unnbound-events 2.0.19 → 2.0.20

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/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/package.json

@@ -1,21 +1,9 @@
 {
   "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.20",
   "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",
-    "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",
   "license": "MIT",
   "repository": {
@@ -30,15 +18,15 @@
     "@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",
+    "typescript": "^5.8.3",
+    "vitest": "^4.0.15"
   },
   "files": [
     "dist/**/*",
@@ -48,5 +36,14 @@
   "engines": {
     "node": ">=22"
   },
-  "sideEffects": false
-}
+  "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"
+  }
+}