listbee 0.3.0

package/dist/cjs/types/store.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Store and domain response types.
+ */
+/** Domain verification status. */
+export type DomainStatus = 'pending' | 'verified' | 'stale';
+/** Store object returned by the ListBee API. */
+export interface StoreResponse {
+    /** Object type discriminator. Always "store". */
+    object: 'store';
+    /** Unique store identifier. */
+    id: string;
+    /** URL-safe handle used in platform URLs. */
+    handle: string;
+    /** Store display name. Falls back to @handle if not set. */
+    name: string | null;
+    /** Resolved display name: name if set, otherwise @handle. */
+    display_name: string;
+    /** Short store bio. */
+    bio: string | null;
+    /** Social media URLs. */
+    social_links: string[];
+    /** True when the store has a payment provider configured. */
+    payment_connected: boolean;
+    /** Payment provider name or null if not configured. */
+    payment_provider: string | null;
+    /** Default currency code (ISO 4217, lowercase). Null until payment configured. */
+    currency: string | null;
+    /** Custom domain configured on this store. Null if not set. */
+    domain: string | null;
+    /** Domain verification status. Null if no domain configured. */
+    domain_status: DomainStatus | null;
+    /** Number of listings in this store. */
+    listing_count: number;
+    /** ISO 8601 timestamp of when the store was created. */
+    created_at: string;
+}
+/** Non-paginated list of stores. */
+export interface StoreListResponse {
+    object: 'list';
+    data: StoreResponse[];
+}
+/** Custom domain object returned by the ListBee API. */
+export interface DomainResponse {
+    /** Object type discriminator. Always "domain". */
+    object: 'domain';
+    /** The custom domain. */
+    domain: string;
+    /** Verification status: pending, verified, or stale. */
+    status: DomainStatus;
+    /** The CNAME target the domain must point to. */
+    cname_target: string;
+    /** Timestamp when domain was verified. Null if not yet verified. */
+    verified_at: string | null;
+}
+/** Parameters for creating a store. */
+export interface CreateStoreParams {
+    /** URL-safe handle, unique globally. */
+    handle: string;
+    /** Optional display name. */
+    name?: string;
+}
+/** Parameters for updating a store. */
+export interface UpdateStoreParams {
+    /** Store display name. */
+    name?: string;
+    /** Short store bio. */
+    bio?: string;
+    /** Social media URLs (HTTPS only, max 5). */
+    social_links?: string[];
+}

package/dist/cjs/types/store.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Store and domain response types.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=store.js.map

package/dist/cjs/types/store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.js","sourceRoot":"","sources":["../../../src/types/store.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/cjs/types/stripe.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Stripe resource response types.
+ */
+/** Response from the Stripe Connect session endpoint. */
+export interface StripeConnectSessionResponse {
+    /** Object type discriminator. Always "stripe_connect_session". */
+    object: 'stripe_connect_session';
+    /** Stripe Connect onboarding URL — redirect the user here. */
+    url: string;
+    /** ISO 8601 timestamp when this session expires. */
+    expires_at: string;
+}

package/dist/cjs/types/stripe.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Stripe resource response types.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=stripe.js.map

