@warlock.js/cascade 4.0.157 → 4.0.161

package/esm/contracts/database-restorer.contract.d.ts

@@ -1,143 +0,0 @@
-import type { Model } from "../model/model";
-/**
- * Restorer service contract for restoring deleted models from the database.
- *
- * The restorer orchestrates the complete restoration pipeline:
- * 1. Strategy detection (trash vs soft delete)
- * 2. Record retrieval from trash table or soft-deleted records
- * 3. ID conflict resolution
- * 4. Event emission (restoring, restored)
- * 5. Driver execution (insert back to original table, remove from trash/clear deletedAt)
- *
- * @example
- * ```typescript
- * const restorer = new DatabaseRestorer(User);
- * const result = await restorer.restore(123);
- *
- * console.log(result.success); // true
- * console.log(result.strategy); // "trash" | "soft"
- * console.log(result.restoredCount); // 1
- * ```
- */
-export interface RestorerContract {
-    /**
-     * Restore a single deleted record by its ID.
-     *
-     * Resolves the delete strategy from options → model static → data source default.
-     * Handles ID conflicts based on options.
-     *
-     * @param id - The primary key value of the record to restore
-     * @param options - Restorer options
-     * @returns Result containing success status, strategy used, and restored record
-     *
-     * @throws {Error} If strategy is "permanent" (cannot restore permanently deleted records)
-     * @throws {Error} If record not found in trash or soft-deleted records
-     * @throws {Error} If ID conflict and onIdConflict is "fail"
-     *
-     * @example
-     * ```typescript
-     * // Restore with default options (assign new ID if conflict)
-     * const result = await restorer.restore(123);
-     *
-     * // Restore with explicit strategy
-     * await restorer.restore(123, { strategy: "trash" });
-     *
-     * // Restore and fail if ID conflict
-     * await restorer.restore(123, { onIdConflict: "fail" });
-     *
-     * // Silent restore (skip events)
-     * await restorer.restore(123, { skipEvents: true });
-     * ```
-     */
-    restore(id: string | number, options?: RestorerOptions): Promise<RestorerResult>;
-    /**
-     * Restore all deleted records for the model's table.
-     *
-     * Restores all records from the trash table (if using trash strategy)
-     * or all soft-deleted records (if using soft strategy).
-     *
-     * @param options - Restorer options
-     * @returns Result containing success status, strategy used, and aggregate counts
-     *
-     * @example
-     * ```typescript
-     * // Restore all with default options
-     * const result = await restorer.restoreAll();
-     *
-     * // Restore all and fail on any ID conflict
-     * await restorer.restoreAll({ onIdConflict: "fail" });
-     * ```
-     */
-    restoreAll(options?: RestorerOptions): Promise<RestorerResult>;
-}
-/**
- * Options for controlling the restore operation.
- */
-export type RestorerOptions = {
-    /**
-     * Override the delete strategy for this operation.
-     * Takes precedence over model static property and data source default.
-     *
-     * Must be "trash" or "soft" (cannot restore permanently deleted records).
-     *
-     * @default undefined (uses model static or data source default)
-     */
-    strategy?: "trash" | "soft";
-    /**
-     * Behavior when the original ID already exists in the target table.
-     *
-     * - `"assignNew"`: Automatically assign a new ID (default)
-     * - `"fail"`: Throw an error if ID conflict occurs
-     *
-     * @default "assignNew"
-     */
-    onIdConflict?: "fail" | "assignNew";
-    /**
-     * Skip lifecycle event emission.
-     * Equivalent to "silent restore".
-     *
-     * @default false
-     */
-    skipEvents?: boolean;
-};
-/**
- * Result returned after a successful restore operation.
- */
-export type RestorerResult = {
-    /**
-     * Whether the restore operation succeeded.
-     */
-    success: boolean;
-    /**
-     * Number of records restored.
-     * - `1` for single restore
-     * - `N` for restoreAll (number of records restored)
-     */
-    restoredCount: number;
-    /**
-     * The delete strategy that was used for restoration.
-     * - `"trash"`: Record was restored from trash table
-     * - `"soft"`: Record was restored by clearing deletedAt timestamp
-     */
-    strategy: "trash" | "soft";
-    /**
-     * The restored record data (for single restore only).
-     * Contains the record that was restored, with potentially new ID if conflict occurred.
-     */
-    restoredRecord?: Model;
-    /**
-     * The restored records list
-     */
-    restoredRecords?: Model[];
-    /**
-     * List of ID conflicts that occurred during restoreAll.
-     * Only populated if onIdConflict is "assignNew" and conflicts occurred.
-     */
-    conflicts?: Array<{
-        /** The original ID that conflicted */
-        id: string | number;
-        /** Reason for the conflict */
-        reason: string;
-    }>;
-};
-//# sourceMappingURL=database-restorer.contract.d.ts.map

