@prosopo/procaptcha-common 2.9.19 → 2.10.17

package/dist/tests/state-builder.test.js

@@ -0,0 +1,193 @@
+import { describe, expect, it, vi } from "vitest";
+import { buildUpdateState, useProcaptcha } from "../state/builder.js";
+describe("state/builder", () => {
+    describe("buildUpdateState", () => {
+        it("should mutate state and call onStateUpdate with partial state", () => {
+            const state = {
+                isHuman: false,
+                index: 0,
+                solutions: [],
+                captchaApi: undefined,
+                showModal: false,
+                challenge: undefined,
+                loading: false,
+                account: undefined,
+                dappAccount: undefined,
+                submission: undefined,
+                timeout: undefined,
+                successfullChallengeTimeout: undefined,
+                sendData: false,
+                attemptCount: 0,
+                error: undefined,
+                sessionId: undefined,
+            };
+            const onStateUpdate = vi.fn();
+            const updateState = buildUpdateState(state, onStateUpdate);
+            const partialState = { isHuman: true, attemptCount: 1 };
+            updateState(partialState);
+            expect(state.isHuman).toBe(true);
+            expect(state.attemptCount).toBe(1);
+            expect(onStateUpdate).toHaveBeenCalledWith(partialState);
+        });
+        it("should handle multiple property updates in order", () => {
+            const state = {
+                isHuman: false,
+                index: 0,
+                solutions: [],
+                captchaApi: undefined,
+                showModal: false,
+                challenge: undefined,
+                loading: false,
+                account: undefined,
+                dappAccount: undefined,
+                submission: undefined,
+                timeout: undefined,
+                successfullChallengeTimeout: undefined,
+                sendData: false,
+                attemptCount: 0,
+                error: undefined,
+                sessionId: undefined,
+            };
+            const onStateUpdate = vi.fn();
+            const updateState = buildUpdateState(state, onStateUpdate);
+            updateState({ loading: true, index: 5, showModal: true });
+            expect(state.loading).toBe(true);
+            expect(state.index).toBe(5);
+            expect(state.showModal).toBe(true);
+        });
+        it("should update error state correctly", () => {
+            const state = {
+                isHuman: false,
+                index: 0,
+                solutions: [],
+                captchaApi: undefined,
+                showModal: false,
+                challenge: undefined,
+                loading: false,
+                account: undefined,
+                dappAccount: undefined,
+                submission: undefined,
+                timeout: undefined,
+                successfullChallengeTimeout: undefined,
+                sendData: false,
+                attemptCount: 0,
+                error: undefined,
+                sessionId: undefined,
+            };
+            const onStateUpdate = vi.fn();
+            const updateState = buildUpdateState(state, onStateUpdate);
+            const errorObj = { message: "Test error", key: "test" };
+            updateState({ error: errorObj });
+            expect(state.error).toEqual(errorObj);
+            expect(onStateUpdate).toHaveBeenCalledWith({ error: errorObj });
+        });
+    });
+    describe("useProcaptcha", () => {
+        it("should initialize with default state values", () => {
+            const useState = vi.fn((defaultValue) => [defaultValue, vi.fn()]);
+            const useRef = vi.fn((defaultValue) => ({ current: defaultValue }));
+            const [state, updateFn] = useProcaptcha(useState, useRef);
+            expect(state.isHuman).toBe(false);
+            expect(state.index).toBe(0);
+            expect(state.solutions).toEqual([]);
+            expect(state.showModal).toBe(false);
+            expect(state.loading).toBe(false);
+            expect(state.sendData).toBe(false);
+            expect(state.attemptCount).toBe(0);
+            expect(state.account).toBeUndefined();
+            expect(state.captchaApi).toBeUndefined();
+            expect(state.challenge).toBeUndefined();
+            expect(state.error).toBeUndefined();
+            expect(typeof updateFn).toBe("function");
+        });
+        it("should call appropriate setters when updating state", () => {
+            const setters = {};
+            const useState = vi.fn((defaultValue) => {
+                const key = typeof defaultValue === "boolean"
+                    ? `boolean-${defaultValue}`
+                    : typeof defaultValue === "number"
+                        ? `number-${defaultValue}`
+                        : Array.isArray(defaultValue)
+                            ? "array"
+                            : "other";
+                if (!setters[key]) {
+                    setters[key] = vi.fn();
+                }
+                return [defaultValue, setters[key]];
+            });
+            const useRef = vi.fn((defaultValue) => ({ current: defaultValue }));
+            const [state, updateFn] = useProcaptcha(useState, useRef);
+            updateFn({
+                isHuman: true,
+                index: 5,
+                loading: true,
+                attemptCount: 3,
+            });
+            expect(setters["boolean-false"]).toHaveBeenCalledWith(true);
+            expect(setters["number-0"]).toHaveBeenCalledWith(5);
+            expect(setters["number-0"]).toHaveBeenCalledWith(3);
+        });
+        it("should handle solutions array correctly with slice", () => {
+            const setSolutions = vi.fn();
+            let solutionsValue = [];
+            const useState = vi.fn((defaultValue) => {
+                if (Array.isArray(defaultValue)) {
+                    return [
+                        solutionsValue,
+                        (newValue) => {
+                            solutionsValue = newValue;
+                            setSolutions(newValue);
+                        },
+                    ];
+                }
+                return [defaultValue, vi.fn()];
+            });
+            const useRef = vi.fn((defaultValue) => ({ current: defaultValue }));
+            const [state, updateFn] = useProcaptcha(useState, useRef);
+            const newSolutions = [[["test", 1, 2]]];
+            updateFn({ solutions: newSolutions });
+            expect(setSolutions).toHaveBeenCalled();
+            const callArg = setSolutions.mock.calls[0]?.[0];
+            expect(callArg).toBeDefined();
+            expect(callArg).not.toBe(newSolutions);
+            expect(callArg).toEqual(newSolutions);
+        });
+        it("should not call setters for undefined values in partial update", () => {
+            const setIsHuman = vi.fn();
+            const setIndex = vi.fn();
+            let isHumanSetter;
+            let indexSetter;
+            const useState = vi.fn((defaultValue) => {
+                if (defaultValue === false) {
+                    isHumanSetter = setIsHuman;
+                    return [false, setIsHuman];
+                }
+                if (defaultValue === 0) {
+                    indexSetter = setIndex;
+                    return [0, setIndex];
+                }
+                return [defaultValue, vi.fn()];
+            });
+            const useRef = vi.fn((defaultValue) => ({ current: defaultValue }));
+            const [state, updateFn] = useProcaptcha(useState, useRef);
+            updateFn({ isHuman: true });
+            expect(setIsHuman).toHaveBeenCalledWith(true);
+            expect(setIndex).not.toHaveBeenCalled();
+        });
+        it("should handle error state update", () => {
+            const setError = vi.fn();
+            const useState = vi.fn((defaultValue) => {
+                if (defaultValue === undefined && setError.mock.calls.length === 0) {
+                    return [undefined, setError];
+                }
+                return [defaultValue, vi.fn()];
+            });
+            const useRef = vi.fn((defaultValue) => ({ current: defaultValue }));
+            const [state, updateFn] = useProcaptcha(useState, useRef);
+            const errorObj = { message: "Test error", key: "testKey" };
+            updateFn({ error: errorObj });
+            expect(setError).toHaveBeenCalledWith(errorObj);
+        });
+    });
+});
+//# sourceMappingURL=state-builder.test.js.map

