@flitt/api 1.0.0

package/dist/cjs/errors.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FlittServerError = exports.FlittRateLimitError = exports.FlittConflictError = exports.FlittNotFoundError = exports.FlittPermissionError = exports.FlittAuthenticationError = exports.FlittValidationError = exports.FlittAPIError = exports.FlittAbortError = exports.FlittTimeoutError = exports.FlittConnectionError = exports.FlittConfigError = exports.FlittError = void 0;
+exports.apiErrorFor = apiErrorFor;
+/** Base class of every error thrown by this package. */
+class FlittError extends Error {
+    constructor(message, options) {
+        super(message);
+        this.name = new.target.name;
+        if (options && "cause" in options) {
+            Object.defineProperty(this, "cause", { value: options.cause, enumerable: false, configurable: true, writable: true });
+        }
+    }
+}
+exports.FlittError = FlittError;
+/** Invalid options or arguments, detected before any request is sent. */
+class FlittConfigError extends FlittError {
+}
+exports.FlittConfigError = FlittConfigError;
+/** The request never got an HTTP response (DNS, TLS, connection reset…). */
+class FlittConnectionError extends FlittError {
+}
+exports.FlittConnectionError = FlittConnectionError;
+/** No response within `timeoutMs`. */
+class FlittTimeoutError extends FlittConnectionError {
+}
+exports.FlittTimeoutError = FlittTimeoutError;
+/** The caller aborted the request with its AbortSignal. */
+class FlittAbortError extends FlittError {
+}
+exports.FlittAbortError = FlittAbortError;
+/** The API answered with an error status. Never contains your API key. */
+class FlittAPIError extends FlittError {
+    /** HTTP status code. */
+    status;
+    /** Machine-readable code, e.g. `NOT_FOUND`, `PLAN_LIMIT`, `RATE_LIMITED`. */
+    code;
+    /** Extra fields sent by the API, if any. */
+    details;
+    /** HTTP method of the failed request. */
+    method;
+    /** Path of the failed request, relative to the base URL (query string removed). */
+    path;
+    /** Quota headers of the failed response, when present. */
+    rateLimit;
+    /** Delay suggested by the API before retrying (Retry-After), in ms. */
+    retryAfterMs;
+    constructor(init) {
+        super(`${init.status} ${init.code}: ${init.message}`);
+        this.status = init.status;
+        this.code = init.code;
+        this.details = init.details;
+        this.method = init.method;
+        this.path = init.path;
+        this.rateLimit = init.rateLimit ?? null;
+        this.retryAfterMs = init.retryAfterMs ?? null;
+    }
+}
+exports.FlittAPIError = FlittAPIError;
+/** 400: missing, invalid or duplicated parameter. */
+class FlittValidationError extends FlittAPIError {
+}
+exports.FlittValidationError = FlittValidationError;
+/** 401: missing, invalid or revoked API key / vote token. */
+class FlittAuthenticationError extends FlittAPIError {
+}
+exports.FlittAuthenticationError = FlittAuthenticationError;
+/** 403: your plan or your role on the server does not allow this. */
+class FlittPermissionError extends FlittAPIError {
+}
+exports.FlittPermissionError = FlittPermissionError;
+/** 404: the resource does not exist or does not belong to you. */
+class FlittNotFoundError extends FlittAPIError {
+}
+exports.FlittNotFoundError = FlittNotFoundError;
+/** 409: conflict (rule already exists, server inactive…). */
+class FlittConflictError extends FlittAPIError {
+}
+exports.FlittConflictError = FlittConflictError;
+/** 429: quota or rate limit reached. See `retryAfterMs` and `rateLimit.reset`. */
+class FlittRateLimitError extends FlittAPIError {
+}
+exports.FlittRateLimitError = FlittRateLimitError;
+/** 5xx: temporary error on Flitt's side. Safe to retry later. */
+class FlittServerError extends FlittAPIError {
+}
+exports.FlittServerError = FlittServerError;
+/** Builds the most specific error class for a status code. */
+function apiErrorFor(init) {
+    const s = init.status;
+    if (s === 400 || s === 422)
+        return new FlittValidationError(init);
+    if (s === 401)
+        return new FlittAuthenticationError(init);
+    if (s === 403)
+        return new FlittPermissionError(init);
+    if (s === 404)
+        return new FlittNotFoundError(init);
+    if (s === 409)
+        return new FlittConflictError(init);
+    if (s === 429)
+        return new FlittRateLimitError(init);
+    if (s >= 500)
+        return new FlittServerError(init);
+    return new FlittAPIError(init);
+}
+//# sourceMappingURL=errors.js.map

