Merge changes from stripe/stripe-node master

Committed-By-Agent: claude

# Conflicts:
#	src/resources/Billing/Alerts.ts
#	src/resources/Billing/CreditBalanceSummary.ts
#	src/resources/Billing/CreditBalanceTransactions.ts
#	src/resources/Billing/CreditGrants.ts
#	src/resources/Checkout/Sessions.ts
#	src/resources/FinancialConnections/Accounts.ts
#	src/resources/FinancialConnections/Sessions.ts
#	src/resources/Identity/VerificationReports.ts
#	src/resources/Identity/VerificationSessions.ts
#	src/resources/Issuing/Authorizations.ts
#	src/resources/Issuing/Cardholders.ts
#	src/resources/Issuing/Cards.ts
#	src/resources/Issuing/Disputes.ts
#	src/resources/Issuing/Tokens.ts
#	src/resources/Issuing/Transactions.ts
#	src/resources/Radar/PaymentEvaluations.ts
#	src/resources/Radar/index.ts
#	src/resources/Tax/CalculationLineItems.ts
#	src/resources/Tax/Calculations.ts
#	src/resources/Tax/Registrations.ts
#	src/resources/Tax/TransactionLineItems.ts
#	src/resources/Tax/Transactions.ts
#	src/resources/Terminal/Configurations.ts
#	src/resources/Terminal/Readers.ts
#	src/resources/TestHelpers/index.ts
#	src/resources/Treasury/FinancialAccountFeatures.ts
#	src/resources/Treasury/OutboundTransfers.ts
#	src/resources/Treasury/ReceivedCredits.ts
#	src/resources/Treasury/ReceivedDebits.ts
#	src/resources/V2/Commerce/ProductCatalogImports.ts
#	src/resources/V2/Core/AccountLinks.ts
#	src/resources/V2/Core/AccountPersons.ts
#	src/resources/V2/Core/Accounts.ts
#	src/resources/V2/Core/Events.ts
#	src/stripe.cjs.node.ts

Author: jar-stripe

justfile

@@ -68,7 +68,7 @@ prettier *args: install
     prettier "{src,examples,scripts,test,types}/**/*.{ts,js}" {{ args }}
 
 # ⭐ format all files
-format: (prettier "--write --loglevel silent")
+format: (prettier "--write --loglevel error")
 
 # verify formatting of files (without changes)
 format-check: (prettier "--check")

src/resources/Apps/Secrets.ts

@@ -100,25 +100,23 @@ export interface Secret {
    */
   payload?: string | null;
 
-  scope: Apps.Secret.Scope;
+  scope: Secret.Scope;
 }
