unnbound-events 2.0.19 → 2.0.21-beta.0

package/README.md

@@ -30,7 +30,7 @@ server.start();
 The server automatically:
 
 - Starts HTTP server on `PORT` (default: `3000`)
-- Starts SQS long-polling if `UNNBOUND_SQS_URL` is set
+- Starts SQS long-polling if `UNNBOUND_SQS_URL` is set. Set `queue.enabled: true` to require queue polling and fail fast when the queue URL is missing.
 - Provides `/healthcheck` endpoint (returns `200 { status: 'ok' }`)
 - Handles graceful shutdown on `SIGINT`/`SIGTERM`
 

package/dist/index.d.ts

@@ -1,9 +1,9 @@
-export type { IncomingEvent, IncomingRequest, EventMetadata, EventSource } from './lib/event';
+export { createEnqueuer } from './lib/enqueue';
 export type { ServerErrorOptions } from './lib/error';
-export type { EventServerOptions, EventServer } from './lib/server';
+export { ServerError } from './lib/error';
+export type { EventMetadata, EventSource, IncomingEvent, IncomingRequest } from './lib/event';
 export type { Handler } from './lib/routing/endpoint';
 export type { MiddlewareHandler } from './lib/routing/middleware';
 export type { EventVariables, MaybePromise } from './lib/routing/types';
+export type { EventServer, EventServerOptions } from './lib/server';
 export { createServer } from './lib/server';
-export { ServerError } from './lib/error';
-export { createEnqueuer } from './lib/enqueue';

package/dist/index.js

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createEnqueuer = exports.ServerError = exports.createServer = void 0;
-var server_1 = require("./lib/server");
-Object.defineProperty(exports, "createServer", { enumerable: true, get: function () { return server_1.createServer; } });
-var error_1 = require("./lib/error");
-Object.defineProperty(exports, "ServerError", { enumerable: true, get: function () { return error_1.ServerError; } });
+exports.createServer = exports.ServerError = exports.createEnqueuer = void 0;
 var enqueue_1 = require("./lib/enqueue");
 Object.defineProperty(exports, "createEnqueuer", { enumerable: true, get: function () { return enqueue_1.createEnqueuer; } });
+var error_1 = require("./lib/error");
+Object.defineProperty(exports, "ServerError", { enumerable: true, get: function () { return error_1.ServerError; } });
+var server_1 = require("./lib/server");
+Object.defineProperty(exports, "createServer", { enumerable: true, get: function () { return server_1.createServer; } });

package/dist/lib/enqueue.js

