@hexclave/shared 1.0.0

package/dist/esm/utils/strings.nicify.test.js

@@ -0,0 +1,243 @@
+import { describe, expect, test } from "vitest";
+import { deindent, nicify } from "./strings.js";
+
+//#region src/utils/strings.nicify.test.ts
+describe("nicify", () => {
+	describe("primitive values", () => {
+		test("numbers", () => {
+			expect(nicify(123)).toBe("123");
+			expect(nicify(123n)).toBe("123n");
+		});
+		test("strings", () => {
+			expect(nicify("hello")).toBe("\"hello\"");
+		});
+		test("booleans", () => {
+			expect(nicify(true)).toBe("true");
+			expect(nicify(false)).toBe("false");
+		});
+		test("null and undefined", () => {
+			expect(nicify(null)).toBe("null");
+			expect(nicify(void 0)).toBe("undefined");
+		});
+		test("symbols", () => {
+			expect(nicify(Symbol("test"))).toBe("Symbol(test)");
+		});
+	});
+	describe("arrays", () => {
+		test("empty array", () => {
+			expect(nicify([])).toBe("[]");
+		});
+		test("single-element array", () => {
+			expect(nicify([1])).toBe("[1]");
+		});
+		test("single-element array with long content", () => {
+			expect(nicify(["123123123123123"])).toBe("[\"123123123123123\"]");
+		});
+		test("flat array", () => {
+			expect(nicify([
+				1,
+				2,
+				3
+			])).toBe("[1, 2, 3]");
+		});
+		test("longer array", () => {
+			expect(nicify([
+				1e4,
+				2,
+				3
+			])).toBe(deindent`
+        [
+          10000,
+          2,
+          3,
+        ]
+      `);
+		});
+		test("nested array", () => {
+			expect(nicify([1, [2, 3]])).toBe(deindent`
+        [
+          1,
+          [2, 3],
+        ]
+      `);
+		});
+	});
+	describe("objects", () => {
+		test("empty object", () => {
+			expect(nicify({})).toBe("{}");
+		});
+		test("simple object", () => {
+			expect(nicify({ a: 1 })).toBe("{ \"a\": 1 }");
+		});
+		test("multiline object", () => {
+			expect(nicify({
+				a: 1,
+				b: 2
+			})).toBe(deindent`
+        {
+          "a": 1,
+          "b": 2,
+        }
+      `);
+		});
+	});
+	describe("custom classes", () => {
+		test("class instance", () => {
+			class TestClass {
+				constructor(value) {
+					this.value = value;
+				}
+			}
+			expect(nicify(new TestClass(42))).toBe("TestClass { \"value\": 42 }");
+		});
+	});
+	describe("built-in objects", () => {
+		test("URL", () => {
+			expect(nicify(new URL("https://example.com"))).toBe("URL(\"https://example.com/\")");
+		});
+		test("TypedArrays", () => {
+			expect(nicify(new Uint8Array([
+				1,
+				2,
+				3
+			]))).toBe("Uint8Array([1,2,3])");
+			expect(nicify(new Int32Array([
+				1,
+				2,
+				3
+			]))).toBe("Int32Array([1,2,3])");
+		});
+		test("Error objects", () => {
+			expect(nicify({ error: /* @__PURE__ */ new Error("test error") })).toMatch(new RegExp(deindent`
+        ^\{
+          "error": Error: test error
+            Stack:
+              at (.|\\n)*
+        \}$
+      `));
+		});
+		test("Error objects with cause and an extra property", () => {
+			const error = new Error("test error", { cause: /* @__PURE__ */ new Error("cause") });
+			error.extra = "something";
+			expect(nicify(error, { lineIndent: "--" })).toMatch(new RegExp(deindent`
+        ^Error: test error
+        --Stack:
+        ----at (.|\\n)+
+        --Extra properties: \{ "extra": "something" \}
+        --Cause:
+        ----Error: cause
+        ------Stack:
+        --------at (.|\\n)+$
+      `));
+		});
+		test("Headers", () => {
+			const headers = new Headers();
+			headers.append("Content-Type", "application/json");
+			headers.append("Accept", "text/plain");
+			expect(nicify(headers)).toBe(deindent`
+        Headers {
+          "accept": "text/plain",
+          "content-type": "application/json",
+        }`);
+		});
+	});
+	describe("multiline strings", () => {
+		test("basic multiline", () => {
+			expect(nicify("line1\nline2")).toBe("deindent`\n  line1\n  line2\n`");
+		});
+		test("multiline with trailing newline", () => {
+			expect(nicify("line1\nline2\n")).toBe("deindent`\n  line1\n  line2\n` + \"\\n\"");
+		});
+		test("multiline with dollar sign", () => {
+			expect(nicify("a\n$b\nc")).toBe("deindent`\n  a\n  $b\n  c\n`");
+		});
+		test("multiline with dollar sign interpolation", () => {
+			expect(nicify("a\n${b\nc")).toBe("deindent`\n  a\n  \\${b\n  c\n`");
+		});
+	});
+	describe("circular references", () => {
+		test("object with self reference", () => {
+			const circular = { a: 1 };
+			circular.self = circular;
+			expect(nicify(circular)).toBe(deindent`
+        {
+          "a": 1,
+          "self": Ref<value>,
+        }`);
+		});
+	});
+	describe("configuration options", () => {
+		test("maxDepth", () => {
+			expect(nicify({ a: { b: { c: { d: { e: 1 } } } } }, { maxDepth: 2 })).toBe("{ \"a\": { \"b\": { ... } } }");
+		});
+		test("lineIndent", () => {
+			expect(nicify({
+				a: 1,
+				b: 2
+			}, { lineIndent: "    " })).toBe(deindent`
+        {
+            "a": 1,
+            "b": 2,
+        }
+      `);
+		});
+		test("hideFields", () => {
+			expect(nicify({
+				a: 1,
+				b: 2,
+				secret: "hidden"
+			}, { hideFields: ["secret"] })).toBe(deindent`
+        {
+          "a": 1,
+          "b": 2,
+          <some fields may have been hidden>,
+        }
+      `);
+		});
+	});
+	describe("custom overrides", () => {
+		test("override with custom type", () => {
+			expect(nicify({ type: "special" }, { overrides: ((value) => {
+				if (typeof value === "object" && value && "type" in value && value.type === "special") return "SPECIAL";
+				return null;
+			}) })).toBe("SPECIAL");
+		});
+	});
+	describe("functions", () => {
+		test("named function", () => {
+			expect(nicify(function namedFunction() {})).toBe("function namedFunction(...) { ... }");
+		});
+		test("arrow function", () => {
+			expect(nicify(() => {})).toBe("(...) => { ... }");
+		});
+	});
+	describe("Nicifiable interface", () => {
+		test("object implementing Nicifiable", () => {
+			expect(nicify({
+				value: 42,
+				getNicifiableKeys() {
+					return ["value"];
+				},
+				getNicifiedObjectExtraLines() {
+					return ["// custom comment"];
+				}
+			})).toBe(deindent`
+        {
+          "value": 42,
+          // custom comment,
+        }
+      `);
+		});
+	});
+	describe("unknown types", () => {
+		test("object without prototype", () => {
+			const unknownType = Object.create(null);
+			unknownType.value = "test";
+			expect(nicify(unknownType)).toBe("{ \"value\": \"test\" }");
+		});
+	});
+});
+
+//#endregion
+export {  };
+//# sourceMappingURL=strings.nicify.test.js.map

