@isnap/sdk 0.1.0 → 1.1.0-next.49

package/dist/client.js

@@ -1,115 +1,284 @@
-import { iSnapError, RateLimitError } from './types.js';
-import { MessagesResource } from './resources/messages.js';
+import { resolveConfig, validateMaxRetries } from './config.js';
+import { APIConnectionError, APIError, ServiceUnavailableError, fromEnvelope } from './errors.js';
+import { generateIdempotencyKey } from './idempotency.js';
+import { AttachmentsResource } from './resources/attachments.js';
+import { ByodResource } from './resources/byod.js';
+import { ChatsResource } from './resources/chats.js';
 import { LinesResource } from './resources/lines.js';
+import { LookupResource } from './resources/lookup.js';
+import { MessagesResource } from './resources/messages.js';
+import { TrialResource } from './resources/trial.js';
 import { WebhooksResource } from './resources/webhooks.js';
+import { withRetries } from './retry.js';
+import { SDK_VERSION } from './version.js';
+const MUTATING = new Set(['POST', 'PATCH', 'PUT', 'DELETE']);
+const NON_JSON_PREVIEW = 200;
+// Hard cap on response body size. Server-side limits are stricter in
+// practice; this is defense-in-depth against a misbehaving proxy or test
+// harness streaming an unbounded body.
+const MAX_RESPONSE_BYTES = 10 * 1024 * 1024;
+const USER_AGENT = `@isnap/sdk/${SDK_VERSION}`;
+// Per-process dedup set for deprecation warnings. Key is
+// `<METHOD> <pathname>|<sunset>` — including the sunset means we re-warn
+// if the backend extends or moves the deadline. Process-wide (not
+// per-client-instance) so spawning multiple ISnapClient objects in tests
+// doesn't multiply the noise.
+const WARNED_DEPRECATIONS = new Set();
 /**
- * The iSnap SDK client. Provides access to all API resources.
+ * Test-only escape hatch to clear the per-process dedup set between test
+ * cases. Not part of the public stability contract — flagged @internal so
+ * IDE auto-import doesn't surface it to consumers.
  *
- * @example
- * ```ts
- * import { init } from '@isnap/sdk';
- *
- * const client = init({ apiKey: 'isnap_your_key' });
- * const msg = await client.messages.send({ line_id: 'ln-1', to: '+15551234567', body: 'Hello' });
- * ```
+ * @internal
  */
-export class iSnapClient {
-    apiKey;
-    baseUrl;
-    maxRetries;
-    retryDelayMs;
-    /** Message sending, retrieval, and conversation management. */
-    messages;
-    /** Phone line listing and lookup. */
+export function _resetDeprecationWarnings() {
+    WARNED_DEPRECATIONS.clear();
+}
+export class ISnapClient {
+    config;
+    attachments;
+    byod;
+    chats;
     lines;
-    /** Webhook endpoint management. */
+    lookup;
+    messages;
+    trial;
     webhooks;
     constructor(config) {
-        this.apiKey = config.apiKey;
-        this.baseUrl = (config.baseUrl ?? 'https://api.isnap.dev').replace(/\/$/, '');
-        this.maxRetries = config.maxRetries ?? 3;
-        this.retryDelayMs = config.retryDelayMs ?? 5000;
-        this.messages = new MessagesResource(this);
+        this.config = resolveConfig(config);
+        this.attachments = new AttachmentsResource(this);
+        this.byod = new ByodResource(this);
+        this.chats = new ChatsResource(this);
         this.lines = new LinesResource(this);
+        this.lookup = new LookupResource(this);
+        this.messages = new MessagesResource(this);
+        this.trial = new TrialResource(this);
         this.webhooks = new WebhooksResource(this);
     }
     /**
-     * Send an HTTP request to the iSnap API.
+     * Direct fetch with no SDK auth, no envelope parsing, no retry — used
+     * internally by resource methods that must call URLs OUTSIDE the iSnap
+     * API surface (e.g. presigned R2 PUTs during `attachments.upload`).
+     *
+     * The leading underscore signals "internal but unavoidably public": it
+     * lives on the public class because resource classes cannot reach the
+     * private `config.fetch` otherwise. SDK consumers should use the typed
+     * resource methods or `request()` for everything in `/v1/*` — calling
+     * this directly bypasses the SDK contract.
      *
-     * Handles authorization, JSON serialization, rate-limit retries, and error mapping.
+     * Applies the same `config.timeoutMs` ceiling as `request()` so a
+     * stalled R2 PUT cannot hang the upload indefinitely.
      *
-     * @param method - HTTP method (GET, POST, DELETE, etc.)
-     * @param path - API path (e.g. `/v1/messages`)
-     * @param body - Optional request body (will be JSON-stringified)
-     * @param query - Optional query parameters
-     * @returns Parsed JSON response
-     * @throws {iSnapError} On non-2xx responses
-     * @throws {RateLimitError} When rate-limited after exhausting retries
+     * @internal
+     */
+    async _externalFetch(url, init = {}) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.config.timeoutMs);
+        const callerSignal = init.signal;
+        let abortListener;
+        if (callerSignal) {
+            if (callerSignal.aborted)
+                controller.abort(callerSignal.reason);
+            else {
+                abortListener = () => controller.abort(callerSignal.reason);
+                callerSignal.addEventListener('abort', abortListener, { once: true });
+            }
+        }
+        try {
+            return await this.config.fetch(url, { ...init, signal: controller.signal });
+        }
+        finally {
+            clearTimeout(timeoutId);
+            if (abortListener)
+                callerSignal?.removeEventListener('abort', abortListener);
+        }
+    }
+    /**
+     * Low-level request method. Resource classes wrap this with typed
+     * camelCase signatures; advanced users can call it directly for
+     * endpoints not yet covered by a resource.
      */
