listbee 0.4.0 → 0.6.0

package/dist/cjs/resources/webhooks.d.ts

@@ -1,15 +1,71 @@
 /**
- * Webhooks resource — CRUD + events + test for /v1/webhooks.
+ * Webhooks resource — CRUD + events + test + verify for /v1/webhooks.
  */
 import type { BaseClient, CursorPage } from '../base-client';
-import type { WebhookResponse, CreateWebhookParams, UpdateWebhookParams, WebhookEventResponse, ListWebhookEventsParams, WebhookTestResponse } from '../types/webhook';
+import type { WebhookResponse, CreateWebhookParams, UpdateWebhookParams, WebhookEventResponse, ListWebhookEventsParams, WebhookTestResponse } from '../generated/types';
+import type { RequestOptions } from '../types/shared';
 export declare class WebhooksResource {
     private readonly _client;
     constructor(_client: BaseClient);
-    create(params: CreateWebhookParams): Promise<WebhookResponse>;
+    /**
+     * List all webhook endpoints.
+     *
+     * @returns Array of WebhookResponse objects (not paginated).
+     */
     list(): Promise<WebhookResponse[]>;
+    /**
+     * Register a new webhook endpoint.
+     *
+     * @param params - Webhook creation parameters (name, url, events).
+     * @param options - Request options.
+     * @returns The created WebhookResponse with signing secret.
+     */
+    create(params: CreateWebhookParams, options?: RequestOptions): Promise<WebhookResponse>;
+    /**
+     * Update a webhook endpoint.
+     *
+     * @param webhookId - The webhook ID (e.g. "wh_abc123").
+     * @param params - Fields to update.
+     * @returns The updated WebhookResponse.
+     */
     update(webhookId: string, params: UpdateWebhookParams): Promise<WebhookResponse>;
+    /**
+     * Delete a webhook endpoint.
+     *
+     * @param webhookId - The webhook ID (e.g. "wh_abc123").
+     */
     delete(webhookId: string): Promise<void>;
+    /**
+     * List delivery event history for a webhook endpoint.
+     *
+     * @param webhookId - The webhook ID.
+     * @param params - Filter and pagination parameters.
+     * @returns A CursorPage of WebhookEventResponse objects.
+     */
     listEvents(webhookId: string, params?: ListWebhookEventsParams): Promise<CursorPage<WebhookEventResponse>>;
+    /**
+     * Retry a failed webhook event delivery.
+     *
+     * @param webhookId - The webhook ID.
+     * @param eventId - The event ID (e.g. "evt_abc123").
+     * @param options - Request options.
+     * @returns The updated WebhookEventResponse.
+     */
+    retryEvent(webhookId: string, eventId: string, options?: RequestOptions): Promise<WebhookEventResponse>;
+    /**
+     * Send a test event to a webhook endpoint.
+     *
+     * @param webhookId - The webhook ID.
+     * @returns WebhookTestResponse with delivery result.
+     */
     test(webhookId: string): Promise<WebhookTestResponse>;
+    /**
+     * Verify the HMAC-SHA256 signature of an incoming webhook payload.
+     *
+     * @param payload - The raw request body string.
+     * @param signature - The value of the X-ListBee-Signature header.
+     * @param secret - Your webhook signing secret (whsec_...).
+     * @throws WebhookVerificationError if the signature is invalid.
+     */
+    verify(payload: string, signature: string, secret: string): Promise<void>;
 }

package/dist/cjs/resources/webhooks.js

@@ -1,55 +1,136 @@
 "use strict";
 /**
- * Webhooks resource — CRUD + events + test for /v1/webhooks.
+ * Webhooks resource — CRUD + events + test + verify for /v1/webhooks.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WebhooksResource = void 0;
+const errors_1 = require("../errors");
 class WebhooksResource {
     constructor(_client) {
         this._client = _client;
     }
-    async create(params) {
-        const body = { name: params.name, url: params.url };
-        if (params.events !== undefined)
-            body['events'] = params.events;
-        const response = await this._client.post('/v1/webhooks', body);
-        return (await response.json());
-    }
+    /**
+     * List all webhook endpoints.
+     *
+     * @returns Array of WebhookResponse objects (not paginated).
+     */
     async list() {
         var _a;
         const response = await this._client.get('/v1/webhooks');
         const body = (await response.json());
         return ((_a = body.data) !== null && _a !== void 0 ? _a : []);
     }