package/dist/cjs/types/stripe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stripe.js","sourceRoot":"","sources":["../../../src/types/stripe.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/cjs/types/webhook.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Webhook response types.
+ */
+import type { WebhookEventType } from './shared';
+/** Full webhook object returned by the ListBee API. */
+export interface WebhookResponse {
+    /** Object type discriminator. Always "webhook". */
+    object: 'webhook';
+    /** Unique webhook identifier. */
+    id: string;
+    /** Display name. */
+    name: string;
+    /** HTTPS endpoint URL. */
+    url: string;
+    /** HMAC signing secret for verifying payloads. */
+    secret: string;
+    /** Event types to subscribe to. Empty array = all events. */
+    events: WebhookEventType[];
+    /** Whether this webhook is currently active. */
+    enabled: boolean;
+    /** ISO 8601 timestamp of when the webhook was created. */
+    created_at: string;
+}
+/** Parameters for creating a webhook. */
+export interface CreateWebhookParams {
+    /** Display name. */
+    name: string;
+    /** HTTPS endpoint URL. */
+    url: string;
+    /** Event types to subscribe to. Omit or empty = all events. */
+    events?: WebhookEventType[];
+}
+/** Parameters for updating a webhook. All fields optional. */
+export interface UpdateWebhookParams {
+    /** Display name. */
+    name?: string;
+    /** HTTPS endpoint URL. */
+    url?: string;
+    /** Event types to subscribe to. */
+    events?: WebhookEventType[];
+    /** Whether this webhook is active. */
+    enabled?: boolean;
+}
+/** A single webhook delivery event. */
+export interface WebhookEventResponse {
+    /** Object type discriminator. Always "webhook_event". */
+    object: 'webhook_event';
+    /** Unique event identifier. */
+    id: string;
+    /** The event type that triggered this delivery. */
+    event_type: WebhookEventType;
+    /** Delivery status. */
+    status: 'pending' | 'delivered' | 'failed';
+    /** Number of delivery attempts so far. */
+    attempts: number;
+    /** Maximum delivery attempts before marking as failed. */
+    max_retries: number;
+    /** HTTP status code from the last delivery attempt. */
+    response_status: number | null;
+    /** Error message from the last failed delivery attempt. */
+    last_error: string | null;
+    /** ISO 8601 timestamp of when the event was created. */
+    created_at: string;
+    /** ISO 8601 timestamp of successful delivery. */
+    delivered_at: string | null;
+}
+/** Parameters for listing webhook events. */
+export interface ListWebhookEventsParams {
+    /** Filter by delivery status. */
+    status?: 'pending' | 'delivered' | 'failed';
+    /** Maximum items per page (default 20). */
+    limit?: number;
+    /** Pagination cursor from a previous response. */
+    cursor?: string;
+}
+/** Response from the webhook test endpoint. */
+export interface WebhookTestResponse {
+    /** Object type discriminator. Always "webhook_test". */
+    object: 'webhook_test';
+    /** Whether the test delivery succeeded (endpoint returned 2xx). */
+    success: boolean;
+    /** HTTP status code from the endpoint. */
+    status_code: number | null;
+    /** Response body from the endpoint (truncated to 2000 chars). */
+    response_body: string | null;
+    /** Error message if delivery failed. */
+    error: string | null;
+}

package/dist/cjs/types/webhook.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Webhook response types.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=webhook.js.map

package/dist/cjs/types/webhook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook.js","sourceRoot":"","sources":["../../../src/types/webhook.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/dist/esm/base-client.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Base HTTP client for the ListBee SDK.
+ */
+import type { ListResponse } from './types/shared';
+/** Options accepted by the ListBee client constructor. */
+export interface ClientOptions {
+    /** Your ListBee API key (lb_...). Falls back to LISTBEE_API_KEY env var. */
+    apiKey?: string;
+    /** API base URL. Default: https://api.listbee.so */
+    baseUrl?: string;
+    /** Default request timeout in milliseconds. Default: 30000 */
+    timeoutMs?: number;
+    /** Max retries on 429/5xx responses. Default: 3 */
+    maxRetries?: number;
+}
+/** Options for individual HTTP requests. */
+export interface RequestOptions {
+    /** Request timeout in milliseconds. */
+    timeoutMs?: number;
+    /** Whether to include the Authorization header. Default: true. */
+    authenticated?: boolean;
+}
+/** A cursor page holding one page of results. */
+export declare class CursorPage<T> {
+    readonly object: "list";
+    readonly data: T[];
+    readonly has_more: boolean;
+    readonly cursor: string | null;
+    constructor(body: ListResponse<T>);
+}
+/** Internal HTTP response wrapper. */
+interface HttpResponse {
+    status: number;
+    headers: Record<string, string>;
+    json(): Promise<unknown>;
+    text(): Promise<string>;
+}
+/**
+ * Low-level HTTP client with auth, retries, and error handling.
+ */
+export declare class BaseClient {
+    protected readonly _apiKey: string | undefined;
+    protected readonly _baseUrl: string;
+    protected readonly _timeoutMs: number;
+    protected readonly _maxRetries: number;
+    constructor(opts?: ClientOptions);
+    protected _ensureApiKey(): string;
+    protected _buildHeaders(authenticated?: boolean): Record<string, string>;
+    protected _shouldRetry(status: number, attempt: number): boolean;
+    protected _retryDelayMs(attempt: number, headers: Record<string, string>): number;
+    /** Perform an HTTP request with retry logic. */
+    _request(method: string, path: string, opts?: {
+        body?: unknown;
+        params?: Record<string, string | number | boolean>;
+        timeoutMs?: number;
+        authenticated?: boolean;
+    }): Promise<HttpResponse>;
+    get(path: string, params?: Record<string, string | number | boolean>, options?: RequestOptions): Promise<HttpResponse>;
+    post(path: string, body?: unknown, options?: RequestOptions): Promise<HttpResponse>;
+    put(path: string, body?: unknown, options?: RequestOptions): Promise<HttpResponse>;
+    patch(path: string, body?: unknown, options?: RequestOptions): Promise<HttpResponse>;
+    delete(path: string, options?: RequestOptions): Promise<HttpResponse>;
+    getPage<T>(path: string, params: Record<string, string | number | boolean>, parse: (item: unknown) => T, options?: RequestOptions): Promise<CursorPage<T>>;
+}
+export {};

