listbee 0.3.0

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

@@ -0,0 +1,15 @@
+/**
+ * Stripe resource — POST /v1/account/stripe-key, POST /v1/account/stripe/connect, DELETE /v1/account/stripe.
+ */
+import type { BaseClient } from '../base-client';
+import type { AccountResponse } from '../types/account';
+import type { StripeConnectSessionResponse } from '../types/stripe';
+export declare class StripeResource {
+    private readonly _client;
+    constructor(_client: BaseClient);
+    setKey(params: {
+        secretKey: string;
+    }): Promise<AccountResponse>;
+    connect(): Promise<StripeConnectSessionResponse>;
+    disconnect(): Promise<AccountResponse>;
+}

package/dist/cjs/resources/stripe.js

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * Stripe resource — POST /v1/account/stripe-key, POST /v1/account/stripe/connect, DELETE /v1/account/stripe.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StripeResource = void 0;
+class StripeResource {
+    constructor(_client) {
+        this._client = _client;
+    }
+    async setKey(params) {
+        const response = await this._client.post('/v1/account/stripe-key', { secret_key: params.secretKey });
+        return (await response.json());
+    }
+    async connect() {
+        const response = await this._client.post('/v1/account/stripe/connect');
+        return (await response.json());
+    }
+    async disconnect() {
+        const response = await this._client.delete('/v1/account/stripe');
+        return (await response.json());
+    }
+}
+exports.StripeResource = StripeResource;
+//# sourceMappingURL=stripe.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stripe.js","sourceRoot":"","sources":["../../../src/resources/stripe.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAMH,MAAa,cAAc;IACzB,YAA6B,OAAmB;QAAnB,YAAO,GAAP,OAAO,CAAY;IAAG,CAAC;IAEpD,KAAK,CAAC,MAAM,CAAC,MAA6B;QACxC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,wBAAwB,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QACrG,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAoB,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QACvE,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAiC,CAAC;IACjE,CAAC;IAED,KAAK,CAAC,UAAU;QACd,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;QACjE,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAoB,CAAC;IACpD,CAAC;CACF;AAjBD,wCAiBC"}

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

@@ -0,0 +1,15 @@
+/**
+ * Webhooks resource — CRUD + events + test for /v1/webhooks.
+ */
+import type { BaseClient, CursorPage } from '../base-client';
+import type { WebhookResponse, CreateWebhookParams, UpdateWebhookParams, WebhookEventResponse, ListWebhookEventsParams, WebhookTestResponse } from '../types/webhook';
+export declare class WebhooksResource {
+    private readonly _client;
+    constructor(_client: BaseClient);
+    create(params: CreateWebhookParams): Promise<WebhookResponse>;
+    list(): Promise<WebhookResponse[]>;
+    update(webhookId: string, params: UpdateWebhookParams): Promise<WebhookResponse>;
+    delete(webhookId: string): Promise<void>;
+    listEvents(webhookId: string, params?: ListWebhookEventsParams): Promise<CursorPage<WebhookEventResponse>>;
+    test(webhookId: string): Promise<WebhookTestResponse>;
+}

package/dist/cjs/resources/webhooks.js

@@ -0,0 +1,55 @@
+"use strict";
+/**
+ * Webhooks resource — CRUD + events + test for /v1/webhooks.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebhooksResource = void 0;
+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());
+    }
+    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 : []);
+    }
+    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);
+        return (await response.json());
+    }
+    async delete(webhookId) {
+        await this._client.delete(`/v1/webhooks/${webhookId}`);
+    }
+    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)
+            queryParams['cursor'] = params.cursor;
+        return this._client.getPage(`/v1/webhooks/${webhookId}/events`, queryParams, (item) => item);
+    }
+    async test(webhookId) {
+        const response = await this._client.post(`/v1/webhooks/${webhookId}/test`);
+        return (await response.json());
+    }
+}
+exports.WebhooksResource = WebhooksResource;
+//# sourceMappingURL=webhooks.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,47 @@
+/**
+ * Account response types.
+ */
+import type { AccountReadiness } from './shared';
+/** Aggregate statistics for an account. */
+export interface AccountStats {
+    /** Total revenue in the smallest currency unit across all orders. */
+    total_revenue: number;
+    /** Total number of orders across all listings. */
+    total_orders: number;
+    /** Total number of listings on the account. */
+    total_listings: number;
+}
+/** Full account object returned by the ListBee API. */
+export interface AccountResponse {
+    /** Object type discriminator. Always "account". */
+    object: 'account';
+    /** Unique account identifier. */
+    id: string;
+    /** Account email address. */
+    email: string;
+    /** Current plan tier. */
+    plan: string;
+    /** Transaction fee rate as a decimal string (e.g. "0.10" = 10%). */
+    fee_rate: string;
+    /** Three-letter ISO currency code, uppercase. Set during onboarding. */
+    currency: string | null;
+    /**
+     * Google Analytics 4 Measurement ID (e.g. "G-XXXXXXXXXX").
+     * Used to track conversions on checkout pages.
+     */
+    ga_measurement_id: string | null;
+    /** Aggregate statistics for this account. */
+    stats: AccountStats;
+    /** Account operational readiness. */
+    readiness: AccountReadiness;
+    /** ISO 8601 timestamp of when the account was created. */
+    created_at: string;
+}
+/** Parameters for updating account settings. */
+export interface UpdateAccountParams {
+    /**
+     * Google Analytics 4 Measurement ID (e.g. "G-XXXXXXXXXX").
+     * Pass null to clear the existing value.
+     */
+    ga_measurement_id?: string | null;
+}

