@stripe/link-cli 0.4.1 → 0.4.2

package/README.md

@@ -71,6 +71,23 @@ The `--request-approval` flag triggers a push notification (or email) to the use
 
 Users can easily approve requests with the [Link app](https://link.com/download).
 
+#### Line items and totals
+
+`--line-item` and `--total` use repeatable `key:value` format.
+
+**`--line-item` keys:** `name` (required), `quantity`, `unit_amount`, `description`, `sku`, `url`, `image_url`, `product_url`
+
+```bash
+--line-item "name:Running Shoes,unit_amount:12000,quantity:1,description:Trail runners"
+```
+
+**`--total` keys:** `type` (required), `display_text` (required), `amount` (required)
+
+```bash
+--total "type:subtotal,display_text:Subtotal,amount:12000" \
+--total "type:total,display_text:Total,amount:12000"
+```
+
 #### Credential types
 
 By default, a spend request provisions a virtual card. For merchants that support the [Machine Payments Protocol](https://mpp.dev) (HTTP 402) and the Stripe payment method, you can instead include `--credential-type "shared_payment_token"`. 

package/dist/cli.js

@@ -13590,8 +13590,13 @@ function parseKvString(raw) {
   }
   return result;
 }
-function formatZodError(err, prefix) {
+function formatZodError(err, prefix, schema) {
+  const allowed = Object.keys(schema.shape);
   const messages = err.issues.map((issue) => {
+    if (issue.code === "unrecognized_keys") {
+      const keys = issue.keys.map((k) => `"${k}"`).join(", ");
+      return `${prefix}: unrecognized key ${keys}. Allowed keys: ${allowed.join(", ")}`;
+    }
     const key = issue.path[0]?.toString();
     return key ? `${prefix} ${key}: ${issue.message}` : `${prefix}: ${issue.message}`;
   });
@@ -13602,7 +13607,8 @@ function parseLineItemFlag(raw) {
   try {
     return LineItemSchema.parse(obj);
   } catch (err) {
-    if (err instanceof z5.ZodError) throw formatZodError(err, "Line item");
+    if (err instanceof z5.ZodError)
+      throw formatZodError(err, "Line item", LineItemSchema);
     throw err;
   }
 }
@@ -13611,7 +13617,8 @@ function parseTotalFlag(raw) {
   try {
     return TotalSchema.parse(obj);
   } catch (err) {
-    if (err instanceof z5.ZodError) throw formatZodError(err, "Total");
+    if (err instanceof z5.ZodError)
+      throw formatZodError(err, "Total", TotalSchema);
     throw err;
   }
 }
@@ -14199,8 +14206,12 @@ var createOptions = z6.object({
   context: z6.string().min(100).describe(
     "Min 100 chars \u2014 describe the purchase and rationale; the user reads this when approving"
   ),
-  lineItem: z6.array(z6.union([z6.string(), z6.record(z6.string(), z6.unknown())])).default([]).describe("Line item (repeatable, key:value format)"),
-  total: z6.array(z6.union([z6.string(), z6.record(z6.string(), z6.unknown())])).default([]).describe("Total (repeatable, key:value format)"),
+  lineItem: z6.array(z6.union([z6.string(), z6.record(z6.string(), z6.unknown())])).default([]).describe(
+    'Line item (repeatable, key:value format). Keys: name (required), quantity, unit_amount, description, sku, url, image_url, product_url. Example: "name:Shoes,unit_amount:5000,quantity:2"'
+  ),
+  total: z6.array(z6.union([z6.string(), z6.record(z6.string(), z6.unknown())])).default([]).describe(
+    'Total (repeatable, key:value format). Keys: type (required), display_text (required), amount (required). Example: "type:total,display_text:Total,amount:5000"'
+  ),
   requestApproval: z6.boolean().default(true).describe("Request approval and poll until approved/denied/expired"),
   test: z6.boolean().default(false).describe(
     "Use test mode (creates testmode credentials from test card data)"
@@ -14225,8 +14236,12 @@ var updateOptions = z6.object({
   profileId: z6.string().optional().describe("Profile ID"),
   merchantId: z6.string().optional().describe("Merchant ID"),
   currency: z6.string().optional().describe("Currency code"),
-  lineItem: z6.array(z6.union([z6.string(), z6.record(z6.string(), z6.unknown())])).default([]).describe("Line item (repeatable, key:value format)"),
-  total: z6.array(z6.union([z6.string(), z6.record(z6.string(), z6.unknown())])).default([]).describe("Total (repeatable, key:value format)")
+  lineItem: z6.array(z6.union([z6.string(), z6.record(z6.string(), z6.unknown())])).default([]).describe(
+    'Line item (repeatable, key:value format). Keys: name (required), quantity, unit_amount, description, sku, url, image_url, product_url. Example: "name:Shoes,unit_amount:5000,quantity:2"'
+  ),
+  total: z6.array(z6.union([z6.string(), z6.record(z6.string(), z6.unknown())])).default([]).describe(
+    'Total (repeatable, key:value format). Keys: type (required), display_text (required), amount (required). Example: "type:total,display_text:Total,amount:5000"'
+  )
 });
 
 // src/commands/spend-request/update.tsx
@@ -14930,7 +14945,7 @@ var ResourceFactory = class {
 };
 
 // src/cli.tsx
-var cliVersion = "0.4.1";
+var cliVersion = "0.4.2";
 var buildNumber = "1";
 var cliName = "@stripe/link-cli";
 var defaultHeaders = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stripe/link-cli",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "type": "module",
   "bin": {
     "link-cli": "./dist/cli.js"
@@ -25,6 +25,7 @@
     "ink": "^5.2.1",
     "ink-spinner": "^5.0.0",
     "mppx": "^0.5.7",
+    "viem": "^2.47.5",
     "qrcode": "^1.5.4",
     "react": "^18.3.1",
     "update-notifier": "^7.3.1",