package/dist/cjs/errors.js.map

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

package/dist/cjs/http.d.ts

@@ -0,0 +1,53 @@
+import type { RateLimit } from "./types.js";
+export type FetchLike = (input: string, init: RequestInit) => Promise<Response>;
+export type Query = Record<string, string | number | boolean | Date | null | undefined>;
+export type RequestOptions = {
+    /** Abort the request (and its retries). */
+    signal?: AbortSignal;
+    /** Overrides the client timeout for this request, in ms. */
+    timeoutMs?: number;
+    /** Overrides the client retry count for this request. */
+    maxRetries?: number;
+};
+export type TransportOptions = {
+    baseUrl: string;
+    token: string;
+    timeoutMs: number;
+    maxRetries: number;
+    maxRetryDelayMs: number;
+    fetch: FetchLike;
+    userAgent?: string;
+    headers?: Record<string, string>;
+    /** Vote API wraps payloads in { ok, data }. */
+    unwrapData: boolean;
+    onRateLimit?: (rateLimit: RateLimit) => void;
+};
+type Call = RequestOptions & {
+    query?: Query;
+    body?: unknown;
+    /** Makes a POST safe to retry (the API deduplicates on it). */
+    idempotencyKey?: string;
+};
+export declare function isBrowserLike(): boolean;
+/** Validates and normalises a base URL: HTTPS only (HTTP allowed for localhost during development). */
+export declare function normalizeBaseUrl(raw: string): string;
+/** One path segment, URL-encoded. Rejects empty values and dot segments. */
+export declare function segment(value: string, name: string): string;
+/** X-RateLimit-* headers. Reset is an ISO date (Public API) or unix seconds (Vote API). */
+export declare function parseRateLimit(headers: Headers): RateLimit | null;
+/** Retry-After in ms (seconds or HTTP date), null if absent or invalid. */
+export declare function parseRetryAfter(headers: Headers, now?: number): number | null;
+/** Full-jitter exponential backoff: random in [0, min(cap, 500 ms * 2^attempt)]. */
+export declare function backoffMs(attempt: number, capMs: number): number;
+export declare class Transport {
+    private readonly opts;
+    /** Quota state from the last response carrying X-RateLimit-* headers. */
+    lastRateLimit: RateLimit | null;
+    constructor(opts: TransportOptions);
+    request<T>(method: string, path: string, call?: Call): Promise<T>;
+}
+/** Random idempotency key (UUID v4 when available). */
+export declare function randomKey(): string;
+export declare function resolveFetch(custom?: FetchLike): FetchLike;
+export {};
+//# sourceMappingURL=http.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/http.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5C,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEhF,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC;AAExF,MAAM,MAAM,cAAc,GAAG;IAC3B,2CAA2C;IAC3C,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yDAAyD;IACzD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,SAAS,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,+CAA+C;IAC/C,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,KAAK,IAAI,CAAC;CAC9C,CAAC;AAEF,KAAK,IAAI,GAAG,cAAc,GAAG;IAC3B,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,+DAA+D;IAC/D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAOF,wBAAgB,aAAa,IAAI,OAAO,CAGvC;AAED,uGAAuG;AACvG,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAcpD;AAED,4EAA4E;AAC5E,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAM3D;AAmBD,2FAA2F;AAC3F,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI,CAYjE;AAED,2EAA2E;AAC3E,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,SAAa,GAAG,MAAM,GAAG,IAAI,CAMjF;AAiBD,oFAAoF;AACpF,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGhE;AAmDD,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAmB;IACxC,yEAAyE;IACzE,aAAa,EAAE,SAAS,GAAG,IAAI,CAAQ;gBAE3B,IAAI,EAAE,gBAAgB;IAI5B,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,IAAS,GAAG,OAAO,CAAC,CAAC,CAAC;CAmI5E;AAED,uDAAuD;AACvD,wBAAgB,SAAS,IAAI,MAAM,CAQlC;AAED,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,CAO1D"}

