@stripe/link-cli 0.16.0 → 0.17.1

package/README.md

@@ -111,6 +111,29 @@ link-cli auth login
 
 You receive a verification URL and a short phrase. Visit the URL, log in to your Link account, and enter the phrase to approve the connection.
 
+### Retrieve user info
+
+```bash
+link-cli user-info retrieve --format json
+```
+
+In addition to identity fields, the response can include Agent Wallet spend limits and step-up status:
+
+```json
+{
+  "email": "jane@example.com",
+  "name": "Jane Doe",
+  "agent_wallet_spend_limits": {
+    "per_transaction": { "limit": 50000 },
+    "daily": { "limit": 500000, "used": 120000, "remaining": 380000 },
+    "thirty_day": { "limit": null, "used": 600000, "remaining": null }
+  },
+  "agent_wallet_step_up": { "status": "not_required" }
+}
+```
+
+Finite spend-limit values are cents because this response does not include a currency. A `null` limit or remaining amount means unlimited. Either Agent Wallet object can be absent when backend enrichment is unavailable; absence does not imply a limit or step-up status.
+
 ### List payment methods
 
 ```bash
@@ -496,4 +519,4 @@ pnpm turbo run build
 pnpm --filter @stripe/link-cli --filter @stripe/link-sdk publish --dry-run --no-git-checks
 ```
 
-CI runs the same publish dry-run for every pull request.
+CI runs the same publish dry-run for every pull request.

package/dist/cli.js

@@ -802,11 +802,13 @@ var SpendRequestResource = class extends BaseResource {
     );
   }
   async update(id, params) {
+    const { approve, ...body } = params;
+    const url = approve ? `${this.endpoint}/${id}/update_delegated` : `${this.endpoint}/${id}`;
     const { status, data, rawBody } = await this.apiFetch({
       method: "POST",
-      url: `${this.endpoint}/${id}`,
+      url,
       headers: { "Content-Type": "application/json" },
-      body: JSON.stringify(params)
+      body: JSON.stringify(body)
     });
     if (status < 200 || status >= 300) {
       this.throwApiError("update spend request", status, data, rawBody);
@@ -932,19 +934,54 @@ var TransactionsResource = class extends BaseResource {
     );
   }
 };
+var rollingSpendLimitSchema = z8.object({
+  limit: z8.number().int().nullable(),
+  used: z8.number().int(),
+  remaining: z8.number().int().nullable()
+});
+var agentWalletSpendLimitsSchema = z8.object({
+  per_transaction: z8.object({
+    limit: z8.number().int().nullable()
+  }),
+  daily: rollingSpendLimitSchema,
+  thirty_day: rollingSpendLimitSchema
+});
+var agentWalletStepUpSchema = z8.object({
+  status: z8.enum([
+    "not_required",
+    "ssn_verification",
+    "identity_verification",
+    "contact_support",
+    "complete"
+  ])
+});
 var userInfoSchema = z8.looseObject({
   email: z8.string().nullable().optional(),
   name: z8.string().nullable().optional(),
   first_name: z8.string().nullable().optional(),
   last_name: z8.string().nullable().optional(),
-  phone: z8.string().nullable().optional()
-}).transform(({ email, name, first_name, last_name, phone }) => ({
-  email: email ?? null,
-  name: name ?? null,
-  first_name: first_name ?? null,
-  last_name: last_name ?? null,
-  phone: phone ?? null
-}));
+  phone: z8.string().nullable().optional(),
+  agent_wallet_spend_limits: agentWalletSpendLimitsSchema.optional(),
+  agent_wallet_step_up: agentWalletStepUpSchema.optional()
+}).transform(
+  ({
+    email,
+    name,
+    first_name,
+    last_name,
+    phone,
+    agent_wallet_spend_limits,
+    agent_wallet_step_up
+  }) => ({
+    email: email ?? null,
+    name: name ?? null,
+    first_name: first_name ?? null,
+    last_name: last_name ?? null,
+    phone: phone ?? null,
+    ...agent_wallet_spend_limits === void 0 ? {} : { agent_wallet_spend_limits },
+    ...agent_wallet_step_up === void 0 ? {} : { agent_wallet_step_up }
+  })
+);
 var UserInfoResource = class extends BaseResource {
   constructor(options) {
     super(options, "/userinfo");
@@ -2801,7 +2838,7 @@ function buildHeaders(data, headers) {
     if (key) result[key] = value;
   }
   if (!Object.keys(result).some((key) => key.toLowerCase() === "user-agent")) {
-    result["User-Agent"] = `link-cli/${"0.16.0"}`;
+    result["User-Agent"] = `link-cli/${"0.17.1"}`;
   }
   return result;
 }
@@ -4939,6 +4976,7 @@ var CreateSpendRequest = ({
   repository,
   params,
   requestApproval = false,
+  approve = false,
   outputFile,
   force,
   onComplete
@@ -5077,7 +5115,7 @@ var CreateSpendRequest = ({
             result.status_details?.requires_action?.next_action ?? null
           );
           setStatus("requires_action");
-        } else if (requestApproval) {
+        } else if (requestApproval && result.status !== "approved") {
           setStatus("waiting");
         } else {
           setStatus("success");
@@ -5352,7 +5390,7 @@ var CreateSpendRequest = ({
           fileError
         ] })
       ] }),
