listbee-mcp 0.2.0 → 0.4.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +76 -12
- package/dist/generated/meta.d.ts.map +1 -1
- package/dist/generated/meta.js +119 -5
- package/dist/generated/meta.js.map +1 -1
- package/dist/generated/schemas.d.ts +209 -13
- package/dist/generated/schemas.d.ts.map +1 -1
- package/dist/generated/schemas.js +24 -5
- package/dist/generated/schemas.js.map +1 -1
- package/dist/handlers/stripe-connect.d.ts +9 -0
- package/dist/handlers/stripe-connect.d.ts.map +1 -0
- package/dist/{tools/stripe.js → handlers/stripe-connect.js} +8 -4
- package/dist/handlers/stripe-connect.js.map +1 -0
- package/dist/handlers/upload-file.d.ts +7 -0
- package/dist/handlers/upload-file.d.ts.map +1 -0
- package/dist/handlers/upload-file.js +38 -0
- package/dist/handlers/upload-file.js.map +1 -0
- package/dist/handlers.d.ts +4 -0
- package/dist/handlers.d.ts.map +1 -0
- package/dist/handlers.js +41 -0
- package/dist/handlers.js.map +1 -0
- package/dist/server.d.ts.map +1 -1
- package/dist/server.js +31 -33
- package/dist/server.js.map +1 -1
- package/dist/transports/http.d.ts.map +1 -1
- package/dist/transports/http.js +25 -1
- package/dist/transports/http.js.map +1 -1
- package/dist/types.d.ts +1 -8
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js +18 -18
- package/dist/types.js.map +1 -1
- package/dist/{tools/shared.d.ts → utils.d.ts} +2 -2
- package/dist/utils.d.ts.map +1 -0
- package/dist/{tools/shared.js → utils.js} +1 -1
- package/dist/utils.js.map +1 -0
- package/mcp-tools.yaml +255 -1
- package/package.json +7 -1
- package/dist/client.d.ts +0 -18
- package/dist/client.d.ts.map +0 -1
- package/dist/client.js +0 -61
- package/dist/client.js.map +0 -1
- package/dist/tools/files.d.ts +0 -7
- package/dist/tools/files.d.ts.map +0 -1
- package/dist/tools/files.js +0 -34
- package/dist/tools/files.js.map +0 -1
- package/dist/tools/listings.d.ts +0 -44
- package/dist/tools/listings.d.ts.map +0 -1
- package/dist/tools/listings.js +0 -83
- package/dist/tools/listings.js.map +0 -1
- package/dist/tools/orders.d.ts +0 -16
- package/dist/tools/orders.d.ts.map +0 -1
- package/dist/tools/orders.js +0 -41
- package/dist/tools/orders.js.map +0 -1
- package/dist/tools/shared.d.ts.map +0 -1
- package/dist/tools/shared.js.map +0 -1
- package/dist/tools/stripe.d.ts +0 -4
- package/dist/tools/stripe.d.ts.map +0 -1
- package/dist/tools/stripe.js.map +0 -1
package/README.md
CHANGED
|
@@ -1,9 +1,19 @@
|
|
|
1
1
|
# listbee-mcp
|
|
2
2
|
|
|
3
|
+
[](https://insiders.vscode.dev/redirect/mcp/install?name=listbee&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22listbee-mcp%22%5D%2C%22env%22%3A%7B%22LISTBEE_API_KEY%22%3A%22%24%7Binput%3AapiKey%7D%22%7D%7D)
|
|
4
|
+
|
|
3
5
|
MCP server for ListBee — commerce API for AI agents.
|
|
4
6
|
|
|
5
7
|
---
|
|
6
8
|
|
|
9
|
+
## Connect
|
|
10
|
+
|
|
11
|
+
**Remote (zero install):** `https://api.listbee.so/mcp` — for ChatGPT Apps, Claude API Connector, remote agents. Each request needs `Authorization: Bearer lb_...` header.
|
|
12
|
+
|
|
13
|
+
**Local (stdio):** `npx -y listbee-mcp` — for Claude Desktop, Cursor, VS Code, Cline.
|
|
14
|
+
|
|
15
|
+
---
|
|
16
|
+
|
|
7
17
|
## Golden Path
|
|
8
18
|
|
|
9
19
|
Four calls to go from zero to a live, selling product page:
|
|
@@ -31,6 +41,8 @@ create_listing → set_deliverables → get_listing → publish_listing
|
|
|
31
41
|
|
|
32
42
|
## Install
|
|
33
43
|
|
|
44
|
+
Requires Node.js 20+.
|
|
45
|
+
|
|
34
46
|
### Claude Desktop
|
|
35
47
|
|
|
36
48
|
`~/.claude/claude_desktop_config.json`
|
|
@@ -40,7 +52,7 @@ create_listing → set_deliverables → get_listing → publish_listing
|
|
|
40
52
|
"mcpServers": {
|
|
41
53
|
"listbee": {
|
|
42
54
|
"command": "npx",
|
|
43
|
-
"args": ["listbee-mcp", "--api-key", "lb_..."]
|
|
55
|
+
"args": ["-y", "listbee-mcp", "--api-key", "lb_..."]
|
|
44
56
|
}
|
|
45
57
|
}
|
|
46
58
|
}
|
|
@@ -53,7 +65,7 @@ Or with an env var:
|
|
|
53
65
|
"mcpServers": {
|
|
54
66
|
"listbee": {
|
|
55
67
|
"command": "npx",
|
|
56
|
-
"args": ["listbee-mcp"],
|
|
68
|
+
"args": ["-y", "listbee-mcp"],
|
|
57
69
|
"env": {
|
|
58
70
|
"LISTBEE_API_KEY": "lb_..."
|
|
59
71
|
}
|
|
@@ -71,7 +83,7 @@ Or with an env var:
|
|
|
71
83
|
"mcpServers": {
|
|
72
84
|
"listbee": {
|
|
73
85
|
"command": "npx",
|
|
74
|
-
"args": ["listbee-mcp", "--api-key", "lb_..."]
|
|
86
|
+
"args": ["-y", "listbee-mcp", "--api-key", "lb_..."]
|
|
75
87
|
}
|
|
76
88
|
}
|
|
77
89
|
}
|
|
@@ -80,13 +92,13 @@ Or with an env var:
|
|
|
80
92
|
### Claude Code
|
|
81
93
|
|
|
82
94
|
```bash
|
|
83
|
-
claude mcp add listbee -- npx listbee-mcp --api-key lb_...
|
|
95
|
+
claude mcp add listbee -- npx -y listbee-mcp --api-key lb_...
|
|
84
96
|
```
|
|
85
97
|
|
|
86
98
|
### CLI
|
|
87
99
|
|
|
88
100
|
```bash
|
|
89
|
-
npx listbee-mcp --api-key lb_...
|
|
101
|
+
npx -y listbee-mcp --api-key lb_...
|
|
90
102
|
```
|
|
91
103
|
|
|
92
104
|
---
|
|
@@ -96,7 +108,7 @@ npx listbee-mcp --api-key lb_...
|
|
|
96
108
|
For hosted deployments (ChatGPT Apps, Claude API Connector, remote agents):
|
|
97
109
|
|
|
98
110
|
```bash
|
|
99
|
-
npx listbee-mcp --transport http --port 3000
|
|
111
|
+
npx -y listbee-mcp --transport http --port 3000
|
|
100
112
|
```
|
|
101
113
|
|
|
102
114
|
Each connecting agent provides their API key via `Authorization: Bearer` header.
|
|
@@ -119,31 +131,47 @@ docker run -p 8080:8080 listbee-mcp
|
|
|
119
131
|
|
|
120
132
|
| Flag | Env var | Default | Description |
|
|
121
133
|
|------|---------|---------|-------------|
|
|
122
|
-
| `--api-key <key>` | `LISTBEE_API_KEY` | — | ListBee API key (required) |
|
|
134
|
+
| `--api-key <key>` | `LISTBEE_API_KEY` | — | ListBee API key (required for stdio) |
|
|
123
135
|
| `--base-url <url>` | `LISTBEE_BASE_URL` | `https://api.listbee.so` | API base URL |
|
|
136
|
+
| `--transport <stdio\|http>` | — | `stdio` | Transport mode |
|
|
137
|
+
| `--port <number>` | `PORT` | `8080` | HTTP port (http mode only) |
|
|
124
138
|
| `--tools <list>` | — | all tools | Comma-separated list of tools to load |
|
|
139
|
+
| `--help`, `-h` | — | — | Show help |
|
|
125
140
|
|
|
126
141
|
**Selective tool loading** — load only what you need:
|
|
127
142
|
|
|
128
143
|
```bash
|
|
129
|
-
npx listbee-mcp --api-key lb_... --tools create_listing,get_listing,publish_listing
|
|
144
|
+
npx -y listbee-mcp --api-key lb_... --tools create_listing,get_listing,publish_listing
|
|
130
145
|
```
|
|
131
146
|
|
|
132
147
|
---
|
|
133
148
|
|
|
134
149
|
## Tools
|
|
135
150
|
|
|
151
|
+
### Account & Auth
|
|
152
|
+
|
|
153
|
+
| Tool | Description |
|
|
154
|
+
|------|-------------|
|
|
155
|
+
| `create_account` | Create a new ListBee account. Sends an OTP to the email for verification. |
|
|
156
|
+
| `verify_otp` | Verify the OTP sent during signup. Returns an API key on success — store it. |
|
|
157
|
+
| `get_account` | Get the account's full state including readiness and billing status. |
|
|
158
|
+
| `update_account` | Update display name, bio, or avatar. These appear on product pages. |
|
|
159
|
+
| `delete_account` | Permanently delete the account and all data. Irreversible. |
|
|
160
|
+
| `create_api_key` | Create a new API key. Full key value returned only once. |
|
|
161
|
+
| `list_api_keys` | List all API keys. Shows prefixes and names, not full values. |
|
|
162
|
+
| `delete_api_key` | Delete and immediately revoke an API key. |
|
|
163
|
+
|
|
136
164
|
### Listings
|
|
137
165
|
|
|
138
166
|
| Tool | Description |
|
|
139
167
|
|------|-------------|
|
|
140
|
-
| `create_listing` | Create a new listing. Returns checkout URL and readiness. |
|
|
168
|
+
| `create_listing` | Create a new listing for sale. Returns checkout URL and readiness. |
|
|
141
169
|
| `get_listing` | Get full listing state including readiness. Call after every change. |
|
|
142
170
|
| `update_listing` | Update title, price, or other listing details. |
|
|
143
171
|
| `list_listings` | List all listings for the current account. |
|
|
144
172
|
| `publish_listing` | Publish a listing so buyers can access the product page. |
|
|
145
173
|
| `set_deliverables` | Attach digital content (file, URL, or text) for automatic delivery. |
|
|
146
|
-
| `remove_deliverables` | Remove deliverables to switch to external fulfillment. |
|
|
174
|
+
| `remove_deliverables` | Remove deliverables to switch to external fulfillment. Draft only. |
|
|
147
175
|
| `delete_listing` | Permanently delete a listing. |
|
|
148
176
|
|
|
149
177
|
### Orders
|
|
@@ -153,6 +181,27 @@ npx listbee-mcp --api-key lb_... --tools create_listing,get_listing,publish_list
|
|
|
153
181
|
| `list_orders` | See all sales and order status. |
|
|
154
182
|
| `get_order` | Get full order details including buyer info and payment. |
|
|
155
183
|
| `deliver_order` | Push digital content to a buyer (external fulfillment only). |
|
|
184
|
+
| `ship_order` | Record shipping info and mark order as fulfilled (external fulfillment). |
|
|
185
|
+
| `refund_order` | Issue a full refund for an order through Stripe. |
|
|
186
|
+
|
|
187
|
+
### Customers
|
|
188
|
+
|
|
189
|
+
| Tool | Description |
|
|
190
|
+
|------|-------------|
|
|
191
|
+
| `list_customers` | List all buyers who have purchased. Auto-populated from orders. |
|
|
192
|
+
| `get_customer` | Get a customer by ID — total orders, total spent, purchase history. |
|
|
193
|
+
|
|
194
|
+
### Webhooks
|
|
195
|
+
|
|
196
|
+
| Tool | Description |
|
|
197
|
+
|------|-------------|
|
|
198
|
+
| `create_webhook` | Create a webhook endpoint. Returns a `whsec_` secret for signature verification. |
|
|
199
|
+
| `list_webhooks` | List all webhook endpoints for the account. |
|
|
200
|
+
| `update_webhook` | Update a webhook URL or event filter. |
|
|
201
|
+
| `delete_webhook` | Delete a webhook endpoint. Irreversible. |
|
|
202
|
+
| `test_webhook` | Send a test event to verify webhook configuration before going live. |
|
|
203
|
+
| `list_webhook_events` | List recent events for a webhook — delivery status, attempts, errors. |
|
|
204
|
+
| `retry_webhook_event` | Retry delivery of a failed webhook event. |
|
|
156
205
|
|
|
157
206
|
### Files
|
|
158
207
|
|
|
@@ -165,6 +214,7 @@ npx listbee-mcp --api-key lb_... --tools create_listing,get_listing,publish_list
|
|
|
165
214
|
| Tool | Description |
|
|
166
215
|
|------|-------------|
|
|
167
216
|
| `start_stripe_connect` | Start Stripe Connect onboarding. Returns a URL — the human must open it in a browser. |
|
|
217
|
+
| `disconnect_stripe` | Disconnect the Stripe account from ListBee. |
|
|
168
218
|
|
|
169
219
|
---
|
|
170
220
|
|
|
@@ -179,7 +229,7 @@ Every listing response includes a `readiness` object that tells you exactly what
|
|
|
179
229
|
"publishable": false,
|
|
180
230
|
"actions": [
|
|
181
231
|
{
|
|
182
|
-
"code": "
|
|
232
|
+
"code": "connect_stripe",
|
|
183
233
|
"kind": "human",
|
|
184
234
|
"message": "Connect a Stripe account to accept payments.",
|
|
185
235
|
"resolve": {
|
|
@@ -188,7 +238,7 @@ Every listing response includes a `readiness` object that tells you exactly what
|
|
|
188
238
|
}
|
|
189
239
|
}
|
|
190
240
|
],
|
|
191
|
-
"next": "
|
|
241
|
+
"next": "connect_stripe"
|
|
192
242
|
}
|
|
193
243
|
}
|
|
194
244
|
```
|
|
@@ -202,10 +252,22 @@ Every listing response includes a `readiness` object that tells you exactly what
|
|
|
202
252
|
- `human` actions: requires human input (show the `message` and `url`)
|
|
203
253
|
- `readiness.next` — the highest-priority action code to resolve first
|
|
204
254
|
|
|
255
|
+
**Canonical action codes:** `connect_stripe`, `enable_charges`, `update_billing`, `configure_webhook`, `publish_listing`, `webhook_disabled`
|
|
256
|
+
|
|
205
257
|
**The pattern:** `create_listing` → `get_listing` → resolve each `api` action → surface `human` actions to the user → `publish_listing` when `publishable` is `true`.
|
|
206
258
|
|
|
207
259
|
---
|
|
208
260
|
|
|
261
|
+
## Debugging
|
|
262
|
+
|
|
263
|
+
Use [MCP Inspector](https://github.com/modelcontextprotocol/inspector) for interactive testing:
|
|
264
|
+
|
|
265
|
+
```bash
|
|
266
|
+
npx @modelcontextprotocol/inspector npx -y listbee-mcp
|
|
267
|
+
```
|
|
268
|
+
|
|
269
|
+
---
|
|
270
|
+
|
|
209
271
|
## Get an API Key
|
|
210
272
|
|
|
211
273
|
[console.listbee.so](https://console.listbee.so) — sign in, go to API Keys.
|
|
@@ -217,6 +279,8 @@ Every listing response includes a `readiness` object that tells you exactly what
|
|
|
217
279
|
- [API Reference](https://docs.listbee.so/api-reference) — full endpoint docs
|
|
218
280
|
- [OpenAPI Spec](https://api.listbee.so/openapi.json) — machine-readable spec
|
|
219
281
|
- [Docs](https://docs.listbee.so) — guides and integration examples
|
|
282
|
+
- [CHANGELOG](https://github.com/listbee-dev/listbee-mcp/blob/main/CHANGELOG.md) — version history
|
|
283
|
+
- [npm](https://www.npmjs.com/package/listbee-mcp) — npm package
|
|
220
284
|
- [GitHub](https://github.com/listbee-dev/listbee-mcp) — source
|
|
221
285
|
|
|
222
286
|
---
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/generated/meta.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,QAAQ;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,
|
|
1
|
+
{"version":3,"file":"meta.d.ts","sourceRoot":"","sources":["../../src/generated/meta.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,QAAQ;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAuMzC,CAAC"}
|
package/dist/generated/meta.js
CHANGED
|
@@ -2,14 +2,44 @@
|
|
|
2
2
|
// source: openapi.json + mcp-tools.yaml
|
|
3
3
|
// Regenerate with: npm run generate
|
|
4
4
|
// openapi_version: 1.0.0
|
|
5
|
-
// generated_at: 2026-04-
|
|
6
|
-
// sha256:
|
|
5
|
+
// generated_at: 2026-04-06T07:16:33.004Z
|
|
6
|
+
// sha256: c8b0d9640ed32ea12e64304dc6799ff00452ce0d57e332cd3eb4bd37042a3254
|
|
7
7
|
export const meta = {
|
|
8
|
+
create_account: {
|
|
9
|
+
operationId: "create_account",
|
|
10
|
+
method: "POST",
|
|
11
|
+
path: "/v1/account",
|
|
12
|
+
description: "Create a new ListBee account with an email address. Sends an OTP code to the email for verification. Follow up with verify_otp to complete signup and get an API key.",
|
|
13
|
+
},
|
|
14
|
+
create_api_key: {
|
|
15
|
+
operationId: "create_api_key",
|
|
16
|
+
method: "POST",
|
|
17
|
+
path: "/v1/api-keys",
|
|
18
|
+
description: "Create a new API key. The full key value (lb_ prefixed) is returned only once — store it securely. Each key can have a name for identification.",
|
|
19
|
+
},
|
|
8
20
|
create_listing: {
|
|
9
21
|
operationId: "create_listing",
|
|
10
22
|
method: "POST",
|
|
11
23
|
path: "/v1/listings",
|
|
12
|
-
description: "Create a new listing for sale. Returns a checkout URL and readiness status.",
|
|
24
|
+
description: "Create a new listing for sale. Returns a checkout URL and readiness status. Only name and price are required — but listings with rich content convert significantly better. Fill in as many fields as you can: description, tagline, highlights, badges, reviews, faqs, cta, cover_url. Write salesy, compelling copy. The product page buyers see is built entirely from these fields.",
|
|
25
|
+
},
|
|
26
|
+
create_webhook: {
|
|
27
|
+
operationId: "create_webhook",
|
|
28
|
+
method: "POST",
|
|
29
|
+
path: "/v1/webhooks",
|
|
30
|
+
description: "Create a webhook endpoint. Specify the URL and which events to receive. The webhook secret (whsec_ prefixed) is returned for signature verification.",
|
|
31
|
+
},
|
|
32
|
+
delete_account: {
|
|
33
|
+
operationId: "delete_account",
|
|
34
|
+
method: "DELETE",
|
|
35
|
+
path: "/v1/account",
|
|
36
|
+
description: "Permanently delete the account and all associated data. This is irreversible.",
|
|
37
|
+
},
|
|
38
|
+
delete_api_key: {
|
|
39
|
+
operationId: "delete_api_key",
|
|
40
|
+
method: "DELETE",
|
|
41
|
+
path: "/v1/api-keys/{key_id}",
|
|
42
|
+
description: "Delete an API key. The key is immediately revoked and cannot be used again.",
|
|
13
43
|
},
|
|
14
44
|
delete_listing: {
|
|
15
45
|
operationId: "delete_listing",
|
|
@@ -17,12 +47,36 @@ export const meta = {
|
|
|
17
47
|
path: "/v1/listings/{listing_id}",
|
|
18
48
|
description: "Delete a listing by ID and its stored content. Irreversible.",
|
|
19
49
|
},
|
|
50
|
+
delete_webhook: {
|
|
51
|
+
operationId: "delete_webhook",
|
|
52
|
+
method: "DELETE",
|
|
53
|
+
path: "/v1/webhooks/{webhook_id}",
|
|
54
|
+
description: "Delete a webhook endpoint. Irreversible.",
|
|
55
|
+
},
|
|
20
56
|
deliver_order: {
|
|
21
57
|
operationId: "deliver_order",
|
|
22
58
|
method: "POST",
|
|
23
59
|
path: "/v1/orders/{order_id}/deliver",
|
|
24
60
|
description: "Push digital content to a buyer for an external fulfillment order. Not needed for managed delivery — ListBee handles that automatically.",
|
|
25
61
|
},
|
|
62
|
+
disconnect_stripe: {
|
|
63
|
+
operationId: "disconnect_stripe",
|
|
64
|
+
method: "DELETE",
|
|
65
|
+
path: "/v1/account/stripe",
|
|
66
|
+
description: "Disconnect the Stripe account from ListBee. Existing listings retain their payment snapshot but new checkouts will fail.",
|
|
67
|
+
},
|
|
68
|
+
get_account: {
|
|
69
|
+
operationId: "get_account",
|
|
70
|
+
method: "GET",
|
|
71
|
+
path: "/v1/account",
|
|
72
|
+
description: "Get the authenticated account's full state including readiness and billing status. This is the first call an agent should make to understand what's set up.",
|
|
73
|
+
},
|
|
74
|
+
get_customer: {
|
|
75
|
+
operationId: "get_customer",
|
|
76
|
+
method: "GET",
|
|
77
|
+
path: "/v1/customers/{customer_id}",
|
|
78
|
+
description: "Get a customer by ID. Shows total orders, total spent, currency, and purchase dates. Customers represent unique buyer emails that have purchased from the seller.",
|
|
79
|
+
},
|
|
26
80
|
get_listing: {
|
|
27
81
|
operationId: "get_listing",
|
|
28
82
|
method: "GET",
|
|
@@ -35,6 +89,18 @@ export const meta = {
|
|
|
35
89
|
path: "/v1/orders/{order_id}",
|
|
36
90
|
description: "Get a single order by ID. Order lifecycle: PENDING → PAID → FULFILLED. Managed listings auto-fulfill. External listings require fulfill() or ship() after payment.",
|
|
37
91
|
},
|
|
92
|
+
list_api_keys: {
|
|
93
|
+
operationId: "list_api_keys",
|
|
94
|
+
method: "GET",
|
|
95
|
+
path: "/v1/api-keys",
|
|
96
|
+
description: "List all API keys. Shows key prefixes and names but not full key values (those are only shown at creation time).",
|
|
97
|
+
},
|
|
98
|
+
list_customers: {
|
|
99
|
+
operationId: "list_customers",
|
|
100
|
+
method: "GET",
|
|
101
|
+
path: "/v1/customers",
|
|
102
|
+
description: "List all customers (buyers) who have purchased from the seller. Auto-populated from orders — no manual creation needed. Sorted by most recent purchase first. Filter by email for exact match lookup.",
|
|
103
|
+
},
|
|
38
104
|
list_listings: {
|
|
39
105
|
operationId: "list_listings",
|
|
40
106
|
method: "GET",
|
|
@@ -47,17 +113,41 @@ export const meta = {
|
|
|
47
113
|
path: "/v1/orders",
|
|
48
114
|
description: "List orders for the authenticated account. Filter by status, listing, and date range. Paginated. Order lifecycle: PENDING (checkout started, buyer data captured) → PAID (payment confirmed, order.paid webhook fires) → FULFILLED (content delivered or goods shipped). Terminal states: CANCELED (payment failed or abandoned), FAILED (system error). Managed listings auto-fulfill on payment. External listings stay in PAID until the seller calls fulfill() or ship().",
|
|
49
115
|
},
|
|
116
|
+
list_webhook_events: {
|
|
117
|
+
operationId: "list_webhook_events",
|
|
118
|
+
method: "GET",
|
|
119
|
+
path: "/v1/webhooks/{webhook_id}/events",
|
|
120
|
+
description: "List recent events for a webhook. Shows delivery status, attempts, and errors. Useful for debugging failed deliveries.",
|
|
121
|
+
},
|
|
122
|
+
list_webhooks: {
|
|
123
|
+
operationId: "list_webhooks",
|
|
124
|
+
method: "GET",
|
|
125
|
+
path: "/v1/webhooks",
|
|
126
|
+
description: "List all webhooks for the account. Shows URL, events filter, and enabled status.",
|
|
127
|
+
},
|
|
50
128
|
publish_listing: {
|
|
51
129
|
operationId: "publish_listing",
|
|
52
130
|
method: "POST",
|
|
53
131
|
path: "/v1/listings/{listing_id}/publish",
|
|
54
132
|
description: "Publish a listing so buyers can access the product page. Only works when readiness.publishable is true.",
|
|
55
133
|
},
|
|
134
|
+
refund_order: {
|
|
135
|
+
operationId: "refund_order",
|
|
136
|
+
method: "POST",
|
|
137
|
+
path: "/v1/orders/{order_id}/refund",
|
|
138
|
+
description: "Issue a full refund for an order. Refund is processed through Stripe on the seller's connected account. Idempotent — already-refunded orders return as-is. Order state (refund_amount, refunded_at) updates asynchronously via Stripe webhook.",
|
|
139
|
+
},
|
|
56
140
|
remove_deliverables: {
|
|
57
141
|
operationId: "remove_deliverables",
|
|
58
142
|
method: "DELETE",
|
|
59
143
|
path: "/v1/listings/{listing_id}/deliverables",
|
|
60
|
-
description: "Remove all deliverables from a draft listing. Demotes the listing to external fulfillment. Draft only — returns 409 if the listing is published
|
|
144
|
+
description: "Remove all deliverables from a draft listing. Demotes the listing to external fulfillment. Draft only — returns 409 if the listing is published.",
|
|
145
|
+
},
|
|
146
|
+
retry_webhook_event: {
|
|
147
|
+
operationId: "retry_webhook_event",
|
|
148
|
+
method: "POST",
|
|
149
|
+
path: "/v1/webhooks/{webhook_id}/events/{event_id}/retry",
|
|
150
|
+
description: "Retry delivery of a failed webhook event. Resets attempt counter.",
|
|
61
151
|
},
|
|
62
152
|
set_deliverables: {
|
|
63
153
|
operationId: "set_deliverables",
|
|
@@ -77,17 +167,41 @@ export const meta = {
|
|
|
77
167
|
path: "/v1/account/stripe/connect",
|
|
78
168
|
description: "Start Stripe Connect onboarding. Returns a URL for the human to complete in a browser. Required before selling through Stripe.",
|
|
79
169
|
},
|
|
170
|
+
test_webhook: {
|
|
171
|
+
operationId: "test_webhook",
|
|
172
|
+
method: "POST",
|
|
173
|
+
path: "/v1/webhooks/{webhook_id}/test",
|
|
174
|
+
description: "Send a test event to the webhook URL. Returns the delivery result. Use this to verify webhook configuration before going live.",
|
|
175
|
+
},
|
|
176
|
+
update_account: {
|
|
177
|
+
operationId: "update_account",
|
|
178
|
+
method: "PUT",
|
|
179
|
+
path: "/v1/account",
|
|
180
|
+
description: "Update the account's display name, bio, or avatar. These appear on product pages as the seller identity.",
|
|
181
|
+
},
|
|
80
182
|
update_listing: {
|
|
81
183
|
operationId: "update_listing",
|
|
82
184
|
method: "PUT",
|
|
83
185
|
path: "/v1/listings/{listing_id}",
|
|
84
186
|
description: "Update listing fields. Slug can be changed while in draft status — input is slugified, conflicts get a random suffix. Returns updated listing with readiness.",
|
|
85
187
|
},
|
|
188
|
+
update_webhook: {
|
|
189
|
+
operationId: "update_webhook",
|
|
190
|
+
method: "PUT",
|
|
191
|
+
path: "/v1/webhooks/{webhook_id}",
|
|
192
|
+
description: "Update a webhook endpoint. Only provided fields are changed.",
|
|
193
|
+
},
|
|
86
194
|
upload_file: {
|
|
87
195
|
operationId: "upload_file",
|
|
88
196
|
method: "POST",
|
|
89
197
|
path: "/v1/files",
|
|
90
|
-
description: "
|
|
198
|
+
description: "Upload a file and receive a token for use in deliverables.",
|
|
199
|
+
},
|
|
200
|
+
verify_otp: {
|
|
201
|
+
operationId: "verify_otp",
|
|
202
|
+
method: "POST",
|
|
203
|
+
path: "/v1/account/verify/otp",
|
|
204
|
+
description: "Verify the OTP code sent to the user's email during account creation. Returns an API key on success — store it securely for all future API calls.",
|
|
91
205
|
},
|
|
92
206
|
};
|
|
93
207
|
//# sourceMappingURL=meta.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"meta.js","sourceRoot":"","sources":["../../src/generated/meta.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,wCAAwC;AACxC,oCAAoC;AACpC,yBAAyB;AACzB,yCAAyC;AACzC,2EAA2E;AAS3E,MAAM,CAAC,MAAM,IAAI,GAA6B;IAC5C,cAAc,EAAE;QACd,WAAW,EAAE,gBAAgB;QAC7B,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,6EAA6E;KAC3F;IACD,cAAc,EAAE;QACd,WAAW,EAAE,gBAAgB;QAC7B,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,2BAA2B;QACjC,WAAW,EAAE,8DAA8D;KAC5E;IACD,aAAa,EAAE;QACb,WAAW,EAAE,eAAe;QAC5B,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,+BAA+B;QACrC,WAAW,EAAE,0IAA0I;KACxJ;IACD,WAAW,EAAE;QACX,WAAW,EAAE,aAAa;QAC1B,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,2BAA2B;QACjC,WAAW,EAAE,4IAA4I;KAC1J;IACD,SAAS,EAAE;QACT,WAAW,EAAE,WAAW;QACxB,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EAAE,oKAAoK;KAClL;IACD,aAAa,EAAE;QACb,WAAW,EAAE,eAAe;QAC5B,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,cAAc;QACpB,WAAW,EAAE,iLAAiL;KAC/L;IACD,WAAW,EAAE;QACX,WAAW,EAAE,aAAa;QAC1B,MAAM,EAAE,KAAK;QACb,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,+cAA+c;KAC7d;IACD,eAAe,EAAE;QACf,WAAW,EAAE,iBAAiB;QAC9B,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,mCAAmC;QACzC,WAAW,EAAE,yGAAyG;KACvH;IACD,mBAAmB,EAAE;QACnB,WAAW,EAAE,qBAAqB;QAClC,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,wCAAwC;QAC9C,WAAW,EAAE,
|
|
1
|
+
{"version":3,"file":"meta.js","sourceRoot":"","sources":["../../src/generated/meta.ts"],"names":[],"mappings":"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"}
|