package/dist/esm/base-client.js

@@ -0,0 +1,159 @@
+/**
+ * Base HTTP client for the ListBee SDK.
+ */
+import { DEFAULT_BASE_URL, DEFAULT_MAX_RETRIES, DEFAULT_TIMEOUT_MS, INITIAL_RETRY_DELAY_MS, MAX_RETRY_DELAY_MS, RETRY_STATUS_CODES, } from './constants';
+import { APIConnectionError, APITimeoutError, ListBeeError, raiseForStatus } from './errors';
+const SDK_VERSION = '0.1.0';
+/** A cursor page holding one page of results. */
+export class CursorPage {
+    constructor(body) {
+        this.object = 'list';
+        this.data = body.data;
+        this.has_more = body.has_more;
+        this.cursor = body.cursor;
+    }
+}
+/**
+ * Low-level HTTP client with auth, retries, and error handling.
+ */
+export class BaseClient {
+    constructor(opts = {}) {
+        this._apiKey = opts.apiKey ?? process.env['LISTBEE_API_KEY'];
+        this._baseUrl = (opts.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, '');
+        this._timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        this._maxRetries = opts.maxRetries ?? DEFAULT_MAX_RETRIES;
+    }
+    _ensureApiKey() {
+        if (!this._apiKey) {
+            throw new ListBeeError('No API key provided. Set apiKey= or the LISTBEE_API_KEY environment variable.');
+        }
+        return this._apiKey;
+    }
+    _buildHeaders(authenticated = true) {
+        const headers = {
+            'Content-Type': 'application/json',
+            'User-Agent': `listbee-typescript/${SDK_VERSION}`,
+        };
+        if (authenticated) {
+            const key = this._ensureApiKey();
+            headers['Authorization'] = `Bearer ${key}`;
+        }
+        return headers;
+    }
+    _shouldRetry(status, attempt) {
+        return RETRY_STATUS_CODES.has(status) && attempt < this._maxRetries;
+    }
+    _retryDelayMs(attempt, headers) {
+        const retryAfter = headers['retry-after'];
+        if (retryAfter != null) {
+            const parsed = parseFloat(retryAfter);
+            if (!isNaN(parsed)) {
+                return Math.min(parsed * 1000, MAX_RETRY_DELAY_MS);
+            }
+        }
+        const delay = INITIAL_RETRY_DELAY_MS * Math.pow(2, attempt);
+        const capped = Math.min(delay, MAX_RETRY_DELAY_MS);
+        const jitter = capped * 0.25 * (Math.random() * 2 - 1);
+        return Math.max(0, capped + jitter);
+    }
+    /** Perform an HTTP request with retry logic. */
+    async _request(method, path, opts = {}) {
+        const { body, params, authenticated = true } = opts;
+        const effectiveTimeout = opts.timeoutMs ?? this._timeoutMs;
+        const headers = this._buildHeaders(authenticated);
+        let url = `${this._baseUrl}${path}`;
+        if (params && Object.keys(params).length > 0) {
+            const entries = {};
+            for (const [k, v] of Object.entries(params)) {
+                entries[k] = String(v);
+            }
+            const qs = new URLSearchParams(entries).toString();
+            url = `${url}?${qs}`;
+        }
+        let attempt = 0;
+        while (true) {
+            let response;
+            try {
+                const controller = new AbortController();
+                const timeoutId = setTimeout(() => controller.abort(), effectiveTimeout);
+                let fetchResponse;
+                try {
+                    fetchResponse = await fetch(url, {
+                        method,
+                        headers,
+                        body: body !== undefined ? JSON.stringify(body) : undefined,
+                        signal: controller.signal,
+                    });
+                }
+                finally {
+                    clearTimeout(timeoutId);
+                }
+                // Convert fetch Response to our internal shape
+                const responseHeaders = {};
+                fetchResponse.headers.forEach((value, key) => {
+                    responseHeaders[key.toLowerCase()] = value;
+                });
+                const responseText = await fetchResponse.text();
+                response = {
+                    status: fetchResponse.status,
+                    headers: responseHeaders,
+                    json: async () => JSON.parse(responseText),
+                    text: async () => responseText,
+                };
+            }
+            catch (err) {
+                if (err instanceof Error && err.name === 'AbortError') {
+                    throw new APITimeoutError(`Request timed out after ${effectiveTimeout}ms`);
+                }
+                throw new APIConnectionError(`Connection error: ${String(err)}`);
+            }
+            if (response.status >= 400) {
+                if (this._shouldRetry(response.status, attempt)) {
+                    const delay = this._retryDelayMs(attempt, response.headers);
+                    await new Promise((resolve) => setTimeout(resolve, delay));
+                    attempt++;
+                    continue;
+                }
+                let errorBody = {};
+                try {
+                    errorBody = (await response.json());
+                }
+                catch {
+                    // ignore parse errors
+                }
+                raiseForStatus(response.status, errorBody, response.headers);
+            }
+            return response;
+        }
+        // Exhausted retries — should not be reached in normal flow
+        /* istanbul ignore next */
+        throw new APIConnectionError('Request failed');
+    }
+    async get(path, params, options) {
+        return this._request('GET', path, { params, ...options });
+    }
+    async post(path, body, options) {
+        return this._request('POST', path, { body, ...options });
+    }
+    async put(path, body, options) {
+        return this._request('PUT', path, { body, ...options });
+    }
+    async patch(path, body, options) {
+        return this._request('PATCH', path, { body, ...options });
+    }
+    async delete(path, options) {
+        return this._request('DELETE', path, { ...options });
+    }
+    async getPage(path, params, parse, options) {
+        const response = await this.get(path, params, options);
+        const raw = (await response.json());
+        const data = (raw.data ?? []).map(parse);
+        return new CursorPage({
+            object: 'list',
+            data,
+            has_more: raw.has_more ?? false,
+            cursor: raw.cursor ?? null,
+        });
+    }
+}
+//# sourceMappingURL=base-client.js.map

