@ambiten/core 1.0.0

package/dist/utils/resolveRuntimeConfig.d.ts

@@ -0,0 +1,22 @@
+import type { ClientSession } from 'mongodb';
+export interface RuntimeResolutionInput {
+    methodTenantId?: string;
+    methodDbName?: string;
+    methodCollectionName?: string;
+    methodSession?: ClientSession;
+    modelTenantId?: string;
+    modelDbName?: string;
+    modelCollectionName?: string;
+    modelSession?: ClientSession;
+    clientDbName?: string;
+}
+export interface RuntimeResolutionOutput {
+    tenantId?: string;
+    dbName?: string;
+    collectionName?: string;
+    session?: ClientSession;
+    requestId?: string;
+    loggerMeta?: Record<string, any>;
+}
+export declare function resolveRuntimeConfig(input: RuntimeResolutionInput): RuntimeResolutionOutput;
+//# sourceMappingURL=resolveRuntimeConfig.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resolveRuntimeConfig.d.ts","sourceRoot":"","sources":["../../src/utils/resolveRuntimeConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAI7C,MAAM,WAAW,sBAAsB;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,aAAa,CAAC,EAAE,aAAa,CAAC;IAE9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,YAAY,CAAC,EAAE,aAAa,CAAC;IAE7B,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACjC;AAED,wBAAgB,oBAAoB,CACnC,KAAK,EAAE,sBAAsB,GAC3B,uBAAuB,CA4BzB"}

package/dist/utils/resolveRuntimeConfig.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveRuntimeConfig = resolveRuntimeConfig;
+const context_1 = require("../context");
+const resolveAmbitenOption_1 = require("./resolveAmbitenOption");
+function resolveRuntimeConfig(input) {
+    const ctx = context_1.AmbitenContext.get();
+    return {
+        tenantId: (0, resolveAmbitenOption_1.resolveAmbitenOption)([
+            input.methodTenantId,
+            ctx?.tenantId,
+            input.modelTenantId
+        ]),
+        dbName: (0, resolveAmbitenOption_1.resolveAmbitenOption)([
+            input.methodDbName,
+            ctx?.dbName,
+            input.modelDbName,
+            input.clientDbName
+        ]),
+        collectionName: (0, resolveAmbitenOption_1.resolveAmbitenOption)([
+            input.methodCollectionName,
+            ctx?.collectionName,
+            input.modelCollectionName
+        ]),
+        session: (0, resolveAmbitenOption_1.resolveAmbitenOption)([
+            input.methodSession,
+            ctx?.session,
+            input.modelSession
+        ]),
+        requestId: ctx?.requestId,
+        loggerMeta: ctx?.loggerMeta
+    };
+}

package/dist/utils/scaffoldLoger.d.ts

@@ -0,0 +1,11 @@
+import type { AmbitenConfig } from '../types';
+export interface ScaffoldLog {
+    files: string[];
+    dirs: string[];
+}
+export declare function createScaffoldLogger(projectRoot: string): {
+    addFile(filePath: string): void;
+    addDir(dirPath: string): void;
+    printSummary(projectName: string, options: AmbitenConfig, durationMs: number): void;
+};
+//# sourceMappingURL=scaffoldLoger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scaffoldLoger.d.ts","sourceRoot":"","sources":["../../src/utils/scaffoldLoger.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAE9C,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM;sBAUlC,MAAM;oBAIR,MAAM;8BAII,MAAM,WAAW,aAAa,cAAc,MAAM;EAuD/E"}

