@zintrust/core 0.1.14 → 0.1.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zintrust/core",
-  "version": "0.1.14",
+  "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;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;AAkVD;;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,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

@@ -197,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())
@@ -205,67 +233,7 @@ const createLifecycle = (params) => {
         StartupConfigValidator.assertValid();
         FeatureFlags.initialize();
         await StartupHealthChecks.assertHealthy();
-        // Register ORM database connections from runtime config.
-        // This makes every `databaseConfig.connections[name]` available via `useDatabase(undefined, name)`.
-        // The configured default is also registered as 'default'.
-        try {
-            const { registerDatabasesFromRuntimeConfig } = await import('../orm/DatabaseRuntimeRegistration.js');
-            registerDatabasesFromRuntimeConfig(databaseConfig);
-        }
-        catch {
-            // best-effort: ignore in restrictive runtimes
-        }
-        // Register queue drivers from runtime config.
-        // Ensures default drivers like `sync` are available without manual registration.
-        try {
-            const { registerQueuesFromRuntimeConfig } = await import('../tools/queue/QueueRuntimeRegistration.js');
-            registerQueuesFromRuntimeConfig(queueConfig);
-        }
-        catch {
-            // best-effort: ignore in restrictive runtimes
-        }
-        // Register cache driver factories from runtime config.
-        // Ensures built-in drivers are available via the driver registry.
-        try {
-            const { registerCachesFromRuntimeConfig } = await import('../cache/CacheRuntimeRegistration.js');
-            registerCachesFromRuntimeConfig(cacheConfig);
-        }
-        catch {
-            // best-effort: ignore in restrictive runtimes
-        }
-        // Register broadcasters from runtime config.
-        // Ensures named broadcasters are available and unknown names throw when selected.
-        try {
-            const { registerBroadcastersFromRuntimeConfig } = await import('../tools/broadcast/BroadcastRuntimeRegistration.js');
-            registerBroadcastersFromRuntimeConfig({
-                default: broadcastConfig.default,
-                drivers: broadcastConfig.drivers,
-            });
-        }
-        catch {
-            // best-effort: ignore in restrictive runtimes
-        }
-        // Register storage disks from runtime config.
-        // Ensures named disks are available and 'default' is a reserved alias.
-        try {
-            const { registerDisksFromRuntimeConfig } = await import('../tools/storage/StorageRuntimeRegistration.js');
-            registerDisksFromRuntimeConfig(storageConfig);
-        }
-        catch {
-            // best-effort: ignore in restrictive runtimes
-        }
-        // Register notification channels from runtime config.
-        // Enables selecting named channels and reserves the `default` alias.
-        try {
-            const { registerNotificationChannelsFromRuntimeConfig } = await import('../tools/notification/NotificationRuntimeRegistration.js');
-            registerNotificationChannelsFromRuntimeConfig({
-                default: notificationConfig.default,
-                drivers: notificationConfig.drivers,
-            });
-        }
-        catch {
-            // best-effort: ignore in restrictive runtimes
-        }
+        await registerFromRuntimeConfig();
         await initializeArtifactDirectories(params.resolvedBasePath);
         await registerRoutes(params.resolvedBasePath, params.router);
         // Register service providers

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;;IA0EpB;;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;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

@@ -11,11 +11,13 @@ const hasOwn = (obj, key) => {
     return Object.prototype.hasOwnProperty.call(obj, key);
 };
 const getDefaultBroadcaster = (drivers) => {
-    const value = normalizeDriverName(Env.get('BROADCAST_DRIVER', 'inmemory'));
-    if (value.length > 0 && hasOwn(drivers, value)) {
+    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}`);
     }
-    // Backwards-compatible default.
     return hasOwn(drivers, 'inmemory') ? 'inmemory' : (Object.keys(drivers)[0] ?? 'inmemory');
 };
 const getPusherConfig = () => ({

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;AA+EnE,eAAO,MAAM,WAAW;IArDtB;;OAEG;;IAGH;;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;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

@@ -17,17 +17,23 @@ const getCacheDriver = (config, name) => {
     if (isExplicitSelection) {
         throw ErrorFactory.createConfigError(`Cache store not configured: ${storeName}`);
     }
-    // Backwards-compatible fallback.
-    const fallback = config.drivers['memory'] ?? Object.values(config.drivers)[0];
-    if (fallback !== undefined)
-        return fallback;
-    throw ErrorFactory.createConfigError('No cache stores are configured');
+    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
      */

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,EAAE,mBAAmB,EAAE,wBAAwB,EAAuB,MAAM,cAAc,CAAC;AAkHlG,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"}
+{"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"}

package/src/config/database.js

@@ -9,11 +9,13 @@ const hasOwn = (obj, key) => {
     return Object.prototype.hasOwnProperty.call(obj, key);
 };
 const getDefaultConnection = (connections) => {
-    const value = String(Env.DB_CONNECTION || '').trim();
-    if (value.length > 0 && hasOwn(connections, value)) {
+    const envSelectedRaw = Env.get('DB_CONNECTION', '');
+    const value = String(envSelectedRaw ?? '').trim();
+    if (value.length > 0 && hasOwn(connections, value))
         return value;
+    if (envSelectedRaw.trim().length > 0) {
+        throw ErrorFactory.createConfigError(`Database connection not configured: ${value}`);
     }
-    // Backwards-compatible default.
     return hasOwn(connections, 'sqlite') ? 'sqlite' : (Object.keys(connections)[0] ?? 'sqlite');
 };
 const getDatabaseConnection = (config) => {

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

@@ -1 +1 @@
-{"version":3,"file":"mail.d.ts","sourceRoot":"","sources":["../../../src/config/mail.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAmB,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAwGtE,eAAO,MAAM,UAAU;IA7ErB;;OAEG;;IAGH;;OAEG;;;;;IAMH;;OAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAsDH;;OAEG;gCACc,MAAM,KAAG,gBAAgB;EAKU,CAAC;AACvD,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC"}
+{"version":3,"file":"mail.d.ts","sourceRoot":"","sources":["../../../src/config/mail.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAmB,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAkHtE,eAAO,MAAM,UAAU;IA7ErB;;OAEG;;IAGH;;OAEG;;;;;IAMH;;OAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAsDH;;OAEG;gCACc,MAAM,KAAG,gBAAgB;EAKU,CAAC;AACvD,MAAM,MAAM,UAAU,GAAG,OAAO,UAAU,CAAC"}

package/src/config/mail.js

@@ -5,33 +5,40 @@
  */
 import { Env } from './env.js';
 import { ErrorFactory } from '../exceptions/ZintrustError.js';
+const isMailDriverConfig = (value) => {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    if (!('driver' in value))
+        return false;
+    const driver = value.driver;
+    return typeof driver === 'string' && driver.trim().length > 0;
+};
 const getMailDriver = (config, name) => {
-    const selected = (name ?? config.default).toString().trim();
+    const drivers = config.drivers;
+    const envSelectedRaw = Env.get('MAIL_CONNECTION', Env.get('MAIL_DRIVER', '')).trim();
+    const selected = (name ??
+        (envSelectedRaw.length > 0 ? envSelectedRaw : undefined) ??
+        config.default)
+        .toString()
+        .trim();
     if (selected.length === 0) {
-        const disabled = config.drivers['disabled'];
-        if (disabled !== undefined)
+        const disabled = drivers['disabled'];
+        if (isMailDriverConfig(disabled))
             return disabled;
         throw ErrorFactory.createConfigError('Mail driver not configured: disabled');
     }
-    if (Object.hasOwn(config.drivers, selected)) {
-        const resolved = config.drivers[selected];
-        if (resolved !== undefined)
+    if (Object.hasOwn(drivers, selected)) {
+        const resolved = drivers[selected];
+        if (isMailDriverConfig(resolved))
             return resolved;
     }
-    // Backward-compatible fallback: if the default is misconfigured, treat mail as disabled.
-    if (name === undefined) {
-        const disabled = config.drivers['disabled'];
-        if (disabled !== undefined)
-            return disabled;
-        throw ErrorFactory.createConfigError('Mail driver not configured: disabled');
-    }
     throw ErrorFactory.createConfigError(`Mail driver not configured: ${selected}`);
 };
 const mailConfigObj = {
     /**
      * Default mail driver
      */
-    default: Env.get('MAIL_DRIVER', 'disabled').trim().toLowerCase() || 'disabled',
+    default: Env.get('MAIL_CONNECTION', Env.get('MAIL_DRIVER', 'disabled')).trim().toLowerCase(),
     /**
      * Default "From" identity
      */

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

@@ -1 +1 @@
-{"version":3,"file":"notification.d.ts","sourceRoot":"","sources":["../../../src/config/notification.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,6BAA6B,EAE7B,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,cAAc,CAAC;AA2GtB,eAAO,MAAM,kBAAkB;IA1C7B;;OAEG;sBACY,MAAM;IAIrB;;;;;OAKG;sBACY,mBAAmB;IAKlC;;OAEG;wBACc,qBAAqB;IAItC;;OAEG;kCACc,MAAM;IAIvB;;;;OAIG;sCACoB,MAAM,KAAG,6BAA6B;EAKO,CAAC;AACvE,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAC;AAE3D,eAAe,kBAAkB,CAAC"}
+{"version":3,"file":"notification.d.ts","sourceRoot":"","sources":["../../../src/config/notification.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,6BAA6B,EAE7B,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,cAAc,CAAC;AAuHtB,eAAO,MAAM,kBAAkB;IA1C7B;;OAEG;sBACY,MAAM;IAIrB;;;;;OAKG;sBACY,mBAAmB;IAKlC;;OAEG;wBACc,qBAAqB;IAItC;;OAEG;kCACc,MAAM;IAIvB;;;;OAIG;sCACoB,MAAM,KAAG,6BAA6B;EAKO,CAAC;AACvE,MAAM,MAAM,kBAAkB,GAAG,OAAO,kBAAkB,CAAC;AAE3D,eAAe,kBAAkB,CAAC"}

package/src/config/notification.js

@@ -11,9 +11,13 @@ const hasOwn = (obj, key) => {
     return Object.prototype.hasOwnProperty.call(obj, key);
 };
 const getDefaultChannel = (drivers) => {
-    const value = normalizeName(Env.get('NOTIFICATION_DRIVER', 'console'));
+    const envSelectedRaw = Env.get('NOTIFICATION_CONNECTION', Env.get('NOTIFICATION_DRIVER', 'console'));
+    const value = normalizeName(envSelectedRaw ?? 'console');
     if (value.length > 0 && hasOwn(drivers, value))
         return value;
+    if (envSelectedRaw.trim().length > 0) {
+        throw ErrorFactory.createConfigError(`Notification channel not configured: ${value}`);
+    }
     return hasOwn(drivers, 'console') ? 'console' : (Object.keys(drivers)[0] ?? 'console');
 };
 const getNotificationDriver = (config, name) => {
@@ -27,13 +31,14 @@ const getNotificationDriver = (config, name) => {
         if (resolved !== undefined)
             return resolved;
     }
+    if (Object.keys(config.drivers ?? {}).length === 0) {
+        throw ErrorFactory.createConfigError('No notification channels are configured');
+    }
     if (isExplicitSelection) {
         throw ErrorFactory.createConfigError(`Notification channel not configured: ${channelName}`);
     }
-    const fallback = config.drivers['console'] ?? Object.values(config.drivers)[0];
-    if (fallback !== undefined)
-        return fallback;
-    throw ErrorFactory.createConfigError('No notification channels are configured');
+    // Default selection is strict: if `default` points at an unconfigured channel, throw.
+    throw ErrorFactory.createConfigError(`Notification channel not configured: ${channelName}`);
 };
 const getBaseProviders = () => {
     return {

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

@@ -1 +1 @@
-{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/config/storage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAiI9F,eAAO,MAAM,aAAa;IAhExB;;OAEG;sBACY,MAAM;IAIrB;;OAEG;sBACY,cAAc;IAI7B;;OAEG;oBACa,oBAAoB,GAAG,mBAAmB;IAI1D;;;;;;OAMG;0BACmB,oBAAoB,SAAS,MAAM,GAAG,mBAAmB;IAI/E;;OAEG;mBACS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAO5C;;OAEG;sBACY;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;IAQtE;;OAEG;sBACY;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;EAQW,CAAC;AAE7D,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC"}
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/config/storage.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAmI9F,eAAO,MAAM,aAAa;IAhExB;;OAEG;sBACY,MAAM;IAIrB;;OAEG;sBACY,cAAc;IAI7B;;OAEG;oBACa,oBAAoB,GAAG,mBAAmB;IAI1D;;;;;;OAMG;0BACmB,oBAAoB,SAAS,MAAM,GAAG,mBAAmB;IAI/E;;OAEG;mBACS;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAO5C;;OAEG;sBACY;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;IAQtE;;OAEG;sBACY;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;EAQW,CAAC;AAE7D,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC"}

package/src/config/storage.js

@@ -20,11 +20,10 @@ const getStorageDriver = (config, name) => {
     if (isExplicitSelection) {
         throw ErrorFactory.createConfigError(`Storage disk not configured: ${diskName}`);
     }
-    // Backwards-compatible fallback.
-    const fallback = config.drivers['local'] ?? Object.values(config.drivers)[0];
-    if (fallback !== undefined)
-        return fallback;
-    throw ErrorFactory.createConfigError('No storage disks are configured');
+    if (Object.keys(config.drivers ?? {}).length === 0) {
+        throw ErrorFactory.createConfigError('No storage disks are configured');
+    }
+    throw ErrorFactory.createConfigError(`Storage default disk not configured: ${diskName || '<empty>'}`);
 };
 const getDrivers = () => ({
     local: {
@@ -65,7 +64,7 @@ const storageConfigObj = {
      * Default storage driver (dynamic; tests may mutate process.env)
      */
     get default() {
-        return Env.get('STORAGE_DRIVER', 'local');
+        return Env.get('STORAGE_CONNECTION', Env.get('STORAGE_DRIVER', 'local')).trim().toLowerCase();
     },
     /**
      * Storage drivers configuration (dynamic; tests may mutate process.env)

package/src/orm/DatabaseRuntimeRegistration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DatabaseRuntimeRegistration.d.ts","sourceRoot":"","sources":["../../../src/orm/DatabaseRuntimeRegistration.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,mBAAmB,EAGpB,MAAM,cAAc,CAAC;AAuCtB;;;;;;;GAOG;AACH,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAOpF"}
+{"version":3,"file":"DatabaseRuntimeRegistration.d.ts","sourceRoot":"","sources":["../../../src/orm/DatabaseRuntimeRegistration.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,mBAAmB,EAGpB,MAAM,cAAc,CAAC;AAwCtB;;;;;;;GAOG;AACH,wBAAgB,kCAAkC,CAAC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAWpF"}

package/src/orm/DatabaseRuntimeRegistration.js

@@ -4,6 +4,7 @@
  * Bridges config-layer database connection definitions into ORM connection
  * instances that can be selected via `useDatabase(undefined, name)`.
  */
+import { ErrorFactory } from '../exceptions/ZintrustError.js';
 import { useDatabase } from './Database.js';
 const toOrmConfig = (cfg) => {
     switch (cfg.driver) {
@@ -49,7 +50,8 @@ const registerConnections = (connections) => {
 export function registerDatabasesFromRuntimeConfig(config) {
     registerConnections(config.connections);
     const defaultCfg = config.connections[config.default];
-    if (defaultCfg !== undefined) {
-        useDatabase(toOrmConfig(defaultCfg), 'default');
+    if (defaultCfg === undefined) {
+        throw ErrorFactory.createConfigError(`Database default connection not configured: ${String(config.default ?? '')}`);
     }
+    useDatabase(toOrmConfig(defaultCfg), 'default');
 }

package/src/templates/project/basic/config/broadcast.ts.tpl

@@ -5,7 +5,7 @@
  * Driver selection must be dynamic (tests may mutate process.env).
  */
 
-import { Env } from './env';
+import { Env } from '@config/env';
 import {
   BroadcastConfigInput,
   BroadcastDrivers,
@@ -14,7 +14,7 @@ import {
   PusherBroadcastDriverConfig,
   RedisBroadcastDriverConfig,
   RedisHttpsBroadcastDriverConfig,
-} from './type';
+} from '@config/type';
 import { ErrorFactory } from '@zintrust/core';
 
 const normalizeDriverName = (value: string): string => value.trim().toLowerCase();
@@ -24,13 +24,15 @@ const hasOwn = (obj: Record<string, unknown>, key: string): boolean => {
 };
 
 const getDefaultBroadcaster = (drivers: BroadcastDrivers): string => {
-  const value = normalizeDriverName(Env.get('BROADCAST_DRIVER', 'inmemory'));
+  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 (value.length > 0 && hasOwn(drivers, value)) return value;
+
+  if (envSelectedRaw.trim().length > 0) {
+    throw ErrorFactory.createConfigError(`Broadcast driver not configured: ${value}`);
   }
 
-  // Backwards-compatible default.
   return hasOwn(drivers, 'inmemory') ? 'inmemory' : (Object.keys(drivers)[0] ?? 'inmemory');
 };
 

package/src/templates/project/basic/config/cache.ts.tpl

@@ -4,8 +4,8 @@
  * Sealed namespace for immutability
  */
 
-import { Env } from './env';
-import { CacheConfigInput, CacheDriverConfig } from './type';
+import { Env } from '@config/env';
+import { CacheConfigInput, CacheDriverConfig } from '@config/type';
 import { ErrorFactory } from '@zintrust/core';
 
 const getCacheDriver = (config: CacheConfigInput, name?: string): CacheDriverConfig => {
@@ -23,18 +23,30 @@ const getCacheDriver = (config: CacheConfigInput, name?: string): CacheDriverCon
     throw ErrorFactory.createConfigError(`Cache store not configured: ${storeName}`);
   }
 
-  // Backwards-compatible fallback.
-  const fallback = config.drivers['memory'] ?? Object.values(config.drivers)[0];
-  if (fallback !== undefined) return fallback;
+  if (Object.keys(config.drivers ?? {}).length === 0) {
+    throw ErrorFactory.createConfigError('No cache stores are configured');
+  }
 
-  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 as unknown as { CACHE_DRIVER?: unknown }).CACHE_DRIVER === 'string'
+        ? String((Env as unknown as { CACHE_DRIVER?: unknown }).CACHE_DRIVER)
+        : Env.get('CACHE_DRIVER', 'memory');
+
+    const selected = envConnection.length > 0 ? envConnection : String(envDriver ?? 'memory');
+    return selected.trim().toLowerCase();
+  })(),
 
   /**
    * Cache drivers

package/src/templates/project/basic/config/database.ts.tpl

@@ -4,8 +4,8 @@
  * Sealed namespace for immutability
  */
 
-import { Env } from './env';
-import { DatabaseConfigShape, DatabaseConnectionConfig, DatabaseConnections } from './type';
+import { Env } from '@config/env';
+import { DatabaseConfigShape, DatabaseConnectionConfig, DatabaseConnections } from '@config/type';
 import { ErrorFactory } from '@zintrust/core';
 
 const hasOwn = (obj: Record<string, unknown>, key: string): boolean => {
@@ -13,13 +13,15 @@ const hasOwn = (obj: Record<string, unknown>, key: string): boolean => {
 };
 
 const getDefaultConnection = (connections: DatabaseConnections): string => {
-  const value = String(Env.DB_CONNECTION || '').trim();
+  const envSelectedRaw = Env.get('DB_CONNECTION', '');
+  const value = String(envSelectedRaw ?? '').trim();
 
-  if (value.length > 0 && hasOwn(connections, value)) {
-    return value;
+  if (value.length > 0 && hasOwn(connections, value)) return value;
+
+  if (envSelectedRaw.trim().length > 0) {
+    throw ErrorFactory.createConfigError(`Database connection not configured: ${value}`);
   }
 
-  // Backwards-compatible default.
   return hasOwn(connections, 'sqlite') ? 'sqlite' : (Object.keys(connections)[0] ?? 'sqlite');
 };
 

package/src/templates/project/basic/config/mail.ts.tpl

@@ -8,24 +8,34 @@ import { Env } from '@config/env';
 import type { MailConfigInput, MailDriverConfig } from '@config/type';
 import { ErrorFactory } from '@zintrust/core';
 
+const isMailDriverConfig = (value: unknown): value is MailDriverConfig => {
+  if (typeof value !== 'object' || value === null) return false;
+  if (!('driver' in value)) return false;
+
+  const driver = (value as { driver?: unknown }).driver;
+  return typeof driver === 'string' && driver.trim().length > 0;
+};
+
 const getMailDriver = (config: MailConfigInput, name?: string): MailDriverConfig => {
-  const selected = (name ?? config.default).toString().trim();
+  const drivers = config.drivers as Record<string, unknown>;
+  const envSelectedRaw = Env.get('MAIL_CONNECTION', Env.get('MAIL_DRIVER', '')).trim();
+  const selected = (
+    name ??
+    (envSelectedRaw.length > 0 ? envSelectedRaw : undefined) ??
+    config.default
+  )
+    .toString()
+    .trim();
+
   if (selected.length === 0) {
-    const disabled = config.drivers['disabled'];
-    if (disabled !== undefined) return disabled;
+    const disabled = drivers['disabled'];
+    if (isMailDriverConfig(disabled)) return disabled;
     throw ErrorFactory.createConfigError('Mail driver not configured: disabled');
   }
 
-  if (Object.hasOwn(config.drivers, selected)) {
-    const resolved = config.drivers[selected];
-    if (resolved !== undefined) return resolved;
-  }
-
-  // Backward-compatible fallback: if the default is misconfigured, treat mail as disabled.
-  if (name === undefined) {
-    const disabled = config.drivers['disabled'];
-    if (disabled !== undefined) return disabled;
-    throw ErrorFactory.createConfigError('Mail driver not configured: disabled');
+  if (Object.hasOwn(drivers, selected)) {
+    const resolved = drivers[selected];
+    if (isMailDriverConfig(resolved)) return resolved;
   }
 
   throw ErrorFactory.createConfigError(`Mail driver not configured: ${selected}`);
@@ -35,7 +45,7 @@ const mailConfigObj = {
   /**
    * Default mail driver
    */
-  default: Env.get('MAIL_DRIVER', 'disabled').trim().toLowerCase() || 'disabled',
+  default: Env.get('MAIL_CONNECTION', Env.get('MAIL_DRIVER', 'disabled')).trim().toLowerCase(),
 
   /**
    * Default "From" identity

package/src/templates/project/basic/config/notification.ts.tpl

@@ -21,8 +21,18 @@ const hasOwn = (obj: Record<string, unknown>, key: string): boolean => {
 };
 
 const getDefaultChannel = (drivers: NotificationDrivers): string => {
-  const value = normalizeName(Env.get('NOTIFICATION_DRIVER', 'console'));
+  const envSelectedRaw = Env.get(
+    'NOTIFICATION_CONNECTION',
+    Env.get('NOTIFICATION_DRIVER', 'console')
+  );
+  const value = normalizeName(envSelectedRaw ?? 'console');
+
   if (value.length > 0 && hasOwn(drivers, value)) return value;
+
+  if (envSelectedRaw.trim().length > 0) {
+    throw ErrorFactory.createConfigError(`Notification channel not configured: ${value}`);
+  }
+
   return hasOwn(drivers, 'console') ? 'console' : (Object.keys(drivers)[0] ?? 'console');
 };
 
@@ -43,14 +53,16 @@ const getNotificationDriver = (
     if (resolved !== undefined) return resolved;
   }
 
+  if (Object.keys(config.drivers ?? {}).length === 0) {
+    throw ErrorFactory.createConfigError('No notification channels are configured');
+  }
+
   if (isExplicitSelection) {
     throw ErrorFactory.createConfigError(`Notification channel not configured: ${channelName}`);
   }
 
-  const fallback = config.drivers['console'] ?? Object.values(config.drivers)[0];
-  if (fallback !== undefined) return fallback;
-
-  throw ErrorFactory.createConfigError('No notification channels are configured');
+  // Default selection is strict: if `default` points at an unconfigured channel, throw.
+  throw ErrorFactory.createConfigError(`Notification channel not configured: ${channelName}`);
 };
 
 const getBaseProviders = (): NotificationProviders => {

package/src/templates/project/basic/config/storage.ts.tpl

@@ -4,11 +4,11 @@
  * Sealed namespace for immutability
  */
 
-import { Env } from './env';
-import type { StorageConfigRuntime, StorageDriverConfig, StorageDrivers } from './type';
+import { Env } from '@config/env';
+import type { StorageConfigRuntime, StorageDriverConfig, StorageDrivers } from '@config/type';
 import { ErrorFactory } from '@zintrust/core';
 
-const hasOwn = (obj: Record<string, unknown>, key: string): boolean => {
+const hasOwn = <T extends object>(obj: T, key: PropertyKey): key is keyof T => {
   return Object.prototype.hasOwnProperty.call(obj, key);
 };
 
@@ -27,11 +27,13 @@ const getStorageDriver = (config: StorageConfigRuntime, name?: string): StorageD
     throw ErrorFactory.createConfigError(`Storage disk not configured: ${diskName}`);
   }
 
-  // Backwards-compatible fallback.
-  const fallback = config.drivers['local'] ?? Object.values(config.drivers)[0];
-  if (fallback !== undefined) return fallback;
+  if (Object.keys(config.drivers ?? {}).length === 0) {
+    throw ErrorFactory.createConfigError('No storage disks are configured');
+  }
 
-  throw ErrorFactory.createConfigError('No storage disks are configured');
+  throw ErrorFactory.createConfigError(
+    `Storage default disk not configured: ${diskName || '<empty>'}`
+  );
 };
 
 const getDrivers = (): StorageDrivers => ({
@@ -74,7 +76,7 @@ const storageConfigObj = {
    * Default storage driver (dynamic; tests may mutate process.env)
    */
   get default(): string {
-    return Env.get('STORAGE_DRIVER', 'local');
+    return Env.get('STORAGE_CONNECTION', Env.get('STORAGE_DRIVER', 'local')).trim().toLowerCase();
   },
 
   /**

package/src/tools/broadcast/BroadcastRuntimeRegistration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BroadcastRuntimeRegistration.d.ts","sourceRoot":"","sources":["../../../../src/tools/broadcast/BroadcastRuntimeRegistration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAIzD;;;;;;;GAOG;AACH,wBAAgB,qCAAqC,CACnD,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,SAAS,GAAG,SAAS,CAAC,GACxD,IAAI,CAWN"}
+{"version":3,"file":"BroadcastRuntimeRegistration.d.ts","sourceRoot":"","sources":["../../../../src/tools/broadcast/BroadcastRuntimeRegistration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAKzD;;;;;;;GAOG;AACH,wBAAgB,qCAAqC,CACnD,MAAM,EAAE,IAAI,CAAC,oBAAoB,EAAE,SAAS,GAAG,SAAS,CAAC,GACxD,IAAI,CAeN"}

package/src/tools/broadcast/BroadcastRuntimeRegistration.js

@@ -1,3 +1,4 @@
+import { ErrorFactory } from '../../exceptions/ZintrustError.js';
 import { BroadcastRegistry } from './BroadcastRegistry.js';
 /**
  * Register broadcasters from runtime config.
@@ -12,9 +13,11 @@ export function registerBroadcastersFromRuntimeConfig(config) {
         BroadcastRegistry.register(name, driverConfig);
     }
     const defaultName = (config.default ?? '').toString().trim().toLowerCase();
-    if (defaultName.length === 0)
-        return;
-    if (BroadcastRegistry.has(defaultName)) {
-        BroadcastRegistry.register('default', BroadcastRegistry.get(defaultName));
+    if (defaultName.length === 0) {
+        throw ErrorFactory.createConfigError('Broadcast default driver is not configured');
     }
+    if (!BroadcastRegistry.has(defaultName)) {
+        throw ErrorFactory.createConfigError(`Broadcast default driver not configured: ${defaultName}`);
+    }
+    BroadcastRegistry.register('default', BroadcastRegistry.get(defaultName));
 }

package/src/tools/notification/NotificationRuntimeRegistration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NotificationRuntimeRegistration.d.ts","sourceRoot":"","sources":["../../../../src/tools/notification/NotificationRuntimeRegistration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAG5D;;;;;GAKG;AACH,wBAAgB,6CAA6C,CAC3D,MAAM,EAAE,IAAI,CAAC,uBAAuB,EAAE,SAAS,GAAG,SAAS,CAAC,GAC3D,IAAI,CAWN;AAED,eAAO,MAAM,+BAA+B;;EAE1C,CAAC;AAEH,eAAe,+BAA+B,CAAC"}
+{"version":3,"file":"NotificationRuntimeRegistration.d.ts","sourceRoot":"","sources":["../../../../src/tools/notification/NotificationRuntimeRegistration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAI5D;;;;;GAKG;AACH,wBAAgB,6CAA6C,CAC3D,MAAM,EAAE,IAAI,CAAC,uBAAuB,EAAE,SAAS,GAAG,SAAS,CAAC,GAC3D,IAAI,CAiBN;AAED,eAAO,MAAM,+BAA+B;;EAE1C,CAAC;AAEH,eAAe,+BAA+B,CAAC"}

package/src/tools/notification/NotificationRuntimeRegistration.js

@@ -1,3 +1,4 @@
+import { ErrorFactory } from '../../exceptions/ZintrustError.js';
 import { NotificationChannelRegistry } from './NotificationChannelRegistry.js';
 /**
  * Register notification channels from runtime config.
@@ -10,11 +11,13 @@ export function registerNotificationChannelsFromRuntimeConfig(config) {
         NotificationChannelRegistry.register(name, driverConfig);
     }
     const defaultName = (config.default ?? '').toString().trim().toLowerCase();
-    if (defaultName.length === 0)
-        return;
-    if (NotificationChannelRegistry.has(defaultName)) {
-        NotificationChannelRegistry.register('default', NotificationChannelRegistry.get(defaultName));
+    if (defaultName.length === 0) {
+        throw ErrorFactory.createConfigError('Notification default channel is not configured');
     }
+    if (!NotificationChannelRegistry.has(defaultName)) {
+        throw ErrorFactory.createConfigError(`Notification default channel not configured: ${defaultName}`);
+    }
+    NotificationChannelRegistry.register('default', NotificationChannelRegistry.get(defaultName));
 }
 export const NotificationRuntimeRegistration = Object.freeze({
     registerNotificationChannelsFromRuntimeConfig,

package/src/tools/queue/Queue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Queue.d.ts","sourceRoot":"","sources":["../../../../src/tools/queue/Queue.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,OAAO,IAAI;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,CAAC,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAErF,UAAU,YAAY;IACpB,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACjE,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAC1E,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACvC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAID,eAAO,MAAM,KAAK;mBACD,MAAM,UAAU,YAAY;aAIlC,IAAI;eAIF,MAAM,GAAG,YAAY;YAUlB,CAAC,mBAAmB,MAAM,WAAW,CAAC,eAAe,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAK7E,CAAC,mBACN,MAAM,eACA,MAAM,GAClB,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;eAKtB,MAAM,MAAM,MAAM,eAAe,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;kBAKpD,MAAM,eAAe,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;iBAK9C,MAAM,eAAe,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;EAI9D,CAAC;AAEH,eAAe,KAAK,CAAC"}
+{"version":3,"file":"Queue.d.ts","sourceRoot":"","sources":["../../../../src/tools/queue/Queue.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,OAAO,IAAI;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,CAAC,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAErF,UAAU,YAAY;IACpB,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACjE,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAC1E,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACvC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrC;AAID,eAAO,MAAM,KAAK;mBACD,MAAM,UAAU,YAAY;aAIlC,IAAI;eAIF,MAAM,GAAG,YAAY;YAelB,CAAC,mBAAmB,MAAM,WAAW,CAAC,eAAe,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAK7E,CAAC,mBACN,MAAM,eACA,MAAM,GAClB,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;eAKtB,MAAM,MAAM,MAAM,eAAe,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;kBAKpD,MAAM,eAAe,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;iBAK9C,MAAM,eAAe,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;EAI9D,CAAC;AAEH,eAAe,KAAK,CAAC"}

package/src/tools/queue/Queue.js

@@ -8,7 +8,10 @@ export const Queue = Object.freeze({
         drivers.clear();
     },
     get(name) {
-        const driverName = (name ?? process.env['QUEUE_DRIVER'] ?? 'inmemory')
+        const driverName = (name ??
+            process.env['QUEUE_CONNECTION'] ??
+            process.env['QUEUE_DRIVER'] ??
+            'inmemory')
             .toString()
             .trim()
             .toLowerCase();

package/src/tools/queue/QueueRuntimeRegistration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"QueueRuntimeRegistration.d.ts","sourceRoot":"","sources":["../../../../src/tools/queue/QueueRuntimeRegistration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAMjD;;;;;;;GAOG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAgBzE"}
+{"version":3,"file":"QueueRuntimeRegistration.d.ts","sourceRoot":"","sources":["../../../../src/tools/queue/QueueRuntimeRegistration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAOjD;;;;;;;GAOG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAczE"}

package/src/tools/queue/QueueRuntimeRegistration.js

@@ -1,3 +1,4 @@
+import { ErrorFactory } from '../../exceptions/ZintrustError.js';
 import { InMemoryQueue } from '../queue/drivers/InMemory.js';
 import { RedisQueue } from '../queue/drivers/Redis.js';
 import { Queue } from '../queue/Queue.js';
@@ -16,13 +17,9 @@ export function registerQueuesFromRuntimeConfig(config) {
     Queue.register('sync', InMemoryQueue);
     Queue.register('redis', RedisQueue);
     const defaultName = (config.default ?? '').toString().trim().toLowerCase();
-    if (defaultName.length === 0)
-        return;
-    try {
-        const drv = Queue.get(defaultName);
-        Queue.register('default', drv);
-    }
-    catch {
-        // Best-effort: external drivers may be registered by optional packages.
+    if (defaultName.length === 0) {
+        throw ErrorFactory.createConfigError('Queue default driver is not configured');
     }
+    const drv = Queue.get(defaultName);
+    Queue.register('default', drv);
 }

package/src/tools/storage/StorageRuntimeRegistration.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StorageRuntimeRegistration.d.ts","sourceRoot":"","sources":["../../../../src/tools/storage/StorageRuntimeRegistration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAG9E,MAAM,MAAM,oBAAoB,GAAG,oBAAoB,GAAG;IACxD,eAAe,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,mBAAmB,CAAC;CAC1D,CAAC;AAEF,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAmBjF;AAED,eAAO,MAAM,0BAA0B;;EAErC,CAAC;AAEH,eAAe,0BAA0B,CAAC"}
+{"version":3,"file":"StorageRuntimeRegistration.d.ts","sourceRoot":"","sources":["../../../../src/tools/storage/StorageRuntimeRegistration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAI9E,MAAM,MAAM,oBAAoB,GAAG,oBAAoB,GAAG;IACxD,eAAe,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,mBAAmB,CAAC;CAC1D,CAAC;AAEF,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAiBjF;AAED,eAAO,MAAM,0BAA0B;;EAErC,CAAC;AAEH,eAAe,0BAA0B,CAAC"}

package/src/tools/storage/StorageRuntimeRegistration.js

@@ -1,21 +1,19 @@
+import { ErrorFactory } from '../../exceptions/ZintrustError.js';
 import { StorageDiskRegistry } from './StorageDiskRegistry.js';
 export function registerDisksFromRuntimeConfig(config) {
     for (const [name, driverConfig] of Object.entries(config.drivers)) {
         StorageDiskRegistry.register(name, driverConfig);
     }
     // Alias reserved name `default` to the configured default.
-    // Prefer config.getDriverConfig() so we preserve its fallback semantics.
-    let resolvedDefault;
-    if (typeof config.getDriverConfig === 'function') {
-        resolvedDefault = config.getDriverConfig('default');
+    const defaultName = String(config.default ?? '').trim();
+    if (defaultName.length === 0) {
+        throw ErrorFactory.createConfigError('Storage default disk is not configured');
     }
-    else {
-        const values = Object.values(config.drivers);
-        resolvedDefault = config.drivers[config.default] ?? values[0];
-    }
-    if (resolvedDefault !== undefined) {
-        StorageDiskRegistry.register('default', resolvedDefault);
+    const resolvedDefault = config.drivers[defaultName];
+    if (resolvedDefault === undefined) {
+        throw ErrorFactory.createConfigError(`Storage default disk not configured: ${defaultName}`);
     }
+    StorageDiskRegistry.register('default', resolvedDefault);
 }
 export const StorageRuntimeRegistration = Object.freeze({
     registerDisksFromRuntimeConfig,