@zintrust/core 0.1.20 → 0.1.21

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zintrust/core",
-  "version": "0.1.20",
+  "version": "0.1.21",
   "description": "Production-grade TypeScript backend framework for JavaScript",
   "homepage": "https://zintrust.com",
   "repository": {
@@ -34,6 +34,7 @@
   },
   "dependencies": {
     "bcrypt": "^6.0.0",
+    "bg": "^1.0.0",
     "chalk": "^5.6.2",
     "commander": "^14.0.2",
     "inquirer": "^13.2.0",

package/src/boot/Application.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Application.d.ts","sourceRoot":"","sources":["../../../src/boot/Application.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAGtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,KAAK,OAAO,EAAU,MAAM,kBAAkB,CAAC;AASxD,MAAM,WAAW,YAAY;IAC3B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,QAAQ,IAAI,OAAO,CAAC;IACpB,aAAa,IAAI,OAAO,CAAC;IACzB,YAAY,IAAI,OAAO,CAAC;IACxB,SAAS,IAAI,OAAO,CAAC;IACrB,cAAc,IAAI,MAAM,CAAC;IACzB,SAAS,IAAI,OAAO,CAAC;IACrB,YAAY,IAAI,iBAAiB,CAAC;IAClC,kBAAkB,IAAI,gBAAgB,CAAC;IACvC,WAAW,IAAI,MAAM,CAAC;CACvB;AAqVD;;GAEG;AACH,eAAO,MAAM,WAAW;IACtB;;OAEG;sBACe,MAAM,GAAG,YAAY;EA0CvC,CAAC;AAEH,eAAe,WAAW,CAAC"}
+{"version":3,"file":"Application.d.ts","sourceRoot":"","sources":["../../../src/boot/Application.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAGtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,KAAK,OAAO,EAAU,MAAM,kBAAkB,CAAC;AAUxD,MAAM,WAAW,YAAY;IAC3B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,QAAQ,IAAI,OAAO,CAAC;IACpB,aAAa,IAAI,OAAO,CAAC;IACzB,YAAY,IAAI,OAAO,CAAC;IACxB,SAAS,IAAI,OAAO,CAAC;IACrB,cAAc,IAAI,MAAM,CAAC;IACzB,SAAS,IAAI,OAAO,CAAC;IACrB,YAAY,IAAI,iBAAiB,CAAC;IAClC,kBAAkB,IAAI,gBAAgB,CAAC;IACvC,WAAW,IAAI,MAAM,CAAC;CACvB;AAyYD;;GAEG;AACH,eAAO,MAAM,WAAW;IACtB;;OAEG;sBACe,MAAM,GAAG,YAAY;EA0CvC,CAAC;AAEH,eAAe,WAAW,CAAC"}

package/src/boot/Application.js

@@ -7,6 +7,7 @@ import { ServiceContainer } from '../container/ServiceContainer.js';
 import { StartupHealthChecks } from '../health/StartupHealthChecks.js';
 import { MiddlewareStack } from '../middleware/MiddlewareStack.js';
 import { Router } from '../routing/Router.js';
+import { StartupConfigFile, StartupConfigFileRegistry } from '../runtime/StartupConfigFileRegistry.js';
 import broadcastConfig from '../config/broadcast.js';
 import { FeatureFlags } from '../config/features.js';
 import { Logger } from '../config/logger.js';
@@ -220,21 +221,47 @@ const tryImportOptional = async (modulePath) => {
         return undefined;
     }
 };
-const registerFromRuntimeConfig = async () => {
-    const db = await tryImportOptional('@orm/DatabaseRuntimeRegistration');
+const isCompiledJsModule = () => {
+    // When running from dist, this module is compiled to .js and Node ESM resolution
+    // requires explicit file extensions for relative imports.
+    return import.meta.url.endsWith('.js');
+};
+const dbLoader = async () => {
+    const db = await tryImportOptional(isCompiledJsModule()
+        ? '../orm/DatabaseRuntimeRegistration.js'
+        : '../orm/DatabaseRuntimeRegistration');
     db?.registerDatabasesFromRuntimeConfig?.(databaseConfig);
-    const queues = await tryImportOptional('@tools/queue/QueueRuntimeRegistration');
+};
+const queuesLoader = async () => {
+    const queues = await tryImportOptional(isCompiledJsModule()
+        ? '../tools/queue/QueueRuntimeRegistration.js'
+        : '../tools/queue/QueueRuntimeRegistration');
     queues?.registerQueuesFromRuntimeConfig?.(queueConfig);
-    const caches = await tryImportOptional('@cache/CacheRuntimeRegistration');
+};
+const cachesLoader = async () => {
+    const caches = await tryImportOptional(isCompiledJsModule()
+        ? '../cache/CacheRuntimeRegistration.js'
+        : '../cache/CacheRuntimeRegistration');
     caches?.registerCachesFromRuntimeConfig?.(cacheConfig);
-    const broadcasters = await tryImportOptional('@broadcast/BroadcastRuntimeRegistration');
+};
+const registerFromRuntimeConfig = async () => {
+    await dbLoader();
+    await queuesLoader();
+    await cachesLoader();
+    const broadcasters = await tryImportOptional(isCompiledJsModule()
+        ? '../tools/broadcast/BroadcastRuntimeRegistration.js'
+        : '../tools/broadcast/BroadcastRuntimeRegistration');
     broadcasters?.registerBroadcastersFromRuntimeConfig?.({
         default: broadcastConfig.default,
         drivers: broadcastConfig.drivers,
     });
-    const disks = await tryImportOptional('@storage/StorageRuntimeRegistration');
+    const disks = await tryImportOptional(isCompiledJsModule()
+        ? '../tools/storage/StorageRuntimeRegistration.js'
+        : '../tools/storage/StorageRuntimeRegistration');
     disks?.registerDisksFromRuntimeConfig?.(storageConfig);
-    const notifications = await tryImportOptional('@notification/NotificationRuntimeRegistration');
+    const notifications = await tryImportOptional(isCompiledJsModule()
+        ? '../tools/notification/NotificationRuntimeRegistration.js'
+        : '../tools/notification/NotificationRuntimeRegistration');
     notifications?.registerNotificationChannelsFromRuntimeConfig?.({
         default: notificationConfig.default,
         drivers: notificationConfig.drivers,
@@ -246,6 +273,17 @@ const createLifecycle = (params) => {
             return;
         Logger.info(`🚀 Booting Zintrust Application in ${params.environment} mode...`);
         StartupConfigValidator.assertValid();
+        // Preload project-owned config overrides that must be available synchronously.
+        await StartupConfigFileRegistry.preload([
+            StartupConfigFile.Middleware,
+            StartupConfigFile.Cache,
+            StartupConfigFile.Database,
+            StartupConfigFile.Queue,
+            StartupConfigFile.Storage,
+            StartupConfigFile.Mail,
+            StartupConfigFile.Broadcast,
+            StartupConfigFile.Notification,
+        ]);
         FeatureFlags.initialize();
         await StartupHealthChecks.assertHealthy();
         await registerFromRuntimeConfig();
@@ -302,9 +340,9 @@ export const Application = Object.freeze({
             boot,
             shutdown,
             isBooted: () => booted,
-            isDevelopment: () => environment === 'development',
-            isProduction: () => environment === 'production',
-            isTesting: () => environment === 'testing',
+            isDevelopment: () => appConfig.isDevelopment(),
+            isProduction: () => appConfig.isProduction(),
+            isTesting: () => appConfig.isTesting(),
             getEnvironment: () => environment,
             getRouter: () => router,
             getContainer: () => container,

package/src/boot/bootstrap.js

@@ -8,6 +8,8 @@ import { Server } from './Server.js';
 import { Env } from '../config/env.js';
 import { Logger } from '../config/logger.js';
 import { ErrorFactory } from '../exceptions/ZintrustError.js';
+// Register plugins (adapters, drivers, etc.)
+// import '@/zintrust.plugins';
 let appInstance;
 let serverInstance;
 let isShuttingDown = false;

package/src/cli/commands/MigrateCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MigrateCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/MigrateCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAsarE;;GAEG;AACH,eAAO,MAAM,cAAc;IACzB;;OAEG;cACO,YAAY;EAUtB,CAAC"}
+{"version":3,"file":"MigrateCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/MigrateCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAidrE;;GAEG;AACH,eAAO,MAAM,cAAc;IACzB;;OAEG;cACO,YAAY;EAUtB,CAAC"}

package/src/cli/commands/MigrateCommand.js

@@ -27,6 +27,7 @@ const addMigrateOptions = (command) => {
         .option('--local', 'D1 only: run against local D1 database')
         .option('--remote', 'D1 only: run against remote D1 database')
         .option('--database <name>', 'D1 only: Wrangler D1 database binding name (not DB_DATABASE env var)')
+        .option('--all', 'Run migrations for all configured database connections')
         .option('--no-interactive', 'Disable interactive prompts (useful for CI/CD)');
 };
 const getInteractive = (options) => options['interactive'] !== false;
@@ -57,6 +58,8 @@ const describeTargetDatabase = (conn) => {
             return `postgresql:${conn.host}:${conn.port}/${conn.database}`;
         case 'mysql':
             return `mysql:${conn.host}:${conn.port}/${conn.database}`;
+        case 'sqlserver':
+            return `sqlserver:${conn.host}:${conn.port}/${conn.database}`;
         default:
             return `${conn.driver}`;
     }
@@ -83,6 +86,15 @@ const mapConnectionToOrmConfig = (conn) => {
                 username: conn.username,
                 password: conn.password,
             };
+        case 'sqlserver':
+            return {
+                driver: 'sqlserver',
+                host: conn.host,
+                port: conn.port,
+                database: conn.database,
+                username: conn.username,
+                password: conn.password,
+            };
         default:
             return { driver: 'sqlite', database: ':memory:' };
     }
@@ -225,9 +237,7 @@ const runD1Actions = async (params) => {
         cmd.info(output);
     cmd.success('D1 migrations completed successfully');
 };
-const executeMigrate = async (options, cmd) => {
-    const interactive = getInteractive(options);
-    const conn = databaseConfig.getConnection();
+const processConnection = async (conn, options, cmd, interactive) => {
     // Avoid confusion: `--database` is a D1-only option (Wrangler binding name), not DB_DATABASE.
     if (isD1Driver(conn.driver)) {
         cmd.debug(`Migrate command executed with options: ${JSON.stringify(options)}`);
@@ -293,6 +303,29 @@ const executeMigrate = async (options, cmd) => {
         await db.disconnect();
     }
 };
+const executeMigrate = async (options, cmd) => {
+    const interactive = getInteractive(options);
+    const targets = [];
+    if (options['all'] === true) {
+        for (const [name, config] of Object.entries(databaseConfig.connections)) {
+            targets.push({ name, config });
+        }
+    }
+    else {
+        targets.push({ name: 'default', config: databaseConfig.getConnection() });
+    }
+    // Run sequentially (to preserve ordering and interactive prompts), but avoid `await` inside a loop.
+    let sequence = Promise.resolve();
+    for (const { name, config } of targets) {
+        sequence = sequence.then(async () => {
+            if (targets.length > 1) {
+                cmd.info(`\n--- Connection: ${name} (${config.driver}) ---`);
+            }
+            await processConnection(config, options, cmd, interactive);
+        });
+    }
+    await sequence;
+};
 /**
  * Migrate Command Factory
  */

package/src/cli/d1/D1SqlMigrations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"D1SqlMigrations.d.ts","sourceRoot":"","sources":["../../../../src/cli/d1/D1SqlMigrations.ts"],"names":[],"mappings":"AAWA,KAAK,6BAA6B,GAAG;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,KAAK,qBAAqB,GAAG;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC;AA4NF,eAAO,MAAM,eAAe;0BACE,6BAA6B,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;EAmC5F,CAAC"}
+{"version":3,"file":"D1SqlMigrations.d.ts","sourceRoot":"","sources":["../../../../src/cli/d1/D1SqlMigrations.ts"],"names":[],"mappings":"AAWA,KAAK,6BAA6B,GAAG;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,KAAK,qBAAqB,GAAG;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC;AAiOF,eAAO,MAAM,eAAe;0BACE,6BAA6B,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;EAmC5F,CAAC"}

package/src/cli/d1/D1SqlMigrations.js

@@ -121,9 +121,14 @@ const createCaptureDb = (onSql) => {
             await RESOLVED_VOID;
             return null;
         },
+        async execute(sql, parameters = []) {
+            captureSql(onSql, sql, parameters);
+            await RESOLVED_VOID;
+            return { rows: [], rowCount: 0 };
+        },
         async transaction(callback) {
             await RESOLVED_VOID;
-            return callback(db);
+            return callback(this);
         },
         table() {
             throw ErrorFactory.createCliError('D1 SQL compilation does not support QueryBuilder-based migrations yet. Use db.query(...) with explicit SQL.');

package/src/cli/scaffolding/ControllerGenerator.js

@@ -117,7 +117,7 @@ function generateCrudController(options) {
  * Auto-generated CRUD controller
  */
 
-import { type IRequest, type IResponse, Controller } from '@zintrust/core';
+import { type IRequest, type IResponse, Controller } from '../../index.js';
 import { ${modelName} } from '@app/Models/${modelName}';
 
 function handleError(res: IResponse, error: unknown): void {
@@ -286,7 +286,7 @@ function generateApiController(options) {
  * Auto-generated API controller
  */
 
-import { type IRequest, type IResponse, Controller } from '@zintrust/core';
+import { type IRequest, type IResponse, Controller } from '../../index.js';
 
 function handleError(res: IResponse, error: unknown): void {
   const message = error instanceof Error ? error.message : 'Internal server error';
@@ -387,7 +387,7 @@ function generateGraphQLController(options) {
  * Auto-generated GraphQL controller
  */
 
-import { type IRequest, type IResponse, Controller } from '@zintrust/core';
+import { type IRequest, type IResponse, Controller } from '../../index.js';
 
 function handleError(res: IResponse, error: unknown): void {
   const message = error instanceof Error ? error.message : 'GraphQL error';
@@ -494,7 +494,7 @@ function generateWebhookController(options) {
  * Auto-generated Webhook controller
  */
 
-import { type IRequest, type IResponse, Controller } from '@zintrust/core';
+import { type IRequest, type IResponse, Controller } from '../../index.js';
 import { Logger } from '../../config/logger';
 
 function handleError(res: IResponse, error: unknown): void {

package/src/cli/scaffolding/GovernanceScaffolder.js

@@ -200,7 +200,7 @@ describe('Architecture: import boundaries', () => {
 `;
 const ROUTE_MIDDLEWARE_REGISTRY_ARCH_TEST_CONTENT = `import { middlewareConfigObj } from '../../config/middleware';
 import { registerRoutes } from '../../../routes/api';
-import { RouteRegistry, Router } from '@zintrust/core';
+import { RouteRegistry, Router } from '../../index.js';
 import { beforeEach, describe, expect, it } from 'vitest';
 
 describe('Architecture: route middleware registry', () => {

package/src/cli/scaffolding/MigrationGenerator.js

@@ -160,7 +160,7 @@ function resolveMigrationImportBlock(migrationsPath) {
             // fall through
         }
     }
-    return `import { MigrationSchema, type Blueprint, type IDatabase } from '@zintrust/core';`;
+    return `import { MigrationSchema, type Blueprint, type IDatabase } from '../../index.js';`;
 }
 /**
  * Generate CREATE migration

package/src/cli/scaffolding/ModelGenerator.js

@@ -84,7 +84,7 @@ function buildModelCode(options) {
  * Auto-generated model file
  */
 
-import { type IModel, Model } from '@zintrust/core';
+import { type IModel, Model } from '../../index.js';
 
 export const ${options.name} = Object.freeze(
   Model.define({

package/src/cli/scaffolding/RouteGenerator.js

@@ -96,7 +96,7 @@ ${routeRegistration}
  * Build import statements
  */
 function buildImports(options) {
-    const imports = ["import { Router, type IRouter } from '@zintrust/core';"];
+    const imports = ["import { Router, type IRouter } from '../../index.js';"];
     // Collect unique controllers
     const controllers = new Set();
     for (const route of options.routes) {

package/src/cli/scaffolding/ServiceScaffolder.js

@@ -162,7 +162,7 @@ function generateServiceIndex(options) {
  * Auth: ${options.auth ?? 'api-key'}
  */
 
-import { Application, Server } from '@zintrust/core';
+import { Application, Server } from '../../index.js';
 import { Logger } from '../../config/logger';
 import { Env } from '../../config/env';
 import { esmDirname } from '../../common/index';
@@ -192,7 +192,7 @@ function generateServiceRoutes(options) {
  * ${options.name} Service Routes
  */
 
-import { Router, type IRouter } from '@zintrust/core';
+import { Router, type IRouter } from '../../index.js';
 
 export function registerRoutes(router: IRouter): void {
   // Example route
@@ -222,7 +222,7 @@ function generateExampleController(options) {
  * Example Controller for ${options.name} Service
  */
 
-import { type IRequest, type IResponse, Controller } from '@zintrust/core';
+import { type IRequest, type IResponse, Controller } from '../../index.js';
 
 const controller = Object.freeze({
   ...Controller,
@@ -285,7 +285,7 @@ function generateExampleModel(options) {
  * Example Model for ${options.name} Service
  */
 
-import { Model } from '@zintrust/core';
+import { Model } from '../../index.js';
 
 export const Example = Model.define({
   table: '${options.name}',

package/src/config/broadcast.d.ts

@@ -4,33 +4,19 @@
  * Centralizes broadcast driver selection and provider env mappings.
  * Driver selection must be dynamic (tests may mutate process.env).
  */
-import type { InMemoryBroadcastDriverConfig, KnownBroadcastDriverConfig, PusherBroadcastDriverConfig, RedisBroadcastDriverConfig, RedisHttpsBroadcastDriverConfig } from './type';
-declare const _default: Readonly<{
-    /**
-     * Default broadcaster name (normalized).
-     */
-    readonly default: string;
-    /**
-     * Broadcast drivers.
-     *
-     * You may add custom named broadcasters (e.g. `ops`, `billing`) that point to any
-     * known driver config.
-     */
-    readonly drivers: {
-        readonly inmemory: InMemoryBroadcastDriverConfig;
-        readonly pusher: PusherBroadcastDriverConfig;
-        readonly redis: RedisBroadcastDriverConfig;
-        readonly redishttps: RedisHttpsBroadcastDriverConfig;
-    };
-    /**
-     * Normalized broadcast driver name for the default broadcaster.
-     */
-    readonly getDriverName: () => string;
-    /**
-     * Get a config object for the currently selected driver.
-     * Defaults to inmemory for unknown/unsupported names.
-     */
-    readonly getDriverConfig: (name?: string) => KnownBroadcastDriverConfig;
+import type { BroadcastDrivers, KnownBroadcastDriverConfig } from './type';
+export type BroadcastConfigOverrides = Partial<{
+    default: string;
+    drivers: Record<string, KnownBroadcastDriverConfig>;
 }>;
-export default _default;
+type BroadcastRuntimeConfig = {
+    default: string;
+    drivers: BroadcastDrivers;
+    getDriverName: () => string;
+    getDriverConfig: (name?: string) => KnownBroadcastDriverConfig;
+};
+declare const createBroadcastConfig: () => BroadcastRuntimeConfig;
+export type BroadcastConfig = ReturnType<typeof createBroadcastConfig>;
+declare const broadcastConfig: BroadcastConfig;
+export default broadcastConfig;
 //# sourceMappingURL=broadcast.d.ts.map

package/src/config/broadcast.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"broadcast.d.ts","sourceRoot":"","sources":["../../../src/config/broadcast.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAGV,6BAA6B,EAC7B,0BAA0B,EAC1B,2BAA2B,EAC3B,0BAA0B,EAC1B,+BAA+B,EAChC,MAAM,cAAc,CAAC;;IA4EpB;;OAEG;sBACY,MAAM;IAIrB;;;;;OAKG;;2BAEe,6BAA6B;;;;;IAc/C;;OAEG;kCACc,MAAM;IAIvB;;;OAGG;sCACoB,MAAM,KAAG,0BAA0B;;AAK5D,wBAAiD"}
+{"version":3,"file":"broadcast.d.ts","sourceRoot":"","sources":["../../../src/config/broadcast.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAEV,gBAAgB,EAEhB,0BAA0B,EAI3B,MAAM,cAAc,CAAC;AAGtB,MAAM,MAAM,wBAAwB,GAAG,OAAO,CAAC;IAC7C,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC;CACrD,CAAC,CAAC;AAEH,KAAK,sBAAsB,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,gBAAgB,CAAC;IAC1B,aAAa,EAAE,MAAM,MAAM,CAAC;IAC5B,eAAe,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,0BAA0B,CAAC;CAChE,CAAC;AA0EF,QAAA,MAAM,qBAAqB,QAAO,sBAoDjC,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAqBvE,QAAA,MAAM,eAAe,EAAE,eAYrB,CAAC;AAEH,eAAe,eAAe,CAAC"}

package/src/config/broadcast.js

@@ -4,6 +4,7 @@
  * Centralizes broadcast driver selection and provider env mappings.
  * Driver selection must be dynamic (tests may mutate process.env).
  */
+import { StartupConfigFile, StartupConfigFileRegistry } from '../runtime/StartupConfigFileRegistry.js';
 import { Env } from './env.js';
 import { ErrorFactory } from '../exceptions/ZintrustError.js';
 const normalizeDriverName = (value) => value.trim().toLowerCase();
@@ -60,45 +61,78 @@ const getBroadcastDriver = (config, name) => {
         return fallback;
     throw ErrorFactory.createConfigError('No broadcast drivers are configured');
 };
-const broadcastConfigObj = {
-    /**
-     * Default broadcaster name (normalized).
-     */
-    get default() {
-        return getDefaultBroadcaster(this.drivers);
-    },
-    /**
-     * Broadcast drivers.
-     *
-     * You may add custom named broadcasters (e.g. `ops`, `billing`) that point to any
-     * known driver config.
-     */
-    drivers: {
-        get inmemory() {
-            return { driver: 'inmemory' };
+const createBroadcastConfig = () => {
+    const overrides = StartupConfigFileRegistry.get(StartupConfigFile.Broadcast) ?? {};
+    const broadcastConfigObj = {
+        /**
+         * Default broadcaster name (normalized).
+         */
+        get default() {
+            const overrideDefault = overrides.default;
+            if (typeof overrideDefault === 'string' && overrideDefault.trim().length > 0) {
+                const value = normalizeDriverName(overrideDefault);
+                if (value.length > 0 && hasOwn(this.drivers, value))
+                    return value;
+                throw ErrorFactory.createConfigError(`Broadcast driver not configured: ${value}`);
+            }
+            return getDefaultBroadcaster(this.drivers);
         },
-        get pusher() {
-            return getPusherConfig();
+        /**
+         * Broadcast drivers.
+         *
+         * You may add custom named broadcasters (e.g. `ops`, `billing`) that point to any
+         * known driver config.
+         */
+        get drivers() {
+            return {
+                inmemory: { driver: 'inmemory' },
+                pusher: getPusherConfig(),
+                redis: getRedisConfig(),
+                redishttps: getRedisHttpsConfig(),
+                ...(overrides.drivers ?? {}),
+            };
         },
-        get redis() {
-            return getRedisConfig();
+        /**
+         * Normalized broadcast driver name for the default broadcaster.
+         */
+        getDriverName() {
+            return normalizeDriverName(this.default);
         },
-        get redishttps() {
-            return getRedisHttpsConfig();
+        /**
+         * Get a config object for the currently selected driver.
+         * Defaults to inmemory for unknown/unsupported names.
+         */
+        getDriverConfig(name) {
+            return getBroadcastDriver(this, name);
         },
+    };
+    return Object.freeze(broadcastConfigObj);
+};
+let cached = null;
+const proxyTarget = {};
+const ensureBroadcastConfig = () => {
+    if (cached)
+        return cached;
+    cached = createBroadcastConfig();
+    try {
+        Object.defineProperties(proxyTarget, Object.getOwnPropertyDescriptors(cached));
+    }
+    catch {
+        // best-effort
+    }
+    return cached;
+};
+const broadcastConfig = new Proxy(proxyTarget, {
+    get(_target, prop) {
+        return ensureBroadcastConfig()[prop];
     },
-    /**
-     * Normalized broadcast driver name for the default broadcaster.
-     */
-    getDriverName() {
-        return normalizeDriverName(this.default);
+    ownKeys() {
+        ensureBroadcastConfig();
+        return Reflect.ownKeys(proxyTarget);
     },
-    /**
-     * Get a config object for the currently selected driver.
-     * Defaults to inmemory for unknown/unsupported names.
-     */
-    getDriverConfig(name) {
-        return getBroadcastDriver(this, name);
+    getOwnPropertyDescriptor(_target, prop) {
+        ensureBroadcastConfig();
+        return Object.getOwnPropertyDescriptor(proxyTarget, prop);
     },
-};
-export default Object.freeze(broadcastConfigObj);
+});
+export default broadcastConfig;

package/src/config/cache.d.ts

@@ -3,53 +3,21 @@
  * Caching drivers and settings
  * Sealed namespace for immutability
  */
-import type { CacheDriverConfig } from './type';
-export declare const cacheConfig: Readonly<{
-    /**
-     * Default cache driver
-     */
+import type { CacheConfigInput, CacheDriverConfig } from './type';
+export type CacheConfigOverrides = Partial<{
     default: string;
-    /**
-     * Cache drivers
-     */
-    drivers: {
-        memory: {
-            driver: "memory";
-            ttl: number;
-        };
-        redis: {
-            driver: "redis";
-            host: string;
-            port: number;
-            ttl: number;
-        };
-        mongodb: {
-            driver: "mongodb";
-            uri: string;
-            db: string;
-            ttl: number;
-        };
-        kv: {
-            driver: "kv";
-            ttl: number;
-        };
-        'kv-remote': {
-            driver: "kv-remote";
-            ttl: number;
-        };
-    };
-    /**
-     * Get cache driver config
-     */
-    getDriver(name?: string): CacheDriverConfig;
-    /**
-     * Key prefix for all cache keys
-     */
+    drivers: CacheConfigInput['drivers'];
     keyPrefix: string;
-    /**
-     * Default cache TTL (seconds)
-     */
     ttl: number;
 }>;
-export type CacheConfig = typeof cacheConfig;
+declare const createCacheConfig: () => {
+    default: string;
+    drivers: CacheConfigInput["drivers"];
+    getDriver: (name?: string) => CacheDriverConfig;
+    keyPrefix: string;
+    ttl: number;
+};
+export type CacheConfig = ReturnType<typeof createCacheConfig>;
+export declare const cacheConfig: CacheConfig;
+export {};
 //# sourceMappingURL=cache.d.ts.map

package/src/config/cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/config/cache.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAoB,iBAAiB,EAAE,MAAM,cAAc,CAAC;AA2FxE,eAAO,MAAM,WAAW;IA/DtB;;OAEG;;IAaH;;OAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;IA4BH;;OAEG;qBACc,MAAM,GAAG,iBAAiB;IAI3C;;OAEG;;IAGH;;OAEG;;EAImD,CAAC;AACzD,MAAM,MAAM,WAAW,GAAG,OAAO,WAAW,CAAC"}
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../../src/config/cache.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGxE,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CACb,CAAC,CAAC;AA0BH,QAAA,MAAM,iBAAiB,QAAO;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;IACrC,SAAS,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,iBAAiB,CAAC;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;CA4Fb,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAqB/D,eAAO,MAAM,WAAW,EAAE,WAYxB,CAAC"}