package/esm/contracts/database-restorer.contract.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"database-restorer.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/database-restorer.contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE5C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACH,OAAO,CACL,EAAE,EAAE,MAAM,GAAG,MAAM,EACnB,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,cAAc,CAAC,CAAC;IAE3B;;;;;;;;;;;;;;;;;OAiBG;IACH,UAAU,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CAChE;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAE5B;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAEpC;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;;;OAIG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;;;OAIG;IACH,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC;IAE3B;;;OAGG;IACH,cAAc,CAAC,EAAE,KAAK,CAAC;IAEvB;;OAEG;IACH,eAAe,CAAC,EAAE,KAAK,EAAE,CAAC;IAE1B;;;OAGG;IACH,SAAS,CAAC,EAAE,KAAK,CAAC;QAChB,sCAAsC;QACtC,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC;QACpB,8BAA8B;QAC9B,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;CACJ,CAAC"}

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

@@ -1,119 +0,0 @@
-import type { UpdateOperations } from "./database-driver.contract";
-/**
- * Writer service contract for persisting models to the database.
- *
- * The writer orchestrates the complete save pipeline:
- * 1. Validation (via @warlock.js/seal)
- * 2. ID generation (for new records in NoSQL)
- * 3. Event emission (validating, saving, created/updated, saved)
- * 4. Driver execution (insert or update)
- * 5. Post-save cleanup (reset dirty tracker, update isNew flag)
- *
- * @example
- * ```typescript
- * const user = new User({ name: "Alice" });
- * const writer = new DatabaseWriter(user);
- * const result = await writer.save();
- *
- * console.log(result.success); // true
- * console.log(result.isNew); // true (was an insert)
- * console.log(result.document); // { _id: ..., id: 1, name: "Alice" }
- * ```
- */
-export interface WriterContract {
-    /**
-     * Save the model instance to the database.
-     *
-     * Performs insert if `model.isNew === true`, otherwise performs update.
-     * Automatically validates, casts, generates IDs, and emits lifecycle events.
-     *
-     * @param options - Save options
-     * @returns Result containing success status, document, and metadata
-     *
-     * @throws {ValidationError} If validation fails
-     * @throws {Error} If database operation fails
-     *
-     * @example
-     * ```typescript
-     * // Insert
-     * const user = new User({ name: "Alice" });
-     * const writer = new DatabaseWriter(user);
-     * await writer.save();
-     *
-     * // Update
-     * user.set("name", "Bob");
-     * await writer.save();
-     *
-     * // Skip validation
-     * await writer.save({ skipValidation: true });
-     *
-     * // Skip events (silent save)
-     * await writer.save({ skipEvents: true });
-     * ```
-     */
-    save(options?: WriterOptions): Promise<WriterResult>;
-}
-/**
- * Options for controlling the save operation.
- */
-export type WriterOptions = {
-    /**
-     * Skip validation and casting.
-     * Useful when data is already validated or for performance-critical operations.
-     *
-     * @default false
-     */
-    skipValidation?: boolean;
-    /**
-     * Skip lifecycle event emission.
-     * Equivalent to "silent save" in legacy Cascade.
-     *
-     * @default false
-     */
-    skipEvents?: boolean;
-    /**
-     * Skip sync operations after save.
-     * Useful when you want to save without triggering sync updates.
-     *
-     * @default false
-     */
-    skipSync?: boolean;
-    /**
-     * Replace entire document with the new data.
-     * By default, Model will only update or unset the dirty changes.
-     * @default false
-     */
-    replace?: boolean;
-};
-/**
- * Result returned after a successful save operation.
- */
-export type WriterResult = {
-    /**
-     * Whether the save operation succeeded.
-     */
-    success: boolean;
-    /**
-     * The saved document with all database-generated fields.
-     * Includes _id, id, timestamps, etc.
-     */
-    document: Record<string, unknown>;
-    /**
-     * Whether this was an insert operation.
-     * - `true`: New record was created
-     * - `false`: Existing record was updated
-     */
-    isNew: boolean;
-    /**
-     * Number of records modified (for updates only).
-     * Undefined for insert operations.
-     */
-    modifiedCount?: number;
-};
-/**
- * Internal type for building update operations from dirty tracker.
- *
- * @internal
- */
-export type BuildUpdateOperationsResult = UpdateOperations;
-//# sourceMappingURL=database-writer.contract.d.ts.map

