@ambiten/core 1.0.2 → 1.2.0

package/dist/esm/redis-manager/redisClient.js

@@ -0,0 +1,147 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RedisService = exports.redis = void 0;
+exports.connectRedis = connectRedis;
+require("dotenv/config");
+const redis_1 = require("redis");
+const DEFAULT_RECONNECT = (retries) => Math.min(retries * 50, 1000);
+const redisUrl = process.env.REDIS_URI;
+let currentClient = null;
+const createStub = () => ({
+    isOpen: false,
+    connect: async () => null,
+    disconnect: async () => null,
+    publish: async () => 0,
+    subscribe: async () => null,
+    duplicate: () => createStub(),
+    get: async () => null,
+    set: async () => 'OK',
+    del: async () => 0,
+    exists: async () => 0,
+    scan: async () => ({
+        cursor: 0,
+        keys: [],
+    }),
+    multi: () => ({
+        incr() {
+            return this;
+        },
+        expire() {
+            return this;
+        },
+        exec: async () => [],
+    }),
+});
+exports.redis = {
+    async getClient(uri) {
+        if (currentClient && currentClient.isOpen) {
+            return currentClient;
+        }
+        const url = uri || redisUrl;
+        if (!url) {
+            return createStub();
+        }
+        try {
+            const client = (0, redis_1.createClient)({
+                url,
+                socket: {
+                    reconnectStrategy: DEFAULT_RECONNECT,
+                },
+            });
+            await client.connect();
+            currentClient = client;
+            return client;
+        }
+        catch {
+            return createStub();
+        }
+    },
+    async disconnect() {
+        if (currentClient) {
+            try {
+                if (currentClient.isOpen &&
+                    typeof currentClient.disconnect === 'function') {
+                    await currentClient.disconnect();
+                }
+                else if (currentClient.isOpen &&
+                    typeof currentClient.quit === 'function') {
+                    await currentClient.quit();
+                }
+            }
+            catch {
+                // swallow disconnect errors
+            }
+        }
+        currentClient = null;
+    },
+    get isOpen() {
+        return !!currentClient?.isOpen;
+    },
+    async get(key) {
+        const client = await this.getClient();
+        return client.get?.(key);
+    },
+    async set(key, value, options) {
+        const client = await this.getClient();
+        return client.set?.(key, value, options);
+    },
+    async del(...keys) {
+        const client = await this.getClient();
+        return client.del?.(keys);
+    },
+    async exists(key) {
+        const client = await this.getClient();
+        return client.exists?.(key);
+    },
+    async scan(cursor = 0, options) {
+        const client = await this.getClient();
+        if (typeof client.scan !== 'function') {
+            return {
+                cursor: 0,
+                keys: [],
+            };
+        }
+        return client.scan(cursor, options);
+    },
+    async publish(channel, message) {
+        const client = await this.getClient();
+        return client.publish?.(channel, message);
+    },
+    async subscribe(channel, listener) {
+        const client = await this.getClient();
+        return client.subscribe?.(channel, listener);
+    },
+    duplicate() {
+        if (currentClient?.duplicate) {
+            return currentClient.duplicate();
+        }
+        return createStub();
+    },
+    multi() {
+        if (currentClient?.multi) {
+            return currentClient.multi();
+        }
+        return createStub().multi?.();
+    },
+};
+class RedisService {
+    static getInstance() {
+        return new RedisService();
+    }
+    async connect(url) {
+        await exports.redis.getClient(url);
+    }
+    getClient() {
+        return exports.redis.getClient();
+    }
+    async close() {
+        await exports.redis.disconnect();
+    }
+}
+exports.RedisService = RedisService;
+async function connectRedis() {
+    return {
+        connect: async (url) => exports.redis.getClient(url),
+    };
+}
+//# sourceMappingURL=redisClient.js.map

package/dist/esm/redis-manager/redisClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"redisClient.js","sourceRoot":"","sources":["../../../src/redis-manager/redisClient.ts"],"names":[],"mappings":"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"}

package/dist/esm/tanancy/MultiTenantManager.d.ts