package/dist/esm/utils/strings.nicify.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strings.nicify.test.js","names":[],"sources":["../../../src/utils/strings.nicify.test.ts"],"sourcesContent":["import { describe, expect, test } from \"vitest\";\nimport { NicifyOptions, deindent, nicify } from \"./strings\";\n\ndescribe(\"nicify\", () => {\n  describe(\"primitive values\", () => {\n    test(\"numbers\", () => {\n      expect(nicify(123)).toBe(\"123\");\n      expect(nicify(123n)).toBe(\"123n\");\n    });\n\n    test(\"strings\", () => {\n      expect(nicify(\"hello\")).toBe('\"hello\"');\n    });\n\n    test(\"booleans\", () => {\n      expect(nicify(true)).toBe(\"true\");\n      expect(nicify(false)).toBe(\"false\");\n    });\n\n    test(\"null and undefined\", () => {\n      expect(nicify(null)).toBe(\"null\");\n      expect(nicify(undefined)).toBe(\"undefined\");\n    });\n\n    test(\"symbols\", () => {\n      expect(nicify(Symbol(\"test\"))).toBe(\"Symbol(test)\");\n    });\n  });\n\n  describe(\"arrays\", () => {\n    test(\"empty array\", () => {\n      expect(nicify([])).toBe(\"[]\");\n    });\n\n    test(\"single-element array\", () => {\n      expect(nicify([1])).toBe(\"[1]\");\n    });\n\n    test(\"single-element array with long content\", () => {\n      expect(nicify([\"123123123123123\"])).toBe('[\"123123123123123\"]');\n    });\n\n    test(\"flat array\", () => {\n      expect(nicify([1, 2, 3])).toBe(\"[1, 2, 3]\");\n    });\n\n    test(\"longer array\", () => {\n      expect(nicify([10000, 2, 3])).toBe(deindent`\n        [\n          10000,\n          2,\n          3,\n        ]\n      `);\n    });\n\n    test(\"nested array\", () => {\n      expect(nicify([1, [2, 3]])).toBe(deindent`\n        [\n          1,\n          [2, 3],\n        ]\n      `);\n    });\n  });\n\n  describe(\"objects\", () => {\n    test(\"empty object\", () => {\n      expect(nicify({})).toBe(\"{}\");\n    });\n\n    test(\"simple object\", () => {\n      expect(nicify({ a: 1 })).toBe('{ \"a\": 1 }');\n    });\n\n    test(\"multiline object\", () => {\n      expect(nicify({ a: 1, b: 2 })).toBe(deindent`\n        {\n          \"a\": 1,\n          \"b\": 2,\n        }\n      `);\n    });\n  });\n\n  describe(\"custom classes\", () => {\n    test(\"class instance\", () => {\n      class TestClass {\n        constructor(public value: number) {}\n      }\n      expect(nicify(new TestClass(42))).toBe('TestClass { \"value\": 42 }');\n    });\n  });\n\n  describe(\"built-in objects\", () => {\n    test(\"URL\", () => {\n      expect(nicify(new URL(\"https://example.com\"))).toBe('URL(\"https://example.com/\")');\n    });\n\n    test(\"TypedArrays\", () => {\n      expect(nicify(new Uint8Array([1, 2, 3]))).toBe(\"Uint8Array([1,2,3])\");\n      expect(nicify(new Int32Array([1, 2, 3]))).toBe(\"Int32Array([1,2,3])\");\n    });\n\n    test(\"Error objects\", () => {\n      const error = new Error(\"test error\");\n      const nicifiedError = nicify({ error });\n      expect(nicifiedError).toMatch(new RegExp(deindent`\n        ^\\{\n          \"error\": Error: test error\n            Stack:\n              at (.|\\\\n)*\n        \\}$\n      `));\n    });\n\n    test(\"Error objects with cause and an extra property\", () => {\n      const error = new Error(\"test error\", { cause: new Error(\"cause\") });\n      (error as any).extra = \"something\";\n      const nicifiedError = nicify(error, { lineIndent: \"--\" });\n      expect(nicifiedError).toMatch(new RegExp(deindent`\n        ^Error: test error\n        --Stack:\n        ----at (.|\\\\n)+\n        --Extra properties: \\{ \"extra\": \"something\" \\}\n        --Cause:\n        ----Error: cause\n        ------Stack:\n        --------at (.|\\\\n)+$\n      `));\n    });\n\n    test(\"Headers\", () => {\n      const headers = new Headers();\n      headers.append(\"Content-Type\", \"application/json\");\n      headers.append(\"Accept\", \"text/plain\");\n      expect(nicify(headers)).toBe(deindent`\n        Headers {\n          \"accept\": \"text/plain\",\n          \"content-type\": \"application/json\",\n        }`\n      );\n    });\n  });\n\n  describe(\"multiline strings\", () => {\n    test(\"basic multiline\", () => {\n      expect(nicify(\"line1\\nline2\")).toBe('deindent`\\n  line1\\n  line2\\n`');\n    });\n\n    test(\"multiline with trailing newline\", () => {\n      expect(nicify(\"line1\\nline2\\n\")).toBe('deindent`\\n  line1\\n  line2\\n` + \"\\\\n\"');\n    });\n\n    test(\"multiline with dollar sign\", () => {\n      expect(nicify(\"a\\n$b\\nc\")).toBe('deindent`\\n  a\\n  $b\\n  c\\n`');\n    });\n\n    test(\"multiline with dollar sign interpolation\", () => {\n      expect(nicify(\"a\\n${b\\nc\")).toBe('deindent`\\n  a\\n  \\\\${b\\n  c\\n`');\n    });\n  });\n\n  describe(\"circular references\", () => {\n    test(\"object with self reference\", () => {\n      const circular: any = { a: 1 };\n      circular.self = circular;\n      expect(nicify(circular)).toBe(deindent`\n        {\n          \"a\": 1,\n          \"self\": Ref<value>,\n        }`\n      );\n    });\n  });\n\n  describe(\"configuration options\", () => {\n    test(\"maxDepth\", () => {\n      const deep = { a: { b: { c: { d: { e: 1 } } } } };\n      expect(nicify(deep, { maxDepth: 2 })).toBe('{ \"a\": { \"b\": { ... } } }');\n    });\n\n    test(\"lineIndent\", () => {\n      expect(nicify({ a: 1, b: 2 }, { lineIndent: \"    \" })).toBe(deindent`\n        {\n            \"a\": 1,\n            \"b\": 2,\n        }\n      `);\n    });\n\n    test(\"hideFields\", () => {\n      expect(nicify({ a: 1, b: 2, secret: \"hidden\" }, { hideFields: [\"secret\"] })).toBe(deindent`\n        {\n          \"a\": 1,\n          \"b\": 2,\n          <some fields may have been hidden>,\n        }\n      `);\n    });\n  });\n\n  describe(\"custom overrides\", () => {\n    test(\"override with custom type\", () => {\n      expect(nicify({ type: \"special\" }, {\n        overrides: ((value: unknown) => {\n          if (typeof value === \"object\" && value && \"type\" in value && (value as any).type === \"special\") {\n            return \"SPECIAL\";\n          }\n          return null;\n        }) as NicifyOptions[\"overrides\"]\n      })).toBe(\"SPECIAL\");\n    });\n  });\n\n  describe(\"functions\", () => {\n    test(\"named function\", () => {\n      expect(nicify(function namedFunction() {})).toBe(\"function namedFunction(...) { ... }\");\n    });\n\n    test(\"arrow function\", () => {\n      expect(nicify(() => {})).toBe(\"(...) => { ... }\");\n    });\n  });\n\n  describe(\"Nicifiable interface\", () => {\n    test(\"object implementing Nicifiable\", () => {\n      const nicifiable = {\n        value: 42,\n        getNicifiableKeys() {\n          return [\"value\"];\n        },\n        getNicifiedObjectExtraLines() {\n          return [\"// custom comment\"];\n        }\n      };\n      expect(nicify(nicifiable)).toBe(deindent`\n        {\n          \"value\": 42,\n          // custom comment,\n        }\n      `);\n    });\n  });\n\n  describe(\"unknown types\", () => {\n    test(\"object without prototype\", () => {\n      const unknownType = Object.create(null);\n      unknownType.value = \"test\";\n      expect(nicify(unknownType)).toBe('{ \"value\": \"test\" }');\n    });\n  });\n});\n"],"mappings":"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"}

