@n-dx/core 0.1.0

package/packages/rex/dist/core/sync-engine.js

@@ -0,0 +1,429 @@
+/**
+ * Bidirectional sync engine for PRDStore instances.
+ *
+ * Coordinates between a local store and a remote store using the primitives
+ * from `sync.ts` (conflict detection, resolution, timestamping). Supports
+ * three sync modes:
+ *
+ * - **push**: local → remote (send local changes out)
+ * - **pull**: remote → local (fetch remote changes in)
+ * - **sync**: bidirectional (push + pull with unified conflict resolution)
+ *
+ * The engine operates on flat item maps built from each store's document tree,
+ * then writes the merged result back to both stores.
+ */
+import { walkTree } from "./tree.js";
+import { detectChangedFields, isModifiedSinceSync, resolveConflicts, stampSynced, extractSyncMeta, conflictToLogEntry, } from "./sync.js";
+// ---------------------------------------------------------------------------
+// SyncEngine
+// ---------------------------------------------------------------------------
+export class SyncEngine {
+    local;
+    remote;
+    constructor(local, remote) {
+        this.local = local;
+        this.remote = remote;
+    }
+    /**
+     * Push local changes to the remote store.
+     * Items modified locally since last sync are written to remote.
+     * If the remote also changed the same item, conflict resolution applies.
+     */
+    async push() {
+        const now = new Date().toISOString();
+        const report = emptyReport("push", now);
+        const localDoc = await this.local.loadDocument();
+        const remoteDoc = await this.remote.loadDocument();
+        const localMap = buildItemMap(localDoc.items);
+        const remoteMap = buildItemMap(remoteDoc.items);
+        // Track items that were conflict-merged so local gets the merged values too
+        const conflictMergedIds = new Set();
+        // Process all local items
+        for (const [id, localItem] of localMap) {
+            const remoteItem = remoteMap.get(id);
+            if (!remoteItem) {
+                // New local item — push to remote
+                report.pushed.push(id);
+                continue;
+            }
+            const changedFields = detectChangedFields(localItem, remoteItem);
+            if (changedFields.length === 0) {
+                report.skipped.push(id);
+                continue;
+            }
+            const localModified = isModifiedSinceSync(localItem);
+            if (!localModified) {
+                report.skipped.push(id);
+                continue;
+            }
+            const remoteMeta = extractSyncMeta(remoteItem);
+            const localMeta = extractSyncMeta(localItem);
+            const remoteModified = remoteMeta.lastModified
+                ? !localMeta.lastSyncedAt || remoteMeta.lastModified > localMeta.lastSyncedAt
+                : false;
+            if (remoteModified) {
+                // Both modified — resolve conflict
+                const { merged, conflicts } = resolveConflicts(localItem, remoteItem, remoteMeta.lastModified);
+                report.conflicts.push(...conflicts);
+                localMap.set(id, merged);
+                conflictMergedIds.add(id);
+                report.pushed.push(id);
+            }
+            else {
+                // Only local changed
+                report.pushed.push(id);
+            }
+        }
+        // Build and save the merged remote document
+        const mergedRemoteItems = mergeItemsIntoTree(remoteDoc, localMap, new Set(report.pushed), localDoc);
+        remoteDoc.items = stampAllSynced(mergedRemoteItems, now);
+        // Write merged conflict values back into local so both stores converge
+        if (conflictMergedIds.size > 0) {
+            localDoc.items = mergeItemsIntoTree(localDoc, localMap, conflictMergedIds, localDoc);
+        }
+        localDoc.items = stampAllSynced(localDoc.items, now);
+        try {
+            await this.remote.saveDocument(remoteDoc);
+            await this.local.saveDocument(localDoc);
+        }
+        catch (err) {
+            report.errors.push({
+                itemId: "*",
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+        return report;
+    }
+    /**
+     * Pull remote changes to the local store.
+     * Items modified remotely since last sync are written to local.
+     * If the local also changed the same item, conflict resolution applies.
+     */
+    async pull() {
+        const now = new Date().toISOString();
+        const report = emptyReport("pull", now);
+        const localDoc = await this.local.loadDocument();
+        const remoteDoc = await this.remote.loadDocument();
+        const localMap = buildItemMap(localDoc.items);
+        const remoteMap = buildItemMap(remoteDoc.items);
+        // Track items that were conflict-merged so remote gets the merged values too
+        const conflictMergedIds = new Set();
+        // Process all remote items
+        for (const [id, remoteItem] of remoteMap) {
+            const localItem = localMap.get(id);
+            if (!localItem) {
+                // New remote item — pull to local
+                report.pulled.push(id);
+                continue;
+            }
+            const changedFields = detectChangedFields(localItem, remoteItem);
+            if (changedFields.length === 0) {
+                report.skipped.push(id);
+                continue;
+            }
+            const remoteMeta = extractSyncMeta(remoteItem);
+            const remoteModified = remoteMeta.lastModified
+                ? !remoteMeta.lastSyncedAt || remoteMeta.lastModified > remoteMeta.lastSyncedAt
+                : false;
+            if (!remoteModified) {
+                report.skipped.push(id);
+                continue;
+            }
+            const localModified = isModifiedSinceSync(localItem);
+            if (localModified) {
+                // Both modified — resolve conflict
+                const { merged, conflicts } = resolveConflicts(localItem, remoteItem, remoteMeta.lastModified);
+                report.conflicts.push(...conflicts);
+                remoteMap.set(id, merged);
+                conflictMergedIds.add(id);
+                report.pulled.push(id);
+            }
+            else {
+                // Only remote changed
+                report.pulled.push(id);
+            }
+        }
+        // Build and save the merged local document
+        const mergedLocalItems = mergeItemsIntoTree(localDoc, remoteMap, new Set(report.pulled), remoteDoc);
+        localDoc.items = stampAllSynced(mergedLocalItems, now);
+        // Write merged conflict values back into remote so both stores converge
+        if (conflictMergedIds.size > 0) {
+            remoteDoc.items = mergeItemsIntoTree(remoteDoc, remoteMap, conflictMergedIds, remoteDoc);
+        }
+        remoteDoc.items = stampAllSynced(remoteDoc.items, now);
+        try {
+            await this.local.saveDocument(localDoc);
+            await this.remote.saveDocument(remoteDoc);
+        }
+        catch (err) {
+            report.errors.push({
+                itemId: "*",
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+        return report;
+    }
+    /**
+     * Full bidirectional sync: push local changes, pull remote changes,
+     * resolve any conflicts with last-write-wins.
+     */
+    async sync(options) {
+        const now = new Date().toISOString();
+        const report = emptyReport("sync", now);
+        const deletions = options?.deletions ?? new Set();
+        const localDoc = await this.local.loadDocument();
+        const remoteDoc = await this.remote.loadDocument();
+        const localMap = buildItemMap(localDoc.items);
+        const remoteMap = buildItemMap(remoteDoc.items);
+        const allIds = new Set([...localMap.keys(), ...remoteMap.keys()]);
+        const mergedMap = new Map();
+        for (const id of allIds) {
+            const localItem = localMap.get(id);
+            const remoteItem = remoteMap.get(id);
+            // Handle deletions
+            if (deletions.has(id)) {
+                report.deleted.push(id);
+                // Don't include in merged — item is deleted
+                continue;
+            }
+            if (localItem && !remoteItem) {
+                // Local only — push
+                report.pushed.push(id);
+                mergedMap.set(id, localItem);
+                continue;
+            }
+            if (!localItem && remoteItem) {
+                // Remote only — pull
+                report.pulled.push(id);
+                mergedMap.set(id, remoteItem);
+                continue;
+            }
+            if (localItem && remoteItem) {
+                const changedFields = detectChangedFields(localItem, remoteItem);
+                if (changedFields.length === 0) {
+                    report.skipped.push(id);
+                    mergedMap.set(id, localItem);
+                    continue;
+                }
+                const localModified = isModifiedSinceSync(localItem);
+                const remoteMeta = extractSyncMeta(remoteItem);
+                const localMeta = extractSyncMeta(localItem);
+                const remoteModified = remoteMeta.lastModified
+                    ? !localMeta.lastSyncedAt || remoteMeta.lastModified > localMeta.lastSyncedAt
+                    : false;
+                if (localModified && remoteModified) {
+                    // True conflict — both sides changed
+                    const { merged, conflicts } = resolveConflicts(localItem, remoteItem, remoteMeta.lastModified);
+                    report.conflicts.push(...conflicts);
+                    mergedMap.set(id, merged);
+                    // Determine whether it was effectively a push or pull
+                    const winner = conflicts.length > 0 && conflicts[0].resolution === "remote"
+                        ? "pulled" : "pushed";
+                    report[winner === "pulled" ? "pulled" : "pushed"].push(id);
+                }
+                else if (localModified) {
+                    // Only local changed — push
+                    report.pushed.push(id);
+                    mergedMap.set(id, localItem);
+                }
+                else if (remoteModified) {
+                    // Only remote changed — pull
+                    report.pulled.push(id);
+                    mergedMap.set(id, remoteItem);
+                }
+                else {
+                    // Neither modified since last sync, but fields differ
+                    // (e.g. both changed before any sync tracking). Treat as skip.
+                    report.skipped.push(id);
+                    mergedMap.set(id, localItem);
+                }
+            }
+        }
+        // Rebuild both trees from the merged flat map, preserving hierarchy
+        const mergedLocalItems = rebuildTree(localDoc, remoteDoc, mergedMap);
+        const stampedItems = stampAllSynced(mergedLocalItems, now);
+        localDoc.items = stampedItems;
+        remoteDoc.items = structuredClone(stampedItems);
+        await this.local.saveDocument(localDoc);
+        await this.remote.saveDocument(remoteDoc);
+        // Log any conflicts
+        for (const conflict of report.conflicts) {
+            await this.local.appendLog(conflictToLogEntry(conflict));
+        }
+        return report;
+    }
+}
+// ---------------------------------------------------------------------------
+// Internal helpers
+// ---------------------------------------------------------------------------
+function emptyReport(direction, timestamp) {
+    return {
+        direction,
+        pushed: [],
+        pulled: [],
+        skipped: [],
+        conflicts: [],
+        deleted: [],
+        errors: [],
+        timestamp,
+    };
+}
+/**
+ * Flatten a PRD item tree into a map keyed by item ID.
+ * Preserves all fields including children references.
+ */
+function buildItemMap(items) {
+    const map = new Map();
+    for (const { item } of walkTree(items)) {
+        map.set(item.id, item);
+    }
+    return map;
+}
+/**
+ * Stamp all items in a tree with lastSyncedAt.
+ * Returns a new array (does not mutate).
+ */
+function stampAllSynced(items, timestamp) {
+    return items.map((item) => {
+        const stamped = stampSynced(item, undefined, timestamp);
+        if (item.children && item.children.length > 0) {
+            stamped.children = stampAllSynced(item.children, timestamp);
+        }
+        return stamped;
+    });
+}
+/**
+ * Merge source items into a target document tree.
+ * For items in `idsToMerge`, copies the value from sourceMap.
+ * For existing items not in idsToMerge, keeps the target version.
+ * For items only in sourceMap and in idsToMerge, appends at root
+ * preserving their subtree from sourceDoc.
+ */
+function mergeItemsIntoTree(targetDoc, sourceMap, idsToMerge, sourceDoc) {
+    const targetMap = buildItemMap(targetDoc.items);
+    const placedIds = new Set();
+    // Update existing items in-tree, tracking which IDs get placed
+    const result = updateItemsInTree(targetDoc.items, sourceMap, idsToMerge, placedIds);
+    // Add root-level items from the source tree that aren't already in the target.
+    // We walk the source tree to preserve hierarchy (children stay nested).
+    addNewItemsFromSource(sourceDoc.items, targetMap, idsToMerge, placedIds, result);
+    return result;
+}
+/**
+ * Walk the source tree and add items that exist in idsToMerge
+ * but not in the target. Preserves hierarchy by recursing into children.
+ */
+function addNewItemsFromSource(sourceItems, targetMap, idsToMerge, placedIds, result) {
+    for (const item of sourceItems) {
+        if (idsToMerge.has(item.id) && !targetMap.has(item.id) && !placedIds.has(item.id)) {
+            // Add this item and its subtree
+            const clone = structuredClone(item);
+            result.push(clone);
+            markPlaced(clone, placedIds);
+        }
+        else if (item.children) {
+            // Item itself is already placed, but check children
+            addNewItemsFromSource(item.children, targetMap, idsToMerge, placedIds, result);
+        }
+    }
+}
+/** Mark an item and all descendants as placed. */
+function markPlaced(item, placedIds) {
+    placedIds.add(item.id);
+    if (item.children) {
+        for (const child of item.children) {
+            markPlaced(child, placedIds);
+        }
+    }
+}
+/**
+ * Walk a tree and replace items whose IDs are in the merge set.
+ * Tracks placed IDs so callers know which items were already in the tree.
+ */
+function updateItemsInTree(items, sourceMap, idsToMerge, placedIds) {
+    return items.map((item) => {
+        let result;
+        if (idsToMerge.has(item.id) && sourceMap.has(item.id)) {
+            result = structuredClone(sourceMap.get(item.id));
+        }
+        else {
+            result = { ...item };
+        }
+        placedIds.add(item.id);
+        if (item.children && item.children.length > 0) {
+            result.children = updateItemsInTree(item.children, sourceMap, idsToMerge, placedIds);
+        }
+        return result;
+    });
+}
+/**
+ * Rebuild a tree from a merged flat map, using both source trees
+ * as structural references. Items are placed in hierarchy based on
+ * the first tree that contains them; new items go to the root.
+ */
+function rebuildTree(localDoc, remoteDoc, mergedMap) {
+    // Use local tree structure as the primary skeleton
+    const placedIds = new Set();
+    const result = rebuildBranch(localDoc.items, mergedMap, placedIds);
+    // Add items from remote that weren't placed from local tree
+    addUnplacedItems(remoteDoc.items, mergedMap, placedIds, result);
+    // Add any remaining items from mergedMap not placed by either tree
+    for (const [id, item] of mergedMap) {
+        if (!placedIds.has(id)) {
+            const clone = structuredClone(item);
+            delete clone.children;
+            result.push(clone);
+            placedIds.add(id);
+        }
+    }
+    return result;
+}
+function rebuildBranch(templateItems, mergedMap, placedIds) {
+    const result = [];
+    for (const item of templateItems) {
+        const merged = mergedMap.get(item.id);
+        if (!merged)
+            continue; // Item was deleted
+        const rebuilt = { ...structuredClone(merged) };
+        delete rebuilt.children;
+        placedIds.add(item.id);
+        if (item.children && item.children.length > 0) {
+            const children = rebuildBranch(item.children, mergedMap, placedIds);
+            if (children.length > 0) {
+                rebuilt.children = children;
+            }
+        }
+        result.push(rebuilt);
+    }
+    return result;
+}
+function addUnplacedItems(templateItems, mergedMap, placedIds, result) {
+    for (const item of templateItems) {
+        if (!placedIds.has(item.id) && mergedMap.has(item.id)) {
+            const merged = mergedMap.get(item.id);
+            const rebuilt = { ...structuredClone(merged) };
+            delete rebuilt.children;
+            placedIds.add(item.id);
+            if (item.children && item.children.length > 0) {
+                const children = [];
+                addUnplacedItems(item.children, mergedMap, placedIds, children);
+                if (children.length > 0) {
+                    rebuilt.children = children;
+                }
+            }
+            result.push(rebuilt);
+        }
+        // Recurse into children even if this item was already placed
+        // (to find unplaced grandchildren)
+        if (item.children) {
+            addUnplacedItems(item.children, mergedMap, placedIds, result);
+        }
+    }
+}
+/**
+ * Deep clone with structural sharing avoidance.
+ */
+function structuredClone(obj) {
+    return JSON.parse(JSON.stringify(obj));
+}
+//# sourceMappingURL=sync-engine.js.map

package/packages/rex/dist/core/sync-engine.js.map

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

package/packages/rex/dist/core/sync.d.ts

@@ -0,0 +1,82 @@
+import type { PRDItem, LogEntry } from "../schema/index.js";
+/**
+ * Sync metadata attached to PRDItems via the `[key: string]: unknown` index.
+ * Items that haven't been synced yet will lack these fields.
+ */
+export interface SyncMetadata {
+    /** ISO 8601 timestamp of last local modification */
+    lastModified?: string;
+    /** ISO 8601 timestamp of last successful sync to/from remote */
+    lastSyncedAt?: string;
+    /** Opaque identifier for the item in the remote system (e.g. Notion page ID) */
+    remoteId?: string;
+}
+export type ConflictResolution = "local" | "remote";
+export interface ConflictRecord {
+    itemId: string;
+    field: string;
+    localValue: unknown;
+    remoteValue: unknown;
+    resolution: ConflictResolution;
+    resolvedAt: string;
+}
+export interface SyncResult {
+    /** Items synced without conflict */
+    synced: string[];
+    /** Items where conflicts were detected and resolved */
+    conflicts: ConflictRecord[];
+    /** Items that failed to sync (e.g. missing on one side) */
+    errors: Array<{
+        itemId: string;
+        error: string;
+    }>;
+}
+/**
+ * Detect which fields differ between a local and remote version of the same item.
+ * Ignores sync metadata fields and structural fields that should never change.
+ */
+export declare function detectChangedFields(local: PRDItem, remote: PRDItem): string[];
+/**
+ * Determine whether a field was modified locally since last sync.
+ * If no lastSyncedAt exists, assume the item has never been synced,
+ * so any difference is a local change.
+ */
+export declare function isModifiedSinceSync(item: PRDItem): boolean;
+/**
+ * Resolve conflicts between a local and remote item using last-write-wins.
+ *
+ * For each differing field:
+ * - Compares local lastModified vs remote lastModified
+ * - The more recently modified version's field value wins
+ * - All conflicts are recorded for logging
+ *
+ * Returns the merged item and a list of conflict records.
+ */
+export declare function resolveConflicts(local: PRDItem, remote: PRDItem, remoteLastModified?: string): {
+    merged: PRDItem;
+    conflicts: ConflictRecord[];
+};
+/**
+ * Reconcile an entire list of local items against a map of remote items (keyed by id).
+ * Returns a full SyncResult with synced IDs, conflict records, and errors.
+ */
+export declare function reconcile(localItems: PRDItem[], remoteItemsById: Map<string, PRDItem & {
+    lastModified?: string;
+}>): SyncResult;
+/**
+ * Build a LogEntry for a conflict that was resolved.
+ */
+export declare function conflictToLogEntry(conflict: ConflictRecord): LogEntry;
+/**
+ * Stamp the current time as lastModified on an item.
+ * Used by store operations to track when items change locally.
+ */
+export declare function stampModified(item: PRDItem, timestamp?: string): PRDItem;
+/**
+ * Mark an item as having been synced at the current time.
+ */
+export declare function stampSynced(item: PRDItem, remoteId?: string, timestamp?: string): PRDItem;
+/**
+ * Extract sync metadata from a PRDItem (which stores it via index signature).
+ */
+export declare function extractSyncMeta(item: PRDItem): SyncMetadata;