@ambiten/core 1.0.0

package/dist/utils/AuthUtils.d.ts

@@ -0,0 +1,15 @@
+import jwt from "jsonwebtoken";
+import 'dotenv/config';
+export declare class AuthService {
+    static generateToken(user: {
+        _id: string;
+        role: string;
+        tenantId: string;
+    }): string;
+    static generateRefreshToken(user: {
+        _id: string;
+        role: string;
+    }): string;
+    static verifyToken(token: string): string | jwt.JwtPayload;
+}
+//# sourceMappingURL=AuthUtils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"AuthUtils.d.ts","sourceRoot":"","sources":["../../src/utils/AuthUtils.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,cAAc,CAAC;AAC/B,OAAO,eAAe,CAAA;AAQtB,qBAAa,WAAW;IACvB,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE;IAM1E,MAAM,CAAC,oBAAoB,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;IAS/D,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,MAAM;CAGhC"}

package/dist/utils/AuthUtils.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuthService = void 0;
+const tslib_1 = require("tslib");
+const jsonwebtoken_1 = tslib_1.__importDefault(require("jsonwebtoken"));
+require("dotenv/config");
+const SECRET = process.env.JWT_SECRET;
+const REFRESH_SECRET = process.env.REFRESH_SECRET;
+const REFRESH_EXPIRATION = process.env.REFRESH_EXPIRATION || '7d';
+const JWT_EXPIRATION = process.env.JWT_EXPIRATION || '1d';
+class AuthService {
+    static generateToken(user) {
+        return jsonwebtoken_1.default.sign(user, SECRET, {
+            expiresIn: JWT_EXPIRATION
+        });
+    }
+    static generateRefreshToken(user) {
+        return jsonwebtoken_1.default.sign(user, REFRESH_SECRET, {
+            expiresIn: REFRESH_EXPIRATION
+        });
+    }
+    static verifyToken(token) {
+        return jsonwebtoken_1.default.verify(token, SECRET);
+    }
+}
+exports.AuthService = AuthService;

package/dist/utils/ModelRegistry.d.ts

@@ -0,0 +1,15 @@
+import { AmbitenModel } from '../lib-core';
+import type { Document } from '../types';
+/**
+ * AmbitenModelRegistry manages registered Ambiten model instances.
+ */
+export declare const AmbitenModelRegistry: {
+    registerModel(model: AmbitenModel<any>): void;
+    getRegisteredModel<T extends Document = Document>(model: AmbitenModel<T>): AmbitenModel<T> | null;
+    isModelRegistered(model: AmbitenModel<any>): boolean;
+    unregisterModel(model: AmbitenModel<any>): void;
+    getAllModels(): AmbitenModel<any>[];
+    clear(): void;
+};
+export declare function clearModelRegistryForTests(): void;
+//# sourceMappingURL=ModelRegistry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ModelRegistry.d.ts","sourceRoot":"","sources":["../../src/utils/ModelRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAIzC;;GAEG;AACH,eAAO,MAAM,oBAAoB;yBACV,YAAY,CAAC,GAAG,CAAC,GAAG,IAAI;uBAI1B,CAAC,SAAS,QAAQ,oBAC5B,YAAY,CAAC,CAAC,CAAC,GACrB,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI;6BAIA,YAAY,CAAC,GAAG,CAAC,GAAG,OAAO;2BAI7B,YAAY,CAAC,GAAG,CAAC,GAAG,IAAI;oBAI/B,YAAY,CAAC,GAAG,CAAC,EAAE;aAI1B,IAAI;CAGd,CAAC;AAIF,wBAAgB,0BAA0B,IAAI,IAAI,CAMjD"}