package/dist/esm/utils/telemetry.d.ts

@@ -0,0 +1,15 @@
+import { AttributeValue, Attributes, Span } from "@opentelemetry/api";
+
+//#region src/utils/telemetry.d.ts
+declare function withTraceSpan<P extends any[], T>(optionsOrDescription: string | {
+  description: string;
+  attributes?: Record<string, AttributeValue>;
+}, fn: (...args: P) => Promise<T>): (...args: P) => Promise<T>;
+declare function traceSpan<T>(optionsOrDescription: string | {
+  description: string;
+  attributes?: Record<string, AttributeValue>;
+}, fn: (span: Span) => Promise<T>): Promise<T>;
+declare function log(message: string, attributes: Attributes): void;
+//#endregion
+export { log, traceSpan, withTraceSpan };
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/esm/utils/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","names":[],"sources":["../../../src/utils/telemetry.tsx"],"mappings":";;;iBAMgB,aAAA,oBAAA,CAAkC,oBAAA;EAAiC,WAAA;EAAqB,UAAA,GAAa,MAAA,SAAe,cAAA;AAAA,GAAmB,EAAA,MAAQ,IAAA,EAAM,CAAA,KAAM,OAAA,CAAQ,CAAA,QAAS,IAAA,EAAM,CAAA,KAAM,OAAA,CAAQ,CAAA;AAAA,iBAM1L,SAAA,GAAA,CAAa,oBAAA;EAAiC,WAAA;EAAqB,UAAA,GAAa,MAAA,SAAe,cAAA;AAAA,GAAmB,EAAA,GAAK,IAAA,EAAM,IAAA,KAAS,OAAA,CAAQ,CAAA,IAAK,OAAA,CAAQ,CAAA;AAAA,iBAgBjK,GAAA,CAAI,OAAA,UAAiB,UAAA,EAAY,UAAA"}

