@warlock.js/cascade 4.0.156 → 4.0.158

package/cjs/validation/rules/database-model-rule.d.ts

@@ -1,7 +0,0 @@
-import { type SchemaRule } from "@warlock.js/seal";
-import { ChildModel } from "./../../model/model";
-export declare const databaseModelRule: SchemaRule;
-export declare const databaseModelsRule: SchemaRule<{
-    model: ChildModel<any> | string;
-}>;
-//# sourceMappingURL=database-model-rule.d.ts.map

package/cjs/validation/rules/database-model-rule.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"database-model-rule.d.ts","sourceRoot":"","sources":["../../../src/validation/rules/database-model-rule.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EAAE,UAAU,EAAS,MAAM,qBAAqB,CAAC;AAGxD,eAAO,MAAM,iBAAiB,EAAE,UAW/B,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,UAAU,CAAC;IAAE,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,GAAG,MAAM,CAAA;CAAE,CAiB9E,CAAC"}

package/cjs/validation/rules/database-model-rule.js

@@ -1,27 +0,0 @@
-'use strict';var seal=require('@warlock.js/seal'),model=require('../../model/model.js'),registerModel=require('../../model/register-model.js');const databaseModelRule = {
-    name: "databaseModule",
-    defaultErrorMessage: "The :input must be a valid :model model",
-    async validate(value, context) {
-        if (value instanceof model.Model === false) {
-            this.context.attributesList.model = this.context.options.model?.name;
-            return seal.invalidRule(this, context);
-        }
-        return seal.VALID_RULE;
-    },
-};
-const databaseModelsRule = {
-    name: "databaseModels",
-    defaultErrorMessage: "The :input must be a list of valid :model",
-    async validate(value, context) {
-        let { model: model$1 } = this.context.options;
-        if (typeof model$1 === "string") {
-            model$1 = registerModel.getModelFromRegistry(model$1);
-        }
-        this.context.attributesList.model = model$1.name;
-        if (!Array.isArray(value))
-            return seal.invalidRule(this, context);
-        if (value.every((item) => item instanceof model.Model))
-            return seal.VALID_RULE;
-        return seal.invalidRule(this, context);
-    },
-};exports.databaseModelRule=databaseModelRule;exports.databaseModelsRule=databaseModelsRule;//# sourceMappingURL=database-model-rule.js.map

package/cjs/validation/rules/database-model-rule.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"database-model-rule.js","sources":["../../../src/validation/rules/database-model-rule.ts"],"sourcesContent":[null],"names":["Model","invalidRule","VALID_RULE","model","getModelFromRegistry"],"mappings":"+IAIa,MAAA,iBAAiB,GAAe;AAC3C,IAAA,IAAI,EAAE,gBAAgB;AACtB,IAAA,mBAAmB,EAAE,yCAAyC;AAC9D,IAAA,MAAM,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAA;AAC3B,QAAA,IAAI,KAAK,YAAYA,WAAK,KAAK,KAAK,EAAE;AACpC,YAAA,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC;AACrE,YAAA,OAAOC,gBAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACnC,SAAA;AAED,QAAA,OAAOC,eAAU,CAAC;KACnB;EACD;AAEW,MAAA,kBAAkB,GAAoD;AACjF,IAAA,IAAI,EAAE,gBAAgB;AACtB,IAAA,mBAAmB,EAAE,2CAA2C;AAChE,IAAA,MAAM,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAA;QAC3B,IAAI,SAAEC,OAAK,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;AACrC,QAAA,IAAI,OAAOA,OAAK,KAAK,QAAQ,EAAE;AAC7B,YAAAA,OAAK,GAAGC,kCAAoB,CAACD,OAAK,CAAE,CAAC;AACtC,SAAA;QAED,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,KAAK,GAAGA,OAAK,CAAC,IAAI,CAAC;AAE/C,QAAA,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;AAAE,YAAA,OAAOF,gBAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAE7D,QAAA,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,IAAI,YAAYD,WAAK,CAAC;AAAE,YAAA,OAAOE,eAAU,CAAC;AAEpE,QAAA,OAAOD,gBAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;KACnC;"}

package/cjs/validation/transformers/embed-model-transformer.d.ts

