@inferior-ai/sdk 2.0.0-beta.3

package/dist/retry.js

@@ -0,0 +1,83 @@
+/**
+ * Retry-with-backoff helper for SDK requests.
+ *
+ * The default policy retries idempotent requests on transient errors
+ * (429, 502, 503, 504) and connection failures with exponential
+ * backoff plus jitter. On 429 responses we honour the `Retry-After`
+ * header when present (seconds form only — RFC HTTP-date is not yet
+ * supported).
+ */
+const RETRY_STATUSES = new Set([429, 502, 503, 504]);
+const IDEMPOTENT_METHODS = new Set(["GET", "HEAD", "OPTIONS"]);
+export const DEFAULT_RETRY = {
+    maxAttempts: 3,
+    baseDelay: 0.5,
+    jitter: 0.2,
+    maxDelay: 30,
+    retryWrites: false,
+};
+function backoff(attempt, base, jitter, cap) {
+    const delay = Math.min(base * 2 ** (attempt - 1), cap);
+    if (jitter > 0)
+        return delay * (1 + Math.random() * jitter);
+    return delay;
+}
+function parseRetryAfter(resp) {
+    const raw = resp.headers.get("retry-after");
+    if (!raw)
+        return null;
+    const n = Number.parseFloat(raw);
+    return Number.isFinite(n) ? n : null;
+}
+function isIdempotent(method, headers, retry) {
+    if (IDEMPOTENT_METHODS.has(method.toUpperCase()))
+        return true;
+    if (retry.retryWrites)
+        return true;
+    if (!headers)
+        return false;
+    return Object.keys(headers).some((k) => k.toLowerCase() === "idempotency-key");
+}
+const sleep = (seconds) => new Promise((r) => setTimeout(r, Math.round(seconds * 1000)));
+/**
+ * Run `fn` with retry semantics. `fn` receives the attempt number and
+ * must return either a `Response` (status code is inspected) or throw.
+ *
+ * The `headers` argument is consulted to determine idempotency (only
+ * used to decide whether retries apply on writes).
+ */
+export async function withRetry(retry, method, headers, fn) {
+    const idempotent = isIdempotent(method, headers, retry);
+    let lastErr;
+    for (let attempt = 1; attempt <= retry.maxAttempts; attempt++) {
+        let resp;
+        try {
+            resp = await fn();
+        }
+        catch (e) {
+            lastErr = e;
+            if (attempt >= retry.maxAttempts || !idempotent)
+                throw e;
+            await sleep(backoff(attempt, retry.baseDelay, retry.jitter, retry.maxDelay));
+            continue;
+        }
+        if (!RETRY_STATUSES.has(resp.status))
+            return resp;
+        if (attempt >= retry.maxAttempts || !idempotent)
+            return resp;
+        const retryAfter = parseRetryAfter(resp);
+        const sleepFor = retryAfter ?? backoff(attempt, retry.baseDelay, retry.jitter, retry.maxDelay);
+        // Drain response so the connection is reusable.
+        try {
+            await resp.text();
+        }
+        catch {
+            /* empty */
+        }
+        await sleep(sleepFor);
+    }
+    if (lastErr)
+        throw lastErr;
+    throw new Error("withRetry: exhausted attempts without producing a response");
+}
+//# sourceMappingURL=retry.js.map

package/dist/retry.js.map

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

package/dist/testing/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Test fixtures for callers integrating against the Inferior SDK.
+ *
+ * Subpath import (NOT bundled with the main `@inferior-ai/sdk` entry):
+ *
+ * ```typescript
+ * import { MockInferiorClient } from '@inferior-ai/sdk/testing'
+ * ```
+ *
+ * Lets your tests construct an `InferiorClient` that does not hit the
+ * network. Add canned responses per endpoint; assert against the
+ * calls your code under test makes via `client.calls`.
+ */
+export { MockInferiorClient } from "./mock-client.js";
+export type { RecordedCall, MockClientOptions } from "./mock-client.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/testing/index.js

