@utiliread/primitives 1.0.0-147 → 1.0.0-149

package/src/cursor-navigation-state.spec.ts

@@ -1,194 +1,194 @@
-import { expect } from "chai";
-
-import { CursorNavigationState } from "./cursor-navigation-state";
-
-describe("CursorNavigationState", () => {
-    it("tracks forward navigation and infers totals from the last page", () => {
-        const state = new CursorNavigationState({ limit: 2 });
-
-        state.visitPage("", {
-            items: [1, 2],
-            nextCursor: "page-2",
-            hasMore: true,
-        });
-
-        expect(state.pageNumber).to.equal(1);
-        expect(state.firstItemNumber).to.equal(1);
-        expect(state.lastItemNumber).to.equal(2);
-        expect(state.nextCursor).to.equal("page-2");
-        expect(state.previousCursor).to.equal("");
-        expect(state.currentIsFirst).to.equal(true);
-        expect(state.currentIsLast).to.equal(false);
-        expect(state.toString()).to.equal("1-2 / ?");
-
-        state.visitPage("page-2", {
-            items: [3, 4],
-            nextCursor: "page-3",
-            hasMore: true,
-        });
-
-        expect(state.pageNumber).to.equal(2);
-        expect(state.firstItemNumber).to.equal(3);
-        expect(state.lastItemNumber).to.equal(4);
-        expect(state.nextCursor).to.equal("page-3");
-        expect(state.previousCursor).to.equal("");
-
-        state.visitPage("page-3", {
-            items: [5],
-            nextCursor: null,
-            hasMore: false,
-        });
-
-        expect(state.pageNumber).to.equal(3);
-        expect(state.firstItemNumber).to.equal(5);
-        expect(state.lastItemNumber).to.equal(5);
-        expect(state.totalCount).to.equal(5);
-        expect(state.pageCount).to.equal(3);
-        expect(state.nextCursor).to.equal("page-3");
-        expect(state.previousCursor).to.equal("page-2");
-        expect(state.currentIsLast).to.equal(true);
-        expect(state.toString()).to.equal("5-5 / 5");
-    });
-
-    it("uses the visited cursor chain when navigating back to earlier pages", () => {
-        const state = new CursorNavigationState({ limit: 2 });
-
-        state.visitPage("", {
-            items: [1, 2],
-            nextCursor: "page-2",
-            hasMore: true,
-        });
-        state.visitPage("page-2", {
-            items: [3, 4],
-            nextCursor: "page-3",
-            hasMore: true,
-        });
-        state.visitPage("page-3", {
-            items: [5],
-            nextCursor: null,
-            hasMore: false,
-        });
-
-        state.visitPage("", {
-            items: [1, 2],
-            nextCursor: "page-2",
-            hasMore: true,
-        });
-
-        expect(state.pageNumber).to.equal(1);
-        expect(state.firstItemNumber).to.equal(1);
-        expect(state.lastItemNumber).to.equal(2);
-        expect(state.previousCursor).to.equal("");
-        expect(state.nextCursor).to.equal("page-2");
-        expect(state.currentIsFirst).to.equal(true);
-        expect(state.currentIsLast).to.equal(false);
-        expect(state.totalCount).to.equal(5);
-    });
-
-    it("tracks per-cursor item counts without regressing the future cursor", () => {
-        const state = new CursorNavigationState({ limit: 2 });
-
-        state.visitPage("", {
-            items: [1, 2],
-            nextCursor: "page-2",
-            hasMore: true,
-        });
-
-        state.visitPage("page-2", {
-            items: [3, 4],
-            nextCursor: "page-3",
-            hasMore: true,
-        });
-
-        state.visitPage("", {
-            items: [1],
-            nextCursor: null,
-            hasMore: false,
-        });
-
-        expect(state.firstItemNumber).to.equal(1);
-        expect(state.lastItemNumber).to.equal(1);
-        expect(state.futureCursor).to.equal("page-3");
-        expect(state.nextCursor).to.equal("page-2");
-        expect(state.currentIsLast).to.equal(false);
-        expect(state.totalCount).to.equal(null);
-
-        state.visitPage("page-2", {
-            items: [2],
-            nextCursor: "page-3",
-            hasMore: true,
-        });
-
-        expect(state.firstItemNumber).to.equal(2);
-        expect(state.lastItemNumber).to.equal(2);
-        expect(state.nextCursor).to.equal("page-3");
-
-        state.visitPage("page-3", {
-            items: [3],
-            nextCursor: null,
-            hasMore: false,
-        });
-
-        expect(state.totalCount).to.equal(3);
-        expect(state.pageCount).to.equal(2);
-        expect(state.firstItemNumber).to.equal(3);
-        expect(state.lastItemNumber).to.equal(3);
-        expect(state.currentIsLast).to.equal(true);
-        expect(state.toString()).to.equal("3-3 / 3");
-    });
-
-    it("supports starting from an intermediate cursor with forward-only navigation", () => {
-        const state = new CursorNavigationState({ limit: 2 });
-
-        state.visitPage("page-2", {
-            items: [3, 4],
-            nextCursor: "page-3",
-            hasMore: true,
-        });
-
-        expect(state.pageNumber).to.equal(0);
-        expect(state.firstItemNumber).to.equal(0);
-        expect(state.lastItemNumber).to.equal(0);
-        expect(state.previousCursor).to.equal("");
-        expect(state.nextCursor).to.equal("page-3");
-        expect(state.currentIsFirst).to.equal(false);
-        expect(state.currentIsLast).to.equal(false);
-        expect(state.totalCount).to.equal(null);
-        expect(state.toString()).to.equal("... / ?");
-
-        state.visitPage("page-3", {
-            items: [5],
-            nextCursor: null,
-            hasMore: false,
-        });
-
-        // Still zero/unknown since we never visited the first page
-        expect(state.pageNumber).to.equal(0);
-        expect(state.firstItemNumber).to.equal(0);
-        expect(state.lastItemNumber).to.equal(0);
-        expect(state.previousCursor).to.equal("");
-        expect(state.nextCursor).to.equal("page-3");
-        expect(state.currentIsLast).to.equal(true);
-        expect(state.totalCount).to.equal(null);
-        expect(state.toString()).to.equal("... / ?");
-    });
-
-    it("reports zero-based item ranges for an empty result set", () => {
-        const state = new CursorNavigationState({ limit: 10 });
-
-        state.visitPage("", {
-            items: [],
-            nextCursor: null,
-            hasMore: false,
-        });
-
-        expect(state.pageNumber).to.equal(1);
-        expect(state.pageCount).to.equal(0);
-        expect(state.totalCount).to.equal(0);
-        expect(state.firstItemNumber).to.equal(0);
-        expect(state.lastItemNumber).to.equal(0);
-        expect(state.currentIsFirst).to.equal(true);
-        expect(state.currentIsLast).to.equal(true);
-        expect(state.toString()).to.equal("0-0 / 0");
-    });
-});
+import { expect } from "chai";
+
+import { CursorNavigationState } from "./cursor-navigation-state";
+
+describe("CursorNavigationState", () => {
+    it("tracks forward navigation and infers totals from the last page", () => {
+        const state = new CursorNavigationState({ limit: 2 });
+
+        state.visitPage("", {
+            items: [1, 2],
+            nextCursor: "page-2",
+            hasMore: true,
+        });
+
+        expect(state.pageNumber).to.equal(1);
+        expect(state.firstItemNumber).to.equal(1);
+        expect(state.lastItemNumber).to.equal(2);
+        expect(state.nextCursor).to.equal("page-2");
+        expect(state.previousCursor).to.equal("");
+        expect(state.currentIsFirst).to.equal(true);
+        expect(state.currentIsLast).to.equal(false);
+        expect(state.toString()).to.equal("1-2 / ?");
+
+        state.visitPage("page-2", {
+            items: [3, 4],
+            nextCursor: "page-3",
+            hasMore: true,
+        });
+
+        expect(state.pageNumber).to.equal(2);
+        expect(state.firstItemNumber).to.equal(3);
+        expect(state.lastItemNumber).to.equal(4);
+        expect(state.nextCursor).to.equal("page-3");
+        expect(state.previousCursor).to.equal("");
+
+        state.visitPage("page-3", {
+            items: [5],
+            nextCursor: null,
+            hasMore: false,
+        });
+
+        expect(state.pageNumber).to.equal(3);
+        expect(state.firstItemNumber).to.equal(5);
+        expect(state.lastItemNumber).to.equal(5);
+        expect(state.totalCount).to.equal(5);
+        expect(state.pageCount).to.equal(3);
+        expect(state.nextCursor).to.equal("page-3");
+        expect(state.previousCursor).to.equal("page-2");
+        expect(state.currentIsLast).to.equal(true);
+        expect(state.toString()).to.equal("5-5 / 5");
+    });
+
+    it("uses the visited cursor chain when navigating back to earlier pages", () => {
+        const state = new CursorNavigationState({ limit: 2 });
+
+        state.visitPage("", {
+            items: [1, 2],
+            nextCursor: "page-2",
+            hasMore: true,
+        });
+        state.visitPage("page-2", {
+            items: [3, 4],
+            nextCursor: "page-3",
+            hasMore: true,
+        });
+        state.visitPage("page-3", {
+            items: [5],
+            nextCursor: null,
+            hasMore: false,
+        });
+
+        state.visitPage("", {
+            items: [1, 2],
+            nextCursor: "page-2",
+            hasMore: true,
+        });
+
+        expect(state.pageNumber).to.equal(1);
+        expect(state.firstItemNumber).to.equal(1);
+        expect(state.lastItemNumber).to.equal(2);
+        expect(state.previousCursor).to.equal("");
+        expect(state.nextCursor).to.equal("page-2");
+        expect(state.currentIsFirst).to.equal(true);
+        expect(state.currentIsLast).to.equal(false);
+        expect(state.totalCount).to.equal(5);
+    });
+
+    it("tracks per-cursor item counts without regressing the future cursor", () => {
+        const state = new CursorNavigationState({ limit: 2 });
+
+        state.visitPage("", {
+            items: [1, 2],
+            nextCursor: "page-2",
+            hasMore: true,
+        });
+
+        state.visitPage("page-2", {
+            items: [3, 4],
+            nextCursor: "page-3",
+            hasMore: true,
+        });
+
+        state.visitPage("", {
+            items: [1],
+            nextCursor: null,
+            hasMore: false,
+        });
+
+        expect(state.firstItemNumber).to.equal(1);
+        expect(state.lastItemNumber).to.equal(1);
+        expect(state.futureCursor).to.equal("page-3");
+        expect(state.nextCursor).to.equal("page-2");
+        expect(state.currentIsLast).to.equal(false);
+        expect(state.totalCount).to.equal(null);
+
+        state.visitPage("page-2", {
+            items: [2],
+            nextCursor: "page-3",
+            hasMore: true,
+        });
+
+        expect(state.firstItemNumber).to.equal(2);
+        expect(state.lastItemNumber).to.equal(2);
+        expect(state.nextCursor).to.equal("page-3");
+
+        state.visitPage("page-3", {
+            items: [3],
+            nextCursor: null,
+            hasMore: false,
+        });
+
+        expect(state.totalCount).to.equal(3);
+        expect(state.pageCount).to.equal(2);
+        expect(state.firstItemNumber).to.equal(3);
+        expect(state.lastItemNumber).to.equal(3);
+        expect(state.currentIsLast).to.equal(true);
+        expect(state.toString()).to.equal("3-3 / 3");
+    });
+
+    it("supports starting from an intermediate cursor with forward-only navigation", () => {
+        const state = new CursorNavigationState({ limit: 2 });
+
+        state.visitPage("page-2", {
+            items: [3, 4],
+            nextCursor: "page-3",
+            hasMore: true,
+        });
+
+        expect(state.pageNumber).to.equal(0);
+        expect(state.firstItemNumber).to.equal(0);
+        expect(state.lastItemNumber).to.equal(0);
+        expect(state.previousCursor).to.equal("");
+        expect(state.nextCursor).to.equal("page-3");
+        expect(state.currentIsFirst).to.equal(false);
+        expect(state.currentIsLast).to.equal(false);
+        expect(state.totalCount).to.equal(null);
+        expect(state.toString()).to.equal("... / ?");
+
+        state.visitPage("page-3", {
+            items: [5],
+            nextCursor: null,
+            hasMore: false,
+        });
+
+        // Still zero/unknown since we never visited the first page
+        expect(state.pageNumber).to.equal(0);
+        expect(state.firstItemNumber).to.equal(0);
+        expect(state.lastItemNumber).to.equal(0);
+        expect(state.previousCursor).to.equal("");
+        expect(state.nextCursor).to.equal("page-3");
+        expect(state.currentIsLast).to.equal(true);
+        expect(state.totalCount).to.equal(null);
+        expect(state.toString()).to.equal("... / ?");
+    });
+
+    it("reports zero-based item ranges for an empty result set", () => {
+        const state = new CursorNavigationState({ limit: 10 });
+
+        state.visitPage("", {
+            items: [],
+            nextCursor: null,
+            hasMore: false,
+        });
+
+        expect(state.pageNumber).to.equal(1);
+        expect(state.pageCount).to.equal(0);
+        expect(state.totalCount).to.equal(0);
+        expect(state.firstItemNumber).to.equal(0);
+        expect(state.lastItemNumber).to.equal(0);
+        expect(state.currentIsFirst).to.equal(true);
+        expect(state.currentIsLast).to.equal(true);
+        expect(state.toString()).to.equal("0-0 / 0");
+    });
+});