@volter/twin-stripe 3.0.0 → 3.0.1

package/dist/src/engine/payment-links.js

@@ -1,5 +0,0 @@
-// Payment Link and Quote semantics. Both carry line items resolved from existing prices. A payment
-// link is a reusable hosted-checkout URL, active until switched off; a quote moves draft → open
-// (finalize) → accepted or canceled, the machine in ../manifest.ts. Link retrieve and update
-// (`active`, its machine), quote retrieve and the quote list are the derived core's.
-export const PL = 'payment_link';

package/dist/src/engine/plans.d.ts

@@ -1,6 +0,0 @@
-import type { Row } from './common.js';
-export declare const INTERVALS: Set<string>;
-/** A recurring price in the plan object's shape (the create page's example response). */
-export declare function planOf(price: Row): Row;
-/** Metadata after an update: an empty value unsets the key, an empty `metadata` unsets them all. */
-export declare function metadataAfter(was: Row, given: unknown): Row;

package/dist/src/engine/plans.js

@@ -1,26 +0,0 @@
-export const INTERVALS = new Set(['day', 'week', 'month', 'year']);
-/** A recurring price in the plan object's shape (the create page's example response). */
-export function planOf(price) {
-    const r = (price.recurring ?? {});
-    const amount = typeof price.unit_amount === 'number' ? price.unit_amount : null;
-    const decimal = typeof price.unit_amount_decimal === 'string' ? price.unit_amount_decimal : amount === null ? null : String(amount);
-    return {
-        id: price.id, object: 'plan', active: price.active ?? true, amount, amount_decimal: decimal,
-        billing_scheme: price.billing_scheme ?? 'per_unit', created: price.created, currency: price.currency, interval: r.interval ?? null,
-        interval_count: r.interval_count ?? 1, livemode: false, metadata: price.metadata ?? {}, meter: r.meter ?? null, nickname: price.nickname ?? null,
-        product: price.product, tiers_mode: price.tiers_mode ?? null, transform_usage: price.transform_quantity ?? null,
-        trial_period_days: r.trial_period_days ?? null, usage_type: r.usage_type ?? 'licensed',
-    };
-}
-/** Metadata after an update: an empty value unsets the key, an empty `metadata` unsets them all. */
-export function metadataAfter(was, given) {
-    if (given === '' || given === null || typeof given !== 'object')
-        return {};
-    const next = { ...was };
-    for (const [k, v] of Object.entries(given))
-        if (v === '' || v === null)
-            delete next[k];
-        else
-            next[k] = v;
-    return next;
-}

package/dist/src/engine/platform.d.ts

@@ -1,39 +0,0 @@
-import type { Row } from './common.js';
-export declare const CLIMATE_SUPPLIERS: readonly [{
-    readonly id: "climsup_charm_industrial";
-    readonly name: "Charm Industrial";
-    readonly removal_pathway: "biomass_carbon_removal_and_storage";
-    readonly info_url: "https://frontierclimate.com/portfolio/charm-industrial";
-    readonly locations: readonly [{
-        readonly city: "San Francisco";
-        readonly country: "US";
-        readonly latitude: 37.7749;
-        readonly longitude: -122.4194;
-        readonly region: "CA";
-    }];
-}];
-export declare const CLIMATE_PRODUCTS: readonly [{
-    readonly id: "climsku_frontier_offtake_portfolio_2027";
-    readonly name: "Frontier's 2027 offtake portfolio";
-    readonly subtotal: 55000;
-    readonly fees: 1650;
-    readonly currency: "usd";
-    readonly delivery_year: 2027;
-    readonly metric_tons_available: "18000";
-    readonly created: 1881439203;
-    readonly suppliers: readonly ["climsup_charm_industrial"];
-}];
-export declare const supplierView: (s: (typeof CLIMATE_SUPPLIERS)[number]) => Row;
-export declare const productView: (p: (typeof CLIMATE_PRODUCTS)[number]) => Row;
-export declare const ORDER = "climate.order";
-export declare const FCS = "financial_connections.session";
-export declare const FCA = "financial_connections.account";
-export declare const FCT = "financial_connections.transaction";
-export declare const REPORT_TYPES: Array<{
-    id: string;
-    name: string;
-}>;
-export declare const reportTypeView: (t: {
-    id: string;
-    name: string;
-}) => Row;

