@zintrust/core 0.5.5 → 0.5.8

package/package.json

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

package/src/index.js

@@ -1,11 +1,11 @@
 /**
- * @zintrust/core v0.5.5
+ * @zintrust/core v0.5.8
  *
  * ZinTrust Framework - Production-Grade TypeScript Backend
  * Built for performance, type safety, and exceptional developer experience
  *
  * Build Information:
- *   Built: 2026-04-13T11:57:18.278Z
+ *   Built: 2026-04-14T16:54:24.540Z
  *   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-13T11:57:18.245Z'; // Replaced during build
+export const ZINTRUST_BUILD_DATE = '2026-04-14T16:54:24.508Z'; // Replaced during build
 export { Application } from './boot/Application.js';
 export { AwsSigV4 } from './common/index.js';
 export { SignedRequest } from './security/SignedRequest.js';

package/src/tools/http/Http.d.ts

@@ -7,6 +7,11 @@
  */
 import { type IHttpResponse } from './HttpResponse';
 export type { IHttpResponse } from './HttpResponse';
+export type HttpRequestBody = Record<string, unknown> | string | ArrayBuffer | ArrayBufferView | Blob | FormData | URLSearchParams;
+export type HttpRequestCustomMode = Readonly<{
+    contentType?: string;
+    serializeBody?: (body: HttpRequestBody | null | undefined) => BodyInitLocal | null | undefined;
+}>;
 /**
  * HTTP Request builder interface
  */