package/dist/esm/base-client.js.map

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

package/dist/esm/client.d.ts

@@ -0,0 +1,58 @@
+/**
+ * ListBee TypeScript SDK — top-level client.
+ */
+import { BaseClient, type ClientOptions } from './base-client';
+import { AccountResource } from './resources/account';
+import { ListingsResource } from './resources/listings';
+import { ApiKeysResource } from './resources/api-keys';
+import { OrdersResource } from './resources/orders';
+import { SignupResource } from './resources/signup';
+import { StripeResource } from './resources/stripe';
+import { StoresResource } from './resources/stores';
+import { WebhooksResource } from './resources/webhooks';
+export type { ClientOptions };
+/**
+ * ListBee API client.
+ *
+ * @example
+ * ```typescript
+ * import { ListBee } from 'listbee';
+ *
+ * const client = new ListBee({ apiKey: 'lb_...' });
+ *
+ * const listing = await client.listings.create({
+ *   name: 'SEO Playbook',
+ *   price: 2999,
+ *   content: 'https://example.com/ebook.pdf',
+ * });
+ * console.log(listing.url);
+ * ```
+ *
+ * The client reads LISTBEE_API_KEY from the environment if no apiKey is provided.
+ */
+export declare class ListBee extends BaseClient {
+    private _account?;
+    private _listings?;
+    private _apiKeys?;
+    private _orders?;
+    private _signup?;
+    private _stripe?;
+    private _stores?;
+    private _webhooks?;
+    /** Account resource — get and update your account. */
+    get account(): AccountResource;
+    /** Listings resource — create, read, update, delete, pause, resume listings. */
+    get listings(): ListingsResource;
+    /** API Keys resource — list, create, delete API keys. */
+    get apiKeys(): ApiKeysResource;
+    /** Orders resource — get and list orders. */
+    get orders(): OrdersResource;
+    /** Signup resource — create account and verify OTP (unauthenticated). */
+    get signup(): SignupResource;
+    /** Stripe resource — set key, connect, disconnect Stripe. */
+    get stripe(): StripeResource;
+    /** Stores resource — create, read, update, delete stores, connect Stripe, manage domains. */
+    get stores(): StoresResource;
+    /** Webhooks resource — create, list, update, delete, list events, test. */
+    get webhooks(): WebhooksResource;
+}

