@prosopo/provider 3.13.7 → 4.7.1

package/dist/tests/unit/util.unit.test.js

@@ -0,0 +1,167 @@
+import { ProsopoContractError, ProsopoEnvError } from "@prosopo/common";
+import { ScheduledTaskNames, ScheduledTaskStatus } from "@prosopo/types";
+import { beforeEach, describe, expect, it, vi } from "vitest";
+import { checkIfTaskIsRunning, encodeStringAddress, getIPAddress, getIPAddressFromBigInt, shuffleArray, } from "../../util.js";
+describe("encodeStringAddress", () => {
+    it("should encode a valid hex address", () => {
+        const hexAddress = "0xd43593c715fdd31c61141abd04a99fd6822c8558854ccde39a5684e7a56da27d";
+        const result = encodeStringAddress(hexAddress);
+        expect(result).toBeDefined();
+        expect(typeof result).toBe("string");
+    });
+    it("should encode a valid base58 address", () => {
+        const base58Address = "5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY";
+        const result = encodeStringAddress(base58Address);
+        expect(result).toBeDefined();
+        expect(typeof result).toBe("string");
+    });
+    it("should throw ProsopoContractError for invalid address", () => {
+        const invalidAddress = "invalid-address";
+        expect(() => encodeStringAddress(invalidAddress)).toThrow(ProsopoContractError);
+        expect(() => encodeStringAddress(invalidAddress)).toThrow("CONTRACT.INVALID_ADDRESS");
+    });
+});
+describe("shuffleArray", () => {
+    it("should return an array of the same length", () => {
+        const original = [1, 2, 3, 4, 5];
+        const result = shuffleArray([...original]);
+        expect(result).toHaveLength(original.length);
+    });
+    it("should contain the same elements", () => {
+        const original = [1, 2, 3, 4, 5];
+        const result = shuffleArray([...original]);
+        expect(result.sort()).toEqual(original.sort());
+    });
+    it("should handle empty array", () => {
+        const original = [];
+        const result = shuffleArray([...original]);
+        expect(result).toEqual([]);
+    });
+    it("should handle single element array", () => {
+        const original = [42];
+        const result = shuffleArray([...original]);
+        expect(result).toEqual([42]);
+    });
+    it("should handle array with duplicate elements", () => {
+        const original = [1, 1, 2, 2, 3];
+        const result = shuffleArray([...original]);
+        expect(result.sort()).toEqual(original.sort());
+        expect(result).toHaveLength(5);
+    });
+    it("should modify the original array in place", () => {
+        const original = [1, 2, 3, 4, 5];
+        const originalCopy = [...original];
+        shuffleArray(original);
+        expect(original).toHaveLength(originalCopy.length);
+        expect(original.sort()).toEqual(originalCopy.sort());
+    });
+});
+describe("checkIfTaskIsRunning", () => {
+    let mockDb;
+    beforeEach(() => {
+        mockDb = {
+            getLastScheduledTaskStatus: vi.fn(),
+            getScheduledTaskStatus: vi.fn(),
+        };
+    });
+    it("should return false when no running task exists", async () => {
+        vi.mocked(mockDb.getLastScheduledTaskStatus).mockResolvedValue(undefined);
+        const result = await checkIfTaskIsRunning(ScheduledTaskNames.StoreCommitmentsExternal, mockDb);
+        expect(result).toBe(false);
+        expect(mockDb.getLastScheduledTaskStatus).toHaveBeenCalledWith(ScheduledTaskNames.StoreCommitmentsExternal, ScheduledTaskStatus.Running);
+    });
+    it("should return false when running task is older than 2 minutes", async () => {
+        const oldTask = {
+            _id: "task-id",
+            datetime: new Date(Date.now() - 1000 * 60 * 3),
+        };
+        vi.mocked(mockDb.getLastScheduledTaskStatus).mockResolvedValue(oldTask);
+        const result = await checkIfTaskIsRunning(ScheduledTaskNames.StoreCommitmentsExternal, mockDb);
+        expect(result).toBe(false);
+        expect(mockDb.getLastScheduledTaskStatus).toHaveBeenCalledTimes(1);
+        expect(mockDb.getScheduledTaskStatus).not.toHaveBeenCalled();
+    });
+    it("should return true when running task exists and is not completed", async () => {
+        const recentTask = {
+            _id: "task-id",
+            datetime: new Date(Date.now() - 1000 * 60),
+        };
+        vi.mocked(mockDb.getLastScheduledTaskStatus).mockResolvedValue(recentTask);
+        vi.mocked(mockDb.getScheduledTaskStatus).mockResolvedValue(undefined);
+        const result = await checkIfTaskIsRunning(ScheduledTaskNames.StoreCommitmentsExternal, mockDb);
+        expect(result).toBe(true);
+        expect(mockDb.getScheduledTaskStatus).toHaveBeenCalledWith(recentTask._id, ScheduledTaskStatus.Completed);
+    });
+    it("should return false when running task exists and is completed", async () => {
+        const recentTask = {
+            _id: "task-id",
+            datetime: new Date(Date.now() - 1000 * 30),
+        };
+        const completedTask = {
+            _id: "completed-id",
+            status: ScheduledTaskStatus.Completed,
+        };
+        vi.mocked(mockDb.getLastScheduledTaskStatus).mockResolvedValue(recentTask);
+        vi.mocked(mockDb.getScheduledTaskStatus).mockResolvedValue(completedTask);
+        const result = await checkIfTaskIsRunning(ScheduledTaskNames.StoreCommitmentsExternal, mockDb);
+        expect(result).toBe(false);
+        expect(mockDb.getScheduledTaskStatus).toHaveBeenCalledWith(recentTask._id, ScheduledTaskStatus.Completed);
+    });
+});
+describe("getIPAddress", () => {
+    it("should parse valid IPv4 address", () => {
+        const ipv4 = "192.168.1.1";
+        const result = getIPAddress(ipv4);
+        expect(result).toBeDefined();
+        expect(result.address).toBe(ipv4);
+        expect(result.v4).toBe(true);
+    });
+    it("should parse valid IPv6 address", () => {
+        const ipv6 = "2001:db8::1";
+        const result = getIPAddress(ipv6);
+        expect(result).toBeDefined();
+        expect(result.address).toBe(ipv6);
+        expect(result.v4).toBe(false);
+    });
+    it("should throw ProsopoEnvError for invalid IP address", () => {
+        const invalidIP = "invalid-ip-address";
+        expect(() => getIPAddress(invalidIP)).toThrow(ProsopoEnvError);
+        expect(() => getIPAddress(invalidIP)).toThrow("API.INVALID_IP");
+    });
+    it("should handle IPv4 loopback", () => {
+        const loopback = "127.0.0.1";
+        const result = getIPAddress(loopback);
+        expect(result.address).toBe(loopback);
+        expect(result.v4).toBe(true);
+    });
+    it("should handle IPv6 loopback", () => {
+        const loopback = "::1";
+        const result = getIPAddress(loopback);
+        expect(result.address).toBe(loopback);
+        expect(result.v4).toBe(false);
+    });
+});
+describe("getIPAddressFromBigInt", () => {
+    it("should convert IPv4 big int to address", () => {
+        const ipv4BigInt = 3232235777n;
+        const result = getIPAddressFromBigInt(ipv4BigInt);
+        expect(result).toBeDefined();
+        expect(result.address).toBe("192.168.1.1");
+        expect(result.v4).toBe(true);
+    });
+    it("should convert IPv6 big int to address", () => {
+        const ipv6BigInt = 42540766411282592856904266426630537217n;
+        const result = getIPAddressFromBigInt(ipv6BigInt);
+        expect(result).toBeDefined();
+        expect(result.v4).toBe(false);
+    });
+    it("should handle edge cases", () => {
+        const zero = getIPAddressFromBigInt(0n);
+        expect(zero).toBeDefined();
+        expect(zero.address).toBe("0.0.0.0");
+        const ipv6Value = getIPAddressFromBigInt(4228250627n);
+        expect(ipv6Value).toBeDefined();
+        expect(ipv6Value.v4).toBe(false);
+    });
+});
+//# sourceMappingURL=util.unit.test.js.map