package/dist/tests/state-builder.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-builder.test.js","sourceRoot":"","sources":["../../src/tests/state-builder.test.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEtE,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC9B,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;QACjC,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;YACxE,MAAM,KAAK,GAAoB;gBAC9B,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,CAAC;gBACR,SAAS,EAAE,EAAE;gBACb,UAAU,EAAE,SAAS;gBACrB,SAAS,EAAE,KAAK;gBAChB,SAAS,EAAE,SAAS;gBACpB,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,SAAS;gBAClB,WAAW,EAAE,SAAS;gBACtB,UAAU,EAAE,SAAS;gBACrB,OAAO,EAAE,SAAS;gBAClB,2BAA2B,EAAE,SAAS;gBACtC,QAAQ,EAAE,KAAK;gBACf,YAAY,EAAE,CAAC;gBACf,KAAK,EAAE,SAAS;gBAChB,SAAS,EAAE,SAAS;aACpB,CAAC;YAEF,MAAM,aAAa,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9B,MAAM,WAAW,GAAG,gBAAgB,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;YAE3D,MAAM,YAAY,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;YACxD,WAAW,CAAC,YAAY,CAAC,CAAC;YAE1B,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACnC,MAAM,CAAC,aAAa,CAAC,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;YAC3D,MAAM,KAAK,GAAoB;gBAC9B,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,CAAC;gBACR,SAAS,EAAE,EAAE;gBACb,UAAU,EAAE,SAAS;gBACrB,SAAS,EAAE,KAAK;gBAChB,SAAS,EAAE,SAAS;gBACpB,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,SAAS;gBAClB,WAAW,EAAE,SAAS;gBACtB,UAAU,EAAE,SAAS;gBACrB,OAAO,EAAE,SAAS;gBAClB,2BAA2B,EAAE,SAAS;gBACtC,QAAQ,EAAE,KAAK;gBACf,YAAY,EAAE,CAAC;gBACf,KAAK,EAAE,SAAS;gBAChB,SAAS,EAAE,SAAS;aACpB,CAAC;YAEF,MAAM,aAAa,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9B,MAAM,WAAW,GAAG,gBAAgB,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;YAE3D,WAAW,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAE1D,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC5B,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qCAAqC,EAAE,GAAG,EAAE;YAC9C,MAAM,KAAK,GAAoB;gBAC9B,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,CAAC;gBACR,SAAS,EAAE,EAAE;gBACb,UAAU,EAAE,SAAS;gBACrB,SAAS,EAAE,KAAK;gBAChB,SAAS,EAAE,SAAS;gBACpB,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,SAAS;gBAClB,WAAW,EAAE,SAAS;gBACtB,UAAU,EAAE,SAAS;gBACrB,OAAO,EAAE,SAAS;gBAClB,2BAA2B,EAAE,SAAS;gBACtC,QAAQ,EAAE,KAAK;gBACf,YAAY,EAAE,CAAC;gBACf,KAAK,EAAE,SAAS;gBAChB,SAAS,EAAE,SAAS;aACpB,CAAC;YAEF,MAAM,aAAa,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;YAC9B,MAAM,WAAW,GAAG,gBAAgB,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;YAE3D,MAAM,QAAQ,GAAG,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;YACxD,WAAW,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YAEjC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;YACtC,MAAM,CAAC,aAAa,CAAC,CAAC,oBAAoB,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QACjE,CAAC,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;QAC9B,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;YACtD,MAAM,QAAQ,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;YAClE,MAAM,MAAM,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;YAGpE,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,aAAa,CAAC,QAAe,EAAE,MAAa,CAAC,CAAC;YAExE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAClC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC5B,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACpC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACpC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAClC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACnC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACnC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,aAAa,EAAE,CAAC;YACtC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,aAAa,EAAE,CAAC;YACzC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,aAAa,EAAE,CAAC;YACxC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,aAAa,EAAE,CAAC;YACpC,MAAM,CAAC,OAAO,QAAQ,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC1C,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;YAE9D,MAAM,OAAO,GAAwB,EAAE,CAAC;YAExC,MAAM,QAAQ,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,YAAY,EAAE,EAAE;gBAEvC,MAAM,GAAG,GACR,OAAO,YAAY,KAAK,SAAS;oBAChC,CAAC,CAAC,WAAW,YAAY,EAAE;oBAC3B,CAAC,CAAC,OAAO,YAAY,KAAK,QAAQ;wBACjC,CAAC,CAAC,UAAU,YAAY,EAAE;wBAC1B,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC;4BAC5B,CAAC,CAAC,OAAO;4BACT,CAAC,CAAC,OAAO,CAAC;gBAEd,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;oBACnB,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;gBACxB,CAAC;gBACD,OAAO,CAAC,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;YACrC,CAAC,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;YAGpE,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,aAAa,CAAC,QAAe,EAAE,MAAa,CAAC,CAAC;YAExE,QAAQ,CAAC;gBACR,OAAO,EAAE,IAAI;gBACb,KAAK,EAAE,CAAC;gBACR,OAAO,EAAE,IAAI;gBACb,YAAY,EAAE,CAAC;aACf,CAAC,CAAC;YAIH,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;YAE5D,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC;YACpD,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;YAC7D,MAAM,YAAY,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;YAE7B,IAAI,cAAc,GAAU,EAAE,CAAC;YAE/B,MAAM,QAAQ,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,YAAY,EAAE,EAAE;gBACvC,IAAI,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;oBACjC,OAAO;wBACN,cAAc;wBAEd,CAAC,QAAa,EAAE,EAAE;4BACjB,cAAc,GAAG,QAAQ,CAAC;4BAC1B,YAAY,CAAC,QAAQ,CAAC,CAAC;wBACxB,CAAC;qBACD,CAAC;gBACH,CAAC;gBACD,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YAChC,CAAC,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;YAGpE,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,aAAa,CAAC,QAAe,EAAE,MAAa,CAAC,CAAC;YAExE,MAAM,YAAY,GAAiC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;YACtE,QAAQ,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,CAAC;YAEtC,MAAM,CAAC,YAAY,CAAC,CAAC,gBAAgB,EAAE,CAAC;YAExC,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAChD,MAAM,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;YAC9B,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACvC,MAAM,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QACvC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;YACzE,MAAM,UAAU,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3B,MAAM,QAAQ,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;YAGzB,IAAI,aAAkB,CAAC;YAEvB,IAAI,WAAgB,CAAC;YAErB,MAAM,QAAQ,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,YAAY,EAAE,EAAE;gBACvC,IAAI,YAAY,KAAK,KAAK,EAAE,CAAC;oBAC5B,aAAa,GAAG,UAAU,CAAC;oBAC3B,OAAO,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;gBAC5B,CAAC;gBACD,IAAI,YAAY,KAAK,CAAC,EAAE,CAAC;oBACxB,WAAW,GAAG,QAAQ,CAAC;oBACvB,OAAO,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;gBACtB,CAAC;gBACD,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YAChC,CAAC,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;YAGpE,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,aAAa,CAAC,QAAe,EAAE,MAAa,CAAC,CAAC;YAExE,QAAQ,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;YAE5B,MAAM,CAAC,UAAU,CAAC,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;YAC9C,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QACzC,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,kCAAkC,EAAE,GAAG,EAAE;YAC3C,MAAM,QAAQ,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;YAEzB,MAAM,QAAQ,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,YAAY,EAAE,EAAE;gBACvC,IAAI,YAAY,KAAK,SAAS,IAAI,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACpE,OAAO,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;gBAC9B,CAAC;gBACD,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YAChC,CAAC,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;YAGpE,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,aAAa,CAAC,QAAe,EAAE,MAAa,CAAC,CAAC;YAExE,MAAM,QAAQ,GAAG,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC;YAC3D,QAAQ,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;YAE9B,MAAM,CAAC,QAAQ,CAAC,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;QACjD,CAAC,CAAC,CAAC;IACJ,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/tests/window.test.d.ts

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

