@interfere/next 0.0.0-alpha.10 → 0.0.0

package/dist/__tests__/core/debug.test.js

@@ -0,0 +1,277 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+import { DebugUtils } from "../../core/debug.js";
+// Mock dependencies
+const mockSessionManager = {
+    checkAndGetSessionAndWindowId: vi.fn(),
+    sessionTimeoutMs: 30000,
+};
+const mockPersistence = {
+    isDisabled: vi.fn(),
+};
+const mockConfig = {
+    buildId: "test-build-id",
+    releaseId: "test-release-id",
+    persistence: "localStorage",
+};
+const mockRuntime = "browser";
+// Mock window and storage APIs
+const mockLocalStorage = {
+    length: 3,
+    key: vi.fn((index) => {
+        const keys = ["interfere_session", "other_key", "interfere_window"];
+        return keys[index] || null;
+    }),
+};
+const mockSessionStorage = {
+    length: 2,
+    key: vi.fn((index) => {
+        const keys = ["interfere_session", "interfere_window"];
+        return keys[index] || null;
+    }),
+};
+const mockWindow = {
+    localStorage: mockLocalStorage,
+    sessionStorage: mockSessionStorage,
+};
+Object.defineProperty(global, "window", {
+    value: mockWindow,
+    writable: true,
+});
+describe("DebugUtils", () => {
+    let debugUtils;
+    beforeEach(() => {
+        vi.clearAllMocks();
+        debugUtils = new DebugUtils({
+            config: mockConfig,
+            sessionManager: mockSessionManager,
+            persistence: mockPersistence,
+            surface: "test-surface",
+            runtime: mockRuntime,
+        });
+    });
+    describe("constructor", () => {
+        it("should initialize with provided parameters", () => {
+            expect(debugUtils).toBeDefined();
+        });
+    });
+    describe("getDebugInfo", () => {
+        it("should return complete debug information", () => {
+            const mockSessionData = {
+                sessionId: "test-session-id",
+                windowId: "test-window-id",
+                sessionStartTimestamp: 1000000,
+                lastActivityTimestamp: 1005000,
+            };
+            mockSessionManager.checkAndGetSessionAndWindowId.mockReturnValue(mockSessionData);
+            mockPersistence.isDisabled.mockReturnValue(false);
+            const result = debugUtils.getDebugInfo(5);
+            expect(result).toEqual({
+                sessionId: "test-session-id",
+                windowId: "test-window-id",
+                sessionStartTimestamp: 1000000,
+                lastActivityTimestamp: 1005000,
+                sessionTimeoutMs: 30000,
+                sessionAge: expect.any(Number),
+                timeSinceLastActivity: expect.any(Number),
+                isSessionActive: true,
+                config: mockConfig,
+                storageInfo: {
+                    canUseLocalStorage: true,
+                    canUseSessionStorage: false,
+                    storageKeys: ["localStorage: interfere_session", "localStorage: interfere_window"],
+                },
+                queueLength: 5,
+                surface: "test-surface",
+                runtime: "browser",
+                buildId: "test-build-id",
+                releaseId: "test-release-id",
+            });
+        });
+        it("should handle null session data", () => {
+            mockSessionManager.checkAndGetSessionAndWindowId.mockReturnValue({
+                sessionId: null,
+                windowId: null,
+                sessionStartTimestamp: null,
+                lastActivityTimestamp: null,
+            });
+            mockPersistence.isDisabled.mockReturnValue(false);
+            const result = debugUtils.getDebugInfo(0);
+            expect(result.sessionId).toBeNull();
+            expect(result.windowId).toBeNull();
+            expect(result.sessionStartTimestamp).toBeNull();
+            expect(result.lastActivityTimestamp).toBeNull();
+            expect(result.sessionAge).toBe(0);
+            expect(result.timeSinceLastActivity).toBe(0);
+        });
+        it("should calculate session age correctly", () => {
+            const now = Date.now();
+            const sessionStart = now - 60000; // 1 minute ago
+            mockSessionManager.checkAndGetSessionAndWindowId.mockReturnValue({
+                sessionId: "test-session",
+                windowId: "test-window",
+                sessionStartTimestamp: sessionStart,
+                lastActivityTimestamp: now - 30000, // 30 seconds ago
+            });
+            mockPersistence.isDisabled.mockReturnValue(false);
+            const result = debugUtils.getDebugInfo(0);
+            expect(result.sessionAge).toBeGreaterThan(59000);
+            expect(result.sessionAge).toBeLessThan(61000);
+            expect(result.timeSinceLastActivity).toBeGreaterThan(29000);
+            expect(result.timeSinceLastActivity).toBeLessThan(31000);
+        });
+        it("should determine session active status correctly", () => {
+            const now = Date.now();
+            // Active session (last activity within timeout)
+            mockSessionManager.checkAndGetSessionAndWindowId.mockReturnValue({
+                sessionId: "test-session",
+                windowId: "test-window",
+                sessionStartTimestamp: now - 60000,
+                lastActivityTimestamp: now - 10000, // 10 seconds ago
+            });
+            mockPersistence.isDisabled.mockReturnValue(false);
+            let result = debugUtils.getDebugInfo(0);
+            expect(result.isSessionActive).toBe(true);
+            // Inactive session (last activity beyond timeout)
+            mockSessionManager.checkAndGetSessionAndWindowId.mockReturnValue({
+                sessionId: "test-session",
+                windowId: "test-window",
+                sessionStartTimestamp: now - 60000,
+                lastActivityTimestamp: now - 40000, // 40 seconds ago
+            });
+            result = debugUtils.getDebugInfo(0);
+            expect(result.isSessionActive).toBe(false);
+        });
+    });
+    describe("getStorageInfo", () => {
+        it("should return localStorage info when persistence is localStorage", () => {
+            mockPersistence.isDisabled.mockReturnValue(false);
+            const result = debugUtils.getDebugInfo(0);
+            expect(result.storageInfo.canUseLocalStorage).toBe(true);
+            expect(result.storageInfo.canUseSessionStorage).toBe(false);
+            expect(result.storageInfo.storageKeys).toEqual([
+                "localStorage: interfere_session",
+                "localStorage: interfere_window",
+            ]);
+        });
+        it("should return sessionStorage info when persistence is sessionStorage", () => {
+            const debugUtilsWithSessionStorage = new DebugUtils({
+                config: { ...mockConfig, persistence: "sessionStorage" },
+                sessionManager: mockSessionManager,
+                persistence: mockPersistence,
+                surface: "test-surface",
+                runtime: mockRuntime,
+            });
+            mockPersistence.isDisabled.mockReturnValue(false);
+            const result = debugUtilsWithSessionStorage.getDebugInfo(0);
+            expect(result.storageInfo.canUseLocalStorage).toBe(false);
+            expect(result.storageInfo.canUseSessionStorage).toBe(true);
+            expect(result.storageInfo.storageKeys).toEqual([
+                "sessionStorage: interfere_session",
+                "sessionStorage: interfere_window",
+            ]);
+        });
+        it("should return disabled storage info when persistence is disabled", () => {
+            mockPersistence.isDisabled.mockReturnValue(true);
+            const result = debugUtils.getDebugInfo(0);
+            expect(result.storageInfo.canUseLocalStorage).toBe(false);
+            expect(result.storageInfo.canUseSessionStorage).toBe(false);
+            expect(result.storageInfo.storageKeys).toEqual([]);
+        });
+        it("should handle missing window object", () => {
+            // @ts-expect-error - Testing non-browser environment
+            delete global.window;
+            mockPersistence.isDisabled.mockReturnValue(false);
+            const result = debugUtils.getDebugInfo(0);
+            expect(result.storageInfo.canUseLocalStorage).toBe(false);
+            expect(result.storageInfo.canUseSessionStorage).toBe(false);
+            expect(result.storageInfo.storageKeys).toEqual([]);
+        });
+        it("should handle missing localStorage", () => {
+            const mockWindowWithoutLocalStorage = {
+                sessionStorage: mockSessionStorage,
+            };
+            Object.defineProperty(global, "window", {
+                value: mockWindowWithoutLocalStorage,
+                writable: true,
+            });
+            mockPersistence.isDisabled.mockReturnValue(false);
+            const result = debugUtils.getDebugInfo(0);
+            expect(result.storageInfo.canUseLocalStorage).toBe(false);
+            expect(result.storageInfo.canUseSessionStorage).toBe(false);
+            expect(result.storageInfo.storageKeys).toEqual([]);
+        });
+        it("should handle missing sessionStorage", () => {
+            const mockWindowWithoutSessionStorage = {
+                localStorage: mockLocalStorage,
+            };
+            Object.defineProperty(global, "window", {
+                value: mockWindowWithoutSessionStorage,
+                writable: true,
+            });
+            const debugUtilsWithSessionStorage = new DebugUtils({
+                config: { ...mockConfig, persistence: "sessionStorage" },
+                sessionManager: mockSessionManager,
+                persistence: mockPersistence,
+                surface: "test-surface",
+                runtime: mockRuntime,
+            });
+            mockPersistence.isDisabled.mockReturnValue(false);
+            const result = debugUtilsWithSessionStorage.getDebugInfo(0);
+            expect(result.storageInfo.canUseLocalStorage).toBe(false);
+            expect(result.storageInfo.canUseSessionStorage).toBe(false);
+            expect(result.storageInfo.storageKeys).toEqual([]);
+        });
+        it("should handle storage access errors", () => {
+            const mockStorageWithError = {
+                length: 3,
+                key: vi.fn(() => {
+                    throw new Error("Storage access denied");
+                }),
+            };
+            const mockWindowWithErrorStorage = {
+                localStorage: mockStorageWithError,
+                sessionStorage: mockSessionStorage,
+            };
+            Object.defineProperty(global, "window", {
+                value: mockWindowWithErrorStorage,
+                writable: true,
+            });
+            mockPersistence.isDisabled.mockReturnValue(false);
+            const result = debugUtils.getDebugInfo(0);
+            expect(result.storageInfo.canUseLocalStorage).toBe(true);
+            expect(result.storageInfo.canUseSessionStorage).toBe(false);
+            expect(result.storageInfo.storageKeys).toEqual([]);
+        });
+        it("should filter storage keys to only interfere_ prefixed keys", () => {
+            const mockStorageWithMixedKeys = {
+                length: 5,
+                key: vi.fn((index) => {
+                    const keys = [
+                        "interfere_session",
+                        "other_key",
+                        "interfere_window",
+                        "another_key",
+                        "interfere_debug",
+                    ];
+                    return keys[index] || null;
+                }),
+            };
+            const mockWindowWithMixedStorage = {
+                localStorage: mockStorageWithMixedKeys,
+                sessionStorage: mockSessionStorage,
+            };
+            Object.defineProperty(global, "window", {
+                value: mockWindowWithMixedStorage,
+                writable: true,
+            });
+            mockPersistence.isDisabled.mockReturnValue(false);
+            const result = debugUtils.getDebugInfo(0);
+            expect(result.storageInfo.storageKeys).toEqual([
+                "localStorage: interfere_session",
+                "localStorage: interfere_window",
+                "localStorage: interfere_debug",
+            ]);
+        });
+    });
+});
+//# sourceMappingURL=debug.test.js.map

