@usethrottle/payment-methods 0.1.0

package/CLAUDE.md

@@ -0,0 +1,44 @@
+# `@usethrottle/payment-methods`
+
+Drop-in saved-card wallet (list, add, set default, remove) for Throttle storefronts. Headless core + React component.
+
+## Package purpose
+
+Wraps the Plan-1 `/api/v1/me/payment-methods*` browser routes and the `/api/v1/payment-methods/client-token` + `/api/v1/customers/:id/payment-methods*` server routes behind a typed SDK.
+
+## Entry points
+
+| Import path                                | Environment  | What it exports                                                                 |
+|--------------------------------------------|--------------|---------------------------------------------------------------------------------|
+| `@usethrottle/payment-methods`             | browser/React | `createPaymentMethods`, `usePaymentMethods`, `<PaymentMethods>`, types, errors  |
+| `@usethrottle/payment-methods/server`      | Node.js only  | `mintClientToken`, `createServerPaymentMethods`                                 |
+
+Never import from `./server` in browser bundles — it only uses `./request`, `./types`, and `./errors`, but the path convention signals server-only intent to bundlers and reviewers.
+
+## SSR isolation rule
+
+`@gr4vy/embed-react` accesses browser globals at module evaluation time. It must NEVER be imported eagerly.
+
+- `PaymentMethods.tsx` loads `Gr4vyAddCard` via `React.lazy()` only. Do not hoist that import.
+- In Next.js, consumers must wrap `<PaymentMethods>` with `dynamic(() => import(...), { ssr: false })` at any route that SSRs.
+- Tests use jsdom (vitest), which does not provide real browser globals — mock `@gr4vy/embed-react` as needed.
+
+## Test conventions
+
+- Runner: **vitest** + **jsdom** (`vitest.config.ts`).
+- Run: `pnpm --filter @usethrottle/payment-methods test`.
+- Typecheck: `pnpm --filter @usethrottle/payment-methods typecheck`.
+- Build: `pnpm --filter @usethrottle/payment-methods build` (tsup, dual CJS + ESM, server subpath).
+
+## API routes consumed
+
+| Route                                              | Auth                         | Used by                         |
+|----------------------------------------------------|------------------------------|---------------------------------|
+| `POST /api/v1/payment-methods/client-token`        | `X-API-Key` (`sk_*`)         | `mintClientToken`               |
+| `GET /api/v1/me/payment-methods`                   | `X-Throttle-PM-Token`        | `client.list`, hook, component  |
+| `PATCH /api/v1/me/payment-methods/:id`             | `X-Throttle-PM-Token`        | `client.setDefault`             |
+| `DELETE /api/v1/me/payment-methods/:id`            | `X-Throttle-PM-Token`        | `client.remove`                 |
+| `POST /api/v1/me/payment-methods/embed-token`      | `X-Throttle-PM-Token`        | `client.startAddCard`           |
+| `GET /api/v1/customers/:id/payment-methods`        | `X-API-Key` (`sk_*`)         | `createServerPaymentMethods.list` |
+| `PATCH /api/v1/customers/:id/payment-methods/:id`  | `X-API-Key` (`sk_*`)         | `createServerPaymentMethods.setDefault` |
+| `DELETE /api/v1/customers/:id/payment-methods/:id` | `X-API-Key` (`sk_*`)         | `createServerPaymentMethods.remove` |

package/README.md