package/dist/tests/window.test.d.ts.map

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

package/dist/tests/window.test.js

@@ -0,0 +1,80 @@
+import { afterEach, describe, expect, it } from "vitest";
+import { getWindowCallback, isSecureBrowserContext, } from "../elements/window.js";
+describe("elements/window", () => {
+    describe("getWindowCallback", () => {
+        const originalWindow = global.window;
+        afterEach(() => {
+            const keys = Object.keys(window);
+            for (const key of keys) {
+                if (key.startsWith("test")) {
+                    delete window[key];
+                }
+            }
+        });
+        it("should retrieve a function from window object", () => {
+            const testFn = () => "test";
+            window.testCallback = testFn;
+            const result = getWindowCallback("testCallback");
+            expect(result).toBe(testFn);
+        });
+        it("should handle window. prefix in callback name", () => {
+            const testFn = () => "test";
+            window.testCallback = testFn;
+            const result = getWindowCallback("window.testCallback");
+            expect(result).toBe(testFn);
+        });
+        it("should throw error if callback is not a function", () => {
+            window.testCallback = "not a function";
+            expect(() => getWindowCallback("testCallback")).toThrow("Callback testCallback is not defined on the window object");
+        });
+        it("should throw error if callback does not exist", () => {
+            expect(() => getWindowCallback("nonExistentCallback")).toThrow("Callback nonExistentCallback is not defined on the window object");
+        });
+        it("should handle callback that is undefined", () => {
+            window.testCallback = undefined;
+            expect(() => getWindowCallback("testCallback")).toThrow("Callback testCallback is not defined on the window object");
+        });
+        it("should handle callback that is null", () => {
+            window.testCallback = null;
+            expect(() => getWindowCallback("testCallback")).toThrow("Callback testCallback is not defined on the window object");
+        });
+        it("should work with arrow functions", () => {
+            const arrowFn = (x) => x * 2;
+            window.testArrowCallback = arrowFn;
+            const result = getWindowCallback("testArrowCallback");
+            expect(result).toBe(arrowFn);
+            expect(result(5)).toBe(10);
+        });
+        it("should work with regular functions", () => {
+            function regularFn(x) {
+                return x * 2;
+            }
+            window.testRegularCallback = regularFn;
+            const result = getWindowCallback("testRegularCallback");
+            expect(result).toBe(regularFn);
+            expect(result(5)).toBe(10);
+        });
+    });
+    describe("isSecureBrowserContext", () => {
+        const originalIsSecureContext = window.isSecureContext;
+        const setIsSecureContext = (value) => {
+            Object.defineProperty(window, "isSecureContext", {
+                value,
+                configurable: true,
+                writable: true,
+            });
+        };
+        afterEach(() => {
+            setIsSecureContext(originalIsSecureContext);
+        });
+        it("should return true in a secure context (HTTPS/localhost)", () => {
+            setIsSecureContext(true);
+            expect(isSecureBrowserContext()).toBe(true);
+        });
+        it("should return false in an insecure context (plain HTTP)", () => {
+            setIsSecureContext(false);
+            expect(isSecureBrowserContext()).toBe(false);
+        });
+    });
+});
+//# sourceMappingURL=window.test.js.map