-    async request(method, path, body, query) {
-        let url = `${this.baseUrl}${path}`;
+    async request(method, path, body, opts = {}) {
+        const url = this.buildUrl(path, opts.query);
+        const idempotencyKey = opts.idempotencyKey ??
+            (this.config.idempotencyKey === 'auto' && MUTATING.has(method)
+                ? generateIdempotencyKey()
+                : undefined);
+        const headers = this.buildHeaders(idempotencyKey, body !== undefined, opts.headers);
+        const init = {
+            method,
+            headers,
+            body: body !== undefined ? JSON.stringify(body) : undefined
+        };
+        const maxRetries = opts.maxRetries !== undefined ? validateMaxRetries(opts.maxRetries) : this.config.maxRetries;
+        return withRetries(() => this.dispatch(url, init, opts), {
+            maxRetries,
+            onRetry: this.config.onRetry,
+            signal: opts.signal
+        });
+    }
+    async dispatch(url, init, opts) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.config.timeoutMs);
+        // Track the abort listener so we can detach it in `finally`. Without
+        // detachment, a long-lived caller signal (e.g. a Node process-wide
+        // shutdown signal) accumulates one closure per request — leaking the
+        // per-attempt AbortController, the caller's `opts`, and any captured
+        // closure state until the signal eventually fires. Detaching at the
+        // end of the dispatch resolves the leak immediately.
+        const callerSignal = opts.signal;
+        let abortListener;
+        if (callerSignal) {
+            if (callerSignal.aborted)
+                controller.abort(callerSignal.reason);
+            else {
+                abortListener = () => controller.abort(callerSignal.reason);
+                callerSignal.addEventListener('abort', abortListener, { once: true });
+            }
+        }
+        let response;
+        try {
+            response = await this.config.fetch(url, { ...init, signal: controller.signal });
+        }
+        catch (err) {
+            throw new APIConnectionError(this.connectionErrorMessage(err), { cause: err });
+        }
+        finally {
+            clearTimeout(timeoutId);
+            if (abortListener)
+                callerSignal?.removeEventListener('abort', abortListener);
+        }
+        // Surface RFC 9745 / RFC 8594 deprecation signals once per (route ×
+        // sunset) per process. Runs before status-based branches so a 410 Gone
+        // response (which throws below) still emits the warning.
+        this.warnIfDeprecated(url, init.method ?? 'GET', response.headers);
+        if (response.status === 204) {
+            return undefined;
+        }
+        const headerTrace = response.headers.get('x-trace-id') ?? '';
+        const headerRequest = response.headers.get('x-request-id') ?? '';
+        const declaredLength = response.headers.get('content-length');
+        if (declaredLength) {
+            const n = Number.parseInt(declaredLength, 10);
+            if (Number.isFinite(n) && n > MAX_RESPONSE_BYTES) {
+                throw new APIError({
+                    status: response.status,
+                    code: 'response_too_large',
+                    message: `Response body exceeds ${MAX_RESPONSE_BYTES} bytes (Content-Length: ${n})`,
+                    traceId: headerTrace,
+                    requestId: headerRequest
+                });
+            }
+        }
+        const text = await response.text();
+        const payload = (() => {
+            if (!text)
+                return null;
+            try {
+                return JSON.parse(text);
+            }
+            catch {
+                return null;
+            }
+        })();
+        if (!payload) {
+            const message = `Server returned non-JSON response (HTTP ${response.status})${text ? `: ${text.slice(0, NON_JSON_PREVIEW)}` : ''}`;
+            // 5xx without an envelope is still transient infra (Cloudflare HTML, LB
+            // 502 page) — surface as ServiceUnavailableError so the retry loop
+            // kicks in. 4xx without an envelope is a misbehaving proxy; surface
+            // immediately as base APIError so the caller sees the raw response.
+            if (response.status >= 500) {
+                throw new ServiceUnavailableError({
+                    status: response.status,
+                    code: 'invalid_response',
+                    message,
+                    traceId: headerTrace,
+                    requestId: headerRequest
+                });
+            }
+            throw new APIError({
+                status: response.status,
+                code: 'invalid_response',
+                message,
+                traceId: headerTrace,
+                requestId: headerRequest
+            });
+        }
+        const traceId = payload.trace_id ?? headerTrace;
+        const requestId = payload.request_id ?? headerRequest;
+        if (!response.ok || payload.success === false || payload.error) {
+            const envelope = payload.error ?? {
+                status: response.status,
+                code: 'unknown_error',
+                message: `HTTP ${response.status} (no error envelope)`
+            };
+            throw fromEnvelope(envelope, traceId, requestId);
+        }
+        return payload.data;
+    }
+    buildUrl(path, query) {
+        const fullPath = path.startsWith('/') ? path : `/${path}`;
+        let url = this.config.baseUrl + fullPath;
         if (query) {
             const params = new URLSearchParams();
             for (const [key, value] of Object.entries(query)) {
-                if (value !== undefined && value !== '')
-                    params.set(key, value);
+                if (value === undefined || value === null)
+                    continue;
+                params.append(key, String(value));
             }
             const qs = params.toString();
             if (qs)
-                url += `?${qs}`;
+                url += (url.includes('?') ? '&' : '?') + qs;
         }
-        const headers = {
-            Authorization: this.apiKey,
-        };
-        if (body !== undefined) {
-            headers['Content-Type'] = 'application/json';
-        }
-        for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
-            const res = await fetch(url, {
-                method,
-                headers,
-                body: body ? JSON.stringify(body) : undefined,
-            });
-            if (res.status === 429) {
-                const retryAfterHeader = res.headers.get('Retry-After');
-                const retryAfter = retryAfterHeader !== null
-                    ? parseInt(retryAfterHeader, 10)
-                    : this.retryDelayMs / 1000;
-                if (attempt < this.maxRetries) {
-                    await new Promise((resolve) => setTimeout(resolve, retryAfter * 1000));
-                    continue;
-                }
-                throw new RateLimitError(`Rate limit exceeded`, retryAfter);
-            }
-            if (!res.ok) {
-                const err = await res.json().catch(() => ({ message: `HTTP ${res.status}` }));
-                throw new iSnapError(err.message || `HTTP ${res.status}`, res.status, err.code);
-            }
-            if (res.status === 204)
-                return undefined;
-            return res.json();
+        return url;
+    }
+    buildHeaders(idempotencyKey, hasBody, custom) {
+        const headers = new Headers();
+        // Defaults set first so caller-supplied headers can override them.
+        headers.set('User-Agent', USER_AGENT);
+        headers.set('Accept', 'application/json');
+        if (hasBody)
+            headers.set('Content-Type', 'application/json');
+        if (custom) {
+            const merged = new Headers(custom);
+            merged.forEach((value, key) => headers.set(key, value));
         }
-        throw new iSnapError('Max retries exceeded', 429);
+        // Locked headers — set last so caller-supplied custom values cannot
+        // override the SDK-managed authentication or idempotency contract.
+        headers.set('Authorization', `Bearer ${this.config.apiKey}`);
+        if (idempotencyKey)
+            headers.set('Idempotency-Key', idempotencyKey);
+        return headers;
+    }
+    warnIfDeprecated(url, method, headers) {
+        const deprecation = headers.get('Deprecation');
+        if (!deprecation || deprecation === 'false')
+            return;
+        const sunset = headers.get('Sunset');
+        let pathname;
+        try {
+            pathname = new URL(url).pathname;
+        }
+        catch {
+            pathname = url;
+        }
+        const key = `${method.toUpperCase()} ${pathname}|${sunset ?? ''}`;
+        if (WARNED_DEPRECATIONS.has(key))
+            return;
+        WARNED_DEPRECATIONS.add(key);
+        const link = headers.get('Link');
+        const successor = link?.match(/<([^>]+)>;\s*rel="successor-version"/)?.[1];
+        const sunsetClause = sunset ? ` and will be removed on ${sunset}` : '';
+        const successorClause = successor ? ` Use ${successor} instead.` : '';
+        console.warn(`[@isnap/sdk] WARNING: ${method.toUpperCase()} ${pathname} is deprecated${sunsetClause}.${successorClause} (RFC 9745)`);
+    }
+    connectionErrorMessage(err) {
+        if (err instanceof DOMException && err.name === 'AbortError') {
+            return `Request aborted after ${this.config.timeoutMs}ms`;
+        }
+        if (err instanceof Error)
+            return `Network error: ${err.message}`;
+        return 'Network error';
     }