-      /* @__PURE__ */ jsx27(AppDownloadQrCodes, {})
+      !approve && /* @__PURE__ */ jsx27(AppDownloadQrCodes, {})
     ] });
   }
   return /* @__PURE__ */ jsxs18(Fragment4, { children: [
@@ -6190,13 +6228,39 @@ var updateOptions = z19.object({
   ),
   total: z19.array(z19.union([z19.string(), z19.record(z19.string(), z19.unknown())])).default([]).describe(
     'Total (repeatable, key:value format). Keys: type (required; one of: subtotal, tax, total, items_base_amount, items_discount, discount, fulfillment, shipping, fee, gift_wrap, tip, store_credit), display_text (required), amount (required). Example: "type:total,display_text:Total,amount:5000"'
-  )
+  ),
+  approve: z19.boolean().default(false).describe("Use the delegated approval flow for this update")
 });
 
 // src/commands/spend-request/update.tsx
-import { Box as Box22, Text as Text24 } from "ink";
+import { Box as Box22, Text as Text24, useInput as useInput10 } from "ink";
 import Spinner14 from "ink-spinner";
-import { useCallback as useCallback11 } from "react";
+import { useCallback as useCallback11, useState as useState12 } from "react";
+
+// src/utils/poll-until-spend-request-update.ts
+async function pollUntilSpendRequestUpdate(repository, id, pendingAmount, options = {}) {
+  const pollIntervalMs = options.pollIntervalMs ?? 2e3;
+  const timeoutMs = options.timeoutMs ?? 3e5;
+  const startTime = Date.now();
+  while (true) {
+    if (Date.now() - startTime > timeoutMs) {
+      throw new Error("Spend request update polling timed out");
+    }
+    const request = await repository.retrieve(id);
+    if (!request) {
+      throw new Error(`Spend request ${id} not found`);
+    }
+    if (request.amount === pendingAmount) {
+      return { request, outcome: "approved" };
+    }
+    if (!request.approval_url) {
+      return { request, outcome: "denied" };
+    }
+    await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));
+  }
+}
+
+// src/commands/spend-request/update.tsx
 import { jsx as jsx31, jsxs as jsxs22 } from "react/jsx-runtime";
 var UpdateSpendRequest = ({
   repository,
@@ -6204,12 +6268,45 @@ var UpdateSpendRequest = ({
   params,
   onComplete
 }) => {
-  const action = useCallback11(
-    () => repository.update(id, params),
-    [repository, id, params]
+  const [pendingApproval, setPendingApproval] = useState12(
+    null
+  );
+  const action = useCallback11(async () => {
+    const request2 = await repository.update(id, params);
+    if (params.amount !== void 0 && request2.status === "approved" && request2.approval_url) {
+      setPendingApproval(request2);
+      return pollUntilSpendRequestUpdate(repository, id, params.amount);
+    }
+    return { request: request2, outcome: "updated" };
+  }, [repository, id, params]);
+  const handleComplete = useCallback11(
+    (result2) => onComplete(result2?.request ?? null),
+    [onComplete]
+  );
+  const {
+    status,
+    data: result,
+    error
+  } = useAsyncAction(action, handleComplete);
+  const request = result?.request ?? pendingApproval;
+  useInput10(
+    (_input, key) => {
+      if (key.return && pendingApproval?.approval_url) {
+        openUrl(pendingApproval.approval_url);
+      }
+    },
+    { isActive: status === "loading" && pendingApproval !== null }
   );
-  const { status, data: request, error } = useAsyncAction(action, onComplete);
   if (status === "loading") {
+    if (pendingApproval?.approval_url) {
+      return /* @__PURE__ */ jsx31(
+        ApprovalWaitingView,
+        {
+          status: "polling",
+          approvalUrl: pendingApproval.approval_url
+        }
+      );
+    }
     return /* @__PURE__ */ jsx31(Box22, { children: /* @__PURE__ */ jsxs22(Text24, { color: "cyan", children: [
       /* @__PURE__ */ jsx31(Spinner14, { type: "dots" }),
       " Updating spend request ",
@@ -6223,6 +6320,21 @@ var UpdateSpendRequest = ({
       /* @__PURE__ */ jsx31(Text24, { color: "red", children: error })
     ] });
   }
+  if (result?.outcome === "denied") {
+    return /* @__PURE__ */ jsxs22(Box22, { flexDirection: "column", children: [
+      /* @__PURE__ */ jsx31(Text24, { color: "yellow", children: "\u2717 Spend request update denied" }),
+      /* @__PURE__ */ jsxs22(Box22, { flexDirection: "column", marginTop: 1, paddingX: 2, children: [
+        /* @__PURE__ */ jsxs22(Text24, { children: [
+          "ID: ",
+          /* @__PURE__ */ jsx31(Text24, { bold: true, children: request?.id })
+        ] }),
+        /* @__PURE__ */ jsxs22(Text24, { children: [
+          "Amount: ",
+          /* @__PURE__ */ jsx31(Text24, { bold: true, children: request?.amount ?? "N/A" })
+        ] })
+      ] })
+    ] });
+  }
   return /* @__PURE__ */ jsxs22(Box22, { flexDirection: "column", children: [
     /* @__PURE__ */ jsx31(Text24, { color: "green", children: "\u2713 Spend request updated" }),
     /* @__PURE__ */ jsxs22(Box22, { flexDirection: "column", marginTop: 1, paddingX: 2, children: [
@@ -6237,10 +6349,7 @@ var UpdateSpendRequest = ({
       /* @__PURE__ */ jsxs22(Text24, { children: [
         "Amount:",
         " ",
-        /* @__PURE__ */ jsx31(Text24, { bold: true, children: (() => {
-          const t = request?.totals?.find((t2) => t2.type === "total");
-          return t ? String(t.amount) : "N/A";
-        })() })
+        /* @__PURE__ */ jsx31(Text24, { bold: true, children: request?.amount !== void 0 ? String(request.amount) : "N/A" })
       ] }),
       /* @__PURE__ */ jsxs22(Text24, { children: [
         "Merchant: ",
@@ -6452,6 +6561,7 @@ function createSpendRequestCli(repository, authStorage2, envAccessToken2) {
               repository,
               params: createParams,
               requestApproval,
+              approve: opts.approve ? true : void 0,
               outputFile,
               force: forceOverwrite,
               onComplete: (result) => {
@@ -6558,6 +6668,9 @@ function createSpendRequestCli(repository, authStorage2, envAccessToken2) {
         params.totals = opts.total.map(
           (item) => typeof item === "string" ? parseTotalFlag(item) : item
         );
+      if (opts.approve !== void 0) {
+        params.approve = opts.approve;
+      }
       if (!c.agent && !c.formatExplicit) {
         let capturedResult = null;
         return renderInteractive(
@@ -6938,6 +7051,9 @@ import { Box as Box24, Text as Text26 } from "ink";
 import Spinner16 from "ink-spinner";
 import { useCallback as useCallback13 } from "react";
 import { jsx as jsx35, jsxs as jsxs24 } from "react/jsx-runtime";
+function formatLimit(value) {
+  return value === null ? "Unlimited" : `${value} cents`;
+}
 var UserInfoRetrieve = ({
   resource,
   onComplete
@@ -6970,7 +7086,51 @@ var UserInfoRetrieve = ({
       /* @__PURE__ */ jsxs24(Text26, { children: [
         /* @__PURE__ */ jsx35(Text26, { dimColor: true, children: "Phone: " }),
         userInfo?.phone ?? /* @__PURE__ */ jsx35(Text26, { dimColor: true, children: "Not set" })
-      ] })
+      ] }),
+      userInfo?.agent_wallet_spend_limits && /* @__PURE__ */ jsxs24(Box24, { flexDirection: "column", marginTop: 1, children: [
+        /* @__PURE__ */ jsx35(Text26, { bold: true, children: "Agent Wallet Spend Limits" }),
+        /* @__PURE__ */ jsxs24(Box24, { flexDirection: "column", paddingLeft: 2, children: [
+          /* @__PURE__ */ jsxs24(Text26, { children: [
+            /* @__PURE__ */ jsx35(Text26, { dimColor: true, children: "Per-transaction: " }),
+            formatLimit(
+              userInfo.agent_wallet_spend_limits.per_transaction.limit
+            )
+          ] }),
+          /* @__PURE__ */ jsxs24(Text26, { children: [
+            /* @__PURE__ */ jsx35(Text26, { dimColor: true, children: "Daily: " }),
+            "limit",
+            " ",
+            formatLimit(userInfo.agent_wallet_spend_limits.daily.limit),
+            ", used ",
+            userInfo.agent_wallet_spend_limits.daily.used,
+            " cents, remaining",
+            " ",
+            formatLimit(
+              userInfo.agent_wallet_spend_limits.daily.remaining
+            )
+          ] }),
+          /* @__PURE__ */ jsxs24(Text26, { children: [
+            /* @__PURE__ */ jsx35(Text26, { dimColor: true, children: "30-day: " }),
+            "limit",
+            " ",
+            formatLimit(
+              userInfo.agent_wallet_spend_limits.thirty_day.limit
+            ),
+            ", used ",
+            userInfo.agent_wallet_spend_limits.thirty_day.used,
+            " ",
+            "cents, remaining",
+            " ",
+            formatLimit(
+              userInfo.agent_wallet_spend_limits.thirty_day.remaining
+            )
+          ] })
+        ] })
+      ] }),
+      userInfo?.agent_wallet_step_up && /* @__PURE__ */ jsx35(Box24, { marginTop: 1, children: /* @__PURE__ */ jsxs24(Text26, { children: [
+        /* @__PURE__ */ jsx35(Text26, { dimColor: true, children: "Agent Wallet step-up status: " }),
+        userInfo.agent_wallet_step_up.status
+      ] }) })
     ] })
   ] });
 };
@@ -6982,7 +7142,7 @@ function createUserInfoCli(createResource, authStorage2, envAccessToken2) {
     description: "User information commands"
   });
   cli2.command("retrieve", {
-    description: "Retrieve user info (email, name, phone)",
+    description: "Retrieve user info, including optional Agent Wallet spend limits and step-up status",
     outputPolicy: "agent-only",
     middleware: [requireAuth(authStorage2, envAccessToken2)],
     async run(c) {
@@ -7599,7 +7759,7 @@ function cacheUpdateInfo(value, ttlMs = UPDATE_CACHE_TTL_MS) {
 }
 
 // src/cli.tsx
-var cliVersion = "0.16.0";
+var cliVersion = "0.17.1";
 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.16.0",
+  "version": "0.17.1",
   "type": "module",
   "bin": {
     "link-cli": "./dist/cli.js"
@@ -45,7 +45,7 @@
     "tsx": "^4.23.5",
     "typescript": "^5.9.3",
     "vitest": "^4.1.10",
-    "@stripe/link-sdk": "0.2.1",
+    "@stripe/link-sdk": "0.3.1",
     "@stripe/link-typescript-config": "0.0.0"
   },
   "scripts": {