package/dist/src/engine/platform.js

@@ -1,34 +0,0 @@
-// ── Climate: Stripe's catalog is managed and account-independent. The twin serves the catalog Stripe's reference
-// publishes (docs.stripe.com/api/climate/product/object, /api/climate/supplier/object): Frontier's 2027 offtake
-// portfolio at $550 a ton plus Frontier's service fees of $16.50 (3%), 18,000 tons, from Charm Industrial.
-// Where the documentation stops and the twin decides: the catalog is that one product and supplier. ──
-export const CLIMATE_SUPPLIERS = [
-    { id: 'climsup_charm_industrial', name: 'Charm Industrial', removal_pathway: 'biomass_carbon_removal_and_storage', info_url: 'https://frontierclimate.com/portfolio/charm-industrial', locations: [{ city: 'San Francisco', country: 'US', latitude: 37.7749, longitude: -122.4194, region: 'CA' }] },
-];
-export const CLIMATE_PRODUCTS = [
-    { id: 'climsku_frontier_offtake_portfolio_2027', name: "Frontier's 2027 offtake portfolio", subtotal: 55000, fees: 1650, currency: 'usd', delivery_year: 2027, metric_tons_available: '18000', created: 1881439203, suppliers: ['climsup_charm_industrial'] },
-];
-export const supplierView = (s) => ({ id: s.id, object: 'climate.supplier', name: s.name, removal_pathway: s.removal_pathway, info_url: s.info_url, locations: s.locations, livemode: false });
-export const productView = (p) => ({
-    id: p.id, object: 'climate.product', name: p.name, livemode: false, delivery_year: p.delivery_year,
-    metric_tons_available: p.metric_tons_available, created: p.created,
-    current_prices_per_metric_ton: { [p.currency]: { amount_fees: p.fees, amount_subtotal: p.subtotal, amount_total: p.subtotal + p.fees } },
-    suppliers: p.suppliers.map((id) => supplierView(CLIMATE_SUPPLIERS.find((s) => s.id === id))),
-});
-export const ORDER = 'climate.order';
-// ── Financial Connections: a session is created for an account holder and its permissions; accounts
-// are linked in the authentication flow Stripe.js opens (../screens/financial-connections.tsx) ──
-export const FCS = 'financial_connections.session';
-export const FCA = 'financial_connections.account';
-export const FCT = 'financial_connections.transaction';
-// ── Reporting: a representative subset of Stripe's report types; a run succeeds at once ──
-export const REPORT_TYPES = [
-    { id: 'balance.summary.1', name: 'Balance summary' },
-    { id: 'balance_change_from_activity.summary.1', name: 'Balance change from activity (summary)' },
-    { id: 'payouts.summary.1', name: 'Payouts (summary)' },
-    { id: 'payout_reconciliation.by_id.itemized.4', name: 'Payout reconciliation (itemized)' },
-];
-export const reportTypeView = (t) => ({
-    id: t.id, object: 'reporting.report_type', name: t.name, version: 1,
-    data_available_start: 0, data_available_end: 0, default_columns: null, updated: 0, livemode: false,
-});

package/dist/src/engine/products.js

@@ -1,4 +0,0 @@
-"use strict";
-// Product and Price semantics, with the entitlement features granted to a product. Retrieve of a
-// product and the product and price updates (archiving and restoring by `active`, the machines in
-// ../manifest.ts) are the derived core's.

package/dist/src/engine/setup-intents.d.ts

@@ -1 +0,0 @@
-export declare const SI = "setup_intent";

package/dist/src/engine/setup-intents.js

@@ -1,4 +0,0 @@
-// SetupIntent semantics. The machine in ../manifest.ts says which moves of `status` are legal and
-// what Stripe answers otherwise; these handlers compute what each move does. List, retrieve and
-// update are the derived core's.
-export const SI = 'setup_intent';

package/dist/src/engine/subscription-schedules.d.ts

@@ -1,3 +0,0 @@
-import { addBillingInterval } from './stripe.js';
-export declare const SS = "subscription_schedule";
-export type Interval = Parameters<typeof addBillingInterval>[1];

package/dist/src/engine/subscription-schedules.js

