@forinda/kickjs-multi-tenant 1.3.1 → 1.4.0

package/dist/index.d.ts

@@ -1,79 +1,4 @@
-import { AppAdapter, AdapterMiddleware, Container } from '@forinda/kickjs-core';
-
-/** DI token for the current tenant context */
-declare const TENANT_CONTEXT: unique symbol;
-/** Tenant information resolved from the request */
-interface TenantInfo {
-    /** Unique tenant identifier */
-    id: string;
-    /** Optional tenant name */
-    name?: string;
-    /** Optional tenant-specific config/metadata */
-    metadata?: Record<string, any>;
-}
-/** Strategy for resolving the tenant from a request */
-type TenantResolutionStrategy = 'header' | 'subdomain' | 'path' | 'query' | ((req: any) => TenantInfo | null | Promise<TenantInfo | null>);
-interface MultiTenantOptions {
-    /**
-     * How to resolve the tenant from the request.
-     * - 'header' — reads X-Tenant-ID header (default)
-     * - 'subdomain' — extracts from subdomain (tenant.example.com)
-     * - 'path' — extracts from first path segment (/tenant-id/...)
-     * - 'query' — reads ?tenantId= query param
-     * - function — custom resolver
-     */
-    strategy?: TenantResolutionStrategy;
-    /** Header name when strategy is 'header' (default: 'x-tenant-id') */
-    headerName?: string;
-    /** Query param name when strategy is 'query' (default: 'tenantId') */
-    queryParam?: string;
-    /**
-     * Called after tenant is resolved. Use for validation, loading tenant
-     * config from DB, or rejecting unknown tenants.
-     */
-    onTenantResolved?: (tenant: TenantInfo, req: any) => void | Promise<void>;
-    /** Return a 403 if no tenant can be resolved (default: true) */
-    required?: boolean;
-    /** Routes to skip tenant resolution (e.g., health checks) */
-    excludeRoutes?: string[];
-}
-
-/**
- * Multi-tenancy adapter for KickJS.
- *
- * Resolves the tenant from each request and makes it available
- * via DI (`@Inject(TENANT_CONTEXT)`) and `req.tenant`.
- *
- * @example
- * ```ts
- * import { TenantAdapter, TENANT_CONTEXT } from '@forinda/kickjs-multi-tenant'
- *
- * bootstrap({
- *   modules,
- *   adapters: [
- *     new TenantAdapter({
- *       strategy: 'header',
- *       onTenantResolved: async (tenant) => {
- *         // Load tenant config from DB, validate, etc.
- *       },
- *     }),
- *   ],
- * })
- *
- * // In a service:
- * @Service()
- * class UserService {
- *   constructor(@Inject(TENANT_CONTEXT) private tenant: TenantInfo) {}
- * }
- * ```
- */
-declare class TenantAdapter implements AppAdapter {
-    name: string;
-    private options;
-    constructor(options?: MultiTenantOptions);
-    middleware(): AdapterMiddleware[];
-    beforeStart(_app: any, container: Container): void;
-    private resolveTenant;
-}
-
-export { type MultiTenantOptions, TENANT_CONTEXT, TenantAdapter, type TenantInfo, type TenantResolutionStrategy };
+export { TenantAdapter } from './tenant.adapter';
+export { TENANT_CONTEXT } from './types';
+export type { TenantInfo, MultiTenantOptions, TenantResolutionStrategy } from './types';
+//# 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,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AACxC,YAAY,EAAE,UAAU,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAA"}

package/dist/index.js

