@ambiten/core 1.0.2 → 1.2.0

package/dist/esm/tanancy/TenantModelResolver.js

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTenantModel = void 0;
+const builders_1 = require("../utils/builders");
+const MultiTenantManager_1 = require("./MultiTenantManager");
+const context_1 = require("../context");
+const tenantModelsCache = new Map();
+function createTenantProvider(tenantId, dbName) {
+    return {
+        async db(ctx) {
+            const client = await MultiTenantManager_1.MultiTenantManager.getClient(tenantId);
+            if (!client) {
+                throw new Error(`Tenant "${tenantId}" not registered.`);
+            }
+            const resolvedDbName = ctx?.dbName ?? dbName;
+            return resolvedDbName ? client.db(resolvedDbName) : client.db();
+        },
+    };
+}
+const getTenantModel = async (params) => {
+    const collectionName = params?.collectionName?.trim();
+    const tenantId = params?.tenantId ?? context_1.AmbitenContext.getTenantId();
+    if (!collectionName) {
+        throw new Error("collectionName is required.");
+    }
+    if (!tenantId) {
+        throw new Error("tenantId is required to run tenant context");
+    }
+    if (!tenantModelsCache.has(tenantId)) {
+        tenantModelsCache.set(tenantId, new Map());
+    }
+    const tenantCache = tenantModelsCache.get(tenantId);
+    const cacheKey = params.dbName
+        ? `${collectionName}::${params.dbName}`
+        : collectionName;
+    if (tenantCache.has(cacheKey)) {
+        return tenantCache.get(cacheKey);
+    }
+    const provider = createTenantProvider(tenantId, params.dbName);
+    const model = (0, builders_1.Model)({
+        collectionName,
+        schema: params.schema,
+        provider,
+    });
+    tenantCache.set(cacheKey, model);
+    return model;
+};
+exports.getTenantModel = getTenantModel;
+// import { AmbitenSchema } from '../lib-core';
+// import { MultiTenantManager } from './MultiTenantManager';
+// import { TenantContext } from './TenantContext';
+// import { Model } from '../utils/builders/createModel';
+// import { ensureModelNameSafe } from '../utils/ensureModelNameSafe'; // <- wherever you put it
+// import { Document } from '../types';
+// import { Db } from 'mongodb';
+// type DbProvider = { db(ctx?: { dbName?: string }): Promise<Db> };
+// /**
+//  * Parameters required to resolve a tenant-specific model.
+//  * @template T - The type of the document in the model.
+//  */
+// export type GetTanantModelParams<T extends Document> = {
+//   collectionName: string;
+//   tenantId: string;
+//   schema?: AmbitenSchema<T>;
+// };
+// const tenantModelsCache: Map<string, Map<string, ReturnType<typeof Model>>> = new Map();
+// /**
+//  * Resolves a tenant-specific model by creating or retrieving it from the cache.
+//  * Ensures that each tenant has its own isolated model instance.
+//  *
+//  * @template T - The type of the document in the model.
+//  * @param {GetTanantModelParams<T>} param - The parameters required to resolve the model.
+//  * @param {string} param.modelName - The name of the model to resolve.
+//  * @param {AmbitenSchema<T>} [param.schema] - The schema definition for the model (optional).
+//  * @param {string} param.tenantId - The ID of the tenant for which the model is being resolved.
+//  * @returns {Promise<any>} A promise that resolves to the tenant-specific model instance.
+//  * @throws {Error} If no tenant context is found or the tenant is not registered.
+//  * @example
+//  * const userModel = await getTenantModel({
+//  *  modelName: 'User',
+//  *  schema: UserSchema,
+//  *  tenantId: 'tenant123'
+//  * });
+//  * // userModel is now a tenant-specific model for the 'User' collection in 'tenant123'
+//  * @example
+//  * const productModel = await getTenantModel({
+//  *  modelName: 'Product',
+//  *  schema: ProductSchema,
+//  *  tenantId: 'tenant456'
+//  * });
+//  */
+// export const getTenantModel = async <T extends Document>
+//   (param: GetTanantModelParams<T>): Promise<any> => {
+//   const safeCollectionName = ensureModelNameSafe(param.collectionName);
+//   const schema = param.schema;
+//   // const client = await MultiTenantManager.getClient(param.tenantId);
+//   const tenantId = param.tenantId ?? TenantContext.getTenantId();
+//   if (!tenantId) throw new Error('No tenant context found');
+//   if (!tenantModelsCache.has(tenantId)) {
+//     tenantModelsCache.set(tenantId, new Map());
+//   }
+//   const clientCache = tenantModelsCache.get(tenantId)!;
+//   if (clientCache.has(safeCollectionName)) {
+//     return clientCache.get(safeCollectionName);
+//   }
+//   const provider = tenantDbProvider(tenantId);
+//   const model = Model({
+//     collectionName: safeCollectionName,
+//     schema,
+//     provider: provider
+//   });
+//   clientCache.set(safeCollectionName, model as unknown as ReturnType<typeof Model>);
+//   return model;
+// };
+//# sourceMappingURL=TenantModelResolver.js.map

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

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

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

