@zintrust/core 0.7.2 → 0.7.3

package/package.json

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

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;AA2YtD,eAAO,MAAM,cAAc;kBA5FM,WAAW;EA8F1C,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;AA6YtD,eAAO,MAAM,cAAc;kBAvEM,WAAW;EAyE1C,CAAC;AAEH,eAAe,cAAc,CAAC"}

package/src/cache/drivers/KVRemoteDriver.js

@@ -206,6 +206,25 @@ const createCloudflareKvApiClient = (resolveNamespaceId) => {
     };
     return { getJson, putJson, deleteKey };
 };
+const logKvRemoteProxyFallback = (operation, error) => {
+    Logger.warn(`KV remote proxy ${operation} failed; falling back to Cloudflare KV API`, Logger.withTraceSkipContext({
+        error: error instanceof Error ? error.message : String(error),
+    }));
+};
+const clearKvRemoteDriver = async () => {
+    Logger.warn('KV remote clear() is not implemented.');
+    await Promise.resolve();
+};
+const createKvRemoteHas = (getJson) => {
+    return async function has(key) {
+        if (!hasCloudflareApiCreds())
+            return (await this.get(key)) !== null;
+        const settings = getSettings();
+        if (!hasProxySigningCreds(settings))
+            return (await getJson(key)) !== null;
+        return (await this.get(key)) !== null;
+    };
+};
 const createKvRemoteDriver = () => {
     const resolveNamespaceId = createCloudflareNamespaceIdResolver();
     const cf = createCloudflareKvApiClient(resolveNamespaceId);
@@ -226,11 +245,7 @@ const createKvRemoteDriver = () => {
             catch (error) {
                 if (!hasCloudflareApiCreds())
                     throw error;
-                Logger.warn('KV remote proxy GET failed; falling back to Cloudflare KV API', {
-                    ...Logger.withTraceSkipContext({
-                        error: error instanceof Error ? error.message : String(error),
-                    }),
-                });
+                logKvRemoteProxyFallback('GET', error);
                 return cf.getJson(key);
             }
         },
@@ -252,11 +267,7 @@ const createKvRemoteDriver = () => {
             catch (error) {
                 if (!hasCloudflareApiCreds())
                     throw error;
-                Logger.warn('KV remote proxy PUT failed; falling back to Cloudflare KV API', {
-                    ...Logger.withTraceSkipContext({
-                        error: error instanceof Error ? error.message : String(error),
-                    }),
-                });
+                logKvRemoteProxyFallback('PUT', error);
                 await cf.putJson(key, value, ttl);
             }
         },
@@ -276,26 +287,12 @@ const createKvRemoteDriver = () => {
             catch (error) {
                 if (!hasCloudflareApiCreds())
                     throw error;
-                Logger.warn('KV remote proxy DELETE failed; falling back to Cloudflare KV API', {
-                    ...Logger.withTraceSkipContext({
-                        error: error instanceof Error ? error.message : String(error),
-                    }),
-                });
+                logKvRemoteProxyFallback('DELETE', error);
                 await cf.deleteKey(key);
             }
         },
-        async clear() {
-            Logger.warn('KV remote clear() is not implemented.');
-            await Promise.resolve();
-        },
-        async has(key) {
-            if (!hasCloudflareApiCreds())
-                return (await this.get(key)) !== null;
-            const settings = getSettings();
-            if (!hasProxySigningCreds(settings))
-                return (await cf.getJson(key)) !== null;
-            return (await this.get(key)) !== null;
-        },
+        clear: clearKvRemoteDriver,
+        has: createKvRemoteHas(cf.getJson),
     };
 };
 export const KVRemoteDriver = Object.freeze({

package/src/index.js

@@ -1,11 +1,11 @@
 /**
- * @zintrust/core v0.7.2
+ * @zintrust/core v0.7.3
  *
  * ZinTrust Framework - Production-Grade TypeScript Backend
  * Built for performance, type safety, and exceptional developer experience
  *
  * Build Information:
- *   Built: 2026-04-18T19:22:40.542Z
+ *   Built: 2026-04-18T19:50:18.473Z
  *   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-04-18T19:22:40.508Z'; // Replaced during build
+export const ZINTRUST_BUILD_DATE = '2026-04-18T19:50:18.439Z'; // Replaced during build
 export { Application } from './boot/Application.js';
 export { AwsSigV4 } from './common/index.js';
 export { SignedRequest } from './security/SignedRequest.js';

package/src/proxy/ProxyServerUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProxyServerUtils.d.ts","sourceRoot":"","sources":["../../../src/proxy/ProxyServerUtils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAI7D,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC,CAAC;AAEH,eAAO,MAAM,iBAAiB,GAC5B,WAAW,kBAAkB,EAC7B,QAAQ,MAAM,EACd,WAAW;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,KACjE,eAUF,CAAC;AAEF,eAAO,MAAM,wBAAwB,GACnC,WAAW,kBAAkB,EAC7B,QAAQ,MAAM,KACb;IACD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,OAAO,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;CAOtB,CAAC;AAEL,eAAO,MAAM,sBAAsB,GACjC,KAAK,eAAe,EACpB,MAAM,MAAM,EACZ,QAAQ;IAAE,OAAO,EAAE,kBAAkB,CAAA;CAAE,EACvC,aAAa,MAAM,KAClB,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAkCtE,CAAC"}
+{"version":3,"file":"ProxyServerUtils.d.ts","sourceRoot":"","sources":["../../../src/proxy/ProxyServerUtils.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAI7D,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC,CAAC;AAiCH,eAAO,MAAM,iBAAiB,GAC5B,WAAW,kBAAkB,EAC7B,QAAQ,MAAM,EACd,WAAW;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,KACjE,eAUF,CAAC;AAEF,eAAO,MAAM,wBAAwB,GACnC,WAAW,kBAAkB,EAC7B,QAAQ,MAAM,KACb;IACD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,OAAO,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;CAOtB,CAAC;AAEL,eAAO,MAAM,sBAAsB,GACjC,KAAK,eAAe,EACpB,MAAM,MAAM,EACZ,QAAQ;IAAE,OAAO,EAAE,kBAAkB,CAAA;CAAE,EACvC,aAAa,MAAM,KAClB,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAoCtE,CAAC"}

package/src/proxy/ProxyServerUtils.js

@@ -1,7 +1,38 @@
 import { Env } from '../config/env.js';
 import { Logger } from '../config/logger.js';
+import { isNonEmptyString } from '../helper/index.js';
 import { resolveProxySigningConfig } from './ProxySigningConfigResolver.js';
 import { extractSigningHeaders, verifyProxySignatureIfNeeded } from './ProxySigningRequest.js';
+const PROXY_DEBUG_ENV_BY_SERVICE = Object.freeze({
+    MySQLProxyServer: 'MYSQL_PROXY_DEBUG',
+    PostgresProxyServer: 'POSTGRES_PROXY_DEBUG',
+    RedisProxyServer: 'REDIS_PROXY_DEBUG',
+    SqlServerProxyServer: 'SQLSERVER_PROXY_DEBUG',
+});
+const parseProxyDebugValue = (raw) => {
+    const normalized = raw.trim().toLowerCase();
+    if (normalized === 'true' || normalized === '1' || normalized === 'yes')
+        return true;
+    if (normalized === 'false' || normalized === '0' || normalized === 'no')
+        return false;
+    return undefined;
+};
+const resolveProxyDebugEnabled = (serviceName) => {
+    const serviceEnvKey = PROXY_DEBUG_ENV_BY_SERVICE[serviceName];
+    const serviceRaw = serviceEnvKey ? Env.get(serviceEnvKey, '') : '';
+    if (isNonEmptyString(serviceRaw)) {
+        const parsed = parseProxyDebugValue(serviceRaw);
+        if (parsed !== undefined)
+            return parsed;
+    }
+    const sharedRaw = Env.get('ZT_PROXY_DEBUG', '');
+    if (isNonEmptyString(sharedRaw)) {
+        const parsed = parseProxyDebugValue(sharedRaw);
+        if (parsed !== undefined)
+            return parsed;
+    }
+    return false;
+};
 export const resolveBaseConfig = (overrides, prefix, defaults) => {
     const host = overrides.host ?? Env.get(`${prefix}_PROXY_HOST`, Env.HOST ?? defaults?.host ?? '127.0.0.1');
     const port = overrides.port ?? Env.getInt(`${prefix}_PROXY_PORT`, Env.PORT ?? defaults?.port ?? 3000);
@@ -18,17 +49,19 @@ export const resolveBaseSigningConfig = (overrides, prefix) => resolveProxySigni
 export const verifyRequestSignature = async (req, body, config, serviceName) => {
     const headers = extractSigningHeaders(req);
     const hasAnySigningHeader = Object.values(headers).some((value) => typeof value === 'string' && value.trim() !== '');
-    Logger.debug(`[${serviceName}] Verifying request signature`, {
-        ...Logger.withTraceSkipContext({
-            path: req.url ?? '',
-            method: req.method ?? 'POST',
-            requireSigning: config.signing.require,
-            hasAnySigningHeader,
-            configuredKeyId: config.signing.keyId,
-            hasConfiguredSecret: config.signing.secret.trim() !== '',
-            bodyBytes: body.length,
-        }),
-    });
+    if (resolveProxyDebugEnabled(serviceName)) {
+        Logger.debug(`[${serviceName}] Verifying request signature`, {
+            ...Logger.withTraceSkipContext({
+                path: req.url ?? '',
+                method: req.method ?? 'POST',
+                requireSigning: config.signing.require,
+                hasAnySigningHeader,
+                configuredKeyId: config.signing.keyId,
+                hasConfiguredSecret: config.signing.secret.trim() !== '',
+                bodyBytes: body.length,
+            }),
+        });
+    }
     const verified = await verifyProxySignatureIfNeeded(req, body, config.signing);
     if (!verified.ok) {
         const error = verified.error ?? { status: 401, message: 'Unauthorized' };