@zintrust/core 2.1.8 → 2.1.9

package/package.json

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

package/src/cache/Cache.d.ts

@@ -19,6 +19,7 @@ export declare const Cache: Readonly<{
     clear: () => Promise<void>;
     has: (key: string) => Promise<boolean>;
     getDriver: () => CacheDriver;
+    getRedisClient: (storeName?: string) => unknown;
     store: (name?: string) => CacheStore;
     reset: () => void;
 }>;
@@ -32,6 +33,7 @@ export declare const cache: Readonly<{
     clear: () => Promise<void>;
     has: (key: string) => Promise<boolean>;
     getDriver: () => CacheDriver;
+    getRedisClient: (storeName?: string) => unknown;
     store: (name?: string) => CacheStore;
     reset: () => void;
 }>;

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

@@ -1 +1 @@
-{"version":3,"file":"Cache.d.ts","sourceRoot":"","sources":["../../../src/cache/Cache.ts"],"names":[],"mappings":"AACA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAkMtD,KAAK,UAAU,GAAG,QAAQ,CAAC;IACzB,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC3C,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,SAAS,EAAE,MAAM,WAAW,CAAC;CAC9B,CAAC,CAAC;AA8FH,eAAO,MAAM,KAAK;UAhMC,CAAC,OAAO,MAAM,KAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;UAkBlC,CAAC,OAAO,MAAM,SAAS,CAAC,QAAQ,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;kBAkBjD,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;iBAiBtB,OAAO,CAAC,IAAI,CAAC;eAgBb,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC;qBAkB3B,WAAW;mBAaX,MAAM,KAAG,UAAU;iBAuFvB,IAAI;EAcpB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,KAAK;UA9MC,CAAC,OAAO,MAAM,KAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;UAkBlC,CAAC,OAAO,MAAM,SAAS,CAAC,QAAQ,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;kBAkBjD,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;iBAiBtB,OAAO,CAAC,IAAI,CAAC;eAgBb,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC;qBAkB3B,WAAW;mBAaX,MAAM,KAAG,UAAU;iBAuFvB,IAAI;EAmBI,CAAC"}
+{"version":3,"file":"Cache.d.ts","sourceRoot":"","sources":["../../../src/cache/Cache.ts"],"names":[],"mappings":"AACA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAuMtD,KAAK,UAAU,GAAG,QAAQ,CAAC;IACzB,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC3C,GAAG,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/D,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACvC,SAAS,EAAE,MAAM,WAAW,CAAC;CAC9B,CAAC,CAAC;AAwGH,eAAO,MAAM,KAAK;UA1MC,CAAC,OAAO,MAAM,KAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;UAkBlC,CAAC,OAAO,MAAM,SAAS,CAAC,QAAQ,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;kBAkBjD,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;iBAiBtB,OAAO,CAAC,IAAI,CAAC;eAgBb,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC;qBAkB3B,WAAW;iCAwGG,MAAM,KAAG,OAAO;mBA3F9B,MAAM,KAAG,UAAU;iBAuFvB,IAAI;EAyBpB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,KAAK;UAzNC,CAAC,OAAO,MAAM,KAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;UAkBlC,CAAC,OAAO,MAAM,SAAS,CAAC,QAAQ,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;kBAkBjD,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;iBAiBtB,OAAO,CAAC,IAAI,CAAC;eAgBb,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC;qBAkB3B,WAAW;iCAwGG,MAAM,KAAG,OAAO;mBA3F9B,MAAM,KAAG,UAAU;iBAuFvB,IAAI;EA8BI,CAAC"}

package/src/cache/Cache.js

