@sasscore/database 0.0.1

package/README.md

@@ -0,0 +1,281 @@
+# `@sasscore/database`
+
+Core database infrastructure for NestJS applications built on:
+
+- Sequelize
+- PostgreSQL
+- Tenant context
+- Transactions
+- Transactional Outbox
+
+The package provides a stable infrastructure boundary between business modules and the underlying database implementation.
+
+The database stack is intentionally fixed. This package does not aim to support multiple ORMs.
+
+## Installation
+
+```bash
+npm install @sasscore/database
+```
+
+Peer dependencies: `@nestjs/common`, `@nestjs/core`, `@nestjs/cqrs`, `@nestjs/sequelize`, `nestjs-cls`, `sequelize`, `sequelize-typescript`.
+
+## Public API
+
+The package exposes a stable root API and dedicated subpath exports.
+
+```typescript
+import { DatabaseModule } from '@sasscore/database';
+
+import {
+  OutboxPublisher,
+  OUTBOX_TOKENS,
+} from '@sasscore/database/outbox';
+```
+
+Available subpaths:
+
+| Subpath | Capability |
+|---------|------------|
+| `@sasscore/database` | `DatabaseModule`, shared tokens, re-exported facades |
+| `@sasscore/database/connection` | Sequelize connection lifecycle |
+| `@sasscore/database/tenancy` | Tenant context port and adapter |
+| `@sasscore/database/transaction-manager` | Transaction boundary |
+| `@sasscore/database/outbox` | Transactional domain-event persistence |
+| `@sasscore/database/health` | Database / migration / outbox health |
+| `@sasscore/database/migrations` | Migration runner and Core outbox schema |
+| `@sasscore/database/models` | `BaseModel` |
+| `@sasscore/database/repositories` | `MainRepository`, tenant scope |
+
+See [`PUBLIC_API.md`](./PUBLIC_API.md) for the complete public API contract.
+
+## Database module
+
+The host application remains responsible for application-specific configuration and lifecycle management.
+
+### `DatabaseModule.forRoot(...)`
+
+```typescript
+import { Module } from '@nestjs/common';
+import { DatabaseModule } from '@sasscore/database';
+
+@Module({
+  imports: [
+    DatabaseModule.forRoot({
+      dialect: 'postgres',
+      host: process.env.DB_HOST,
+      port: process.env.DB_PORT ? Number(process.env.DB_PORT) : undefined,
+      database: process.env.DB_NAME ?? process.env.DB_DATABASE,
+      username: process.env.DB_USER ?? process.env.DB_USERNAME,
+      password: process.env.DB_PASSWORD,
+    }),
+  ],
+})
+export class AppModule {}
+```
+
+Sequelize SQL logging defaults to `false`. Pass `logging: true` to enable.
+
+### `DatabaseModule.forRootAsync(...)`
+
+```typescript
+import { Module } from '@nestjs/common';
+import { ConfigModule, ConfigService } from '@nestjs/config';
+import { DatabaseModule } from '@sasscore/database';
+
+@Module({
+  imports: [
+    ConfigModule.forRoot({ isGlobal: true }),
+    DatabaseModule.forRootAsync({
+      inject: [ConfigService],
+      useFactory: (config: ConfigService) => ({
+        dialect: 'postgres',
+        host: config.get<string>('DB_HOST'),
+        port: config.get<number>('DB_PORT'),
+        database: config.get<string>('DB_NAME') ?? config.get<string>('DB_DATABASE'),
+        username: config.get<string>('DB_USER') ?? config.get<string>('DB_USERNAME'),
+        password: config.get<string>('DB_PASSWORD'),
+      }),
+    }),
+  ],
+})
+export class AppModule {}
+```
+
+`DatabaseModuleOptions`: `dialect` (`'postgres'`), `host`, `port`, `database`, `username`, `password`, `logging`.
+
+## Core capabilities
+
+### Connection
+
+Provides the Sequelize database connection and connection lifecycle.
+
+`@sasscore/database/connection`
+
+### Tenant context
+
+Provides the tenant context abstraction used by business modules.
+
+`@sasscore/database/tenancy`
+
+Business modules should depend on `ITenantContext` rather than implementing their own tenant resolution.
+
+### Transactions
+
+Provides a transaction boundary for application operations.
+
+`@sasscore/database/transaction-manager`
+
+```typescript
+await this.transactionManager.runInTransaction(async (transaction) => {
+  // transactional work
+});
+```
+
+### Outbox
+
+Provides transactional domain-event persistence and publishing infrastructure.
+
+`@sasscore/database/outbox`
+
+```typescript
+await this.transactionManager.runInTransaction(async (transaction) => {
+  await this.outboxPublisher.publish(event, { transaction });
+});
+```
+
+The outbox allows an event to be persisted within the same database transaction as the business operation.
+
+### Health
+
+Provides database health checks.
+
+`@sasscore/database/health`
+
+### Migrations
+
+The package provides migration infrastructure:
+
+- `MigrationDefinition`
+- `MigrationRunner`
+- `createMigrationRegistry`
+- `databaseMigrations`
+
+The package owns migrations required by its own infrastructure, such as the Outbox schema.
+
+The host application composes package migrations with migrations from other domains:
+
+```typescript
+createMigrationRegistry(
+  databaseMigrations,
+  // iamMigrations,
+  // billingMigrations,
+);
+```
+
+Database lifecycle commands remain the responsibility of the host application. For example:
+
+```bash
+npm run db:init
+npm run db:migrate
+npm run db:seed
+```
+
+## Business module boundary
+
+Business modules such as IAM, Billing and Commerce should not depend directly on Sequelize, CLS, or database-specific Outbox tables.
+
+Instead, they depend on the abstractions provided by this package.
+
+```typescript
+constructor(
+  private readonly transactionManager: DatabaseTransactionManager,
+  private readonly tenantContext: ITenantContext,
+  private readonly outboxPublisher: OutboxPublisher,
+) {}
+
+await this.transactionManager.runInTransaction(async (transaction) => {
+  const companyId = this.tenantContext.getCompanyId();
+
+  await this.outboxPublisher.publish(event, { transaction });
+});
+```
+
+This keeps database implementation details behind the infrastructure boundary.
+
+## Architecture
+
+```text
+Business Contexts
+      │
+      ▼
+@sasscore/database
+      │
+      ├── Connection
+      ├── Tenant Context
+      ├── Transactions
+      ├── Outbox
+      ├── Health
+      ├── Models
+      └── Repositories
+      │
+      ▼
+Sequelize
+      │
+      ▼
+PostgreSQL
+```
+
+## Package structure
+
+The package is organized around infrastructure capabilities:
+
+```text
+database/
+├── connection/
+├── tenancy/
+├── transaction-manager/
+├── outbox/
+├── health/
+├── models/
+├── repositories/
+├── migrations/
+├── types/
+├── database.module.ts
+├── tokens.ts
+└── index.ts
+```
+
+The directory structure is an implementation detail. Consumers should use the documented public exports rather than importing internal files.
+
+## Public API contract
+
+The supported public API is defined by:
+
+- package root exports
+- documented subpath exports
+- [`PUBLIC_API.md`](./PUBLIC_API.md)
+
+Internal implementation files are not part of the public contract.
+
+What changed between versions: [`CHANGELOG.md`](./CHANGELOG.md).
+
+## Build
+
+The package can be built independently:
+
+```bash
+npm run build
+```
+
+The package must compile independently from the host application's domain modules and infrastructure.
+
+## Tests
+
+```bash
+npm test
+```
+
+From the API repo: `npm run test:pkg:database`.
+
+Integration / host-level database health checks may be provided by the consuming application.

