@vue-skuilder/db 0.2.18 → 0.2.20

package/dist/core/index.mjs

@@ -6899,16 +6899,44 @@ var init_BaseUserDB = __esm({
       // Database to use for write operations (local-first approach)
       updateQueue;
       _hydration = { state: "not-required" };
+      /** In-flight hydration, so concurrent callers can wait for a real answer. */
+      _hydrationPromise = null;
       /**
-       * How far the local mirror can be trusted. See {@link UserHydrationStatus}.
+       * 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}.
        *
-       * Consumers that would otherwise read a 404 as "new user" — onboarding
-       * gates, first-run experiences, progress dashboards — should check for
-       * `failed` and present a retry affordance rather than an empty state.
+       * This is a snapshot, and during login it can legitimately read
+       * `hydrating` — prefer awaitHydration() anywhere a decision hangs on the
+       * answer.
        */
       hydrationStatus() {
         return { ...this._hydration };
       }
+      /**
+       * The hydration status once it has settled — never `hydrating`.
+       *
+       * Resolves immediately unless a pull is in flight. Exists for callers that
+       * must decide something (a route guard, a first-run branch) and would
+       * otherwise sample `hydrating` and guess. Since init() is awaited by both
+       * app startup and login(), that only happens when something navigates
+       * concurrently with a login still in progress — a window that stretches to
+       * HYDRATION_TIMEOUT_MS on a slow connection.
+       */
+      async awaitHydration() {
+        try {
+          await this._hydrationPromise;
+        } catch {
+        }
+        return this.hydrationStatus();
+      }
       /**
        * Whether a missing document may be treated as genuinely absent, allowing
        * callers to create it with defaults.
@@ -7365,8 +7393,9 @@ Currently logged-in as ${this._username}.`
         }
         this.syncStrategy.stopSync?.();
         this.setDBandQ();
-        await this.hydrateLocalMirror();
-        this.syncStrategy.startSync(this.localDB, this.remoteDB);
+        this._hydrationPromise = this.hydrateLocalMirror();
+        await this._hydrationPromise;
+        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") {
@@ -7394,6 +7423,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;
@@ -7405,11 +7435,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",