package/dist/utils/ModelRegistry.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AmbitenModelRegistry = void 0;
+exports.clearModelRegistryForTests = clearModelRegistryForTests;
+const modelRegistry = new Set();
+/**
+ * AmbitenModelRegistry manages registered Ambiten model instances.
+ */
+exports.AmbitenModelRegistry = {
+    registerModel(model) {
+        modelRegistry.add(model);
+    },
+    getRegisteredModel(model) {
+        return modelRegistry.has(model) ? model : null;
+    },
+    isModelRegistered(model) {
+        return modelRegistry.has(model);
+    },
+    unregisterModel(model) {
+        modelRegistry.delete(model);
+    },
+    getAllModels() {
+        return [...modelRegistry];
+    },
+    clear() {
+        modelRegistry.clear();
+    }
+};
+const registeredModels = [];
+function clearModelRegistryForTests() {
+    for (const model of registeredModels) {
+        exports.AmbitenModelRegistry.unregisterModel(model);
+    }
+    registeredModels.length = 0;
+}

package/dist/utils/banner.d.ts

@@ -0,0 +1,2 @@
+export declare function showBanner(): void;
+//# sourceMappingURL=banner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"banner.d.ts","sourceRoot":"","sources":["../../src/utils/banner.ts"],"names":[],"mappings":"AAGA,wBAAgB,UAAU,SAgBzB"}

package/dist/utils/banner.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.showBanner = showBanner;
+const tslib_1 = require("tslib");
+const figlet_1 = tslib_1.__importDefault(require("figlet"));
+const color_palatte_1 = require("./color-palatte");
+function showBanner() {
+    try {
+        const banner = figlet_1.default.textSync('Ambiten CLI', {
+            font: 'Standard',
+            horizontalLayout: 'default',
+            verticalLayout: 'default',
+        });
+        console.log((0, color_palatte_1.colorize)(banner, 'blue'));
+    }
+    catch (error) {
+        console.warn((0, color_palatte_1.colorize)('Figlet font not found or failed to load. Displaying fallback banner.', 'yellow'), error);
+        console.log((0, color_palatte_1.colorize)('=== Ambiten Core CLI ===', 'blue'));
+    }
+}

package/dist/utils/builders/createModel.d.ts

@@ -0,0 +1,37 @@
+import { AmbitenModel } from "../../lib-core";
+import { AmbitenModelOptions, Document } from "../../types";
+/**
+ * Parameters for creating a new model.
+ * @template T - The type of the document in the collection.
+ */
+type CreateModelParams<T extends Document = any> = AmbitenModelOptions<T>;
+/**
+ * Creates a new model for a MongoDB collection.
+ * In Multi-Tenancy mode, the model will be created for the specified tenant.
+ * If no tenant ID is provided, the model will be created for the default tenant.
+ * Note: Once a the applyMultiTenancy() middleware is applied to a connection to register tenant/s, the tenantId will be automatically set for all models created after that.
+ * This allows you to create models for different tenants without having to specify the tenantId each time. Then a tenantId or db instance or client instance is required to create a model.
+ * @template T - The type of the document in the collection.
+ * @param {CreateModelParams<T>} params - The parameters for creating the model.
+ * @returns {AmbitenModel<T>} The created model.
+ *
+ * @example
+ * const userSchema = createSchema({
+ *   name: { type: String, required: true },
+ *   age: { type: Number, required: true },
+ *   email: { type: String, required: true },
+ * });
+ *
+ * const userModel = Model({
+ *   name: 'users',
+ *   schema: userSchema,
+ *   provider: (client/db - whichever you naming is)/new MyCustomDbProvider(), // Your custom database provider instance
+ *   ctx: {
+ *     tenantId: 'tenant-a', // Optional: specify tenant ID if using multi-tenancy
+ *     dbName: 'myDatabase', // Optional: specify database name if needed
+ * } read docs for more details on what context options you can provide
+ * });
+ */
+export declare const Model: <T extends Document = any>(options: CreateModelParams<T>) => AmbitenModel<T>;
+export {};
+//# sourceMappingURL=createModel.d.ts.map

