@zintrust/core 0.4.83 → 0.4.84

package/package.json

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

package/src/index.js

@@ -1,11 +1,11 @@
 /**
- * @zintrust/core v0.4.83
+ * @zintrust/core v0.4.84
  *
  * ZinTrust Framework - Production-Grade TypeScript Backend
  * Built for performance, type safety, and exceptional developer experience
  *
  * Build Information:
- *   Built: 2026-04-08T17:11:55.886Z
+ *   Built: 2026-04-08T17:43:03.695Z
  *   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-08T17:11:55.852Z'; // Replaced during build
+export const ZINTRUST_BUILD_DATE = '2026-04-08T17:43:03.659Z'; // Replaced during build
 export { Application } from './boot/Application.js';
 export { AwsSigV4 } from './common/index.js';
 export { SignedRequest } from './security/SignedRequest.js';

package/src/orm/adapters/MySQLProxyAdapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MySQLProxyAdapter.d.ts","sourceRoot":"","sources":["../../../../src/orm/adapters/MySQLProxyAdapter.ts"],"names":[],"mappings":"AACA;;;;GAIG;AAgBH,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAe,MAAM,sBAAsB,CAAC;AAuO1F,eAAO,MAAM,iBAAiB;oBACZ,cAAc,GAAG,gBAAgB;EAcjD,CAAC;AAEH,eAAe,iBAAiB,CAAC"}
+{"version":3,"file":"MySQLProxyAdapter.d.ts","sourceRoot":"","sources":["../../../../src/orm/adapters/MySQLProxyAdapter.ts"],"names":[],"mappings":"AACA;;;;GAIG;AAgBH,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAe,MAAM,sBAAsB,CAAC;AAkU1F,eAAO,MAAM,iBAAiB;oBACZ,cAAc,GAAG,gBAAgB;EAcjD,CAAC;AAEH,eAAe,iBAAiB,CAAC"}

package/src/orm/adapters/MySQLProxyAdapter.js

@@ -33,18 +33,79 @@ const buildSignedProxyConfig = (settings) => {
 };
 const isQueryResponse = (value) => isRecord(value) && Array.isArray(value['rows']) && typeof value['rowCount'] === 'number';
 const isQueryOneResponse = (value) => isRecord(value) && 'row' in value;
+const hasText = (value) => typeof value === 'string' && value.trim() !== '';
+const describeErrorBody = (body) => {
+    const bodyCode = hasText(body['code']) ? body['code'].trim() : '';
+    const bodyMessage = hasText(body['message']) ? body['message'].trim() : '';
+    if (bodyCode !== '' && bodyMessage !== '')
+        return `${bodyCode}: ${bodyMessage}`;
+    if (bodyCode !== '')
+        return bodyCode;
+    if (bodyMessage !== '')
+        return bodyMessage;
+    return undefined;
+};
+const describeErrorRecord = (record) => {
+    const body = record['body'];
+    if (isRecord(body)) {
+        const describedBody = describeErrorBody(body);
+        if (describedBody !== undefined)
+            return describedBody;
+    }
+    const nestedDetails = describeErrorDetails(record['details']);
+    if (nestedDetails !== undefined)
+        return nestedDetails;
+    if (hasText(record['message']))
+        return record['message'].trim();
+    if (hasText(record['code']))
+        return record['code'].trim();
+    return undefined;
+};
+const describeErrorDetails = (details) => {
+    if (hasText(details))
+        return details.trim();
+    if (!isRecord(details))
+        return undefined;
+    return describeErrorRecord(details);
+};
+const withMaybeProperty = (target, key, value) => {
+    if (value === undefined)
+        return target;
+    return { ...target, [key]: value };
+};
+const toLoggedError = (error) => {
+    if (!(error instanceof Error)) {
+        return { message: String(error) };
+    }
+    const maybeError = error;
+    const detailSummary = describeErrorDetails(maybeError.details);
+    const message = detailSummary !== undefined && !error.message.includes(detailSummary)
+        ? `${error.message} (${detailSummary})`
+        : error.message;
+    let loggedError = {
+        message,
+    };
+    loggedError = withMaybeProperty(loggedError, 'code', hasText(maybeError.code) ? maybeError.code : undefined);
+    loggedError = withMaybeProperty(loggedError, 'statusCode', typeof maybeError.statusCode === 'number' ? maybeError.statusCode : undefined);
+    loggedError = withMaybeProperty(loggedError, 'details', maybeError.details);
+    return loggedError;
+};
 const requestProxy = async (state, path, payload) => {
     try {
         return await SqlProxyHttpAdapterShared.requestProxy(state.signed, path, payload);
     }
     catch (error) {
+        const loggedError = toLoggedError(error);
         Logger.error('[MySQLProxyAdapter] Proxy request failed', {
             path,
             baseUrl: state.settings.baseUrl,
             timeoutMs: state.settings.timeoutMs,
             hasKeyId: (state.settings.keyId ?? '').trim() !== '',
             hasSecret: (state.settings.secret ?? '').trim() !== '',
-            error: error instanceof Error ? error.message : String(error),
+            error: loggedError.message,
+            ...withMaybeProperty({}, 'errorCode', loggedError.code),
+            ...withMaybeProperty({}, 'errorStatusCode', loggedError.statusCode),
+            ...withMaybeProperty({}, 'errorDetails', loggedError.details),
         });
         throw error;
     }

package/src/proxy/d1/ZintrustD1Proxy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ZintrustD1Proxy.d.ts","sourceRoot":"","sources":["../../../../src/proxy/d1/ZintrustD1Proxy.ts"],"names":[],"mappings":"AAUA,KAAK,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,aAAa,CAAC;AAEjD,KAAK,qBAAqB,GAAG;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,KAAK,WAAW,GAAG;IACjB,GAAG,EAAE;QACH,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;QACtC,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;QACrE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;QAChE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,WAAW,GAAG,MAAM,GAAG,IAAI,CAAC,CAAC;KAChG,CAAC;IACF,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACrF,CAAC;AAEF,KAAK,WAAW,CAAC,CAAC,IAAI;IACpB,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;CACf,CAAC;AAEF,KAAK,WAAW,GAAG;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,KAAK,mBAAmB,GAAG;IACzB,IAAI,EAAE,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,KAAK,mBAAmB,CAAC;IACpD,GAAG,EAAE,CAAC,CAAC,GAAG,OAAO,OAAO,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,KAAK,EAAE,CAAC,CAAC,GAAG,OAAO,OAAO,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC5C,GAAG,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC;CACjC,CAAC;AAEF,KAAK,UAAU,GAAG;IAChB,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,mBAAmB,CAAC;CAC/C,CAAC;AAEF,KAAK,KAAK,GAAG;IACX,EAAE,CAAC,EAAE,UAAU,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC,CAAC;AAkSF,eAAO,MAAM,eAAe;;;mBAGL,OAAO,OAAO,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC;EAqB5D,CAAC;AAEH,eAAe,eAAe,CAAC"}
+{"version":3,"file":"ZintrustD1Proxy.d.ts","sourceRoot":"","sources":["../../../../src/proxy/d1/ZintrustD1Proxy.ts"],"names":[],"mappings":"AAUA,KAAK,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,aAAa,CAAC;AAEjD,KAAK,qBAAqB,GAAG;IAC3B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,KAAK,WAAW,GAAG;IACjB,GAAG,EAAE;QACH,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;QACtC,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;QACrE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;QAChE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,WAAW,GAAG,MAAM,GAAG,IAAI,CAAC,CAAC;KAChG,CAAC;IACF,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACrF,CAAC;AAEF,KAAK,WAAW,CAAC,CAAC,IAAI;IACpB,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;CACf,CAAC;AAEF,KAAK,WAAW,GAAG;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,KAAK,mBAAmB,GAAG;IACzB,IAAI,EAAE,CAAC,GAAG,MAAM,EAAE,OAAO,EAAE,KAAK,mBAAmB,CAAC;IACpD,GAAG,EAAE,CAAC,CAAC,GAAG,OAAO,OAAO,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,KAAK,EAAE,CAAC,CAAC,GAAG,OAAO,OAAO,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC5C,GAAG,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC;CACjC,CAAC;AAEF,KAAK,UAAU,GAAG;IAChB,OAAO,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,mBAAmB,CAAC;CAC/C,CAAC;AAEF,KAAK,KAAK,GAAG;IACX,EAAE,CAAC,EAAE,UAAU,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC,CAAC;AAiTF,eAAO,MAAM,eAAe;;;mBAGL,OAAO,OAAO,KAAK,GAAG,OAAO,CAAC,QAAQ,CAAC;EAqB5D,CAAC;AAEH,eAAe,eAAe,CAAC"}

package/src/proxy/d1/ZintrustD1Proxy.js

@@ -1,4 +1,4 @@
-import { SystemTraceBridge } from '../../trace/SystemTraceBridge.js';
+import { SystemTraceWorkerBridge } from '../../trace/SystemTraceWorkerBridge.js';
 import { getEnvInt, json, normalizeBindingName, readAndVerifyJson, toErrorResponse, } from '../CloudflareProxyShared.js';
 import { RequestValidator } from '../RequestValidator.js';
 const DEFAULT_SIGNING_WINDOW_MS = 60_000;
@@ -149,7 +149,7 @@ const handleQuery = async (request, env) => {
             .prepare(resolved.sql)
             .bind(...resolved.params)
             .all();
-        SystemTraceBridge.emitQuery(resolved.sql, resolved.params, Date.now() - startedAt, 'd1-proxy');
+        SystemTraceWorkerBridge.emitQuery(resolved.sql, resolved.params, Date.now() - startedAt, 'd1-proxy');
         const rows = result.results ?? [];
         return json(200, { rows, rowCount: rows.length });
     }
@@ -168,7 +168,7 @@ const handleQueryOne = async (request, env) => {
             .prepare(resolved.sql)
             .bind(...resolved.params)
             .first();
-        SystemTraceBridge.emitQuery(resolved.sql, resolved.params, Date.now() - startedAt, 'd1-proxy');
+        SystemTraceWorkerBridge.emitQuery(resolved.sql, resolved.params, Date.now() - startedAt, 'd1-proxy');
         return json(200, { row: row ?? null });
     }
     catch (error) {
@@ -186,7 +186,7 @@ const handleExec = async (request, env) => {
             .prepare(resolved.sql)
             .bind(...resolved.params)
             .run();
-        SystemTraceBridge.emitQuery(resolved.sql, resolved.params, Date.now() - startedAt, 'd1-proxy');
+        SystemTraceWorkerBridge.emitQuery(resolved.sql, resolved.params, Date.now() - startedAt, 'd1-proxy');
         return json(200, { ok: true, meta: out.meta });
     }
     catch (error) {
@@ -230,14 +230,14 @@ const handleStatement = async (request, env) => {
                 .prepare(sql)
                 .bind(...parsed.params)
                 .run();
-            SystemTraceBridge.emitQuery(sql, parsed.params, Date.now() - startedAt, 'd1-proxy');
+            SystemTraceWorkerBridge.emitQuery(sql, parsed.params, Date.now() - startedAt, 'd1-proxy');
             return json(200, { ok: true, meta: out.meta });
         }
         const out = await resolved.db
             .prepare(sql)
             .bind(...parsed.params)
             .all();
-        SystemTraceBridge.emitQuery(sql, parsed.params, Date.now() - startedAt, 'd1-proxy');
+        SystemTraceWorkerBridge.emitQuery(sql, parsed.params, Date.now() - startedAt, 'd1-proxy');
         const rows = out.results ?? [];
         return json(200, { rows, rowCount: rows.length });
     }

package/src/proxy/kv/ZintrustKvProxy.js

@@ -1,4 +1,4 @@
-import { SystemTraceBridge } from '../../trace/SystemTraceBridge.js';
+import { SystemTraceWorkerBridge } from '../../trace/SystemTraceWorkerBridge.js';
 import { isObject, isString } from '../../helper/index.js';
 import { getEnvInt, json, normalizeBindingName, readAndVerifyJson, toErrorResponse, } from '../CloudflareProxyShared.js';
 import { RequestValidator } from '../RequestValidator.js';
@@ -72,16 +72,16 @@ const handleGet = async (request, env) => {
     const startedAt = Date.now();
     if (parsed.type === 'json') {
         const value = await resolved.cache.get(storageKey, 'json');
-        SystemTraceBridge.emitCache('get', storageKey, Date.now() - startedAt, value !== null, value, 'kv-proxy');
+        SystemTraceWorkerBridge.emitCache('get', storageKey, Date.now() - startedAt, value !== null, value, 'kv-proxy');
         return json(200, { value: value ?? null });
     }
     if (parsed.type === 'arrayBuffer') {
         const value = await resolved.cache.get(storageKey, 'arrayBuffer');
-        SystemTraceBridge.emitCache('get', storageKey, Date.now() - startedAt, value !== null, value, 'kv-proxy');
+        SystemTraceWorkerBridge.emitCache('get', storageKey, Date.now() - startedAt, value !== null, value, 'kv-proxy');
         return json(200, { value: value ?? null });
     }
     const value = await resolved.cache.get(storageKey);
-    SystemTraceBridge.emitCache('get', storageKey, Date.now() - startedAt, value !== null, value, 'kv-proxy');
+    SystemTraceWorkerBridge.emitCache('get', storageKey, Date.now() - startedAt, value !== null, value, 'kv-proxy');
     return json(200, { value: value ?? null });
 };
 const parsePutPayload = (payload) => {
@@ -119,7 +119,7 @@ const handlePut = async (request, env) => {
         options.expirationTtl = Math.floor(parsed.ttlSeconds);
     }
     await resolved.cache.put(storageKey, value, options);
-    SystemTraceBridge.emitCache('set', storageKey, Date.now() - startedAt, undefined, parsed.value, 'kv-proxy', parsed.ttlSeconds);
+    SystemTraceWorkerBridge.emitCache('set', storageKey, Date.now() - startedAt, undefined, parsed.value, 'kv-proxy', parsed.ttlSeconds);
     return json(200, { ok: true });
 };
 const parseDeletePayload = (payload) => {
@@ -142,7 +142,7 @@ const handleDelete = async (request, env) => {
     const storageKey = buildStorageKey(env, { namespace: parsed.namespace, key: parsed.key });
     const startedAt = Date.now();
     await resolved.cache.delete(storageKey);
-    SystemTraceBridge.emitCache('delete', storageKey, Date.now() - startedAt, undefined, undefined, 'kv-proxy');
+    SystemTraceWorkerBridge.emitCache('delete', storageKey, Date.now() - startedAt, undefined, undefined, 'kv-proxy');
     return json(200, { ok: true });
 };
 const parseListPayload = (payload) => {
@@ -177,7 +177,7 @@ const handleList = async (request, env) => {
         limit,
         cursor: parsed.params.cursor,
     });
-    SystemTraceBridge.emitEvent('kv-proxy.list', 1, {
+    SystemTraceWorkerBridge.emitEvent('kv-proxy.list', 1, {
         prefix: fullPrefix,
         limit,
         cursor: parsed.params.cursor,

package/src/trace/SystemTraceWorkerBridge.d.ts

@@ -0,0 +1,7 @@
+export declare const SystemTraceWorkerBridge: Readonly<{
+    emitCache: (operation: "get" | "set" | "delete" | "clear" | "has", key: string, duration: number, hit?: boolean, payload?: unknown, store?: string, ttl?: number) => void;
+    emitEvent: (name: string, listenerCount: number, payload?: unknown) => void;
+    emitQuery: (query: string, params: unknown[], duration: number, connection?: string) => void;
+}>;
+export default SystemTraceWorkerBridge;
+//# sourceMappingURL=SystemTraceWorkerBridge.d.ts.map

package/src/trace/SystemTraceWorkerBridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SystemTraceWorkerBridge.d.ts","sourceRoot":"","sources":["../../../src/trace/SystemTraceWorkerBridge.ts"],"names":[],"mappings":"AAgEA,eAAO,MAAM,uBAAuB;2BA9BvB,KAAK,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,KAAK,OAChD,MAAM,YACD,MAAM,QACV,OAAO,YACH,OAAO,UACT,MAAM,QACR,MAAM,KACX,IAAI;sBAMkB,MAAM,iBAAiB,MAAM,YAAY,OAAO,KAAG,IAAI;uBAOvE,MAAM,UACL,OAAO,EAAE,YACP,MAAM,eACH,MAAM,KAClB,IAAI;EAUL,CAAC;AAEH,eAAe,uBAAuB,CAAC"}

package/src/trace/SystemTraceWorkerBridge.js

@@ -0,0 +1,35 @@
+const getWorkerTraceModule = () => {
+    return globalThis.__zintrust_worker_trace_bridge__;
+};
+const withWorkerTraceModule = (run) => {
+    const module = getWorkerTraceModule();
+    if (module === undefined)
+        return;
+    try {
+        run(module);
+    }
+    catch {
+        // Ignore optional trace failures so Worker proxy behavior is unaffected.
+    }
+};
+const emitCache = (operation, key, duration, hit, payload, store, ttl) => {
+    withWorkerTraceModule((module) => {
+        module.emitCache?.(operation, key, duration, hit, payload, store, ttl);
+    });
+};
+const emitEvent = (name, listenerCount, payload) => {
+    withWorkerTraceModule((module) => {
+        module.emitEvent?.(name, listenerCount, payload);
+    });
+};
+const emitQuery = (query, params, duration, connection) => {
+    withWorkerTraceModule((module) => {
+        module.emitQuery?.(query, params, duration, connection);
+    });
+};
+export const SystemTraceWorkerBridge = Object.freeze({
+    emitCache,
+    emitEvent,
+    emitQuery,
+});
+export default SystemTraceWorkerBridge;