@warlock.js/cascade 4.0.48 → 4.0.59

package/cjs/writer/database-writer.d.ts

@@ -0,0 +1,181 @@
+import type { WriterContract, WriterOptions, WriterResult } from "../contracts/database-writer.contract";
+import type { Model } from "../model/model";
+/**
+ * Database writer service that orchestrates model persistence.
+ *
+ * Handles the complete save pipeline:
+ * 1. Check for changes (skip if no changes and not new)
+ * 2. Emit `saving` event (for data enrichment)
+ * 3. Emit `validating` event
+ * 4. Validate and cast data via @warlock.js/seal schema
+ * 5. Emit `validated` event
+ * 6. Generate ID (for new NoSQL records)
+ * 7. Emit `creating`/`updating` events
+ * 8. Execute insert or update via driver
+ * 9. Merge returned data into model
+ * 10. Reset dirty tracker and update `isNew` flag
+ * 11. Emit `saved` and `created`/`updated` events
+ *
+ * @example
+ * ```typescript
+ * const user = new User({ name: "Alice", email: "alice@example.com" });
+ * const writer = new DatabaseWriter(user);
+ * await writer.save();
+ *
+ * console.log(user.get("id")); // 1 (auto-generated)
+ * console.log(user.get("_id")); // ObjectId("...")
+ *
+ * // Update existing record
+ * user.set("name", "Alice Smith");
+ * await writer.save();
+ * // Only updates the "name" field (partial update)
+ *
+ * // Silent save (no events)
+ * await writer.save({ skipEvents: true });
+ * ```
+ */
+export declare class DatabaseWriter implements WriterContract {
+    /** The model instance being persisted */
+    private readonly model;
+    /** Model constructor reference */
+    private readonly ctor;
+    /** Data source containing driver and ID generator */
+    private readonly dataSource;
+    /** Database driver for executing queries */
+    private readonly driver;
+    /** Table/collection name */
+    private readonly table;
+    /** Primary key field name */
+    private readonly primaryKey;
+    /** Validation schema (if defined) */
+    private readonly schema?;
+    /** Strict mode configuration */
+    private readonly strictMode;
+    /**
+     * Create a new writer instance for a model.
+     *
+     * @param model - The model instance to persist
+     *
+     * @example
+     * ```typescript
+     * const user = new User({ name: "Alice" });
+     * const writer = new DatabaseWriter(user);
+     * await writer.save();
+     * ```
+     */
+    constructor(model: Model);
+    /**
+     * Save the model instance to the database.
+     *
+     * @param options - Save options
+     * @returns Result with success status, document, and metadata
+     * @throws {ValidationError} If validation fails
+     */
+    save(options?: WriterOptions): Promise<WriterResult>;
+    /**
+     * Validate and cast model data using the schema.
+     *
+     * Updates the model's data in-place with validated/casted values.
+     *
+     * @param isInsert - Whether this is an insert operation
+     * @param options - Save options
+     * @throws {ValidationError} If validation fails
+     * @private
+     */
+    private validateAndCast;
+    /**
+     * Perform an insert operation.
+     *
+     * @param options - Save options
+     * @returns Insert result
+     * @private
+     */
+    private performInsert;
+    /**
+     * Perform an update operation.
+     *
+     * @param options - Save options
+     * @returns Update result
+     * @private
+     */
+    private performUpdate;
+    /**
+     * Generate ID for the model if auto-generation is enabled.
+     *
+     * @private
+     */
+    private generateIdIfNeeded;
+    /**
+     * Build update operations from the model's dirty tracker.
+     *
+     * Handles both modified fields ($set) and removed fields ($unset).
+     *
+     * @returns Update operations for the driver
+     * @private
+     *
+     * @example
+     * ```typescript
+     * // Model with changes
+     * user.set("name", "Alice");
+     * user.unset("tempField");
+     *
+     * const operations = this.buildUpdateOperations();
+     * // {
+     * //   $set: { name: "Alice" },
+     * //   $unset: { tempField: 1 }
+     * // }
+     * ```
+     */
+    private buildUpdateOperations;
+    /**
+     * Resolve the initial ID from model configuration.
+     *
+     * Priority:
+     * 1. Model.initialId (explicit value)
+     * 2. Model.randomInitialId (random or function)
+     * 3. Default: 1
+     *
+     * @returns The initial ID value
+     * @private
+     */
+    private resolveInitialId;
+    /**
+     * Resolve the increment value from model configuration.
+     *
+     * Priority:
+     * 1. Model.incrementIdBy (explicit value)
+     * 2. Model.randomIncrement (random or function)
+     * 3. Default: 1
+     *
+     * @returns The increment value
+     * @private
+     */
+    private resolveIncrementBy;
+    /**
+     * Generate a random integer between min and max (inclusive).
+     *
+     * @param min - Minimum value
+     * @param max - Maximum value
+     * @returns Random integer
+     * @private
+     */
+    private randomInt;
+    /**
+     * Trigger sync operations after successful save.
+     * Only syncs on updates (not creates) unless sync config specifies embedOnCreate.
+     *
+     * @param changedFields - Fields that were changed (for filtering)
+     * @private
+     */
+    /**
+     * Trigger sync operations after successful save.
+     *
+     * Emits a model.updated event that ModelSyncOperation listens to.
+     * The sync is handled by registered sync operations, not directly here.
+     *
+     * @param changedFields - Fields that were changed (for filtering)
+     * @private
+     */
+    private triggerSync;
+}
+//# sourceMappingURL=database-writer.d.ts.map