@@ -0,0 +1,258 @@
+# `@usethrottle/payment-methods`
+
+Drop-in saved-card wallet for Throttle storefronts. Headless core + React component + server helpers.
+
+## Install
+
+```bash
+npm install @usethrottle/payment-methods
+# or
+pnpm add @usethrottle/payment-methods
+```
+
+React and `react-dom` are peer dependencies (>=18).
+
+---
+
+## How it works
+
+1. **Backend** calls `mintClientToken` (from `@usethrottle/payment-methods/server`) using your secret key. It returns a short-lived JWT scoped to one customer.
+2. **Frontend** passes that token to `<PaymentMethods clientToken={token} />` (or the headless `createPaymentMethods` / `usePaymentMethods`). The token authorises all card management operations — your secret key never reaches the browser.
+
+```
+Your Backend  ──POST /api/v1/payment-methods/client-token──►  Throttle API
+                ◄── { token, expiresAt } ──────────────────────
+Your Backend  ──{ token }──────────────────────────────────►  Browser
+Browser       ──<PaymentMethods clientToken={token} />──────►  wallet UI
+```
+
+---
+
+## Backend: mint a client token
+
+```ts
+// app/api/pm-token/route.ts  (Next.js App Router)
+import { mintClientToken } from '@usethrottle/payment-methods/server';
+
+export async function POST(request: Request) {
+  const user = await getAuthUser(request); // your own auth
+  if (!user) return new Response(null, { status: 401 });
+
+  const customerId = await resolveThrottleCustomerId(user.id); // cus_*
+
+  const { token, expiresAt } = await mintClientToken({
+    apiKey: process.env.THROTTLE_SECRET_KEY!,
+    customerId,
+    // baseUrl?: 'https://api.usethrottle.dev'  (default)
+    // environmentId?: 'env_...'               (omit to use key default)
+  });
+
+  return Response.json({ token, expiresAt });
+}
+```
+
+`mintClientToken` options:
+
+| Option          | Type   | Required | Description                                              |
+|-----------------|--------|----------|----------------------------------------------------------|
+| `apiKey`        | string | yes      | Your `sk_*` secret key.                                  |
+| `customerId`    | string | yes      | Throttle customer ID (`cus_*`).                          |
+| `baseUrl`       | string | no       | API base URL (defaults to `https://api.usethrottle.dev`).|
+| `environmentId` | string | no       | Override the environment derived from the key.           |
+
+Returns `{ token: string; expiresAt: string }`.
+
+---
+
+## Frontend: React component
+
+```tsx
+// components/Wallet.tsx
+'use client';
+
+import dynamic from 'next/dynamic';
+
+const PaymentMethods = dynamic(
+  () => import('@usethrottle/payment-methods').then((m) => m.PaymentMethods),
+  { ssr: false },
+);
+
+export function Wallet({ clientToken }: { clientToken: string }) {
+  return (
+    <PaymentMethods
+      clientToken={clientToken}
+      theme={{
+        colorPrimary: '#1D56E8',
+        colorText: '#111827',
+        colorBorder: '#E5E7EB',
+        borderRadius: '8px',
+      }}
+      onChange={(cards) => console.log('cards updated', cards)}
+    />
+  );
+}
+```
+
+### `<PaymentMethods>` props
+
+| Prop          | Type                    | Required | Description                                                            |
+|---------------|-------------------------|----------|------------------------------------------------------------------------|
+| `clientToken` | string                  | yes      | Short-lived token from `mintClientToken`.                              |
+| `baseUrl`     | string                  | no       | API base URL override.                                                 |
+| `theme`       | `PaymentMethodsTheme`   | no       | Colour + radius tokens (see table below).                              |
+| `onChange`    | `(cards: SavedCard[]) => void` | no | Fires after every list change (initial load, set default, remove, add card). |
+
+### `PaymentMethodsTheme` tokens
+
+| Token           | Default     | Description             |
+|-----------------|-------------|-------------------------|
+| `colorPrimary`  | `#1D56E8`   | Accent / button colour. |
+| `colorText`     | `#111827`   | Body text colour.       |
+| `colorBorder`   | `#E5E7EB`   | Card border colour.     |
+| `borderRadius`  | `8px`       | Corner radius.          |
+
+### SSR note
+
+`@gr4vy/embed-react` uses browser globals. Always render `<PaymentMethods>` in a client component (`'use client'`) **and** wrap it with `dynamic(..., { ssr: false })` at any route that server-renders. The component itself lazy-loads the Gr4vy embed internally, so it is safe inside a client component; the `dynamic` guard prevents the module from being evaluated during SSR.
+
+---
+
+## Frontend: headless hook
+
+```tsx
+'use client';
+
+import { usePaymentMethods } from '@usethrottle/payment-methods';
+
+export function CardList({ clientToken }: { clientToken: string }) {
+  const { cards, isLoading, error, setDefault, remove, addCard } =
+    usePaymentMethods({ clientToken });
+
+  if (isLoading) return <p>Loading...</p>;
+  if (error) return <p style={{ color: 'red' }}>{error.message}</p>;
+
+  return (
+    <ul>
+      {cards.map((card) => (
+        <li key={card.id}>
+          {card.cardBrand} .... {card.cardLastFour}
+          {!card.isDefault && (
+            <>
+              <button onClick={() => setDefault(card.id)}>Make default</button>
+              <button onClick={() => remove(card.id)}>Remove</button>
+            </>
+          )}
+        </li>
+      ))}
+      <li>
+        <button onClick={() => addCard().then((payload) => console.log(payload)).catch(console.error)}>
+          + Add card
+        </button>
+      </li>
+    </ul>
+  );
+}
+```
+
+`usePaymentMethods` returns:
+
+| Key         | Type                                  | Description                                                         |
+|-------------|---------------------------------------|---------------------------------------------------------------------|
+| `cards`     | `SavedCard[]`                         | Current list of saved cards.                                        |
+| `isLoading` | boolean                               | True while the initial list is fetching.                            |
+| `error`     | `ThrottlePaymentMethodsError \| null` | Last error, or `null`.                                              |
+| `setDefault`| `(id: string) => Promise<void>`       | Promote a card to default; refetches list on success.               |
+| `remove`    | `(id: string) => Promise<void>`       | Remove a card; refetches list on success.                           |
+| `addCard`   | `() => Promise<EmbedPayload>`         | Fetches a Gr4vy add-only embed payload for the card-add UI. Unlike `setDefault`/`remove`, it does **not** route failures into `error` — `await` it in a `try/catch` (the `<PaymentMethods>` component does this for you). |
+| `refetch`   | `() => Promise<void>`                 | Manually re-fetches the list.                                       |
+
+---
+
+## Frontend: headless client (no React)
+
+```ts
+import { createPaymentMethods } from '@usethrottle/payment-methods';
+
+const client = createPaymentMethods({ clientToken: token });
+
+const cards = await client.list();
+await client.setDefault('cpm_...');
+await client.remove('cpm_...');
+const embedPayload = await client.startAddCard();
+```
+
+`createPaymentMethods({ clientToken, baseUrl? })` returns `{ list, setDefault, remove, startAddCard }`.
+
+---
+
+## Backend: server CRUD
+
+Use `createServerPaymentMethods` when your backend needs to manage a customer's cards directly (e.g. admin tooling), without a browser session.
+
+```ts
+import { createServerPaymentMethods } from '@usethrottle/payment-methods/server';
+
+const server = createServerPaymentMethods({
+  apiKey: process.env.THROTTLE_SECRET_KEY!,
+  customerId: 'cus_...',
+});
+
+const cards = await server.list();
+await server.setDefault('cpm_...');
+await server.remove('cpm_...');
+// Note: startAddCard is not available on the server client —
+// the Gr4vy embed flow is inherently browser-side.
+```
+
+`createServerPaymentMethods` options match `mintClientToken` (`apiKey`, `customerId`, `baseUrl?`, `environmentId?`).
+
+---
+
+## Error handling
+
+All errors thrown by this package are instances of `ThrottlePaymentMethodsError` (extends `ThrottleError`):
+
+```ts
+import { isThrottleError, ThrottlePaymentMethodsError } from '@usethrottle/payment-methods';
+
+try {
+  await client.remove(cardId);
+} catch (err) {
+  if (err instanceof ThrottlePaymentMethodsError) {
+    if (err.code === 'cannot_remove_default') {
+      // 409 — buyer must set another card as default first
+      alert('Set another card as default before removing this one.');
+    } else {
+      console.error(err.code, err.message, err.statusCode);
+    }
+  }
+}
+
+// isThrottleError also works (catches both ThrottleError and ThrottlePaymentMethodsError):
+if (isThrottleError(err)) { /* … */ }
+```
+
+Common error codes:
+
+| Status | Code                    | When                                                                 |
+|--------|-------------------------|----------------------------------------------------------------------|
+| 401    | `unauthorized`          | Token missing, malformed, or expired. Mint a fresh token and retry. |
+| 403    | `forbidden`             | PM token used outside the `/me/payment-methods` surface.            |
+| 404    | `not_found`             | Card ID not found or already removed.                                |
+| 409    | `cannot_remove_default` | Removing the default card while an active subscription is attached. |
+
+---
+
+## `SavedCard` shape
+
+```ts
+interface SavedCard {
+  id: string;             // "cpm_*"
+  methodType: string;     // "card" in v1
+  cardBrand: string | null;      // "visa" | "mastercard" | "amex" | ...
+  cardLastFour: string | null;   // "4242"
+  cardExpMonth: number | null;   // 1-12
+  cardExpYear: number | null;    // 4-digit year
+  isDefault: boolean;
+}
+```