package/dist/__tests__/core/debug.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.test.js","sourceRoot":"","sources":["../../../src/__tests__/core/debug.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/core/encoders.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=encoders.test.d.ts.map

package/dist/__tests__/core/encoders.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoders.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/core/encoders.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/core/encoders.test.js

@@ -0,0 +1,56 @@
+/** biome-ignore-all lint/style/noMagicNumbers: Self-explanatory */
+import { describe, expect, it } from "vitest";
+import { decode, encode } from "../../core/encoders.js";
+describe("encoders", () => {
+    describe("encode", () => {
+        it("encodes strings to Uint8Array", () => {
+            const result = encode("hello");
+            expect(result).toBeInstanceOf(Uint8Array);
+            expect(new TextDecoder().decode(result)).toBe('"hello"');
+        });
+        it("encodes objects to Uint8Array", () => {
+            const obj = { foo: "bar", num: 123 };
+            const result = encode(obj);
+            expect(result).toBeInstanceOf(Uint8Array);
+            expect(new TextDecoder().decode(result)).toBe('{"foo":"bar","num":123}');
+        });
+        it("encodes arrays to Uint8Array", () => {
+            const arr = [1, 2, 3];
+            const result = encode(arr);
+            expect(result).toBeInstanceOf(Uint8Array);
+            expect(new TextDecoder().decode(result)).toBe("[1,2,3]");
+        });
+        it("encodes null", () => {
+            expect(new TextDecoder().decode(encode(null))).toBe("null");
+        });
+        it("handles undefined by encoding as null", () => {
+            // JSON.stringify(undefined) returns undefined, which becomes empty string
+            // This is expected behavior for JSON
+            const result = encode(undefined);
+            expect(result).toBeInstanceOf(Uint8Array);
+        });
+    });
+    describe("decode", () => {
+        it("decodes Uint8Array back to original values", () => {
+            const testCases = [
+                "hello",
+                { foo: "bar", num: 123 },
+                [1, 2, 3],
+                null,
+                true,
+                false,
+                42,
+            ];
+            for (const original of testCases) {
+                const encoded = encode(original);
+                const decoded = decode(encoded);
+                expect(decoded).toEqual(original);
+            }
+        });
+        it("throws on invalid JSON", () => {
+            const invalidJson = new TextEncoder().encode("not valid json");
+            expect(() => decode(invalidJson)).toThrow();
+        });
+    });
+});
+//# sourceMappingURL=encoders.test.js.map