package/dist/esm/client.js

@@ -0,0 +1,50 @@
+/**
+ * ListBee TypeScript SDK — top-level client.
+ */
+import { BaseClient } from './base-client';
+import { AccountResource } from './resources/account';
+import { ListingsResource } from './resources/listings';
+import { ApiKeysResource } from './resources/api-keys';
+import { OrdersResource } from './resources/orders';
+import { SignupResource } from './resources/signup';
+import { StripeResource } from './resources/stripe';
+import { StoresResource } from './resources/stores';
+import { WebhooksResource } from './resources/webhooks';
+/**
+ * ListBee API client.
+ *
+ * @example
+ * ```typescript
+ * import { ListBee } from 'listbee';
+ *
+ * const client = new ListBee({ apiKey: 'lb_...' });
+ *
+ * const listing = await client.listings.create({
+ *   name: 'SEO Playbook',
+ *   price: 2999,
+ *   content: 'https://example.com/ebook.pdf',
+ * });
+ * console.log(listing.url);
+ * ```
+ *
+ * The client reads LISTBEE_API_KEY from the environment if no apiKey is provided.
+ */
+export class ListBee extends BaseClient {
+    /** Account resource — get and update your account. */
+    get account() { return (this._account ?? (this._account = new AccountResource(this))); }
+    /** Listings resource — create, read, update, delete, pause, resume listings. */
+    get listings() { return (this._listings ?? (this._listings = new ListingsResource(this))); }
+    /** API Keys resource — list, create, delete API keys. */
+    get apiKeys() { return (this._apiKeys ?? (this._apiKeys = new ApiKeysResource(this))); }
+    /** Orders resource — get and list orders. */
+    get orders() { return (this._orders ?? (this._orders = new OrdersResource(this))); }
+    /** Signup resource — create account and verify OTP (unauthenticated). */
+    get signup() { return (this._signup ?? (this._signup = new SignupResource(this))); }
+    /** Stripe resource — set key, connect, disconnect Stripe. */
+    get stripe() { return (this._stripe ?? (this._stripe = new StripeResource(this))); }
+    /** Stores resource — create, read, update, delete stores, connect Stripe, manage domains. */
+    get stores() { return (this._stores ?? (this._stores = new StoresResource(this))); }
+    /** Webhooks resource — create, list, update, delete, list events, test. */
+    get webhooks() { return (this._webhooks ?? (this._webhooks = new WebhooksResource(this))); }
+}
+//# sourceMappingURL=client.js.map