package/dist/connection/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @sasscore/database/connection
+ */
+export { DATABASE_TOKENS } from '../tokens.js';
+export { DatabaseConnectionModule } from './infrastructure/connection.module.js';
+export { SequelizeService } from './infrastructure/sequelize.service.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/connection/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../connection/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC"}

package/dist/connection/index.js

@@ -0,0 +1,7 @@
+/**
+ * @sasscore/database/connection
+ */
+export { DATABASE_TOKENS } from '../tokens.js';
+export { DatabaseConnectionModule } from './infrastructure/connection.module.js';
+export { SequelizeService } from './infrastructure/sequelize.service.js';
+//# sourceMappingURL=index.js.map

package/dist/connection/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../connection/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,wBAAwB,EAAE,MAAM,uCAAuC,CAAC;AACjF,OAAO,EAAE,gBAAgB,EAAE,MAAM,uCAAuC,CAAC"}

package/dist/connection/infrastructure/connection.module.d.ts

@@ -0,0 +1,18 @@
+import { DynamicModule } from '@nestjs/common';
+import type { Model, ModelCtor } from 'sequelize-typescript';
+import type { DatabaseModuleOptions } from '../../types/index.js';
+/**
+ * Database connection capability — public entry for business modules.
+ *
+ * Host apps that already bootstrap Sequelize (e.g. monolith `UniversalDatabaseModule`)
+ * can call {@link DatabaseConnectionModule.forRoot} with empty options — only
+ * {@link SequelizeService} is registered against the existing connection.
+ *
+ * Standalone / future package consumers pass connection options to wire
+ * `SequelizeModule.forRoot` from this package.
+ */
+export declare class DatabaseConnectionModule {
+    static forRoot(options?: DatabaseModuleOptions): DynamicModule;
+    static forFeature(models: ModelCtor<Model>[], connection?: string): DynamicModule;
+}
+//# sourceMappingURL=connection.module.d.ts.map