package/dist/utils/builders/createModel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createModel.d.ts","sourceRoot":"","sources":["../../../src/utils/builders/createModel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAiB,MAAM,gBAAgB,CAAA;AAC5D,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAG5D;;;GAGG;AACH,KAAK,iBAAiB,CAAC,CAAC,SAAS,QAAQ,GAAG,GAAG,IAAI,mBAAmB,CAAC,CAAC,CAAC,CAAC;AAE1E;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,KAAK,GAAI,CAAC,SAAS,QAAQ,GAAG,GAAG,EAC5C,SAAS,iBAAiB,CAAC,CAAC,CAAC,KAC5B,YAAY,CAAC,CAAC,CAKhB,CAAA"}

package/dist/utils/builders/createModel.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Model = void 0;
+const lib_core_1 = require("../../lib-core");
+/**
+ * Creates a new model for a MongoDB collection.
+ * In Multi-Tenancy mode, the model will be created for the specified tenant.
+ * If no tenant ID is provided, the model will be created for the default tenant.
+ * Note: Once a the applyMultiTenancy() middleware is applied to a connection to register tenant/s, the tenantId will be automatically set for all models created after that.
+ * This allows you to create models for different tenants without having to specify the tenantId each time. Then a tenantId or db instance or client instance is required to create a model.
+ * @template T - The type of the document in the collection.
+ * @param {CreateModelParams<T>} params - The parameters for creating the model.
+ * @returns {AmbitenModel<T>} The created model.
+ *
+ * @example
+ * const userSchema = createSchema({
+ *   name: { type: String, required: true },
+ *   age: { type: Number, required: true },
+ *   email: { type: String, required: true },
+ * });
+ *
+ * const userModel = Model({
+ *   name: 'users',
+ *   schema: userSchema,
+ *   provider: (client/db - whichever you naming is)/new MyCustomDbProvider(), // Your custom database provider instance
+ *   ctx: {
+ *     tenantId: 'tenant-a', // Optional: specify tenant ID if using multi-tenancy
+ *     dbName: 'myDatabase', // Optional: specify database name if needed
+ * } read docs for more details on what context options you can provide
+ * });
+ */
+const Model = (options) => {
+    return new lib_core_1.AmbitenModel({
+        ...options,
+        provider: options.provider ?? lib_core_1.AmbitenClient.init()
+    });
+};
+exports.Model = Model;

package/dist/utils/builders/getTenantDb.d.ts

@@ -0,0 +1,12 @@
+import { Db } from 'mongodb';
+/**
+ * Retrieves the database instance for a specific tenant.
+ * If the database is already cached, it returns the cached instance.
+ * Otherwise, it initializes a new database connection for the tenant, caches it, and returns it.
+ *
+ * @param {string} tenantId - The ID of the tenant whose database is to be retrieved.
+ * @returns {Promise<Db>} A promise that resolves to the MongoDB database instance for the tenant.
+ * @throws {Error} If the database for the specified tenant is not found.
+ */
+export declare const getTenantDB: (tenantId: string) => Promise<Db>;
+//# sourceMappingURL=getTenantDb.d.ts.map

package/dist/utils/builders/getTenantDb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getTenantDb.d.ts","sourceRoot":"","sources":["../../../src/utils/builders/getTenantDb.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,SAAS,CAAC;AAK7B;;;;;;;;GAQG;AACH,eAAO,MAAM,WAAW,GAAU,UAAU,MAAM,KAAG,OAAO,CAAC,EAAE,CAS9D,CAAA"}

package/dist/utils/builders/getTenantDb.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTenantDB = void 0;
+const lib_core_1 = require("../../lib-core");
+const dbCache = new Map();
+/**
+ * Retrieves the database instance for a specific tenant.
+ * If the database is already cached, it returns the cached instance.
+ * Otherwise, it initializes a new database connection for the tenant, caches it, and returns it.
+ *
+ * @param {string} tenantId - The ID of the tenant whose database is to be retrieved.
+ * @returns {Promise<Db>} A promise that resolves to the MongoDB database instance for the tenant.
+ * @throws {Error} If the database for the specified tenant is not found.
+ */
+const getTenantDB = async (tenantId) => {
+    if (dbCache.has(tenantId)) {
+        return dbCache.get(tenantId);
+    }
+    const db = lib_core_1.AmbitenClient.init().withDatabase(tenantId);
+    if (!db)
+        throw new Error(`Database not found for tenant: ${tenantId}`);
+    dbCache.set(tenantId, await db.db());
+    return await db.db();
+};
+exports.getTenantDB = getTenantDB;

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

