dynamics-tools

A small monorepo of TypeScript packages for working with Microsoft Dataverse / Dynamics 365 from Node.js.

Packages

Package	npm	Description
dataverse-types-gen		Generate TypeScript types & optionset enums from a Dataverse $metadata endpoint.
dataverse-msal-client		Authenticated DynamicsWebApi client factory + @odata.bind helpers.

dataverse-types-gen

Build-time CLI that connects to a Dataverse environment's $metadata endpoint and generates strongly-typed TypeScript interfaces, @odata.bind helper types, and optionset enums for the entities you request.

pnpm add -D dataverse-types-gen
npx dataverse-types-gen

dataverse-msal-client

Runtime helper that wires up a DynamicsWebApi instance authenticated via Microsoft Entra ID client credentials (service principal), plus small @odata.bind URL helpers that pair with the types emitted by dataverse-types-gen.

pnpm add dataverse-msal-client @azure/msal-node dynamics-web-api

Working in the monorepo

pnpm install
pnpm -r build

Releasing

Versioning and publishing are handled by Changesets. Add a changeset to any PR that changes a published package:

pnpm changeset

Merging to main opens a "Version Packages" PR; merging that PR publishes the changed packages to npm and creates the matching GitHub Releases. See CONTRIBUTING.md.

License

MIT