listbee 0.3.0 → 0.5.0

package/README.md

@@ -19,12 +19,23 @@ import { ListBee } from 'listbee';
 
 const client = new ListBee({ apiKey: 'lb_...' });
 
+// Managed fulfillment — ListBee delivers a file automatically
 const listing = await client.listings.create({
   name: 'SEO Playbook',
   price: 2900,
   content: 'https://example.com/seo-playbook.pdf',
 });
 console.log(listing.url); // https://buy.listbee.so/r7kq2xy9
+
+// External fulfillment — you handle delivery via webhooks
+const report = await client.listings.create({
+  name: 'Custom SEO Report',
+  price: 4900,
+  fulfillment: 'external',
+  checkout_schema: [
+    { type: 'text', key: 'website_url', label: 'Your website URL', required: true },
+  ],
+});
 ```
 
 Using an environment variable instead:
@@ -76,13 +87,24 @@ import { ListBee } from 'listbee';
 
 const client = new ListBee({ apiKey: 'lb_...' });
 
-// Create — minimal
+// Create — managed fulfillment (ListBee delivers the file)
 const listing = await client.listings.create({
   name: 'SEO Playbook',
   price: 2900,       // $29.00 in cents
   content: 'https://example.com/seo-playbook.pdf', // file URL, redirect URL, or plain text
 });
 
+// Create — external fulfillment (you deliver via webhooks)
+const report = await client.listings.create({
+  name: 'Custom SEO Report',
+  price: 4900,
+  fulfillment: 'external',
+  checkout_schema: [
+    { type: 'text', key: 'website_url', label: 'Your website URL', required: true },
+    { type: 'select', key: 'priority', label: 'Priority', required: false, options: ['standard', 'rush'] },
+  ],
+});
+
 // Create — all optional params
 const listing = await client.listings.create({
   name: 'SEO Playbook 2026',
@@ -143,7 +165,7 @@ for (const order of page.data) {
 
 // Filter by status, listing, date range
 const page = await client.orders.list({
-  status: 'completed',
+  status: 'paid',
   listing: 'seo-playbook',
   created_after: new Date('2026-03-01'),
   created_before: '2026-03-31T23:59:59Z', // Date objects or ISO strings
@@ -152,6 +174,33 @@ const page = await client.orders.list({
 // Get by ID
 const order = await client.orders.get('ord_9xM4kP7nR2qT5wY1');
 console.log(order.listing_id, order.amount);
+console.log(order.status);              // "pending" | "paid" | "fulfilled" | "canceled" | "failed"
+console.log(order.fulfillment_status);  // "pending" | "shipped" | "fulfilled" | null
+console.log(order.checkout_data);       // custom checkout field values
+console.log(order.shipping_address);    // ShippingAddress | null
+console.log(order.paid_at);            // ISO 8601 timestamp
+
+// Fulfill an order — push content to the buyer (external fulfillment)
+const fulfilled = await client.orders.fulfill('ord_9xM4kP7nR2qT5wY1', {
+  content: 'Your custom report is ready.',
+  content_type: 'text',
+});
+console.log(fulfilled.status);            // "fulfilled"
+console.log(fulfilled.fulfillment_status); // "fulfilled"
+
+// Fulfill with a URL
+await client.orders.fulfill('ord_9xM4kP7nR2qT5wY1', {
+  content_url: 'https://example.com/report.pdf',
+});
+
+// Ship an order — add tracking info
+const shipped = await client.orders.ship('ord_9xM4kP7nR2qT5wY1', {
+  carrier: 'UPS',
+  tracking_code: '1Z999AA10123456784',
+  seller_note: 'Ships within 2 business days',
+});
+console.log(shipped.fulfillment_status); // "shipped"
+console.log(shipped.carrier);           // "UPS"
 ```
 
 ### Webhooks
@@ -166,8 +215,9 @@ const webhook = await client.webhooks.create({
   name: 'Production endpoint',
   url: 'https://example.com/webhooks/listbee',
   events: [
-    WebhookEventType.ORDER_COMPLETED,
-    WebhookEventType.ORDER_REFUNDED,
+    WebhookEventType.ORDER_PAID,
+    WebhookEventType.ORDER_FULFILLED,
+    WebhookEventType.ORDER_SHIPPED,
   ],
 });
 console.log(webhook.id);     // wh_3mK8nP2qR5tW7xY1
