listbee 0.7.0 → 0.8.0

package/README.md

@@ -26,20 +26,17 @@ pnpm add listbee
 ## Quick start
 
 ```typescript
-import { ListBee } from 'listbee';
+import { ListBee, Deliverable } from 'listbee';
 
 const client = new ListBee({ apiKey: 'lb_...' });
 
-// Create a listing, set a deliverable, publish
-const listing = await client.listings.create({
+// Create a listing, attach a deliverable, and publish in one call
+const listing = await client.listings.createComplete({
   name: 'SEO Playbook',
   price: 2900, // $29.00 in cents
   description: 'A comprehensive guide to modern SEO.',
-});
-
-await client.listings.setDeliverables(listing.id, {
   deliverables: [
-    { type: 'url', value: 'https://example.com/seo-playbook.pdf' },
+    Deliverable.url('https://example.com/seo-playbook.pdf'),
   ],
 });
 
@@ -72,7 +69,7 @@ The key is validated lazily — an `AuthenticationError` is raised only when you
 
 | Resource | Methods |
 |----------|---------|
-| `listings` | `create`, `get`, `list`, `update`, `publish`, `setDeliverables`, `removeDeliverables`, `delete` |
+| `listings` | `create`, `get`, `list`, `update`, `publish`, `setDeliverables`, `removeDeliverables`, `addDeliverable`, `removeDeliverable`, `createComplete`, `delete` |
 | `orders` | `get`, `list`, `deliver`, `ship`, `refund` |
 | `customers` | `get`, `list` |
 | `files` | `upload` |
@@ -100,9 +97,11 @@ const listing = await client.listings.create({
 console.log(listing.id); // lst_r7kq2xy9m3pR5tW1
 
 // Set deliverables (file, URL, or text)
+import { Deliverable } from 'listbee';
+
 await client.listings.setDeliverables(listing.id, {
   deliverables: [
-    { type: 'url', value: 'https://example.com/seo-playbook.pdf' },
+    Deliverable.url('https://example.com/seo-playbook.pdf'),
   ],
 });
 
@@ -129,6 +128,26 @@ await client.listings.update('lst_r7kq2xy9m3pR5tW1', { price: 3900 });
 // Remove deliverables (revert to external fulfillment)
 await client.listings.removeDeliverables('lst_r7kq2xy9m3pR5tW1');
 
+// Add a single deliverable using the Deliverable class
+import { Deliverable } from 'listbee';
+
+await client.listings.addDeliverable('lst_r7kq2xy9m3pR5tW1', Deliverable.url('https://example.com/playbook.pdf'));
+await client.listings.addDeliverable('lst_r7kq2xy9m3pR5tW1', Deliverable.text('Your license key: XXXX-XXXX'));
+await client.listings.addDeliverable('lst_r7kq2xy9m3pR5tW1', Deliverable.fromToken(file.token));
+
+// Remove a single deliverable by del_ ID
+await client.listings.removeDeliverable('lst_r7kq2xy9m3pR5tW1', 'del_4hR9nK2mQ7tV5wX1');
+
+// Create a listing and attach deliverables in one call
+const listing = await client.listings.createComplete({
+  name: 'SEO Playbook',
+  price: 2900,
+  deliverables: [
+    Deliverable.url('https://example.com/seo-playbook.pdf'),
+  ],
+});
+await client.listings.publish(listing.id);
+
 // Delete
 await client.listings.delete('lst_r7kq2xy9m3pR5tW1');
 ```
@@ -152,17 +171,19 @@ console.log(order.checkout_data); // custom checkout field values
 console.log(order.paid_at);       // ISO 8601 timestamp
 
 // Deliver — push content to the buyer (external fulfillment)
+import { Deliverable } from 'listbee';
+
 const fulfilled = await client.orders.deliver('ord_9xM4kP7nR2qT5wY1', {
   deliverables: [
-    { type: 'text', value: 'Your AI-generated report is ready.' },
+    Deliverable.text('Your AI-generated report is ready.'),
   ],
 });
 console.log(fulfilled.status); // "fulfilled"
 