+    /**
+     * Register a new webhook endpoint.
+     *
+     * @param params - Webhook creation parameters (name, url, events).
+     * @param options - Request options.
+     * @returns The created WebhookResponse with signing secret.
+     */
+    async create(params, options) {
+        const response = await this._client.post('/v1/webhooks', params, options);
+        return (await response.json());
+    }
+    /**
+     * Update a webhook endpoint.
+     *
+     * @param webhookId - The webhook ID (e.g. "wh_abc123").
+     * @param params - Fields to update.
+     * @returns The updated WebhookResponse.
+     */
     async update(webhookId, params) {
-        const body = {};
-        if (params.name !== undefined)
-            body['name'] = params.name;
-        if (params.url !== undefined)
-            body['url'] = params.url;
-        if (params.events !== undefined)
-            body['events'] = params.events;
-        if (params.enabled !== undefined)
-            body['enabled'] = params.enabled;
-        const response = await this._client.put(`/v1/webhooks/${webhookId}`, body);
+        const response = await this._client.put(`/v1/webhooks/${webhookId}`, params);
         return (await response.json());
     }
+    /**
+     * Delete a webhook endpoint.
+     *
+     * @param webhookId - The webhook ID (e.g. "wh_abc123").
+     */
     async delete(webhookId) {
         await this._client.delete(`/v1/webhooks/${webhookId}`);
     }
+    /**
+     * List delivery event history for a webhook endpoint.
+     *
+     * @param webhookId - The webhook ID.
+     * @param params - Filter and pagination parameters.
+     * @returns A CursorPage of WebhookEventResponse objects.
+     */
     async listEvents(webhookId, params = {}) {
         var _a;
         const queryParams = { limit: (_a = params.limit) !== null && _a !== void 0 ? _a : 20 };
-        if (params.status !== undefined)
-            queryParams['status'] = params.status;
-        if (params.cursor !== undefined)
+        if (params.delivered != null)
+            queryParams['delivered'] = params.delivered;
+        if (params.cursor != null)
             queryParams['cursor'] = params.cursor;
         return this._client.getPage(`/v1/webhooks/${webhookId}/events`, queryParams, (item) => item);
     }
+    /**
+     * Retry a failed webhook event delivery.
+     *
+     * @param webhookId - The webhook ID.
+     * @param eventId - The event ID (e.g. "evt_abc123").
+     * @param options - Request options.
+     * @returns The updated WebhookEventResponse.
+     */
+    async retryEvent(webhookId, eventId, options) {
+        const response = await this._client.post(`/v1/webhooks/${webhookId}/events/${eventId}/retry`, undefined, options);
+        return (await response.json());
+    }
+    /**
+     * Send a test event to a webhook endpoint.
+     *
+     * @param webhookId - The webhook ID.
+     * @returns WebhookTestResponse with delivery result.
+     */
     async test(webhookId) {
         const response = await this._client.post(`/v1/webhooks/${webhookId}/test`);
         return (await response.json());
     }
