@zintrust/core 0.1.13 → 0.1.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zintrust/core",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "description": "Production-grade TypeScript backend framework for JavaScript",
   "homepage": "https://zintrust.com",
   "repository": {

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,EAAE,iBAAiB,EAAoB,MAAM,8BAA8B,CAAC;AAEnF,OAAO,EAAE,gBAAgB,EAAmB,MAAM,8BAA8B,CAAC;AACjF,OAAO,EAAE,KAAK,OAAO,EAAU,MAAM,kBAAkB,CAAC;AAOxD,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;AA2LD;;GAEG;AACH,eAAO,MAAM,WAAW;IACtB;;OAEG;sBACe,MAAM,GAAG,YAAY;EAmDvC,CAAC;AAEH,eAAe,WAAW,CAAC"}
+{"version":3,"file":"Application.d.ts","sourceRoot":"","sources":["../../../src/boot/Application.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,iBAAiB,EAAoB,MAAM,8BAA8B,CAAC;AAEnF,OAAO,EAAE,gBAAgB,EAAmB,MAAM,8BAA8B,CAAC;AACjF,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;AAsUD;;GAEG;AACH,eAAO,MAAM,WAAW;IACtB;;OAEG;sBACe,MAAM,GAAG,YAAY;EA0CvC,CAAC;AAEH,eAAe,WAAW,CAAC"}

package/src/boot/Application.js

@@ -2,13 +2,15 @@
  * Application - Framework core entry point
  * Handles application lifecycle, booting, and environment
  */
-import { appConfig } from '../config/index.js';
+import { appConfig, cacheConfig, databaseConfig, queueConfig, storageConfig } from '../config/index.js';
 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 broadcastConfig from '../config/broadcast.js';
 import { FeatureFlags } from '../config/features.js';
 import { Logger } from '../config/logger.js';
+import notificationConfig from '../config/notification.js';
 import { StartupConfigValidator } from '../config/StartupConfigValidator.js';
 import * as path from '../node-singletons/path.js';
 import { pathToFileURL } from '../node-singletons/url.js';
@@ -55,6 +57,83 @@ const registerCoreInstances = (params) => {
     params.container.singleton('container', params.container);
     params.container.singleton('shutdownManager', params.shutdownManager);
 };
+const registerFrameworkShutdownHooks = (shutdownManager) => {
+    // Register framework-level shutdown hooks for long-lived resources
+    // ConnectionManager may not be initialized; shutdownIfInitialized is safe
+    // Use dynamic import without top-level await to avoid transforming the module into an async module
+    import('../orm/ConnectionManager.js')
+        .then((mod) => {
+        shutdownManager.add(async () => mod.ConnectionManager.shutdownIfInitialized());
+    })
+        /* c8 ignore start */
+        .catch(() => {
+        /* ignore import failures in restrictive runtimes */
+    });
+    /* c8 ignore stop */
+    import('../orm/Database.js')
+        .then((mod) => {
+        shutdownManager.add(() => mod.resetDatabase());
+    })
+        /* c8 ignore start */
+        .catch(() => {
+        /* ignore import failures in restrictive runtimes */
+    });
+    /* c8 ignore stop */
+    import('../cache/Cache.js')
+        .then((mod) => {
+        shutdownManager.add(() => mod.Cache.reset());
+    })
+        /* c8 ignore start */
+        .catch(() => {
+        /* ignore import failures in restrictive runtimes */
+    });
+    /* c8 ignore stop */
+    import('../tools/broadcast/BroadcastRegistry.js')
+        .then((mod) => {
+        shutdownManager.add(() => mod.BroadcastRegistry.reset());
+    })
+        /* c8 ignore start */
+        .catch(() => {
+        /* ignore import failures in restrictive runtimes */
+    });
+    /* c8 ignore stop */
+    import('../tools/storage/StorageDiskRegistry.js')
+        .then((mod) => {
+        shutdownManager.add(() => mod.StorageDiskRegistry.reset());
+    })
+        /* c8 ignore start */
+        .catch(() => {
+        /* ignore import failures in restrictive runtimes */
+    });
+    /* c8 ignore stop */
+    import('../tools/notification/NotificationChannelRegistry.js')
+        .then((mod) => {
+        shutdownManager.add(() => mod.NotificationChannelRegistry.reset());
+    })
+        /* c8 ignore start */
+        .catch(() => {
+        /* ignore import failures in restrictive runtimes */
+    });
+    /* c8 ignore stop */
+    import('../tools/mail/MailDriverRegistry.js')
+        .then((mod) => {
+        shutdownManager.add(() => mod.MailDriverRegistry.reset());
+    })
+        /* c8 ignore start */
+        .catch(() => {
+        /* ignore import failures in restrictive runtimes */
+    });
+    /* c8 ignore stop */
+    import('../tools/queue/Queue.js')
+        .then((mod) => {
+        shutdownManager.add(() => mod.Queue.reset());
+    })
+        /* c8 ignore start */
+        .catch(() => {
+        /* ignore import failures in restrictive runtimes */
+    });
+    /* c8 ignore stop */
+};
 const tryImportRoutesFromAppBase = async (resolvedBasePath) => {
     if (resolvedBasePath === '')
         return undefined;
@@ -118,6 +197,34 @@ const initializeArtifactDirectories = async (resolvedBasePath) => {
         }
     }
 };
+const tryImportOptional = async (modulePath) => {
+    try {
+        return (await import(modulePath));
+    }
+    catch {
+        return undefined;
+    }
+};
+const registerFromRuntimeConfig = async () => {
+    const db = await tryImportOptional('@orm/DatabaseRuntimeRegistration');
+    db?.registerDatabasesFromRuntimeConfig?.(databaseConfig);
+    const queues = await tryImportOptional('@tools/queue/QueueRuntimeRegistration');
+    queues?.registerQueuesFromRuntimeConfig?.(queueConfig);
+    const caches = await tryImportOptional('@cache/CacheRuntimeRegistration');
+    caches?.registerCachesFromRuntimeConfig?.(cacheConfig);
+    const broadcasters = await tryImportOptional('@broadcast/BroadcastRuntimeRegistration');
+    broadcasters?.registerBroadcastersFromRuntimeConfig?.({
+        default: broadcastConfig.default,
+        drivers: broadcastConfig.drivers,
+    });
+    const disks = await tryImportOptional('@storage/StorageRuntimeRegistration');
+    disks?.registerDisksFromRuntimeConfig?.(storageConfig);
+    const notifications = await tryImportOptional('@notification/NotificationRuntimeRegistration');
+    notifications?.registerNotificationChannelsFromRuntimeConfig?.({
+        default: notificationConfig.default,
+        drivers: notificationConfig.drivers,
+    });
+};
 const createLifecycle = (params) => {
     const boot = async () => {
         if (params.getBooted())
@@ -126,6 +233,7 @@ const createLifecycle = (params) => {
         StartupConfigValidator.assertValid();
         FeatureFlags.initialize();
         await StartupHealthChecks.assertHealthy();
+        await registerFromRuntimeConfig();
         await initializeArtifactDirectories(params.resolvedBasePath);
         await registerRoutes(params.resolvedBasePath, params.router);
         // Register service providers
@@ -164,16 +272,7 @@ export const Application = Object.freeze({
         let booted = false;
         registerCorePaths(container, resolvedBasePath, joinFromBase);
         registerCoreInstances({ container, environment, router, middlewareStack, shutdownManager });
-        // Register framework-level shutdown hooks for long-lived resources
-        // ConnectionManager may not be initialized; shutdownIfInitialized is safe
-        // Use dynamic import without top-level await to avoid transforming the module into an async module
-        import('../orm/ConnectionManager.js')
-            .then(({ ConnectionManager }) => {
-            shutdownManager.add(async () => ConnectionManager.shutdownIfInitialized());
-        })
-            .catch(() => {
-            /* ignore import failures in restrictive runtimes */
-        });
+        registerFrameworkShutdownHooks(shutdownManager);
         const { boot, shutdown } = createLifecycle({
             environment,
             resolvedBasePath,

package/src/cache/Cache.d.ts

@@ -4,6 +4,14 @@
  * Sealed namespace pattern - all exports through Cache namespace
  */
 import { CacheDriver } from './CacheDriver';
+type CacheStore = Readonly<{
+    get: <T>(key: string) => Promise<T | null>;
+    set: <T>(key: string, value: T, ttl?: number) => Promise<void>;
+    delete: (key: string) => Promise<void>;
+    clear: () => Promise<void>;
+    has: (key: string) => Promise<boolean>;
+    getDriver: () => CacheDriver;
+}>;
 export declare const Cache: Readonly<{
     get: <T>(key: string) => Promise<T | null>;
     set: <T>(key: string, value: T, ttl?: number) => Promise<void>;
@@ -11,6 +19,8 @@ export declare const Cache: Readonly<{
     clear: () => Promise<void>;
     has: (key: string) => Promise<boolean>;
     getDriver: () => CacheDriver;
+    store: (name?: string) => CacheStore;
+    reset: () => void;
 }>;
 /**
  * Helper alias for cache
@@ -22,5 +32,8 @@ export declare const cache: Readonly<{
     clear: () => Promise<void>;
     has: (key: string) => Promise<boolean>;
     getDriver: () => CacheDriver;
+    store: (name?: string) => CacheStore;
+    reset: () => void;
 }>;
+export {};
 //# sourceMappingURL=Cache.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"Cache.d.ts","sourceRoot":"","sources":["../../../src/cache/Cache.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AA0GjD,eAAO,MAAM,KAAK;UA1CC,CAAC,OAAO,MAAM,KAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;UAQlC,CAAC,OAAO,MAAM,SAAS,CAAC,QAAQ,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;kBAOjD,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;iBAOtB,OAAO,CAAC,IAAI,CAAC;eAOb,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC;qBAQ3B,WAAW;EAY/B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,KAAK;UAtDC,CAAC,OAAO,MAAM,KAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;UAQlC,CAAC,OAAO,MAAM,SAAS,CAAC,QAAQ,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;kBAOjD,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;iBAOtB,OAAO,CAAC,IAAI,CAAC;eAOb,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC;qBAQ3B,WAAW;EAiBP,CAAC"}
+{"version":3,"file":"Cache.d.ts","sourceRoot":"","sources":["../../../src/cache/Cache.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAmHjD,KAAK,UAAU,GAAG,QAAQ,CAAC;IACzB,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC3C,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,SAAS,EAAE,MAAM,WAAW,CAAC;CAC9B,CAAC,CAAC;AA0CH,eAAO,MAAM,KAAK;UA1FC,CAAC,OAAO,MAAM,KAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;UAQlC,CAAC,OAAO,MAAM,SAAS,CAAC,QAAQ,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;kBAOjD,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;iBAOtB,OAAO,CAAC,IAAI,CAAC;eAOb,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC;qBAQ3B,WAAW;mBAaX,MAAM,KAAG,UAAU;iBAmCvB,IAAI;EAcpB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,KAAK;UAxGC,CAAC,OAAO,MAAM,KAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;UAQlC,CAAC,OAAO,MAAM,SAAS,CAAC,QAAQ,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;kBAOjD,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;iBAOtB,OAAO,CAAC,IAAI,CAAC;eAOb,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC;qBAQ3B,WAAW;mBAaX,MAAM,KAAG,UAAU;iBAmCvB,IAAI;EAmBI,CAAC"}

package/src/cache/Cache.js

@@ -11,7 +11,7 @@ import { MongoDriver } from './drivers/MongoDriver.js';
 import { RedisDriver } from './drivers/RedisDriver.js';
 import { cacheConfig } from '../config/cache.js';
 import { ErrorFactory } from '../exceptions/ZintrustError.js';
-let instance;
+const instances = new Map();
 function buildDriver(driver) {
     const maybeCreate = driver.create;
     if (typeof maybeCreate === 'function') {
@@ -22,8 +22,8 @@ function buildDriver(driver) {
     }
     throw ErrorFactory.createGeneralError('Invalid cache driver export');
 }
-function resolveDriver() {
-    const driverConfig = cacheConfig.getDriver();
+function resolveDriver(storeName) {
+    const driverConfig = cacheConfig.getDriver(storeName);
     const externalFactory = CacheDriverRegistry.get(driverConfig.driver);
     if (externalFactory !== undefined) {
         return externalFactory(driverConfig);
@@ -43,9 +43,18 @@ function resolveDriver() {
             return buildDriver(MemoryDriver);
     }
 }
-function getDriverInstance() {
-    instance ??= resolveDriver();
-    return instance;
+function getDriverInstance(storeName) {
+    const normalizedSelection = String(storeName ?? '')
+        .trim()
+        .toLowerCase();
+    const resolvedKey = normalizedSelection.length > 0 ? normalizedSelection : 'default';
+    const existing = instances.get(resolvedKey);
+    if (existing !== undefined)
+        return existing;
+    const selector = resolvedKey === 'default' ? undefined : resolvedKey;
+    const created = resolveDriver(selector);
+    instances.set(resolvedKey, created);
+    return created;
 }
 /**
  * Get an item from the cache
@@ -85,6 +94,37 @@ const has = async (key) => {
 const getDriver = () => {
     return getDriverInstance();
 };
+const store = (name) => {
+    const getFromStore = async (key) => {
+        return getDriverInstance(name).get(key);
+    };
+    const setInStore = async (key, value, ttl) => {
+        await getDriverInstance(name).set(key, value, ttl);
+    };
+    const delFromStore = async (key) => {
+        await getDriverInstance(name).delete(key);
+    };
+    const clearStore = async () => {
+        await getDriverInstance(name).clear();
+    };
+    const hasInStore = async (key) => {
+        return getDriverInstance(name).has(key);
+    };
+    const getStoreDriver = () => {
+        return getDriverInstance(name);
+    };
+    return Object.freeze({
+        get: getFromStore,
+        set: setInStore,
+        delete: delFromStore,
+        clear: clearStore,
+        has: hasInStore,
+        getDriver: getStoreDriver,
+    });
+};
+const reset = () => {
+    instances.clear();
+};
 // Sealed namespace with cache functionality
 export const Cache = Object.freeze({
     get,
@@ -93,6 +133,8 @@ export const Cache = Object.freeze({
     clear,
     has,
     getDriver,
+    store,
+    reset,
 });
 /**
  * Helper alias for cache

package/src/cache/CacheRuntimeRegistration.d.ts

@@ -0,0 +1,11 @@
+import type { CacheConfig } from '../config/cache';
+/**
+ * Register cache drivers from runtime config.
+ *
+ * This follows the framework's config-driven availability pattern:
+ * - Built-in driver factories are registered so config entries can reference them.
+ * - Named cache stores are still resolved from `cacheConfig.drivers[storeName]`.
+ * - Unknown store names throw when explicitly selected via `cacheConfig.getDriver(name)`.
+ */
+export declare function registerCachesFromRuntimeConfig(_config: CacheConfig): void;
+//# sourceMappingURL=CacheRuntimeRegistration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CacheRuntimeRegistration.d.ts","sourceRoot":"","sources":["../../../src/cache/CacheRuntimeRegistration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AASjD;;;;;;;GAOG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAM1E"}

package/src/cache/CacheRuntimeRegistration.js

@@ -0,0 +1,21 @@
+import { CacheDriverRegistry } from './CacheDriverRegistry.js';
+import { KVDriver } from './drivers/KVDriver.js';
+import { KVRemoteDriver } from './drivers/KVRemoteDriver.js';
+import { MemoryDriver } from './drivers/MemoryDriver.js';
+import { MongoDriver } from './drivers/MongoDriver.js';
+import { RedisDriver } from './drivers/RedisDriver.js';
+/**
+ * Register cache drivers from runtime config.
+ *
+ * This follows the framework's config-driven availability pattern:
+ * - Built-in driver factories are registered so config entries can reference them.
+ * - Named cache stores are still resolved from `cacheConfig.drivers[storeName]`.
+ * - Unknown store names throw when explicitly selected via `cacheConfig.getDriver(name)`.
+ */
+export function registerCachesFromRuntimeConfig(_config) {
+    CacheDriverRegistry.register('memory', () => MemoryDriver.create());
+    CacheDriverRegistry.register('redis', () => RedisDriver.create());
+    CacheDriverRegistry.register('mongodb', () => MongoDriver.create());
+    CacheDriverRegistry.register('kv', () => KVDriver.create());
+    CacheDriverRegistry.register('kv-remote', () => KVRemoteDriver.create());
+}

package/src/config/broadcast.d.ts

@@ -4,19 +4,33 @@
  * Centralizes broadcast driver selection and provider env mappings.
  * Driver selection must be dynamic (tests may mutate process.env).
  */
-import { KnownBroadcastDriverConfig } from './type';
+import { InMemoryBroadcastDriverConfig, KnownBroadcastDriverConfig, PusherBroadcastDriverConfig, RedisBroadcastDriverConfig, RedisHttpsBroadcastDriverConfig } from './type';
 declare const _default: Readonly<{
     /**
-     * Normalized broadcast driver name.
+     * Default broadcaster name (normalized).
+     */
+    readonly default: string;
+    /**
+     * Broadcast drivers.
      *
-     * NOTE: Allows custom driver names (project-specific drivers), so returns string.
+     * 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: () => KnownBroadcastDriverConfig;
+    readonly getDriverConfig: (name?: string) => KnownBroadcastDriverConfig;
 }>;
 export default _default;
 //# 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,EACL,0BAA0B,EAI3B,MAAM,cAAc,CAAC;;IA6BpB;;;;OAIG;kCACc,MAAM;IAIvB;;;OAGG;oCACgB,0BAA0B;;AAW/C,wBAAiD"}
+{"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"}

package/src/config/broadcast.js

@@ -5,7 +5,21 @@
  * Driver selection must be dynamic (tests may mutate process.env).
  */
 import { Env } from './env.js';
+import { ErrorFactory } from '../exceptions/ZintrustError.js';
 const normalizeDriverName = (value) => value.trim().toLowerCase();
+const hasOwn = (obj, key) => {
+    return Object.prototype.hasOwnProperty.call(obj, key);
+};
+const getDefaultBroadcaster = (drivers) => {
+    const envSelectedRaw = Env.get('BROADCAST_CONNECTION', Env.get('BROADCAST_DRIVER', 'inmemory'));
+    const value = normalizeDriverName(envSelectedRaw ?? 'inmemory');
+    if (value.length > 0 && hasOwn(drivers, value))
+        return value;
+    if (envSelectedRaw.trim().length > 0) {
+        throw ErrorFactory.createConfigError(`Broadcast driver not configured: ${value}`);
+    }
+    return hasOwn(drivers, 'inmemory') ? 'inmemory' : (Object.keys(drivers)[0] ?? 'inmemory');
+};
 const getPusherConfig = () => ({
     driver: 'pusher',
     appId: Env.get('PUSHER_APP_ID', ''),
@@ -27,28 +41,64 @@ const getRedisHttpsConfig = () => ({
     token: Env.get('REDIS_HTTPS_TOKEN', ''),
     channelPrefix: Env.get('BROADCAST_CHANNEL_PREFIX', 'broadcast:'),
 });
+const getBroadcastDriver = (config, name) => {
+    const selected = normalizeDriverName(String(name ?? config.default));
+    const broadcasterName = selected === 'default' ? normalizeDriverName(config.default) : selected;
+    const isExplicitSelection = name !== undefined &&
+        String(name).trim().length > 0 &&
+        normalizeDriverName(String(name)) !== 'default';
+    if (broadcasterName.length > 0 && hasOwn(config.drivers, broadcasterName)) {
+        const resolved = config.drivers[broadcasterName];
+        if (resolved !== undefined)
+            return resolved;
+    }
+    if (isExplicitSelection) {
+        throw ErrorFactory.createConfigError(`Broadcast driver not configured: ${broadcasterName}`);
+    }
+    const fallback = config.drivers['inmemory'] ?? Object.values(config.drivers)[0];
+    if (fallback !== undefined)
+        return fallback;
+    throw ErrorFactory.createConfigError('No broadcast drivers are configured');
+};
 const broadcastConfigObj = {
     /**
-     * Normalized broadcast driver name.
+     * Default broadcaster name (normalized).
+     */
+    get default() {
+        return getDefaultBroadcaster(this.drivers);
+    },
+    /**
+     * Broadcast drivers.
      *
-     * NOTE: Allows custom driver names (project-specific drivers), so returns string.
+     * You may add custom named broadcasters (e.g. `ops`, `billing`) that point to any
+     * known driver config.
+     */
+    drivers: {
+        get inmemory() {
+            return { driver: 'inmemory' };
+        },
+        get pusher() {
+            return getPusherConfig();
+        },
+        get redis() {
+            return getRedisConfig();
+        },
+        get redishttps() {
+            return getRedisHttpsConfig();
+        },
+    },
+    /**
+     * Normalized broadcast driver name for the default broadcaster.
      */
     getDriverName() {
-        return normalizeDriverName(Env.get('BROADCAST_DRIVER', 'inmemory'));
+        return normalizeDriverName(this.default);
     },
     /**
      * Get a config object for the currently selected driver.
      * Defaults to inmemory for unknown/unsupported names.
      */
-    getDriverConfig() {
-        const driver = this.getDriverName();
-        if (driver === 'pusher')
-            return getPusherConfig();
-        if (driver === 'redis')
-            return getRedisConfig();
-        if (driver === 'redishttps')
-            return getRedisHttpsConfig();
-        return { driver: 'inmemory' };
+    getDriverConfig(name) {
+        return getBroadcastDriver(this, name);
     },
 };
 export default Object.freeze(broadcastConfigObj);

package/src/config/cache.d.ts

@@ -41,7 +41,7 @@ export declare const cacheConfig: Readonly<{
     /**
      * Get cache driver config
      */
-    getDriver(): CacheDriverConfig;
+    getDriver(name?: string): CacheDriverConfig;
     /**
      * Key prefix for all cache keys
      */

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,EAAgB,MAAM,cAAc,CAAC;AAmEjF,eAAO,MAAM,WAAW;IArDtB;;OAEG;;IAGH;;OAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;IA4BH;;OAEG;iBACU,iBAAiB;IAI9B;;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;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"}

package/src/config/cache.js

@@ -4,19 +4,36 @@
  * Sealed namespace for immutability
  */
 import { Env } from './env.js';
-const getCacheDriver = (config) => {
-    const defaultDriver = config.default;
-    if (Object.hasOwn(config.drivers, defaultDriver)) {
-        const driverName = defaultDriver;
-        return config.drivers[driverName];
+import { ErrorFactory } from '../exceptions/ZintrustError.js';
+const getCacheDriver = (config, name) => {
+    const selected = String(name ?? config.default).trim();
+    const storeName = selected === 'default' ? String(config.default).trim() : selected;
+    const isExplicitSelection = name !== undefined && String(name).trim().length > 0 && String(name).trim() !== 'default';
+    if (storeName.length > 0 && Object.hasOwn(config.drivers, storeName)) {
+        const resolved = config.drivers[storeName];
+        if (resolved !== undefined)
+            return resolved;
     }
-    return config.drivers.memory;
+    if (isExplicitSelection) {
+        throw ErrorFactory.createConfigError(`Cache store not configured: ${storeName}`);
+    }
+    if (Object.keys(config.drivers ?? {}).length === 0) {
+        throw ErrorFactory.createConfigError('No cache stores are configured');
+    }
+    throw ErrorFactory.createConfigError(`Cache default store not configured: ${storeName || '<empty>'}`);
 };
 const cacheConfigObj = {
     /**
      * Default cache driver
      */
-    default: Env.CACHE_DRIVER,
+    default: (() => {
+        const envConnection = Env.get('CACHE_CONNECTION', '').trim();
+        const envDriver = typeof Env.CACHE_DRIVER === 'string'
+            ? String(Env.CACHE_DRIVER)
+            : Env.get('CACHE_DRIVER', 'memory');
+        const selected = envConnection.length > 0 ? envConnection : String(envDriver ?? 'memory');
+        return selected.trim().toLowerCase();
+    })(),
     /**
      * Cache drivers
      */
@@ -49,8 +66,8 @@ const cacheConfigObj = {
     /**
      * Get cache driver config
      */
-    getDriver() {
-        return getCacheDriver(this);
+    getDriver(name) {
+        return getCacheDriver(this, name);
     },
     /**
      * Key prefix for all cache keys

package/src/config/database.d.ts

@@ -8,7 +8,7 @@ export declare const databaseConfig: Readonly<{
     /**
      * Default database connection
      */
-    default: keyof import("./type").DatabaseConnections;
+    default: string;
     /**
      * Database connections
      */

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

@@ -1 +1 @@
-{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../../src/config/database.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,mBAAmB,EACnB,wBAAwB,EAEzB,MAAM,cAAc,CAAC;AA6FtB,eAAO,MAAM,cAAc;IA5EzB;;OAEG;;IAGH;;OAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAsCH;;OAEG;wBACiB,mBAAmB,GAAG,wBAAwB;IAIlE;;OAEG;;;;;IAMH;;OAEG;;;;;IAMH;;OAEG;;;;EAMyD,CAAC;AAC/D,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC"}
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../../src/config/database.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAuB,MAAM,cAAc,CAAC;AAoHlG,eAAO,MAAM,cAAc;IAzCzB;;OAEG;;IAGH;;OAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAGH;;OAEG;wBACiB,mBAAmB,GAAG,wBAAwB;IAIlE;;OAEG;;;;;IAMH;;OAEG;;;;;IAMH;;OAEG;;;;EAMyD,CAAC;AAC/D,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC"}