package/dist/connection/infrastructure/connection.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.module.d.ts","sourceRoot":"","sources":["../../../connection/infrastructure/connection.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAkB,MAAM,gBAAgB,CAAC;AAE/D,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAE7D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAGlE;;;;;;;;;GASG;AACH,qBAEa,wBAAwB;IACnC,MAAM,CAAC,OAAO,CAAC,OAAO,GAAE,qBAA0B,GAAG,aAAa;IA4ClE,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,SAAS,CAAC,KAAK,CAAC,EAAE,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,aAAa;CAOlF"}

package/dist/connection/infrastructure/connection.module.js

@@ -0,0 +1,75 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var DatabaseConnectionModule_1;
+import { Global, Module } from '@nestjs/common';
+import { SequelizeModule } from '@nestjs/sequelize';
+import { DATABASE_TOKENS } from '../../providers/database.tokens.js';
+import { SequelizeService } from './sequelize.service.js';
+/**
+ * Database connection capability — public entry for business modules.
+ *
+ * Host apps that already bootstrap Sequelize (e.g. monolith `UniversalDatabaseModule`)
+ * can call {@link DatabaseConnectionModule.forRoot} with empty options — only
+ * {@link SequelizeService} is registered against the existing connection.
+ *
+ * Standalone / future package consumers pass connection options to wire
+ * `SequelizeModule.forRoot` from this package.
+ */
+let DatabaseConnectionModule = DatabaseConnectionModule_1 = class DatabaseConnectionModule {
+    static forRoot(options = {}) {
+        const hasConnectionOptions = options.host != null ||
+            options.database != null ||
+            options.username != null ||
+            options.port != null;
+        const imports = hasConnectionOptions
+            ? [
+                SequelizeModule.forRoot({
+                    dialect: options.dialect ?? 'postgres',
+                    host: options.host,
+                    port: options.port,
+                    database: options.database,
+                    username: options.username,
+                    password: options.password,
+                    autoLoadModels: true,
+                    synchronize: false,
+                    logging: options.logging ?? false,
+                }),
+            ]
+            : [];
+        return {
+            module: DatabaseConnectionModule_1,
+            global: true,
+            imports,
+            providers: [
+                SequelizeService,
+                {
+                    provide: DATABASE_TOKENS.SEQUELIZE,
+                    useFactory: (sequelizeService) => sequelizeService.getSequelize(),
+                    inject: [SequelizeService],
+                },
+            ],
+            exports: [
+                SequelizeService,
+                DATABASE_TOKENS.SEQUELIZE,
+                ...(imports.length ? [SequelizeModule] : []),
+            ],
+        };
+    }
+    static forFeature(models, connection) {
+        return {
+            module: DatabaseConnectionModule_1,
+            imports: [SequelizeModule.forFeature(models, connection)],
+            exports: [SequelizeModule],
+        };
+    }
+};
+DatabaseConnectionModule = DatabaseConnectionModule_1 = __decorate([
+    Global(),
+    Module({})
+], DatabaseConnectionModule);
+export { DatabaseConnectionModule };
+//# sourceMappingURL=connection.module.js.map