@@ -0,0 +1,4 @@
+export * from './createModel';
+export * from './schema';
+export * from './getTenantDb';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/builders/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC"}

package/dist/utils/builders/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./createModel"), exports);
+tslib_1.__exportStar(require("./schema"), exports);
+tslib_1.__exportStar(require("./getTenantDb"), exports);

package/dist/utils/builders/schema.d.ts

@@ -0,0 +1,22 @@
+import { AmbitenSchema } from "../../lib-core";
+import { Document, SchemaDefinition } from "../../types";
+/**
+ * Creates a new AmbitenSchema instance with the provided schema definition.
+ * @param {SchemaDefinition<T> | Record<keyof T, any>} schema - The schema definition for the document.
+ * @returns {AmbitenSchema<T>} The created AmbitenSchema instance.
+ *
+ * @template T - The type of the document.
+ * @example
+ * const userSchema = createSchema({
+ *   name: { type: String, required: true },
+ *  age: { type: Number, required: true },
+ *  email: { type: String, required: true },
+ * });
+ * const userModel = new AmbitenModel(userSchema, 'users', db);
+ *
+ * const user = await userModel.create({ name: 'John Doe', age: 30, email: 'example.com' });
+ * console.log(user); // { _id: '...', name: 'John Doe', age: 30, email: 'example.com' }
+ *
+ */
+export declare const createSchema: <T extends Document>(schema: SchemaDefinition<T> | Record<keyof T, any>) => AmbitenSchema<T>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/utils/builders/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/utils/builders/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEzD;;;;;;;;;;;;;;;;;GAiBG;AAEH,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,QAAQ,EAC9C,QAAQ,gBAAgB,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,KAChD,aAAa,CAAC,CAAC,CAEjB,CAAA"}

package/dist/utils/builders/schema.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSchema = void 0;
+const lib_core_1 = require("../../lib-core");
+/**
+ * Creates a new AmbitenSchema instance with the provided schema definition.
+ * @param {SchemaDefinition<T> | Record<keyof T, any>} schema - The schema definition for the document.
+ * @returns {AmbitenSchema<T>} The created AmbitenSchema instance.
+ *
+ * @template T - The type of the document.
+ * @example
+ * const userSchema = createSchema({
+ *   name: { type: String, required: true },
+ *  age: { type: Number, required: true },
+ *  email: { type: String, required: true },
+ * });
+ * const userModel = new AmbitenModel(userSchema, 'users', db);
+ *
+ * const user = await userModel.create({ name: 'John Doe', age: 30, email: 'example.com' });
+ * console.log(user); // { _id: '...', name: 'John Doe', age: 30, email: 'example.com' }
+ *
+ */
+const createSchema = (schema) => {
+    return new lib_core_1.AmbitenSchema(schema);
+};
+exports.createSchema = createSchema;

package/dist/utils/cacheWithRedis.d.ts

@@ -0,0 +1,27 @@
+import { redis } from '../redis-manager';
+/**
+ * Options for caching behavior.
+ */
+interface AmbitenCacheOptions {
+    ttlSeconds?: number;
+    prefix?: string;
+    tenantId?: string;
+    namespace?: string;
+}
+/**
+ * Caches a value in Redis with optional tenant and namespace scoping.
+ * If the value is not found in cache, it runs the provided fetcher function
+ * to get the value, caches it, and then returns it.
+ *
+ * @param {string} key - The cache key to use.
+ * @param {() => Promise<T>} fetcher - A function that fetches the value if not cached.
+ * @param {AmbitenCacheOptions} options - Options for caching behavior.
+ * @returns {Promise<T>} - The cached or fetched value.
+ * @example
+ * const value = await cacheWithRedis(redisClient, 'myKey', async () => {
+ *   // Fetch from database or external API
+ *  return await fetchDataFromSource();
+ */
+export declare function cacheWithRedis<T>(client: typeof redis, key: string, fetcher: () => Promise<T>, options?: AmbitenCacheOptions): Promise<T>;
+export {};
+//# sourceMappingURL=cacheWithRedis.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cacheWithRedis.d.ts","sourceRoot":"","sources":["../../src/utils/cacheWithRedis.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAGzC;;GAEG;AACH,UAAU,mBAAmB;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,cAAc,CAAC,CAAC,EACpC,MAAM,EAAE,OAAO,KAAK,EACpB,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,CAAC,CAAC,CAGZ"}