package/cjs/writer/database-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-writer.d.ts","sourceRoot":"","sources":["../../src/writer/database-writer.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACb,YAAY,EACb,MAAM,uCAAuC,CAAC;AAC/C,OAAO,KAAK,EAAc,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAMxD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,qBAAa,cAAe,YAAW,cAAc;IACnD,yCAAyC;IACzC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAE9B,kCAAkC;IAClC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAoB;IAEzC,qDAAqD;IACrD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IAExC,4CAA4C;IAC5C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IAExC,4BAA4B;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAE/B,6BAA6B;IAC7B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IAEpC,qCAAqC;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAkB;IAE1C,gCAAgC;IAChC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAa;IAExC;;;;;;;;;;;OAWG;gBACgB,KAAK,EAAE,KAAK;IAW/B;;;;;;OAMG;IACU,IAAI,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,YAAY,CAAC;IA0DrE;;;;;;;;;OASG;YACW,eAAe;IA8D7B;;;;;;OAMG;YACW,aAAa;IAsC3B;;;;;;OAMG;YACW,aAAa;IAoC3B;;;;OAIG;YACW,kBAAkB;IAwBhC;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,OAAO,CAAC,qBAAqB;IA4B7B;;;;;;;;;;OAUG;IACH,OAAO,CAAC,gBAAgB;IAcxB;;;;;;;;;;OAUG;IACH,OAAO,CAAC,kBAAkB;IAc1B;;;;;;;OAOG;IACH,OAAO,CAAC,SAAS;IAIjB;;;;;;OAMG;IACH;;;;;;;;OAQG;YACW,WAAW;CAI1B"}

package/cjs/writer/database-writer.js

