@pacspace-io/sdk 0.1.0 → 0.2.0

package/README.md

@@ -41,7 +41,9 @@ const checkpoint = await pac.balance.checkpoint('cust_123', {
 | Option | Type | Default | Description |
 |--------|------|---------|-------------|
 | `apiKey` | `string` | **required** | Your PacSpace API key (`pk_live_*` or `pk_test_*`) |
-| `baseUrl` | `string` | `https://balance-api.pacspace.io` | API base URL |
+| `baseUrl` | `string` | auto-routed | API base URL (overrides auto-routing if provided) |
+| `sandboxUrl` | `string` | `https://api-sandbox-<hash>.run.app` | Custom sandbox URL (used for `pk_test_*` keys) |
+| `productionUrl` | `string` | `https://api.pacspace.io` | Custom production URL (used for `pk_live_*` keys) |
 | `chainId` | `number` | auto-detected | Default chain ID (296 for sandbox, 295 for production) |
 | `maxRetries` | `number` | `2` | Max retries on transient errors |
 | `timeout` | `number` | `30000` | Request timeout in ms |
@@ -103,17 +105,36 @@ if (report.matchesYours) {
 
 #### `pac.balance.receipt(customerId, options?)`
 
-Generate a verifiable receipt with cryptographic proof data.
+Generate a verifiable receipt. With `options.period` (YYYY-MM), returns a period-specific receipt with `proofRoot`, `verifyUrl`, and `verificationReference` — share the `verifyUrl` on invoices for counterparty verification.
 
 ```typescript
-const receipt = await pac.balance.receipt('cust_123');
+// Period receipt (shareable proof for invoices)
+const receipt = await pac.balance.receipt('cust_123', { period: '2026-02' });
+console.log(receipt.proofRoot);   // Proof root for verification
+console.log(receipt.verifyUrl);   // app.pacspace.io/verify/{proofRoot}
 console.log(receipt.finalBalance);
-console.log(receipt.verification.itemHashes);
+
+// Full ledger receipt (all verified deltas)
+const full = await pac.balance.receipt('cust_123');
+console.log(full.finalBalance);
+console.log(full.verification.itemHashes);
+```
+
+#### `pac.verify(proofRoot)`
+
+Verify a proof root via the public verification endpoint. No API key required — the proof root is the access key.
+
+```typescript
+const result = await pac.verify(receipt.proofRoot);
+if (result.verified) {
+  console.log(result.verification?.publicLedgerUrl);
+  console.log(result.summary?.recordCount);
+}
 ```
 
 #### `pac.balance.checkpoint(customerId?, options?)`
 
-Commit a period-end checkpoint (Merkle root anchored on-chain).
+Commit a period-end checkpoint. The proof root is recorded on the public verification layer for independent verification.
 
 ```typescript
 const checkpoint = await pac.balance.checkpoint('cust_123', {
@@ -179,12 +200,47 @@ try {
 | `RateLimitError` | 429 | Rate limit exceeded |
 | `TimeoutError` | — | Polling timeout exceeded |
 
-## Environment Detection
+## Environment Detection & Auto-Routing
 
-The SDK auto-detects your environment from the API key prefix:
+The SDK automatically routes requests to the correct API endpoint based on your API key prefix:
 
-- `pk_test_*` → Sandbox (Hedera Testnet, chain 296)
-- `pk_live_*` → Production (Hedera Mainnet, chain 295)
+- `pk_test_*` → Sandbox API (`https://api-sandbox-<hash>.run.app`) + Hedera Testnet (chain 296)
+- `pk_live_*` → Production API (`https://api.pacspace.io`) + Hedera Mainnet (chain 295)
+
+### Examples
+
+**Sandbox (automatic):**
+```typescript
+const pac = new PacSpace({ apiKey: 'pk_test_...' });
+// Automatically uses sandbox API URL
+```
+
+**Production (automatic):**
+```typescript
+const pac = new PacSpace({ apiKey: 'pk_live_...' });
+// Automatically uses production API URL
+```
+
+**Custom URLs:**
+```typescript
+// Override sandbox URL
+const pac = new PacSpace({
+  apiKey: 'pk_test_...',
+  sandboxUrl: 'https://custom-sandbox.example.com',
+});
+
+// Override production URL
+const pac = new PacSpace({
+  apiKey: 'pk_live_...',
+  productionUrl: 'https://custom-production.example.com',
+});
+
+// Override with explicit baseUrl (disables auto-routing)
+const pac = new PacSpace({
+  apiKey: 'pk_test_...',
+  baseUrl: 'https://custom-api.example.com',
+});
+```
 
 ## Requirements
 

package/dist/client.d.ts

@@ -11,11 +11,24 @@ export declare class HttpClient {
     private readonly maxRetries;
     private readonly timeout;
     private readonly fetchFn;
+    private readonly bufferWrites;
+    private readonly bufferMaxItems;
+    private readonly bufferMaxAttempts;
+    private readonly bufferBaseDelayMs;
+    private readonly bufferMaxDelayMs;
+    private readonly bufferedWrites;
+    private drainTimer;
+    private drainInProgress;
+    private closed;
     /** Default chain ID, auto-detected from API key prefix or explicit config. */
     readonly defaultChainId: number | undefined;
     /** Default credit pool ID. */
     readonly defaultCreditPoolId: number | undefined;
     constructor(config: PacSpaceConfig);
+    /**
+     * Close the client and reject any buffered writes.
+     */
+    close(reason?: string): void;
     /**
      * Make a GET request and return unwrapped data.
      */
@@ -46,9 +59,27 @@ export declare class HttpClient {
      */
     private safeParseJson;
     /**
-     * Extract a string error message from a parsed error body.
+     * Extract normalized API error fields from an error payload.
+     */
+    private extractApiError;
+    private asMessage;
+    private asRecord;
+    private asString;
+    private asNumber;
+    private shouldBufferRequest;
+    private enqueueBufferedRequest;
+    private removeBufferedRequest;
+    private scheduleBufferDrain;
+    private drainBufferedWrites;
+    private getBufferDelayMs;
+    /**
+     * Auto-detect base URL from API key prefix.
+     * - `pk_test_*` keys → sandbox API URL
+     * - `pk_live_*` keys → production API URL
+     *
+     * Custom URLs from config override the defaults.
      */
-    private extractErrorMessage;
+    private detectBaseUrl;
     /**
      * Auto-detect chain ID from API key prefix.
      */

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAwBrE;;;;;GAKG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IAEvC,8EAA8E;IAC9E,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,8BAA8B;IAC9B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,GAAG,SAAS,CAAC;gBAErC,MAAM,EAAE,cAAc;IA4BlC;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAIhE;;OAEG;IACG,IAAI,CAAC,CAAC,EACV,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,CAAC,CAAC;IAIb;;OAEG;YACW,OAAO;IAwFrB;;OAEG;IACH,OAAO,CAAC,YAAY;IAwBpB;;OAEG;YACW,gBAAgB;IAoC9B;;;OAGG;IACH,OAAO,CAAC,aAAa;IAcrB;;OAEG;YACW,aAAa;IAU3B;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAU3B;;OAEG;IACH,OAAO,CAAC,aAAa;IAUrB;;OAEG;IACH,OAAO,CAAC,KAAK;CAGd"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AA+ErE;;;;;GAKG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAe;IACvC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAU;IACvC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAuC;IACtE,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,MAAM,CAAS;IAEvB,8EAA8E;IAC9E,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,8BAA8B;IAC9B,QAAQ,CAAC,mBAAmB,EAAE,MAAM,GAAG,SAAS,CAAC;gBAErC,MAAM,EAAE,cAAc;IAyClC;;OAEG;IACH,KAAK,CAAC,MAAM,SAAkB,GAAG,IAAI;IAYrC;;OAEG;IACG,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAIhE;;OAEG;IACG,IAAI,CAAC,CAAC,EACV,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,CAAC,CAAC;IAIb;;OAEG;YACW,OAAO;IAiIrB;;OAEG;IACH,OAAO,CAAC,YAAY;IAwBpB;;OAEG;YACW,gBAAgB;IAoC9B;;;OAGG;IACH,OAAO,CAAC,aAAa;IAoBrB;;OAEG;YACW,aAAa;IAU3B;;OAEG;IACH,OAAO,CAAC,eAAe;IAkCvB,OAAO,CAAC,SAAS;IAgBjB,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,QAAQ;IAahB,OAAO,CAAC,mBAAmB;IA6B3B,OAAO,CAAC,sBAAsB;IA4D9B,OAAO,CAAC,qBAAqB;IAO7B,OAAO,CAAC,mBAAmB;YAiBb,mBAAmB;IA0CjC,OAAO,CAAC,gBAAgB;IAYxB;;;;;;OAMG;IACH,OAAO,CAAC,aAAa;IAWrB;;OAEG;IACH,OAAO,CAAC,aAAa;IAUrB;;OAEG;IACH,OAAO,CAAC,KAAK;CAGd"}

package/dist/client.js

@@ -3,9 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.HttpClient = void 0;
 const errors_1 = require("./errors");
 /**
- * Default base URL for the PacSpace API.
+ * Default sandbox API base URL.
  */
-const DEFAULT_BASE_URL = 'https://balance-api.pacspace.io';
+const DEFAULT_SANDBOX_URL = 'https://api-sandbox-wnizuypena-uw.a.run.app';
+/**
+ * Default production API base URL.
+ */
+const DEFAULT_PRODUCTION_URL = 'https://api.pacspace.io';
 /**
  * Default request timeout in milliseconds.
  */
@@ -14,6 +18,26 @@ const DEFAULT_TIMEOUT_MS = 30000;
  * Default maximum number of retries on transient errors.
  */
 const DEFAULT_MAX_RETRIES = 2;
+/**
+ * Enable client-side write buffering by default.
+ */
+const DEFAULT_BUFFER_WRITES = true;
+/**
+ * Maximum in-memory buffered write requests.
+ */
+const DEFAULT_BUFFER_MAX_ITEMS = 1000;
+/**
+ * Maximum retry attempts per buffered request.
+ */
+const DEFAULT_BUFFER_MAX_ATTEMPTS = 100;
+/**
+ * Base delay for buffered request retries.
+ */
+const DEFAULT_BUFFER_BASE_DELAY_MS = 1000;
+/**
+ * Max delay for buffered request retries.
+ */
+const DEFAULT_BUFFER_MAX_DELAY_MS = 60000;
 /**
  * HTTP status codes that are safe to retry.
  */
@@ -26,14 +50,30 @@ const RETRYABLE_STATUS_CODES = new Set([408, 429, 500, 502, 503, 504]);
  */
 class HttpClient {
     constructor(config) {
+        this.bufferedWrites = [];
+        this.drainTimer = null;
+        this.drainInProgress = false;
+        this.closed = false;
         if (!config.apiKey) {
             throw new errors_1.PacSpaceError('API key is required. Pass it via new PacSpace({ apiKey: "pk_..." })', 0, 'MISSING_API_KEY');
         }
         this.apiKey = config.apiKey;
-        this.baseUrl = (config.baseUrl || DEFAULT_BASE_URL).replace(/\/+$/, '');
+        // Determine base URL: explicit baseUrl overrides everything, otherwise auto-route by API key prefix
+        if (config.baseUrl) {
+            this.baseUrl = config.baseUrl.replace(/\/+$/, '');
+        }
+        else {
+            this.baseUrl = this.detectBaseUrl(config.apiKey, config).replace(/\/+$/, '');
+        }
         this.maxRetries = config.maxRetries ?? DEFAULT_MAX_RETRIES;
         this.timeout = config.timeout ?? DEFAULT_TIMEOUT_MS;
         this.fetchFn = config.fetch || globalThis.fetch;
+        this.bufferWrites = config.bufferWrites ?? DEFAULT_BUFFER_WRITES;
+        this.bufferMaxItems = config.bufferMaxItems ?? DEFAULT_BUFFER_MAX_ITEMS;
+        this.bufferMaxAttempts = config.bufferMaxAttempts ?? DEFAULT_BUFFER_MAX_ATTEMPTS;
+        this.bufferBaseDelayMs =
+            config.bufferBaseDelayMs ?? DEFAULT_BUFFER_BASE_DELAY_MS;
+        this.bufferMaxDelayMs = config.bufferMaxDelayMs ?? DEFAULT_BUFFER_MAX_DELAY_MS;
         // Auto-detect chain ID from API key prefix
         this.defaultChainId = config.chainId ?? this.detectChainId(config.apiKey);
         this.defaultCreditPoolId = config.creditPoolId;
@@ -41,6 +81,20 @@ class HttpClient {
             throw new errors_1.PacSpaceError('No global fetch found. Upgrade to Node 18+ or pass a custom fetch implementation via config.', 0, 'NO_FETCH');
         }
     }
+    /**
+     * Close the client and reject any buffered writes.
+     */
+    close(reason = 'Client closed') {
+        this.closed = true;
+        if (this.drainTimer) {
+            clearTimeout(this.drainTimer);
+            this.drainTimer = null;
+        }
+        const pending = this.bufferedWrites.splice(0, this.bufferedWrites.length);
+        for (const item of pending) {
+            item.reject(new errors_1.PacSpaceError(reason, 0, 'CLIENT_CLOSED', item.path));
+        }
+    }
     /**
      * Make a GET request and return unwrapped data.
      */
@@ -56,7 +110,10 @@ class HttpClient {
     /**
      * Core request method with retry logic, auth injection, and response unwrapping.
      */
-    async request(method, path, body, options) {
+    async request(method, path, body, options, allowBuffering = true) {
+        if (this.closed) {
+            throw new errors_1.PacSpaceError('Client closed', 0, 'CLIENT_CLOSED', path);
+        }
         const url = `${this.baseUrl}${path}`;
         const headers = this.buildHeaders(options);
         const requestInit = {
@@ -87,7 +144,11 @@ class HttpClient {
                 if (attempt < this.maxRetries) {
                     continue;
                 }
-                throw new errors_1.PacSpaceError(`Network error: ${lastError.message}`, 0, 'NETWORK_ERROR', path);
+                const networkError = new errors_1.PacSpaceError(`Network error: ${lastError.message}`, 0, 'NETWORK_ERROR', path);
+                if (allowBuffering && this.shouldBufferRequest(method, networkError)) {
+                    return this.enqueueBufferedRequest(method, path, body, options, networkError);
+                }
+                throw networkError;
             }
             // Successful response — parse and unwrap
             if (response.ok) {
@@ -96,20 +157,29 @@ class HttpClient {
                     return raw.data;
                 }
                 // success: false in a 2xx response (shouldn't happen, but handle it)
-                throw (0, errors_1.mapApiError)(response.status, raw.error || raw.message || 'Unknown error', path, response.headers);
+                const parsedError = this.extractApiError(raw, 'Unknown error');
+                throw (0, errors_1.mapApiError)(response.status, parsedError.message, path, response.headers, parsedError);
             }
             // Non-retryable error — throw immediately
             if (!RETRYABLE_STATUS_CODES.has(response.status)) {
                 const errorBody = await this.safeParseJson(response);
-                const message = this.extractErrorMessage(errorBody, response.statusText);
-                throw (0, errors_1.mapApiError)(response.status, message, path, response.headers);
+                const parsedError = this.extractApiError(errorBody, response.statusText);
+                throw (0, errors_1.mapApiError)(response.status, parsedError.message, path, response.headers, parsedError);
             }
             // Retryable error — continue to next attempt
             const errorBody = await this.safeParseJson(response);
-            lastError = (0, errors_1.mapApiError)(response.status, this.extractErrorMessage(errorBody, response.statusText), path, response.headers);
+            const parsedError = this.extractApiError(errorBody, response.statusText);
+            lastError = (0, errors_1.mapApiError)(response.status, parsedError.message, path, response.headers, parsedError);
+            if (lastError instanceof errors_1.CadenceLimitError) {
+                throw lastError;
+            }
         }
         // All retries exhausted
-        throw lastError || new errors_1.PacSpaceError('Request failed', 0, 'UNKNOWN', path);
+        const finalError = lastError || new errors_1.PacSpaceError('Request failed', 0, 'UNKNOWN', path);
+        if (allowBuffering && this.shouldBufferRequest(method, finalError)) {
+            return this.enqueueBufferedRequest(method, path, body, options, finalError);
+        }
+        throw finalError;
     }
     /**
      * Build HTTP headers with auth and optional overrides.
@@ -172,6 +242,10 @@ class HttpClient {
         if (lastError instanceof errors_1.RateLimitError && lastError.retryAfter) {
             return lastError.retryAfter * 1000;
         }
+        if (lastError instanceof errors_1.ServiceUnavailableError &&
+            lastError.retryAfter) {
+            return lastError.retryAfter * 1000;
+        }
         // Exponential backoff: 500ms, 1500ms, 3500ms, ...
         const baseDelay = 500;
         const delay = baseDelay * Math.pow(2, attempt - 1);
@@ -191,16 +265,217 @@ class HttpClient {
         }
     }
     /**
-     * Extract a string error message from a parsed error body.
+     * Extract normalized API error fields from an error payload.
      */
-    extractErrorMessage(errorBody, fallback) {
-        if (!errorBody)
-            return fallback;
-        if (typeof errorBody.error === 'string')
-            return errorBody.error;
-        if (typeof errorBody.message === 'string')
-            return errorBody.message;
-        return fallback;
+    extractApiError(errorBody, fallback) {
+        if (!errorBody) {
+            return { message: fallback };
+        }
+        const nestedError = this.asRecord(errorBody.error);
+        if (nestedError) {
+            return {
+                message: this.asMessage(nestedError.message) ??
+                    this.asMessage(errorBody.message) ??
+                    fallback,
+                code: this.asString(nestedError.code) ??
+                    this.asString(errorBody.code),
+                retryAfterSeconds: this.asNumber(nestedError.retryAfterSeconds),
+                customerId: this.asString(nestedError.customerId),
+            };
+        }
+        return {
+            message: this.asMessage(errorBody.message) ??
+                this.asMessage(errorBody.error) ??
+                fallback,
+            code: this.asString(errorBody.code),
+            retryAfterSeconds: this.asNumber(errorBody.retryAfterSeconds),
+            customerId: this.asString(errorBody.customerId),
+        };
+    }
+    asMessage(value) {
+        if (typeof value === 'string') {
+            return value;
+        }
+        if (Array.isArray(value)) {
+            const messages = value
+                .filter((item) => typeof item === 'string')
+                .map((item) => item.trim())
+                .filter((item) => item.length > 0);
+            if (messages.length > 0) {
+                return messages.join('; ');
+            }
+        }
+        return undefined;
+    }
+    asRecord(value) {
+        if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+            return value;
+        }
+        return null;
+    }
+    asString(value) {
+        return typeof value === 'string' ? value : undefined;
+    }
+    asNumber(value) {
+        if (typeof value === 'number' && Number.isFinite(value)) {
+            return value;
+        }
+        if (typeof value === 'string') {
+            const parsed = Number.parseFloat(value);
+            if (Number.isFinite(parsed)) {
+                return parsed;
+            }
+        }
+        return undefined;
+    }
+    shouldBufferRequest(method, error) {
+        if (!this.bufferWrites)
+            return false;
+        const normalizedMethod = method.toUpperCase();
+        if (normalizedMethod === 'GET' ||
+            normalizedMethod === 'HEAD' ||
+            normalizedMethod === 'OPTIONS') {
+            return false;
+        }
+        if (error instanceof errors_1.PacSpaceError) {
+            if (error.code === 'CANCELLED' ||
+                error.code === 'MISSING_API_KEY' ||
+                error.code === 'INVALID_API_KEY' ||
+                error.code === 'VALIDATION_ERROR' ||
+                error.code === 'CADENCE_LIMIT') {
+                return false;
+            }
+            return (RETRYABLE_STATUS_CODES.has(error.statusCode) || error.statusCode === 0);
+        }
+        return true;
+    }
+    enqueueBufferedRequest(method, path, body, options, lastError) {
+        if (this.closed) {
+            throw new errors_1.PacSpaceError('Client closed', 0, 'CLIENT_CLOSED', path);
+        }
+        if (this.bufferedWrites.length >= this.bufferMaxItems) {
+            throw new errors_1.PacSpaceError(`Client write buffer is full (${this.bufferMaxItems} items)`, 0, 'WRITE_BUFFER_FULL', path);
+        }
+        return new Promise((resolve, reject) => {
+            const requestId = `buf_${Date.now()}_${Math.random()
+                .toString(16)
+                .slice(2)}`;
+            const rejectIfAborted = () => {
+                this.removeBufferedRequest(requestId);
+                reject(new errors_1.PacSpaceError('Request cancelled', 0, 'CANCELLED', path));
+            };
+            if (options?.signal?.aborted) {
+                rejectIfAborted();
+                return;
+            }
+            options?.signal?.addEventListener('abort', rejectIfAborted, {
+                once: true,
+            });
+            const delayMs = this.getBufferDelayMs(1, lastError);
+            const buffered = {
+                id: requestId,
+                method,
+                path,
+                body,
+                options,
+                attempts: 1,
+                nextAttemptAt: Date.now() + delayMs,
+                resolve: (value) => {
+                    options?.signal?.removeEventListener('abort', rejectIfAborted);
+                    resolve(value);
+                },
+                reject: (error) => {
+                    options?.signal?.removeEventListener('abort', rejectIfAborted);
+                    reject(error);
+                },
+            };
+            this.bufferedWrites.push(buffered);
+            this.scheduleBufferDrain();
+        });
+    }
+    removeBufferedRequest(requestId) {
+        const index = this.bufferedWrites.findIndex((item) => item.id === requestId);
+        if (index >= 0) {
+            this.bufferedWrites.splice(index, 1);
+        }
+    }
+    scheduleBufferDrain() {
+        if (this.closed)
+            return;
+        if (this.drainTimer || this.drainInProgress || this.bufferedWrites.length === 0) {
+            return;
+        }
+        const nextAttemptAt = this.bufferedWrites.reduce((min, item) => Math.min(min, item.nextAttemptAt), Number.POSITIVE_INFINITY);
+        const delayMs = Math.max(0, nextAttemptAt - Date.now());
+        this.drainTimer = setTimeout(() => {
+            this.drainTimer = null;
+            void this.drainBufferedWrites();
+        }, delayMs);
+        this.drainTimer.unref?.();
+    }
+    async drainBufferedWrites() {
+        if (this.closed)
+            return;
+        if (this.drainInProgress)
+            return;
+        this.drainInProgress = true;
+        try {
+            while (this.bufferedWrites.length > 0) {
+                const current = this.bufferedWrites[0];
+                if (current.nextAttemptAt > Date.now()) {
+                    break;
+                }
+                try {
+                    const result = await this.request(current.method, current.path, current.body, current.options, false);
+                    this.bufferedWrites.shift();
+                    current.resolve(result);
+                }
+                catch (error) {
+                    const err = error instanceof Error ? error : new Error(String(error));
+                    current.attempts += 1;
+                    if (current.attempts > this.bufferMaxAttempts) {
+                        this.bufferedWrites.shift();
+                        current.reject(err);
+                        continue;
+                    }
+                    current.nextAttemptAt =
+                        Date.now() + this.getBufferDelayMs(current.attempts, err);
+                    break;
+                }
+            }
+        }
+        finally {
+            this.drainInProgress = false;
+            this.scheduleBufferDrain();
+        }
+    }
+    getBufferDelayMs(attempt, error) {
+        if (error instanceof errors_1.RateLimitError && error.retryAfter) {
+            return error.retryAfter * 1000;
+        }
+        if (error instanceof errors_1.ServiceUnavailableError && error.retryAfter) {
+            return error.retryAfter * 1000;
+        }
+        const cappedAttempt = Math.min(Math.max(attempt, 1), 12);
+        const delay = this.bufferBaseDelayMs * Math.pow(2, cappedAttempt - 1);
+        return Math.min(delay, this.bufferMaxDelayMs);
+    }
+    /**
+     * Auto-detect base URL from API key prefix.
+     * - `pk_test_*` keys → sandbox API URL
+     * - `pk_live_*` keys → production API URL
+     *
+     * Custom URLs from config override the defaults.
+     */
+    detectBaseUrl(apiKey, config) {
+        if (apiKey.startsWith('pk_test_')) {
+            return config.sandboxUrl || DEFAULT_SANDBOX_URL;
+        }
+        if (apiKey.startsWith('pk_live_')) {
+            return config.productionUrl || DEFAULT_PRODUCTION_URL;
+        }
+        // Fallback to production if prefix doesn't match expected patterns
+        return config.productionUrl || DEFAULT_PRODUCTION_URL;
     }
     /**
      * Auto-detect chain ID from API key prefix.

package/dist/client.js.map

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

package/dist/errors/index.d.ts

@@ -43,6 +43,25 @@ export declare class RateLimitError extends PacSpaceError {
     readonly retryAfter: number | null;
     constructor(message?: string, retryAfter?: number | null, requestPath?: string);
 }
+/**
+ * Thrown when a customer's submission cadence window has not elapsed (HTTP 429).
+ * This error is terminal for the current request and should not be auto-retried.
+ */
+export declare class CadenceLimitError extends PacSpaceError {
+    /** Milliseconds remaining before the next allowed submission, if provided. */
+    readonly retryAfterMs: number | null;
+    /** Customer ID associated with the cadence block, when provided. */
+    readonly customerId: string | null;
+    constructor(message?: string, retryAfterSeconds?: number | null, customerId?: string | null, requestPath?: string);
+}
+/**
+ * Thrown when the API is temporarily unavailable (HTTP 503).
+ */
+export declare class ServiceUnavailableError extends PacSpaceError {
+    /** Seconds to wait before retrying, if provided by the API. */
+    readonly retryAfter: number | null;
+    constructor(message?: string, retryAfter?: number | null, requestPath?: string);
+}
 /**
  * Thrown when the API returns a validation error (HTTP 400).
  */
@@ -65,5 +84,9 @@ export declare class WebhookVerificationError extends PacSpaceError {
  * Map an HTTP status code + API response to the appropriate typed error.
  * @internal
  */
-export declare function mapApiError(statusCode: number, message: string, requestPath?: string, headers?: Headers): PacSpaceError;
+export declare function mapApiError(statusCode: number, message: string, requestPath?: string, headers?: Headers, apiError?: {
+    code?: string;
+    retryAfterSeconds?: number | null;
+    customerId?: string | null;
+}): PacSpaceError;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,8CAA8C;IAC9C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;gBAG5B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,MAAM;CAWvB;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,aAAa;gBACvC,OAAO,SAA+B,EAAE,WAAW,CAAC,EAAE,MAAM;CAIzE;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,aAAa;gBAEvD,OAAO,SAA4C,EACnD,WAAW,CAAC,EAAE,MAAM;CAKvB;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,aAAa;gBAClC,OAAO,SAAuB,EAAE,WAAW,CAAC,EAAE,MAAM;CAIjE;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,aAAa;gBAEvD,OAAO,SAA0D,EACjE,WAAW,CAAC,EAAE,MAAM;CAKvB;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,aAAa;IAC/C,+DAA+D;IAC/D,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;gBAGjC,OAAO,SAAwB,EAC/B,UAAU,GAAE,MAAM,GAAG,IAAW,EAChC,WAAW,CAAC,EAAE,MAAM;CAMvB;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,aAAa;gBACpC,OAAO,SAAyB,EAAE,WAAW,CAAC,EAAE,MAAM;CAInE;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,aAAa;gBAE3C,OAAO,SAAiD,EACxD,WAAW,CAAC,EAAE,MAAM;CAKvB;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,aAAa;gBAC7C,OAAO,SAA0C;CAI9D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,OAAO,GAChB,aAAa,CAuBf"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,8CAA8C;IAC9C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,kEAAkE;IAClE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;gBAG5B,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,MAAM;CAWvB;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,aAAa;gBACvC,OAAO,SAA+B,EAAE,WAAW,CAAC,EAAE,MAAM;CAIzE;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,aAAa;gBAEvD,OAAO,SAA4C,EACnD,WAAW,CAAC,EAAE,MAAM;CAKvB;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,aAAa;gBAClC,OAAO,SAAuB,EAAE,WAAW,CAAC,EAAE,MAAM;CAIjE;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,aAAa;gBAEvD,OAAO,SAA0D,EACjE,WAAW,CAAC,EAAE,MAAM;CAKvB;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,aAAa;IAC/C,+DAA+D;IAC/D,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;gBAGjC,OAAO,SAAwB,EAC/B,UAAU,GAAE,MAAM,GAAG,IAAW,EAChC,WAAW,CAAC,EAAE,MAAM;CAMvB;AAED;;;GAGG;AACH,qBAAa,iBAAkB,SAAQ,aAAa;IAClD,8EAA8E;IAC9E,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,oEAAoE;IACpE,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;gBAGjC,OAAO,SAAqC,EAC5C,iBAAiB,GAAE,MAAM,GAAG,IAAW,EACvC,UAAU,GAAE,MAAM,GAAG,IAAW,EAChC,WAAW,CAAC,EAAE,MAAM;CAUvB;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,aAAa;IACxD,+DAA+D;IAC/D,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;gBAGjC,OAAO,SAAoC,EAC3C,UAAU,GAAE,MAAM,GAAG,IAAW,EAChC,WAAW,CAAC,EAAE,MAAM;CAMvB;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,aAAa;gBACpC,OAAO,SAAyB,EAAE,WAAW,CAAC,EAAE,MAAM;CAInE;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,aAAa;gBAE3C,OAAO,SAAiD,EACxD,WAAW,CAAC,EAAE,MAAM;CAKvB;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,aAAa;gBAC7C,OAAO,SAA0C;CAI9D;AAED;;;GAGG;AACH,wBAAgB,WAAW,CACzB,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,OAAO,EACjB,QAAQ,CAAC,EAAE;IACT,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,GACA,aAAa,CA+Cf"}