TS Business Central

TypeScript toolkit for Microsoft Dynamics 365 Business Central integration.

Español (README.es.md)

---

🌟 Overview

ts-business-central is a professional-grade monorepo containing a suite of libraries designed to make Business Central integrations reliable, type-safe, and easy to maintain.

📦 Included Packages

Package	Version	Description
@chetodb/business-central		Core SDK: Resilience, Key Rotation, and OData CRUD.
@chetodb/nestjs-business-central		NestJS Module: Native framework integration.

---

🚀 Getting Started

You can choose to install the standalone Core SDK or the NestJS module depending on your architecture.

� Option 1: Core SDK (Standalone)

pnpm add @chetodb/business-central

Perfect for vanilla Node.js, Express, or any TypeScript environment.

import { BusinessCentralClient } from '@chetodb/business-central';

const client = new BusinessCentralClient({
  tenantId: 'your-tenant-id',
  companyName: 'CRONUS',
  azureKeys: [{ name: 'primary', clientId: '...', clientSecret: '...' }]
});

const customers = await client.get('customers', { top: 5 });

🔌 Option 2: NestJS Module

pnpm add @chetodb/nestjs-business-central

Simply import the BusinessCentralModule in your AppModule and inject the client natively in your services.

import { BusinessCentralModule } from '@chetodb/nestjs-business-central';

@Module({
  imports: [
    BusinessCentralModule.forRoot({
      isGlobal: true,
      tenantId: 'your-tenant-id',
      companyName: 'CRONUS',
      azureKeys: [{ name: 'primary', clientId: '...', clientSecret: '...' }]
    }),
  ]
})
export class AppModule {}

👉 See full NestJS documentation here

---

🧪 Development & Monorepo

This project uses pnpm workspaces for efficient management.

# Install all dependencies
pnpm install

# Build all packages
pnpm build

# Run tests across the monorepo
pnpm test

---

🤝 Contribution & Governance

We welcome contributions! Please see our Contributing Guide for details on our code of conduct and the process for submitting pull requests.

• License: MIT © 2026 David Cheto (ChetoDB)
• Status: Active development 🏗️