@@ -0,0 +1,402 @@
+'use strict';var events=require('@mongez/events'),seal=require('@warlock.js/seal'),modelEvents=require('../sync/model-events.js'),databaseWriterValidationError=require('../validation/database-writer-validation-error.js');require('../validation/database-seal-plugins.js');function _interopDefault(e){return e&&e.__esModule?e:{default:e}}var events__default=/*#__PURE__*/_interopDefault(events);/**
+ * Database writer service that orchestrates model persistence.
+ *
+ * Handles the complete save pipeline:
+ * 1. Check for changes (skip if no changes and not new)
+ * 2. Emit `saving` event (for data enrichment)
+ * 3. Emit `validating` event
+ * 4. Validate and cast data via @warlock.js/seal schema
+ * 5. Emit `validated` event
+ * 6. Generate ID (for new NoSQL records)
+ * 7. Emit `creating`/`updating` events
+ * 8. Execute insert or update via driver
+ * 9. Merge returned data into model
+ * 10. Reset dirty tracker and update `isNew` flag
+ * 11. Emit `saved` and `created`/`updated` events
+ *
+ * @example
+ * ```typescript
+ * const user = new User({ name: "Alice", email: "alice@example.com" });
+ * const writer = new DatabaseWriter(user);
+ * await writer.save();
+ *
+ * console.log(user.get("id")); // 1 (auto-generated)
+ * console.log(user.get("_id")); // ObjectId("...")
+ *
+ * // Update existing record
+ * user.set("name", "Alice Smith");
+ * await writer.save();
+ * // Only updates the "name" field (partial update)
+ *
+ * // Silent save (no events)
+ * await writer.save({ skipEvents: true });
+ * ```
+ */
+class DatabaseWriter {
+    /** The model instance being persisted */
+    model;
+    /** Model constructor reference */
+    ctor;
+    /** Data source containing driver and ID generator */
+    dataSource;
+    /** Database driver for executing queries */
+    driver;
+    /** Table/collection name */
+    table;
+    /** Primary key field name */
+    primaryKey;
+    /** Validation schema (if defined) */
+    schema;
+    /** Strict mode configuration */
+    strictMode;
+    /**
+     * Create a new writer instance for a model.
+     *
+     * @param model - The model instance to persist
+     *
+     * @example
+     * ```typescript
+     * const user = new User({ name: "Alice" });
+     * const writer = new DatabaseWriter(user);
+     * await writer.save();
+     * ```
+     */
+    constructor(model) {
+        this.model = model;
+        this.ctor = model.constructor;
+        this.dataSource = this.ctor.getDataSource();
+        this.driver = this.dataSource.driver;
+        this.table = this.ctor.table;
+        this.primaryKey = this.ctor.primaryKey;
+        this.schema = this.ctor.schema;
+        this.strictMode = this.ctor.strictMode;
+    }
+    /**
+     * Save the model instance to the database.
+     *
+     * @param options - Save options
+     * @returns Result with success status, document, and metadata
+     * @throws {ValidationError} If validation fails
+     */
+    async save(options = {}) {
+        const isInsert = this.model.isNew;
+        // 1. Check if model has changes (skip if no changes and not new)
+        if (!isInsert && !this.model.hasChanges()) {
+            return {
+                success: true,
+                document: this.model.data,
+                isNew: false,
+                modifiedCount: 0,
+            };
+        }
+        // 2. Emit saving event (before validation for data enrichment)
+        if (!options.skipEvents) {
+            await this.model.emitEvent("saving", {
+                isInsert,
+                options,
+                mode: isInsert ? "insert" : "update",
+            });
+        }
+        // 3. Validate and cast data
+        await this.validateAndCast(isInsert, options);
+        // 4. Execute insert or update
+        let result;
+        if (isInsert) {
+            result = await this.performInsert(options);
+        }
+        else {
+            result = await this.performUpdate(options);
+        }
+        // 5. Reset dirty tracker and update isNew flag
+        const changedFields = isInsert ? [] : this.model.getDirtyColumns();
+        this.model.dirtyTracker.reset();
+        this.model.isNew = false;
+        // 6. Emit post-save events
+        if (!options.skipEvents) {
+            await this.model.emitEvent("saved");
+            await this.model.emitEvent(isInsert ? "created" : "updated");
+        }
+        // 7. Trigger sync operations (fire-and-forget, non-blocking)
+        if (!options.skipSync && !isInsert) {
+            void this.triggerSync(changedFields);
+        }
+        return {
+            success: true,
+            document: this.model.data,
+            isNew: isInsert,
+            modifiedCount: isInsert ? undefined : result.modifiedCount,
+        };
+    }
+    /**
+     * Validate and cast model data using the schema.
+     *
+     * Updates the model's data in-place with validated/casted values.
+     *
+     * @param isInsert - Whether this is an insert operation
+     * @param options - Save options
+     * @throws {ValidationError} If validation fails
+     * @private
+     */
+    async validateAndCast(isInsert, options) {
+        // Emit validating event
+        if (!options.skipEvents) {
+            await this.model.emitEvent("validating", {
+                isInsert,
+                options,
+                mode: isInsert ? "insert" : "update",
+            });
+        }
+        // Skip validation if requested or no schema defined
+        if (options.skipValidation || !this.schema) {
+            return;
+        }
+        // Clone schema for partial data (updates only)
+        const validationSchema = isInsert
+            ? this.schema.clone()
+            : this.schema.clone(Object.keys(this.model.data)).extend({
+                id: seal.v.int(),
+                _id: seal.v.any(),
+                createdAt: seal.v.date(),
+                updatedAt: seal.v.date(),
+            });
+        // Apply strict mode
+        if (this.strictMode === "strip") {
+            validationSchema.stripUnknown();
+        }
+        else if (this.strictMode === "fail") {
+            validationSchema.allowUnknown(false);
+        }
+        else if (this.strictMode === "allow") {
+            validationSchema.allowUnknown(true);
+        }
+        // Run validation
+        const result = await seal.v.validate(validationSchema, this.model.data, {
+            context: {
+                model: this.model,
+            },
+            ...seal.getSealConfig(),
+        });
+        if (!result.isValid) {
+            const error = new databaseWriterValidationError.DatabaseWriterValidationError(`[${this.model.constructor.name} Model] ${isInsert ? "Insert" : "Update"} Validation failed`, result.errors);
+            if (!options.skipEvents) {
+                await this.model.emitEvent("validated", { result, error });
+            }
+            throw error;
+        }
+        // Update model data with validated/casted data
+        this.model.replaceData(result.data);
+        // Emit validated event
+        if (!options.skipEvents) {
+            await this.model.emitEvent("validated", { result });
+        }
+    }
+    /**
+     * Perform an insert operation.
+     *
+     * @param options - Save options
+     * @returns Insert result
+     * @private
+     */
+    async performInsert(options) {
+        // Generate ID if needed (NoSQL only)
+        await this.generateIdIfNeeded();
+        // Get data to insert (already validated and casted)
+        const dataToInsert = this.model.data;
+        // add createdAt and updatedAt to the data
+        const createdAtColumn = this.ctor.createdAtColumn ?? "createdAt";
+        if (createdAtColumn) {
+            dataToInsert[createdAtColumn] = new Date();
+        }
+        const updatedAtColumn = this.ctor.updatedAtColumn ?? "updatedAt";
+        if (updatedAtColumn) {
+            dataToInsert[updatedAtColumn] = new Date();
+        }
+        // Emit creating event
+        if (!options.skipEvents) {
+            await this.model.emitEvent("creating");
+        }
+        // INSERT: use full validated data
+        const result = await this.driver.insert(this.table, dataToInsert);
+        // Merge returned data (e.g., generated _id, timestamps)
+        // Note: We use merge here because the result might not include all fields
+        // (e.g., our generated 'id' field), and we don't want to lose them
+        this.model.merge(result.document);
+        // Reset dirty tracker immediately after merge to prevent
+        // database-generated fields (like _id) from being marked as dirty
+        this.model.dirtyTracker.reset();
+        return result;
+    }
+    /**
+     * Perform an update operation.
+     *
+     * @param options - Save options
+     * @returns Update result
+     * @private
+     */
+    async performUpdate(options) {
+        // Emit updating event
+        if (!options.skipEvents) {
+            await this.model.emitEvent("updating");
+        }
+        if (this.ctor.updatedAtColumn !== false) {
+            this.model.set(this.ctor.updatedAtColumn ?? "updatedAt", new Date());
+        }
+        if (options.replace) {
+            const document = await this.driver.replace(this.table, {
+                [this.primaryKey]: this.model.get(this.primaryKey),
+            }, this.model.data);
+            if (document) {
+                this.model.replaceData(document);
+            }
+            return { modifiedCount: document ? 1 : 0 };
+        }
+        // Build operations from dirty tracker
+        const operations = this.buildUpdateOperations();
+        // Build filter using primary key
+        const filter = { [this.primaryKey]: this.model.get(this.primaryKey) };
+        // Execute update with operations
+        return await this.driver.update(this.table, filter, operations);
+    }
+    /**
+     * Generate ID for the model if auto-generation is enabled.
+     *
+     * @private
+     */
+    async generateIdIfNeeded() {
+        if (!this.ctor.autoGenerateId || this.model.get("id")) {
+            return;
+        }
+        const idGenerator = this.dataSource.idGenerator;
+        if (!idGenerator) {
+            return;
+        }
+        // Resolve ID generation options from model configuration
+        const initialId = this.resolveInitialId();
+        const incrementIdBy = this.resolveIncrementBy();
+        const id = await idGenerator.generateNextId({
+            table: this.table,
+            initialId,
+            incrementIdBy,
+        });
+        this.model.set("id", id);
+    }
+    /**
+     * Build update operations from the model's dirty tracker.
+     *
+     * Handles both modified fields ($set) and removed fields ($unset).
+     *
+     * @returns Update operations for the driver
+     * @private
+     *
+     * @example
+     * ```typescript
+     * // Model with changes
+     * user.set("name", "Alice");
+     * user.unset("tempField");
+     *
+     * const operations = this.buildUpdateOperations();
+     * // {
+     * //   $set: { name: "Alice" },
+     * //   $unset: { tempField: 1 }
+     * // }
+     * ```
+     */
+    buildUpdateOperations() {
+        const operations = {};
+        // Get dirty columns (modified fields)
+        const dirtyColumns = this.model.getDirtyColumns();
+        if (dirtyColumns.length > 0) {
+            operations.$set = {};
+            for (const column of dirtyColumns) {
+                const value = this.model.get(column);
+                if (value === undefined)
+                    continue;
+                operations.$set[column] = this.model.get(column);
+            }
+        }
+        // Get removed columns
+        const removedColumns = this.model.getRemovedColumns();
+        if (removedColumns.length > 0) {
+            operations.$unset = {};
+            for (const column of removedColumns) {
+                operations.$unset[column] = 1;
+            }
+        }
+        return operations;
+    }
+    /**
+     * Resolve the initial ID from model configuration.
+     *
+     * Priority:
+     * 1. Model.initialId (explicit value)
+     * 2. Model.randomInitialId (random or function)
+     * 3. Default: 1
+     *
+     * @returns The initial ID value
+     * @private
+     */
+    resolveInitialId() {
+        if (this.ctor.initialId) {
+            return this.ctor.initialId;
+        }
+        if (this.ctor.randomInitialId) {
+            return typeof this.ctor.randomInitialId === "function"
+                ? this.ctor.randomInitialId()
+                : this.randomInt(10000, 499999);
+        }
+        return 1; // Default initial ID
+    }
+    /**
+     * Resolve the increment value from model configuration.
+     *
+     * Priority:
+     * 1. Model.incrementIdBy (explicit value)
+     * 2. Model.randomIncrement (random or function)
+     * 3. Default: 1
+     *
+     * @returns The increment value
+     * @private
+     */
+    resolveIncrementBy() {
+        if (this.ctor.incrementIdBy) {
+            return this.ctor.incrementIdBy;
+        }
+        if (this.ctor.randomIncrement) {
+            return typeof this.ctor.randomIncrement === "function"
+                ? this.ctor.randomIncrement()
+                : this.randomInt(1, 10);
+        }
+        return 1; // Default increment
+    }
+    /**
+     * Generate a random integer between min and max (inclusive).
+     *
+     * @param min - Minimum value
+     * @param max - Maximum value
+     * @returns Random integer
+     * @private
+     */
+    randomInt(min, max) {
+        return Math.floor(Math.random() * (max - min + 1)) + min;
+    }
+    /**
+     * Trigger sync operations after successful save.
+     * Only syncs on updates (not creates) unless sync config specifies embedOnCreate.
+     *
+     * @param changedFields - Fields that were changed (for filtering)
+     * @private
+     */
+    /**
+     * Trigger sync operations after successful save.
+     *
+     * Emits a model.updated event that ModelSyncOperation listens to.
+     * The sync is handled by registered sync operations, not directly here.
+     *
+     * @param changedFields - Fields that were changed (for filtering)
+     * @private
+     */
+    async triggerSync(changedFields) {
+        // Emit model.updated event - ModelSyncOperation listens to these
+        await events__default.default.triggerAll(modelEvents.getModelUpdatedEvent(this.ctor), this.model, changedFields);
+    }
+}exports.DatabaseWriter=DatabaseWriter;//# sourceMappingURL=database-writer.js.map

