@zintrust/core 0.1.19 → 0.1.21

package/src/common/utility.d.ts

@@ -0,0 +1,38 @@
+export declare const generateUuid: () => string;
+export declare function generateSecureJobId(errMsg?: string): string;
+export declare const getString: (value: unknown) => string;
+export declare function isEmpty(value: unknown): boolean;
+export declare function toStr(value: unknown): string;
+export declare function stripSpaces(value: unknown): string;
+export declare function sanitize(value: unknown, pattern: RegExp, stripSpace?: boolean): string;
+export declare function isNumericString(value: string): boolean;
+export declare function toPlusDecimal(num: unknown, dec?: number): number;
+export declare function toMinusDecimal(num: unknown, dec?: number): number;
+export declare const nowIso: () => string;
+export interface UtilitiesType {
+    generateUuid: () => string;
+    getString: (value: unknown) => string;
+    generateSecureJobId: (errMsg?: string) => string;
+    isEmpty: (value: unknown) => boolean;
+    toStr: (value: unknown) => string;
+    stripSpaces: (value: unknown) => string;
+    sanitize: (value: unknown, pattern: RegExp, stripSpace?: boolean) => string;
+    isNumericString: (value: string) => boolean;
+    toPlusDecimal: (num: unknown, dec?: number) => number;
+    toMinusDecimal: (num: unknown, dec?: number) => number;
+    nowIso: () => string;
+}
+export declare const Utilities: Readonly<{
+    generateUuid: () => string;
+    getString: (value: unknown) => string;
+    generateSecureJobId: typeof generateSecureJobId;
+    isEmpty: typeof isEmpty;
+    toStr: typeof toStr;
+    stripSpaces: typeof stripSpaces;
+    sanitize: typeof sanitize;
+    isNumericString: typeof isNumericString;
+    toPlusDecimal: typeof toPlusDecimal;
+    toMinusDecimal: typeof toMinusDecimal;
+    nowIso: () => string;
+}>;
+//# sourceMappingURL=utility.d.ts.map

package/src/common/utility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utility.d.ts","sourceRoot":"","sources":["../../../src/common/utility.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,YAAY,QAAO,MAG/B,CAAC;AAEF,wBAAgB,mBAAmB,CACjC,MAAM,GAAE,MAAgE,GACvE,MAAM,CAoBR;AAED,eAAO,MAAM,SAAS,GAAI,OAAO,OAAO,KAAG,MAAkD,CAAC;AAQ9F,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAS/C;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE5C;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAElD;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,UAAQ,GAAG,MAAM,CAGpF;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAKtD;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,SAAI,GAAG,MAAM,CAqB3D;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,SAAI,GAAG,MAAM,CAe5D;AAED,eAAO,MAAM,MAAM,QAAO,MAAkC,CAAC;AAE7D,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,MAAM,CAAC;IAC3B,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC;IACtC,mBAAmB,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IACjD,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC;IACrC,KAAK,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC;IAClC,WAAW,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC;IACxC,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,OAAO,KAAK,MAAM,CAAC;IAC5E,eAAe,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;IAC5C,aAAa,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IACtD,cAAc,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IACvD,MAAM,EAAE,MAAM,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,SAAS;wBA5HU,MAAM;uBA6BL,OAAO,KAAG,MAAM;;;;;;;;;kBA+EvB,MAAM;EA4B9B,CAAC"}

package/src/common/utility.js

