@ambiten/core 1.0.0

package/dist/templates/generateDefaultConfigContent.js

@@ -0,0 +1,108 @@
+"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);
+}

package/dist/templates/generateGCManagerFile.d.ts

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

package/dist/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/templates/generateGCManagerFile.js

@@ -0,0 +1,39 @@
+"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.');
+}
+`;
+}

package/dist/templates/generateGCRunnerFile.d.ts

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

package/dist/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/templates/generateGCRunnerFile.js

@@ -0,0 +1,25 @@
+"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);
+});
+`;
+}

package/dist/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/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/templates/generateMainEntry.js

@@ -0,0 +1,24 @@
+"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);
+});
+`;
+}

package/dist/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/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/templates/index.js

@@ -0,0 +1,8 @@
+"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);

package/dist/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/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"}

package/dist/templates/scaffold/structureGenerator.js

@@ -0,0 +1,193 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateAppStructure = generateAppStructure;
+const tslib_1 = require("tslib");
+const fs_extra_1 = tslib_1.__importDefault(require("fs-extra"));
+const path_1 = tslib_1.__importDefault(require("path"));
+const utils_1 = require("../../utils");
+const generateMainEntry_1 = require("../generateMainEntry");
+const generateDefaultConfigContent_1 = require("../generateDefaultConfigContent");
+const generateGCManagerFile_1 = require("../generateGCManagerFile");
+const generateGCRunnerFile_1 = require("../generateGCRunnerFile");
+function buildPackageJson(options) {
+    const dependencies = {
+        '@ambiten/core': '^1.0.0',
+        mongodb: '^6.14.2',
+    };
+    if (options.logger?.enabled) {
+        dependencies['@ambiten/logger'] = '^1.0.0';
+    }
+    if (options.graphql?.enabled) {
+        dependencies['graphql'] = '^16.11.0';
+        dependencies['@apollo/server'] = '^5.1.0';
+    }
+    if (options.features?.useRedisCache) {
+        dependencies['redis'] = '^4.7.1';
+    }
+    return {
+        name: options.projectName ?? 'my-ambiten-app',
+        description: 'A Ambiten-powered application',
+        private: true,
+        version: '1.0.0',
+        type: 'commonjs',
+        main: 'dist/main.js',
+        scripts: {
+            dev: 'ts-node src/main.ts',
+            build: 'tsc',
+            start: 'node dist/main.js',
+        },
+        license: 'ISC',
+        dependencies,
+        devDependencies: {
+            typescript: '^5.9.3',
+            'ts-node': '^10.9.2',
+            '@types/node': '^22.15.30',
+        },
+    };
+}
+function buildTsConfig() {
+    return {
+        compilerOptions: {
+            "target": "ES2021",
+            "module": "commonjs",
+            "moduleResolution": "node",
+            "rootDir": './src',
+            "outDir": './dist',
+            "sourceMap": true,
+            "declaration": true,
+            "declarationMap": true,
+            "esModuleInterop": true,
+            "resolveJsonModule": true,
+            "strict": true,
+            "noImplicitAny": true,
+            "noImplicitReturns": true,
+            "noUncheckedIndexedAccess": true,
+            "exactOptionalPropertyTypes": true,
+            "forceConsistentCasingInFileNames": true,
+            "skipLibCheck": true,
+            types: ['node'],
+            lib: ['ES2021']
+        },
+        include: ['src/**/*'],
+        exclude: ['node_modules', 'dist']
+    };
+}
+function generateInitAmbitenTS() {
+    return `import { AmbitenBootstrapFactory } from '@ambiten/core';
+import type { AmbitenRuntime } from '@ambiten/core';
+
+export async function run(): Promise<AmbitenRuntime> {
+  return AmbitenBootstrapFactory.create();
+}
+`;
+}
+function generateGraphqlStarterTS() {
+    return `/**
+ * Optional GraphQL starter file.
+ *
+ * Use this file if you want to separate GraphQL setup from your bootstrap flow.
+ * If your bootstrap already initializes GraphQL, this file can be removed.
+ */
+
+export {};
+`;
+}
+async function generateAppStructure(projectRoot, options, logger) {
+    const srcDir = path_1.default.join(projectRoot, 'src');
+    const coreDir = path_1.default.join(srcDir, 'core');
+    const utilsDir = path_1.default.join(srcDir, 'utils');
+    const typesDir = path_1.default.join(srcDir, 'types');
+    const modelsDir = path_1.default.join(srcDir, 'models');
+    const graphqlDir = path_1.default.join(srcDir, 'graphql');
+    const gcDir = path_1.default.join(srcDir, 'gc');
+    await fs_extra_1.default.ensureDir(srcDir);
+    logger?.addDir(srcDir);
+    await fs_extra_1.default.ensureDir(coreDir);
+    logger?.addDir(coreDir);
+    await fs_extra_1.default.ensureDir(utilsDir);
+    logger?.addDir(utilsDir);
+    await fs_extra_1.default.ensureDir(typesDir);
+    logger?.addDir(typesDir);
+    await fs_extra_1.default.ensureDir(modelsDir);
+    logger?.addDir(modelsDir);
+    if (options.graphql?.enabled) {
+        await fs_extra_1.default.ensureDir(graphqlDir);
+        logger?.addDir(graphqlDir);
+    }
+    if (options.advanced?.garbageCollector?.enabled) {
+        await fs_extra_1.default.ensureDir(gcDir);
+        logger?.addDir(gcDir);
+    }
+    const mainPath = path_1.default.join(srcDir, 'main.ts');
+    await fs_extra_1.default.writeFile(mainPath, (0, generateMainEntry_1.generateMainTS)(options));
+    logger?.addFile(mainPath);
+    const initAmbitenPath = path_1.default.join(coreDir, 'initAmbiten.ts');
+    await fs_extra_1.default.writeFile(initAmbitenPath, generateInitAmbitenTS());
+    logger?.addFile(initAmbitenPath);
+    const helperPath = path_1.default.join(utilsDir, 'helper.ts');
+    await fs_extra_1.default.writeFile(helperPath, `export function noop(): void {}\n`);
+    logger?.addFile(helperPath);
+    const configTypesPath = path_1.default.join(typesDir, 'config.ts');
+    await fs_extra_1.default.writeFile(configTypesPath, `export {};\n`);
+    logger?.addFile(configTypesPath);
+    if (options.graphql?.enabled) {
+        const schemaPath = path_1.default.join(graphqlDir, 'schema.gql');
+        await fs_extra_1.default.writeFile(schemaPath, `type Query {
+  hello: String
+}
+`);
+        logger?.addFile(schemaPath);
+        const resolversPath = path_1.default.join(graphqlDir, 'resolvers.ts');
+        await fs_extra_1.default.writeFile(resolversPath, `export const resolvers = {
+  Query: {
+    hello: () => 'Hello, world!',
+  },
+};
+`);
+        logger?.addFile(resolversPath);
+        await fs_extra_1.default.writeFile(path_1.default.join(graphqlDir, 'graphql.ts'), generateGraphqlStarterTS());
+    }
+    if (options.advanced?.garbageCollector?.enabled) {
+        const gcManagerPath = path_1.default.join(gcDir, 'gcManager.ts');
+        await fs_extra_1.default.writeFile(gcManagerPath, (0, generateGCManagerFile_1.generateGCManager)());
+        logger?.addFile(gcManagerPath);
+        const gcRunnerPath = path_1.default.join(gcDir, 'gcRunner.ts');
+        await fs_extra_1.default.writeFile(gcRunnerPath, (0, generateGCRunnerFile_1.generateGCRunner)());
+        logger?.addFile(gcRunnerPath);
+    }
+    const configPath = path_1.default.join(projectRoot, 'ambiten.config.json');
+    await fs_extra_1.default.writeFile(configPath, (0, generateDefaultConfigContent_1.DEFAULT_CONFIG_CONTENT)(options));
+    logger?.addFile(configPath);
+    const packageJsonPath = path_1.default.join(projectRoot, 'package.json');
+    await fs_extra_1.default.writeJson(packageJsonPath, buildPackageJson(options), { spaces: 2 });
+    logger?.addFile(packageJsonPath);
+    const tsconfigPath = path_1.default.join(projectRoot, 'tsconfig.json');
+    await fs_extra_1.default.writeJson(tsconfigPath, buildTsConfig(), { spaces: 2 });
+    logger?.addFile(tsconfigPath);
+    const gitignorePath = path_1.default.join(projectRoot, '.gitignore');
+    await fs_extra_1.default.writeFile(gitignorePath, `node_modules
+dist
+lib
+.store
+.env
+`);
+    logger?.addFile(gitignorePath);
+    if (options.advanced?.autoInstall) {
+        const packageManager = (0, utils_1.detectPackageManager)(projectRoot);
+        try {
+            await (0, utils_1.installPackages)([], projectRoot);
+            console.log((0, utils_1.colorize)(`[Installing dependencies]: Installed project dependencies using ${packageManager}.`, 'green'));
+        }
+        catch (error) {
+            console.log((0, utils_1.colorize)('⚠️  Dependency installation failed or was interrupted. Skipping install.', 'yellow'), error);
+        }
+    }
+    else {
+        const packageManager = (0, utils_1.detectPackageManager)(projectRoot);
+        const installCommand = packageManager === 'npm'
+            ? 'npm install'
+            : `${packageManager} install`;
+        console.log((0, utils_1.colorize)('[Skipping install]: Set advanced.autoInstall=true to install dependencies automatically.', 'blue'));
+        console.log((0, utils_1.colorize)(`[Next steps]: cd ${projectRoot} && ${installCommand}`, 'blue'));
+    }
+}

package/dist/types/GCConfig.d.ts

@@ -0,0 +1,7 @@
+export type GCConfig = {
+    ttlField: string;
+    expiresIn: string;
+    softDelete?: boolean;
+    archiveBeforeDelete?: boolean;
+};
+//# sourceMappingURL=GCConfig.d.ts.map

package/dist/types/GCConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GCConfig.d.ts","sourceRoot":"","sources":["../../src/types/GCConfig.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B,CAAC"}

package/dist/types/GCConfig.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/ambiten-runtime-type.d.ts

@@ -0,0 +1,24 @@
+import { ILogger } from "@ambiten/logger";
+import { AmbitenClient, AmbitenModel, AmbitenSchema } from "../lib-core";
+import { AmbitenGraphQL } from "../graphql";
+import { AmbitenGC } from "../gc";
+import { Document } from "./document";
+import { BootstrapClient } from "./bootstrapClient.type";
+import { AmbitenCacheOptions } from "../ambiten-cache";
+export interface AmbitenRuntime<T extends Document = Document> {
+    getMongoClient(): AmbitenClient | BootstrapClient;
+    onConnect(hook: any): void;
+    getModel(): AmbitenModel<T>;
+    getSchema(): AmbitenSchema<T>;
+    getGraphQL(): AmbitenGraphQL | undefined;
+    getGCRunner(): AmbitenGC | undefined;
+    getLogger(): ILogger;
+    registerMultiTenancy(options: {
+        tenants?: Record<string, string>;
+        lazy?: boolean;
+    }): Promise<void>;
+    cache<T>(key: string, fetcher: () => Promise<T>, options?: AmbitenCacheOptions): Promise<T>;
+    invalidateCache(tenantId: string, namespace?: string): Promise<void>;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=ambiten-runtime-type.d.ts.map

package/dist/types/ambiten-runtime-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ambiten-runtime-type.d.ts","sourceRoot":"","sources":["../../src/types/ambiten-runtime-type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EACN,aAAa,EACb,YAAY,EACZ,aAAa,EAEb,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,QAAQ,GAAG,QAAQ;IAC5D,cAAc,IAAI,aAAa,GAAG,eAAe,CAAA;IAEjD,SAAS,CAAC,IAAI,KAAA,GAAG,IAAI,CAAA;IACrB,QAAQ,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC;IAE5B,SAAS,IAAI,aAAa,CAAC,CAAC,CAAC,CAAC;IAE9B,UAAU,IAAI,cAAc,GAAG,SAAS,CAAC;IAEzC,WAAW,IAAI,SAAS,GAAG,SAAS,CAAC;IACrC,SAAS,IAAI,OAAO,CAAC;IAErB,oBAAoB,CAAC,OAAO,EAAE;QAC7B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,IAAI,CAAC,EAAE,OAAO,CAAC;KACf,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElB,KAAK,CAAC,CAAC,EACN,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,OAAO,CAAC,EAAE,mBAAmB,GAC3B,OAAO,CAAC,CAAC,CAAC,CAAC;IAEd,eAAe,CACd,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B"}

package/dist/types/ambiten-runtime-type.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/ambiten.client.type.d.ts

@@ -0,0 +1,136 @@
+import { ClientSession, Collection, Db, MongoClient } from "mongodb";
+import { AmbitenConfig } from "./ambitenConfig.js";
+import { Document } from "./document.js";
+/**
+ * Configuration options for the AmbitenClient.
+ */
+export interface AmbitenClientConfig {
+    /**
+     * The MongoDB connection URI.
+     */
+    uri: string;
+    /**
+     * Optional configuration options for the client.
+     */
+    options?: AmbitenClientOptions;
+    /**
+     * An optional MongoClient instance.
+     */
+    tenantResolver?: TenantClientResolver;
+}
+export interface TenantClientResolver {
+    getClient(tenantId: string): Promise<MongoClient | null>;
+}
+export interface AmbitenResolvedClientScope {
+    tenantId?: string;
+    requestId?: string;
+    dbName: string;
+    collectionName?: string;
+    session?: ClientSession;
+}
+/**
+ * Options for configuring the AmbitenClient.
+ */
+export interface AmbitenClientOptions {
+    /**
+     * The name of the database to connect to.
+     */
+    dbName?: string;
+    /**
+     * The name of the collection to use.
+     */
+    collectionName?: string;
+    /**
+     * An optional MongoClient instance.
+     */
+    client?: MongoClient;
+    /**
+     * Optional configuration for Ambiten.
+     */
+    config?: AmbitenConfig;
+}
+/**
+ * Represents the AmbitenClient interface for interacting with MongoDB.
+ * @template T - The type of the document in the collection.
+ */
+export interface AmbitenClientType<T extends Document> {
+    /**
+     * The MongoDB connection URI.
+     */
+    uri: string;
+    /**
+     * Connects to the MongoDB database.
+     * @returns {Promise<Db>} A promise that resolves to the connected database instance.
+     */
+    connect(): Promise<Db>;
+    /**
+     * Drops the entire database.
+     * @returns {Promise<boolean>} A promise that resolves to `true` if the database is dropped successfully.
+     */
+    dropDatabase(): Promise<boolean>;
+    /**
+     * Retrieves the current database instance.
+     * @returns {Db} The connected database instance.
+     */
+    getDb(): Db;
+    /**
+     * Retrieves a collection by name.
+     * @param {string} collectionName - The name of the collection.
+     * @returns {Promise<Collection<T>>} A promise that resolves to the collection instance.
+     */
+    collection(collectionName: string): Promise<Collection<T>>;
+    /**
+     * Retrieves a collection by name.
+     * @param {string} name - The name of the collection.
+     * @returns {Promise<Collection<T>>} A promise that resolves to the collection instance.
+     */
+    getCollection(name: string): Promise<Collection<T>>;
+    /**
+     * Retrieves the database instance for a specific tenant.
+     * @param {string} tenantId - The ID of the tenant.
+     * @returns {Db} The database instance for the tenant.
+     */
+    getTenantDB(tenantId: string): Db;
+    /**
+     * Sets the MongoDB driver.
+     * @param {any} mongodbDriver - The MongoDB driver to set.
+     */
+    setDriver(mongodbDriver: any): void;
+    /**
+     * Retrieves a collection for a specific tenant.
+     * @param {string} tenantId - The ID of the tenant.
+     * @param {string} collectionName - The name of the collection.
+     * @returns {Promise<Collection<T>>} A promise that resolves to the collection instance.
+     */
+    getTenantCollection(tenantId: string, collectionName: string): Promise<Collection<T>>;
+    /**
+     * Retrieves the database instance for a specific tenant and URI.
+     * @param {string} tenantId - The ID of the tenant.
+     * @param {string} uri - The MongoDB connection URI.
+     * @returns {Promise<{db: Db, client: MongoClient}>} A promise that resolves to the database instance and its MongoClient.
+     */
+    getDatabase(tenantId: string, uri: string): Promise<{
+        db: Db;
+        client: MongoClient;
+    }>;
+    /**
+     * Switches to a different database by name.
+     * @param {string} dbName - The name of the database to switch to.
+     * @returns {Promise<{db: Db, client: MongoClient}>} A promise that resolves to the new database instance and its MongoClient.
+     */
+    useDatabase(dbName: string): Promise<{
+        db: Db;
+        client: MongoClient;
+    }>;
+    /**
+     * Validates the MongoDB connection URI.
+     * @param {string} uri - The MongoDB connection URI.
+     */
+    validateUri(uri: string): void;
+    /**
+     * Retrieves the MongoClient instance.
+     * @returns {MongoClient} The MongoClient instance.
+     */
+    getClient(): MongoClient;
+}
+//# sourceMappingURL=ambiten.client.type.d.ts.map

package/dist/types/ambiten.client.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ambiten.client.type.d.ts","sourceRoot":"","sources":["../../src/types/ambiten.client.type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,EAAE,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;GAEG;AACH,MAAM,WAAW,mBAAmB;IACnC;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;OAEG;IACH,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAE/B;;OAEG;IACH,cAAc,CAAC,EAAE,oBAAoB,CAAC;CACtC;AAED,MAAM,WAAW,oBAAoB;IACpC,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;CACzD;AAED,MAAM,WAAW,0BAA0B;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,aAAa,CAAC;CACxB;AAMD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IAErB;;OAEG;IACH,MAAM,CAAC,EAAE,aAAa,CAAC;CACvB;AAGD;;;GAGG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,QAAQ;IACpD;;OAEG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,EAAE,CAAC,CAAC;IAEvB;;;OAGG;IACH,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAEjC;;;OAGG;IACH,KAAK,IAAI,EAAE,CAAC;IAEZ;;;;OAIG;IACH,UAAU,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAE3D;;;;OAIG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAEpD;;;;OAIG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,EAAE,CAAC;IAElC;;;OAGG;IACH,SAAS,CAAC,aAAa,EAAE,GAAG,GAAG,IAAI,CAAC;IAEpC;;;;;OAKG;IACH,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAEtF;;;;;OAKG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,EAAE,CAAC;QAAC,MAAM,EAAE,WAAW,CAAA;KAAE,CAAC,CAAC;IAErF;;;;OAIG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,EAAE,CAAC;QAAC,MAAM,EAAE,WAAW,CAAA;KAAE,CAAC,CAAC;IAEtE;;;OAGG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAE/B;;;OAGG;IACH,SAAS,IAAI,WAAW,CAAC;CACzB"}

package/dist/types/ambiten.client.type.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+;