@zudojs/tenancy 0.0.1

package/dist/tenancyTypes/tenantIdentity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenantIdentity.js","sourceRoot":"","sources":["../../src/tenancyTypes/tenantIdentity.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,mCAAmC;AACnC,MAAM,UAAU,cAAc,CAAC,KAAa;IAC1C,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,KAAiB,CAAC;AAC3B,CAAC"}

package/dist/tenancyTypes/tenantInterface.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Tenant and context types.
+ *
+ * @module tenancyTypes/tenantInterface
+ */
+import type { TenantId, TenantStatus } from "./tenantIdentity.js";
+/** A tenant entity. */
+export interface Tenant {
+    readonly id: TenantId;
+    readonly name: string;
+    readonly slug?: string;
+    readonly status: TenantStatus;
+    readonly metadata: Readonly<Record<string, unknown>>;
+    readonly createdAt?: Date;
+    readonly updatedAt?: Date;
+}
+/** How the tenant was resolved. */
+export type TenantResolutionSource = "header" | "subdomain" | "domain" | "path" | "jwt" | "api-key" | "manual" | "system" | "custom";
+/** Tenant trust level for resolution sources. */
+export type TenantTrustLevel = "trusted" | "verified" | "untrusted";
+/** A resolved tenant context for the current execution. */
+export interface TenantContext {
+    readonly tenantId: TenantId;
+    readonly source: TenantResolutionSource;
+    readonly trust: TenantTrustLevel;
+    readonly resolvedAt: Date;
+    readonly metadata: Readonly<Record<string, unknown>>;
+}
+/** System-level execution context (no tenant). */
+export interface SystemContext {
+    readonly mode: "system";
+}
+/** Tenant-scoped execution context. */
+export interface TenantExecutionContext {
+    readonly mode: "tenant";
+    readonly tenant: Tenant;
+    readonly context: TenantContext;
+}
+/** Union of system and tenant execution contexts. */
+export type ExecutionTenantContext = SystemContext | TenantExecutionContext;
+/** Tenant requirement for routes/operations. */
+export type TenantRequirement = "required" | "optional" | "forbidden";
+/** Resource that belongs to a tenant. */
+export interface TenantResource {
+    readonly tenantId: TenantId;
+}
+//# sourceMappingURL=tenantInterface.d.ts.map

package/dist/tenancyTypes/tenantInterface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenantInterface.d.ts","sourceRoot":"","sources":["../../src/tenancyTypes/tenantInterface.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAe,MAAM,qBAAqB,CAAC;AAE/E,uBAAuB;AACvB,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACrD,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC;IAC1B,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC;CAC3B;AAED,mCAAmC;AACnC,MAAM,MAAM,sBAAsB,GAC9B,QAAQ,GACR,WAAW,GACX,QAAQ,GACR,MAAM,GACN,KAAK,GACL,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,QAAQ,CAAC;AAEb,iDAAiD;AACjD,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;AAEpE,2DAA2D;AAC3D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC;IACxC,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACtD;AAED,kDAAkD;AAClD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;CACzB;AAED,uCAAuC;AACvC,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;CACjC;AAED,qDAAqD;AACrD,MAAM,MAAM,sBAAsB,GAAG,aAAa,GAAG,sBAAsB,CAAC;AAE5E,gDAAgD;AAChD,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,UAAU,GAAG,WAAW,CAAC;AAEtE,yCAAyC;AACzC,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;CAC7B"}

package/dist/tenancyTypes/tenantInterface.js

@@ -0,0 +1,7 @@
+/**
+ * Tenant and context types.
+ *
+ * @module tenancyTypes/tenantInterface
+ */
+export {};
+//# sourceMappingURL=tenantInterface.js.map

