@stratum-hq/hono 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { stratumMiddleware } from "./middleware.js";
+export type { StratumMiddlewareOptions } from "./middleware.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,YAAY,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { stratumMiddleware } from "./middleware.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/middleware.d.ts

@@ -0,0 +1,23 @@
+import type { MiddlewareHandler } from "hono";
+import type { TenantContextLegacy } from "@stratum-hq/core";
+export interface StratumMiddlewareOptions {
+    /** Header name to extract tenant ID from (default: 'x-tenant-id') */
+    header?: string;
+    /** JWT claim name to extract tenant ID from */
+    jwtClaim?: string;
+    /** URL path parameter name to extract tenant ID from */
+    pathParam?: string;
+    /**
+     * Optional callback to resolve a full tenant context from the tenant ID.
+     * When provided, the middleware will call this to obtain ancestry, config,
+     * and permissions instead of using placeholder values.
+     */
+    resolve?: (tenantId: string) => Promise<TenantContextLegacy> | TenantContextLegacy;
+}
+/**
+ * Hono middleware that extracts a tenant ID from the request and sets it
+ * in both the Hono context (`c.get('tenantId')`) and the SDK's
+ * AsyncLocalStorage context via `runWithTenantContext()`.
+ */
+export declare function stratumMiddleware(options?: StratumMiddlewareOptions): MiddlewareHandler;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAE7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAG5D,MAAM,WAAW,wBAAwB;IACvC,qEAAqE;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,mBAAmB,CAAC,GAAG,mBAAmB,CAAC;CACpF;AAkBD;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,GAAE,wBAA6B,GACrC,iBAAiB,CAqCnB"}

package/dist/middleware.js

@@ -0,0 +1,57 @@
+import { runWithTenantContext } from "@stratum-hq/sdk";
+import { IsolationStrategy } from "@stratum-hq/core";
+function extractFromHeader(c, header) {
+    return c.req.header(header) ?? undefined;
+}
+function extractFromJwtClaim(c, claim) {
+    // Hono's JWT middleware sets the payload on the context variable 'jwtPayload'
+    const payload = c.get("jwtPayload");
+    if (!payload)
+        return undefined;
+    const value = payload[claim];
+    return typeof value === "string" ? value : undefined;
+}
+function extractFromPathParam(c, param) {
+    return c.req.param(param) ?? undefined;
+}
+/**
+ * Hono middleware that extracts a tenant ID from the request and sets it
+ * in both the Hono context (`c.get('tenantId')`) and the SDK's
+ * AsyncLocalStorage context via `runWithTenantContext()`.
+ */
+export function stratumMiddleware(options = {}) {
+    return async (c, next) => {
+        let tenantId;
+        if (options.jwtClaim) {
+            tenantId = extractFromJwtClaim(c, options.jwtClaim);
+        }
+        else if (options.pathParam) {
+            tenantId = extractFromPathParam(c, options.pathParam);
+        }
+        else {
+            const header = options.header ?? "x-tenant-id";
+            tenantId = extractFromHeader(c, header);
+        }
+        if (!tenantId) {
+            return c.json({ error: "Missing tenant ID" }, 400);
+        }
+        c.set("tenantId", tenantId);
+        const ctx = options.resolve
+            ? await options.resolve(tenantId)
+            : /**
+               * @warning Placeholder context — ancestry_path, resolved_config, and
+               * resolved_permissions are stub values. Provide a `resolve` callback
+               * to populate real tenant data.
+               */
+                {
+                    tenant_id: tenantId,
+                    ancestry_path: tenantId,
+                    depth: 0,
+                    resolved_config: {},
+                    resolved_permissions: {},
+                    isolation_strategy: IsolationStrategy.SHARED_RLS,
+                };
+        return runWithTenantContext(ctx, () => next());
+    };
+}
+//# sourceMappingURL=middleware.js.map

package/dist/middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAiBrD,SAAS,iBAAiB,CAAC,CAAU,EAAE,MAAc;IACnD,OAAO,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC;AAC3C,CAAC;AAED,SAAS,mBAAmB,CAAC,CAAU,EAAE,KAAa;IACpD,8EAA8E;IAC9E,MAAM,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,YAAY,CAAwC,CAAC;IAC3E,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC7B,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACvD,CAAC;AAED,SAAS,oBAAoB,CAAC,CAAU,EAAE,KAAa;IACrD,OAAO,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC;AACzC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,UAAoC,EAAE;IAEtC,OAAO,KAAK,EAAE,CAAU,EAAE,IAAU,EAAE,EAAE;QACtC,IAAI,QAA4B,CAAC;QAEjC,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,QAAQ,GAAG,mBAAmB,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QACtD,CAAC;aAAM,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YAC7B,QAAQ,GAAG,oBAAoB,CAAC,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QACxD,CAAC;aAAM,CAAC;YACN,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,aAAa,CAAC;YAC/C,QAAQ,GAAG,iBAAiB,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAC1C,CAAC;QAED,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,mBAAmB,EAAE,EAAE,GAAG,CAAC,CAAC;QACrD,CAAC;QAED,CAAC,CAAC,GAAG,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;QAE5B,MAAM,GAAG,GAAwB,OAAO,CAAC,OAAO;YAC9C,CAAC,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC;YACjC,CAAC,CAAC;;;;iBAIG;gBACH;oBACE,SAAS,EAAE,QAAQ;oBACnB,aAAa,EAAE,QAAQ;oBACvB,KAAK,EAAE,CAAC;oBACR,eAAe,EAAE,EAAE;oBACnB,oBAAoB,EAAE,EAAE;oBACxB,kBAAkB,EAAE,iBAAiB,CAAC,UAAU;iBACjD,CAAC;QAEN,OAAO,oBAAoB,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@stratum-hq/hono",
+  "version": "0.1.0",
+  "description": "Stratum Hono integration — tenant extraction middleware with ALS context",
+  "keywords": [
+    "multi-tenancy",
+    "multi-tenant",
+    "saas",
+    "tenant",
+    "hono",
+    "middleware",
+    "typescript",
+    "stratum"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "lint": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "peerDependencies": {
+    "@stratum-hq/core": ">=0.2.0",
+    "@stratum-hq/sdk": ">=0.2.0",
+    "hono": ">=4.0.0"
+  },
+  "devDependencies": {
+    "@stratum-hq/core": "*",
+    "@stratum-hq/sdk": "*",
+    "hono": "^4.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.6.0"
+  }
+}