package/dist/utils/cacheWithRedis.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cacheWithRedis = cacheWithRedis;
+const ambiten_cache_1 = require("../ambiten-cache");
+/**
+ * Caches a value in Redis with optional tenant and namespace scoping.
+ * If the value is not found in cache, it runs the provided fetcher function
+ * to get the value, caches it, and then returns it.
+ *
+ * @param {string} key - The cache key to use.
+ * @param {() => Promise<T>} fetcher - A function that fetches the value if not cached.
+ * @param {AmbitenCacheOptions} options - Options for caching behavior.
+ * @returns {Promise<T>} - The cached or fetched value.
+ * @example
+ * const value = await cacheWithRedis(redisClient, 'myKey', async () => {
+ *   // Fetch from database or external API
+ *  return await fetchDataFromSource();
+ */
+async function cacheWithRedis(client, key, fetcher, options = {}) {
+    const cache = new ambiten_cache_1.AmbitenCache(client);
+    return await cache.wrap(key, fetcher, options);
+}

package/dist/utils/castId.d.ts

@@ -0,0 +1,5 @@
+import { ObjectId } from 'mongodb';
+export declare const isValidObjectId: (id: string) => boolean;
+export declare function isObjectId(id: ObjectId): id is ObjectId;
+export declare function castId(inputId?: ObjectId): ObjectId;
+//# sourceMappingURL=castId.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"castId.d.ts","sourceRoot":"","sources":["../../src/utils/castId.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAkBlC,eAAO,MAAM,eAAe,GAAI,IAAI,MAAM,KAAG,OAE5C,CAAA;AAQD,wBAAgB,UAAU,CAAC,EAAE,EAAE,QAAQ,GAAG,EAAE,IAAI,QAAQ,CAMvD;AAGD,wBAAgB,MAAM,CAAC,OAAO,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAenD"}

package/dist/utils/castId.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidObjectId = void 0;
+exports.isObjectId = isObjectId;
+exports.castId = castId;
+const symbols_1 = require("./symbols");
+const mongodb_1 = require("mongodb");
+Object.defineProperty(mongodb_1.ObjectId.prototype, "_id", {
+    configurable: true,
+    enumerable: true,
+    get: function () {
+        return this.toHexString();
+    }
+});
+if (!Object.prototype.hasOwnProperty.call(mongodb_1.ObjectId.prototype, 'valueOf')) {
+    mongodb_1.ObjectId.prototype.valueOf = function objectIdValueOf() {
+        return this.toString();
+    };
+}
+const isValidObjectId = (id) => {
+    return /^[0-9a-fA-F]{24}$/.test(id);
+};
+exports.isValidObjectId = isValidObjectId;
+mongodb_1.ObjectId.prototype.toJSON = function objectIdToJSON() {
+    return this.toHexString();
+};
+mongodb_1.ObjectId.prototype[symbols_1.objectIdSymbol] = true;
+function isObjectId(id) {
+    if (id == null)
+        return false;
+    if (typeof id !== "object")
+        return false;
+    if (id.constructor !== mongodb_1.ObjectId)
+        return false;
+    if (id[symbols_1.objectIdSymbol] !== true)
+        return false;
+    return true;
+}
+// Casts a string to an ObjectId
+function castId(inputId) {
+    if (typeof inputId === "string") {
+        const _id = inputId;
+        if (!(0, exports.isValidObjectId)(_id)) {
+            throw new Error("Invalid ObjectId format in castId");
+        }
+        if (!isObjectId(inputId)) {
+            throw new Error("Invalid ObjectId in castId");
+        }
+        return mongodb_1.ObjectId.createFromHexString(_id);
+    }
+    return inputId;
+}