package/dist/esm/utils/telemetry.js

@@ -0,0 +1,31 @@
+import { HexclaveAssertionError } from "./errors.js";
+import { getEnvVariable } from "./env.js";
+import { trace } from "@opentelemetry/api";
+
+//#region src/utils/telemetry.tsx
+const tracer = trace.getTracer("stack-tracer");
+function withTraceSpan(optionsOrDescription, fn) {
+	return async (...args) => {
+		return await traceSpan(optionsOrDescription, (span) => fn(...args));
+	};
+}
+async function traceSpan(optionsOrDescription, fn) {
+	let options = typeof optionsOrDescription === "string" ? { description: optionsOrDescription } : optionsOrDescription;
+	return await tracer.startActiveSpan(`STACK: ${options.description}`, async (span) => {
+		if (options.attributes) for (const [key, value] of Object.entries(options.attributes)) span.setAttribute(key, value);
+		try {
+			return await fn(span);
+		} finally {
+			span.end();
+		}
+	});
+}
+function log(message, attributes) {
+	const span = trace.getActiveSpan();
+	if (span) span.addEvent(message, attributes);
+	else if (getEnvVariable("STACK_SEED_MODE", "false") !== "true") throw new HexclaveAssertionError("No active span found");
+}
+
+//#endregion
+export { log, traceSpan, withTraceSpan };
+//# sourceMappingURL=telemetry.js.map

