@topgunbuild/client 0.9.0 → 0.10.0

package/dist/index.mjs

@@ -1336,10 +1336,11 @@ var _SyncEngine = class _SyncEngine {
         break;
       }
       case "QUERY_RESP": {
-        const { queryId, results } = message.payload;
+        const { queryId, results, nextCursor, hasMore, cursorStatus } = message.payload;
         const query = this.queries.get(queryId);
         if (query) {
           query.onResult(results, "server");
+          query.updatePaginationInfo({ nextCursor, hasMore, cursorStatus });
         }
         break;
       }
@@ -2493,7 +2494,8 @@ var _SyncEngine = class _SyncEngine {
         where: filter.where,
         sort: filter.sort,
         limit: filter.limit,
-        offset: filter.offset
+        cursor: filter.cursor
+        // Phase 14.1: replaces offset
       }
     });
   }
@@ -2566,9 +2568,6 @@ var _SyncEngine = class _SyncEngine {
       });
     }
     let sliced = results;
-    if (filter.offset) {
-      sliced = sliced.slice(filter.offset);
-    }
     if (filter.limit) {
       sliced = sliced.slice(0, filter.limit);
     }
@@ -2581,6 +2580,11 @@ var _SyncEngine = class _SyncEngine {
     const query = this.hybridQueries.get(payload.subscriptionId);
     if (query) {
       query.onResult(payload.results, "server");
+      query.updatePaginationInfo({
+        nextCursor: payload.nextCursor,
+        hasMore: payload.hasMore,
+        cursorStatus: payload.cursorStatus
+      });
     }
   }
   /**
@@ -2703,6 +2707,9 @@ var QueryHandle = class {
     this.changeTracker = new ChangeTracker();
     this.pendingChanges = [];
     this.changeListeners = /* @__PURE__ */ new Set();
+    // Pagination info (Phase 14.1)
+    this._paginationInfo = { hasMore: false, cursorStatus: "none" };
+    this.paginationListeners = /* @__PURE__ */ new Set();
     // Track if we've received authoritative server response
     this.hasReceivedServerData = false;
     this.id = crypto.randomUUID();
@@ -2896,6 +2903,49 @@ var QueryHandle = class {
   getMapName() {
     return this.mapName;
   }
+  // ============== Pagination Methods (Phase 14.1) ==============
+  /**
+   * Get current pagination info.
+   * Returns nextCursor, hasMore, and cursorStatus.
+   */
+  getPaginationInfo() {
+    return { ...this._paginationInfo };
+  }
+  /**
+   * Subscribe to pagination info changes.
+   * Called when server sends QUERY_RESP with new cursor info.
+   *
+   * @returns Unsubscribe function
+   */
+  onPaginationChange(listener) {
+    this.paginationListeners.add(listener);
+    listener(this.getPaginationInfo());
+    return () => this.paginationListeners.delete(listener);
+  }
+  /**
+   * Update pagination info from server response.
+   * Called by SyncEngine when processing QUERY_RESP.
+   *
+   * @internal
+   */
+  updatePaginationInfo(info) {
+    this._paginationInfo = {
+      nextCursor: info.nextCursor,
+      hasMore: info.hasMore ?? false,
+      cursorStatus: info.cursorStatus ?? "none"
+    };
+    this.notifyPaginationListeners();
+  }
+  notifyPaginationListeners() {
+    const info = this.getPaginationInfo();
+    for (const listener of this.paginationListeners) {
+      try {
+        listener(info);
+      } catch (e) {
+        logger.error({ err: e }, "QueryHandle pagination listener error");
+      }
+    }
+  }
 };
 
 // src/DistributedLock.ts
@@ -3487,6 +3537,9 @@ var HybridQueryHandle = class {
     this.changeListeners = /* @__PURE__ */ new Set();
     // Track server data reception
     this.hasReceivedServerData = false;
+    // Pagination info (Phase 14.1)
+    this._paginationInfo = { hasMore: false, cursorStatus: "none" };
+    this.paginationListeners = /* @__PURE__ */ new Set();
     this.id = crypto.randomUUID();
     this.syncEngine = syncEngine;
     this.mapName = mapName;
@@ -3669,9 +3722,6 @@ var HybridQueryHandle = class {
       });
     }
     let sliced = results;
-    if (this.filter.offset) {
-      sliced = sliced.slice(this.filter.offset);
-    }
     if (this.filter.limit) {
       sliced = sliced.slice(0, this.filter.limit);
     }
@@ -3704,6 +3754,49 @@ var HybridQueryHandle = class {
     }
     return false;
   }
+  // ============== Pagination Methods (Phase 14.1) ==============
+  /**
+   * Get current pagination info.
+   * Returns nextCursor, hasMore, and cursorStatus.
+   */
+  getPaginationInfo() {
+    return { ...this._paginationInfo };
+  }
+  /**
+   * Subscribe to pagination info changes.
+   * Called when server sends HYBRID_QUERY_RESP with new cursor info.
+   *
+   * @returns Unsubscribe function
+   */
+  onPaginationChange(listener) {
+    this.paginationListeners.add(listener);
+    listener(this.getPaginationInfo());
+    return () => this.paginationListeners.delete(listener);
+  }
+  /**
+   * Update pagination info from server response.
+   * Called by SyncEngine when processing HYBRID_QUERY_RESP.
+   *
+   * @internal
+   */
+  updatePaginationInfo(info) {
+    this._paginationInfo = {
+      nextCursor: info.nextCursor,
+      hasMore: info.hasMore ?? false,
+      cursorStatus: info.cursorStatus ?? "none"
+    };
+    this.notifyPaginationListeners();
+  }
+  notifyPaginationListeners() {
+    const info = this.getPaginationInfo();
+    for (const listener of this.paginationListeners) {
+      try {
+        listener(info);
+      } catch (e) {
+        logger.error({ err: e }, "HybridQueryHandle pagination listener error");
+      }
+    }
+  }
 };
 
 // src/cluster/ClusterClient.ts
@@ -5610,7 +5703,7 @@ var TopGunClient = class {
    * Results include relevance scores for FTS ranking.
    *
    * @param mapName Name of the map to query
-   * @param filter Hybrid query filter with predicate, where, sort, limit, offset
+   * @param filter Hybrid query filter with predicate, where, sort, limit, cursor
    * @returns HybridQueryHandle for managing the subscription
    *
    * @example