@zintrust/core 0.4.98 → 0.4.99

package/package.json

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

package/src/common/ExternalServiceUtils.d.ts

@@ -18,7 +18,7 @@ export declare const validateRequiredParams: (params: Record<string, unknown>, r
  * Create standardized API error response
  */
 export declare const createApiError: (message: string, service: string) => Error;
-export declare const tracedFetch: (url: string, options: RequestInit, _trace?: TracedFetchTraceOptions) => Promise<Response>;
+export declare const tracedFetch: (url: string, options: RequestInit, trace?: TracedFetchTraceOptions) => Promise<Response>;
 /**
  * Common fetch wrapper with error handling
  */

package/src/common/ExternalServiceUtils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExternalServiceUtils.d.ts","sourceRoot":"","sources":["../../../src/common/ExternalServiceUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,MAAM,EAAE,iBAAa,KAAG,MAe1D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,GACjC,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,UAAU,MAAM,EAAE,KACjB,IAWF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,SAAS,MAAM,EAAE,SAAS,MAAM,KAAG,KAEjE,CAAC;AAEF,eAAO,MAAM,WAAW,GACtB,KAAK,MAAM,EACX,SAAS,WAAW,EACpB,SAAS,uBAAuB,KAC/B,OAAO,CAAC,QAAQ,CAElB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,GACpB,KAAK,MAAM,EACX,SAAS,WAAW,EACpB,QAAQ,uBAAuB,KAC9B,OAAO,CAAC,QAAQ,CAclB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,EAChC,SAAS,OAAO,EAChB,OAAO,CAAC,EACR,QAAQ,MAAM,KACb;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAY9C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW;IACtB;;OAEG;iBACU,MAAM;IAMnB;;OAEG;oBACa,MAAM;IAItB;;OAEG;8BACuB,MAAM,GAAG,OAAO;IAI1C;;OAEG;gCAEO,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,OAAO,GAAG,WAAW,eACpD,MAAM,UACX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;IAYjC;;OAEG;+BAEO,WAAW,GAAG,WAAW,eACpB,MAAM,SACZ,KAAK,UACJ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;CASlC,CAAC"}
+{"version":3,"file":"ExternalServiceUtils.d.ts","sourceRoot":"","sources":["../../../src/common/ExternalServiceUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAkHF;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,KAAK,MAAM,EAAE,iBAAa,KAAG,MAe1D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,GACjC,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,UAAU,MAAM,EAAE,KACjB,IAWF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,SAAS,MAAM,EAAE,SAAS,MAAM,KAAG,KAEjE,CAAC;AAEF,eAAO,MAAM,WAAW,GACtB,KAAK,MAAM,EACX,SAAS,WAAW,EACpB,QAAQ,uBAAuB,KAC9B,OAAO,CAAC,QAAQ,CAWlB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,GACpB,KAAK,MAAM,EACX,SAAS,WAAW,EACpB,QAAQ,uBAAuB,KAC9B,OAAO,CAAC,QAAQ,CAclB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,GAAI,CAAC,EAChC,SAAS,OAAO,EAChB,OAAO,CAAC,EACR,QAAQ,MAAM,KACb;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAY9C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW;IACtB;;OAEG;iBACU,MAAM;IAMnB;;OAEG;oBACa,MAAM;IAItB;;OAEG;8BACuB,MAAM,GAAG,OAAO;IAI1C;;OAEG;gCAEO,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,OAAO,GAAG,WAAW,eACpD,MAAM,UACX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;IAYjC;;OAEG;+BAEO,WAAW,GAAG,WAAW,eACpB,MAAM,SACZ,KAAK,UACJ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;CASlC,CAAC"}

package/src/common/ExternalServiceUtils.js

@@ -2,8 +2,92 @@
  * Shared Utilities for External Service Drivers
  * Common patterns for API calls, environment variable reading, and error handling
  */
+import { SystemTraceBridge } from '../trace/SystemTraceBridge.js';
 import { Env } from '../config/env.js';
 import { ErrorFactory } from '../exceptions/ZintrustError.js';
+const isHeaderEntriesLike = (value) => {
+    return typeof value === 'object' && value !== null && 'entries' in value;
+};
+const isHeaderTuple = (value) => {
+    return (Array.isArray(value) &&
+        value.length === 2 &&
+        typeof value[0] === 'string' &&
+        typeof value[1] === 'string');
+};
+const isHeaderTupleArray = (value) => {
+    return Array.isArray(value) && value.every(isHeaderTuple);
+};
+const asHeadersInitLocal = (headers) => {
+    return headers;
+};
+const asBodyInitLocal = (body) => {
+    return body;
+};
+const headersToRecord = (headers) => {
+    if (headers === undefined)
+        return {};
+    if (headers instanceof Headers) {
+        return Object.fromEntries(headers.entries());
+    }
+    if (isHeaderEntriesLike(headers)) {
+        return Object.fromEntries(headers.entries());
+    }
+    if (isHeaderTupleArray(headers)) {
+        return Object.fromEntries(headers);
+    }
+    return Object.fromEntries(Object.entries(headers).filter((entry) => typeof entry[1] === 'string'));
+};
+const bodyToTracePayload = (body) => {
+    if (body === null || body === undefined)
+        return undefined;
+    if (typeof body === 'string') {
+        try {
+            return JSON.parse(body);
+        }
+        catch {
+            return body;
+        }
+    }
+    if (body instanceof URLSearchParams) {
+        return body.toString();
+    }
+    if (typeof FormData !== 'undefined' &&
+        body instanceof FormData &&
+        typeof body.entries === 'function') {
+        return Array.from(body.entries()).map(([key, value]) => [key, String(value)]);
+    }
+    return '[stream]';
+};
+const captureResponseBody = async (response) => {
+    try {
+        return await response.clone().text();
+    }
+    catch {
+        return undefined;
+    }
+};
+const emitTrace = async (url, options, trace, duration, response, error) => {
+    const responseBody = response ? await captureResponseBody(response) : undefined;
+    let traceError;
+    if (error instanceof Error) {
+        traceError = error.message;
+    }
+    else if (error !== undefined) {
+        traceError = String(error);
+    }
+    SystemTraceBridge.emitHttpClient({
+        source: trace?.source,
+        method: String(options.method ?? 'GET').toUpperCase(),
+        url,
+        requestHeaders: headersToRecord(asHeadersInitLocal(options.headers)),
+        responseStatus: response?.status,
+        duration,
+        requestBody: bodyToTracePayload(asBodyInitLocal(options.body)),
+        responseHeaders: headersToRecord(response?.headers),
+        responseBody,
+        error: traceError,
+    });
+};
 /**
  * Environment variable reader with fallback support
  * Handles both Env.get() and process.env for maximum compatibility
@@ -44,8 +128,17 @@ export const validateRequiredParams = (params, required) => {
 export const createApiError = (message, service) => {
     return ErrorFactory.createValidationError(`${service} API error: ${message}`);
 };
-export const tracedFetch = async (url, options, _trace) => {
-    return globalThis.fetch(url, options);
+export const tracedFetch = async (url, options, trace) => {
+    const startTime = Date.now();
+    try {
+        const response = await globalThis.fetch(url, options);
+        await emitTrace(url, options, trace, Date.now() - startTime, response);
+        return response;
+    }
+    catch (error) {
+        await emitTrace(url, options, trace, Date.now() - startTime, undefined, error);
+        throw error;
+    }
 };
 /**
  * Common fetch wrapper with error handling

package/src/index.js

@@ -1,11 +1,11 @@
 /**
- * @zintrust/core v0.4.98
+ * @zintrust/core v0.4.99
  *
  * ZinTrust Framework - Production-Grade TypeScript Backend
  * Built for performance, type safety, and exceptional developer experience
  *
  * Build Information:
- *   Built: 2026-04-12T07:36:38.129Z
+ *   Built: 2026-04-12T10:03:16.711Z
  *   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-12T07:36:38.086Z'; // Replaced during build
+export const ZINTRUST_BUILD_DATE = '2026-04-12T10:03:16.675Z'; // Replaced during build
 export { Application } from './boot/Application.js';
 export { AwsSigV4 } from './common/index.js';
 export { SignedRequest } from './security/SignedRequest.js';