@multiplatform.one/frappe 6.1.0 → 6.3.0

package/dist/cjs/sync/virtualPageManager.spec.cjs

@@ -1,801 +0,0 @@
-var import_vitest = require("vitest");
-var import_normalizedCache = require("./normalizedCache.cjs");
-var import_types = require("./types.cjs");
-var import_virtualPageManager = require("./virtualPageManager.cjs");
-function getCache(sub) {
-  return sub.progressiveCache;
-}
-function setCache(sub, patch) {
-  const cache = sub.progressiveCache;
-  Object.assign(cache, patch);
-}
-(0, import_vitest.describe)("VirtualPageManager", () => {
-  let virtualPageManager;
-  let mockNormalizedCache;
-  let mockDb;
-  const mockDocs = Array.from({
-    length: 100
-  }, (_, i) => ({
-    name: `doc-${i}`,
-    doctype: "TestDoc",
-    owner: "user",
-    modified: new Date(2024, 0, 1, 0, 0, i).toISOString(),
-    creation: new Date(2024, 0, 1).toISOString(),
-    modified_by: "user",
-    value: i,
-    title: `Document ${i}`
-  }));
-  (0, import_vitest.beforeEach)(() => {
-    mockNormalizedCache = {
-      get: import_vitest.vi.fn(({
-        name
-      }) => {
-        const doc = mockDocs.find(d => d.name === name);
-        return doc || null;
-      }),
-      upsert: import_vitest.vi.fn(),
-      delete: import_vitest.vi.fn(),
-      clear: import_vitest.vi.fn(),
-      getAll: import_vitest.vi.fn(),
-      hasDoc: import_vitest.vi.fn(),
-      getAllByDoctype: import_vitest.vi.fn(),
-      batchUpsert: import_vitest.vi.fn(),
-      batchDelete: import_vitest.vi.fn(),
-      clearByDoctype: import_vitest.vi.fn(),
-      size: import_vitest.vi.fn(),
-      sizeByDoctype: import_vitest.vi.fn()
-    };
-    mockDb = {
-      getDocList: import_vitest.vi.fn(async (doctype, options) => {
-        const limit = options?.limit || 20;
-        let start = options?.limitStart || 0;
-        if (options?.cursor) {
-          const cursorIdx = mockDocs.findIndex(d => d.name === options.cursor);
-          if (cursorIdx >= 0) start = cursorIdx + 1;
-        }
-        const result = mockDocs.slice(start, start + limit);
-        if (options?.orderBy?.order === "desc") {
-          return result.reverse();
-        }
-        return result;
-      }),
-      getCount: import_vitest.vi.fn(async () => mockDocs.length),
-      getDoc: import_vitest.vi.fn(),
-      createDoc: import_vitest.vi.fn(),
-      updateDoc: import_vitest.vi.fn(),
-      deleteDoc: import_vitest.vi.fn()
-    };
-    virtualPageManager = new import_virtualPageManager.VirtualPageManager(mockNormalizedCache, mockDb, {
-      batchSize: 50
-    });
-  });
-  (0, import_vitest.describe)("initializeSubscription", () => {
-    (0, import_vitest.it)("should initialize a subscription with progressive cache", async () => {
-      const query = {
-        doctype: "TestDoc",
-        limit: 20,
-        orderBy: {
-          field: "modified",
-          order: import_types.Order.Asc
-        }
-      };
-      const subscription = await virtualPageManager.initializeSubscription("sub-1", query);
-      (0, import_vitest.expect)(subscription).toBeDefined();
-      (0, import_vitest.expect)(subscription.id).toBe("sub-1");
-      (0, import_vitest.expect)(subscription.query).toEqual(query);
-      (0, import_vitest.expect)(getCache(subscription)).toBeDefined();
-      (0, import_vitest.expect)(getCache(subscription).docIds).toHaveLength(50);
-      (0, import_vitest.expect)(subscription.viewWindow.pageSize).toBe(20);
-      (0, import_vitest.expect)(subscription.viewWindow.currentPage).toBe(1);
-    });
-    (0, import_vitest.it)("should fetch initial batch of documents", async () => {
-      const query = {
-        doctype: "TestDoc",
-        limit: 10
-      };
-      await virtualPageManager.initializeSubscription("sub-2", query);
-      (0, import_vitest.expect)(mockDb.getDocList).toHaveBeenCalledWith("TestDoc", {
-        fields: void 0,
-        filters: void 0,
-        orderBy: void 0,
-        cursor: void 0,
-        limit: 50
-      });
-    });
-    (0, import_vitest.it)("should store subscription for later retrieval", async () => {
-      const query = {
-        doctype: "TestDoc",
-        limit: 20
-      };
-      await virtualPageManager.initializeSubscription("sub-3", query);
-      const subscription = virtualPageManager.getSubscription("sub-3");
-      (0, import_vitest.expect)(subscription).toBeDefined();
-      (0, import_vitest.expect)(subscription?.id).toBe("sub-3");
-    });
-  });
-  (0, import_vitest.describe)("getPage", () => {
-    (0, import_vitest.it)("should return documents for requested page", async () => {
-      const query = {
-        doctype: "TestDoc",
-        limit: 10
-      };
-      await virtualPageManager.initializeSubscription("sub-4", query);
-      const page = await virtualPageManager.getPage("sub-4", 1);
-      (0, import_vitest.expect)(page).toHaveLength(10);
-      (0, import_vitest.expect)(page[0].name).toBe("doc-0");
-      (0, import_vitest.expect)(page[9].name).toBe("doc-9");
-    });
-    (0, import_vitest.it)("should update current page in view window", async () => {
-      const query = {
-        doctype: "TestDoc",
-        limit: 10
-      };
-      await virtualPageManager.initializeSubscription("sub-5", query);
-      await virtualPageManager.getPage("sub-5", 3);
-      const subscription = virtualPageManager.getSubscription("sub-5");
-      (0, import_vitest.expect)(subscription?.viewWindow.currentPage).toBe(3);
-    });
-    (0, import_vitest.it)("should fetch more data when accessing pages beyond cache", async () => {
-      const query = {
-        doctype: "TestDoc",
-        limit: 10
-      };
-      await virtualPageManager.initializeSubscription("sub-6", query);
-      const page = await virtualPageManager.getPage("sub-6", 7);
-      (0, import_vitest.expect)(mockDb.getDocList).toHaveBeenCalledTimes(2);
-      (0, import_vitest.expect)(page).toHaveLength(10);
-      (0, import_vitest.expect)(page[0].name).toBe("doc-60");
-    });
-    (0, import_vitest.it)("should return empty array for non-existent subscription", async () => {
-      const page = await virtualPageManager.getPage("non-existent", 1);
-      (0, import_vitest.expect)(page).toEqual([]);
-    });
-  });
-  (0, import_vitest.describe)("getNextBatch", () => {
-    (0, import_vitest.it)("should return documents after cursor", async () => {
-      const query = {
-        doctype: "TestDoc",
-        limit: 20
-      };
-      await virtualPageManager.initializeSubscription("sub-7", query);
-      const docs = await virtualPageManager.getNextBatch("sub-7", "doc-10", 5);
-      (0, import_vitest.expect)(docs).toHaveLength(5);
-      (0, import_vitest.expect)(docs[0].name).toBe("doc-11");
-      (0, import_vitest.expect)(docs[4].name).toBe("doc-15");
-    });
-    (0, import_vitest.it)("should return empty array if cursor not found", async () => {
-      const query = {
-        doctype: "TestDoc",
-        limit: 20
-      };
-      await virtualPageManager.initializeSubscription("sub-8", query);
-      const docs = await virtualPageManager.getNextBatch("sub-8", "non-existent", 5);
-      (0, import_vitest.expect)(docs).toEqual([]);
-    });
-    (0, import_vitest.it)("should fetch more data if needed", async () => {
-      const query = {
-        doctype: "TestDoc",
-        limit: 10
-      };
-      await virtualPageManager.initializeSubscription("sub-9", query);
-      const docs = await virtualPageManager.getNextBatch("sub-9", "doc-45", 10);
-      (0, import_vitest.expect)(docs).toHaveLength(10);
-      (0, import_vitest.expect)(docs[0].name).toBe("doc-46");
-      (0, import_vitest.expect)(docs[9].name).toBe("doc-55");
-    });
-  });
-  (0, import_vitest.describe)("getPageInfo", () => {
-    (0, import_vitest.it)("should return correct page information", async () => {
-      const query = {
-        doctype: "TestDoc",
-        limit: 10
-      };
-      await virtualPageManager.initializeSubscription("sub-10", query);
-      const pageInfo = virtualPageManager.getPageInfo("sub-10");
-      (0, import_vitest.expect)(pageInfo.currentPage).toBe(1);
-      (0, import_vitest.expect)(pageInfo.pageSize).toBe(10);
-      (0, import_vitest.expect)(pageInfo.itemsInCache).toBe(50);
-      (0, import_vitest.expect)(pageInfo.knownPages).toBe(5);
-      (0, import_vitest.expect)(pageInfo.hasMore).toBe(true);
-    });
-    (0, import_vitest.it)("should return default info for non-existent subscription", () => {
-      const pageInfo = virtualPageManager.getPageInfo("non-existent");
-      (0, import_vitest.expect)(pageInfo.currentPage).toBe(1);
-      (0, import_vitest.expect)(pageInfo.knownPages).toBe(0);
-      (0, import_vitest.expect)(pageInfo.totalPages).toBe("unknown");
-      (0, import_vitest.expect)(pageInfo.hasMore).toBe(false);
-      (0, import_vitest.expect)(pageInfo.itemsInCache).toBe(0);
-      (0, import_vitest.expect)(pageInfo.pageSize).toBe(20);
-    });
-    (0, import_vitest.it)("should calculate total pages when count is known", async () => {
-      const query = {
-        doctype: "TestDoc",
-        limit: 15
-      };
-      await virtualPageManager.initializeSubscription("sub-11", query);
-      const subscription = virtualPageManager.getSubscription("sub-11");
-      if (subscription) {
-        setCache(subscription, {
-          totalCount: 100
-        });
-      }
-      const pageInfo = virtualPageManager.getPageInfo("sub-11");
-      (0, import_vitest.expect)(pageInfo.totalPages).toBe(7);
-    });
-  });
-  (0, import_vitest.describe)("getTotalPages", () => {
-    (0, import_vitest.it)("should return total pages when all data is fetched", async () => {
-      const query = {
-        doctype: "TestDoc",
-        limit: 100
-      };
-      await virtualPageManager.initializeSubscription("sub-12", query);
-      const subscription = virtualPageManager.getSubscription("sub-12");
-      if (subscription) {
-        setCache(subscription, {
-          hasMore: false,
-          docIds: mockDocs.map(d => d.name)
-        });
-      }
-      const totalPages = await virtualPageManager.getTotalPages("sub-12");
-      (0, import_vitest.expect)(totalPages).toBe(1);
-    });
-    (0, import_vitest.it)("should fetch count from server when needed", async () => {
-      const query = {
-        doctype: "TestDoc",
-        limit: 10
-      };
-      await virtualPageManager.initializeSubscription("sub-13", query);
-      const totalPages = await virtualPageManager.getTotalPages("sub-13");
-      (0, import_vitest.expect)(mockDb.getCount).toHaveBeenCalledWith("TestDoc", void 0);
-      (0, import_vitest.expect)(totalPages).toBe(10);
-    });
-    (0, import_vitest.it)("should return unknown for non-existent subscription", async () => {
-      const totalPages = await virtualPageManager.getTotalPages("non-existent");
-      (0, import_vitest.expect)(totalPages).toBe("unknown");
-    });
-  });
-  (0, import_vitest.describe)("determineOptimisticPlacement", () => {
-    (0, import_vitest.it)("should determine WITHIN_RANGE placement correctly", async () => {
-      const query = {
-        doctype: "TestDoc",
-        limit: 20,
-        orderBy: {
-          field: "value",
-          order: import_types.Order.Asc
-        }
-      };
-      await virtualPageManager.initializeSubscription("sub-14", query);
-      const subscription = virtualPageManager.getSubscription("sub-14");
-      const newDoc = {
-        name: "new-doc",
-        doctype: "TestDoc",
-        value: 25,
-        owner: "user",
-        modified: (/* @__PURE__ */new Date()).toISOString(),
-        creation: (/* @__PURE__ */new Date()).toISOString(),
-        modified_by: "user"
-      };
-      const placement = virtualPageManager.determineOptimisticPlacement(subscription, newDoc);
-      (0, import_vitest.expect)(placement.strategy).toBe(import_virtualPageManager.PlacementStrategy.WithinRange);
-      (0, import_vitest.expect)(placement.position).toBeDefined();
-      (0, import_vitest.expect)(placement.position).toBeGreaterThanOrEqual(25);
-      (0, import_vitest.expect)(placement.position).toBeLessThanOrEqual(26);
-    });
-    (0, import_vitest.it)("should determine BEFORE_RANGE placement", async () => {
-      const query = {
-        doctype: "TestDoc",
-        limit: 20,
-        orderBy: {
-          field: "value",
-          order: import_types.Order.Asc
-        }
-      };
-      await virtualPageManager.initializeSubscription("sub-15", query);
-      const subscription = virtualPageManager.getSubscription("sub-15");
-      const newDoc = {
-        name: "new-doc",
-        doctype: "TestDoc",
-        value: -1,
-        owner: "user",
-        modified: (/* @__PURE__ */new Date()).toISOString(),
-        creation: (/* @__PURE__ */new Date()).toISOString(),
-        modified_by: "user"
-      };
-      const placement = virtualPageManager.determineOptimisticPlacement(subscription, newDoc);
-      (0, import_vitest.expect)(placement.strategy).toBe(import_virtualPageManager.PlacementStrategy.BeforeRange);
-    });
-    (0, import_vitest.it)("should determine AFTER_RANGE placement", async () => {
-      const query = {
-        doctype: "TestDoc",
-        limit: 20,
-        orderBy: {
-          field: "value",
-          order: import_types.Order.Asc
-        }
-      };
-      await virtualPageManager.initializeSubscription("sub-16", query);
-      const subscription = virtualPageManager.getSubscription("sub-16");
-      const newDoc = {
-        name: "new-doc",
-        doctype: "TestDoc",
-        value: 200,
-        owner: "user",
-        modified: (/* @__PURE__ */new Date()).toISOString(),
-        creation: (/* @__PURE__ */new Date()).toISOString(),
-        modified_by: "user"
-      };
-      const placement = virtualPageManager.determineOptimisticPlacement(subscription, newDoc);
-      (0, import_vitest.expect)(placement.strategy).toBe(import_virtualPageManager.PlacementStrategy.AfterRange);
-    });
-    (0, import_vitest.it)("should return UNCERTAIN when no sort field", async () => {
-      const query = {
-        doctype: "TestDoc",
-        limit: 20
-      };
-      await virtualPageManager.initializeSubscription("sub-17", query);
-      const subscription = virtualPageManager.getSubscription("sub-17");
-      const newDoc = {
-        name: "new-doc",
-        doctype: "TestDoc",
-        owner: "user",
-        modified: (/* @__PURE__ */new Date()).toISOString(),
-        creation: (/* @__PURE__ */new Date()).toISOString(),
-        modified_by: "user"
-      };
-      const placement = virtualPageManager.determineOptimisticPlacement(subscription, newDoc);
-      (0, import_vitest.expect)(placement.strategy).toBe(import_virtualPageManager.PlacementStrategy.Uncertain);
-    });
-    (0, import_vitest.it)("should handle DESC order correctly", async () => {
-      const query = {
-        doctype: "TestDoc",
-        limit: 20,
-        orderBy: {
-          field: "value",
-          order: import_types.Order.Desc
-        }
-      };
-      await virtualPageManager.initializeSubscription("sub-18", query);
-      const subscription = virtualPageManager.getSubscription("sub-18");
-      setCache(subscription, {
-        docIds: mockDocs.slice(0, 50).reverse().map(d => d.name)
-      });
-      const newDoc = {
-        name: "new-doc",
-        doctype: "TestDoc",
-        value: 200,
-        owner: "user",
-        modified: (/* @__PURE__ */new Date()).toISOString(),
-        creation: (/* @__PURE__ */new Date()).toISOString(),
-        modified_by: "user"
-      };
-      const placement = virtualPageManager.determineOptimisticPlacement(subscription, newDoc);
-      (0, import_vitest.expect)(placement.strategy).toBe(import_virtualPageManager.PlacementStrategy.BeforeRange);
-    });
-  });
-  (0, import_vitest.describe)("handleRemoteCreate", () => {
-    (0, import_vitest.it)("should add document in correct position", async () => {
-      const query = {
-        doctype: "TestDoc",
-        limit: 20,
-        orderBy: {
-          field: "value",
-          order: import_types.Order.Asc
-        }
-      };
-      await virtualPageManager.initializeSubscription("sub-19", query);
-      const newDoc = {
-        name: "new-doc",
-        doctype: "TestDoc",
-        value: 25,
-        owner: "user",
-        modified: (/* @__PURE__ */new Date()).toISOString(),
-        creation: (/* @__PURE__ */new Date()).toISOString(),
-        modified_by: "user"
-      };
-      const result = await virtualPageManager.handleRemoteCreate("sub-19", newDoc);
-      const subscription = virtualPageManager.getSubscription("sub-19");
-      (0, import_vitest.expect)(result).toBe(true);
-      (0, import_vitest.expect)(getCache(subscription).docIds).toContain("new-doc");
-    });
-    (0, import_vitest.it)("should handle BEFORE_RANGE placement", async () => {
-      const query = {
-        doctype: "TestDoc",
-        limit: 20,
-        orderBy: {
-          field: "value",
-          order: import_types.Order.Asc
-        }
-      };
-      await virtualPageManager.initializeSubscription("sub-20", query);
-      const newDoc = {
-        name: "new-doc",
-        doctype: "TestDoc",
-        value: -1,
-        owner: "user",
-        modified: (/* @__PURE__ */new Date()).toISOString(),
-        creation: (/* @__PURE__ */new Date()).toISOString(),
-        modified_by: "user"
-      };
-      const result = await virtualPageManager.handleRemoteCreate("sub-20", newDoc);
-      const subscription = virtualPageManager.getSubscription("sub-20");
-      (0, import_vitest.expect)(result).toBe(true);
-      (0, import_vitest.expect)(getCache(subscription).docIds[0]).toBe("new-doc");
-    });
-    (0, import_vitest.it)("should handle UNCERTAIN placement", async () => {
-      const query = {
-        doctype: "TestDoc",
-        limit: 20
-      };
-      await virtualPageManager.initializeSubscription("sub-21", query);
-      const newDoc = {
-        name: "new-doc",
-        doctype: "TestDoc",
-        owner: "user",
-        modified: (/* @__PURE__ */new Date()).toISOString(),
-        creation: (/* @__PURE__ */new Date()).toISOString(),
-        modified_by: "user"
-      };
-      const result = await virtualPageManager.handleRemoteCreate("sub-21", newDoc);
-      const subscription = virtualPageManager.getSubscription("sub-21");
-      (0, import_vitest.expect)(result).toBe(false);
-      (0, import_vitest.expect)(subscription.needsRehydration).toBe(true);
-    });
-  });
-  (0, import_vitest.describe)("handleRemoteDelete", () => {
-    (0, import_vitest.it)("should remove document from cache", async () => {
-      const query = {
-        doctype: "TestDoc",
-        limit: 20
-      };
-      await virtualPageManager.initializeSubscription("sub-22", query);
-      const result = await virtualPageManager.handleRemoteDelete("sub-22", "doc-10");
-      const subscription = virtualPageManager.getSubscription("sub-22");
-      (0, import_vitest.expect)(result).toBe(true);
-      (0, import_vitest.expect)(getCache(subscription).docIds).not.toContain("doc-10");
-      (0, import_vitest.expect)(subscription.pendingBackfill).toBe(true);
-    });
-    (0, import_vitest.it)("should return false for non-existent document", async () => {
-      const query = {
-        doctype: "TestDoc",
-        limit: 20
-      };
-      await virtualPageManager.initializeSubscription("sub-23", query);
-      const result = await virtualPageManager.handleRemoteDelete("sub-23", "non-existent");
-      (0, import_vitest.expect)(result).toBe(false);
-    });
-  });
-  (0, import_vitest.describe)("handleRemoteUpdate", () => {
-    (0, import_vitest.it)("should update document position when sort value changes", async () => {
-      const query = {
-        doctype: "TestDoc",
-        limit: 20,
-        orderBy: {
-          field: "value",
-          order: import_types.Order.Asc
-        }
-      };
-      await virtualPageManager.initializeSubscription("sub-24", query);
-      const updatedDoc = {
-        name: "doc-10",
-        doctype: "TestDoc",
-        value: 45,
-        owner: "user",
-        modified: (/* @__PURE__ */new Date()).toISOString(),
-        creation: (/* @__PURE__ */new Date()).toISOString(),
-        modified_by: "user"
-      };
-      const result = await virtualPageManager.handleRemoteUpdate("sub-24", updatedDoc);
-      const subscription = virtualPageManager.getSubscription("sub-24");
-      (0, import_vitest.expect)(result).toBe(true);
-      const index = getCache(subscription).docIds.indexOf("doc-10");
-      (0, import_vitest.expect)(index).toBeGreaterThan(10);
-    });
-    (0, import_vitest.it)("should handle document not in cache", async () => {
-      const query = {
-        doctype: "TestDoc",
-        limit: 20,
-        orderBy: {
-          field: "value",
-          order: import_types.Order.Asc
-        }
-      };
-      await virtualPageManager.initializeSubscription("sub-25", query);
-      const updatedDoc = {
-        name: "doc-200",
-        doctype: "TestDoc",
-        value: 999,
-        owner: "user",
-        modified: (/* @__PURE__ */new Date()).toISOString(),
-        creation: (/* @__PURE__ */new Date()).toISOString(),
-        modified_by: "user"
-      };
-      const result = await virtualPageManager.handleRemoteUpdate("sub-25", updatedDoc);
-      (0, import_vitest.expect)(result).toBe(false);
-    });
-    (0, import_vitest.it)("should not reposition if sort value unchanged", async () => {
-      const query = {
-        doctype: "TestDoc",
-        limit: 20,
-        orderBy: {
-          field: "value",
-          order: import_types.Order.Asc
-        }
-      };
-      await virtualPageManager.initializeSubscription("sub-26", query);
-      const subscription = virtualPageManager.getSubscription("sub-26");
-      const originalIndex = getCache(subscription).docIds.indexOf("doc-10");
-      const updatedDoc = {
-        name: "doc-10",
-        doctype: "TestDoc",
-        value: 10,
-        title: "Updated Title",
-        owner: "user",
-        modified: (/* @__PURE__ */new Date()).toISOString(),
-        creation: (/* @__PURE__ */new Date()).toISOString(),
-        modified_by: "user"
-      };
-      const result = await virtualPageManager.handleRemoteUpdate("sub-26", updatedDoc);
-      const newIndex = getCache(subscription).docIds.indexOf("doc-10");
-      (0, import_vitest.expect)(result).toBe(true);
-      (0, import_vitest.expect)(newIndex).toBe(originalIndex);
-    });
-  });
-  (0, import_vitest.describe)("invalidateCache", () => {
-    (0, import_vitest.it)("should clear page cache and increment generation", async () => {
-      const query = {
-        doctype: "TestDoc",
-        limit: 20
-      };
-      await virtualPageManager.initializeSubscription("sub-27", query);
-      const system = virtualPageManager;
-      const initialGeneration = system.cacheGeneration;
-      virtualPageManager.invalidateCache();
-      (0, import_vitest.expect)(system.cacheGeneration).toBe(initialGeneration + 1);
-      (0, import_vitest.expect)(system.pageCache.size).toBe(0);
-    });
-  });
-  (0, import_vitest.describe)("updateProgressiveCache", () => {
-    (0, import_vitest.it)("should update subscription cache", async () => {
-      const query = {
-        doctype: "TestDoc",
-        limit: 20
-      };
-      await virtualPageManager.initializeSubscription("sub-28", query);
-      const newDocIds = ["doc-100", "doc-101", "doc-102"];
-      virtualPageManager.updateProgressiveCache("sub-28", newDocIds, "cursor-102", false);
-      const subscription = virtualPageManager.getSubscription("sub-28");
-      (0, import_vitest.expect)(getCache(subscription).docIds).toEqual(newDocIds);
-      (0, import_vitest.expect)(getCache(subscription).nextCursor).toBe("cursor-102");
-      (0, import_vitest.expect)(getCache(subscription).hasMore).toBe(false);
-    });
-    (0, import_vitest.it)("should handle non-existent subscription", () => {
-      (0, import_vitest.expect)(() => {
-        virtualPageManager.updateProgressiveCache("non-existent", [], null, false);
-      }).not.toThrow();
-    });
-  });
-  (0, import_vitest.describe)("hybrid pagination", () => {
-    const pageSize = 20;
-    function createMockDbForHybrid() {
-      const getDocList = import_vitest.vi.fn().mockImplementation(async (_doctype, options) => {
-        const limit = options?.limit || pageSize;
-        let start;
-        if (options?.limitStart !== void 0 && options?.limitStart !== null) {
-          start = options.limitStart;
-        } else if (options?.cursor) {
-          const match = String(options.cursor).match(/doc-(\d+)/);
-          start = match ? Number.parseInt(match[1], 10) + 1 : 0;
-        } else {
-          start = 0;
-        }
-        return Array.from({
-          length: limit
-        }, (_, i) => ({
-          name: `doc-${start + i}`,
-          doctype: "TestDoc",
-          modified: "2026-01-01 00:00:00"
-        }));
-      });
-      return {
-        getDocList,
-        getCount: import_vitest.vi.fn().mockResolvedValue(1e3),
-        getDoc: import_vitest.vi.fn(),
-        createDoc: import_vitest.vi.fn(),
-        updateDoc: import_vitest.vi.fn(),
-        deleteDoc: import_vitest.vi.fn()
-      };
-    }
-    (0, import_vitest.beforeEach)(() => {
-      mockNormalizedCache = new import_normalizedCache.NormalizedCache();
-      mockDb = createMockDbForHybrid();
-      virtualPageManager = new import_virtualPageManager.VirtualPageManager(mockNormalizedCache, mockDb, {
-        batchSize: 100
-      });
-    });
-    (0, import_vitest.it)("sequential page access uses cursor-based fetch", async () => {
-      const query = {
-        doctype: "TestDoc",
-        limit: pageSize
-      };
-      await virtualPageManager.initializeSubscription("sub-h1", query);
-      await virtualPageManager.getPage("sub-h1", 1);
-      await virtualPageManager.getPage("sub-h1", 2);
-      const calls = mockDb.getDocList.mock.calls;
-      for (const [, options] of calls) {
-        (0, import_vitest.expect)(options).not.toHaveProperty("limitStart");
-      }
-    });
-    (0, import_vitest.it)("non-contiguous page jump uses offset-based fetch", async () => {
-      const query = {
-        doctype: "TestDoc",
-        limit: pageSize
-      };
-      await virtualPageManager.initializeSubscription("sub-h2", query);
-      await virtualPageManager.getPage("sub-h2", 1);
-      await virtualPageManager.getPage("sub-h2", 50);
-      const calls = mockDb.getDocList.mock.calls;
-      const offsetCall = calls.find(call => call[1]?.limitStart === (50 - 1) * pageSize);
-      (0, import_vitest.expect)(offsetCall).toBeDefined();
-      (0, import_vitest.expect)(offsetCall[1]).toMatchObject({
-        limitStart: 980,
-        limit: pageSize
-      });
-    });
-    (0, import_vitest.it)("after offset jump, contiguous access uses cursor", async () => {
-      const query = {
-        doctype: "TestDoc",
-        limit: pageSize
-      };
-      await virtualPageManager.initializeSubscription("sub-h3", query);
-      await virtualPageManager.getPage("sub-h3", 1);
-      await virtualPageManager.getPage("sub-h3", 50);
-      mockDb.getDocList.mockClear();
-      await virtualPageManager.getPage("sub-h3", 51);
-      const calls = mockDb.getDocList.mock.calls;
-      (0, import_vitest.expect)(calls.length).toBeGreaterThan(0);
-      for (const [, options] of calls) {
-        (0, import_vitest.expect)(options).not.toHaveProperty("limitStart");
-      }
-    });
-    (0, import_vitest.it)("gap placeholders after offset jump", async () => {
-      const query = {
-        doctype: "TestDoc",
-        limit: pageSize
-      };
-      await virtualPageManager.initializeSubscription("sub-h4", query);
-      await virtualPageManager.getPage("sub-h4", 1);
-      await virtualPageManager.getPage("sub-h4", 50);
-      const subscription = virtualPageManager.getSubscription("sub-h4");
-      const docIds = getCache(subscription).docIds;
-      const limitStart = (50 - 1) * pageSize;
-      (0, import_vitest.expect)(docIds.length).toBeGreaterThanOrEqual(limitStart + pageSize);
-      const gapRange = docIds.slice(pageSize, limitStart);
-      (0, import_vitest.expect)(gapRange.some(id => id === "")).toBe(true);
-      (0, import_vitest.expect)(docIds[limitStart]).not.toBe("");
-      (0, import_vitest.expect)(docIds.slice(limitStart, limitStart + pageSize).every(id => id !== "")).toBe(true);
-    });
-    (0, import_vitest.it)("mapIdsToDocuments filters gaps", async () => {
-      const query = {
-        doctype: "TestDoc",
-        limit: pageSize
-      };
-      await virtualPageManager.initializeSubscription("sub-h5", query);
-      await virtualPageManager.getPage("sub-h5", 1);
-      await virtualPageManager.getPage("sub-h5", 50);
-      const page = await virtualPageManager.getPage("sub-h5", 50);
-      (0, import_vitest.expect)(page.every(doc => doc !== void 0 && doc !== null)).toBe(true);
-      (0, import_vitest.expect)(page.length).toBe(pageSize);
-      (0, import_vitest.expect)(page[0].name).toBe("doc-980");
-    });
-    (0, import_vitest.it)("getPageIslands returns correct islands", async () => {
-      const query = {
-        doctype: "TestDoc",
-        limit: pageSize
-      };
-      await virtualPageManager.initializeSubscription("sub-h6", query);
-      await virtualPageManager.getPage("sub-h6", 1);
-      await virtualPageManager.getPage("sub-h6", 50);
-      const islands = virtualPageManager.getPageIslands("sub-h6");
-      (0, import_vitest.expect)(islands.length).toBe(2);
-      const cursorIsland = islands.find(i => i.fetchedVia === "cursor");
-      const offsetIsland = islands.find(i => i.fetchedVia === "offset");
-      (0, import_vitest.expect)(cursorIsland).toBeDefined();
-      (0, import_vitest.expect)(offsetIsland).toBeDefined();
-      (0, import_vitest.expect)(offsetIsland).toMatchObject({
-        startPage: 50,
-        endPage: 50,
-        startIndex: 980,
-        endIndex: 1e3,
-        fetchedVia: "offset"
-      });
-    });
-    (0, import_vitest.it)("island merging when adjacent pages fetched", async () => {
-      const query = {
-        doctype: "TestDoc",
-        limit: pageSize
-      };
-      await virtualPageManager.initializeSubscription("sub-h7", query);
-      await virtualPageManager.getPage("sub-h7", 1);
-      await virtualPageManager.getPage("sub-h7", 2);
-      await virtualPageManager.getPage("sub-h7", 3);
-      const islands = virtualPageManager.getPageIslands("sub-h7");
-      (0, import_vitest.expect)(islands.length).toBe(1);
-      (0, import_vitest.expect)(islands[0].startPage).toBe(1);
-      (0, import_vitest.expect)(islands[0].endPage).toBeGreaterThanOrEqual(3);
-      (0, import_vitest.expect)(islands[0].fetchedVia).toBe("cursor");
-    });
-  });
-  (0, import_vitest.describe)("edge cases and error handling", () => {
-    (0, import_vitest.it)("should handle empty progressive cache", async () => {
-      const query = {
-        doctype: "TestDoc",
-        limit: 20,
-        orderBy: {
-          field: "value",
-          order: import_types.Order.Asc
-        }
-      };
-      await virtualPageManager.initializeSubscription("sub-29", query);
-      const subscription = virtualPageManager.getSubscription("sub-29");
-      setCache(subscription, {
-        docIds: []
-      });
-      const newDoc = {
-        name: "new-doc",
-        doctype: "TestDoc",
-        value: 10,
-        owner: "user",
-        modified: (/* @__PURE__ */new Date()).toISOString(),
-        creation: (/* @__PURE__ */new Date()).toISOString(),
-        modified_by: "user"
-      };
-      const placement = virtualPageManager.determineOptimisticPlacement(subscription, newDoc);
-      (0, import_vitest.expect)(placement.strategy).toBe(import_virtualPageManager.PlacementStrategy.WithinRange);
-      (0, import_vitest.expect)(placement.position).toBe(0);
-    });
-    (0, import_vitest.it)("should handle null values in comparison", async () => {
-      const query = {
-        doctype: "TestDoc",
-        limit: 20,
-        orderBy: {
-          field: "value",
-          order: import_types.Order.Asc
-        }
-      };
-      await virtualPageManager.initializeSubscription("sub-30", query);
-      const subscription = virtualPageManager.getSubscription("sub-30");
-      const newDoc = {
-        name: "new-doc",
-        doctype: "TestDoc",
-        value: null,
-        owner: "user",
-        modified: (/* @__PURE__ */new Date()).toISOString(),
-        creation: (/* @__PURE__ */new Date()).toISOString(),
-        modified_by: "user"
-      };
-      const placement = virtualPageManager.determineOptimisticPlacement(subscription, newDoc);
-      (0, import_vitest.expect)(placement.strategy).toBe(import_virtualPageManager.PlacementStrategy.WithinRange);
-      (0, import_vitest.expect)(placement.position).toBe(0);
-    });
-    (0, import_vitest.it)("should limit cache size appropriately", async () => {
-      const query = {
-        doctype: "TestDoc",
-        limit: 10,
-        orderBy: {
-          field: "value",
-          order: import_types.Order.Asc
-        }
-      };
-      await virtualPageManager.initializeSubscription("sub-31", query);
-      const subscription = virtualPageManager.getSubscription("sub-31");
-      const bigCache = Array.from({
-        length: 1001
-      }, (_, i) => `doc-${i % 100}`);
-      setCache(subscription, {
-        docIds: bigCache
-      });
-      (0, import_vitest.expect)(virtualPageManager.shouldLimitCacheSize(subscription)).toBe(true);
-    });
-  });
-});