unnbound-events 2.0.16 → 2.0.18

package/README.md

@@ -5,7 +5,7 @@ Unified HTTP and SQS queue routing with a single API. Register handlers once, ha
 ## Install
 
 ```bash
-pnpm add unnbound-events
+bun add unnbound-events
 ```
 
 ## Quick Start
@@ -120,7 +120,7 @@ const server = createServer({
 The queue adapter reads from:
 
 - `UNNBOUND_SQS_URL` - Queue URL (required for queue listener)
-- `UNNBOUND_AWS_REGION` - AWS region (default: `us-west-1`)
+- `UNNBOUND_AWS_REGION` - AWS region (default: `us-east-1`)
 - `UNNBOUND_SQS_ENDPOINT` - Custom endpoint (optional)
 
 ```bash

package/dist/lib/adapters/extended-sqs-client.d.ts

@@ -1,6 +1,6 @@
-import { S3Client } from '@aws-sdk/client-s3';
-import { Message, ReceiveMessageCommand, SQSClient } from '@aws-sdk/client-sqs';
-import { IncomingEvent, IncomingRequest } from '../event';
+import { type S3Client } from '@aws-sdk/client-s3';
+import { type Message, type ReceiveMessageCommand, SQSClient } from '@aws-sdk/client-sqs';
+import type { IncomingEvent, IncomingRequest } from '../event';
 export interface S3Pointer {
     bucket: string;
     key: string;

package/dist/lib/adapters/extended-sqs-client.js

@@ -40,18 +40,14 @@ class ExtendedSQSClient extends client_sqs_1.SQSClient {
         return this.parseEvent({ ...parsed, request: { ...parsed.request, body } });
     }
     isSqsMessage(message) {
-        return (!!message &&
-            typeof message === 'object' &&
-            'id' in message &&
-            'timestamp' in message &&
-            'request' in message);
+        return (!!message && typeof message === 'object' && 'id' in message && 'timestamp' in message && 'request' in message);
     }
     isS3PointerMessage(body) {
         return Array.isArray(body) && body.length === 2 && body[0] === this.S3_POINTER_CLASS;
     }
     parseEvent(message) {
         const method = message.request.method.toLowerCase();
-        const url = new URL(message.request.url, `https://unnbound.ai`);
+        const url = new URL(message.request.url, 'https://unnbound.ai');
         const request = {
             url: url.toString(),
             method,

package/dist/lib/adapters/http-adapter.d.ts

@@ -1,5 +1,5 @@
-import { ILogger } from 'unnbound-logger-sdk';
-import { Hono } from 'hono';
+import type { Hono } from 'hono';
+import { type ILogger } from 'unnbound-logger-sdk';
 export interface HttpAdapterOptions {
     app: Hono<any, any, any>;
     logger: ILogger;

package/dist/lib/adapters/http-adapter.js

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.HttpAdapter = void 0;
+const node_server_1 = require("@hono/node-server");
 const unnbound_logger_sdk_1 = require("unnbound-logger-sdk");
 const internal_1 = require("unnbound-logger-sdk/dist/internal");
-const node_server_1 = require("@hono/node-server");
 class HttpAdapter {
     logger;
     app;
@@ -13,7 +13,7 @@ class HttpAdapter {
     }
     async listen() {
         try {
-            const port = parseInt(process.env.PORT ?? '3000');
+            const port = Number.parseInt(process.env.PORT ?? '3000');
             const server = await new Promise((resolve, reject) => {
                 try {
                     const server = (0, node_server_1.serve)({ fetch: this.app.fetch, port }, () => resolve(server));

package/dist/lib/adapters/queue-adapter.d.ts

@@ -1,13 +1,12 @@
-import { ILogger } from 'unnbound-logger-sdk';
-import { Hono } from 'hono';
+import type { Hono } from 'hono';
+import { type ILogger } from 'unnbound-logger-sdk';
 export interface SqsRequest {
     method: string;
     url: string;
     headers: Record<string, string>;
     body?: any;
 }
-export interface SqsMetadata {
-}
+export type SqsMetadata = {};
 export interface SqsMessage {
     id: string;
     timestamp: number;

package/dist/lib/adapters/queue-adapter.js

@@ -1,10 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.QueueAdapter = void 0;
-const unnbound_logger_sdk_1 = require("unnbound-logger-sdk");
-const internal_1 = require("unnbound-logger-sdk/dist/internal");
 const client_s3_1 = require("@aws-sdk/client-s3");
 const client_sqs_1 = require("@aws-sdk/client-sqs");
+const unnbound_logger_sdk_1 = require("unnbound-logger-sdk");
+const internal_1 = require("unnbound-logger-sdk/dist/internal");
 const utils_1 = require("../utils");
 const extended_sqs_client_1 = require("./extended-sqs-client");
 class QueueAdapter {
@@ -20,7 +20,7 @@ class QueueAdapter {
             maxMessages: options?.maxMessages ?? 10,
             visibilityTimeout: options?.visibilityTimeout ?? 20,
         };
-        const region = process.env.UNNBOUND_AWS_REGION ?? process.env.AWS_REGION ?? 'us-west-1';
+        const region = process.env.UNNBOUND_AWS_REGION ?? process.env.AWS_REGION ?? 'us-east-1';
         const endpoint = process.env.UNNBOUND_S3_ENDPOINT;
         const s3 = new client_s3_1.S3Client({ region, endpoint, maxAttempts: 3 });
         this.sqs = new extended_sqs_client_1.ExtendedSQSClient({ region, endpoint, s3, maxAttempts: 3 });
@@ -77,7 +77,7 @@ class QueueAdapter {
             }
         };
     }
-    async processMessage({ message, event, }) {
+    async processMessage({ message, event }) {
         try {
             // It forward the request to the HTTP server that will
             // handle it according to the routes the user set up.

package/dist/lib/enqueue.d.ts

@@ -1,6 +1,10 @@
-import { EventMetadata, IncomingRequest } from './event';
+import type { EventMetadata, IncomingRequest } from './event';
 export interface EnqueuedRequest extends Omit<IncomingRequest, 'url' | 'headers' | 'query'> {
     query?: IncomingRequest['query'];
     headers?: IncomingRequest['headers'];
 }
+/**
+ * Create an enqueuer that posts to the ingress service via HTTP.
+ * The ingress service publishes to SQS for async processing.
+ */
 export declare const createEnqueuer: () => (event: EnqueuedRequest, metadata?: Partial<EventMetadata>) => Promise<undefined>;

package/dist/lib/enqueue.js

@@ -5,29 +5,117 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createEnqueuer = void 0;
 const axios_1 = __importDefault(require("axios"));
-const types_1 = require("unnbound-logger-sdk/dist/types");
 const unnbound_logger_sdk_1 = require("unnbound-logger-sdk");
 const internal_1 = require("unnbound-logger-sdk/dist/internal");
 const storage_1 = require("unnbound-logger-sdk/dist/storage");
+const types_1 = require("unnbound-logger-sdk/dist/types");
+/**
+ * Extract workspace shortId from workflow URL
+ *
+ * Supported formats:
+ * - New path-based: {env}.workflow.gotemper.com/sandbox/{shortId} → {shortId}
+ * - New path-based: {env}.workflow.gotemper.com/{shortId} → {shortId}
+ * - Legacy hostname: {shortId}.workspaces.{env}.unnbound.ai → {shortId}
+ * - Custom domain: proxy.domain.com/{shortId} → {shortId}
+ */
 const getWorkspaceId = (url) => {
     url = url.replace(/^https?:\/\//, '');
-    if (!url.includes('unnbound.ai'))
-        return url.replace(/^.+?\/(.+)$/, '$1').replace(/^a?sync\//, '');
-    if (url.startsWith('workflow.'))
-        return url.replace(/^.+?\/(.+)$/, '$1').replace(/^a?sync\//, '');
-    return url.replace(/\.unnbound\.ai$/, '').replace(/^a?sync\//, '');
+    // Custom domain: extract path after domain (not gotemper.com or legacy unnbound.ai)
+    if (!url.includes('gotemper.com') && !url.includes('unnbound.ai')) {
+        return url
+            .replace(/^.+?\/(.+)$/, '$1')
+            .replace(/^(sandbox\/)?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.')) {
+        // Extract everything after the domain, then remove sandbox/ and async/ prefixes
+        const path = url.replace(/^.+?\/(.+)$/, '$1');
+        return path
+            .replace(/^sandbox\//, '')
+            .replace(/^a?sync\//, '')
+            .split('/')[0];
+    }
+    // Legacy hostname format: {shortId}.workspaces.{env}.unnbound.ai
+    return url.split('.')[0];
+};
+/**
+ * Check if the workflow URL indicates a sandbox environment
+ */
+const isSandboxUrl = (url) => {
+    // Check if URL contains /sandbox/ path
+    return url.includes('/sandbox/') || url.includes('/sandbox');
 };
-const getEnvironment = (url) => (url.includes('stg.unnbound.ai') ? 'stg' : 'prod');
+/**
+ * Extract workflow domain from URL
+ *
+ * Supports all environments by extracting the domain from the URL:
+ * - nick.dev.workflow.gotemper.com → nick.dev.workflow.gotemper.com (new pattern)
+ * - stg.dev.workflow.gotemper.com → stg.dev.workflow.gotemper.com (new pattern)
+ * - workflow.gotemper.com → workflow.gotemper.com (prod)
+ * - Custom domain: proxy.api.goaugment.com → proxy.api.goaugment.com
+ *
+ * Also handles legacy formats:
+ * - {shortId}.workspaces.{env}.unnbound.ai → {env}.dev.workflow.gotemper.com
+ */
 const getWorkflowDomain = (url) => {
-    return getEnvironment(url) === 'stg' ? 'workflow.stg.unnbound.ai' : 'workflow.unnbound.ai';
+    // Remove protocol and extract hostname
+    const cleanUrl = url.replace(/^https?:\/\//, '');
+    const hostname = cleanUrl.split('/')[0];
+    // For gotemper.com or unnbound.ai domains, ensure we use the workflow subdomain pattern
+    if (hostname.includes('gotemper.com') || hostname.includes('unnbound.ai')) {
+        // New pattern: {env}.dev.workflow.{domain} - return as-is
+        if (hostname.includes('.workflow.')) {
+            return hostname;
+        }
+        // Prod pattern: workflow.{domain} - return as-is
+        if (hostname.startsWith('workflow.')) {
+            return hostname;
+        }
+        // Legacy hostname format: {shortId}.workspaces.{env}.unnbound.ai
+        // Extract env and construct workflow domain using new pattern with gotemper.com
+        const parts = hostname.split('.');
+        const workspacesIdx = parts.indexOf('workspaces');
+        if (workspacesIdx !== -1) {
+            // Everything after 'workspaces' is the env domain (e.g., 'stg.unnbound.ai')
+            const envParts = parts.slice(workspacesIdx + 1); // ['stg', 'unnbound', 'ai']
+            const env = envParts[0]; // 'stg'
+            // New pattern: {env}.dev.workflow.gotemper.com (always use gotemper.com now)
+            // 'unnbound' means prod (legacy unnbound.ai prod URL)
+            return env === 'unnbound' ? 'workflow.gotemper.com' : `${env}.dev.workflow.gotemper.com`;
+        }
+    }
+    // Custom domain - return hostname as-is
+    return hostname;
 };
-const createEnqueuer = () => {
+// Generate a simple UUID v4
+const _generateId = () => {
+    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
+        const r = (Math.random() * 16) | 0;
+        const v = c === 'x' ? r : (r & 0x3) | 0x8;
+        return v.toString(16);
+    });
+};
+/**
+ * Create an HTTP-based enqueuer that posts to the ingress service.
+ * Used for legacy SQS mode or cross-workflow communication.
+ *
+ * URL format:
+ * - Sandbox:    https://{env}.dev.workflow.gotemper.com/sandbox/async/{shortId} (dev) or https://workflow.gotemper.com/sandbox/async/{shortId} (prod)
+ * - Production: https://{env}.dev.workflow.gotemper.com/async/{shortId} (dev) or https://workflow.gotemper.com/async/{shortId} (prod)
+ */
+const createHttpEnqueuer = () => {
     const url = process.env.UNNBOUND_WORKFLOW_URL;
     if (!url)
         throw new Error('UNNBOUND_WORKFLOW_URL is not configured. Reach out to support.');
-    const client = (0, unnbound_logger_sdk_1.traceAxios)(axios_1.default.create({ baseURL: `https://${getWorkflowDomain(url)}/async/${getWorkspaceId(url)}` }), { getPayload: internal_1.internal });
+    // Construct base URL with sandbox prefix if applicable
+    const workspaceId = getWorkspaceId(url);
+    const domain = getWorkflowDomain(url);
+    const sandboxPrefix = isSandboxUrl(url) ? '/sandbox' : '';
+    const baseURL = `https://${domain}${sandboxPrefix}/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...');
+        unnbound_logger_sdk_1.logger.info({ event, metadata }, 'Enqueuing event via HTTP...');
         if (!event.path.startsWith('/'))
             throw new Error('Path must be relative.');
         const { traceId, messageId } = storage_1.storage.getStore() ?? {};
@@ -51,4 +139,11 @@ const createEnqueuer = () => {
         throw new Error(`Unhandled enqueue method: ${event.method}`);
     };
 };
+/**
+ * Create an enqueuer that posts to the ingress service via HTTP.
+ * The ingress service publishes to SQS for async processing.
+ */
+const createEnqueuer = () => {
+    return createHttpEnqueuer();
+};
 exports.createEnqueuer = createEnqueuer;

package/dist/lib/error.d.ts

@@ -1,5 +1,5 @@
-import { StatusCode } from 'hono/utils/http-status';
-import { StrictEventHandlerResult } from './event';
+import type { StatusCode } from 'hono/utils/http-status';
+import type { StrictEventHandlerResult } from './event';
 export interface ServerErrorOptions extends ErrorOptions {
     status?: StatusCode;
     message?: string;

package/dist/lib/event.d.ts

@@ -1,5 +1,5 @@
+import type { StatusCode } from 'hono/utils/http-status';
 import type { HttpMethod } from 'unnbound-logger-sdk';
-import { StatusCode } from 'hono/utils/http-status';
 export interface IncomingRequest<B = any> {
     url: string;
     method: HttpMethod;
@@ -27,4 +27,4 @@ export interface StrictEventHandlerResult {
     headers?: Record<string, string>;
     body?: object | undefined | null;
 }
-export type EventHandlerResult = Partial<StrictEventHandlerResult> | undefined | null | void;
+export type EventHandlerResult = Partial<StrictEventHandlerResult> | undefined | null | undefined;

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

@@ -1,7 +1,7 @@
-import { Context } from 'hono';
-import { EventHandlerResult, StrictEventHandlerResult } from '../event';
-import { MiddlewareHandler } from './middleware';
-import { EventEnvironment, EventVariables, MaybePromise } from './types';
+import type { Context } from 'hono';
+import type { EventHandlerResult, StrictEventHandlerResult } from '../event';
+import { type MiddlewareHandler } from './middleware';
+import type { EventEnvironment, EventVariables, MaybePromise } from './types';
 export type Handler<I, R = EventHandlerResult> = (input: I) => MaybePromise<R>;
 export interface Endpoint<I> {
     (path: string, handler: Handler<I>): MaybePromise<void>;

package/dist/lib/routing/endpoint.js

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.attachTraceHeaders = exports.respondWith = exports.patchEndpoint = exports.parseEndpointArguments = exports.buildEndpointArguments = void 0;
-const types_1 = require("unnbound-logger-sdk/dist/types");
-const storage_1 = require("unnbound-logger-sdk/dist/storage");
 const unnbound_logger_sdk_1 = require("unnbound-logger-sdk");
+const storage_1 = require("unnbound-logger-sdk/dist/storage");
+const types_1 = require("unnbound-logger-sdk/dist/types");
 const utils_1 = require("../utils");
 const middleware_1 = require("./middleware");
 const buildEndpointArguments = (...args) => {

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

@@ -1,5 +1,5 @@
-import { Context, Next } from 'hono';
-import { EventEnvironment, EventVariables, MaybePromise } from './types';
+import type { Context, Next } from 'hono';
+import type { EventEnvironment, EventVariables, MaybePromise } from './types';
 export type MiddlewareHandler<I> = (input: I, next: Next) => MaybePromise<void>;
 export interface Middleware<I> {
     (...middlewares: MiddlewareHandler<I>[]): MaybePromise<void>;

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

@@ -1,5 +1,5 @@
-import { Env } from 'hono';
-import { IncomingEvent, MatchedIncomingRequest } from '../event';
+import type { Env } from 'hono';
+import type { IncomingEvent, MatchedIncomingRequest } from '../event';
 export type MaybePromise<V> = Promise<V> | V;
 interface EventInternalVariables<V extends object> {
     set: <K extends keyof V>(key: K, value: V[K]) => void;

package/dist/lib/server.d.ts

@@ -1,9 +1,8 @@
-import { ILogger } from 'unnbound-logger-sdk';
-import { Endpoint } from './routing/endpoint';
-import { Middleware } from './routing/middleware';
-import { EventVariables } from './routing/types';
-interface HttpOptions {
-}
+import { type ILogger } from 'unnbound-logger-sdk';
+import { type Endpoint } from './routing/endpoint';
+import { type Middleware } from './routing/middleware';
+import type { EventVariables } from './routing/types';
+type HttpOptions = {};
 interface QueueOptions {
     maxMessages?: number;
     visibilityTimeout?: number;

package/dist/lib/server.js

@@ -1,14 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createServer = void 0;
-const unnbound_logger_sdk_1 = require("unnbound-logger-sdk");
 const hono_1 = require("hono");
+const unnbound_logger_sdk_1 = require("unnbound-logger-sdk");
 const http_adapter_1 = require("./adapters/http-adapter");
 const queue_adapter_1 = require("./adapters/queue-adapter");
+const error_1 = require("./error");
 const endpoint_1 = require("./routing/endpoint");
 const middleware_1 = require("./routing/middleware");
 const utils_1 = require("./utils");
-const error_1 = require("./error");
 class HttpQueueServer {
     logger;
     app = new hono_1.Hono();
@@ -33,6 +33,7 @@ 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,

package/dist/lib/utils.d.ts

@@ -1,6 +1,6 @@
-import { Maybe } from 'unnbound-logger-sdk/dist/types';
-import { HonoRequest } from 'hono';
-import { EventHandlerResult, EventMetadata, EventSource, IncomingEvent, IncomingRequest, MatchedIncomingRequest, StrictEventHandlerResult } from './event';
+import type { HonoRequest } from 'hono';
+import { type Maybe } from 'unnbound-logger-sdk/dist/types';
+import type { EventHandlerResult, EventMetadata, EventSource, IncomingEvent, IncomingRequest, MatchedIncomingRequest, StrictEventHandlerResult } from './event';
 export declare const normalizeHeaders: (headers: Record<string, string | string[]>) => Record<string, string>;
 export declare const getIncomingEvent: (event: HonoRequest) => Promise<IncomingEvent<MatchedIncomingRequest>>;
 export declare const getMetadataFromRequest: (request: IncomingRequest, source: EventSource) => EventMetadata;

package/dist/lib/utils.js

@@ -2,8 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.batchArray = exports.buildIncomingPayload = exports.serializeMetadata = exports.getMetadataFromRequest = exports.getIncomingEvent = exports.normalizeHeaders = void 0;
 const unnbound_logger_sdk_1 = require("unnbound-logger-sdk");
-const types_1 = require("unnbound-logger-sdk/dist/types");
 const trace_1 = require("unnbound-logger-sdk/dist/trace");
+const types_1 = require("unnbound-logger-sdk/dist/types");
 const utils_1 = require("unnbound-logger-sdk/dist/utils");
 const error_1 = require("./error");
 const normalizeHeaders = (headers) => {
@@ -33,7 +33,7 @@ const parseParams = (request) => {
     }
 };
 const getIncomingRequest = async (request) => {
-    const url = new URL(request.url, `https://unnbound.ai`);
+    const url = new URL(request.url, 'https://unnbound.ai');
     const headers = (0, exports.normalizeHeaders)(request.header());
     return {
         url: url.toString(),
@@ -76,7 +76,7 @@ const serializeMetadata = (metadata) => ({
 exports.serializeMetadata = serializeMetadata;
 const deserializeMetadata = (request) => ({
     source: request.headers[sourceKey],
-    timestamp: request.headers[timestampKey] ? parseInt(request.headers[timestampKey]) : undefined,
+    timestamp: request.headers[timestampKey] ? Number.parseInt(request.headers[timestampKey]) : undefined,
 });
 const buildResponsePayload = (result) => ({
     status: result?.status ?? 204,

package/package.json

@@ -1,21 +1,19 @@
 {
   "name": "unnbound-events",
   "description": "Unified events SDK to handle HTTP routes and queued messages with a single routing API.",
-  "version": "2.0.16",
+  "version": "2.0.18",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {
     "build": "tsc",
-    "test": "jest",
-    "test:coverage": "jest --coverage",
-    "test:watch": "jest --watch",
+    "test": "echo 'No tests'",
     "typecheck": "tsc -noEmit",
     "lint": "eslint --cache --cache-location ./node_modules/.cache/eslint .",
-    "lint:fix": "pnpm lint --fix",
-    "format": "prettier --write .",
-    "format:check": "prettier --check .",
-    "prepublishOnly": "pnpm build",
-    "start:example": "npx --yes tsx --watch examples/node-server.ts",
+    "lint:fix": "bun run lint --fix",
+    "format": "biome format --write .",
+    "format:check": "biome format .",
+    "prepublishOnly": "bun run build",
+    "start:example": "bun --watch examples/node-server.ts",
     "version:bump": "npm version patch"
   },
   "author": "Unnbound Team",
@@ -33,12 +31,14 @@
     "@aws-sdk/client-sqs": "^3.0.0",
     "@hono/node-server": "^1.19.6",
     "axios": "^1.12.2",
-    "hono": "^4.10.4",
-    "unnbound-logger-sdk": "workspace:*"
+    "hono": "^4.11.4",
+    "ioredis": "^5.4.1",
+    "unnbound-logger-sdk": "^3.0.34"
   },
   "devDependencies": {
     "@types/jest": "^29.5.12",
-    "@types/node": "^22"
+    "@types/node": "^22",
+    "typescript": "^5.8.3"
   },
   "files": [
     "dist/**/*",