-}
-/**
- * Create a new iSnap SDK client.
- *
- * @param config - API key and optional settings
- * @returns A configured {@link iSnapClient} instance
- *
- * @example
- * ```ts
- * import { init } from '@isnap/sdk';
- *
- * const client = init({
- *   apiKey: 'isnap_your_key',
- *   maxRetries: 5,
- *   retryDelayMs: 2000,
- * });
- * ```
- */
-export function init(config) {
-    return new iSnapClient(config);
 }
 //# sourceMappingURL=client.js.map

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":"AAAA,OAAO,EACL,aAAa,EACb,kBAAkB,EAGnB,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,kBAAkB,EAClB,QAAQ,EACR,uBAAuB,EACvB,YAAY,EACb,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAChE,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAExC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAE1C,MAAM,QAAQ,GAA4B,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAA;AAErF,MAAM,gBAAgB,GAAG,GAAG,CAAA;AAE5B,qEAAqE;AACrE,yEAAyE;AACzE,uCAAuC;AACvC,MAAM,kBAAkB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAA;AAE3C,MAAM,UAAU,GAAG,cAAc,WAAW,EAAE,CAAA;AAE9C,yDAAyD;AACzD,yEAAyE;AACzE,kEAAkE;AAClE,yEAAyE;AACzE,8BAA8B;AAC9B,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAAU,CAAA;AAE7C;;;;;;GAMG;AACH,MAAM,UAAU,yBAAyB;IACvC,mBAAmB,CAAC,KAAK,EAAE,CAAA;AAC7B,CAAC;AAED,MAAM,OAAO,WAAW;IACL,MAAM,CAAgB;IAE9B,WAAW,CAAqB;IAChC,IAAI,CAAc;IAClB,KAAK,CAAe;IACpB,KAAK,CAAe;IACpB,MAAM,CAAgB;IACtB,QAAQ,CAAkB;IAC1B,KAAK,CAAe;IACpB,QAAQ,CAAkB;IAEnC,YAAY,MAAoB;QAC9B,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAA;QACnC,IAAI,CAAC,WAAW,GAAG,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAA;QAChD,IAAI,CAAC,IAAI,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,CAAA;QAClC,IAAI,CAAC,KAAK,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,CAAA;QACpC,IAAI,CAAC,KAAK,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,CAAA;QACpC,IAAI,CAAC,MAAM,GAAG,IAAI,cAAc,CAAC,IAAI,CAAC,CAAA;QACtC,IAAI,CAAC,QAAQ,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAA;QAC1C,IAAI,CAAC,KAAK,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,CAAA;QACpC,IAAI,CAAC,QAAQ,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAA;IAC5C,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,KAAK,CAAC,cAAc,CAAC,GAAW,EAAE,OAAoB,EAAE;QACtD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;QACxC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;QAC7E,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAA;QAChC,IAAI,aAAuC,CAAA;QAC3C,IAAI,YAAY,EAAE,CAAC;YACjB,IAAI,YAAY,CAAC,OAAO;gBAAE,UAAU,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAA;iBAC1D,CAAC;gBACJ,aAAa,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAA;gBAC3D,YAAY,CAAC,gBAAgB,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;YACvE,CAAC;QACH,CAAC;QACD,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAA;QAC7E,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,SAAS,CAAC,CAAA;YACvB,IAAI,aAAa;gBAAE,YAAY,EAAE,mBAAmB,CAAC,OAAO,EAAE,aAAa,CAAC,CAAA;QAC9E,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAO,CACX,MAAkB,EAClB,IAAY,EACZ,IAAc,EACd,OAAuB,EAAE;QAEzB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAA;QAC3C,MAAM,cAAc,GAClB,IAAI,CAAC,cAAc;YACnB,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,KAAK,MAAM,IAAI,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC;gBAC5D,CAAC,CAAC,sBAAsB,EAAE;gBAC1B,CAAC,CAAC,SAAS,CAAC,CAAA;QAChB,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,cAAc,EAAE,IAAI,KAAK,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;QACnF,MAAM,IAAI,GAAgB;YACxB,MAAM;YACN,OAAO;YACP,IAAI,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;SAC5D,CAAA;QAED,MAAM,UAAU,GACd,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,kBAAkB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAA;QAE9F,OAAO,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAI,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE;YAC1D,UAAU;YACV,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;YAC5B,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC,CAAA;IACJ,CAAC;IAEO,KAAK,CAAC,QAAQ,CACpB,GAAW,EACX,IAAiB,EACjB,IAAoB;QAEpB,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;QACxC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAA;QAC7E,qEAAqE;QACrE,mEAAmE;QACnE,qEAAqE;QACrE,qEAAqE;QACrE,oEAAoE;QACpE,qDAAqD;QACrD,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAAA;QAChC,IAAI,aAAuC,CAAA;QAC3C,IAAI,YAAY,EAAE,CAAC;YACjB,IAAI,YAAY,CAAC,OAAO;gBAAE,UAAU,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAA;iBAC1D,CAAC;gBACJ,aAAa,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAA;gBAC3D,YAAY,CAAC,gBAAgB,CAAC,OAAO,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;YACvE,CAAC;QACH,CAAC;QAED,IAAI,QAAkB,CAAA;QACtB,IAAI,CAAC;YACH,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAA;QACjF,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,kBAAkB,CAAC,IAAI,CAAC,sBAAsB,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAA;QAChF,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,SAAS,CAAC,CAAA;YACvB,IAAI,aAAa;gBAAE,YAAY,EAAE,mBAAmB,CAAC,OAAO,EAAE,aAAa,CAAC,CAAA;QAC9E,CAAC;QAED,oEAAoE;QACpE,uEAAuE;QACvE,yDAAyD;QACzD,IAAI,CAAC,gBAAgB,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,IAAI,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAA;QAElE,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YAC5B,OAAO,SAAc,CAAA;QACvB,CAAC;QAED,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,CAAA;QAC5D,MAAM,aAAa,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,CAAA;QAEhE,MAAM,cAAc,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAA;QAC7D,IAAI,cAAc,EAAE,CAAC;YACnB,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,cAAc,EAAE,EAAE,CAAC,CAAA;YAC7C,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,kBAAkB,EAAE,CAAC;gBACjD,MAAM,IAAI,QAAQ,CAAC;oBACjB,MAAM,EAAE,QAAQ,CAAC,MAAM;oBACvB,IAAI,EAAE,oBAAoB;oBAC1B,OAAO,EAAE,yBAAyB,kBAAkB,2BAA2B,CAAC,GAAG;oBACnF,OAAO,EAAE,WAAW;oBACpB,SAAS,EAAE,aAAa;iBACzB,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;QAClC,MAAM,OAAO,GAA+B,CAAC,GAAG,EAAE;YAChD,IAAI,CAAC,IAAI;gBAAE,OAAO,IAAI,CAAA;YACtB,IAAI,CAAC;gBACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAwB,CAAA;YAChD,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,IAAI,CAAA;YACb,CAAC;QACH,CAAC,CAAC,EAAE,CAAA;QAEJ,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,2CAA2C,QAAQ,CAAC,MAAM,IACxE,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,CAAC,EAAE,CAAC,CAAC,CAAC,EAClD,EAAE,CAAA;YACF,wEAAwE;YACxE,mEAAmE;YACnE,oEAAoE;YACpE,oEAAoE;YACpE,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;gBAC3B,MAAM,IAAI,uBAAuB,CAAC;oBAChC,MAAM,EAAE,QAAQ,CAAC,MAAM;oBACvB,IAAI,EAAE,kBAAkB;oBACxB,OAAO;oBACP,OAAO,EAAE,WAAW;oBACpB,SAAS,EAAE,aAAa;iBACzB,CAAC,CAAA;YACJ,CAAC;YACD,MAAM,IAAI,QAAQ,CAAC;gBACjB,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,IAAI,EAAE,kBAAkB;gBACxB,OAAO;gBACP,OAAO,EAAE,WAAW;gBACpB,SAAS,EAAE,aAAa;aACzB,CAAC,CAAA;QACJ,CAAC;QAED,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,IAAI,WAAW,CAAA;QAC/C,MAAM,SAAS,GAAG,OAAO,CAAC,UAAU,IAAI,aAAa,CAAA;QAErD,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,OAAO,CAAC,OAAO,KAAK,KAAK,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAC/D,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,IAAI;gBAChC,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,IAAI,EAAE,eAAe;gBACrB,OAAO,EAAE,QAAQ,QAAQ,CAAC,MAAM,sBAAsB;aACvD,CAAA;YACD,MAAM,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAC,CAAA;QAClD,CAAC;QAED,OAAO,OAAO,CAAC,IAAS,CAAA;IAC1B,CAAC;IAEO,QAAQ,CAAC,IAAY,EAAE,KAA+B;QAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAA;QACzD,IAAI,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,GAAG,QAAQ,CAAA;QACxC,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAA;YACpC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACjD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;oBAAE,SAAQ;gBACnD,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;YACnC,CAAC;YACD,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAA;YAC5B,IAAI,EAAE;gBAAE,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,CAAA;QACrD,CAAC;QACD,OAAO,GAAG,CAAA;IACZ,CAAC;IAEO,YAAY,CAClB,cAAkC,EAClC,OAAgB,EAChB,MAA+B;QAE/B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAA;QAC7B,mEAAmE;QACnE,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,UAAU,CAAC,CAAA;QACrC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAA;QACzC,IAAI,OAAO;YAAE,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAA;QAC5D,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,MAAM,GAAG,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;YAClC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAA;QACzD,CAAC;QACD,oEAAoE;QACpE,mEAAmE;QACnE,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,UAAU,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAA;QAC5D,IAAI,cAAc;YAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,cAAc,CAAC,CAAA;QAClE,OAAO,OAAO,CAAA;IAChB,CAAC;IAEO,gBAAgB,CAAC,GAAW,EAAE,MAAc,EAAE,OAAgB;QACpE,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAA;QAC9C,IAAI,CAAC,WAAW,IAAI,WAAW,KAAK,OAAO;YAAE,OAAM;QACnD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QACpC,IAAI,QAAgB,CAAA;QACpB,IAAI,CAAC;YACH,QAAQ,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAA;QAClC,CAAC;QAAC,MAAM,CAAC;YACP,QAAQ,GAAG,GAAG,CAAA;QAChB,CAAC;QACD,MAAM,GAAG,GAAG,GAAG,MAAM,CAAC,WAAW,EAAE,IAAI,QAAQ,IAAI,MAAM,IAAI,EAAE,EAAE,CAAA;QACjE,IAAI,mBAAmB,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAM;QACxC,mBAAmB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAC5B,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;QAChC,MAAM,SAAS,GAAG,IAAI,EAAE,KAAK,CAAC,sCAAsC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;QAC1E,MAAM,YAAY,GAAG,MAAM,CAAC,CAAC,CAAC,2BAA2B,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;QACtE,MAAM,eAAe,GAAG,SAAS,CAAC,CAAC,CAAC,QAAQ,SAAS,WAAW,CAAC,CAAC,CAAC,EAAE,CAAA;QACrE,OAAO,CAAC,IAAI,CACV,yBAAyB,MAAM,CAAC,WAAW,EAAE,IAAI,QAAQ,iBAAiB,YAAY,IAAI,eAAe,aAAa,CACvH,CAAA;IACH,CAAC;IAEO,sBAAsB,CAAC,GAAY;QACzC,IAAI,GAAG,YAAY,YAAY,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAC7D,OAAO,yBAAyB,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,CAAA;QAC3D,CAAC;QACD,IAAI,GAAG,YAAY,KAAK;YAAE,OAAO,kBAAkB,GAAG,CAAC,OAAO,EAAE,CAAA;QAChE,OAAO,eAAe,CAAA;IACxB,CAAC;CACF"}

