unnbound-events 2.0.20 → 2.0.21-beta.0

package/dist/lib/event.d.ts

@@ -25,6 +25,12 @@ export interface IncomingEvent<R extends IncomingRequest = IncomingRequest> {
 export interface StrictEventHandlerResult {
     status: StatusCode;
     headers?: Record<string, string>;
-    body?: object | undefined | null;
+    /**
+     * Response body. Objects are JSON-serialized; `Uint8Array` (including Buffer)
+     * and `ArrayBuffer` are sent verbatim as binary — required for protocols like
+     * AS2 whose responses (signed S/MIME MDNs) must not be JSON-mangled. Set the
+     * `content-type` header explicitly when returning binary.
+     */
+    body?: object | Uint8Array | ArrayBuffer | undefined | null;
 }
 export type EventHandlerResult = Partial<StrictEventHandlerResult> | undefined | null | undefined;

package/dist/lib/routing/endpoint.d.ts

@@ -8,12 +8,12 @@ export interface Endpoint<I> {
     (path: string, middleware: MiddlewareHandler<I>, handler: Handler<I>): MaybePromise<void>;
 }
 export type EndpointArgs<I> = [path: string, handler: Handler<I>] | [path: string, middleware: MiddlewareHandler<I>, handler: Handler<I>];
-export declare const buildEndpointArguments: (...args: EndpointArgs<EventVariables<{}>>) => (string | MiddlewareHandler<Context<EventEnvironment<{}>, any, {}>> | Handler<Context<EventEnvironment<{}>, any, {}>, Response>)[];
+export declare const buildEndpointArguments: (...args: EndpointArgs<EventVariables<{}>>) => (string | Handler<Context<EventEnvironment<{}>, any, {}>, Response> | MiddlewareHandler<Context<EventEnvironment<{}>, any, {}>>)[];
 export declare const parseEndpointArguments: (...args: EndpointArgs<EventVariables<{}>>) => {
     path: string;
     middlewares: MiddlewareHandler<EventVariables<{}>>[];
     handler: Handler<EventVariables<{}>, EventHandlerResult>;
 };
 export declare const patchEndpoint: <V extends object>(handler: Handler<EventVariables<V>>) => Handler<Context<EventEnvironment<V>>, Response>;
-export declare const respondWith: (context: Context, result: StrictEventHandlerResult) => (Response & import("hono").TypedResponse<null, 100 | 101 | 102 | 103 | 200 | 201 | 202 | 203 | 204 | 205 | 206 | 207 | 208 | 226 | 300 | 301 | 302 | 303 | 304 | 305 | 306 | 307 | 308 | 400 | 401 | 402 | 403 | 404 | 405 | 406 | 407 | 408 | 409 | 410 | 411 | 412 | 413 | 414 | 415 | 416 | 417 | 418 | 421 | 422 | 423 | 424 | 425 | 426 | 428 | 429 | 431 | 451 | 500 | 501 | 502 | 503 | 504 | 505 | 506 | 507 | 508 | 510 | 511 | -1, "body">) | (Response & import("hono").TypedResponse<never, 100 | 102 | 103 | 200 | 201 | 202 | 203 | 206 | 207 | 208 | 226 | 300 | 301 | 302 | 303 | 305 | 306 | 307 | 308 | 400 | 401 | 402 | 403 | 404 | 405 | 406 | 407 | 408 | 409 | 410 | 411 | 412 | 413 | 414 | 415 | 416 | 417 | 418 | 421 | 422 | 423 | 424 | 425 | 426 | 428 | 429 | 431 | 451 | 500 | 501 | 502 | 503 | 504 | 505 | 506 | 507 | 508 | 510 | 511 | -1, "json">);
+export declare const respondWith: (context: Context, result: StrictEventHandlerResult) => (Response & import("hono").TypedResponse<never, -1 | 100 | 102 | 103 | 200 | 201 | 202 | 203 | 206 | 207 | 208 | 226 | 300 | 301 | 302 | 303 | 305 | 306 | 307 | 308 | 400 | 401 | 402 | 403 | 404 | 405 | 406 | 407 | 408 | 409 | 410 | 411 | 412 | 413 | 414 | 415 | 416 | 417 | 418 | 421 | 422 | 423 | 424 | 425 | 426 | 428 | 429 | 431 | 451 | 500 | 501 | 502 | 503 | 504 | 505 | 506 | 507 | 508 | 510 | 511, "json">) | (Response & import("hono").TypedResponse<null, -1 | 100 | 101 | 102 | 103 | 200 | 201 | 202 | 203 | 204 | 205 | 206 | 207 | 208 | 226 | 300 | 301 | 302 | 303 | 304 | 305 | 306 | 307 | 308 | 400 | 401 | 402 | 403 | 404 | 405 | 406 | 407 | 408 | 409 | 410 | 411 | 412 | 413 | 414 | 415 | 416 | 417 | 418 | 421 | 422 | 423 | 424 | 425 | 426 | 428 | 429 | 431 | 451 | 500 | 501 | 502 | 503 | 504 | 505 | 506 | 507 | 508 | 510 | 511, "body">) | (Response & import("hono").TypedResponse<ArrayBuffer, -1 | 100 | 102 | 103 | 200 | 201 | 202 | 203 | 206 | 207 | 208 | 226 | 300 | 301 | 302 | 303 | 305 | 306 | 307 | 308 | 400 | 401 | 402 | 403 | 404 | 405 | 406 | 407 | 408 | 409 | 410 | 411 | 412 | 413 | 414 | 415 | 416 | 417 | 418 | 421 | 422 | 423 | 424 | 425 | 426 | 428 | 429 | 431 | 451 | 500 | 501 | 502 | 503 | 504 | 505 | 506 | 507 | 508 | 510 | 511, "body">);
 export declare const attachTraceHeaders: (headers?: Record<string, string>) => Record<string, string> | undefined;

package/dist/lib/routing/endpoint.js

@@ -33,6 +33,15 @@ const respondWith = (context, result) => {
     const headers = (0, exports.attachTraceHeaders)(result.headers);
     if (!result.body)
         return context.body(null, result.status, headers);
+    // Binary bodies (Buffer/Uint8Array/ArrayBuffer) go out verbatim — JSON-serializing
+    // them corrupts wire protocols like AS2, whose signed S/MIME MDN response must be
+    // byte-exact. Buffers can be views over a pooled ArrayBuffer, so slice to the view.
+    if (result.body instanceof Uint8Array || result.body instanceof ArrayBuffer) {
+        const bytes = result.body instanceof ArrayBuffer
+            ? result.body
+            : result.body.buffer.slice(result.body.byteOffset, result.body.byteOffset + result.body.byteLength);
+        return context.body(bytes, result.status, headers);
+    }
     return context.json(result.body, result.status, headers);
 };
 exports.respondWith = respondWith;

package/dist/lib/utils.d.ts

@@ -17,7 +17,6 @@ export declare const buildIncomingPayload: (event: IncomingEvent<MatchedIncoming
     source: EventSource;
     delay: number | undefined;
     http: {
-        response?: StrictEventHandlerResult | undefined;
         url: string;
         method: string;
         query: Record<string, any>;
@@ -26,8 +25,9 @@ export declare const buildIncomingPayload: (event: IncomingEvent<MatchedIncoming
         incoming: boolean;
         request: {
             headers: Record<string, string>;
-            body: any;
+            body: unknown;
         };
+        response?: StrictEventHandlerResult | undefined;
     };
 };
 export declare const batchArray: <T>(array: T[], size: number) => T[][];

package/dist/lib/utils.js

@@ -78,13 +78,20 @@ const deserializeMetadata = (request) => ({
     source: request.headers[sourceKey],
     timestamp: request.headers[timestampKey] ? Number.parseInt(request.headers[timestampKey]) : undefined,
 });
+/** Trace-safe body representation: binary bodies become a marker, not a byte dump. */
+const describeBody = (body) => {
+    if (body instanceof Uint8Array || body instanceof ArrayBuffer) {
+        return { binary: true, byteLength: body.byteLength };
+    }
+    return (0, utils_1.safeJsonParse)(body);
+};
 const buildResponsePayload = (result) => ({
     status: result?.status ?? 204,
     headers: {
         'content-type': 'application/json; charset=utf-8',
         ...(result?.headers ? (0, exports.normalizeHeaders)(result.headers) : undefined),
     },
-    body: result?.body ? (0, utils_1.safeJsonParse)(result.body) : undefined,
+    body: result?.body ? describeBody(result.body) : undefined,
 });
 const buildIncomingPayload = (event, result) => {
     return {
@@ -102,7 +109,7 @@ const buildIncomingPayload = (event, result) => {
             incoming: true,
             request: {
                 headers: event.request.headers,
-                body: (0, utils_1.safeJsonParse)(event.request.body),
+                body: describeBody(event.request.body),
             },
             ...(result && {
                 response: result.error

package/package.json

@@ -1,9 +1,19 @@
 {
   "name": "unnbound-events",
   "description": "Unified events SDK to handle HTTP routes and queued messages with a single routing API.",
-  "version": "2.0.20",
+  "version": "2.0.21-beta.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "format": "biome format --write .",
+    "format:check": "biome format .",
+    "prepublishOnly": "pnpm run build",
+    "start:example": "tsx watch examples/node-server.ts",
+    "version:bump": "npm version patch"
+  },
   "author": "Unnbound Team",
   "license": "MIT",
   "repository": {
@@ -25,7 +35,6 @@
   "devDependencies": {
     "@types/jest": "^29.5.12",
     "@types/node": "^24.12.2",
-    "typescript": "^5.8.3",
     "vitest": "^4.0.15"
   },
   "files": [
@@ -36,14 +45,5 @@
   "engines": {
     "node": ">=22"
   },
-  "sideEffects": false,
-  "scripts": {
-    "build": "tsc",
-    "test": "vitest run",
-    "typecheck": "tsgo --noEmit",
-    "format": "biome format --write .",
-    "format:check": "biome format .",
-    "start:example": "tsx watch examples/node-server.ts",
-    "version:bump": "npm version patch"
-  }
-}
+  "sideEffects": false
+}