@usebetterdev/tenant-express 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 usebetter
+
+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,3 @@
+# @better-tenant/express
+
+Express middleware helpers for Better Tenant.

package/dist/index.cjs

@@ -0,0 +1,55 @@
+"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, {
+  createExpressMiddleware: () => createExpressMiddleware
+});
+module.exports = __toCommonJS(index_exports);
+var import_tenant_core = require("@usebetterdev/tenant-core");
+function createExpressMiddleware(tenant, options = {}) {
+  const missingTenantStatus = options.missingTenantStatus ?? 404;
+  return async (request, response, next) => {
+    try {
+      await tenant.handleRequest(
+        (0, import_tenant_core.toResolvableRequest)(request),
+        async () => {
+          next();
+        },
+        {
+          onMissingTenant: async () => {
+            if (options.onMissingTenant) {
+              await options.onMissingTenant(request, response);
+              return;
+            }
+            response.status(missingTenantStatus).json({ error: "Tenant not found" });
+          }
+        }
+      );
+    } catch (error) {
+      next(error);
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createExpressMiddleware
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { toResolvableRequest } from \"@usebetterdev/tenant-core\";\nimport type {\n  BetterTenantInstance,\n  NodeLikeRequest,\n  ResolvableRequest,\n  TenantContext,\n  TenantScopedDatabase,\n} from \"@usebetterdev/tenant-core\";\n\nexport interface ExpressRequestLike extends NodeLikeRequest {\n  headers: Record<string, string | string[] | number | undefined>;\n  originalUrl?: string;\n  hostname?: string;\n}\n\nexport interface ExpressResponseLike {\n  status: (code: number) => ExpressResponseLike;\n  json: (body: unknown) => unknown;\n}\n\nexport type ExpressNextFunction = (error?: unknown) => void;\n\nexport interface CreateExpressMiddlewareOptions {\n  missingTenantStatus?: 401 | 404;\n  onMissingTenant?: (\n    request: ExpressRequestLike,\n    response: ExpressResponseLike,\n  ) => void | Promise<void>;\n}\n\nexport interface ExpressTenantLike extends Pick<BetterTenantInstance, \"handleRequest\"> {}\n\nexport type ExpressMiddleware = (\n  request: ExpressRequestLike,\n  response: ExpressResponseLike,\n  next: ExpressNextFunction,\n) => Promise<void>;\n\nexport function createExpressMiddleware(\n  tenant: ExpressTenantLike,\n  options: CreateExpressMiddlewareOptions = {},\n): ExpressMiddleware {\n  const missingTenantStatus = options.missingTenantStatus ?? 404;\n\n  return async (request, response, next) => {\n    try {\n      await tenant.handleRequest<ResolvableRequest, void>(\n        toResolvableRequest(request),\n        async () => {\n          next();\n        },\n        {\n          onMissingTenant: async () => {\n            if (options.onMissingTenant) {\n              await options.onMissingTenant(request, response);\n              return;\n            }\n            response.status(missingTenantStatus).json({ error: \"Tenant not found\" });\n          },\n        },\n      );\n    } catch (error) {\n      next(error);\n    }\n  };\n}\n\nexport type { TenantContext, TenantScopedDatabase };\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,yBAAoC;AAsC7B,SAAS,wBACd,QACA,UAA0C,CAAC,GACxB;AACnB,QAAM,sBAAsB,QAAQ,uBAAuB;AAE3D,SAAO,OAAO,SAAS,UAAU,SAAS;AACxC,QAAI;AACF,YAAM,OAAO;AAAA,YACX,wCAAoB,OAAO;AAAA,QAC3B,YAAY;AACV,eAAK;AAAA,QACP;AAAA,QACA;AAAA,UACE,iBAAiB,YAAY;AAC3B,gBAAI,QAAQ,iBAAiB;AAC3B,oBAAM,QAAQ,gBAAgB,SAAS,QAAQ;AAC/C;AAAA,YACF;AACA,qBAAS,OAAO,mBAAmB,EAAE,KAAK,EAAE,OAAO,mBAAmB,CAAC;AAAA,UACzE;AAAA,QACF;AAAA,MACF;AAAA,IACF,SAAS,OAAO;AACd,WAAK,KAAK;AAAA,IACZ;AAAA,EACF;AACF;","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,23 @@
+import { NodeLikeRequest, BetterTenantInstance } from '@usebetterdev/tenant-core';
+export { TenantContext, TenantScopedDatabase } from '@usebetterdev/tenant-core';
+
+interface ExpressRequestLike extends NodeLikeRequest {
+    headers: Record<string, string | string[] | number | undefined>;
+    originalUrl?: string;
+    hostname?: string;
+}
+interface ExpressResponseLike {
+    status: (code: number) => ExpressResponseLike;
+    json: (body: unknown) => unknown;
+}
+type ExpressNextFunction = (error?: unknown) => void;
+interface CreateExpressMiddlewareOptions {
+    missingTenantStatus?: 401 | 404;
+    onMissingTenant?: (request: ExpressRequestLike, response: ExpressResponseLike) => void | Promise<void>;
+}
+interface ExpressTenantLike extends Pick<BetterTenantInstance, "handleRequest"> {
+}
+type ExpressMiddleware = (request: ExpressRequestLike, response: ExpressResponseLike, next: ExpressNextFunction) => Promise<void>;
+declare function createExpressMiddleware(tenant: ExpressTenantLike, options?: CreateExpressMiddlewareOptions): ExpressMiddleware;
+
+export { type CreateExpressMiddlewareOptions, type ExpressMiddleware, type ExpressNextFunction, type ExpressRequestLike, type ExpressResponseLike, type ExpressTenantLike, createExpressMiddleware };

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+import { NodeLikeRequest, BetterTenantInstance } from '@usebetterdev/tenant-core';
+export { TenantContext, TenantScopedDatabase } from '@usebetterdev/tenant-core';
+
+interface ExpressRequestLike extends NodeLikeRequest {
+    headers: Record<string, string | string[] | number | undefined>;
+    originalUrl?: string;
+    hostname?: string;
+}
+interface ExpressResponseLike {
+    status: (code: number) => ExpressResponseLike;
+    json: (body: unknown) => unknown;
+}
+type ExpressNextFunction = (error?: unknown) => void;
+interface CreateExpressMiddlewareOptions {
+    missingTenantStatus?: 401 | 404;
+    onMissingTenant?: (request: ExpressRequestLike, response: ExpressResponseLike) => void | Promise<void>;
+}
+interface ExpressTenantLike extends Pick<BetterTenantInstance, "handleRequest"> {
+}
+type ExpressMiddleware = (request: ExpressRequestLike, response: ExpressResponseLike, next: ExpressNextFunction) => Promise<void>;
+declare function createExpressMiddleware(tenant: ExpressTenantLike, options?: CreateExpressMiddlewareOptions): ExpressMiddleware;
+
+export { type CreateExpressMiddlewareOptions, type ExpressMiddleware, type ExpressNextFunction, type ExpressRequestLike, type ExpressResponseLike, type ExpressTenantLike, createExpressMiddleware };

package/dist/index.js

@@ -0,0 +1,30 @@
+// src/index.ts
+import { toResolvableRequest } from "@usebetterdev/tenant-core";
+function createExpressMiddleware(tenant, options = {}) {
+  const missingTenantStatus = options.missingTenantStatus ?? 404;
+  return async (request, response, next) => {
+    try {
+      await tenant.handleRequest(
+        toResolvableRequest(request),
+        async () => {
+          next();
+        },
+        {
+          onMissingTenant: async () => {
+            if (options.onMissingTenant) {
+              await options.onMissingTenant(request, response);
+              return;
+            }
+            response.status(missingTenantStatus).json({ error: "Tenant not found" });
+          }
+        }
+      );
+    } catch (error) {
+      next(error);
+    }
+  };
+}
+export {
+  createExpressMiddleware
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import { toResolvableRequest } from \"@usebetterdev/tenant-core\";\nimport type {\n  BetterTenantInstance,\n  NodeLikeRequest,\n  ResolvableRequest,\n  TenantContext,\n  TenantScopedDatabase,\n} from \"@usebetterdev/tenant-core\";\n\nexport interface ExpressRequestLike extends NodeLikeRequest {\n  headers: Record<string, string | string[] | number | undefined>;\n  originalUrl?: string;\n  hostname?: string;\n}\n\nexport interface ExpressResponseLike {\n  status: (code: number) => ExpressResponseLike;\n  json: (body: unknown) => unknown;\n}\n\nexport type ExpressNextFunction = (error?: unknown) => void;\n\nexport interface CreateExpressMiddlewareOptions {\n  missingTenantStatus?: 401 | 404;\n  onMissingTenant?: (\n    request: ExpressRequestLike,\n    response: ExpressResponseLike,\n  ) => void | Promise<void>;\n}\n\nexport interface ExpressTenantLike extends Pick<BetterTenantInstance, \"handleRequest\"> {}\n\nexport type ExpressMiddleware = (\n  request: ExpressRequestLike,\n  response: ExpressResponseLike,\n  next: ExpressNextFunction,\n) => Promise<void>;\n\nexport function createExpressMiddleware(\n  tenant: ExpressTenantLike,\n  options: CreateExpressMiddlewareOptions = {},\n): ExpressMiddleware {\n  const missingTenantStatus = options.missingTenantStatus ?? 404;\n\n  return async (request, response, next) => {\n    try {\n      await tenant.handleRequest<ResolvableRequest, void>(\n        toResolvableRequest(request),\n        async () => {\n          next();\n        },\n        {\n          onMissingTenant: async () => {\n            if (options.onMissingTenant) {\n              await options.onMissingTenant(request, response);\n              return;\n            }\n            response.status(missingTenantStatus).json({ error: \"Tenant not found\" });\n          },\n        },\n      );\n    } catch (error) {\n      next(error);\n    }\n  };\n}\n\nexport type { TenantContext, TenantScopedDatabase };\n"],"mappings":";AAAA,SAAS,2BAA2B;AAsC7B,SAAS,wBACd,QACA,UAA0C,CAAC,GACxB;AACnB,QAAM,sBAAsB,QAAQ,uBAAuB;AAE3D,SAAO,OAAO,SAAS,UAAU,SAAS;AACxC,QAAI;AACF,YAAM,OAAO;AAAA,QACX,oBAAoB,OAAO;AAAA,QAC3B,YAAY;AACV,eAAK;AAAA,QACP;AAAA,QACA;AAAA,UACE,iBAAiB,YAAY;AAC3B,gBAAI,QAAQ,iBAAiB;AAC3B,oBAAM,QAAQ,gBAAgB,SAAS,QAAQ;AAC/C;AAAA,YACF;AACA,qBAAS,OAAO,mBAAmB,EAAE,KAAK,EAAE,OAAO,mBAAmB,CAAC;AAAA,UACzE;AAAA,QACF;AAAA,MACF;AAAA,IACF,SAAS,OAAO;AACd,WAAK,KAAK;AAAA,IACZ;AAAA,EACF;AACF;","names":[]}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@usebetterdev/tenant-express",
+  "version": "0.1.0",
+  "repository": "github:usebetter-dev/usebetter",
+  "bugs": "https://github.com/usebetter-dev/usebetter/issues",
+  "homepage": "https://github.com/usebetter-dev/usebetter#readme",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "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"
+  ],
+  "dependencies": {
+    "@usebetterdev/tenant-core": "0.1.0"
+  },
+  "peerDependencies": {
+    "express": ">=4.18.0"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.0",
+    "@types/node": "^22.10.0",
+    "@types/supertest": "^6.0.3",
+    "express": "^5.1.0",
+    "supertest": "^7.1.4",
+    "tsup": "^8.3.5",
+    "typescript": "~5.7.2",
+    "vitest": "^2.1.6"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "scripts": {
+    "build": "tsup",
+    "lint": "oxlint",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}