@compose-market/sdk 0.1.0 → 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,43 @@
+# Changelog
+
+## 0.2.0
+
+First production-shaped release. Full rewrite from the 0.1.x typed-fetch prototype.
+
+### Highlights
+
+- **Modular architecture** — dedicated resource classes (`KeysResource`, `ModelsResource`, `InferenceResource`, `X402Resource`, `WebhooksResource`) over a shared `HttpClient` with lazy request execution (no double-fire when a caller does both `await` and `.asResponse()`).
+- **Streaming** — `AsyncIterable<ChatCompletionChunk>` and `AsyncIterable<ResponseStreamEvent>` with `.final()` for reassembled chat completions, tool-call deltas, and reasoning deltas.
+- **Typed cost receipts** — every billable call returns `{ data, receipt, requestId, response }`; streams emit a terminal `event: compose.receipt` frame; non-streaming calls carry `X-Compose-Receipt` header + `compose_receipt` JSON field.
+- **Canonical Compose model card** — `sdk.models.list()` returns the flat Compose-native shape `{ modelId, name, provider, type, contextWindow, pricing, ... }` exactly as served by `api.compose.market`. `sdk.models.search()` adds cursor pagination with modality/provider/price/context filters over the full ~45k catalog.
+- **x402 v2 first-class** — facilitator `supported`/`chains`/`verify`/`settle` + typed decoders for `PAYMENT-REQUIRED`, `PAYMENT-RESPONSE`, `X-Compose-Receipt`. New `sdk.x402.facilitator.chains()` enumerates live chains + USDC contract metadata.
+- **Typed error tree** — `ComposeError` → `ComposeAPIError` → `BadRequestError` / `AuthenticationError` / `PermissionDeniedError` / `NotFoundError` / `ConflictError` / `UnprocessableEntityError` / `RateLimitError` / `InternalServerError` / `ComposePaymentRequiredError` / `ComposeBudgetExhaustedError`. Every error carries `code`, `status`, `details`, `requestId`, and (for 402) `paymentRequired`.
+- **Webhook verification** — HMAC-SHA256, Stripe-style `X-Compose-Signature: t=...,v1=...` header, constant-time comparison.
+- **Retries + timeouts + AbortSignal** — jittered exponential backoff; honors `Retry-After`; auto-generates `X-Idempotency-Key` on mutations.
+- **Video job streaming** — `sdk.inference.videos.stream(id)` / `.waitUntilDone(id, { onStatus })` for SSE-driven polling.
+
+### Breaking changes from 0.1.x
+
+- Package entry moved from `./index.js` to `./dist/index.js` with dual `.d.ts` + sourcemaps.
+- `ComposeApiError` renamed to `ComposeAPIError` (plus typed subclasses). Error envelopes now follow the canonical `{ error: { code, message, details? } }` shape.
+- `sdk.keys.getActive()` no longer returns the token. The token is returned exactly once by `sdk.keys.create()` and must be persisted by the integrator (store in `localStorage`, keychain, secret store, etc.). Calling `getActive()` returns metadata only.
+- `sdk.keys.revoke()` and the new `sdk.keys.get(id)` require possession of the target key's JWT (pass via `sdk.keys.use(token)` or the constructor).
+- `sdk.inference.*` entry points now return `ComposeCompletion<T>` (`{ data, receipt, requestId, response }`) instead of the raw JSON body. Use `.data` to access the parsed body.
+- Streaming is now an explicit `.stream()` method (separate from `.create()`) returning `ComposeStreamIterator<Chunk, Final>`. Passing `stream: true` to `.create()` throws `BadRequestError`.
+
+### Tests
+
+- **Hermetic.** Three suites: `sdk.unit.test.ts` (pure), `sdk.streaming.test.ts` (in-test synthetic SSE server), `sdk.contract.test.ts` (in-test mock HTTP server with canned responses mirroring `api.compose.market`).
+- No sibling-repo imports. No Redis. No Thirdweb. No secrets. No environment variables. Runs clean from a fresh `git clone`.
+
+### Infrastructure prerequisites
+
+This release aligns with Compose api/ Phase 0 changes:
+- `GET /api/session` no longer returns the Compose Key token (metadata only).
+- `DELETE /api/keys/:keyId` requires JWT-possession auth.
+- `GET /api/keys/:keyId` added for single-key inspection.
+- `GET /api/x402/facilitator/chains` added for chain metadata enumeration.
+- `X-Request-Id` is set on every response; `X-Compose-Receipt` on billable responses.
+- SSE streams emit named `compose.receipt`, `compose.error`, `compose.video.status` events.
+- CORS is unified (allow-list + `Vary: Origin` + explicit `Expose-Headers`).
+- `POST /api/payments/prepare` honors `X-Idempotency-Key` — replays return the original intent unchanged.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 compose.market
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,186 @@
+# `@compose-market/sdk`
+
+Official Compose.Market SDK: Compose Keys, x402 v2 facilitator, 45k+ model catalog, and OpenAI-shaped streaming inference with typed cost receipts.
+
+[![npm](https://img.shields.io/npm/v/@compose-market/sdk.svg)](https://www.npmjs.com/package/@compose-market/sdk)
+[![license](https://img.shields.io/npm/l/@compose-market/sdk.svg)](./LICENSE)
+
+Zero runtime dependencies. Works in Node 20+, Bun, Deno, Cloudflare Workers, and modern browsers.
+
+## Install
+
+```bash
+npm install @compose-market/sdk
+```
+
+## Quick start
+
+```ts
+import { ComposeSDK } from "@compose-market/sdk";
+
+// Whatever identity stack you already use produced a wallet address for
+// your user. Pass it through — Compose trusts it exactly the way our
+// first-party apps do.
+const sdk = new ComposeSDK({
+  userAddress: "0x1234567890abcdef1234567890abcdef12345678",
+  chainId: 43114, // Avalanche C-Chain
+});
+
+// Create a 10 USDC / 24 h Compose Key. The token is returned exactly once;
+// store it client-side. Subsequent calls on this SDK instance carry it
+// automatically as `Authorization: Bearer compose-<jwt>`.
+const session = await sdk.keys.create({
+  purpose: "session",
+  budgetUsd: 10,
+  durationHours: 24,
+});
+
+// Non-streaming chat completion with a cost receipt.
+const { data, receipt, requestId } = await sdk.inference.chat.completions.create({
+  model: "gpt-4.1-mini",
+  messages: [{ role: "user", content: "Hello!" }],
+});
+console.log(data.choices[0].message.content);
+console.log("Charged", receipt?.finalAmountWei, "wei");
+console.log("Request id:", requestId);
+
+// Streaming chat completion — async iterable of ChatCompletionChunk.
+const stream = sdk.inference.chat.completions.stream({
+  model: "gpt-4.1-mini",
+  messages: [{ role: "user", content: "Write a haiku about Avalanche." }],
+});
+for await (const chunk of stream) {
+  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
+}
+const { chatCompletion, receipt: streamReceipt } = await stream.final();
+console.log("\nTotal tokens:", chatCompletion.usage.total_tokens);
+console.log("Settled:", streamReceipt?.finalAmountWei, "wei", streamReceipt?.txHash);
+```
+
+## Capabilities
+
+### Compose Keys
+
+- `sdk.keys.create({ purpose, budgetUsd, durationHours, ... })` — creates a Compose Key JWT. Requires the underlying wallet to have pre-approved USDC to the Compose treasury for the requested budget.
+- `sdk.keys.getActive({ chainId? })` — returns current session metadata (budget, expiry, warnings). **Does not** return the token; the token is returned exactly once by `create()` and must be persisted by the integrator.
+- `sdk.keys.list()` — lists all keys for the attached wallet.
+- `sdk.keys.get(keyId)` — inspects a single key. Requires possession of that key's JWT.
+- `sdk.keys.revoke(keyId)` — revokes a key. Requires possession of that key's JWT.
+- `sdk.keys.use(token)` / `sdk.keys.currentToken()` / `sdk.keys.clearToken()` — in-memory token management.
+
+### 45k+ Model Catalog
+
+- `sdk.models.list()` — curated ~612-model set, canonical Compose shape (`{ modelId, name, provider, type, contextWindow, pricing, input, output, ... }`).
+- `sdk.models.listAll()` — full ~45k catalog.
+- `sdk.models.search({ q, modality, provider, priceMaxPerMTok, contextWindowMin, streaming, cursor, limit })` — cursor-paginated search.
+- `sdk.models.get(modelId)` — single model details.
+- `sdk.models.getParams(modelId)` — optional per-model parameters for image/video generation.
+
+### Inference
+
+Every billable call resolves to `{ data, receipt, requestId, response }`. The receipt is also available as an SSE `event: compose.receipt` frame on streaming calls and as a `X-Compose-Receipt` base64-url header on all billable responses.
+
+- `sdk.inference.chat.completions.create(params)` / `.stream(params)` — OpenAI Chat Completions with typed tool-call delta aggregation and `reasoning_content` deltas.
+- `sdk.inference.responses.create(params)` / `.stream(params)` / `.get(id)` / `.inputItems(id)` / `.cancel(id)` — OpenAI Responses API.
+- `sdk.inference.embeddings.create(params)`.
+- `sdk.inference.images.generate(params)` / `.edit(params)`.
+- `sdk.inference.audio.speech(params)` — returns the raw audio `Response`.
+- `sdk.inference.audio.transcriptions(params)` — multipart/form-data when `file` is a Blob/File/Uint8Array; JSON+base64 when `file` is a string.
+- `sdk.inference.videos.generate(params)` / `.get(id)` / `.stream(id)` / `.waitUntilDone(id, { onStatus })` — async video job polling via SSE.
+
+### x402
+
+- `sdk.x402.facilitator.supported()` — enumerate schemes + CAIP-2 networks the facilitator is configured for.
+- `sdk.x402.facilitator.chains()` — full chain metadata (USDC contract, explorer, testnet flag).
+- `sdk.x402.facilitator.verify(body)` / `.settle(body)` — direct facilitator access.
+- `sdk.x402.decodePaymentRequired(headerValue)` / `.decodePaymentResponse(headerValue)` / `.decodeReceipt(headerValue)` — typed base64-url decoders for the three x402 v2 headers.
+
+### Webhooks
+
+- `sdk.webhooks.verify({ body, signature, secret })` — HMAC-SHA256 signature verification (constant-time).
+- `sdk.webhooks.constructEvent({ body, signature, secret })` — verify + parse into a typed event. Throws on invalid signatures.
+
+## Error model
+
+Typed error hierarchy — every error derives from `ComposeError` and has a stable `code` matching the canonical server enum.
+
+```ts
+import {
+  ComposeError,
+  ComposeAPIError,
+  ComposePaymentRequiredError,
+  ComposeBudgetExhaustedError,
+  AuthenticationError,
+  PermissionDeniedError,
+  NotFoundError,
+  RateLimitError,
+  ComposeConnectionError,
+  ComposeTimeoutError,
+} from "@compose-market/sdk";
+
+try {
+  await sdk.inference.chat.completions.create({ /* ... */ });
+} catch (err) {
+  if (err instanceof ComposePaymentRequiredError) {
+    console.log("x402 payment required:", err.paymentRequired);
+  } else if (err instanceof RateLimitError) {
+    console.log("Retry after", err.retryAfter, "seconds");
+  } else {
+    throw err;
+  }
+}
+```
+
+## Streaming events
+
+The SDK surfaces every SSE event the Compose gateway emits:
+
+- Standard OpenAI chunks (`chat.completion.chunk`, `response.output_text.delta`, `response.completed`).
+- **Reasoning deltas** — `reasoning_content` in chat chunks, `response.reasoning.delta` in responses streams.
+- **Tool-call deltas** — assembled across chunks into a typed `ChatCompletionMessageToolCall[]`.
+- **`compose.receipt`** — terminal settlement receipt with tx hash, line items, platform fee.
+- **`compose.error`** — structured stream errors when the upstream fails mid-flight.
+- **`compose.video.status`** — video job progress updates on `videos.stream(id)`.
+
+## Retries, timeouts, AbortSignal
+
+```ts
+const sdk = new ComposeSDK({
+  timeoutMs: 30_000,
+  retry: {
+    maxRetries: 3,
+    initialDelayMs: 500,
+    maxDelayMs: 8_000,
+    jitter: true,
+  },
+});
+
+const controller = new AbortController();
+setTimeout(() => controller.abort(), 5_000);
+await sdk.inference.chat.completions.create(
+  { model: "gpt-4.1-mini", messages: [{ role: "user", content: "..." }] },
+  { signal: controller.signal },
+);
+```
+
+The SDK auto-retries 408 / 409 / 425 / 429 / 5xx responses and transient network errors, honors `Retry-After` from 429 responses, and auto-generates an `X-Idempotency-Key` on mutating calls so retries are safe against the Compose facilitator.
+
+## Supported chains (v1.0)
+
+- **Avalanche C-Chain** (`eip155:43114`)
+- **Avalanche Fuji testnet** (`eip155:43113`)
+
+Solana support ships in v1.1. Enumerate live chains with `sdk.x402.facilitator.chains()`.
+
+## What this SDK is NOT
+
+- Not a wallet. The SDK never prompts for a signature, never creates a smart account, never runs KYC. Identity is whatever you already have.
+- Not a retry-forever loop on payment-required errors. 402 responses are surfaced as typed errors; the caller decides what to do next.
+- Not a Thirdweb/Privy/Clerk/Auth0 adapter. It's transport-agnostic on purpose — integrators bring whatever identity stack they already use.
+
+Not bundled:
+- No wallet client, no identity provider, no auth SDK. Bring the wallet address your stack produced and keep the rest of your infrastructure unchanged.
+
+## License
+
+MIT

package/dist/errors.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Compose Market SDK — typed error hierarchy.
+ *
+ * Every error raised by the SDK derives from `ComposeError`. Callers can
+ * discriminate via `instanceof` (e.g. `err instanceof ComposePaymentRequiredError`)
+ * or via `err.code`, which always matches the canonical server error enum.
+ */
+import type { ComposeErrorCode, ComposeReceipt, PaymentRequired } from "./types/index.js";
+export declare class ComposeError extends Error {
+    readonly code: ComposeErrorCode;
+    readonly status?: number;
+    readonly details?: Record<string, unknown>;
+    readonly requestId?: string;
+    readonly headers?: Record<string, string>;
+    readonly body?: unknown;
+    constructor(input: {
+        code: ComposeErrorCode;
+        message: string;
+        status?: number;
+        details?: Record<string, unknown>;
+        requestId?: string;
+        headers?: Record<string, string>;
+        body?: unknown;
+    });
+}
+export declare class ComposeAPIError extends ComposeError {
+    constructor(input: {
+        code: ComposeErrorCode;
+        message: string;
+        status: number;
+        details?: Record<string, unknown>;
+        requestId?: string;
+        headers?: Record<string, string>;
+        body?: unknown;
+    });
+}
+export declare class BadRequestError extends ComposeAPIError {
+    constructor(input: Omit<ConstructorParameters<typeof ComposeAPIError>[0], "status" | "code"> & {
+        code?: ComposeErrorCode;
+    });
+}
+export declare class AuthenticationError extends ComposeAPIError {
+    constructor(input: Omit<ConstructorParameters<typeof ComposeAPIError>[0], "status" | "code"> & {
+        code?: ComposeErrorCode;
+    });
+}
+export declare class PermissionDeniedError extends ComposeAPIError {
+    constructor(input: Omit<ConstructorParameters<typeof ComposeAPIError>[0], "status" | "code"> & {
+        code?: ComposeErrorCode;
+    });
+}
+export declare class NotFoundError extends ComposeAPIError {
+    constructor(input: Omit<ConstructorParameters<typeof ComposeAPIError>[0], "status" | "code"> & {
+        code?: ComposeErrorCode;
+    });
+}
+export declare class ConflictError extends ComposeAPIError {
+    constructor(input: Omit<ConstructorParameters<typeof ComposeAPIError>[0], "status" | "code"> & {
+        code?: ComposeErrorCode;
+    });
+}
+export declare class UnprocessableEntityError extends ComposeAPIError {
+    constructor(input: Omit<ConstructorParameters<typeof ComposeAPIError>[0], "status" | "code"> & {
+        code?: ComposeErrorCode;
+    });
+}
+export declare class RateLimitError extends ComposeAPIError {
+    readonly retryAfter?: number;
+    constructor(input: Omit<ConstructorParameters<typeof ComposeAPIError>[0], "status" | "code"> & {
+        code?: ComposeErrorCode;
+        retryAfter?: number;
+    });
+}
+export declare class InternalServerError extends ComposeAPIError {
+    constructor(input: {
+        code?: ComposeErrorCode;
+        message: string;
+        status?: number;
+        details?: Record<string, unknown>;
+        requestId?: string;
+        headers?: Record<string, string>;
+        body?: unknown;
+    });
+}
+export declare class ComposePaymentRequiredError extends ComposeAPIError {
+    readonly paymentRequired: PaymentRequired | null;
+    readonly paymentRequiredHeader: string | null;
+    constructor(input: {
+        code?: ComposeErrorCode;
+        message: string;
+        details?: Record<string, unknown>;
+        requestId?: string;
+        headers?: Record<string, string>;
+        body?: unknown;
+        paymentRequired: PaymentRequired | null;
+        paymentRequiredHeader: string | null;
+    });
+}
+export declare class ComposeBudgetExhaustedError extends ComposeAPIError {
+    constructor(input: {
+        message: string;
+        details?: Record<string, unknown>;
+        requestId?: string;
+        headers?: Record<string, string>;
+        body?: unknown;
+    });
+}
+export declare class ComposeConnectionError extends ComposeError {
+    readonly cause?: unknown;
+    constructor(input: {
+        message: string;
+        cause?: unknown;
+        requestId?: string;
+    });
+}
+export declare class ComposeTimeoutError extends ComposeError {
+    constructor(input: {
+        message: string;
+        requestId?: string;
+    });
+}
+export interface ComposeCallFailure {
+    code: ComposeErrorCode;
+    message: string;
+    details?: Record<string, unknown>;
+    receipt?: ComposeReceipt;
+}
+/**
+ * Internal constructor: build the most specific error from a parsed HTTP
+ * response. Used by the HTTP client before the response is handed back to
+ * callers.
+ */
+export declare function buildApiError(input: {
+    status: number;
+    code: ComposeErrorCode;
+    message: string;
+    details?: Record<string, unknown>;
+    requestId?: string;
+    headers?: Record<string, string>;
+    body?: unknown;
+    paymentRequired?: PaymentRequired | null;
+    paymentRequiredHeader?: string | null;
+    retryAfter?: number;
+}): ComposeAPIError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

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

package/dist/errors.js

@@ -0,0 +1,152 @@
+/**
+ * Compose Market SDK — typed error hierarchy.
+ *
+ * Every error raised by the SDK derives from `ComposeError`. Callers can
+ * discriminate via `instanceof` (e.g. `err instanceof ComposePaymentRequiredError`)
+ * or via `err.code`, which always matches the canonical server error enum.
+ */
+export class ComposeError extends Error {
+    code;
+    status;
+    details;
+    requestId;
+    headers;
+    body;
+    constructor(input) {
+        super(input.message);
+        this.name = "ComposeError";
+        this.code = input.code;
+        this.status = input.status;
+        this.details = input.details;
+        this.requestId = input.requestId;
+        this.headers = input.headers;
+        this.body = input.body;
+    }
+}
+export class ComposeAPIError extends ComposeError {
+    constructor(input) {
+        super(input);
+        this.name = "ComposeAPIError";
+    }
+}
+export class BadRequestError extends ComposeAPIError {
+    constructor(input) {
+        super({ code: input.code ?? "validation_error", ...input, status: 400 });
+        this.name = "BadRequestError";
+    }
+}
+export class AuthenticationError extends ComposeAPIError {
+    constructor(input) {
+        super({ code: input.code ?? "authentication_failed", ...input, status: 401 });
+        this.name = "AuthenticationError";
+    }
+}
+export class PermissionDeniedError extends ComposeAPIError {
+    constructor(input) {
+        super({ code: input.code ?? "forbidden", ...input, status: 403 });
+        this.name = "PermissionDeniedError";
+    }
+}
+export class NotFoundError extends ComposeAPIError {
+    constructor(input) {
+        super({ code: input.code ?? "not_found", ...input, status: 404 });
+        this.name = "NotFoundError";
+    }
+}
+export class ConflictError extends ComposeAPIError {
+    constructor(input) {
+        super({ code: input.code ?? "conflict", ...input, status: 409 });
+        this.name = "ConflictError";
+    }
+}
+export class UnprocessableEntityError extends ComposeAPIError {
+    constructor(input) {
+        super({ code: input.code ?? "validation_error", ...input, status: 422 });
+        this.name = "UnprocessableEntityError";
+    }
+}
+export class RateLimitError extends ComposeAPIError {
+    retryAfter;
+    constructor(input) {
+        super({ code: input.code ?? "rate_limited", ...input, status: 429 });
+        this.name = "RateLimitError";
+        this.retryAfter = input.retryAfter;
+    }
+}
+export class InternalServerError extends ComposeAPIError {
+    constructor(input) {
+        super({ code: input.code ?? "internal_error", status: input.status ?? 500, message: input.message, details: input.details, requestId: input.requestId, headers: input.headers, body: input.body });
+        this.name = "InternalServerError";
+    }
+}
+export class ComposePaymentRequiredError extends ComposeAPIError {
+    paymentRequired;
+    paymentRequiredHeader;
+    constructor(input) {
+        super({ code: input.code ?? "payment_required", ...input, status: 402 });
+        this.name = "ComposePaymentRequiredError";
+        this.paymentRequired = input.paymentRequired;
+        this.paymentRequiredHeader = input.paymentRequiredHeader;
+    }
+}
+export class ComposeBudgetExhaustedError extends ComposeAPIError {
+    constructor(input) {
+        super({ code: "budget_exhausted", ...input, status: 402 });
+        this.name = "ComposeBudgetExhaustedError";
+    }
+}
+export class ComposeConnectionError extends ComposeError {
+    cause;
+    constructor(input) {
+        super({ code: "network_error", ...input });
+        this.name = "ComposeConnectionError";
+        this.cause = input.cause;
+    }
+}
+export class ComposeTimeoutError extends ComposeError {
+    constructor(input) {
+        super({ code: "timeout", ...input });
+        this.name = "ComposeTimeoutError";
+    }
+}
+/**
+ * Internal constructor: build the most specific error from a parsed HTTP
+ * response. Used by the HTTP client before the response is handed back to
+ * callers.
+ */
+export function buildApiError(input) {
+    const base = {
+        code: input.code,
+        message: input.message,
+        details: input.details,
+        requestId: input.requestId,
+        headers: input.headers,
+        body: input.body,
+    };
+    if (input.status === 402) {
+        if (input.code === "budget_exhausted") {
+            return new ComposeBudgetExhaustedError(base);
+        }
+        return new ComposePaymentRequiredError({
+            ...base,
+            paymentRequired: input.paymentRequired ?? null,
+            paymentRequiredHeader: input.paymentRequiredHeader ?? null,
+        });
+    }
+    if (input.status === 400)
+        return new BadRequestError(base);
+    if (input.status === 401)
+        return new AuthenticationError(base);
+    if (input.status === 403)
+        return new PermissionDeniedError(base);
+    if (input.status === 404)
+        return new NotFoundError(base);
+    if (input.status === 409)
+        return new ConflictError(base);
+    if (input.status === 422)
+        return new UnprocessableEntityError(base);
+    if (input.status === 429)
+        return new RateLimitError({ ...base, retryAfter: input.retryAfter });
+    return new InternalServerError({ ...base, status: input.status });
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/http.d.ts

@@ -0,0 +1,98 @@
+/**
+ * HTTP client core for the Compose Market SDK.
+ *
+ * Responsibilities:
+ *   - Build canonical headers (Authorization / x-session-user-address / x-chain-id /
+ *     PAYMENT-SIGNATURE / x-x402-max-amount-wei / x-idempotency-key / User-Agent).
+ *   - Apply retries with exponential backoff + jitter (default 2 retries, honor
+ *     Retry-After).
+ *   - Attach an AbortSignal for caller-driven cancellation and an internal
+ *     timeout.
+ *   - Parse error envelopes + PaymentRequired into typed error classes.
+ *   - Return an `APIPromise<T>` that exposes `.asResponse()` and `.withResponse()`
+ *     so callers can read headers (receipts, request-id, tx hash) without parsing.
+ *
+ * Zero runtime dependencies. Uses the platform `fetch`.
+ */
+export type FetchLike = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
+export interface RetryPolicy {
+    maxRetries: number;
+    initialDelayMs: number;
+    maxDelayMs: number;
+    jitter: boolean;
+}
+export interface HttpClientOptions {
+    baseUrl: string;
+    fetch: FetchLike;
+    timeoutMs: number;
+    defaultHeaders: Record<string, string>;
+    retry: RetryPolicy;
+    userAgent: string;
+    logger?: {
+        debug?: (msg: string, meta?: Record<string, unknown>) => void;
+        warn?: (msg: string, meta?: Record<string, unknown>) => void;
+        error?: (msg: string, meta?: Record<string, unknown>) => void;
+    };
+}
+export interface HeaderBagInput {
+    authJwt?: string;
+    composeKey?: string | null;
+    walletAddress?: string | null;
+    chainId?: number | null;
+    paymentSignature?: string;
+    x402MaxAmountWei?: string;
+    idempotencyKey?: string;
+    composeRunId?: string;
+    requestId?: string;
+    extra?: Record<string, string | undefined>;
+}
+export interface RequestOptions {
+    method: string;
+    path: string;
+    query?: Record<string, string | number | boolean | null | undefined>;
+    body?: unknown;
+    bodyType?: "json" | "form-data" | "raw";
+    rawBody?: BodyInit;
+    headers?: HeaderBagInput;
+    /** Override for streaming responses — skip JSON parsing. */
+    expectStream?: boolean;
+    signal?: AbortSignal;
+    /** Caller-provided per-call timeout (ms). */
+    timeoutMs?: number;
+    /** Caller-provided per-call retry policy. */
+    retry?: Partial<RetryPolicy>;
+    /**
+     * Treat this call as NOT retryable on network errors; useful for non-
+     * idempotent mutations the caller knows should only be attempted once.
+     */
+    doNotRetry?: boolean;
+}
+export interface APIPromise<T> extends PromiseLike<T> {
+    /** Return the raw `Response` without consuming the body. */
+    asResponse(): Promise<Response>;
+    /** Return `{ data, response }` with the parsed body and raw response. */
+    withResponse(): Promise<{
+        data: T;
+        response: Response;
+    }>;
+    /** Standard promise `catch`. */
+    catch<TResult = never>(onrejected?: ((reason: unknown) => TResult | PromiseLike<TResult>) | null): Promise<T | TResult>;
+    /** Standard promise `finally`. */
+    finally(onfinally?: (() => void) | null): Promise<T>;
+}
+export declare function buildHeaders(input: HeaderBagInput & {
+    defaultHeaders: Record<string, string>;
+    userAgent: string;
+    bodyType?: "json" | "form-data" | "raw";
+}): Headers;
+export declare class HttpClient {
+    private readonly options;
+    constructor(options: HttpClientOptions);
+    request<T>(config: RequestOptions): APIPromise<T>;
+    private execute;
+    private computeBackoff;
+    private encodeBody;
+    private parseResponseBody;
+    private safeReadJson;
+}
+//# sourceMappingURL=http.d.ts.map