package/cjs/writer/database-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-writer.js","sources":["../../src/writer/database-writer.ts"],"sourcesContent":[null],"names":["v","getSealConfig","DatabaseWriterValidationError","events","getModelUpdatedEvent"],"mappings":"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"}

package/esm/context/database-data-source-context.d.ts

@@ -0,0 +1,29 @@
+import { Context } from "@warlock.js/context";
+import type { DataSource } from "../data-source/data-source";
+type DataSourceContextValue = string | DataSource;
+type DataSourceContextStore = {
+    dataSource?: DataSourceContextValue;
+};
+/**
+ * Database DataSource Context
+ *
+ * Manages the active database connection/data source using AsyncLocalStorage.
+ * Extends the base Context class for consistent API.
+ */
+declare class DatabaseDataSourceContext extends Context<DataSourceContextStore> {
+    /**
+     * Get the current data source
+     */
+    getDataSource(): DataSourceContextValue | undefined;
+    /**
+     * Set the data source in context
+     */
+    setDataSource(dataSource: DataSourceContextValue): void;
+    /**
+     * Build the initial data source store with defaults
+     */
+    buildStore(): DataSourceContextStore;
+}
+export declare const databaseDataSourceContext: DatabaseDataSourceContext;
+export {};
+//# sourceMappingURL=database-data-source-context.d.ts.map