package/dist/utils/scaffoldLoger.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createScaffoldLogger = createScaffoldLogger;
+const tslib_1 = require("tslib");
+const path_1 = tslib_1.__importDefault(require("path"));
+const color_palatte_1 = require("./color-palatte");
+function createScaffoldLogger(projectRoot) {
+    const log = {
+        files: [],
+        dirs: [],
+    };
+    const normalize = (p) => path_1.default.relative(projectRoot, p).replace(/\\/g, '/');
+    return {
+        addFile(filePath) {
+            log.files.push(normalize(filePath));
+        },
+        addDir(dirPath) {
+            log.dirs.push(normalize(dirPath) + '/');
+        },
+        printSummary(projectName, options, durationMs) {
+            const enabledFeatures = [
+                options.multiTenant?.enabled ? 'Multi-tenancy' : null,
+                options.graphql?.enabled ? 'GraphQL' : null,
+                options.logger?.enabled ? 'Logger' : null,
+                options.features?.useRedisCache ? 'Redis Cache' : null,
+                options.advanced?.garbageCollector?.enabled ? 'Garbage Collector' : null,
+            ].filter(Boolean);
+            const disabledFeatures = [
+                !options.multiTenant?.enabled ? 'Multi-tenancy' : null,
+                !options.graphql?.enabled ? 'GraphQL' : null,
+                !options.logger?.enabled ? 'Logger' : null,
+                !options.features?.useRedisCache ? 'Redis Cache' : null,
+                !options.advanced?.garbageCollector?.enabled ? 'Garbage Collector' : null,
+            ].filter(Boolean);
+            const seconds = (durationMs / 1000).toFixed(2);
+            console.log('');
+            console.log((0, color_palatte_1.colorize)(`✔ Project scaffold completed in ${seconds}s`, 'green'));
+            console.log('');
+            if (log.dirs.length) {
+                console.log((0, color_palatte_1.colorize)('Directories:', 'blue'));
+                log.dirs.forEach((d) => {
+                    console.log((0, color_palatte_1.colorize)(`  + ${d}`, 'green'));
+                });
+                console.log('');
+            }
+            if (log.files.length) {
+                console.log((0, color_palatte_1.colorize)('Files:', 'blue'));
+                log.files.forEach((f) => {
+                    console.log((0, color_palatte_1.colorize)(`  + ${f}`, 'green'));
+                });
+                console.log('');
+            }
+            console.log((0, color_palatte_1.colorize)('Feature summary:', 'blue'));
+            enabledFeatures.forEach((feature) => {
+                console.log((0, color_palatte_1.colorize)(`  ✓ ${feature}`, 'green'));
+            });
+            disabledFeatures.forEach((feature) => {
+                console.log((0, color_palatte_1.colorize)(`  ✗ ${feature}`, 'yellow'));
+            });
+            console.log('');
+            console.log((0, color_palatte_1.colorize)('Next steps:', 'blue'));
+            console.log((0, color_palatte_1.colorize)(`  cd ${projectName}`, 'green'));
+            console.log((0, color_palatte_1.colorize)(`  pnpm install`, 'green'));
+            console.log((0, color_palatte_1.colorize)(`  pnpm dev`, 'green'));
+            console.log('');
+        },
+    };
+}

package/dist/utils/symbols.d.ts

@@ -0,0 +1,4 @@
+export declare const AmbitenSymbol: unique symbol;
+export declare const schemaTypeSymbol: unique symbol;
+export declare const objectIdSymbol: unique symbol;
+//# sourceMappingURL=symbols.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"symbols.d.ts","sourceRoot":"","sources":["../../src/utils/symbols.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,eAAoB,CAAC;AAC/C,eAAO,MAAM,gBAAgB,eAA8B,CAAC;AAC5D,eAAO,MAAM,cAAc,eAAgC,CAAC"}

package/dist/utils/symbols.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.objectIdSymbol = exports.schemaTypeSymbol = exports.AmbitenSymbol = void 0;
+exports.AmbitenSymbol = Symbol('Ambiten');
+exports.schemaTypeSymbol = Symbol('AmbitenSchemaType');
+exports.objectIdSymbol = Symbol.for('AmbitenObjectId');

package/dist/utils/time.d.ts

@@ -0,0 +1,5 @@
+export declare const parseDuration: (duration: string) => number;
+export declare const formatDuration: (ms: number) => string;
+export declare const isValidDuration: (duration: string) => boolean;
+export declare const now: Date;
+//# sourceMappingURL=time.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"time.d.ts","sourceRoot":"","sources":["../../src/utils/time.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,GAAI,UAAU,MAAM,KAAG,MAgBhD,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,IAAI,MAAM,KAAG,MAU3C,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,UAAU,MAAM,KAAG,OAElD,CAAC;AAGF,eAAO,MAAM,GAAG,MAAa,CAAC"}