package/dist/esm/utils/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","names":[],"sources":["../../../src/utils/telemetry.tsx"],"sourcesContent":["import { Attributes, AttributeValue, Span, trace } from \"@opentelemetry/api\";\nimport { getEnvVariable } from \"./env\";\nimport { HexclaveAssertionError } from \"./errors\";\n\nconst tracer = trace.getTracer('stack-tracer');\n\nexport function withTraceSpan<P extends any[], T>(optionsOrDescription: string | { description: string, attributes?: Record<string, AttributeValue> }, fn: (...args: P) => Promise<T>): (...args: P) => Promise<T> {\n  return async (...args: P) => {\n    return await traceSpan(optionsOrDescription, (span) => fn(...args));\n  };\n}\n\nexport async function traceSpan<T>(optionsOrDescription: string | { description: string, attributes?: Record<string, AttributeValue> }, fn: (span: Span) => Promise<T>): Promise<T> {\n  let options = typeof optionsOrDescription === 'string' ? { description: optionsOrDescription } : optionsOrDescription;\n  return await tracer.startActiveSpan(`STACK: ${options.description}`, async (span) => {\n    if (options.attributes) {\n      for (const [key, value] of Object.entries(options.attributes)) {\n        span.setAttribute(key, value);\n      }\n    }\n    try {\n      return await fn(span);\n    } finally {\n      span.end();\n    }\n  });\n}\n\nexport function log(message: string, attributes: Attributes) {\n  const span = trace.getActiveSpan();\n  if (span) {\n    span.addEvent(message, attributes);\n    // Telemetry is not initialized while seeding, so we don't want to throw an error\n  } else if (getEnvVariable('STACK_SEED_MODE', 'false') !== 'true') {\n    throw new HexclaveAssertionError('No active span found');\n  }\n}\n"],"mappings":";;;;;AAIA,MAAM,SAAS,MAAM,UAAU,eAAe;AAE9C,SAAgB,cAAkC,sBAAqG,IAA4D;AACjN,QAAO,OAAO,GAAG,SAAY;AAC3B,SAAO,MAAM,UAAU,uBAAuB,SAAS,GAAG,GAAG,KAAK,CAAC;;;AAIvE,eAAsB,UAAa,sBAAqG,IAA4C;CAClL,IAAI,UAAU,OAAO,yBAAyB,WAAW,EAAE,aAAa,sBAAsB,GAAG;AACjG,QAAO,MAAM,OAAO,gBAAgB,UAAU,QAAQ,eAAe,OAAO,SAAS;AACnF,MAAI,QAAQ,WACV,MAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,QAAQ,WAAW,CAC3D,MAAK,aAAa,KAAK,MAAM;AAGjC,MAAI;AACF,UAAO,MAAM,GAAG,KAAK;YACb;AACR,QAAK,KAAK;;GAEZ;;AAGJ,SAAgB,IAAI,SAAiB,YAAwB;CAC3D,MAAM,OAAO,MAAM,eAAe;AAClC,KAAI,KACF,MAAK,SAAS,SAAS,WAAW;UAEzB,eAAe,mBAAmB,QAAQ,KAAK,OACxD,OAAM,IAAI,uBAAuB,uBAAuB"}

package/dist/esm/utils/turnstile-browser.d.ts

@@ -0,0 +1,32 @@
+import { TurnstileAction } from "./turnstile";
+
+//#region src/utils/turnstile-browser.d.ts
+type TurnstileWidgetId = string;
+type TurnstileTheme = "auto" | "light" | "dark";
+type TurnstileAppearance = "always" | "execute" | "interaction-only";
+type TurnstileExecution = "render" | "execute";
+type TurnstileSize = "invisible" | "flexible" | "normal" | "compact";
+type TurnstileConfig = {
+  sitekey: string;
+  action: TurnstileAction;
+  theme?: TurnstileTheme;
+  appearance?: TurnstileAppearance;
+  execution?: TurnstileExecution;
+  size?: TurnstileSize;
+  callback: (token: string) => void;
+  "error-callback": (errorCode?: string) => void;
+  "expired-callback": () => void;
+  "timeout-callback"?: () => void;
+};
+type TurnstileApi = {
+  render: (container: HTMLElement, config: TurnstileConfig) => TurnstileWidgetId;
+  execute?: (widgetId: TurnstileWidgetId) => void;
+  remove: (widgetId: TurnstileWidgetId) => void;
+  reset?: (widgetId: TurnstileWidgetId) => void;
+};
+declare function isTurnstileApi(value: unknown): value is TurnstileApi;
+declare function getTurnstileApi(): TurnstileApi | undefined;
+declare function loadTurnstileScript(): Promise<void>;
+//#endregion
+export { TurnstileApi, TurnstileAppearance, TurnstileConfig, TurnstileExecution, TurnstileSize, TurnstileTheme, TurnstileWidgetId, getTurnstileApi, isTurnstileApi, loadTurnstileScript };
+//# sourceMappingURL=turnstile-browser.d.ts.map

