@stratasync/core 0.2.0

package/dist/sync/delta-applier.js

@@ -0,0 +1,110 @@
+import { createArchivePayload, createUnarchivePatch, readArchivedAt, } from "../transaction/archive.js";
+import { maxSyncId, ZERO_SYNC_ID } from "./sync-id.js";
+/**
+ * Merges data into an existing row and writes it back.
+ */
+const mergeAndPut = async (target, modelName, modelId, data, overrides) => {
+    const existing = await target.get(modelName, modelId);
+    await target.put(modelName, modelId, {
+        ...existing,
+        ...data,
+        ...overrides,
+    });
+};
+/**
+ * Applies a single sync action to the target
+ */
+const applySingleAction = async (action, target, options) => {
+    const { modelName, modelId, data } = action;
+    switch (action.action) {
+        case "I": {
+            await target.put(modelName, modelId, data);
+            break;
+        }
+        case "U": {
+            if (options.mergeUpdates) {
+                await target.patch(modelName, modelId, data);
+            }
+            else {
+                const existing = await target.get(modelName, modelId);
+                await target.put(modelName, modelId, existing ? { ...existing, ...data } : data);
+            }
+            break;
+        }
+        case "D": {
+            await target.delete(modelName, modelId);
+            break;
+        }
+        case "A": {
+            await mergeAndPut(target, modelName, modelId, data, createArchivePayload(readArchivedAt(data)));
+            break;
+        }
+        case "V": {
+            await mergeAndPut(target, modelName, modelId, data, createUnarchivePatch());
+            break;
+        }
+        default: {
+            break;
+        }
+    }
+};
+/**
+ * Updates the result counters based on action type
+ */
+const updateResult = (result, action) => {
+    const actionSyncId = action.id;
+    result.lastSyncId = maxSyncId(result.lastSyncId, actionSyncId);
+    switch (action.action) {
+        case "I": {
+            result.inserts += 1;
+            break;
+        }
+        case "U": {
+            result.updates += 1;
+            break;
+        }
+        case "D": {
+            result.deletes += 1;
+            break;
+        }
+        case "A": {
+            result.archives += 1;
+            break;
+        }
+        case "V": {
+            result.unarchives += 1;
+            break;
+        }
+        default: {
+            break;
+        }
+    }
+};
+export const applyDeltas = async (packet, target, registry, options = {}) => {
+    const result = {
+        archives: 0,
+        deletes: 0,
+        inserts: 0,
+        lastSyncId: ZERO_SYNC_ID,
+        skipped: 0,
+        unarchives: 0,
+        updates: 0,
+    };
+    for (const action of packet.actions) {
+        // Skip actions from our own client (we already applied them optimistically)
+        const actionSyncId = action.id;
+        if (options.clientId && action.clientId === options.clientId) {
+            result.skipped += 1;
+            result.lastSyncId = maxSyncId(result.lastSyncId, actionSyncId);
+            continue;
+        }
+        // Verify model exists in schema
+        if (!registry.hasModel(action.modelName)) {
+            continue;
+        }
+        await applySingleAction(action, target, options);
+        updateResult(result, action);
+    }
+    return result;
+};
+//# sourceMappingURL=delta-applier.js.map

package/dist/sync/delta-applier.js.map

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

package/dist/sync/rebase.d.ts

