@saga-bus/middleware-tenant 1.0.0

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,119 @@
+# @saga-bus/middleware-tenant
+
+Multi-tenant isolation middleware for saga-bus.
+
+## Installation
+
+```bash
+pnpm add @saga-bus/middleware-tenant
+```
+
+## Usage
+
+```typescript
+import { createTenantMiddleware, getTenantId } from "@saga-bus/middleware-tenant";
+import { createBus } from "@saga-bus/core";
+
+const tenantMiddleware = createTenantMiddleware({
+  strategy: "header",
+  headerName: "x-tenant-id",
+  required: true,
+});
+
+const bus = createBus({
+  middleware: [tenantMiddleware],
+  sagas: [...],
+  transport,
+});
+
+// Access tenant in handlers
+const tenantId = getTenantId(); // from AsyncLocalStorage context
+```
+
+## Tenant Resolution Strategies
+
+### Header Strategy (default)
+Extracts tenant ID from message headers:
+
+```typescript
+createTenantMiddleware({
+  strategy: "header",
+  headerName: "x-tenant-id",
+});
+```
+
+### Correlation Prefix Strategy
+Extracts tenant ID from correlation ID prefix:
+
+```typescript
+createTenantMiddleware({
+  strategy: "correlation-prefix",
+  correlationSeparator: ":",
+});
+// correlationId "tenant123:order-456" → tenantId "tenant123"
+```
+
+### Custom Strategy
+Provide your own resolver function:
+
+```typescript
+createTenantMiddleware({
+  strategy: "custom",
+  resolver: (envelope) => envelope.payload?.tenantId,
+});
+```
+
+## Tenant-Aware Publishing
+
+```typescript
+import { createTenantPublisher } from "@saga-bus/middleware-tenant";
+
+const publish = createTenantPublisher(bus, {
+  headerName: "x-tenant-id",
+});
+
+// Automatically adds tenant header from context
+await publish({ type: "OrderCreated", payload: { orderId: "123" } });
+```
+
+## Configuration
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `strategy` | `string` | `"header"` | Resolution strategy |
+| `headerName` | `string` | `"x-tenant-id"` | Header name for header strategy |
+| `correlationSeparator` | `string` | `":"` | Separator for correlation prefix |
+| `resolver` | `function` | - | Custom resolver function |
+| `required` | `boolean` | `true` | Require tenant on all messages |
+| `defaultTenantId` | `string` | - | Default when not required |
+| `allowedTenants` | `string[]` | - | Allowlist of valid tenants |
+| `prefixSagaId` | `boolean` | `true` | Prefix saga IDs with tenant |
+
+## Context API
+
+```typescript
+import {
+  getTenantId,
+  getTenantInfo,
+  requireTenantId,
+  runWithTenant,
+} from "@saga-bus/middleware-tenant";
+
+// Get current tenant (undefined if not set)
+const tenantId = getTenantId();
+
+// Get full tenant info
+const info = getTenantInfo(); // { tenantId, originalSagaId }
+
+// Throw if no tenant
+const tenantId = requireTenantId();
+
+// Run code with explicit tenant context
+await runWithTenant("tenant-123", async () => {
+  // getTenantId() returns "tenant-123" here
+});
+```
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,158 @@
+"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, {
+  TenantNotAllowedError: () => TenantNotAllowedError,
+  TenantResolutionError: () => TenantResolutionError,
+  createTenantMiddleware: () => createTenantMiddleware,
+  createTenantPublisher: () => createTenantPublisher,
+  getTenantId: () => getTenantId,
+  getTenantInfo: () => getTenantInfo,
+  requireTenantId: () => requireTenantId,
+  runWithTenant: () => runWithTenant
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/types.ts
+var TenantResolutionError = class extends Error {
+  constructor(message, envelope) {
+    super(message);
+    this.envelope = envelope;
+    this.name = "TenantResolutionError";
+  }
+};
+var TenantNotAllowedError = class extends Error {
+  constructor(tenantId, envelope) {
+    super(`Tenant "${tenantId}" is not allowed`);
+    this.tenantId = tenantId;
+    this.envelope = envelope;
+    this.name = "TenantNotAllowedError";
+  }
+};
+
+// src/TenantContext.ts
+var import_node_async_hooks = require("async_hooks");
+var tenantStorage = new import_node_async_hooks.AsyncLocalStorage();
+function runWithTenant(tenantInfo, fn) {
+  return tenantStorage.run(tenantInfo, fn);
+}
+function getTenantId() {
+  return tenantStorage.getStore()?.tenantId;
+}
+function getTenantInfo() {
+  return tenantStorage.getStore();
+}
+function requireTenantId() {
+  const tenantId = getTenantId();
+  if (!tenantId) {
+    throw new Error("No tenant context available");
+  }
+  return tenantId;
+}
+
+// src/TenantMiddleware.ts
+function createTenantMiddleware(options = {}) {
+  const strategy = options.strategy ?? "header";
+  const headerName = options.headerName ?? "x-tenant-id";
+  const correlationSeparator = options.correlationSeparator ?? ":";
+  const required = options.required ?? true;
+  const defaultTenantId = options.defaultTenantId;
+  const allowedTenants = options.allowedTenants ? new Set(options.allowedTenants) : void 0;
+  const prefixSagaId = options.prefixSagaId ?? true;
+  const resolver = options.resolver ?? createResolver(strategy, {
+    headerName,
+    correlationSeparator
+  });
+  return async (ctx, next) => {
+    const { envelope } = ctx;
+    let tenantId = resolver(envelope);
+    if (!tenantId) {
+      if (required) {
+        throw new TenantResolutionError(
+          `Could not resolve tenant ID from message using strategy "${strategy}"`,
+          envelope
+        );
+      }
+      tenantId = defaultTenantId;
+    }
+    if (!tenantId) {
+      await next();
+      return;
+    }
+    if (allowedTenants && !allowedTenants.has(tenantId)) {
+      throw new TenantNotAllowedError(tenantId, envelope);
+    }
+    let originalSagaId;
+    if (prefixSagaId && ctx.sagaId) {
+      originalSagaId = ctx.sagaId;
+      ctx.sagaId = `${tenantId}:${ctx.sagaId}`;
+    }
+    await runWithTenant({ tenantId, originalSagaId }, async () => {
+      await next();
+    });
+  };
+}
+function createTenantPublisher(options = {}) {
+  const headerName = options.headerName ?? "x-tenant-id";
+  return (envelope, tenantId) => {
+    return {
+      ...envelope,
+      headers: {
+        ...envelope.headers,
+        [headerName]: tenantId
+      }
+    };
+  };
+}
+function createResolver(strategy, options) {
+  switch (strategy) {
+    case "header":
+      return (envelope) => {
+        return envelope.headers[options.headerName];
+      };
+    case "correlation-prefix":
+      return (envelope) => {
+        const partitionKey = envelope.partitionKey;
+        if (!partitionKey) {
+          return void 0;
+        }
+        const separatorIndex = partitionKey.indexOf(options.correlationSeparator);
+        if (separatorIndex === -1) {
+          return void 0;
+        }
+        return partitionKey.slice(0, separatorIndex);
+      };
+    case "custom":
+      throw new Error("Custom strategy requires a resolver function");
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  TenantNotAllowedError,
+  TenantResolutionError,
+  createTenantMiddleware,
+  createTenantPublisher,
+  getTenantId,
+  getTenantInfo,
+  requireTenantId,
+  runWithTenant
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/types.ts","../src/TenantContext.ts","../src/TenantMiddleware.ts"],"sourcesContent":["export {\n  createTenantMiddleware,\n  createTenantPublisher,\n} from \"./TenantMiddleware.js\";\nexport {\n  getTenantId,\n  getTenantInfo,\n  requireTenantId,\n  runWithTenant,\n} from \"./TenantContext.js\";\nexport type {\n  TenantMiddlewareOptions,\n  TenantResolver,\n  TenantInfo,\n} from \"./types.js\";\nexport { TenantResolutionError, TenantNotAllowedError } from \"./types.js\";\n","import type { MessageEnvelope } from \"@saga-bus/core\";\n\n/**\n * Tenant middleware configuration options.\n */\nexport interface TenantMiddlewareOptions {\n  /**\n   * Strategy for resolving tenant ID from messages.\n   * @default \"header\"\n   */\n  strategy?: \"header\" | \"correlation-prefix\" | \"custom\";\n\n  /**\n   * Custom tenant resolver function.\n   * Required when strategy is \"custom\".\n   */\n  resolver?: TenantResolver;\n\n  /**\n   * Header name for tenant ID when using \"header\" strategy.\n   * @default \"x-tenant-id\"\n   */\n  headerName?: string;\n\n  /**\n   * Separator for correlation prefix strategy.\n   * @default \":\"\n   */\n  correlationSeparator?: string;\n\n  /**\n   * Whether to require tenant ID on all messages.\n   * @default true\n   */\n  required?: boolean;\n\n  /**\n   * Default tenant ID when not required and not found.\n   */\n  defaultTenantId?: string;\n\n  /**\n   * Allowlist of valid tenant IDs.\n   * If provided, messages from unknown tenants are rejected.\n   */\n  allowedTenants?: string[];\n\n  /**\n   * Whether to prefix saga IDs with tenant ID for isolation.\n   * @default true\n   */\n  prefixSagaId?: boolean;\n}\n\n/**\n * Function to resolve tenant ID from a message.\n */\nexport type TenantResolver = (envelope: MessageEnvelope) => string | undefined;\n\n/**\n * Tenant context for the current request.\n */\nexport interface TenantInfo {\n  /**\n   * Resolved tenant ID.\n   */\n  tenantId: string;\n\n  /**\n   * Original saga ID before tenant prefix.\n   */\n  originalSagaId?: string;\n}\n\n/**\n * Error thrown when tenant resolution fails.\n */\nexport class TenantResolutionError extends Error {\n  constructor(\n    message: string,\n    public readonly envelope: MessageEnvelope\n  ) {\n    super(message);\n    this.name = \"TenantResolutionError\";\n  }\n}\n\n/**\n * Error thrown when tenant is not in allowlist.\n */\nexport class TenantNotAllowedError extends Error {\n  constructor(\n    public readonly tenantId: string,\n    public readonly envelope: MessageEnvelope\n  ) {\n    super(`Tenant \"${tenantId}\" is not allowed`);\n    this.name = \"TenantNotAllowedError\";\n  }\n}\n","import { AsyncLocalStorage } from \"node:async_hooks\";\nimport type { TenantInfo } from \"./types.js\";\n\nconst tenantStorage = new AsyncLocalStorage<TenantInfo>();\n\n/**\n * Run a function within a tenant context.\n */\nexport function runWithTenant<T>(\n  tenantInfo: TenantInfo,\n  fn: () => T | Promise<T>\n): T | Promise<T> {\n  return tenantStorage.run(tenantInfo, fn);\n}\n\n/**\n * Get the current tenant ID.\n * Returns undefined if not in a tenant context.\n */\nexport function getTenantId(): string | undefined {\n  return tenantStorage.getStore()?.tenantId;\n}\n\n/**\n * Get the full tenant info for the current context.\n */\nexport function getTenantInfo(): TenantInfo | undefined {\n  return tenantStorage.getStore();\n}\n\n/**\n * Get the current tenant ID or throw if not available.\n */\nexport function requireTenantId(): string {\n  const tenantId = getTenantId();\n  if (!tenantId) {\n    throw new Error(\"No tenant context available\");\n  }\n  return tenantId;\n}\n","import type {\n  SagaMiddleware,\n  SagaPipelineContext,\n  MessageEnvelope,\n} from \"@saga-bus/core\";\nimport type { TenantMiddlewareOptions, TenantResolver } from \"./types.js\";\nimport { TenantResolutionError, TenantNotAllowedError } from \"./types.js\";\nimport { runWithTenant } from \"./TenantContext.js\";\n\n/**\n * Create multi-tenant middleware for saga-bus.\n *\n * Resolves tenant ID from messages and provides tenant context\n * via AsyncLocalStorage for use within handlers.\n *\n * @example\n * ```typescript\n * const middleware = createTenantMiddleware({\n *   strategy: \"header\",\n *   headerName: \"x-tenant-id\",\n *   allowedTenants: [\"tenant1\", \"tenant2\"],\n * });\n *\n * const bus = createMessageBus({\n *   middleware: [middleware],\n * });\n * ```\n */\nexport function createTenantMiddleware(\n  options: TenantMiddlewareOptions = {}\n): SagaMiddleware {\n  const strategy = options.strategy ?? \"header\";\n  const headerName = options.headerName ?? \"x-tenant-id\";\n  const correlationSeparator = options.correlationSeparator ?? \":\";\n  const required = options.required ?? true;\n  const defaultTenantId = options.defaultTenantId;\n  const allowedTenants = options.allowedTenants\n    ? new Set(options.allowedTenants)\n    : undefined;\n  const prefixSagaId = options.prefixSagaId ?? true;\n\n  const resolver =\n    options.resolver ??\n    createResolver(strategy, {\n      headerName,\n      correlationSeparator,\n    });\n\n  return async (ctx: SagaPipelineContext, next: () => Promise<void>) => {\n    const { envelope } = ctx;\n\n    // Resolve tenant ID\n    let tenantId = resolver(envelope);\n\n    if (!tenantId) {\n      if (required) {\n        throw new TenantResolutionError(\n          `Could not resolve tenant ID from message using strategy \"${strategy}\"`,\n          envelope\n        );\n      }\n      tenantId = defaultTenantId;\n    }\n\n    if (!tenantId) {\n      // No tenant and not required - proceed without tenant context\n      await next();\n      return;\n    }\n\n    // Validate against allowlist\n    if (allowedTenants && !allowedTenants.has(tenantId)) {\n      throw new TenantNotAllowedError(tenantId, envelope);\n    }\n\n    // Modify saga ID if needed\n    let originalSagaId: string | undefined;\n    if (prefixSagaId && ctx.sagaId) {\n      originalSagaId = ctx.sagaId;\n      ctx.sagaId = `${tenantId}:${ctx.sagaId}`;\n    }\n\n    // Run handler within tenant context\n    await runWithTenant({ tenantId, originalSagaId }, async () => {\n      await next();\n    });\n  };\n}\n\n/**\n * Create a publish interceptor that adds tenant ID to outbound messages.\n *\n * @example\n * ```typescript\n * const publisher = createTenantPublisher();\n * const envelope = publisher(originalEnvelope, \"tenant1\");\n * ```\n */\nexport function createTenantPublisher(\n  options: Pick<TenantMiddlewareOptions, \"headerName\"> = {}\n): (envelope: MessageEnvelope, tenantId: string) => MessageEnvelope {\n  const headerName = options.headerName ?? \"x-tenant-id\";\n\n  return (envelope: MessageEnvelope, tenantId: string): MessageEnvelope => {\n    return {\n      ...envelope,\n      headers: {\n        ...envelope.headers,\n        [headerName]: tenantId,\n      },\n    };\n  };\n}\n\nfunction createResolver(\n  strategy: \"header\" | \"correlation-prefix\" | \"custom\",\n  options: {\n    headerName: string;\n    correlationSeparator: string;\n  }\n): TenantResolver {\n  switch (strategy) {\n    case \"header\":\n      return (envelope: MessageEnvelope) => {\n        return envelope.headers[options.headerName];\n      };\n\n    case \"correlation-prefix\":\n      return (envelope: MessageEnvelope) => {\n        const partitionKey = envelope.partitionKey;\n        if (!partitionKey) {\n          return undefined;\n        }\n        const separatorIndex = partitionKey.indexOf(options.correlationSeparator);\n        if (separatorIndex === -1) {\n          return undefined;\n        }\n        return partitionKey.slice(0, separatorIndex);\n      };\n\n    case \"custom\":\n      throw new Error(\"Custom strategy requires a resolver function\");\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,129 @@
+import { MessageEnvelope, SagaMiddleware } from '@saga-bus/core';
+
+/**
+ * Tenant middleware configuration options.
+ */
+interface TenantMiddlewareOptions {
+    /**
+     * Strategy for resolving tenant ID from messages.
+     * @default "header"
+     */
+    strategy?: "header" | "correlation-prefix" | "custom";
+    /**
+     * Custom tenant resolver function.
+     * Required when strategy is "custom".
+     */
+    resolver?: TenantResolver;
+    /**
+     * Header name for tenant ID when using "header" strategy.
+     * @default "x-tenant-id"
+     */
+    headerName?: string;
+    /**
+     * Separator for correlation prefix strategy.
+     * @default ":"
+     */
+    correlationSeparator?: string;
+    /**
+     * Whether to require tenant ID on all messages.
+     * @default true
+     */
+    required?: boolean;
+    /**
+     * Default tenant ID when not required and not found.
+     */
+    defaultTenantId?: string;
+    /**
+     * Allowlist of valid tenant IDs.
+     * If provided, messages from unknown tenants are rejected.
+     */
+    allowedTenants?: string[];
+    /**
+     * Whether to prefix saga IDs with tenant ID for isolation.
+     * @default true
+     */
+    prefixSagaId?: boolean;
+}
+/**
+ * Function to resolve tenant ID from a message.
+ */
+type TenantResolver = (envelope: MessageEnvelope) => string | undefined;
+/**
+ * Tenant context for the current request.
+ */
+interface TenantInfo {
+    /**
+     * Resolved tenant ID.
+     */
+    tenantId: string;
+    /**
+     * Original saga ID before tenant prefix.
+     */
+    originalSagaId?: string;
+}
+/**
+ * Error thrown when tenant resolution fails.
+ */
+declare class TenantResolutionError extends Error {
+    readonly envelope: MessageEnvelope;
+    constructor(message: string, envelope: MessageEnvelope);
+}
+/**
+ * Error thrown when tenant is not in allowlist.
+ */
+declare class TenantNotAllowedError extends Error {
+    readonly tenantId: string;
+    readonly envelope: MessageEnvelope;
+    constructor(tenantId: string, envelope: MessageEnvelope);
+}
+
+/**
+ * Create multi-tenant middleware for saga-bus.
+ *
+ * Resolves tenant ID from messages and provides tenant context
+ * via AsyncLocalStorage for use within handlers.
+ *
+ * @example
+ * ```typescript
+ * const middleware = createTenantMiddleware({
+ *   strategy: "header",
+ *   headerName: "x-tenant-id",
+ *   allowedTenants: ["tenant1", "tenant2"],
+ * });
+ *
+ * const bus = createMessageBus({
+ *   middleware: [middleware],
+ * });
+ * ```
+ */
+declare function createTenantMiddleware(options?: TenantMiddlewareOptions): SagaMiddleware;
+/**
+ * Create a publish interceptor that adds tenant ID to outbound messages.
+ *
+ * @example
+ * ```typescript
+ * const publisher = createTenantPublisher();
+ * const envelope = publisher(originalEnvelope, "tenant1");
+ * ```
+ */
+declare function createTenantPublisher(options?: Pick<TenantMiddlewareOptions, "headerName">): (envelope: MessageEnvelope, tenantId: string) => MessageEnvelope;
+
+/**
+ * Run a function within a tenant context.
+ */
+declare function runWithTenant<T>(tenantInfo: TenantInfo, fn: () => T | Promise<T>): T | Promise<T>;
+/**
+ * Get the current tenant ID.
+ * Returns undefined if not in a tenant context.
+ */
+declare function getTenantId(): string | undefined;
+/**
+ * Get the full tenant info for the current context.
+ */
+declare function getTenantInfo(): TenantInfo | undefined;
+/**
+ * Get the current tenant ID or throw if not available.
+ */
+declare function requireTenantId(): string;
+
+export { type TenantInfo, type TenantMiddlewareOptions, TenantNotAllowedError, TenantResolutionError, type TenantResolver, createTenantMiddleware, createTenantPublisher, getTenantId, getTenantInfo, requireTenantId, runWithTenant };

package/dist/index.d.ts

@@ -0,0 +1,129 @@
+import { MessageEnvelope, SagaMiddleware } from '@saga-bus/core';
+
+/**
+ * Tenant middleware configuration options.
+ */
+interface TenantMiddlewareOptions {
+    /**
+     * Strategy for resolving tenant ID from messages.
+     * @default "header"
+     */
+    strategy?: "header" | "correlation-prefix" | "custom";
+    /**
+     * Custom tenant resolver function.
+     * Required when strategy is "custom".
+     */
+    resolver?: TenantResolver;
+    /**
+     * Header name for tenant ID when using "header" strategy.
+     * @default "x-tenant-id"
+     */
+    headerName?: string;
+    /**
+     * Separator for correlation prefix strategy.
+     * @default ":"
+     */
+    correlationSeparator?: string;
+    /**
+     * Whether to require tenant ID on all messages.
+     * @default true
+     */
+    required?: boolean;
+    /**
+     * Default tenant ID when not required and not found.
+     */
+    defaultTenantId?: string;
+    /**
+     * Allowlist of valid tenant IDs.
+     * If provided, messages from unknown tenants are rejected.
+     */
+    allowedTenants?: string[];
+    /**
+     * Whether to prefix saga IDs with tenant ID for isolation.
+     * @default true
+     */
+    prefixSagaId?: boolean;
+}
+/**
+ * Function to resolve tenant ID from a message.
+ */
+type TenantResolver = (envelope: MessageEnvelope) => string | undefined;
+/**
+ * Tenant context for the current request.
+ */
+interface TenantInfo {
+    /**
+     * Resolved tenant ID.
+     */
+    tenantId: string;
+    /**
+     * Original saga ID before tenant prefix.
+     */
+    originalSagaId?: string;
+}
+/**
+ * Error thrown when tenant resolution fails.
+ */
+declare class TenantResolutionError extends Error {
+    readonly envelope: MessageEnvelope;
+    constructor(message: string, envelope: MessageEnvelope);
+}
+/**
+ * Error thrown when tenant is not in allowlist.
+ */
+declare class TenantNotAllowedError extends Error {
+    readonly tenantId: string;
+    readonly envelope: MessageEnvelope;
+    constructor(tenantId: string, envelope: MessageEnvelope);
+}
+
+/**
+ * Create multi-tenant middleware for saga-bus.
+ *
+ * Resolves tenant ID from messages and provides tenant context
+ * via AsyncLocalStorage for use within handlers.
+ *
+ * @example
+ * ```typescript
+ * const middleware = createTenantMiddleware({
+ *   strategy: "header",
+ *   headerName: "x-tenant-id",
+ *   allowedTenants: ["tenant1", "tenant2"],
+ * });
+ *
+ * const bus = createMessageBus({
+ *   middleware: [middleware],
+ * });
+ * ```
+ */
+declare function createTenantMiddleware(options?: TenantMiddlewareOptions): SagaMiddleware;
+/**
+ * Create a publish interceptor that adds tenant ID to outbound messages.
+ *
+ * @example
+ * ```typescript
+ * const publisher = createTenantPublisher();
+ * const envelope = publisher(originalEnvelope, "tenant1");
+ * ```
+ */
+declare function createTenantPublisher(options?: Pick<TenantMiddlewareOptions, "headerName">): (envelope: MessageEnvelope, tenantId: string) => MessageEnvelope;
+
+/**
+ * Run a function within a tenant context.
+ */
+declare function runWithTenant<T>(tenantInfo: TenantInfo, fn: () => T | Promise<T>): T | Promise<T>;
+/**
+ * Get the current tenant ID.
+ * Returns undefined if not in a tenant context.
+ */
+declare function getTenantId(): string | undefined;
+/**
+ * Get the full tenant info for the current context.
+ */
+declare function getTenantInfo(): TenantInfo | undefined;
+/**
+ * Get the current tenant ID or throw if not available.
+ */
+declare function requireTenantId(): string;
+
+export { type TenantInfo, type TenantMiddlewareOptions, TenantNotAllowedError, TenantResolutionError, type TenantResolver, createTenantMiddleware, createTenantPublisher, getTenantId, getTenantInfo, requireTenantId, runWithTenant };

package/dist/index.js

@@ -0,0 +1,124 @@
+// src/types.ts
+var TenantResolutionError = class extends Error {
+  constructor(message, envelope) {
+    super(message);
+    this.envelope = envelope;
+    this.name = "TenantResolutionError";
+  }
+};
+var TenantNotAllowedError = class extends Error {
+  constructor(tenantId, envelope) {
+    super(`Tenant "${tenantId}" is not allowed`);
+    this.tenantId = tenantId;
+    this.envelope = envelope;
+    this.name = "TenantNotAllowedError";
+  }
+};
+
+// src/TenantContext.ts
+import { AsyncLocalStorage } from "async_hooks";
+var tenantStorage = new AsyncLocalStorage();
+function runWithTenant(tenantInfo, fn) {
+  return tenantStorage.run(tenantInfo, fn);
+}
+function getTenantId() {
+  return tenantStorage.getStore()?.tenantId;
+}
+function getTenantInfo() {
+  return tenantStorage.getStore();
+}
+function requireTenantId() {
+  const tenantId = getTenantId();
+  if (!tenantId) {
+    throw new Error("No tenant context available");
+  }
+  return tenantId;
+}
+
+// src/TenantMiddleware.ts
+function createTenantMiddleware(options = {}) {
+  const strategy = options.strategy ?? "header";
+  const headerName = options.headerName ?? "x-tenant-id";
+  const correlationSeparator = options.correlationSeparator ?? ":";
+  const required = options.required ?? true;
+  const defaultTenantId = options.defaultTenantId;
+  const allowedTenants = options.allowedTenants ? new Set(options.allowedTenants) : void 0;
+  const prefixSagaId = options.prefixSagaId ?? true;
+  const resolver = options.resolver ?? createResolver(strategy, {
+    headerName,
+    correlationSeparator
+  });
+  return async (ctx, next) => {
+    const { envelope } = ctx;
+    let tenantId = resolver(envelope);
+    if (!tenantId) {
+      if (required) {
+        throw new TenantResolutionError(
+          `Could not resolve tenant ID from message using strategy "${strategy}"`,
+          envelope
+        );
+      }
+      tenantId = defaultTenantId;
+    }
+    if (!tenantId) {
+      await next();
+      return;
+    }
+    if (allowedTenants && !allowedTenants.has(tenantId)) {
+      throw new TenantNotAllowedError(tenantId, envelope);
+    }
+    let originalSagaId;
+    if (prefixSagaId && ctx.sagaId) {
+      originalSagaId = ctx.sagaId;
+      ctx.sagaId = `${tenantId}:${ctx.sagaId}`;
+    }
+    await runWithTenant({ tenantId, originalSagaId }, async () => {
+      await next();
+    });
+  };
+}
+function createTenantPublisher(options = {}) {
+  const headerName = options.headerName ?? "x-tenant-id";
+  return (envelope, tenantId) => {
+    return {
+      ...envelope,
+      headers: {
+        ...envelope.headers,
+        [headerName]: tenantId
+      }
+    };
+  };
+}
+function createResolver(strategy, options) {
+  switch (strategy) {
+    case "header":
+      return (envelope) => {
+        return envelope.headers[options.headerName];
+      };
+    case "correlation-prefix":
+      return (envelope) => {
+        const partitionKey = envelope.partitionKey;
+        if (!partitionKey) {
+          return void 0;
+        }
+        const separatorIndex = partitionKey.indexOf(options.correlationSeparator);
+        if (separatorIndex === -1) {
+          return void 0;
+        }
+        return partitionKey.slice(0, separatorIndex);
+      };
+    case "custom":
+      throw new Error("Custom strategy requires a resolver function");
+  }
+}
+export {
+  TenantNotAllowedError,
+  TenantResolutionError,
+  createTenantMiddleware,
+  createTenantPublisher,
+  getTenantId,
+  getTenantInfo,
+  requireTenantId,
+  runWithTenant
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/TenantContext.ts","../src/TenantMiddleware.ts"],"sourcesContent":["import type { MessageEnvelope } from \"@saga-bus/core\";\n\n/**\n * Tenant middleware configuration options.\n */\nexport interface TenantMiddlewareOptions {\n  /**\n   * Strategy for resolving tenant ID from messages.\n   * @default \"header\"\n   */\n  strategy?: \"header\" | \"correlation-prefix\" | \"custom\";\n\n  /**\n   * Custom tenant resolver function.\n   * Required when strategy is \"custom\".\n   */\n  resolver?: TenantResolver;\n\n  /**\n   * Header name for tenant ID when using \"header\" strategy.\n   * @default \"x-tenant-id\"\n   */\n  headerName?: string;\n\n  /**\n   * Separator for correlation prefix strategy.\n   * @default \":\"\n   */\n  correlationSeparator?: string;\n\n  /**\n   * Whether to require tenant ID on all messages.\n   * @default true\n   */\n  required?: boolean;\n\n  /**\n   * Default tenant ID when not required and not found.\n   */\n  defaultTenantId?: string;\n\n  /**\n   * Allowlist of valid tenant IDs.\n   * If provided, messages from unknown tenants are rejected.\n   */\n  allowedTenants?: string[];\n\n  /**\n   * Whether to prefix saga IDs with tenant ID for isolation.\n   * @default true\n   */\n  prefixSagaId?: boolean;\n}\n\n/**\n * Function to resolve tenant ID from a message.\n */\nexport type TenantResolver = (envelope: MessageEnvelope) => string | undefined;\n\n/**\n * Tenant context for the current request.\n */\nexport interface TenantInfo {\n  /**\n   * Resolved tenant ID.\n   */\n  tenantId: string;\n\n  /**\n   * Original saga ID before tenant prefix.\n   */\n  originalSagaId?: string;\n}\n\n/**\n * Error thrown when tenant resolution fails.\n */\nexport class TenantResolutionError extends Error {\n  constructor(\n    message: string,\n    public readonly envelope: MessageEnvelope\n  ) {\n    super(message);\n    this.name = \"TenantResolutionError\";\n  }\n}\n\n/**\n * Error thrown when tenant is not in allowlist.\n */\nexport class TenantNotAllowedError extends Error {\n  constructor(\n    public readonly tenantId: string,\n    public readonly envelope: MessageEnvelope\n  ) {\n    super(`Tenant \"${tenantId}\" is not allowed`);\n    this.name = \"TenantNotAllowedError\";\n  }\n}\n","import { AsyncLocalStorage } from \"node:async_hooks\";\nimport type { TenantInfo } from \"./types.js\";\n\nconst tenantStorage = new AsyncLocalStorage<TenantInfo>();\n\n/**\n * Run a function within a tenant context.\n */\nexport function runWithTenant<T>(\n  tenantInfo: TenantInfo,\n  fn: () => T | Promise<T>\n): T | Promise<T> {\n  return tenantStorage.run(tenantInfo, fn);\n}\n\n/**\n * Get the current tenant ID.\n * Returns undefined if not in a tenant context.\n */\nexport function getTenantId(): string | undefined {\n  return tenantStorage.getStore()?.tenantId;\n}\n\n/**\n * Get the full tenant info for the current context.\n */\nexport function getTenantInfo(): TenantInfo | undefined {\n  return tenantStorage.getStore();\n}\n\n/**\n * Get the current tenant ID or throw if not available.\n */\nexport function requireTenantId(): string {\n  const tenantId = getTenantId();\n  if (!tenantId) {\n    throw new Error(\"No tenant context available\");\n  }\n  return tenantId;\n}\n","import type {\n  SagaMiddleware,\n  SagaPipelineContext,\n  MessageEnvelope,\n} from \"@saga-bus/core\";\nimport type { TenantMiddlewareOptions, TenantResolver } from \"./types.js\";\nimport { TenantResolutionError, TenantNotAllowedError } from \"./types.js\";\nimport { runWithTenant } from \"./TenantContext.js\";\n\n/**\n * Create multi-tenant middleware for saga-bus.\n *\n * Resolves tenant ID from messages and provides tenant context\n * via AsyncLocalStorage for use within handlers.\n *\n * @example\n * ```typescript\n * const middleware = createTenantMiddleware({\n *   strategy: \"header\",\n *   headerName: \"x-tenant-id\",\n *   allowedTenants: [\"tenant1\", \"tenant2\"],\n * });\n *\n * const bus = createMessageBus({\n *   middleware: [middleware],\n * });\n * ```\n */\nexport function createTenantMiddleware(\n  options: TenantMiddlewareOptions = {}\n): SagaMiddleware {\n  const strategy = options.strategy ?? \"header\";\n  const headerName = options.headerName ?? \"x-tenant-id\";\n  const correlationSeparator = options.correlationSeparator ?? \":\";\n  const required = options.required ?? true;\n  const defaultTenantId = options.defaultTenantId;\n  const allowedTenants = options.allowedTenants\n    ? new Set(options.allowedTenants)\n    : undefined;\n  const prefixSagaId = options.prefixSagaId ?? true;\n\n  const resolver =\n    options.resolver ??\n    createResolver(strategy, {\n      headerName,\n      correlationSeparator,\n    });\n\n  return async (ctx: SagaPipelineContext, next: () => Promise<void>) => {\n    const { envelope } = ctx;\n\n    // Resolve tenant ID\n    let tenantId = resolver(envelope);\n\n    if (!tenantId) {\n      if (required) {\n        throw new TenantResolutionError(\n          `Could not resolve tenant ID from message using strategy \"${strategy}\"`,\n          envelope\n        );\n      }\n      tenantId = defaultTenantId;\n    }\n\n    if (!tenantId) {\n      // No tenant and not required - proceed without tenant context\n      await next();\n      return;\n    }\n\n    // Validate against allowlist\n    if (allowedTenants && !allowedTenants.has(tenantId)) {\n      throw new TenantNotAllowedError(tenantId, envelope);\n    }\n\n    // Modify saga ID if needed\n    let originalSagaId: string | undefined;\n    if (prefixSagaId && ctx.sagaId) {\n      originalSagaId = ctx.sagaId;\n      ctx.sagaId = `${tenantId}:${ctx.sagaId}`;\n    }\n\n    // Run handler within tenant context\n    await runWithTenant({ tenantId, originalSagaId }, async () => {\n      await next();\n    });\n  };\n}\n\n/**\n * Create a publish interceptor that adds tenant ID to outbound messages.\n *\n * @example\n * ```typescript\n * const publisher = createTenantPublisher();\n * const envelope = publisher(originalEnvelope, \"tenant1\");\n * ```\n */\nexport function createTenantPublisher(\n  options: Pick<TenantMiddlewareOptions, \"headerName\"> = {}\n): (envelope: MessageEnvelope, tenantId: string) => MessageEnvelope {\n  const headerName = options.headerName ?? \"x-tenant-id\";\n\n  return (envelope: MessageEnvelope, tenantId: string): MessageEnvelope => {\n    return {\n      ...envelope,\n      headers: {\n        ...envelope.headers,\n        [headerName]: tenantId,\n      },\n    };\n  };\n}\n\nfunction createResolver(\n  strategy: \"header\" | \"correlation-prefix\" | \"custom\",\n  options: {\n    headerName: string;\n    correlationSeparator: string;\n  }\n): TenantResolver {\n  switch (strategy) {\n    case \"header\":\n      return (envelope: MessageEnvelope) => {\n        return envelope.headers[options.headerName];\n      };\n\n    case \"correlation-prefix\":\n      return (envelope: MessageEnvelope) => {\n        const partitionKey = envelope.partitionKey;\n        if (!partitionKey) {\n          return undefined;\n        }\n        const separatorIndex = partitionKey.indexOf(options.correlationSeparator);\n        if (separatorIndex === -1) {\n          return undefined;\n        }\n        return partitionKey.slice(0, separatorIndex);\n      };\n\n    case \"custom\":\n      throw new Error(\"Custom strategy requires a resolver function\");\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@saga-bus/middleware-tenant",
+  "version": "1.0.0",
+  "description": "Multi-tenant middleware for saga-bus",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "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/deanforan/saga-bus.git",
+    "directory": "packages/middleware-tenant"
+  },
+  "keywords": [
+    "saga",
+    "message-bus",
+    "middleware",
+    "multi-tenant",
+    "tenant"
+  ],
+  "dependencies": {
+    "@saga-bus/core": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.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.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src/",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}