@stratum-hq/hono 0.1.0 → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Christian Crank
+
+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,59 @@
+# @stratum-hq/hono
+
+[Hono](https://hono.dev) middleware for [Stratum](https://github.com/stratum-hq/Stratum) — extracts tenant identity from a request and sets up AsyncLocalStorage context for downstream handlers.
+
+## Installation
+
+```bash
+npm install @stratum-hq/hono @stratum-hq/sdk @stratum-hq/core hono
+```
+
+## Quick Start
+
+```typescript
+import { Hono } from "hono";
+import { stratumMiddleware } from "@stratum-hq/hono";
+import { getTenantContext } from "@stratum-hq/sdk";
+
+const app = new Hono();
+
+app.use("*", stratumMiddleware({
+  header: "x-tenant-id",
+  // Optional: fetch the full tenant context (ancestry, config, permissions)
+  resolve: async (tenantId) => sdkClient.resolveTenant(tenantId),
+}));
+
+app.get("/users", (c) => {
+  const tenantId = c.get("tenantId");        // raw ID set by the middleware
+  const ctx = getTenantContext();             // full context via AsyncLocalStorage
+  return c.json({ tenantId, config: ctx.resolved_config });
+});
+```
+
+## Options
+
+`stratumMiddleware(options)` extracts the tenant ID from exactly one source, in this precedence:
+
+| Option | Behavior |
+|--------|----------|
+| `jwtClaim` | Read the claim from Hono's `jwtPayload` context variable |
+| `pathParam` | Read a URL path parameter (`c.req.param(name)`) |
+| `header` | Read a request header (default: `x-tenant-id`) |
+| `resolve` | Optional callback `(tenantId) => TenantContext` to populate ancestry, config, and permissions |
+
+If no tenant ID is found, the middleware responds with `400 { error: "Missing tenant ID" }`. Without a `resolve` callback the context is a placeholder (empty config/permissions) — provide `resolve` for real tenant data.
+
+## Features
+
+- Tenant extraction from header, JWT claim, or path parameter
+- Binds tenant context via `runWithTenantContext` so downstream handlers can call `getTenantContext()`
+- Lightweight — structural types only, no heavy dependencies
+
+## Links
+
+- Documentation: https://docs.stratum-hq.org/packages/hono/
+- GitHub: https://github.com/stratum-hq/Stratum
+
+## License
+
+MIT © Christian Crank

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stratum-hq/hono",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Stratum Hono integration — tenant extraction middleware with ALS context",
   "keywords": [
     "multi-tenancy",
@@ -37,8 +37,8 @@
     "registry": "https://registry.npmjs.org/"
   },
   "peerDependencies": {
-    "@stratum-hq/core": ">=0.2.0",
-    "@stratum-hq/sdk": ">=0.2.0",
+    "@stratum-hq/core": ">=0.3.0",
+    "@stratum-hq/sdk": ">=0.3.0",
     "hono": ">=4.0.0"
   },
   "devDependencies": {
@@ -47,5 +47,10 @@
     "hono": "^4.0.0",
     "typescript": "^5.4.0",
     "vitest": "^1.6.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/stratum-hq/Stratum.git",
+    "directory": "packages/hono"
   }
 }