@stripe/link-cli 0.3.1 → 0.4.1

package/README.md

@@ -84,6 +84,14 @@ link-cli spend-request retrieve lsrq_001 --format json
 ```
 By default, retrieving a spend request will not include card details. Use the `--include=card` to see unmasked card details.
 
+For agent polling, pass `--interval` and optionally `--max-attempts`:
+
+```bash
+link-cli spend-request retrieve lsrq_001 --interval 2 --max-attempts 150 --format json
+```
+
+Polling exits successfully only after the request reaches a terminal status such as `approved`, `denied`, or `expired`. If polling reaches `--timeout` or exhausts `--max-attempts` while the request is still non-terminal, the command exits non-zero with `code: "POLLING_TIMEOUT"` so callers do not treat a still-pending request as complete.
+
 If the merchant supports MPP, use `link-cli mpp pay` instead:
 
 ```bash

package/dist/cli.js

@@ -13688,7 +13688,7 @@ function useApprovalPolling({
         if (!cancelled) {
           onSuccess(final);
           setStatus("success");
-          setTimeout(onComplete, 1e3);
+          setTimeout(() => onComplete(final), 1e3);
         }
       } catch (err) {
         if (!cancelled) {
@@ -13748,12 +13748,12 @@ var CreateSpendRequest = ({
           setStatus("waiting");
         } else {
           setStatus("success");
-          setTimeout(onComplete, 1500);
+          setTimeout(() => onComplete(result), 1500);
         }
       } catch (err) {
         setError(err.message);
         setStatus("error");
-        setTimeout(onComplete, 1500);
+        setTimeout(() => onComplete(null), 1500);
       }
     };
     create();
@@ -13785,10 +13785,7 @@ var CreateSpendRequest = ({
         /* @__PURE__ */ jsxs13(Text15, { children: [
           "Amount:",
           " ",
-          /* @__PURE__ */ jsx20(Text15, { bold: true, children: (() => {
-            const t = request?.totals.find((t2) => t2.type === "total");
-            return t ? String(t.amount) : "N/A";
-          })() })
+          /* @__PURE__ */ jsx20(Text15, { bold: true, children: request?.amount != null ? `${request.amount} ${request.currency?.toUpperCase() ?? ""}`.trim() : "N/A" })
         ] }),
         /* @__PURE__ */ jsxs13(Text15, { children: [
           "Merchant: ",
@@ -13798,6 +13795,10 @@ var CreateSpendRequest = ({
           "Line Items:",
           " ",
           /* @__PURE__ */ jsx20(Text15, { bold: true, children: request?.line_items.map((li) => li.name).join(", ") || "N/A" })
+        ] }),
+        request?.credential_type === "shared_payment_token" && request.shared_payment_token && /* @__PURE__ */ jsxs13(Text15, { children: [
+          "Token: ",
+          /* @__PURE__ */ jsx20(Text15, { bold: true, children: request.shared_payment_token.id })
         ] })
       ] }),
       /* @__PURE__ */ jsx20(AppDownloadQrCodes, {})
@@ -13885,14 +13886,15 @@ var RequestApproval = ({
         /* @__PURE__ */ jsxs14(Text16, { children: [
           "Amount:",
           " ",
-          /* @__PURE__ */ jsx21(Text16, { bold: true, children: (() => {
-            const t = result?.totals.find((t2) => t2.type === "total");
-            return t ? String(t.amount) : "N/A";
-          })() })
+          /* @__PURE__ */ jsx21(Text16, { bold: true, children: result?.amount != null ? `${result.amount} ${result.currency?.toUpperCase() ?? ""}`.trim() : "N/A" })
         ] }),
         /* @__PURE__ */ jsxs14(Text16, { children: [
           "Merchant: ",
           /* @__PURE__ */ jsx21(Text16, { bold: true, children: result?.merchant_name })
+        ] }),
+        result?.credential_type === "shared_payment_token" && result.shared_payment_token && /* @__PURE__ */ jsxs14(Text16, { children: [
+          "Token: ",
+          /* @__PURE__ */ jsx21(Text16, { bold: true, children: result.shared_payment_token.id })
         ] })
       ] })
     ] });
