@absolutejs/sync 1.23.0 → 1.24.0

package/dist/engine/index.d.ts

@@ -49,6 +49,8 @@ export { exponentialBackoff, isSerializationFailure, RetriesExhaustedError } fro
 export type { ExponentialBackoffOptions, RetryPolicy } from './retry';
 export { CdcConsumerSlowError, createSyncEngine, MissedChangesError, MutationQueueOverflowError, SchemaError, SubscriptionLimitError, UnauthorizedError } from './syncEngine';
 export type { ChangeLogSnapshot, CrdtFields, LoggedChange, StreamChangesOptions, SubscribeArgs, Subscription, SyncEngine, SyncEngineOptions } from './syncEngine';
+export { EngineFencedError } from './migrate';
+export type { EngineSnapshot, ExportSnapshotOptions, FenceHandle, ImportSnapshotOptions, MigrationImportResult } from './migrate';
 export { syncCdc } from './cdc';
 export type { SyncCdcOptions } from './cdc';
 export type { CrdtMergeable } from '../crdt';

package/dist/engine/index.js

@@ -1401,6 +1401,16 @@ var fireMetrics = (hook, record) => {
   }
 };
 
+// src/engine/migrate.ts
+class EngineFencedError extends Error {
+  reason;
+  constructor(reason) {
+    super(`[sync] Engine is fenced for migration: ${reason}`);
+    this.name = "EngineFencedError";
+    this.reason = reason;
+  }
+}
+
 // src/engine/syncEngine.ts
 class UnauthorizedError extends Error {
   constructor(subject) {
@@ -1603,6 +1613,7 @@ var createSyncEngine = (options = {}) => {
   let mutationsInFlight = 0;
   const mutationWaiters = [];
   let mutationsQueued = 0;
+  const activeFences = new Set;
   const acquireMutationSlot = async () => {
     const limit = options.mutationConcurrency;
     if (limit === undefined) {
@@ -2721,6 +2732,10 @@ var createSyncEngine = (options = {}) => {
         }
       });
       try {
+        if (activeFences.size > 0) {
+          const oldest = activeFences.values().next().value;
+          throw new EngineFencedError(oldest.reason);
+        }
         const mutation = mutations.get(name);
         if (mutation === undefined) {
           throw new Error(`Unknown mutation "${name}"`);
@@ -3096,6 +3111,70 @@ var createSyncEngine = (options = {}) => {
       }
       return { asOfAt, asOfVersion, rows, truncated };
     },
+    fence: ({ reason }) => {
+      const handle = {
+        fencedAt: Date.now(),
+        reason,
+        lift: () => {
+          activeFences.delete(handle);
+        }
+      };
+      activeFences.add(handle);
+      return handle;
+    },
+    exportSnapshot: async ({ tables, ctx = {} } = {}) => {
+      const tableFilter = tables !== undefined ? new Set(tables) : undefined;
+      const rows = {};
+      for (const [table, reader] of readers) {
+        if (tableFilter !== undefined && !tableFilter.has(table)) {
+          continue;
+        }
+        const iterable = await reader.all(ctx);
+        rows[table] = [...iterable];
+      }
+      return {
+        exportedAt: Date.now(),
+        sourceInstanceId: instanceId,
+        tables: rows,
+        version
+      };
+    },
+    importSnapshot: async (snapshot, { tables, onProgress, ctx = {} } = {}) => {
+      const tableFilter = tables !== undefined ? new Set(tables) : undefined;
+      const perTable = {};
+      const skipped = [];
+      let tablesImported = 0;
+      let rowsImported = 0;
+      for (const [table, snapshotRows] of Object.entries(snapshot.tables)) {
+        if (tableFilter !== undefined && !tableFilter.has(table)) {
+          continue;
+        }
+        const writer = writers.get(table);
+        if (writer === undefined) {
+          skipped.push(table);
+          continue;
+        }
+        const total = snapshotRows.length;
+        let done = 0;
+        for (const row of snapshotRows) {
+          await writer.insert(row, ctx, undefined);
+          done += 1;
+          rowsImported += 1;
+          if (onProgress !== undefined) {
+            onProgress(table, done, total);
+          }
+        }
+        perTable[table] = done;
+        if (done > 0)
+          tablesImported += 1;
+      }
+      return {
+        perTable,
+        rowsImported,
+        skipped,
+        tablesImported
+      };
+    },
     metrics: () => {
       const now = Date.now();
       const byCollection = {};
@@ -3667,8 +3746,9 @@ export {
   PackMissingDependencyError,
   MutationQueueOverflowError,
   MissedChangesError,
+  EngineFencedError,
   CdcConsumerSlowError
 };
 
-//# debugId=04E0C6606054D14564756E2164756E21
+//# debugId=A8C35E8D4A587BE064756E2164756E21
 //# sourceMappingURL=index.js.map