@@ -0,0 +1,98 @@
+import { MongoClient } from 'mongodb';
+export interface TenantConfig {
+    tenantId: string;
+    uri: string;
+    dbName: string;
+    client?: MongoClient;
+    lazy: boolean;
+    metadata?: Record<string, unknown>;
+}
+export interface RegisterTenantOptions {
+    dbName?: string;
+    client?: MongoClient;
+    lazy?: boolean;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * MultiTenantManager is responsible for managing tenant configurations and MongoDB client connections in a multi-tenant application.
+ * It supports both lazy and immediate tenant registration, allowing for flexible connection management based on application needs.
+ */
+export declare class MultiTenantManager {
+    private static tenants;
+    constructor();
+    /**
+     * Checks if a tenant is already registered.
+     * @param {string} tenantId - The ID of the tenant to check.
+     * @returns {boolean} `true` if the tenant is registered, `false` otherwise.
+     */
+    static hasTenant(tenantId: string): boolean;
+    /**
+     * Registers a tenant for lazy connection.
+     * Connection is established only when the tenant is accessed for the first time.
+     *
+     * @param {string} tenantId - The tenant ID.
+     * @param {string} uri - The MongoDB URI.
+     * @param {RegisterTenantOptions} [options] - Optional tenant registration settings.
+     */
+    static registerLazyTenant(tenantId: string, uri: string, options?: Omit<RegisterTenantOptions, 'lazy' | 'client'>): TenantConfig;
+    /**
+     * Registers a tenant and establishes a connection immediately.
+     *
+     * @param {string} tenantId - The tenant ID.
+     * @param {string} uri - The MongoDB URI.
+     * @param {RegisterTenantOptions} [options] - Optional tenant registration settings.
+     * @returns {Promise<MongoClient>} The connected MongoClient instance.
+     */
+    static registerTenant(tenantId: string, uri: string, options?: Omit<RegisterTenantOptions, 'lazy'>): Promise<MongoClient>;
+    /**
+     * Retrieves the MongoClient instance for a specific tenant.
+     * If the tenant was registered lazily, connection is established on first access.
+     *
+     * @param {string} tenantId - The tenant ID.
+     * @returns {Promise<MongoClient | null>} The MongoClient or null if not registered.
+     */
+    static getClient(tenantId: string): Promise<MongoClient | null>;
+    /**
+     * Retrieves the full tenant configuration.
+     *
+     * @param {string} tenantId - The tenant ID.
+     * @returns {TenantConfig | undefined} The tenant configuration if found.
+     */
+    static getTenant(tenantId: string): TenantConfig | undefined;
+    /**
+     * Retrieves the configured database name for a tenant.
+     *
+     * @param {string} tenantId - The tenant ID.
+     * @returns {string | undefined} The database name if found.
+     */
+    static getTenantDbName(tenantId: string): string | undefined;
+    /**
+     * Returns the first connected tenant ID.
+     * Useful for backward compatibility, though not ideal in multi-tenant flows.
+     */
+    static getConnectedTenant(): string;
+    /**
+     * Returns all currently connected tenant IDs.
+     */
+    static getAllConnectedTenants(): string[];
+    /**
+     * Returns all registered tenant configs.
+     */
+    static getAllTenants(): TenantConfig[];
+    /**
+     * Returns true if at least one tenant is registered.
+     */
+    static isEnabled(): boolean;
+    /**
+     * Removes a tenant from the registry.
+     */
+    static removeTenant(tenantId: string): boolean;
+    /**
+     * Clears all tenants from the registry.
+     */
+    static clearTenants(): void;
+    private static validateTenantId;
+    private static validateUri;
+    private static extractDbNameFromUri;
+}
+//# sourceMappingURL=MultiTenantManager.d.ts.map

package/dist/esm/tanancy/MultiTenantManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultiTenantManager.d.ts","sourceRoot":"","sources":["../../../src/tanancy/MultiTenantManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAC,OAAO,CAAwC;;IAI9D;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI3C;;;;;;;OAOG;IACH,MAAM,CAAC,kBAAkB,CACvB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,qBAAqB,EAAE,MAAM,GAAG,QAAQ,CAAM,GAC3D,YAAY;IAoBf;;;;;;;OAOG;WACU,cAAc,CACzB,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,IAAI,CAAC,qBAAqB,EAAE,MAAM,CAAM,GAChD,OAAO,CAAC,WAAW,CAAC;IA6BvB;;;;;;OAMG;WACU,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IA4BrE;;;;;OAKG;IACH,MAAM,CAAC,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAK5D;;;;;OAKG;IACH,MAAM,CAAC,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI5D;;;OAGG;IACH,MAAM,CAAC,kBAAkB,IAAI,MAAM;IAKnC;;OAEG;IACH,MAAM,CAAC,sBAAsB,IAAI,MAAM,EAAE;IAMzC;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,YAAY,EAAE;IAItC;;OAEG;IACH,MAAM,CAAC,SAAS,IAAI,OAAO;IAI3B;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAK9C;;OAEG;IACH,MAAM,CAAC,YAAY,IAAI,IAAI;IAI3B,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAM/B,OAAO,CAAC,MAAM,CAAC,WAAW;IAU1B,OAAO,CAAC,MAAM,CAAC,oBAAoB;CAepC"}

package/dist/esm/tanancy/MultiTenantManager.js

@@ -0,0 +1,191 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MultiTenantManager = void 0;
+const mongodb_1 = require("mongodb");
+/**
+ * MultiTenantManager is responsible for managing tenant configurations and MongoDB client connections in a multi-tenant application.
+ * It supports both lazy and immediate tenant registration, allowing for flexible connection management based on application needs.
+ */
+class MultiTenantManager {
+    static tenants = new Map();
+    constructor() { }
+    /**
+     * Checks if a tenant is already registered.
+     * @param {string} tenantId - The ID of the tenant to check.
+     * @returns {boolean} `true` if the tenant is registered, `false` otherwise.
+     */
+    static hasTenant(tenantId) {
+        return this.tenants.has(tenantId);
+    }
+    /**
+     * Registers a tenant for lazy connection.
+     * Connection is established only when the tenant is accessed for the first time.
+     *
+     * @param {string} tenantId - The tenant ID.
+     * @param {string} uri - The MongoDB URI.
+     * @param {RegisterTenantOptions} [options] - Optional tenant registration settings.
+     */
+    static registerLazyTenant(tenantId, uri, options = {}) {
+        this.validateTenantId(tenantId);
+        this.validateUri(uri);
+        const normalizedTenantId = tenantId.trim();
+        const tenantConfig = {
+            tenantId: normalizedTenantId,
+            uri: uri.trim(),
+            dbName: options.dbName?.trim() || this.extractDbNameFromUri(uri) || normalizedTenantId,
+            client: undefined,
+            lazy: true,
+            metadata: options.metadata
+        };
+        this.tenants.set(normalizedTenantId, tenantConfig);
+        return tenantConfig;
+    }
+    /**
+     * Registers a tenant and establishes a connection immediately.
+     *
+     * @param {string} tenantId - The tenant ID.
+     * @param {string} uri - The MongoDB URI.
+     * @param {RegisterTenantOptions} [options] - Optional tenant registration settings.
+     * @returns {Promise<MongoClient>} The connected MongoClient instance.
+     */
+    static async registerTenant(tenantId, uri, options = {}) {
+        this.validateTenantId(tenantId);
+        this.validateUri(uri);
+        const normalizedTenantId = tenantId.trim();
+        const existing = this.tenants.get(normalizedTenantId);
+        if (existing?.client) {
+            return existing.client;
+        }
+        const client = options.client ?? new mongodb_1.MongoClient(uri);
+        if (!options.client) {
+            await client.connect();
+        }
+        const tenantConfig = {
+            tenantId: normalizedTenantId,
+            uri: uri.trim(),
+            dbName: options.dbName?.trim() || this.extractDbNameFromUri(uri) || normalizedTenantId,
+            client,
+            lazy: false,
+            metadata: options.metadata
+        };
+        this.tenants.set(normalizedTenantId, tenantConfig);
+        return client;
+    }
+    /**
+     * Retrieves the MongoClient instance for a specific tenant.
+     * If the tenant was registered lazily, connection is established on first access.
+     *
+     * @param {string} tenantId - The tenant ID.
+     * @returns {Promise<MongoClient | null>} The MongoClient or null if not registered.
+     */
+    static async getClient(tenantId) {
+        this.validateTenantId(tenantId);
+        const normalizedTenantId = tenantId.trim();
+        const tenant = this.tenants.get(normalizedTenantId);
+        if (!tenant)
+            return null;
+        if (tenant.client) {
+            return tenant.client;
+        }
+        if (tenant.lazy) {
+            const client = new mongodb_1.MongoClient(tenant.uri);
+            await client.connect();
+            this.tenants.set(normalizedTenantId, {
+                ...tenant,
+                client,
+                lazy: false
+            });
+            return client;
+        }
+        return null;
+    }
+    /**
+     * Retrieves the full tenant configuration.
+     *
+     * @param {string} tenantId - The tenant ID.
+     * @returns {TenantConfig | undefined} The tenant configuration if found.
+     */
+    static getTenant(tenantId) {
+        this.validateTenantId(tenantId);
+        return this.tenants.get(tenantId.trim());
+    }
+    /**
+     * Retrieves the configured database name for a tenant.
+     *
+     * @param {string} tenantId - The tenant ID.
+     * @returns {string | undefined} The database name if found.
+     */
+    static getTenantDbName(tenantId) {
+        return this.getTenant(tenantId)?.dbName;
+    }
+    /**
+     * Returns the first connected tenant ID.
+     * Useful for backward compatibility, though not ideal in multi-tenant flows.
+     */
+    static getConnectedTenant() {
+        const connected = Array.from(this.tenants.values()).find(tenant => !!tenant.client);
+        return connected?.tenantId || '';
+    }
+    /**
+     * Returns all currently connected tenant IDs.
+     */
+    static getAllConnectedTenants() {
+        return Array.from(this.tenants.values())
+            .filter(tenant => !!tenant.client)
+            .map(tenant => tenant.tenantId);
+    }
+    /**
+     * Returns all registered tenant configs.
+     */
+    static getAllTenants() {
+        return Array.from(this.tenants.values());
+    }
+    /**
+     * Returns true if at least one tenant is registered.
+     */
+    static isEnabled() {
+        return this.tenants.size > 0;
+    }
+    /**
+     * Removes a tenant from the registry.
+     */
+    static removeTenant(tenantId) {
+        this.validateTenantId(tenantId);
+        return this.tenants.delete(tenantId.trim());
+    }
+    /**
+     * Clears all tenants from the registry.
+     */
+    static clearTenants() {
+        this.tenants.clear();
+    }
+    static validateTenantId(tenantId) {
+        if (!tenantId || typeof tenantId !== 'string' || !tenantId.trim()) {
+            throw new Error('Tenant ID is required.');
+        }
+    }
+    static validateUri(uri) {
+        if (!uri || typeof uri !== 'string' || !uri.trim()) {
+            throw new Error('MongoDB URI is required.');
+        }
+        if (!uri.startsWith('mongodb://') && !uri.startsWith('mongodb+srv://')) {
+            throw new Error(`Invalid MongoDB URI: ${uri}`);
+        }
+    }
+    static extractDbNameFromUri(uri) {
+        try {
+            const withoutQuery = uri.split('?')[0];
+            const parts = withoutQuery.split('/');
+            const lastPart = parts[parts.length - 1];
+            if (!lastPart || lastPart.includes(':')) {
+                return undefined;
+            }
+            return lastPart.trim() || undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+}
+exports.MultiTenantManager = MultiTenantManager;
+//# sourceMappingURL=MultiTenantManager.js.map

package/dist/esm/tanancy/MultiTenantManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MultiTenantManager.js","sourceRoot":"","sources":["../../../src/tanancy/MultiTenantManager.ts"],"names":[],"mappings":"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"}

package/dist/esm/tanancy/TenantContext.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @deprecated
+ * @internal
+ *
+ * This is legacy code and is not intended for public use. It may be removed in future versions without warning.
+ * Provides a thread-safe context for managing tenant-specific data using `AsyncLocalStorage`.
+ * This is useful for multi-tenant applications where the current tenant needs to be tracked across asynchronous operations.
+ */
+export declare class TenantContext {
+    /**
+     * Runs a callback function within a specific tenant context.
+     * @param {string} tenantId - The ID of the tenant to set in the context.
+     * @param {() => void} callback - The callback function to execute within the tenant context.
+     */
+    static run(tenantId: string, callback: () => void): void;
+    /**
+     * Sets the tenant ID in the current context.
+     * @param {string} tenantId - The ID of the tenant to set.
+     */
+    static setTenantId(tenantId: string): void;
+    /**
+     * Retrieves the tenant ID from the current context.
+     * @returns {string | undefined} The tenant ID, or `undefined` if no tenant ID is set.
+     */
+    static getTenantId(): string | undefined;
+    /**
+     * Clears the tenant ID from the current context.
+     */
+    static clear(): void;
+}
+//# sourceMappingURL=TenantContext.d.ts.map

package/dist/esm/tanancy/TenantContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TenantContext.d.ts","sourceRoot":"","sources":["../../../src/tanancy/TenantContext.ts"],"names":[],"mappings":"AAWA;;;;;;;GAOG;AACH,qBAAa,aAAa;IACxB;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI;IAOxD;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAK1C;;;OAGG;IACH,MAAM,CAAC,WAAW,IAAI,MAAM,GAAG,SAAS;IAIxC;;OAEG;IACH,MAAM,CAAC,KAAK,IAAI,IAAI;CAIrB"}

package/dist/esm/tanancy/TenantContext.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TenantContext = void 0;
+/**
+ * This is legacy code and is not intended for public use. It may be removed in future versions without warning.
+ * @deprecated
+ * @internal
+ * TenantContext provides a thread-safe way to manage tenant-specific data using AsyncLocalStorage.
+ * This is particularly useful in multi-tenant applications where you need to track the current tenant across asynchronous operations.
+ */
+const node_async_hooks_1 = require("node:async_hooks");
+const tenantStorage = new node_async_hooks_1.AsyncLocalStorage();
+/**
+ * @deprecated
+ * @internal
+ *
+ * This is legacy code and is not intended for public use. It may be removed in future versions without warning.
+ * Provides a thread-safe context for managing tenant-specific data using `AsyncLocalStorage`.
+ * This is useful for multi-tenant applications where the current tenant needs to be tracked across asynchronous operations.
+ */
+class TenantContext {
+    /**
+     * Runs a callback function within a specific tenant context.
+     * @param {string} tenantId - The ID of the tenant to set in the context.
+     * @param {() => void} callback - The callback function to execute within the tenant context.
+     */
+    static run(tenantId, callback) {
+        if (!tenantId) {
+            throw new Error('tenantId is required to run tenant context');
+        }
+        tenantStorage.run({ tenantId: tenantId }, callback);
+    }
+    /**
+     * Sets the tenant ID in the current context.
+     * @param {string} tenantId - The ID of the tenant to set.
+     */
+    static setTenantId(tenantId) {
+        const store = tenantStorage.getStore();
+        if (store)
+            store.tenantId = tenantId;
+    }
+    /**
+     * Retrieves the tenant ID from the current context.
+     * @returns {string | undefined} The tenant ID, or `undefined` if no tenant ID is set.
+     */
+    static getTenantId() {
+        return tenantStorage.getStore()?.tenantId;
+    }
+    /**
+     * Clears the tenant ID from the current context.
+     */
+    static clear() {
+        const store = tenantStorage.getStore();
+        if (store)
+            store.tenantId = undefined;
+    }
+}
+exports.TenantContext = TenantContext;
+;
+//# sourceMappingURL=TenantContext.js.map

package/dist/esm/tanancy/TenantContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TenantContext.js","sourceRoot":"","sources":["../../../src/tanancy/TenantContext.ts"],"names":[],"mappings":";;;AAAA;;;;;;GAMG;AACH,uDAAqD;AAErD,MAAM,aAAa,GAAG,IAAI,oCAAiB,EAAoC,CAAC;AAEhF;;;;;;;GAOG;AACH,MAAa,aAAa;IACxB;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,QAAgB,EAAE,QAAoB;QAC/C,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;QACD,aAAa,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,QAAQ,CAAC,CAAC;IACtD,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,WAAW,CAAC,QAAgB;QACjC,MAAM,KAAK,GAAG,aAAa,CAAC,QAAQ,EAAE,CAAC;QACvC,IAAI,KAAK;YAAE,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAC;IACvC,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,WAAW;QAChB,OAAO,aAAa,CAAC,QAAQ,EAAE,EAAE,QAAQ,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK;QACV,MAAM,KAAK,GAAG,aAAa,CAAC,QAAQ,EAAE,CAAC;QACvC,IAAI,KAAK;YAAE,KAAK,CAAC,QAAQ,GAAG,SAAS,CAAC;IACxC,CAAC;CACF;AArCD,sCAqCC;AAAA,CAAC"}

package/dist/esm/tanancy/TenantModelResolver.d.ts

@@ -0,0 +1,10 @@
+import type { Document } from "mongodb";
+import type { AmbitenSchema } from "../lib-core";
+export type GetTenantModelParams<T extends Document> = {
+    collectionName: string;
+    schema: AmbitenSchema<T>;
+    tenantId?: string;
+    dbName?: string;
+};
+export declare const getTenantModel: <T extends Document>(params: GetTenantModelParams<T>) => Promise<any>;
+//# sourceMappingURL=TenantModelResolver.d.ts.map

package/dist/esm/tanancy/TenantModelResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TenantModelResolver.d.ts","sourceRoot":"","sources":["../../../src/tanancy/TenantModelResolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAM,QAAQ,EAAE,MAAM,SAAS,CAAC;AAG5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAMjD,MAAM,MAAM,oBAAoB,CAAC,CAAC,SAAS,QAAQ,IAAI;IACrD,cAAc,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAqBF,eAAO,MAAM,cAAc,GAAU,CAAC,SAAS,QAAQ,EACrD,QAAQ,oBAAoB,CAAC,CAAC,CAAC,KAC9B,OAAO,CAAC,GAAG,CAqCb,CAAC"}