@@ -0,0 +1,5 @@
+export * from './MultiTenantManager';
+export * from './TenantContext';
+export * from './TenantModelResolver';
+export * from './init/initMultiTenancy';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tanancy/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC"}

package/dist/esm/tanancy/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./MultiTenantManager"), exports);
+tslib_1.__exportStar(require("./TenantContext"), exports);
+tslib_1.__exportStar(require("./TenantModelResolver"), exports);
+tslib_1.__exportStar(require("./init/initMultiTenancy"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tanancy/index.ts"],"names":[],"mappings":";;;AAAA,+DAAqC;AACrC,0DAAgC;AAChC,gEAAsC;AACtC,kEAAwC"}

package/dist/esm/tanancy/init/initMultiTenancy.d.ts

@@ -0,0 +1,29 @@
+import { AmbitenConfig } from '../../types/index';
+export interface InitMultiTenancyOptions {
+    lazy?: boolean;
+    config?: AmbitenConfig['logger'];
+}
+/**
+ * Initializes multi-tenancy by registering tenants with their respective MongoDB URIs.
+ * Supports both lazy (on-demand) and eager connection strategies.
+ *
+ * @param {Record<string, string>} tenants - A record of tenant IDs mapped to their MongoDB URIs.
+ * @param {InitMultiTenancyOptions} [options={}] - Optional configuration for multi-tenancy initialization.
+ * @param {boolean} [options.lazy=false] - If `true`, tenants are registered lazily (connected on-demand).
+ * @param {AmbitenConfig} [options.config] - Optional configuration, including a logger for logging messages.
+ * @returns {Promise<void>} A promise that resolves when all tenants are registered.
+ * @throws {Error} If a tenant's MongoDB URI is invalid or missing.
+ * @throws {Error} If a tenant is already registered and `lazy` is `false`.
+ * @example
+ * // Initialize multi-tenancy with eager connection. Practically, you should use applyMultiTenancy instead.
+ * that implements this function.
+ * await initMultiTenancy({
+ *   'tenant-a': 'mongodb://localhost:27017/tenant-a',
+ *  'tenant-b': 'mongodb://localhost:27017/tenant-b'
+ * }, {
+ *   lazy: false,
+ *  config: {}
+ */
+export declare const initMultiTenancy: (tenants: Record<string, string>, // tenantId => MongoDB URI
+options?: InitMultiTenancyOptions) => Promise<void>;
+//# sourceMappingURL=initMultiTenancy.d.ts.map

package/dist/esm/tanancy/init/initMultiTenancy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initMultiTenancy.d.ts","sourceRoot":"","sources":["../../../../src/tanancy/init/initMultiTenancy.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGlD,MAAM,WAAW,uBAAuB;IACtC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAA;CACjC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,gBAAgB,GAC3B,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,0BAA0B;AAC3D,UAAS,uBAA4B,KACpC,OAAO,CAAC,IAAI,CA2Bd,CAAC"}

package/dist/esm/tanancy/init/initMultiTenancy.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initMultiTenancy = void 0;
+const MultiTenantManager_1 = require("../MultiTenantManager");
+/**
+ * Initializes multi-tenancy by registering tenants with their respective MongoDB URIs.
+ * Supports both lazy (on-demand) and eager connection strategies.
+ *
+ * @param {Record<string, string>} tenants - A record of tenant IDs mapped to their MongoDB URIs.
+ * @param {InitMultiTenancyOptions} [options={}] - Optional configuration for multi-tenancy initialization.
+ * @param {boolean} [options.lazy=false] - If `true`, tenants are registered lazily (connected on-demand).
+ * @param {AmbitenConfig} [options.config] - Optional configuration, including a logger for logging messages.
+ * @returns {Promise<void>} A promise that resolves when all tenants are registered.
+ * @throws {Error} If a tenant's MongoDB URI is invalid or missing.
+ * @throws {Error} If a tenant is already registered and `lazy` is `false`.
+ * @example
+ * // Initialize multi-tenancy with eager connection. Practically, you should use applyMultiTenancy instead.
+ * that implements this function.
+ * await initMultiTenancy({
+ *   'tenant-a': 'mongodb://localhost:27017/tenant-a',
+ *  'tenant-b': 'mongodb://localhost:27017/tenant-b'
+ * }, {
+ *   lazy: false,
+ *  config: {}
+ */
+const initMultiTenancy = async (tenants, // tenantId => MongoDB URI
+options = {}) => {
+    const { lazy = false, config } = options;
+    for (const [tenantId, uri] of Object.entries(tenants)) {
+        if (!uri || typeof uri !== 'string' || !uri.startsWith('mongodb')) {
+            throw new Error(`Invalid MongoDB URI for tenant "${tenantId}": ${uri}`);
+        }
+        if (MultiTenantManager_1.MultiTenantManager.hasTenant(tenantId)) {
+            config?.logger?.warn?.(`Tenant "${tenantId}" is already registered. Skipping.`);
+            continue;
+        }
+        if (lazy) {
+            // Ensure logger implements all required methods for core/src/types/logger.types.ts
+            if (config?.enabled && config.logger) {
+                const logger = config.logger;
+                return logger;
+            }
+            MultiTenantManager_1.MultiTenantManager.registerLazyTenant(tenantId, uri);
+            continue;
+        }
+        else {
+            // Eagerly connect
+            await MultiTenantManager_1.MultiTenantManager.registerTenant(tenantId, uri);
+        }
+    }
+};
+exports.initMultiTenancy = initMultiTenancy;
+function impl_Logger(logger) {
+    const { info, warn, error, fatal, debug } = logger;
+    return {
+        info: info?.bind(logger) ?? (() => { }),
+        warn: warn?.bind(logger) ?? (() => { }),
+        error: error?.bind(logger) ?? (() => { }),
+        fatal: fatal?.bind(logger) ?? (() => { }),
+        debug: debug?.bind(logger) ?? (() => { }),
+    };
+}
+//# sourceMappingURL=initMultiTenancy.js.map

package/dist/esm/tanancy/init/initMultiTenancy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"initMultiTenancy.js","sourceRoot":"","sources":["../../../../src/tanancy/init/initMultiTenancy.ts"],"names":[],"mappings":";;;AAAA,8DAA2D;AAS3D;;;;;;;;;;;;;;;;;;;;GAoBG;AACI,MAAM,gBAAgB,GAAG,KAAK,EACnC,OAA+B,EAAE,0BAA0B;AAC3D,UAAmC,EAAE,EACtB,EAAE;IACjB,MAAM,EAAE,IAAI,GAAG,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IAEzC,KAAK,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACtD,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAClE,MAAM,IAAI,KAAK,CAAC,mCAAmC,QAAQ,MAAM,GAAG,EAAE,CAAC,CAAC;QAC1E,CAAC;QAED,IAAI,uCAAkB,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3C,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,WAAW,QAAQ,oCAAoC,CAAC,CAAC;YAChF,SAAS;QACX,CAAC;QAED,IAAI,IAAI,EAAE,CAAC;YACT,mFAAmF;YACnF,IAAI,MAAM,EAAE,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBACrC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAa,CAAC;gBACpC,OAAO,MAAM,CAAA;YACf,CAAC;YAED,uCAAkB,CAAC,kBAAkB,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;YACrD,SAAS;QACX,CAAC;aAAM,CAAC;YACN,kBAAkB;YAClB,MAAM,uCAAkB,CAAC,cAAc,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;AACH,CAAC,CAAC;AA9BW,QAAA,gBAAgB,oBA8B3B;AAEF,SAAS,WAAW,CAAC,MAAW;IAC9B,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;IACnD,OAAO;QACL,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACvC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACvC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACzC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACzC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;KAC1C,CAAC;AACJ,CAAC"}

package/dist/esm/templates/generateDefaultConfigContent.d.ts

@@ -0,0 +1,10 @@
+import type { AmbitenConfig } from "../types";
+export interface LoggerFormatOptions {
+    timestamp?: boolean | (() => string);
+    colorize?: boolean;
+    source?: string;
+    json?: boolean;
+    prefix?: string;
+}
+export declare function DEFAULT_CONFIG_CONTENT(options: AmbitenConfig): string;
+//# sourceMappingURL=generateDefaultConfigContent.d.ts.map

package/dist/esm/templates/generateDefaultConfigContent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateDefaultConfigContent.d.ts","sourceRoot":"","sources":["../../../src/templates/generateDefaultConfigContent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,OAAO,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC;IACrC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAGD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CA+GrE"}

package/dist/esm/templates/generateDefaultConfigContent.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_CONFIG_CONTENT = DEFAULT_CONFIG_CONTENT;
+function DEFAULT_CONFIG_CONTENT(options) {
+    const config = {
+        configVersion: '1.0.0',
+        projectName: options.projectName ?? 'my-ambiten-app',
+        connection: {
+            uri: options.connection?.uri ?? 'mongodb://localhost:27017/my-ambiten-app',
+            options: {
+                dbName: options.connection?.options?.dbName ??
+                    options.projectName ??
+                    'my-ambiten-app',
+            },
+        },
+        ...(options.multiTenant?.enabled
+            ? {
+                multiTenant: {
+                    enabled: true,
+                    headerKey: options.multiTenant.headerKey ?? 'x-tenant-id',
+                    tenants: options.multiTenant.tenants ?? {},
+                    initOptions: {
+                        lazy: options.multiTenant.initOptions?.lazy ?? false,
+                        retryAttempts: options.multiTenant.initOptions?.retryAttempts ?? 3,
+                    },
+                },
+            }
+            : {}),
+        ...(options.logger?.enabled
+            ? {
+                logger: {
+                    enabled: true,
+                    level: options.logger.level ?? 'info',
+                    colorize: options.logger.colorize ?? true,
+                    json: options.logger.json ?? false,
+                    transportConfigs: [
+                        {
+                            "type": "console",
+                            "options": {}
+                        },
+                        {
+                            "type": "rotating-file",
+                            "options": {
+                                "filename": "./logs/ambiten.log",
+                                "frequency": "hourly",
+                                "maxSize": 200,
+                                "compress": false,
+                                "flushInterval": 1000
+                            }
+                        }
+                    ],
+                    enableMetrics: typeof options.logger.enableMetrics === 'boolean'
+                        ? {
+                            enabled: options.logger.enableMetrics,
+                            logInterval: 60000,
+                        }
+                        : options.logger.enableMetrics ?? {
+                            enabled: false,
+                            logInterval: 60000,
+                        },
+                    compress: typeof options.logger.compress === 'boolean'
+                        ? {
+                            enabled: options.logger.compress,
+                        }
+                        : options.logger.compress ?? {
+                            enabled: false,
+                        },
+                }
+            }
+            : {}),
+        ...(options.graphql?.enabled
+            ? {
+                graphql: {
+                    enabled: true,
+                    subscriptions: options.graphql.subscriptions ?? false,
+                    playground: options.graphql.playground ?? true,
+                    schemaOutputPath: options.graphql.schemaOutputPath ?? './src/graphql/schema.gql',
+                },
+            }
+            : {}),
+        features: {
+            models: options.features?.models ?? './src/models',
+            schemas: options.features?.schemas ?? './src/schemas',
+            ...(options.graphql?.enabled
+                ? {
+                    typeDefs: options.features?.typeDefs ?? './src/graphql/typeDefs',
+                    resolvers: options.features?.resolvers ?? './src/graphql/resolvers',
+                }
+                : {}),
+            useRedisCache: options.features?.useRedisCache ?? false,
+            redisUri: options.features?.redisUri ?? '',
+        },
+        advanced: {
+            autoInstall: options.advanced?.autoInstall ?? false,
+            circuitBreaker: {
+                enabled: options.advanced?.circuitBreaker?.enabled ?? true,
+                retryAttempts: options.advanced?.circuitBreaker?.retryAttempts ?? 5,
+            },
+            garbageCollector: {
+                enabled: options.advanced?.garbageCollector?.enabled ?? false,
+                retentionPeriod: options.advanced?.garbageCollector?.retentionPeriod ?? 30,
+                logResults: options.advanced?.garbageCollector?.logResults ?? true,
+            },
+            gcCron: options.advanced?.gcCron ?? '* * * * *',
+        },
+    };
+    return JSON.stringify(config, null, 2);
+}
+//# sourceMappingURL=generateDefaultConfigContent.js.map

package/dist/esm/templates/generateDefaultConfigContent.js.map

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

package/dist/esm/templates/generateGCManagerFile.d.ts

@@ -0,0 +1,2 @@
+export declare function generateGCManager(): string;
+//# sourceMappingURL=generateGCManagerFile.d.ts.map

package/dist/esm/templates/generateGCManagerFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateGCManagerFile.d.ts","sourceRoot":"","sources":["../../../src/templates/generateGCManagerFile.ts"],"names":[],"mappings":"AAAA,wBAAgB,iBAAiB,IAAI,MAAM,CAmC1C"}

package/dist/esm/templates/generateGCManagerFile.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateGCManager = generateGCManager;
+function generateGCManager() {
+    return `import { AmbitenModel } from '@ambiten/core';
+import { ObjectId } from 'mongodb';
+
+export interface GarbageCollectorOptions {
+  /**
+   * Retention period in days.
+   */
+  retentionPeriod?: number;
+  dateField?: string;
+}
+
+export async function runGarbageCollector(
+  model: AmbitenModel<any>,
+  options: GarbageCollectorOptions = {}
+): Promise<void> {
+  const retentionPeriod = options.retentionPeriod ?? 7;
+  const dateField = options.dateField ?? 'deletedAt';
+
+  const cutoff = new Date(
+    Date.now() - retentionPeriod * 24 * 60 * 60 * 1000
+  );
+
+  const expiredDocs = await model.find({
+    [dateField]: { $lt: cutoff }
+  });
+
+  for (const doc of expiredDocs) {
+    await model.deleteOne({ _id: new ObjectId(doc._id) });
+    console.log(\`🗑️ Deleted expired document: \${doc._id}\`);
+  }
+
+  console.log('✅ Garbage collection completed.');
+}
+`;
+}
+//# sourceMappingURL=generateGCManagerFile.js.map

package/dist/esm/templates/generateGCManagerFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateGCManagerFile.js","sourceRoot":"","sources":["../../../src/templates/generateGCManagerFile.ts"],"names":[],"mappings":";;AAAA,8CAmCC;AAnCD,SAAgB,iBAAiB;IAC/B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiCR,CAAC;AACF,CAAC"}

package/dist/esm/templates/generateGCRunnerFile.d.ts

@@ -0,0 +1,2 @@
+export declare function generateGCRunner(): string;
+//# sourceMappingURL=generateGCRunnerFile.d.ts.map

package/dist/esm/templates/generateGCRunnerFile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateGCRunnerFile.d.ts","sourceRoot":"","sources":["../../../src/templates/generateGCRunnerFile.ts"],"names":[],"mappings":"AAAA,wBAAgB,gBAAgB,IAAI,MAAM,CAqBzC"}

package/dist/esm/templates/generateGCRunnerFile.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateGCRunner = generateGCRunner;
+function generateGCRunner() {
+    return `/**
+ * Garbage collector runner
+ *
+ * Replace the imports below with your actual bootstrap/model entry points.
+ */
+
+import { runGarbageCollector } from './gcManager';
+// import { UserModel } from '../models/UserModel';
+
+async function main() {
+  // Example:
+  // await runGarbageCollector(UserModel, { retentionPeriod: 7 });
+  console.log('⚠️  Update gcRunner.ts with your model imports before using it.');
+}
+
+main().catch((error) => {
+  console.error('❌ Garbage collector failed:', error);
+  process.exit(1);
+});
+`;
+}
+//# sourceMappingURL=generateGCRunnerFile.js.map

package/dist/esm/templates/generateGCRunnerFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateGCRunnerFile.js","sourceRoot":"","sources":["../../../src/templates/generateGCRunnerFile.ts"],"names":[],"mappings":";;AAAA,4CAqBC;AArBD,SAAgB,gBAAgB;IAC9B,OAAO;;;;;;;;;;;;;;;;;;;CAmBR,CAAC;AACF,CAAC"}

package/dist/esm/templates/generateMainEntry.d.ts

@@ -0,0 +1,3 @@
+import type { AmbitenConfig } from '../types';
+export declare function generateMainTS(options: AmbitenConfig): string;
+//# sourceMappingURL=generateMainEntry.d.ts.map

package/dist/esm/templates/generateMainEntry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateMainEntry.d.ts","sourceRoot":"","sources":["../../../src/templates/generateMainEntry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,wBAAgB,cAAc,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAoB7D"}

package/dist/esm/templates/generateMainEntry.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateMainTS = generateMainTS;
+function generateMainTS(options) {
+    return `import { run } from './core/initAmbiten';
+
+async function main() {
+  const app = await run();
+
+  if (typeof app?.onConnect === 'function') {
+     app.onConnect(() => {
+      console.log('✅ Ambiten application initialized successfully.');
+    });
+  }
+
+  return app;
+}
+
+main().catch((error) => {
+  console.error('❌ Failed to start application:', error);
+  process.exit(1);
+});
+`;
+}
+//# sourceMappingURL=generateMainEntry.js.map

package/dist/esm/templates/generateMainEntry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateMainEntry.js","sourceRoot":"","sources":["../../../src/templates/generateMainEntry.ts"],"names":[],"mappings":";;AAEA,wCAoBC;AApBD,SAAgB,cAAc,CAAC,OAAsB;IACnD,OAAO;;;;;;;;;;;;;;;;;;CAkBR,CAAC;AACF,CAAC"}

package/dist/esm/templates/index.d.ts

@@ -0,0 +1,6 @@
+export * from './generateDefaultConfigContent';
+export * from './generateMainEntry';
+export * from './scaffold/structureGenerator';
+export * from './generateGCManagerFile';
+export * from './generateGCRunnerFile';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/templates/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/index.ts"],"names":[],"mappings":"AAAA,cAAc,gCAAgC,CAAC;AAC/C,cAAc,qBAAqB,CAAC;AACpC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,yBAAyB,CAAC;AACxC,cAAc,wBAAwB,CAAC"}

package/dist/esm/templates/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./generateDefaultConfigContent"), exports);
+tslib_1.__exportStar(require("./generateMainEntry"), exports);
+tslib_1.__exportStar(require("./scaffold/structureGenerator"), exports);
+tslib_1.__exportStar(require("./generateGCManagerFile"), exports);
+tslib_1.__exportStar(require("./generateGCRunnerFile"), exports);
+//# sourceMappingURL=index.js.map

package/dist/esm/templates/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/index.ts"],"names":[],"mappings":";;;AAAA,yEAA+C;AAC/C,8DAAoC;AACpC,wEAA8C;AAC9C,kEAAwC;AACxC,iEAAuC"}

package/dist/esm/templates/scaffold/structureGenerator.d.ts

@@ -0,0 +1,4 @@
+import type { AmbitenConfig } from '../../types';
+import { createScaffoldLogger } from '../../utils';
+export declare function generateAppStructure(projectRoot: string, options: AmbitenConfig, logger?: ReturnType<typeof createScaffoldLogger>): Promise<void>;
+//# sourceMappingURL=structureGenerator.d.ts.map

package/dist/esm/templates/scaffold/structureGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structureGenerator.d.ts","sourceRoot":"","sources":["../../../../src/templates/scaffold/structureGenerator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAEL,oBAAoB,EAGrB,MAAM,aAAa,CAAC;AAkGrB,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,aAAa,EACtB,MAAM,CAAC,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,GAC/C,OAAO,CAAC,IAAI,CAAC,CAsJf"}