@zintrust/core 2.2.1 → 2.2.2

package/package.json

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

package/src/index.js

@@ -1,11 +1,11 @@
 /**
- * @zintrust/core v2.2.1
+ * @zintrust/core v2.2.2
  *
  * ZinTrust Framework - Production-Grade TypeScript Backend
  * Built for performance, type safety, and exceptional developer experience
  *
  * Build Information:
- *   Built: 2026-05-27T19:51:45.261Z
+ *   Built: 2026-05-28T12:49:02.769Z
  *   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-05-27T19:51:45.222Z'; // Replaced during build
+export const ZINTRUST_BUILD_DATE = '2026-05-28T12:49:02.707Z'; // Replaced during build
 export { Application } from './boot/Application.js';
 export { AwsSigV4 } from './common/index.js';
 export { SignedRequest } from './security/SignedRequest.js';

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

@@ -6,17 +6,34 @@ export type RedisTransportOptions = Readonly<{
 }>;
 type RedisProxyConnection = {
     [x: string]: unknown;
+    __bullmq_iredis?: true;
+    isCluster?: false;
+    options?: Readonly<Record<string, unknown>>;
     status: 'ready';
     connect: () => Promise<void>;
     quit: () => Promise<'OK'>;
     disconnect: () => void;
+    duplicate: () => RedisProxyConnection;
+    defineCommand: (name: string, definition: {
+        numberOfKeys: number;
+        lua: string;
+    }) => void;
+    runCommand: (name: string, args: unknown[]) => Promise<unknown>;
     on: (event: string, handler: (...args: unknown[]) => void) => RedisProxyConnection;
     once: (event: string, handler: (...args: unknown[]) => void) => RedisProxyConnection;
     off: (event: string, handler: (...args: unknown[]) => void) => RedisProxyConnection;
     removeListener: (event: string, handler: (...args: unknown[]) => void) => RedisProxyConnection;
+    setMaxListeners: (count: number) => RedisProxyConnection;
+    getMaxListeners: () => number;
     call: (command: string, ...args: unknown[]) => Promise<unknown>;
     pipeline: () => {
         exec: () => Promise<Array<[Error | null, unknown]>>;
+        runCommand?: (name: string, args: unknown[]) => unknown;
+        [key: string]: unknown;
+    };
+    multi: () => {
+        exec: () => Promise<Array<[Error | null, unknown]>>;
+        runCommand?: (name: string, args: unknown[]) => unknown;
         [key: string]: unknown;
     };
     scanStream: (options?: {

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,CAAC;AAEpD,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC,CAAC;AAUH,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;AAiRF,eAAO,MAAM,yBAAyB,QAAO,kBAI5C,CAAC;AAEF,eAAO,MAAM,0BAA0B,GACrC,QAAQ,WAAW,EACnB,UAAU,qBAAqB,KAC9B,oBAgDF,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

@@ -186,10 +186,14 @@ const createScanStream = (settings, options) => {
     });
     return stream;
 };
-const createPipeline = (settings) => {
+const createPipeline = (settings, _runCommand) => {
     const commands = [];
     const target = {
         async exec() {
+            Logger.debug('[redis][proxy][pipeline] Executing pipeline', {
+                commandCount: commands.length,
+                commands: commands.map((c) => ({ command: c.command, argsCount: c.args.length })),
+            });
             const results = [];
             for (const entry of commands) {
                 try {
@@ -208,6 +212,15 @@ const createPipeline = (settings) => {
             }
             return results;
         },
+        runCommand(name, args) {
+            Logger.debug('[redis][proxy][pipeline] runCommand called in pipeline', {
+                commandName: name,
+                argsCount: args.length,
+                hasRunCommandFunction: _runCommand !== undefined,
+            });
+            commands.push({ command: name, args });
+            return pipeline;
+        },
     };
     const pipeline = new Proxy(target, {
         get(obj, prop) {
@@ -215,6 +228,10 @@ const createPipeline = (settings) => {
                 return Reflect.get(obj, prop);
             if (prop in obj)
                 return Reflect.get(obj, prop);
+            Logger.debug('[redis][proxy][pipeline] Property access in pipeline', {
+                property: prop,
+                currentCommandCount: commands.length,
+            });
             return (...args) => {
                 commands.push({ command: prop.toUpperCase(), args });
                 return pipeline;
@@ -228,46 +245,151 @@ export const resolveRedisTransportMode = () => {
         ? 'proxy'
         : 'direct';
 };
-export const createRedisProxyConnection = (config, options) => {
-    const settings = resolveProxySettings();
-    logTransportSelection('proxy', config, options);
+const logDefineCommandCall = (name, definition) => {
+    Logger.debug('[redis][proxy][bullmq] defineCommand called', {
+        commandName: name,
+        numberOfKeys: definition.numberOfKeys,
+        luaLength: definition.lua.length,
+        luaPreview: definition.lua.substring(0, 100) + '...',
+    });
+};
+const storeScript = (scripts, name, definition) => {
+    scripts.set(name, {
+        numberOfKeys: definition.numberOfKeys,
+        lua: definition.lua,
+    });
+    Logger.debug('[redis][proxy][bullmq] Script stored', {
+        commandName: name,
+        totalScripts: scripts.size,
+        allScriptNames: Array.from(scripts.keys()),
+    });
+};
+const executeScriptViaEval = async (settings, name, script, args) => {
+    Logger.debug('[redis][proxy][bullmq] Executing script via EVAL', {
+        commandName: name,
+        numberOfKeys: script.numberOfKeys,
+        luaLength: script.lua.length,
+        args: args.slice(0, 3), // Log first 3 args to avoid huge logs
+    });
+    return requestProxyCommand(settings, 'EVAL', [script.lua, script.numberOfKeys, ...args]);
+};
+const createCommandFunction = (settings, prop) => {
+    return async (...args) => {
+        Logger.debug('[redis][proxy][trap] Executing unknown property as command', {
+            property: prop,
+            argsCount: args.length,
+            args: args.slice(0, 3),
+        });
+        return requestProxyCommand(settings, typeof prop === 'string' ? prop.toUpperCase() : String(prop), args);
+    };
+};
+const handlePropertyAccess = (obj, prop, scripts, client, settings) => {
+    if (typeof prop !== 'string')
+        return Reflect.get(obj, prop);
+    if (prop === 'then')
+        return undefined;
+    if (prop === 'setMaxListeners') {
+        return function (_count) {
+            return client;
+        };
+    }
+    if (prop === 'getMaxListeners') {
+        return function () {
+            return Infinity;
+        };
+    }
+    if (prop in obj) {
+        Logger.debug('[redis][proxy][trap] Property access on target object', {
+            property: prop,
+            hasScript: scripts.has(prop),
+        });
+        return Reflect.get(obj, prop);
+    }
+    // Log when BullMQ accesses unknown properties (potential versioned commands)
+    Logger.debug('[redis][proxy][trap] Unknown property access - potential BullMQ command', {
+        property: prop,
+        propertyType: typeof prop,
+        hasScript: typeof prop === 'string' ? scripts.has(prop) : false,
+        availableScripts: Array.from(scripts.keys()),
+        isVersionedCommand: typeof prop === 'string' ? prop.includes(':') : false,
+    });
+    if (typeof prop !== 'string') {
+        return Reflect.get(obj, prop);
+    }
+    return createCommandFunction(settings, prop);
+};
+const createProxyTarget = (config, options, scripts, runDefinedCommand, settings, client) => {
     const target = {
+        __bullmq_iredis: true,
+        isCluster: false,
+        options: Object.freeze({}),
         status: 'ready',
         connect: async () => { },
         // eslint-disable-next-line @typescript-eslint/require-await
         quit: async () => 'OK',
         disconnect: () => undefined,
-        on: (_event, _handler) => client,
-        once: (_event, _handler) => client,
-        off: (_event, _handler) => client,
-        removeListener: (_event, _handler) => client,
-        setMaxListeners: (_count) => client,
+        duplicate: () => createRedisProxyConnection(config, options),
+        defineCommand: (name, definition) => {
+            logDefineCommandCall(name, definition);
+            storeScript(scripts, name, definition);
+        },
+        runCommand: async (name, args) => runDefinedCommand(name, args),
+        on: (_event, _handler) => client ?? target,
+        once: (_event, _handler) => client ?? target,
+        off: (_event, _handler) => client ?? target,
+        removeListener: (_event, _handler) => client ?? target,
+        setMaxListeners: (_count) => client ?? target,
         getMaxListeners: () => Infinity,
         call: async (command, ...args) => {
+            Logger.debug('[redis][proxy][call] Direct call method invoked', {
+                command,
+                argsCount: args.length,
+                hasScript: scripts.has(command),
+                isVersionedCommand: command.includes(':'),
+                args: args.slice(0, 3),
+            });
             return requestProxyCommand(settings, command, args);
         },
-        pipeline: () => createPipeline(settings),
+        pipeline: () => createPipeline(settings, runDefinedCommand),
+        multi: () => createPipeline(settings, runDefinedCommand),
         scanStream: (scanOptions) => createScanStream(settings, scanOptions),
     };
-    const client = new Proxy(target, {
+    return target;
+};
+export const createRedisProxyConnection = (config, options) => {
+    const settings = resolveProxySettings();
+    const scripts = new Map();
+    const runDefinedCommand = async (name, args) => {
+        Logger.debug('[redis][proxy][bullmq] runDefinedCommand called', {
+            commandName: name,
+            argsCount: args.length,
+            hasScript: scripts.has(name),
+            scriptKeys: Array.from(scripts.keys()),
+        });
+        const script = scripts.get(name);
+        if (script === undefined) {
+            Logger.warn('[redis][proxy][bullmq] Script not found, falling back to direct proxy call', {
+                commandName: name,
+                availableScripts: Array.from(scripts.keys()),
+            });
+            return requestProxyCommand(settings, name, args);
+        }
+        return executeScriptViaEval(settings, name, script, args);
+    };
+    logTransportSelection('proxy', config, options);
+    Logger.info('[redis][proxy][bullmq] Creating BullMQ-compatible proxy connection', {
+        hasBullMQFlag: true,
+        hasIsClusterFlag: true,
+        hasOptionsFlag: true,
+        hasDuplicateMethod: true,
+        hasDefineCommandMethod: true,
+        hasRunCommandMethod: true,
+        hasMultiMethod: true,
+    });
+    const proxyTarget = createProxyTarget(config, options, scripts, runDefinedCommand, settings, null);
+    const client = new Proxy(proxyTarget, {
         get(obj, prop) {
-            if (typeof prop !== 'string')
-                return Reflect.get(obj, prop);
-            if (prop === 'then')
-                return undefined;
-            if (prop === 'setMaxListeners') {
-                return function (_count) {
-                    return client;
-                };
-            }
-            if (prop === 'getMaxListeners') {
-                return function () {
-                    return Infinity;
-                };
-            }
-            if (prop in obj)
-                return Reflect.get(obj, prop);
-            return async (...args) => requestProxyCommand(settings, prop.toUpperCase(), args);
+            return handlePropertyAccess(obj, prop, scripts, client, settings);
         },
     });
     return client;