@@ -191,7 +241,7 @@ await client.webhooks.update('wh_3mK8nP2qR5tW7xY1', { enabled: false });
 // Update — change URL and events
 await client.webhooks.update('wh_3mK8nP2qR5tW7xY1', {
   url: 'https://example.com/webhooks/v2',
-  events: [WebhookEventType.ORDER_COMPLETED],
+  events: [WebhookEventType.ORDER_PAID],
 });
 
 // List delivery events
@@ -326,6 +376,37 @@ console.log(connect.url); // redirect seller here
 await client.stripe.disconnect();
 ```
 
+## Fulfillment modes
+
+ListBee supports two fulfillment modes:
+
+- **Managed** — ListBee delivers digital content automatically (files, URLs, text). Set `content` when creating a listing.
+- **External** — ListBee fires `order.paid` webhook, your app handles delivery. Use `orders.fulfill()` to push content back, or `orders.ship()` for physical goods.
+
+```typescript
+import { ListBee, FulfillmentMode } from 'listbee';
+
+const client = new ListBee({ apiKey: 'lb_...' });
+
+// Check fulfillment mode
+const listing = await client.listings.get('my-listing');
+if (listing.fulfillment === FulfillmentMode.EXTERNAL) {
+  // Handle delivery yourself
+}
+
+// Fulfill externally — push generated content
+await client.orders.fulfill('ord_...', {
+  content: 'Your AI-generated report...',
+  content_type: 'text',
+});
+
+// Or ship physical goods
+await client.orders.ship('ord_...', {
+  carrier: 'FedEx',
+  tracking_code: '7489274892',
+});
+```
+
 ## Readiness system
 
 Every listing and account includes a `readiness` field that tells you whether it can currently accept payments.
@@ -484,13 +565,25 @@ import {
   type DomainResponse,
   type WebhookEventResponse,
   type WebhookTestResponse,
+  type CheckoutField,
+  type ShippingAddress,
+
+  // Param types
+  type FulfillOrderParams,
+  type ShipOrderParams,
 
   // Enums (runtime values)
-  ContentType,        // "file" | "url" | "text"
-  OrderStatus,        // "completed"
-  WebhookEventType,   // "order.completed" | "order.refunded" | ...
-  ActionCode,         // "set_stripe_key" | "connect_stripe" | ...
-  ActionKind,         // "api" | "human"
+  DeliverableType,     // "file" | "url" | "text"
+  FulfillmentMode,     // "managed" | "external"
+  CheckoutFieldType,   // "address" | "text" | "select" | "date"
+  OrderStatus,         // "pending" | "paid" | "fulfilled" | "canceled" | "failed"
+  FulfillmentStatus,   // "pending" | "shipped" | "fulfilled"
+  WebhookEventType,    // "order.paid" | "order.fulfilled" | "order.shipped" | ...
+  ActionCode,          // "set_stripe_key" | "connect_stripe" | "configure_webhook" | ...
+  ActionKind,          // "api" | "human"
+
+  // Deprecated (use DeliverableType)
+  ContentType,
 
   // Errors
   ListBeeError,
@@ -509,20 +602,25 @@ import {
 Enums are `as const` objects — use them to avoid magic strings:
 
 ```typescript
-import { ContentType, WebhookEventType } from 'listbee';
+import { DeliverableType, WebhookEventType, FulfillmentMode } from 'listbee';
 