package/dist/tests/window.test.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@prosopo/procaptcha-common",
-	"version": "2.9.19",
+	"version": "2.10.17",
 	"author": "PROSOPO LIMITED <info@prosopo.io>",
 	"license": "Apache-2.0",
 	"main": "dist/index.js",
@@ -21,7 +21,8 @@
 	"source": "./src/index.ts",
 	"scripts": {
 		"clean": "del-cli --verbose dist tsconfig.tsbuildinfo",
-		"build": "NODE_ENV=${NODE_ENV:-development}; vite build --config vite.esm.config.ts --mode $NODE_ENV",
+		"build": "npm run build:cross-env -- --mode ${NODE_ENV:-development}",
+		"build:cross-env": "vite build --config vite.esm.config.ts",
 		"build:tsc": "tsc --build --verbose",
 		"build:cjs": "NODE_ENV=${NODE_ENV:-development}; vite build --config vite.cjs.config.ts --mode $NODE_ENV",
 		"typecheck": "tsc --project tsconfig.types.json",
@@ -33,17 +34,19 @@
 	"dependencies": {
 		"@emotion/react": "11.11.1",
 		"@emotion/styled": "11.11.0",
-		"@prosopo/account": "2.7.43",
-		"@prosopo/load-balancer": "2.8.13",
-		"@prosopo/types": "3.6.4",
-		"@prosopo/widget-skeleton": "2.7.12",
-		"react": "18.3.1"
+		"@prosopo/account": "2.8.35",
+		"@prosopo/load-balancer": "2.9.10",
+		"@prosopo/types": "4.3.0",
+		"@prosopo/widget-skeleton": "2.8.3",
+		"react": "18.3.1",
+		"react-dom": "18.3.1"
 	},
 	"devDependencies": {
-		"@prosopo/config": "3.1.26",
+		"@prosopo/config": "3.3.1",
 		"@types/jsdom": "21.1.7",
 		"@types/node": "22.10.2",
 		"@types/react": "18.3.1",
+		"@types/react-dom": "18.3.1",
 		"@vitest/coverage-v8": "3.2.4",
 		"concurrently": "9.0.1",
 		"del-cli": "6.0.0",
@@ -58,7 +61,8 @@
 	},
 	"repository": {
 		"type": "git",
-		"url": "git+https://github.com/prosopo/captcha.git"
+		"url": "git+https://github.com/prosopo/captcha.git",
+		"directory": "packages/procaptcha-common"
 	},
 	"bugs": {
 		"url": "https://github.com/prosopo/captcha/issues"

package/src/callbacks/defaultCallbacks.ts

@@ -0,0 +1,197 @@
+// Copyright 2021-2026 Prosopo (UK) Ltd.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+import {
+	ApiParams,
+	type Callbacks,
+	type ProcaptchaRenderOptions,
+	type ProcaptchaToken,
+} from "@prosopo/types";
+import { getParentForm, removeProcaptchaResponse } from "../elements/form.js";
+import { getWindowCallback } from "../elements/window.js";
+
+export const getDefaultCallbacks = (element?: Element): Callbacks => ({
+	onHuman: (token: ProcaptchaToken) => handleOnHuman(token, element),
+	onChallengeExpired: () => {
+		removeProcaptchaResponse();
+		console.log("Challenge expired");
+	},
+	onExtensionNotFound: () => {
+		console.error("Extension not found");
+	},
+	onExpired: () => {
+		removeProcaptchaResponse();
+	},
+	onError: (error: Error) => {
+		removeProcaptchaResponse();
+		console.error(error);
+	},
+	onClose: () => {
+		console.log("Challenge closed");
+	},
+	onOpen: () => {
+		console.log("Challenge opened");
+	},
+	onFailed: () => {
+		alert("Captcha challenge failed. Please try again");
+		console.log("Challenge failed");
+	},
+	onReset: () => {
+		removeProcaptchaResponse();
+		console.log("Captcha widget reset");
+	},
+	onReload: () => {
+		console.log("Challenge reloaded");
+	},
+});
+
+/**
+ * Set the a user callback function for an element. Data tags take precedence over renderOptions.
+ */
+const getUserCallback = (
+	callback: string,
+	element: Element,
+	callbackFnOrName: string | ((token: string) => void) | undefined,
+) => {
+	const callbackFnName = element.getAttribute(`data-${callback}`);
+	if (callbackFnName) {
+		const callbackFn = getWindowCallback(callbackFnName);
+		if (callbackFn) {
+			return callbackFn;
+		}
+	}
+	if (typeof callbackFnOrName === "function") {
+		return callbackFnOrName;
+	}
+	if (typeof callbackFnOrName === "string") {
+		return getWindowCallback(callbackFnOrName);
+	}
+};
+
+export function setUserCallbacks(
+	renderOptions: ProcaptchaRenderOptions | undefined,
+	callbacks: Callbacks,
+	element: Element,
+) {
+	const humanCallback = getUserCallback(
+		"callback",
+		element,
+		renderOptions?.callback,
+	);
+	if (humanCallback) {
+		// wrap the user's callback in a function that also calls handleOnHuman
+		callbacks.onHuman = (token: ProcaptchaToken) => {
+			handleOnHuman(token, element);
+			humanCallback(token);
+		};
+	}
+
+	const chalExpiredCallback = getUserCallback(
+		"chalexpired-callback",
+		element,
+		renderOptions?.["chalexpired-callback"],
+	);
+	if (chalExpiredCallback) {
+		callbacks.onChallengeExpired = () => {
+			removeProcaptchaResponse();
+			chalExpiredCallback();
+		};
+	}
+
+	const expiredCallback = getUserCallback(
+		"expired-callback",
+		element,
+		renderOptions?.["expired-callback"],
+	);
+	if (expiredCallback) {
+		callbacks.onExpired = () => {
+			removeProcaptchaResponse();
+			expiredCallback();
+		};
+	}
+
+	const errorCallback = getUserCallback(
+		"error-callback",
+		element,
+		renderOptions?.["error-callback"],
+	);
+	if (errorCallback) {
+		callbacks.onError = (error: Error) => {
+			removeProcaptchaResponse();
+			errorCallback(error);
+		};
+	}
+
+	const closeCallback = getUserCallback(
+		"close-callback",
+		element,
+		renderOptions?.["close-callback"],
+	);
+	if (closeCallback) {
+		callbacks.onClose = () => {
+			closeCallback();
+		};
+	}
+
+	const openCallback = getUserCallback(
+		"open-callback",
+		element,
+		renderOptions?.["open-callback"],
+	);
+	if (openCallback) {
+		callbacks.onOpen = () => {
+			openCallback();
+		};
+	}
+
+	const failedCallback = getUserCallback(
+		"failed-callback",
+		element,
+		renderOptions?.["failed-callback"],
+	);
+	if (failedCallback) {
+		callbacks.onFailed = () => {
+			failedCallback();
+		};
+	}
+
+	const resetCallback = getUserCallback(
+		"reset-callback",
+		element,
+		renderOptions?.["reset-callback"],
+	);
+	if (resetCallback) {
+		callbacks.onReset = () => {
+			removeProcaptchaResponse();
+			resetCallback();
+		};
+	}
+}
+
+const handleOnHuman = (token: ProcaptchaToken, element?: Element) => {
+	removeProcaptchaResponse();
+	if (element) {
+		const form = getParentForm(element);
+
+		if (!form) {
+			console.error("Parent form not found for the element:", element);
+			return;
+		}
+
+		const input = document.createElement("input");
+		input.type = "hidden";
+		input.name = ApiParams.procaptchaResponse;
+		input.value = token;
+		form.appendChild(input);
+	}
+};

package/src/callbacks/defaultEvents.ts

@@ -0,0 +1,21 @@
+// Copyright 2021-2026 Prosopo (UK) Ltd.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+import type { Callbacks } from "@prosopo/types";
+import { getDefaultCallbacks } from "./defaultCallbacks.js";
+
+export const getDefaultEvents = (callbacks: Partial<Callbacks>) => ({
+	...getDefaultCallbacks(undefined),
+	...callbacks,
+});

package/src/elements/form.ts

@@ -0,0 +1,41 @@
+// Copyright 2021-2026 Prosopo (UK) Ltd.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+import { ApiParams } from "@prosopo/types";
+
+type ParentForm = HTMLFormElement | null;
+
+export function getParentForm(widgetElement: Element): ParentForm {
+	const parentForm = widgetElement.closest("form") as ParentForm;
+
+	if (parentForm) {
+		return parentForm;
+	}
+
+	// fallback for widgets inside a shadow DOM
+
+	const rootWidgetNode = widgetElement.getRootNode();
+	if (rootWidgetNode instanceof ShadowRoot) {
+		return rootWidgetNode.host.closest("form") as ParentForm;
+	}
+
+	return null;
+}
+
+export const removeProcaptchaResponse = () => {
+	const element = Array.from(
+		document.getElementsByName(ApiParams.procaptchaResponse),
+	);
+	element.map((el) => el.remove());
+};

package/src/elements/window.ts

@@ -0,0 +1,39 @@
+// Copyright 2021-2026 Prosopo (UK) Ltd.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+export const getWindowCallback = (callbackName: string) => {
+	// biome-ignore lint/suspicious/noExplicitAny: TODO fix any
+	const fn = (window as any)[callbackName.replace("window.", "")];
+	if (typeof fn !== "function") {
+		throw new Error(
+			`Callback ${callbackName} is not defined on the window object`,
+		);
+	}
+	return fn;
+};
+
+/**
+ * Procaptcha depends on secure-context-only browser APIs (e.g. SubtleCrypto)
+ * to run a challenge. These are unavailable when the widget is served over
+ * plain HTTP, which otherwise surfaces as a cryptic provider-selection
+ * failure. The browser already treats HTTPS and localhost as secure contexts,
+ * so this only flags genuine HTTP origins. Non-browser (SSR) environments are
+ * treated as secure since the HTTP restriction does not apply there.
+ */
+export const isSecureBrowserContext = (): boolean => {
+	if (typeof window === "undefined") {
+		return true;
+	}
+	return window.isSecureContext === true;
+};