package/dist/__tests__/core/encoders.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encoders.test.js","sourceRoot":"","sources":["../../../src/__tests__/core/encoders.test.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAExD,QAAQ,CAAC,UAAU,EAAE,GAAG,EAAE;IACxB,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;QACtB,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;YACvC,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;YAC/B,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;YAC1C,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC3D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,+BAA+B,EAAE,GAAG,EAAE;YACvC,MAAM,GAAG,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;YACrC,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YAC3B,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;YAC1C,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QAC3E,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;YACtC,MAAM,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;YACtB,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YAC3B,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;YAC1C,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC3D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,cAAc,EAAE,GAAG,EAAE;YACtB,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,uCAAuC,EAAE,GAAG,EAAE;YAC/C,0EAA0E;YAC1E,qCAAqC;YACrC,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;YACjC,MAAM,CAAC,MAAM,CAAC,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;QAC5C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;QACtB,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;YACpD,MAAM,SAAS,GAAG;gBAChB,OAAO;gBACP,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE;gBACxB,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;gBACT,IAAI;gBACJ,IAAI;gBACJ,KAAK;gBACL,EAAE;aACH,CAAC;YAEF,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;gBACjC,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;gBACjC,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;gBAChC,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YACpC,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,wBAAwB,EAAE,GAAG,EAAE;YAChC,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;YAC/D,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QAC9C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/core/persistence.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=persistence.test.d.ts.map