-// Or deliver a file or URL
+// Or deliver a URL
 await client.orders.deliver('ord_9xM4kP7nR2qT5wY1', {
   deliverables: [
-    { type: 'url', value: 'https://example.com/report.pdf' },
+    Deliverable.url('https://example.com/report.pdf'),
   ],
 });
 
@@ -197,18 +218,19 @@ console.log(customer.email, customer.order_count);
 
 ```typescript
 import { createReadStream } from 'fs';
+import { Deliverable } from 'listbee';
 
 // Upload a file (multipart, native FormData)
 const file = await client.files.upload({
   file: createReadStream('/path/to/report.pdf'),
   filename: 'report.pdf',
 });
-console.log(file.id);  // use this ID in setDeliverables
+console.log(file.token);  // use this token in setDeliverables / Deliverable.fromToken()
 
 // Then attach to a listing
 await client.listings.setDeliverables(listing.id, {
   deliverables: [
-    { type: 'file', token: file.id },
+    Deliverable.fromToken(file.token),
   ],
 });
 ```
@@ -300,68 +322,30 @@ console.log(connect.url); // redirect seller here
 await client.stripe.disconnect();
 ```
 
-## Convenience Helpers
-
-Composite methods that chain multiple API calls into one.
+## Fulfillment modes
 
-### Create and Publish
+- **Managed** — ListBee delivers digital content automatically. Call `setDeliverables()` on the listing, then `publish()`.
+- **External** — ListBee fires `order.paid` webhook, your app handles delivery. Call `orders.deliver()` to push content back.
 
 ```typescript
