@zintrust/core 2.7.2 → 2.7.3

package/package.json

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

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;AA2DtD;;GAEG;AACH,eAAO,MAAM,QAAQ;kBAtDF,WAAW;EAwD5B,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;AA0DtD;;GAEG;AACH,eAAO,MAAM,QAAQ;kBArDF,WAAW;EAuD5B,CAAC"}

package/src/cache/drivers/KVDriver.js

@@ -9,8 +9,7 @@ import { ErrorFactory } from '../../exceptions/ZintrustError.js';
  * Create a new KV driver instance
  */
 const create = () => {
-    // In Cloudflare Workers, the KV namespace is usually bound to a variable in the environment
-    const kv = Cloudflare.getKVBinding('CACHE');
+    const kv = Cloudflare.getKVBinding();
     return {
         async get(key) {
             if (kv === null)
@@ -20,7 +19,7 @@ const create = () => {
         },
         async set(key, value, ttl) {
             if (kv === null) {
-                Logger.warn('KV binding "CACHE" not found. Cache set ignored.');
+                Logger.warn('Configured KV binding not found. Cache set ignored.');
                 return;
             }
             const options = {};

package/src/health/RuntimeHealthProbes.js

@@ -40,9 +40,9 @@ const pingKvCache = async (timeoutMs = 2000) => {
     if (driver !== 'kv')
         return null;
     const start = Date.now();
-    const kv = Cloudflare.getKVBinding('CACHE');
+    const kv = Cloudflare.getKVBinding();
     if (kv === null) {
-        throw ErrorFactory.createConfigError('KV binding "CACHE" not found');
+        throw ErrorFactory.createConfigError('Configured KV binding not found');
     }
     const key = `__runtime_health__:kv:${Date.now()}`;
     await withTimeout('runtime.cache.kv.ping', timeoutMs, async () => {

package/src/index.js

@@ -1,11 +1,11 @@
 /**
- * @zintrust/core v2.7.2
+ * @zintrust/core v2.7.3
  *
  * ZinTrust Framework - Production-Grade TypeScript Backend
  * Built for performance, type safety, and exceptional developer experience
  *
  * Build Information:
- *   Built: 2026-06-19T10:18:51.959Z
+ *   Built: 2026-06-20T09:43:35.633Z
  *   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-19T10:18:51.925Z'; // Replaced during build
+export const ZINTRUST_BUILD_DATE = '2026-06-20T09:43:35.558Z'; // Replaced during build
 export { Application } from './boot/Application.js';
 export { AwsSigV4 } from './common/index.js';
 export { SignedRequest } from './security/SignedRequest.js';

package/src/tools/broadcast/Broadcast.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Broadcast.d.ts","sourceRoot":"","sources":["../../../../src/tools/broadcast/Broadcast.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAE/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,KAAK,WAAW,GAAG,QAAQ,CAAC;IAC1B,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1E,OAAO,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,OAAO,CAAC,sBAAsB,CAAC,CAAC;CAC5E,CAAC,CAAC;AAEH,KAAK,qBAAqB,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,YAAY,CAAC;AAC9E,KAAK,qBAAqB,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAC1D,KAAK,kBAAkB,GAAG,eAAe,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAShE,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,KAAK,CAAC,EAAE,qBAAqB,CAAC;IAC9B,YAAY,CAAC,EAAE,qBAAqB,CAAC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC,CAAC;AA0BH,MAAM,MAAM,sBAAsB,GAAG,QAAQ,CAAC;IAC5C,EAAE,EAAE,IAAI,CAAC;IACT,SAAS,EAAE,kBAAkB,CAAC;IAC9B,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,0BAA0B,CAAC,QAAQ,CAAC,CAAC;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mBAAmB,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACpD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;CAC9B,CAAC,CAAC;AAo3BH,eAAO,MAAM,SAAS;mBACC,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC;kBAIxD,MAAM,SAAS,MAAM,QAAQ,OAAO;0BAU5B,MAAM,SAAS,MAAM,QAAQ,OAAO;wBAKvD,qBAAqB,YACnB;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;4BAO1C,MAAM,SACR,MAAM,QACP,OAAO,YACJ;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;qBAKpC,MAAM;8BAES,qBAAqB;kCAEjB,MAAM,SAAS,MAAM,QAAQ,OAAO;;uBAKrD,MAAM,GAAG,WAAW;EAmBvC,CAAC;AAEH,eAAe,SAAS,CAAC"}
+{"version":3,"file":"Broadcast.d.ts","sourceRoot":"","sources":["../../../../src/tools/broadcast/Broadcast.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAE/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,KAAK,WAAW,GAAG,QAAQ,CAAC;IAC1B,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1E,OAAO,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,OAAO,CAAC,sBAAsB,CAAC,CAAC;CAC5E,CAAC,CAAC;AAEH,KAAK,qBAAqB,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,YAAY,CAAC;AAC9E,KAAK,qBAAqB,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAC1D,KAAK,kBAAkB,GAAG,eAAe,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAShE,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7B,KAAK,CAAC,EAAE,qBAAqB,CAAC;IAC9B,YAAY,CAAC,EAAE,qBAAqB,CAAC;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC,CAAC;AA0BH,MAAM,MAAM,sBAAsB,GAAG,QAAQ,CAAC;IAC5C,EAAE,EAAE,IAAI,CAAC;IACT,SAAS,EAAE,kBAAkB,CAAC;IAC9B,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,0BAA0B,CAAC,QAAQ,CAAC,CAAC;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mBAAmB,CAAC,EAAE,SAAS,kBAAkB,EAAE,CAAC;IACpD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;CAC9B,CAAC,CAAC;AAs3BH,eAAO,MAAM,SAAS;mBACC,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC;kBAIxD,MAAM,SAAS,MAAM,QAAQ,OAAO;0BAU5B,MAAM,SAAS,MAAM,QAAQ,OAAO;wBAKvD,qBAAqB,YACnB;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;4BAO1C,MAAM,SACR,MAAM,QACP,OAAO,YACJ;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE;qBAKpC,MAAM;8BAES,qBAAqB;kCAEjB,MAAM,SAAS,MAAM,QAAQ,OAAO;;uBAKrD,MAAM,GAAG,WAAW;EAmBvC,CAAC;AAEH,eAAe,SAAS,CAAC"}

package/src/tools/broadcast/Broadcast.js

@@ -1,9 +1,9 @@
 import { isArray, isNonEmptyString, isObject } from '../../helper/index.js';
-import { delay } from '../../common/index.js';
 import { InMemoryDriver } from './drivers/InMemory.js';
 import { PusherDriver } from './drivers/Pusher.js';
 import { RedisDriver } from './drivers/Redis.js';
 import { RedisHttpsDriver } from './drivers/RedisHttps.js';
+import { delay } from '../../common/index.js';
 import broadcastConfig from '../../config/broadcast.js';
 import { Env } from '../../config/env.js';
 import { Logger } from '../../config/logger.js';
@@ -31,7 +31,8 @@ const resolveInternalPublishRetryConfig = () => ({
 // exponential backoff + full jitter
 const computeRetryDelayMs = (baseDelayMs, attempt) => {
     const exponential = baseDelayMs * Math.pow(2, attempt - 1);
-    const jitter = baseDelayMs === 0 ? 0 : Math.floor(Math.random() * baseDelayMs);
+    const num = Math.random(); // NOSONAR
+    const jitter = baseDelayMs === 0 ? 0 : Math.floor(num * baseDelayMs);
     return exponential + jitter;
 };
 const pickFirstNonEmpty = (...values) => {
@@ -305,29 +306,29 @@ const attemptInternalPublishEndpoint = async (endpoint, secret, payload) => {
         return { result: null, error, transient: true };
     }
 };
-const requestInternalPublishEndpoint = async (endpoint, secret, payload) => {
-    const { maxAttempts, baseDelayMs } = resolveInternalPublishRetryConfig();
-    let lastAttempt = { result: null };
-    for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
-        lastAttempt = await attemptInternalPublishEndpoint(endpoint, secret, payload);
-        if (lastAttempt.result !== null) {
-            return lastAttempt;
-        }
-        // Non-transient failures (application 4xx, etc.) reached the origin; do not retry.
-        if (lastAttempt.transient !== true || attempt >= maxAttempts) {
-            break;
-        }
-        const delayMs = computeRetryDelayMs(baseDelayMs, attempt);
-        Logger.warn('Broadcast internal publish retrying transient failure.', {
-            endpoint,
-            attempt,
-            maxAttempts,
-            delayMs,
-            status: lastAttempt.status,
-        });
-        await delay(delayMs);
+const requestInternalPublishEndpoint = async (endpoint, secret, payload, attempt = 1, retryConfig) => {
+    const { maxAttempts, baseDelayMs } = retryConfig ?? resolveInternalPublishRetryConfig();
+    const result = await attemptInternalPublishEndpoint(endpoint, secret, payload);
+    if (result.result !== null) {
+        return result;
+    }
+    // Non-transient failures (application 4xx, etc.) reached the origin; do not retry.
+    if (result.transient !== true || attempt >= maxAttempts) {
+        return result;
     }
-    return lastAttempt;
+    const delayMs = computeRetryDelayMs(baseDelayMs, attempt);
+    Logger.warn('Broadcast internal publish retrying transient failure.', {
+        endpoint,
+        attempt,
+        maxAttempts,
+        delayMs,
+        status: result.status,
+    });
+    await delay(delayMs);
+    return requestInternalPublishEndpoint(endpoint, secret, payload, attempt + 1, {
+        maxAttempts,
+        baseDelayMs,
+    });
 };
 const tryInternalPublishEndpoints = async (endpoints, secret, payload, index = 0, lastError) => {
     const endpoint = endpoints[index];