@@ -1,3 +0,0 @@
-import { type TransformerCallback } from "@warlock.js/seal";
-export declare const databaseModelTransformer: TransformerCallback;
-//# sourceMappingURL=embed-model-transformer.d.ts.map

package/cjs/validation/transformers/embed-model-transformer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"embed-model-transformer.d.ts","sourceRoot":"","sources":["../../../src/validation/transformers/embed-model-transformer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAG5D,eAAO,MAAM,wBAAwB,EAAE,mBAsBtC,CAAC"}

package/cjs/validation/transformers/embed-model-transformer.js

@@ -1,18 +0,0 @@
-'use strict';var model=require('../../model/model.js');const databaseModelTransformer = (value, context) => {
-    const embed = context.options.embed ?? "embedData";
-    if (value instanceof model.Model === false && !Array.isArray(value)) {
-        return value;
-    }
-    if (Array.isArray(value)) {
-        return value.map((item) => {
-            if (typeof embed === "string") {
-                return item[embed];
-            }
-            return item.only(embed);
-        });
-    }
-    if (typeof embed === "string") {
-        return value[embed];
-    }
-    return value.only(embed);
-};exports.databaseModelTransformer=databaseModelTransformer;//# sourceMappingURL=embed-model-transformer.js.map

package/cjs/validation/transformers/embed-model-transformer.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"embed-model-transformer.js","sources":["../../../src/validation/transformers/embed-model-transformer.ts"],"sourcesContent":[null],"names":["Model"],"mappings":"6DAGa,wBAAwB,GAAwB,CAAC,KAAK,EAAE,OAAO,KAAI;IAC9E,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,WAAW,CAAC;AAEnD,IAAA,IAAI,KAAK,YAAYA,WAAK,KAAK,KAAK,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;AAC7D,QAAA,OAAO,KAAK,CAAC;AACd,KAAA;AAED,IAAA,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE;AACxB,QAAA,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,KAAI;AACxB,YAAA,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;AAC7B,gBAAA,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC;AACpB,aAAA;AAED,YAAA,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC1B,SAAC,CAAC,CAAC;AACJ,KAAA;AAED,IAAA,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;AAC7B,QAAA,OAAQ,KAAa,CAAC,KAAK,CAAC,CAAC;AAC9B,KAAA;AAED,IAAA,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC3B"}

package/cjs/validation/validators/embed-validator.d.ts

@@ -1,21 +0,0 @@
-import { BaseValidator } from "@warlock.js/seal";
-import { type ChildModel } from "../../model/model";
-export declare class EmbedModelValidator extends BaseValidator {
-    /**
-     * Check if value is a string type
-     */
-    matchesType(value: any): boolean;
-    /**
-     * Mutate the value to be a model, also fail if the mutated value is not a valid model
-     */
-    model(model: ChildModel<any> | string, errorMessage?: string): EmbedModelValidator;
-    /**
-     * Validate the value is a list of models
-     */
-    models(model: ChildModel<any> | string, errorMessage?: string): EmbedModelValidator;
-    /**
-     * Determine how the data will be stored as an embedded document
-     */
-    embed(embed?: string | string[]): EmbedModelValidator;
-}
-//# sourceMappingURL=embed-validator.d.ts.map

package/cjs/validation/validators/embed-validator.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"embed-validator.d.ts","sourceRoot":"","sources":["../../../src/validation/validators/embed-validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAS,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAK3D,qBAAa,mBAAoB,SAAQ,aAAa;IACpD;;OAEG;IACI,WAAW,CAAC,KAAK,EAAE,GAAG,GAAG,OAAO;IAQvC;;OAEG;IACI,KAAK,CAAC,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,GAAG,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,mBAAmB;IAUzF;;OAEG;IACI,MAAM,CAAC,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC,GAAG,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,mBAAmB;IAc1F;;OAEG;IACI,KAAK,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,mBAAmB;CAK7D"}

package/cjs/validation/validators/embed-validator.js