@@ -0,0 +1,15 @@
+/**
+ * Test fixtures for callers integrating against the Inferior SDK.
+ *
+ * Subpath import (NOT bundled with the main `@inferior-ai/sdk` entry):
+ *
+ * ```typescript
+ * import { MockInferiorClient } from '@inferior-ai/sdk/testing'
+ * ```
+ *
+ * Lets your tests construct an `InferiorClient` that does not hit the
+ * network. Add canned responses per endpoint; assert against the
+ * calls your code under test makes via `client.calls`.
+ */
+export { MockInferiorClient } from "./mock-client.js";
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/testing/mock-client.d.ts

@@ -0,0 +1,102 @@
+/**
+ * `MockInferiorClient` — InferiorClient subclass that intercepts
+ * every fetch call for tests.
+ *
+ * @example
+ * ```typescript
+ * import { MockInferiorClient } from '@inferior-ai/sdk/testing'
+ *
+ * test('my search wrapper', async () => {
+ *   const client = new MockInferiorClient()
+ *   client.mockSearch({
+ *     results: [{ id: 'exp_abc', title: 'Stripe webhook fix' } as any],
+ *   })
+ *
+ *   // Code under test:
+ *   const response = await client.search('stripe')
+ *   expect(response.results[0].title).toBe('Stripe webhook fix')
+ *
+ *   // Inspect what your code actually called:
+ *   expect(client.calls).toHaveLength(1)
+ *   expect(client.calls[0].url).toContain('/v1/experiences/search')
+ *   expect(client.calls[0].headers.get('user-agent')).toMatch(/^inferior-sdk-ts/)
+ * })
+ * ```
+ *
+ * Stubs are FIFO. Default response when no stub matches is a 404
+ * with a descriptive body — surfaces unexpected calls fast.
+ */
+import { InferiorClient } from "../client.js";
+export interface RecordedCall {
+    /** HTTP method, uppercased. */
+    method: string;
+    /** Full request URL as a string. */
+    url: string;
+    /** Request headers (Headers object — case-insensitive `.get()`). */
+    headers: Headers;
+    /** Raw request body as a string (empty for GETs). */
+    body: string;
+    /** Parsed body if JSON, else null. */
+    bodyJson: unknown | null;
+}
+export interface MockClientOptions {
+    apiKey?: string;
+    baseUrl?: string;
+}
+export declare class MockInferiorClient extends InferiorClient {
+    private stubs;
+    /** Every intercepted request — assert against this in your tests. */
+    calls: RecordedCall[];
+    constructor(options?: MockClientOptions);
+    private dispatch;
+    private unmatched;
+    /**
+     * Queue a single response for the next matching request.
+     * Returns `this` for chaining.
+     */
+    addResponse(method: string, pathSubstring: string, options?: {
+        status?: number;
+        jsonBody?: unknown;
+        textBody?: string;
+        headers?: Record<string, string>;
+        description?: string;
+    }): this;
+    mockSearch(opts?: {
+        results?: unknown[];
+        total?: number;
+        cached?: boolean;
+    }): this;
+    mockDeposit(opts?: {
+        id?: string;
+        status?: string;
+        qualityScore?: number;
+        validationState?: string;
+    }): this;
+    mockDepositRaw(opts?: {
+        rawDepositId?: string;
+    }): this;
+    mockFeedback(opts?: {
+        feedbackId?: string;
+        experienceId?: string;
+    }): this;
+    /**
+     * Stub the next matching call with an error response.
+     * The SDK's `raiseForStatus` will raise the corresponding typed
+     * exception (`ServerError`, `RateLimitError`, etc.) with `requestId`
+     * populated from the mock's `X-Request-ID`.
+     */
+    mockError(method: string, pathSubstring: string, opts: {
+        status: number;
+        error?: string;
+        message?: string;
+        details?: Record<string, unknown>;
+    }): this;
+    /** Clear all queued stubs and recorded calls. */
+    reset(): this;
+    /**
+     * Throw if any registered stub never fired. Useful at test
+     * teardown to catch over-stubbing.
+     */
+    assertNoUnmatched(): void;
+}
+//# sourceMappingURL=mock-client.d.ts.map