@@ -1 +0,0 @@
-export const SS = 'subscription_schedule';

package/dist/src/engine/tax.d.ts

@@ -1,7 +0,0 @@
-import type { Row } from './common.js';
-export declare const TWIN_TAX_RATE_PCT = 10;
-export declare const ADDRESS_LINES: string[];
-export declare function settingsBody(stored: Row | undefined): Row;
-export declare const TX = "tax.transaction";
-export declare const txLine: (id: string, i: number, l: Row, sign: 1 | -1, reversal: Row | null, type: string) => Row;
-export declare const linesOf: (holder: Row) => Row[];

package/dist/src/engine/tax.js

@@ -1,28 +0,0 @@
-export const TWIN_TAX_RATE_PCT = 10;
-// ── settings: active once a head office is set; the answer has no id ──
-// the defaults' provider: "The tax calculation provider this account uses. Defaults to `stripe` when not using a
-// third-party provider" (the served spec's tax settings defaults); the head office's address answers each line, the
-// lines not given null (the served spec's address: each "(string, nullable)"; the settings page's example answers
-// line2 null)
-export const ADDRESS_LINES = ['city', 'country', 'line1', 'line2', 'postal_code', 'state'];
-export function settingsBody(stored) {
-    const given = (stored?.head_office ?? null);
-    const address = given && typeof given.address === 'object' && given.address ? given.address : undefined;
-    const headOffice = given ? { ...given, ...(address ? { address: Object.fromEntries(ADDRESS_LINES.map((k) => [k, address[k] ?? null])) } : {}) } : null;
-    const active = !!headOffice;
-    return {
-        object: 'tax.settings', livemode: false,
-        defaults: { provider: 'stripe', ...(stored?.defaults ?? { tax_behavior: null, tax_code: null }) }, head_office: headOffice,
-        status: active ? 'active' : 'pending',
-        status_details: active ? { active: {} } : { pending: { missing_fields: ['head_office'] } },
-    };
-}
-// ── transactions: committing a calculation, or reversing a transaction with negated amounts ──
-export const TX = 'tax.transaction';
-export const txLine = (id, i, l, sign, reversal, type) => ({
-    object: 'tax.transaction_line_item', id: `tax_li_${id}_${i + 1}`,
-    amount: sign === 1 ? l.amount : -(Number(l.amount) || 0), amount_tax: sign === 1 ? l.amount_tax : -(Number(l.amount_tax) || 0),
-    reference: l.reference ?? null, tax_behavior: l.tax_behavior ?? 'exclusive', tax_code: l.tax_code ?? 'txcd_99999999',
-    quantity: l.quantity ?? 1, reversal, type, livemode: false, metadata: {},
-});
-export const linesOf = (holder) => holder.line_items?.data ?? [];

package/dist/src/engine/terminal.d.ts

@@ -1,4 +0,0 @@
-export declare const LOC = "terminal.location";
-export declare const READER = "terminal.reader";
-export declare const CONF = "terminal.configuration";
-export declare const TOPUP_DAYS = 5;

package/dist/src/engine/terminal.js

@@ -1,20 +0,0 @@
-// Terminal and top-up semantics: in-person locations, readers (handed a PaymentIntent to process)
-// and their configurations, the reader SDK's connection tokens, and top-ups that fund the balance
-// (a test top-up succeeds at once; only a pending one cancels, the machine in ../manifest.ts). In test mode a
-// simulated reader is presented a card by a test helper: the PaymentIntent the reader is processing is paid with a
-// card_present payment method (succeeded, or requires_capture under manual capture) and the reader's action succeeds
-// (docs.stripe.com/terminal/references/testing#simulated-test-cards,
-// docs.stripe.com/api/terminal/readers/present_payment_method). Where the documentation stops and the twin decides:
-// the presented card is the simulated reader's default Visa, and the reader answers at once.
-// Lists and retrieves are the derived core's.
-export const LOC = 'terminal.location';
-export const READER = 'terminal.reader';
-export const CONF = 'terminal.configuration';
-// ── top-ups ──
-// a top-up adds money to the balance it names, through the ledger, once its funds arrive: "USA (USD) ACH Debit Transfer
-// 5 days" (docs.stripe.com/connect/top-ups), and to the Issuing balance alike: "Top-ups debit your bank account. Your
-// top-ups can take up to 5 business days to become available. While they're pending, they won't be added to your
-// Issuing balance" (docs.stripe.com/issuing/funding/balance). It is pending until its expected_availability_date, then
-// settled by settleTopups. Where the documentation stops and the twin decides: every top-up takes exactly five days,
-// whatever its currency and balance, and succeeds.
-export const TOPUP_DAYS = 5;