package/dist/connection/infrastructure/connection.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.module.js","sourceRoot":"","sources":["../../../connection/infrastructure/connection.module.ts"],"names":[],"mappings":";;;;;;;AAAA,OAAO,EAAiB,MAAM,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAErE,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D;;;;;;;;;GASG;AAGI,IAAM,wBAAwB,gCAA9B,MAAM,wBAAwB;IACnC,MAAM,CAAC,OAAO,CAAC,UAAiC,EAAE;QAChD,MAAM,oBAAoB,GACxB,OAAO,CAAC,IAAI,IAAI,IAAI;YACpB,OAAO,CAAC,QAAQ,IAAI,IAAI;YACxB,OAAO,CAAC,QAAQ,IAAI,IAAI;YACxB,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC;QAEvB,MAAM,OAAO,GAAG,oBAAoB;YAClC,CAAC,CAAC;gBACE,eAAe,CAAC,OAAO,CAAC;oBACtB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,UAAU;oBACtC,IAAI,EAAE,OAAO,CAAC,IAAI;oBAClB,IAAI,EAAE,OAAO,CAAC,IAAI;oBAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;oBAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ;oBAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ;oBAC1B,cAAc,EAAE,IAAI;oBACpB,WAAW,EAAE,KAAK;oBAClB,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,KAAK;iBAClC,CAAC;aACH;YACH,CAAC,CAAC,EAAE,CAAC;QAEP,OAAO;YACL,MAAM,EAAE,0BAAwB;YAChC,MAAM,EAAE,IAAI;YACZ,OAAO;YACP,SAAS,EAAE;gBACT,gBAAgB;gBAChB;oBACE,OAAO,EAAE,eAAe,CAAC,SAAS;oBAClC,UAAU,EAAE,CAAC,gBAAkC,EAAE,EAAE,CACjD,gBAAgB,CAAC,YAAY,EAAE;oBACjC,MAAM,EAAE,CAAC,gBAAgB,CAAC;iBAC3B;aACF;YACD,OAAO,EAAE;gBACP,gBAAgB;gBAChB,eAAe,CAAC,SAAS;gBACzB,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;aAC7C;SACF,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,MAA0B,EAAE,UAAmB;QAC/D,OAAO;YACL,MAAM,EAAE,0BAAwB;YAChC,OAAO,EAAE,CAAC,eAAe,CAAC,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;YACzD,OAAO,EAAE,CAAC,eAAe,CAAC;SAC3B,CAAC;IACJ,CAAC;CACF,CAAA;AApDY,wBAAwB;IAFpC,MAAM,EAAE;IACR,MAAM,CAAC,EAAE,CAAC;GACE,wBAAwB,CAoDpC"}

package/dist/connection/infrastructure/sequelize.service.d.ts

