@warlock.js/cascade 4.0.48 → 4.0.59

package/esm/drivers/mongo/mongodb-driver.js

@@ -0,0 +1,411 @@
+import {colors}from'@mongez/copper';import {log}from'@warlock.js/logger';import {EventEmitter}from'node:events';import {databaseTransactionContext}from'../../context/database-transaction-context.js';import {dataSourceRegistry}from'../../data-source/data-source-registry.js';import {MongoIdGenerator}from'./mongo-id-generator.js';import {MongoMigrationDriver}from'./mongo-migration-driver.js';import {MongoQueryBuilder}from'./mongo-query-builder.js';import {MongoSyncAdapter}from'./mongo-sync-adapter.js';import {MongoDBBlueprint}from'./mongodb-blueprint.js';const DEFAULT_TRANSACTION_OPTIONS = {
+    readPreference: "primary",
+    readConcern: { level: "local" },
+    writeConcern: { w: "majority" },
+};
+let ObjectId;
+/**
+ * MongoDB driver implementation that fulfils the Cascade driver contract.
+ *
+ * It encapsulates the native Mongo client, exposes lifecycle events, and
+ * provides helpers for CRUD, transactions, atomic updates, and sync adapters.
+ */
+class MongoDbDriver {
+    config;
+    driverOptions;
+    events = new EventEmitter();
+    client;
+    database;
+    connected = false;
+    syncAdapterInstance;
+    migrationDriverInstance;
+    transactionOptions;
+    idGeneratorInstance;
+    _blueprint;
+    get blueprint() {
+        if (!this._blueprint) {
+            this._blueprint = new MongoDBBlueprint(this.database);
+        }
+        return this._blueprint;
+    }
+    /**
+     * The name of this driver.
+     */
+    name = "mongodb";
+    /**
+     * Create a new MongoDB driver using the supplied connection options.
+     *
+     * @param config - Connection configuration
+     * @param driverOptions - Driver-specific options
+     */
+    constructor(config, driverOptions) {
+        this.config = config;
+        this.driverOptions = driverOptions;
+        this.transactionOptions = {
+            ...DEFAULT_TRANSACTION_OPTIONS,
+            ...driverOptions?.transactionOptions,
+        };
+    }
+    /**
+     * Indicates whether the driver currently maintains an active connection.
+     */
+    get isConnected() {
+        return this.connected;
+    }
+    /**
+     * Get the MongoDB database instance.
+     *
+     * @returns The MongoDB Db instance
+     * @throws {Error} If not connected
+     *
+     * @example
+     * ```typescript
+     * const db = driver.getDatabase();
+     * const collection = db.collection("users");
+     * ```
+     */
+    getDatabase() {
+        if (!this.database) {
+            throw new Error("Database not available. Ensure the driver is connected before accessing the database.");
+        }
+        return this.database;
+    }
+    /**
+     * Get the ID generator instance for this driver.
+     *
+     * Creates a MongoIdGenerator on first access if autoGenerateId is enabled.
+     *
+     * @returns The ID generator instance, or undefined if disabled
+     *
+     * @example
+     * ```typescript
+     * const idGenerator = driver.getIdGenerator();
+     * if (idGenerator) {
+     *   const id = await idGenerator.generateNextId({ table: "users" });
+     * }
+     * ```
+     */
+    getIdGenerator() {
+        // Return undefined if ID generation is disabled
+        if (this.driverOptions?.autoGenerateId === false) {
+            return undefined;
+        }
+        // Create ID generator lazily on first access
+        if (!this.idGeneratorInstance) {
+            this.idGeneratorInstance = new MongoIdGenerator(this, this.driverOptions?.counterCollection);
+        }
+        return this.idGeneratorInstance;
+    }
+    /**
+     * Establish a MongoDB connection using the configured options.
+     * Throws if the connection attempt fails.
+     */
+    async connect() {
+        if (this.connected) {
+            return;
+        }
+        const uri = this.resolveUri();
+        const { MongoClient, ObjectId: ObjectIdMongoDB } = await import('mongodb');
+        ObjectId = ObjectIdMongoDB;
+        const client = new MongoClient(uri, this.buildClientOptions());
+        try {
+            log.info("database", "connection", `Connecting to database ${colors.bold(colors.yellowBright(this.config.database))}`);
+            await client.connect();
+            this.client = client;
+            this.database = client.db(this.config.database);
+            this.connected = true;
+            log.success("database", "connection", "Connected to database");
+            client.on("close", () => {
+                if (this.connected) {
+                    this.connected = false;
+                    this.emit("disconnected");
+                    log.warn("database", "connection", "Disconnected from database");
+                }
+            });
+            this.emit("connected");
+        }
+        catch (error) {
+            await client.close().catch(() => undefined);
+            this.emit("disconnected");
+            throw error;
+        }
+    }
+    /**
+     * Close the underlying MongoDB connection.
+     */
+    async disconnect() {
+        if (!this.client) {
+            return;
+        }
+        try {
+            await this.client.close();
+        }
+        finally {
+            this.connected = false;
+            this.emit("disconnected");
+        }
+    }
+    /**
+     * Subscribe to driver lifecycle events.
+     */
+    on(event, listener) {
+        this.events.on(event, listener);
+    }
+    /**
+     * Insert a single document into the given collection.
+     */
+    async insert(table, document, options) {
+        const collection = this.getDatabaseInstance().collection(table);
+        const mongoOptions = this.withSession(options);
+        const result = await collection.insertOne(document, mongoOptions);
+        return {
+            document: {
+                ...document,
+                _id: result.insertedId,
+            },
+        };
+    }
+    /**
+     * Insert multiple documents into the given collection.
+     */
+    async insertMany(table, documents, options) {
+        const collection = this.getDatabaseInstance().collection(table);
+        const mongoOptions = this.withSession(options);
+        const result = await collection.insertMany(documents, mongoOptions);
+        return documents.map((document, index) => {
+            const insertedId = result.insertedIds[index];
+            return {
+                document: {
+                    ...document,
+                    _id: insertedId,
+                },
+            };
+        });
+    }
+    /**
+     * Update a single document that matches the provided filter.
+     */
+    async update(table, filter, update, options) {
+        const collection = this.getDatabaseInstance().collection(table);
+        const mongoOptions = this.withSession(options);
+        const result = await collection.updateOne(filter, update, mongoOptions);
+        return { modifiedCount: result.modifiedCount };
+    }
+    /**
+     * Replace a single document that matches the provided filter.
+     */
+    async replace(table, filter, document, options) {
+        const collection = this.getDatabaseInstance().collection(table);
+        const result = await collection.findOneAndReplace(filter, document);
+        return result?.value;
+    }
+    /**
+     * Update multiple documents that match the provided filter.
+     */
+    async updateMany(table, filter, update, options) {
+        const collection = this.getDatabaseInstance().collection(table);
+        const mongoOptions = this.withSession(options);
+        const result = await collection.updateMany(filter, update, mongoOptions);
+        return { modifiedCount: result.modifiedCount };
+    }
+    /**
+     * Delete a single document that matches the provided filter.
+     */
+    async delete(table, filter = {}, options) {
+        const collection = this.getDatabaseInstance().collection(table);
+        const mongoOptions = this.withSession(options);
+        const result = await collection.deleteOne(filter, mongoOptions);
+        return result.deletedCount > 0 ? 1 : 0;
+    }
+    /**
+     * Delete documents that match the provided filter.
+     */
+    async deleteMany(table, filter = {}, options) {
+        const collection = this.getDatabaseInstance().collection(table);
+        const mongoOptions = this.withSession(options);
+        const result = await collection.deleteMany(filter, mongoOptions);
+        return result.deletedCount ?? 0;
+    }
+    /**
+     * Remove all records from a collection.
+     *
+     * This uses deleteMany with an empty filter to remove all documents.
+     * For very large collections, consider using the migration driver's
+     * dropTable + createTable approach for better performance.
+     */
+    async truncateTable(table, options) {
+        const collection = this.getDatabaseInstance().collection(table);
+        const mongoOptions = this.withSession(options);
+        const result = await collection.deleteMany({}, mongoOptions);
+        return result.deletedCount ?? 0;
+    }
+    /**
+     * Serialize the given data
+     */
+    serialize(data) {
+        if (data._id && data._id instanceof ObjectId) {
+            data._id = data._id.toString();
+        }
+        return data;
+    }
+    /**
+     * Deserialize the given data
+     */
+    deserialize(data) {
+        if (data._id && typeof data._id === "string") {
+            data._id = new ObjectId(data._id);
+        }
+        return data;
+    }
+    /**
+     * Provide a Mongo-backed query builder instance for the given collection.
+     */
+    queryBuilder(table) {
+        return new MongoQueryBuilder(table, dataSourceRegistry.get());
+    }
+    /**
+     * Begin a MongoDB transaction, returning commit/rollback helpers.
+     */
+    async beginTransaction() {
+        const client = this.getClientInstance();
+        const session = client.startSession();
+        await session.startTransaction(this.transactionOptions);
+        databaseTransactionContext.enter({ session });
+        let finished = false;
+        const finalize = async (operation) => {
+            if (finished)
+                return;
+            try {
+                await operation();
+            }
+            finally {
+                finished = true;
+                databaseTransactionContext.exit();
+                await session.endSession().catch(() => undefined);
+            }
+        };
+        return {
+            context: session,
+            commit: async () => {
+                await finalize(async () => {
+                    try {
+                        await session.commitTransaction();
+                    }
+                    catch (error) {
+                        await session.abortTransaction().catch(() => undefined);
+                        throw error;
+                    }
+                });
+            },
+            rollback: async () => {
+                await finalize(async () => {
+                    await session.abortTransaction();
+                });
+            },
+        };
+    }
+    /**
+     * Execute atomic operations (typically $inc/$set style updates) against documents.
+     *
+     * Uses `updateMany` so callers can atomically modify any set of documents.
+     */
+    async atomic(table, filter, operations, options) {
+        const collection = this.getDatabaseInstance().collection(table);
+        const mongoOptions = this.withSession(options);
+        const result = await collection.updateMany(filter, operations, mongoOptions);
+        return { modifiedCount: result.modifiedCount };
+    }
+    /**
+     * Lazily create (and cache) the Mongo sync adapter.
+     * The adapter uses this driver instance to ensure all operations
+     * participate in active transactions via the session context.
+     */
+    syncAdapter() {
+        if (!this.syncAdapterInstance) {
+            this.syncAdapterInstance = new MongoSyncAdapter(this);
+        }
+        return this.syncAdapterInstance;
+    }
+    /**
+     * Lazily create (and cache) the Mongo migration driver.
+     * The migration driver handles schema operations like indexes, collections, etc.
+     */
+    migrationDriver() {
+        if (!this.migrationDriverInstance) {
+            this.migrationDriverInstance = new MongoMigrationDriver(this);
+        }
+        return this.migrationDriverInstance;
+    }
+    /**
+     * Expose the underlying Mongo client for advanced consumers.
+     */
+    getClient() {
+        return this.getClientInstance();
+    }
+    /**
+     * Retrieve the active Mongo client, throwing if the driver is disconnected.
+     */
+    getClientInstance() {
+        if (!this.client) {
+            throw new Error("Mongo driver is not connected.");
+        }
+        return this.client;
+    }
+    /**
+     * Retrieve the active Mongo database, throwing if the driver is disconnected.
+     * @private
+     */
+    getDatabaseInstance() {
+        if (!this.database) {
+            throw new Error("Mongo driver is not connected to a database.");
+        }
+        return this.database;
+    }
+    /**
+     * Resolve the Mongo connection string based on provided options.
+     */
+    resolveUri() {
+        if (this.config.uri) {
+            return this.config.uri;
+        }
+        const host = this.config.host ?? "localhost";
+        const port = this.config.port ?? 27017;
+        return `mongodb://${host}:${port}`;
+    }
+    /**
+     * Build the Mongo client options derived from the driver configuration.
+     */
+    buildClientOptions() {
+        const baseOptions = {
+            ...(this.config.clientOptions ?? {}),
+        };
+        if (this.config.username && !baseOptions.auth) {
+            baseOptions.auth = {
+                username: this.config.username,
+                password: this.config.password,
+            };
+        }
+        if (this.config.authSource && !baseOptions.authSource) {
+            baseOptions.authSource = this.config.authSource;
+        }
+        return baseOptions;
+    }
+    /**
+     * Emit a driver lifecycle event.
+     */
+    emit(event, ...args) {
+        this.events.emit(event, ...args);
+    }
+    /**
+     * Attach the active transaction session (when available) to Mongo options.
+     */
+    withSession(options) {
+        const session = databaseTransactionContext.getSession();
+        if (!session) {
+            return options;
+        }
+        const baseOptions = options ? { ...options } : {};
+        baseOptions.session = session;
+        return baseOptions;
+    }
+}export{MongoDbDriver};//# sourceMappingURL=mongodb-driver.js.map