@@ -1 +1,65 @@
-var l=Object.defineProperty;var a=(i,t)=>l(i,"name",{value:t,configurable:!0});import{Logger as d,Scope as h}from"@forinda/kickjs-core";var o=Symbol("TenantContext");var p=d.for("MultiTenant"),s=class{static{a(this,"TenantAdapter")}name="TenantAdapter";options;constructor(t={}){this.options={strategy:t.strategy??"header",required:t.required??!0,headerName:t.headerName??"x-tenant-id",queryParam:t.queryParam??"tenantId",...t}}middleware(){return[{handler:a(async(t,n,e)=>{if(this.options.excludeRoutes?.some(u=>t.path.startsWith(u)))return e();let r=await this.resolveTenant(t);if(!r){if(this.options.required){n.status(403).json({message:"Tenant not found. Provide a valid tenant identifier."});return}return e()}t.tenant=r,this.options.onTenantResolved&&await this.options.onTenantResolved(r,t),e()},"handler"),phase:"beforeGlobal"}]}beforeStart(t,n){n.registerFactory(o,()=>({id:"default",name:"Default Tenant"}),h.SINGLETON),p.info(`Tenant resolution: ${typeof this.options.strategy=="function"?"custom":this.options.strategy}`)}async resolveTenant(t){let n=this.options.strategy;if(typeof n=="function")return n(t);switch(n){case"header":{let e=t.get(this.options.headerName);return e?{id:e}:null}case"subdomain":{let r=t.hostname.split(".");return r.length>=3?{id:r[0]}:null}case"path":{let e=t.path.split("/").filter(Boolean);return e.length>0?{id:e[0]}:null}case"query":{let e=t.query[this.options.queryParam];return e?{id:e}:null}default:return null}}};export{o as TENANT_CONTEXT,s as TenantAdapter};
+import { Logger as s, Scope as o } from "@forinda/kickjs-core";
+var i = /* @__PURE__ */ Symbol("TenantContext"), u = s.for("MultiTenant"), d = class {
+  name = "TenantAdapter";
+  options;
+  constructor(t = {}) {
+    this.options = {
+      strategy: t.strategy ?? "header",
+      required: t.required ?? !0,
+      headerName: t.headerName ?? "x-tenant-id",
+      queryParam: t.queryParam ?? "tenantId",
+      ...t
+    };
+  }
+  middleware() {
+    return [{
+      handler: async (t, n, e) => {
+        if (this.options.excludeRoutes?.some((r) => t.path.startsWith(r))) return e();
+        const a = await this.resolveTenant(t);
+        if (!a) {
+          if (this.options.required) {
+            n.status(403).json({ message: "Tenant not found. Provide a valid tenant identifier." });
+            return;
+          }
+          return e();
+        }
+        t.tenant = a, this.options.onTenantResolved && await this.options.onTenantResolved(a, t), e();
+      },
+      phase: "beforeGlobal"
+    }];
+  }
+  beforeStart(t, n) {
+    n.registerFactory(i, () => ({
+      id: "default",
+      name: "Default Tenant"
+    }), o.SINGLETON), u.info(`Tenant resolution: ${typeof this.options.strategy == "function" ? "custom" : this.options.strategy}`);
+  }
+  async resolveTenant(t) {
+    const n = this.options.strategy;
+    if (typeof n == "function") return n(t);
+    switch (n) {
+      case "header": {
+        const e = t.get(this.options.headerName);
+        return e ? { id: e } : null;
+      }
+      case "subdomain": {
+        const e = t.hostname.split(".");
+        return e.length >= 3 ? { id: e[0] } : null;
+      }
+      case "path": {
+        const e = t.path.split("/").filter(Boolean);
+        return e.length > 0 ? { id: e[0] } : null;
+      }
+      case "query": {
+        const e = t.query[this.options.queryParam];
+        return e ? { id: e } : null;
+      }
+      default:
+        return null;
+    }
+  }
+};
+export {
+  i as TENANT_CONTEXT,
+  d as TenantAdapter
+};

package/dist/tenant.adapter.d.ts

@@ -0,0 +1,40 @@
+import { type AppAdapter, type AdapterMiddleware, type Container } from '@forinda/kickjs-core';
+import { type MultiTenantOptions } from './types';
+/**
+ * Multi-tenancy adapter for KickJS.
+ *
+ * Resolves the tenant from each request and makes it available
+ * via DI (`@Inject(TENANT_CONTEXT)`) and `req.tenant`.
+ *
+ * @example
+ * ```ts
+ * import { TenantAdapter, TENANT_CONTEXT } from '@forinda/kickjs-multi-tenant'
+ *
+ * bootstrap({
+ *   modules,
+ *   adapters: [
+ *     new TenantAdapter({
+ *       strategy: 'header',
+ *       onTenantResolved: async (tenant) => {
+ *         // Load tenant config from DB, validate, etc.
+ *       },
+ *     }),
+ *   ],
+ * })
+ *
+ * // In a service:
+ * @Service()
+ * class UserService {
+ *   constructor(@Inject(TENANT_CONTEXT) private tenant: TenantInfo) {}
+ * }
+ * ```
+ */
+export declare class TenantAdapter implements AppAdapter {
+    name: string;
+    private options;
+    constructor(options?: MultiTenantOptions);
+    middleware(): AdapterMiddleware[];
+    beforeStart(_app: any, container: Container): void;
+    private resolveTenant;
+}
+//# sourceMappingURL=tenant.adapter.d.ts.map