package/dist/tests/unit/util.unit.test.js.map

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

package/dist/tests/unit/utils/devicePlatform.unit.test.d.ts

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

package/dist/tests/unit/utils/devicePlatform.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"devicePlatform.unit.test.d.ts","sourceRoot":"","sources":["../../../../src/tests/unit/utils/devicePlatform.unit.test.ts"],"names":[],"mappings":""}

package/dist/tests/unit/utils/devicePlatform.unit.test.js

@@ -0,0 +1,58 @@
+import { describe, expect, it } from "vitest";
+import { derivePlatform } from "../../../utils/devicePlatform.js";
+const IPHONE_UA = "Mozilla/5.0 (iPhone; CPU iPhone OS 17_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.0 Mobile/15E148 Safari/604.1";
+const IPAD_UA = "Mozilla/5.0 (iPad; CPU OS 17_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.0 Mobile/15E148 Safari/604.1";
+const MAC_UA = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.0 Safari/605.1.15";
+const PIXEL_UA = "Mozilla/5.0 (Linux; Android 14; Pixel 7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/119.0.0.0 Mobile Safari/537.36";
+const WINDOWS_CHROME_UA = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/119.0.0.0 Safari/537.36";
+describe("derivePlatform", () => {
+    describe("isApple", () => {
+        it("matches iPhone UA", () => {
+            expect(derivePlatform(IPHONE_UA, false).isApple).toBe(true);
+        });
+        it("matches iPad UA", () => {
+            expect(derivePlatform(IPAD_UA, false).isApple).toBe(true);
+        });
+        it("matches Macintosh UA", () => {
+            expect(derivePlatform(MAC_UA, false).isApple).toBe(true);
+        });
+        it("does not match Android UA", () => {
+            expect(derivePlatform(PIXEL_UA, false).isApple).toBe(false);
+        });
+        it("does not match Windows UA", () => {
+            expect(derivePlatform(WINDOWS_CHROME_UA, false).isApple).toBe(false);
+        });
+        it("does not match empty UA", () => {
+            expect(derivePlatform("", false).isApple).toBe(false);
+        });
+    });
+    describe("isWebView", () => {
+        it("passes through caller-supplied true", () => {
+            expect(derivePlatform(WINDOWS_CHROME_UA, true).isWebView).toBe(true);
+        });
+        it("passes through caller-supplied false", () => {
+            expect(derivePlatform(IPHONE_UA, false).isWebView).toBe(false);
+        });
+    });
+    describe("isMobile", () => {
+        it("prefers ipInfo.isMobile=true when provided", () => {
+            expect(derivePlatform(WINDOWS_CHROME_UA, false, { isMobile: true }).isMobile).toBe(true);
+        });
+        it("prefers ipInfo.isMobile=false when provided, even on a mobile UA", () => {
+            expect(derivePlatform(IPHONE_UA, false, { isMobile: false }).isMobile).toBe(false);
+        });
+        it("falls back to UA when ipInfo missing — iPhone is mobile", () => {
+            expect(derivePlatform(IPHONE_UA, false).isMobile).toBe(true);
+        });
+        it("falls back to UA when ipInfo missing — Pixel is mobile", () => {
+            expect(derivePlatform(PIXEL_UA, false).isMobile).toBe(true);
+        });
+        it("falls back to UA when ipInfo missing — Windows Chrome is not mobile", () => {
+            expect(derivePlatform(WINDOWS_CHROME_UA, false).isMobile).toBe(false);
+        });
+        it("falls back to UA when ipInfo missing — Mac Safari is not mobile", () => {
+            expect(derivePlatform(MAC_UA, false).isMobile).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=devicePlatform.unit.test.js.map

package/dist/tests/unit/utils/devicePlatform.unit.test.js.map

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

package/dist/tests/unit/utils/hashUserAgent.unit.test.d.ts

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

package/dist/tests/unit/utils/hashUserAgent.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hashUserAgent.unit.test.d.ts","sourceRoot":"","sources":["../../../../src/tests/unit/utils/hashUserAgent.unit.test.ts"],"names":[],"mappings":""}

package/dist/tests/unit/utils/hashUserAgent.unit.test.js

@@ -0,0 +1,52 @@
+import { describe, expect, it } from "vitest";
+import { hashUserAgent } from "../../../utils/hashUserAgent.js";
+describe("hashUserAgent", () => {
+    it("should return a 32-character hex string", () => {
+        const userAgent = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36";
+        const result = hashUserAgent(userAgent);
+        expect(result).toHaveLength(32);
+        expect(result).toMatch(/^[a-f0-9]{32}$/);
+    });
+    it("should produce consistent results for the same input", () => {
+        const userAgent = "Test User Agent String";
+        const result1 = hashUserAgent(userAgent);
+        const result2 = hashUserAgent(userAgent);
+        expect(result1).toBe(result2);
+    });
+    it("should produce different results for different inputs", () => {
+        const userAgent1 = "Mozilla/5.0 (Windows NT 10.0; Win64; x64)";
+        const userAgent2 = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)";
+        const result1 = hashUserAgent(userAgent1);
+        const result2 = hashUserAgent(userAgent2);
+        expect(result1).not.toBe(result2);
+    });
+    it("should handle empty string", () => {
+        const result = hashUserAgent("");
+        expect(result).toHaveLength(32);
+        expect(result).toMatch(/^[a-f0-9]{32}$/);
+    });
+    it("should handle very long user agent strings", () => {
+        const longUserAgent = "A".repeat(1000);
+        const result = hashUserAgent(longUserAgent);
+        expect(result).toHaveLength(32);
+        expect(result).toMatch(/^[a-f0-9]{32}$/);
+    });
+    it("should handle special characters", () => {
+        const specialUserAgent = "Mozilla/5.0 (compatible; MSIE 9.0; Windows NT 6.1; Trident/5.0; !@#$%^&*())";
+        const result = hashUserAgent(specialUserAgent);
+        expect(result).toHaveLength(32);
+        expect(result).toMatch(/^[a-f0-9]{32}$/);
+    });
+    it("should handle unicode characters", () => {
+        const unicodeUserAgent = "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:89.0) Gecko/20100101 Firefox/89.0 🌟";
+        const result = hashUserAgent(unicodeUserAgent);
+        expect(result).toHaveLength(32);
+        expect(result).toMatch(/^[a-f0-9]{32}$/);
+    });
+    it("should use SHA-256 and return first 32 characters", () => {
+        const userAgent = "test";
+        const result = hashUserAgent(userAgent);
+        expect(result).toBe("9f86d081884c7d659a2feaa0c55ad015");
+    });
+});
+//# sourceMappingURL=hashUserAgent.unit.test.js.map

package/dist/tests/unit/utils/hashUserAgent.unit.test.js.map

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

package/dist/tests/unit/utils/hashUserIp.unit.test.d.ts

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

package/dist/tests/unit/utils/hashUserIp.unit.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hashUserIp.unit.test.d.ts","sourceRoot":"","sources":["../../../../src/tests/unit/utils/hashUserIp.unit.test.ts"],"names":[],"mappings":""}

package/dist/tests/unit/utils/hashUserIp.unit.test.js

@@ -0,0 +1,81 @@
+import { describe, expect, it } from "vitest";
+import { hashUserIp } from "../../../utils/hashUserIp.js";
+describe("hashUserIp", () => {
+    it("should return a 64-character hex string", () => {
+        const user = "user123";
+        const ip = "192.168.1.1";
+        const sitekey = "sitekey456";
+        const result = hashUserIp(user, ip, sitekey);
+        expect(result).toHaveLength(64);
+        expect(result).toMatch(/^[a-f0-9]{64}$/);
+    });
+    it("should produce consistent results for the same inputs", () => {
+        const user = "testuser";
+        const ip = "10.0.0.1";
+        const sitekey = "testsitekey";
+        const result1 = hashUserIp(user, ip, sitekey);
+        const result2 = hashUserIp(user, ip, sitekey);
+        expect(result1).toBe(result2);
+    });
+    it("should produce different results when user changes", () => {
+        const ip = "192.168.1.1";
+        const sitekey = "sitekey456";
+        const result1 = hashUserIp("user1", ip, sitekey);
+        const result2 = hashUserIp("user2", ip, sitekey);
+        expect(result1).not.toBe(result2);
+    });
+    it("should produce different results when IP changes", () => {
+        const user = "user123";
+        const sitekey = "sitekey456";
+        const result1 = hashUserIp(user, "192.168.1.1", sitekey);
+        const result2 = hashUserIp(user, "192.168.1.2", sitekey);
+        expect(result1).not.toBe(result2);
+    });
+    it("should produce different results when sitekey changes", () => {
+        const user = "user123";
+        const ip = "192.168.1.1";
+        const result1 = hashUserIp(user, ip, "sitekey1");
+        const result2 = hashUserIp(user, ip, "sitekey2");
+        expect(result1).not.toBe(result2);
+    });
+    it("should handle empty strings", () => {
+        const result = hashUserIp("", "", "");
+        expect(result).toHaveLength(64);
+        expect(result).toMatch(/^[a-f0-9]{64}$/);
+    });
+    it("should handle special characters", () => {
+        const user = "user@domain.com";
+        const ip = "2001:db8::1";
+        const sitekey = "site_key-123";
+        const result = hashUserIp(user, ip, sitekey);
+        expect(result).toHaveLength(64);
+        expect(result).toMatch(/^[a-f0-9]{64}$/);
+    });
+    it("should handle unicode characters", () => {
+        const user = "用户123";
+        const ip = "192.168.1.1";
+        const sitekey = "网站密钥";
+        const result = hashUserIp(user, ip, sitekey);
+        expect(result).toHaveLength(64);
+        expect(result).toMatch(/^[a-f0-9]{64}$/);
+    });
+    it("should create different hashes for same user/ip with different sitekeys", () => {
+        const user = "user123";
+        const ip = "192.168.1.1";
+        const result1 = hashUserIp(user, ip, "site1");
+        const result2 = hashUserIp(user, ip, "site2");
+        expect(result1).not.toBe(result2);
+        expect(result1).toHaveLength(64);
+        expect(result2).toHaveLength(64);
+    });
+    it("should use SHA-256 with user:ip:sitekey format", () => {
+        const user = "test";
+        const ip = "127.0.0.1";
+        const sitekey = "abc";
+        const result = hashUserIp(user, ip, sitekey);
+        const result2 = hashUserIp(user, ip, sitekey);
+        expect(result).toBe(result2);
+        expect(result).toHaveLength(64);
+    });
+});
+//# sourceMappingURL=hashUserIp.unit.test.js.map

package/dist/tests/unit/utils/hashUserIp.unit.test.js.map

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

package/dist/util/usageCounters.d.ts

@@ -0,0 +1,22 @@
+import type { Logger } from "@prosopo/logger";
+import type { RedisConnection } from "@prosopo/redis-client";
+import { type CounterSpec } from "@prosopo/types";
+export interface CounterIncrement {
+    spec: CounterSpec;
+    value: string;
+}
+export declare class UsageCounters {
+    private readonly connection;
+    private readonly logger;
+    private scriptShaPromise;
+    constructor(connection: RedisConnection, logger: Logger);
+    private getClient;
+    private getScriptSha;
+    incr(dappAccount: string, spec: CounterSpec, value: string): Promise<number | null>;
+    incrAsync(dappAccount: string, spec: CounterSpec, value: string): void;
+    incrManyAsync(dappAccount: string, increments: CounterIncrement[]): void;
+    clearAll(dappAccount?: string): Promise<number | null>;
+    batchGet(dappAccount: string, reads: CounterIncrement[]): Promise<Record<string, number> | null>;
+}
+export declare const buildAllWindowIncrements: (kind: "served" | "solved", captchaType: CounterSpec["captchaType"], ip: string, userAccount: string) => CounterIncrement[];
+//# sourceMappingURL=usageCounters.d.ts.map

package/dist/util/usageCounters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usageCounters.d.ts","sourceRoot":"","sources":["../../src/util/usageCounters.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAEN,KAAK,WAAW,EAEhB,MAAM,gBAAgB,CAAC;AAWxB,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACd;AAUD,qBAAa,aAAa;IACzB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkB;IAC7C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,gBAAgB,CAAgC;gBAE5C,UAAU,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM;YAKzC,SAAS;YAWT,YAAY;IAiBpB,IAAI,CACT,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IA2BzB,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAatE,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB,EAAE,GAAG,IAAI;IAYlE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IA2CtD,QAAQ,CACb,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,gBAAgB,EAAE,GACvB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;CA8BzC;AAMD,eAAO,MAAM,wBAAwB,SAC9B,QAAQ,GAAG,QAAQ,eACZ,WAAW,CAAC,aAAa,CAAC,MACnC,MAAM,eACG,MAAM,KACjB,gBAAgB,EAoClB,CAAC"}

package/dist/util/usageCounters.js

@@ -0,0 +1,201 @@
+import { encodeCounterKey, COUNTER_WINDOW_SECONDS } from "@prosopo/types";
+const INCR_WITH_TTL_LUA = `local count = redis.call('INCR', KEYS[1])
+if count == 1 then
+  redis.call('EXPIRE', KEYS[1], tonumber(ARGV[1]))
+end
+return count`;
+class UsageCounters {
+  constructor(connection, logger) {
+    this.scriptShaPromise = null;
+    this.connection = connection;
+    this.logger = logger;
+  }
+  async getClient() {
+    if (!this.connection.isReady()) {
+      return null;
+    }
+    try {
+      return await this.connection.getClient();
+    } catch {
+      return null;
+    }
+  }
+  async getScriptSha(client) {
+    if (!this.scriptShaPromise) {
+      this.scriptShaPromise = client.scriptLoad(INCR_WITH_TTL_LUA).then(
+        (sha) => sha,
+        (error) => {
+          this.scriptShaPromise = null;
+          throw error;
+        }
+      );
+    }
+    return this.scriptShaPromise;
+  }
+  /**
+   * Atomically increment a counter. Sets TTL only on the first write within
+   * the window. Returns the post-increment value, or null on Redis failure.
+   */
+  async incr(dappAccount, spec, value) {
+    const client = await this.getClient();
+    if (!client) {
+      return null;
+    }
+    const key = encodeCounterKey(dappAccount, spec, value);
+    const ttlSeconds = COUNTER_WINDOW_SECONDS[spec.window];
+    try {
+      const sha = await this.getScriptSha(client);
+      const result = await client.evalSha(sha, {
+        keys: [key],
+        arguments: [String(ttlSeconds)]
+      });
+      return Number(result);
+    } catch (error) {
+      this.logger.warn(() => ({
+        msg: "Counter incr failed",
+        err: error,
+        data: { key }
+      }));
+      return null;
+    }
+  }
+  /**
+   * Fire-and-forget increment. Errors are logged but do not propagate.
+   */
+  incrAsync(dappAccount, spec, value) {
+    this.incr(dappAccount, spec, value).catch((error) => {
+      this.logger.error(() => ({
+        msg: "Counter incrAsync rejected",
+        err: error,
+        data: { dappAccount, spec, value }
+      }));
+    });
+  }
+  /**
+   * Fire-and-forget increment of multiple counters in parallel.
+   */
+  incrManyAsync(dappAccount, increments) {
+    for (const { spec, value } of increments) {
+      this.incrAsync(dappAccount, spec, value);
+    }
+  }
+  /**
+   * Delete every counter key matching the given dapp (or all counters when
+   * dappAccount is omitted). Intended for admin manual-testing flows — not
+   * for the hot path. Uses SCAN + DEL in chunks; returns the number of keys
+   * deleted. Returns null on Redis failure.
+   */
+  async clearAll(dappAccount) {
+    const client = await this.getClient();
+    if (!client) {
+      return null;
+    }
+    const pattern = dappAccount ? `cnt:${dappAccount}:*` : "cnt:*";
+    let deleted = 0;
+    try {
+      const batchSize = 500;
+      let batch = [];
+      for await (const key of client.scanIterator({
+        MATCH: pattern,
+        COUNT: 200
+      })) {
+        if (Array.isArray(key)) {
+          for (const k of key) batch.push(k);
+        } else {
+          batch.push(key);
+        }
+        if (batch.length >= batchSize) {
+          deleted += Number(await client.del(batch));
+          batch = [];
+        }
+      }
+      if (batch.length > 0) {
+        deleted += Number(await client.del(batch));
+      }
+      return deleted;
+    } catch (error) {
+      this.logger.warn(() => ({
+        msg: "Counter clearAll failed",
+        err: error,
+        data: { pattern, deleted }
+      }));
+      return null;
+    }
+  }
+  /**
+   * Bulk read counters via MGET. Missing keys map to 0. Returns a record
+   * keyed by encoded counter key. Returns null on Redis failure so callers
+   * can fall back.
+   */
+  async batchGet(dappAccount, reads) {
+    if (reads.length === 0) {
+      return {};
+    }
+    const client = await this.getClient();
+    if (!client) {
+      return null;
+    }
+    const keys = reads.map(
+      (r) => encodeCounterKey(dappAccount, r.spec, r.value)
+    );
+    try {
+      const values = await client.mGet(keys);
+      const out = {};
+      for (let i = 0; i < keys.length; i++) {
+        const raw = values[i];
+        const key = keys[i];
+        if (key === void 0) continue;
+        out[key] = raw === null || raw === void 0 ? 0 : Number(raw);
+      }
+      return out;
+    } catch (error) {
+      this.logger.warn(() => ({
+        msg: "Counter batchGet failed",
+        err: error,
+        data: { keyCount: keys.length }
+      }));
+      return null;
+    }
+  }
+}
+const buildAllWindowIncrements = (kind, captchaType, ip, userAccount) => {
+  const out = [];
+  for (const window of [
+    "1m",
+    "10m",
+    "1h",
+    "3h",
+    "6h",
+    "24h"
+  ]) {
+    out.push(
+      { spec: { kind, captchaType, dimension: "ip", window }, value: ip },
+      {
+        spec: { kind, captchaType, dimension: "userAccount", window },
+        value: userAccount
+      }
+    );
+    if (captchaType !== "any") {
+      out.push(
+        {
+          spec: { kind, captchaType: "any", dimension: "ip", window },
+          value: ip
+        },
+        {
+          spec: {
+            kind,
+            captchaType: "any",
+            dimension: "userAccount",
+            window
+          },
+          value: userAccount
+        }
+      );
+    }
+  }
+  return out;
+};
+export {
+  UsageCounters,
+  buildAllWindowIncrements
+};