@@ -13925,6 +13927,7 @@ var RetrieveSpendRequest = ({
   const startTimeRef = useRef4(Date.now());
   const pollRef = useRef4(null);
   const timerRef = useRef4(null);
+  const requestRef = useRef4(null);
   useEffect12(() => {
     return () => {
       if (pollRef.current) clearInterval(pollRef.current);
@@ -13938,16 +13941,17 @@ var RetrieveSpendRequest = ({
         if (!result) {
           setError(`Spend request ${id} not found`);
           setPhase("error");
-          setTimeout(onComplete, 1500);
+          setTimeout(() => onComplete(null), 1500);
           return;
         }
+        requestRef.current = result;
         setRequest(result);
         if (result.status === "approved") {
           setPhase("success");
-          setTimeout(onComplete, 1500);
+          setTimeout(() => onComplete(result), 1500);
         } else if (result.status === "denied") {
           setPhase("declined");
-          setTimeout(onComplete, 1500);
+          setTimeout(() => onComplete(result), 1500);
         } else {
           startTimeRef.current = Date.now();
           setPhase("polling");
@@ -13955,7 +13959,7 @@ var RetrieveSpendRequest = ({
       } catch (err) {
         setError(err.message);
         setPhase("error");
-        setTimeout(onComplete, 1500);
+        setTimeout(() => onComplete(null), 1500);
       }
     };
     fetch2();
@@ -13972,23 +13976,24 @@ var RetrieveSpendRequest = ({
         if (pollRef.current) clearInterval(pollRef.current);
         if (timerRef.current) clearInterval(timerRef.current);
         setPhase("timeout");
-        setTimeout(onComplete, 1500);
+        setTimeout(() => onComplete(requestRef.current), 1500);
         return;
       }
       try {
         const result = await repository.getSpendRequest(id, { include });
         if (!result) return;
+        requestRef.current = result;
         setRequest(result);
         if (result.status === "approved") {
           if (pollRef.current) clearInterval(pollRef.current);
           if (timerRef.current) clearInterval(timerRef.current);
           setPhase("success");
-          setTimeout(onComplete, 1500);
+          setTimeout(() => onComplete(result), 1500);
         } else if (result.status === "denied") {
           if (pollRef.current) clearInterval(pollRef.current);
           if (timerRef.current) clearInterval(timerRef.current);
           setPhase("declined");
-          setTimeout(onComplete, 1500);
+          setTimeout(() => onComplete(result), 1500);
         }
       } catch {
       }
@@ -14061,10 +14066,7 @@ var RetrieveSpendRequest = ({
         /* @__PURE__ */ jsxs15(Text17, { children: [
           "Amount:",
           " ",
-          /* @__PURE__ */ jsx22(Text17, { bold: true, children: (() => {
-            const t = request?.totals.find((t2) => t2.type === "total");
-            return t ? String(t.amount) : "N/A";
-          })() })
+          /* @__PURE__ */ jsx22(Text17, { bold: true, children: request?.amount != null ? String(request.amount) : "N/A" })
         ] }),
         /* @__PURE__ */ jsxs15(Text17, { children: [
           "Merchant: ",
@@ -14088,10 +14090,7 @@ var RetrieveSpendRequest = ({
       /* @__PURE__ */ jsxs15(Text17, { children: [
         "Amount:",
         " ",
-        /* @__PURE__ */ jsx22(Text17, { bold: true, children: (() => {
-          const t = request?.totals.find((t2) => t2.type === "total");
-          return t ? String(t.amount) : "N/A";
-        })() })
+        /* @__PURE__ */ jsx22(Text17, { bold: true, children: request?.amount != null ? String(request.amount) : "N/A" })
       ] }),
       /* @__PURE__ */ jsxs15(Text17, { children: [
         "Merchant: ",
@@ -14208,11 +14207,15 @@ var createOptions = z6.object({
   )
 });
 var retrieveOptions = z6.object({
-  timeout: z6.coerce.number().default(300).describe("Polling timeout in seconds"),
+  timeout: z6.coerce.number().default(300).describe(
+    "Polling timeout in seconds. When reached during active polling, exits non-zero with POLLING_TIMEOUT."
+  ),
   interval: z6.coerce.number().default(0).describe(
-    "Poll interval in seconds. When > 0, polls until status is terminal or timeout is reached, yielding status on each attempt."
+    "Poll interval in seconds. When > 0, polls until status is terminal, timeout is reached, or max attempts are exhausted."
+  ),
+  maxAttempts: z6.coerce.number().default(0).describe(
+    "Max poll attempts. 0 = unlimited. Exhaustion during active polling exits non-zero with POLLING_TIMEOUT."
   ),
-  maxAttempts: z6.coerce.number().default(0).describe("Max poll attempts. 0 = unlimited (use timeout instead)."),
   include: z6.array(z6.string()).default([]).describe("Include extra data (repeatable, e.g. --include card)")
 });
 var updateOptions = z6.object({
@@ -14248,11 +14251,11 @@ var UpdateSpendRequest = ({
         const result = await repository.updateSpendRequest(id, params);
         setRequest(result);
         setStatus("success");
-        setTimeout(onComplete, 1500);
+        setTimeout(() => onComplete(result), 1500);
       } catch (err) {
         setError(err.message);
         setStatus("error");
-        setTimeout(onComplete, 1500);
+        setTimeout(() => onComplete(null), 1500);
       }
     };
     update();
@@ -14384,6 +14387,7 @@ function createSpendRequestCli(repository) {
       };
       if (!c.agent && !c.formatExplicit) {
         return new Promise((resolve) => {
+          let capturedResult = null;
           const { waitUntilExit } = render6(
             /* @__PURE__ */ jsx24(
               CreateSpendRequest,
@@ -14391,14 +14395,14 @@ function createSpendRequestCli(repository) {
                 repository,
                 params: createParams,
                 requestApproval,
-                onComplete: () => {
+                onComplete: (result) => {
+                  capturedResult = result;
                 }
               }
             )
           );
-          waitUntilExit().then(async () => {
-            const created2 = await repository.createSpendRequest(createParams);
-            resolve(created2);
+          waitUntilExit().then(() => {
+            resolve(capturedResult);
           });
         });
       }
@@ -14457,6 +14461,7 @@ function createSpendRequestCli(repository) {
         );
       if (!c.agent && !c.formatExplicit) {
         return new Promise((resolve) => {
+          let capturedResult = null;
           const { waitUntilExit } = render6(
             /* @__PURE__ */ jsx24(
               UpdateSpendRequest,
@@ -14464,13 +14469,14 @@ function createSpendRequestCli(repository) {
                 repository,
                 id,
                 params,
-                onComplete: () => {
+                onComplete: (result) => {
+                  capturedResult = result;
                 }
               }
             )
           );
-          waitUntilExit().then(async () => {
-            resolve(await repository.updateSpendRequest(id, params));
+          waitUntilExit().then(() => {
+            resolve(capturedResult);
           });
         });
       }
@@ -14498,20 +14504,21 @@ function createSpendRequestCli(repository) {
       const id = c.args.id;
       if (!c.agent && !c.formatExplicit) {
         return new Promise((resolve) => {
+          let capturedResult = null;
           const { waitUntilExit } = render6(
             /* @__PURE__ */ jsx24(
               RequestApproval,
               {
                 repository,
                 id,
-                onComplete: () => {
+                onComplete: (result) => {
+                  capturedResult = result;
                 }
               }
             )
           );
-          waitUntilExit().then(async () => {
-            const approval2 = await repository.requestApproval(id);
-            resolve(approval2);
+          waitUntilExit().then(() => {
+            resolve(capturedResult);
           });
         });
       }
@@ -14554,6 +14561,7 @@ function createSpendRequestCli(repository) {
       const include = includeArr?.length ? includeArr : void 0;
       if (!c.agent && !c.formatExplicit) {
         return new Promise((resolve) => {
+          let capturedResult = null;
           const { waitUntilExit } = render6(
             /* @__PURE__ */ jsx24(
               RetrieveSpendRequest,
@@ -14562,14 +14570,14 @@ function createSpendRequestCli(repository) {
                 id,
                 timeout,
                 include,
-                onComplete: () => {
+                onComplete: (result) => {
+                  capturedResult = result;
                 }
               }
             )
           );
-          waitUntilExit().then(async () => {
-            const request = await repository.getSpendRequest(id, { include });
-            resolve(request);
+          waitUntilExit().then(() => {
+            resolve(capturedResult);
           });
         });
       }
@@ -14596,11 +14604,20 @@ function createSpendRequestCli(repository) {
           return;
         }
         attempts++;
-        const shouldStop = interval <= 0 || maxAttempts > 0 && attempts >= maxAttempts || Date.now() >= deadline;
-        if (shouldStop) {
+        if (interval <= 0) {
           yield request;
           return;
         }
+        const maxAttemptsExhausted = maxAttempts > 0 && attempts >= maxAttempts;
+        const timeoutReached = Date.now() >= deadline;
+        if (maxAttemptsExhausted || timeoutReached) {
+          const reason = maxAttemptsExhausted ? `max attempts (${maxAttempts}) exhausted` : `timeout (${timeout}s) reached`;
+          return c.error({
+            code: "POLLING_TIMEOUT",
+            message: `Polling stopped before spend request ${id} reached a terminal status: ${reason}; current status is ${request.status}.`,
+            retryable: true
+          });
+        }
         const snapshot = JSON.stringify(request);
         if (snapshot !== previousAttemptData) {
           previousAttemptData = snapshot;
@@ -14913,7 +14930,7 @@ var ResourceFactory = class {
 };
 
 // src/cli.tsx
-var cliVersion = "0.3.1";
+var cliVersion = "0.4.1";
 var buildNumber = "1";
 var cliName = "@stripe/link-cli";
 var defaultHeaders = {

package/package.json

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