listbee 0.5.0 → 0.6.0

package/README.md

@@ -2,6 +2,13 @@
 
 Official TypeScript SDK for the [ListBee API](https://listbee.so) — one API call to sell and deliver digital content.
 
+- Zero runtime dependencies (native fetch, Node >= 18)
+- Types generated from OpenAPI spec — zero drift
+- Full error hierarchy (RFC 9457)
+- Cursor-based pagination
+- Retry with exponential backoff
+- Idempotency support
+
 ## Install
 
 ```bash
@@ -19,42 +26,29 @@ import { ListBee } from 'listbee';
 
 const client = new ListBee({ apiKey: 'lb_...' });
 
-// Managed fulfillment — ListBee delivers a file automatically
+// Create a listing, set a deliverable, publish
 const listing = await client.listings.create({
   name: 'SEO Playbook',
-  price: 2900,
-  content: 'https://example.com/seo-playbook.pdf',
+  price: 2900, // $29.00 in cents
+  description: 'A comprehensive guide to modern SEO.',
 });
-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 },
-  ],
+await client.listings.setDeliverables(listing.id, {
+  url: 'https://example.com/seo-playbook.pdf',
 });
+
+const published = await client.listings.publish(listing.id);
+console.log(published.url); // https://buy.listbee.so/r7kq2xy9
 ```
 
-Using an environment variable instead:
+Or read from the environment:
 
 ```bash
 export LISTBEE_API_KEY="lb_..."
 ```
 
 ```typescript
-import { ListBee } from 'listbee';
-
 const client = new ListBee(); // reads LISTBEE_API_KEY automatically
-
-const listing = await client.listings.create({
-  name: 'SEO Playbook',
-  price: 2900,
-  content: 'https://example.com/seo-playbook.pdf',
-});
-console.log(listing.url);
 ```
 
 ## Authentication
@@ -62,145 +56,138 @@ console.log(listing.url);
 Pass your API key explicitly or via the `LISTBEE_API_KEY` environment variable.
 
 ```typescript
-import { ListBee } from 'listbee';
-
-// Explicit key
 const client = new ListBee({ apiKey: 'lb_...' });
-
-// Environment variable (LISTBEE_API_KEY)
-const client = new ListBee();
-
-// process.env lookup
-const client = new ListBee({ apiKey: process.env.LISTBEE_API_KEY });
+const client = new ListBee(); // env var
 ```
 
-The key is validated lazily — the client constructs successfully even with a missing or invalid key. An `AuthenticationError` is raised only when you make the first API call.
-
-API keys start with `lb_`. Get yours at [listbee.so](https://listbee.so).
+The key is validated lazily — an `AuthenticationError` is raised only when you make the first API call. API keys start with `lb_`. Get yours at [listbee.so](https://listbee.so).
 
 ## Resources
 
+| Resource | Methods |
+|----------|---------|
+| `listings` | `create`, `get`, `list`, `update`, `publish`, `setDeliverables`, `removeDeliverables`, `delete` |
+| `orders` | `get`, `list`, `deliver`, `refund` |
+| `customers` | `get`, `list` |
+| `files` | `upload` |
+| `webhooks` | `create`, `get`, `list`, `update`, `delete`, `listEvents`, `retryEvent`, `test`, `verify` |
+| `account` | `get`, `update`, `delete` |
+| `apiKeys` | `list`, `create`, `delete` |
+| `signup` | `create`, `verify` |
+| `stripe` | `connect`, `disconnect` |
+
 ### Listings
 
 ```typescript
-import { ListBee } from 'listbee';
-
-const client = new ListBee({ apiKey: 'lb_...' });
-
-// 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
+// Create
 const listing = await client.listings.create({
   name: 'SEO Playbook 2026',
   price: 2900,
-  content: 'https://example.com/seo-playbook.pdf',
   description: 'A comprehensive guide to modern SEO techniques.',
   tagline: 'Updated for 2026 algorithm changes',
   highlights: ['50+ pages', 'Actionable tips', 'Free updates'],
-  cta: 'Get Instant Access',          // buy button text; defaults to "Buy Now"
+  cta: 'Get Instant Access',
   cover_url: 'https://example.com/cover.png',
-  compare_at_price: 3900,             // strikethrough price
-  badges: ['Limited time', 'Best seller'],
-  cover_blur: 'auto',                 // "auto" | "true" | "false"
-  rating: 4.8,
-  rating_count: 1243,
-  reviews: [
-    { name: 'Clara D.', rating: 5.0, content: 'Excellent quality content.' },
-  ],
-  faqs: [
-    { q: 'Is this for beginners?', a: 'Yes, completely beginner-friendly.' },
-  ],
+  compare_at_price: 3900,
   metadata: { source: 'n8n', campaign: 'launch-week' },
 });
-console.log(listing.id);  // lst_r7kq2xy9m3pR5tW1
-console.log(listing.url); // https://buy.listbee.so/m3pr5tw1
+console.log(listing.id); // lst_r7kq2xy9m3pR5tW1
 
-// Get by slug
-const listing = await client.listings.get('m3pr5tw1');
+// Set deliverables (file, URL, or text)
+await client.listings.setDeliverables(listing.id, {
+  url: 'https://example.com/seo-playbook.pdf',
+});
 
-// List — paginated
-const page = await client.listings.list({ limit: 20 });
-for (const listing of page.data) {
-  console.log(listing.slug, listing.name);
-}
+// Publish
+const published = await client.listings.publish(listing.id);
+console.log(published.url); // https://buy.listbee.so/r7kq2xy9
 
-// Update — partial updates
-const updated = await client.listings.update('r7kq2xy9', {
-  name: 'SEO Playbook 2026 Updated',
-  price: 3900,
+// Get by ID
+const listing = await client.listings.get('lst_r7kq2xy9m3pR5tW1');
+
+// List — with filters
+const page = await client.listings.list({
+  status: 'published',
+  limit: 20,
 });
+for (const l of page.data) {
+  console.log(l.id, l.name, l.status);
+}
+console.log(page.total_count); // total matching listings
 
-// Pause / Resume
-await client.listings.pause('r7kq2xy9');
-await client.listings.resume('r7kq2xy9');
+// Update
+await client.listings.update('lst_r7kq2xy9m3pR5tW1', { price: 3900 });
+
+// Remove deliverables (revert to external fulfillment)
+await client.listings.removeDeliverables('lst_r7kq2xy9m3pR5tW1');
 
 // Delete
-await client.listings.delete('m3pr5tw1');
+await client.listings.delete('lst_r7kq2xy9m3pR5tW1');
 ```
 
 ### Orders
 
 ```typescript
-// List all orders
-const page = await client.orders.list();
-for (const order of page.data) {
-  console.log(order.id, order.status);
-}
-
-// Filter by status, listing, date range
+// List — with filters
 const page = await client.orders.list({
   status: 'paid',
-  listing: 'seo-playbook',
+  buyer_email: 'buyer@example.com',
   created_after: new Date('2026-03-01'),
-  created_before: '2026-03-31T23:59:59Z', // Date objects or ISO strings
+  created_before: '2026-03-31T23:59:59Z',
 });
+console.log(page.total_count);
 
 // 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.',
+console.log(order.status);       // "pending" | "paid" | "fulfilled" | "canceled" | "failed"
+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)
+const fulfilled = await client.orders.deliver('ord_9xM4kP7nR2qT5wY1', {
+  content: 'Your AI-generated report is ready.',
   content_type: 'text',
 });
-console.log(fulfilled.status);            // "fulfilled"
-console.log(fulfilled.fulfillment_status); // "fulfilled"
+console.log(fulfilled.status); // "fulfilled"
 
-// Fulfill with a URL
-await client.orders.fulfill('ord_9xM4kP7nR2qT5wY1', {
+// Or with a URL
+await client.orders.deliver('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',
+// Refund
+const refunded = await client.orders.refund('ord_9xM4kP7nR2qT5wY1');
+console.log(refunded.status); // "canceled"
+```
+
+### Customers
+
+```typescript
+// List customers
+const page = await client.customers.list({ limit: 20, email: 'buyer@example.com' });
+for (const c of page.data) {
+  console.log(c.id, c.email);
+}
+
+// Get a customer
+const customer = await client.customers.get('cus_7kQ2xY9mN3pR5tW1');
+console.log(customer.email, customer.order_count);
+```
+
+### Files
+
+```typescript
+import { createReadStream } from 'fs';
+
+// Upload a file (multipart, native FormData)
+const file = await client.files.upload({
+  file: createReadStream('/path/to/report.pdf'),
+  filename: 'report.pdf',
 });
-console.log(shipped.fulfillment_status); // "shipped"
-console.log(shipped.carrier);           // "UPS"
+console.log(file.id);  // use this ID in setDeliverables
+
+// Then attach to a listing
+await client.listings.setDeliverables(listing.id, { file_id: file.id });
 ```
 
 ### Webhooks
@@ -217,46 +204,28 @@ const webhook = await client.webhooks.create({
   events: [
     WebhookEventType.ORDER_PAID,
     WebhookEventType.ORDER_FULFILLED,
-    WebhookEventType.ORDER_SHIPPED,
+    WebhookEventType.CUSTOMER_CREATED,
   ],
 });
 console.log(webhook.id);     // wh_3mK8nP2qR5tW7xY1
-console.log(webhook.secret); // HMAC signing key
+console.log(webhook.secret); // HMAC signing key — save this
 
-// Create — receive all events (omit events param)
-const webhook = await client.webhooks.create({
-  name: 'Catch-all',
-  url: 'https://example.com/webhooks/listbee-all',
-});
-
-// List
-const webhooks = await client.webhooks.list();
-for (const wh of webhooks) {
-  console.log(wh.id, wh.name, wh.enabled);
-}
-
-// Update — disable without deleting
-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_PAID],
+// Verify an incoming webhook (HMAC-SHA256, uses crypto.subtle — no dependencies)
+const isValid = await client.webhooks.verify({
+  payload: rawBodyString,
+  signature: req.headers['listbee-signature'],
+  secret: webhook.secret,
 });
 
 // List delivery events
-const events = await client.webhooks.listEvents('wh_3mK8nP2qR5tW7xY1', {
-  status: 'failed',
-});
-for (const evt of events.data) {
-  console.log(evt.event_type, evt.status, evt.last_error);
-}
+const events = await client.webhooks.listEvents('wh_3mK8nP2qR5tW7xY1', { status: 'failed' });
 
-// Test endpoint
-const test = await client.webhooks.test('wh_3mK8nP2qR5tW7xY1');
-console.log(test.success, test.status_code);
+// Retry a failed event
+await client.webhooks.retryEvent('wh_3mK8nP2qR5tW7xY1', 'evt_abc123');
 
-// Delete
+// Update, test, delete
+await client.webhooks.update('wh_3mK8nP2qR5tW7xY1', { enabled: false });
+await client.webhooks.test('wh_3mK8nP2qR5tW7xY1');
 await client.webhooks.delete('wh_3mK8nP2qR5tW7xY1');
 ```
 
@@ -265,15 +234,12 @@ await client.webhooks.delete('wh_3mK8nP2qR5tW7xY1');
 ```typescript
 const account = await client.account.get();
 console.log(account.id);    // acc_7kQ2xY9mN3pR5tW1
-console.log(account.email); // seller@example.com
+console.log(account.email);
 console.log(account.plan);  // free | growth | scale
 console.log(account.readiness.operational);
 
-// Update Google Analytics tracking
 await client.account.update({ ga_measurement_id: 'G-XXXXXXXXXX' });
-
-// Clear GA tracking
-await client.account.update({ ga_measurement_id: null });
+await client.account.delete();
 ```
 
 ### Signup
@@ -281,93 +247,28 @@ await client.account.update({ ga_measurement_id: null });
 Agent self-service onboarding — no API key required:
 
 ```typescript
-import { ListBee } from 'listbee';
-
 const client = new ListBee(); // no API key needed
 
-// Request a signup code
 await client.signup.create({ email: 'seller@example.com' });
 
-// Verify the code — returns account + API key
-const result = await client.signup.verify({
-  email: 'seller@example.com',
-  code: '123456',
-});
+const result = await client.signup.verify({ email: 'seller@example.com', code: '123456' });
 console.log(result.api_key); // lb_... (one-time display)
 ```
 
 ### API keys
 
 ```typescript
-// List all API keys
 const keys = await client.apiKeys.list();
-for (const key of keys) {
-  console.log(key.id, key.name);
-}
 
-// Create a new key — the key value is only shown once
 const newKey = await client.apiKeys.create({ name: 'CI pipeline' });
 console.log(newKey.key); // lb_... (save this immediately)
 
-// Delete a key
 await client.apiKeys.delete('lbk_7kQ2xY9mN3pR5tW1');
 ```
 
-### Stores
-
-```typescript
-// Create a store
-const store = await client.stores.create({ handle: 'fitness-brand', name: 'Fitness Brand' });
-console.log(store.id);     // str_7kQ2xY9mN3pR5tW1vB8a
-console.log(store.handle); // fitness-brand
-
-// List all stores
-const stores = await client.stores.list();
-for (const s of stores.data) {
-  console.log(s.handle, s.display_name);
-}
-
-// Get a store
-const store = await client.stores.get('str_7kQ2xY9mN3pR5tW1vB8a');
-
-// Update a store
-const updated = await client.stores.update('str_7kQ2xY9mN3pR5tW1vB8a', {
-  name: 'Fitness Pro',
-  bio: 'Premium fitness content',
-  social_links: ['https://twitter.com/fitnesspro'],
-});
-
-// Delete a store
-await client.stores.delete('str_7kQ2xY9mN3pR5tW1vB8a');
-
-// Connect Stripe — returns a URL to redirect the user to
-const session = await client.stores.connectStripe('str_7kQ2xY9mN3pR5tW1vB8a');
-console.log(session.url); // redirect seller here
-
-// Custom domains
-const domain = await client.stores.setDomain('str_7kQ2xY9mN3pR5tW1vB8a', { domain: 'fitness.com' });
-console.log(domain.cname_target); // buy.listbee.so — point your CNAME here
-
-const verified = await client.stores.verifyDomain('str_7kQ2xY9mN3pR5tW1vB8a');
-console.log(verified.status); // "verified" or "pending"
-
-await client.stores.removeDomain('str_7kQ2xY9mN3pR5tW1vB8a');
-
-// Create a listing in a specific store
-const listing = await client.listings.create({
-  name: 'SEO Playbook',
-  price: 2900,
-  content: 'https://example.com/seo-playbook.pdf',
-  store_id: 'str_7kQ2xY9mN3pR5tW1vB8a',
-});
-```
-
 ### Stripe
 
 ```typescript
-// Set your Stripe secret key
-await client.stripe.setKey({ secretKey: 'sk_live_...' });
-
 // Generate a Stripe Connect onboarding link
 const connect = await client.stripe.connect();
 console.log(connect.url); // redirect seller here
@@ -378,75 +279,67 @@ 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.
+- **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
-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',
+// External fulfillment — AI-generated content
+const listing = 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 },
+  ],
 });
