@stripe/link-cli 0.8.0 → 0.8.2

package/README.md

@@ -105,7 +105,7 @@ Returns the shipping addresses saved to your Link account. The response preserve
 
 ### Create a spend request
 
-Create a spend request with a payment method, merchant details, line items, and amounts:
+Create a spend request with merchant details, line items, and amounts. If `--payment-method-id` is omitted, your default payment method will be used, or the first eligible one if no default is set:
 
 ```bash
 link-cli spend-request create \
@@ -214,7 +214,7 @@ All commands accept `--auth <path>` to store auth credentials in a specific file
 
 A spend request moves through: **create** → **request approval** → **approved** (with credentials).
 
-**Required fields for create:** `payment_method_id`, `merchant_name`, `merchant_url`, `context`, `amount`
+**Required fields for create:** `merchant_name`, `merchant_url`, `context`, `amount`. `payment_method_id` is optional — if omitted, your default payment method will be used, or the first eligible one if no default is set.
 
 **Constraints:** `context` must be at least 100 characters; `amount` must not exceed 500000 (cents); `currency` must be a 3-letter ISO code. The user has 10 minutes from when approval is requested to approve. Approved credentials (card or SPT) are valid for 12 hours from spend request creation.
 **Test mode:** Pass `--test` to create testmode credentials (uses test card `4242424242424242`), useful for development and integration testing without real payment methods.
@@ -267,6 +267,25 @@ link-cli mpp decode \
   --challenge 'Payment id="ch_001", realm="merchant.example", method="stripe", intent="charge", request="..."'
 ```
 
+### Report outcomes
+
+Use `report` to record the outcome of a purchase attempt. Reporting is optional, but calling it after attempts — success or failure — helps Stripe improve checkout for agents.
+
+```bash
+# Successful purchase
+link-cli report --domain shop.example.com --outcome success --spend-request-id lsrq_abc123
+
+# Blocked by captcha
+link-cli report --domain shop.example.com --outcome blocked --spend-request-id lsrq_abc123 \
+  --tag captcha --step "checkout page" --freeform-context "Turnstile challenge appeared"
+
+# Abandoned due to timeout
+link-cli report --domain shop.example.com --outcome abandoned --spend-request-id lsrq_abc123 \
+  --tag timeout
+```
+
+Outcomes: `success`, `blocked`, `abandoned`. Tags: `stripe_checkout`, `captcha`, `anti_bot_script`, `cdn_block`, `waf_block`, `dns_block`, `rate_limited`, `login_required`, `3ds_challenge`, `page_inaccessible`, `timeout`, `site_error`, `payment_declined`, `other`.
+
 ### Environment variables
 
 | Variable | Effect |

package/dist/cli.js

@@ -15631,7 +15631,7 @@ var RetrieveSpendRequest = ({
 // src/commands/spend-request/schema.ts
 import { z as z8 } from "incur";
 var createOptions = z8.object({
-  paymentMethodId: z8.string().describe("Payment method ID"),
+  paymentMethodId: z8.string().optional().describe("Payment method ID"),
   credentialType: z8.enum(["shared_payment_token", "card"]).default("card").describe(
     '"card" for checkout forms/Stripe Elements; "shared_payment_token" for HTTP 402/machine payment flows'
   ),
@@ -16703,7 +16703,7 @@ function cacheUpdateInfo(value, ttlMs = UPDATE_CACHE_TTL_MS) {
 }
 
 // src/cli.tsx
-var cliVersion = "0.8.0";
+var cliVersion = "0.8.2";
 var cliName = "@stripe/link-cli";
 var defaultHeaders = {
   "User-Agent": `link-cli/${cliVersion}`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stripe/link-cli",
-  "version": "0.8.0",
+  "version": "0.8.2",
   "type": "module",
   "bin": {
     "link-cli": "./dist/cli.js"