package/dist/testing/mock-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-client.d.ts","sourceRoot":"","sources":["../../src/testing/mock-client.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,MAAM,WAAW,YAAY;IAC3B,+BAA+B;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,oCAAoC;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,oEAAoE;IACpE,OAAO,EAAE,OAAO,CAAC;IACjB,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;CAC1B;AAQD,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,qBAAa,kBAAmB,SAAQ,cAAc;IACpD,OAAO,CAAC,KAAK,CAAc;IAC3B,qEAAqE;IAC9D,KAAK,EAAE,YAAY,EAAE,CAAM;gBAEtB,OAAO,GAAE,iBAAsB;YAc7B,QAAQ;IAgCtB,OAAO,CAAC,SAAS;IA4BjB;;;OAGG;IACH,WAAW,CACT,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE;QACP,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,WAAW,CAAC,EAAE,MAAM,CAAC;KACjB,GACL,IAAI;IAmCP,UAAU,CAAC,IAAI,GAAE;QAAE,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,IAAI;IAatF,WAAW,CACT,IAAI,GAAE;QACJ,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,eAAe,CAAC,EAAE,MAAM,CAAC;KACrB,GACL,IAAI;IAqBP,cAAc,CAAC,IAAI,GAAE;QAAE,YAAY,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,IAAI;IAa1D,YAAY,CAAC,IAAI,GAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,IAAI;IAe7E;;;;;OAKG;IACH,SAAS,CACP,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAC5F,IAAI;IAWP,iDAAiD;IACjD,KAAK,IAAI,IAAI;IAMb;;;OAGG;IACH,iBAAiB,IAAI,IAAI;CAM1B"}

package/dist/testing/mock-client.js