@@ -29,6 +29,9 @@ function createNoOpDriver() {
         delete: async () => { },
         clear: async () => { },
         has: async () => false,
+        getRedisClient() {
+            throw ErrorFactory.createConfigError('getRedisClient() is not supported with no-op cache driver');
+        },
     };
 }
 function buildDriver(driver) {
@@ -181,6 +184,13 @@ const store = (name) => {
 const reset = () => {
     instances.clear();
 };
+const getRedisClient = (storeName) => {
+    const driver = getDriverInstance(storeName);
+    if (typeof driver.getRedisClient !== 'function') {
+        throw ErrorFactory.createConfigError('getRedisClient() is only supported by Redis cache driver');
+    }
+    return driver.getRedisClient();
+};
 // Sealed namespace with cache functionality
 export const Cache = Object.freeze({
     get,
@@ -189,6 +199,7 @@ export const Cache = Object.freeze({
     clear,
     has,
     getDriver,
+    getRedisClient,
     store,
     reset,
 });

package/src/cache/CacheDriver.d.ts

@@ -27,6 +27,11 @@ export interface CacheDriver {
      * Dispose of resources (optional cleanup method)
      */
     dispose?(): Promise<void>;
+    /**
+     * Get the underlying Redis client for advanced operations like transactions
+     * Only supported by Redis driver, throws error for other drivers
+     */
+    getRedisClient?(): unknown;
 }
 export declare const CACHE_DRIVER_INTERFACE = "CacheDriver";
 //# sourceMappingURL=CacheDriver.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"CacheDriver.d.ts","sourceRoot":"","sources":["../../../src/cache/CacheDriver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAEvC;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3D;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEnC;;OAEG;IACH,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAGD,eAAO,MAAM,sBAAsB,gBAAgB,CAAC"}
+{"version":3,"file":"CacheDriver.d.ts","sourceRoot":"","sources":["../../../src/cache/CacheDriver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAEvC;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3D;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC;;OAEG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEvB;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEnC;;OAEG;IACH,OAAO,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1B;;;OAGG;IACH,cAAc,CAAC,IAAI,OAAO,CAAC;CAC5B;AAGD,eAAO,MAAM,sBAAsB,gBAAgB,CAAC"}

package/src/cache/drivers/KVDriver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"KVDriver.d.ts","sourceRoot":"","sources":["../../../../src/cache/drivers/KVDriver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAoDtD;;GAEG;AACH,eAAO,MAAM,QAAQ;kBAhDF,WAAW;EAkD5B,CAAC"}
+{"version":3,"file":"KVDriver.d.ts","sourceRoot":"","sources":["../../../../src/cache/drivers/KVDriver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AA2DtD;;GAEG;AACH,eAAO,MAAM,QAAQ;kBAtDF,WAAW;EAwD5B,CAAC"}

package/src/cache/drivers/KVDriver.js

@@ -4,6 +4,7 @@
  */
 import { Cloudflare } from '../../config/cloudflare.js';
 import { Logger } from '../../config/logger.js';
+import { ErrorFactory } from '../../exceptions/ZintrustError.js';
 /**
  * Create a new KV driver instance
  */
@@ -45,6 +46,9 @@ const create = () => {
             const value = await kv.get(key);
             return value !== null;
         },
+        getRedisClient() {
+            throw ErrorFactory.createConfigError('getRedisClient() is only supported by Redis cache driver, not KV driver');
+        },
     };
 };
 /**

package/src/cache/drivers/KVRemoteDriver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"KVRemoteDriver.d.ts","sourceRoot":"","sources":["../../../../src/cache/drivers/KVRemoteDriver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAmZtD,eAAO,MAAM,cAAc;kBAvEM,WAAW;EAyE1C,CAAC;AAEH,eAAe,cAAc,CAAC"}
+{"version":3,"file":"KVRemoteDriver.d.ts","sourceRoot":"","sources":["../../../../src/cache/drivers/KVRemoteDriver.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAyZtD,eAAO,MAAM,cAAc;kBA7EM,WAAW;EA+E1C,CAAC;AAEH,eAAe,cAAc,CAAC"}

package/src/cache/drivers/KVRemoteDriver.js

@@ -300,6 +300,9 @@ const createKvRemoteDriver = () => {
         },
         clear: clearKvRemoteDriver,
         has: createKvRemoteHas(cf.getJson),
+        getRedisClient() {
+            throw ErrorFactory.createConfigError('getRedisClient() is only supported by Redis cache driver, not KV remote driver');
+        },
     };
 };
 export const KVRemoteDriver = Object.freeze({

package/src/cache/drivers/MemoryDriver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MemoryDriver.d.ts","sourceRoot":"","sources":["../../../../src/cache/drivers/MemoryDriver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAuFtD;;GAEG;AACH,eAAO,MAAM,YAAY;kBAxEN,WAAW;EA0E5B,CAAC"}
+{"version":3,"file":"MemoryDriver.d.ts","sourceRoot":"","sources":["../../../../src/cache/drivers/MemoryDriver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AA8FtD;;GAEG;AACH,eAAO,MAAM,YAAY;kBA9EN,WAAW;EAgF5B,CAAC"}

package/src/cache/drivers/MemoryDriver.js

@@ -2,6 +2,7 @@
  * Memory Cache Driver
  * Simple in-memory storage for local development
  */
+import { ErrorFactory } from '../../exceptions/ZintrustError.js';
 function isUnrefableTimer(value) {
     return (typeof value === 'object' &&
         value !== null &&
@@ -69,6 +70,9 @@ const create = () => {
             storage.clear();
             await Promise.resolve();
         },
+        getRedisClient() {
+            throw ErrorFactory.createConfigError('getRedisClient() is only supported by Redis cache driver, not memory driver');
+        },
     };
 };
 /**

package/src/cache/drivers/MongoDriver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MongoDriver.d.ts","sourceRoot":"","sources":["../../../../src/cache/drivers/MongoDriver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAKtD;;;;GAIG;AACH,eAAO,MAAM,WAAW;IACtB;;OAEG;cACO,WAAW;EA4ErB,CAAC"}
+{"version":3,"file":"MongoDriver.d.ts","sourceRoot":"","sources":["../../../../src/cache/drivers/MongoDriver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAKtD;;;;GAIG;AACH,eAAO,MAAM,WAAW;IACtB;;OAEG;cACO,WAAW;EAkFrB,CAAC"}

package/src/cache/drivers/MongoDriver.js

@@ -75,6 +75,9 @@ export const MongoDriver = Object.freeze({
                 const result = (await request('findOne', { filter: { _id: key } }));
                 return result?.document !== undefined && result.document !== null;
             },
+            getRedisClient() {
+                throw ErrorFactory.createConfigError('getRedisClient() is only supported by Redis cache driver, not MongoDB driver');
+            },
         };
     },
 });

package/src/cache/drivers/RedisDriver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RedisDriver.d.ts","sourceRoot":"","sources":["../../../../src/cache/drivers/RedisDriver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAmXtD;;GAEG;AACH,eAAO,MAAM,WAAW;kBAXL,WAAW;EAa5B,CAAC"}
+{"version":3,"file":"RedisDriver.d.ts","sourceRoot":"","sources":["../../../../src/cache/drivers/RedisDriver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AA6XtD;;GAEG;AACH,eAAO,MAAM,WAAW;kBAXL,WAAW;EAa5B,CAAC"}

package/src/cache/drivers/RedisDriver.js

@@ -109,6 +109,9 @@ const createCacheDriverFromIoredisClient = (client) => ({
             return false;
         }
     },
+    getRedisClient() {
+        return client;
+    },
 });
 const createIoredisCacheDriver = (params) => {
     const client = createIoredisClient(params);
@@ -288,6 +291,9 @@ const createTcpCacheDriver = () => {
                 return false;
             }
         },
+        getRedisClient() {
+            throw ErrorFactory.createConfigError('getRedisClient() is only supported with ioredis driver, not TCP socket driver');
+        },
     };
 };
 /**

package/src/index.js

@@ -1,11 +1,11 @@
 /**
- * @zintrust/core v2.1.8
+ * @zintrust/core v2.1.9
  *
  * ZinTrust Framework - Production-Grade TypeScript Backend
  * Built for performance, type safety, and exceptional developer experience
  *
  * Build Information:
- *   Built: 2026-05-27T14:43:06.009Z
+ *   Built: 2026-05-27T15:00:45.519Z
  *   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-27T14:43:05.974Z'; // Replaced during build
+export const ZINTRUST_BUILD_DATE = '2026-05-27T15:00:45.486Z'; // Replaced during build
 export { Application } from './boot/Application.js';
 export { AwsSigV4 } from './common/index.js';
 export { SignedRequest } from './security/SignedRequest.js';