ribaunt 0.0.5

package/dist/cjs/widget.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Ribaunt CAPTCHA Widget - Web Component
+ *
+ * Usage:
+ * ```html
+ * <ribaunt-widget
+ *   challenge-endpoint="/api/challenge"
+ *   verify-endpoint="/api/verify"
+ *   show-warning="true"
+ *   warning-message="Custom warning message"
+ * ></ribaunt-widget>
+ * ```
+ *
+ * Or in React/Vue/Svelte:
+ * ```jsx
+ * <ribaunt-widget
+ *   challengeEndpoint="/api/challenge"
+ *   verifyEndpoint="/api/verify"
+ * />
+ * ```
+ *
+ * Events:
+ * - verify: Fired when verification is complete
+ * - error: Fired when an error occurs
+ * - state-change: Fired when widget state changes
+ */
+type WidgetState = 'initial' | 'verifying' | 'done' | 'error';
+export declare class RibauntWidget extends HTMLElement {
+    private shadow;
+    private state;
+    private progress;
+    private captchaElement;
+    private checkboxElement;
+    private messageElement;
+    private warningElement;
+    static get observedAttributes(): string[];
+    constructor();
+    connectedCallback(): void;
+    disconnectedCallback(): void;
+    attributeChangedCallback(name: string, oldValue: string | null, newValue: string | null): void;
+    private render;
+    private attachEventListeners;
+    private removeEventListeners;
+    private handleClick;
+    private handleKeyPress;
+    private getMessage;
+    private setState;
+    private setProgress;
+    private verify;
+    /**
+     * Public API: Reset the widget to initial state
+     */
+    reset(): void;
+    /**
+     * Public API: Get current state
+     */
+    getState(): WidgetState;
+    /**
+     * Public API: Programmatically trigger verification
+     */
+    startVerification(): void;
+}
+export default RibauntWidget;
+//# sourceMappingURL=widget.d.ts.map

package/dist/cjs/widget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget.d.ts","sourceRoot":"","sources":["../../src/widget.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AA+KH,KAAK,WAAW,GAAG,SAAS,GAAG,WAAW,GAAG,MAAM,GAAG,OAAO,CAAC;AAE9D,qBAAa,aAAc,SAAQ,WAAW;IAC5C,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,eAAe,CAA+B;IACtD,OAAO,CAAC,cAAc,CAAqC;IAC3D,OAAO,CAAC,cAAc,CAA+B;IAErD,MAAM,KAAK,kBAAkB,aAQ5B;;IASD,iBAAiB;IAKjB,oBAAoB;IAIpB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAMvF,OAAO,CAAC,MAAM;IA+Bd,OAAO,CAAC,oBAAoB;IAO5B,OAAO,CAAC,oBAAoB;IAO5B,OAAO,CAAC,WAAW;IAKnB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,UAAU;IAalB,OAAO,CAAC,QAAQ;IAoBhB,OAAO,CAAC,WAAW;YAYL,MAAM;IAgEpB;;OAEG;IACH,KAAK;IAKL;;OAEG;IACH,QAAQ,IAAI,WAAW;IAIvB;;OAEG;IACH,iBAAiB;CAKlB;AAQD,eAAe,aAAa,CAAC"}

package/dist/cjs/widget.js