package/dist/Gr4vyAddCard-J3HC6KTK.js

@@ -0,0 +1,87 @@
+// src/Gr4vyAddCard.tsx
+import { useRef } from "react";
+import Gr4vyEmbed from "@gr4vy/embed-react";
+import { jsx, jsxs } from "react/jsx-runtime";
+function Gr4vyAddCard({ payload, theme, onAdded, onCancel, onError }) {
+  const embedRef = useRef(null);
+  const colors = theme ? {
+    ...theme.colorPrimary !== void 0 ? { primary: theme.colorPrimary } : {},
+    ...theme.colorText !== void 0 ? { text: theme.colorText } : {},
+    ...theme.colorBorder !== void 0 ? { inputBorder: theme.colorBorder } : {}
+  } : {};
+  const gr4vyTheme = Object.keys(colors).length ? { colors } : void 0;
+  return /* @__PURE__ */ jsxs("div", { children: [
+    /* @__PURE__ */ jsx(
+      Gr4vyEmbed,
+      {
+        ref: embedRef,
+        gr4vyId: payload.gr4vyId,
+        environment: payload.environment,
+        token: payload.embedToken,
+        amount: payload.amount,
+        currency: payload.currency,
+        merchantAccountId: payload.merchantAccountId,
+        intent: "capture",
+        paymentSource: "recurring",
+        store: true,
+        display: "addOnly",
+        ...gr4vyTheme !== void 0 ? { theme: gr4vyTheme } : {},
+        onComplete: (txn) => {
+          onAdded(txn.paymentMethod?.id);
+        },
+        onEvent: (eventName, data) => {
+          if (eventName === "transactionFailed") {
+            onError(data);
+          }
+        }
+      }
+    ),
+    /* @__PURE__ */ jsx(
+      "button",
+      {
+        type: "button",
+        onClick: () => {
+          embedRef.current?.submit();
+        },
+        style: {
+          marginTop: "12px",
+          padding: "8px 16px",
+          backgroundColor: theme?.colorPrimary ?? "#1D56E8",
+          color: "#fff",
+          border: "none",
+          borderRadius: "8px",
+          fontSize: "14px",
+          fontWeight: 600,
+          cursor: "pointer",
+          width: "100%"
+        },
+        children: "Save card"
+      }
+    ),
+    /* @__PURE__ */ jsx(
+      "button",
+      {
+        type: "button",
+        onClick: onCancel,
+        style: {
+          marginTop: "8px",
+          padding: "8px 16px",
+          backgroundColor: "transparent",
+          color: theme?.colorText ?? "#111827",
+          border: `1px solid ${theme?.colorBorder ?? "#E5E7EB"}`,
+          borderRadius: "8px",
+          fontSize: "14px",
+          cursor: "pointer",
+          width: "100%"
+        },
+        children: "Cancel"
+      }
+    )
+  ] });
+}
+var Gr4vyAddCard_default = Gr4vyAddCard;
+export {
+  Gr4vyAddCard,
+  Gr4vyAddCard_default as default
+};
+//# sourceMappingURL=Gr4vyAddCard-J3HC6KTK.js.map

