@zintrust/core 2.8.3 → 2.8.4

package/package.json

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

package/src/common/EnvFallbackUtils.d.ts

@@ -0,0 +1,6 @@
+export declare const readWorkersEnvString: (key: string) => string;
+export declare const readWorkersFallbackString: (workersKey: string, fallbackKey: string, fallback?: string, includeFallbackWorkerBinding?: boolean) => string;
+export declare const readWorkersFallbackInt: (workersKey: string, fallbackKey: string, fallback: number, includeFallbackWorkerBinding?: boolean) => number;
+export declare const readWorkersFallbackBool: (workersKey: string, fallbackKey: string, fallback: boolean) => boolean;
+export declare const parseJsonObjectEnv: (key: string) => Record<string, unknown> | undefined;
+//# sourceMappingURL=EnvFallbackUtils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"EnvFallbackUtils.d.ts","sourceRoot":"","sources":["../../../src/common/EnvFallbackUtils.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,oBAAoB,GAAI,KAAK,MAAM,KAAG,MAIlD,CAAC;AAEF,eAAO,MAAM,yBAAyB,GACpC,YAAY,MAAM,EAClB,aAAa,MAAM,EACnB,iBAAa,EACb,sCAAoC,KACnC,MAUF,CAAC;AAEF,eAAO,MAAM,sBAAsB,GACjC,YAAY,MAAM,EAClB,aAAa,MAAM,EACnB,UAAU,MAAM,EAChB,sCAAoC,KACnC,MAUF,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAClC,YAAY,MAAM,EAClB,aAAa,MAAM,EACnB,UAAU,OAAO,KAChB,OAMF,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,KAAK,MAAM,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAa1E,CAAC"}

package/src/common/EnvFallbackUtils.js

@@ -0,0 +1,50 @@
+import { Cloudflare } from '../config/cloudflare.js';
+import { Env } from '../config/env.js';
+const normalizeEnvString = (value, fallback = '') => typeof value === 'string' ? value : fallback;
+export const readWorkersEnvString = (key) => {
+    const workerValue = Cloudflare.getWorkersVar(key);
+    if (workerValue !== null && workerValue.trim() !== '')
+        return workerValue;
+    return '';
+};
+export const readWorkersFallbackString = (workersKey, fallbackKey, fallback = '', includeFallbackWorkerBinding = false) => {
+    const workerValue = readWorkersEnvString(workersKey);
+    if (workerValue.trim() !== '')
+        return workerValue;
+    if (includeFallbackWorkerBinding) {
+        const fallbackWorkerValue = readWorkersEnvString(fallbackKey);
+        if (fallbackWorkerValue.trim() !== '')
+            return fallbackWorkerValue;
+    }
+    return normalizeEnvString(Env.get(fallbackKey, fallback), fallback);
+};
+export const readWorkersFallbackInt = (workersKey, fallbackKey, fallback, includeFallbackWorkerBinding = false) => {
+    const raw = readWorkersFallbackString(workersKey, fallbackKey, String(fallback), includeFallbackWorkerBinding);
+    if (raw.trim() === '')
+        return fallback;
+    const parsed = Number.parseInt(raw, 10);
+    return Number.isFinite(parsed) ? parsed : fallback;
+};
+export const readWorkersFallbackBool = (workersKey, fallbackKey, fallback) => {
+    const workerValue = readWorkersEnvString(workersKey);
+    if (workerValue.trim() !== '') {
+        return workerValue === 'true' || workerValue === '1';
+    }
+    return Env.getBool(fallbackKey, fallback);
+};
+export const parseJsonObjectEnv = (key) => {
+    const value = Env.get(key, '');
+    const raw = typeof value === 'string' ? value.trim() : '';
+    if (raw === '')
+        return undefined;
+    try {
+        const parsed = JSON.parse(raw);
+        if (typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed)) {
+            return parsed;
+        }
+    }
+    catch {
+        return { value: raw };
+    }
+    return undefined;
+};

package/src/common/ExternalServiceUtils.d.ts

@@ -2,6 +2,7 @@
  * Shared Utilities for External Service Drivers
  * Common patterns for API calls, environment variable reading, and error handling
  */