@@ -0,0 +1,57 @@
+import type { Transaction } from "../transaction/types.js";
+import type { SyncAction } from "./types.js";
+/**
+ * Result of rebasing pending transactions against server deltas
+ */
+export interface RebaseResult {
+    /** Transactions that should remain pending */
+    pending: Transaction[];
+    /** Transactions that were confirmed by the server */
+    confirmed: Transaction[];
+    /** Transactions that conflict with server changes */
+    conflicts: RebaseConflict[];
+}
+/**
+ * A conflict between a pending transaction and a server change
+ */
+export interface RebaseConflict {
+    /** The local pending transaction */
+    localTransaction: Transaction;
+    /** The conflicting server action */
+    serverAction: SyncAction;
+    /** Type of conflict */
+    conflictType: ConflictType;
+    /** Suggested resolution */
+    resolution: ConflictResolution;
+}
+/**
+ * Types of conflicts that can occur
+ */
+type ConflictType = "update-update" | "update-delete" | "delete-update" | "insert-insert";
+/**
+ * Possible conflict resolutions
+ */
+export type ConflictResolution = "server-wins" | "client-wins" | "merge" | "manual";
+/**
+ * Options for rebase operation
+ */
+export interface RebaseOptions {
+    /** Client ID to identify own transactions */
+    clientId: string;
+    /** Default conflict resolution strategy */
+    defaultResolution?: ConflictResolution;
+    /** Field-level conflict detection */
+    fieldLevelConflicts?: boolean;
+}
+/**
+ * Rebases pending transactions against server deltas
+ *
+ * This is the core algorithm for handling concurrent edits:
+ * 1. For each server action, check if we have a pending transaction for the same model/id
+ * 2. If the server action is our own transaction (matched by clientTxId), mark as confirmed
+ * 3. If the server action conflicts with our pending transaction, detect the conflict type
+ * 4. Apply the appropriate resolution strategy
+ */
+export declare const rebaseTransactions: (pending: Transaction[], serverActions: SyncAction[], options: RebaseOptions) => RebaseResult;
+export {};
+//# sourceMappingURL=rebase.d.ts.map

package/dist/sync/rebase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rebase.d.ts","sourceRoot":"","sources":["../../src/sync/rebase.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,8CAA8C;IAC9C,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,qDAAqD;IACrD,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,qDAAqD;IACrD,SAAS,EAAE,cAAc,EAAE,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,oCAAoC;IACpC,gBAAgB,EAAE,WAAW,CAAC;IAC9B,oCAAoC;IACpC,YAAY,EAAE,UAAU,CAAC;IACzB,uBAAuB;IACvB,YAAY,EAAE,YAAY,CAAC;IAC3B,2BAA2B;IAC3B,UAAU,EAAE,kBAAkB,CAAC;CAChC;AAED;;GAEG;AACH,KAAK,YAAY,GAEb,eAAe,GAEf,eAAe,GAEf,eAAe,GAEf,eAAe,CAAC;AAEpB;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAE1B,aAAa,GAEb,aAAa,GAEb,OAAO,GAEP,QAAQ,CAAC;AAEb;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,2CAA2C;IAC3C,iBAAiB,CAAC,EAAE,kBAAkB,CAAC;IACvC,qCAAqC;IACrC,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAoHD;;;;;;;;GAQG;AACH,eAAO,MAAM,kBAAkB,GAC7B,SAAS,WAAW,EAAE,EACtB,eAAe,UAAU,EAAE,EAC3B,SAAS,aAAa,KACrB,YA2DF,CAAC"}

package/dist/sync/rebase.js

