@volter/twin-stripe 3.0.0 → 3.0.1

package/spec/sources.json

@@ -1,4 +1,13 @@
 {
+  "archive:https://registry.npmjs.org/@stripe/stripe-js/-/stripe-js-8.6.0.tgz#sha256=13e61419e9076ab440cc636e34d3ea5df3fc62bbf2d6a80d3fd718e8cd47f0a2!/package/dist/stripe-js/checkout.d.ts": {
+    "status": 200,
+    "checked": "2026-10-03",
+    "sha256": "13e61419e9076ab440cc636e34d3ea5df3fc62bbf2d6a80d3fd718e8cd47f0a2",
+    "quotes": {
+      "export interface StripeCheckoutSession": true,
+      "loadActions: () => Promise<StripeCheckoutLoadActionsResult>": true
+    }
+  },
   "https://docs.stripe.com/api/authentication": {
     "status": 200,
     "checked": "2026-09-30",
@@ -10,41 +19,16 @@
     "status": 200,
     "checked": "2026-09-30"
   },
-  "https://docs.stripe.com/api/billing/alert/activate": {
-    "status": 200,
-    "checked": "2026-09-30"
-  },
-  "https://docs.stripe.com/api/billing/alert/archive": {
-    "status": 200,
-    "checked": "2026-09-30"
-  },
-  "https://docs.stripe.com/api/billing/alert/deactivate": {
-    "status": 200,
-    "checked": "2026-09-30"
-  },
-  "https://docs.stripe.com/api/billing/meter/deactivate": {
+  "https://docs.stripe.com/api/billing/meter/create": {
     "status": 200,
-    "checked": "2026-09-30"
-  },
-  "https://docs.stripe.com/api/billing/meter/reactivate": {
-    "status": 200,
-    "checked": "2026-09-30"
-  },
-  "https://docs.stripe.com/api/capabilities/update": {
-    "status": 200,
-    "checked": "2026-09-30"
-  },
-  "https://docs.stripe.com/api/charges/capture": {
-    "status": 200,
-    "checked": "2026-09-30"
+    "checked": "2026-10-03",
+    "quotes": {
+      "stripe_customer_id": true
+    }
   },
   "https://docs.stripe.com/api/charges/object#charge_object-refunded": {
     "status": 200,
-    "checked": "2026-09-30"
-  },
-  "https://docs.stripe.com/api/checkout/sessions/expire": {
-    "status": 200,
-    "checked": "2026-09-30"
+    "checked": "2026-10-03"
   },
   "https://docs.stripe.com/api/checkout/sessions/object#checkout_session_object-payment_status": {
     "status": 200,
@@ -54,54 +38,22 @@
     "status": 200,
     "checked": "2026-09-30"
   },
-  "https://docs.stripe.com/api/climate/order/cancel": {
+  "https://docs.stripe.com/api/invoices/create_preview.md?query=subscription_details": {
     "status": 200,
-    "checked": "2026-09-30"
-  },
-  "https://docs.stripe.com/api/credit_notes/void": {
-    "status": 200,
-    "checked": "2026-09-30"
-  },
-  "https://docs.stripe.com/api/customer_portal/configurations/update": {
-    "status": 200,
-    "checked": "2026-09-30"
-  },
-  "https://docs.stripe.com/api/disputes/close": {
-    "status": 200,
-    "checked": "2026-09-30"
-  },
-  "https://docs.stripe.com/api/disputes/update#update_dispute-submit": {
-    "status": 200,
-    "checked": "2026-09-30"
-  },
-  "https://docs.stripe.com/api/fee_refunds/create": {
-    "status": 200,
-    "checked": "2026-09-30"
-  },
-  "https://docs.stripe.com/api/financial_connections/accounts/disconnect": {
-    "status": 200,
-    "checked": "2026-09-30"
-  },
-  "https://docs.stripe.com/api/invoices/delete": {
-    "status": 200,
-    "checked": "2026-10-02"
-  },
-  "https://docs.stripe.com/api/invoices/finalize": {
-    "status": 200,
-    "checked": "2026-09-30"
-  },
-  "https://docs.stripe.com/api/invoices/mark_uncollectible": {
-    "status": 200,
-    "checked": "2026-09-30"
+    "checked": "2026-10-04",
+    "quotes": {
+      "The default value is": true,
+      "forces the proration to be calculated as though the update was done at the specified time.": true,
+      "The time given must be within the current subscription period": true,
+      "cannot be set to": true,
+      "Disable creating prorations in this request.": true,
+      "Always invoice immediately for prorations.": true
+    }
   },
   "https://docs.stripe.com/api/invoices/pay": {
     "status": 200,
     "checked": "2026-09-30"
   },
-  "https://docs.stripe.com/api/invoices/send": {
-    "status": 200,
-    "checked": "2026-09-30"
-  },
   "https://docs.stripe.com/api/invoices/void": {
     "status": 200,
     "checked": "2026-09-30"
@@ -114,149 +66,60 @@
     "status": 200,
     "checked": "2026-09-30"
   },
-  "https://docs.stripe.com/api/issuing/cardholders/update": {
+  "https://docs.stripe.com/api/issuing/cards/create": {
     "status": 200,
-    "checked": "2026-09-30"
+    "checked": "2026-10-03",
+    "quotes": {
+      "Whether authorizations can be approved on this card. May be blocked from activating cards depending on past-due Cardholder requirements. Defaults to inactive.": true,
+      "Defaults to inactive": true
+    }
   },
   "https://docs.stripe.com/api/issuing/cards/update": {
     "status": 200,
     "checked": "2026-09-30"
   },
-  "https://docs.stripe.com/api/issuing/tokens/update": {
-    "status": 200,
-    "checked": "2026-09-30"
-  },
-  "https://docs.stripe.com/api/mandates/object": {
-    "status": 200,
-    "checked": "2026-09-30"
-  },
-  "https://docs.stripe.com/api/payment_intents/apply_customer_balance": {
-    "status": 200,
-    "checked": "2026-09-30"
-  },
   "https://docs.stripe.com/api/payment_intents/cancel": {
     "status": 200,
-    "checked": "2026-09-30"
-  },
-  "https://docs.stripe.com/api/payment_intents/capture": {
-    "status": 200,
-    "checked": "2026-09-30"
+    "checked": "2026-10-03"
   },
   "https://docs.stripe.com/api/payment_intents/confirm": {
     "status": 200,
     "checked": "2026-09-30"
   },
-  "https://docs.stripe.com/api/payment_intents/increment_authorization": {
-    "status": 200,
-    "checked": "2026-09-30"
-  },
-  "https://docs.stripe.com/api/payment_links/payment_links/update": {
-    "status": 200,
-    "checked": "2026-09-30"
-  },
-  "https://docs.stripe.com/api/payouts/cancel": {
-    "status": 200,
-    "checked": "2026-09-30"
-  },
-  "https://docs.stripe.com/api/plans/delete": {
-    "status": 200,
-    "checked": "2026-09-30"
-  },
-  "https://docs.stripe.com/api/prices/update#update_price-active": {
+  "https://docs.stripe.com/api/plans/create": {
     "status": 200,
-    "checked": "2026-09-30"
-  },
-  "https://docs.stripe.com/api/products/update#update_product-active": {
-    "status": 200,
-    "checked": "2026-09-30"
+    "checked": "2026-10-03",
+    "quotes": {
+      "It replaces the Plans API and is backwards compatible to simplify your migration.": true
+    }
   },
   "https://docs.stripe.com/api/promotion_codes/update": {
     "status": 200,
     "checked": "2026-09-30"
   },
-  "https://docs.stripe.com/api/quotes/accept": {
-    "status": 200,
-    "checked": "2026-09-30"
-  },
-  "https://docs.stripe.com/api/quotes/cancel": {
-    "status": 200,
-    "checked": "2026-09-30"
-  },
-  "https://docs.stripe.com/api/quotes/finalize": {
-    "status": 200,
-    "checked": "2026-09-30"
-  },
-  "https://docs.stripe.com/api/radar/reviews/approve": {
-    "status": 200,
-    "checked": "2026-09-30"
-  },
-  "https://docs.stripe.com/api/refunds/cancel": {
-    "status": 200,
-    "checked": "2026-09-30"
-  },
-  "https://docs.stripe.com/api/refunds/create#create_refund-refund_application_fee": {
-    "status": 200,
-    "checked": "2026-09-30"
-  },
-  "https://docs.stripe.com/api/setup_intents/cancel": {
-    "status": 200,
-    "checked": "2026-09-30"
-  },
-  "https://docs.stripe.com/api/setup_intents/confirm": {
-    "status": 200,
-    "checked": "2026-09-30"
-  },
-  "https://docs.stripe.com/api/setup_intents/verify_microdeposits": {
-    "status": 200,
-    "checked": "2026-09-30"
-  },
-  "https://docs.stripe.com/api/subscription_schedules/cancel": {
-    "status": 200,
-    "checked": "2026-09-30"
-  },
-  "https://docs.stripe.com/api/subscription_schedules/release": {
-    "status": 200,
-    "checked": "2026-09-30"
-  },
   "https://docs.stripe.com/api/subscriptions/cancel": {
     "status": 200,
     "checked": "2026-09-30"
   },
-  "https://docs.stripe.com/api/subscriptions/update#update_subscription-trial_end": {
+  "https://docs.stripe.com/api/subscriptions/object": {
     "status": 200,
-    "checked": "2026-09-30"
-  },
-  "https://docs.stripe.com/api/tax_rates/update": {
-    "status": 200,
-    "checked": "2026-09-30"
-  },
-  "https://docs.stripe.com/api/terminal/readers/present_payment_method": {
-    "status": 200,
-    "checked": "2026-09-30"
-  },
-  "https://docs.stripe.com/api/test_clocks/advance": {
-    "status": 200,
-    "checked": "2026-09-30"
-  },
-  "https://docs.stripe.com/api/topups/cancel": {
-    "status": 200,
-    "checked": "2026-09-30"
-  },
-  "https://docs.stripe.com/api/treasury": {
-    "status": 200,
-    "checked": "2026-09-30"
-  },
-  "https://docs.stripe.com/api/treasury/inbound_transfers": {
-    "status": 200,
-    "checked": "2026-09-30"
+    "checked": "2026-10-03",
+    "quotes": {
+      "subscription_items?subscription=": true
+    }
   },
-  "https://docs.stripe.com/api/treasury/transactions/object": {
+  "https://docs.stripe.com/api/subscriptions/update#update_subscription-trial_end": {
     "status": 200,
     "checked": "2026-09-30"
   },
-  "https://docs.stripe.com/api/webhook_endpoints/update#update_webhook_endpoint-disabled": {
+  "https://docs.stripe.com/billing/customer/balance": {
     "status": 200,
-    "checked": "2026-09-30"
+    "checked": "2026-10-03",
+    "quotes": {
+      "Represents the starting value of the customer invoice balance when a customer is created using the API with a non-zero invoice balance.": true,
+      "All modifications to the invoice balance are recorded as Transactions": true,
+      "All Transactions created with the API or in the Dashboard have a type value of adjustment": true
+    }
   },
   "https://docs.stripe.com/billing/subscriptions/build-subscriptions": {
     "status": 200,
@@ -270,11 +133,21 @@
     "status": 200,
     "checked": "2026-09-30"
   },
-  "https://docs.stripe.com/billing/subscriptions/trials": {
+  "https://docs.stripe.com/billing/subscriptions/prorations": {
     "status": 200,
-    "checked": "2026-09-30"
+    "checked": "2026-10-04",
+    "quotes": {
+      "Unused time on original 10 USD plan (credit)": true,
+      "Remaining time on new 20 USD plan (debit)": true,
+      "The current billing period’s start and end times are used to calculate the cost of the subscription before and after the change.": true,
+      "By default, Stripe calculates prorations down to the second.": true,
+      "When calculating proration credits or debits, Stripe uses the subscription’s discounted price, not the original price.": true,
+      "The prorated amount is calculated as soon as the API updates the subscription.": true,
+      "creates a non-proration debit, even when the debit covers a partial billing period.": true,
+      "no additional discounts are applied to the proration line items themselves": true
+    }
   },
-  "https://docs.stripe.com/billing/subscriptions/trials/free-trials": {
+  "https://docs.stripe.com/billing/subscriptions/trials": {
     "status": 200,
     "checked": "2026-09-30"
   },
@@ -286,29 +159,42 @@
     "status": 200,
     "checked": "2026-09-30"
   },
-  "https://docs.stripe.com/billing/testing/test-clocks/api-advanced-usage": {
+  "https://docs.stripe.com/changelog/clover/2025-09-30/polymorphic-coupon": {
     "status": 200,
-    "checked": "2026-09-30"
+    "checked": "2026-10-03",
+    "quotes": {
+      "Moves the top-level coupon field on Promotion Codes to promotion.coupon": true,
+      "When you retrieve Promotion Codes, they don’t auto-expand the promotion.coupon field": true
+    }
   },
-  "https://docs.stripe.com/connect/account-capabilities#capability-status": {
+  "https://docs.stripe.com/connect/account-capabilities": {
     "status": 200,
-    "checked": "2026-09-30"
+    "checked": "2026-10-03",
+    "quotes": {
+      "If a connected account has both card_payments and transfers": true
+    }
   },
-  "https://docs.stripe.com/connect/top-ups": {
+  "https://docs.stripe.com/connect/authentication": {
     "status": 200,
-    "checked": "2026-09-30"
+    "checked": "2026-10-03",
+    "quotes": {
+      "Stripe-Account header": true
+    }
   },
-  "https://docs.stripe.com/customer-management": {
+  "https://docs.stripe.com/connect/destination-charges#issue-refunds": {
     "status": 200,
-    "checked": "2026-09-30"
+    "checked": "2026-10-03"
   },
-  "https://docs.stripe.com/identity/how-sessions-work": {
+  "https://docs.stripe.com/customer-management": {
     "status": 200,
     "checked": "2026-09-30"
   },
   "https://docs.stripe.com/invoicing/integration": {
     "status": 200,
-    "checked": "2026-09-30"
+    "checked": "2026-10-02",
+    "quotes": {
+      "To finalize a draft invoice, use the Dashboard, send it to the customer, or pay it.": true
+    }
   },
   "https://docs.stripe.com/invoicing/integration/workflow-transitions#finalized": {
     "status": 200,
@@ -329,6 +215,14 @@
     "status": 200,
     "checked": "2026-09-30"
   },
+  "https://docs.stripe.com/issuing/testing": {
+    "status": 200,
+    "checked": "2026-10-03",
+    "quotes": {
+      "Before you create test transactions, you must add test funds to the Issuing balance on your account.": true,
+      "You can create test top-ups in the Dashboard, or with the Top-ups API": true
+    }
+  },
   "https://docs.stripe.com/keys": {
     "status": 200,
     "checked": "2026-09-30",
@@ -344,29 +238,56 @@
     "status": 200,
     "checked": "2026-09-30"
   },
-  "https://docs.stripe.com/payments/customer-balance/reconciliation": {
+  "https://docs.stripe.com/payments/paymentintents/lifecycle": {
     "status": 200,
     "checked": "2026-09-30"
   },
-  "https://docs.stripe.com/payments/paymentintents/lifecycle": {
+  "https://docs.stripe.com/payouts": {
     "status": 200,
-    "checked": "2026-09-30"
+    "checked": "2026-10-03",
+    "quotes": {
+      "paid": true
+    }
   },
   "https://docs.stripe.com/payouts#payout-statuses": {
     "status": 200,
     "checked": "2026-09-30"
   },
+  "https://docs.stripe.com/radar/lists": {
+    "status": 200,
+    "checked": "2026-10-03",
+    "quotes": {
+      "Use the Dashboard or the API to create lists.": true,
+      "Enter a name for the list": true,
+      "Select the type of list to create.": true,
+      "Click Add to save your new list.": true
+    }
+  },
+  "https://docs.stripe.com/rate-limits": {
+    "status": 200,
+    "checked": "2026-10-01",
+    "quotes": {
+      "25 requests per second": true
+    }
+  },
   "https://docs.stripe.com/refunds": {
     "status": 200,
     "checked": "2026-09-30"
   },
-  "https://docs.stripe.com/reports/api": {
+  "https://docs.stripe.com/search": {
     "status": 200,
-    "checked": "2026-09-30"
+    "checked": "2026-10-03",
+    "quotes": {
+      "Substring match operator (substrings must be a minimum of 3 characters)": true
+    }
   },
-  "https://docs.stripe.com/testing#evidence": {
+  "https://docs.stripe.com/testing": {
     "status": 200,
-    "checked": "2026-09-30"
+    "checked": "2026-10-02",
+    "quotes": {
+      "Generic decline 4000 0000 0000 0002": true,
+      "This card requires authentication on all transactions, regardless of how the card is set up.": true
+    }
   },
   "https://docs.stripe.com/webhooks": {
     "status": 200,
@@ -374,5 +295,12 @@
     "quotes": {
       "register a webhook endpoint, Stripe pushes real-time data to it when": true
     }
+  },
+  "https://github.com/stripe/stripe-mock/issues/31": {
+    "status": 200,
+    "checked": "2026-10-03",
+    "quotes": {
+      "Unrecognized request URL (GET: /v1/test).": true
+    }
   }
 }

package/src/cli.ts

@@ -1,9 +1,6 @@
-#!/usr/bin/env node
-// world-stripe: serve the stripe twin.
 import { hasFlag, optionValue } from '@volter/world-core/args';
 import { keepProcessAlive } from '@volter/world-core/lifecycle';
 import { createStripeTwinServer } from './server.ts';
-
 const [cmd, ...rest] = process.argv.slice(2);
 const port = Number(optionValue(rest, '--port', '0')) || undefined;
 const root = optionValue(rest, '--root') || undefined;

package/src/engine/after-payment.ts

@@ -15,9 +15,7 @@
 // deadline depends on the card network); the dispute fee is 1500 cents in any currency (Stripe's US fee is $15); an
 // elevated-risk review's risk score is 67 (Radar's elevated band); the application is `ca_twin`.
 import { BYPASS_PENDING_CARDS } from './test-cards.ts';
-
 export type Outcome = 'dispute' | 'dispute_not_received' | 'inquiry' | 'review' | 'available';
-export const DAY = 86_400;
 
 /** The test cards whose success Stripe follows with its own act, by number and by their documented test names. */
 export const AFTER_SUCCESS_CARDS: Record<string, { brand: string; number: string; outcome: Outcome }> = {

package/src/engine/balance.ts

@@ -16,7 +16,6 @@
 // US schedule counts business days) and reads paid from then on; an automatic payout is made at midnight UTC on the
 // first scheduled day on or after its funds become available, only when what it would pay is positive.
 import type { Row } from './common.ts';
-
 export const DAY = 86_400;
 
 export const DAYS = ['sunday', 'monday', 'tuesday', 'wednesday', 'thursday', 'friday', 'saturday'];

package/src/engine/checkout.ts

@@ -4,7 +4,6 @@
 // the payment made: a succeeded PaymentIntent, an active (or
 // trialing) subscription, or a succeeded SetupIntent. List and retrieve are the derived core's.
 import type { Row } from './common.ts';
-
 export const CS = 'checkout.session';
 
 /** The payment method types a session takes: the list a caller pinned to an earlier version gives as

package/src/engine/common.ts

@@ -1,22 +1,9 @@
 // Stripe's shared computation over rows already read: the fields each object's spec gives, a row as Stripe answers it,
 // and the list and refund shapes (the handlers' shared behaviour is ../semantics/shared.ts).
-import { view } from './stripe.ts';
-
 import surface from '../generated/surface.gen.json' with { type: 'json' };
 
 export type Row = Record<string, unknown>;
 
-
-/** A removed discount as Stripe answers it: the discount, marked deleted (docs.stripe.com/api/discounts/delete). */
-export function deletedDiscount(d: Row, now: unknown): Row {
-  const coupon = d.coupon && typeof d.coupon === 'object' ? String((d.coupon as Row).id) : typeof d.coupon === 'string' ? d.coupon : null;
-  return {
-    id: d.id ?? `di_${coupon ?? 'twin'}`, object: 'discount', deleted: true, checkout_session: d.checkout_session ?? null, customer: d.customer ?? null,
-    invoice: d.invoice ?? null, invoice_item: d.invoice_item ?? null, promotion_code: d.promotion_code ?? null, subscription: d.subscription ?? null,
-    subscription_item: d.subscription_item ?? null, source: d.source ?? { type: 'coupon', coupon }, start: d.start ?? now,
-  };
-}
-
 /** Keep the rows whose field equals the request's parameter of the same name, for each name given. */
 /** A list's range filter on a unix time (`created[gte]=…&created[lt]=…`, or one exact time). */
 export function inRange(t: unknown, v: unknown): boolean {
@@ -31,6 +18,25 @@ export const SPEC_FIELDS = new Map((surface.resources as Array<{ name: string; f
  *  shared helpers look a price, a payment method or a card up by, read from the context's tree. */
 export type Find = (storedType: string, id: string) => Row | undefined;
 
+/** An account's external_accounts, "External accounts (bank accounts and debit cards) currently attached to this
+ *  account" (docs.stripe.com/api/accounts/object), as the list its example answers. */
+export const externalList = (account: string, data: Row[]): Row => ({ object: 'list', data, has_more: false, total_count: data.length, url: `/v1/accounts/${account}/external_accounts` });
+
+
+
+
+/** A removed discount as Stripe answers it: the discount, marked deleted (docs.stripe.com/api/discounts/delete). */
+export function deletedDiscount(d: Row, now: unknown): Row {
+  const coupon = d.coupon && typeof d.coupon === 'object' ? String((d.coupon as Row).id) : typeof d.coupon === 'string' ? d.coupon : null;
+  return {
+    id: d.id ?? `di_${coupon ?? 'twin'}`, object: 'discount', deleted: true, checkout_session: d.checkout_session ?? null, customer: d.customer ?? null,
+    invoice: d.invoice ?? null, invoice_item: d.invoice_item ?? null, promotion_code: d.promotion_code ?? null, subscription: d.subscription ?? null,
+    subscription_item: d.subscription_item ?? null, source: d.source ?? { type: 'coupon', coupon }, start: d.start ?? now,
+  };
+}
+
+
+
 /** A refund's destination_details for a card charge: "If this is a `card` refund, this hash contains the transaction
  *  specific details" and its `type` "can be `refund`, `reversal`, or `pending`" — a reversal, where "The original charge
  *  will drop off the bank statement altogether", for an authorization released uncaptured, else a refund, "a credit entry
@@ -41,7 +47,3 @@ export function refundDestination(charge: Row, type: 'refund' | 'reversal'): Row
   if (pmd && pmd.type !== 'card') return {};
   return { destination_details: { type: 'card', card: { reference: null, reference_status: null, reference_type: null, type } } };
 }
-
-/** An account's external_accounts, "External accounts (bank accounts and debit cards) currently attached to this
- *  account" (docs.stripe.com/api/accounts/object), as the list its example answers. */
-export const externalList = (account: string, data: Row[]): Row => ({ object: 'list', data, has_more: false, total_count: data.length, url: `/v1/accounts/${account}/external_accounts` });