@@ -0,0 +1,217 @@
+/**
+ * `MockInferiorClient` — InferiorClient subclass that intercepts
+ * every fetch call for tests.
+ *
+ * @example
+ * ```typescript
+ * import { MockInferiorClient } from '@inferior-ai/sdk/testing'
+ *
+ * test('my search wrapper', async () => {
+ *   const client = new MockInferiorClient()
+ *   client.mockSearch({
+ *     results: [{ id: 'exp_abc', title: 'Stripe webhook fix' } as any],
+ *   })
+ *
+ *   // Code under test:
+ *   const response = await client.search('stripe')
+ *   expect(response.results[0].title).toBe('Stripe webhook fix')
+ *
+ *   // Inspect what your code actually called:
+ *   expect(client.calls).toHaveLength(1)
+ *   expect(client.calls[0].url).toContain('/v1/experiences/search')
+ *   expect(client.calls[0].headers.get('user-agent')).toMatch(/^inferior-sdk-ts/)
+ * })
+ * ```
+ *
+ * Stubs are FIFO. Default response when no stub matches is a 404
+ * with a descriptive body — surfaces unexpected calls fast.
+ */
+import { InferiorClient } from "../client.js";
+export class MockInferiorClient extends InferiorClient {
+    stubs = [];
+    /** Every intercepted request — assert against this in your tests. */
+    calls = [];
+    constructor(options = {}) {
+        super({
+            apiKey: options.apiKey ?? "cw_full_test_mock_key",
+            baseUrl: options.baseUrl ?? "https://api.inferior.ai",
+            retry: false,
+            // Override the global fetch with our recording dispatcher.
+            fetch: undefined, // overridden below
+        });
+        // Replace the fetcher after super() so `this` is bound correctly.
+        this.fetcher = this.dispatch.bind(this);
+    }
+    // ── Recording ────────────────────────────────────────────────────
+    async dispatch(input, init) {
+        const url = typeof input === "string"
+            ? input
+            : input instanceof URL
+                ? input.toString()
+                : input.url;
+        const method = (init?.method ?? "GET").toUpperCase();
+        const headers = new Headers(init?.headers ?? {});
+        const body = typeof init?.body === "string" ? init.body : "";
+        let bodyJson = null;
+        if (body) {
+            try {
+                bodyJson = JSON.parse(body);
+            }
+            catch {
+                bodyJson = null;
+            }
+        }
+        this.calls.push({ method, url, headers, body, bodyJson });
+        for (let i = 0; i < this.stubs.length; i++) {
+            const stub = this.stubs[i];
+            if (stub.matcher(url, init ?? {})) {
+                this.stubs.splice(i, 1);
+                return stub.response();
+            }
+        }
+        return this.unmatched(method, url);
+    }
+    unmatched(method, url) {
+        const path = (() => {
+            try {
+                return new URL(url).pathname;
+            }
+            catch {
+                return url;
+            }
+        })();
+        return new Response(JSON.stringify({
+            error: "MockInferiorClientUnmatchedRequest",
+            message: `No stub matched ${method} ${path}. Use addResponse() / mockSearch() / ` +
+                `mockDeposit() / mockDepositRaw() / mockFeedback() / mockError() to register a response.`,
+            details: { method, path },
+        }), {
+            status: 404,
+            headers: {
+                "Content-Type": "application/json",
+                "X-Request-ID": "req_mock_unmatched",
+            },
+        });
+    }
+    // ── Stub registration — generic ──────────────────────────────────
+    /**
+     * Queue a single response for the next matching request.
+     * Returns `this` for chaining.
+     */
+    addResponse(method, pathSubstring, options = {}) {
+        const { status = 200, jsonBody, textBody, headers = {}, description = "" } = options;
+        const matcher = (url, init) => {
+            const m = (init.method ?? "GET").toUpperCase();
+            return m === method.toUpperCase() && url.includes(pathSubstring);
+        };
+        const responseHeaders = {
+            "X-Request-ID": "req_mock_test",
+            ...headers,
+        };
+        let body;
+        if (jsonBody !== undefined) {
+            body = JSON.stringify(jsonBody);
+            responseHeaders["Content-Type"] = responseHeaders["Content-Type"] ?? "application/json";
+        }
+        else if (textBody !== undefined) {
+            body = textBody;
+        }
+        else {
+            body = null;
+        }
+        // Wrap in a factory so each replay produces a fresh Response (Response
+        // bodies are single-read; without the factory, retries would 500).
+        this.stubs.push({
+            matcher,
+            response: () => new Response(body, { status, headers: responseHeaders }),
+            description,
+        });
+        return this;
+    }
+    // ── Convenience helpers ──────────────────────────────────────────
+    mockSearch(opts = {}) {
+        const results = opts.results ?? [];
+        return this.addResponse("GET", "/v1/experiences/search", {
+            jsonBody: {
+                results,
+                total_results: opts.total ?? results.length,
+                metadata: { cached: opts.cached ?? false, channels_used: ["semantic"] },
+                schema_version: "2.0.0",
+            },
+            description: `search(${results.length} results)`,
+        });
+    }
+    mockDeposit(opts = {}) {
+        const { id = "exp_test_mock", status = "accepted", qualityScore = 0.75, validationState = "verified", } = opts;
+        return this.addResponse("POST", "/v1/experiences", {
+            status: 201,
+            jsonBody: {
+                id,
+                status,
+                quality_score: qualityScore,
+                trust_visibility: "searchable",
+                validation_state: validationState,
+                schema_version: "2.0.0",
+            },
+            description: `deposit(${id})`,
+        });
+    }
+    mockDepositRaw(opts = {}) {
+        const rawDepositId = opts.rawDepositId ?? "raw_test_mock";
+        return this.addResponse("POST", "/v1/experiences/raw", {
+            status: 202,
+            jsonBody: {
+                raw_deposit_id: rawDepositId,
+                status: "accepted",
+                normalization_status: "queued",
+            },
+            description: `depositRaw(${rawDepositId})`,
+        });
+    }
+    mockFeedback(opts = {}) {
+        const feedbackId = opts.feedbackId ?? "fbk_test_mock";
+        const experienceId = opts.experienceId ?? "exp_test_mock";
+        return this.addResponse("POST", "/feedback", {
+            status: 201,
+            jsonBody: {
+                feedback_id: feedbackId,
+                experience_id: experienceId,
+                updated_scores: { lower: 0.5, center: 0.7, upper: 0.9, n: 1 },
+                validity_update: {},
+            },
+            description: `feedback(${feedbackId})`,
+        });
+    }
+    /**
+     * Stub the next matching call with an error response.
+     * The SDK's `raiseForStatus` will raise the corresponding typed
+     * exception (`ServerError`, `RateLimitError`, etc.) with `requestId`
+     * populated from the mock's `X-Request-ID`.
+     */
+    mockError(method, pathSubstring, opts) {
+        const { status, error = "ServerError", message = "Mocked error", details = {} } = opts;
+        return this.addResponse(method, pathSubstring, {
+            status,
+            jsonBody: { error, message, details },
+            description: `error(${status} ${error})`,
+        });
+    }
+    // ── Inspection ───────────────────────────────────────────────────
+    /** Clear all queued stubs and recorded calls. */
+    reset() {
+        this.stubs.length = 0;
+        this.calls.length = 0;
+        return this;
+    }
+    /**
+     * Throw if any registered stub never fired. Useful at test
+     * teardown to catch over-stubbing.
+     */
+    assertNoUnmatched() {
+        if (this.stubs.length > 0) {
+            const labels = this.stubs.map((s) => s.description || "(unlabelled)").join(", ");
+            throw new Error(`${this.stubs.length} unfired stubs: ${labels}`);
+        }
+    }
+}
+//# sourceMappingURL=mock-client.js.map

