@zintrust/core 0.4.49 → 0.4.50

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zintrust/core",
-  "version": "0.4.49",
+  "version": "0.4.50",
   "description": "Production-grade TypeScript backend framework for JavaScript",
   "homepage": "https://zintrust.com",
   "repository": {
@@ -58,7 +58,7 @@
   },
   "dependencies": {
     "@cloudflare/containers": "^0.2.0",
-    "@zintrust/workers": "0.4.49",
+    "@zintrust/workers": "0.4.50",
     "bcryptjs": "^3.0.3",
     "bullmq": "^5.71.1",
     "chalk": "^5.6.2",

package/src/boot/registry/runtime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../../src/boot/registry/runtime.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAOvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAiN9C,eAAO,MAAM,8BAA8B,GAAI,iBAAiB,gBAAgB,KAAG,IA4BlF,CAAC;AA8NF,eAAO,MAAM,eAAe,GAAI,QAAQ;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,eAAe,EAAE,gBAAgB,CAAC;IAClC,SAAS,EAAE,MAAM,OAAO,CAAC;IACzB,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACrC,KAAG;IAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CA8E7D,CAAC"}
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../../src/boot/registry/runtime.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAOvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAuN9C,eAAO,MAAM,8BAA8B,GAAI,iBAAiB,gBAAgB,KAAG,IA4BlF,CAAC;AAmPF,eAAO,MAAM,eAAe,GAAI,QAAQ;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,eAAe,EAAE,gBAAgB,CAAC;IAClC,SAAS,EAAE,MAAM,OAAO,CAAC;IACzB,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACrC,KAAG;IAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CA+E7D,CAAC"}

package/src/boot/registry/runtime.js

@@ -10,6 +10,7 @@ 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 { isNonEmptyString } from '../../helper/index.js';
 import { existsSync } from '../../node-singletons/fs.js';
 import * as path from '../../node-singletons/path.js';
 import { pathToFileURL } from '../../node-singletons/url.js';
@@ -278,8 +279,24 @@ const initializeQueueMonitor = async (router) => {
     }
     const redisConfig = extractRedisConfigFromQueueConfig();
     const { QueueMonitor } = queueMonitorModule;
+    const resolveKnownQueues = async () => {
+        try {
+            const workersModule = (await loadWorkersModule());
+            const records = await workersModule?.WorkerFactory?.listPersistedRecords?.();
+            if (!Array.isArray(records)) {
+                return [];
+            }
+            return Array.from(new Set(records
+                .map((record) => record.queueName)
+                .filter((queueName) => isNonEmptyString(queueName)))).sort((left, right) => left.localeCompare(right));
+        }
+        catch {
+            return [];
+        }
+    };
     const monitor = QueueMonitor.create({
         ...monitorConfig,
+        knownQueues: resolveKnownQueues,
         redis: redisConfig,
     });
     try {
@@ -292,7 +309,7 @@ const initializeQueueMonitor = async (router) => {
     Logger.info(`Queue Monitor enqueue endpoint at http://127.0.0.1:${appConfig.port}/test/enqueue`);
 };
 const initializeWorkers = async (router) => {
-    const workers = await loadWorkersModule();
+    const workers = await loadWorkersModule({ allowWhenDisabled: true });
     if (workers?.WorkerInit !== undefined && typeof workers.registerWorkerRoutes === 'function') {
         workers.registerWorkerRoutes(router, undefined, { middleware: undefined });
     }
@@ -403,16 +420,19 @@ export const createLifecycle = (params) => {
         await initializeArtifactDirectories(params.resolvedBasePath);
         await registerMasterRoutes(params.resolvedBasePath, params.router);
         await initializeSystemDebugger();
-        if (Cloudflare.getWorkersEnv() === null &&
-            appConfig.dockerWorker === false &&
-            appConfig.worker === true) {
+        if (Cloudflare.getWorkersEnv() === null && appConfig.dockerWorker === false) {
             await initializeWorkers(params.router);
             await initializeQueueMonitor(params.router);
-            await initializeQueueHttpGateway(params.router);
-            await initializeScheduleHttpGateway(params.router);
+            if (appConfig.worker === true) {
+                await initializeQueueHttpGateway(params.router);
+                await initializeScheduleHttpGateway(params.router);
+            }
+            else {
+                Logger.info('Skipping worker execution/gateway initialization (WORKER_ENABLED=false).');
+            }
         }
         else if (!appConfig.dockerWorker) {
-            Logger.info('Skipping worker module initialization (WORKER_ENABLED=false).');
+            Logger.info('Skipping local worker dashboards in Cloudflare Workers runtime.');
         }
         // Register service providers
         // Bootstrap services

package/src/index.js

@@ -1,11 +1,11 @@
 /**
- * @zintrust/core v0.4.49
+ * @zintrust/core v0.4.50
  *
  * ZinTrust Framework - Production-Grade TypeScript Backend
  * Built for performance, type safety, and exceptional developer experience
  *
  * Build Information:
- *   Built: 2026-04-03T16:22:10.308Z
+ *   Built: 2026-04-04T09:55:52.876Z
  *   Node: >=20.0.0
  *   License: MIT
  *
@@ -21,7 +21,7 @@
  * Available at runtime for debugging and health checks
  */
 export const ZINTRUST_VERSION = '0.1.41';
-export const ZINTRUST_BUILD_DATE = '2026-04-03T16:22:10.274Z'; // Replaced during build
+export const ZINTRUST_BUILD_DATE = '2026-04-04T09:55:52.845Z'; // Replaced during build
 export { Application } from './boot/Application.js';
 export { AwsSigV4 } from './common/index.js';
 export { SignedRequest } from './security/SignedRequest.js';

package/src/orm/adapters/D1Adapter.js

@@ -63,12 +63,12 @@ export const D1Adapter = Object.freeze({
             // eslint-disable-next-line @typescript-eslint/require-await
             async connect() {
                 connected = true;
-                Logger.info('✓ D1 connected');
+                Logger.debug('✓ D1 connected');
             },
             // eslint-disable-next-line @typescript-eslint/require-await
             async disconnect() {
                 connected = false;
-                Logger.info('✓ D1 disconnected');
+                Logger.debug('✓ D1 disconnected');
             },
             async query(sql, parameters) {
                 if (!connected)

package/src/runtime/WorkersModule.d.ts

@@ -1,6 +1,8 @@
 type WorkersModule = typeof import('../../packages/workers/src/index.js');
 type QueueMonitorModule = typeof import('../../packages/queue-monitor/src/index.js');
-export declare const loadWorkersModule: () => Promise<WorkersModule>;
+export declare const loadWorkersModule: (options?: {
+    allowWhenDisabled?: boolean;
+}) => Promise<WorkersModule>;
 export declare const loadQueueMonitorModule: () => Promise<QueueMonitorModule>;
 export {};
 //# sourceMappingURL=WorkersModule.d.ts.map

package/src/runtime/WorkersModule.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"WorkersModule.d.ts","sourceRoot":"","sources":["../../../src/runtime/WorkersModule.ts"],"names":[],"mappings":"AAOA,KAAK,aAAa,GAAG,cAAc,mBAAmB,CAAC,CAAC;AACxD,KAAK,kBAAkB,GAAG,cAAc,yBAAyB,CAAC,CAAC;AA8WnE,eAAO,MAAM,iBAAiB,QAAa,OAAO,CAAC,aAAa,CAwB/D,CAAC;AA4CF,eAAO,MAAM,sBAAsB,QAAa,OAAO,CAAC,kBAAkB,CAkBzE,CAAC"}
+{"version":3,"file":"WorkersModule.d.ts","sourceRoot":"","sources":["../../../src/runtime/WorkersModule.ts"],"names":[],"mappings":"AAOA,KAAK,aAAa,GAAG,cAAc,mBAAmB,CAAC,CAAC;AACxD,KAAK,kBAAkB,GAAG,cAAc,yBAAyB,CAAC,CAAC;AA+WnE,eAAO,MAAM,iBAAiB,GAC5B,UAAS;IAAE,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAAO,KAC5C,OAAO,CAAC,aAAa,CA2BvB,CAAC;AA4CF,eAAO,MAAM,sBAAsB,QAAa,OAAO,CAAC,kBAAkB,CAkBzE,CAAC"}

package/src/runtime/WorkersModule.js

@@ -203,6 +203,7 @@ let patchAfterFailureAttempted = false;
 let queueMonitorModulePromise;
 let queueMonitorPatchAfterFailureAttempted = false;
 let workersResolverDiagnosticLogged = false;
+let workersDisabledByEnvLogged = false;
 const resolvePackageEntryForDebug = (packageName) => {
     if (!isNodeRuntime())
         return null;
@@ -306,9 +307,12 @@ const tryLocalFallback = async () => {
     }
     return null;
 };
-export const loadWorkersModule = async () => {
-    if (shouldDisableWorkerModules()) {
-        Logger.info('Skipping @zintrust/workers module import (workers disabled by env).');
+export const loadWorkersModule = async (options = {}) => {
+    if (shouldDisableWorkerModules() && options.allowWhenDisabled !== true) {
+        if (!workersDisabledByEnvLogged) {
+            workersDisabledByEnvLogged = true;
+            Logger.info('Skipping @zintrust/workers module import (workers disabled by env).');
+        }
         workersModulePromise ??= Promise.resolve(createDisabledWorkersModule());
         return workersModulePromise;
     }

package/src/tools/redis/RedisTransport.d.ts

@@ -5,6 +5,7 @@ export type RedisTransportOptions = Readonly<{
     requireDirect?: boolean;
 }>;
 type RedisProxyConnection = {
+    [x: string]: unknown;
     status: 'ready';
     connect: () => Promise<void>;
     quit: () => Promise<'OK'>;

package/src/tools/redis/RedisTransport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RedisTransport.d.ts","sourceRoot":"","sources":["../../../../src/tools/redis/RedisTransport.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAIhD,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEpD,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC,CAAC;AASH,KAAK,oBAAoB,GAAG;IAC1B,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,KAAK,oBAAoB,CAAC;IACnF,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,KAAK,oBAAoB,CAAC;IACrF,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,KAAK,oBAAoB,CAAC;IACpF,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,KAAK,oBAAoB,CAAC;IAC/F,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAChE,QAAQ,EAAE,MAAM;QACd,IAAI,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;QACpD,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,UAAU,EAAE,CAAC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK;QAC5D,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,KAAK,OAAO,CAAC;QACtE,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,KAAK,OAAO,CAAC;QACxE,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,KAAK,OAAO,CAAC;KACxE,CAAC;CACH,CAAC;AA0PF,eAAO,MAAM,yBAAyB,QAAO,kBAE5C,CAAC;AAEF,eAAO,MAAM,0BAA0B,GACrC,QAAQ,WAAW,EACnB,UAAU,qBAAqB,KAC9B,oBAoCF,CAAC;AAEF,eAAO,MAAM,wBAAwB,GACnC,QAAQ,WAAW,EACnB,UAAU,qBAAqB,KAC9B,kBAaF,CAAC"}
+{"version":3,"file":"RedisTransport.d.ts","sourceRoot":"","sources":["../../../../src/tools/redis/RedisTransport.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAIhD,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEpD,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC,CAAC;AASH,KAAK,oBAAoB,GAAG;IAC1B,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IACrB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,KAAK,oBAAoB,CAAC;IACnF,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,KAAK,oBAAoB,CAAC;IACrF,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,KAAK,oBAAoB,CAAC;IACpF,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,KAAK,oBAAoB,CAAC;IAC/F,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAChE,QAAQ,EAAE,MAAM;QACd,IAAI,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;QACpD,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;IACF,UAAU,EAAE,CAAC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK;QAC5D,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,KAAK,OAAO,CAAC;QACtE,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,KAAK,OAAO,CAAC;QACxE,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,KAAK,OAAO,CAAC;KACxE,CAAC;CACH,CAAC;AA4QF,eAAO,MAAM,yBAAyB,QAAO,kBAI5C,CAAC;AAEF,eAAO,MAAM,0BAA0B,GACrC,QAAQ,WAAW,EACnB,UAAU,qBAAqB,KAC9B,oBAoCF,CAAC;AAEF,eAAO,MAAM,wBAAwB,GACnC,QAAQ,WAAW,EACnB,UAAU,qBAAqB,KAC9B,kBAaF,CAAC"}

package/src/tools/redis/RedisTransport.js

@@ -3,6 +3,20 @@ import { Logger } from '../../config/logger.js';
 import { ErrorFactory } from '../../exceptions/ZintrustError.js';
 import { SignedRequest } from '../../security/SignedRequest.js';
 const loggedSelections = new Set();
+const readEnvString = (key, fallback = '') => {
+    if (typeof Env.get === 'function') {
+        return Env.get(key, fallback);
+    }
+    const value = Env[key];
+    return typeof value === 'string' ? value : fallback;
+};
+const readEnvBool = (key, fallback = false) => {
+    if (typeof Env.getBool === 'function') {
+        return Env.getBool(key, fallback);
+    }
+    const value = Env[key];
+    return typeof value === 'boolean' ? value : fallback;
+};
 const resolveSigningPrefix = (baseUrl) => {
     try {
         const parsed = new URL(baseUrl);
@@ -35,7 +49,7 @@ const buildSigningUrl = (requestUrl, baseUrl) => {
     return requestUrl;
 };
 const resolveProxyBaseUrl = () => {
-    const explicit = Env.REDIS_PROXY_URL.trim();
+    const explicit = readEnvString('REDIS_PROXY_URL', '').trim();
     if (explicit !== '')
         return explicit;
     return `http://${Env.REDIS_PROXY_HOST}:${Env.REDIS_PROXY_PORT}`;
@@ -205,7 +219,9 @@ const createPipeline = (settings) => {
     return pipeline;
 };
 export const resolveRedisTransportMode = () => {
-    return Env.USE_REDIS_PROXY || Env.REDIS_PROXY_URL.trim() !== '' ? 'proxy' : 'direct';
+    return readEnvBool('USE_REDIS_PROXY', false) || readEnvString('REDIS_PROXY_URL', '').trim() !== ''
+        ? 'proxy'
+        : 'direct';
 };
 export const createRedisProxyConnection = (config, options) => {
     const settings = resolveProxySettings();