package/dist/utils/time.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.now = exports.isValidDuration = exports.formatDuration = exports.parseDuration = void 0;
+const parseDuration = (duration) => {
+    const match = duration.match(/^(\d+)([smhd])$/);
+    const isValid = (0, exports.isValidDuration)(duration);
+    if (!match || !isValid) {
+        throw new Error(`Invalid duration format: ${duration}. Expected format is <number><unit> where unit is one of 's', 'm', 'h', or 'd'.`);
+    }
+    const value = parseInt(match[1], 10);
+    const unit = match[2];
+    switch (unit) {
+        case 's': return value * 1000; // seconds to milliseconds
+        case 'm': return value * 60 * 1000; // minutes to milliseconds
+        case 'h': return value * 60 * 60 * 1000; // hours to milliseconds
+        case 'd': return value * 24 * 60 * 60 * 1000; // days to milliseconds
+        default: throw new Error(`Unknown time unit: ${unit}`);
+    }
+};
+exports.parseDuration = parseDuration;
+const formatDuration = (ms) => {
+    const seconds = Math.floor(ms / 1000);
+    const minutes = Math.floor(seconds / 60);
+    const hours = Math.floor(minutes / 60);
+    const days = Math.floor(hours / 24);
+    if (days > 0)
+        return `${days}d`;
+    if (hours > 0)
+        return `${hours}h`;
+    if (minutes > 0)
+        return `${minutes}m`;
+    return `${seconds}s`;
+};
+exports.formatDuration = formatDuration;
+const isValidDuration = (duration) => {
+    return /^(\d+)([smhd])$/.test(duration);
+};
+exports.isValidDuration = isValidDuration;
+exports.now = new Date();

package/package.json