package/dist/cjs/types/account.js

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

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

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

package/dist/cjs/types/api-key.d.ts

@@ -0,0 +1,18 @@
+/**
+ * API key response types.
+ */
+/** Full API key object returned by the ListBee API. */
+export interface ApiKeyResponse {
+    /** Object type discriminator. Always "api_key". */
+    object: 'api_key';
+    /** Unique API key identifier. */
+    id: string;
+    /** Human-readable label. */
+    name: string;
+    /** First 8 characters of the key value. */
+    prefix: string;
+    /** Full key value — only populated on create, null in list. */
+    key: string | null;
+    /** ISO 8601 timestamp of when the key was created. */
+    created_at: string;
+}

package/dist/cjs/types/api-key.js

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

package/dist/cjs/types/api-key.js.map

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

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

@@ -0,0 +1,10 @@
+export type { AccountReadiness, ListingReadiness, ReadinessAction, ListResponse } from './shared';
+export { ContentType, OrderStatus, 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 } 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';

package/dist/cjs/types/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ActionCode = exports.ActionKind = exports.WebhookEventType = exports.OrderStatus = exports.ContentType = void 0;
+var shared_1 = require("./shared");
+Object.defineProperty(exports, "ContentType", { enumerable: true, get: function () { return shared_1.ContentType; } });
+Object.defineProperty(exports, "OrderStatus", { enumerable: true, get: function () { return shared_1.OrderStatus; } });
+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; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":";;;AACA,mCAA8F;AAArF,qGAAA,WAAW,OAAA;AAAE,qGAAA,WAAW,OAAA;AAAE,0GAAA,gBAAgB,OAAA;AAAE,oGAAA,UAAU,OAAA;AAAE,oGAAA,UAAU,OAAA"}

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