package/dist/esm/utils/turnstile-browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turnstile-browser.d.ts","names":[],"sources":["../../../src/utils/turnstile-browser.ts"],"mappings":";;;KAGY,iBAAA;AAAA,KACA,cAAA;AAAA,KACA,mBAAA;AAAA,KACA,kBAAA;AAAA,KACA,aAAA;AAAA,KAEA,eAAA;EACV,OAAA;EACA,MAAA,EAAQ,eAAA;EACR,KAAA,GAAQ,cAAA;EACR,UAAA,GAAa,mBAAA;EACb,SAAA,GAAY,kBAAA;EACZ,IAAA,GAAO,aAAA;EACP,QAAA,GAAW,KAAA;EACX,gBAAA,GAAmB,SAAA;EACnB,kBAAA;EACA,kBAAA;AAAA;AAAA,KAGU,YAAA;EACV,MAAA,GAAS,SAAA,EAAW,WAAA,EAAa,MAAA,EAAQ,eAAA,KAAoB,iBAAA;EAC7D,OAAA,IAAW,QAAA,EAAU,iBAAA;EACrB,MAAA,GAAS,QAAA,EAAU,iBAAA;EACnB,KAAA,IAAS,QAAA,EAAU,iBAAA;AAAA;AAAA,iBAML,cAAA,CAAe,KAAA,YAAiB,KAAA,IAAS,YAAA;AAAA,iBAOzC,eAAA,CAAA,GAAmB,YAAA;AAAA,iBAWnB,mBAAA,CAAA,GAAuB,OAAA"}

package/dist/esm/utils/turnstile-browser.js

@@ -0,0 +1,61 @@
+import { HexclaveAssertionError } from "./errors.js";
+
+//#region src/utils/turnstile-browser.ts
+const TURNSTILE_SCRIPT_BASE_URL = "https://challenges.cloudflare.com/turnstile/v0/api.js";
+const TURNSTILE_SCRIPT_LOAD_TIMEOUT_MS = 3e4;
+function isTurnstileApi(value) {
+	return typeof value === "object" && value !== null && "render" in value && "remove" in value;
+}
+function getTurnstileApi() {
+	if (typeof window === "undefined") return;
+	const maybeTurnstile = Reflect.get(window, "turnstile");
+	return isTurnstileApi(maybeTurnstile) ? maybeTurnstile : void 0;
+}
+let turnstileScriptPromise = null;
+function loadTurnstileScript() {
+	if (typeof window === "undefined") return Promise.reject(new HexclaveAssertionError("Turnstile can only be loaded in the browser"));
+	if (getTurnstileApi()) return Promise.resolve();
+	turnstileScriptPromise ??= new Promise((resolve, reject) => {
+		const rejectAndReset = (err) => {
+			turnstileScriptPromise = null;
+			reject(err);
+		};
+		const timeout = setTimeout(() => {
+			rejectAndReset(/* @__PURE__ */ new Error("Turnstile script load timed out"));
+		}, TURNSTILE_SCRIPT_LOAD_TIMEOUT_MS);
+		const resolveAndClearTimeout = () => {
+			clearTimeout(timeout);
+			resolve();
+		};
+		const existingScript = document.querySelector(`script[src^="${TURNSTILE_SCRIPT_BASE_URL}"]`);
+		if (existingScript) {
+			if (getTurnstileApi()) {
+				resolveAndClearTimeout();
+				return;
+			}
+			existingScript.addEventListener("load", () => resolveAndClearTimeout(), { once: true });
+			existingScript.addEventListener("error", () => {
+				existingScript.remove();
+				clearTimeout(timeout);
+				rejectAndReset(/* @__PURE__ */ new Error("Failed to load Turnstile"));
+			}, { once: true });
+			return;
+		}
+		const script = document.createElement("script");
+		script.src = `${TURNSTILE_SCRIPT_BASE_URL}?render=explicit`;
+		script.async = true;
+		script.defer = true;
+		script.onload = () => resolveAndClearTimeout();
+		script.onerror = () => {
+			script.remove();
+			clearTimeout(timeout);
+			rejectAndReset(/* @__PURE__ */ new Error("Failed to load Turnstile"));
+		};
+		document.head.append(script);
+	});
+	return turnstileScriptPromise;
+}
+
+//#endregion
+export { getTurnstileApi, isTurnstileApi, loadTurnstileScript };
+//# sourceMappingURL=turnstile-browser.js.map

