listbee 0.3.0 → 0.5.0

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

@@ -46,21 +46,91 @@ export interface ListResponse<T> {
     has_more: boolean;
     cursor: string | null;
 }
-/** Content type — auto-detected from the content value at creation. */
+/** Deliverable object returned as part of a listing or order. */
+export interface DeliverableResponse {
+    /** Object type discriminator. Always "deliverable". */
+    object: 'deliverable';
+    /** Deliverable type — auto-detected from the content at creation. */
+    type: 'file' | 'url' | 'text';
+    /** true if the deliverable content has been successfully fetched and stored. */
+    has_content: boolean;
+}
+/** 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";
 };
-export type ContentType = (typeof ContentType)[keyof typeof ContentType];
+/**
+ * @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;
+}
 /** Order status. */
 export declare const OrderStatus: {
-    readonly COMPLETED: "completed";
+    readonly PENDING: "pending";
+    readonly PAID: "paid";
+    readonly FULFILLED: "fulfilled";
+    readonly CANCELED: "canceled";
+    readonly FAILED: "failed";
 };
 export type OrderStatus = (typeof OrderStatus)[keyof typeof OrderStatus];
 /** Webhook event type. */
 export declare const WebhookEventType: {
-    readonly ORDER_COMPLETED: "order.completed";
+    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";
@@ -83,5 +153,6 @@ export declare const ActionCode: {
     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

@@ -3,20 +3,43 @@
  * 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 = {
+exports.ActionCode = exports.ActionKind = exports.WebhookEventType = 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 = {
-    COMPLETED: 'completed',
+    PENDING: 'pending',
+    PAID: 'paid',
+    FULFILLED: 'fulfilled',
+    CANCELED: 'canceled',
+    FAILED: 'failed',
 };
 /** Webhook event type. */
 exports.WebhookEventType = {
-    ORDER_COMPLETED: 'order.completed',
+    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',
@@ -37,5 +60,6 @@ exports.ActionCode = {
     CONNECT_STRIPE: 'connect_stripe',
     ENABLE_CHARGES: 'enable_charges',
     UPDATE_BILLING: 'update_billing',
+    CONFIGURE_WEBHOOK: 'configure_webhook',
 };
 //# 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,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"}
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/types/shared.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AA6DH,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,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"}

package/dist/esm/index.d.ts

@@ -14,12 +14,12 @@ export { SignupResource } from './resources/signup';
 export { StripeResource } from './resources/stripe';
 export { StoresResource } from './resources/stores';
 export { WebhooksResource } from './resources/webhooks';
-export { ContentType, OrderStatus, WebhookEventType, ActionKind, ActionCode } from './types/shared';
-export type { AccountReadiness, ListingReadiness, ReadinessAction, ListResponse, } from './types/shared';
+export { ContentType, DeliverableType, FulfillmentMode, CheckoutFieldType, OrderStatus, WebhookEventType, ActionKind, ActionCode } from './types/shared';
+export type { AccountReadiness, DeliverableResponse, ListingReadiness, ReadinessAction, ListResponse, CheckoutField, ShippingAddress, } from './types/shared';
 export type { AccountResponse, UpdateAccountParams, AccountStats } from './types/account';
 export type { BlurMode, CreateListingParams, FaqItem, ListingResponse, ListingStatus, Review, UpdateListingParams, } from './types/listing';
 export type { ApiKeyResponse } from './types/api-key';
-export type { OrderResponse, ListOrdersParams } from './types/order';
+export type { OrderResponse, ListOrdersParams, FulfillOrderParams, ShipOrderParams } from './types/order';
 export type { SignupResponse, VerifyResponse } from './types/signup';
 export type { StripeConnectSessionResponse } from './types/stripe';
 export type { WebhookResponse, CreateWebhookParams, UpdateWebhookParams, WebhookEventResponse, ListWebhookEventsParams, WebhookTestResponse, } from './types/webhook';

package/dist/esm/index.js

@@ -16,5 +16,5 @@ export { StripeResource } from './resources/stripe';
 export { StoresResource } from './resources/stores';
 export { WebhooksResource } from './resources/webhooks';
 // Enums (runtime values)
-export { ContentType, OrderStatus, WebhookEventType, ActionKind, ActionCode } from './types/shared';
+export { ContentType, DeliverableType, FulfillmentMode, CheckoutFieldType, OrderStatus, WebhookEventType, ActionKind, ActionCode } from './types/shared';
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,SAAS;AACT,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEnC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C,SAAS;AACT,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,mBAAmB,EACnB,YAAY,EACZ,aAAa,EACb,cAAc,EACd,eAAe,EACf,wBAAwB,GACzB,MAAM,UAAU,CAAC;AAElB,YAAY;AACZ,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;AAExD,yBAAyB;AACzB,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,gBAAgB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,SAAS;AACT,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEnC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C,SAAS;AACT,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,mBAAmB,EACnB,YAAY,EACZ,aAAa,EACb,cAAc,EACd,eAAe,EACf,wBAAwB,GACzB,MAAM,UAAU,CAAC;AAElB,YAAY;AACZ,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;AAExD,yBAAyB;AACzB,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,eAAe,EAAE,iBAAiB,EAAE,WAAW,EAAE,gBAAgB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/esm/resources/listings.js

@@ -19,7 +19,11 @@ export class ListingsResource {
      */
     async create(params) {
         const { name, price, content, timeoutMs, cover_blur, ...rest } = params;
-        const body = { name, price, content };
+        const body = { name, price };
+        // content is optional (omit for external fulfillment)
+        if (content !== undefined) {
+            body['content'] = content;
+        }
         const optionalFields = [
             'description',
             'tagline',
@@ -34,6 +38,8 @@ export class ListingsResource {
             'reviews',
             'faqs',
             'store_id',
+            'fulfillment',
+            'checkout_schema',
         ];
         for (const field of optionalFields) {
             if (rest[field] !== undefined) {
@@ -108,12 +114,18 @@ export class ListingsResource {
             'rating_count',
             'reviews',
             'faqs',
+            'fulfillment',
+            'checkout_schema',
         ];
         for (const field of fields) {
             if (params[field] !== undefined) {
                 body[field] = params[field];
             }
         }
+        // checkout_schema can be explicitly set to null to clear it
+        if ('checkout_schema' in params && params.checkout_schema === null) {
+            body['checkout_schema'] = null;
+        }
         // UTM fields — include when explicitly provided (even null)
         if ('utm_source' in params)
             body['utm_source'] = params.utm_source;

package/dist/esm/resources/listings.js.map

@@ -1 +1 @@
-{"version":3,"file":"listings.js","sourceRoot":"","sources":["../../../src/resources/listings.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAGzD,8CAA8C;AAC9C,MAAM,OAAO,gBAAgB;IAC3B,YAA6B,OAAmB;QAAnB,YAAO,GAAP,OAAO,CAAY;IAAG,CAAC;IAEpD;;;;;;;;;OASG;IACH,KAAK,CAAC,MAAM,CAAC,MAA2B;QACtC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACxE,MAAM,IAAI,GAA4B,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;QAE/D,MAAM,cAAc,GAAG;YACrB,aAAa;YACb,SAAS;YACT,YAAY;YACZ,KAAK;YACL,WAAW;YACX,UAAU;YACV,kBAAkB;YAClB,QAAQ;YACR,QAAQ;YACR,cAAc;YACd,SAAS;YACT,MAAM;YACN,UAAU;SACF,CAAC;QAEX,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;YACnC,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,SAAS,EAAE,CAAC;gBAC9B,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC;QAED,iEAAiE;QACjE,IAAI,UAAU,KAAK,SAAS,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;YACtD,IAAI,CAAC,YAAY,CAAC,GAAG,UAAU,CAAC;QAClC,CAAC;QAED,4DAA4D;QAC5D,IAAI,YAAY,IAAI,MAAM;YAAE,IAAI,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC;QACnE,IAAI,YAAY,IAAI,MAAM;YAAE,IAAI,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC;QACnE,IAAI,cAAc,IAAI,MAAM;YAAE,IAAI,CAAC,cAAc,CAAC,GAAG,MAAM,CAAC,YAAY,CAAC;QAEzE,MAAM,gBAAgB,GAAG,SAAS,IAAI,yBAAyB,CAAC;QAChE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,gBAAgB,EAAE,CAAC,CAAC;QAChG,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAoB,CAAC;IACpD,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,GAAG,CAAC,IAAY;QACpB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC;QAChE,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAoB,CAAC;IACpD,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,IAAI,CAAC,SAA8C,EAAE;QACzD,MAAM,WAAW,GAA8C;YAC7D,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE;SAC1B,CAAC;QACF,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;YAAE,WAAW,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;QACvE,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CACzB,cAAc,EACd,WAAW,EACX,CAAC,IAAI,EAAE,EAAE,CAAC,IAAuB,CAClC,CAAC;IACJ,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,MAAM,CAAC,IAAY,EAAE,MAA2B;QACpD,MAAM,IAAI,GAA4B,EAAE,CAAC;QAEzC,MAAM,MAAM,GAAG;YACb,MAAM;YACN,OAAO;YACP,aAAa;YACb,SAAS;YACT,YAAY;YACZ,KAAK;YACL,WAAW;YACX,UAAU;YACV,kBAAkB;YAClB,QAAQ;YACR,YAAY;YACZ,QAAQ;YACR,cAAc;YACd,SAAS;YACT,MAAM;SACE,CAAC;QAEX,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,SAAS,EAAE,CAAC;gBAChC,IAAI,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;QAED,4DAA4D;QAC5D,IAAI,YAAY,IAAI,MAAM;YAAE,IAAI,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC;QACnE,IAAI,YAAY,IAAI,MAAM;YAAE,IAAI,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC;QACnE,IAAI,cAAc,IAAI,MAAM;YAAE,IAAI,CAAC,cAAc,CAAC,GAAG,MAAM,CAAC,YAAY,CAAC;QAEzE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,EAAE,EAAE,IAAI,CAAC,CAAC;QACtE,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAoB,CAAC;IACpD,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,KAAK,CAAC,IAAY;QACtB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,IAAI,QAAQ,CAAC,CAAC;QACvE,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAoB,CAAC;IACpD,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,IAAI,SAAS,CAAC,CAAC;QACxE,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAoB,CAAC;IACpD,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,IAAY;QACvB,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC;IACpD,CAAC;CACF"}
+{"version":3,"file":"listings.js","sourceRoot":"","sources":["../../../src/resources/listings.ts"],"names":[],"mappings":"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"}

package/dist/esm/resources/orders.d.ts

@@ -1,11 +1,43 @@
 /**
- * Orders resource — GET /v1/orders/{id}, GET /v1/orders.
+ * Orders resource — GET /v1/orders/{id}, GET /v1/orders,
+ * POST /v1/orders/{id}/fulfill, POST /v1/orders/{id}/ship.
  */
 import type { BaseClient, CursorPage } from '../base-client';
-import type { OrderResponse, ListOrdersParams } from '../types/order';
+import type { OrderResponse, ListOrdersParams, FulfillOrderParams, ShipOrderParams } from '../types/order';
 export declare class OrdersResource {
     private readonly _client;
     constructor(_client: BaseClient);
+    /**
+     * Retrieve an order by ID.
+     *
+     * @param orderId - The order ID (e.g. "ord_9xM4kP7nR2qT5wY1").
+     * @returns The OrderResponse.
+     */
     get(orderId: string): Promise<OrderResponse>;
+    /**
+     * Return a paginated list of orders.
+     *
+     * @param params - Filter and pagination parameters.
+     * @returns A CursorPage of OrderResponse objects.
+     */
     list(params?: ListOrdersParams): Promise<CursorPage<OrderResponse>>;
+    /**
+     * Fulfill an order — attach a deliverable and transition to FULFILLED.
+     *
+     * For external fulfillment listings, this allows your app to push
+     * generated content back to ListBee for delivery.
+     *
+     * @param orderId - The order ID (e.g. "ord_9xM4kP7nR2qT5wY1").
+     * @param params - Fulfillment parameters including the required deliverable ID.
+     * @returns The updated OrderResponse.
+     */
+    fulfill(orderId: string, params: FulfillOrderParams): Promise<OrderResponse>;
+    /**
+     * Mark an order as shipped with tracking information.
+     *
+     * @param orderId - The order ID (e.g. "ord_9xM4kP7nR2qT5wY1").
+     * @param params - Shipping parameters (carrier, tracking_code, seller_note).
+     * @returns The updated OrderResponse.
+     */
+    ship(orderId: string, params: ShipOrderParams): Promise<OrderResponse>;
 }

package/dist/esm/resources/orders.js

@@ -1,14 +1,27 @@
 /**
- * Orders resource — GET /v1/orders/{id}, GET /v1/orders.
+ * Orders resource — GET /v1/orders/{id}, GET /v1/orders,
+ * POST /v1/orders/{id}/fulfill, POST /v1/orders/{id}/ship.
  */
 export class OrdersResource {
     constructor(_client) {
         this._client = _client;
     }
+    /**
+     * Retrieve an order by ID.
+     *
+     * @param orderId - The order ID (e.g. "ord_9xM4kP7nR2qT5wY1").
+     * @returns The OrderResponse.
+     */
     async get(orderId) {
         const response = await this._client.get(`/v1/orders/${orderId}`);
         return (await response.json());
     }
+    /**
+     * Return a paginated list of orders.
+     *
+     * @param params - Filter and pagination parameters.
+     * @returns A CursorPage of OrderResponse objects.
+     */
     async list(params = {}) {
         const queryParams = {
             limit: params.limit ?? 20,
@@ -27,5 +40,39 @@ export class OrdersResource {
             queryParams['cursor'] = params.cursor;
         return this._client.getPage('/v1/orders', queryParams, (item) => item);
     }
+    /**
+     * Fulfill an order — attach a deliverable and transition to FULFILLED.
+     *
+     * For external fulfillment listings, this allows your app to push
+     * generated content back to ListBee for delivery.
+     *
+     * @param orderId - The order ID (e.g. "ord_9xM4kP7nR2qT5wY1").
+     * @param params - Fulfillment parameters including the required deliverable ID.
+     * @returns The updated OrderResponse.
+     */
+    async fulfill(orderId, params) {
+        const body = {
+            deliverable: params.deliverable,
+        };
+        const response = await this._client.post(`/v1/orders/${orderId}/fulfill`, body);
+        return (await response.json());
+    }
+    /**
+     * Mark an order as shipped with tracking information.
+     *
+     * @param orderId - The order ID (e.g. "ord_9xM4kP7nR2qT5wY1").
+     * @param params - Shipping parameters (carrier, tracking_code, seller_note).
+     * @returns The updated OrderResponse.
+     */
+    async ship(orderId, params) {
+        const body = {
+            carrier: params.carrier,
+            tracking_code: params.tracking_code,
+        };
+        if (params.seller_note !== undefined)
+            body['seller_note'] = params.seller_note;
+        const response = await this._client.post(`/v1/orders/${orderId}/ship`, body);
+        return (await response.json());
+    }
 }
 //# sourceMappingURL=orders.js.map

package/dist/esm/resources/orders.js.map

@@ -1 +1 @@
-{"version":3,"file":"orders.js","sourceRoot":"","sources":["../../../src/resources/orders.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,MAAM,OAAO,cAAc;IACzB,YAA6B,OAAmB;QAAnB,YAAO,GAAP,OAAO,CAAY;IAAG,CAAC;IAEpD,KAAK,CAAC,GAAG,CAAC,OAAe;QACvB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,OAAO,EAAE,CAAC,CAAC;QACjE,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAkB,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,SAA2B,EAAE;QACtC,MAAM,WAAW,GAA8C;YAC7D,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE;SAC1B,CAAC;QACF,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;YAAE,WAAW,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;QACvE,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS;YAAE,WAAW,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC;QAC1E,IAAI,MAAM,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;YACvC,WAAW,CAAC,eAAe,CAAC,GAAG,MAAM,CAAC,aAAa,YAAY,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC;QAClI,CAAC;QACD,IAAI,MAAM,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;YACxC,WAAW,CAAC,gBAAgB,CAAC,GAAG,MAAM,CAAC,cAAc,YAAY,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC;QACtI,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;YAAE,WAAW,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;QAEvE,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAgB,YAAY,EAAE,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAqB,CAAC,CAAC;IACzG,CAAC;CACF"}
+{"version":3,"file":"orders.js","sourceRoot":"","sources":["../../../src/resources/orders.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,OAAO,cAAc;IACzB,YAA6B,OAAmB;QAAnB,YAAO,GAAP,OAAO,CAAY;IAAG,CAAC;IAEpD;;;;;OAKG;IACH,KAAK,CAAC,GAAG,CAAC,OAAe;QACvB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,OAAO,EAAE,CAAC,CAAC;QACjE,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAkB,CAAC;IAClD,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,IAAI,CAAC,SAA2B,EAAE;QACtC,MAAM,WAAW,GAA8C;YAC7D,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE;SAC1B,CAAC;QACF,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;YAAE,WAAW,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;QACvE,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS;YAAE,WAAW,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC;QAC1E,IAAI,MAAM,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;YACvC,WAAW,CAAC,eAAe,CAAC,GAAG,MAAM,CAAC,aAAa,YAAY,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC;QAClI,CAAC;QACD,IAAI,MAAM,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;YACxC,WAAW,CAAC,gBAAgB,CAAC,GAAG,MAAM,CAAC,cAAc,YAAY,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC;QACtI,CAAC;QACD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;YAAE,WAAW,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;QAEvE,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAgB,YAAY,EAAE,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAqB,CAAC,CAAC;IACzG,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,OAAO,CAAC,OAAe,EAAE,MAA0B;QACvD,MAAM,IAAI,GAA4B;YACpC,WAAW,EAAE,MAAM,CAAC,WAAW;SAChC,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,OAAO,UAAU,EAAE,IAAI,CAAC,CAAC;QAChF,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAkB,CAAC;IAClD,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,IAAI,CAAC,OAAe,EAAE,MAAuB;QACjD,MAAM,IAAI,GAA4B;YACpC,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,aAAa,EAAE,MAAM,CAAC,aAAa;SACpC,CAAC;QACF,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS;YAAE,IAAI,CAAC,aAAa,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC;QAE/E,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,cAAc,OAAO,OAAO,EAAE,IAAI,CAAC,CAAC;QAC7E,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAkB,CAAC;IAClD,CAAC;CACF"}

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

@@ -1,9 +1,9 @@
-export type { AccountReadiness, ListingReadiness, ReadinessAction, ListResponse } from './shared';
-export { ContentType, OrderStatus, WebhookEventType, ActionKind, ActionCode } from './shared';
+export type { AccountReadiness, DeliverableResponse, ListingReadiness, ReadinessAction, ListResponse, CheckoutField, ShippingAddress } from './shared';
+export { ContentType, DeliverableType, FulfillmentMode, CheckoutFieldType, 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 { 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';

package/dist/esm/types/index.js

@@ -1,2 +1,2 @@
-export { ContentType, OrderStatus, WebhookEventType, ActionKind, ActionCode } from './shared';
+export { ContentType, DeliverableType, FulfillmentMode, CheckoutFieldType, OrderStatus, WebhookEventType, ActionKind, ActionCode } from './shared';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,gBAAgB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,eAAe,EAAE,iBAAiB,EAAE,WAAW,EAAE,gBAAgB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC"}

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

@@ -1,7 +1,7 @@
 /**
  * Listing response types.
  */
-import type { ListingReadiness } from './shared';
+import type { CheckoutField, DeliverableResponse, FulfillmentMode, ListingReadiness } from './shared';
 /** A single buyer review card displayed on the listing product page. */
 export interface Review {
     /** Reviewer display name. */
@@ -42,10 +42,12 @@ export interface ListingResponse {
     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;
+    /** Deliverable associated with this listing, or null for external fulfillment. */
+    deliverable: DeliverableResponse | null;
+    /** Fulfillment mode — "managed" (ListBee delivers) or "external" (you deliver). */
+    fulfillment: FulfillmentMode;
+    /** Checkout schema — custom fields collected at checkout (max 10). */
+    checkout_schema: CheckoutField[] | null;
     /** true if a cover image exists (uploaded or auto-generated). */
     has_cover: boolean;
     /** Strikethrough price in smallest currency unit. */
@@ -94,8 +96,12 @@ export interface CreateListingParams {
     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;
+    /** File URL, redirect URL, or plain text to deliver after purchase. Omit for external fulfillment. */
+    content?: string;
+    /** Fulfillment mode — "managed" or "external". Inferred from content when omitted. */
+    fulfillment?: FulfillmentMode;
+    /** Checkout schema — custom fields collected at checkout (max 10). */
+    checkout_schema?: CheckoutField[];
     /** Store to create this listing in. Required when account has multiple stores. */
     store_id?: string;
     /** Longer product description, plain text. */
@@ -142,6 +148,10 @@ export interface UpdateListingParams {
     name?: string;
     /** Price in the smallest currency unit (e.g. 2900 = $29.00). */
     price?: number;
+    /** Fulfillment mode — "managed" or "external". */
+    fulfillment?: FulfillmentMode;
+    /** Checkout schema — custom fields collected at checkout (max 10). */
+    checkout_schema?: CheckoutField[] | null;
     /** Longer product description, plain text. */
     description?: string;
     /** Short line shown below the product name. */

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

@@ -1,7 +1,7 @@
 /**
  * Order response types.
  */
-import type { OrderStatus } from './shared';
+import type { DeliverableResponse, OrderStatus, ShippingAddress } from './shared';
 /** Full order object returned by the ListBee API. */
 export interface OrderResponse {
     /** Object type discriminator. Always "order". */
@@ -16,12 +16,28 @@ export interface OrderResponse {
     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;
+    /** Custom checkout data collected from the buyer. */
+    checkout_data: Record<string, unknown> | null;
+    /** Shipping address collected at checkout. */
+    shipping_address: ShippingAddress | null;
+    /** Deliverable associated with this order (managed fulfillment only). */
+    deliverable: DeliverableResponse | null;
+    /** Shipping carrier name (e.g. "UPS", "FedEx"). */
+    carrier: string | null;
+    /** Shipping tracking code. */
+    tracking_code: string | null;
+    /** Seller note for the buyer. */
+    seller_note: string | null;
+    /** ISO 8601 timestamp of when payment was confirmed. */
+    paid_at: string | null;
+    /** ISO 8601 timestamp of when the order was fulfilled. */
+    fulfilled_at: string | null;
+    /** ISO 8601 timestamp of when the order was shipped. */
+    shipped_at: string | null;
     /** ISO 8601 timestamp of when the order was created. */
     created_at: string;
 }
@@ -40,3 +56,20 @@ export interface ListOrdersParams {
     /** Pagination cursor from a previous response. */
     cursor?: string;
 }
+/** Parameters for fulfilling an order. */
+export interface FulfillOrderParams {
+    /**
+     * ID of the deliverable to attach to this order.
+     * Auto-detected from the listing's deliverable. Required for external listings.
+     */
+    deliverable: string;
+}
+/** Parameters for shipping an order. */
+export interface ShipOrderParams {
+    /** Shipping carrier name (e.g. "UPS", "FedEx"). */
+    carrier: string;
+    /** Shipping tracking code. */
+    tracking_code: string;
+    /** Optional note for the buyer. */
+    seller_note?: string;
+}

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

@@ -46,21 +46,91 @@ export interface ListResponse<T> {
     has_more: boolean;
     cursor: string | null;
 }
-/** Content type — auto-detected from the content value at creation. */
+/** Deliverable object returned as part of a listing or order. */
+export interface DeliverableResponse {
+    /** Object type discriminator. Always "deliverable". */
+    object: 'deliverable';
+    /** Deliverable type — auto-detected from the content at creation. */
+    type: 'file' | 'url' | 'text';
+    /** true if the deliverable content has been successfully fetched and stored. */
+    has_content: boolean;
+}
+/** 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";
 };
-export type ContentType = (typeof ContentType)[keyof typeof ContentType];
+/**
+ * @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;
+}
 /** Order status. */
 export declare const OrderStatus: {
-    readonly COMPLETED: "completed";
+    readonly PENDING: "pending";
+    readonly PAID: "paid";
+    readonly FULFILLED: "fulfilled";
+    readonly CANCELED: "canceled";
+    readonly FAILED: "failed";
 };
 export type OrderStatus = (typeof OrderStatus)[keyof typeof OrderStatus];
 /** Webhook event type. */
 export declare const WebhookEventType: {
-    readonly ORDER_COMPLETED: "order.completed";
+    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";
@@ -83,5 +153,6 @@ export declare const ActionCode: {
     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];