@@ -0,0 +1,180 @@
+{
+  "name": "@ambiten/core",
+  "version": "1.0.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "Core library for Ambiten, providing essential functionalities and utilities for building applications with Ambiten.",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "browser": "./dist/index-browser.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "ambiten": "./bin/bootstrap.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./browser": {
+      "import": "./dist/index-browser.js",
+      "require": "./dist/index-browser.js",
+      "types": "./dist/browser.d.ts"
+    },
+    "./bin": {
+      "import": "./dist/index-cli.js",
+      "require": "./dist/index-cli.js",
+      "types": "./dist/cli.d.ts"
+    },
+    "./bundle": "./dist/ambiten-logger.js",
+    "./package.json": "./package.json"
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "bin",
+    "README.md",
+    "LICENSE",
+    "package.json",
+    "!dist/scripts"
+  ],
+  "release": {
+    "branches": [
+      "main"
+    ]
+  },
+  "keywords": [
+    "mongodb",
+    "odm",
+    "core",
+    "Ambiten",
+    "library"
+  ],
+  "author": "Emmanuel Nodolomwanyi",
+  "maintainers": [
+    {
+      "name": "Emmanuel Nodolomwanyi"
+    }
+  ],
+  "license": "ISC",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AmbitenHQ/ambiten.git",
+    "directory": "packages/core"
+  },
+  "bugs": {
+    "url": "https://github.com/AmbitenHQ/ambiten/issues"
+  },
+  "homepage": "https://ambiten.dev",
+  "dependencies": {
+    "@babel/runtime": "7.28.4",
+    "@inquirer/prompts": "^8.3.2",
+    "buffer": "6.0.3",
+    "commander": "14.0.2",
+    "fs-extra": "11.3.3",
+    "node-cron": "4.2.0",
+    "prompts": "^2.4.2",
+    "@ambiten/logger": "1.0.0"
+  },
+  "peerDependencies": {
+    "@graphql-tools/schema": "10.0.23",
+    "ajv": ">=8.18.0",
+    "ajv-formats": "3.0.1",
+    "express": "^5.1.0",
+    "express-serve-static-core": "^0.1.1",
+    "graphql": "16.11.0",
+    "graphql-http": "1.22.4",
+    "graphql-redis-subscriptions": "2.7.0",
+    "graphql-subscriptions": "3.0.0",
+    "graphql-tag": "2.12.6",
+    "graphql-ws": "5.16.2",
+    "jsonwebtoken": "9.0.2",
+    "mongodb": "^5 || ^6",
+    "redis": "4.7.1",
+    "ws": ">=8.20.1"
+  },
+  "peerDependenciesMeta": {
+    "mongodb": {
+      "optional": false
+    },
+    "graphql": {
+      "optional": false
+    }
+  },
+  "overrides": {
+    "graphql": "16.11.0"
+  },
+  "devDependencies": {
+    "@babel/core": "^7.28.5",
+    "@babel/eslint-parser": "^7.28.5",
+    "@babel/plugin-transform-modules-commonjs": "^7.27.1",
+    "@babel/plugin-transform-runtime": "^7.28.5",
+    "@babel/preset-env": "^7.28.5",
+    "@babel/preset-typescript": "^7.28.5",
+    "@eslint/js": "^9.39.2",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/commit-analyzer": "^13.0.1",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^11.0.6",
+    "@semantic-release/npm": "^12.0.2",
+    "@semantic-release/release-notes-generator": "^14.1.0",
+    "@testing-library/jest-dom": "^6.9.1",
+    "@types/express": "^5.0.6",
+    "@types/express-serve-static-core": "^5.1.1",
+    "@types/jest": "^29.5.14",
+    "@types/jsonwebtoken": "^9.0.10",
+    "@types/node": "^22.19.3",
+    "@types/webpack": "5.28.5",
+    "axios": "^1.13.2",
+    "babel-loader": "^10.0.0",
+    "clean-webpack-plugin": "^4.0.0",
+    "console-browserify": "^1.2.0",
+    "conventional-changelog": "^7.2.0",
+    "crypto-browserify": "^3.12.1",
+    "dotenv": "16.4.7",
+    "eslint": "^9.39.2",
+    "eslint-webpack-plugin": "^5.0.2",
+    "figlet": "^1.9.4",
+    "globals": "^14.0.0",
+    "graphql": "16.11.0",
+    "jest": "^29.7.0",
+    "mongodb-memory-server": "^10.4.3",
+    "path-browserify": "^1.0.1",
+    "semantic-release": "^24.2.9",
+    "socket.io-client": "^4.8.3",
+    "stream-browserify": "^3.0.0",
+    "supertest": "^7.1.4",
+    "ts-jest": "^29.4.6",
+    "ts-loader": "9.5.4",
+    "ts-node": "^10.9.2",
+    "tsconfig-paths": "^4.2.0",
+    "tsconfig-paths-webpack-plugin": "^4.2.0",
+    "tslib": "2.8.1",
+    "tsx": "^4.21.0",
+    "typescript": "5.9.3",
+    "typescript-eslint": "8.30.1",
+    "webpack": "5.104.1",
+    "webpack-cli": "6.0.1",
+    "webpack-node-externals": "3.0.0",
+    "webpack-remove-debug": "0.1.0",
+    "webpack-shebang-plugin": "1.1.8",
+    "@ambiten/adapter-types": "1.0.0"
+  },
+  "engines": {
+    "node": ">=20.11.0"
+  },
+  "scripts": {
+    "build:node": "webpack --config webpack.node.config.js",
+    "build:cli": "webpack --config webpack.cli.config.js",
+    "build:web": "webpack --config webpack.web.config.js",
+    "build:types": "tsc -p tsconfig.json --excludeDirectories **/node_modules",
+    "build": "pnpm run build:types && pnpm run build:node && pnpm run build:cli && pnpm run build:web",
+    "lint": "eslint src",
+    "clean": "rimraf dist",
+    "typedoc": "typedoc --options typedoc.json",
+    "release": "pnpm changeset version",
+    "test": "jest --detectOpenHandles --coverage"
+  }
+}