@multiplatform.one/frappe 6.0.0

package/dist/esm/sync/mutationJournal.spec.mjs

@@ -0,0 +1,331 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { MutationJournal, frappeSyncSequence } from "./mutationJournal.mjs";
+import { Operation, Status } from "./types.mjs";
+describe("MutationJournal", () => {
+  let journal;
+  beforeEach(() => {
+    vi.useFakeTimers();
+  });
+  afterEach(() => {
+    vi.useRealTimers();
+    if (journal) {
+      journal.dispose();
+    }
+  });
+  describe("basic operations", () => {
+    beforeEach(() => {
+      journal = new MutationJournal({
+        enableAutoCleanup: false
+      });
+    });
+    it("should add a pending entry", () => {
+      const entry = {
+        doctype: "Task",
+        docname: "TASK-001",
+        operation: Operation.Update,
+        status: Status.Pending,
+        values: {
+          doctype: "Task",
+          name: "TASK-001",
+          status: "InProgress"
+        }
+      };
+      journal.add("mut-1", entry);
+      const retrieved = journal.get("mut-1");
+      expect(retrieved).toBeDefined();
+      expect(retrieved?.doctype).toBe("Task");
+      expect(retrieved?.sequence).toBeDefined();
+      expect(retrieved?.createdAt).toBeDefined();
+      expect(retrieved?.ttl).toBeDefined();
+      expect(retrieved?.retryCount).toBe(0);
+    });
+    it("should confirm an entry", () => {
+      const entry = {
+        doctype: "Task",
+        operation: Operation.Create,
+        status: Status.Pending
+      };
+      journal.add("mut-2", entry);
+      journal.confirm("mut-2");
+      const retrieved = journal.get("mut-2");
+      expect(retrieved).toBeUndefined();
+    });
+    it("should fail an entry and increment retry count", () => {
+      const entry = {
+        doctype: "Task",
+        operation: Operation.Update,
+        status: Status.Pending
+      };
+      const error = new Error("Network error");
+      journal.add("mut-3", entry);
+      journal.fail("mut-3", error);
+      const retrieved = journal.get("mut-3");
+      expect(retrieved).toBeDefined();
+      expect(retrieved?.status).toBe(Status.Failed);
+      expect(retrieved?.error).toBe(error);
+      expect(retrieved?.retryCount).toBe(1);
+      journal.fail("mut-3", error);
+      const retrievedAgain = journal.get("mut-3");
+      expect(retrievedAgain?.retryCount).toBe(2);
+    });
+    it("should list pending entries in sequence order", () => {
+      const entry1 = {
+        doctype: "Task",
+        operation: Operation.Create,
+        status: Status.Pending
+      };
+      const entry2 = {
+        doctype: "Task",
+        operation: Operation.Update,
+        status: Status.Failed
+      };
+      const entry3 = {
+        doctype: "Task",
+        operation: Operation.Delete,
+        status: Status.Confirmed
+      };
+      const entry4 = {
+        doctype: "Task",
+        operation: Operation.Update,
+        status: Status.Pending
+      };
+      journal.add("mut-1", entry1);
+      journal.add("mut-2", entry2);
+      journal.add("mut-3", entry3);
+      journal.add("mut-4", entry4);
+      journal.confirm("mut-3");
+      const pending = journal.listPending();
+      expect(pending).toHaveLength(3);
+      expect(pending[0].id).toBe("mut-1");
+      expect(pending[1].id).toBe("mut-2");
+      expect(pending[2].id).toBe("mut-4");
+    });
+    it("should clear all entries", () => {
+      const entry1 = {
+        doctype: "Task",
+        operation: Operation.Create,
+        status: Status.Pending
+      };
+      const entry2 = {
+        doctype: "Task",
+        operation: Operation.Update,
+        status: Status.Pending
+      };
+      journal.add("mut-1", entry1);
+      journal.add("mut-2", entry2);
+      journal.clear();
+      expect(journal.get("mut-1")).toBeUndefined();
+      expect(journal.get("mut-2")).toBeUndefined();
+      expect(journal.listPending()).toHaveLength(0);
+    });
+  });
+  describe("TTL and expiration", () => {
+    it("should expire entries after TTL", () => {
+      journal = new MutationJournal({
+        ttl: 1e3,
+        enableAutoCleanup: false
+      });
+      const entry = {
+        doctype: "Task",
+        operation: Operation.Update,
+        status: Status.Pending
+      };
+      journal.add("mut-1", entry);
+      expect(journal.get("mut-1")).toBeDefined();
+      vi.advanceTimersByTime(1001);
+      expect(journal.get("mut-1")).toBeUndefined();
+    });
+    it("should not return expired entries in listPending", () => {
+      journal = new MutationJournal({
+        ttl: 1e3,
+        enableAutoCleanup: false
+      });
+      const entry1 = {
+        doctype: "Task",
+        operation: Operation.Create,
+        status: Status.Pending
+      };
+      const entry2 = {
+        doctype: "Task",
+        operation: Operation.Update,
+        status: Status.Pending
+      };
+      journal.add("mut-1", entry1);
+      vi.advanceTimersByTime(500);
+      journal.add("mut-2", entry2);
+      vi.advanceTimersByTime(501);
+      const pending = journal.listPending();
+      expect(pending).toHaveLength(1);
+      expect(pending[0].id).toBe("mut-2");
+    });
+    it("should cleanup expired entries", () => {
+      journal = new MutationJournal({
+        ttl: 1e3,
+        enableAutoCleanup: false
+      });
+      const entry1 = {
+        doctype: "Task",
+        operation: Operation.Create,
+        status: Status.Pending
+      };
+      const entry2 = {
+        doctype: "Task",
+        operation: Operation.Update,
+        status: Status.Pending
+      };
+      journal.add("mut-1", entry1);
+      journal.add("mut-2", entry2);
+      vi.advanceTimersByTime(1001);
+      const cleaned = journal.cleanupExpired();
+      expect(cleaned).toBe(2);
+      expect(journal.listPending()).toHaveLength(0);
+    });
+  });
+  describe("auto cleanup", () => {
+    it("should automatically cleanup expired entries", () => {
+      journal = new MutationJournal({
+        ttl: 1e3,
+        enableAutoCleanup: true
+      });
+      const entry = {
+        doctype: "Task",
+        operation: Operation.Create,
+        status: Status.Pending
+      };
+      journal.add("mut-1", entry);
+      vi.advanceTimersByTime(60001);
+      expect(journal.get("mut-1")).toBeUndefined();
+    });
+    it("should stop auto cleanup on dispose", () => {
+      journal = new MutationJournal({
+        enableAutoCleanup: true
+      });
+      const stopAutoCleanupSpy = vi.spyOn(journal, "stopAutoCleanup");
+      journal.dispose();
+      expect(stopAutoCleanupSpy).toHaveBeenCalled();
+    });
+  });
+  describe("storage integration", () => {
+    it("should persist and load sequence number", () => {
+      const mockStorage = {
+        getItem: vi.fn().mockReturnValue("10"),
+        setItem: vi.fn(),
+        removeItem: vi.fn(),
+        clear: vi.fn(),
+        key: vi.fn(),
+        length: 0
+      };
+      journal = new MutationJournal({
+        storage: mockStorage,
+        enableAutoCleanup: false
+      });
+      expect(mockStorage.getItem).toHaveBeenCalledWith(frappeSyncSequence);
+      const entry = {
+        doctype: "Task",
+        operation: Operation.Create,
+        status: Status.Pending
+      };
+      journal.add("mut-1", entry);
+      const retrieved = journal.get("mut-1");
+      expect(retrieved?.sequence).toBe(11);
+      expect(mockStorage.setItem).toHaveBeenCalledWith(frappeSyncSequence, "11");
+    });
+    it("should handle missing storage sequence gracefully", () => {
+      const mockStorage = {
+        getItem: vi.fn().mockReturnValue(null),
+        setItem: vi.fn(),
+        removeItem: vi.fn(),
+        clear: vi.fn(),
+        key: vi.fn(),
+        length: 0
+      };
+      journal = new MutationJournal({
+        storage: mockStorage,
+        enableAutoCleanup: false
+      });
+      const entry = {
+        doctype: "Task",
+        operation: Operation.Create,
+        status: Status.Pending
+      };
+      journal.add("mut-1", entry);
+      const retrieved = journal.get("mut-1");
+      expect(retrieved?.sequence).toBe(1);
+    });
+  });
+  describe("sequence ordering", () => {
+    beforeEach(() => {
+      journal = new MutationJournal({
+        enableAutoCleanup: false
+      });
+    });
+    it("should assign sequential numbers to entries", () => {
+      const entry1 = {
+        doctype: "Task",
+        operation: Operation.Create,
+        status: Status.Pending
+      };
+      const entry2 = {
+        doctype: "Task",
+        operation: Operation.Update,
+        status: Status.Pending
+      };
+      const entry3 = {
+        doctype: "Task",
+        operation: Operation.Delete,
+        status: Status.Pending
+      };
+      journal.add("mut-1", entry1);
+      journal.add("mut-2", entry2);
+      journal.add("mut-3", entry3);
+      const retrieved1 = journal.get("mut-1");
+      const retrieved2 = journal.get("mut-2");
+      const retrieved3 = journal.get("mut-3");
+      expect(retrieved1?.sequence).toBe(1);
+      expect(retrieved2?.sequence).toBe(2);
+      expect(retrieved3?.sequence).toBe(3);
+    });
+    it("should preserve sequence when provided", () => {
+      const entry = {
+        doctype: "Task",
+        operation: Operation.Create,
+        status: Status.Pending,
+        sequence: 100
+      };
+      journal.add("mut-1", entry);
+      const retrieved = journal.get("mut-1");
+      expect(retrieved?.sequence).toBe(100);
+    });
+  });
+  describe("snapshot handling", () => {
+    beforeEach(() => {
+      journal = new MutationJournal({
+        enableAutoCleanup: false
+      });
+    });
+    it("should store and retrieve snapshots", () => {
+      const snapshot = {
+        doctype: "Task",
+        name: "TASK-001",
+        title: "Original Task",
+        status: "Open"
+      };
+      const entry = {
+        doctype: "Task",
+        docname: "TASK-001",
+        operation: Operation.Update,
+        status: Status.Pending,
+        snapshot,
+        values: {
+          doctype: "Task",
+          name: "TASK-001",
+          status: "Closed"
+        }
+      };
+      journal.add("mut-1", entry);
+      const retrieved = journal.get("mut-1");
+      expect(retrieved?.snapshot).toEqual(snapshot);
+    });
+  });
+});
+//# sourceMappingURL=mutationJournal.spec.mjs.map