package/dist/utils/color-palatte.d.ts

@@ -0,0 +1,4 @@
+type Platform = 'blue' | 'cyan' | 'green' | 'magenta' | 'red' | 'yellow';
+export declare const colorize: (text: string, platform: Platform) => string;
+export {};
+//# sourceMappingURL=color-palatte.d.ts.map

package/dist/utils/color-palatte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color-palatte.d.ts","sourceRoot":"","sources":["../../src/utils/color-palatte.ts"],"names":[],"mappings":"AAAA,KAAK,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,KAAK,GAAG,QAAQ,CAAC;AAGzE,eAAO,MAAM,QAAQ,GAAI,MAAM,MAAM,EAAE,UAAU,QAAQ,WAmBxD,CAAA"}

package/dist/utils/color-palatte.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.colorize = void 0;
+;
+const colorize = (text, platform) => {
+    switch (platform) {
+        case 'red':
+            return `\x1b[31m${text}\x1b[0m`; // Red color
+        case 'green':
+            return `\x1b[32m${text}\x1b[0m`; // Green color
+        case 'magenta':
+            return `\x1b[35m${text}\x1b[0m`; // Magenta color
+        case 'cyan':
+            return `\x1b[36m${text}\x1b[0m`; // Cyan color
+        case 'yellow':
+            return `\x1b[33m${text}\x1b[0m`; // Yellow color
+        case 'blue':
+            return `\x1b[34m${text}\x1b[0m`; // Blue color
+        default:
+            break;
+    }
+    return `\x1b[36m${text}\x1b[0m`;
+};
+exports.colorize = colorize;

package/dist/utils/configureAmbitenContext.d.ts

@@ -0,0 +1,13 @@
+import type { BootstrapClient } from '../types';
+/**
+ * Configures the Ambiten runtime context with a transaction client resolver.
+ *
+ * The resolver is used by {@link AmbitenContext.withTransaction} to obtain the
+ * correct MongoDB client for the current runtime scope. Tenant-specific clients
+ * are resolved first when a tenant identifier is available; otherwise the
+ * configured provider client factory is used.
+ *
+ * @param provider - Bootstrap client/provider used to resolve MongoDB clients.
+ */
+export declare function configureAmbitenContext(provider: BootstrapClient): void;
+//# sourceMappingURL=configureAmbitenContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"configureAmbitenContext.d.ts","sourceRoot":"","sources":["../../src/utils/configureAmbitenContext.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAgB,eAAe,EAAE,MAAM,UAAU,CAAC;AAE9D;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAsBvE"}

package/dist/utils/configureAmbitenContext.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configureAmbitenContext = configureAmbitenContext;
+const context_1 = require("../context");
+const tanancy_1 = require("../tanancy");
+/**
+ * Configures the Ambiten runtime context with a transaction client resolver.
+ *
+ * The resolver is used by {@link AmbitenContext.withTransaction} to obtain the
+ * correct MongoDB client for the current runtime scope. Tenant-specific clients
+ * are resolved first when a tenant identifier is available; otherwise the
+ * configured provider client factory is used.
+ *
+ * @param provider - Bootstrap client/provider used to resolve MongoDB clients.
+ */
+function configureAmbitenContext(provider) {
+    context_1.AmbitenContext.configureTransactionResolver({
+        resolveClient: async (tenantId, dbName) => {
+            if (tenantId) {
+                const tenantClient = await tanancy_1.MultiTenantManager.getClient(tenantId);
+                if (tenantClient) {
+                    return tenantClient;
+                }
+            }
+            if (typeof provider.client === 'function') {
+                const ctx = {
+                    tenantId,
+                    dbName
+                };
+                return provider.client(ctx);
+            }
+            return undefined;
+        }
+    });
+}

package/dist/utils/detect-package-manager.d.ts