package/esm/drivers/mongo/mongodb-driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongodb-driver.js","sources":["../../../src/drivers/mongo/mongodb-driver.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/esm/drivers/mongo/types.d.ts

@@ -0,0 +1,43 @@
+import type { TransactionOptions } from "mongodb";
+/**
+ * MongoDB pipeline stage names.
+ */
+export type PipelineStage = "$match" | "$project" | "$sort" | "$group" | "$lookup" | "$limit" | "$skip" | "$unwind" | "$addFields" | "$setWindowFields";
+/**
+ * Represents a single operation in the query builder chain.
+ */
+export type Operation = {
+    /** The MongoDB aggregation stage this operation belongs to */
+    stage: PipelineStage;
+    /** Whether this operation can be merged with other operations of the same stage */
+    mergeable: boolean;
+    /** The operation type (for processing logic) */
+    type: string;
+    /** The operation payload */
+    payload: any;
+};
+/**
+ * MongoDB driver-specific options.
+ *
+ * These are cascade-next specific configurations for the MongoDB driver,
+ * not native MongoDB client options.
+ */
+export type MongoDriverOptions = {
+    /**
+     * Enable auto-generation of numeric IDs.
+     * When enabled, creates a counter collection for managing sequential IDs.
+     * @default false
+     */
+    autoGenerateId?: boolean;
+    /**
+     * Counter collection name for auto-generated IDs.
+     * @default "counters"
+     */
+    counterCollection?: string;
+    /**
+     * Transaction options for this driver.
+     * Applied to all transactions unless overridden.
+     */
+    transactionOptions?: TransactionOptions;
+};
+//# sourceMappingURL=types.d.ts.map