@@ -0,0 +1,155 @@
+/**
+ * Normalizes Archive (A) and Unarchive (V) actions to Update (U)
+ * since they are semantically update-like operations.
+ */
+const normalizeAction = (action) => {
+    switch (action) {
+        case "I": {
+            return "I";
+        }
+        case "U":
+        case "A":
+        case "V": {
+            return "U";
+        }
+        case "D": {
+            return "D";
+        }
+        default: {
+            return null;
+        }
+    }
+};
+const getLocalConflictFields = (tx) => {
+    if (tx.action === "A" || tx.action === "V") {
+        return ["archivedAt"];
+    }
+    return Object.keys(tx.payload);
+};
+const getServerConflictFields = (action) => {
+    if (action.action === "A" || action.action === "V") {
+        const dataKeys = Object.keys(action.data).filter((key) => key !== "archivedAt");
+        return ["archivedAt", ...dataKeys];
+    }
+    return Object.keys(action.data);
+};
+/**
+ * Determines the resolution strategy for a conflict
+ */
+const resolveConflict = (conflictType, options) => {
+    if (options.defaultResolution) {
+        return options.defaultResolution;
+    }
+    // insert-insert is rare (likely a bug) and requires manual resolution.
+    // All other conflict types default to server-wins (last-write-wins).
+    if (conflictType === "insert-insert") {
+        return "manual";
+    }
+    return "server-wins";
+};
+/**
+ * Detects if there's a conflict between a local transaction and server action
+ */
+const detectConflict = (tx, action, options) => {
+    const normalizedServer = normalizeAction(action.action);
+    const normalizedLocal = normalizeAction(tx.action);
+    if (!(normalizedServer && normalizedLocal)) {
+        return null;
+    }
+    // modelName and modelId match is guaranteed by the caller's key-based lookup
+    let conflictType;
+    if (normalizedLocal === "I" && normalizedServer === "I") {
+        conflictType = "insert-insert";
+    }
+    else if (normalizedLocal === "D" && normalizedServer === "U") {
+        conflictType = "delete-update";
+    }
+    else if (normalizedLocal === "U" && normalizedServer === "D") {
+        conflictType = "update-delete";
+    }
+    else if (normalizedLocal === "U" && normalizedServer === "U") {
+        // Check for field-level conflicts
+        if (options.fieldLevelConflicts) {
+            const localFields = getLocalConflictFields(tx);
+            const serverFields = getServerConflictFields(action);
+            const overlap = localFields.some((f) => serverFields.includes(f));
+            if (!overlap) {
+                // No overlapping fields, can merge
+                return null;
+            }
+        }
+        conflictType = "update-update";
+    }
+    else {
+        // No conflict for other combinations
+        return null;
+    }
+    // Determine resolution
+    const resolution = resolveConflict(conflictType, options);
+    return {
+        conflictType,
+        localTransaction: tx,
+        resolution,
+        serverAction: action,
+    };
+};
+/**
+ * Rebases pending transactions against server deltas
+ *
+ * This is the core algorithm for handling concurrent edits:
+ * 1. For each server action, check if we have a pending transaction for the same model/id
+ * 2. If the server action is our own transaction (matched by clientTxId), mark as confirmed
+ * 3. If the server action conflicts with our pending transaction, detect the conflict type
+ * 4. Apply the appropriate resolution strategy
+ */
+export const rebaseTransactions = (pending, serverActions, options) => {
+    const result = {
+        confirmed: [],
+        conflicts: [],
+        pending: [],
+    };
+    // Index pending transactions by model+id for fast lookup
+    const pendingByKey = new Map();
+    for (const tx of pending) {
+        const key = `${tx.modelName}:${tx.modelId}`;
+        const existing = pendingByKey.get(key) ?? [];
+        existing.push(tx);
+        pendingByKey.set(key, existing);
+    }
+    // Track which transactions have been processed
+    const processed = new Set();
+    // Process each server action
+    for (const action of serverActions) {
+        const key = `${action.modelName}:${action.modelId}`;
+        const relatedTxs = pendingByKey.get(key) ?? [];
+        for (const tx of relatedTxs) {
+            if (processed.has(tx.clientTxId)) {
+                continue;
+            }
+            // Check if this server action is our own transaction
+            if (action.clientTxId === tx.clientTxId &&
+                action.clientId === options.clientId) {
+                result.confirmed.push(tx);
+                processed.add(tx.clientTxId);
+                // Our own echo — don't conflict-check remaining pending txs against it.
+                // Subsequent pending mutations (e.g. undo) were created on top of this
+                // change and should not be rolled back by its server confirmation.
+                break;
+            }
+            // Check for conflicts
+            const conflict = detectConflict(tx, action, options);
+            if (conflict) {
+                result.conflicts.push(conflict);
+                processed.add(tx.clientTxId);
+            }
+        }
+    }
+    // Remaining unprocessed transactions stay pending
+    for (const tx of pending) {
+        if (!processed.has(tx.clientTxId)) {
+            result.pending.push(tx);
+        }
+    }
+    return result;
+};
+//# sourceMappingURL=rebase.js.map

package/dist/sync/rebase.js.map

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

package/dist/sync/sync-id.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Sync ID type — string on the wire, represents a monotonically increasing integer.
+ * Using string avoids precision loss for values exceeding Number.MAX_SAFE_INTEGER.
+ */
+export type SyncId = string;
+/** Zero sync ID constant */
+export declare const ZERO_SYNC_ID: SyncId;
+/**
+ * Compares two string-encoded sync IDs numerically.
+ * Returns negative if a < b, 0 if equal, positive if a > b.
+ */
+export declare const compareSyncId: (a: SyncId, b: SyncId) => number;
+/** Returns the larger of two sync IDs */
+export declare const maxSyncId: (a: SyncId, b: SyncId) => SyncId;
+/** Checks if sync ID a is greater than sync ID b */
+export declare const isSyncIdGreaterThan: (a: SyncId, b: SyncId) => boolean;
+//# sourceMappingURL=sync-id.d.ts.map