package/dist/testing/mock-client.js.map

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

package/dist/webhooks.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Webhook signature verification helper.
+ *
+ * Backend signs every webhook delivery with HMAC-SHA256 over the raw
+ * body and sends the signature as `X-Inferior-Signature: sha256=<hex>`.
+ *
+ * @example
+ * ```typescript
+ * import { verify, InvalidSignatureError } from '@inferior-ai/sdk'
+ *
+ * app.post('/inferior-webhook', async (req, res) => {
+ *   const body = req.rawBody as Buffer | string  // NOT the parsed JSON
+ *   const sig = req.headers['x-inferior-signature'] as string
+ *   try {
+ *     const event = verify(body, sig, 'whsec_...')
+ *     // handle event …
+ *     res.status(200).end()
+ *   } catch (e) {
+ *     if (e instanceof InvalidSignatureError) {
+ *       res.status(400).end()
+ *     } else {
+ *       throw e
+ *     }
+ *   }
+ * })
+ * ```
+ *
+ * The helper validates both signature equality (constant-time compare)
+ * and event freshness (default 5-minute tolerance) — the latter
+ * prevents replay attacks if a delivery is captured and re-sent.
+ */
+export declare class InvalidSignatureError extends Error {
+    constructor(message: string);
+}
+export interface VerifyOptions {
+    /** Max event age in seconds. Default 300 (5min). 0 disables freshness check. */
+    tolerance?: number;
+    /** Override "now" for testing (unix seconds). */
+    deliveryTimestamp?: number;
+}
+/**
+ * Verify a webhook signature and return the parsed event payload.
+ *
+ * @param body Raw request body (`Buffer` or `string`). Do NOT pass the parsed JSON.
+ * @param signatureHeader Value of the `X-Inferior-Signature` header (`sha256=<hex>`).
+ * @param secret Webhook signing secret (from the admin UI).
+ * @param options Optional `tolerance` (default 300s) and `deliveryTimestamp`.
+ * @returns The parsed JSON event.
+ * @throws InvalidSignatureError on missing/malformed header, signature mismatch, or stale timestamp.
+ */
+export declare function verify(body: Buffer | string, signatureHeader: string | undefined | null, secret: string, options?: VerifyOptions): Record<string, unknown>;
+//# sourceMappingURL=webhooks.d.ts.map

package/dist/webhooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../src/webhooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AAIH,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAED,MAAM,WAAW,aAAa;IAC5B,gFAAgF;IAChF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;;;;;;;;GASG;AACH,wBAAgB,MAAM,CACpB,IAAI,EAAE,MAAM,GAAG,MAAM,EACrB,eAAe,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,EAC1C,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA+CzB"}