package/esm/drivers/mongo/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/drivers/mongo/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAElD;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,QAAQ,GACR,UAAU,GACV,OAAO,GACP,QAAQ,GACR,SAAS,GACT,QAAQ,GACR,OAAO,GACP,SAAS,GACT,YAAY,GACZ,kBAAkB,CAAC;AAEvB;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,8DAA8D;IAC9D,KAAK,EAAE,aAAa,CAAC;IACrB,mFAAmF;IACnF,SAAS,EAAE,OAAO,CAAC;IACnB,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,OAAO,EAAE,GAAG,CAAC;CACd,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;OAGG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;OAGG;IACH,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;CACzC,CAAC"}

package/esm/errors/missing-data-source.error.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Error thrown when a requested data source is not found in the registry.
+ *
+ * This can occur when:
+ * - Attempting to retrieve a non-existent named data source
+ * - Trying to get the default data source before any have been registered
+ * - Context override references an unregistered data source name
+ */
+export declare class MissingDataSourceError extends Error {
+    /**
+     * The name of the data source that was not found (if applicable).
+     */
+    readonly dataSourceName?: string;
+    /**
+     * Creates a new MissingDataSourceError.
+     *
+     * @param message - Descriptive error message
+     * @param dataSourceName - Optional data source name that was not found
+     */
+    constructor(message: string, dataSourceName?: string);
+}
+//# sourceMappingURL=missing-data-source.error.d.ts.map

