@warlock.js/cascade 4.0.174 → 4.1.2

package/esm/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/esm/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/esm/validation/rules/database-model-rule.js

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

package/esm/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":[],"mappings":"gKAIa,MAAA,iBAAiB,GAAe;AAC3C,IAAA,IAAI,EAAE,eAAe;AACrB,IAAA,mBAAmB,EAAE,yCAAyC;AAC9D,IAAA,MAAM,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAA;AAC3B,QAAA,IAAI,KAAK,YAAY,KAAK,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,OAAO,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACnC,SAAA;AAED,QAAA,OAAO,UAAU,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,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC;AACrC,QAAA,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;AAC7B,YAAA,KAAK,GAAG,oBAAoB,CAAC,KAAK,CAAE,CAAC;AACtC,SAAA;QAED,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC;AAE/C,QAAA,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;AAAE,YAAA,OAAO,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAE7D,QAAA,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,IAAI,YAAY,KAAK,CAAC;AAAE,YAAA,OAAO,UAAU,CAAC;AAEpE,QAAA,OAAO,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;KACnC;"}

package/esm/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/esm/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/esm/validation/transformers/embed-model-transformer.js

@@ -1,18 +0,0 @@
-import {Model}from'../../model/model.js';const databaseModelTransformer = (value, context) => {
-    const embed = context.options.embed ?? "embedData";
-    if (value instanceof 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);
-};export{databaseModelTransformer};//# sourceMappingURL=embed-model-transformer.js.map

package/esm/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":[],"mappings":"+CAGa,wBAAwB,GAAwB,CAAC,KAAK,EAAE,OAAO,KAAI;IAC9E,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,WAAW,CAAC;AAEnD,IAAA,IAAI,KAAK,YAAY,KAAK,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/esm/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/esm/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/esm/validation/validators/embed-validator.js

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

package/esm/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":[],"mappings":"2VAMM,MAAO,mBAAoB,SAAQ,aAAa,CAAA;AACpD;;AAEG;AACI,IAAA,WAAW,CAAC,KAAU,EAAA;QAC3B,QACE,KAAK,YAAY,KAAK;YACtB,OAAO,KAAK,KAAK,QAAQ;aACxB,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,IAAI,YAAY,KAAK,CAAC,CAAC,EACtE;KACH;AAED;;AAEG;IACI,KAAK,CAAC,KAA+B,EAAE,YAAqB,EAAA;AACjE,QAAA,IAAI,CAAC,UAAU,CAAC,oBAAoB,EAAE;YACpC,KAAK;AACN,SAAA,CAAC,CAAC;AAEH,QAAA,OAAO,IAAI,CAAC,OAAO,CAAC,iBAAiB,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,CAAC,qBAAqB,EAAE;YACzC,KAAK;AACN,SAAA,CAAC,CAAC;AAEH,QAAA,QAAQ,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;AACnC,QAAA,QAAQ,CAAC,cAAc,CAAC,kBAAkB,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,CAAC,wBAAwB,EAAE;YACnD,KAAK;AACN,SAAA,CAAC,CAAC;KACJ;AACF"}

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

@@ -1,174 +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.
-     *
-     * 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/esm/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;;;;;;;;OAQG;YACW,WAAW;CAI1B"}