package/dist/config.d.ts

@@ -0,0 +1,43 @@
+import type { RetryInfo } from './retry.js';
+export interface ClientConfig {
+    apiKey: string;
+    baseUrl?: string;
+    maxRetries?: number;
+    timeoutMs?: number;
+    idempotencyKey?: 'auto' | 'manual';
+    fetch?: typeof fetch;
+    onRetry?: (info: RetryInfo) => void;
+}
+export interface ResolvedConfig {
+    apiKey: string;
+    baseUrl: string;
+    maxRetries: number;
+    timeoutMs: number;
+    idempotencyKey: 'auto' | 'manual';
+    fetch: typeof fetch;
+    onRetry?: (info: RetryInfo) => void;
+}
+export declare const DEFAULTS: {
+    baseUrl: string;
+    maxRetries: number;
+    timeoutMs: number;
+    idempotencyKey: "auto";
+};
+export declare function resolveConfig(config: ClientConfig): ResolvedConfig;
+/**
+ * Validate `maxRetries` — must be a non-negative integer. NaN, negatives,
+ * or non-integers (e.g. `Infinity`, `2.5`) would silently break the
+ * `for (let attempt = 0; attempt <= config.maxRetries; attempt++)` loop in
+ * `withRetries` and produce confusing failure modes (zero attempts, or
+ * fractional comparisons). Validate at the boundary so the error surfaces
+ * at construction, not on the first request. Exported for reuse from
+ * per-call `RequestOptions.maxRetries` overrides.
+ */
+export declare function validateMaxRetries(value: number | undefined): number;
+/**
+ * Validate `timeoutMs` — must be a finite positive number. NaN, zero,
+ * negative, or `Infinity` would either abort every request immediately or
+ * never time out at all.
+ */
+export declare function validateTimeoutMs(value: number | undefined): number;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAE3C,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,cAAc,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAA;IAClC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAA;IACpB,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAA;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,cAAc,EAAE,MAAM,GAAG,QAAQ,CAAA;IACjC,KAAK,EAAE,OAAO,KAAK,CAAA;IACnB,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAA;CACpC;AAED,eAAO,MAAM,QAAQ;;;;;CAKpB,CAAA;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,cAAc,CAiBlE;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAQpE;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAQnE"}