@@ -18,6 +23,7 @@ export interface IHttpRequest {
     withTimeout(ms: number): IHttpRequest;
     asJson(): IHttpRequest;
     asForm(): IHttpRequest;
+    asCustom(mode: HttpRequestCustomMode): IHttpRequest;
     send(): Promise<IHttpResponse>;
     sendRaw(): Promise<Response>;
     sendStream(): Promise<{
@@ -25,6 +31,10 @@ export interface IHttpRequest {
         stream: ReadableStream<Uint8Array> | null;
     }>;
 }
+/**
+ * Internal request state
+ */
+type BodyInitLocal = NonNullable<RequestInit['body']>;
 /**
  * HTTP Client - Sealed namespace for making HTTP requests
  */
@@ -36,19 +46,19 @@ export declare const HttpClient: Readonly<{
     /**
      * Make POST request
      */
-    post(url: string, data?: Record<string, unknown>): IHttpRequest;
+    post(url: string, data?: HttpRequestBody | null): IHttpRequest;
     /**
      * Make PUT request
      */
-    put(url: string, data?: Record<string, unknown>): IHttpRequest;
+    put(url: string, data?: HttpRequestBody | null): IHttpRequest;
     /**
      * Make PATCH request
      */
-    patch(url: string, data?: Record<string, unknown>): IHttpRequest;
+    patch(url: string, data?: HttpRequestBody | null): IHttpRequest;
     /**
      * Make DELETE request
      */
-    delete(url: string, data?: Record<string, unknown>): IHttpRequest;
+    delete(url: string, data?: HttpRequestBody | null): IHttpRequest;
 }>;
 export default HttpClient;
 //# sourceMappingURL=Http.d.ts.map

package/src/tools/http/Http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Http.d.ts","sourceRoot":"","sources":["../../../../src/tools/http/Http.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,EAAsB,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAElF,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,CAAC;IACtD,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,YAAY,CAAC;IAC3D,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,YAAY,CAAC;IACnE,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,CAAC;IAChE,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,CAAC;IACtC,MAAM,IAAI,YAAY,CAAC;IACvB,MAAM,IAAI,YAAY,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;IAC/B,OAAO,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC7B,UAAU,IAAI,OAAO,CAAC;QAAE,QAAQ,EAAE,QAAQ,CAAC;QAAC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;CAC1F;AA6QD;;GAEG;AACH,eAAO,MAAM,UAAU;IACrB;;OAEG;aACM,MAAM,GAAG,YAAY;IAI9B;;OAEG;cACO,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY;IAQ/D;;OAEG;aACM,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY;IAQ9D;;OAEG;eACQ,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY;IAQhE;;OAEG;gBACS,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY;EAOjE,CAAC;AAEH,eAAe,UAAU,CAAC"}
+{"version":3,"file":"Http.d.ts","sourceRoot":"","sources":["../../../../src/tools/http/Http.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,EAAsB,KAAK,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAElF,YAAY,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,MAAM,MAAM,eAAe,GACvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACvB,MAAM,GACN,WAAW,GACX,eAAe,GACf,IAAI,GACJ,QAAQ,GACR,eAAe,CAAC;AAEpB,MAAM,MAAM,qBAAqB,GAAG,QAAQ,CAAC;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,GAAG,SAAS,KAAK,aAAa,GAAG,IAAI,GAAG,SAAS,CAAC;CAChG,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,YAAY,CAAC;IACtD,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,YAAY,CAAC;IAC3D,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,YAAY,CAAC;IACnE,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,CAAC;IAChE,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,CAAC;IACtC,MAAM,IAAI,YAAY,CAAC;IACvB,MAAM,IAAI,YAAY,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,qBAAqB,GAAG,YAAY,CAAC;IACpD,IAAI,IAAI,OAAO,CAAC,aAAa,CAAC,CAAC;IAC/B,OAAO,IAAI,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC7B,UAAU,IAAI,OAAO,CAAC;QAAE,QAAQ,EAAE,QAAQ,CAAC;QAAC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;CAC1F;AAED;;GAEG;AACH,KAAK,aAAa,GAAG,WAAW,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;AAuXtD;;GAEG;AACH,eAAO,MAAM,UAAU;IACrB;;OAEG;aACM,MAAM,GAAG,YAAY;IAI9B;;OAEG;cACO,MAAM,SAAS,eAAe,GAAG,IAAI,GAAG,YAAY;IAQ9D;;OAEG;aACM,MAAM,SAAS,eAAe,GAAG,IAAI,GAAG,YAAY;IAQ7D;;OAEG;eACQ,MAAM,SAAS,eAAe,GAAG,IAAI,GAAG,YAAY;IAQ/D;;OAEG;gBACS,MAAM,SAAS,eAAe,GAAG,IAAI,GAAG,YAAY;EAOhE,CAAC;AAEH,eAAe,UAAU,CAAC"}

package/src/tools/http/Http.js

@@ -10,6 +10,7 @@ import { SystemTraceBridge } from '../../trace/SystemTraceBridge.js';
 import { Env } from '../../config/env.js';
 import { Logger } from '../../config/logger.js';
 import { ErrorFactory } from '../../exceptions/ZintrustError.js';
+import { isArray, isDate, isObject } from '../../helper/index.js';
 import { createHttpResponse } from './HttpResponse.js';
 const headersToRecord = (headers) => {
     if (!headers)
@@ -45,10 +46,88 @@ const bodyToTracePayload = (body) => {
     if (typeof FormData !== 'undefined' && body instanceof FormData) {
         return Array.from(body.entries()).map(([key, value]) => [key, String(value)]);
     }
+    if (ArrayBuffer.isView(body) || body instanceof ArrayBuffer) {
+        return '[binary]';
+    }
+    if (isObject(body)) {
+        return body;
+    }
     return '[stream]';
 };
+const appendFormValue = (params, key, value) => {
+    if (value === undefined || value === null) {
+        return;
+    }
+    if (isArray(value)) {
+        for (const item of value) {
+            appendFormValue(params, key, item);
+        }
+        return;
+    }
+    if (isDate(value)) {
+        params.append(key, value.toISOString());
+        return;
+    }
+    if (isObject(value)) {
+        params.append(key, JSON.stringify(value));
+        return;
+    }
+    params.append(key, String(value));
+};
+const normalizeBodyInit = (body) => {
+    if (ArrayBuffer.isView(body) && !(body instanceof DataView)) {
+        return new Uint8Array(body.buffer, body.byteOffset, body.byteLength);
+    }
+    return body;
+};
+const serializeFormBody = (body) => {
+    if (body === null || body === undefined)
+        return body;
+    if (typeof body === 'string' || body instanceof URLSearchParams)
+        return body;
+    if (body instanceof ArrayBuffer ||
+        ArrayBuffer.isView(body) ||
+        body instanceof Blob ||
+        (typeof FormData !== 'undefined' && body instanceof FormData)) {
+        return normalizeBodyInit(body);
+    }
+    if (isObject(body)) {
+        const params = new URLSearchParams();
+        for (const [key, value] of Object.entries(body)) {
+            appendFormValue(params, key, value);
+        }
+        return params;
+    }
+    return body;
+};
+const serializeJsonBody = (body) => {
+    if (body === null || body === undefined)
+        return body;
+    if (typeof body === 'string' || body instanceof URLSearchParams)
+        return body;
+    if (body instanceof ArrayBuffer ||
+        ArrayBuffer.isView(body) ||
+        body instanceof Blob ||
+        (typeof FormData !== 'undefined' && body instanceof FormData)) {
+        return normalizeBodyInit(body);
+    }
+    return JSON.stringify(body);
+};
+const serializeRequestBody = (state) => {
+    if (state.contentType === 'custom') {
+        const customBody = state.customMode?.serializeBody?.(state.body);
+        return customBody ?? serializeJsonBody(state.body);
+    }
+    if (state.contentType === 'form') {
+        return serializeFormBody(state.body);
+    }
+    if (state.contentType === 'json') {
+        return serializeJsonBody(state.body);
+    }
+    return serializeJsonBody(state.body);
+};
 const emitHttpClientTrace = (input) => {
-    const { state, durationMs, response, responseBody, error } = input;
+    const { state, requestBody, durationMs, response, responseBody, error } = input;
     SystemTraceBridge.emitHttpClient({
         source: 'http-client',
         method: state.method,
@@ -56,7 +135,7 @@ const emitHttpClientTrace = (input) => {
         requestHeaders: { ...state.headers },
         responseStatus: response?.status,
         duration: durationMs,
-        requestBody: bodyToTracePayload(state.body),
+        requestBody: bodyToTracePayload(requestBody ?? state.body),
         responseHeaders: headersToRecord(response?.headers),
         responseBody,
         error,
@@ -83,10 +162,10 @@ async function performRequest(state) {
     return createHttpResponse(response, bodyText);
 }
 async function performRequestRaw(state) {
-    const { response, durationMs } = await performFetch(state);
+    const { response, durationMs, requestBody } = await performFetch(state);
     const bodyText = await response.text();
-    emitHttpClientTrace({ state, response, responseBody: bodyText, durationMs });
-    return { response, bodyText, durationMs };
+    emitHttpClientTrace({ state, requestBody, response, responseBody: bodyText, durationMs });
+    return { response, bodyText, durationMs, requestBody };
 }
 async function performFetch(state) {
     const timeout = state.timeout ?? Env.getInt('HTTP_TIMEOUT', 30000);
@@ -99,29 +178,31 @@ async function performFetch(state) {
         if (OpenTelemetry.isEnabled()) {
             OpenTelemetry.injectTraceHeaders(state.headers);
         }
+        const requestBody = serializeRequestBody(state);
         const init = {
             method: state.method,
             headers: state.headers,
             signal: controller.signal,
         };
-        if (state.body !== undefined &&
-            state.body !== null &&
-            ['POST', 'PUT', 'PATCH'].includes(state.method)) {
-            init.body = state.body;
+        if (requestBody !== undefined &&
+            requestBody !== null &&
+            ['POST', 'PUT', 'PATCH', 'DELETE'].includes(state.method)) {
+            init.body = requestBody;
         }
-        return init;
+        return { init, requestBody };
     };
     const startTime = Date.now();
     try {
-        const init = buildInit();
+        const { init, requestBody } = buildInit();
         const response = await globalThis.fetch(state.url, init);
         const duration = Date.now() - startTime;
-        return { response, durationMs: duration };
+        return { response, durationMs: duration, requestBody };
     }
     catch (error) {
         const duration = Date.now() - startTime;
         emitHttpClientTrace({
             state,
+            requestBody: serializeRequestBody(state),
             durationMs: duration,
             error: error instanceof Error ? error.message : String(error),
         });
@@ -154,7 +235,7 @@ function createRequestBuilder(method, url, initialBody) {
         headers: {
             'User-Agent': 'ZinTrust/1.0',
         },
-        body: initialBody ? JSON.stringify(initialBody) : undefined,
+        body: initialBody ?? undefined,
     };
     const self = {
         withHeader(name, value) {
@@ -188,19 +269,27 @@ function createRequestBuilder(method, url, initialBody) {
             state.headers['Content-Type'] = 'application/x-www-form-urlencoded';
             return self;
         },
+        asCustom(mode) {
+            state.contentType = 'custom';
+            state.customMode = mode;
+            if (typeof mode.contentType === 'string' && mode.contentType.trim() !== '') {
+                state.headers['Content-Type'] = mode.contentType;
+            }
+            return self;
+        },
         async send() {
             return performRequest(state);
         },
         async sendRaw() {
-            const { response, durationMs } = await performFetch(state);
+            const { response, durationMs, requestBody } = await performFetch(state);
             const responseBody = await captureTraceResponseBody(response);
-            emitHttpClientTrace({ state, response, responseBody, durationMs });
+            emitHttpClientTrace({ state, requestBody, response, responseBody, durationMs });
             return response;
         },
         async sendStream() {
-            const { response, durationMs } = await performFetch(state);
+            const { response, durationMs, requestBody } = await performFetch(state);
             const responseBody = await captureTraceResponseBody(response);
-            emitHttpClientTrace({ state, response, responseBody, durationMs });
+            emitHttpClientTrace({ state, requestBody, response, responseBody, durationMs });
             return { response, stream: response.body };
         },
     };
@@ -221,7 +310,7 @@ export const HttpClient = Object.freeze({
      */
     post(url, data) {
         const builder = createRequestBuilder('POST', url, data);
-        if (data) {
+        if (isObject(data)) {
             builder.asJson();
         }
         return builder;
@@ -231,7 +320,7 @@ export const HttpClient = Object.freeze({
      */
     put(url, data) {
         const builder = createRequestBuilder('PUT', url, data);
-        if (data) {
+        if (isObject(data)) {
             builder.asJson();
         }
         return builder;
@@ -241,7 +330,7 @@ export const HttpClient = Object.freeze({
      */
     patch(url, data) {
         const builder = createRequestBuilder('PATCH', url, data);
-        if (data) {
+        if (isObject(data)) {
             builder.asJson();
         }
         return builder;
@@ -251,7 +340,7 @@ export const HttpClient = Object.freeze({
      */
     delete(url, data) {
         const builder = createRequestBuilder('DELETE', url, data);
-        if (data) {
+        if (isObject(data)) {
             builder.asJson();
         }
         return builder;

package/src/tools/http/index.d.ts

@@ -4,10 +4,10 @@
 declare const _default: Readonly<{
     HttpClient: Readonly<{
         get(url: string): import("./Http").IHttpRequest;
-        post(url: string, data?: Record<string, unknown>): import("./Http").IHttpRequest;
-        put(url: string, data?: Record<string, unknown>): import("./Http").IHttpRequest;
-        patch(url: string, data?: Record<string, unknown>): import("./Http").IHttpRequest;
-        delete(url: string, data?: Record<string, unknown>): import("./Http").IHttpRequest;
+        post(url: string, data?: import("./Http").HttpRequestBody | null): import("./Http").IHttpRequest;
+        put(url: string, data?: import("./Http").HttpRequestBody | null): import("./Http").IHttpRequest;
+        patch(url: string, data?: import("./Http").HttpRequestBody | null): import("./Http").IHttpRequest;
+        delete(url: string, data?: import("./Http").HttpRequestBody | null): import("./Http").IHttpRequest;
     }>;
     createHttpResponse: (response: Response, body: string) => import("./HttpResponse").IHttpResponse;
 }>;