@memberjunction/version-history 0.0.1 → 4.0.0

package/dist/RestoreEngine.d.ts

@@ -0,0 +1,97 @@
+import { UserInfo } from '@memberjunction/core';
+import { RestoreOptions, RestoreResult } from './types.js';
+/**
+ * Restores records to the state captured by a version label.
+ *
+ * Key behaviors:
+ * - Automatically creates a "Pre-Restore" safety label before making changes
+ * - Restores in topological order (parents before children) based on entity
+ *   relationships to maintain referential integrity
+ * - Tracks progress and errors in a VersionLabelRestore audit record
+ * - Supports dry-run mode for previewing changes without applying them
+ */
+export declare class RestoreEngine {
+    private LabelMgr;
+    private SnapshotBldr;
+    /**
+     * Restore records to the state captured by a version label.
+     */
+    RestoreToLabel(labelId: string, options: RestoreOptions, contextUser: UserInfo): Promise<RestoreResult>;
+    /**
+     * Process all restore items in order, tracking progress and updating the
+     * audit record in batches.
+     */
+    private processRestoreItems;
+    /**
+     * Load all VersionLabelItems for a label, optionally filtered.
+     */
+    private loadLabelItems;
+    /**
+     * Filter label items to only include those matching a set of selected records.
+     */
+    private filterBySelectedRecords;
+    /**
+     * Sort label items by entity dependency order so parents are restored
+     * before their children.
+     */
+    private sortByDependencyOrder;
+    /**
+     * Restore a single record to its labeled state.
+     */
+    private restoreSingleItem;
+    /**
+     * Resolve entity metadata by ID.
+     */
+    private resolveEntityInfo;
+    /**
+     * Apply the snapshot data to an existing or new entity and save it.
+     */
+    private applyRestore;
+    /**
+     * Build a failed RestoreItemResult.
+     */
+    private failedItemResult;
+    /**
+     * Load an existing entity record, or create a new one if it doesn't exist.
+     */
+    private loadOrCreateEntity;
+    /**
+     * Apply snapshot data to an entity, setting each field from the snapshot.
+     * Returns true if any field was changed.
+     */
+    private applySnapshotToEntity;
+    /**
+     * Check if two values are meaningfully different.
+     */
+    private valuesDiffer;
+    /**
+     * Create a "Pre-Restore" safety label capturing current state of all
+     * records that will be affected by the restore.
+     */
+    private createPreRestoreLabel;
+    /**
+     * Create a VersionLabelRestore audit record.
+     */
+    private createRestoreAuditRecord;
+    /**
+     * Update restore progress counters.
+     */
+    private updateRestoreProgress;
+    /**
+     * Finalize the restore audit record.
+     */
+    private finalizeRestoreAudit;
+    /**
+     * Determine the overall status based on counts.
+     */
+    private determineFinalStatus;
+    /**
+     * Apply defaults to restore options.
+     */
+    private resolveDefaults;
+    /**
+     * Create an empty result (used when there's nothing to restore).
+     */
+    private emptyResult;
+}
+//# sourceMappingURL=RestoreEngine.d.ts.map

package/dist/RestoreEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RestoreEngine.d.ts","sourceRoot":"","sources":["../src/RestoreEngine.ts"],"names":[],"mappings":"AAAA,OAAO,EAMH,QAAQ,EAGX,MAAM,sBAAsB,CAAC;AAM9B,OAAO,EAEH,cAAc,EACd,aAAa,EAGhB,MAAM,SAAS,CAAC;AAiBjB;;;;;;;;;GASG;AACH,qBAAa,aAAa;IACtB,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,YAAY,CAAyB;IAE7C;;OAEG;IACU,cAAc,CACvB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,cAAc,EACvB,WAAW,EAAE,QAAQ,GACtB,OAAO,CAAC,aAAa,CAAC;IAoEzB;;;OAGG;YACW,mBAAmB;IAsCjC;;OAEG;YACW,cAAc;IAyC5B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAe/B;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IA8C7B;;OAEG;YACW,iBAAiB;IA8B/B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAKzB;;OAEG;YACW,YAAY;IAwB1B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAIxB;;OAEG;YACW,kBAAkB;IAqBhC;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IA0B7B;;OAEG;IACH,OAAO,CAAC,YAAY;IAMpB;;;OAGG;YACW,qBAAqB;IAuCnC;;OAEG;YACW,wBAAwB;IA2BtC;;OAEG;YACW,qBAAqB;IAoBnC;;OAEG;YACW,oBAAoB;IA6BlC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAU5B;;OAEG;IACH,OAAO,CAAC,eAAe;IAUvB;;OAEG;IACH,OAAO,CAAC,WAAW;CAWtB"}