package/dist/sync/sync-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-id.d.ts","sourceRoot":"","sources":["../../src/sync/sync-id.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC;AAE5B,4BAA4B;AAC5B,eAAO,MAAM,YAAY,EAAE,MAAY,CAAC;AAIxC;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,GAAG,MAAM,EAAE,GAAG,MAAM,KAAG,MAcpD,CAAC;AAEF,yCAAyC;AACzC,eAAO,MAAM,SAAS,GAAI,GAAG,MAAM,EAAE,GAAG,MAAM,KAAG,MACf,CAAC;AAEnC,oDAAoD;AACpD,eAAO,MAAM,mBAAmB,GAAI,GAAG,MAAM,EAAE,GAAG,MAAM,KAAG,OAClC,CAAC"}

package/dist/sync/sync-id.js

@@ -0,0 +1,26 @@
+/** Zero sync ID constant */
+export const ZERO_SYNC_ID = "0";
+const LEADING_ZEROS = /^0+/;
+/**
+ * Compares two string-encoded sync IDs numerically.
+ * Returns negative if a < b, 0 if equal, positive if a > b.
+ */
+export const compareSyncId = (a, b) => {
+    const aStripped = a.replace(LEADING_ZEROS, "") || "0";
+    const bStripped = b.replace(LEADING_ZEROS, "") || "0";
+    if (aStripped.length !== bStripped.length) {
+        return aStripped.length - bStripped.length;
+    }
+    if (aStripped < bStripped) {
+        return -1;
+    }
+    if (aStripped > bStripped) {
+        return 1;
+    }
+    return 0;
+};
+/** Returns the larger of two sync IDs */
+export const maxSyncId = (a, b) => compareSyncId(a, b) >= 0 ? a : b;
+/** Checks if sync ID a is greater than sync ID b */
+export const isSyncIdGreaterThan = (a, b) => compareSyncId(a, b) > 0;
+//# sourceMappingURL=sync-id.js.map

package/dist/sync/sync-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-id.js","sourceRoot":"","sources":["../../src/sync/sync-id.ts"],"names":[],"mappings":"AAMA,4BAA4B;AAC5B,MAAM,CAAC,MAAM,YAAY,GAAW,GAAG,CAAC;AAExC,MAAM,aAAa,GAAG,KAAK,CAAC;AAE5B;;;GAGG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,CAAS,EAAE,CAAS,EAAU,EAAE;IAC5D,MAAM,SAAS,GAAG,CAAC,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC;IACtD,MAAM,SAAS,GAAG,CAAC,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC;IAEtD,IAAI,SAAS,CAAC,MAAM,KAAK,SAAS,CAAC,MAAM,EAAE,CAAC;QAC1C,OAAO,SAAS,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC;IAC7C,CAAC;IACD,IAAI,SAAS,GAAG,SAAS,EAAE,CAAC;QAC1B,OAAO,CAAC,CAAC,CAAC;IACZ,CAAC;IACD,IAAI,SAAS,GAAG,SAAS,EAAE,CAAC;QAC1B,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC,CAAC;AAEF,yCAAyC;AACzC,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAS,EAAE,CAAS,EAAU,EAAE,CACxD,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAEnC,oDAAoD;AACpD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAS,EAAE,CAAS,EAAW,EAAE,CACnE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC"}

package/dist/sync/types.d.ts