package/dist/Gr4vyAddCard-J3HC6KTK.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/Gr4vyAddCard.tsx"],"sourcesContent":["/**\n * Gr4vyAddCard — lazy-loaded vault-only embed wrapper.\n *\n * THIS FILE MUST ONLY BE LOADED VIA React.lazy(() => import('./Gr4vyAddCard'))\n * from PaymentMethods.tsx. Never import it at the module top-level of any file\n * that is part of the server bundle — @gr4vy/embed-react touches `window` at\n * module evaluation time and will throw `ReferenceError: window is not defined`\n * in SSR contexts.\n */\nimport React, { useRef } from 'react';\nimport Gr4vyEmbed, { type EmbedInstance } from '@gr4vy/embed-react';\nimport type { EmbedPayload, PaymentMethodsTheme } from './types';\n\ninterface Gr4vyTransaction {\n  id: string;\n  status: string;\n  paymentMethod?: { id?: string };\n}\n\nexport interface Gr4vyAddCardProps {\n  payload: EmbedPayload;\n  theme?: PaymentMethodsTheme;\n  onAdded: (paymentMethodId?: string) => void;\n  onCancel: () => void;\n  onError: (err: unknown) => void;\n}\n\nexport function Gr4vyAddCard({ payload, theme, onAdded, onCancel, onError }: Gr4vyAddCardProps) {\n  const embedRef = useRef<EmbedInstance>(null);\n\n  const colors = theme\n    ? {\n        ...(theme.colorPrimary !== undefined ? { primary: theme.colorPrimary } : {}),\n        ...(theme.colorText !== undefined ? { text: theme.colorText } : {}),\n        ...(theme.colorBorder !== undefined ? { inputBorder: theme.colorBorder } : {}),\n      }\n    : {};\n  const gr4vyTheme = Object.keys(colors).length ? { colors } : undefined;\n\n  return (\n    <div>\n      <Gr4vyEmbed\n        ref={embedRef}\n        gr4vyId={payload.gr4vyId}\n        environment={payload.environment}\n        token={payload.embedToken}\n        amount={payload.amount}\n        currency={payload.currency}\n        merchantAccountId={payload.merchantAccountId}\n        intent=\"capture\"\n        paymentSource=\"recurring\"\n        store={true}\n        display=\"addOnly\"\n        {...(gr4vyTheme !== undefined ? { theme: gr4vyTheme } : {})}\n        onComplete={(txn: Gr4vyTransaction) => {\n          onAdded(txn.paymentMethod?.id);\n        }}\n        onEvent={(eventName: string, data: unknown) => {\n          if (eventName === 'transactionFailed') {\n            onError(data);\n          }\n        }}\n      />\n\n      <button\n        type=\"button\"\n        onClick={() => {\n          embedRef.current?.submit();\n        }}\n        style={{\n          marginTop: '12px',\n          padding: '8px 16px',\n          backgroundColor: theme?.colorPrimary ?? '#1D56E8',\n          color: '#fff',\n          border: 'none',\n          borderRadius: '8px',\n          fontSize: '14px',\n          fontWeight: 600,\n          cursor: 'pointer',\n          width: '100%',\n        }}\n      >\n        Save card\n      </button>\n\n      <button\n        type=\"button\"\n        onClick={onCancel}\n        style={{\n          marginTop: '8px',\n          padding: '8px 16px',\n          backgroundColor: 'transparent',\n          color: theme?.colorText ?? '#111827',\n          border: `1px solid ${theme?.colorBorder ?? '#E5E7EB'}`,\n          borderRadius: '8px',\n          fontSize: '14px',\n          cursor: 'pointer',\n          width: '100%',\n        }}\n      >\n        Cancel\n      </button>\n    </div>\n  );\n}\n\nexport default Gr4vyAddCard;\n"],"mappings":";AASA,SAAgB,cAAc;AAC9B,OAAO,gBAAwC;AA8B3C,SACE,KADF;AAbG,SAAS,aAAa,EAAE,SAAS,OAAO,SAAS,UAAU,QAAQ,GAAsB;AAC9F,QAAM,WAAW,OAAsB,IAAI;AAE3C,QAAM,SAAS,QACX;AAAA,IACE,GAAI,MAAM,iBAAiB,SAAY,EAAE,SAAS,MAAM,aAAa,IAAI,CAAC;AAAA,IAC1E,GAAI,MAAM,cAAc,SAAY,EAAE,MAAM,MAAM,UAAU,IAAI,CAAC;AAAA,IACjE,GAAI,MAAM,gBAAgB,SAAY,EAAE,aAAa,MAAM,YAAY,IAAI,CAAC;AAAA,EAC9E,IACA,CAAC;AACL,QAAM,aAAa,OAAO,KAAK,MAAM,EAAE,SAAS,EAAE,OAAO,IAAI;AAE7D,SACE,qBAAC,SACC;AAAA;AAAA,MAAC;AAAA;AAAA,QACC,KAAK;AAAA,QACL,SAAS,QAAQ;AAAA,QACjB,aAAa,QAAQ;AAAA,QACrB,OAAO,QAAQ;AAAA,QACf,QAAQ,QAAQ;AAAA,QAChB,UAAU,QAAQ;AAAA,QAClB,mBAAmB,QAAQ;AAAA,QAC3B,QAAO;AAAA,QACP,eAAc;AAAA,QACd,OAAO;AAAA,QACP,SAAQ;AAAA,QACP,GAAI,eAAe,SAAY,EAAE,OAAO,WAAW,IAAI,CAAC;AAAA,QACzD,YAAY,CAAC,QAA0B;AACrC,kBAAQ,IAAI,eAAe,EAAE;AAAA,QAC/B;AAAA,QACA,SAAS,CAAC,WAAmB,SAAkB;AAC7C,cAAI,cAAc,qBAAqB;AACrC,oBAAQ,IAAI;AAAA,UACd;AAAA,QACF;AAAA;AAAA,IACF;AAAA,IAEA;AAAA,MAAC;AAAA;AAAA,QACC,MAAK;AAAA,QACL,SAAS,MAAM;AACb,mBAAS,SAAS,OAAO;AAAA,QAC3B;AAAA,QACA,OAAO;AAAA,UACL,WAAW;AAAA,UACX,SAAS;AAAA,UACT,iBAAiB,OAAO,gBAAgB;AAAA,UACxC,OAAO;AAAA,UACP,QAAQ;AAAA,UACR,cAAc;AAAA,UACd,UAAU;AAAA,UACV,YAAY;AAAA,UACZ,QAAQ;AAAA,UACR,OAAO;AAAA,QACT;AAAA,QACD;AAAA;AAAA,IAED;AAAA,IAEA;AAAA,MAAC;AAAA;AAAA,QACC,MAAK;AAAA,QACL,SAAS;AAAA,QACT,OAAO;AAAA,UACL,WAAW;AAAA,UACX,SAAS;AAAA,UACT,iBAAiB;AAAA,UACjB,OAAO,OAAO,aAAa;AAAA,UAC3B,QAAQ,aAAa,OAAO,eAAe,SAAS;AAAA,UACpD,cAAc;AAAA,UACd,UAAU;AAAA,UACV,QAAQ;AAAA,UACR,OAAO;AAAA,QACT;AAAA,QACD;AAAA;AAAA,IAED;AAAA,KACF;AAEJ;AAEA,IAAO,uBAAQ;","names":[]}