@@ -19,26 +19,26 @@ const types_1 = require("unnbound-logger-sdk/dist/types");
  * - Custom domain: proxy.domain.com/{shortId} → {shortId}
  */
 const getWorkspaceId = (url) => {
-    url = url.replace(/^https?:\/\//, '');
+    const urlWithoutProtocol = url.replace(/^https?:\/\//, '');
     // Custom domain: extract path after domain (not gotemper.com or legacy unnbound.ai)
-    if (!url.includes('gotemper.com') && !url.includes('unnbound.ai')) {
-        return url
+    if (!urlWithoutProtocol.includes('gotemper.com') && !urlWithoutProtocol.includes('unnbound.ai')) {
+        return urlWithoutProtocol
             .replace(/^.+?\/(.+)$/, '$1')
             .replace(/^(sandbox|staging)\//, '')
             .replace(/^a?sync\//, '')
             .split('/')[0];
     }
     // New path-based format: {env}.workflow.gotemper.com/{sandbox/}{shortId} or workflow.gotemper.com/{sandbox/}{shortId}
-    if (url.includes('.workflow.') || url.startsWith('workflow.')) {
+    if (urlWithoutProtocol.includes('.workflow.') || urlWithoutProtocol.startsWith('workflow.')) {
         // Extract everything after the domain, then remove sandbox/ and async/ prefixes
-        const path = url.replace(/^.+?\/(.+)$/, '$1');
+        const path = urlWithoutProtocol.replace(/^.+?\/(.+)$/, '$1');
         return path
             .replace(/^(sandbox|staging)\//, '')
             .replace(/^a?sync\//, '')
             .split('/')[0];
     }
     // Legacy hostname format: {shortId}.workspaces.{env}.unnbound.ai
-    return url.split('.')[0];
+    return urlWithoutProtocol.split('.')[0];
 };
 const TYPE_PATH_PREFIXES = {
     sandbox: '/sandbox',
@@ -101,6 +101,7 @@ const getWorkflowDomain = (url) => {
     // Custom domain - return hostname as-is
     return hostname;
 };
+const getWorkflowProtocol = (url) => (url.startsWith('http://') ? 'http' : 'https');
 /**
  * Create an HTTP-based enqueuer that posts to the ingress service.
  * Used for legacy SQS mode or cross-workflow communication.
@@ -117,7 +118,7 @@ const createHttpEnqueuer = () => {
     const workspaceId = getWorkspaceId(url);
     const domain = getWorkflowDomain(url);
     const workflowType = getWorkflowType(url);
-    const baseURL = `https://${domain}${TYPE_PATH_PREFIXES[workflowType]}/async/${workspaceId}`;
+    const baseURL = `${getWorkflowProtocol(url)}://${domain}${TYPE_PATH_PREFIXES[workflowType]}/async/${workspaceId}`;
     const client = (0, unnbound_logger_sdk_1.traceAxios)(axios_1.default.create({ baseURL }), { getPayload: internal_1.internal });
     return async (event, metadata) => {
         unnbound_logger_sdk_1.logger.info({ event, metadata }, 'Enqueuing event via HTTP...');

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/server.d.ts

@@ -4,6 +4,7 @@ import { type Middleware } from './routing/middleware';
 import type { EventVariables } from './routing/types';
 type HttpOptions = {};
 interface QueueOptions {
+    enabled?: boolean;
     maxMessages?: number;
     visibilityTimeout?: number;
 }

package/dist/lib/server.js

@@ -14,6 +14,7 @@ class HttpQueueServer {
     app = new hono_1.Hono();
     http;
     queue;
+    queueEnabled;
     dispose;
     constructor(options = {}) {
         this.logger = options.logger ?? unnbound_logger_sdk_1.logger;
@@ -33,12 +34,14 @@ class HttpQueueServer {
             return (0, endpoint_1.respondWith)(c, error.toJson());
         });
         this.http = new http_adapter_1.HttpAdapter({ app: this.app, logger: this.logger, ...options.http });
-        // SQS adapter for async message processing
-        this.queue = new queue_adapter_1.QueueAdapter({
-            app: this.app,
-            logger: this.logger,
-            options: options.queue,
-        });
+        this.queueEnabled = shouldEnableQueue(options.queue);
+        this.queue = this.queueEnabled
+            ? new queue_adapter_1.QueueAdapter({
+                app: this.app,
+                logger: this.logger,
+                options: options.queue,
+            })
+            : null;
     }
     get = (...args) => {
         // @ts-expect-error
@@ -73,17 +76,24 @@ class HttpQueueServer {
         process.on('SIGINT', createOnSignal('SIGINT'));
         process.on('SIGTERM', createOnSignal('SIGTERM'));
         this.logger.debug({}, 'Starting server...');
+        const disposables = [];
         try {
-            const disposables = await Promise.all([this.http.listen(), this.queue.listen()]);
-            this.dispose = async () => {
-                await Promise.all(disposables.map((dispose) => dispose()))
-                    .then(() => void 0)
-                    .catch(console.error);
-            };
+            disposables.push(await this.http.listen());
+            if (this.queue && this.queueEnabled) {
+                disposables.push(await this.queue.listen());
+            }
+            else {
+                this.logger.info({
+                    runtimeTarget: process.env.UNNBOUND_RUNTIME_TARGET ?? 'default',
+                    queueConfigured: Boolean(process.env.UNNBOUND_SQS_URL),
+                }, 'Queue listener disabled for this runtime.');
+            }
+            this.dispose = () => this.stopDisposables(disposables);
             this.logger.info('Server started.');
             return this.dispose;
         }
         catch (error) {
+            await this.stopDisposables(disposables);
             this.logger.error({ err: error }, 'Server failed to start.');
             throw error;
         }
@@ -95,6 +105,20 @@ class HttpQueueServer {
         await this.dispose();
         this.logger.debug({}, 'Server stopped.');
     }
+    async stopDisposables(disposables) {
+        const results = await Promise.allSettled(disposables.map((dispose) => dispose()));
+        for (const result of results) {
+            if (result.status === 'rejected') {
+                this.logger.error({ err: result.reason }, 'Server disposable failed to stop.');
+            }
+        }
+    }
 }
 const createServer = (options = {}) => new HttpQueueServer(options);
 exports.createServer = createServer;
+function shouldEnableQueue(options) {
+    if (options?.enabled !== undefined) {
+        return options.enabled;
+    }
+    return Boolean(process.env.UNNBOUND_SQS_URL);
+}

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,19 +1,17 @@
 {
   "name": "unnbound-events",
   "description": "Unified events SDK to handle HTTP routes and queued messages with a single routing API.",
-  "version": "2.0.19",
+  "version": "2.0.21-beta.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {
-    "build": "bun x tsc",
-    "test": "echo 'No tests'",
-    "typecheck": "tsc -noEmit",
-    "lint": "eslint --cache --cache-location ./node_modules/.cache/eslint .",
-    "lint:fix": "bun run lint --fix",
+    "build": "tsc",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
     "format": "biome format --write .",
     "format:check": "biome format .",
-    "prepublishOnly": "bun run build",
-    "start:example": "bun --watch examples/node-server.ts",
+    "prepublishOnly": "pnpm run build",
+    "start:example": "tsx watch examples/node-server.ts",
     "version:bump": "npm version patch"
   },
   "author": "Unnbound Team",
@@ -30,15 +28,14 @@
     "@aws-sdk/client-s3": "^3.0.0",
     "@aws-sdk/client-sqs": "^3.0.0",
     "@hono/node-server": "^1.19.11",
-    "axios": "^1.12.2",
-    "hono": "^4.12.7",
-    "ioredis": "^5.4.1",
+    "axios": "1.16.0",
+    "hono": "^4.12.21",
     "unnbound-logger-sdk": "^3.0.34"
   },
   "devDependencies": {
     "@types/jest": "^29.5.12",
-    "@types/node": "^22",
-    "typescript": "^5.8.3"
+    "@types/node": "^24.12.2",
+    "vitest": "^4.0.15"
   },
   "files": [
     "dist/**/*",