@usethrottle/mcp 0.4.1 → 0.4.3

package/dist/lib.cjs

@@ -20,13 +20,24 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/lib.ts
 var lib_exports = {};
 __export(lib_exports, {
+  CURRENCIES: () => CURRENCIES,
   ThrottleClient: () => ThrottleClient,
+  UnknownCurrencyError: () => UnknownCurrencyError,
   VERSION: () => VERSION,
   buildInstructions: () => buildInstructions,
   createServer: () => createServer,
+  currencySymbol: () => currencySymbol,
+  formatMoney: () => formatMoney,
+  isKnownCurrency: () => isKnownCurrency,
   loadContractIndex: () => loadContractIndex,
   loadDocsIndex: () => loadDocsIndex,
-  registerableActions: () => registerableActions
+  minorUnitsOf: () => minorUnitsOf,
+  money: () => dist_exports,
+  moneyValue: () => moneyValue,
+  parseMoney: () => parseMoney,
+  registerableActions: () => registerableActions,
+  toDecimalString: () => toDecimalString,
+  toMinor: () => toMinor
 });
 module.exports = __toCommonJS(lib_exports);
 
@@ -94,6 +105,8 @@ add("Customers", "customers", ["read", "write"], { read: "View customers", write
 add("Customers", "customer_pii", ["read"], { read: "View customer PII" }, { sensitive: true });
 add("Customers", "customer_addresses", ["read", "write"], { read: "View addresses", write: "Manage addresses" });
 add("Customers", "customer_payment_methods", ["read", "write"], { read: "View stored cards", write: "Manage stored cards" }, { sensitive: true });
+add("Customers", "customer_tokens", ["read"], { read: "Check shoppers' sign-in tokens" });
+add("Customers", "customer_directory", ["read"], { read: "Find customers by name or email" }, { sensitive: true });
 add(
   "Customer accounts",
   "customer_accounts",
@@ -226,6 +239,7 @@ var EVENT_SCOPE_OVERRIDES = {
   "subscription.invoice_refunded": "payment_refunds:read",
   "payment.disputed": "payment_disputes:read",
   "payment.dispute_cleared": "payment_disputes:read",
+  "payment.dispute_lost": "payment_disputes:read",
   "fulfillment.digital.delivered": "fulfillment_digital:read"
 };
 var PREFIX_RULES = [
@@ -534,7 +548,7 @@ var ACTIONS = [
   {
     id: "search_customers",
     title: "Search customers",
-    description: "Find customers by name, email or external id, or list them by creation date. Over an OAuth connection (ChatGPT, Claude) text search is not available \u2014 list by date instead \u2014 because every field it could match is withheld there.",
+    description: "Find customers by name, company, email or external id, or list them by creation date. Over an OAuth connection (ChatGPT, Claude) text search is not available \u2014 list by date instead \u2014 because every field it could match is withheld there.",
     kind: "read",
     scopes: ["customers:read"],
     input: [
@@ -1379,7 +1393,7 @@ var ACTIONS = [
   {
     id: "create_customer",
     title: "Create a customer",
-    description: "Create a customer record. Use search_customers first if the buyer may already exist \u2014 this does not de-duplicate by email.",
+    description: "Create a customer record. Email and externalId are each unique per application: a value that already belongs to a customer fails with 409 customer_already_exists rather than returning the existing record, so use search_customers first if the buyer may already exist.",
     kind: "write",
     scopes: ["customers:write"],
     input: [
@@ -1457,7 +1471,7 @@ var ACTIONS = [
   {
     id: "create_checkout_link",
     title: "Create a checkout link",
-    description: "Build a cart from line items and return a hosted checkout URL the buyer can pay at. Prices are in minor units (2500 = $25.00).",
+    description: "Build a cart from line items and return a hosted checkout URL the buyer can pay at. Prices are integers in the minor units of the cart currency (2500 = 25.00 in a two-decimal currency).",
     kind: "write",
     scopes: ["carts:write", "cart_items:write", "checkout_sessions:write"],
     input: [
@@ -1611,6 +1625,29 @@ var ACTIONS = [
     channels: ["mcp", "zapier", "make", "n8n"],
     idempotent: true
   },
+  {
+    id: "set_subscription_payment_method",
+    title: "Change a subscription's card",
+    description: "Set the saved card one subscription renews on. Only that subscription moves; the customer's default card and their other subscriptions stay as they are. Nothing is charged now.",
+    kind: "write",
+    scopes: ["subscriptions:write"],
+    input: [
+      { name: "id", type: "string", required: true, description: "Subscription id." },
+      {
+        name: "paymentMethodId",
+        type: "string",
+        required: true,
+        description: "One of the subscription customer's saved cards (GET /api/v1/customers/:id/payment-methods): active and in date."
+      }
+    ],
+    requests: [{ method: "PATCH", path: "/api/v1/subscriptions/:id/payment-method" }],
+    channels: ["mcp", "zapier", "make", "n8n"],
+    idempotent: true,
+    guardrails: [
+      "Changes which card future renewals charge. Confirm the subscription and the card (brand, last four) with the user first.",
+      "409 payment_method_unusable: the card is not this customer's active, in-date saved card. 409 invalid_state: the subscription is cancelled or completed."
+    ]
+  },
   {
     id: "cancel_subscription",
     title: "Cancel a subscription",
@@ -2449,6 +2486,14 @@ var HANDLERS = {
       idempotencyKey: `mcp-manage-subscription-${id}-${action}-${Date.now()}`
     });
   },
+  set_subscription_payment_method: async (ctx, args) => {
+    const id = String(args.id);
+    return ctx.client.patch(`/api/v1/subscriptions/${id}/payment-method`, {
+      // `id` is the path parameter; the body is `.strict()`.
+      body: { paymentMethodId: args.paymentMethodId },
+      idempotencyKey: `mcp-set-subscription-card-${id}-${String(args.paymentMethodId)}-${Date.now()}`
+    });
+  },
   create_quote: async (ctx, args) => {
     const items = Array.isArray(args.items) ? args.items : [];
     if (args.netN !== void 0 && items.some((item) => item && item.recurring)) {
@@ -2713,6 +2758,7 @@ var DISPLAY_QUALIFIERS = [
   "Payment processing",
   "Disputed",
   "Authorization expired",
+  "Chargeback lost",
   "Returned",
   "Partially returned",
   "Delivered",
@@ -2790,6 +2836,8 @@ var PAYMENT = {
   cardBrand: S,
   disputed: S,
   disputeOpenedAt: S,
+  disputeOutcome: S,
+  disputeClosedAt: S,
   errorCode: S,
   netN: S,
   netNSource: S,
@@ -2852,6 +2900,10 @@ var SUBSCRIPTION = {
   pendingIntervalCount: S,
   scheduleTotal: S,
   nextPaymentAmount: S,
+  // A physical subscription (0236): the method is an enum, and the ship-to is
+  // kept to its country like every other address here.
+  deliveryMethod: S,
+  shippingAddress: ADDRESS,
   paymentSchedule: [{
     index: S,
     amount: S,
@@ -3228,7 +3280,7 @@ var OAUTH_PROJECTIONS = {
 };
 
 // src/server.ts
-var VERSION = true ? "0.4.1" : "0.0.0-dev";
+var VERSION = true ? "0.4.3" : "0.0.0-dev";
 function registerableActions(policy) {
   const isProduction = policy.identity.environment.providerEnvironment === "production";
   return actionsForChannel("mcp").filter((action) => {
@@ -3257,7 +3309,7 @@ function buildInstructions(identity, actions, policy) {
     '- The application can vary per call: pass "applicationId" on a read or analytics tool to reach a different application in this workspace, and call list_applications to see which ones this connection can reach. Omitting applicationId uses the application this connection was authorized for.',
     "- Every analytics result covers exactly ONE application and names it in `application`. Say which application a figure describes. If the user asks about their business as a whole and this connection reaches more than one application, do not answer from the default alone \u2014 call list_applications, then query each and add them up, or ask which application they mean.",
     '- List tools return { data, pagination }. When pagination.hasMore is true, pass pagination.cursor back as "cursor" rather than raising "limit".',
-    "- Amounts are integer minor units (2500 = $25.00).",
+    "- Amounts are integer minor units of the record's currency (2500 = 25.00 in a two-decimal currency; JPY has none, KWD has three).",
     "- Throttle rejects snake_case on public request bodies. Before writing integration code, confirm shapes with describe_endpoint and check bodies with validate_payload instead of guessing field names.",
     "- API errors come back as text with a stable code. On insufficient_scopes, tell the user which scope to add \u2014 do not retry.",
     "- Analytics results may mark a section `omitted`. That means UNKNOWN, never zero. When `grantable` is false the data cannot be read over this connection at all \u2014 say so rather than reporting an absence."
@@ -3394,14 +3446,332 @@ function loadDocsIndex() {
 function loadContractIndex() {
   return loadIndex("contract-index.json", { generatedAt: "", operations: [] }, "contract");
 }
+
+// ../money/dist/index.js
+var dist_exports = {};
+__export(dist_exports, {
+  CURRENCIES: () => CURRENCIES,
+  UNCONFIRMED_EXPONENT_CODES: () => UNCONFIRMED_EXPONENT_CODES,
+  UnknownCurrencyError: () => UnknownCurrencyError,
+  currencySymbol: () => currencySymbol,
+  formatMoney: () => formatMoney,
+  isEnableableCurrency: () => isEnableableCurrency,
+  isKnownCurrency: () => isKnownCurrency,
+  minorUnitsOf: () => minorUnitsOf,
+  moneyValue: () => moneyValue,
+  parseMoney: () => parseMoney,
+  toDecimalString: () => toDecimalString,
+  toMinor: () => toMinor
+});
+var CURRENCY_ROWS = [
+  ["AED", 2, "AED", false],
+  ["AFN", 2, "AFN", false],
+  ["ALL", 2, "ALL", false],
+  ["AMD", 2, "AMD", false],
+  ["AOA", 2, "AOA", false],
+  ["ARS", 2, "ARS", false],
+  ["AUD", 2, "A$", false],
+  ["AWG", 2, "AWG", false],
+  ["AZN", 2, "AZN", false],
+  ["BAM", 2, "BAM", false],
+  ["BBD", 2, "BBD", false],
+  ["BDT", 2, "BDT", false],
+  ["BHD", 3, "BHD", false],
+  ["BIF", 0, "BIF", false],
+  ["BMD", 2, "BMD", false],
+  ["BND", 2, "BND", false],
+  ["BOB", 2, "BOB", false],
+  ["BOV", 2, "BOV", true],
+  ["BRL", 2, "R$", false],
+  ["BSD", 2, "BSD", false],
+  ["BTN", 2, "BTN", false],
+  ["BWP", 2, "BWP", false],
+  ["BYN", 2, "BYN", false],
+  ["BZD", 2, "BZD", false],
+  ["CAD", 2, "CA$", false],
+  ["CDF", 2, "CDF", false],
+  ["CHE", 2, "CHE", true],
+  ["CHF", 2, "CHF", false],
+  ["CHW", 2, "CHW", true],
+  ["CLF", 4, "CLF", true],
+  ["CLP", 0, "CLP", false],
+  ["CNY", 2, "CN\xA5", false],
+  ["COP", 2, "COP", false],
+  ["COU", 2, "COU", true],
+  ["CRC", 2, "CRC", false],
+  ["CUP", 2, "CUP", false],
+  ["CVE", 2, "CVE", false],
+  ["CZK", 2, "CZK", false],
+  ["DJF", 0, "DJF", false],
+  ["DKK", 2, "DKK", false],
+  ["DOP", 2, "DOP", false],
+  ["DZD", 2, "DZD", false],
+  ["EGP", 2, "EGP", false],
+  ["ERN", 2, "ERN", false],
+  ["ETB", 2, "ETB", false],
+  ["EUR", 2, "\u20AC", false],
+  ["FJD", 2, "FJD", false],
+  ["FKP", 2, "FKP", false],
+  ["GBP", 2, "\xA3", false],
+  ["GEL", 2, "GEL", false],
+  ["GHS", 2, "GHS", false],
+  ["GIP", 2, "GIP", false],
+  ["GMD", 2, "GMD", false],
+  ["GNF", 0, "GNF", false],
+  ["GTQ", 2, "GTQ", false],
+  ["GYD", 2, "GYD", false],
+  ["HKD", 2, "HK$", false],
+  ["HNL", 2, "HNL", false],
+  ["HTG", 2, "HTG", false],
+  ["HUF", 2, "HUF", false],
+  ["IDR", 2, "IDR", false],
+  ["ILS", 2, "\u20AA", false],
+  ["INR", 2, "\u20B9", false],
+  ["IQD", 3, "IQD", false],
+  ["IRR", 2, "IRR", false],
+  ["ISK", 0, "ISK", false],
+  ["JMD", 2, "JMD", false],
+  ["JOD", 3, "JOD", false],
+  ["JPY", 0, "\xA5", false],
+  ["KES", 2, "KES", false],
+  ["KGS", 2, "KGS", false],
+  ["KHR", 2, "KHR", false],
+  ["KMF", 0, "KMF", false],
+  ["KPW", 2, "KPW", false],
+  ["KRW", 0, "\u20A9", false],
+  ["KWD", 3, "KWD", false],
+  ["KYD", 2, "KYD", false],
+  ["KZT", 2, "KZT", false],
+  ["LAK", 2, "LAK", false],
+  ["LBP", 2, "LBP", false],
+  ["LKR", 2, "LKR", false],
+  ["LRD", 2, "LRD", false],
+  ["LSL", 2, "LSL", false],
+  ["LYD", 3, "LYD", false],
+  ["MAD", 2, "MAD", false],
+  ["MDL", 2, "MDL", false],
+  ["MGA", 2, "MGA", false],
+  ["MKD", 2, "MKD", false],
+  ["MMK", 2, "MMK", false],
+  ["MNT", 2, "MNT", false],
+  ["MOP", 2, "MOP", false],
+  ["MRU", 2, "MRU", false],
+  ["MUR", 2, "MUR", false],
+  ["MVR", 2, "MVR", false],
+  ["MWK", 2, "MWK", false],
+  ["MXN", 2, "MX$", false],
+  ["MXV", 2, "MXV", true],
+  ["MYR", 2, "MYR", false],
+  ["MZN", 2, "MZN", false],
+  ["NAD", 2, "NAD", false],
+  ["NGN", 2, "NGN", false],
+  ["NIO", 2, "NIO", false],
+  ["NOK", 2, "NOK", false],
+  ["NPR", 2, "NPR", false],
+  ["NZD", 2, "NZ$", false],
+  ["OMR", 3, "OMR", false],
+  ["PAB", 2, "PAB", false],
+  ["PEN", 2, "PEN", false],
+  ["PGK", 2, "PGK", false],
+  ["PHP", 2, "\u20B1", false],
+  ["PKR", 2, "PKR", false],
+  ["PLN", 2, "PLN", false],
+  ["PYG", 0, "PYG", false],
+  ["QAR", 2, "QAR", false],
+  ["RON", 2, "RON", false],
+  ["RSD", 2, "RSD", false],
+  ["RUB", 2, "RUB", false],
+  ["RWF", 0, "RWF", false],
+  ["SAR", 2, "SAR", false],
+  ["SBD", 2, "SBD", false],
+  ["SCR", 2, "SCR", false],
+  ["SDG", 2, "SDG", false],
+  ["SEK", 2, "SEK", false],
+  ["SGD", 2, "SGD", false],
+  ["SHP", 2, "SHP", false],
+  ["SLE", 2, "SLE", false],
+  ["SOS", 2, "SOS", false],
+  ["SRD", 2, "SRD", false],
+  ["SSP", 2, "SSP", false],
+  ["STN", 2, "STN", false],
+  ["SVC", 2, "SVC", false],
+  ["SYP", 2, "SYP", false],
+  ["SZL", 2, "SZL", false],
+  ["THB", 2, "THB", false],
+  ["TJS", 2, "TJS", false],
+  ["TMT", 2, "TMT", false],
+  ["TND", 3, "TND", false],
+  ["TOP", 2, "TOP", false],
+  ["TRY", 2, "TRY", false],
+  ["TTD", 2, "TTD", false],
+  ["TWD", 2, "NT$", false],
+  ["TZS", 2, "TZS", false],
+  ["UAH", 2, "UAH", false],
+  ["UGX", 0, "UGX", false],
+  ["USD", 2, "$", false],
+  ["USN", 2, "USN", true],
+  ["UYI", 0, "UYI", true],
+  ["UYU", 2, "UYU", false],
+  ["UYW", 4, "UYW", true],
+  ["UZS", 2, "UZS", false],
+  ["VED", 2, "VED", false],
+  ["VES", 2, "VES", false],
+  ["VND", 0, "\u20AB", false],
+  ["VUV", 0, "VUV", false],
+  ["WST", 2, "WST", false],
+  ["XAD", 2, "XAD", true],
+  ["XAF", 0, "FCFA", false],
+  ["XCD", 2, "EC$", false],
+  ["XCG", 2, "Cg.", false],
+  ["XOF", 0, "F\u202FCFA", false],
+  ["XPF", 0, "CFPF", false],
+  ["YER", 2, "YER", false],
+  ["ZAR", 2, "ZAR", false],
+  ["ZMW", 2, "ZMW", false],
+  ["ZWG", 2, "ZWG", false]
+];
+var UnknownCurrencyError = class extends Error {
+  constructor(currency) {
+    super(`Unknown currency code: ${currency}`);
+    this.code = "unknown_currency";
+    this.name = "UnknownCurrencyError";
+    this.currency = currency;
+  }
+};
+var BY_CODE = new Map(
+  CURRENCY_ROWS.map(([code, minorUnits, symbol, fund]) => [code, { minorUnits, symbol, fund }])
+);
+var CURRENCIES = Object.freeze(
+  CURRENCY_ROWS.map(([code, minorUnits, symbol]) => Object.freeze({ code, minorUnits, symbol }))
+);
+var UNCONFIRMED = /* @__PURE__ */ new Set(["COP", "HUF", "IDR", "ISK", "TWD", "UGX"]);
+var UNCONFIRMED_EXPONENT_CODES = Object.freeze({
+  has: (code) => UNCONFIRMED.has(code),
+  get size() {
+    return UNCONFIRMED.size;
+  },
+  forEach: (fn, thisArg) => UNCONFIRMED.forEach((v) => fn.call(thisArg, v, v, UNCONFIRMED_EXPONENT_CODES)),
+  keys: () => UNCONFIRMED.keys(),
+  values: () => UNCONFIRMED.values(),
+  entries: () => UNCONFIRMED.entries(),
+  [Symbol.iterator]: () => UNCONFIRMED.values()
+});
+function currencyRow(code) {
+  return BY_CODE.get(code);
+}
+function isKnownCurrency(code) {
+  return BY_CODE.has(code);
+}
+function minorUnitsOf(code) {
+  const row = BY_CODE.get(code);
+  if (row === void 0) throw new UnknownCurrencyError(code);
+  return row.minorUnits;
+}
+function isEnableableCurrency(code) {
+  const row = BY_CODE.get(code);
+  return row !== void 0 && row.minorUnits !== 4 && !row.fund && !UNCONFIRMED.has(code);
+}
+var NBSP = "\xA0";
+function normalizeCode(code) {
+  return typeof code === "string" ? code.trim().toUpperCase() : "";
+}
+function displayExponent(normalizedCode) {
+  return currencyRow(normalizedCode)?.minorUnits ?? 2;
+}
+function roundHalfAwayFromZero(n) {
+  return n < 0 ? -Math.round(-n) : Math.round(n);
+}
+function decimalDigits(abs, exponent, grouped) {
+  const raw = Number.isSafeInteger(abs) ? String(abs) : BigInt(abs).toString();
+  const padded = raw.padStart(exponent + 1, "0");
+  const cut = padded.length - exponent;
+  let integer = padded.slice(0, cut);
+  if (grouped) integer = integer.replace(/\B(?=(\d{3})+(?!\d))/g, ",");
+  return exponent === 0 ? integer : `${integer}.${padded.slice(cut)}`;
+}
+function formatMoney(minor, code, opts) {
+  if (typeof minor !== "number" || !Number.isFinite(minor)) return "\u2014";
+  const c = normalizeCode(code);
+  const row = currencyRow(c);
+  const n = roundHalfAwayFromZero(minor);
+  const sign = n < 0 ? "-" : "";
+  const digits = decimalDigits(Math.abs(n), row?.minorUnits ?? 2, true);
+  if (c === "") return sign + digits;
+  if (row === void 0) return `${sign}${digits}${NBSP}${c}`;
+  const separator = new RegExp("\\p{Sc}$", "u").test(row.symbol) ? "" : NBSP;
+  const text = `${sign}${row.symbol}${separator}${digits}`;
+  return opts?.display === "symbol-code" && row.symbol !== c ? `${text}${NBSP}${c}` : text;
+}
+function currencySymbol(code) {
+  const c = normalizeCode(code);
+  return currencyRow(c)?.symbol ?? c;
+}
+function toDecimalString(minor, code) {
+  if (typeof minor !== "number" || !Number.isFinite(minor)) return "";
+  const n = roundHalfAwayFromZero(minor);
+  const sign = n < 0 ? "-" : "";
+  return sign + decimalDigits(Math.abs(n), displayExponent(normalizeCode(code)), false);
+}
+function moneyValue(amount, currency) {
+  return { amount, currency: normalizeCode(currency), display: formatMoney(amount, currency) };
+}
+function toMinorUnits(negative, integer, fraction, exponent) {
+  if (fraction.length > exponent) return null;
+  const n = Number(integer + fraction.padEnd(exponent, "0"));
+  if (!Number.isSafeInteger(n)) return null;
+  return negative && n !== 0 ? -n : n;
+}
+function toMinor(decimal, code) {
+  const text = typeof decimal === "number" ? String(decimal) : typeof decimal === "string" ? decimal : "";
+  const m = /^(-?)(\d+)(?:\.(\d+))?$/.exec(text);
+  if (m === null) return null;
+  return toMinorUnits(m[1] === "-", m[2], m[3] ?? "", displayExponent(normalizeCode(code)));
+}
+var SPACE = /^[ \u00A0]/;
+var TRAILING_SPACE = /[ \u00A0]$/;
+var AMOUNT = /^([1-9]\d{0,2}(?:,\d{3})+|\d+)(?:\.(\d+))?$/;
+function withoutMarker(text, markers) {
+  for (const marker of markers) {
+    if (text.startsWith(marker)) return text.slice(marker.length).replace(SPACE, "");
+  }
+  for (const marker of markers) {
+    if (text.endsWith(marker)) return text.slice(0, text.length - marker.length).replace(TRAILING_SPACE, "");
+  }
+  return text;
+}
+function parseMoney(text, code) {
+  if (typeof text !== "string") return null;
+  const c = normalizeCode(code);
+  let rest = text.trim();
+  const negative = rest.startsWith("-");
+  if (negative) rest = rest.slice(1);
+  if (c !== "") {
+    const symbol = currencySymbol(c);
+    rest = withoutMarker(rest, symbol === c ? [c] : [symbol, c]);
+  }
+  const m = AMOUNT.exec(rest);
+  if (m === null) return null;
+  return toMinorUnits(negative, m[1].replace(/,/g, ""), m[2] ?? "", displayExponent(c));
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  CURRENCIES,
   ThrottleClient,
+  UnknownCurrencyError,
   VERSION,
   buildInstructions,
   createServer,
+  currencySymbol,
+  formatMoney,
+  isKnownCurrency,
   loadContractIndex,
   loadDocsIndex,
-  registerableActions
+  minorUnitsOf,
+  money,
+  moneyValue,
+  parseMoney,
+  registerableActions,
+  toDecimalString,
+  toMinor
 });
 //# sourceMappingURL=lib.cjs.map