package/dist/RestoreEngine.js

@@ -0,0 +1,432 @@
+import { CompositeKey, Metadata, RunView, LogError, LogStatus, } from '@memberjunction/core';
+import { LabelManager } from './LabelManager.js';
+import { SnapshotBuilder } from './SnapshotBuilder.js';
+import { ENTITY_VERSION_LABEL_ITEMS, ENTITY_VERSION_LABEL_RESTORES, ENTITY_VERSION_LABELS, sqlEquals, sqlNotIn, loadRecordChangeSnapshot, loadEntityById, buildPrimaryKeyForLoad, } from './constants.js';
+/** Batch size for progress update writes — only persist every N items. */
+const PROGRESS_UPDATE_INTERVAL = 10;
+/**
+ * Restores records to the state captured by a version label.
+ *
+ * Key behaviors:
+ * - Automatically creates a "Pre-Restore" safety label before making changes
+ * - Restores in topological order (parents before children) based on entity
+ *   relationships to maintain referential integrity
+ * - Tracks progress and errors in a VersionLabelRestore audit record
+ * - Supports dry-run mode for previewing changes without applying them
+ */
+export class RestoreEngine {
+    constructor() {
+        this.LabelMgr = new LabelManager();
+        this.SnapshotBldr = new SnapshotBuilder();
+    }
+    /**
+     * Restore records to the state captured by a version label.
+     */
+    async RestoreToLabel(labelId, options, contextUser) {
+        const resolvedOptions = this.resolveDefaults(options);
+        // Load the target label
+        const label = await loadEntityById(ENTITY_VERSION_LABELS, labelId, contextUser);
+        if (!label)
+            throw new Error(`Version label '${labelId}' not found`);
+        const labelName = label.Name;
+        const labelScope = label.Scope;
+        LogStatus(`VersionHistory: Starting restore to label '${labelName}' (${labelId})`);
+        // Load all label items to restore
+        const items = await this.loadLabelItems(labelId, resolvedOptions, contextUser);
+        if (items.length === 0) {
+            LogStatus('VersionHistory: No items to restore');
+            return this.emptyResult(resolvedOptions.DryRun);
+        }
+        // Create pre-restore safety label
+        let preRestoreLabelId = null;
+        if (resolvedOptions.CreatePreRestoreLabel && !resolvedOptions.DryRun) {
+            preRestoreLabelId = await this.createPreRestoreLabel(labelName, labelScope, items, contextUser);
+        }
+        // Create the restore audit record
+        let restoreAuditId = null;
+        if (!resolvedOptions.DryRun) {
+            restoreAuditId = await this.createRestoreAuditRecord(labelId, items.length, preRestoreLabelId, contextUser);
+        }
+        // Sort items by entity dependency order and process them
+        const sortedItems = this.sortByDependencyOrder(items);
+        const { details, restoredCount, failedCount, skippedCount } = await this.processRestoreItems(sortedItems, resolvedOptions.DryRun, restoreAuditId, contextUser);
+        // Finalize the audit record
+        const finalStatus = this.determineFinalStatus(restoredCount, failedCount, items.length);
+        if (restoreAuditId && !resolvedOptions.DryRun) {
+            await this.finalizeRestoreAudit(restoreAuditId, finalStatus, failedCount, details, contextUser);
+        }
+        // Mark the label as restored
+        if (!resolvedOptions.DryRun && finalStatus !== 'Error') {
+            await this.LabelMgr.MarkLabelRestored(labelId, contextUser);
+        }
+        LogStatus(`VersionHistory: Restore complete. ${restoredCount} restored, ${failedCount} failed, ${skippedCount} skipped.`);
+        return {
+            RestoreID: restoreAuditId ?? 'dry-run',
+            PreRestoreLabelID: preRestoreLabelId,
+            Status: finalStatus,
+            RestoredCount: restoredCount,
+            FailedCount: failedCount,
+            SkippedCount: skippedCount,
+            Details: details,
+        };
+    }
+    // -----------------------------------------------------------------------
+    // Private helpers
+    // -----------------------------------------------------------------------
+    /**
+     * Process all restore items in order, tracking progress and updating the
+     * audit record in batches.
+     */
+    async processRestoreItems(sortedItems, dryRun, restoreAuditId, contextUser) {
+        const details = [];
+        let restoredCount = 0;
+        let failedCount = 0;
+        let skippedCount = 0;
+        for (let i = 0; i < sortedItems.length; i++) {
+            const result = await this.restoreSingleItem(sortedItems[i], dryRun, contextUser);
+            details.push(result);
+            switch (result.Status) {
+                case 'Restored':
+                    restoredCount++;
+                    break;
+                case 'Failed':
+                    failedCount++;
+                    break;
+                case 'Skipped':
+                    skippedCount++;
+                    break;
+            }
+            // Batch progress updates — only write every N items or on the last item
+            const isLastItem = i === sortedItems.length - 1;
+            const isBatchBoundary = (i + 1) % PROGRESS_UPDATE_INTERVAL === 0;
+            if (restoreAuditId && !dryRun && (isBatchBoundary || isLastItem)) {
+                await this.updateRestoreProgress(restoreAuditId, restoredCount, failedCount, contextUser);
+            }
+        }
+        return { details, restoredCount, failedCount, skippedCount };
+    }
+    /**
+     * Load all VersionLabelItems for a label, optionally filtered.
+     */
+    async loadLabelItems(labelId, options, contextUser) {
+        const rv = new RunView();
+        let extraFilter = sqlEquals('VersionLabelID', labelId);
+        // Apply entity exclusion
+        if (options.SkipEntities && options.SkipEntities.length > 0) {
+            const md = new Metadata();
+            const excludeIds = options.SkipEntities
+                .map(name => md.EntityByName(name)?.ID)
+                .filter((id) => id != null);
+            if (excludeIds.length > 0) {
+                extraFilter += ` AND ${sqlNotIn('EntityID', excludeIds)}`;
+            }
+        }
+        const result = await rv.RunView({
+            EntityName: ENTITY_VERSION_LABEL_ITEMS,
+            ExtraFilter: extraFilter,
+            ResultType: 'simple',
+        }, contextUser);
+        if (!result.Success) {
+            LogError(`RestoreEngine: Failed to load label items: ${result.ErrorMessage}`);
+            return [];
+        }
+        let items = result.Results;
+        // Apply selected records filter
+        if (options.Scope === 'Selected' && options.SelectedRecords && options.SelectedRecords.length > 0) {
+            items = this.filterBySelectedRecords(items, options.SelectedRecords);
+        }
+        return items;
+    }
+    /**
+     * Filter label items to only include those matching a set of selected records.
+     */
+    filterBySelectedRecords(items, selectedRecords) {
+        const selectedSet = new Set(selectedRecords.map(s => `${s.EntityName}::${s.RecordID}`));
+        const md = new Metadata();
+        return items.filter(item => {
+            const entityInfo = md.Entities.find(e => e.ID === item.EntityID);
+            const entityName = entityInfo?.Name ?? '';
+            return selectedSet.has(`${entityName}::${item.RecordID}`);
+        });
+    }
+    /**
+     * Sort label items by entity dependency order so parents are restored
+     * before their children.
+     */
+    sortByDependencyOrder(items) {
+        const md = new Metadata();
+        // Build a map of entityId -> dependency level
+        const levelMap = new Map();
+        const visited = new Set();
+        const computeLevel = (entityId) => {
+            if (levelMap.has(entityId))
+                return levelMap.get(entityId);
+            if (visited.has(entityId))
+                return 0; // Cycle — break it
+            visited.add(entityId);
+            const entityInfo = md.Entities.find(e => e.ID === entityId);
+            if (!entityInfo) {
+                levelMap.set(entityId, 0);
+                return 0;
+            }
+            // Find all FK fields pointing to other entities
+            let maxParentLevel = -1;
+            for (const field of entityInfo.Fields) {
+                if (field.RelatedEntityID && field.RelatedEntityID !== entityId) {
+                    const parentLevel = computeLevel(field.RelatedEntityID);
+                    maxParentLevel = Math.max(maxParentLevel, parentLevel);
+                }
+            }
+            const level = maxParentLevel + 1;
+            levelMap.set(entityId, level);
+            return level;
+        };
+        // Compute levels for all entities in the item set
+        const entityIds = new Set(items.map(i => i.EntityID));
+        for (const entityId of entityIds) {
+            computeLevel(entityId);
+        }
+        // Sort: lower level (parents) first
+        return [...items].sort((a, b) => {
+            const levelA = levelMap.get(a.EntityID) ?? 0;
+            const levelB = levelMap.get(b.EntityID) ?? 0;
+            return levelA - levelB;
+        });
+    }
+    /**
+     * Restore a single record to its labeled state.
+     */
+    async restoreSingleItem(item, dryRun, contextUser) {
+        const entityInfo = this.resolveEntityInfo(item.EntityID);
+        if (!entityInfo) {
+            return this.failedItemResult(`Unknown(${item.EntityID})`, item.RecordID, `Entity with ID '${item.EntityID}' not found in metadata`);
+        }
+        try {
+            const snapshotData = await loadRecordChangeSnapshot(item.RecordChangeID, contextUser);
+            if (!snapshotData) {
+                return this.failedItemResult(entityInfo.Name, item.RecordID, 'Could not load snapshot from RecordChange');
+            }
+            if (dryRun) {
+                return { EntityName: entityInfo.Name, RecordID: item.RecordID, Status: 'Restored' };
+            }
+            return await this.applyRestore(entityInfo, item.RecordID, snapshotData, contextUser);
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            LogError(`RestoreEngine: Error restoring ${entityInfo.Name}/${item.RecordID}: ${msg}`);
+            return this.failedItemResult(entityInfo.Name, item.RecordID, msg);
+        }
+    }
+    /**
+     * Resolve entity metadata by ID.
+     */
+    resolveEntityInfo(entityId) {
+        const md = new Metadata();
+        return md.Entities.find(e => e.ID === entityId) ?? null;
+    }
+    /**
+     * Apply the snapshot data to an existing or new entity and save it.
+     */
+    async applyRestore(entityInfo, recordId, snapshotData, contextUser) {
+        const entity = await this.loadOrCreateEntity(entityInfo, recordId, contextUser);
+        if (!entity) {
+            return this.failedItemResult(entityInfo.Name, recordId, 'Could not load entity for restore');
+        }
+        const changed = this.applySnapshotToEntity(entity, snapshotData, entityInfo);
+        if (!changed) {
+            return { EntityName: entityInfo.Name, RecordID: recordId, Status: 'Skipped' };
+        }
+        const saved = await entity.Save();
+        if (!saved) {
+            return this.failedItemResult(entityInfo.Name, recordId, 'Save failed');
+        }
+        return { EntityName: entityInfo.Name, RecordID: recordId, Status: 'Restored' };
+    }
+    /**
+     * Build a failed RestoreItemResult.
+     */
+    failedItemResult(entityName, recordId, errorMessage) {
+        return { EntityName: entityName, RecordID: recordId, Status: 'Failed', ErrorMessage: errorMessage };
+    }
+    /**
+     * Load an existing entity record, or create a new one if it doesn't exist.
+     */
+    async loadOrCreateEntity(entityInfo, recordId, contextUser) {
+        const md = new Metadata();
+        const entity = await md.GetEntityObject(entityInfo.Name, contextUser);
+        // Try to load existing record using the entity's actual primary key
+        try {
+            const key = buildPrimaryKeyForLoad(entityInfo, recordId);
+            const loaded = await entity.InnerLoad(key);
+            if (loaded)
+                return entity;
+        }
+        catch {
+            // Record doesn't exist — fall through to create
+        }
+        // Record doesn't exist; return fresh entity for insert
+        return await md.GetEntityObject(entityInfo.Name, contextUser);
+    }
+    /**
+     * Apply snapshot data to an entity, setting each field from the snapshot.
+     * Returns true if any field was changed.
+     */
+    applySnapshotToEntity(entity, snapshotData, entityInfo) {
+        let anyChanged = false;
+        for (const field of entityInfo.Fields) {
+            // Skip read-only, primary key, and system fields
+            if (field.ReadOnly)
+                continue;
+            if (field.IsPrimaryKey)
+                continue;
+            if (field.Name.startsWith('__mj_'))
+                continue;
+            const snapshotValue = snapshotData[field.Name];
+            if (snapshotValue === undefined)
+                continue;
+            const currentValue = entity.Get(field.Name);
+            if (!this.valuesDiffer(currentValue, snapshotValue))
+                continue;
+            entity.Set(field.Name, snapshotValue);
+            anyChanged = true;
+        }
+        return anyChanged;
+    }
+    /**
+     * Check if two values are meaningfully different.
+     */
+    valuesDiffer(a, b) {
+        if (a === b)
+            return false;
+        if (a == null && b == null)
+            return false;
+        return String(a) !== String(b);
+    }
+    /**
+     * Create a "Pre-Restore" safety label capturing current state of all
+     * records that will be affected by the restore.
+     */
+    async createPreRestoreLabel(targetLabelName, targetLabelScope, items, contextUser) {
+        const label = await this.LabelMgr.CreateLabel({
+            Name: `Pre-Restore: ${targetLabelName} (${new Date().toISOString()})`,
+            Description: `Automatic safety snapshot created before restoring to label '${targetLabelName}'`,
+            Scope: targetLabelScope,
+        }, contextUser);
+        const preRestoreLabelId = label.ID;
+        const md = new Metadata();
+        // Capture current state of each record that will be restored
+        for (const item of items) {
+            const entityInfo = md.Entities.find(e => e.ID === item.EntityID);
+            if (!entityInfo)
+                continue;
+            const key = new CompositeKey([{
+                    FieldName: entityInfo.FirstPrimaryKey.Name,
+                    Value: item.RecordID,
+                }]);
+            await this.SnapshotBldr.CaptureRecord(preRestoreLabelId, entityInfo.Name, key, false, // Don't walk dependencies — we already have the full item list
+            {}, contextUser);
+        }
+        LogStatus(`VersionHistory: Created pre-restore safety label (${preRestoreLabelId})`);
+        return preRestoreLabelId;
+    }
+    /**
+     * Create a VersionLabelRestore audit record.
+     */
+    async createRestoreAuditRecord(labelId, totalItems, preRestoreLabelId, contextUser) {
+        const md = new Metadata();
+        const restore = await md.GetEntityObject(ENTITY_VERSION_LABEL_RESTORES, contextUser);
+        restore.VersionLabelID = labelId;
+        restore.Status = 'In Progress';
+        restore.UserID = contextUser.ID;
+        restore.TotalItems = totalItems;
+        restore.CompletedItems = 0;
+        restore.FailedItems = 0;
+        if (preRestoreLabelId) {
+            restore.PreRestoreLabelID = preRestoreLabelId;
+        }
+        const saved = await restore.Save();
+        if (!saved) {
+            throw new Error('Failed to create restore audit record');
+        }
+        return restore.ID;
+    }
+    /**
+     * Update restore progress counters.
+     */
+    async updateRestoreProgress(restoreId, completedItems, failedItems, contextUser) {
+        try {
+            const restore = await loadEntityById(ENTITY_VERSION_LABEL_RESTORES, restoreId, contextUser);
+            if (!restore)
+                return;
+            restore.CompletedItems = completedItems;
+            restore.FailedItems = failedItems;
+            await restore.Save();
+        }
+        catch (e) {
+            // Non-critical — progress update failure shouldn't stop the restore
+            const msg = e instanceof Error ? e.message : String(e);
+            LogError(`RestoreEngine: Failed to update restore progress for ${restoreId}: ${msg}`);
+        }
+    }
+    /**
+     * Finalize the restore audit record.
+     */
+    async finalizeRestoreAudit(restoreId, status, failedCount, details, contextUser) {
+        try {
+            const restore = await loadEntityById(ENTITY_VERSION_LABEL_RESTORES, restoreId, contextUser);
+            if (!restore)
+                return;
+            restore.Status = status;
+            restore.EndedAt = new Date();
+            if (failedCount > 0) {
+                const errorItems = details
+                    .filter(d => d.Status === 'Failed')
+                    .map(d => `${d.EntityName}/${d.RecordID}: ${d.ErrorMessage ?? 'Unknown'}`)
+                    .join('\n');
+                restore.ErrorLog = errorItems;
+            }
+            await restore.Save();
+        }
+        catch (e) {
+            const msg = e instanceof Error ? e.message : String(e);
+            LogError(`RestoreEngine: Error finalizing audit record: ${msg}`);
+        }
+    }
+    /**
+     * Determine the overall status based on counts.
+     */
+    determineFinalStatus(restored, failed, _total) {
+        if (failed === 0)
+            return 'Complete';
+        if (restored === 0)
+            return 'Error';
+        return 'Partial';
+    }
+    /**
+     * Apply defaults to restore options.
+     */
+    resolveDefaults(options) {
+        return {
+            DryRun: options.DryRun ?? false,
+            Scope: options.Scope ?? 'Full',
+            SelectedRecords: options.SelectedRecords ?? [],
+            SkipEntities: options.SkipEntities ?? [],
+            CreatePreRestoreLabel: options.CreatePreRestoreLabel ?? true,
+        };
+    }
+    /**
+     * Create an empty result (used when there's nothing to restore).
+     */
+    emptyResult(dryRun) {
+        return {
+            RestoreID: dryRun ? 'dry-run' : '',
+            PreRestoreLabelID: null,
+            Status: 'Complete',
+            RestoredCount: 0,
+            FailedCount: 0,
+            SkippedCount: 0,
+            Details: [],
+        };
+    }
+}
+//# sourceMappingURL=RestoreEngine.js.map

