@warlock.js/cascade 4.0.48 → 4.0.58

package/esm/restorer/database-restorer.js

@@ -0,0 +1,425 @@
+/**
+ * Database restorer service that orchestrates model restoration.
+ *
+ * Handles 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"
+ * ```
+ */
+class DatabaseRestorer {
+    /** Model constructor reference */
+    ctor;
+    /** Data source containing driver */
+    dataSource;
+    /** Database driver for executing queries */
+    driver;
+    /** Table/collection name */
+    table;
+    /** Primary key field name */
+    primaryKey;
+    /**
+     * Create a new restorer instance for a model class.
+     *
+     * @param modelClass - The model class (static context)
+     *
+     * @example
+     * ```typescript
+     * const restorer = new DatabaseRestorer(User);
+     * await restorer.restore(123);
+     * ```
+     */
+    constructor(modelClass) {
+        this.ctor = modelClass;
+        this.dataSource = modelClass.getDataSource();
+        this.driver = this.dataSource.driver;
+        this.table = modelClass.table;
+        this.primaryKey = modelClass.primaryKey;
+    }
+    /**
+     * Restore a single deleted record by its ID.
+     *
+     * @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 record not found in trash or soft-deleted records
+     * @throws {Error} If ID conflict and onIdConflict is "fail"
+     */
+    async restore(id, options = {}) {
+        const onIdConflict = options.onIdConflict ?? "assignNew";
+        const skipEvents = options.skipEvents ?? false;
+        // 1. Resolve strategy (options → model static → data source default)
+        const strategy = this.resolveStrategy(options.strategy);
+        // 2. Validate strategy (cannot restore permanent deletes)
+        if (strategy === "permanent") {
+            throw new Error(`Cannot restore ${this.ctor.name} with ${this.primaryKey} ${id}: permanently deleted records cannot be restored.`);
+        }
+        // 3. Fetch record based on strategy
+        const recordData = await this.fetchRecordByStrategy(id, strategy);
+        if (!recordData) {
+            throw new Error(`Cannot restore ${this.ctor.name} with ${this.primaryKey} ${id}: record not found in ${strategy === "trash" ? "trash table" : "soft-deleted records"}.`);
+        }
+        // 4. Prepare record data (remove metadata fields)
+        const restoredData = { ...recordData };
+        delete restoredData.deletedAt;
+        delete restoredData.originalTable;
+        // 5. Check for ID conflict and handle
+        const finalData = await this.handleIdConflict(restoredData, id, onIdConflict);
+        // 6. Create temporary model instance for event emission
+        // Note: Model is abstract, but at runtime this.ctor is a concrete subclass
+        const model = new this.ctor(finalData);
+        // 7. Emit restoring event (unless skipEvents)
+        if (!skipEvents) {
+            await model.emitEvent("restoring");
+        }
+        // 8. Restore based on strategy
+        if (strategy === "trash") {
+            // Insert record back into original table (was moved to trash)
+            await this.driver.insert(this.table, finalData);
+            model.isNew = false;
+            // Remove from trash table
+            await this.driver.delete(this.resolveTrashTable(), {
+                [this.primaryKey]: id,
+            });
+        }
+        else if (strategy === "soft") {
+            // Record still exists, just unset deletedAt (don't insert - would create duplicate!)
+            const deletedAtColumn = this.ctor.deletedAtColumn ?? "deletedAt";
+            const filter = { [this.primaryKey]: id };
+            const updateOperations = {
+                $unset: { [deletedAtColumn]: 1 },
+            };
+            await this.driver.update(this.table, filter, updateOperations);
+            model.isNew = false;
+        }
+        // 10. Emit restored event (unless skipEvents)
+        if (!skipEvents) {
+            await model.emitEvent("restored");
+        }
+        return {
+            success: true,
+            restoredCount: 1,
+            strategy,
+            restoredRecord: model,
+        };
+    }
+    /**
+     * Restore all deleted records for the model's table.
+     *
+     * @param options - Restorer options
+     * @returns Result containing success status, strategy used, and aggregate counts
+     */
+    async restoreAll(options = {}) {
+        const onIdConflict = options.onIdConflict ?? "assignNew";
+        const skipEvents = options.skipEvents ?? false;
+        // 1. Resolve strategy (options → model static → data source default)
+        const strategy = this.resolveStrategy(options.strategy);
+        // 2. Validate strategy (cannot restore permanent deletes)
+        if (strategy === "permanent") {
+            throw new Error(`Cannot restore all ${this.ctor.name} records: permanently deleted records cannot be restored.`);
+        }
+        // 3. Fetch all records based on strategy
+        const recordsToRestore = await this.fetchAllRecordsByStrategy(strategy);
+        if (recordsToRestore.length === 0) {
+            return {
+                success: true,
+                restoredCount: 0,
+                strategy,
+            };
+        }
+        // 4. Restore each record
+        let restoredCount = 0;
+        const conflicts = [];
+        const restoredRecords = [];
+        for (const recordData of recordsToRestore) {
+            const id = recordData[this.primaryKey];
+            try {
+                // Prepare record data (remove metadata fields)
+                const restoredData = { ...recordData };
+                delete restoredData.deletedAt;
+                delete restoredData.originalTable;
+                // Check for ID conflict
+                const idExists = await this.checkIdExists(id);
+                if (idExists) {
+                    if (onIdConflict === "fail") {
+                        throw new Error(`Cannot restore ${this.ctor.name} with ${this.primaryKey} ${id}: ID already exists in target table.`);
+                    }
+                    // Assign new ID
+                    const finalData = await this.assignNewId(restoredData);
+                    conflicts.push({
+                        id,
+                        reason: `ID ${id} already exists, assigned new ID ${finalData[this.primaryKey]}`,
+                    });
+                    // Create temporary model for events
+                    const model = new this.ctor(finalData);
+                    // Emit restoring event
+                    if (!skipEvents) {
+                        await model.emitEvent("restoring");
+                    }
+                    // Restore based on strategy
+                    if (strategy === "trash") {
+                        // Insert with new ID (was moved to trash)
+                        await this.driver.insert(this.table, finalData);
+                        model.isNew = false;
+                    }
+                    else if (strategy === "soft") {
+                        // Record still exists, just unset deletedAt
+                        const deletedAtColumn = this.ctor.deletedAtColumn ?? "deletedAt";
+                        const filter = { [this.primaryKey]: id };
+                        const updateOperations = {
+                            $unset: { [deletedAtColumn]: 1 },
+                        };
+                        await this.driver.update(this.table, filter, updateOperations);
+                        model.isNew = false;
+                    }
+                    restoredRecords.push(model);
+                    // Emit restored event
+                    if (!skipEvents) {
+                        await model.emitEvent("restored");
+                    }
+                }
+                else {
+                    // No conflict, restore with original ID
+                    const model = new this.ctor(restoredData);
+                    // Emit restoring event
+                    if (!skipEvents) {
+                        await model.emitEvent("restoring");
+                    }
+                    // Restore based on strategy
+                    if (strategy === "trash") {
+                        // Insert with original ID (was moved to trash)
+                        await this.driver.insert(this.table, restoredData);
+                        model.isNew = false;
+                    }
+                    else if (strategy === "soft") {
+                        // Record still exists, just unset deletedAt
+                        const deletedAtColumn = this.ctor.deletedAtColumn ?? "deletedAt";
+                        const filter = { [this.primaryKey]: id };
+                        const updateOperations = {
+                            $unset: { [deletedAtColumn]: 1 },
+                        };
+                        await this.driver.update(this.table, filter, updateOperations);
+                        model.isNew = false;
+                    }
+                    restoredRecords.push(model);
+                    // Emit restored event
+                    if (!skipEvents) {
+                        await model.emitEvent("restored");
+                    }
+                }
+                // Remove from trash (only for trash strategy)
+                if (strategy === "trash") {
+                    const trashTable = this.resolveTrashTable();
+                    const trashFilter = { [this.primaryKey]: id };
+                    await this.driver.delete(trashTable, trashFilter);
+                }
+                restoredCount++;
+            }
+            catch (error) {
+                if (onIdConflict === "fail") {
+                    throw error;
+                }
+                // Continue with next record if assignNew mode
+                conflicts.push({
+                    id,
+                    reason: error instanceof Error ? error.message : String(error),
+                });
+            }
+        }
+        return {
+            success: true,
+            restoredCount,
+            restoredRecords,
+            strategy,
+            conflicts: conflicts.length > 0 ? conflicts : undefined,
+        };
+    }
+    /**
+     * Resolve the delete strategy.
+     *
+     * Priority: options → model static → data source default → "permanent"
+     *
+     * @param strategyOption - Optional strategy override from options
+     * @returns The resolved delete strategy
+     * @private
+     */
+    resolveStrategy(strategyOption) {
+        return (strategyOption ??
+            this.ctor.deleteStrategy ??
+            this.dataSource.defaultDeleteStrategy ??
+            "permanent");
+    }
+    /**
+     * Fetch a record by ID based on the delete strategy.
+     *
+     * @param id - The primary key value
+     * @param strategy - The delete strategy to use
+     * @returns The record data, or null if not found
+     * @private
+     */
+    async fetchRecordByStrategy(id, strategy) {
+        if (strategy === "trash") {
+            const trashTable = this.resolveTrashTable();
+            try {
+                const trashQuery = await this.driver
+                    .queryBuilder(trashTable)
+                    .where(this.primaryKey, id)
+                    .first();
+                return trashQuery;
+            }
+            catch {
+                return null;
+            }
+        }
+        else if (strategy === "soft") {
+            const deletedAtColumn = this.ctor.deletedAtColumn ?? "deletedAt";
+            try {
+                const softDeletedQuery = await this.driver
+                    .queryBuilder(this.table)
+                    .where(this.primaryKey, id)
+                    .whereNotNull(deletedAtColumn)
+                    .first();
+                return softDeletedQuery;
+            }
+            catch {
+                return null;
+            }
+        }
+        return null;
+    }
+    /**
+     * Fetch all records based on the delete strategy.
+     *
+     * @param strategy - The delete strategy to use
+     * @returns Array of record data
+     * @private
+     */
+    async fetchAllRecordsByStrategy(strategy) {
+        if (strategy === "trash") {
+            const trashTable = this.resolveTrashTable();
+            try {
+                const trashQuery = this.driver
+                    .queryBuilder(trashTable)
+                    .where("originalTable", this.table)
+                    .get();
+                return (await trashQuery);
+            }
+            catch {
+                return [];
+            }
+        }
+        else if (strategy === "soft") {
+            const deletedAtColumn = this.ctor.deletedAtColumn ?? "deletedAt";
+            try {
+                const softDeletedQuery = this.driver
+                    .queryBuilder(this.table)
+                    .whereNotNull(deletedAtColumn)
+                    .get();
+                return (await softDeletedQuery);
+            }
+            catch {
+                return [];
+            }
+        }
+        return [];
+    }
+    /**
+     * Handle ID conflict by checking if ID exists and assigning new one if needed.
+     *
+     * @param recordData - The record data to restore
+     * @param originalId - The original ID value
+     * @param onIdConflict - Conflict resolution strategy
+     * @returns Record data with potentially new ID
+     * @private
+     */
+    async handleIdConflict(recordData, originalId, onIdConflict) {
+        const idExists = await this.checkIdExists(originalId);
+        if (idExists) {
+            if (onIdConflict === "fail") {
+                throw new Error(`Cannot restore ${this.ctor.name} with ${this.primaryKey} ${originalId}: ID already exists in target table.`);
+            }
+            // Assign new ID
+            return await this.assignNewId(recordData);
+        }
+        return recordData;
+    }
+    /**
+     * Check if an ID already exists in the target table.
+     *
+     * @param id - The ID to check
+     * @returns True if ID exists, false otherwise
+     * @private
+     */
+    async checkIdExists(id) {
+        try {
+            const query = this.driver
+                .queryBuilder(this.table)
+                .where(this.primaryKey, id)
+                .exists();
+            return await query;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Assign a new ID to the record data.
+     *
+     * For MongoDB: Generates new ObjectId for `_id`, keeps `id` if it exists
+     * For SQL: Removes `id` to let database auto-increment
+     *
+     * @param recordData - The record data
+     * @returns Record data with new ID assigned
+     * @private
+     */
+    async assignNewId(recordData) {
+        const isMongoDb = this.driver.name === "mongodb";
+        const newData = { ...recordData };
+        if (isMongoDb) {
+            // MongoDB: Generate new ObjectId for _id
+            if (this.primaryKey === "_id") {
+                // Remove _id to let MongoDB generate new one
+                delete newData._id;
+            }
+            else if (this.primaryKey === "id") {
+                // Remove id to let ID generator create new one
+                delete newData.id;
+            }
+        }
+        else {
+            // SQL: Remove primary key to let database auto-increment
+            delete newData[this.primaryKey];
+        }
+        return newData;
+    }
+    /**
+     * Resolve the trash table/collection name.
+     *
+     * Priority:
+     * 1. Model.trashTable (if set)
+     * 2. Data source defaultTrashTable (e.g., "RecycleBin" for MongoDB)
+     * 3. Default pattern: `{table}Trash`
+     *
+     * @returns The trash table/collection name
+     * @private
+     */
+    resolveTrashTable() {
+        if (this.ctor.trashTable) {
+            return this.ctor.trashTable;
+        }
+        if (this.dataSource.defaultTrashTable) {
+            return this.dataSource.defaultTrashTable;
+        }
+        return `${this.table}Trash`;
+    }
+}export{DatabaseRestorer};//# sourceMappingURL=database-restorer.js.map

package/esm/restorer/database-restorer.js.map

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

package/esm/sync/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Sync system exports.
+ *
+ * @module cascade-next/sync
+ */
+export { modelSync } from "./model-sync";
+export { ModelSyncOperation } from "./model-sync-operation";
+export { MODEL_EVENT_PREFIX, ModelSyncEventType, getModelDeletedEvent, getModelEvent, getModelUpdatedEvent, } from "./model-events";
+export { DEFAULT_MAX_SYNC_DEPTH, SyncContextManager } from "./sync-context";
+export { SyncManager } from "./sync-manager";
+export type { EmbedKey, ModelSyncConfig, ModelSyncContract, ModelSyncOperationContract, SyncConfig, SyncContext, SyncEventPayload, SyncInstruction, SyncInstructionOptions, SyncResult, } from "./types";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sync/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAG5D,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,oBAAoB,EACpB,aAAa,EACb,oBAAoB,GACrB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAC5E,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C,YAAY,EACV,QAAQ,EACR,eAAe,EACf,iBAAiB,EACjB,0BAA0B,EAC1B,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,sBAAsB,EACtB,UAAU,GACX,MAAM,SAAS,CAAC"}

package/esm/sync/model-events.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Model sync event name helpers.
+ *
+ * Provides type-safe event names for model sync operations.
+ * Avoids hardcoded string literals throughout the codebase.
+ *
+ * @module cascade-next/sync/model-events
+ */
+import type { ChildModel, Model } from "../model/model";
+/**
+ * Event name prefix for all model sync events.
+ */
+export declare const MODEL_EVENT_PREFIX = "model";
+/**
+ * Model sync event types.
+ */
+export declare const ModelSyncEventType: {
+    readonly UPDATED: "updated";
+    readonly DELETED: "deleted";
+};
+export type ModelSyncEventTypeName = (typeof ModelSyncEventType)[keyof typeof ModelSyncEventType];
+/**
+ * Get the event name for a model update.
+ *
+ * @param modelClass - The model class
+ * @returns Event name string (e.g., "model.Category.updated")
+ *
+ * @example
+ * ```typescript
+ * const eventName = getModelUpdatedEvent(Category);
+ * // Returns: "model.Category.updated"
+ * ```
+ */
+export declare function getModelUpdatedEvent(modelClass: ChildModel<Model>): string;
+/**
+ * Get the event name for a model deletion.
+ *
+ * @param modelClass - The model class
+ * @returns Event name string (e.g., "model.Category.deleted")
+ *
+ * @example
+ * ```typescript
+ * const eventName = getModelDeletedEvent(Category);
+ * // Returns: "model.Category.deleted"
+ * ```
+ */
+export declare function getModelDeletedEvent(modelClass: ChildModel<Model>): string;
+/**
+ * Get the event name for a model by name string.
+ *
+ * @param modelName - The model class name
+ * @param eventType - The event type
+ * @returns Event name string
+ *
+ * @example
+ * ```typescript
+ * const eventName = getModelEvent("Category", "updated");
+ * // Returns: "model.Category.updated"
+ * ```
+ */
+export declare function getModelEvent(modelName: string, eventType: ModelSyncEventTypeName): string;
+//# sourceMappingURL=model-events.d.ts.map

package/esm/sync/model-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-events.d.ts","sourceRoot":"","sources":["../../src/sync/model-events.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,kBAAkB,UAAU,CAAC;AAE1C;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;CAGrB,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAElG;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,UAAU,CAAC,KAAK,CAAC,GAAG,MAAM,CAE1E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,UAAU,CAAC,KAAK,CAAC,GAAG,MAAM,CAE1E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,sBAAsB,GAAG,MAAM,CAE1F"}

package/esm/sync/model-events.js

@@ -0,0 +1,49 @@
+/**
+ * Model sync event name helpers.
+ *
+ * Provides type-safe event names for model sync operations.
+ * Avoids hardcoded string literals throughout the codebase.
+ *
+ * @module cascade-next/sync/model-events
+ */
+/**
+ * Event name prefix for all model sync events.
+ */
+const MODEL_EVENT_PREFIX = "model";
+/**
+ * Model sync event types.
+ */
+const ModelSyncEventType = {
+    UPDATED: "updated",
+    DELETED: "deleted",
+};
+/**
+ * Get the event name for a model update.
+ *
+ * @param modelClass - The model class
+ * @returns Event name string (e.g., "model.Category.updated")
+ *
+ * @example
+ * ```typescript
+ * const eventName = getModelUpdatedEvent(Category);
+ * // Returns: "model.Category.updated"
+ * ```
+ */
+function getModelUpdatedEvent(modelClass) {
+    return `${MODEL_EVENT_PREFIX}.${modelClass.name}.${ModelSyncEventType.UPDATED}`;
+}
+/**
+ * Get the event name for a model deletion.
+ *
+ * @param modelClass - The model class
+ * @returns Event name string (e.g., "model.Category.deleted")
+ *
+ * @example
+ * ```typescript
+ * const eventName = getModelDeletedEvent(Category);
+ * // Returns: "model.Category.deleted"
+ * ```
+ */
+function getModelDeletedEvent(modelClass) {
+    return `${MODEL_EVENT_PREFIX}.${modelClass.name}.${ModelSyncEventType.DELETED}`;
+}export{MODEL_EVENT_PREFIX,ModelSyncEventType,getModelDeletedEvent,getModelUpdatedEvent};//# sourceMappingURL=model-events.js.map

package/esm/sync/model-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-events.js","sources":["../../src/sync/model-events.ts"],"sourcesContent":[null],"names":[],"mappings":"AAAA;;;;;;;AAOG;AAIH;;AAEG;AACI,MAAM,kBAAkB,GAAG,QAAQ;AAE1C;;AAEG;AACU,MAAA,kBAAkB,GAAG;AAChC,IAAA,OAAO,EAAE,SAAS;AAClB,IAAA,OAAO,EAAE,SAAS;EACT;AAIX;;;;;;;;;;;AAWG;AACG,SAAU,oBAAoB,CAAC,UAA6B,EAAA;IAChE,OAAO,CAAA,EAAG,kBAAkB,CAAA,CAAA,EAAI,UAAU,CAAC,IAAI,CAAA,CAAA,EAAI,kBAAkB,CAAC,OAAO,CAAA,CAAE,CAAC;AAClF,CAAC;AAED;;;;;;;;;;;AAWG;AACG,SAAU,oBAAoB,CAAC,UAA6B,EAAA;IAChE,OAAO,CAAA,EAAG,kBAAkB,CAAA,CAAA,EAAI,UAAU,CAAC,IAAI,CAAA,CAAA,EAAI,kBAAkB,CAAC,OAAO,CAAA,CAAE,CAAC;AAClF"}