package/dist/esm/utils/turnstile-browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turnstile-browser.js","names":[],"sources":["../../../src/utils/turnstile-browser.ts"],"sourcesContent":["import { HexclaveAssertionError } from \"./errors\";\nimport { TurnstileAction } from \"./turnstile\";\n\nexport type TurnstileWidgetId = string;\nexport type TurnstileTheme = \"auto\" | \"light\" | \"dark\";\nexport type TurnstileAppearance = \"always\" | \"execute\" | \"interaction-only\";\nexport type TurnstileExecution = \"render\" | \"execute\";\nexport type TurnstileSize = \"invisible\" | \"flexible\" | \"normal\" | \"compact\";\n\nexport type TurnstileConfig = {\n  sitekey: string,\n  action: TurnstileAction,\n  theme?: TurnstileTheme,\n  appearance?: TurnstileAppearance,\n  execution?: TurnstileExecution,\n  size?: TurnstileSize,\n  callback: (token: string) => void,\n  \"error-callback\": (errorCode?: string) => void,\n  \"expired-callback\": () => void,\n  \"timeout-callback\"?: () => void,\n};\n\nexport type TurnstileApi = {\n  render: (container: HTMLElement, config: TurnstileConfig) => TurnstileWidgetId,\n  execute?: (widgetId: TurnstileWidgetId) => void,\n  remove: (widgetId: TurnstileWidgetId) => void,\n  reset?: (widgetId: TurnstileWidgetId) => void,\n};\n\nconst TURNSTILE_SCRIPT_BASE_URL = \"https://challenges.cloudflare.com/turnstile/v0/api.js\";\nconst TURNSTILE_SCRIPT_LOAD_TIMEOUT_MS = 30_000;\n\nexport function isTurnstileApi(value: unknown): value is TurnstileApi {\n  return typeof value === \"object\"\n    && value !== null\n    && \"render\" in value\n    && \"remove\" in value;\n}\n\nexport function getTurnstileApi(): TurnstileApi | undefined {\n  if (typeof window === \"undefined\") {\n    return undefined;\n  }\n\n  const maybeTurnstile = Reflect.get(window, \"turnstile\");\n  return isTurnstileApi(maybeTurnstile) ? maybeTurnstile : undefined;\n}\n\nlet turnstileScriptPromise: Promise<void> | null = null;\n\nexport function loadTurnstileScript(): Promise<void> {\n  if (typeof window === \"undefined\") {\n    return Promise.reject(new HexclaveAssertionError(\"Turnstile can only be loaded in the browser\"));\n  }\n\n  if (getTurnstileApi()) {\n    return Promise.resolve();\n  }\n\n  turnstileScriptPromise ??= new Promise<void>((resolve, reject) => {\n    const rejectAndReset = (err: Error) => {\n      turnstileScriptPromise = null;\n      reject(err);\n    };\n\n    const timeout = setTimeout(() => {\n      rejectAndReset(new Error(\"Turnstile script load timed out\"));\n    }, TURNSTILE_SCRIPT_LOAD_TIMEOUT_MS);\n\n    const resolveAndClearTimeout = () => {\n      clearTimeout(timeout);\n      resolve();\n    };\n\n    const existingScript = document.querySelector<HTMLScriptElement>(`script[src^=\"${TURNSTILE_SCRIPT_BASE_URL}\"]`);\n    if (existingScript) {\n      // If the Turnstile API is already available (script loaded before our loader ran),\n      // resolve immediately — the load event may have already fired.\n      if (getTurnstileApi()) {\n        resolveAndClearTimeout();\n        return;\n      }\n      existingScript.addEventListener(\"load\", () => resolveAndClearTimeout(), { once: true });\n      existingScript.addEventListener(\"error\", () => {\n        existingScript.remove();\n        clearTimeout(timeout);\n        rejectAndReset(new Error(\"Failed to load Turnstile\"));\n      }, { once: true });\n      return;\n    }\n\n    const script = document.createElement(\"script\");\n    script.src = `${TURNSTILE_SCRIPT_BASE_URL}?render=explicit`;\n    script.async = true;\n    script.defer = true;\n    script.onload = () => resolveAndClearTimeout();\n    script.onerror = () => {\n      script.remove();\n      clearTimeout(timeout);\n      rejectAndReset(new Error(\"Failed to load Turnstile\"));\n    };\n    document.head.append(script);\n  });\n\n  return turnstileScriptPromise;\n}\n"],"mappings":";;;AA6BA,MAAM,4BAA4B;AAClC,MAAM,mCAAmC;AAEzC,SAAgB,eAAe,OAAuC;AACpE,QAAO,OAAO,UAAU,YACnB,UAAU,QACV,YAAY,SACZ,YAAY;;AAGnB,SAAgB,kBAA4C;AAC1D,KAAI,OAAO,WAAW,YACpB;CAGF,MAAM,iBAAiB,QAAQ,IAAI,QAAQ,YAAY;AACvD,QAAO,eAAe,eAAe,GAAG,iBAAiB;;AAG3D,IAAI,yBAA+C;AAEnD,SAAgB,sBAAqC;AACnD,KAAI,OAAO,WAAW,YACpB,QAAO,QAAQ,OAAO,IAAI,uBAAuB,8CAA8C,CAAC;AAGlG,KAAI,iBAAiB,CACnB,QAAO,QAAQ,SAAS;AAG1B,4BAA2B,IAAI,SAAe,SAAS,WAAW;EAChE,MAAM,kBAAkB,QAAe;AACrC,4BAAyB;AACzB,UAAO,IAAI;;EAGb,MAAM,UAAU,iBAAiB;AAC/B,kCAAe,IAAI,MAAM,kCAAkC,CAAC;KAC3D,iCAAiC;EAEpC,MAAM,+BAA+B;AACnC,gBAAa,QAAQ;AACrB,YAAS;;EAGX,MAAM,iBAAiB,SAAS,cAAiC,gBAAgB,0BAA0B,IAAI;AAC/G,MAAI,gBAAgB;AAGlB,OAAI,iBAAiB,EAAE;AACrB,4BAAwB;AACxB;;AAEF,kBAAe,iBAAiB,cAAc,wBAAwB,EAAE,EAAE,MAAM,MAAM,CAAC;AACvF,kBAAe,iBAAiB,eAAe;AAC7C,mBAAe,QAAQ;AACvB,iBAAa,QAAQ;AACrB,mCAAe,IAAI,MAAM,2BAA2B,CAAC;MACpD,EAAE,MAAM,MAAM,CAAC;AAClB;;EAGF,MAAM,SAAS,SAAS,cAAc,SAAS;AAC/C,SAAO,MAAM,GAAG,0BAA0B;AAC1C,SAAO,QAAQ;AACf,SAAO,QAAQ;AACf,SAAO,eAAe,wBAAwB;AAC9C,SAAO,gBAAgB;AACrB,UAAO,QAAQ;AACf,gBAAa,QAAQ;AACrB,kCAAe,IAAI,MAAM,2BAA2B,CAAC;;AAEvD,WAAS,KAAK,OAAO,OAAO;GAC5B;AAEF,QAAO"}