@@ -0,0 +1,101 @@
+import { ErrorFactory } from '../exceptions/ZintrustError.js';
+import { randomBytes } from '../node-singletons/crypto.js';
+export const generateUuid = () => {
+    if (typeof globalThis?.crypto?.randomUUID === 'function')
+        return globalThis.crypto.randomUUID();
+    return `${Date.now()}-${Math.random().toString(36).slice(2, 9)}`; // NOSONAR
+};
+export function generateSecureJobId(errMsg = 'Secure crypto API not available to generate a job id.') {
+    if (typeof globalThis.crypto?.randomUUID === 'function') {
+        return globalThis.crypto.randomUUID();
+    }
+    if (typeof globalThis.crypto?.getRandomValues === 'function') {
+        const bytes = new Uint8Array(16);
+        globalThis.crypto.getRandomValues(bytes);
+        return bytesToHex(bytes);
+    }
+    // Node fallback for environments without Web Crypto
+    try {
+        return randomBytes(16).toString('hex');
+    }
+    catch (error) {
+        throw ErrorFactory.createTryCatchError(errMsg || 'Secure crypto API not available to generate a job id.', error);
+    }
+}
+export const getString = (value) => (typeof value === 'string' ? value : '');
+function bytesToHex(bytes) {
+    let out = '';
+    for (const b of bytes)
+        out += b.toString(16).padStart(2, '0');
+    return out;
+}
+export function isEmpty(value) {
+    return (value === null ||
+        value === undefined ||
+        value === false ||
+        value === 0 ||
+        value === '' ||
+        value === '0');
+}
+export function toStr(value) {
+    return String(value ?? '');
+}
+export function stripSpaces(value) {
+    return toStr(value).replaceAll(' ', '');
+}
+export function sanitize(value, pattern, stripSpace = false) {
+    const input = stripSpace ? stripSpaces(value) : toStr(value);
+    return input.replace(pattern, '');
+}
+export function isNumericString(value) {
+    const trimmed = value.trim();
+    if (trimmed.length === 0)
+        return false;
+    const n = Number(trimmed);
+    return Number.isFinite(n);
+}
+export function toPlusDecimal(num, dec = 8) {
+    if (isEmpty(num))
+        return 0;
+    const numStr = toStr(num);
+    const hasDot = numStr.includes('.');
+    const hasExponent = /e/i.test(numStr);
+    const normalized = hasExponent ? Number(numStr).toFixed(dec + 1) : numStr;
+    const valueNew = hasDot
+        ? (() => {
+            const [whole, frac = ''] = normalized.split('.');
+            return Number.parseFloat(`${whole}.${frac.slice(0, dec)}`);
+        })()
+        : Number.parseFloat(normalized);
+    if (valueNew < 0 && String(valueNew).startsWith('-')) {
+        return 0;
+    }
+    return valueNew;
+}
+export function toMinusDecimal(num, dec = 8) {
+    if (isEmpty(num))
+        return 0;
+    const numStr = toStr(num);
+    const hasDot = numStr.includes('.');
+    const hasExponent = /e/i.test(numStr);
+    const normalized = hasExponent ? Number(numStr).toFixed(dec + 1) : numStr;
+    if (hasDot) {
+        const [whole, frac = ''] = normalized.split('.');
+        return Number.parseFloat(`${whole}.${frac.slice(0, dec)}`);
+    }
+    return Number.parseFloat(normalized);
+}
+export const nowIso = () => new Date().toISOString();
+export const Utilities = Object.freeze({
+    generateUuid,
+    getString,
+    generateSecureJobId,
+    isEmpty,
+    toStr,
+    stripSpaces,
+    sanitize,
+    isNumericString,
+    toPlusDecimal,
+    toMinusDecimal,
+    nowIso,
+});

package/src/config/FileLogWriter.d.ts

@@ -2,7 +2,7 @@
  * FileLogWriter (Node.js only)
  *
  * Provides best-effort file logging with daily + size-based rotation.
