@saga-bus/hono 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Dean Foran
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,263 @@
+# @saga-bus/hono
+
+Hono integration for saga-bus, designed for edge runtimes (Cloudflare Workers, Deno, Bun).
+
+## Installation
+
+```bash
+npm install @saga-bus/hono hono
+# or
+pnpm add @saga-bus/hono hono
+```
+
+## Features
+
+- **Edge Runtime Compatible**: Works with Cloudflare Workers, Deno, Bun
+- **Context Variables**: Type-safe `c.var.bus` and `c.var.correlationId`
+- **Health Handler**: Factory for health check routes
+- **Error Handler**: Saga-specific error responses
+- **No Node.js Dependencies**: Uses simple UUID generator
+
+## Quick Start
+
+```typescript
+import { Hono } from "hono";
+import { createBus } from "@saga-bus/core";
+import {
+  sagaBusMiddleware,
+  sagaErrorHandler,
+  createHealthHandler,
+} from "@saga-bus/hono";
+
+const bus = createBus({ /* config */ });
+await bus.start();
+
+const app = new Hono();
+
+// Error handler first
+app.use("*", sagaErrorHandler());
+
+// Attach bus to context
+app.use("*", sagaBusMiddleware({ bus }));
+
+// Health check
+app.get("/health", createHealthHandler({ bus }));
+
+// Your routes
+app.post("/orders", async (c) => {
+  const bus = c.get("bus");
+  const correlationId = c.get("correlationId");
+
+  await bus.publish({
+    type: "CreateOrder",
+    payload: await c.req.json(),
+  });
+
+  return c.json({ correlationId });
+});
+
+export default app;
+```
+
+## API Reference
+
+### sagaBusMiddleware(options)
+
+Creates middleware that attaches the bus instance and correlation ID to context.
+
+```typescript
+interface SagaBusHonoOptions {
+  /** The bus instance to attach */
+  bus: Bus;
+
+  /** Header name for correlation ID (default: "x-correlation-id") */
+  correlationIdHeader?: string;
+
+  /** Whether to generate correlation ID if not present (default: true) */
+  generateCorrelationId?: boolean;
+
+  /** Custom correlation ID generator */
+  correlationIdGenerator?: () => string;
+}
+```
+
+### sagaErrorHandler()
+
+Error handler middleware for saga-related errors.
+
+- **SagaTimeoutError**: Returns 408 Request Timeout
+- **ConcurrencyError**: Returns 409 Conflict
+
+### createHealthHandler(options)
+
+Creates a health check handler.
+
+```typescript
+interface HealthCheckOptions {
+  /** The bus instance to check */
+  bus: Bus;
+
+  /** Additional health checks */
+  checks?: Array<{
+    name: string;
+    check: () => Promise<boolean>;
+  }>;
+}
+```
+
+### SagaBusEnv
+
+Type definition for Hono context variables.
+
+```typescript
+interface SagaBusEnv extends Env {
+  Variables: {
+    bus: Bus;
+    correlationId: string;
+  };
+}
+```
+
+## Examples
+
+### Basic Usage
+
+```typescript
+import { Hono } from "hono";
+import { sagaBusMiddleware, SagaBusEnv } from "@saga-bus/hono";
+
+const app = new Hono<SagaBusEnv>();
+
+app.use("*", sagaBusMiddleware({ bus }));
+
+app.post("/messages", async (c) => {
+  const bus = c.get("bus");
+  const correlationId = c.get("correlationId");
+
+  await bus.publish({
+    type: c.req.query("type") || "Message",
+    payload: await c.req.json(),
+  });
+
+  return c.json({ success: true, correlationId });
+});
+```
+
+### With Health Checks
+
+```typescript
+import { createHealthHandler } from "@saga-bus/hono";
+
+app.get("/health", createHealthHandler({
+  bus,
+  checks: [
+    {
+      name: "database",
+      check: async () => {
+        await db.query("SELECT 1");
+        return true;
+      },
+    },
+  ],
+}));
+```
+
+### Cloudflare Workers
+
+```typescript
+import { Hono } from "hono";
+import { sagaBusMiddleware, SagaBusEnv } from "@saga-bus/hono";
+import { createBus } from "@saga-bus/core";
+
+interface Env {
+  DB: D1Database;
+}
+
+const app = new Hono<SagaBusEnv & { Bindings: Env }>();
+
+// Create bus per-request from environment
+app.use("*", async (c, next) => {
+  const bus = createBusFromEnv(c.env);
+  return sagaBusMiddleware({ bus })(c, next);
+});
+
+app.post("/messages", async (c) => {
+  await c.get("bus").publish({ type: "Message", payload: {} });
+  return c.json({ ok: true });
+});
+
+export default app;
+```
+
+### Deno
+
+```typescript
+import { Hono } from "https://deno.land/x/hono/mod.ts";
+import { sagaBusMiddleware, SagaBusEnv } from "@saga-bus/hono";
+
+const app = new Hono<SagaBusEnv>();
+app.use("*", sagaBusMiddleware({ bus }));
+
+Deno.serve(app.fetch);
+```
+
+### Custom Correlation ID Generator
+
+```typescript
+app.use("*", sagaBusMiddleware({
+  bus,
+  correlationIdHeader: "x-request-id",
+  correlationIdGenerator: () => `req-${Date.now()}-${Math.random().toString(36).slice(2)}`,
+}));
+```
+
+## TypeScript Support
+
+The package provides full type safety for context variables:
+
+```typescript
+import { Hono } from "hono";
+import { SagaBusEnv } from "@saga-bus/hono";
+
+// Use SagaBusEnv for typed context
+const app = new Hono<SagaBusEnv>();
+
+app.get("/", (c) => {
+  // c.get("bus") is typed as Bus
+  const bus = c.get("bus");
+
+  // c.get("correlationId") is typed as string
+  const correlationId = c.get("correlationId");
+
+  return c.json({ correlationId });
+});
+```
+
+## Error Handling
+
+```typescript
+app.use("*", sagaErrorHandler());
+
+app.get("/order/:id", async (c) => {
+  // If this throws a ConcurrencyError, client gets 409
+  await c.get("bus").publish({
+    type: "UpdateOrder",
+    payload: { id: c.req.param("id") },
+  });
+  return c.json({ updated: true });
+});
+```
+
+Response on ConcurrencyError:
+
+```json
+{
+  "error": "Concurrency Conflict",
+  "message": "Expected version 1, but found 2",
+  "correlationId": "abc-123"
+}
+```
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,146 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  createHealthHandler: () => createHealthHandler,
+  createReadinessHandler: () => createReadinessHandler,
+  sagaBusMiddleware: () => sagaBusMiddleware,
+  sagaErrorHandler: () => sagaErrorHandler
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/middleware.ts
+function generateId() {
+  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+    const r = Math.random() * 16 | 0;
+    const v = c === "x" ? r : r & 3 | 8;
+    return v.toString(16);
+  });
+}
+function sagaBusMiddleware(options) {
+  const {
+    bus,
+    correlationIdHeader = "x-correlation-id",
+    generateCorrelationId = true,
+    correlationIdGenerator = generateId
+  } = options;
+  return async (c, next) => {
+    c.set("bus", bus);
+    let correlationId = c.req.header(correlationIdHeader);
+    if (!correlationId && generateCorrelationId) {
+      correlationId = correlationIdGenerator();
+    }
+    if (correlationId) {
+      c.set("correlationId", correlationId);
+      c.header(correlationIdHeader, correlationId);
+    }
+    await next();
+  };
+}
+function sagaErrorHandler() {
+  return (err, c) => {
+    if (err instanceof Error) {
+      if (err.name === "SagaTimeoutError") {
+        return c.json(
+          {
+            error: "Saga Timeout",
+            message: err.message,
+            correlationId: c.get("correlationId")
+          },
+          408
+        );
+      }
+      if (err.name === "ConcurrencyError") {
+        return c.json(
+          {
+            error: "Concurrency Conflict",
+            message: err.message,
+            correlationId: c.get("correlationId")
+          },
+          409
+        );
+      }
+    }
+    return c.json(
+      {
+        error: "Internal Server Error",
+        message: err instanceof Error ? err.message : "Unknown error",
+        correlationId: c.get("correlationId")
+      },
+      500
+    );
+  };
+}
+
+// src/health.ts
+function createHealthHandler(options) {
+  const { bus, checks = [] } = options;
+  return async (c) => {
+    const healthStatus = {
+      status: "healthy",
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      checks: {}
+    };
+    try {
+      if (bus) {
+        healthStatus.checks.bus = { status: "pass" };
+      } else {
+        throw new Error("Bus not available");
+      }
+    } catch (error) {
+      healthStatus.status = "unhealthy";
+      healthStatus.checks.bus = {
+        status: "fail",
+        message: error instanceof Error ? error.message : "Unknown error"
+      };
+    }
+    for (const check of checks) {
+      try {
+        const result = await check.check();
+        healthStatus.checks[check.name] = {
+          status: result ? "pass" : "fail"
+        };
+        if (!result) {
+          healthStatus.status = "unhealthy";
+        }
+      } catch (error) {
+        healthStatus.status = "unhealthy";
+        healthStatus.checks[check.name] = {
+          status: "fail",
+          message: error instanceof Error ? error.message : "Unknown error"
+        };
+      }
+    }
+    const statusCode = healthStatus.status === "healthy" ? 200 : 503;
+    return c.json(healthStatus, statusCode);
+  };
+}
+function createReadinessHandler(options) {
+  return createHealthHandler(options);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createHealthHandler,
+  createReadinessHandler,
+  sagaBusMiddleware,
+  sagaErrorHandler
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/middleware.ts","../src/health.ts"],"sourcesContent":["export { sagaBusMiddleware, sagaErrorHandler } from \"./middleware.js\";\nexport { createHealthHandler, createReadinessHandler } from \"./health.js\";\nexport type {\n  SagaBusEnv,\n  SagaBusHonoOptions,\n  HealthCheckOptions,\n  HealthStatus,\n} from \"./types.js\";\n","import type { MiddlewareHandler, ErrorHandler } from \"hono\";\nimport type { SagaBusEnv, SagaBusHonoOptions } from \"./types.js\";\n\n// Simple UUID generator for edge compatibility (no crypto.randomUUID dependency)\nfunction generateId(): string {\n  return \"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx\".replace(/[xy]/g, (c) => {\n    const r = (Math.random() * 16) | 0;\n    const v = c === \"x\" ? r : (r & 0x3) | 0x8;\n    return v.toString(16);\n  });\n}\n\n/**\n * Creates middleware that attaches the bus instance and correlation ID to context.\n */\nexport function sagaBusMiddleware(\n  options: SagaBusHonoOptions\n): MiddlewareHandler<SagaBusEnv> {\n  const {\n    bus,\n    correlationIdHeader = \"x-correlation-id\",\n    generateCorrelationId = true,\n    correlationIdGenerator = generateId,\n  } = options;\n\n  return async (c, next) => {\n    // Attach bus to context\n    c.set(\"bus\", bus);\n\n    // Extract or generate correlation ID\n    let correlationId = c.req.header(correlationIdHeader);\n\n    if (!correlationId && generateCorrelationId) {\n      correlationId = correlationIdGenerator();\n    }\n\n    if (correlationId) {\n      c.set(\"correlationId\", correlationId);\n      c.header(correlationIdHeader, correlationId);\n    }\n\n    await next();\n  };\n}\n\n/**\n * Error handler for saga-related errors.\n * Use with app.onError(sagaErrorHandler())\n */\nexport function sagaErrorHandler(): ErrorHandler<SagaBusEnv> {\n  return (err, c) => {\n    if (err instanceof Error) {\n      if (err.name === \"SagaTimeoutError\") {\n        return c.json(\n          {\n            error: \"Saga Timeout\",\n            message: err.message,\n            correlationId: c.get(\"correlationId\"),\n          },\n          408\n        );\n      }\n\n      if (err.name === \"ConcurrencyError\") {\n        return c.json(\n          {\n            error: \"Concurrency Conflict\",\n            message: err.message,\n            correlationId: c.get(\"correlationId\"),\n          },\n          409\n        );\n      }\n    }\n\n    // Return generic error for other cases\n    return c.json(\n      {\n        error: \"Internal Server Error\",\n        message: err instanceof Error ? err.message : \"Unknown error\",\n        correlationId: c.get(\"correlationId\"),\n      },\n      500\n    );\n  };\n}\n","import type { Context } from \"hono\";\nimport type { HealthCheckOptions, HealthStatus, SagaBusEnv } from \"./types.js\";\n\n/**\n * Creates a health check handler.\n */\nexport function createHealthHandler(options: HealthCheckOptions) {\n  const { bus, checks = [] } = options;\n\n  return async (c: Context<SagaBusEnv>) => {\n    const healthStatus: HealthStatus = {\n      status: \"healthy\",\n      timestamp: new Date().toISOString(),\n      checks: {},\n    };\n\n    // Check bus\n    try {\n      if (bus) {\n        healthStatus.checks.bus = { status: \"pass\" };\n      } else {\n        throw new Error(\"Bus not available\");\n      }\n    } catch (error) {\n      healthStatus.status = \"unhealthy\";\n      healthStatus.checks.bus = {\n        status: \"fail\",\n        message: error instanceof Error ? error.message : \"Unknown error\",\n      };\n    }\n\n    // Run additional checks\n    for (const check of checks) {\n      try {\n        const result = await check.check();\n        healthStatus.checks[check.name] = {\n          status: result ? \"pass\" : \"fail\",\n        };\n        if (!result) {\n          healthStatus.status = \"unhealthy\";\n        }\n      } catch (error) {\n        healthStatus.status = \"unhealthy\";\n        healthStatus.checks[check.name] = {\n          status: \"fail\",\n          message: error instanceof Error ? error.message : \"Unknown error\",\n        };\n      }\n    }\n\n    const statusCode = healthStatus.status === \"healthy\" ? 200 : 503;\n    return c.json(healthStatus, statusCode);\n  };\n}\n\n/**\n * Creates a readiness check handler (alias for health).\n */\nexport function createReadinessHandler(options: HealthCheckOptions) {\n  return createHealthHandler(options);\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,76 @@
+import * as hono from 'hono';
+import { Env, MiddlewareHandler, ErrorHandler, Context } from 'hono';
+import { Bus } from '@saga-bus/core';
+
+interface SagaBusEnv extends Env {
+    Variables: {
+        bus: Bus;
+        correlationId: string;
+    };
+}
+interface SagaBusHonoOptions {
+    /** The bus instance to attach */
+    bus: Bus;
+    /** Header name for correlation ID */
+    correlationIdHeader?: string;
+    /** Whether to generate correlation ID if not present */
+    generateCorrelationId?: boolean;
+    /** Custom correlation ID generator */
+    correlationIdGenerator?: () => string;
+}
+interface HealthCheckOptions {
+    /** The bus instance to check */
+    bus: Bus;
+    /** Additional health checks */
+    checks?: Array<{
+        name: string;
+        check: () => Promise<boolean>;
+    }>;
+}
+interface HealthStatus {
+    status: "healthy" | "unhealthy";
+    timestamp: string;
+    checks: Record<string, {
+        status: "pass" | "fail";
+        message?: string;
+    }>;
+}
+
+/**
+ * Creates middleware that attaches the bus instance and correlation ID to context.
+ */
+declare function sagaBusMiddleware(options: SagaBusHonoOptions): MiddlewareHandler<SagaBusEnv>;
+/**
+ * Error handler for saga-related errors.
+ * Use with app.onError(sagaErrorHandler())
+ */
+declare function sagaErrorHandler(): ErrorHandler<SagaBusEnv>;
+
+/**
+ * Creates a health check handler.
+ */
+declare function createHealthHandler(options: HealthCheckOptions): (c: Context<SagaBusEnv>) => Promise<Response & hono.TypedResponse<{
+    status: "healthy" | "unhealthy";
+    timestamp: string;
+    checks: {
+        [x: string]: {
+            status: "pass" | "fail";
+            message?: string | undefined;
+        };
+    };
+}, 200 | 503, "json">>;
+/**
+ * Creates a readiness check handler (alias for health).
+ */
+declare function createReadinessHandler(options: HealthCheckOptions): (c: Context<SagaBusEnv>) => Promise<Response & hono.TypedResponse<{
+    status: "healthy" | "unhealthy";
+    timestamp: string;
+    checks: {
+        [x: string]: {
+            status: "pass" | "fail";
+            message?: string | undefined;
+        };
+    };
+}, 200 | 503, "json">>;
+
+export { type HealthCheckOptions, type HealthStatus, type SagaBusEnv, type SagaBusHonoOptions, createHealthHandler, createReadinessHandler, sagaBusMiddleware, sagaErrorHandler };

package/dist/index.d.ts

@@ -0,0 +1,76 @@
+import * as hono from 'hono';
+import { Env, MiddlewareHandler, ErrorHandler, Context } from 'hono';
+import { Bus } from '@saga-bus/core';
+
+interface SagaBusEnv extends Env {
+    Variables: {
+        bus: Bus;
+        correlationId: string;
+    };
+}
+interface SagaBusHonoOptions {
+    /** The bus instance to attach */
+    bus: Bus;
+    /** Header name for correlation ID */
+    correlationIdHeader?: string;
+    /** Whether to generate correlation ID if not present */
+    generateCorrelationId?: boolean;
+    /** Custom correlation ID generator */
+    correlationIdGenerator?: () => string;
+}
+interface HealthCheckOptions {
+    /** The bus instance to check */
+    bus: Bus;
+    /** Additional health checks */
+    checks?: Array<{
+        name: string;
+        check: () => Promise<boolean>;
+    }>;
+}
+interface HealthStatus {
+    status: "healthy" | "unhealthy";
+    timestamp: string;
+    checks: Record<string, {
+        status: "pass" | "fail";
+        message?: string;
+    }>;
+}
+
+/**
+ * Creates middleware that attaches the bus instance and correlation ID to context.
+ */
+declare function sagaBusMiddleware(options: SagaBusHonoOptions): MiddlewareHandler<SagaBusEnv>;
+/**
+ * Error handler for saga-related errors.
+ * Use with app.onError(sagaErrorHandler())
+ */
+declare function sagaErrorHandler(): ErrorHandler<SagaBusEnv>;
+
+/**
+ * Creates a health check handler.
+ */
+declare function createHealthHandler(options: HealthCheckOptions): (c: Context<SagaBusEnv>) => Promise<Response & hono.TypedResponse<{
+    status: "healthy" | "unhealthy";
+    timestamp: string;
+    checks: {
+        [x: string]: {
+            status: "pass" | "fail";
+            message?: string | undefined;
+        };
+    };
+}, 200 | 503, "json">>;
+/**
+ * Creates a readiness check handler (alias for health).
+ */
+declare function createReadinessHandler(options: HealthCheckOptions): (c: Context<SagaBusEnv>) => Promise<Response & hono.TypedResponse<{
+    status: "healthy" | "unhealthy";
+    timestamp: string;
+    checks: {
+        [x: string]: {
+            status: "pass" | "fail";
+            message?: string | undefined;
+        };
+    };
+}, 200 | 503, "json">>;
+
+export { type HealthCheckOptions, type HealthStatus, type SagaBusEnv, type SagaBusHonoOptions, createHealthHandler, createReadinessHandler, sagaBusMiddleware, sagaErrorHandler };

package/dist/index.js

@@ -0,0 +1,116 @@
+// src/middleware.ts
+function generateId() {
+  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+    const r = Math.random() * 16 | 0;
+    const v = c === "x" ? r : r & 3 | 8;
+    return v.toString(16);
+  });
+}
+function sagaBusMiddleware(options) {
+  const {
+    bus,
+    correlationIdHeader = "x-correlation-id",
+    generateCorrelationId = true,
+    correlationIdGenerator = generateId
+  } = options;
+  return async (c, next) => {
+    c.set("bus", bus);
+    let correlationId = c.req.header(correlationIdHeader);
+    if (!correlationId && generateCorrelationId) {
+      correlationId = correlationIdGenerator();
+    }
+    if (correlationId) {
+      c.set("correlationId", correlationId);
+      c.header(correlationIdHeader, correlationId);
+    }
+    await next();
+  };
+}
+function sagaErrorHandler() {
+  return (err, c) => {
+    if (err instanceof Error) {
+      if (err.name === "SagaTimeoutError") {
+        return c.json(
+          {
+            error: "Saga Timeout",
+            message: err.message,
+            correlationId: c.get("correlationId")
+          },
+          408
+        );
+      }
+      if (err.name === "ConcurrencyError") {
+        return c.json(
+          {
+            error: "Concurrency Conflict",
+            message: err.message,
+            correlationId: c.get("correlationId")
+          },
+          409
+        );
+      }
+    }
+    return c.json(
+      {
+        error: "Internal Server Error",
+        message: err instanceof Error ? err.message : "Unknown error",
+        correlationId: c.get("correlationId")
+      },
+      500
+    );
+  };
+}
+
+// src/health.ts
+function createHealthHandler(options) {
+  const { bus, checks = [] } = options;
+  return async (c) => {
+    const healthStatus = {
+      status: "healthy",
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      checks: {}
+    };
+    try {
+      if (bus) {
+        healthStatus.checks.bus = { status: "pass" };
+      } else {
+        throw new Error("Bus not available");
+      }
+    } catch (error) {
+      healthStatus.status = "unhealthy";
+      healthStatus.checks.bus = {
+        status: "fail",
+        message: error instanceof Error ? error.message : "Unknown error"
+      };
+    }
+    for (const check of checks) {
+      try {
+        const result = await check.check();
+        healthStatus.checks[check.name] = {
+          status: result ? "pass" : "fail"
+        };
+        if (!result) {
+          healthStatus.status = "unhealthy";
+        }
+      } catch (error) {
+        healthStatus.status = "unhealthy";
+        healthStatus.checks[check.name] = {
+          status: "fail",
+          message: error instanceof Error ? error.message : "Unknown error"
+        };
+      }
+    }
+    const statusCode = healthStatus.status === "healthy" ? 200 : 503;
+    return c.json(healthStatus, statusCode);
+  };
+}
+function createReadinessHandler(options) {
+  return createHealthHandler(options);
+}
+export {
+  createHealthHandler,
+  createReadinessHandler,
+  sagaBusMiddleware,
+  sagaErrorHandler
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/middleware.ts","../src/health.ts"],"sourcesContent":["import type { MiddlewareHandler, ErrorHandler } from \"hono\";\nimport type { SagaBusEnv, SagaBusHonoOptions } from \"./types.js\";\n\n// Simple UUID generator for edge compatibility (no crypto.randomUUID dependency)\nfunction generateId(): string {\n  return \"xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx\".replace(/[xy]/g, (c) => {\n    const r = (Math.random() * 16) | 0;\n    const v = c === \"x\" ? r : (r & 0x3) | 0x8;\n    return v.toString(16);\n  });\n}\n\n/**\n * Creates middleware that attaches the bus instance and correlation ID to context.\n */\nexport function sagaBusMiddleware(\n  options: SagaBusHonoOptions\n): MiddlewareHandler<SagaBusEnv> {\n  const {\n    bus,\n    correlationIdHeader = \"x-correlation-id\",\n    generateCorrelationId = true,\n    correlationIdGenerator = generateId,\n  } = options;\n\n  return async (c, next) => {\n    // Attach bus to context\n    c.set(\"bus\", bus);\n\n    // Extract or generate correlation ID\n    let correlationId = c.req.header(correlationIdHeader);\n\n    if (!correlationId && generateCorrelationId) {\n      correlationId = correlationIdGenerator();\n    }\n\n    if (correlationId) {\n      c.set(\"correlationId\", correlationId);\n      c.header(correlationIdHeader, correlationId);\n    }\n\n    await next();\n  };\n}\n\n/**\n * Error handler for saga-related errors.\n * Use with app.onError(sagaErrorHandler())\n */\nexport function sagaErrorHandler(): ErrorHandler<SagaBusEnv> {\n  return (err, c) => {\n    if (err instanceof Error) {\n      if (err.name === \"SagaTimeoutError\") {\n        return c.json(\n          {\n            error: \"Saga Timeout\",\n            message: err.message,\n            correlationId: c.get(\"correlationId\"),\n          },\n          408\n        );\n      }\n\n      if (err.name === \"ConcurrencyError\") {\n        return c.json(\n          {\n            error: \"Concurrency Conflict\",\n            message: err.message,\n            correlationId: c.get(\"correlationId\"),\n          },\n          409\n        );\n      }\n    }\n\n    // Return generic error for other cases\n    return c.json(\n      {\n        error: \"Internal Server Error\",\n        message: err instanceof Error ? err.message : \"Unknown error\",\n        correlationId: c.get(\"correlationId\"),\n      },\n      500\n    );\n  };\n}\n","import type { Context } from \"hono\";\nimport type { HealthCheckOptions, HealthStatus, SagaBusEnv } from \"./types.js\";\n\n/**\n * Creates a health check handler.\n */\nexport function createHealthHandler(options: HealthCheckOptions) {\n  const { bus, checks = [] } = options;\n\n  return async (c: Context<SagaBusEnv>) => {\n    const healthStatus: HealthStatus = {\n      status: \"healthy\",\n      timestamp: new Date().toISOString(),\n      checks: {},\n    };\n\n    // Check bus\n    try {\n      if (bus) {\n        healthStatus.checks.bus = { status: \"pass\" };\n      } else {\n        throw new Error(\"Bus not available\");\n      }\n    } catch (error) {\n      healthStatus.status = \"unhealthy\";\n      healthStatus.checks.bus = {\n        status: \"fail\",\n        message: error instanceof Error ? error.message : \"Unknown error\",\n      };\n    }\n\n    // Run additional checks\n    for (const check of checks) {\n      try {\n        const result = await check.check();\n        healthStatus.checks[check.name] = {\n          status: result ? \"pass\" : \"fail\",\n        };\n        if (!result) {\n          healthStatus.status = \"unhealthy\";\n        }\n      } catch (error) {\n        healthStatus.status = \"unhealthy\";\n        healthStatus.checks[check.name] = {\n          status: \"fail\",\n          message: error instanceof Error ? error.message : \"Unknown error\",\n        };\n      }\n    }\n\n    const statusCode = healthStatus.status === \"healthy\" ? 200 : 503;\n    return c.json(healthStatus, statusCode);\n  };\n}\n\n/**\n * Creates a readiness check handler (alias for health).\n */\nexport function createReadinessHandler(options: HealthCheckOptions) {\n  return createHealthHandler(options);\n}\n"],"mappings":";AAIA,SAAS,aAAqB;AAC5B,SAAO,uCAAuC,QAAQ,SAAS,CAAC,MAAM;AACpE,UAAM,IAAK,KAAK,OAAO,IAAI,KAAM;AACjC,UAAM,IAAI,MAAM,MAAM,IAAK,IAAI,IAAO;AACtC,WAAO,EAAE,SAAS,EAAE;AAAA,EACtB,CAAC;AACH;AAKO,SAAS,kBACd,SAC+B;AAC/B,QAAM;AAAA,IACJ;AAAA,IACA,sBAAsB;AAAA,IACtB,wBAAwB;AAAA,IACxB,yBAAyB;AAAA,EAC3B,IAAI;AAEJ,SAAO,OAAO,GAAG,SAAS;AAExB,MAAE,IAAI,OAAO,GAAG;AAGhB,QAAI,gBAAgB,EAAE,IAAI,OAAO,mBAAmB;AAEpD,QAAI,CAAC,iBAAiB,uBAAuB;AAC3C,sBAAgB,uBAAuB;AAAA,IACzC;AAEA,QAAI,eAAe;AACjB,QAAE,IAAI,iBAAiB,aAAa;AACpC,QAAE,OAAO,qBAAqB,aAAa;AAAA,IAC7C;AAEA,UAAM,KAAK;AAAA,EACb;AACF;AAMO,SAAS,mBAA6C;AAC3D,SAAO,CAAC,KAAK,MAAM;AACjB,QAAI,eAAe,OAAO;AACxB,UAAI,IAAI,SAAS,oBAAoB;AACnC,eAAO,EAAE;AAAA,UACP;AAAA,YACE,OAAO;AAAA,YACP,SAAS,IAAI;AAAA,YACb,eAAe,EAAE,IAAI,eAAe;AAAA,UACtC;AAAA,UACA;AAAA,QACF;AAAA,MACF;AAEA,UAAI,IAAI,SAAS,oBAAoB;AACnC,eAAO,EAAE;AAAA,UACP;AAAA,YACE,OAAO;AAAA,YACP,SAAS,IAAI;AAAA,YACb,eAAe,EAAE,IAAI,eAAe;AAAA,UACtC;AAAA,UACA;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAGA,WAAO,EAAE;AAAA,MACP;AAAA,QACE,OAAO;AAAA,QACP,SAAS,eAAe,QAAQ,IAAI,UAAU;AAAA,QAC9C,eAAe,EAAE,IAAI,eAAe;AAAA,MACtC;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACF;;;AC/EO,SAAS,oBAAoB,SAA6B;AAC/D,QAAM,EAAE,KAAK,SAAS,CAAC,EAAE,IAAI;AAE7B,SAAO,OAAO,MAA2B;AACvC,UAAM,eAA6B;AAAA,MACjC,QAAQ;AAAA,MACR,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,MAClC,QAAQ,CAAC;AAAA,IACX;AAGA,QAAI;AACF,UAAI,KAAK;AACP,qBAAa,OAAO,MAAM,EAAE,QAAQ,OAAO;AAAA,MAC7C,OAAO;AACL,cAAM,IAAI,MAAM,mBAAmB;AAAA,MACrC;AAAA,IACF,SAAS,OAAO;AACd,mBAAa,SAAS;AACtB,mBAAa,OAAO,MAAM;AAAA,QACxB,QAAQ;AAAA,QACR,SAAS,iBAAiB,QAAQ,MAAM,UAAU;AAAA,MACpD;AAAA,IACF;AAGA,eAAW,SAAS,QAAQ;AAC1B,UAAI;AACF,cAAM,SAAS,MAAM,MAAM,MAAM;AACjC,qBAAa,OAAO,MAAM,IAAI,IAAI;AAAA,UAChC,QAAQ,SAAS,SAAS;AAAA,QAC5B;AACA,YAAI,CAAC,QAAQ;AACX,uBAAa,SAAS;AAAA,QACxB;AAAA,MACF,SAAS,OAAO;AACd,qBAAa,SAAS;AACtB,qBAAa,OAAO,MAAM,IAAI,IAAI;AAAA,UAChC,QAAQ;AAAA,UACR,SAAS,iBAAiB,QAAQ,MAAM,UAAU;AAAA,QACpD;AAAA,MACF;AAAA,IACF;AAEA,UAAM,aAAa,aAAa,WAAW,YAAY,MAAM;AAC7D,WAAO,EAAE,KAAK,cAAc,UAAU;AAAA,EACxC;AACF;AAKO,SAAS,uBAAuB,SAA6B;AAClE,SAAO,oBAAoB,OAAO;AACpC;","names":[]}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@saga-bus/hono",
+  "version": "0.1.1",
+  "description": "Hono integration for saga-bus (edge runtime compatible)",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/d-e-a-n-f/saga-bus.git",
+    "directory": "packages/hono"
+  },
+  "bugs": {
+    "url": "https://github.com/d-e-a-n-f/saga-bus/issues"
+  },
+  "homepage": "https://github.com/d-e-a-n-f/saga-bus#readme",
+  "keywords": [
+    "saga",
+    "message-bus",
+    "hono",
+    "middleware",
+    "edge",
+    "cloudflare-workers",
+    "deno",
+    "bun"
+  ],
+  "dependencies": {
+    "@saga-bus/core": "0.1.1"
+  },
+  "devDependencies": {
+    "hono": "^4.6.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.9.2",
+    "vitest": "^3.0.0",
+    "@repo/eslint-config": "0.0.0",
+    "@repo/typescript-config": "0.0.0"
+  },
+  "peerDependencies": {
+    "@saga-bus/core": ">=0.1.1",
+    "hono": ">=4.0.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src/",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}