korajs 1.0.0-beta.10 → 1.0.0-beta.11

package/dist/index.cjs

@@ -1317,6 +1317,7 @@ function createSyncQuerySubscriptionHook(getSyncEngine) {
 // src/initialize-app.ts
 async function initializeApp(config, emitter, mergeEngine) {
   const adapterType = config.store?.adapter ?? detectAdapterType();
+  let effectiveAdapterType = adapterType;
   const baseDbName = config.store?.name ?? "kora-db";
   const authBinding = config.sync?.authClient ?? null;
   const authUserId = config.store?.namespaceByAuthUser && authBinding?.resolveUserId ? await authBinding.resolveUserId() : void 0;
@@ -1357,6 +1358,7 @@ async function initializeApp(config, emitter, mergeEngine) {
         emitter,
         config.store?.workerResponseTimeoutMs
       );
+      effectiveAdapterType = "indexeddb";
       store = buildStore(adapter);
       await store.open();
       emitter.emit({
@@ -1368,6 +1370,7 @@ async function initializeApp(config, emitter, mergeEngine) {
         message: `OPFS persistence is unavailable (${fallbackReason}) for database "${dbName}"; Kora is using durable IndexedDB instead.`
       });
     } catch {
+      effectiveAdapterType = "sqlite-wasm";
       adapter = await createAdapter(
         "sqlite-wasm",
         dbName,
@@ -1413,6 +1416,8 @@ async function initializeApp(config, emitter, mergeEngine) {
         url: config.sync.url,
         transport: config.sync.transport,
         auth: syncAuth,
+        authState: authBinding?.resolveSyncState,
+        querySubsets: config.sync.querySubsets,
         batchSize: config.sync.batchSize,
         schemaVersion: config.sync.schemaVersion ?? config.schema.version,
         scopeMap,
@@ -1449,7 +1454,15 @@ async function initializeApp(config, emitter, mergeEngine) {
     unsubscribeLocalOperations,
     authBinding,
     blobStore,
-    blobChunkProvider
+    blobChunkProvider,
+    storeInfo: {
+      baseName: baseDbName,
+      databaseName: dbName,
+      authUserId: authUserId ?? null,
+      persistence: effectiveAdapterType,
+      durable: adapter.getStorageOpenState?.()?.persistent ?? adapterType !== "sqlite-wasm",
+      isolationState: "ready"
+    }
   };
 }
 function emitOpfsUnavailable(emitter, dbName, reason) {
@@ -1573,6 +1586,66 @@ function createSyncControl(options) {
         state.syncStatusBridge?.refresh();
       }
     },
+    async setQuerySubsets(subsets) {
+      await ready;
+      state.syncEngine?.setQuerySubsets(subsets);
+    },
+    async waitForSettled(options2 = {}) {
+      await ready;
+      const upload = options2.upload ?? true;
+      const download = options2.download ?? "active-view";
+      const classify = () => {
+        const status = state.syncEngine?.getStatus() ?? offlineSyncStatus();
+        if (status.phase === "suspended")
+          return { outcome: "suspended", reason: status.reason ?? "suspended", status };
+        if (status.blockedFailure)
+          return { outcome: "blocked", failure: status.blockedFailure, status };
+        if (status.phase === "offline") return { outcome: "offline", status };
+        const uploadDone = !upload || status.pendingOperations === 0 && (status.inFlightUploadOperations ?? 0) === 0;
+        const downloadDone = download === false || status.activeViewComplete;
+        return uploadDone && downloadDone ? { outcome: "settled", status } : null;
+      };
+      return await new Promise((resolve) => {
+        let done = false;
+        let unsubscribeReady = false;
+        let cleanupPending = false;
+        let timer = null;
+        let unsubscribe = () => {
+        };
+        const finish = (result) => {
+          if (done) return;
+          done = true;
+          if (unsubscribeReady) unsubscribe();
+          else cleanupPending = true;
+          if (timer) clearTimeout(timer);
+          options2.signal?.removeEventListener("abort", onAbort);
+          resolve(result);
+        };
+        const check = () => {
+          const result = classify();
+          if (result) finish(result);
+        };
+        const onAbort = () => finish({
+          outcome: "aborted",
+          status: state.syncEngine?.getStatus() ?? offlineSyncStatus()
+        });
+        unsubscribe = state.syncStatusBridge?.subscribe(check) ?? (() => {
+        });
+        unsubscribeReady = true;
+        if (cleanupPending) unsubscribe();
+        options2.signal?.addEventListener("abort", onAbort, { once: true });
+        if (options2.timeoutMs !== void 0)
+          timer = setTimeout(
+            () => finish({
+              outcome: "timeout",
+              status: state.syncEngine?.getStatus() ?? offlineSyncStatus()
+            }),
+            options2.timeoutMs
+          );
+        if (options2.signal?.aborted) onAbort();
+        else check();
+      });
+    },
     getStatus() {
       if (state.syncEngine) {
         return state.syncEngine.getStatus();
@@ -1609,13 +1682,22 @@ function createSyncControl(options) {
         state: "disconnected",
         status: {
           status: "offline",
+          phase: "offline",
           reconnecting: false,
           pendingOperations: 0,
           lastSyncedAt: null,
           lastSuccessfulPush: null,
           lastSuccessfulPull: null,
           conflicts: 0,
-          clockSkewMs: null
+          clockSkewMs: null,
+          inFlightUploadOperations: 0,
+          hasInFlightDeliveryBatch: false,
+          activeViewId: "",
+          activeViewComplete: false,
+          initialSync: { complete: false, receivedBatches: 0, totalBatches: null, progress: null },
+          deliveryWatermark: 0,
+          serverFrontier: null,
+          blockedFailure: null
         },
         nodeId: "",
         url: config.sync?.url ?? "",
@@ -1675,8 +1757,15 @@ var AuthSyncCoordinator = class {
     if (!engine) {
       return;
     }
+    engine.notifyAuthChanged?.();
+    const authState = await this.authBinding.resolveSyncState?.();
+    if (authState?.state === "loading" || authState?.state === "signed-out") {
+      await engine.stop();
+      await engine.start();
+      return;
+    }
     const headers = await this.authBinding.auth();
-    if (!headers.token) {
+    if (!headers.token && authState?.state !== "anonymous") {
       await engine.stop();
       return;
     }
@@ -1952,6 +2041,14 @@ function createApp(config) {
   let unsubscribeSync = null;
   let unsubscribeAudit = null;
   let unsubscribeLocalOperations = null;
+  let currentStoreInfo = {
+    baseName: config.store?.name ?? "kora-db",
+    databaseName: "",
+    authUserId: null,
+    persistence: config.store?.adapter ?? "sqlite-wasm",
+    durable: false,
+    isolationState: "closed"
+  };
   const syncState = {
     syncEngine: null,
     syncStatusBridge: null,
@@ -1975,6 +2072,7 @@ function createApp(config) {
       config.blob?.chunkSize,
       () => enumerateLiveBlobRefs(init.store, config.schema)
     );
+    currentStoreInfo = init.storeInfo;
     wireSyncLifecycleAfterReady(config, emitter, syncState, init);
   });
   const getStore = () => store;
@@ -2031,6 +2129,9 @@ function createApp(config) {
     getQueryStoreCache() {
       return queryStoreCache;
     },
+    storeInfo() {
+      return { ...currentStoreInfo };
+    },
     transaction(fn) {
       return executeTransaction(fn);
     },
@@ -2064,6 +2165,7 @@ function createApp(config) {
         await store.close();
         store = null;
       }
+      currentStoreInfo = { ...currentStoreInfo, isolationState: "closed" };
       emitter.clear();
     },
     async exportBackup(options) {