+    /**
+     * Verify the HMAC-SHA256 signature of an incoming webhook payload.
+     *
+     * @param payload - The raw request body string.
+     * @param signature - The value of the X-ListBee-Signature header.
+     * @param secret - Your webhook signing secret (whsec_...).
+     * @throws WebhookVerificationError if the signature is invalid.
+     */
+    async verify(payload, signature, secret) {
+        var _a;
+        const encoder = new TextEncoder();
+        const keyData = encoder.encode(secret);
+        const msgData = encoder.encode(payload);
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const subtle = (_a = globalThis.crypto) === null || _a === void 0 ? void 0 : _a.subtle;
+        if (!subtle) {
+            throw new errors_1.WebhookVerificationError('crypto.subtle is not available in this environment');
+        }
+        const cryptoKey = await subtle.importKey('raw', keyData, { name: 'HMAC', hash: 'SHA-256' }, false, ['sign']);
+        const sigBuffer = await subtle.sign('HMAC', cryptoKey, msgData);
+        const sigHex = Array.from(new Uint8Array(sigBuffer))
+            .map((b) => b.toString(16).padStart(2, '0'))
+            .join('');
+        // Constant-time comparison using HMAC
+        const expectedBytes = encoder.encode(sigHex);
+        const actualBytes = encoder.encode(signature);
+        if (expectedBytes.length !== actualBytes.length) {
+            throw new errors_1.WebhookVerificationError('Invalid webhook signature');
+        }
+        // Compare using HMAC to avoid timing attacks
+        const compareKey = await subtle.importKey('raw', keyData, { name: 'HMAC', hash: 'SHA-256' }, false, ['sign']);
+        const expectedSig = await subtle.sign('HMAC', compareKey, expectedBytes);
+        const actualSig = await subtle.sign('HMAC', compareKey, actualBytes);
+        const expectedArr = new Uint8Array(expectedSig);
+        const actualArr = new Uint8Array(actualSig);
+        let mismatch = 0;
+        for (let i = 0; i < expectedArr.length; i++) {
+            mismatch |= expectedArr[i] ^ actualArr[i];
+        }
+        if (mismatch !== 0) {
+            throw new errors_1.WebhookVerificationError('Invalid webhook signature');
+        }
+    }
 }
 exports.WebhooksResource = WebhooksResource;
 //# sourceMappingURL=webhooks.js.map

package/dist/cjs/resources/webhooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"webhooks.js","sourceRoot":"","sources":["../../../src/resources/webhooks.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAYH,MAAa,gBAAgB;IAC3B,YAA6B,OAAmB;QAAnB,YAAO,GAAP,OAAO,CAAY;IAAG,CAAC;IAEpD,KAAK,CAAC,MAAM,CAAC,MAA2B;QACtC,MAAM,IAAI,GAA4B,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC;QAC7E,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;YAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;QAChE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;QAC/D,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAoB,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,IAAI;;QACR,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QACxD,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAyB,CAAC;QAC7D,OAAO,CAAC,MAAA,IAAI,CAAC,IAAI,mCAAI,EAAE,CAAsB,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,SAAiB,EAAE,MAA2B;QACzD,MAAM,IAAI,GAA4B,EAAE,CAAC;QACzC,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS;YAAE,IAAI,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC;QAC1D,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS;YAAE,IAAI,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC;QACvD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;YAAE,IAAI,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;QAChE,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS;YAAE,IAAI,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC;QACnE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,SAAS,EAAE,EAAE,IAAI,CAAC,CAAC;QAC3E,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAoB,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,SAAiB;QAC5B,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,gBAAgB,SAAS,EAAE,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,SAAiB,EAAE,SAAkC,EAAE;;QACtE,MAAM,WAAW,GAA8C,EAAE,KAAK,EAAE,MAAA,MAAM,CAAC,KAAK,mCAAI,EAAE,EAAE,CAAC;QAC7F,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;YAAE,WAAW,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;QACvE,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;YAAE,WAAW,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;QACvE,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAuB,gBAAgB,SAAS,SAAS,EAAE,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAA4B,CAAC,CAAC;IAC7I,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,SAAiB;QAC1B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,SAAS,OAAO,CAAC,CAAC;QAC3E,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAwB,CAAC;IACxD,CAAC;CACF;AAzCD,4CAyCC"}
+{"version":3,"file":"webhooks.js","sourceRoot":"","sources":["../../../src/resources/webhooks.ts"],"names":[],"mappings":"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"}

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