package/esm/context/database-data-source-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-data-source-context.d.ts","sourceRoot":"","sources":["../../src/context/database-data-source-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAkB,MAAM,qBAAqB,CAAC;AAC9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAE7D,KAAK,sBAAsB,GAAG,MAAM,GAAG,UAAU,CAAC;AAElD,KAAK,sBAAsB,GAAG;IAC5B,UAAU,CAAC,EAAE,sBAAsB,CAAC;CACrC,CAAC;AAEF;;;;;GAKG;AACH,cAAM,yBAA0B,SAAQ,OAAO,CAAC,sBAAsB,CAAC;IACrE;;OAEG;IACI,aAAa,IAAI,sBAAsB,GAAG,SAAS;IAI1D;;OAEG;IACI,aAAa,CAAC,UAAU,EAAE,sBAAsB,GAAG,IAAI;IAI9D;;OAEG;IACI,UAAU,IAAI,sBAAsB;CAG5C;AAED,eAAO,MAAM,yBAAyB,2BAAkC,CAAC"}

package/esm/context/database-data-source-context.js

@@ -0,0 +1,28 @@
+import {contextManager,Context}from'@warlock.js/context';/**
+ * Database DataSource Context
+ *
+ * Manages the active database connection/data source using AsyncLocalStorage.
+ * Extends the base Context class for consistent API.
+ */
+class DatabaseDataSourceContext extends Context {
+    /**
+     * Get the current data source
+     */
+    getDataSource() {
+        return this.get("dataSource");
+    }
+    /**
+     * Set the data source in context
+     */
+    setDataSource(dataSource) {
+        this.set("dataSource", dataSource);
+    }
+    /**
+     * Build the initial data source store with defaults
+     */
+    buildStore() {
+        return { dataSource: undefined };
+    }
+}
+const databaseDataSourceContext = new DatabaseDataSourceContext();
+contextManager.register("db.datasource", databaseDataSourceContext);export{databaseDataSourceContext};//# sourceMappingURL=database-data-source-context.js.map

package/esm/context/database-data-source-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-data-source-context.js","sources":["../../src/context/database-data-source-context.ts"],"sourcesContent":[null],"names":[],"mappings":"yDASA;;;;;AAKG;AACH,MAAM,yBAA0B,SAAQ,OAA+B,CAAA;AACrE;;AAEG;IACI,aAAa,GAAA;AAClB,QAAA,OAAO,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;KAC/B;AAED;;AAEG;AACI,IAAA,aAAa,CAAC,UAAkC,EAAA;AACrD,QAAA,IAAI,CAAC,GAAG,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;KACpC;AAED;;AAEG;IACI,UAAU,GAAA;AACf,QAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;KAClC;AACF,CAAA;AAEY,MAAA,yBAAyB,GAAG,IAAI,yBAAyB,GAAG;AAEzE,cAAc,CAAC,QAAQ,CAAC,eAAe,EAAE,yBAAyB,CAAC"}