package/dist/src/engine/test-clocks.d.ts

@@ -1,5 +0,0 @@
-export declare const CLOCK = "test_helpers.test_clock";
-/** How long an advance takes: "it takes a few seconds to advance to the specified time"
- *  (docs.stripe.com/billing/testing/test-clocks/api-advanced-usage). Where the documentation stops and the twin decides:
- *  five seconds of World time from the advance. */
-export declare const ADVANCE_SECONDS = 5;

package/dist/src/engine/test-clocks.js

@@ -1,9 +0,0 @@
-// Test clock semantics. A test clock is Stripe's own door for a transition no API verb makes: the
-// passage of time. Advancing it moves the subscriptions of the clock's customers as a real clock tick does:
-// trials that ended end, and periods that ended renew (./renewals.ts advanceBilling). List, retrieve and delete are
-// the derived core's.
-export const CLOCK = 'test_helpers.test_clock';
-/** How long an advance takes: "it takes a few seconds to advance to the specified time"
- *  (docs.stripe.com/billing/testing/test-clocks/api-advanced-usage). Where the documentation stops and the twin decides:
- *  five seconds of World time from the advance. */
-export const ADVANCE_SECONDS = 5;

package/dist/src/engine/tokens.d.ts

@@ -1,7 +0,0 @@
-import type { Row } from './common.js';
-/** The Card object a card token carries, as the served spec's `card` describes it: its brand as a name ("Card brand.
- *  Can be `American Express`, ... `MasterCard`, `UnionPay`, `Visa`, or `Unknown`"), the holder's name and address as
- *  given ("Cardholder name"), and the CVC's check when one was given ("If a CVC was provided, results of the check:
- *  pass, fail, unavailable, or unchecked"). Where the documentation stops and the twin decides: a test card's CVC passes. */
-export declare const BRAND_NAMES: Record<string, string>;
-export declare function legacyCard(id: string, card: Row): Row;

package/dist/src/engine/tokens.js

@@ -1,20 +0,0 @@
-// Token semantics: the older integrations' single-use tokens for a card, a bank account or PII. A
-// token carries only the safe fields of its instrument, never the card or account number. Retrieve
-// is the derived core's.
-import { paymentMethodSubObject } from "./stripe.js";
-/** The Card object a card token carries, as the served spec's `card` describes it: its brand as a name ("Card brand.
- *  Can be `American Express`, ... `MasterCard`, `UnionPay`, `Visa`, or `Unknown`"), the holder's name and address as
- *  given ("Cardholder name"), and the CVC's check when one was given ("If a CVC was provided, results of the check:
- *  pass, fail, unavailable, or unchecked"). Where the documentation stops and the twin decides: a test card's CVC passes. */
-export const BRAND_NAMES = { amex: 'American Express', cartes_bancaires: 'Cartes Bancaires', diners: 'Diners Club', discover: 'Discover', eftpos_au: 'Eftpos Australia', girocard: 'Girocard', jcb: 'JCB', mastercard: 'MasterCard', unionpay: 'UnionPay', visa: 'Visa' };
-export function legacyCard(id, card) {
-    const pm = paymentMethodSubObject('card', { card }).card;
-    const given = (k) => (typeof card[k] === 'string' && card[k] !== '' ? card[k] : null);
-    return {
-        id, object: 'card', brand: BRAND_NAMES[String(pm.brand)] ?? 'Unknown', last4: pm.last4, exp_month: pm.exp_month, exp_year: pm.exp_year,
-        funding: pm.funding ?? 'credit', country: pm.country ?? null, fingerprint: pm.fingerprint ?? null, name: given('name'),
-        address_line1: given('address_line1'), address_line2: given('address_line2'), address_city: given('address_city'), address_state: given('address_state'),
-        address_zip: given('address_zip'), address_country: given('address_country'), address_line1_check: null, address_zip_check: null,
-        cvc_check: card.cvc !== undefined && card.cvc !== '' ? 'pass' : null, dynamic_last4: null, tokenization_method: null, metadata: {}, customer: null,
-    };
-}

