@vue-skuilder/db 0.2.19 → 0.2.20

package/dist/{SyncStrategy-BJMZq3WO.d.cts → SyncStrategy-CCU1H81I.d.cts}

@@ -48,17 +48,23 @@ interface SyncStrategy {
      *
      * @param localDB The local PouchDB instance
      * @param remoteDB The remote PouchDB instance
-     * @returns Count of documents written locally
+     * @returns Count of documents written locally, and — only when the pull is
+     *   known to have landed the remote's complete current state — the sequence
+     *   it corresponds to, for startSync() to resume from. Omitted means "no
+     *   safe shortcut, walk from the checkpoint".
      */
     hydrate?(localDB: PouchDB.Database, remoteDB: PouchDB.Database): Promise<{
         docsWritten: number;
+        lastSeq?: string | number;
     }>;
     /**
      * Start synchronization between local and remote databases
      * @param localDB The local PouchDB instance
      * @param remoteDB The remote PouchDB instance
+     * @param since Sequence to start the pull from, as returned by a hydrate()
+     *   in the same session. Omit to resume from the stored checkpoint.
      */
-    startSync(localDB: PouchDB.Database, remoteDB: PouchDB.Database): void;
+    startSync(localDB: PouchDB.Database, remoteDB: PouchDB.Database, since?: string | number): void;
     /**
      * Stop synchronization (optional - for cleanup)
      */

package/dist/{SyncStrategy-BJMZq3WO.d.ts → SyncStrategy-CCU1H81I.d.ts}

@@ -48,17 +48,23 @@ interface SyncStrategy {
      *
      * @param localDB The local PouchDB instance
      * @param remoteDB The remote PouchDB instance
-     * @returns Count of documents written locally
+     * @returns Count of documents written locally, and — only when the pull is
+     *   known to have landed the remote's complete current state — the sequence
+     *   it corresponds to, for startSync() to resume from. Omitted means "no
+     *   safe shortcut, walk from the checkpoint".
      */
     hydrate?(localDB: PouchDB.Database, remoteDB: PouchDB.Database): Promise<{
         docsWritten: number;
+        lastSeq?: string | number;
     }>;
     /**
      * Start synchronization between local and remote databases
      * @param localDB The local PouchDB instance
      * @param remoteDB The remote PouchDB instance
+     * @param since Sequence to start the pull from, as returned by a hydrate()
+     *   in the same session. Omit to resume from the stored checkpoint.
      */
-    startSync(localDB: PouchDB.Database, remoteDB: PouchDB.Database): void;
+    startSync(localDB: PouchDB.Database, remoteDB: PouchDB.Database, since?: string | number): void;
     /**
      * Stop synchronization (optional - for cleanup)
      */

package/dist/core/index.js

@@ -6921,6 +6921,14 @@ var init_BaseUserDB = __esm({
       _hydration = { state: "not-required" };
       /** In-flight hydration, so concurrent callers can wait for a real answer. */
       _hydrationPromise = null;
+      /**
+       * Sequence the local mirror was filled to by a hydration that succeeded in
+       * THIS init(), handed to startSync() so the live pull can skip history it
+       * would otherwise re-walk. Undefined whenever there is no such guarantee —
+       * hydration skipped, not required, or failed. Never persisted; see the
+       * `since` note in CouchDBSyncStrategy.startSync().
+       */
+      _hydratedSeq;
       /**
        * How far the local mirror can be trusted, RIGHT NOW. See
        * {@link UserHydrationStatus}.
@@ -7407,7 +7415,7 @@ Currently logged-in as ${this._username}.`
         this.setDBandQ();
         this._hydrationPromise = this.hydrateLocalMirror();
         await this._hydrationPromise;
-        this.syncStrategy.startSync(this.localDB, this.remoteDB);
+        this.syncStrategy.startSync(this.localDB, this.remoteDB, this._hydratedSeq);
         this.applyDesignDocs().catch((error) => {
           log3(`Error in applyDesignDocs background task: ${error}`);
           if (error && typeof error === "object") {
@@ -7435,6 +7443,7 @@ Currently logged-in as ${this._username}.`
        * ceiling). Callers decide what a failure means for them.
        */
       async hydrateLocalMirror() {
+        this._hydratedSeq = void 0;
         if (this.localDB.name === this.remoteDB.name || !this.syncStrategy.hydrate) {
           this._hydration = { state: "not-required" };
           return;
@@ -7446,11 +7455,12 @@ Currently logged-in as ${this._username}.`
         this._hydration = { state: "hydrating" };
         const start = Date.now();
         try {
-          const { docsWritten } = await withTimeout(
+          const { docsWritten, lastSeq } = await withTimeout(
             this.syncStrategy.hydrate(this.localDB, this.remoteDB),
             HYDRATION_TIMEOUT_MS,
             `Hydration of local mirror for ${this._username}`
           );
+          this._hydratedSeq = lastSeq;
           await this.writeHydrationMarker();
           this._hydration = {
             state: "hydrated",