package/dist/RestoreEngine.js.map

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

package/dist/SnapshotBuilder.d.ts

@@ -0,0 +1,108 @@
+import { CompositeKey, UserInfo } from '@memberjunction/core';
+import { CaptureResult, CreateLabelProgressCallback, WalkOptions } from './types.js';
+/**
+ * Captures the current state of records into VersionLabelItem entries,
+ * linking each record to its most recent RecordChange snapshot.
+ *
+ * ## Batched approach
+ *
+ * When capturing a dependency graph, the builder:
+ * 1. Groups all nodes by EntityID
+ * 2. For each entity group, runs ONE batched query to find the latest
+ *    RecordChange for all records in the group
+ * 3. Creates synthetic snapshots for records with no change history
+ * 4. Creates VersionLabelItem entries for all records
+ *
+ * This reduces hundreds/thousands of individual RunView calls down to
+ * a handful of batched queries (one per unique entity type).
+ */
+export declare class SnapshotBuilder {
+    private Walker;
+    /**
+     * Capture a snapshot of a single record and optionally its full dependency graph.
+     */
+    CaptureRecord(labelId: string, entityName: string, recordKey: CompositeKey, includeDependencies: boolean, walkOptions: WalkOptions, contextUser: UserInfo, onProgress?: CreateLabelProgressCallback): Promise<CaptureResult>;
+    /**
+     * Capture all records of a given entity type.
+     */
+    CaptureEntity(labelId: string, entityName: string, contextUser: UserInfo): Promise<CaptureResult>;
+    /**
+     * Capture all tracked entities (System scope).
+     */
+    CaptureSystem(labelId: string, contextUser: UserInfo): Promise<CaptureResult>;
+    /**
+     * Walk the dependency graph and capture all nodes using batched queries.
+     *
+     * Steps:
+     * 1. Walk the dependency graph to get all nodes
+     * 2. Batch-lookup the latest RecordChange for all nodes (grouped by entity)
+     * 3. Create synthetic snapshots for nodes without a RecordChange
+     * 4. Create VersionLabelItem entries for all nodes
+     */
+    private captureWithDependencies;
+    /** Safely invoke the progress callback if provided. */
+    private emitProgress;
+    /**
+     * Batch-lookup the latest RecordChange for a list of dependency nodes.
+     *
+     * Groups nodes by EntityID, then runs ONE query per entity group with an
+     * IN clause for all RecordIDs. Returns a map keyed by "entityId::recordId"
+     * with the latest RecordChange ID and timestamp.
+     *
+     * This replaces N individual RunView calls with ~K calls (K = unique entity types).
+     */
+    private batchLookupLatestChanges;
+    /**
+     * Group dependency nodes by EntityID, collecting unique RecordIDs per entity.
+     * Returns a Map of entityId → Set of recordIds.
+     */
+    private groupNodesByEntity;
+    /**
+     * Query Record Changes for a single entity group.
+     * Uses an IN clause to find the latest change for each record in one query.
+     *
+     * Returns a Map of "entityId::recordId" → RecordChangeLookup.
+     */
+    private lookupChangesForEntityGroup;
+    /**
+     * Query Record Changes for a chunk of RecordIDs within a single entity.
+     * Loads all matching changes ordered by RecordID and ChangedAt DESC,
+     * then picks the latest change per record.
+     */
+    private lookupChangesChunk;
+    /**
+     * Capture a single dependency node using the pre-built change lookup.
+     * If no existing RecordChange is found, creates a synthetic snapshot.
+     */
+    private captureNodeWithLookup;
+    /**
+     * Capture a single record without batching. Used by CaptureEntity and
+     * the non-dependency CaptureRecord path.
+     */
+    private captureSingleRecord;
+    /**
+     * Wrapper for captureSingleRecord that returns a CaptureResult.
+     */
+    private captureSingleRecordAsResult;
+    /**
+     * Find the most recent RecordChange for a single entity + record.
+     * Used by the non-batched capture path.
+     */
+    private findLatestRecordChange;
+    /**
+     * Create a synthetic RecordChange entry of Type='Snapshot' for a record
+     * that has no prior change history.
+     */
+    private createSyntheticSnapshot;
+    /**
+     * Create a VersionLabelItem linking a record to its RecordChange.
+     */
+    private createLabelItem;
+    /**
+     * Load the current state of a single record.
+     */
+    private loadCurrentRecord;
+    /** Create a failure CaptureResult. */
+    private failResult;
+}
+//# sourceMappingURL=SnapshotBuilder.d.ts.map