@@ -0,0 +1,177 @@
+/**
+ * Listing response types.
+ */
+import type { ListingReadiness } from './shared';
+/** A single buyer review card displayed on the listing product page. */
+export interface Review {
+    /** Reviewer display name. */
+    name: string;
+    /** Star rating (1–5). */
+    rating: number;
+    /** Review body text. */
+    content: string;
+}
+/** A single FAQ accordion item displayed on the listing product page. */
+export interface FaqItem {
+    /** Question text. */
+    q: string;
+    /** Answer text. */
+    a: string;
+}
+/** Cover image blur mode. */
+export type BlurMode = 'auto' | 'true' | 'false';
+/** Listing status. */
+export type ListingStatus = 'active' | 'paused' | 'draft';
+/** Full listing object returned by the ListBee API. */
+export interface ListingResponse {
+    /** Object type discriminator. Always "listing". */
+    object: 'listing';
+    /** Unique listing identifier. */
+    id: string;
+    /** URL slug used on the product page. */
+    slug: string;
+    /** Product name shown on the product page. */
+    name: string;
+    /** Longer product description, plain text. */
+    description: string | null;
+    /** Short line shown below the product name. */
+    tagline: string | null;
+    /** Bullet-point feature badges shown on the product page. */
+    highlights: string[];
+    /** Buy button text. Defaults to "Buy Now" when not set. */
+    cta: string | null;
+    /** Price in the smallest currency unit (e.g. 2900 = $29.00). */
+    price: number;
+    /** Auto-detected from the content value at creation. */
+    content_type: string;
+    /** true if content was successfully fetched and stored. */
+    has_content: boolean;
+    /** true if a cover image exists (uploaded or auto-generated). */
+    has_cover: boolean;
+    /** Strikethrough price in smallest currency unit. */
+    compare_at_price: number | null;
+    /** Short promotional badges shown on the product page. */
+    badges: string[];
+    /** Cover image blur mode. */
+    cover_blur: BlurMode;
+    /** Seller-provided aggregate star rating (1–5). */
+    rating: number | null;
+    /** Seller-provided review or purchase count shown alongside the rating. */
+    rating_count: number | null;
+    /** Featured review cards shown on the product page. */
+    reviews: Review[];
+    /** FAQ accordion items shown on the product page. */
+    faqs: FaqItem[];
+    /** Arbitrary key-value pairs forwarded in webhook events. */
+    metadata: Record<string, unknown> | null;
+    /**
+     * UTM source tag attached to checkout links (e.g. "twitter").
+     * Null means use account defaults.
+     */
+    utm_source: string | null;
+    /**
+     * UTM medium tag attached to checkout links (e.g. "social").
+     * Null means use account defaults.
+     */
+    utm_medium: string | null;
+    /**
+     * UTM campaign tag attached to checkout links (e.g. "launch-week").
+     * Null means use account defaults.
+     */
+    utm_campaign: string | null;
+    /** Current listing status. */
+    status: ListingStatus;
+    /** Full product page URL — share this with buyers. */
+    url: string | null;
+    /** Monetization readiness. */
+    readiness: ListingReadiness;
+    /** ISO 8601 timestamp of when the listing was created. */
+    created_at: string;
+}
+/** Parameters for creating a listing. */
+export interface CreateListingParams {
+    /** Product name shown on the product page. */
+    name: string;
+    /** Price in the smallest currency unit (e.g. 2900 = $29.00). */
+    price: number;
+    /** File URL, redirect URL, or plain text to deliver after purchase. */
+    content: string;
+    /** Store to create this listing in. Required when account has multiple stores. */
+    store_id?: string;
+    /** Longer product description, plain text. */
+    description?: string;
+    /** Short line shown below the product name. */
+    tagline?: string;
+    /** Bullet-point feature badges shown on the product page. */
+    highlights?: string[];
+    /** Buy button text. Defaults to "Buy Now" when not set. */
+    cta?: string;
+    /** URL of a cover image to fetch and store. */
+    cover_url?: string;
+    /** Arbitrary key-value pairs forwarded in webhook events. */
+    metadata?: Record<string, unknown>;
+    /** Strikethrough price in smallest currency unit. */
+    compare_at_price?: number;
+    /** Short promotional badges shown on the product page. */
+    badges?: string[];
+    /**
+     * Cover blur mode — "auto", "true", or "false".
+     * Only sent when different from "auto".
+     */
+    cover_blur?: BlurMode;
+    /** Seller-provided aggregate star rating (1–5). */
+    rating?: number;
+    /** Seller-provided review or purchase count. */
+    rating_count?: number;
+    /** Featured review cards shown on the product page. */
+    reviews?: Review[];
+    /** FAQ accordion items shown on the product page. */
+    faqs?: FaqItem[];
+    /** UTM source tag attached to checkout links. Null means use account defaults. */
+    utm_source?: string | null;
+    /** UTM medium tag attached to checkout links. Null means use account defaults. */
+    utm_medium?: string | null;
+    /** UTM campaign tag attached to checkout links. Null means use account defaults. */
+    utm_campaign?: string | null;
+    /** Request timeout in milliseconds. Defaults to LISTING_CREATE_TIMEOUT_MS (120s). */
+    timeoutMs?: number;
+}
+/** Parameters for updating a listing. */
+export interface UpdateListingParams {
+    /** Product name shown on the product page. */
+    name?: string;
+    /** Price in the smallest currency unit (e.g. 2900 = $29.00). */
+    price?: number;
+    /** Longer product description, plain text. */
+    description?: string;
+    /** Short line shown below the product name. */
+    tagline?: string;
+    /** Bullet-point feature badges shown on the product page. */
+    highlights?: string[];
+    /** Buy button text. */
+    cta?: string;
+    /** URL of a cover image to fetch and store. */
+    cover_url?: string;
+    /** Arbitrary key-value pairs forwarded in webhook events. */
+    metadata?: Record<string, unknown>;
+    /** Strikethrough price in smallest currency unit. */
+    compare_at_price?: number;
+    /** Short promotional badges shown on the product page. */
+    badges?: string[];
+    /** Cover blur mode — "auto", "true", or "false". */
+    cover_blur?: BlurMode;
+    /** Seller-provided aggregate star rating (1–5). */
+    rating?: number;
+    /** Seller-provided review or purchase count. */
+    rating_count?: number;
+    /** Featured review cards shown on the product page. */
+    reviews?: Review[];
+    /** FAQ accordion items shown on the product page. */
+    faqs?: FaqItem[];
+    /** UTM source tag attached to checkout links. Null means use account defaults. */
+    utm_source?: string | null;
+    /** UTM medium tag attached to checkout links. Null means use account defaults. */
+    utm_medium?: string | null;
+    /** UTM campaign tag attached to checkout links. Null means use account defaults. */
+    utm_campaign?: string | null;
+}