package/esm/errors/missing-data-source.error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"missing-data-source.error.d.ts","sourceRoot":"","sources":["../../src/errors/missing-data-source.error.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C;;OAEG;IACH,SAAgB,cAAc,CAAC,EAAE,MAAM,CAAC;IAExC;;;;;OAKG;gBACgB,OAAO,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM;CAU5D"}

package/esm/errors/missing-data-source.error.js

@@ -0,0 +1,29 @@
+/**
+ * Error thrown when a requested data source is not found in the registry.
+ *
+ * This can occur when:
+ * - Attempting to retrieve a non-existent named data source
+ * - Trying to get the default data source before any have been registered
+ * - Context override references an unregistered data source name
+ */
+class MissingDataSourceError extends Error {
+    /**
+     * The name of the data source that was not found (if applicable).
+     */
+    dataSourceName;
+    /**
+     * Creates a new MissingDataSourceError.
+     *
+     * @param message - Descriptive error message
+     * @param dataSourceName - Optional data source name that was not found
+     */
+    constructor(message, dataSourceName) {
+        super(message);
+        this.name = "MissingDataSourceError";
+        this.dataSourceName = dataSourceName;
+        // Maintains proper stack trace for where error was thrown (V8 only)
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, MissingDataSourceError);
+        }
+    }
+}export{MissingDataSourceError};//# sourceMappingURL=missing-data-source.error.js.map

package/esm/errors/missing-data-source.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"missing-data-source.error.js","sources":["../../src/errors/missing-data-source.error.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;;;;;;AAOG;AACG,MAAO,sBAAuB,SAAQ,KAAK,CAAA;AAC/C;;AAEG;AACa,IAAA,cAAc,CAAU;AAExC;;;;;AAKG;IACH,WAAmB,CAAA,OAAe,EAAE,cAAuB,EAAA;QACzD,KAAK,CAAC,OAAO,CAAC,CAAC;AACf,QAAA,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;AACrC,QAAA,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;;QAGrC,IAAI,KAAK,CAAC,iBAAiB,EAAE;AAC3B,YAAA,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,sBAAsB,CAAC,CAAC;AACvD,SAAA;KACF;AACF"}