package/dist/webhooks.js

@@ -0,0 +1,90 @@
+/**
+ * Webhook signature verification helper.
+ *
+ * Backend signs every webhook delivery with HMAC-SHA256 over the raw
+ * body and sends the signature as `X-Inferior-Signature: sha256=<hex>`.
+ *
+ * @example
+ * ```typescript
+ * import { verify, InvalidSignatureError } from '@inferior-ai/sdk'
+ *
+ * app.post('/inferior-webhook', async (req, res) => {
+ *   const body = req.rawBody as Buffer | string  // NOT the parsed JSON
+ *   const sig = req.headers['x-inferior-signature'] as string
+ *   try {
+ *     const event = verify(body, sig, 'whsec_...')
+ *     // handle event …
+ *     res.status(200).end()
+ *   } catch (e) {
+ *     if (e instanceof InvalidSignatureError) {
+ *       res.status(400).end()
+ *     } else {
+ *       throw e
+ *     }
+ *   }
+ * })
+ * ```
+ *
+ * The helper validates both signature equality (constant-time compare)
+ * and event freshness (default 5-minute tolerance) — the latter
+ * prevents replay attacks if a delivery is captured and re-sent.
+ */
+import { createHmac, timingSafeEqual } from "node:crypto";
+export class InvalidSignatureError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "InvalidSignatureError";
+    }
+}
+/**
+ * Verify a webhook signature and return the parsed event payload.
+ *
+ * @param body Raw request body (`Buffer` or `string`). Do NOT pass the parsed JSON.
+ * @param signatureHeader Value of the `X-Inferior-Signature` header (`sha256=<hex>`).
+ * @param secret Webhook signing secret (from the admin UI).
+ * @param options Optional `tolerance` (default 300s) and `deliveryTimestamp`.
+ * @returns The parsed JSON event.
+ * @throws InvalidSignatureError on missing/malformed header, signature mismatch, or stale timestamp.
+ */
+export function verify(body, signatureHeader, secret, options = {}) {
+    const { tolerance = 300, deliveryTimestamp } = options;
+    if (!signatureHeader)
+        throw new InvalidSignatureError("missing signature header");
+    if (!signatureHeader.includes("=")) {
+        throw new InvalidSignatureError("malformed signature header (expected 'sha256=<hex>')");
+    }
+    const [scheme, sigHex] = signatureHeader.split("=", 2);
+    if (scheme !== "sha256") {
+        throw new InvalidSignatureError(`unsupported signature scheme: ${scheme}`);
+    }
+    const rawBody = typeof body === "string" ? Buffer.from(body, "utf-8") : body;
+    const expected = createHmac("sha256", secret).update(rawBody).digest("hex");
+    if (expected.length !== sigHex.length) {
+        throw new InvalidSignatureError("signature mismatch");
+    }
+    if (!timingSafeEqual(Buffer.from(expected, "hex"), Buffer.from(sigHex, "hex"))) {
+        throw new InvalidSignatureError("signature mismatch");
+    }
+    let event;
+    try {
+        event = JSON.parse(rawBody.toString("utf-8"));
+    }
+    catch (e) {
+        throw new InvalidSignatureError(`event body is not valid JSON: ${e.message}`);
+    }
+    if (tolerance > 0) {
+        const ts = (event.ts ?? event.timestamp);
+        if (ts !== undefined && ts !== null) {
+            const eventTime = Number(ts);
+            if (!Number.isFinite(eventTime)) {
+                throw new InvalidSignatureError(`event timestamp not parseable: ${String(ts)}`);
+            }
+            const now = deliveryTimestamp ?? Math.floor(Date.now() / 1000);
+            if (Math.abs(now - eventTime) > tolerance) {
+                throw new InvalidSignatureError(`event timestamp outside tolerance (${Math.abs(now - eventTime)}s > ${tolerance}s)`);
+            }
+        }
+    }
+    return event;
+}
+//# sourceMappingURL=webhooks.js.map

package/dist/webhooks.js.map

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