package/dist/SnapshotBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SnapshotBuilder.d.ts","sourceRoot":"","sources":["../src/SnapshotBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,YAAY,EAIZ,QAAQ,EAGX,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAgB,aAAa,EAAE,2BAA2B,EAAkB,WAAW,EAAE,MAAM,SAAS,CAAC;AA+BhH;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,eAAe;IACxB,OAAO,CAAC,MAAM,CAA+B;IAM7C;;OAEG;IACU,aAAa,CACtB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,YAAY,EACvB,mBAAmB,EAAE,OAAO,EAC5B,WAAW,EAAE,WAAW,EACxB,WAAW,EAAE,QAAQ,EACrB,UAAU,CAAC,EAAE,2BAA2B,GACzC,OAAO,CAAC,aAAa,CAAC;IAOzB;;OAEG;IACU,aAAa,CACtB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,QAAQ,GACtB,OAAO,CAAC,aAAa,CAAC;IAgDzB;;OAEG;IACU,aAAa,CACtB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,QAAQ,GACtB,OAAO,CAAC,aAAa,CAAC;IA6BzB;;;;;;;;OAQG;YACW,uBAAuB;IAwFrC,uDAAuD;IACvD,OAAO,CAAC,YAAY;IAiBpB;;;;;;;;OAQG;YACW,wBAAwB;IAwBtC;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAY1B;;;;;OAKG;YACW,2BAA2B;IAuBzC;;;;OAIG;YACW,kBAAkB;IAkDhC;;;OAGG;YACW,qBAAqB;IAuCnC;;;OAGG;YACW,mBAAmB;IA6CjC;;OAEG;YACW,2BAA2B;IA6BzC;;;OAGG;YACW,sBAAsB;IAsBpC;;;OAGG;YACW,uBAAuB;IAiCrC;;OAEG;YACW,eAAe;IAsB7B;;OAEG;YACW,iBAAiB;IAkB/B,sCAAsC;IACtC,OAAO,CAAC,UAAU;CASrB"}