burnledger 0.1.0

package/dist/esm/client.js

@@ -0,0 +1,238 @@
+/** Async BurnLedger API client.
+ *
+ * Single class — Node.js is all-async, no sync/async split needed.
+ * Pagination uses AsyncIterable<T> via Paginator.
+ */
+import { RateLimitError, TimeoutError } from "./errors.js";
+import { Transport } from "./http.js";
+import { parseAttestation, parseCertificateResponse, parseConsistencyProof, parseInclusionProof, parseLogEntry, parseRevocationStatus, parseSignedTreeHead, parseSystem, parseVerifyResult, parseWebhook, } from "./models.js";
+import { Paginator } from "./pagination.js";
+export class BurnLedger {
+    transport;
+    constructor(opts) {
+        this.transport = new Transport({
+            baseUrl: opts.baseUrl ?? "https://api.burnledger.com",
+            apiKey: opts.apiKey,
+            timeout: opts.timeout ?? 30,
+            maxRetries: opts.maxRetries ?? 2,
+        });
+    }
+    close() {
+        // Transport uses native fetch — no persistent connections to close.
+        // Method exists for API symmetry and future extensibility.
+    }
+    [Symbol.asyncDispose]() {
+        this.close();
+        return Promise.resolve();
+    }
+    // --- Systems ---
+    async registerSystem(opts) {
+        const config = resolveConnectionConfig(opts.connectionConfig, opts.dsn, opts.uri);
+        const body = {
+            name: opts.name,
+            connector_type: opts.connectorType,
+            connection_config: config,
+            subject_query: opts.subjectQuery,
+            hash_scope: opts.hashScope ?? "existence",
+            max_records: opts.maxRecords ?? 1_000_000,
+            max_bytes: opts.maxBytes ?? 10 * 1024 * 1024 * 1024,
+            query_timeout: opts.queryTimeout ?? "30s",
+        };
+        const data = await this.transport.request("POST", "/v1/systems", {
+            json: body,
+        });
+        return parseSystem(data);
+    }
+    async getSystem(systemId) {
+        const data = await this.transport.request("GET", `/v1/systems/${systemId}`);
+        return parseSystem(data);
+    }
+    listSystems(opts) {
+        return new Paginator(this.transport, "/v1/systems", parseSystem, {
+            params: { limit: opts?.limit ?? 25 },
+        });
+    }
+    async deregisterSystem(systemId) {
+        await this.transport.request("DELETE", `/v1/systems/${systemId}`);
+    }
+    async healthCheck(systemId) {
+        const data = await this.transport.request("POST", `/v1/systems/${systemId}/health-check`);
+        return parseSystem(data);
+    }
+    // --- Attestations ---
+    async attest(subjectIdentifier, opts) {
+        const body = {
+            subject_identifier: subjectIdentifier,
+            proof_mode: opts?.proofMode ?? "count",
+            expires_in: opts?.expiresIn ?? "72h",
+        };
+        if (opts?.systemIds !== undefined)
+            body.system_ids = opts.systemIds;
+        if (opts?.webhookUrl !== undefined)
+            body.webhook_url = opts.webhookUrl;
+        const data = await this.transport.request("POST", "/v1/attestations", {
+            json: body,
+        });
+        return parseAttestation(data);
+    }
+    async getAttestation(attestationId) {
+        const data = await this.transport.request("GET", `/v1/attestations/${attestationId}`);
+        return parseAttestation(data);
+    }
+    async waitFor(attestationId, opts) {
+        return poll({
+            fetch: () => this.getAttestation(attestationId),
+            done: (att) => att.status !== "PENDING_VERIFICATION",
+            operation: `waitFor(${attestationId})`,
+            timeout: opts?.timeout ?? 60,
+            pollInterval: opts?.pollInterval ?? 2,
+        });
+    }
+    async verify(attestationId, subjectIdentifier, opts) {
+        const body = { subject_identifier: subjectIdentifier };
+        const data = await this.transport.request("POST", `/v1/attestations/${attestationId}/verify`, { json: body });
+        const result = parseVerifyResult(data);
+        const timeout = opts?.timeout ?? 0;
+        if (timeout <= 0 || result.status === "CERTIFIED") {
+            return result;
+        }
+        return poll({
+            fetch: async () => {
+                const d = await this.transport.request("POST", `/v1/attestations/${attestationId}/verify`, { json: body });
+                return parseVerifyResult(d);
+            },
+            done: (r) => r.status === "CERTIFIED",
+            operation: `verify(${attestationId})`,
+            timeout,
+            pollInterval: opts?.pollInterval ?? 2,
+        });
+    }
+    // --- Certificates ---
+    async getCertificate(certificateId) {
+        const data = await this.transport.request("GET", `/v1/certificates/${certificateId}`);
+        return parseCertificateResponse(data);
+    }
+    listCertificates(opts) {
+        return new Paginator(this.transport, "/v1/certificates", parseCertificateResponse, { params: { limit: opts?.limit ?? 25 } });
+    }
+    async downloadPdf(certificateId) {
+        return this.transport.requestBytes("GET", `/v1/certificates/${certificateId}/pdf`);
+    }
+    async savePdf(certificateId, path) {
+        const pdf = await this.downloadPdf(certificateId);
+        const { writeFile } = await import("node:fs/promises");
+        await writeFile(path, pdf);
+    }
+    async getRevocationStatus(certificateId) {
+        const data = await this.transport.request("GET", `/v1/certificates/${certificateId}/revocation-status`);
+        return parseRevocationStatus(data);
+    }
+    async revokeCertificate(certificateId, opts) {
+        const data = await this.transport.request("POST", `/v1/certificates/${certificateId}/revoke`, { json: { reason: opts.reason } });
+        return parseCertificateResponse(data);
+    }
+    // --- Webhooks ---
+    async registerWebhook(opts) {
+        const data = await this.transport.request("POST", "/v1/webhooks", {
+            json: { url: opts.url },
+        });
+        return parseWebhook(data);
+    }
+    listWebhooks(opts) {
+        return new Paginator(this.transport, "/v1/webhooks", parseWebhook, {
+            params: { limit: opts?.limit ?? 25 },
+        });
+    }
+    async deleteWebhook(webhookId) {
+        await this.transport.request("DELETE", `/v1/webhooks/${webhookId}`);
+    }
+    // --- Transparency log (public, no auth) ---
+    async getLogHead() {
+        const data = await this.transport.request("GET", "/v1/log/head", {
+            authenticated: false,
+        });
+        return parseSignedTreeHead(data);
+    }
+    async getLogEntry(index) {
+        const data = await this.transport.request("GET", `/v1/log/entry/${index}`, { authenticated: false });
+        return parseLogEntry(data);
+    }
+    async getLogEntries(opts) {
+        const data = await this.transport.request("GET", "/v1/log/entries", {
+            params: { start: opts.start, end: opts.end },
+            authenticated: false,
+        });
+        return data.map(parseLogEntry);
+    }
+    async getInclusionProof(opts) {
+        const data = await this.transport.request("GET", "/v1/log/proof/inclusion", {
+            params: { index: opts.index, tree_size: opts.treeSize },
+            authenticated: false,
+        });
+        return parseInclusionProof(data);
+    }
+    async getConsistencyProof(opts) {
+        const data = await this.transport.request("GET", "/v1/log/proof/consistency", {
+            params: { old_size: opts.oldSize, new_size: opts.newSize },
+            authenticated: false,
+        });
+        return parseConsistencyProof(data);
+    }
+}
+// ---------------------------------------------------------------------------
+// Connection config resolution
+// ---------------------------------------------------------------------------
+function resolveConnectionConfig(connectionConfig, dsn, uri) {
+    const convenience = (dsn !== undefined ? 1 : 0) + (uri !== undefined ? 1 : 0);
+    if (convenience > 0 && connectionConfig !== undefined) {
+        throw new Error("Cannot provide both connectionConfig and a convenience parameter (dsn/uri). Use one or the other.");
+    }
+    if (convenience > 1) {
+        throw new Error("Cannot provide both dsn and uri.");
+    }
+    if (dsn !== undefined)
+        return { dsn };
+    if (uri !== undefined)
+        return { uri };
+    if (connectionConfig !== undefined)
+        return connectionConfig;
+    return {};
+}
+// ---------------------------------------------------------------------------
+// Polling helper
+// ---------------------------------------------------------------------------
+async function poll(opts) {
+    const deadline = Date.now() + opts.timeout * 1000;
+    let interval = opts.pollInterval * 1000;
+    while (true) {
+        const elapsed = (Date.now() - (deadline - opts.timeout * 1000)) / 1000;
+        if (Date.now() >= deadline) {
+            throw new TimeoutError(opts.operation, elapsed);
+        }
+        let result;
+        try {
+            result = await opts.fetch();
+        }
+        catch (err) {
+            if (err instanceof RateLimitError && err.retryAfter !== undefined) {
+                await sleep(err.retryAfter * 1000);
+                continue;
+            }
+            throw err;
+        }
+        if (opts.done(result)) {
+            return result;
+        }
+        const remaining = deadline - Date.now();
+        const sleepTime = Math.min(interval, remaining);
+        if (sleepTime <= 0) {
+            throw new TimeoutError(opts.operation, elapsed);
+        }
+        await sleep(sleepTime);
+        interval = Math.min(interval * 1.5, 30_000);
+    }
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=client.js.map

package/dist/esm/client.js.map

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

package/dist/esm/crypto-browser.d.ts

@@ -0,0 +1,7 @@
+/** Browser CryptoOps implementation using WebCrypto (crypto.subtle).
+ *
+ * Ed25519 support: Chrome 113+, Firefox 128+, Safari 17+.
+ */
+import type { CryptoOps } from "./crypto.js";
+export declare const browserCrypto: CryptoOps;
+//# sourceMappingURL=crypto-browser.d.ts.map

package/dist/esm/crypto-browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto-browser.d.ts","sourceRoot":"","sources":["../../src/crypto-browser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,eAAO,MAAM,aAAa,EAAE,SAyB3B,CAAC"}

package/dist/esm/crypto-browser.js

@@ -0,0 +1,34 @@
+/** Browser CryptoOps implementation using WebCrypto (crypto.subtle).
+ *
+ * Ed25519 support: Chrome 113+, Firefox 128+, Safari 17+.
+ */
+export const browserCrypto = {
+    async sha256(data) {
+        const hash = await crypto.subtle.digest("SHA-256", toBuffer(data));
+        return new Uint8Array(hash);
+    },
+    async ed25519Verify(publicKey, data, signature) {
+        try {
+            const spki = concatBytes(ED25519_DER_PREFIX, publicKey);
+            const key = await crypto.subtle.importKey("spki", toBuffer(spki), { name: "Ed25519" }, false, ["verify"]);
+            return crypto.subtle.verify("Ed25519", key, toBuffer(signature), toBuffer(data));
+        }
+        catch {
+            return false;
+        }
+    },
+};
+const ED25519_DER_PREFIX = new Uint8Array([
+    0x30, 0x2a, 0x30, 0x05, 0x06, 0x03, 0x2b, 0x65, 0x70, 0x03, 0x21, 0x00,
+]);
+/** Ensure the Uint8Array is backed by a plain ArrayBuffer (not SharedArrayBuffer). */
+function toBuffer(data) {
+    return data.buffer.slice(data.byteOffset, data.byteOffset + data.byteLength);
+}
+function concatBytes(a, b) {
+    const out = new Uint8Array(a.length + b.length);
+    out.set(a, 0);
+    out.set(b, a.length);
+    return out;
+}
+//# sourceMappingURL=crypto-browser.js.map

package/dist/esm/crypto-browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto-browser.js","sourceRoot":"","sources":["../../src/crypto-browser.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,CAAC,MAAM,aAAa,GAAc;IACtC,KAAK,CAAC,MAAM,CAAC,IAAgB;QAC3B,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QACnE,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,aAAa,CACjB,SAAqB,EACrB,IAAgB,EAChB,SAAqB;QAErB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,WAAW,CAAC,kBAAkB,EAAE,SAAS,CAAC,CAAC;YACxD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,SAAS,CACvC,MAAM,EACN,QAAQ,CAAC,IAAI,CAAC,EACd,EAAE,IAAI,EAAE,SAAS,EAAE,EACnB,KAAK,EACL,CAAC,QAAQ,CAAC,CACX,CAAC;YACF,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,EAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QACnF,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF,CAAC;AAEF,MAAM,kBAAkB,GAAG,IAAI,UAAU,CAAC;IACxC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;CACvE,CAAC,CAAC;AAEH,sFAAsF;AACtF,SAAS,QAAQ,CAAC,IAAgB;IAChC,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAgB,CAAC;AAC9F,CAAC;AAED,SAAS,WAAW,CAAC,CAAa,EAAE,CAAa;IAC/C,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC;IAChD,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACd,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IACrB,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/esm/crypto-node.d.ts

@@ -0,0 +1,4 @@
+/** Node.js CryptoOps implementation wrapping node:crypto. */
+import type { CryptoOps } from "./crypto.js";
+export declare const nodeCrypto: CryptoOps;
+//# sourceMappingURL=crypto-node.d.ts.map

package/dist/esm/crypto-node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto-node.d.ts","sourceRoot":"","sources":["../../src/crypto-node.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAG7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAM7C,eAAO,MAAM,UAAU,EAAE,SAuBxB,CAAC"}

package/dist/esm/crypto-node.js

@@ -0,0 +1,27 @@
+/** Node.js CryptoOps implementation wrapping node:crypto. */
+import { createHash, verify } from "node:crypto";
+const ED25519_DER_PREFIX = new Uint8Array([
+    0x30, 0x2a, 0x30, 0x05, 0x06, 0x03, 0x2b, 0x65, 0x70, 0x03, 0x21, 0x00,
+]);
+export const nodeCrypto = {
+    async sha256(data) {
+        const hash = createHash("sha256").update(data).digest();
+        return new Uint8Array(hash);
+    },
+    async ed25519Verify(publicKey, data, signature) {
+        try {
+            const spki = concatBytes(ED25519_DER_PREFIX, publicKey);
+            return verify(null, data, { key: Buffer.from(spki), format: "der", type: "spki" }, signature);
+        }
+        catch {
+            return false;
+        }
+    },
+};
+function concatBytes(a, b) {
+    const out = new Uint8Array(a.length + b.length);
+    out.set(a, 0);
+    out.set(b, a.length);
+    return out;
+}
+//# sourceMappingURL=crypto-node.js.map

package/dist/esm/crypto-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto-node.js","sourceRoot":"","sources":["../../src/crypto-node.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAE7D,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGjD,MAAM,kBAAkB,GAAG,IAAI,UAAU,CAAC;IACxC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI;CACvE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,UAAU,GAAc;IACnC,KAAK,CAAC,MAAM,CAAC,IAAgB;QAC3B,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;QACxD,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,aAAa,CACjB,SAAqB,EACrB,IAAgB,EAChB,SAAqB;QAErB,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,WAAW,CAAC,kBAAkB,EAAE,SAAS,CAAC,CAAC;YACxD,OAAO,MAAM,CACX,IAAI,EACJ,IAAI,EACJ,EAAE,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EACvD,SAAS,CACV,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF,CAAC;AAEF,SAAS,WAAW,CAAC,CAAa,EAAE,CAAa;IAC/C,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC;IAChD,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACd,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IACrB,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/esm/crypto.d.ts

@@ -0,0 +1,6 @@
+/** Pluggable cryptographic operations for Node.js and browser environments. */
+export interface CryptoOps {
+    sha256(data: Uint8Array): Promise<Uint8Array>;
+    ed25519Verify(publicKey: Uint8Array, data: Uint8Array, signature: Uint8Array): Promise<boolean>;
+}
+//# sourceMappingURL=crypto.d.ts.map

package/dist/esm/crypto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.d.ts","sourceRoot":"","sources":["../../src/crypto.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAE/E,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC9C,aAAa,CACX,SAAS,EAAE,UAAU,EACrB,IAAI,EAAE,UAAU,EAChB,SAAS,EAAE,UAAU,GACpB,OAAO,CAAC,OAAO,CAAC,CAAC;CACrB"}

package/dist/esm/crypto.js

@@ -0,0 +1,3 @@
+/** Pluggable cryptographic operations for Node.js and browser environments. */
+export {};
+//# sourceMappingURL=crypto.js.map

package/dist/esm/crypto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto.js","sourceRoot":"","sources":["../../src/crypto.ts"],"names":[],"mappings":"AAAA,+EAA+E"}

package/dist/esm/errors.d.ts

@@ -0,0 +1,76 @@
+/** Exception hierarchy for the BurnLedger SDK.
+ *
+ * Maps HTTP status codes to typed errors. Every error includes
+ * enough context for log correlation.
+ */
+export declare class BurnLedgerError extends Error {
+    constructor(message: string);
+}
+export declare class ApiError extends BurnLedgerError {
+    readonly code: string;
+    readonly statusCode: number;
+    readonly requestId: string;
+    constructor(opts: {
+        code: string;
+        message: string;
+        requestId: string;
+        statusCode: number;
+    });
+}
+export declare class AuthenticationError extends ApiError {
+    constructor(opts: {
+        code: string;
+        message: string;
+        requestId: string;
+    });
+}
+export declare class NotFoundError extends ApiError {
+    constructor(opts: {
+        code: string;
+        message: string;
+        requestId: string;
+    });
+}
+export declare class ConflictError extends ApiError {
+    constructor(opts: {
+        code: string;
+        message: string;
+        requestId: string;
+    });
+}
+export declare class ValidationError extends ApiError {
+    constructor(opts: {
+        code: string;
+        message: string;
+        requestId: string;
+    });
+}
+export declare class RateLimitError extends ApiError {
+    readonly retryAfter: number | undefined;
+    constructor(opts: {
+        code: string;
+        message: string;
+        requestId: string;
+        retryAfter?: number;
+    });
+}
+export declare class ServerError extends ApiError {
+    constructor(opts: {
+        code: string;
+        message: string;
+        requestId: string;
+        statusCode: number;
+    });
+}
+export declare class TimeoutError extends BurnLedgerError {
+    readonly operation: string;
+    readonly elapsed: number;
+    constructor(operation: string, elapsed: number);
+}
+export declare class VerificationError extends BurnLedgerError {
+    readonly reason: string;
+    constructor(reason: string);
+}
+/** Parse an API error envelope and throw the appropriate exception. */
+export declare function raiseForError(statusCode: number, body: Record<string, unknown>, retryAfter?: number): never;
+//# sourceMappingURL=errors.d.ts.map

package/dist/esm/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,QAAS,SAAQ,eAAe;IAC3C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,IAAI,EAAE;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;KACpB;CASF;AAED,qBAAa,mBAAoB,SAAQ,QAAQ;gBACnC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;CAIvE;AAED,qBAAa,aAAc,SAAQ,QAAQ;gBAC7B,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;CAIvE;AAED,qBAAa,aAAc,SAAQ,QAAQ;gBAC7B,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;CAIvE;AAED,qBAAa,eAAgB,SAAQ,QAAQ;gBAC/B,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;CAIvE;AAED,qBAAa,cAAe,SAAQ,QAAQ;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;gBAE5B,IAAI,EAAE;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB;CAKF;AAED,qBAAa,WAAY,SAAQ,QAAQ;gBAC3B,IAAI,EAAE;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;KACpB;CAIF;AAED,qBAAa,YAAa,SAAQ,eAAe;IAC/C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;gBAEb,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAM/C;AAED,qBAAa,iBAAkB,SAAQ,eAAe;IACpD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,MAAM,EAAE,MAAM;CAK3B;AAkBD,uEAAuE;AACvE,wBAAgB,aAAa,CAC3B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,UAAU,CAAC,EAAE,MAAM,GAClB,KAAK,CAqBP"}

package/dist/esm/errors.js

@@ -0,0 +1,105 @@
+/** Exception hierarchy for the BurnLedger SDK.
+ *
+ * Maps HTTP status codes to typed errors. Every error includes
+ * enough context for log correlation.
+ */
+export class BurnLedgerError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "BurnLedgerError";
+    }
+}
+export class ApiError extends BurnLedgerError {
+    code;
+    statusCode;
+    requestId;
+    constructor(opts) {
+        super(`[${opts.statusCode}] ${opts.code}: ${opts.message} (request_id=${opts.requestId})`);
+        this.name = "ApiError";
+        this.code = opts.code;
+        this.statusCode = opts.statusCode;
+        this.requestId = opts.requestId;
+    }
+}
+export class AuthenticationError extends ApiError {
+    constructor(opts) {
+        super({ ...opts, statusCode: 401 });
+        this.name = "AuthenticationError";
+    }
+}
+export class NotFoundError extends ApiError {
+    constructor(opts) {
+        super({ ...opts, statusCode: 404 });
+        this.name = "NotFoundError";
+    }
+}
+export class ConflictError extends ApiError {
+    constructor(opts) {
+        super({ ...opts, statusCode: 409 });
+        this.name = "ConflictError";
+    }
+}
+export class ValidationError extends ApiError {
+    constructor(opts) {
+        super({ ...opts, statusCode: 422 });
+        this.name = "ValidationError";
+    }
+}
+export class RateLimitError extends ApiError {
+    retryAfter;
+    constructor(opts) {
+        super({ ...opts, statusCode: 429 });
+        this.name = "RateLimitError";
+        this.retryAfter = opts.retryAfter;
+    }
+}
+export class ServerError extends ApiError {
+    constructor(opts) {
+        super(opts);
+        this.name = "ServerError";
+    }
+}
+export class TimeoutError extends BurnLedgerError {
+    operation;
+    elapsed;
+    constructor(operation, elapsed) {
+        super(`${operation}: timed out after ${elapsed.toFixed(1)}s`);
+        this.name = "TimeoutError";
+        this.operation = operation;
+        this.elapsed = elapsed;
+    }
+}
+export class VerificationError extends BurnLedgerError {
+    reason;
+    constructor(reason) {
+        super(reason);
+        this.name = "VerificationError";
+        this.reason = reason;
+    }
+}
+const STATUS_TO_CLASS = {
+    401: AuthenticationError,
+    404: NotFoundError,
+    409: ConflictError,
+    422: ValidationError,
+    429: RateLimitError,
+};
+/** Parse an API error envelope and throw the appropriate exception. */
+export function raiseForError(statusCode, body, retryAfter) {
+    const err = (body.error ?? {});
+    const code = err.code ?? "UNKNOWN";
+    const message = err.message ?? "";
+    const requestId = err.request_id ?? "";
+    const Cls = STATUS_TO_CLASS[statusCode];
+    if (Cls === RateLimitError) {
+        throw new RateLimitError({ code, message, requestId, retryAfter });
+    }
+    if (Cls) {
+        throw new Cls({ code, message, requestId });
+    }
+    if (statusCode >= 500) {
+        throw new ServerError({ code, message, requestId, statusCode });
+    }
+    throw new ApiError({ code, message, requestId, statusCode });
+}
+//# sourceMappingURL=errors.js.map