+export { parseJsonObjectEnv, readWorkersEnvString, readWorkersFallbackBool, readWorkersFallbackInt, readWorkersFallbackString, } from './EnvFallbackUtils';
 export type TracedFetchTraceOptions = {
     source?: string;
 };
@@ -10,11 +11,6 @@ export type TracedFetchTraceOptions = {
  * Handles both Env.get() and process.env for maximum compatibility
  */
 export declare const readEnvString: (key: string, fallback?: string) => string;
-export declare const readWorkersEnvString: (key: string) => string;
-export declare const readWorkersFallbackString: (workersKey: string, fallbackKey: string, fallback?: string, includeFallbackWorkerBinding?: boolean) => string;
-export declare const readWorkersFallbackInt: (workersKey: string, fallbackKey: string, fallback: number, includeFallbackWorkerBinding?: boolean) => number;
-export declare const readWorkersFallbackBool: (workersKey: string, fallbackKey: string, fallback: boolean) => boolean;
-export declare const parseJsonObjectEnv: (key: string) => Record<string, unknown> | undefined;
 /**
  * Validate required parameters for external service calls
  */

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

@@ -1 +1 @@
-{"version":3,"file":"ExternalServiceUtils.d.ts","sourceRoot":"","sources":["../../../src/common/ExternalServiceUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAkHF;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,MAAM,EAAE,iBAAa,KAAG,MAe1D,CAAC;AAEF,eAAO,MAAM,oBAAoB,GAAI,KAAK,MAAM,KAAG,MAIlD,CAAC;AAEF,eAAO,MAAM,yBAAyB,GACpC,YAAY,MAAM,EAClB,aAAa,MAAM,EACnB,iBAAa,EACb,sCAAoC,KACnC,MAUF,CAAC;AAEF,eAAO,MAAM,sBAAsB,GACjC,YAAY,MAAM,EAClB,aAAa,MAAM,EACnB,UAAU,MAAM,EAChB,sCAAoC,KACnC,MAUF,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAClC,YAAY,MAAM,EAClB,aAAa,MAAM,EACnB,UAAU,OAAO,KAChB,OAMF,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAI,KAAK,MAAM,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAY1E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,GACjC,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,UAAU,MAAM,EAAE,KACjB,IAWF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,SAAS,MAAM,EAAE,SAAS,MAAM,KAAG,KAEjE,CAAC;AAEF,eAAO,MAAM,WAAW,GACtB,KAAK,MAAM,EACX,SAAS,WAAW,EACpB,QAAQ,uBAAuB,KAC9B,OAAO,CAAC,QAAQ,CAWlB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,GACpB,KAAK,MAAM,EACX,SAAS,WAAW,EACpB,QAAQ,uBAAuB,KAC9B,OAAO,CAAC,QAAQ,CAclB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,EAChC,SAAS,OAAO,EAChB,OAAO,CAAC,EACR,QAAQ,MAAM,KACb;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAY9C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW;IACtB;;OAEG;iBACU,MAAM;IAMnB;;OAEG;oBACa,MAAM;IAItB;;OAEG;8BACuB,MAAM,GAAG,OAAO;IAI1C;;OAEG;gCAEO,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,OAAO,GAAG,WAAW,eACpD,MAAM,UACX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;IAYjC;;OAEG;+BAEO,WAAW,GAAG,WAAW,eACpB,MAAM,SACZ,KAAK,UACJ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;CASlC,CAAC"}
+{"version":3,"file":"ExternalServiceUtils.d.ts","sourceRoot":"","sources":["../../../src/common/ExternalServiceUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,uBAAuB,EACvB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,0BAA0B,CAAC;AAElC,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAkHF;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,MAAM,EAAE,iBAAa,KAAG,MAe1D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,GACjC,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,UAAU,MAAM,EAAE,KACjB,IAWF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,SAAS,MAAM,EAAE,SAAS,MAAM,KAAG,KAEjE,CAAC;AAEF,eAAO,MAAM,WAAW,GACtB,KAAK,MAAM,EACX,SAAS,WAAW,EACpB,QAAQ,uBAAuB,KAC9B,OAAO,CAAC,QAAQ,CAWlB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,GACpB,KAAK,MAAM,EACX,SAAS,WAAW,EACpB,QAAQ,uBAAuB,KAC9B,OAAO,CAAC,QAAQ,CAclB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,EAChC,SAAS,OAAO,EAChB,OAAO,CAAC,EACR,QAAQ,MAAM,KACb;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAY9C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW;IACtB;;OAEG;iBACU,MAAM;IAMnB;;OAEG;oBACa,MAAM;IAItB;;OAEG;8BACuB,MAAM,GAAG,OAAO;IAI1C;;OAEG;gCAEO,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,OAAO,GAAG,WAAW,eACpD,MAAM,UACX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;IAYjC;;OAEG;+BAEO,WAAW,GAAG,WAAW,eACpB,MAAM,SACZ,KAAK,UACJ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;CASlC,CAAC"}

package/src/common/ExternalServiceUtils.js

@@ -3,9 +3,9 @@
  * Common patterns for API calls, environment variable reading, and error handling
  */
 import { SystemTraceBridge } from '../trace/SystemTraceBridge.js';
-import { Cloudflare } from '../config/cloudflare.js';
 import { Env } from '../config/env.js';
 import { ErrorFactory } from '../exceptions/ZintrustError.js';
+export { parseJsonObjectEnv, readWorkersEnvString, readWorkersFallbackBool, readWorkersFallbackInt, readWorkersFallbackString, } from './EnvFallbackUtils.js';
 const isHeaderEntriesLike = (value) => {
     return typeof value === 'object' && value !== null && 'entries' in value;
 };
@@ -110,52 +110,6 @@ export const readEnvString = (key, fallback = '') => {
     }
     return fallback;
 };
-export const readWorkersEnvString = (key) => {
-    const workerValue = Cloudflare.getWorkersVar(key);
-    if (workerValue !== null && workerValue.trim() !== '')
-        return workerValue;
-    return '';
-};
-export const readWorkersFallbackString = (workersKey, fallbackKey, fallback = '', includeFallbackWorkerBinding = false) => {
-    const workerValue = readWorkersEnvString(workersKey);
-    if (workerValue.trim() !== '')
-        return workerValue;
-    if (includeFallbackWorkerBinding) {
-        const fallbackWorkerValue = readWorkersEnvString(fallbackKey);
-        if (fallbackWorkerValue.trim() !== '')
-            return fallbackWorkerValue;
-    }
-    return readEnvString(fallbackKey, fallback);
-};
-export const readWorkersFallbackInt = (workersKey, fallbackKey, fallback, includeFallbackWorkerBinding = false) => {
-    const raw = readWorkersFallbackString(workersKey, fallbackKey, String(fallback), includeFallbackWorkerBinding);
-    if (raw.trim() === '')
-        return fallback;
-    const parsed = Number.parseInt(raw, 10);
-    return Number.isFinite(parsed) ? parsed : fallback;
-};
-export const readWorkersFallbackBool = (workersKey, fallbackKey, fallback) => {
-    const workerValue = readWorkersEnvString(workersKey);
-    if (workerValue.trim() !== '') {
-        return workerValue === 'true' || workerValue === '1';
-    }
-    return Env.getBool(fallbackKey, fallback);
-};
-export const parseJsonObjectEnv = (key) => {
-    const raw = Env.get(key, '').trim();
-    if (raw === '')
-        return undefined;
-    try {
-        const parsed = JSON.parse(raw);
-        if (typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed)) {
-            return parsed;
-        }
-    }
-    catch {
-        return { value: raw };
-    }
-    return undefined;
-};
 /**
  * Validate required parameters for external service calls
  */

package/src/config/cache.js

@@ -3,7 +3,7 @@
  * Caching drivers and settings
  * Sealed namespace for immutability
  */
-import { parseJsonObjectEnv, readWorkersFallbackBool, readWorkersFallbackInt, readWorkersFallbackString, } from '../common/ExternalServiceUtils.js';
+import { parseJsonObjectEnv, readWorkersFallbackBool, readWorkersFallbackInt, readWorkersFallbackString, } from '../common/EnvFallbackUtils.js';
 import { Env } from './env.js';
 import { ErrorFactory } from '../exceptions/ZintrustError.js';
 import { StartupConfigFile, StartupConfigFileRegistry } from '../runtime/StartupConfigFileRegistry.js';

package/src/config/database.js

@@ -3,7 +3,8 @@
  * Database connections and pooling settings
  * Sealed namespace for immutability
  */
-import { parseJsonObjectEnv, readEnvString, readWorkersFallbackInt as readSharedWorkersFallbackInt, readWorkersFallbackString as readSharedWorkersFallbackString, } from '../common/ExternalServiceUtils.js';
+import { parseJsonObjectEnv, readWorkersFallbackInt as readSharedWorkersFallbackInt, readWorkersFallbackString as readSharedWorkersFallbackString, } from '../common/EnvFallbackUtils.js';
+import { readEnvString } from '../common/ExternalServiceUtils.js';
 import { Env } from './env.js';
 import { ErrorFactory } from '../exceptions/ZintrustError.js';
 import { StartupConfigFile, StartupConfigFileRegistry } from '../runtime/StartupConfigFileRegistry.js';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,OAAO,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,KAAK,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACtF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACpE,YAAY,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;8BAkCoY,CAAC;;;;;;;;;;;;;;;;;;;;iFAhDrX,CAAA;;;;;;;;;;;;;;;;;;;;8BAD2B,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAiDuuE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;EAH5xE,CAAC;AAEZ,MAAM,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAaH,OAAO,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,KAAK,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACtF,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAE,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACpE,YAAY,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;8BAkCoY,CAAC;;;;;;;;;;;;;;;;;;;;iFAhDrX,CAAA;;;;;;;;;;;;;;;;;;;;8BAD2B,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAiDmuE,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;EAHxxE,CAAC;AAEZ,MAAM,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC"}

package/src/config/queue.js

@@ -3,7 +3,7 @@
  * Background job and message queue settings
  * Sealed namespace for immutability
  */
-import { parseJsonObjectEnv, readWorkersFallbackBool, readWorkersFallbackInt, readWorkersFallbackString, } from '../common/ExternalServiceUtils.js';
+import { parseJsonObjectEnv, readWorkersFallbackBool, readWorkersFallbackInt, readWorkersFallbackString, } from '../common/EnvFallbackUtils.js';
 import { Env } from './env.js';
 import { Logger } from './logger.js';
 import { ErrorFactory } from '../exceptions/ZintrustError.js';

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

@@ -1 +1 @@
-{"version":3,"file":"workers.d.ts","sourceRoot":"","sources":["../../../src/config/workers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,8BAA8B,CAAC;AAItC,OAAO,KAAK,EACV,WAAW,EAIX,mBAAmB,EACpB,MAAM,cAAc,CAAC;AAItB,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AAibnC,eAAO,MAAM,qBAAqB,GAChC,QAAQ,WAAW,EACnB,mBAAc,EACd,UAAU,qBAAqB,KAC9B,OASF,CAAC;AAEF,eAAO,MAAM,wBAAwB,QAAa,OAAO,CAAC,IAAI,CAmB7D,CAAC;AAgFF,QAAA,MAAM,mBAAmB,QAAO,mBA2D/B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAkBnE,eAAO,MAAM,aAAa,EAAE,aAY1B,CAAC"}
+{"version":3,"file":"workers.d.ts","sourceRoot":"","sources":["../../../src/config/workers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAGL,KAAK,qBAAqB,EAC3B,MAAM,8BAA8B,CAAC;AAItC,OAAO,KAAK,EACV,WAAW,EAIX,mBAAmB,EACpB,MAAM,cAAc,CAAC;AAItB,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AAibnC,eAAO,MAAM,qBAAqB,GAChC,QAAQ,WAAW,EACnB,mBAAc,EACd,UAAU,qBAAqB,KAC9B,OAcF,CAAC;AAEF,eAAO,MAAM,wBAAwB,QAAa,OAAO,CAAC,IAAI,CAmB7D,CAAC;AAgFF,QAAA,MAAM,mBAAmB,QAAO,mBA2D/B,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAkBnE,eAAO,MAAM,aAAa,EAAE,aAY1B,CAAC"}

package/src/config/workers.js

@@ -329,7 +329,12 @@ export const createRedisConnection = (config, maxRetries = 3, options) => {
     const subsystem = options?.subsystem ?? '';
     const skipProxy = BULLMQ_SUBSYSTEMS.has(subsystem);
     const mode = skipProxy ? 'direct' : ensureRedisTransportMode(config, options);
-    if (mode === 'proxy' || mode === 'rpc') {
+    // In zedgi mode, allow proxy connection for queue-monitor since we have a Zedgi-native driver
+    const allowProxyForZedgi = mode === 'zedgi' && subsystem === 'queue-monitor';
+    if (mode === 'proxy' || mode === 'rpc' || mode === 'zedgi') {
+        if (skipProxy && !allowProxyForZedgi) {
+            return createDirectRedisConnection(config, maxRetries, options);
+        }
         return createRedisProxyConnection(config, options);
     }
     return createDirectRedisConnection(config, maxRetries, options);

package/src/index.js

@@ -1,11 +1,11 @@
 /**
- * @zintrust/core v2.8.3
+ * @zintrust/core v2.8.4
  *
  * ZinTrust Framework - Production-Grade TypeScript Backend
  * Built for performance, type safety, and exceptional developer experience
  *
  * Build Information:
- *   Built: 2026-06-27T09:11:20.114Z
+ *   Built: 2026-06-27T19:52:39.098Z
  *   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-06-27T09:11:20.079Z'; // Replaced during build
+export const ZINTRUST_BUILD_DATE = '2026-06-27T19:52:39.056Z'; // Replaced during build
 export { Application } from './boot/Application.js';
 export { AwsSigV4 } from './common/index.js';
 export { SignedRequest } from './security/SignedRequest.js';

package/src/redis-index.d.ts

@@ -6,4 +6,5 @@ export { RedisKeys, createRedisKey, extractOriginalKey, getBullMQSafeQueueName,
 export type { RedisConfig } from './config/type';
 export { createRedisConnection } from './config/workers';
 export type { RedisTransportOptions } from './tools/redis/RedisTransport';
+export { isZedgiRedisExecutorRegistered, registerZedgiRedisExecutor, resolveRedisTransportMode, type RedisTransportMode, } from './tools/redis/RedisTransport';
 //# sourceMappingURL=redis-index.d.ts.map

package/src/redis-index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"redis-index.d.ts","sourceRoot":"","sources":["../../src/redis-index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,SAAS,EACT,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,SAAS,EACT,QAAQ,EACR,KAAK,YAAY,GAClB,MAAM,8BAA8B,CAAC;AAGtC,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,YAAY,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC"}
+{"version":3,"file":"redis-index.d.ts","sourceRoot":"","sources":["../../src/redis-index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,SAAS,EACT,cAAc,EACd,kBAAkB,EAClB,sBAAsB,EACtB,SAAS,EACT,QAAQ,EACR,KAAK,YAAY,GAClB,MAAM,8BAA8B,CAAC;AAGtC,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,YAAY,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAGzE,OAAO,EACL,8BAA8B,EAC9B,0BAA0B,EAC1B,yBAAyB,EACzB,KAAK,kBAAkB,GACxB,MAAM,6BAA6B,CAAC"}

package/src/redis-index.js

@@ -5,3 +5,5 @@
 // Redis key manager
 export { RedisKeys, createRedisKey, extractOriginalKey, getBullMQSafeQueueName, getPrefix, isAppKey, } from './tools/redis/RedisKeyManager.js';
 export { createRedisConnection } from './config/workers.js';
+// Redis transport and Zedgi integration
+export { isZedgiRedisExecutorRegistered, registerZedgiRedisExecutor, resolveRedisTransportMode, } from './tools/redis/RedisTransport.js';

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":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAsIjD,wBAAsB,+BAA+B,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAkDxF"}
+{"version":3,"file":"QueueRuntimeRegistration.d.ts","sourceRoot":"","sources":["../../../../src/tools/queue/QueueRuntimeRegistration.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAuJjD,wBAAsB,+BAA+B,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAkDxF"}

package/src/tools/queue/QueueRuntimeRegistration.js

@@ -1,5 +1,5 @@
-import { Logger } from '../../config/logger.js';
 import { Env } from '../../config/env.js';
+import { Logger } from '../../config/logger.js';
 import { ErrorFactory } from '../../exceptions/ZintrustError.js';
 import { ZintrustLang } from '../../lang/lang.js';
 import { existsSync } from '../../node-singletons/fs.js';
@@ -7,10 +7,10 @@ import * as path from '../../node-singletons/path.js';
 import { pathToFileURL } from '../../node-singletons/url.js';
 import { detectRuntime } from '../../runtime/detectRuntime.js';
 import { DatabaseQueue } from '../queue/drivers/Database.js';
-import { autoRegisterJobStateTrackerPersistenceFromEnv } from '../queue/JobStateTrackerDbPersistence.js';
-import { QueueReliabilityOrchestrator } from '../queue/QueueReliabilityOrchestrator.js';
 import { InMemoryQueue } from '../queue/drivers/InMemory.js';
+import { autoRegisterJobStateTrackerPersistenceFromEnv } from '../queue/JobStateTrackerDbPersistence.js';
 import { Queue } from '../queue/Queue.js';
+import { QueueReliabilityOrchestrator } from '../queue/QueueReliabilityOrchestrator.js';
 const QUEUE_REDIS_PACKAGE = '@zintrust/queue-redis';
 const ZEDGI_PACKAGE = '@zintrust/zedgi';
 /**
@@ -21,7 +21,20 @@ const ZEDGI_PACKAGE = '@zintrust/zedgi';
  * - If the configured default is registered, it is ALSO registered as 'default'.
  * - Unknown/unregistered driver names still throw when selected.
  */
+const isDriverRegistered = (name) => {
+    try {
+        Queue.get(name);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};
 const registerRedisDriverIfAvailable = async () => {
+    if (isDriverRegistered('redis')) {
+        return true;
+    }
+    // Fall back to dynamic import only if not already registered
     try {
         const mod = (await import(/* @vite-ignore */ QUEUE_REDIS_PACKAGE));
         if (mod.RedisQueue !== undefined) {
@@ -63,6 +76,10 @@ const registerRedisDriverIfAvailable = async () => {
     return false;
 };
 const registerZedgiQueueDriverIfAvailable = async (config) => {
+    if (isDriverRegistered('queue-zedgi')) {
+        return true;
+    }
+    // Fall back to dynamic import only if not already registered
     try {
         const mod = (await import(/* @vite-ignore */ ZEDGI_PACKAGE));
         if (mod.ZedgiQueueDriver !== undefined) {

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

@@ -1,5 +1,5 @@
 import type { RedisConfig } from '../../config/type';
-export type RedisTransportMode = 'direct' | 'proxy' | 'rpc';
+export type RedisTransportMode = 'direct' | 'proxy' | 'rpc' | 'zedgi';
 export type RedisTransportOptions = Readonly<{
     subsystem?: string;
     requireDirect?: boolean;
@@ -32,6 +32,9 @@ type RedisProxyConnection = {
         off: (event: string, handler: (...args: unknown[]) => void) => unknown;
     };
 };
+declare let zedgiRedisExecutor: ((config: Record<string, unknown>, command: string, args: unknown[]) => Promise<unknown>) | undefined;
+export declare const registerZedgiRedisExecutor: (executor: typeof zedgiRedisExecutor) => void;
+export declare const isZedgiRedisExecutorRegistered: () => boolean;
 export declare const resolveRedisTransportMode: () => RedisTransportMode;
 export declare const createRedisProxyConnection: (config: RedisConfig, options?: RedisTransportOptions) => RedisProxyConnection;
 export declare const ensureRedisTransportMode: (config: RedisConfig, options?: RedisTransportOptions) => RedisTransportMode;

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;AAKhD,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,OAAO,GAAG,KAAK,CAAC;AAE5D,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC,CAAC;AAgBH,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,KAAK,EAAE,MAAM;QACX,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;AA6YF,eAAO,MAAM,yBAAyB,QAAO,kBAG5C,CAAC;AAEF,eAAO,MAAM,0BAA0B,GACrC,QAAQ,WAAW,EACnB,UAAU,qBAAqB,KAC9B,oBAwDF,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":"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"}

package/src/tools/redis/RedisTransport.js

@@ -3,6 +3,19 @@ import { Logger } from '../../config/logger.js';
 import { ErrorFactory } from '../../exceptions/ZintrustError.js';
 import { parseCustomHeadersFromEnv } from '../../orm/adapters/SqlProxyAdapterUtils.js';
 import { SignedRequest } from '../../security/SignedRequest.js';
+// Zedgi executor registry for static provider registration
+let zedgiRedisExecutor;
+export const registerZedgiRedisExecutor = (executor) => {
+    zedgiRedisExecutor = typeof executor === 'function' ? executor : undefined;
+};
+export const isZedgiRedisExecutorRegistered = () => zedgiRedisExecutor !== undefined;
+const isZedgiRedisEnabled = () => zedgiRedisExecutor !== undefined && readEnvBool('USE_ZEDGI', false);
+const requestZedgiCommand = async (settings, command, args) => {
+    if (zedgiRedisExecutor === undefined) {
+        throw ErrorFactory.createConfigError('Zedgi Redis executor is not registered');
+    }
+    return zedgiRedisExecutor(settings.config ?? {}, command, args);
+};
 const loggedSelections = new Set();
 const readEnvString = (key, fallback = '') => {
     if (typeof Env.get === 'function') {
@@ -167,6 +180,9 @@ const requestRpcPipeline = async (settings, commands, transaction) => {
     ]);
 };
 const requestRedisCommand = async (mode, settings, command, args) => {
+    if (mode === 'zedgi') {
+        return requestZedgiCommand(settings, command, args);
+    }
     return mode === 'rpc'
         ? requestRpcCommand(settings, command, args)
         : requestProxyCommand(settings, command, args);
@@ -187,6 +203,7 @@ const logTransportSelection = (mode, config, options) => {
         port: mode === 'direct' ? config.port : undefined,
         proxyUrl: mode === 'proxy' ? resolveProxyBaseUrl() : undefined,
         rpcUrl: mode === 'rpc' ? readEnvString('REDIS_RPC_URL', '') : undefined,
+        zedgiUrl: mode === 'zedgi' ? readEnvString('ZEDGI_URL', '') : undefined,
     });
 };
 const normalizeScanResponse = (value) => {
@@ -294,13 +311,24 @@ const createPipeline = (settings, mode, transaction = false) => {
     return pipeline;
 };
 export const resolveRedisTransportMode = () => {
+    if (isZedgiRedisEnabled())
+        return 'zedgi';
     if (isRedisRpcEnabled())
         return 'rpc';
     return readEnvBool('USE_REDIS_PROXY', false) ? 'proxy' : 'direct';
 };
 export const createRedisProxyConnection = (config, options) => {
     const mode = resolveRedisTransportMode();
-    const settings = mode === 'rpc' ? resolveRpcSettings() : resolveProxySettings();
+    let settings;
+    if (mode === 'zedgi') {
+        settings = { config };
+    }
+    else if (mode === 'rpc') {
+        settings = resolveRpcSettings();
+    }
+    else {
+        settings = resolveProxySettings();
+    }
     if (mode === 'direct') {
         throw ErrorFactory.createConfigError('Redis proxy connection requested while direct mode is active.');
     }
@@ -349,8 +377,8 @@ export const createRedisProxyConnection = (config, options) => {
 };
 export const ensureRedisTransportMode = (config, options) => {
     const mode = resolveRedisTransportMode();
-    if (mode === 'proxy' && options?.requireDirect === true) {
-        throw ErrorFactory.createConfigError(`Redis subsystem '${options.subsystem ?? 'redis'}' requires a direct Redis connection, but proxy mode is enabled.`);
+    if ((mode === 'proxy' || mode === 'zedgi') && options?.requireDirect === true) {
+        throw ErrorFactory.createConfigError(`Redis subsystem '${options.subsystem ?? 'redis'}' requires a direct Redis connection, but ${mode} mode is enabled.`);
     }
     if (mode === 'direct') {
         logTransportSelection(mode, config, options);