- * This module imports Node built-ins and should be loaded only in Node environments.
+ * Uses async write streams to avoid blocking the event loop.
  */
 type CleanOnceOptions = {
     logsDir?: string;
@@ -17,6 +17,7 @@ type CleanOnceOptions = {
 export declare const cleanOnce: (options?: CleanOnceOptions) => string[];
 export declare const FileLogWriter: Readonly<{
     write(line: string): void;
+    flush(): void;
 }>;
 export default FileLogWriter;
 //# sourceMappingURL=FileLogWriter.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"FileLogWriter.d.ts","sourceRoot":"","sources":["../../../src/config/FileLogWriter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA8EH,KAAK,gBAAgB,GAAG;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAiFF;;;GAGG;AACH,eAAO,MAAM,SAAS,GAAI,UAAU,gBAAgB,KAAG,MAAM,EAsB5D,CAAC;AAoBF,eAAO,MAAM,aAAa;gBACZ,MAAM,GAAG,IAAI;EAqBzB,CAAC;AAEH,eAAe,aAAa,CAAC"}
+{"version":3,"file":"FileLogWriter.d.ts","sourceRoot":"","sources":["../../../src/config/FileLogWriter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAwGH,KAAK,gBAAgB,GAAG;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAiFF;;;GAGG;AACH,eAAO,MAAM,SAAS,GAAI,UAAU,gBAAgB,KAAG,MAAM,EAsB5D,CAAC;AAwEF,eAAO,MAAM,aAAa;gBACZ,MAAM,GAAG,IAAI;aAqChB,IAAI;EAQb,CAAC;AAEH,eAAe,aAAa,CAAC"}

package/src/config/FileLogWriter.js

@@ -2,12 +2,34 @@
  * FileLogWriter (Node.js only)
  *
  * Provides best-effort file logging with daily + size-based rotation.
- * This module imports Node built-ins and should be loaded only in Node environments.
+ * Uses async write streams to avoid blocking the event loop.
  */
 import { ensureDirSafe } from '../common/index.js';
 import { Env } from './env.js';
 import * as fs from '../node-singletons/fs.js';
 import * as path from '../node-singletons/path.js';
+// Write stream cache to avoid recreating streams
+const streamCache = new Map();
+const pendingWrites = new Map();
+const canUseWriteStreams = () => {
+    try {
+        // Vitest's ESM module mocks can throw when accessing missing exports.
+        // Treat missing createWriteStream as "no stream support".
+        return (typeof fs.createWriteStream === 'function');
+    }
+    catch {
+        return false;
+    }
+};
+const appendFileSafe = (logFile, content) => {
+    try {
+        // Some tests/mock environments provide only appendFileSync (no streams).
+        fs.appendFileSync(logFile, content);
+    }
+    catch {
+        // best-effort
+    }
+};
 const getCwdSafe = () => {
     try {
         if (typeof process === 'undefined' || typeof process.cwd !== 'function')
@@ -160,6 +182,12 @@ const rotateIfNeeded = (logFile, maxSizeBytes) => {
         const stat = fs.statSync(logFile);
         if (stat.size <= maxSizeBytes)
             return;
+        // Close and clear existing stream before rotation
+        const stream = streamCache.get(logFile);
+        if (stream !== undefined) {
+            stream.end();
+            streamCache.delete(logFile);
+        }
         const ext = '.log';
         const base = logFile.endsWith(ext) ? logFile.slice(0, -ext.length) : logFile;
         const rotated = `${base}-${Date.now()}${ext}`;
@@ -169,6 +197,38 @@ const rotateIfNeeded = (logFile, maxSizeBytes) => {
         // best-effort
     }
 };
+const getOrCreateStream = (logFile) => {
+    let stream = streamCache.get(logFile);
+    if (stream === undefined || stream.destroyed) {
+        const createWriteStream = fs
+            .createWriteStream;
+        stream = createWriteStream(logFile, { flags: 'a', encoding: 'utf-8' });
+        // Clean up on error
+        stream.on('error', () => {
+            streamCache.delete(logFile);
+        });
+        streamCache.set(logFile, stream);
+    }
+    return stream;
+};
+const flushPendingWrites = (logFile) => {
+    const pending = pendingWrites.get(logFile);
+    if (pending === undefined || pending.length === 0)
+        return;
+    const lines = pending.join('');
+    if (!canUseWriteStreams()) {
+        appendFileSafe(logFile, lines);
+        pendingWrites.delete(logFile);
+        return;
+    }
+    const stream = getOrCreateStream(logFile);
+    stream.write(lines, (error) => {
+        if (error !== null && error !== undefined) {
+            // Silent failure for best-effort logging
+        }
+    });
+    pendingWrites.delete(logFile);
+};
 export const FileLogWriter = Object.freeze({
     write(line) {
         const cwd = getCwdSafe();
@@ -179,8 +239,20 @@ export const FileLogWriter = Object.freeze({
         const dateStr = getDateStr(new Date());
         const logFile = path.join(logsDir, `app-${dateStr}.log`);
         rotateIfNeeded(logFile, Env.LOG_ROTATION_SIZE);
+        // In test environments we sometimes mock @node-singletons/fs without stream APIs.
+        // Fall back to synchronous append to avoid runtime crashes.
+        if (!canUseWriteStreams()) {
+            appendFileSafe(logFile, `${line}\n`);
+            cleanupOldLogs(logsDir, Env.LOG_ROTATION_DAYS);
+            return;
+        }
         try {
-            fs.appendFileSync(logFile, `${line}\n`);
+            // Buffer writes for async processing
+            const pending = pendingWrites.get(logFile) ?? [];
+            pending.push(`${line}\n`);
+            pendingWrites.set(logFile, pending);
+            // Flush on next tick to batch multiple rapid writes
+            process.nextTick(() => flushPendingWrites(logFile));
         }
         catch {
             // best-effort
@@ -188,5 +260,14 @@ export const FileLogWriter = Object.freeze({
         }
         cleanupOldLogs(logsDir, Env.LOG_ROTATION_DAYS);
     },
+    // Flush all streams (for graceful shutdown)
+    flush() {
+        for (const [logFile, stream] of streamCache.entries()) {
+            flushPendingWrites(logFile);
+            stream.end();
+        }
+        streamCache.clear();
+        pendingWrites.clear();
+    },
 });
 export default FileLogWriter;

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

@@ -1 +1 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../../src/config/app.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAA4B,SAAS,EAAE,MAAM,cAAc,CAAC;AAsCxE,QAAA,MAAM,UAAU,QAAO,MAAM,CAAC,UAuB7B,CAAC;AA0FF,eAAO,MAAM,SAAS;IA5EpB;;OAEG;;IAMH;;OAEG;;IAGH;;OAEG;;IAMH;;OAEG;;IAMH;;OAEG;kCACc,OAAO;IAIxB;;OAEG;iCACa,OAAO;IAIvB;;OAEG;8BACU,OAAO;IAIpB;;OAEG;;IAMH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;+BA3GkB,MAAM,CAAC,UAAU;EAiHY,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,CAAC;AAEtB,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../../src/config/app.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAA4B,SAAS,EAAE,MAAM,cAAc,CAAC;AAsCxE,QAAA,MAAM,UAAU,QAAO,MAAM,CAAC,UA0B7B,CAAC;AA0FF,eAAO,MAAM,SAAS;IA5EpB;;OAEG;;IAMH;;OAEG;;IAGH;;OAEG;;IAMH;;OAEG;;IAMH;;OAEG;kCACc,OAAO;IAIxB;;OAEG;iCACa,OAAO;IAIvB;;OAEG;8BACU,OAAO;IAIpB;;OAEG;;IAMH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;+BA9GkB,MAAM,CAAC,UAAU;EAoHY,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,CAAC;AAEtB,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC"}

package/src/config/app.js

@@ -42,7 +42,9 @@ const getSafeEnv = () => {
             readEnvString('NODE_ENV', 'development'),
         USE_RAW_QRY: baseEnv.USE_RAW_QRY ?? (readEnvString('USE_RAW_QRY', '') || undefined),
         SERVICE_API_KEY: baseEnv.SERVICE_API_KEY ?? readEnvString('SERVICE_API_KEY', ''),
-        SERVICE_JWT_SECRET: baseEnv.SERVICE_JWT_SECRET ?? readEnvString('SERVICE_JWT_SECRET', ''),
+        SERVICE_JWT_SECRET: baseEnv.SERVICE_JWT_SECRET ??
+            readEnvString('SERVICE_JWT_SECRET', '') ??
+            readEnvString('APP_KEY', ''),
         BASE_URL: baseEnv['BASE_URL'] ?? readEnvString('BASE_URL', ''),
         MODE: baseEnv['MODE'] ?? readEnvString('MODE', ''),
         // Hardening for child-process usage

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 { 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,EAGL,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 { 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,EAAoB,iBAAiB,EAAE,MAAM,cAAc,CAAC;AA2FnE,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"}