+await client.listings.publish(listing.id);
 
-// Or ship physical goods
-await client.orders.ship('ord_...', {
-  carrier: 'FedEx',
-  tracking_code: '7489274892',
+// On order.paid webhook:
+await client.orders.deliver(order.id, {
+  content: generatedReport,
+  content_type: 'text',
 });
 ```
 
 ## Readiness system
 
-Every listing and account includes a `readiness` field that tells you whether it can currently accept payments.
-
-- `listing.readiness.sellable` — `true` when buyers can complete a purchase
-- `account.readiness.operational` — `true` when the account can sell
-
-When `false`, an `actions` array explains what's needed and how to resolve each item. The `next` field points to the highest-priority action (prefers `kind: api`).
+Every listing and account includes a `readiness` field.
 
 ```typescript
-import { ActionKind } from 'listbee';
-
 const account = await client.account.get();
 if (!account.readiness.operational) {
   for (const action of account.readiness.actions) {
-    if (action.kind === ActionKind.API) {
+    if (action.kind === 'api') {
       console.log(`API action: ${action.code} -> ${action.resolve.endpoint}`);
     } else {
       console.log(`Manual step: ${action.code} -> ${action.resolve.url}`);
     }
   }
-  console.log(`Next action: ${account.readiness.next}`);
 }
 ```
 
-## Pagination
+## Idempotency
+
+Pass `idempotencyKey` to any mutating request. Same key within 24h returns the cached response:
+
+```typescript
+await client.listings.create(
+  { name: 'SEO Playbook', price: 2900 },
+  { idempotencyKey: 'create-listing-campaign-2026' },
+);
+```
 
-`listings.list()` and `orders.list()` return a `CursorPage` with cursor-based pagination.
+## Pagination
 
 ```typescript
-// First page
 const page = await client.listings.list({ limit: 10 });
-console.log(page.data);     // ListingResponse[]
-console.log(page.has_more); // true if more pages exist
-console.log(page.cursor);   // cursor string for the next page
+console.log(page.data);        // ListingResponse[]
+console.log(page.has_more);    // true if more pages exist
+console.log(page.cursor);      // pass to next call
+console.log(page.total_count); // total matching items
 
-// Fetch next page
 if (page.has_more) {
   const nextPage = await client.listings.list({ limit: 10, cursor: page.cursor });
-  console.log(nextPage.data);
 }
 ```
 
@@ -454,186 +347,99 @@ if (page.has_more) {
 
 ```
 ListBeeError
-├── APIConnectionError   // network error — request never reached the server
-├── APITimeoutError      // request timed out
-└── APIStatusError       // server returned 4xx/5xx
-    ├── AuthenticationError    // 401 — invalid or missing API key
-    ├── NotFoundError          // 404 — resource not found
-    ├── ConflictError          // 409 — resource conflict
-    ├── ValidationError        // 422 — request validation failed
-    ├── RateLimitError         // 429 — rate limit exceeded
-    └── InternalServerError    // 500+ — server-side error
+├── APIConnectionError      network error — request never reached the server
+├── APITimeoutError         request timed out
+└── APIStatusError          server returned 4xx/5xx
+    ├── BadRequestError          400
+    ├── AuthenticationError      401
+    ├── ForbiddenError           403
+    ├── NotFoundError            404
+    ├── ConflictError            409
+    ├── PayloadTooLargeError     413
+    ├── ValidationError          422
+    ├── RateLimitError           429
+    └── InternalServerError      500+
 ```
 
-Catch specific errors:
-
 ```typescript
-import {
-  ListBee,
-  AuthenticationError,
-  NotFoundError,
-  RateLimitError,
-  ValidationError,
-  APIConnectionError,
-  APITimeoutError,
-  APIStatusError,
-} from 'listbee';
-
-const client = new ListBee({ apiKey: 'lb_...' });
+import { NotFoundError, AuthenticationError, RateLimitError, ErrorCode } from 'listbee';
 
 try {
-  const listing = await client.listings.get('does-not-exist');
+  await client.listings.get('lst_does-not-exist');
 } catch (e) {
   if (e instanceof NotFoundError) {
     console.log(e.status); // 404
-    console.log(e.code);   // machine-readable code
+    console.log(e.code);   // ErrorCode value
     console.log(e.detail); // human-readable explanation
-  } else if (e instanceof AuthenticationError) {
-    console.log('Invalid API key');
   } else if (e instanceof RateLimitError) {
-    console.log(`Rate limited. Resets at ${e.reset}, ${e.remaining}/${e.limit} remaining`);
-  } else if (e instanceof ValidationError) {
-    console.log(`Bad request — field: ${e.param}, detail: ${e.detail}`);
-  } else if (e instanceof APIConnectionError) {
-    console.log('Network error — check your connection');
-  } else if (e instanceof APITimeoutError) {
-    console.log('Request timed out');
-  } else if (e instanceof APIStatusError) {
-    console.log(`API error ${e.status}: ${e.detail}`);
+    console.log(`Rate limited. Resets at ${e.reset}`);
   }
 }
 ```
 
-Error responses follow [RFC 9457](https://www.rfc-editor.org/rfc/rfc9457) (Problem Details). All `APIStatusError` subclasses expose:
-
-| Attribute | Type | Description |
-|-----------|------|-------------|
-| `status` | `number` | HTTP status code |
-| `code` | `string` | Machine-readable error code |
-| `detail` | `string` | Specific explanation |
-| `title` | `string` | Short, stable error category label |
-| `type` | `string` | URI identifying the error type |
-| `param` | `string \| null` | Request field that caused the error |
-
-`RateLimitError` additionally exposes `limit`, `remaining`, and `reset` (parsed from response headers).
+All `APIStatusError` subclasses expose: `status`, `code` (`ErrorCode`), `detail`, `title`, `type`, `param`.
 
 ## Configuration
 
 ```typescript
-import { ListBee } from 'listbee';
-
 const client = new ListBee({
   apiKey: 'lb_...',
-  timeoutMs: 60_000,    // default: 30000
+  timeoutMs: 60_000,   // default: 30000
   maxRetries: 5,        // default: 3; retries on 429/500/502/503/504
-  baseUrl: 'https://api.listbee.so', // default; override for testing
-});
-```
-
-`listings.create()` uses a default timeout of **120 seconds** because cover image processing can take longer. Pass `timeoutMs` to override:
-
-```typescript
-const listing = await client.listings.create({
-  name: 'Quick listing',
-  price: 999,
-  content: 'https://example.com/file.pdf',
-  timeoutMs: 30_000, // override the 120s default for this call
+  baseUrl: 'https://api.listbee.so', // override for testing
 });
 ```
 
-## Types and enums
+## Types
 
-All types are importable directly from `listbee`:
+All types are importable from `listbee`:
 
 ```typescript
 import {
-  // Client
   ListBee,
   CursorPage,
+  ErrorCode,
 
   // Response types
   type ListingResponse,
   type OrderResponse,
+  type CustomerResponse,
+  type FileResponse,
   type WebhookResponse,
   type AccountResponse,
   type ApiKeyResponse,
   type SignupResponse,
   type VerifyResponse,
-  type StripeConnectSessionResponse,
-  type StoreResponse,
-  type StoreListResponse,
-  type DomainResponse,
   type WebhookEventResponse,
   type WebhookTestResponse,
   type CheckoutField,
-  type ShippingAddress,
-
-  // Param types
-  type FulfillOrderParams,
-  type ShipOrderParams,
-
-  // Enums (runtime values)
-  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,
+  // Enums
+  DeliverableType,   // "file" | "url" | "text"
+  FulfillmentMode,   // "managed" | "external"
+  ListingStatus,     // "draft" | "published"
+  OrderStatus,       // "pending" | "paid" | "fulfilled" | "canceled" | "failed"
+  WebhookEventType,
+  ActionCode,
+  ActionKind,
 
   // Errors
   ListBeeError,
   APIStatusError,
   APIConnectionError,
   APITimeoutError,
+  BadRequestError,
   AuthenticationError,
+  ForbiddenError,
   NotFoundError,
   ConflictError,
+  PayloadTooLargeError,
   ValidationError,
   RateLimitError,
   InternalServerError,
 } from 'listbee';
 ```
 
-Enums are `as const` objects — use them to avoid magic strings:
-
-```typescript
-import { DeliverableType, WebhookEventType, FulfillmentMode } from 'listbee';
-
-// 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_PAID,
-    WebhookEventType.ORDER_FULFILLED,
-  ],
-});
-```
-
-## Tree-shaking
-
-Import individual resources for smaller bundles:
-
-```typescript
-import { WebhooksResource } from 'listbee/webhooks';
-import { OrdersResource } from 'listbee/orders';
-```
-
 ## Requirements
 
 - Node.js >= 18