package/dist/esm/sync/mutationJournal.spec.mjs.map

@@ -0,0 +1 @@
+{"version":3,"names":["afterEach","beforeEach","describe","expect","it","vi","MutationJournal","frappeSyncSequence","Operation","Status","journal","useFakeTimers","useRealTimers","dispose","enableAutoCleanup","entry","doctype","docname","operation","Update","status","Pending","values","name","add","retrieved","get","toBeDefined","toBe","sequence","createdAt","ttl","retryCount","Create","confirm","toBeUndefined","error","Error","fail","Failed","retrievedAgain","entry1","entry2","entry3","Delete","Confirmed","entry4","pending","listPending","toHaveLength","id","clear","advanceTimersByTime","cleaned","cleanupExpired","stopAutoCleanupSpy","spyOn","toHaveBeenCalled","mockStorage","getItem","fn","mockReturnValue","setItem","removeItem","key","length","storage","toHaveBeenCalledWith","retrieved1","retrieved2","retrieved3","snapshot","title","toEqual"],"sources":["../../../src/sync/mutationJournal.spec.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/esm/sync/mutationJournal.spec.native.js

@@ -0,0 +1,331 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { MutationJournal, frappeSyncSequence } from "./mutationJournal.native.js";
+import { Operation, Status } from "./types.native.js";
+describe("MutationJournal", function () {
+  var journal;
+  beforeEach(function () {
+    vi.useFakeTimers();
+  });
+  afterEach(function () {
+    vi.useRealTimers();
+    if (journal) {
+      journal.dispose();
+    }
+  });
+  describe("basic operations", function () {
+    beforeEach(function () {
+      journal = new MutationJournal({
+        enableAutoCleanup: false
+      });
+    });
+    it("should add a pending entry", function () {
+      var entry = {
+        doctype: "Task",
+        docname: "TASK-001",
+        operation: Operation.Update,
+        status: Status.Pending,
+        values: {
+          doctype: "Task",
+          name: "TASK-001",
+          status: "InProgress"
+        }
+      };
+      journal.add("mut-1", entry);
+      var retrieved = journal.get("mut-1");
+      expect(retrieved).toBeDefined();
+      expect(retrieved === null || retrieved === void 0 ? void 0 : retrieved.doctype).toBe("Task");
+      expect(retrieved === null || retrieved === void 0 ? void 0 : retrieved.sequence).toBeDefined();
+      expect(retrieved === null || retrieved === void 0 ? void 0 : retrieved.createdAt).toBeDefined();
+      expect(retrieved === null || retrieved === void 0 ? void 0 : retrieved.ttl).toBeDefined();
+      expect(retrieved === null || retrieved === void 0 ? void 0 : retrieved.retryCount).toBe(0);
+    });
+    it("should confirm an entry", function () {
+      var entry = {
+        doctype: "Task",
+        operation: Operation.Create,
+        status: Status.Pending
+      };
+      journal.add("mut-2", entry);
+      journal.confirm("mut-2");
+      var retrieved = journal.get("mut-2");
+      expect(retrieved).toBeUndefined();
+    });
+    it("should fail an entry and increment retry count", function () {
+      var entry = {
+        doctype: "Task",
+        operation: Operation.Update,
+        status: Status.Pending
+      };
+      var error = new Error("Network error");
+      journal.add("mut-3", entry);
+      journal.fail("mut-3", error);
+      var retrieved = journal.get("mut-3");
+      expect(retrieved).toBeDefined();
+      expect(retrieved === null || retrieved === void 0 ? void 0 : retrieved.status).toBe(Status.Failed);
+      expect(retrieved === null || retrieved === void 0 ? void 0 : retrieved.error).toBe(error);
+      expect(retrieved === null || retrieved === void 0 ? void 0 : retrieved.retryCount).toBe(1);
+      journal.fail("mut-3", error);
+      var retrievedAgain = journal.get("mut-3");
+      expect(retrievedAgain === null || retrievedAgain === void 0 ? void 0 : retrievedAgain.retryCount).toBe(2);
+    });
+    it("should list pending entries in sequence order", function () {
+      var entry1 = {
+        doctype: "Task",
+        operation: Operation.Create,
+        status: Status.Pending
+      };
+      var entry2 = {
+        doctype: "Task",
+        operation: Operation.Update,
+        status: Status.Failed
+      };
+      var entry3 = {
+        doctype: "Task",
+        operation: Operation.Delete,
+        status: Status.Confirmed
+      };
+      var entry4 = {
+        doctype: "Task",
+        operation: Operation.Update,
+        status: Status.Pending
+      };
+      journal.add("mut-1", entry1);
+      journal.add("mut-2", entry2);
+      journal.add("mut-3", entry3);
+      journal.add("mut-4", entry4);
+      journal.confirm("mut-3");
+      var pending = journal.listPending();
+      expect(pending).toHaveLength(3);
+      expect(pending[0].id).toBe("mut-1");
+      expect(pending[1].id).toBe("mut-2");
+      expect(pending[2].id).toBe("mut-4");
+    });
+    it("should clear all entries", function () {
+      var entry1 = {
+        doctype: "Task",
+        operation: Operation.Create,
+        status: Status.Pending
+      };
+      var entry2 = {
+        doctype: "Task",
+        operation: Operation.Update,
+        status: Status.Pending
+      };
+      journal.add("mut-1", entry1);
+      journal.add("mut-2", entry2);
+      journal.clear();
+      expect(journal.get("mut-1")).toBeUndefined();
+      expect(journal.get("mut-2")).toBeUndefined();
+      expect(journal.listPending()).toHaveLength(0);
+    });
+  });
+  describe("TTL and expiration", function () {
+    it("should expire entries after TTL", function () {
+      journal = new MutationJournal({
+        ttl: 1e3,
+        enableAutoCleanup: false
+      });
+      var entry = {
+        doctype: "Task",
+        operation: Operation.Update,
+        status: Status.Pending
+      };
+      journal.add("mut-1", entry);
+      expect(journal.get("mut-1")).toBeDefined();
+      vi.advanceTimersByTime(1001);
+      expect(journal.get("mut-1")).toBeUndefined();
+    });
+    it("should not return expired entries in listPending", function () {
+      journal = new MutationJournal({
+        ttl: 1e3,
+        enableAutoCleanup: false
+      });
+      var entry1 = {
+        doctype: "Task",
+        operation: Operation.Create,
+        status: Status.Pending
+      };
+      var entry2 = {
+        doctype: "Task",
+        operation: Operation.Update,
+        status: Status.Pending
+      };
+      journal.add("mut-1", entry1);
+      vi.advanceTimersByTime(500);
+      journal.add("mut-2", entry2);
+      vi.advanceTimersByTime(501);
+      var pending = journal.listPending();
+      expect(pending).toHaveLength(1);
+      expect(pending[0].id).toBe("mut-2");
+    });
+    it("should cleanup expired entries", function () {
+      journal = new MutationJournal({
+        ttl: 1e3,
+        enableAutoCleanup: false
+      });
+      var entry1 = {
+        doctype: "Task",
+        operation: Operation.Create,
+        status: Status.Pending
+      };
+      var entry2 = {
+        doctype: "Task",
+        operation: Operation.Update,
+        status: Status.Pending
+      };
+      journal.add("mut-1", entry1);
+      journal.add("mut-2", entry2);
+      vi.advanceTimersByTime(1001);
+      var cleaned = journal.cleanupExpired();
+      expect(cleaned).toBe(2);
+      expect(journal.listPending()).toHaveLength(0);
+    });
+  });
+  describe("auto cleanup", function () {
+    it("should automatically cleanup expired entries", function () {
+      journal = new MutationJournal({
+        ttl: 1e3,
+        enableAutoCleanup: true
+      });
+      var entry = {
+        doctype: "Task",
+        operation: Operation.Create,
+        status: Status.Pending
+      };
+      journal.add("mut-1", entry);
+      vi.advanceTimersByTime(60001);
+      expect(journal.get("mut-1")).toBeUndefined();
+    });
+    it("should stop auto cleanup on dispose", function () {
+      journal = new MutationJournal({
+        enableAutoCleanup: true
+      });
+      var stopAutoCleanupSpy = vi.spyOn(journal, "stopAutoCleanup");
+      journal.dispose();
+      expect(stopAutoCleanupSpy).toHaveBeenCalled();
+    });
+  });
+  describe("storage integration", function () {
+    it("should persist and load sequence number", function () {
+      var mockStorage = {
+        getItem: vi.fn().mockReturnValue("10"),
+        setItem: vi.fn(),
+        removeItem: vi.fn(),
+        clear: vi.fn(),
+        key: vi.fn(),
+        length: 0
+      };
+      journal = new MutationJournal({
+        storage: mockStorage,
+        enableAutoCleanup: false
+      });
+      expect(mockStorage.getItem).toHaveBeenCalledWith(frappeSyncSequence);
+      var entry = {
+        doctype: "Task",
+        operation: Operation.Create,
+        status: Status.Pending
+      };
+      journal.add("mut-1", entry);
+      var retrieved = journal.get("mut-1");
+      expect(retrieved === null || retrieved === void 0 ? void 0 : retrieved.sequence).toBe(11);
+      expect(mockStorage.setItem).toHaveBeenCalledWith(frappeSyncSequence, "11");
+    });
+    it("should handle missing storage sequence gracefully", function () {
+      var mockStorage = {
+        getItem: vi.fn().mockReturnValue(null),
+        setItem: vi.fn(),
+        removeItem: vi.fn(),
+        clear: vi.fn(),
+        key: vi.fn(),
+        length: 0
+      };
+      journal = new MutationJournal({
+        storage: mockStorage,
+        enableAutoCleanup: false
+      });
+      var entry = {
+        doctype: "Task",
+        operation: Operation.Create,
+        status: Status.Pending
+      };
+      journal.add("mut-1", entry);
+      var retrieved = journal.get("mut-1");
+      expect(retrieved === null || retrieved === void 0 ? void 0 : retrieved.sequence).toBe(1);
+    });
+  });
+  describe("sequence ordering", function () {
+    beforeEach(function () {
+      journal = new MutationJournal({
+        enableAutoCleanup: false
+      });
+    });
+    it("should assign sequential numbers to entries", function () {
+      var entry1 = {
+        doctype: "Task",
+        operation: Operation.Create,
+        status: Status.Pending
+      };
+      var entry2 = {
+        doctype: "Task",
+        operation: Operation.Update,
+        status: Status.Pending
+      };
+      var entry3 = {
+        doctype: "Task",
+        operation: Operation.Delete,
+        status: Status.Pending
+      };
+      journal.add("mut-1", entry1);
+      journal.add("mut-2", entry2);
+      journal.add("mut-3", entry3);
+      var retrieved1 = journal.get("mut-1");
+      var retrieved2 = journal.get("mut-2");
+      var retrieved3 = journal.get("mut-3");
+      expect(retrieved1 === null || retrieved1 === void 0 ? void 0 : retrieved1.sequence).toBe(1);
+      expect(retrieved2 === null || retrieved2 === void 0 ? void 0 : retrieved2.sequence).toBe(2);
+      expect(retrieved3 === null || retrieved3 === void 0 ? void 0 : retrieved3.sequence).toBe(3);
+    });
+    it("should preserve sequence when provided", function () {
+      var entry = {
+        doctype: "Task",
+        operation: Operation.Create,
+        status: Status.Pending,
+        sequence: 100
+      };
+      journal.add("mut-1", entry);
+      var retrieved = journal.get("mut-1");
+      expect(retrieved === null || retrieved === void 0 ? void 0 : retrieved.sequence).toBe(100);
+    });
+  });
+  describe("snapshot handling", function () {
+    beforeEach(function () {
+      journal = new MutationJournal({
+        enableAutoCleanup: false
+      });
+    });
+    it("should store and retrieve snapshots", function () {
+      var snapshot = {
+        doctype: "Task",
+        name: "TASK-001",
+        title: "Original Task",
+        status: "Open"
+      };
+      var entry = {
+        doctype: "Task",
+        docname: "TASK-001",
+        operation: Operation.Update,
+        status: Status.Pending,
+        snapshot,
+        values: {
+          doctype: "Task",
+          name: "TASK-001",
+          status: "Closed"
+        }
+      };
+      journal.add("mut-1", entry);
+      var retrieved = journal.get("mut-1");
+      expect(retrieved === null || retrieved === void 0 ? void 0 : retrieved.snapshot).toEqual(snapshot);
+    });
+  });
+});
+//# sourceMappingURL=mutationJournal.spec.native.js.map