package/dist/tenant.adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant.adapter.d.ts","sourceRoot":"","sources":["../src/tenant.adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,SAAS,EAEf,MAAM,sBAAsB,CAAA;AAE7B,OAAO,EAGL,KAAK,kBAAkB,EAExB,MAAM,SAAS,CAAA;AAIhB;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,qBAAa,aAAc,YAAW,UAAU;IAC9C,IAAI,SAAkB;IACtB,OAAO,CAAC,OAAO,CAGK;gBAER,OAAO,GAAE,kBAAuB;IAU5C,UAAU,IAAI,iBAAiB,EAAE;IAoCjC,WAAW,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI;YAapC,aAAa;CAmC5B"}

package/dist/types.d.ts

@@ -0,0 +1,38 @@
+/** DI token for the current tenant context */
+export declare const TENANT_CONTEXT: unique symbol;
+/** Tenant information resolved from the request */
+export interface TenantInfo {
+    /** Unique tenant identifier */
+    id: string;
+    /** Optional tenant name */
+    name?: string;
+    /** Optional tenant-specific config/metadata */
+    metadata?: Record<string, any>;
+}
+/** Strategy for resolving the tenant from a request */
+export type TenantResolutionStrategy = 'header' | 'subdomain' | 'path' | 'query' | ((req: any) => TenantInfo | null | Promise<TenantInfo | null>);
+export interface MultiTenantOptions {
+    /**
+     * How to resolve the tenant from the request.
+     * - 'header' — reads X-Tenant-ID header (default)
+     * - 'subdomain' — extracts from subdomain (tenant.example.com)
+     * - 'path' — extracts from first path segment (/tenant-id/...)
+     * - 'query' — reads ?tenantId= query param
+     * - function — custom resolver
+     */
+    strategy?: TenantResolutionStrategy;
+    /** Header name when strategy is 'header' (default: 'x-tenant-id') */
+    headerName?: string;
+    /** Query param name when strategy is 'query' (default: 'tenantId') */
+    queryParam?: string;
+    /**
+     * Called after tenant is resolved. Use for validation, loading tenant
+     * config from DB, or rejecting unknown tenants.
+     */
+    onTenantResolved?: (tenant: TenantInfo, req: any) => void | Promise<void>;
+    /** Return a 403 if no tenant can be resolved (default: true) */
+    required?: boolean;
+    /** Routes to skip tenant resolution (e.g., health checks) */
+    excludeRoutes?: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,eAAO,MAAM,cAAc,eAA0B,CAAA;AAErD,mDAAmD;AACnD,MAAM,WAAW,UAAU;IACzB,+BAA+B;IAC/B,EAAE,EAAE,MAAM,CAAA;IACV,2BAA2B;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAC/B;AAED,uDAAuD;AACvD,MAAM,MAAM,wBAAwB,GAChC,QAAQ,GACR,WAAW,GACX,MAAM,GACN,OAAO,GACP,CAAC,CAAC,GAAG,EAAE,GAAG,KAAK,UAAU,GAAG,IAAI,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,CAAA;AAElE,MAAM,WAAW,kBAAkB;IACjC;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,wBAAwB,CAAA;IAEnC,qEAAqE;IACrE,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB;;;OAGG;IACH,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEzE,gEAAgE;IAChE,QAAQ,CAAC,EAAE,OAAO,CAAA;IAElB,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;CACzB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forinda/kickjs-multi-tenant",
-  "version": "1.3.1",
+  "version": "1.4.0",
   "description": "Multi-tenancy helpers for KickJS — tenant resolution, scoped DI, and database routing",
   "keywords": [
     "kickjs",
@@ -33,7 +33,8 @@
     "@forinda/kickjs-mailer",
     "@forinda/kickjs-queue",
     "@forinda/kickjs-devtools",
-    "@forinda/kickjs-notifications"
+    "@forinda/kickjs-notifications",
+    "vite"
   ],
   "type": "module",
   "main": "dist/index.js",
@@ -49,12 +50,11 @@
   ],
   "dependencies": {
     "reflect-metadata": "^0.2.2",
-    "@forinda/kickjs-core": "1.3.1",
-    "@forinda/kickjs-http": "1.3.1"
+    "@forinda/kickjs-core": "1.4.0",
+    "@forinda/kickjs-http": "1.4.0"
   },
   "devDependencies": {
     "@types/node": "^24.5.2",
-    "tsup": "^8.5.0",
     "typescript": "^5.9.2"
   },
   "publishConfig": {
@@ -75,8 +75,9 @@
     "url": "https://github.com/forinda/kick-js/issues"
   },
   "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
+    "build": "vite build && pnpm build:types",
+    "build:types": "tsc -p tsconfig.build.json",
+    "dev": "vite build --watch",
     "typecheck": "tsc --noEmit",
     "clean": "rm -rf dist .turbo"
   }