-// Managed fulfillment — one call does create + set deliverables + publish
-const listing = await client.listings.createAndPublish({
+import { Deliverable } from 'listbee';
+
+// One-shot: create listing + attach deliverables
+const listing = await client.listings.createComplete({
   name: 'SEO Playbook',
   price: 2900,
-  deliverables: [{ type: 'url', value: 'https://example.com/ebook.pdf' }],
-});
-
-// External fulfillment — no deliverables needed
-const listing = await client.listings.createAndPublish({
-  name: 'Custom Report',
-  price: 4900,
-  fulfillment: 'external',
-});
-```
-
-### Upload and Set Deliverable
-
-```typescript
-const listing = await client.listings.uploadAndSetDeliverable('lst_abc123', {
-  file: new File([buffer], 'ebook.pdf', { type: 'application/pdf' }),
-});
-```
-
-### Upload and Deliver
-
-```typescript
-const order = await client.orders.uploadAndDeliver('ord_abc123', {
-  file: new File([content], 'report.pdf', { type: 'application/pdf' }),
+  deliverables: [
+    Deliverable.url('https://example.com/seo-playbook.pdf'),
+  ],
 });
-```
-
-### Get Customer by Email
-
-```typescript
-const customer = await client.customers.getByEmail('buyer@example.com');
-if (customer) {
-  console.log(`Total spent: ${customer.total_spent}`);
-}
-```
-
-### Retry Failed Webhook Events
-
-```typescript
-const retried = await client.webhooks.retryFailedEvents('wh_abc123');
-console.log(`Retried ${retried.length} events`);
-```
-
-## Fulfillment modes
+await client.listings.publish(listing.id);
 
-- **Managed** — ListBee delivers digital content automatically. Call `setDeliverables()` on the listing, then `publish()`.
-- **External** — ListBee fires `order.paid` webhook, your app handles delivery. Call `orders.deliver()` to push content back.
+// Add or remove individual deliverables after creation
+await client.listings.addDeliverable(listing.id, Deliverable.text('Bonus: license key XXXX-XXXX'));
+await client.listings.removeDeliverable(listing.id, 'del_4hR9nK2mQ7tV5wX1');
 
-```typescript
 // External fulfillment — AI-generated content
-const listing = await client.listings.create({
+const external = await client.listings.create({
   name: 'Custom SEO Report',
   price: 4900,
   fulfillment: 'external',
@@ -369,12 +353,12 @@ const listing = await client.listings.create({
     { type: 'text', key: 'website_url', label: 'Your website URL', required: true },
   ],
 });
-await client.listings.publish(listing.id);
+await client.listings.publish(external.id);
 
 // On order.paid webhook:
 await client.orders.deliver(order.id, {
   deliverables: [
-    { type: 'text', value: generatedReport },
+    Deliverable.text(generatedReport),
   ],
 });
 ```
@@ -477,6 +461,8 @@ import {
   ListBee,
   CursorPage,
   ErrorCode,
+  Deliverable,     // input class: .file() | .url() | .text() | .fromToken()
+  PartialCreationError,  // thrown when listing is created but deliverable attachment fails
 
   // Response types
   type ListingResponse,

package/dist/cjs/deliverable.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Deliverable input builder — type-safe file handling for SDK methods.
+ */
+/// <reference types="node" />
+/// <reference types="node" />
+type FileSource = Buffer | Blob | string;
+/**
+ * Input builder for deliverables. Use static factory methods.
+ *
+ * @example
+ * ```ts
+ * Deliverable.file(Buffer.from('pdf'), 'guide.pdf')
+ * Deliverable.fromToken('file_tok_abc')
+ * Deliverable.url('https://example.com/secret')
+ * Deliverable.text('License key: ABCD-1234')
+ * ```
+ */
+export declare class Deliverable {
+    /** @internal */ readonly _type: 'file' | 'url' | 'text';
+    /** @internal */ readonly _fileData?: Buffer | Blob;
+    /** @internal */ readonly _filename?: string;
+    /** @internal */ readonly _value?: string;
+    /** @internal */ readonly _token?: string;
+    private constructor();
+    /**
+     * Create a file deliverable from a Buffer, Blob, or file path.
+     *
+     * @param source - File content or path.
+     * @param filename - Filename (required for Buffer/Blob, auto-detected for paths).
+     */
+    static file(source: FileSource, filename?: string): Deliverable;
+    /**
+     * Create a file deliverable from a pre-uploaded file token.
+     *
+     * @param token - File token from `client.files.upload()` (valid 24 hours).
+     */
+    static fromToken(token: string): Deliverable;
+    /**
+     * Create a URL redirect deliverable.
+     *
+     * @param url - HTTPS URL buyers will be redirected to after purchase.
+     */
+    static url(url: string): Deliverable;
+    /**
+     * Create a plain text deliverable.
+     *
+     * @param content - Text content delivered to the buyer.
+     */
+    static text(content: string): Deliverable;
+    /** True if this deliverable has file data that must be uploaded first. */
+    get needsUpload(): boolean;
+    /** @internal Returns file data for upload. */
+    toUploadData(): Buffer | Blob;
+    /** @internal Returns JSON body for the API. */
+    toApiBody(token?: string): Record<string, string>;
+}
+export {};

package/dist/cjs/deliverable.js

@@ -0,0 +1,90 @@
+"use strict";
+/**
+ * Deliverable input builder — type-safe file handling for SDK methods.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Deliverable = void 0;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+/**
+ * Input builder for deliverables. Use static factory methods.
+ *
+ * @example
+ * ```ts
+ * Deliverable.file(Buffer.from('pdf'), 'guide.pdf')
+ * Deliverable.fromToken('file_tok_abc')
+ * Deliverable.url('https://example.com/secret')
+ * Deliverable.text('License key: ABCD-1234')
+ * ```
+ */
+class Deliverable {
+    constructor(fields) {
+        this._type = fields._type;
+        this._fileData = fields._fileData;
+        this._filename = fields._filename;
+        this._value = fields._value;
+        this._token = fields._token;
+    }
+    /**
+     * Create a file deliverable from a Buffer, Blob, or file path.
+     *
+     * @param source - File content or path.
+     * @param filename - Filename (required for Buffer/Blob, auto-detected for paths).
+     */
+    static file(source, filename) {
+        if (typeof source === 'string') {
+            return new Deliverable({
+                _type: 'file',
+                _fileData: (0, node_fs_1.readFileSync)(source),
+                _filename: filename !== null && filename !== void 0 ? filename : (0, node_path_1.basename)(source),
+            });
+        }
+        if (!filename)
+            throw new Error('filename is required when source is Buffer or Blob');
+        return new Deliverable({
+            _type: 'file',
+            _fileData: source,
+            _filename: filename,
+        });
+    }
+    /**
+     * Create a file deliverable from a pre-uploaded file token.
+     *
+     * @param token - File token from `client.files.upload()` (valid 24 hours).
+     */
+    static fromToken(token) {
+        return new Deliverable({ _type: 'file', _token: token });
+    }
+    /**
+     * Create a URL redirect deliverable.
+     *
+     * @param url - HTTPS URL buyers will be redirected to after purchase.
+     */
+    static url(url) {
+        return new Deliverable({ _type: 'url', _value: url });
+    }
+    /**
+     * Create a plain text deliverable.
+     *
+     * @param content - Text content delivered to the buyer.
+     */
+    static text(content) {
+        return new Deliverable({ _type: 'text', _value: content });
+    }
+    /** True if this deliverable has file data that must be uploaded first. */
+    get needsUpload() {
+        return this._type === 'file' && this._fileData != null;
+    }
+    /** @internal Returns file data for upload. */
+    toUploadData() {
+        return this._fileData;
+    }
+    /** @internal Returns JSON body for the API. */
+    toApiBody(token) {
+        if (this._type === 'file')
+            return { type: 'file', token: token !== null && token !== void 0 ? token : this._token };
+        return { type: this._type, value: this._value };
+    }
+}
+exports.Deliverable = Deliverable;
+//# sourceMappingURL=deliverable.js.map

package/dist/cjs/deliverable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deliverable.js","sourceRoot":"","sources":["../../src/deliverable.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,qCAAuC;AACvC,yCAAqC;AAIrC;;;;;;;;;;GAUG;AACH,MAAa,WAAW;IAOtB,YAAoB,MAA2H;QAC7I,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QAC1B,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QAClC,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC;QAClC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAC9B,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,IAAI,CAAC,MAAkB,EAAE,QAAiB;QAC/C,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC/B,OAAO,IAAI,WAAW,CAAC;gBACrB,KAAK,EAAE,MAAM;gBACb,SAAS,EAAE,IAAA,sBAAY,EAAC,MAAM,CAAC;gBAC/B,SAAS,EAAE,QAAQ,aAAR,QAAQ,cAAR,QAAQ,GAAI,IAAA,oBAAQ,EAAC,MAAM,CAAC;aACxC,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QACrF,OAAO,IAAI,WAAW,CAAC;YACrB,KAAK,EAAE,MAAM;YACb,SAAS,EAAE,MAAM;YACjB,SAAS,EAAE,QAAQ;SACpB,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,SAAS,CAAC,KAAa;QAC5B,OAAO,IAAI,WAAW,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,GAAG,CAAC,GAAW;QACpB,OAAO,IAAI,WAAW,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IACxD,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,IAAI,CAAC,OAAe;QACzB,OAAO,IAAI,WAAW,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,0EAA0E;IAC1E,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,KAAK,KAAK,MAAM,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC;IACzD,CAAC;IAED,8CAA8C;IAC9C,YAAY;QACV,OAAO,IAAI,CAAC,SAAU,CAAC;IACzB,CAAC;IAED,+CAA+C;IAC/C,SAAS,CAAC,KAAc;QACtB,IAAI,IAAI,CAAC,KAAK,KAAK,MAAM;YAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,aAAL,KAAK,cAAL,KAAK,GAAI,IAAI,CAAC,MAAO,EAAE,CAAC;QACjF,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,MAAO,EAAE,CAAC;IACnD,CAAC;CACF;AA/ED,kCA+EC"}

package/dist/cjs/errors.d.ts

@@ -86,6 +86,17 @@ export declare class InternalServerError extends APIStatusError {
 export declare class WebhookVerificationError extends ListBeeError {
     constructor(message: string);
 }
+/**
+ * Raised when createComplete creates the listing but fails during file upload
+ * or deliverable attachment.
+ *
+ * The `listingId` property contains the draft that was created, so the caller
+ * can resume with individual `addDeliverable` calls.
+ */
+export declare class PartialCreationError extends ListBeeError {
+    readonly listingId: string;
+    constructor(listingId: string, message: string);
+}
 type ErrorBody = {
     type?: unknown;
     title?: unknown;

package/dist/cjs/errors.js

@@ -3,7 +3,7 @@
  * Typed exception hierarchy for the ListBee SDK (RFC 9457).
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.raiseForStatus = exports.WebhookVerificationError = exports.InternalServerError = exports.RateLimitError = exports.PayloadTooLargeError = exports.ValidationError = exports.ConflictError = exports.NotFoundError = exports.ForbiddenError = exports.AuthenticationError = exports.BadRequestError = exports.APIStatusError = exports.APITimeoutError = exports.APIConnectionError = exports.ListBeeError = void 0;
+exports.raiseForStatus = exports.PartialCreationError = exports.WebhookVerificationError = exports.InternalServerError = exports.RateLimitError = exports.PayloadTooLargeError = exports.ValidationError = exports.ConflictError = exports.NotFoundError = exports.ForbiddenError = exports.AuthenticationError = exports.BadRequestError = exports.APIStatusError = exports.APITimeoutError = exports.APIConnectionError = exports.ListBeeError = void 0;
 /** Base class for all ListBee SDK errors. */
 class ListBeeError extends Error {
     constructor(message) {
@@ -127,6 +127,21 @@ class WebhookVerificationError extends ListBeeError {
     }
 }
 exports.WebhookVerificationError = WebhookVerificationError;
+/**
+ * Raised when createComplete creates the listing but fails during file upload
+ * or deliverable attachment.
+ *
+ * The `listingId` property contains the draft that was created, so the caller
+ * can resume with individual `addDeliverable` calls.
+ */
+class PartialCreationError extends ListBeeError {
+    constructor(listingId, message) {
+        super(message);
+        this.name = 'PartialCreationError';
+        this.listingId = listingId;
+    }
+}
+exports.PartialCreationError = PartialCreationError;
 /**
  * Parse an RFC 9457 error body and throw the appropriate typed exception.
  */

package/dist/cjs/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,6CAA6C;AAC7C,MAAa,YAAa,SAAQ,KAAK;IACrC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AALD,oCAKC;AAED,wEAAwE;AACxE,MAAa,kBAAmB,SAAQ,YAAY;IAClD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AALD,gDAKC;AAED,uCAAuC;AACvC,MAAa,eAAgB,SAAQ,YAAY;IAC/C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AALD,0CAKC;AAED,+DAA+D;AAC/D,MAAa,cAAe,SAAQ,YAAY;IAc9C,YAAY,IAOX;;QACC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACxB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,KAAK,GAAG,MAAA,IAAI,CAAC,KAAK,mCAAI,IAAI,CAAC;IAClC,CAAC;CACF;AA/BD,wCA+BC;AAED,mEAAmE;AACnE,MAAa,eAAgB,SAAQ,cAAc;IACjD,YAAY,IAAqD;QAC/D,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AALD,0CAKC;AAED,4DAA4D;AAC5D,MAAa,mBAAoB,SAAQ,cAAc;IACrD,YAAY,IAAqD;QAC/D,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AALD,kDAKC;AAED,+CAA+C;AAC/C,MAAa,cAAe,SAAQ,cAAc;IAChD,YAAY,IAAqD;QAC/D,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AALD,wCAKC;AAED,oDAAoD;AACpD,MAAa,aAAc,SAAQ,cAAc;IAC/C,YAAY,IAAqD;QAC/D,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AALD,sCAKC;AAED,mDAAmD;AACnD,MAAa,aAAc,SAAQ,cAAc;IAC/C,YAAY,IAAqD;QAC/D,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AALD,sCAKC;AAED,2DAA2D;AAC3D,MAAa,eAAgB,SAAQ,cAAc;IACjD,YAAY,IAAqD;QAC/D,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AALD,0CAKC;AAED,2DAA2D;AAC3D,MAAa,oBAAqB,SAAQ,cAAc;IACtD,YAAY,IAAqD;QAC/D,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AALD,oDAKC;AAED,qDAAqD;AACrD,MAAa,cAAe,SAAQ,cAAc;IAQhD,YACE,IAIC;;QAED,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,KAAK,GAAG,MAAA,IAAI,CAAC,KAAK,mCAAI,IAAI,CAAC;QAChC,IAAI,CAAC,SAAS,GAAG,MAAA,IAAI,CAAC,SAAS,mCAAI,IAAI,CAAC;QACxC,IAAI,CAAC,KAAK,GAAG,MAAA,IAAI,CAAC,KAAK,mCAAI,IAAI,CAAC;IAClC,CAAC;CACF;AArBD,wCAqBC;AAED,oDAAoD;AACpD,MAAa,mBAAoB,SAAQ,cAAc;IACrD,YAAY,IAAqD;QAC/D,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AALD,kDAKC;AAED,wDAAwD;AACxD,MAAa,wBAAyB,SAAQ,YAAY;IACxD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AALD,4DAKC;AAED;;;;;;GAMG;AACH,MAAa,oBAAqB,SAAQ,YAAY;IAGpD,YAAY,SAAiB,EAAE,OAAe;QAC5C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;CACF;AARD,oDAQC;AAWD;;GAEG;AACH,SAAgB,cAAc,CAAC,UAAkB,EAAE,IAAe,EAAE,OAA+B;IACjG,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5D,MAAM,KAAK,GAAG,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/D,MAAM,MAAM,GAAG,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC;IAC1E,MAAM,MAAM,GAAG,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAClE,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5D,MAAM,KAAK,GAAG,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAEjE,MAAM,IAAI,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAE1D,IAAI,UAAU,KAAK,GAAG;QAAE,MAAM,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC;IACxD,IAAI,UAAU,KAAK,GAAG;QAAE,MAAM,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAC5D,IAAI,UAAU,KAAK,GAAG;QAAE,MAAM,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;IACvD,IAAI,UAAU,KAAK,GAAG;QAAE,MAAM,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC;IACtD,IAAI,UAAU,KAAK,GAAG;QAAE,MAAM,IAAI,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAC7D,IAAI,UAAU,KAAK,GAAG;QAAE,MAAM,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC;IACtD,IAAI,UAAU,KAAK,GAAG;QAAE,MAAM,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC;IACxD,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;QACvB,MAAM,QAAQ,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;QAC9C,MAAM,YAAY,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;QACtD,MAAM,QAAQ,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAAC;QAC9C,MAAM,IAAI,cAAc,CAAC;YACvB,GAAG,IAAI;YACP,KAAK,EAAE,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI;YACvD,SAAS,EAAE,YAAY,IAAI,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI;YACnE,KAAK,EAAE,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI;SACtD,CAAC,CAAC;IACL,CAAC;IACD,IAAI,UAAU,IAAI,GAAG;QAAE,MAAM,IAAI,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAE3D,MAAM,IAAI,cAAc,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC;AA/BD,wCA+BC"}

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

@@ -224,7 +224,11 @@ export interface paths {
          * @description Replace all deliverables on a draft listing. Accepts an array of up to 3 deliverables (file, url, text). File tokens must be obtained via POST /v1/files first. Old file deliverables are automatically cleaned up from storage.
          */
         put: operations["set_deliverables"];
-        post?: never;
+        /**
+         * Add deliverable
+         * @description Add a single deliverable to a draft listing. Appends to the existing array. Returns the new deliverable with a unique del_ prefixed ID. Max 3 deliverables per listing — returns 409 if at capacity.
+         */
+        post: operations["add_deliverable"];
         /**
          * Remove deliverables
          * @description Remove all deliverables from a draft listing. Demotes the listing to external fulfillment. Draft only — returns 409 if the listing is published.
@@ -235,6 +239,26 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/listings/{listing_id}/deliverables/{deliverable_id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /**
+         * Remove deliverable
+         * @description Remove a single deliverable by its del_ ID from a draft listing. If the deliverable is a file, the CDN content is cleaned up.
+         */
+        delete: operations["remove_deliverable"];
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/listings/{listing_id}/publish": {
         parameters: {
             query?: never;
@@ -697,6 +721,29 @@ export interface components {
                 [key: string]: unknown;
             } | null;
         };
+        /**
+         * AddDeliverableRequest
+         * @description Add a single deliverable to a listing.
+         */
+        AddDeliverableRequest: {
+            /**
+             * @description Deliverable type: `file` (uploaded via POST /v1/files), `url` (redirect), or `text` (literal string).
+             * @example file
+             */
+            type: components["schemas"]["DeliverableType"];
+            /**
+             * Token
+             * @description File token from POST /v1/files. Required when type is `file`.
+             * @example file_7kQ2xY9mN3pR5tW1vB8a01
+             */
+            token?: string | null;
+            /**
+             * Value
+             * @description URL (https required) or text content. Required when type is `url` or `text`.
+             * @example https://example.com/secret-area
+             */
+            value?: string | null;
+        };
         /** ApiKeyListResponse */
         ApiKeyListResponse: {
             /**
@@ -1219,6 +1266,12 @@ export interface components {
              * @constant
              */
             object: "deliverable";
+            /**
+             * Id
+             * @description Unique deliverable identifier (del_ prefixed).
+             * @example del_7kQ2xY9mN3pR5tW1vB8a01
+             */
+            id: string;
             /**
              * @description Deliverable type.
              * @example file
@@ -2363,7 +2416,7 @@ export interface components {
          * WebhookEventType
          * @enum {string}
          */
-        WebhookEventType: "order.paid" | "order.fulfilled" | "order.shipped" | "order.refunded" | "order.disputed" | "order.dispute_closed" | "order.canceled" | "listing.created" | "listing.updated" | "listing.out_of_stock" | "listing.deleted" | "customer.created";
+        WebhookEventType: "order.paid" | "order.fulfilled" | "order.shipped" | "order.refunded" | "order.disputed" | "order.dispute_closed" | "order.canceled" | "listing.created" | "listing.updated" | "listing.published" | "listing.out_of_stock" | "listing.deleted" | "customer.created";
         /** WebhookListResponse */
         WebhookListResponse: {
             /**
@@ -3297,6 +3350,69 @@ export interface operations {
             };
         };
     };
+    add_deliverable: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Listing ID. */
+                listing_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["AddDeliverableRequest"];
+            };
+        };
+        responses: {
+            /** @description Successful Response */
+            201: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["DeliverableResponse"];
+                };
+            };
+            /** @description Invalid or missing API key. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Listing not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Listing not in draft, or at max capacity. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Validation error. */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+        };
+    };
     remove_deliverables: {
         parameters: {
             query?: never;
@@ -3356,6 +3472,65 @@ export interface operations {
             };
         };
     };
+    remove_deliverable: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                /** @description Listing ID. */
+                listing_id: string;
+                /** @description Deliverable ID. */
+                deliverable_id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description Successful Response */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Invalid or missing API key. */
+            401: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Listing or deliverable not found. */
+            404: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Listing is not in draft status. */
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ProblemDetail"];
+                };
+            };
+            /** @description Validation Error */
+            422: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["HTTPValidationError"];
+                };
+            };
+        };
+    };
     publish_listing: {
         parameters: {
             query?: never;