@@ -1,10 +1,4 @@
-export type { AccountReadiness, ListingReadiness, ReadinessAction, ListResponse, CheckoutField, ShippingAddress } from './shared';
-export { ContentType, DeliverableType, FulfillmentMode, CheckoutFieldType, OrderStatus, FulfillmentStatus, WebhookEventType, ActionKind, ActionCode } from './shared';
-export type { AccountResponse, UpdateAccountParams, AccountStats } from './account';
-export type { BlurMode, CreateListingParams, FaqItem, ListingResponse, ListingStatus, Review, UpdateListingParams, } from './listing';
-export type { ApiKeyResponse } from './api-key';
-export type { OrderResponse, ListOrdersParams, FulfillOrderParams, ShipOrderParams } from './order';
-export type { SignupResponse, VerifyResponse } from './signup';
-export type { StripeConnectSessionResponse } from './stripe';
-export type { WebhookResponse, CreateWebhookParams, UpdateWebhookParams, WebhookEventResponse, ListWebhookEventsParams, WebhookTestResponse, } from './webhook';
-export type { StoreResponse, StoreListResponse, DomainResponse, DomainStatus, CreateStoreParams, UpdateStoreParams } from './store';
+export type { ClientOptions, RequestOptions, ListResponse } from './shared';
+export { CursorPage } from './shared';
+export type * from '../generated/types';
+export * from '../generated/enums';

package/dist/cjs/types/index.js

@@ -1,14 +1,21 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ActionCode = exports.ActionKind = exports.WebhookEventType = exports.FulfillmentStatus = exports.OrderStatus = exports.CheckoutFieldType = exports.FulfillmentMode = exports.DeliverableType = exports.ContentType = void 0;
+exports.CursorPage = void 0;
 var shared_1 = require("./shared");
