@zintrust/core 2.9.0 → 3.0.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zintrust/core",
-  "version": "2.9.0",
+  "version": "3.0.1",
   "description": "Production-grade TypeScript backend framework for JavaScript",
   "homepage": "https://zintrust.com",
   "repository": {
@@ -224,8 +224,8 @@
     "jsonwebtoken": "^9.0.3",
     "mysql2": "^3.22.5",
     "pg": "^8.22.0",
-    "redis": "^6.1.0",
-    "tsx": "^4.22.5"
+    "redis": "^6.0.1",
+    "tsx": "^4.22.4"
   },
   "overrides": {
     "ajv": "^8.18.0",

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

@@ -1 +1 @@
-{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../../src/config/queue.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH,OAAO,KAAK,EACV,sBAAsB,EACtB,eAAe,EACf,kBAAkB,EAKnB,MAAM,cAAc,CAAC;AAyCtB,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC;IACzC,OAAO,EAAE,eAAe,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACrC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,UAAU,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACnF,OAAO,EAAE;QACP,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;QAClC,WAAW,EAAE,OAAO,CAAC;QACrB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,kBAAkB,EAAE,MAAM,CAAC;KAC5B,CAAC;CACH,CAAC,CAAC;AAuFH;;GAEG;AACH,eAAO,MAAM,iBAAiB,QAAO,kBAiBnC,CAAC;AAkDH,QAAA,MAAM,iBAAiB,QAAO;IAC5B,OAAO,EAAE,eAAe,CAAC;IACzB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,SAAS,EAAE,CAAC,YAAY,EAAE,sBAAsB,KAAK,kBAAkB,CAAC,eAAe,CAAC,CAAC;IACzF,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,UAAU,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACnF,OAAO,EAAE;QACP,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;QAClC,WAAW,EAAE,OAAO,CAAC;QACrB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,kBAAkB,EAAE,MAAM,CAAC;KAC5B,CAAC;CAuEH,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAkB/D,eAAO,MAAM,WAAW,EAAE,WAYxB,CAAC"}
+{"version":3,"file":"queue.d.ts","sourceRoot":"","sources":["../../../src/config/queue.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAcH,OAAO,KAAK,EACV,sBAAsB,EACtB,eAAe,EACf,kBAAkB,EAKnB,MAAM,cAAc,CAAC;AAyCtB,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC;IACzC,OAAO,EAAE,eAAe,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACrC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,UAAU,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACnF,OAAO,EAAE;QACP,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;QAClC,WAAW,EAAE,OAAO,CAAC;QACrB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,kBAAkB,EAAE,MAAM,CAAC;KAC5B,CAAC;CACH,CAAC,CAAC;AA6FH;;GAEG;AACH,eAAO,MAAM,iBAAiB,QAAO,kBAiBnC,CAAC;AAkDH,QAAA,MAAM,iBAAiB,QAAO;IAC5B,OAAO,EAAE,eAAe,CAAC;IACzB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,SAAS,EAAE,CAAC,YAAY,EAAE,sBAAsB,KAAK,kBAAkB,CAAC,eAAe,CAAC,CAAC;IACzF,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,UAAU,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACnF,OAAO,EAAE;QACP,OAAO,EAAE,OAAO,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;QAClC,WAAW,EAAE,OAAO,CAAC;QACrB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,kBAAkB,EAAE,MAAM,CAAC;KAC5B,CAAC;CAuEH,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAkB/D,eAAO,MAAM,WAAW,EAAE,WAYxB,CAAC"}

package/src/config/queue.js

@@ -83,6 +83,12 @@ const createSqsQueueDriver = () => ({
     region: Env.AWS_REGION,
     queueUrl: Env.get('AWS_SQS_QUEUE_URL'),
 });
+const resolveDefaultQueueDriver = () => {
+    const connection = Env.get('QUEUE_CONNECTION', '').trim();
+    if (connection !== '')
+        return connection;
+    return Env.get('QUEUE_DRIVER', 'sync');
+};
 /**
  * Helper: Create base driver configurations from environment
  */
@@ -138,7 +144,7 @@ const createBaseMonitor = () => {
 };
 const createQueueConfig = () => {
     const overrides = StartupConfigFileRegistry.get(StartupConfigFile.Queue) ?? {};
-    const baseDefault = Env.get('QUEUE_DRIVER', 'sync');
+    const baseDefault = resolveDefaultQueueDriver();
     const baseDrivers = createBaseDrivers();
     const baseFailed = {
         database: Env.get('FAILED_JOBS_DB_CONNECTION', 'default'),

package/src/index.js

@@ -1,11 +1,11 @@
 /**
- * @zintrust/core v2.9.0
+ * @zintrust/core v3.0.1
  *
  * ZinTrust Framework - Production-Grade TypeScript Backend
  * Built for performance, type safety, and exceptional developer experience
  *
  * Build Information:
- *   Built: 2026-07-02T15:52:01.052Z
+ *   Built: 2026-07-13T15:20:14.904Z
  *   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-07-02T15:52:01.021Z'; // Replaced during build
+export const ZINTRUST_BUILD_DATE = '2026-07-13T15:20:14.868Z'; // Replaced during build
 export { Application } from './boot/Application.js';
 export { AwsSigV4 } from './common/index.js';
 export { SignedRequest } from './security/SignedRequest.js';

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

@@ -1 +1 @@
-{"version":3,"file":"OfficialPlugins.d.ts","sourceRoot":"","sources":["../../../src/runtime/OfficialPlugins.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG,QAAQ,CAAC;AAuKxD,eAAO,MAAM,eAAe;;;;;uBAKR,uBAAuB,GAAY,aAAa,CAAC,MAAM,CAAC;0BAGrD,uBAAuB,GAAY,aAAa,CAAC,MAAM,CAAC;EAG7E,CAAC"}
+{"version":3,"file":"OfficialPlugins.d.ts","sourceRoot":"","sources":["../../../src/runtime/OfficialPlugins.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,uBAAuB,GAAG,MAAM,GAAG,QAAQ,CAAC;AAyKxD,eAAO,MAAM,eAAe;;;;;uBAKR,uBAAuB,GAAY,aAAa,CAAC,MAAM,CAAC;0BAGrD,uBAAuB,GAAY,aAAa,CAAC,MAAM,CAAC;EAG7E,CAAC"}

package/src/runtime/OfficialPlugins.js

@@ -12,6 +12,7 @@ const isSelected = (keys, expected) => {
     const value = readEnvString(...keys);
     return value !== '' && expected.includes(value);
 };
+const isQueueSelected = (expected) => isSelected(['QUEUE_CONNECTION', 'QUEUE_DRIVER'], expected);
 const looksLikeSqlitePath = () => {
     const raw = readEnvString('DB_PATH', 'DB_DATABASE');
     if (raw === '')
@@ -52,28 +53,28 @@ const baseRegistrations = Object.freeze([
         isEnabled: () => readEnvBool('USE_ZEDGI') ||
             isSelected(['DB_CONNECTION'], ['mysql-zedgi', 'postgres-zedgi', 'pg-zedgi']) ||
             isSelected(['CACHE_CONNECTION', 'CACHE_DRIVER'], ['redis-zedgi']) ||
-            isSelected(['QUEUE_DRIVER'], ['queue-zedgi']),
+            isQueueSelected(['queue-zedgi']),
     },
     {
         packageName: '@zintrust/queue-redis',
         specifier: '@zintrust/queue-redis/register',
-        isEnabled: () => isSelected(['QUEUE_DRIVER'], ['redis']) ||
+        isEnabled: () => isQueueSelected(['redis']) ||
             isSelected(['BROADCAST_CONNECTION', 'BROADCAST_DRIVER'], ['redis', 'redishttps']),
     },
     {
         packageName: '@zintrust/queue-rabbitmq',
         specifier: '@zintrust/queue-rabbitmq/register',
-        isEnabled: () => isSelected(['QUEUE_DRIVER'], ['rabbitmq']),
+        isEnabled: () => isQueueSelected(['rabbitmq']),
     },
     {
         packageName: '@zintrust/queue-sqs',
         specifier: '@zintrust/queue-sqs/register',
-        isEnabled: () => isSelected(['QUEUE_DRIVER'], ['sqs']),
+        isEnabled: () => isQueueSelected(['sqs']),
     },
     {
         packageName: '@zintrust/queue-cloudflare',
         specifier: '@zintrust/queue-cloudflare/register',
-        isEnabled: () => isSelected(['QUEUE_DRIVER'], ['cloudflare', 'cloudflare-queues', 'cf-queues']),
+        isEnabled: () => isQueueSelected(['cloudflare', 'cloudflare-queues', 'cf-queues']),
     },
     {
         packageName: '@zintrust/cache-redis',

package/src/worker-runtime/rpc-client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rpc-client.d.ts","sourceRoot":"","sources":["../../../src/worker-runtime/rpc-client.ts"],"names":[],"mappings":"AAiBA,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAOF,eAAO,MAAM,oBAAoB,QAAO,OAAkC,CAAC;AA6B3E,wFAAwF;AACxF,eAAO,MAAM,OAAO,GAClB,WAAW,MAAM,EACjB,qBAAqB,MAAM,KAC1B,OAAO,CAAC,SAAS,GAAG,SAAS,CAM/B,CAAC;AAEF,mCAAmC;AACnC,eAAO,MAAM,MAAM,GACjB,WAAW,MAAM,EACjB,OAAO,MAAM,EACb,cAAc,OAAO,KACpB,OAAO,CAAC,IAAI,CAEd,CAAC;AAEF,gCAAgC;AAChC,eAAO,MAAM,OAAO,GAAU,WAAW,MAAM,EAAE,OAAO,MAAM,EAAE,QAAQ,MAAM,KAAG,OAAO,CAAC,IAAI,CAM5F,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,WAAW,QAAa,OAAO,CAAC,gBAAgB,EAAE,CAG9D,CAAC"}
+{"version":3,"file":"rpc-client.d.ts","sourceRoot":"","sources":["../../../src/worker-runtime/rpc-client.ts"],"names":[],"mappings":"AAiBA,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAOF,eAAO,MAAM,oBAAoB,QAAO,OAAkC,CAAC;AAiD3E,wFAAwF;AACxF,eAAO,MAAM,OAAO,GAClB,WAAW,MAAM,EACjB,qBAAqB,MAAM,KAC1B,OAAO,CAAC,SAAS,GAAG,SAAS,CAU/B,CAAC;AAEF,mCAAmC;AACnC,eAAO,MAAM,MAAM,GACjB,WAAW,MAAM,EACjB,OAAO,MAAM,EACb,cAAc,OAAO,KACpB,OAAO,CAAC,IAAI,CAEd,CAAC;AAEF,gCAAgC;AAChC,eAAO,MAAM,OAAO,GAAU,WAAW,MAAM,EAAE,OAAO,MAAM,EAAE,QAAQ,MAAM,KAAG,OAAO,CAAC,IAAI,CAM5F,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,gFAAgF;AAChF,eAAO,MAAM,WAAW,QAAa,OAAO,CAAC,gBAAgB,EAAE,CAG9D,CAAC"}

package/src/worker-runtime/rpc-client.js

@@ -11,6 +11,26 @@ import { ErrorFactory } from '../exceptions/ZintrustError.js';
 const getBaseUrl = () => Env.get('REDIS_RPC_URL', '').trim();
 const getSecret = () => Env.get('REDIS_RPC_SECRET', Env.get('REDIS_PROXY_SECRET', Env.get('APP_KEY', ''))).trim();
 export const isRedisRpcConfigured = () => getBaseUrl().length > 0;
+/**
+ * Resolve the target Redis database index from env
+ * (REDIS_QUEUE_DB → REDIS_DB → undefined).
+ * Returns undefined when no explicit DB is configured,
+ * which means the RPC backend uses its own server default.
+ */
+const getQueueDb = () => {
+    const queueDb = Env.getInt('REDIS_QUEUE_DB', -1);
+    if (queueDb >= 0)
+        return queueDb;
+    const redisDb = Env.getInt('REDIS_DB', -1);
+    if (redisDb >= 0)
+        return redisDb;
+    return undefined;
+};
+/** Merge target DB into any queue RPC payload when configured. */
+const queuePayload = (extra) => {
+    const db = getQueueDb();
+    return db === undefined ? extra : { db, ...extra };
+};
 const call = async (service, method, payload = {}) => {
     const baseUrl = getBaseUrl();
     if (baseUrl.length === 0) {
@@ -33,20 +53,20 @@ const call = async (service, method, payload = {}) => {
 };
 /** Atomically claim and pull the next waiting job for a queue, or undefined if none. */
 export const pullJob = async (queueName, visibilityTimeoutMs) => {
-    const result = await call('queue', 'dequeue', {
+    const result = await call('queue', 'dequeue', queuePayload({
         queueName,
         visibilityTimeoutMs,
-    });
+    }));
     return result ?? undefined;
 };
 /** Mark a pulled job completed. */
 export const ackJob = async (queueName, jobId, returnValue) => {
-    await call('queue', 'ack', { queueName, jobId, returnValue });
+    await call('queue', 'ack', queuePayload({ queueName, jobId, returnValue }));
 };
 /** Mark a pulled job failed. */
 export const failJob = async (queueName, jobId, reason) => {
     try {
-        await call('queue', 'fail', { queueName, jobId, reason });
+        await call('queue', 'fail', queuePayload({ queueName, jobId, reason }));
     }
     catch (error) {
         Logger.warn('[worker-runtime] failJob RPC failed', { queueName, jobId, error });

package/src/zintrust.plugins.d.ts

@@ -1,7 +1,10 @@
 /**
- * Auto-generated fallback module.
- * This file is created by scripts/ensure-worker-plugins.mjs when missing.
- * It allows optional runtime plugin imports to resolve in CI/scaffolded setups.
+ * ZinTrust plugin auto-imports
+ *
+ * In real projects, this file is managed by `zin plugin install` and contains
+ * side-effect imports (e.g. `@zintrust/db-sqlite/register`) that register
+ * optional adapters/drivers into core registries.
+ *
  */
 export type {};
 export declare const __zintrustGeneratedPluginStub = "zintrust.plugins.ts";

package/src/zintrust.plugins.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"zintrust.plugins.d.ts","sourceRoot":"","sources":["../../src/zintrust.plugins.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,YAAY,EAAE,CAAC;AAgBf,eAAO,MAAM,6BAA6B,wBAAwB,CAAC;;AACnE,wBAAkB"}
+{"version":3,"file":"zintrust.plugins.d.ts","sourceRoot":"","sources":["../../src/zintrust.plugins.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,YAAY,EAAE,CAAC;AAgBf,eAAO,MAAM,6BAA6B,wBAAwB,CAAC;;AACnE,wBAAkB"}

package/src/zintrust.plugins.js

@@ -1,7 +1,10 @@
 /**
- * Auto-generated fallback module.
- * This file is created by scripts/ensure-worker-plugins.mjs when missing.
- * It allows optional runtime plugin imports to resolve in CI/scaffolded setups.
+ * ZinTrust plugin auto-imports
+ *
+ * In real projects, this file is managed by `zin plugin install` and contains
+ * side-effect imports (e.g. `@zintrust/db-sqlite/register`) that register
+ * optional adapters/drivers into core registries.
+ *
  */
 import * as TraceRuntime from './runtime/plugins/trace-runtime.js';
 globalThis.__zintrust_system_trace_plugin_requested__ = true;