package/dist/__tests__/core/persistence.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/core/persistence.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/core/persistence.test.js

@@ -0,0 +1,129 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+import { InterferePersistence } from "../../session/persistence.js";
+// Test constants
+const TEST_NUMBER_VALUE = 42;
+const TEST_STRING_VALUE = "testValue";
+// Mock storage for testing
+const createMockStorage = () => {
+    const store = {};
+    return {
+        _is_supported: () => true,
+        _parse: (key) => {
+            const value = store[key];
+            return value ? JSON.parse(value) : null;
+        },
+        _set: (key, value) => {
+            store[key] = JSON.stringify(value);
+        },
+        _remove: (key) => {
+            delete store[key];
+        },
+    };
+};
+describe("InterferePersistence", () => {
+    let mockStorage;
+    let persistence;
+    beforeEach(() => {
+        mockStorage = createMockStorage();
+        persistence = new InterferePersistence({ persistence: "localStorage" }, "test-surface", false, { customStorage: mockStorage });
+    });
+    describe("property management", () => {
+        it("should set and get properties", () => {
+            persistence.setProperty("testKey", TEST_STRING_VALUE);
+            expect(persistence.getProperty("testKey")).toBe(TEST_STRING_VALUE);
+        });
+        it("should return typed properties", () => {
+            persistence.setProperty("number", TEST_NUMBER_VALUE);
+            const value = persistence.getProperty("number");
+            expect(value).toBe(TEST_NUMBER_VALUE);
+        });
+        it("should remove individual properties", () => {
+            persistence.setProperty("key1", "value1");
+            persistence.setProperty("key2", "value2");
+            persistence.removeProp("key1");
+            expect(persistence.getProperty("key1")).toBeUndefined();
+            expect(persistence.getProperty("key2")).toBe("value2");
+        });
+        it("should get all properties as immutable copy", () => {
+            persistence.setProperty("key1", "value1");
+            persistence.setProperty("key2", "value2");
+            const props = persistence.getAllProperties();
+            expect(props).toEqual({ key1: "value1", key2: "value2" });
+            // Should be immutable - modifying the returned object shouldn't affect internal state
+            const modifiableProps = props;
+            modifiableProps.key3 = "value3";
+            expect(persistence.getProperty("key3")).toBeUndefined();
+        });
+    });
+    describe("register method", () => {
+        it("should register new properties", () => {
+            const result = persistence.register({
+                key1: "value1",
+                key2: TEST_NUMBER_VALUE,
+            });
+            expect(result).toBe(true);
+            expect(persistence.getProperty("key1")).toBe("value1");
+            expect(persistence.getProperty("key2")).toBe(TEST_NUMBER_VALUE);
+        });
+        it("should detect changes with shallow equality by default", () => {
+            const obj1 = { nested: "value" };
+            const obj2 = { nested: "value" };
+            persistence.register({ testObj: obj1 });
+            const result = persistence.register({ testObj: obj2 });
+            // Should detect change even though content is same (shallow equality)
+            expect(result).toBe(true);
+        });
+        it("should use deep equality when enabled", () => {
+            const deepPersistence = new InterferePersistence({ persistence: "localStorage" }, "test-surface-deep", false, { customStorage: mockStorage, useDeepEquality: true });
+            const obj1 = { nested: "value" };
+            const obj2 = { nested: "value" };
+            deepPersistence.register({ testObj: obj1 });
+            const result = deepPersistence.register({ testObj: obj2 });
+            // Should not detect change with deep equality
+            expect(result).toBe(false);
+        });
+        it("should return false when no changes detected", () => {
+            persistence.register({ key1: "value1" });
+            const result = persistence.register({ key1: "value1" });
+            expect(result).toBe(false);
+        });
+    });
+    describe("disabled state", () => {
+        it("should not save when disabled", () => {
+            persistence.setDisabled(true);
+            persistence.setProperty("key", "value");
+            // Create new instance to check if data was persisted
+            const newPersistence = new InterferePersistence({ persistence: "localStorage" }, "test-surface", false, { customStorage: mockStorage });
+            expect(newPersistence.getProperty("key")).toBeUndefined();
+        });
+        it("should only save on enable if props exist", () => {
+            const spySet = vi.spyOn(mockStorage, "_set");
+            // Enable with no props
+            persistence.setDisabled(false);
+            expect(spySet).not.toHaveBeenCalled();
+            // Add props then enable
+            persistence.setProperty("key", "value");
+            persistence.setDisabled(true);
+            persistence.setDisabled(false);
+            expect(spySet).toHaveBeenCalled();
+        });
+    });
+    describe("backward compatibility", () => {
+        it("should support deprecated unregister method", () => {
+            persistence.setProperty("key", "value");
+            persistence.unregister("key");
+            expect(persistence.getProperty("key")).toBeUndefined();
+        });
+    });
+    describe("initialization optimization", () => {
+        it("should not build storage when disabled", () => {
+            const disabledPersistence = new InterferePersistence({ persistence: "localStorage" }, "test-surface", true // disabled
+            );
+            // Should not throw even without custom storage
+            expect(() => {
+                disabledPersistence.setProperty("key", "value");
+            }).not.toThrow();
+        });
+    });
+});
+//# sourceMappingURL=persistence.test.js.map

