@kcaptcha/client 0.1.0

package/dist/api.d.ts

@@ -0,0 +1,32 @@
+export interface Geometry {
+    width: number;
+    height: number;
+    spacing: number;
+    /** Each pipe is a flat polyline [x0, y0, x1, y1, ...]. */
+    pipes: number[][];
+}
+export interface Challenge {
+    token: string;
+    geometry: Geometry;
+    expiresIn: number;
+}
+export interface VerifyResult {
+    token: string;
+    expiresIn: number;
+}
+/** code examples: incorrect, expired, replayed, rate_limited, network_error, http_404 ... */
+export declare class ApiError extends Error {
+    readonly code: string;
+    readonly status: number;
+    readonly retryAfter?: number | undefined;
+    constructor(code: string, status: number, retryAfter?: number | undefined);
+}
+export declare class KCaptchaApi {
+    private readonly endpoint;
+    constructor(endpoint: string);
+    /** POST <endpoint>/new-code */
+    newCode(): Promise<Challenge>;
+    /** POST <endpoint>/verify-captcha */
+    verify(token: string, answer: string): Promise<VerifyResult>;
+    private post;
+}

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+import type { KCaptchaOptions } from './options';
+export interface KCaptchaHandle {
+    readonly element: HTMLElement;
+    /** The pass token, or null if not verified. */
+    getToken(): string | null;
+    /** Uncheck the widget. Call this after a failed form submit: a pass token works only once. */
+    reset(): void;
+    /** Remove the widget and its hidden field. */
+    destroy(): void;
+}
+export declare const version = "0.1.0";
+export declare function isMounted(el: HTMLElement): boolean;
+/**
+ * Render a kCAPTCHA widget into `target` (an element or a CSS selector).
+ * Returns null, after printing an error to the console and into the element,
+ * if the options are invalid, most importantly if `endpoint` is missing.
+ */
+export declare function mount(target: HTMLElement | string, options: KCaptchaOptions): KCaptchaHandle | null;
+export { KCaptchaOptionError } from './options';
+export type { KCaptchaOptions } from './options';