package/dist/tenancyTypes/tenantInterface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenantInterface.js","sourceRoot":"","sources":["../../src/tenancyTypes/tenantInterface.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/utils/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Utility helpers for the tenancy package.
+ *
+ * @module utils
+ */
+export { isTenantActive, sameTenant, summarizeTenant, summarizeContext, } from "./utils.helper.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,cAAc,EACd,UAAU,EACV,eAAe,EACf,gBAAgB,GACjB,MAAM,mBAAmB,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,7 @@
+/**
+ * Utility helpers for the tenancy package.
+ *
+ * @module utils
+ */
+export { isTenantActive, sameTenant, summarizeTenant, summarizeContext, } from "./utils.helper.js";
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,cAAc,EACd,UAAU,EACV,eAAe,EACf,gBAAgB,GACjB,MAAM,mBAAmB,CAAC"}

package/dist/utils/utils.helper.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Utility helpers for the tenancy package.
+ *
+ * @module utils/utils
+ */
+import type { TenantId } from "../tenancyTypes/tenantIdentity.js";
+import type { Tenant, TenantContext } from "../tenancyTypes/tenantInterface.js";
+/**
+ * Check if a tenant is in a usable state.
+ */
+export declare function isTenantActive(tenant: Tenant): boolean;
+/**
+ * Check if two tenant IDs match.
+ */
+export declare function sameTenant(a: TenantId, b: TenantId): boolean;
+/**
+ * Create a tenant summary string for logging.
+ */
+export declare function summarizeTenant(tenant: Tenant): string;
+/**
+ * Create a tenant context summary string for logging.
+ */
+export declare function summarizeContext(ctx: TenantContext): string;
+//# sourceMappingURL=utils.helper.d.ts.map

package/dist/utils/utils.helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.helper.d.ts","sourceRoot":"","sources":["../../src/utils/utils.helper.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAEhF;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAE5D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAE3D"}

package/dist/utils/utils.helper.js

@@ -0,0 +1,30 @@
+/**
+ * Utility helpers for the tenancy package.
+ *
+ * @module utils/utils
+ */
+/**
+ * Check if a tenant is in a usable state.
+ */
+export function isTenantActive(tenant) {
+    return tenant.status === "active";
+}
+/**
+ * Check if two tenant IDs match.
+ */
+export function sameTenant(a, b) {
+    return a === b;
+}
+/**
+ * Create a tenant summary string for logging.
+ */
+export function summarizeTenant(tenant) {
+    return `Tenant(${tenant.id}, ${tenant.name}, ${tenant.status})`;
+}
+/**
+ * Create a tenant context summary string for logging.
+ */
+export function summarizeContext(ctx) {
+    return `TenantContext(${ctx.tenantId}, source=${ctx.source}, trust=${ctx.trust})`;
+}
+//# sourceMappingURL=utils.helper.js.map

package/dist/utils/utils.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.helper.js","sourceRoot":"","sources":["../../src/utils/utils.helper.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,MAAc;IAC3C,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,CAAW,EAAE,CAAW;IACjD,OAAO,CAAC,KAAK,CAAC,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAc;IAC5C,OAAO,UAAU,MAAM,CAAC,EAAE,KAAK,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,MAAM,GAAG,CAAC;AAClE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAkB;IACjD,OAAO,iBAAiB,GAAG,CAAC,QAAQ,YAAY,GAAG,CAAC,MAAM,WAAW,GAAG,CAAC,KAAK,GAAG,CAAC;AACpF,CAAC"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@zudojs/tenancy",
+  "version": "0.0.1",
+  "description": "Multi-tenant context and isolation with tenant resolution, AsyncLocalStorage propagation, resolver chains, trust levels, and guard middleware.",
+  "license": "MIT",
+  "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",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@zudojs/errors": "workspace:*",
+    "@zudojs/constants": "workspace:*"
+  },
+  "peerDependencies": {
+    "@zudojs/http": "workspace:*"
+  },
+  "peerDependenciesMeta": {
+    "@zudojs/http": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^7.0.2",
+    "vitest": "^4.1.11"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "zudojs",
+    "tenancy",
+    "multi-tenant",
+    "saas"
+  ],
+  "homepage": "https://github.com/oyinlola-tech/zudo#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/oyinlola-tech/zudo"
+  }
+}