-export namespace Apps {
-  export namespace Secret {
-    export interface Scope {
-      /**
-       * The secret scope type.
-       */
-      type: Scope.Type;
+export namespace Secret {
+  export interface Scope {
+    /**
+     * The secret scope type.
+     */
+    type: Scope.Type;
 
-      /**
-       * The user ID, if type is set to "user"
-       */
-      user?: string;
-    }
+    /**
+     * The user ID, if type is set to "user"
+     */
+    user?: string;
+  }
 
-    export namespace Scope {
-      export type Type = 'account' | 'user';
-    }
+  export namespace Scope {
+    export type Type = 'account' | 'user';
   }
 }
 export namespace Apps {

src/resources/Billing/Alerts.ts

@@ -442,7 +442,7 @@ export interface Alert {
   /**
    * Status of the alert. This can be active, inactive or archived.
    */
-  status: Billing.Alert.Status | null;
+  status: Alert.Status | null;
 
   /**
    * Title of the alert.
@@ -452,7 +452,7 @@ export interface Alert {
   /**
    * Encapsulates configuration of the alert to monitor usage on a specific [Billing Meter](https://docs.stripe.com/api/billing/meter).
    */
-  usage_threshold: Billing.Alert.UsageThreshold | null;
+  usage_threshold: Alert.UsageThreshold | null;
 }
 export namespace Billing {
   export namespace Alert {
@@ -494,11 +494,34 @@ export namespace Billing {
 
     export type Status = 'active' | 'archived' | 'inactive';
 
-    export interface UsageThreshold {
+  export interface UsageThreshold {
+    /**
+     * The filters allow limiting the scope of this usage alert. You can only specify up to one filter at this time.
+     */
+    filters: Array<UsageThreshold.Filter> | null;
+
+    /**
+     * The value at which this alert will trigger.
+     */
+    gte: number;
+
+    /**
+     * The [Billing Meter](https://docs.stripe.com/api/billing/meter) ID whose usage is monitored.
+     */
+    meter: string | Meter;
+
+    /**
+     * Defines how the alert will behave.
+     */
+    recurrence: 'one_time';
+  }
+
+  export namespace UsageThreshold {
+    export interface Filter {
       /**
-       * The filters allow limiting the scope of this usage alert. You can only specify up to one filter at this time.
+       * Limit the scope of the alert to this customer ID
        */
-      filters: Array<UsageThreshold.Filter> | null;
+      customer: string | Customer | null;
 
       /**
        * The value at which this alert will trigger.

src/resources/Billing/CreditBalanceSummary.ts

@@ -69,7 +69,7 @@ export interface CreditBalanceSummary {
   /**
    * The billing credit balances. One entry per credit grant currency. If a customer only has credit grants in a single currency, then this will have a single balance entry.
    */
-  balances: Array<Billing.CreditBalanceSummary.Balance>;
+  balances: Array<CreditBalanceSummary.Balance>;
 
   /**
    * The customer the balance is for.
@@ -86,18 +86,29 @@ export interface CreditBalanceSummary {
    */
   livemode: boolean;
 }
-export namespace Billing {
-  export namespace CreditBalanceSummary {
-    export interface Balance {
-      available_balance: Balance.AvailableBalance;
+export namespace CreditBalanceSummary {
+  export interface Balance {
+    available_balance: Balance.AvailableBalance;
 
       balance_update_details?: Balance.BalanceUpdateDetails;
 
       ledger_balance: Balance.LedgerBalance;
     }
 
-    export namespace Balance {
-      export interface AvailableBalance {
+    export interface LedgerBalance {
+      /**
+       * The monetary amount.
+       */
+      monetary: LedgerBalance.Monetary | null;
+
+      /**
+       * The type of this amount. We currently only support `monetary` billing credits.
+       */
+      type: 'monetary';
+    }
+
+    export namespace AvailableBalance {
+      export interface Monetary {
         /**
          * The custom pricing unit amount.
          */
@@ -106,10 +117,10 @@ export namespace Billing {
         /**
          * The monetary amount.
          */
-        monetary: AvailableBalance.Monetary | null;
+        currency: string;
 
         /**
-         * The type of this amount. We currently only support `monetary` billing credits.
+         * A positive integer representing the amount.
          */
         type: AvailableBalance.Type;
       }
@@ -120,8 +131,10 @@ export namespace Billing {
          */
         latest_meter_event: BalanceUpdateDetails.LatestMeterEvent | null;
       }
+    }
 
-      export interface LedgerBalance {
+    export namespace LedgerBalance {
+      export interface Monetary {
         /**
          * The custom pricing unit amount.
          */
@@ -130,10 +143,10 @@ export namespace Billing {
         /**
          * The monetary amount.
          */
-        monetary: LedgerBalance.Monetary | null;
+        currency: string;
 
         /**
-         * The type of this amount. We currently only support `monetary` billing credits.
+         * A positive integer representing the amount.
          */
         type: LedgerBalance.Type;
       }

src/resources/Billing/CreditBalanceTransactions.ts

@@ -160,7 +160,7 @@ export interface CreditBalanceTransaction {
   /**
    * Credit details for this credit balance transaction. Only present if type is `credit`.
    */
-  credit: Billing.CreditBalanceTransaction.Credit | null;
+  credit: CreditBalanceTransaction.Credit | null;
 
   /**
    * The credit grant associated with this credit balance transaction.
@@ -170,7 +170,7 @@ export interface CreditBalanceTransaction {
   /**
    * Debit details for this credit balance transaction. Only present if type is `debit`.
    */
-  debit: Billing.CreditBalanceTransaction.Debit | null;
+  debit: CreditBalanceTransaction.Debit | null;
 
   /**
    * The effective time of this credit balance transaction.
@@ -190,39 +190,99 @@ export interface CreditBalanceTransaction {
   /**
    * The type of credit balance transaction (credit or debit).
    */
-  type: Billing.CreditBalanceTransaction.Type | null;
+  type: CreditBalanceTransaction.Type | null;
 }
-export namespace Billing {
-  export namespace CreditBalanceTransaction {
-    export interface Credit {
-      amount: Credit.Amount;
+export namespace CreditBalanceTransaction {
+  export interface Credit {
+    amount: Credit.Amount;
+
+    /**
+     * Details of the invoice to which the reinstated credits were originally applied. Only present if `type` is `credits_application_invoice_voided`.
+     */
+    credits_application_invoice_voided: Credit.CreditsApplicationInvoiceVoided | null;
+
+    /**
+     * The type of credit transaction.
+     */
+    type: Credit.Type;
+  }
+
+  export interface Debit {
+    amount: Debit.Amount;
+
+    /**
+     * Details of how the billing credits were applied to an invoice. Only present if `type` is `credits_applied`.
+     */
+    credits_applied: Debit.CreditsApplied | null;
+
+    /**
+     * The type of debit transaction.
+     */
+    type: Debit.Type;
+  }
+
+  export type Type = 'credit' | 'debit';
 
+  export namespace Credit {
+    export interface Amount {
       /**
-       * Details of the invoice to which the reinstated credits were originally applied. Only present if `type` is `credits_application_invoice_voided`.
+       * The monetary amount.
        */
-      credits_application_invoice_voided: Credit.CreditsApplicationInvoiceVoided | null;
+      monetary: Amount.Monetary | null;
 
       /**
-       * The type of credit transaction.
+       * The type of this amount. We currently only support `monetary` billing credits.
        */
-      type: Credit.Type;
+      type: 'monetary';
     }
 
-    export interface Debit {
-      amount: Debit.Amount;
+    export interface CreditsApplicationInvoiceVoided {
+      /**
+       * The invoice to which the reinstated billing credits were originally applied.
+       */
+      invoice: string | Invoice;
 
       /**
-       * Details of how the billing credits were applied to an invoice. Only present if `type` is `credits_applied`.
+       * The invoice line item to which the reinstated billing credits were originally applied.
        */
-      credits_applied: Debit.CreditsApplied | null;
+      invoice_line_item: string;
+    }
 
+    export type Type = 'credits_application_invoice_voided' | 'credits_granted';
+
+    export namespace Amount {
+      export interface Monetary {
+        /**
+         * Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
+         */
+        currency: string;
+
+        /**
+         * A positive integer representing the amount.
+         */
+        value: number;
+      }
+    }
+  }
+
+  export namespace Debit {
+    export interface Amount {
       /**
-       * The type of debit transaction.
+       * The monetary amount.
        */
-      type: Debit.Type;
+      monetary: Amount.Monetary | null;
+
+      /**
+       * The type of this amount. We currently only support `monetary` billing credits.
+       */
+      type: 'monetary';
     }
 
-    export type Type = 'credit' | 'debit';
+    export interface CreditsApplied {
+      /**
+       * The invoice to which the billing credits were applied.
+       */
+      invoice: string | Invoice;
 
     export namespace Credit {
       export interface Amount {
@@ -326,8 +386,10 @@ export namespace Billing {
       }
     }
 
-    export namespace Debit {
-      export interface Amount {
+    export type Type = 'credits_applied' | 'credits_expired' | 'credits_voided';
+
+    export namespace Amount {
+      export interface Monetary {
         /**
          * The custom pricing unit amount.
          */
@@ -336,10 +398,10 @@ export namespace Billing {
         /**
          * The monetary amount.
          */
-        monetary: Amount.Monetary | null;
+        currency: string;
 
         /**
-         * The type of this amount. We currently only support `monetary` billing credits.
+         * A positive integer representing the amount.
          */
         type: Amount.Type;
       }