@@ -1,43 +0,0 @@
-'use strict';var seal=require('@warlock.js/seal'),model=require('../../model/model.js'),embedMutator=require('../mutators/embed-mutator.js'),databaseModelRule=require('../rules/database-model-rule.js'),embedModelTransformer=require('../transformers/embed-model-transformer.js');class EmbedModelValidator extends seal.BaseValidator {
-    /**
-     * Check if value is a string type
-     */
-    matchesType(value) {
-        return (value instanceof model.Model ||
-            typeof value === "number" ||
-            (Array.isArray(value) && value.every((item) => item instanceof model.Model)));
-    }
-    /**
-     * Mutate the value to be a model, also fail if the mutated value is not a valid model
-     */
-    model(model, errorMessage) {
-        this.addMutator(embedMutator.databaseModelMutator, {
-            model,
-        });
-        return this.addRule(databaseModelRule.databaseModelRule, errorMessage, {
-            model,
-        });
-    }
-    /**
-     * Validate the value is a list of models
-     */
-    models(model, errorMessage) {
-        const instance = this.instance;
-        instance.addMutator(embedMutator.databaseModelsMutator, {
-            model,
-        });
-        instance.addMutableRule(seal.arrayRule);
-        instance.addMutableRule(databaseModelRule.databaseModelsRule, errorMessage, {
-            model,
-        });
-        return instance;
-    }
-    /**
-     * Determine how the data will be stored as an embedded document
-     */
-    embed(embed) {
-        return this.addTransformer(embedModelTransformer.databaseModelTransformer, {
-            embed,
-        });
-    }
-}exports.EmbedModelValidator=EmbedModelValidator;//# sourceMappingURL=embed-validator.js.map

package/cjs/validation/validators/embed-validator.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"embed-validator.js","sources":["../../../src/validation/validators/embed-validator.ts"],"sourcesContent":[null],"names":["BaseValidator","Model","databaseModelMutator","databaseModelRule","databaseModelsMutator","arrayRule","databaseModelsRule","databaseModelTransformer"],"mappings":"sRAMM,MAAO,mBAAoB,SAAQA,kBAAa,CAAA;AACpD;;AAEG;AACI,IAAA,WAAW,CAAC,KAAU,EAAA;QAC3B,QACE,KAAK,YAAYC,WAAK;YACtB,OAAO,KAAK,KAAK,QAAQ;aACxB,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,IAAI,YAAYA,WAAK,CAAC,CAAC,EACtE;KACH;AAED;;AAEG;IACI,KAAK,CAAC,KAA+B,EAAE,YAAqB,EAAA;AACjE,QAAA,IAAI,CAAC,UAAU,CAACC,iCAAoB,EAAE;YACpC,KAAK;AACN,SAAA,CAAC,CAAC;AAEH,QAAA,OAAO,IAAI,CAAC,OAAO,CAACC,mCAAiB,EAAE,YAAY,EAAE;YACnD,KAAK;AACN,SAAA,CAAC,CAAC;KACJ;AAED;;AAEG;IACI,MAAM,CAAC,KAA+B,EAAE,YAAqB,EAAA;AAClE,QAAA,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;AAC/B,QAAA,QAAQ,CAAC,UAAU,CAACC,kCAAqB,EAAE;YACzC,KAAK;AACN,SAAA,CAAC,CAAC;AAEH,QAAA,QAAQ,CAAC,cAAc,CAACC,cAAS,CAAC,CAAC;AACnC,QAAA,QAAQ,CAAC,cAAc,CAACC,oCAAkB,EAAE,YAAY,EAAE;YACxD,KAAK;AACN,SAAA,CAAC,CAAC;AAEH,QAAA,OAAO,QAAQ,CAAC;KACjB;AAED;;AAEG;AACI,IAAA,KAAK,CAAC,KAAyB,EAAA;AACpC,QAAA,OAAO,IAAI,CAAC,cAAc,CAACC,8CAAwB,EAAE;YACnD,KAAK;AACN,SAAA,CAAC,CAAC;KACJ;AACF"}

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

@@ -1,181 +0,0 @@
-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
-     */
-    generateNextId(): Promise<void>;
-    /**
-     * 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

@@ -1 +0,0 @@
-{"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;IAgE7B;;;;;;OAMG;YACW,aAAa;IAyC3B;;;;;;OAMG;YACW,aAAa;IAsC3B;;;;OAIG;IACU,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAwB5C;;;;;;;;;;;;;;;;;;;;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"}