package/esm/contracts/database-writer.contract.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"database-writer.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/database-writer.contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;CACtD;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B;;;;;OAKG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;;OAGG;IACH,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAElC;;;;OAIG;IACH,KAAK,EAAE,OAAO,CAAC;IAEf;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,2BAA2B,GAAG,gBAAgB,CAAC"}

package/esm/contracts/driver-blueprint.contract.d.ts

@@ -1,49 +0,0 @@
-export interface DriverBlueprintContract {
-    /**
-     * Get tables list
-     */
-    listTables(): Promise<string[]>;
-    /**
-     * Get all indexes of the given table
-     */
-    listIndexes(table: string): Promise<TableIndexInformation[]>;
-    /**
-     * Get all tables of the database
-     */
-    listTables(): Promise<string[]>;
-    /**
-     * Get all columns of the given table
-     */
-    listColumns(table: string): Promise<string[]>;
-    /**
-     * Check if the given table exists
-     */
-    tableExists(table: string): Promise<boolean>;
-}
-export type TableIndexInformation = {
-    /**
-     * Index name
-     */
-    name: string;
-    /**
-     * Index columns
-     */
-    columns?: string[];
-    /**
-     * Index type
-     */
-    type?: string;
-    /**
-     * Index unique
-     */
-    unique: boolean;
-    /**
-     * Index partial
-     */
-    partial: boolean;
-    /**
-     * Index options
-     */
-    options: Record<string, any>;
-};
-//# sourceMappingURL=driver-blueprint.contract.d.ts.map

package/esm/contracts/driver-blueprint.contract.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"driver-blueprint.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/driver-blueprint.contract.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAChC;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAE7D;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAEhC;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAE9C;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC9C;AAED,MAAM,MAAM,qBAAqB,GAAG;IAClC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,MAAM,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC9B,CAAC"}

package/esm/contracts/index.d.ts

@@ -1,10 +0,0 @@
-export * from "./database-driver.contract";
-export * from "./database-id-generator.contract";
-export * from "./database-remover.contract";
-export * from "./database-restorer.contract";
-export * from "./database-writer.contract";
-export * from "./driver-blueprint.contract";
-export * from "./migration-driver.contract";
-export * from "./query-builder.contract";
-export * from "./sync-adapter.contract";
-//# sourceMappingURL=index.d.ts.map

package/esm/contracts/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/contracts/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kCAAkC,CAAC;AACjD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,yBAAyB,CAAC"}