-// Check content type
-if (listing.content_type === ContentType.FILE) {
+// Check deliverable type
+if (listing.deliverable_type === DeliverableType.FILE) {
   console.log('Delivers a file');
 }
 
+// Check fulfillment mode
+if (listing.fulfillment === FulfillmentMode.EXTERNAL) {
+  console.log('External fulfillment — handle delivery yourself');
+}
+
 // Subscribe to specific events
 const webhook = await client.webhooks.create({
   name: 'Orders only',
   url: 'https://example.com/hooks',
   events: [
-    WebhookEventType.ORDER_COMPLETED,
-    WebhookEventType.ORDER_REFUNDED,
+    WebhookEventType.ORDER_PAID,
+    WebhookEventType.ORDER_FULFILLED,
   ],
 });
 ```

package/dist/cjs/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/cjs/index.js

@@ -3,7 +3,7 @@
  * ListBee TypeScript SDK — public exports.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ActionCode = exports.ActionKind = exports.WebhookEventType = exports.OrderStatus = exports.ContentType = exports.WebhooksResource = exports.StoresResource = exports.StripeResource = exports.SignupResource = exports.OrdersResource = exports.ApiKeysResource = exports.ListingsResource = exports.AccountResource = exports.WebhookVerificationError = exports.ValidationError = exports.RateLimitError = exports.NotFoundError = exports.ListBeeError = exports.InternalServerError = exports.ConflictError = exports.AuthenticationError = exports.APITimeoutError = exports.APIStatusError = exports.APIConnectionError = exports.CursorPage = exports.ListBee = void 0;
+exports.ActionCode = exports.ActionKind = exports.WebhookEventType = exports.OrderStatus = exports.CheckoutFieldType = exports.FulfillmentMode = exports.DeliverableType = exports.ContentType = exports.WebhooksResource = exports.StoresResource = exports.StripeResource = exports.SignupResource = exports.OrdersResource = exports.ApiKeysResource = exports.ListingsResource = exports.AccountResource = exports.WebhookVerificationError = exports.ValidationError = exports.RateLimitError = exports.NotFoundError = exports.ListBeeError = exports.InternalServerError = exports.ConflictError = exports.AuthenticationError = exports.APITimeoutError = exports.APIStatusError = exports.APIConnectionError = exports.CursorPage = exports.ListBee = void 0;
 // Client
 var client_1 = require("./client");
 Object.defineProperty(exports, "ListBee", { enumerable: true, get: function () { return client_1.ListBee; } });
@@ -42,6 +42,9 @@ Object.defineProperty(exports, "WebhooksResource", { enumerable: true, get: func
 // Enums (runtime values)
 var shared_1 = require("./types/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, "WebhookEventType", { enumerable: true, get: function () { return shared_1.WebhookEventType; } });
 Object.defineProperty(exports, "ActionKind", { enumerable: true, get: function () { return shared_1.ActionKind; } });

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,SAAS;AACT,mCAAmC;AAA1B,iGAAA,OAAO,OAAA;AAEhB,6CAA2C;AAAlC,yGAAA,UAAU,OAAA;AAGnB,SAAS;AACT,mCAYkB;AAXhB,4GAAA,kBAAkB,OAAA;AAClB,wGAAA,cAAc,OAAA;AACd,yGAAA,eAAe,OAAA;AACf,6GAAA,mBAAmB,OAAA;AACnB,uGAAA,aAAa,OAAA;AACb,6GAAA,mBAAmB,OAAA;AACnB,sGAAA,YAAY,OAAA;AACZ,uGAAA,aAAa,OAAA;AACb,wGAAA,cAAc,OAAA;AACd,yGAAA,eAAe,OAAA;AACf,kHAAA,wBAAwB,OAAA;AAG1B,YAAY;AACZ,+CAAsD;AAA7C,0GAAA,eAAe,OAAA;AACxB,iDAAwD;AAA/C,4GAAA,gBAAgB,OAAA;AACzB,iDAAuD;AAA9C,2GAAA,eAAe,OAAA;AACxB,6CAAoD;AAA3C,wGAAA,cAAc,OAAA;AACvB,6CAAoD;AAA3C,wGAAA,cAAc,OAAA;AACvB,6CAAoD;AAA3C,wGAAA,cAAc,OAAA;AACvB,6CAAoD;AAA3C,wGAAA,cAAc,OAAA;AACvB,iDAAwD;AAA/C,4GAAA,gBAAgB,OAAA;AAEzB,yBAAyB;AACzB,yCAAoG;AAA3F,qGAAA,WAAW,OAAA;AAAE,qGAAA,WAAW,OAAA;AAAE,0GAAA,gBAAgB,OAAA;AAAE,oGAAA,UAAU,OAAA;AAAE,oGAAA,UAAU,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,SAAS;AACT,mCAAmC;AAA1B,iGAAA,OAAO,OAAA;AAEhB,6CAA2C;AAAlC,yGAAA,UAAU,OAAA;AAGnB,SAAS;AACT,mCAYkB;AAXhB,4GAAA,kBAAkB,OAAA;AAClB,wGAAA,cAAc,OAAA;AACd,yGAAA,eAAe,OAAA;AACf,6GAAA,mBAAmB,OAAA;AACnB,uGAAA,aAAa,OAAA;AACb,6GAAA,mBAAmB,OAAA;AACnB,sGAAA,YAAY,OAAA;AACZ,uGAAA,aAAa,OAAA;AACb,wGAAA,cAAc,OAAA;AACd,yGAAA,eAAe,OAAA;AACf,kHAAA,wBAAwB,OAAA;AAG1B,YAAY;AACZ,+CAAsD;AAA7C,0GAAA,eAAe,OAAA;AACxB,iDAAwD;AAA/C,4GAAA,gBAAgB,OAAA;AACzB,iDAAuD;AAA9C,2GAAA,eAAe,OAAA;AACxB,6CAAoD;AAA3C,wGAAA,cAAc,OAAA;AACvB,6CAAoD;AAA3C,wGAAA,cAAc,OAAA;AACvB,6CAAoD;AAA3C,wGAAA,cAAc,OAAA;AACvB,6CAAoD;AAA3C,wGAAA,cAAc,OAAA;AACvB,iDAAwD;AAA/C,4GAAA,gBAAgB,OAAA;AAEzB,yBAAyB;AACzB,yCAAyJ;AAAhJ,qGAAA,WAAW,OAAA;AAAE,yGAAA,eAAe,OAAA;AAAE,yGAAA,eAAe,OAAA;AAAE,2GAAA,iBAAiB,OAAA;AAAE,qGAAA,WAAW,OAAA;AAAE,0GAAA,gBAAgB,OAAA;AAAE,oGAAA,UAAU,OAAA;AAAE,oGAAA,UAAU,OAAA"}

package/dist/cjs/resources/listings.js

@@ -22,7 +22,11 @@ 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',
@@ -37,6 +41,8 @@ class ListingsResource {
             'reviews',
             'faqs',
             'store_id',
+            'fulfillment',
+            'checkout_schema',
         ];
         for (const field of optionalFields) {
             if (rest[field] !== undefined) {
@@ -112,12 +118,18 @@ 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/cjs/resources/listings.js.map

@@ -1 +1 @@
-{"version":3,"file":"listings.js","sourceRoot":"","sources":["../../../src/resources/listings.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAGH,4CAAyD;AAGzD,8CAA8C;AAC9C,MAAa,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,aAAT,SAAS,cAAT,SAAS,GAAI,qCAAyB,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,MAAA,MAAM,CAAC,KAAK,mCAAI,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;AAhKD,4CAgKC"}
+{"version":3,"file":"listings.js","sourceRoot":"","sources":["../../../src/resources/listings.ts"],"names":[],"mappings":"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"}

package/dist/cjs/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/cjs/resources/orders.js

@@ -1,6 +1,7 @@
 "use strict";
 /**
- * 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.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.OrdersResource = void 0;
@@ -8,10 +9,22 @@ 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 = {}) {
         var _a;
         const queryParams = {
@@ -31,6 +44,40 @@ 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());
+    }
 }
 exports.OrdersResource = OrdersResource;
 //# sourceMappingURL=orders.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"orders.js","sourceRoot":"","sources":["../../../src/resources/orders.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAKH,MAAa,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,MAAA,MAAM,CAAC,KAAK,mCAAI,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;AAxBD,wCAwBC"}
+{"version":3,"file":"orders.js","sourceRoot":"","sources":["../../../src/resources/orders.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAKH,MAAa,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,MAAA,MAAM,CAAC,KAAK,mCAAI,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;AAzED,wCAyEC"}

package/dist/cjs/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/cjs/types/index.js

@@ -1,8 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ActionCode = exports.ActionKind = exports.WebhookEventType = exports.OrderStatus = exports.ContentType = void 0;
+exports.ActionCode = exports.ActionKind = exports.WebhookEventType = exports.OrderStatus = exports.CheckoutFieldType = exports.FulfillmentMode = exports.DeliverableType = exports.ContentType = 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, "WebhookEventType", { enumerable: true, get: function () { return shared_1.WebhookEventType; } });
 Object.defineProperty(exports, "ActionKind", { enumerable: true, get: function () { return shared_1.ActionKind; } });

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

@@ -1 +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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":";;;AACA,mCAAmJ;AAA1I,qGAAA,WAAW,OAAA;AAAE,yGAAA,eAAe,OAAA;AAAE,yGAAA,eAAe,OAAA;AAAE,2GAAA,iBAAiB,OAAA;AAAE,qGAAA,WAAW,OAAA;AAAE,0GAAA,gBAAgB,OAAA;AAAE,oGAAA,UAAU,OAAA;AAAE,oGAAA,UAAU,OAAA"}

package/dist/cjs/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/cjs/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;
+}