package/dist/esm/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAsB,MAAM,eAAe,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAIxD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,OAAQ,SAAQ,UAAU;IAUrC,sDAAsD;IACtD,IAAI,OAAO,KAAsB,OAAO,CAAC,IAAI,CAAC,QAAQ,KAAb,IAAI,CAAC,QAAQ,GAAK,IAAI,eAAe,CAAC,IAAI,CAAC,EAAC,CAAC,CAAC,CAAC;IACxF,gFAAgF;IAChF,IAAI,QAAQ,KAAuB,OAAO,CAAC,IAAI,CAAC,SAAS,KAAd,IAAI,CAAC,SAAS,GAAK,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAC,CAAC,CAAC,CAAC;IAC5F,yDAAyD;IACzD,IAAI,OAAO,KAAsB,OAAO,CAAC,IAAI,CAAC,QAAQ,KAAb,IAAI,CAAC,QAAQ,GAAK,IAAI,eAAe,CAAC,IAAI,CAAC,EAAC,CAAC,CAAC,CAAC;IACxF,6CAA6C;IAC7C,IAAI,MAAM,KAAqB,OAAO,CAAC,IAAI,CAAC,OAAO,KAAZ,IAAI,CAAC,OAAO,GAAK,IAAI,cAAc,CAAC,IAAI,CAAC,EAAC,CAAC,CAAC,CAAC;IACpF,yEAAyE;IACzE,IAAI,MAAM,KAAqB,OAAO,CAAC,IAAI,CAAC,OAAO,KAAZ,IAAI,CAAC,OAAO,GAAK,IAAI,cAAc,CAAC,IAAI,CAAC,EAAC,CAAC,CAAC,CAAC;IACpF,6DAA6D;IAC7D,IAAI,MAAM,KAAqB,OAAO,CAAC,IAAI,CAAC,OAAO,KAAZ,IAAI,CAAC,OAAO,GAAK,IAAI,cAAc,CAAC,IAAI,CAAC,EAAC,CAAC,CAAC,CAAC;IACpF,6FAA6F;IAC7F,IAAI,MAAM,KAAqB,OAAO,CAAC,IAAI,CAAC,OAAO,KAAZ,IAAI,CAAC,OAAO,GAAK,IAAI,cAAc,CAAC,IAAI,CAAC,EAAC,CAAC,CAAC,CAAC;IACpF,2EAA2E;IAC3E,IAAI,QAAQ,KAAuB,OAAO,CAAC,IAAI,CAAC,SAAS,KAAd,IAAI,CAAC,SAAS,GAAK,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAC,CAAC,CAAC,CAAC;CAC7F"}

package/dist/esm/constants.d.ts

@@ -0,0 +1,17 @@
+/**
+ * SDK-wide constants.
+ */
+/** Default API base URL. */
+export declare const DEFAULT_BASE_URL = "https://api.listbee.so";
+/** Default request timeout in milliseconds. */
+export declare const DEFAULT_TIMEOUT_MS = 30000;
+/** Default maximum retries on 429/5xx responses. */
+export declare const DEFAULT_MAX_RETRIES = 3;
+/** Extended timeout for listing create (cover processing can be slow). */
+export declare const LISTING_CREATE_TIMEOUT_MS = 120000;
+/** Initial retry backoff delay in milliseconds. */
+export declare const INITIAL_RETRY_DELAY_MS = 500;
+/** Maximum retry backoff delay in milliseconds. */
+export declare const MAX_RETRY_DELAY_MS = 30000;
+/** HTTP status codes that should trigger a retry. */
+export declare const RETRY_STATUS_CODES: ReadonlySet<number>;

package/dist/esm/constants.js

@@ -0,0 +1,18 @@
+/**
+ * SDK-wide constants.
+ */
+/** Default API base URL. */
+export const DEFAULT_BASE_URL = 'https://api.listbee.so';
+/** Default request timeout in milliseconds. */
+export const DEFAULT_TIMEOUT_MS = 30000;
+/** Default maximum retries on 429/5xx responses. */
+export const DEFAULT_MAX_RETRIES = 3;
+/** Extended timeout for listing create (cover processing can be slow). */
+export const LISTING_CREATE_TIMEOUT_MS = 120000;
+/** Initial retry backoff delay in milliseconds. */
+export const INITIAL_RETRY_DELAY_MS = 500;
+/** Maximum retry backoff delay in milliseconds. */
+export const MAX_RETRY_DELAY_MS = 30000;
+/** HTTP status codes that should trigger a retry. */
+export const RETRY_STATUS_CODES = new Set([429, 500, 502, 503, 504]);
+//# sourceMappingURL=constants.js.map

package/dist/esm/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,4BAA4B;AAC5B,MAAM,CAAC,MAAM,gBAAgB,GAAG,wBAAwB,CAAC;AAEzD,+CAA+C;AAC/C,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAM,CAAC;AAEzC,oDAAoD;AACpD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AAErC,0EAA0E;AAC1E,MAAM,CAAC,MAAM,yBAAyB,GAAG,MAAO,CAAC;AAEjD,mDAAmD;AACnD,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAE1C,mDAAmD;AACnD,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAM,CAAC;AAEzC,qDAAqD;AACrD,MAAM,CAAC,MAAM,kBAAkB,GAAwB,IAAI,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC"}