package/dist/chunk-T2CV3T5K.js

@@ -0,0 +1,49 @@
+// src/errors.ts
+import { ThrottleError } from "@usethrottle/errors";
+import { ThrottleError as ThrottleError2, isThrottleError } from "@usethrottle/errors";
+var ThrottlePaymentMethodsError = class extends ThrottleError {
+  constructor(args) {
+    super(args);
+    this.name = "ThrottlePaymentMethodsError";
+  }
+};
+
+// src/types.ts
+var DEFAULT_BASE_URL = "https://api.usethrottle.dev";
+
+// src/request.ts
+async function request(input) {
+  const res = await fetch(`${input.baseUrl}${input.path}`, {
+    method: input.method,
+    headers: {
+      ...input.body !== void 0 ? { "Content-Type": "application/json" } : {},
+      ...input.headers ?? {}
+    },
+    ...input.body !== void 0 ? { body: JSON.stringify(input.body) } : {}
+  });
+  const text = await res.text();
+  let parsed = {};
+  try {
+    parsed = text ? JSON.parse(text) : {};
+  } catch {
+  }
+  if (!res.ok) {
+    const e = parsed?.error ?? {};
+    throw new ThrottlePaymentMethodsError({
+      code: e.code ?? "request_failed",
+      message: e.message ?? `Request failed with ${res.status}`,
+      statusCode: res.status,
+      details: e.details
+    });
+  }
+  return parsed;
+}
+
+export {
+  ThrottlePaymentMethodsError,
+  ThrottleError2 as ThrottleError,
+  isThrottleError,
+  DEFAULT_BASE_URL,
+  request
+};
+//# sourceMappingURL=chunk-T2CV3T5K.js.map