-Object.defineProperty(exports, "ContentType", { enumerable: true, get: function () { return shared_1.ContentType; } });
-Object.defineProperty(exports, "DeliverableType", { enumerable: true, get: function () { return shared_1.DeliverableType; } });
-Object.defineProperty(exports, "FulfillmentMode", { enumerable: true, get: function () { return shared_1.FulfillmentMode; } });
-Object.defineProperty(exports, "CheckoutFieldType", { enumerable: true, get: function () { return shared_1.CheckoutFieldType; } });
-Object.defineProperty(exports, "OrderStatus", { enumerable: true, get: function () { return shared_1.OrderStatus; } });
-Object.defineProperty(exports, "FulfillmentStatus", { enumerable: true, get: function () { return shared_1.FulfillmentStatus; } });
-Object.defineProperty(exports, "WebhookEventType", { enumerable: true, get: function () { return shared_1.WebhookEventType; } });
-Object.defineProperty(exports, "ActionKind", { enumerable: true, get: function () { return shared_1.ActionKind; } });
-Object.defineProperty(exports, "ActionCode", { enumerable: true, get: function () { return shared_1.ActionCode; } });
+Object.defineProperty(exports, "CursorPage", { enumerable: true, get: function () { return shared_1.CursorPage; } });
+__exportStar(require("../generated/enums"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":";;;AACA,mCAAsK;AAA7J,qGAAA,WAAW,OAAA;AAAE,yGAAA,eAAe,OAAA;AAAE,yGAAA,eAAe,OAAA;AAAE,2GAAA,iBAAiB,OAAA;AAAE,qGAAA,WAAW,OAAA;AAAE,2GAAA,iBAAiB,OAAA;AAAE,0GAAA,gBAAgB,OAAA;AAAE,oGAAA,UAAU,OAAA;AAAE,oGAAA,UAAU,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AACA,mCAAsC;AAA7B,oGAAA,UAAU,OAAA;AAEnB,qDAAmC"}

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

@@ -1,156 +1,36 @@
 /**
- * Shared types used across multiple resources.
+ * SDK infrastructure types and shared domain types.
  */
-/** A single readiness action describing how to resolve an issue. */
-export interface ReadinessAction {
-    /** Machine-readable action code. */
-    code: string;
-    /** Whether this action is resolved via the API or manually by the human. */
-    kind: 'api' | 'human';
-    /** Human-readable description of the action. */
-    message: string;
-    /** How to resolve this action. */
-    resolve: {
-        /** HTTP method for API actions. */
-        method: string;
-        /** API endpoint path for `kind: "api"` actions. */
-        endpoint: string | null;
-        /** External URL for `kind: "human"` actions. */
-        url: string | null;
-        /** Request parameters to include. */
-        params: Record<string, unknown> | null;
-    };
+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;
 }
-/** Account operational readiness. */
-export interface AccountReadiness {
-    /** Whether the account can accept payments. */
-    operational: boolean;
-    /** List of actions required to become operational. */
-    actions: ReadinessAction[];
-    /** Code of the highest-priority action, or null if operational. */
-    next: string | null;
+export interface RequestOptions {
+    /** Request timeout in milliseconds. */
+    timeoutMs?: number;
+    /** Idempotency key for safe request retries. */
+    idempotencyKey?: string;
+    /** Whether to include Authorization header. Default: true. */
+    authenticated?: boolean;
 }
-/** Listing monetization readiness. */
-export interface ListingReadiness {
-    /** Whether buyers can complete a purchase on this listing. */
-    sellable: boolean;
-    /** List of actions required to become sellable. */
-    actions: ReadinessAction[];
-    /** Code of the highest-priority action, or null if sellable. */
-    next: string | null;
-}
-/** Paginated list response wrapper. */
 export interface ListResponse<T> {
     object: 'list';
     data: T[];
     has_more: boolean;
     cursor: string | null;
+    total_count?: number;
 }
-/** Deliverable type — auto-detected from the content value at creation. */
-export declare const DeliverableType: {
-    readonly FILE: "file";
-    readonly URL: "url";
-    readonly TEXT: "text";
-};
-export type DeliverableType = (typeof DeliverableType)[keyof typeof DeliverableType];
-/**
- * Content type — auto-detected from the content value at creation.
- * @deprecated Use `DeliverableType` instead.
- */
-export declare const ContentType: {
-    readonly FILE: "file";
-    readonly URL: "url";
-    readonly TEXT: "text";
-};
-/**
- * @deprecated Use `DeliverableType` instead.
- */
-export type ContentType = DeliverableType;
-/** Fulfillment mode for a listing. */
-export declare const FulfillmentMode: {
-    readonly MANAGED: "managed";
-    readonly EXTERNAL: "external";
-};
-export type FulfillmentMode = (typeof FulfillmentMode)[keyof typeof FulfillmentMode];
-/** Checkout field type for buyer-facing forms. */
-export declare const CheckoutFieldType: {
-    readonly ADDRESS: "address";
-    readonly TEXT: "text";
-    readonly SELECT: "select";
-    readonly DATE: "date";
-};
-export type CheckoutFieldType = (typeof CheckoutFieldType)[keyof typeof CheckoutFieldType];
-/** A single checkout field definition for the listing checkout form. */
-export interface CheckoutField {
-    /** Field type. */
-    type: CheckoutFieldType;
-    /** Unique machine-readable field key. */
-    key: string;
-    /** Human-readable label shown to the buyer. */
-    label: string;
-    /** Whether the buyer must fill this field. */
-    required: boolean;
-    /** Available options (only for "select" type). */
-    options?: string[];
-}
-/** Shipping address collected at checkout. */
-export interface ShippingAddress {
-    /** Street address line 1. */
-    line1: string;
-    /** Street address line 2. */
-    line2: string | null;
-    /** City name. */
-    city: string;
-    /** State, province, or region. */
-    state: string | null;
-    /** Postal or ZIP code. */
-    postal_code: string;
-    /** Two-letter ISO 3166-1 alpha-2 country code. */
-    country: string;
+export declare class CursorPage<T> {
+    readonly object: "list";
+    readonly data: T[];
+    readonly has_more: boolean;
+    readonly cursor: string | null;
+    readonly total_count?: number;
+    constructor(body: ListResponse<T>);
 }
-/** Order status. */
-export declare const OrderStatus: {
-    readonly PENDING: "pending";
-    readonly PAID: "paid";
-    readonly FULFILLED: "fulfilled";
-    readonly CANCELED: "canceled";
-    readonly FAILED: "failed";
-};
-export type OrderStatus = (typeof OrderStatus)[keyof typeof OrderStatus];
-/** Order fulfillment status. */
-export declare const FulfillmentStatus: {
-    readonly PENDING: "pending";
-    readonly SHIPPED: "shipped";
-    readonly FULFILLED: "fulfilled";
-};
-export type FulfillmentStatus = (typeof FulfillmentStatus)[keyof typeof FulfillmentStatus];
-/** Webhook event type. */
-export declare const WebhookEventType: {
-    readonly ORDER_PAID: "order.paid";
-    readonly ORDER_FULFILLED: "order.fulfilled";
-    readonly ORDER_SHIPPED: "order.shipped";
-    readonly ORDER_REFUNDED: "order.refunded";
-    readonly ORDER_DISPUTED: "order.disputed";
-    readonly ORDER_DISPUTE_CLOSED: "order.dispute_closed";
-    readonly LISTING_CREATED: "listing.created";
-    readonly LISTING_UPDATED: "listing.updated";
-    readonly LISTING_PAUSED: "listing.paused";
-    readonly LISTING_RESUMED: "listing.resumed";
-    readonly LISTING_DELETED: "listing.deleted";
-};
-export type WebhookEventType = (typeof WebhookEventType)[keyof typeof WebhookEventType];
-/** Readiness action kind. */
-export declare const ActionKind: {
-    readonly API: "api";
-    readonly HUMAN: "human";
-};
-export type ActionKind = (typeof ActionKind)[keyof typeof ActionKind];
-/** Readiness action code. */
-export declare const ActionCode: {
-    readonly SET_STRIPE_KEY: "set_stripe_key";
-    readonly CONNECT_STRIPE: "connect_stripe";
-    readonly ENABLE_CHARGES: "enable_charges";
-    readonly UPDATE_BILLING: "update_billing";
-    readonly CONFIGURE_WEBHOOK: "configure_webhook";
-};
-export type ActionCode = (typeof ActionCode)[keyof typeof ActionCode];

package/dist/cjs/types/shared.js

@@ -1,71 +1,17 @@
 "use strict";
 /**
- * Shared types used across multiple resources.
+ * SDK infrastructure types and shared domain types.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ActionCode = exports.ActionKind = exports.WebhookEventType = exports.FulfillmentStatus = exports.OrderStatus = exports.CheckoutFieldType = exports.FulfillmentMode = exports.ContentType = exports.DeliverableType = void 0;
-/** Deliverable type — auto-detected from the content value at creation. */
-exports.DeliverableType = {
-    FILE: 'file',
-    URL: 'url',
-    TEXT: 'text',
-};
-/**
- * Content type — auto-detected from the content value at creation.
- * @deprecated Use `DeliverableType` instead.
- */
-exports.ContentType = exports.DeliverableType;
-/** Fulfillment mode for a listing. */
-exports.FulfillmentMode = {
-    MANAGED: 'managed',
-    EXTERNAL: 'external',
-};
-/** Checkout field type for buyer-facing forms. */
-exports.CheckoutFieldType = {
-    ADDRESS: 'address',
-    TEXT: 'text',
-    SELECT: 'select',
-    DATE: 'date',
-};
-/** Order status. */
-exports.OrderStatus = {
-    PENDING: 'pending',
-    PAID: 'paid',
-    FULFILLED: 'fulfilled',
-    CANCELED: 'canceled',
-    FAILED: 'failed',
-};
-/** Order fulfillment status. */
-exports.FulfillmentStatus = {
-    PENDING: 'pending',
-    SHIPPED: 'shipped',
-    FULFILLED: 'fulfilled',
-};
-/** Webhook event type. */
-exports.WebhookEventType = {
-    ORDER_PAID: 'order.paid',
-    ORDER_FULFILLED: 'order.fulfilled',
-    ORDER_SHIPPED: 'order.shipped',
-    ORDER_REFUNDED: 'order.refunded',
-    ORDER_DISPUTED: 'order.disputed',
-    ORDER_DISPUTE_CLOSED: 'order.dispute_closed',
-    LISTING_CREATED: 'listing.created',
-    LISTING_UPDATED: 'listing.updated',
-    LISTING_PAUSED: 'listing.paused',
-    LISTING_RESUMED: 'listing.resumed',
-    LISTING_DELETED: 'listing.deleted',
-};
-/** Readiness action kind. */
-exports.ActionKind = {
-    API: 'api',
-    HUMAN: 'human',
-};
-/** Readiness action code. */
-exports.ActionCode = {
-    SET_STRIPE_KEY: 'set_stripe_key',
-    CONNECT_STRIPE: 'connect_stripe',
-    ENABLE_CHARGES: 'enable_charges',
-    UPDATE_BILLING: 'update_billing',
-    CONFIGURE_WEBHOOK: 'configure_webhook',
-};
+exports.CursorPage = void 0;
+class CursorPage {
+    constructor(body) {
+        this.object = 'list';
+        this.data = body.data;
+        this.has_more = body.has_more;
+        this.cursor = body.cursor;
+        this.total_count = body.total_count;
+    }
+}
+exports.CursorPage = CursorPage;
 //# sourceMappingURL=shared.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/types/shared.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAmDH,2EAA2E;AAC9D,QAAA,eAAe,GAAG;IAC7B,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,KAAK;IACV,IAAI,EAAE,MAAM;CACJ,CAAC;AAGX;;;GAGG;AACU,QAAA,WAAW,GAAG,uBAAe,CAAC;AAM3C,sCAAsC;AACzB,QAAA,eAAe,GAAG;IAC7B,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,UAAU;CACZ,CAAC;AAGX,kDAAkD;AACrC,QAAA,iBAAiB,GAAG;IAC/B,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,MAAM;IACZ,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,MAAM;CACJ,CAAC;AAiCX,oBAAoB;AACP,QAAA,WAAW,GAAG;IACzB,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,MAAM;IACZ,SAAS,EAAE,WAAW;IACtB,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,QAAQ;CACR,CAAC;AAGX,gCAAgC;AACnB,QAAA,iBAAiB,GAAG;IAC/B,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,SAAS,EAAE,WAAW;CACd,CAAC;AAGX,0BAA0B;AACb,QAAA,gBAAgB,GAAG;IAC9B,UAAU,EAAE,YAAY;IACxB,eAAe,EAAE,iBAAiB;IAClC,aAAa,EAAE,eAAe;IAC9B,cAAc,EAAE,gBAAgB;IAChC,cAAc,EAAE,gBAAgB;IAChC,oBAAoB,EAAE,sBAAsB;IAC5C,eAAe,EAAE,iBAAiB;IAClC,eAAe,EAAE,iBAAiB;IAClC,cAAc,EAAE,gBAAgB;IAChC,eAAe,EAAE,iBAAiB;IAClC,eAAe,EAAE,iBAAiB;CAC1B,CAAC;AAGX,6BAA6B;AAChB,QAAA,UAAU,GAAG;IACxB,GAAG,EAAE,KAAK;IACV,KAAK,EAAE,OAAO;CACN,CAAC;AAGX,6BAA6B;AAChB,QAAA,UAAU,GAAG;IACxB,cAAc,EAAE,gBAAgB;IAChC,cAAc,EAAE,gBAAgB;IAChC,cAAc,EAAE,gBAAgB;IAChC,cAAc,EAAE,gBAAgB;IAChC,iBAAiB,EAAE,mBAAmB;CAC9B,CAAC"}
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/types/shared.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AA8BH,MAAa,UAAU;IAOrB,YAAY,IAAqB;QANxB,WAAM,GAAG,MAAe,CAAC;QAOhC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC9B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;IACtC,CAAC;CACF;AAbD,gCAaC"}

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

@@ -1,33 +1,11 @@
 /**
  * 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>);
-}
+/// <reference types="node" />
+import { CursorPage } from './types/shared';
+import type { ClientOptions, RequestOptions } from './types/shared';
+export type { ClientOptions, RequestOptions };
+export { CursorPage };
 /** Internal HTTP response wrapper. */
 interface HttpResponse {
     status: number;
@@ -54,12 +32,14 @@ export declare class BaseClient {
         params?: Record<string, string | number | boolean>;
         timeoutMs?: number;
         authenticated?: boolean;
+        idempotencyKey?: string;
     }): 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>;
+    delete(path: string, options?: RequestOptions): Promise<void>;
+    deleteWithResponse<T>(path: string, options?: RequestOptions): Promise<T>;
+    postMultipart<T>(path: string, formData: FormData, options?: RequestOptions): Promise<T>;
     getPage<T>(path: string, params: Record<string, string | number | boolean>, parse: (item: unknown) => T, options?: RequestOptions): Promise<CursorPage<T>>;
 }
-export {};