package/dist/__tests__/core/persistence.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.test.js","sourceRoot":"","sources":["../../../src/__tests__/core/persistence.test.ts"],"names":[],"mappings":"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"}

package/dist/__tests__/core/rage-click.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=rage-click.test.d.ts.map

package/dist/__tests__/core/rage-click.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rage-click.test.d.ts","sourceRoot":"","sources":["../../../src/__tests__/core/rage-click.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/core/rage-click.test.js

@@ -0,0 +1,121 @@
+import { describe, expect, it } from "vitest";
+import RageClick from "../../session/rage-click.js";
+// Test constants
+const TEST_X = 100;
+const TEST_Y = 100;
+const SMALL_OFFSET = 5;
+const MEDIUM_OFFSET = 10;
+const MEDIUM_LARGE_OFFSET = 15;
+const LARGE_OFFSET = 50;
+const VERY_LARGE_OFFSET = 100;
+const SHORT_DELAY = 100;
+const MEDIUM_DELAY = 200;
+const LONG_DELAY = 300;
+const VERY_LONG_DELAY = 400;
+const CUSTOM_TIMEOUT = 500;
+const VERY_LATE_DELAY = 1500;
+const MUCH_LATER_DELAY = 3000;
+const MAX_TEXT_TEST_LENGTH = 150;
+const EXPECTED_TRUNCATED_LENGTH = 100;
+describe("RageClick", () => {
+    it("should detect rage click with default settings", () => {
+        const detector = new RageClick();
+        const baseTime = Date.now();
+        // First two clicks should not trigger
+        expect(detector.isRageClick(TEST_X, TEST_Y, baseTime)).toBe(false);
+        expect(detector.isRageClick(TEST_X + SMALL_OFFSET, TEST_Y + SMALL_OFFSET, baseTime + SHORT_DELAY)).toBe(false);
+        // Third click should trigger rage click
+        expect(detector.isRageClick(TEST_X - SMALL_OFFSET, TEST_Y - SMALL_OFFSET, baseTime + MEDIUM_DELAY)).toBe(true);
+    });
+    it("should not detect rage click if clicks are too far apart", () => {
+        const detector = new RageClick();
+        const baseTime = Date.now();
+        // Clicks outside the radius threshold (default 30px)
+        expect(detector.isRageClick(TEST_X, TEST_Y, baseTime)).toBe(false);
+        expect(detector.isRageClick(TEST_X + LARGE_OFFSET, TEST_Y, baseTime + SHORT_DELAY)).toBe(false);
+        expect(detector.isRageClick(TEST_X, TEST_Y + LARGE_OFFSET, baseTime + MEDIUM_DELAY)).toBe(false);
+        // Should not trigger even with more clicks
+        expect(detector.isRageClick(TEST_X + VERY_LARGE_OFFSET, TEST_Y, baseTime + LONG_DELAY)).toBe(false);
+    });
+    it("should not detect rage click if clicks are too slow", () => {
+        const detector = new RageClick();
+        const baseTime = Date.now();
+        // Spread clicks over a longer time period so they don't form a rage click
+        expect(detector.isRageClick(TEST_X, TEST_Y, baseTime)).toBe(false);
+        expect(detector.isRageClick(TEST_X + SMALL_OFFSET, TEST_Y + SMALL_OFFSET, baseTime + VERY_LATE_DELAY)).toBe(false); // Gap too large
+        expect(detector.isRageClick(TEST_X - SMALL_OFFSET, TEST_Y - SMALL_OFFSET, baseTime + MUCH_LATER_DELAY)).toBe(false); // Gap too large
+    });
+    it("should use static configuration values", () => {
+        const detector = new RageClick();
+        const baseTime = Date.now();
+        // Static config uses 3 clicks within 1000ms and 30px radius
+        // First click
+        expect(detector.isRageClick(TEST_X, TEST_Y, baseTime)).toBe(false);
+        // Second click
+        expect(detector.isRageClick(TEST_X + MEDIUM_OFFSET, TEST_Y + MEDIUM_OFFSET, baseTime + MEDIUM_DELAY)).toBe(false);
+        // Third click should trigger rage click
+        expect(detector.isRageClick(TEST_X + MEDIUM_LARGE_OFFSET, TEST_Y + MEDIUM_LARGE_OFFSET, baseTime + VERY_LONG_DELAY)).toBe(true);
+    });
+    it("should reset after detecting rage click", () => {
+        const detector = new RageClick();
+        const baseTime = Date.now();
+        // Trigger first rage click
+        expect(detector.isRageClick(TEST_X, TEST_Y, baseTime)).toBe(false);
+        expect(detector.isRageClick(TEST_X + SMALL_OFFSET, TEST_Y + SMALL_OFFSET, baseTime + SHORT_DELAY)).toBe(false);
+        expect(detector.isRageClick(TEST_X - SMALL_OFFSET, TEST_Y - SMALL_OFFSET, baseTime + MEDIUM_DELAY)).toBe(true);
+        // Should reset and require 3 new clicks
+        expect(detector.isRageClick(TEST_X, TEST_Y, baseTime + LONG_DELAY)).toBe(false);
+        expect(detector.isRageClick(TEST_X + SMALL_OFFSET, TEST_Y + SMALL_OFFSET, baseTime + VERY_LONG_DELAY)).toBe(false);
+        expect(detector.isRageClick(TEST_X - SMALL_OFFSET, TEST_Y - SMALL_OFFSET, baseTime + CUSTOM_TIMEOUT)).toBe(true);
+    });
+    it("should filter out old clicks", () => {
+        const detector = new RageClick();
+        const baseTime = Date.now();
+        // Add some old clicks
+        expect(detector.isRageClick(TEST_X, TEST_Y, baseTime)).toBe(false);
+        expect(detector.isRageClick(TEST_X + SMALL_OFFSET, TEST_Y + SMALL_OFFSET, baseTime + SHORT_DELAY)).toBe(false);
+        // Wait longer than timeout, then add new clicks
+        const laterTime = baseTime + VERY_LATE_DELAY; // After timeout window
+        expect(detector.isRageClick(TEST_X, TEST_Y, laterTime)).toBe(false);
+        expect(detector.isRageClick(TEST_X + SMALL_OFFSET, TEST_Y + SMALL_OFFSET, laterTime + SHORT_DELAY)).toBe(false);
+        expect(detector.isRageClick(TEST_X - SMALL_OFFSET, TEST_Y - SMALL_OFFSET, laterTime + MEDIUM_DELAY)).toBe(true);
+    });
+    it("should extract element information correctly", () => {
+        const detector = new RageClick();
+        // Mock DOM element
+        const mockElement = {
+            tagName: "BUTTON",
+            className: "test-class",
+            id: "test-id",
+            innerText: "Click me!",
+            getAttribute: (attr) => attr === "aria-label" ? "Test Button" : null,
+        };
+        const elementInfo = detector.getElementInfo(mockElement);
+        expect(elementInfo).toEqual({
+            tagName: "button",
+            className: "test-class",
+            id: "test-id",
+            text: "Click me!",
+            ariaLabel: "Test Button",
+        });
+    });
+    it("should handle null element gracefully", () => {
+        const detector = new RageClick();
+        const elementInfo = detector.getElementInfo(null);
+        expect(elementInfo).toEqual({});
+    });
+    it("should truncate long text", () => {
+        const detector = new RageClick();
+        // Mock element with long text
+        const longText = "a".repeat(MAX_TEXT_TEST_LENGTH);
+        const mockElement = {
+            tagName: "DIV",
+            innerText: longText,
+            getAttribute: () => null,
+        };
+        const elementInfo = detector.getElementInfo(mockElement);
+        expect(elementInfo.text).toHaveLength(EXPECTED_TRUNCATED_LENGTH);
+        expect(elementInfo.text).toBe("a".repeat(EXPECTED_TRUNCATED_LENGTH));
+    });
+});
+//# sourceMappingURL=rage-click.test.js.map