package/dist/esm/errors.js.map

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

package/dist/esm/http.d.ts

@@ -0,0 +1,35 @@
+/** HTTP transport layer wrapping native fetch.
+ *
+ * Handles: Bearer auth, response envelope unwrapping, retry on 5xx/transport
+ * errors, Retry-After respect on 429, and raw byte streaming for PDFs.
+ */
+export interface TransportOptions {
+    baseUrl: string;
+    apiKey: string;
+    timeout: number;
+    maxRetries: number;
+}
+export declare class Transport {
+    private readonly baseUrl;
+    private readonly apiKey;
+    private readonly timeout;
+    private readonly maxRetries;
+    constructor(opts: TransportOptions);
+    /** Make a request and return the unwrapped `data` field. */
+    request(method: string, path: string, opts?: {
+        json?: unknown;
+        params?: Record<string, string | number>;
+        authenticated?: boolean;
+    }): Promise<unknown>;
+    /** Make a request and return the full response envelope (for pagination). */
+    requestRaw(method: string, path: string, opts?: {
+        json?: unknown;
+        params?: Record<string, string | number>;
+        authenticated?: boolean;
+    }): Promise<Record<string, unknown>>;
+    /** Make a request and return raw bytes (for PDF downloads). */
+    requestBytes(method: string, path: string, opts?: {
+        authenticated?: boolean;
+    }): Promise<Uint8Array>;
+}
+//# sourceMappingURL=http.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/http.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;gBAExB,IAAI,EAAE,gBAAgB;IAOlC,4DAA4D;IACtD,OAAO,CACX,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE;QACL,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;QACzC,aAAa,CAAC,EAAE,OAAO,CAAC;KACzB,GACA,OAAO,CAAC,OAAO,CAAC;IAKnB,6EAA6E;IACvE,UAAU,CACd,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE;QACL,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;QACzC,aAAa,CAAC,EAAE,OAAO,CAAC;KACzB,GACA,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAiFnC,+DAA+D;IACzD,YAAY,CAChB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,GACjC,OAAO,CAAC,UAAU,CAAC;CAyBvB"}