@@ -0,0 +1,402 @@
+"use strict";
+/**
+ * Ribaunt CAPTCHA Widget - Web Component
+ *
+ * Usage:
+ * ```html
+ * <ribaunt-widget
+ *   challenge-endpoint="/api/challenge"
+ *   verify-endpoint="/api/verify"
+ *   show-warning="true"
+ *   warning-message="Custom warning message"
+ * ></ribaunt-widget>
+ * ```
+ *
+ * Or in React/Vue/Svelte:
+ * ```jsx
+ * <ribaunt-widget
+ *   challengeEndpoint="/api/challenge"
+ *   verifyEndpoint="/api/verify"
+ * />
+ * ```
+ *
+ * Events:
+ * - verify: Fired when verification is complete
+ * - error: Fired when an error occurs
+ * - state-change: Fired when widget state changes
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RibauntWidget = void 0;
+const solver_js_1 = require("./solver.js");
+const WIDGET_STYLES = `
+  /* Widget Container Styles */
+  :host,
+  :host * {
+    box-sizing: border-box;
+  }
+
+  .captcha {
+    background-color: var(--ribaunt-background, #fdfdfd);
+    border: 1px solid var(--ribaunt-border-color, #dddddd8f);
+    border-radius: var(--ribaunt-border-radius, 14px);
+    user-select: none;
+    height: var(--ribaunt-widget-height, 58px);
+    width: var(--ribaunt-widget-width, 230px);
+    display: flex;
+    align-items: center;
+    padding: var(--ribaunt-widget-padding, 14px);
+    gap: var(--ribaunt-gap, 15px);
+    cursor: pointer;
+    transition: filter .2s, transform .2s;
+    position: relative;
+    -webkit-tap-highlight-color: rgba(255, 255, 255, 0);
+    overflow: hidden;
+    color: var(--ribaunt-color, #212121);
+  }
+
+  .captcha:hover {
+    filter: brightness(98%);
+  }
+
+  /* Checkbox Styles */
+  .checkbox {
+    width: var(--ribaunt-checkbox-size, 25px);
+    height: var(--ribaunt-checkbox-size, 25px);
+    border: var(--ribaunt-checkbox-border, 1px solid #aaaaaad1);
+    border-radius: var(--ribaunt-checkbox-border-radius, 6px);
+    background-color: var(--ribaunt-checkbox-background, #fafafa91);
+    transition: opacity .2s;
+    margin-top: var(--ribaunt-checkbox-margin, 2px);
+    margin-bottom: var(--ribaunt-checkbox-margin, 2px);
+    flex-shrink: 0;
+  }
+
+  /* Font Family */
+  .captcha * {
+    font-family: var(--ribaunt-font, system, -apple-system, "BlinkMacSystemFont", ".SFNSText-Regular", "San Francisco", "Roboto", "Segoe UI", "Helvetica Neue", "Lucida Grande", "Ubuntu", "arial", sans-serif);
+  }
+
+  /* Label Text */
+  .captcha p {
+    margin: 0;
+    font-weight: 500;
+    font-size: 15px;
+    user-select: none;
+    transition: opacity .2s;
+  }
+
+  /* Verifying State */
+  .captcha[data-state=verifying] .checkbox {
+    background: none;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    transform: scale(1.1);
+    border: none;
+    border-radius: 50%;
+    background: conic-gradient(
+      var(--ribaunt-spinner-color, #000) 0%, 
+      var(--ribaunt-spinner-color, #000) var(--progress, 0%), 
+      var(--ribaunt-spinner-background-color, #eee) var(--progress, 0%), 
+      var(--ribaunt-spinner-background-color, #eee) 100%
+    );
+    position: relative;
+    transition: all 0.15s cubic-bezier(0.4, 0, 0.2, 1);
+  }
+
+  .captcha[data-state=verifying] .checkbox::after {
+    content: "";
+    background-color: var(--ribaunt-background, #fdfdfd);
+    width: calc(100% - var(--ribaunt-spinner-thickness, 5px));
+    height: calc(100% - var(--ribaunt-spinner-thickness, 5px));
+    border-radius: 50%;
+    margin: calc(var(--ribaunt-spinner-thickness, 5px) / 2);
+    transition: all 0.15s cubic-bezier(0.4, 0, 0.2, 1);
+  }
+
+  /* Done/Success State */
+  .captcha[data-state=done] .checkbox {
+    border: 1px solid transparent;
+    background-image: var(--ribaunt-checkmark, url("data:image/svg+xml,%3Csvg%20xmlns%3D%22http%3A%2F%2Fwww.w3.org%2F2000%2Fsvg%22%20width%3D%2224%22%20height%3D%2224%22%20viewBox%3D%220%200%2024%2024%22%3E%3Cstyle%3E%40keyframes%20anim%7B0%25%7Bstroke-dashoffset%3A23.21320343017578px%7Dto%7Bstroke-dashoffset%3A0%7D%7D%3C%2Fstyle%3E%3Cpath%20fill%3D%22none%22%20stroke%3D%22%2300a67d%22%20stroke-linecap%3D%22round%22%20stroke-linejoin%3D%22round%22%20stroke-width%3D%222%22%20d%3D%22m5%2012%205%205L20%207%22%20style%3D%22stroke-dashoffset%3A0%3Bstroke-dasharray%3A23.21320343017578px%3Banimation%3Aanim%20.5s%20ease%22%2F%3E%3C%2Fsvg%3E"));
+    background-size: cover;
+  }
+
+  /* Error State */
+  .captcha[data-state=error] .checkbox {
+    border: 1px solid transparent;
+    background-image: var(--ribaunt-error-cross, url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='96' height='96' viewBox='0 0 24 24'%3E%3Cpath fill='%23f55b50' d='M11 15h2v2h-2zm0-8h2v6h-2zm1-5C6.47 2 2 6.5 2 12a10 10 0 0 0 10 10a10 10 0 0 0 10-10A10 10 0 0 0 12 2m0 18a8 8 0 0 1-8-8a8 8 0 0 1 8-8a8 8 0 0 1 8 8a8 8 0 0 1-8 8'/%3E%3C/svg%3E"));
+    background-size: cover;
+  }
+
+  /* Disabled State */
+  .captcha[disabled] {
+    cursor: not-allowed;
+  }
+
+  .captcha[disabled][data-state=verifying] {
+    cursor: progress;
+  }
+
+  .captcha[disabled][data-state=done] {
+    cursor: default;
+  }
+
+  /* Logo */
+  .logo {
+    position: absolute;
+    bottom: 8px;
+    right: 8px;
+    width: 20px;
+    height: auto;
+    opacity: 0.6;
+    transition: opacity 0.2s, color 0.2s;
+    color: var(--ribaunt-logo-color, #666);
+    pointer-events: auto;
+  }
+
+  .logo svg {
+    width: 100%;
+    height: auto;
+    display: block;
+  }
+
+  /* Logo color adapts to theme */
+  @media (prefers-color-scheme: dark) {
+    .logo {
+      color: var(--ribaunt-logo-color, #999);
+    }
+  }
+
+  /* Warning Message */
+  .warning {
+    width: var(--ribaunt-widget-width, 230px);
+    background: rgb(237, 56, 46);
+    color: white;
+    padding: 4px 6px;
+    padding-bottom: calc(var(--ribaunt-border-radius, 14px) + 5px);
+    font-size: 10px;
+    box-sizing: border-box;
+    font-family: system-ui;
+    border-top-left-radius: 8px;
+    border-top-right-radius: 8px;
+    text-align: center;
+    user-select: none;
+    margin-bottom: -35.5px;
+    opacity: 0;
+    transition: margin-bottom .3s, opacity .3s;
+  }
+
+  .warning.visible {
+    margin-bottom: calc(-1 * var(--ribaunt-border-radius, 14px));
+    opacity: 1;
+  }
+`;
+const RIBAUNT_LOGO = `
+  <svg width="500" height="384" viewBox="0 0 500 384" fill="none" xmlns="http://www.w3.org/2000/svg">
+    <path fill-rule="evenodd" clip-rule="evenodd" d="M368.357 122.188H236.618L187.59 0H450.972L500 122.188L434.14 286.295H302.478L368.357 122.188Z" fill="currentColor"/>
+    <path fill-rule="evenodd" clip-rule="evenodd" d="M236.619 122.188L341.575 383.702H209.913L170.796 286.199L131.663 383.702H0L104.957 122.188H236.619Z" fill="currentColor"/>
+  </svg>
+`;
+class RibauntWidget extends HTMLElement {
+    static get observedAttributes() {
+        return [
+            'challenge-endpoint',
+            'verify-endpoint',
+            'show-warning',
+            'warning-message',
+            'disabled',
+        ];
+    }
+    constructor() {
+        super();
+        this.state = 'initial';
+        this.progress = 0;
+        this.captchaElement = null;
+        this.checkboxElement = null;
+        this.messageElement = null;
+        this.warningElement = null;
+        this.shadow = this.attachShadow({ mode: 'open' });
+        this.handleClick = this.handleClick.bind(this);
+        this.handleKeyPress = this.handleKeyPress.bind(this);
+    }
+    connectedCallback() {
+        this.render();
+        this.attachEventListeners();
+    }
+    disconnectedCallback() {
+        this.removeEventListeners();
+    }
+    attributeChangedCallback(name, oldValue, newValue) {
+        if (oldValue !== newValue) {
+            this.render();
+        }
+    }
+    render() {
+        const showWarning = this.hasAttribute('show-warning') && this.getAttribute('show-warning') !== 'false';
+        const warningMessage = this.getAttribute('warning-message') || 'Enable WASM for significantly faster solving';
+        this.shadow.innerHTML = `
+      <style>${WIDGET_STYLES}</style>
+      <div>
+        ${showWarning ? `<div class="warning ${showWarning ? 'visible' : ''}">${warningMessage}</div>` : ''}
+        <div class="captcha" data-state="${this.state}" role="button" tabindex="0" aria-label="${this.getMessage()}">
+          <div class="checkbox"></div>
+          <p>${this.getMessage()}</p>
+          <a class="logo" href="https://ribaunt.com" target="_blank" rel="noopener noreferrer" aria-label="Powered by Ribaunt">
+            ${RIBAUNT_LOGO}
+          </a>
+        </div>
+      </div>
+    `;
+        this.captchaElement = this.shadow.querySelector('.captcha');
+        this.checkboxElement = this.shadow.querySelector('.checkbox');
+        this.messageElement = this.shadow.querySelector('p');
+        this.warningElement = this.shadow.querySelector('.warning');
+        // Update progress CSS variable if verifying
+        if (this.state === 'verifying' && this.captchaElement) {
+            this.captchaElement.style.setProperty('--progress', `${this.progress}%`);
+        }
+        this.attachEventListeners();
+    }
+    attachEventListeners() {
+        if (this.captchaElement) {
+            this.captchaElement.addEventListener('click', this.handleClick);
+            this.captchaElement.addEventListener('keypress', this.handleKeyPress);
+        }
+    }
+    removeEventListeners() {
+        if (this.captchaElement) {
+            this.captchaElement.removeEventListener('click', this.handleClick);
+            this.captchaElement.removeEventListener('keypress', this.handleKeyPress);
+        }
+    }
+    handleClick() {
+        if (this.state !== 'initial' && this.state !== 'error')
+            return;
+        this.verify();
+    }
+    handleKeyPress(e) {
+        if (e.key === 'Enter' || e.key === ' ') {
+            e.preventDefault();
+            this.handleClick();
+        }
+    }
+    getMessage() {
+        switch (this.state) {
+            case 'initial':
+                return "I'm a human";
+            case 'verifying':
+                return `Verifying... ${this.progress}%`;
+            case 'done':
+                return "You're a human";
+            case 'error':
+                return 'Error. Try again.';
+        }
+    }
+    setState(newState) {
+        this.state = newState;
+        if (this.captchaElement) {
+            this.captchaElement.setAttribute('data-state', this.state);
+            this.captchaElement.setAttribute('aria-label', this.getMessage());
+        }
+        if (this.messageElement) {
+            this.messageElement.textContent = this.getMessage();
+        }
+        // Dispatch state change event
+        this.dispatchEvent(new CustomEvent('state-change', {
+            detail: { state: this.state },
+            bubbles: true,
+            composed: true,
+        }));
+    }
+    setProgress(value) {
+        // Smooth the progress value for better animation
+        const smoothedProgress = Math.round(value * 10) / 10;
+        this.progress = smoothedProgress;
+        if (this.messageElement) {
+            this.messageElement.textContent = this.getMessage();
+        }
+        if (this.captchaElement) {
+            this.captchaElement.style.setProperty('--progress', `${smoothedProgress}%`);
+        }
+    }
+    async verify() {
+        this.setState('verifying');
+        this.setProgress(0);
+        try {
+            const challengeEndpoint = this.getAttribute('challenge-endpoint');
+            const verifyEndpoint = this.getAttribute('verify-endpoint');
+            // Get challenge tokens
+            let tokens = [];
+            if (challengeEndpoint) {
+                const response = await fetch(challengeEndpoint);
+                if (!response.ok)
+                    throw new Error('Failed to fetch challenge');
+                const data = await response.json();
+                tokens = data.challenges || data.tokens || data;
+            }
+            if (!tokens || !Array.isArray(tokens) || tokens.length === 0) {
+                throw new Error('No challenge tokens available');
+            }
+            // Solve challenges using the browser-compatible solver
+            const solutions = await (0, solver_js_1.solveChallenge)(tokens, (progress) => {
+                this.setProgress(progress);
+            });
+            // Verify solution
+            if (verifyEndpoint) {
+                const response = await fetch(verifyEndpoint, {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify({ tokens, solutions }),
+                });
+                if (!response.ok) {
+                    throw new Error('Verification failed');
+                }
+            }
+            this.setState('done');
+            // Dispatch verify event
+            this.dispatchEvent(new CustomEvent('verify', {
+                detail: { solutions },
+                bubbles: true,
+                composed: true,
+            }));
+        }
+        catch (error) {
+            this.setState('error');
+            // Dispatch error event
+            this.dispatchEvent(new CustomEvent('error', {
+                detail: { error: error instanceof Error ? error.message : String(error) },
+                bubbles: true,
+                composed: true,
+            }));
+        }
+    }
+    /**
+     * Public API: Reset the widget to initial state
+     */
+    reset() {
+        this.setState('initial');
+        this.setProgress(0);
+    }
+    /**
+     * Public API: Get current state
+     */
+    getState() {
+        return this.state;
+    }
+    /**
+     * Public API: Programmatically trigger verification
+     */
+    startVerification() {
+        if (this.state === 'initial' || this.state === 'error') {
+            this.verify();
+        }
+    }
+}
+exports.RibauntWidget = RibauntWidget;
+// Register the custom element
+if (typeof window !== 'undefined' && !customElements.get('ribaunt-widget')) {
+    customElements.define('ribaunt-widget', RibauntWidget);
+}
+// Export for use in TypeScript
+exports.default = RibauntWidget;
+//# sourceMappingURL=widget.js.map

package/dist/cjs/widget.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+export type ChallengeToken = string;
+export interface ChallengeSolution {
+    nonce: string;
+    hash: string;
+}
+/**
+ * Creates one or more PoW challenges and returns them as signed JWT tokens.
+ *
+ * @param difficulty - Number of leading zeros required in the hash (default 6)
+ * @param amount - Number of challenges to create (default 4)
+ * @param ttlSeconds - Time to live for each challenge in seconds (default 30)
+ * @returns An array of JWT challenge tokens
+ */
+export declare function createChallenge(difficulty?: number, amount?: number, ttlSeconds?: number): ChallengeToken[];
+/**
+ * Solves one or more PoW challenges encoded in JWT tokens.
+ *
+ * @param token - The JWT challenge token or an array of tokens
+ * @returns The nonce/hash pair for single input or an array of them for multiple tokens
+ */
+export declare function solveChallenge(token: ChallengeToken): ChallengeSolution | undefined;
+export declare function solveChallenge(token: ChallengeToken[]): ChallengeSolution[] | undefined;
+/**
+ * Verifies a PoW solution returned by the client.
+ *
+ * @param token - The original JWT issued as the challenge (single token or array of tokens)
+ * @param nonce - The nonce/answer submitted by the client (single nonce, array of nonces, or array of solution objects)
+ * @returns true only if every provided solution is valid; otherwise false
+ */
+export declare function verifySolution(token: ChallengeToken | ChallengeToken[], nonce: number | string | Array<number | string> | ChallengeSolution | ChallengeSolution[]): boolean;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAeA,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC;AAEpC,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAqCD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,UAAU,GAAE,MAAU,EACtB,MAAM,GAAE,MAAU,EAClB,UAAU,GAAE,MAAW,GACtB,cAAc,EAAE,CAKlB;AAoDD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,GAAG,iBAAiB,GAAG,SAAS,CAAC;AACrF,wBAAgB,cAAc,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,iBAAiB,EAAE,GAAG,SAAS,CAAC;AAuBzF;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,cAAc,GAAG,cAAc,EAAE,EACxC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,GAAG,iBAAiB,GAAG,iBAAiB,EAAE,GACxF,OAAO,CAqDT"}

package/dist/index.js

@@ -0,0 +1,167 @@
+import crypto from 'crypto';
+import jwt from 'jsonwebtoken';
+const secret = process.env.RIBAUNT_SECRET;
+if (!secret) {
+    throw new Error('RIBAUNT_SECRET environment variable is not set!');
+}
+function generateChallenge(length = 8) {
+    const buffer = crypto.randomBytes(length);
+    return buffer.toString('base64').slice(0, length);
+}
+function createChallengePayload(difficulty, ttlSeconds) {
+    return {
+        challenge: generateChallenge(),
+        difficulty,
+        expires: Math.floor(Date.now() / 1000) + ttlSeconds,
+    };
+}
+function signChallenge(payload) {
+    return jwt.sign(payload, secret);
+}
+function assertValidAmount(amount) {
+    if (!Number.isFinite(amount)) {
+        throw new Error('Challenge amount must be a finite number');
+    }
+    const normalized = Math.floor(amount);
+    if (normalized < 1) {
+        throw new Error('Challenge amount must be at least 1');
+    }
+    return normalized;
+}
+function createSingleChallenge(difficulty, ttlSeconds) {
+    const payload = createChallengePayload(difficulty, ttlSeconds);
+    return signChallenge(payload);
+}
+/**
+ * Creates one or more PoW challenges and returns them as signed JWT tokens.
+ *
+ * @param difficulty - Number of leading zeros required in the hash (default 6)
+ * @param amount - Number of challenges to create (default 4)
+ * @param ttlSeconds - Time to live for each challenge in seconds (default 30)
+ * @returns An array of JWT challenge tokens
+ */
+export function createChallenge(difficulty = 5, amount = 4, ttlSeconds = 30) {
+    const normalizedAmount = assertValidAmount(amount);
+    const challenges = Array.from({ length: normalizedAmount }, () => createSingleChallenge(difficulty, ttlSeconds));
+    return challenges;
+}
+function solveSingleChallenge(token) {
+    try {
+        const payload = jwt.decode(token);
+        if (!payload)
+            return undefined;
+        const { challenge, difficulty } = payload;
+        const prefix = '0'.repeat(difficulty);
+        let nonce = 0;
+        while (true) {
+            const hash = crypto
+                .createHash('sha256')
+                .update(`${challenge}${nonce}`)
+                .digest('hex');
+            if (hash.startsWith(prefix)) {
+                return { nonce: String(nonce), hash };
+            }
+            nonce++;
+        }
+    }
+    catch (err) {
+        return undefined;
+    }
+}
+function verifySingleSolution(token, nonce) {
+    if (nonce === undefined || nonce === null) {
+        return false;
+    }
+    try {
+        const payload = jwt.verify(token, secret);
+        const now = Math.floor(Date.now() / 1000);
+        if (payload.expires < now)
+            return false;
+        const nonceValue = typeof nonce === 'number' ? String(nonce) : nonce;
+        const hash = crypto
+            .createHash('sha256')
+            .update(`${payload.challenge}${nonceValue}`)
+            .digest('hex');
+        const prefix = '0'.repeat(payload.difficulty);
+        return hash.startsWith(prefix);
+    }
+    catch (err) {
+        return false;
+    }
+}
+export function solveChallenge(token) {
+    if (Array.isArray(token)) {
+        const solutions = [];
+        for (const singleToken of token) {
+            const solution = solveSingleChallenge(singleToken);
+            if (!solution) {
+                return undefined;
+            }
+            solutions.push(solution);
+        }
+        return solutions;
+    }
+    const solution = solveSingleChallenge(token);
+    return solution;
+}
+/**
+ * Verifies a PoW solution returned by the client.
+ *
+ * @param token - The original JWT issued as the challenge (single token or array of tokens)
+ * @param nonce - The nonce/answer submitted by the client (single nonce, array of nonces, or array of solution objects)
+ * @returns true only if every provided solution is valid; otherwise false
+ */
+export function verifySolution(token, nonce) {
+    if (Array.isArray(token)) {
+        let nonces;
+        if (Array.isArray(nonce)) {
+            if (nonce.length !== token.length) {
+                return false;
+            }
+            if (nonce.length > 0 && typeof nonce[0] === 'object' && 'nonce' in nonce[0]) {
+                nonces = nonce.map(s => s.nonce);
+            }
+            else {
+                nonces = nonce;
+            }
+        }
+        else {
+            return false;
+        }
+        for (let index = 0; index < token.length; index++) {
+            const challengeToken = token[index];
+            const nonceEntry = nonces[index];
+            if (challengeToken === undefined || nonceEntry === undefined) {
+                return false;
+            }
+            if (!verifySingleSolution(challengeToken, nonceEntry)) {
+                return false;
+            }
+        }
+        return true;
+    }
+    let effectiveNonce;
+    if (Array.isArray(nonce)) {
+        if (nonce.length === 0) {
+            return false;
+        }
+        if (typeof nonce[0] === 'object' && 'nonce' in nonce[0]) {
+            effectiveNonce = nonce[0].nonce;
+        }
+        else {
+            effectiveNonce = nonce[0];
+        }
+    }
+    else if (typeof nonce === 'object' && 'nonce' in nonce) {
+        effectiveNonce = nonce.nonce;
+    }
+    else {
+        effectiveNonce = nonce;
+    }
+    if (effectiveNonce === undefined) {
+        return false;
+    }
+    const result = verifySingleSolution(token, effectiveNonce);
+    return result;
+}
+//# sourceMappingURL=index.js.map