https://github.com/chetodb/ts-business-central
Modern, resilient, and type-safe TypeScript SDK for Microsoft Dynamics 365 Business Central. Includes OData fluent builder, automatic key rotation, and NestJS integration.
https://github.com/chetodb/ts-business-central
api-client-typescript business-central dynamics-365 microsoft-dynamics-365 monorepo nestjs-library odata pnpm-workspace resilience rest-api sdk-typescript type-safety typescript typescript-library
Last synced: 3 months ago
JSON representation
Modern, resilient, and type-safe TypeScript SDK for Microsoft Dynamics 365 Business Central. Includes OData fluent builder, automatic key rotation, and NestJS integration.
- Host: GitHub
- URL: https://github.com/chetodb/ts-business-central
- Owner: chetodb
- License: mit
- Created: 2026-02-11T13:40:23.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-03-10T22:44:09.000Z (3 months ago)
- Last Synced: 2026-03-11T03:57:41.363Z (3 months ago)
- Topics: api-client-typescript, business-central, dynamics-365, microsoft-dynamics-365, monorepo, nestjs-library, odata, pnpm-workspace, resilience, rest-api, sdk-typescript, type-safety, typescript, typescript-library
- Language: TypeScript
- Homepage:
- Size: 157 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.es.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# TS Business Central (Español)
[](https://biomejs.dev)
[](https://opensource.org/licenses/MIT)
[](https://nodejs.org)
**El toolkit de TypeScript para integraciones con Microsoft Dynamics 365 Business Central.**
[English (README.md)](./README.md)
---
## 🌟 Visión General
`ts-business-central` es un monorepo profesional que contiene un conjunto de librerías diseñadas para que las integraciones con Business Central sean fiables, seguras (type-safe) y fáciles de mantener.
### 📦 Paquetes Incluidos
| Paquete | Versión | Descripción |
| --- | --- | --- |
| [**`@chetodb/business-central`**](./packages/core) |  | **Core SDK**: Resiliencia, Rotación de Claves y CRUD OData. |
| [**`@chetodb/nestjs-business-central`**](./packages/nestjs) |  | **Módulo NestJS**: Integración nativa con el framework. |
---
## 🚀 Empezando
Puedes elegir instalar el Core SDK independiente o el módulo nativo de NestJS dependiendo de tu arquitectura.
### � Opción 2: Core SDK (Independiente)
```bash
pnpm add @chetodb/business-central
```
Perfecto para Vanilla Node.js, Express, o cualquier entorno TypeScript.
```ts
import { BusinessCentralClient } from '@chetodb/business-central';
const client = new BusinessCentralClient({
tenantId: 'tu-tenant-id',
companyName: 'CRONUS',
azureKeys: [{ name: 'principal', clientId: '...', clientSecret: '...' }]
});
const customers = await client.get('customers', { top: 5 });
```
### 🔌 Opción 1: Módulo NestJS
```bash
pnpm add @chetodb/nestjs-business-central
```
Simplemente importa el `BusinessCentralModule` en tu `AppModule` e inyecta el cliente nativamente en tus servicios.
```ts
import { BusinessCentralModule } from '@chetodb/nestjs-business-central';
@Module({
imports: [
BusinessCentralModule.forRoot({
isGlobal: true,
tenantId: 'tu-tenant-id',
companyName: 'CRONUS',
azureKeys: [{ name: 'primary', clientId: '...', clientSecret: '...' }]
}),
]
})
export class AppModule {}
```
> 👉 [Ver documentación completa de NestJS aquí](./packages/nestjs/README.es.md)
---
## 🧪 Desarrollo y Monorepo
Este proyecto utiliza workspaces de `pnpm` para una gestión eficiente.
```bash
# Instalar todas las dependencias
pnpm install
# Construir todos los paquetes
pnpm build
# Ejecutar tests en todo el monorepo
pnpm test
```
---
## 🤝 Contribución y Gobernanza
¡Las contribuciones son bienvenidas! Consulta nuestra [Guía de Contribución](./CONTRIBUTING.md) para más detalles sobre nuestro código de conducta y el proceso para enviar pull requests.
- **Licencia**: [MIT](./LICENSE) © 2026 David Cheto (ChetoDB)
- **Estado**: Desarrollo activo 🏗️