@@ -0,0 +1,152 @@
+import type { TransactionAction } from "../schema/types.js";
+import type { SyncId } from "./sync-id.js";
+/**
+ * Sync action types emitted by the server.
+ * Includes mutation actions plus sync-group / coverage signals.
+ */
+export type SyncActionType = TransactionAction | "C" | "G" | "S";
+/**
+ * A sync action represents a single change from the server
+ */
+export interface SyncAction {
+    /** Monotonically increasing sync ID (string-encoded for BigInt safety) */
+    id: SyncId;
+    /** Name of the model that changed */
+    modelName: string;
+    /** ID of the model instance */
+    modelId: string;
+    /** Type of change */
+    action: SyncActionType;
+    /** Full or partial data for the model */
+    data: Record<string, unknown>;
+    /** Group ID for multi-tenancy filtering */
+    groupId?: string;
+    /** Group IDs for multi-tenancy filtering */
+    groups?: string[];
+    /** Client transaction ID if this was a client mutation */
+    clientTxId?: string;
+    /** Client ID that originated the change */
+    clientId?: string;
+    /** Timestamp when the change was created */
+    createdAt?: Date;
+    /** Class name marker (Done payloads include __class) */
+    __class?: "SyncAction";
+}
+/**
+ * A packet of delta changes from the server
+ */
+export interface DeltaPacket {
+    /** Highest sync ID in this packet */
+    lastSyncId: SyncId;
+    /** Array of sync actions */
+    actions: SyncAction[];
+    /** Whether there are more deltas available */
+    hasMore?: boolean;
+}
+/**
+ * Bootstrap metadata for initial sync
+ */
+export interface BootstrapMetadata {
+    /** Latest sync ID at bootstrap completion (may be omitted for partial/batch payloads) */
+    lastSyncId?: SyncId;
+    /** Groups returned by the server for this user */
+    subscribedSyncGroups: string[];
+    /** Count of returned models (by model name) */
+    returnedModelsCount?: Record<string, number>;
+    /** Schema hash returned by server (if provided) */
+    schemaHash?: string;
+    /** Server database version (if provided) */
+    databaseVersion?: number;
+    /** Additional metadata fields (if provided) */
+    raw?: Record<string, unknown>;
+}
+/**
+ * A row of model data during bootstrap
+ */
+export interface ModelRow {
+    /** Model name */
+    modelName: string;
+    /** Row data */
+    data: Record<string, unknown>;
+}
+/**
+ * State of the sync client
+ */
+export type SyncClientState = "disconnected" | "connecting" | "bootstrapping" | "syncing" | "error";
+/**
+ * Connection state for transport
+ */
+export type ConnectionState = "disconnected" | "connecting" | "connected" | "reconnecting" | "error";
+/**
+ * Options for bootstrap operation
+ */
+export interface BootstrapOptions {
+    /** Bootstrap type (full or partial) */
+    type?: "full" | "partial";
+    /** Models to include in bootstrap */
+    onlyModels?: string[];
+    /** Schema hash for validation/caching (optional) */
+    schemaHash?: string;
+    /** First sync ID for partial bootstrap (optional) */
+    firstSyncId?: SyncId;
+    /** Sync groups to bootstrap (optional) */
+    syncGroups?: string[];
+    /** Skip sync packets during partial bootstrap (optional) */
+    noSyncPackets?: boolean;
+    /** Enable CDN caching (optional) */
+    useCFCaching?: boolean;
+    /** Disable cache (optional) */
+    noCache?: boolean;
+    /** Models hash for cache validation (optional) */
+    modelsHash?: string;
+}
+/**
+ * Options for delta subscription
+ */
+export interface SubscribeOptions {
+    /** Start after this sync ID */
+    afterSyncId: SyncId;
+    /** Groups to subscribe to */
+    groups: string[];
+}
+/**
+ * Delta subscription handle
+ */
+export interface DeltaSubscription {
+    /** Async iterator of delta packets */
+    [Symbol.asyncIterator](): AsyncIterator<DeltaPacket>;
+    /** Unsubscribe and close connection */
+    unsubscribe(): void;
+}
+/**
+ * Batch load request for lazy-loaded models
+ */
+export type BatchRequest = {
+    /** Model name */
+    modelName: string;
+    /** Indexed key to filter by */
+    indexedKey: string;
+    /** Indexed key value */
+    keyValue: string;
+    /** Disallow groupId for indexed requests */
+    groupId?: never;
+} | {
+    /** Model name */
+    modelName: string;
+    /** Sync group ID */
+    groupId: string;
+    /** Disallow indexed key filters for group requests */
+    indexedKey?: never;
+    /** Disallow indexed key values for group requests */
+    keyValue?: never;
+};
+/**
+ * Batch load options for partial hydration
+ */
+export interface BatchLoadOptions {
+    /** First sync ID from full bootstrap */
+    firstSyncId: SyncId;
+    /** Batch requests to load */
+    requests: BatchRequest[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/sync/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/sync/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,iBAAiB,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,0EAA0E;IAC1E,EAAE,EAAE,MAAM,CAAC;IACX,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,qBAAqB;IACrB,MAAM,EAAE,cAAc,CAAC;IACvB,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,SAAS,CAAC,EAAE,IAAI,CAAC;IACjB,wDAAwD;IACxD,OAAO,CAAC,EAAE,YAAY,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,yFAAyF;IACzF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,+CAA+C;IAC/C,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,+CAA+C;IAC/C,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe;IACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,cAAc,GACd,YAAY,GACZ,eAAe,GACf,SAAS,GACT,OAAO,CAAC;AAEZ;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,cAAc,GACd,YAAY,GACZ,WAAW,GACX,cAAc,GACd,OAAO,CAAC;AAEZ;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,qCAAqC;IACrC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,4DAA4D;IAC5D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,oCAAoC;IACpC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,sCAAsC;IACtC,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,WAAW,CAAC,CAAC;IACrD,uCAAuC;IACvC,WAAW,IAAI,IAAI,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GACpB;IACE,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,wBAAwB;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,4CAA4C;IAC5C,OAAO,CAAC,EAAE,KAAK,CAAC;CACjB,GACD;IACE,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,UAAU,CAAC,EAAE,KAAK,CAAC;IACnB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,KAAK,CAAC;CAClB,CAAC;AAEN;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wCAAwC;IACxC,WAAW,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,QAAQ,EAAE,YAAY,EAAE,CAAC;CAC1B"}

package/dist/sync/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/sync/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/sync/types.ts"],"names":[],"mappings":""}

package/dist/transaction/archive.d.ts

@@ -0,0 +1,16 @@
+export interface ArchiveState extends Record<string, unknown> {
+    archivedAt?: number | null;
+}
+export interface ArchiveTransactionOptions {
+    original?: Record<string, unknown>;
+    archivedAt?: number;
+}
+export interface UnarchiveTransactionOptions {
+    original?: Record<string, unknown>;
+}
+export declare const readArchivedAt: (record: Record<string, unknown> | ArchiveState | undefined) => number | undefined;
+export declare const captureArchiveState: (record: Record<string, unknown> | ArchiveState | undefined) => ArchiveState;
+export declare const createArchivePayload: (archivedAt?: number) => ArchiveState;
+export declare const createUnarchivePatch: () => ArchiveState;
+export declare const createUnarchivePayload: () => Record<string, unknown>;
+//# sourceMappingURL=archive.d.ts.map

package/dist/transaction/archive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../src/transaction/archive.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAa,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC3D,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAID,eAAO,MAAM,cAAc,GACzB,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,GAAG,SAAS,KACzD,MAAM,GAAG,SAgBX,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAC9B,QAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,YAAY,GAAG,SAAS,KACzD,YAAgE,CAAC;AAEpE,eAAO,MAAM,oBAAoB,GAAI,aAAa,MAAM,KAAG,YAEzD,CAAC;AAEH,eAAO,MAAM,oBAAoB,QAAO,YAAsC,CAAC;AAE/E,eAAO,MAAM,sBAAsB,QAAO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAS,CAAC"}

package/dist/transaction/archive.js

@@ -0,0 +1,23 @@
+const ISO_ARCHIVE_TIMESTAMP_REGEX = /^\d{4}-\d{2}-\d{2}(?:[T ][0-9:.+Z-]+)?$/;
+export const readArchivedAt = (record) => {
+    const archivedAt = record?.archivedAt;
+    if (typeof archivedAt === "number") {
+        return archivedAt;
+    }
+    if (typeof archivedAt === "string") {
+        const isIsoTimestamp = ISO_ARCHIVE_TIMESTAMP_REGEX.test(archivedAt);
+        if (!isIsoTimestamp) {
+            return undefined;
+        }
+        const parsed = Date.parse(archivedAt);
+        return Number.isNaN(parsed) ? undefined : parsed;
+    }
+    return undefined;
+};
+export const captureArchiveState = (record) => ({ archivedAt: readArchivedAt(record) ?? null });
+export const createArchivePayload = (archivedAt) => ({
+    archivedAt: archivedAt ?? Date.now(),
+});
+export const createUnarchivePatch = () => ({ archivedAt: null });
+export const createUnarchivePayload = () => ({});
+//# sourceMappingURL=archive.js.map

package/dist/transaction/archive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive.js","sourceRoot":"","sources":["../../src/transaction/archive.ts"],"names":[],"mappings":"AAaA,MAAM,2BAA2B,GAAG,yCAAyC,CAAC;AAE9E,MAAM,CAAC,MAAM,cAAc,GAAG,CAC5B,MAA0D,EACtC,EAAE;IACtB,MAAM,UAAU,GAAG,MAAM,EAAE,UAAU,CAAC;IACtC,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;QACnC,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,IAAI,OAAO,UAAU,KAAK,QAAQ,EAAE,CAAC;QACnC,MAAM,cAAc,GAAG,2BAA2B,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACpE,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QACtC,OAAO,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;IACnD,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,MAA0D,EAC5C,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,cAAc,CAAC,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;AAEpE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,UAAmB,EAAgB,EAAE,CAAC,CAAC;IAC1E,UAAU,EAAE,UAAU,IAAI,IAAI,CAAC,GAAG,EAAE;CACrC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAiB,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;AAE/E,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAA4B,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC"}

package/dist/transaction/create.d.ts

@@ -0,0 +1,31 @@
+import type { ArchiveTransactionOptions, UnarchiveTransactionOptions } from "./archive.js";
+import type { Transaction, TransactionBatch } from "./types.js";
+/**
+ * Creates a transaction batch from an array of transactions
+ */
+export declare const createTransactionBatch: (transactions: Transaction[]) => TransactionBatch;
+/**
+ * Creates an INSERT transaction for a new model instance
+ */
+export declare const createInsertTransaction: (clientId: string, modelName: string, modelId: string, data: Record<string, unknown>) => Transaction;
+/**
+ * Creates an UPDATE transaction for an existing model instance
+ */
+export declare const createUpdateTransaction: (clientId: string, modelName: string, modelId: string, changes: Record<string, unknown>, original: Record<string, unknown>) => Transaction;
+/**
+ * Creates a DELETE transaction for removing a model instance
+ */
+export declare const createDeleteTransaction: (clientId: string, modelName: string, modelId: string, original: Record<string, unknown>) => Transaction;
+/**
+ * Creates an ARCHIVE transaction for soft-deleting a model instance
+ */
+export declare const createArchiveTransaction: (clientId: string, modelName: string, modelId: string, options?: ArchiveTransactionOptions) => Transaction;
+/**
+ * Creates an UNARCHIVE transaction for restoring a soft-deleted model instance
+ */
+export declare const createUnarchiveTransaction: (clientId: string, modelName: string, modelId: string, options?: UnarchiveTransactionOptions) => Transaction;
+/**
+ * Creates an undo transaction for a given transaction.
+ */
+export declare const createUndoTransaction: (tx: Transaction, clientId?: string) => Transaction | null;
+//# sourceMappingURL=create.d.ts.map

package/dist/transaction/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/transaction/create.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,yBAAyB,EACzB,2BAA2B,EAC5B,MAAM,cAAc,CAAC;AAQtB,OAAO,KAAK,EAEV,WAAW,EACX,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAyBpB;;GAEG;AACH,eAAO,MAAM,sBAAsB,GACjC,cAAc,WAAW,EAAE,KAC1B,gBAID,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,uBAAuB,GAClC,UAAU,MAAM,EAChB,WAAW,MAAM,EACjB,SAAS,MAAM,EACf,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B,WAOC,CAAC;AAEL;;GAEG;AACH,eAAO,MAAM,uBAAuB,GAClC,UAAU,MAAM,EAChB,WAAW,MAAM,EACjB,SAAS,MAAM,EACf,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAChC,WAQC,CAAC;AAEL;;GAEG;AACH,eAAO,MAAM,uBAAuB,GAClC,UAAU,MAAM,EAChB,WAAW,MAAM,EACjB,SAAS,MAAM,EACf,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAChC,WAQC,CAAC;AAEL;;GAEG;AACH,eAAO,MAAM,wBAAwB,GACnC,UAAU,MAAM,EAChB,WAAW,MAAM,EACjB,SAAS,MAAM,EACf,UAAS,yBAA8B,KACtC,WAQC,CAAC;AAEL;;GAEG;AACH,eAAO,MAAM,0BAA0B,GACrC,UAAU,MAAM,EAChB,WAAW,MAAM,EACjB,SAAS,MAAM,EACf,UAAS,2BAAgC,KACxC,WAQC,CAAC;AAEL;;GAEG;AACH,eAAO,MAAM,qBAAqB,GAChC,IAAI,WAAW,EACf,WAAU,MAAoB,KAC7B,WAAW,GAAG,IAgDhB,CAAC"}