@pome-sh/cli 0.1.1 → 0.2.0

package/node_modules/@pome-sh/twin-stripe/dist/src/domain/stripe-domain.d.ts

@@ -1,9 +1,12 @@
 import type { TwinStripeDatabase, StateDelta } from "../types.js";
-import { PaymentIntentsDomain, type CreatePIInput, type ListPIsInput } from "./payment-intents.js";
+import { PaymentIntentsDomain, type CreatePIInput, type ListPIsInput, type UpdatePIInput } from "./payment-intents.js";
 import { ChargesDomain, type ListChargesInput } from "./charges.js";
 import { BalanceDomain, type ListBalanceTxInput } from "./balance.js";
 import { EventsDomain, type ListEventsInput } from "./events.js";
 import { RefundsDomain, type CreateRefundInput, type ListRefundsInput } from "./refunds.js";
+import { CustomersDomain, type CustomerFieldsInput, type ListCustomersInput } from "./customers.js";
+import { PaymentMethodsDomain, type CreatePaymentMethodInput, type ListCustomerPaymentMethodsInput } from "./payment-methods.js";
+import { BillingDomain, type CreatePriceInput, type CreateSubscriptionInput, type ListBillingInput, type ProductFieldsInput, type UpdateSubscriptionInput } from "./billing.js";
 export declare class StripeDomain {
     readonly db: TwinStripeDatabase;
     readonly paymentIntents: PaymentIntentsDomain;
@@ -11,6 +14,9 @@ export declare class StripeDomain {
     readonly balance: BalanceDomain;
     readonly events: EventsDomain;
     readonly refunds: RefundsDomain;
+    readonly customers: CustomersDomain;
+    readonly paymentMethods: PaymentMethodsDomain;
+    readonly billing: BillingDomain;
     constructor(db: TwinStripeDatabase);
     /** Reset Stripe-domain state. Used by `/admin/reset`. */
     reset(): void;
@@ -39,15 +45,15 @@ export declare class StripeDomain {
         confirmation_method: import("../upstream-types.js").PaymentIntent["confirmation_method"];
         created: number;
         currency: string;
-        customer: null;
+        customer: string | null;
         description: null;
-        last_payment_error: null;
+        last_payment_error: import("../upstream-types.js").PaymentIntent["last_payment_error"];
         latest_charge: string | null;
         livemode: false;
         metadata: {};
         next_action: null;
         on_behalf_of: null;
-        payment_method: null;
+        payment_method: string | null;
         payment_method_configuration_details: null;
         payment_method_types: string[];
         processing: null;
@@ -84,15 +90,15 @@ export declare class StripeDomain {
             confirmation_method: import("../upstream-types.js").PaymentIntent["confirmation_method"];
             created: number;
             currency: string;
-            customer: null;
+            customer: string | null;
             description: null;
-            last_payment_error: null;
+            last_payment_error: import("../upstream-types.js").PaymentIntent["last_payment_error"];
             latest_charge: string | null;
             livemode: false;
             metadata: {};
             next_action: null;
             on_behalf_of: null;
-            payment_method: null;
+            payment_method: string | null;
             payment_method_configuration_details: null;
             payment_method_types: string[];
             processing: null;
@@ -109,7 +115,19 @@ export declare class StripeDomain {
         has_more: boolean;
         url: string;
     };
-    confirmPaymentIntent(accountId: string, id: string): {
+    confirmPaymentIntent(accountId: string, id: string, opts?: {
+        payment_method?: string;
+    }): {
+        body: unknown;
+        delta: StateDelta;
+    };
+    /**
+     * POST /v1/payment_intents/:id (F-731). The ruled retry-with-new-PM step:
+     * metadata merges per-key, and attaching a PM moves the card PI back to
+     * requires_confirmation. PM/customer resolution happens here so unknown
+     * ids 404 with Stripe's resource_missing before any state gate fires.
+     */
+    updatePaymentIntent(accountId: string, id: string, input: UpdatePIInput): {
         body: unknown;
         delta: StateDelta;
     };
@@ -136,9 +154,13 @@ export declare class StripeDomain {
     };
     /**
      * Create a refund. Returns the serialized API shape plus a canonical
-     * `state_delta` so the route can hand both to `respond()`. The INSERT
-     * + charges.amount_refunded UPDATE happen in one better-sqlite3
-     * transaction inside `refunds.create()`.
+     * `state_delta` so the route can hand both to `respond()`.
+     *
+     * F-733: the whole flow — refund INSERT + charges.amount_refunded UPDATE
+     * (inside `refunds.create()`, nested as a savepoint), the negative
+     * refund-type balance transaction, the ledger link backfill, and the
+     * charge.refunded / refund.created events — commits in one better-sqlite3
+     * transaction, mirroring the settle flows.
      */
     createRefund(accountId: string, input: CreateRefundInput): {
         body: unknown;
@@ -148,7 +170,7 @@ export declare class StripeDomain {
         id: string;
         object: "refund";
         amount: number;
-        balance_transaction: null;
+        balance_transaction: string | null;
         charge: string;
         created: number;
         currency: string;
@@ -166,7 +188,7 @@ export declare class StripeDomain {
             id: string;
             object: "refund";
             amount: number;
-            balance_transaction: null;
+            balance_transaction: string | null;
             charge: string;
             created: number;
             currency: string;
@@ -181,6 +203,159 @@ export declare class StripeDomain {
         has_more: boolean;
         url: string;
     };
+    createCustomer(accountId: string, input: CustomerFieldsInput): {
+        body: unknown;
+        delta: StateDelta;
+    };
+    /** Deleted customers serve the `{deleted: true}` stub, like real Stripe. */
+    retrieveCustomer(accountId: string, id: string): {
+        id: string;
+        object: "customer";
+        address: null;
+        balance: number;
+        created: number;
+        currency: null;
+        default_source: null;
+        delinquent: false;
+        description: string | null;
+        discount: null;
+        email: string | null;
+        invoice_settings: {
+            custom_fields: null;
+            default_payment_method: null;
+            footer: null;
+            rendering_options: null;
+        };
+        livemode: false;
+        metadata: {};
+        name: string | null;
+        phone: string | null;
+        preferred_locales: never[];
+        shipping: null;
+        tax_exempt: "none";
+        test_clock: null;
+    } | {
+        id: string;
+        object: "customer";
+        deleted: true;
+    };
+    updateCustomer(accountId: string, id: string, input: CustomerFieldsInput): {
+        body: unknown;
+        delta: StateDelta;
+    };
+    deleteCustomer(accountId: string, id: string): {
+        body: unknown;
+        delta: StateDelta;
+    };
+    listCustomers(accountId: string, input: ListCustomersInput): {
+        object: "list";
+        data: {
+            id: string;
+            object: "customer";
+            address: null;
+            balance: number;
+            created: number;
+            currency: null;
+            default_source: null;
+            delinquent: false;
+            description: string | null;
+            discount: null;
+            email: string | null;
+            invoice_settings: {
+                custom_fields: null;
+                default_payment_method: null;
+                footer: null;
+                rendering_options: null;
+            };
+            livemode: false;
+            metadata: {};
+            name: string | null;
+            phone: string | null;
+            preferred_locales: never[];
+            shipping: null;
+            tax_exempt: "none";
+            test_clock: null;
+        }[];
+        has_more: boolean;
+        url: string;
+    };
+    listCustomerPaymentMethods(accountId: string, customerId: string, input: ListCustomerPaymentMethodsInput): {
+        object: "list";
+        data: {
+            id: string;
+            object: "payment_method";
+            billing_details: {
+                address: {
+                    city: null;
+                    country: null;
+                    line1: null;
+                    line2: null;
+                    postal_code: null;
+                    state: null;
+                };
+                email: null;
+                name: null;
+                phone: null;
+            };
+            card: {
+                brand: string;
+                exp_month: number;
+                exp_year: number;
+                fingerprint: string;
+                funding: string;
+                last4: string;
+            };
+            created: number;
+            customer: string | null;
+            livemode: false;
+            metadata: {};
+            type: import("../upstream-types.js").PaymentMethod["type"];
+        }[];
+        has_more: boolean;
+        url: string;
+    };
+    createPaymentMethod(accountId: string, input: CreatePaymentMethodInput): {
+        body: unknown;
+        delta: StateDelta;
+    };
+    retrievePaymentMethod(accountId: string, id: string): {
+        id: string;
+        object: "payment_method";
+        billing_details: {
+            address: {
+                city: null;
+                country: null;
+                line1: null;
+                line2: null;
+                postal_code: null;
+                state: null;
+            };
+            email: null;
+            name: null;
+            phone: null;
+        };
+        card: {
+            brand: string;
+            exp_month: number;
+            exp_year: number;
+            fingerprint: string;
+            funding: string;
+            last4: string;
+        };
+        created: number;
+        customer: string | null;
+        livemode: false;
+        metadata: {};
+        type: import("../upstream-types.js").PaymentMethod["type"];
+    };
+    attachPaymentMethod(accountId: string, id: string, customerId: string): {
+        body: unknown;
+        delta: StateDelta;
+    };
+    detachPaymentMethod(accountId: string, id: string): {
+        body: unknown;
+        delta: StateDelta;
+    };
     retrieveCharge(accountId: string, id: string): {
         invoice: string | null;
         id: string;
@@ -209,35 +384,27 @@ export declare class StripeDomain {
         captured: boolean;
         created: number;
         currency: string;
-        customer: null;
+        customer: string | null;
         description: null;
         disputed: false;
         failure_balance_transaction: null;
-        failure_code: null;
-        failure_message: null;
+        failure_code: import("../upstream-types.js").Charge["failure_code"];
+        failure_message: string | null;
         fraud_details: {};
         livemode: false;
         metadata: {};
         on_behalf_of: null;
         outcome: {
             network_status: string;
-            reason: null;
+            reason: string | null;
             risk_level: string;
             seller_message: string;
             type: string;
         };
         paid: boolean;
         payment_intent: string;
-        payment_method: null;
-        payment_method_details: {
-            type: string;
-            crypto: {
-                buyer_address: string | undefined;
-                network: "base";
-                token_currency: "usdc";
-                transaction_hash: string | undefined;
-            };
-        };
+        payment_method: string | null;
+        payment_method_details: import("../upstream-types.js").Charge["payment_method_details"];
         receipt_email: null;
         receipt_number: null;
         receipt_url: null;
@@ -247,7 +414,7 @@ export declare class StripeDomain {
         source_transfer: null;
         statement_descriptor: null;
         statement_descriptor_suffix: null;
-        status: "failed" | "pending" | "succeeded";
+        status: "succeeded" | "pending" | "failed";
         transfer_data: null;
         transfer_group: null;
     };
@@ -281,35 +448,27 @@ export declare class StripeDomain {
             captured: boolean;
             created: number;
             currency: string;
-            customer: null;
+            customer: string | null;
             description: null;
             disputed: false;
             failure_balance_transaction: null;
-            failure_code: null;
-            failure_message: null;
+            failure_code: import("../upstream-types.js").Charge["failure_code"];
+            failure_message: string | null;
             fraud_details: {};
             livemode: false;
             metadata: {};
             on_behalf_of: null;
             outcome: {
                 network_status: string;
-                reason: null;
+                reason: string | null;
                 risk_level: string;
                 seller_message: string;
                 type: string;
             };
             paid: boolean;
             payment_intent: string;
-            payment_method: null;
-            payment_method_details: {
-                type: string;
-                crypto: {
-                    buyer_address: string | undefined;
-                    network: "base";
-                    token_currency: "usdc";
-                    transaction_hash: string | undefined;
-                };
-            };
+            payment_method: string | null;
+            payment_method_details: import("../upstream-types.js").Charge["payment_method_details"];
             receipt_email: null;
             receipt_number: null;
             receipt_url: null;
@@ -319,7 +478,7 @@ export declare class StripeDomain {
             source_transfer: null;
             statement_descriptor: null;
             statement_descriptor_suffix: null;
-            status: "failed" | "pending" | "succeeded";
+            status: "succeeded" | "pending" | "failed";
             transfer_data: null;
             transfer_group: null;
         }[];
@@ -387,6 +546,224 @@ export declare class StripeDomain {
         has_more: boolean;
         url: string;
     };
+    createProduct(accountId: string, input: ProductFieldsInput): {
+        body: unknown;
+        delta: StateDelta;
+    };
+    retrieveProduct(accountId: string, id: string): {
+        id: string;
+        object: "product";
+        active: boolean;
+        created: number;
+        default_price: null;
+        description: string | null;
+        images: never[];
+        livemode: false;
+        marketing_features: never[];
+        metadata: {};
+        name: string;
+        package_dimensions: null;
+        shippable: null;
+        tax_code: null;
+        type: "service";
+        unit_label: null;
+        updated: number;
+        url: null;
+    };
+    listProducts(accountId: string, input: ListBillingInput & {
+        active?: boolean;
+    }): {
+        object: "list";
+        data: {
+            id: string;
+            object: "product";
+            active: boolean;
+            created: number;
+            default_price: null;
+            description: string | null;
+            images: never[];
+            livemode: false;
+            marketing_features: never[];
+            metadata: {};
+            name: string;
+            package_dimensions: null;
+            shippable: null;
+            tax_code: null;
+            type: "service";
+            unit_label: null;
+            updated: number;
+            url: null;
+        }[];
+        has_more: boolean;
+        url: string;
+    };
+    createPrice(accountId: string, input: CreatePriceInput): {
+        body: unknown;
+        delta: StateDelta;
+    };
+    retrievePrice(accountId: string, id: string): {
+        id: string;
+        object: "price";
+        active: boolean;
+        billing_scheme: "per_unit";
+        created: number;
+        currency: string;
+        custom_unit_amount: null;
+        livemode: false;
+        lookup_key: string | null;
+        metadata: {};
+        nickname: string | null;
+        product: string;
+        recurring: {
+            interval: import("../upstream-types.js").PriceRecurring["interval"];
+            interval_count: number;
+            meter: null;
+            usage_type: "licensed";
+        } | null;
+        tax_behavior: "unspecified";
+        tiers_mode: null;
+        transform_quantity: null;
+        type: "recurring" | "one_time";
+        unit_amount: number | null;
+        unit_amount_decimal: string | null;
+    };
+    listPrices(accountId: string, input: ListBillingInput & {
+        product?: string;
+        active?: boolean;
+    }): {
+        object: "list";
+        data: {
+            id: string;
+            object: "price";
+            active: boolean;
+            billing_scheme: "per_unit";
+            created: number;
+            currency: string;
+            custom_unit_amount: null;
+            livemode: false;
+            lookup_key: string | null;
+            metadata: {};
+            nickname: string | null;
+            product: string;
+            recurring: {
+                interval: import("../upstream-types.js").PriceRecurring["interval"];
+                interval_count: number;
+                meter: null;
+                usage_type: "licensed";
+            } | null;
+            tax_behavior: "unspecified";
+            tiers_mode: null;
+            transform_quantity: null;
+            type: "recurring" | "one_time";
+            unit_amount: number | null;
+            unit_amount_decimal: string | null;
+        }[];
+        has_more: boolean;
+        url: string;
+    };
+    createSubscription(accountId: string, input: CreateSubscriptionInput): {
+        body: unknown;
+        delta: StateDelta;
+    };
+    retrieveSubscription(accountId: string, id: string): {
+        id: string;
+        object: "subscription";
+        billing_cycle_anchor: number;
+        cancel_at: null;
+        cancel_at_period_end: boolean;
+        canceled_at: number | null;
+        collection_method: "charge_automatically";
+        created: number;
+        currency: string;
+        customer: string;
+        days_until_due: null;
+        default_payment_method: null;
+        description: null;
+        ended_at: number | null;
+        items: {
+            object: "list";
+            data: {
+                id: string;
+                object: "subscription_item";
+                created: number;
+                metadata: {};
+                price: import("../upstream-types.js").DeepPartial<import("../upstream-types.js").SubscriptionItem>["price"];
+                quantity: number;
+                subscription: string;
+            }[];
+            has_more: false;
+            url: string;
+        };
+        latest_invoice: null;
+        livemode: false;
+        metadata: {};
+        start_date: number;
+        status: import("../types.js").SubscriptionStatus;
+        trial_end: null;
+        trial_start: null;
+    };
+    updateSubscription(accountId: string, id: string, input: UpdateSubscriptionInput): {
+        body: unknown;
+        delta: StateDelta;
+    };
+    cancelSubscription(accountId: string, id: string): {
+        body: unknown;
+        delta: StateDelta;
+    };
+    listSubscriptions(accountId: string, input: ListBillingInput & {
+        customer?: string;
+        status?: string;
+    }): {
+        object: "list";
+        data: {
+            id: string;
+            object: "subscription";
+            billing_cycle_anchor: number;
+            cancel_at: null;
+            cancel_at_period_end: boolean;
+            canceled_at: number | null;
+            collection_method: "charge_automatically";
+            created: number;
+            currency: string;
+            customer: string;
+            days_until_due: null;
+            default_payment_method: null;
+            description: null;
+            ended_at: number | null;
+            items: {
+                object: "list";
+                data: {
+                    id: string;
+                    object: "subscription_item";
+                    created: number;
+                    metadata: {};
+                    price: import("../upstream-types.js").DeepPartial<import("../upstream-types.js").SubscriptionItem>["price"];
+                    quantity: number;
+                    subscription: string;
+                }[];
+                has_more: false;
+                url: string;
+            };
+            latest_invoice: null;
+            livemode: false;
+            metadata: {};
+            start_date: number;
+            status: import("../types.js").SubscriptionStatus;
+            trial_end: null;
+            trial_start: null;
+        }[];
+        has_more: boolean;
+        url: string;
+    };
+    /** Resolve item price rows so the serializer can expand SubscriptionItem.price. */
+    private subscriptionBody;
+    retrieveInvoice(accountId: string, id: string): never;
+    listInvoices(accountId: string, input: ListBillingInput): {
+        object: "list";
+        data: never[];
+        has_more: boolean;
+        url: string;
+    };
     /**
      * Account-scoped state export. Used by `/_pome/state` to surface only
      * the calling session's data. Two sessions hitting `_pome/state` see