@@ -0,0 +1,16 @@
+import { Sequelize, Model } from 'sequelize-typescript';
+/**
+ * Thin Sequelize facade for package consumers.
+ * Requires Nest `SequelizeModule` to be registered by the host (or {@link DatabaseConnectionModule.forRoot}).
+ */
+export declare class SequelizeService {
+    private readonly sequelize;
+    constructor(sequelize: Sequelize);
+    getSequelize(): Sequelize;
+    transaction<T>(callback: (transaction: never) => Promise<T>): Promise<T>;
+    getModel<T extends Model>(modelName: string): unknown;
+    query(sql: string, options?: unknown): Promise<unknown>;
+    healthCheck(): Promise<boolean>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=sequelize.service.d.ts.map

package/dist/connection/infrastructure/sequelize.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequelize.service.d.ts","sourceRoot":"","sources":["../../../connection/infrastructure/sequelize.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAExD;;;GAGG;AACH,qBACa,gBAAgB;IAGzB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,SAAS;IAGvC,YAAY,IAAI,SAAS;IAInB,WAAW,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,WAAW,EAAE,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAI9E,QAAQ,CAAC,CAAC,SAAS,KAAK,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;IAI/C,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAIvD,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAS/B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/connection/infrastructure/sequelize.service.js

@@ -0,0 +1,56 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { Injectable } from '@nestjs/common';
+import { InjectConnection } from '@nestjs/sequelize';
+import { Sequelize } from 'sequelize-typescript';
+/**
+ * Thin Sequelize facade for package consumers.
+ * Requires Nest `SequelizeModule` to be registered by the host (or {@link DatabaseConnectionModule.forRoot}).
+ */
+let SequelizeService = class SequelizeService {
+    sequelize;
+    constructor(sequelize) {
+        this.sequelize = sequelize;
+    }
+    getSequelize() {
+        return this.sequelize;
+    }
+    async transaction(callback) {
+        return this.sequelize.transaction(callback);
+    }
+    getModel(modelName) {
+        return this.sequelize.models[modelName];
+    }
+    async query(sql, options) {
+        return this.sequelize.query(sql, options);
+    }
+    async healthCheck() {
+        try {
+            await this.sequelize.authenticate();
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async close() {
+        await this.sequelize.close();
+    }
+};
+SequelizeService = __decorate([
+    Injectable(),
+    __param(0, InjectConnection()),
+    __metadata("design:paramtypes", [Sequelize])
+], SequelizeService);
+export { SequelizeService };
+//# sourceMappingURL=sequelize.service.js.map

package/dist/connection/infrastructure/sequelize.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequelize.service.js","sourceRoot":"","sources":["../../../connection/infrastructure/sequelize.service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAS,MAAM,sBAAsB,CAAC;AAExD;;;GAGG;AAEI,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;IAGR;IAFnB,YAEmB,SAAoB;QAApB,cAAS,GAAT,SAAS,CAAW;IACpC,CAAC;IAEJ,YAAY;QACV,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,WAAW,CAAI,QAA4C;QAC/D,OAAO,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,QAA8D,CAAC,CAAC;IACpG,CAAC;IAED,QAAQ,CAAkB,SAAiB;QACzC,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,GAAW,EAAE,OAAiB;QACxC,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,GAAG,EAAE,OAAgB,CAAC,CAAC;IACrD,CAAC;IAED,KAAK,CAAC,WAAW;QACf,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC;YACpC,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IAC/B,CAAC;CACF,CAAA;AAlCY,gBAAgB;IAD5B,UAAU,EAAE;IAGR,WAAA,gBAAgB,EAAE,CAAA;qCACS,SAAS;GAH5B,gBAAgB,CAkC5B"}

package/dist/database.module.d.ts

@@ -0,0 +1,25 @@
+import { DynamicModule } from '@nestjs/common';
+import type { DatabaseModuleOptions } from './types/index.js';
+export type { DatabaseModuleOptions } from './types/index.js';
+/**
+ * Aggregates database package capabilities for app bootstrap.
+ *
+ * Consumer (e.g. kit client):
+ * ```typescript
+ * @Module({ imports: [DatabaseModule.forRoot({ ... })] })
+ * export class AppModule {}
+ * ```
+ */
+export declare class DatabaseDomainModule {
+    /**
+     * Single entry point — connection, health, outbox stay inside the package.
+     */
+    static forRoot(options?: DatabaseModuleOptions): DynamicModule;
+    static forRootAsync(options: {
+        useFactory: (...args: never[]) => DatabaseModuleOptions | Promise<DatabaseModuleOptions>;
+        inject?: Array<string | symbol | (new (...args: never[]) => unknown)>;
+    }): DynamicModule;
+}
+/** @sasscore/database root export alias */
+export { DatabaseDomainModule as DatabaseModule };
+//# sourceMappingURL=database.module.d.ts.map

package/dist/database.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.module.d.ts","sourceRoot":"","sources":["../database.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAU,MAAM,gBAAgB,CAAC;AAIvD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAE9D,YAAY,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAE9D;;;;;;;;GAQG;AACH,qBACa,oBAAoB;IAC/B;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,GAAE,qBAA0B,GAAG,aAAa;IAiBlE,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE;QAC3B,UAAU,EAAE,CACV,GAAG,IAAI,EAAE,KAAK,EAAE,KACb,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;QAC5D,MAAM,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,CAAC,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,CAAC,CAAC,CAAC;KACvE,GAAG,aAAa;CAuBlB;AAED,2CAA2C;AAC3C,OAAO,EAAE,oBAAoB,IAAI,cAAc,EAAE,CAAC"}

package/dist/database.module.js

@@ -0,0 +1,71 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var DatabaseDomainModule_1;
+import { Module } from '@nestjs/common';
+import { DatabaseConnectionModule } from './connection/index.js';
+import { DatabaseHealthModule } from './health/health.module.js';
+import { DatabaseOutboxModule } from './outbox/infrastructure/outbox.module.js';
+/**
+ * Aggregates database package capabilities for app bootstrap.
+ *
+ * Consumer (e.g. kit client):
+ * ```typescript
+ * @Module({ imports: [DatabaseModule.forRoot({ ... })] })
+ * export class AppModule {}
+ * ```
+ */
+let DatabaseDomainModule = DatabaseDomainModule_1 = class DatabaseDomainModule {
+    /**
+     * Single entry point — connection, health, outbox stay inside the package.
+     */
+    static forRoot(options = {}) {
+        return {
+            module: DatabaseDomainModule_1,
+            global: true,
+            imports: [
+                DatabaseConnectionModule.forRoot(options),
+                DatabaseHealthModule,
+                DatabaseOutboxModule,
+            ],
+            exports: [
+                DatabaseConnectionModule,
+                DatabaseHealthModule,
+                DatabaseOutboxModule,
+            ],
+        };
+    }
+    static forRootAsync(options) {
+        return {
+            module: DatabaseDomainModule_1,
+            global: true,
+            imports: [
+                DatabaseConnectionModule.forRoot(),
+                DatabaseHealthModule,
+                DatabaseOutboxModule,
+            ],
+            exports: [
+                DatabaseConnectionModule,
+                DatabaseHealthModule,
+                DatabaseOutboxModule,
+            ],
+            providers: [
+                {
+                    provide: 'DATABASE_MODULE_OPTIONS',
+                    useFactory: options.useFactory,
+                    inject: (options.inject ?? []),
+                },
+            ],
+        };
+    }
+};
+DatabaseDomainModule = DatabaseDomainModule_1 = __decorate([
+    Module({})
+], DatabaseDomainModule);
+export { DatabaseDomainModule };
+/** @sasscore/database root export alias */
+export { DatabaseDomainModule as DatabaseModule };
+//# sourceMappingURL=database.module.js.map

package/dist/database.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.module.js","sourceRoot":"","sources":["../database.module.ts"],"names":[],"mappings":";;;;;;;AAAA,OAAO,EAAiB,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AAKhF;;;;;;;;GAQG;AAEI,IAAM,oBAAoB,4BAA1B,MAAM,oBAAoB;IAC/B;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,UAAiC,EAAE;QAChD,OAAO;YACL,MAAM,EAAE,sBAAoB;YAC5B,MAAM,EAAE,IAAI;YACZ,OAAO,EAAE;gBACP,wBAAwB,CAAC,OAAO,CAAC,OAAO,CAAC;gBACzC,oBAAoB;gBACpB,oBAAoB;aACrB;YACD,OAAO,EAAE;gBACP,wBAAwB;gBACxB,oBAAoB;gBACpB,oBAAoB;aACrB;SACF,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,YAAY,CAAC,OAKnB;QACC,OAAO;YACL,MAAM,EAAE,sBAAoB;YAC5B,MAAM,EAAE,IAAI;YACZ,OAAO,EAAE;gBACP,wBAAwB,CAAC,OAAO,EAAE;gBAClC,oBAAoB;gBACpB,oBAAoB;aACrB;YACD,OAAO,EAAE;gBACP,wBAAwB;gBACxB,oBAAoB;gBACpB,oBAAoB;aACrB;YACD,SAAS,EAAE;gBACT;oBACE,OAAO,EAAE,yBAAyB;oBAClC,UAAU,EAAE,OAAO,CAAC,UAAU;oBAC9B,MAAM,EAAE,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAY;iBAC1C;aACF;SACF,CAAC;IACJ,CAAC;CACF,CAAA;AAjDY,oBAAoB;IADhC,MAAM,CAAC,EAAE,CAAC;GACE,oBAAoB,CAiDhC;;AAED,2CAA2C;AAC3C,OAAO,EAAE,oBAAoB,IAAI,cAAc,EAAE,CAAC"}

package/dist/health/database-health.service.d.ts

@@ -0,0 +1,12 @@
+import type { Sequelize } from 'sequelize-typescript';
+import type { DatabaseHealthResult } from './database-health.types.js';
+/**
+ * Package capability: probe Sequelize / PostgreSQL connectivity.
+ * No HTTP — host apps expose this via their own controllers.
+ */
+export declare class DatabaseHealth {
+    private readonly sequelize;
+    constructor(sequelize: Sequelize);
+    check(): Promise<DatabaseHealthResult>;
+}
+//# sourceMappingURL=database-health.service.d.ts.map

package/dist/health/database-health.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-health.service.d.ts","sourceRoot":"","sources":["../../health/database-health.service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEtD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAEvE;;;GAGG;AACH,qBACa,cAAc;IAGvB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,SAAS;IAGjC,KAAK,IAAI,OAAO,CAAC,oBAAoB,CAAC;CAkB7C"}

package/dist/health/database-health.service.js

@@ -0,0 +1,48 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { Inject, Injectable } from '@nestjs/common';
+import { DATABASE_TOKENS } from '../providers/database.tokens.js';
+/**
+ * Package capability: probe Sequelize / PostgreSQL connectivity.
+ * No HTTP — host apps expose this via their own controllers.
+ */
+let DatabaseHealth = class DatabaseHealth {
+    sequelize;
+    constructor(sequelize) {
+        this.sequelize = sequelize;
+    }
+    async check() {
+        const startedAt = Date.now();
+        try {
+            await this.sequelize.authenticate();
+            return {
+                status: 'up',
+                latencyMs: Date.now() - startedAt,
+            };
+        }
+        catch (error) {
+            return {
+                status: 'down',
+                latencyMs: Date.now() - startedAt,
+                error: error instanceof Error ? error.message : 'Database connection failed',
+            };
+        }
+    }
+};
+DatabaseHealth = __decorate([
+    Injectable(),
+    __param(0, Inject(DATABASE_TOKENS.SEQUELIZE)),
+    __metadata("design:paramtypes", [Function])
+], DatabaseHealth);
+export { DatabaseHealth };
+//# sourceMappingURL=database-health.service.js.map

package/dist/health/database-health.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-health.service.js","sourceRoot":"","sources":["../../health/database-health.service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEpD,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAGlE;;;GAGG;AAEI,IAAM,cAAc,GAApB,MAAM,cAAc;IAGN;IAFnB,YAEmB,SAAoB;QAApB,cAAS,GAAT,SAAS,CAAW;IACpC,CAAC;IAEJ,KAAK,CAAC,KAAK;QACT,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,CAAC;YACpC,OAAO;gBACL,MAAM,EAAE,IAAI;gBACZ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;aAClC,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO;gBACL,MAAM,EAAE,MAAM;gBACd,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;gBACjC,KAAK,EACH,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,4BAA4B;aACxE,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAA;AAxBY,cAAc;IAD1B,UAAU,EAAE;IAGR,WAAA,MAAM,CAAC,eAAe,CAAC,SAAS,CAAC,CAAA;;GAFzB,cAAc,CAwB1B"}