package/dist/cjs/http.js

@@ -0,0 +1,322 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Transport = void 0;
+exports.isBrowserLike = isBrowserLike;
+exports.normalizeBaseUrl = normalizeBaseUrl;
+exports.segment = segment;
+exports.parseRateLimit = parseRateLimit;
+exports.parseRetryAfter = parseRetryAfter;
+exports.backoffMs = backoffMs;
+exports.randomKey = randomKey;
+exports.resolveFetch = resolveFetch;
+const errors_js_1 = require("./errors.js");
+const version_js_1 = require("./version.js");
+const RETRYABLE_STATUS = new Set([408, 425, 429, 500, 502, 503, 504]);
+const MAX_ERROR_TEXT = 300;
+/** Responses above this size are refused (a sane API response is far smaller). */
+const MAX_RESPONSE_BYTES = 32 * 1024 * 1024;
+function isBrowserLike() {
+    const g = globalThis;
+    return typeof g.window !== "undefined" && typeof g.window.document !== "undefined";
+}
+/** Validates and normalises a base URL: HTTPS only (HTTP allowed for localhost during development). */
+function normalizeBaseUrl(raw) {
+    let url;
+    try {
+        url = new URL(raw);
+    }
+    catch {
+        throw new errors_js_1.FlittConfigError(`Invalid baseUrl: ${JSON.stringify(raw)}`);
+    }
+    const local = ["localhost", "127.0.0.1", "[::1]", "::1"].includes(url.hostname);
+    if (url.protocol !== "https:" && !(url.protocol === "http:" && local)) {
+        throw new errors_js_1.FlittConfigError("baseUrl must use https:// (your API key would travel in clear otherwise).");
+    }
+    if (url.username || url.password)
+        throw new errors_js_1.FlittConfigError("baseUrl must not contain credentials.");
+    if (url.search || url.hash)
+        throw new errors_js_1.FlittConfigError("baseUrl must not contain a query string or a fragment.");
+    return url.toString().replace(/\/+$/, "");
+}
+/** One path segment, URL-encoded. Rejects empty values and dot segments. */
+function segment(value, name) {
+    const v = String(value ?? "").trim();
+    if (!v)
+        throw new errors_js_1.FlittConfigError(`${name} is required.`);
+    if (v === "." || v === "..")
+        throw new errors_js_1.FlittConfigError(`${name} is invalid.`);
+    if (v.length > 256)
+        throw new errors_js_1.FlittConfigError(`${name} is too long.`);
+    return encodeURIComponent(v);
+}
+function buildQuery(query) {
+    if (!query)
+        return "";
+    const params = new URLSearchParams();
+    for (const [key, value] of Object.entries(query)) {
+        if (value === undefined || value === null || value === "")
+            continue;
+        params.set(key, value instanceof Date ? value.toISOString() : String(value));
+    }
+    const s = params.toString();
+    return s ? `?${s}` : "";
+}
+function parseCount(raw) {
+    if (!raw || raw.toLowerCase() === "unlimited")
+        return null;
+    const n = Number(raw);
+    return Number.isFinite(n) ? n : null;
+}
+/** X-RateLimit-* headers. Reset is an ISO date (Public API) or unix seconds (Vote API). */
+function parseRateLimit(headers) {
+    const limit = headers.get("x-ratelimit-limit");
+    const remaining = headers.get("x-ratelimit-remaining");
+    const reset = headers.get("x-ratelimit-reset");
+    if (limit === null && remaining === null && reset === null)
+        return null;
+    let resetAt = null;
+    if (reset) {
+        const asNumber = /^\d+(\.\d+)?$/.test(reset) ? Number(reset) : NaN;
+        const d = Number.isFinite(asNumber) ? new Date(asNumber < 1e12 ? asNumber * 1000 : asNumber) : new Date(reset);
+        resetAt = Number.isNaN(d.getTime()) ? null : d;
+    }
+    return { limit: parseCount(limit), remaining: parseCount(remaining), reset: resetAt };
+}
+/** Retry-After in ms (seconds or HTTP date), null if absent or invalid. */
+function parseRetryAfter(headers, now = Date.now()) {
+    const raw = headers.get("retry-after");
+    if (!raw)
+        return null;
+    if (/^\d+(\.\d+)?$/.test(raw.trim()))
+        return Math.max(0, Math.round(Number(raw) * 1000));
+    const date = Date.parse(raw);
+    return Number.isNaN(date) ? null : Math.max(0, date - now);
+}
+function sleep(ms, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted)
+            return reject(new errors_js_1.FlittAbortError("Request aborted."));
+        const timer = setTimeout(() => {
+            signal?.removeEventListener("abort", onAbort);
+            resolve();
+        }, ms);
+        const onAbort = () => {
+            clearTimeout(timer);
+            reject(new errors_js_1.FlittAbortError("Request aborted."));
+        };
+        signal?.addEventListener("abort", onAbort, { once: true });
+    });
+}
+/** Full-jitter exponential backoff: random in [0, min(cap, 500 ms * 2^attempt)]. */
+function backoffMs(attempt, capMs) {
+    const ceiling = Math.min(capMs, 500 * 2 ** attempt);
+    return Math.floor(Math.random() * ceiling);
+}
+function stripText(text) {
+    return text
+        .replace(/<[^>]*>/g, " ")
+        .replace(/\s+/g, " ")
+        .trim()
+        .slice(0, MAX_ERROR_TEXT);
+}
+const DEFAULT_CODES = {
+    400: "BAD_REQUEST",
+    401: "UNAUTHORIZED",
+    403: "FORBIDDEN",
+    404: "NOT_FOUND",
+    409: "CONFLICT",
+    429: "RATE_LIMITED",
+    500: "INTERNAL",
+    502: "BAD_GATEWAY",
+    503: "UNAVAILABLE",
+    504: "GATEWAY_TIMEOUT",
+};
+/**
+ * The API uses three error shapes; they are all turned into one error type:
+ *   { error: { code, message, details } }          (Public API)
+ *   { ok: false, error: { code, message } }        (Vote API)
+ *   { error: "Unauthorized", message: "..." }      (authentication layer)
+ */
+function describeError(status, statusText, body, text) {
+    const fallbackCode = DEFAULT_CODES[status] ?? `HTTP_${status}`;
+    if (body && typeof body === "object") {
+        const b = body;
+        if (b.error && typeof b.error === "object") {
+            const e = b.error;
+            return {
+                code: typeof e.code === "string" && e.code ? e.code : fallbackCode,
+                message: typeof e.message === "string" && e.message ? e.message : statusText || "Request failed",
+                details: e.details,
+            };
+        }
+        const { error: _e, message: _m, ...rest } = b;
+        return {
+            code: fallbackCode,
+            message: typeof b.message === "string" && b.message ? b.message : typeof b.error === "string" ? b.error : statusText || "Request failed",
+            details: Object.keys(rest).length ? rest : undefined,
+        };
+    }
+    return { code: fallbackCode, message: stripText(text) || statusText || "Request failed", details: undefined };
+}
+class Transport {
+    opts;
+    /** Quota state from the last response carrying X-RateLimit-* headers. */
+    lastRateLimit = null;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    async request(method, path, call = {}) {
+        const url = `${this.opts.baseUrl}${path}${buildQuery(call.query)}`;
+        const retryable = method === "GET" || method === "HEAD" || method === "DELETE" || Boolean(call.idempotencyKey);
+        const maxRetries = Math.max(0, Math.min(10, call.maxRetries ?? this.opts.maxRetries));
+        const timeoutMs = Math.max(1, call.timeoutMs ?? this.opts.timeoutMs);
+        const headers = {
+            Accept: "application/json",
+            ...this.opts.headers,
+            Authorization: `Bearer ${this.opts.token}`,
+        };
+        // Browsers forbid setting User-Agent; elsewhere it identifies the SDK in our logs.
+        if (!isBrowserLike())
+            headers["User-Agent"] = this.opts.userAgent ?? `flitt-api-js/${version_js_1.VERSION}`;
+        let payload;
+        if (call.body !== undefined) {
+            headers["Content-Type"] = "application/json";
+            payload = JSON.stringify(call.body);
+        }
+        if (call.idempotencyKey)
+            headers["Idempotency-Key"] = call.idempotencyKey;
+        for (let attempt = 0;; attempt++) {
+            if (call.signal?.aborted)
+                throw new errors_js_1.FlittAbortError("Request aborted.");
+            const controller = new AbortController();
+            const onAbort = () => controller.abort();
+            call.signal?.addEventListener("abort", onAbort, { once: true });
+            let timedOut = false;
+            const timer = setTimeout(() => {
+                timedOut = true;
+                controller.abort();
+            }, timeoutMs);
+            let response;
+            try {
+                response = await this.opts.fetch(url, {
+                    method,
+                    headers,
+                    body: payload,
+                    signal: controller.signal,
+                    // Never follow a redirect with the Authorization header attached.
+                    // (No `cache` / `credentials` options: Cloudflare Workers reject them,
+                    // and cross-origin requests do not carry cookies by default.)
+                    redirect: "error",
+                });
+            }
+            catch (err) {
+                clearTimeout(timer);
+                call.signal?.removeEventListener("abort", onAbort);
+                if (call.signal?.aborted)
+                    throw new errors_js_1.FlittAbortError("Request aborted.", { cause: err });
+                const error = timedOut
+                    ? new errors_js_1.FlittTimeoutError(`No response from Flitt within ${timeoutMs} ms (${method} ${path}).`, { cause: err })
+                    : new errors_js_1.FlittConnectionError(`Could not reach Flitt (${method} ${path}): ${err?.message ?? err}`, { cause: err });
+                if (retryable && attempt < maxRetries) {
+                    await sleep(backoffMs(attempt, this.opts.maxRetryDelayMs), call.signal);
+                    continue;
+                }
+                throw error;
+            }
+            let text;
+            try {
+                const declared = Number(response.headers.get("content-length") ?? "0");
+                if (declared > MAX_RESPONSE_BYTES)
+                    throw new errors_js_1.FlittConnectionError(`Response too large (${declared} bytes).`);
+                text = await response.text();
+            }
+            catch (err) {
+                clearTimeout(timer);
+                call.signal?.removeEventListener("abort", onAbort);
+                if (err instanceof errors_js_1.FlittConnectionError)
+                    throw err;
+                if (call.signal?.aborted)
+                    throw new errors_js_1.FlittAbortError("Request aborted.", { cause: err });
+                const error = timedOut
+                    ? new errors_js_1.FlittTimeoutError(`Flitt response not received within ${timeoutMs} ms (${method} ${path}).`, { cause: err })
+                    : new errors_js_1.FlittConnectionError(`Connection lost while reading the response (${method} ${path}).`, { cause: err });
+                if (retryable && attempt < maxRetries) {
+                    await sleep(backoffMs(attempt, this.opts.maxRetryDelayMs), call.signal);
+                    continue;
+                }
+                throw error;
+            }
+            finally {
+                clearTimeout(timer);
+                call.signal?.removeEventListener("abort", onAbort);
+            }
+            const rateLimit = parseRateLimit(response.headers);
+            if (rateLimit) {
+                this.lastRateLimit = rateLimit;
+                this.opts.onRateLimit?.(rateLimit);
+            }
+            let body = undefined;
+            if (text) {
+                try {
+                    body = JSON.parse(text);
+                }
+                catch {
+                    body = undefined;
+                }
+            }
+            if (response.ok) {
+                if (body === undefined && text) {
+                    throw (0, errors_js_1.apiErrorFor)({ status: 502, code: "INVALID_RESPONSE", message: `Expected JSON, got: ${stripText(text)}`, method, path });
+                }
+                if (this.opts.unwrapData && body && typeof body === "object" && "ok" in body) {
+                    return body.data;
+                }
+                return body;
+            }
+            const retryAfterMs = parseRetryAfter(response.headers);
+            const described = describeError(response.status, response.statusText, body, text);
+            const error = (0, errors_js_1.apiErrorFor)({
+                status: response.status,
+                ...described,
+                method,
+                path,
+                rateLimit,
+                retryAfterMs: retryAfterMs ??
+                    (response.status === 429 && rateLimit?.reset ? Math.max(0, rateLimit.reset.getTime() - Date.now()) : null),
+            });
+            // 429 is retried only when the wait is short (per-minute limits), never
+            // for a monthly quota. Non-idempotent calls are retried only on 429:
+            // the API refused them before doing anything.
+            const canRetry429 = response.status === 429 && error.retryAfterMs !== null && error.retryAfterMs <= this.opts.maxRetryDelayMs;
+            const canRetry = response.status === 429 ? canRetry429 : retryable && RETRYABLE_STATUS.has(response.status);
+            if (canRetry && attempt < maxRetries) {
+                const wait = error.retryAfterMs ?? backoffMs(attempt, this.opts.maxRetryDelayMs);
+                await sleep(Math.min(wait, this.opts.maxRetryDelayMs), call.signal);
+                continue;
+            }
+            throw error;
+        }
+    }
+}
+exports.Transport = Transport;
+/** Random idempotency key (UUID v4 when available). */
+function randomKey() {
+    const c = globalThis.crypto;
+    if (c?.randomUUID)
+        return c.randomUUID();
+    if (c?.getRandomValues) {
+        const bytes = c.getRandomValues(new Uint8Array(16));
+        return Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join("");
+    }
+    throw new errors_js_1.FlittConfigError("No secure random source (globalThis.crypto) available: pass an idempotencyKey.");
+}
+function resolveFetch(custom) {
+    if (custom)
+        return custom;
+    const f = globalThis.fetch;
+    if (typeof f !== "function") {
+        throw new errors_js_1.FlittConfigError("No global fetch found: use Node.js 18+ or pass the `fetch` option.");
+    }
+    return f.bind(globalThis);
+}
+//# sourceMappingURL=http.js.map

