tixbit 0.2.0 → 0.2.1

package/README.md

@@ -97,6 +97,8 @@ tixbit link complete <order-reference>
 
 The second command checks approval, sends one Stripe MPP credential, and reports whether the ticket was issued. If approval is still pending, it returns the same URL without sending payment. If the payment result is uncertain, use `link complete` with the same order reference. The CLI stores the purchase key in a private file under `~/.local/state/tixbit/link` (or `XDG_STATE_HOME`) and never prints or saves the Link payment token. Keep that file until the order is settled. Each command returns JSON; `approval_required` and payment failures use exit code 2.
 
+Each spend request includes its TixBit order reference in the approval details. Link can still rate limit a matching amount and merchant for a short time, even after a request is canceled. If Link rejects a request, the CLI reports a safe error code such as `LINK_DUPLICATE_REQUEST` or `LINK_NETWORK_UNAVAILABLE` without printing Link credentials.
+
 `--email` is always required and is never inferred from git or local account state. If a request times out or returns `pending` or `manual_review_required`, reuse the same idempotency key and follow the returned `action`; do not start another payment.
 
 ### Link agent checkout

package/dist/cli.js

@@ -923,8 +923,30 @@ async function linkCli(args) {
       windowsHide: true
     });
     stdout = typeof result === "string" ? result : result.stdout;
-  } catch {
-    throw new LinkCheckoutError("LINK_CLI_FAILED", "Link could not complete this step. Run `npx @stripe/link-cli auth login`, then retry with the same order reference.");
+  } catch (error) {
+    const output2 = error && typeof error === "object" && "stdout" in error ? String(error.stdout) : "";
+    let message = "";
+    try {
+      const parsed = JSON.parse(output2);
+      const data = parsed && typeof parsed === "object" && !Array.isArray(parsed) && "data" in parsed ? parsed.data : parsed;
+      const item = Array.isArray(data) ? data[0] : data;
+      if (item && typeof item === "object" && "message" in item) {
+        message = String(item.message);
+      } else {
+        const nested = parsed && typeof parsed === "object" && !Array.isArray(parsed) && "error" in parsed ? parsed.error : void 0;
+        if (nested && typeof nested === "object" && "message" in nested) {
+          message = String(nested.message);
+        }
+      }
+    } catch {
+    }
+    if (/duplicate spend requests|matching spend request/i.test(message)) {
+      throw new LinkCheckoutError("LINK_DUPLICATE_REQUEST", "Link blocked a matching spend request. Wait a few minutes, then start a new checkout.");
+    }
+    if (/Invalid network_id|could not retrieve merchant information/i.test(message)) {
+      throw new LinkCheckoutError("LINK_NETWORK_UNAVAILABLE", "Link could not resolve the merchant profile in this account and mode. No payment was sent.");
+    }
+    throw new LinkCheckoutError("LINK_CLI_FAILED", "Link could not complete this step. Check Link sign-in and payment methods, then retry.");
   }
   try {
     const parsed = JSON.parse(stdout);
@@ -984,7 +1006,7 @@ async function startLinkPurchase(input) {
   if (typeof body.orderReference !== "string" || !ORDER_REFERENCE.test(body.orderReference)) {
     throw new LinkCheckoutError("ORDER_REFERENCE_MISSING", "TixBit did not return an order reference.");
   }
-  const context = `Approve one TixBit ticket purchase for listing ${purchase.listingId}, quantity ${purchase.quantity}. The total charge is USD ${(amountCents / 100).toFixed(2)}. This request permits one machine payment for this selected order only.`;
+  const context = `Approve one TixBit ticket purchase for order ${body.orderReference}, listing ${purchase.listingId}, quantity ${purchase.quantity}. The total charge is USD ${(amountCents / 100).toFixed(2)}. This request permits one machine payment for this selected order only.`;
   const created = await linkCli([
     "spend-request",
     "create",
@@ -998,6 +1020,8 @@ async function startLinkPurchase(input) {
     "usd",
     "--context",
     context,
+    "--metadata",
+    `order_reference:${body.orderReference}`,
     "--request-approval"
   ]);
   if (typeof created.id !== "string" || !SPEND_REQUEST_ID.test(created.id)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tixbit",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Search events, browse listings, view seatmaps, and purchase TixBit tickets through MPP",
   "type": "module",
   "main": "./dist/index.js",