package/dist/chunk-T2CV3T5K.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/types.ts","../src/request.ts"],"sourcesContent":["import { ThrottleError } from '@usethrottle/errors';\n\nexport class ThrottlePaymentMethodsError extends ThrottleError {\n  constructor(args: { code: string; message: string; statusCode: number; details?: unknown }) {\n    super(args);\n    this.name = 'ThrottlePaymentMethodsError';\n  }\n}\n\nexport { ThrottleError, isThrottleError } from '@usethrottle/errors';\n","export interface SavedCard {\n  id: string;\n  methodType: string;\n  cardBrand: string | null;\n  cardLastFour: string | null;\n  cardExpMonth: number | null;\n  cardExpYear: number | null;\n  isDefault: boolean;\n}\n\nexport interface EmbedPayload {\n  embedToken: string;\n  checkoutSessionId: string;\n  amount: number;\n  currency: string;\n  gr4vyId: string;\n  merchantAccountId?: string;\n  environment: 'sandbox' | 'production';\n  hostedUrl?: string;\n  embedUrl?: string;\n}\n\nexport interface MintedClientToken {\n  token: string;\n  expiresAt: string;\n}\n\nexport interface PaymentMethodsTheme {\n  colorPrimary?: string;\n  colorText?: string;\n  colorBorder?: string;\n  borderRadius?: string;\n}\n\nexport const DEFAULT_BASE_URL = 'https://api.usethrottle.dev';\n","import { ThrottlePaymentMethodsError } from './errors';\n\nexport async function request(input: {\n  method: string;\n  path: string;\n  baseUrl: string;\n  headers?: Record<string, string>;\n  body?: unknown;\n}): Promise<any> {\n  const res = await fetch(`${input.baseUrl}${input.path}`, {\n    method: input.method,\n    headers: {\n      ...(input.body !== undefined ? { 'Content-Type': 'application/json' } : {}),\n      ...(input.headers ?? {}),\n    },\n    ...(input.body !== undefined ? { body: JSON.stringify(input.body) } : {}),\n  });\n  const text = await res.text();\n  let parsed: any = {};\n  try {\n    parsed = text ? JSON.parse(text) : {};\n  } catch {\n    // Non-JSON body (e.g. an HTML 502/503 gateway page). Leave parsed as {} so\n    // the non-2xx branch below still throws a typed ThrottlePaymentMethodsError\n    // (code 'request_failed') rather than leaking a raw SyntaxError.\n  }\n  if (!res.ok) {\n    const e = parsed?.error ?? {};\n    throw new ThrottlePaymentMethodsError({\n      code: e.code ?? 'request_failed',\n      message: e.message ?? `Request failed with ${res.status}`,\n      statusCode: res.status,\n      details: e.details,\n    });\n  }\n  return parsed;\n}\n"],"mappings":";AAAA,SAAS,qBAAqB;AAS9B,SAAS,iBAAAA,gBAAe,uBAAuB;AAPxC,IAAM,8BAAN,cAA0C,cAAc;AAAA,EAC7D,YAAY,MAAgF;AAC1F,UAAM,IAAI;AACV,SAAK,OAAO;AAAA,EACd;AACF;;;AC2BO,IAAM,mBAAmB;;;AChChC,eAAsB,QAAQ,OAMb;AACf,QAAM,MAAM,MAAM,MAAM,GAAG,MAAM,OAAO,GAAG,MAAM,IAAI,IAAI;AAAA,IACvD,QAAQ,MAAM;AAAA,IACd,SAAS;AAAA,MACP,GAAI,MAAM,SAAS,SAAY,EAAE,gBAAgB,mBAAmB,IAAI,CAAC;AAAA,MACzE,GAAI,MAAM,WAAW,CAAC;AAAA,IACxB;AAAA,IACA,GAAI,MAAM,SAAS,SAAY,EAAE,MAAM,KAAK,UAAU,MAAM,IAAI,EAAE,IAAI,CAAC;AAAA,EACzE,CAAC;AACD,QAAM,OAAO,MAAM,IAAI,KAAK;AAC5B,MAAI,SAAc,CAAC;AACnB,MAAI;AACF,aAAS,OAAO,KAAK,MAAM,IAAI,IAAI,CAAC;AAAA,EACtC,QAAQ;AAAA,EAIR;AACA,MAAI,CAAC,IAAI,IAAI;AACX,UAAM,IAAI,QAAQ,SAAS,CAAC;AAC5B,UAAM,IAAI,4BAA4B;AAAA,MACpC,MAAM,EAAE,QAAQ;AAAA,MAChB,SAAS,EAAE,WAAW,uBAAuB,IAAI,MAAM;AAAA,MACvD,YAAY,IAAI;AAAA,MAChB,SAAS,EAAE;AAAA,IACb,CAAC;AAAA,EACH;AACA,SAAO;AACT;","names":["ThrottleError"]}