package/dist/esm/utils/turnstile-flow.d.ts

@@ -0,0 +1,29 @@
+import { TurnstileAction } from "./turnstile";
+
+//#region src/utils/turnstile-flow.d.ts
+declare class BotChallengeUserCancelledError extends Error {
+  constructor();
+}
+declare class BotChallengeExecutionFailedError extends Error {
+  constructor(message?: string, options?: {
+    cause?: unknown;
+  });
+}
+declare function executeTurnstileInvisible(siteKey: string, action: TurnstileAction): Promise<string>;
+declare function showTurnstileVisibleChallenge(siteKey: string, action: TurnstileAction): Promise<string>;
+type BotChallengeExecuteParams = {
+  token?: string;
+  phase?: "invisible" | "visible";
+  unavailable?: true;
+};
+type WithBotChallengeFlowOptions<T> = {
+  visibleSiteKey: string;
+  invisibleSiteKey: string;
+  action: TurnstileAction;
+  execute: (challenge: BotChallengeExecuteParams) => Promise<T>;
+  isChallengeRequired: (result: T) => boolean;
+};
+declare function withBotChallengeFlow<T>(options: WithBotChallengeFlowOptions<T>): Promise<T>;
+//#endregion
+export { BotChallengeExecuteParams, BotChallengeExecutionFailedError, BotChallengeUserCancelledError, WithBotChallengeFlowOptions, executeTurnstileInvisible, showTurnstileVisibleChallenge, withBotChallengeFlow };
+//# sourceMappingURL=turnstile-flow.d.ts.map

package/dist/esm/utils/turnstile-flow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"turnstile-flow.d.ts","names":[],"sources":["../../../src/utils/turnstile-flow.ts"],"mappings":";;;cAIa,8BAAA,SAAuC,KAAA;EAAA,WAAA,CAAA;AAAA;AAAA,cAOvC,gCAAA,SAAyC,KAAA;cACxC,OAAA,WAAkD,OAAA;IAAY,KAAA;EAAA;AAAA;AAAA,iBAWtD,yBAAA,CAA0B,OAAA,UAAiB,MAAA,EAAQ,eAAA,GAAkB,OAAA;AAAA,iBA0E3E,6BAAA,CAA8B,OAAA,UAAiB,MAAA,EAAQ,eAAA,GAAkB,OAAA;AAAA,KAqG7E,yBAAA;EACV,KAAA;EACA,KAAA;EACA,WAAA;AAAA;AAAA,KAGU,2BAAA;EACV,cAAA;EACA,gBAAA;EACA,MAAA,EAAQ,eAAA;EACR,OAAA,GAAU,SAAA,EAAW,yBAAA,KAA8B,OAAA,CAAQ,CAAA;EAC3D,mBAAA,GAAsB,MAAA,EAAQ,CAAA;AAAA;AAAA,iBASV,oBAAA,GAAA,CAAwB,OAAA,EAAS,2BAAA,CAA4B,CAAA,IAAK,OAAA,CAAQ,CAAA"}