@@ -0,0 +1,5 @@
+export type PackageManager = 'pnpm' | 'npm' | 'yarn';
+export declare function detectPackageManager(cwd?: string): PackageManager;
+export declare function getInstallCommand(manager: PackageManager, packages: string[]): string[];
+export declare function installPackages(packages?: string[], cwd?: string): Promise<void>;
+//# sourceMappingURL=detect-package-manager.d.ts.map

package/dist/utils/detect-package-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-package-manager.d.ts","sourceRoot":"","sources":["../../src/utils/detect-package-manager.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;AAErD,wBAAgB,oBAAoB,CAAC,GAAG,SAAgB,GAAG,cAAc,CAYxE;AAED,wBAAgB,iBAAiB,CAChC,OAAO,EAAE,cAAc,EACvB,QAAQ,EAAE,MAAM,EAAE,GAChB,MAAM,EAAE,CAUV;AAED,wBAAsB,eAAe,CACnC,QAAQ,GAAE,MAAM,EAAO,EACvB,GAAG,SAAgB,GAClB,OAAO,CAAC,IAAI,CAAC,CAgCf"}

package/dist/utils/detect-package-manager.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectPackageManager = detectPackageManager;
+exports.getInstallCommand = getInstallCommand;
+exports.installPackages = installPackages;
+const tslib_1 = require("tslib");
+const fs_1 = tslib_1.__importDefault(require("fs"));
+const path_1 = tslib_1.__importDefault(require("path"));
+const child_process_1 = require("child_process");
+function detectPackageManager(cwd = process.cwd()) {
+    if (fs_1.default.existsSync(path_1.default.join(cwd, 'pnpm-lock.yaml')))
+        return 'pnpm';
+    if (fs_1.default.existsSync(path_1.default.join(cwd, 'yarn.lock')))
+        return 'yarn';
+    if (fs_1.default.existsSync(path_1.default.join(cwd, 'package-lock.json')))
+        return 'npm';
+    const userAgent = process.env.npm_config_user_agent ?? '';
+    if (userAgent.includes('pnpm'))
+        return 'pnpm';
+    if (userAgent.includes('yarn'))
+        return 'yarn';
+    if (userAgent.includes('npm'))
+        return 'npm';
+    return 'npm';
+}
+function getInstallCommand(manager, packages) {
+    switch (manager) {
+        case 'pnpm':
+            return ['pnpm', ['add', ...packages].join(' ')];
+        case 'yarn':
+            return ['yarn', ['add', ...packages].join(' ')];
+        case 'npm':
+        default:
+            return ['npm', ['install', ...packages].join(' ')];
+    }
+}
+async function installPackages(packages = [], cwd = process.cwd()) {
+    const manager = detectPackageManager(cwd);
+    const args = packages.length === 0
+        ? ['install']
+        : manager === 'npm'
+            ? ['install', ...packages]
+            : ['add', ...packages];
+    await new Promise((resolve, reject) => {
+        const child = (0, child_process_1.spawn)(manager, args, {
+            cwd,
+            stdio: 'inherit',
+            shell: process.platform === 'win32',
+        });
+        child.on('error', reject);
+        child.on('close', (code) => {
+            if (code === 0) {
+                resolve();
+                return;
+            }
+            reject(new Error(`${manager} ${args.join(' ')} failed with exit code ${code}`));
+        });
+    });
+}

package/dist/utils/ensureModelNameSafe.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Ensures that the provided model name is a valid, non-empty string.
+ * Throws an error if the model name is invalid.
+ *
+ * @param {string} collectionName - The collection name to validate.
+ * @returns {string} - The validated model name.
+ * @throws {Error} - If the model name is invalid.
+ * @example
+ * const safeModelName = ensureModelNameSafe('MyModel123');
+ */
+export declare function ensureModelNameSafe(collectionName: string): string;
+//# sourceMappingURL=ensureModelNameSafe.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ensureModelNameSafe.d.ts","sourceRoot":"","sources":["../../src/utils/ensureModelNameSafe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAiBlE"}