package/dist/config.js

@@ -0,0 +1,55 @@
+export const DEFAULTS = {
+    baseUrl: 'https://api.isnap.ai',
+    maxRetries: 3,
+    timeoutMs: 30_000,
+    idempotencyKey: 'auto'
+};
+export function resolveConfig(config) {
+    if (!config || typeof config.apiKey !== 'string') {
+        throw new Error('iSnap SDK: apiKey is required');
+    }
+    const apiKey = config.apiKey.trim();
+    if (apiKey.length === 0) {
+        throw new Error('iSnap SDK: apiKey cannot be empty or whitespace');
+    }
+    return {
+        apiKey,
+        baseUrl: (config.baseUrl ?? DEFAULTS.baseUrl).replace(/\/+$/, ''),
+        maxRetries: validateMaxRetries(config.maxRetries),
+        timeoutMs: validateTimeoutMs(config.timeoutMs),
+        idempotencyKey: config.idempotencyKey ?? DEFAULTS.idempotencyKey,
+        fetch: config.fetch ?? fetch,
+        onRetry: config.onRetry
+    };
+}
+/**
+ * Validate `maxRetries` — must be a non-negative integer. NaN, negatives,
+ * or non-integers (e.g. `Infinity`, `2.5`) would silently break the
+ * `for (let attempt = 0; attempt <= config.maxRetries; attempt++)` loop in
+ * `withRetries` and produce confusing failure modes (zero attempts, or
+ * fractional comparisons). Validate at the boundary so the error surfaces
+ * at construction, not on the first request. Exported for reuse from
+ * per-call `RequestOptions.maxRetries` overrides.
+ */
+export function validateMaxRetries(value) {
+    if (value === undefined)
+        return DEFAULTS.maxRetries;
+    if (!Number.isInteger(value) || value < 0) {
+        throw new Error(`iSnap SDK: maxRetries must be a non-negative integer (got ${String(value)})`);
+    }
+    return value;
+}
+/**
+ * Validate `timeoutMs` — must be a finite positive number. NaN, zero,
+ * negative, or `Infinity` would either abort every request immediately or
+ * never time out at all.
+ */
+export function validateTimeoutMs(value) {
+    if (value === undefined)
+        return DEFAULTS.timeoutMs;
+    if (!Number.isFinite(value) || value <= 0) {
+        throw new Error(`iSnap SDK: timeoutMs must be a finite positive number (got ${String(value)})`);
+    }
+    return value;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAsBA,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,OAAO,EAAE,sBAAsB;IAC/B,UAAU,EAAE,CAAC;IACb,SAAS,EAAE,MAAM;IACjB,cAAc,EAAE,MAAe;CAChC,CAAA;AAED,MAAM,UAAU,aAAa,CAAC,MAAoB;IAChD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;QACjD,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAA;IAClD,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAA;IACnC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAA;IACpE,CAAC;IACD,OAAO;QACL,MAAM;QACN,OAAO,EAAE,CAAC,MAAM,CAAC,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;QACjE,UAAU,EAAE,kBAAkB,CAAC,MAAM,CAAC,UAAU,CAAC;QACjD,SAAS,EAAE,iBAAiB,CAAC,MAAM,CAAC,SAAS,CAAC;QAC9C,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,QAAQ,CAAC,cAAc;QAChE,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,KAAK;QAC5B,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAA;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAyB;IAC1D,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC,UAAU,CAAA;IACnD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CACb,6DAA6D,MAAM,CAAC,KAAK,CAAC,GAAG,CAC9E,CAAA;IACH,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAyB;IACzD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC,SAAS,CAAA;IAClD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CACb,8DAA8D,MAAM,CAAC,KAAK,CAAC,GAAG,CAC/E,CAAA;IACH,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,53 @@
+import type { ErrorEnvelope, ErrorIssue } from './types.js';
+export interface APIErrorMeta {
+    status: number;
+    code: string;
+    message: string;
+    traceId: string;
+    requestId: string;
+    retryAfter?: number;
+    issues?: ErrorIssue[];
+}
+export declare class APIError extends Error {
+    readonly status: number;
+    readonly code: string;
+    readonly traceId: string;
+    readonly requestId: string;
+    readonly retryAfter?: number;
+    readonly issues?: ErrorIssue[];
+    constructor(meta: APIErrorMeta);
+}
+export declare class BadRequestError extends APIError {
+}
+export declare class AuthenticationError extends APIError {
+}
+export declare class PaymentRequiredError extends APIError {
+}
+export declare class PermissionDeniedError extends APIError {
+}
+export declare class NotFoundError extends APIError {
+}
+export declare class ConflictError extends APIError {
+}
+export declare class GoneError extends APIError {
+}
+export declare class UnprocessableEntityError extends APIError {
+}
+export declare class RateLimitError extends APIError {
+}
+export declare class QuotaExceededError extends APIError {
+}
+export declare class InternalServerError extends APIError {
+}
+export declare class ServiceUnavailableError extends APIError {
+}
+export declare class APIConnectionError extends Error {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+export declare class WebhookSignatureError extends Error {
+    constructor(message: string);
+}
+export declare function fromEnvelope(envelope: ErrorEnvelope, traceId: string, requestId: string): APIError;
+//# 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":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE3D,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,MAAM,CAAC,EAAE,UAAU,EAAE,CAAA;CACtB;AAED,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,CAAA;gBAElB,IAAI,EAAE,YAAY;CAU/B;AAED,qBAAa,eAAgB,SAAQ,QAAQ;CAAG;AAChD,qBAAa,mBAAoB,SAAQ,QAAQ;CAAG;AACpD,qBAAa,oBAAqB,SAAQ,QAAQ;CAAG;AACrD,qBAAa,qBAAsB,SAAQ,QAAQ;CAAG;AACtD,qBAAa,aAAc,SAAQ,QAAQ;CAAG;AAC9C,qBAAa,aAAc,SAAQ,QAAQ;CAAG;AAC9C,qBAAa,SAAU,SAAQ,QAAQ;CAAG;AAC1C,qBAAa,wBAAyB,SAAQ,QAAQ;CAAG;AACzD,qBAAa,cAAe,SAAQ,QAAQ;CAAG;AAC/C,qBAAa,kBAAmB,SAAQ,QAAQ;CAAG;AACnD,qBAAa,mBAAoB,SAAQ,QAAQ;CAAG;AACpD,qBAAa,uBAAwB,SAAQ,QAAQ;CAAG;AAExD,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAI3D;AAED,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAUD,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,aAAa,EACvB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,QAAQ,CAqCV"}