package/dist/cjs/http.js.map

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

package/dist/cjs/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @flitt/api — official client of the Flitt Public API and Vote API.
+ * https://flitt.me/docs/public-api
+ */
+export { Flitt, FlittVotes, DEFAULT_BASE_URL } from "./client.js";
+export type { ClientOptions, FlittOptions, FlittVotesOptions } from "./client.js";
+export type { FetchLike, RequestOptions } from "./http.js";
+export { verifyWebhook, FlittWebhookError } from "./webhooks.js";
+export type { VerifyWebhookOptions, HeaderSource } from "./webhooks.js";
+export { FlittError, FlittConfigError, FlittConnectionError, FlittTimeoutError, FlittAbortError, FlittAPIError, FlittValidationError, FlittAuthenticationError, FlittPermissionError, FlittNotFoundError, FlittConflictError, FlittRateLimitError, FlittServerError, } from "./errors.js";
+export { VERSION } from "./version.js";
+export type * from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAClE,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAClF,YAAY,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACjE,YAAY,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACxE,OAAO,EACL,UAAU,EACV,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,mBAAmB,YAAY,CAAC"}

package/dist/cjs/index.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VERSION = exports.FlittServerError = exports.FlittRateLimitError = exports.FlittConflictError = exports.FlittNotFoundError = exports.FlittPermissionError = exports.FlittAuthenticationError = exports.FlittValidationError = exports.FlittAPIError = exports.FlittAbortError = exports.FlittTimeoutError = exports.FlittConnectionError = exports.FlittConfigError = exports.FlittError = exports.FlittWebhookError = exports.verifyWebhook = exports.DEFAULT_BASE_URL = exports.FlittVotes = exports.Flitt = void 0;
+/**
+ * @flitt/api — official client of the Flitt Public API and Vote API.
+ * https://flitt.me/docs/public-api
+ */
+var client_js_1 = require("./client.js");
+Object.defineProperty(exports, "Flitt", { enumerable: true, get: function () { return client_js_1.Flitt; } });
+Object.defineProperty(exports, "FlittVotes", { enumerable: true, get: function () { return client_js_1.FlittVotes; } });
+Object.defineProperty(exports, "DEFAULT_BASE_URL", { enumerable: true, get: function () { return client_js_1.DEFAULT_BASE_URL; } });
+var webhooks_js_1 = require("./webhooks.js");
+Object.defineProperty(exports, "verifyWebhook", { enumerable: true, get: function () { return webhooks_js_1.verifyWebhook; } });
+Object.defineProperty(exports, "FlittWebhookError", { enumerable: true, get: function () { return webhooks_js_1.FlittWebhookError; } });
+var errors_js_1 = require("./errors.js");
+Object.defineProperty(exports, "FlittError", { enumerable: true, get: function () { return errors_js_1.FlittError; } });
+Object.defineProperty(exports, "FlittConfigError", { enumerable: true, get: function () { return errors_js_1.FlittConfigError; } });
+Object.defineProperty(exports, "FlittConnectionError", { enumerable: true, get: function () { return errors_js_1.FlittConnectionError; } });
+Object.defineProperty(exports, "FlittTimeoutError", { enumerable: true, get: function () { return errors_js_1.FlittTimeoutError; } });
+Object.defineProperty(exports, "FlittAbortError", { enumerable: true, get: function () { return errors_js_1.FlittAbortError; } });
+Object.defineProperty(exports, "FlittAPIError", { enumerable: true, get: function () { return errors_js_1.FlittAPIError; } });
+Object.defineProperty(exports, "FlittValidationError", { enumerable: true, get: function () { return errors_js_1.FlittValidationError; } });
+Object.defineProperty(exports, "FlittAuthenticationError", { enumerable: true, get: function () { return errors_js_1.FlittAuthenticationError; } });
+Object.defineProperty(exports, "FlittPermissionError", { enumerable: true, get: function () { return errors_js_1.FlittPermissionError; } });
+Object.defineProperty(exports, "FlittNotFoundError", { enumerable: true, get: function () { return errors_js_1.FlittNotFoundError; } });
+Object.defineProperty(exports, "FlittConflictError", { enumerable: true, get: function () { return errors_js_1.FlittConflictError; } });
+Object.defineProperty(exports, "FlittRateLimitError", { enumerable: true, get: function () { return errors_js_1.FlittRateLimitError; } });
+Object.defineProperty(exports, "FlittServerError", { enumerable: true, get: function () { return errors_js_1.FlittServerError; } });
+var version_js_1 = require("./version.js");
+Object.defineProperty(exports, "VERSION", { enumerable: true, get: function () { return version_js_1.VERSION; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;AAAA;;;GAGG;AACH,yCAAkE;AAAzD,kGAAA,KAAK,OAAA;AAAE,uGAAA,UAAU,OAAA;AAAE,6GAAA,gBAAgB,OAAA;AAG5C,6CAAiE;AAAxD,4GAAA,aAAa,OAAA;AAAE,gHAAA,iBAAiB,OAAA;AAEzC,yCAcqB;AAbnB,uGAAA,UAAU,OAAA;AACV,6GAAA,gBAAgB,OAAA;AAChB,iHAAA,oBAAoB,OAAA;AACpB,8GAAA,iBAAiB,OAAA;AACjB,4GAAA,eAAe,OAAA;AACf,0GAAA,aAAa,OAAA;AACb,iHAAA,oBAAoB,OAAA;AACpB,qHAAA,wBAAwB,OAAA;AACxB,iHAAA,oBAAoB,OAAA;AACpB,+GAAA,kBAAkB,OAAA;AAClB,+GAAA,kBAAkB,OAAA;AAClB,gHAAA,mBAAmB,OAAA;AACnB,6GAAA,gBAAgB,OAAA;AAElB,2CAAuC;AAA9B,qGAAA,OAAO,OAAA"}

package/dist/cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}