package/dist/src/engine/treasury.d.ts

@@ -1,23 +0,0 @@
-import type { Row } from './common.js';
-export declare const FA = "treasury.financial_account";
-export declare const TX = "treasury.transaction";
-export declare const ENTRY = "treasury.transaction_entry";
-export declare const ENTRY_TYPES: Set<string>;
-/** A financial account's features as the served spec's treasury.financial_account_features gives them: a toggle
- *  (card_issuing, deposit_insurance, intra_stripe_flows) or a feature per network (financial_addresses.aba,
- *  inbound_transfers.ach, outbound_payments.ach and .us_domestic_wire, outbound_transfers likewise), each
- *  { requested, status, status_details }. What a request asks for is laid over what the account had. Where the
- *  documentation stops and the twin decides: a requested feature is active at once (test mode), and one never requested
- *  is left out (each is optional in the served spec). Answers the features and the active features' paths. */
-export declare const NETWORKS: Record<string, string[]>;
-export declare const TOGGLES: string[];
-export declare function featuresOf(requested: Row, had?: Row): {
-    features: Row;
-    active: string[];
-};
-export declare const noTransitions: {
-    canceled_at: null;
-    failed_at: null;
-    posted_at: null;
-    returned_at: null;
-};

package/dist/src/engine/treasury.js

@@ -1,45 +0,0 @@
-export const FA = 'treasury.financial_account';
-export const TX = 'treasury.transaction';
-export const ENTRY = 'treasury.transaction_entry';
-export const ENTRY_TYPES = new Set(['credit_reversal', 'debit_reversal', 'inbound_transfer', 'inbound_transfer_return', 'issuing_authorization_hold', 'issuing_authorization_release', 'outbound_payment', 'outbound_transfer', 'received_credit', 'received_debit']);
-/** A financial account's features as the served spec's treasury.financial_account_features gives them: a toggle
- *  (card_issuing, deposit_insurance, intra_stripe_flows) or a feature per network (financial_addresses.aba,
- *  inbound_transfers.ach, outbound_payments.ach and .us_domestic_wire, outbound_transfers likewise), each
- *  { requested, status, status_details }. What a request asks for is laid over what the account had. Where the
- *  documentation stops and the twin decides: a requested feature is active at once (test mode), and one never requested
- *  is left out (each is optional in the served spec). Answers the features and the active features' paths. */
-export const NETWORKS = { financial_addresses: ['aba'], inbound_transfers: ['ach'], outbound_payments: ['ach', 'us_domestic_wire'], outbound_transfers: ['ach', 'us_domestic_wire'] };
-export const TOGGLES = ['card_issuing', 'deposit_insurance', 'intra_stripe_flows'];
-export function featuresOf(requested, had = {}) {
-    const on = (v) => v === true || v === 'true';
-    const setting = (asked) => ({ requested: asked, status: asked ? 'active' : 'restricted', status_details: [] });
-    const features = { ...had };
-    for (const t of TOGGLES) {
-        const r = requested[t];
-        if (r && typeof r === 'object' && r.requested !== undefined)
-            features[t] = setting(on(r.requested));
-    }
-    for (const [f, nets] of Object.entries(NETWORKS)) {
-        const r = requested[f];
-        if (!r || typeof r !== 'object')
-            continue;
-        const current = features[f] ?? {};
-        const next = { ...current };
-        for (const n of nets) {
-            const nr = r[n];
-            if (nr && typeof nr === 'object' && nr.requested !== undefined)
-                next[n] = setting(on(nr.requested));
-        }
-        features[f] = next;
-    }
-    const active = [];
-    for (const t of TOGGLES)
-        if (features[t]?.status === 'active')
-            active.push(t);
-    for (const [f, nets] of Object.entries(NETWORKS))
-        for (const n of nets)
-            if (features[f]?.[n]?.status === 'active')
-                active.push(`${f}.${n}`);
-    return { features, active };
-}
-export const noTransitions = { canceled_at: null, failed_at: null, posted_at: null, returned_at: null };