package/dist/cjs/types/listing.js

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

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

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

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

@@ -0,0 +1,42 @@
+/**
+ * Order response types.
+ */
+import type { OrderStatus } from './shared';
+/** Full order object returned by the ListBee API. */
+export interface OrderResponse {
+    /** Object type discriminator. Always "order". */
+    object: 'order';
+    /** Unique order identifier. */
+    id: string;
+    /** ID of the listing that was purchased. */
+    listing_id: string;
+    /** Buyer's email address. */
+    buyer_email: string;
+    /** Amount in smallest currency unit (e.g. 2900 = $29.00). */
+    amount: number;
+    /** Three-letter ISO 4217 currency code, uppercase. */
+    currency: string;
+    /** Stripe Checkout Session ID. */
+    stripe_session_id: string;
+    /** Stripe PaymentIntent ID. */
+    stripe_payment_intent_id: string;
+    /** Order status. */
+    status: OrderStatus;
+    /** ISO 8601 timestamp of when the order was created. */
+    created_at: string;
+}
+/** Parameters for listing orders. */
+export interface ListOrdersParams {
+    /** Filter by order status. */
+    status?: OrderStatus;
+    /** Filter by listing slug. */
+    listing?: string;
+    /** Only orders created after this date (ISO 8601 string or Date). */
+    created_after?: string | Date;
+    /** Only orders created before this date (ISO 8601 string or Date). */
+    created_before?: string | Date;
+    /** Maximum items per page (1-100, default 20). */
+    limit?: number;
+    /** Pagination cursor from a previous response. */
+    cursor?: string;
+}

package/dist/cjs/types/order.js

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

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

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

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

@@ -0,0 +1,87 @@
+/**
+ * Shared types used across multiple resources.
+ */
+/** 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;
+    };
+}
+/** 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;
+}
+/** 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;
+}
+/** Content type — auto-detected from the content value at creation. */
+export declare const ContentType: {
+    readonly FILE: "file";
+    readonly URL: "url";
+    readonly TEXT: "text";
+};
+export type ContentType = (typeof ContentType)[keyof typeof ContentType];
+/** Order status. */
+export declare const OrderStatus: {
+    readonly COMPLETED: "completed";
+};
+export type OrderStatus = (typeof OrderStatus)[keyof typeof OrderStatus];
+/** Webhook event type. */
+export declare const WebhookEventType: {
+    readonly ORDER_COMPLETED: "order.completed";
+    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";
+};
+export type ActionCode = (typeof ActionCode)[keyof typeof ActionCode];

package/dist/cjs/types/shared.js

@@ -0,0 +1,41 @@
+"use strict";
+/**
+ * Shared types used across multiple resources.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ActionCode = exports.ActionKind = exports.WebhookEventType = exports.OrderStatus = exports.ContentType = void 0;
+/** Content type — auto-detected from the content value at creation. */
+exports.ContentType = {
+    FILE: 'file',
+    URL: 'url',
+    TEXT: 'text',
+};
+/** Order status. */
+exports.OrderStatus = {
+    COMPLETED: 'completed',
+};
+/** Webhook event type. */
+exports.WebhookEventType = {
+    ORDER_COMPLETED: 'order.completed',
+    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',
+};
+//# sourceMappingURL=shared.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/types/shared.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAmDH,uEAAuE;AAC1D,QAAA,WAAW,GAAG;IACzB,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,KAAK;IACV,IAAI,EAAE,MAAM;CACJ,CAAC;AAGX,oBAAoB;AACP,QAAA,WAAW,GAAG;IACzB,SAAS,EAAE,WAAW;CACd,CAAC;AAGX,0BAA0B;AACb,QAAA,gBAAgB,GAAG;IAC9B,eAAe,EAAE,iBAAiB;IAClC,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;CACxB,CAAC"}

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

@@ -0,0 +1,24 @@
+/**
+ * Signup response types.
+ */
+import type { AccountResponse } from './account';
+/** Response from the signup create endpoint. */
+export interface SignupResponse {
+    /** Object type discriminator. Always "signup_session". */
+    object: 'signup_session';
+    /** Email the OTP was sent to. */
+    email: string;
+    /** Always "otp_sent". */
+    status: 'otp_sent';
+    /** Human-readable message. */
+    message: string;
+}
+/** Response from the signup verify endpoint. */
+export interface VerifyResponse {
+    /** Object type discriminator. Always "signup_result". */
+    object: 'signup_result';
+    /** The newly created account. */
+    account: AccountResponse;
+    /** Raw API key value — store this, it's only shown once. */
+    api_key: string;
+}

package/dist/cjs/types/signup.js

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

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

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