@stacksjs/payments 0.70.86 → 0.70.88

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/payments",
   "type": "module",
   "sideEffects": false,
-  "version": "0.70.86",
+  "version": "0.70.88",
   "description": "The Stacks payments package. Currently supporting Stripe.",
   "author": "Chris Breuer",
   "contributors": [
@@ -67,9 +67,9 @@
     }
   },
   "devDependencies": {
-    "@stacksjs/config": "0.70.86",
+    "@stacksjs/config": "0.70.88",
     "better-dx": "^0.2.16",
-    "@stacksjs/utils": "0.70.86",
+    "@stacksjs/utils": "0.70.88",
     "@stripe/stripe-js": "^8.7.0",
     "stripe": "^21.0.1"
   }

package/dist/billable/charge.d.ts

@@ -1,9 +0,0 @@
-import type { UserModel } from '@stacksjs/orm';
-import type Stripe from 'stripe';
-export declare const manageCharge: ManageCharge;
-export declare interface ManageCharge {
-  createPayment: (user: UserModel, amount: number, options: Stripe.PaymentIntentCreateParams) => Promise<Stripe.Response<Stripe.PaymentIntent>>
-  findPayment: (id: string) => Promise<Stripe.PaymentIntent | null>
-  refund: (paymentIntentId: string, options?: Stripe.RefundCreateParams) => Promise<Stripe.Response<Stripe.Refund>>
-  charge: (user: UserModel, amount: number, paymentMethod: string, options: Stripe.PaymentIntentCreateParams) => Promise<Stripe.Response<Stripe.PaymentIntent>>
-}

package/dist/billable/checkout.d.ts

@@ -1,6 +0,0 @@
-import type { UserModel } from '@stacksjs/orm';
-import type Stripe from 'stripe';
-export declare const manageCheckout: Checkout;
-export declare interface Checkout {
-  create: (user: UserModel, params: Stripe.Checkout.SessionCreateParams) => Promise<Stripe.Response<Stripe.Checkout.Session>>
-}

package/dist/billable/customer.d.ts

@@ -1,15 +0,0 @@
-import type { StripeCustomerOptions } from '@stacksjs/types';
-import type { UserModel } from '@stacksjs/orm';
-import type Stripe from 'stripe';
-export declare const manageCustomer: ManageCustomer;
-export declare interface ManageCustomer {
-  stripeId: (user: UserModel) => string
-  hasStripeId: (user: UserModel) => boolean
-  createStripeCustomer: (user: UserModel, options: Stripe.CustomerCreateParams) => Promise<Stripe.Response<Stripe.Customer>>
-  updateStripeCustomer: (user: UserModel, options: Stripe.CustomerUpdateParams) => Promise<Stripe.Response<Stripe.Customer>>
-  createOrGetStripeUser: (user: UserModel, options: Stripe.CustomerCreateParams) => Promise<Stripe.Response<Stripe.Customer>>
-  retrieveStripeUser: (user: UserModel) => Promise<Stripe.Response<Stripe.Customer> | undefined>
-  createOrUpdateStripeUser: (user: UserModel, options: Stripe.CustomerCreateParams) => Promise<Stripe.Response<Stripe.Customer>>
-  deleteStripeUser: (user: UserModel) => Promise<Stripe.Response<Stripe.DeletedCustomer>>
-  syncStripeCustomerDetails: (user: UserModel, options: StripeCustomerOptions) => Promise<Stripe.Response<Stripe.Customer>>
-}

package/dist/billable/index.d.ts

@@ -1,13 +0,0 @@
-// Core Billable Modules
-export * from './charge';
-export * from './checkout';
-export * from './customer';
-export * from './intent';
-export * from './invoice';
-export * from './payment-method';
-export * from './price';
-export * from './product';
-export * from './setup-products';
-export * from './subscription';
-export * from './transaction';
-export * from './webhook';

package/dist/billable/intent.d.ts

@@ -1,6 +0,0 @@
-import type { UserModel } from '@stacksjs/orm';
-import type Stripe from 'stripe';
-export declare const manageSetupIntent: SetupIntent;
-export declare interface SetupIntent {
-  create: (user: UserModel, params: Stripe.SetupIntentCreateParams) => Promise<Stripe.Response<Stripe.SetupIntent>>
-}

package/dist/billable/invoice.d.ts

@@ -1,6 +0,0 @@
-import type { UserModel } from '@stacksjs/orm';
-import type Stripe from 'stripe';
-export declare const manageInvoice: ManageInvoice;
-export declare interface ManageInvoice {
-  list: (user: UserModel) => Promise<Stripe.Response<Stripe.ApiList<Stripe.Invoice>>>
-}

package/dist/billable/payment-method.d.ts

@@ -1,18 +0,0 @@
-import { PaymentMethod } from '@stacksjs/orm';
-import type { ModelRow, UserModel } from '@stacksjs/orm';
-import type { Selectable } from '@stacksjs/database';
-import type Stripe from 'stripe';
-export declare const managePaymentMethod: ManagePaymentMethod;
-export declare interface ManagePaymentMethod {
-  addPaymentMethod: (user: UserModel, paymentMethod: string | Stripe.PaymentMethod) => Promise<Stripe.Response<Stripe.PaymentMethod>>
-  updatePaymentMethod: (user: UserModel, paymentMethodId: string, updateParams?: Stripe.PaymentMethodUpdateParams) => Promise<Stripe.Response<Stripe.PaymentMethod>>
-  setUserDefaultPayment: (user: UserModel, paymentMethodId: string) => Promise<Stripe.Response<Stripe.Customer>>
-  setDefaultPaymentMethod: (user: UserModel, paymentMethodId: number) => Promise<Stripe.Response<Stripe.Customer>>
-  storePaymentMethod: (user: UserModel, paymentMethodId: Stripe.PaymentMethod) => Promise<PaymentMethodInstance>
-  deletePaymentMethod: (user: UserModel, paymentMethodId: string | number) => Promise<Stripe.Response<Stripe.PaymentMethod>>
-  retrievePaymentMethod: (user: UserModel, paymentMethodId: number) => Promise<PaymentMethodInstance | undefined>
-  retrieveDefaultPaymentMethod: (user: UserModel) => Promise<PaymentMethodInstance | undefined>
-  listPaymentMethods: (user: UserModel, cardType?: string) => Promise<Selectable<PaymentMethodsTable>[]>
-}
-declare type PaymentMethodInstance = NonNullable<Awaited<ReturnType<typeof PaymentMethod.find>>>;
-declare type PaymentMethodsTable = ModelRow<typeof PaymentMethod>;

package/dist/billable/price.d.ts

@@ -1,6 +0,0 @@
-import type Stripe from 'stripe';
-export declare const managePrice: PriceManager;
-export declare interface PriceManager {
-  retrieveByLookupKey: (lookupKey: string) => Promise<Stripe.Price | undefined>
-  createOrGet: (lookupKey: string, params: Stripe.PriceCreateParams) => Promise<Stripe.Price>
-}

package/dist/billable/product.d.ts

@@ -1,37 +0,0 @@
-import type Stripe from 'stripe';
-export declare const manageProduct: ProductManager;
-export declare const managePriceExtended: ExtendedPriceManager;
-export declare const manageCoupon: CouponManager;
-export declare interface ProductManager {
-  create: (params: Stripe.ProductCreateParams) => Promise<Stripe.Response<Stripe.Product>>
-  retrieve: (productId: string) => Promise<Stripe.Response<Stripe.Product>>
-  update: (productId: string, params: Stripe.ProductUpdateParams) => Promise<Stripe.Response<Stripe.Product>>
-  list: (params?: Stripe.ProductListParams) => Promise<Stripe.Response<Stripe.ApiList<Stripe.Product>>>
-  archive: (productId: string) => Promise<Stripe.Response<Stripe.Product>>
-  createWithPrice: (product: Stripe.ProductCreateParams, price: Omit<Stripe.PriceCreateParams, 'product'>) => Promise<{ product: Stripe.Product, price: Stripe.Price }>
-  search: (query: string, params?: Stripe.ProductSearchParams) => Promise<Stripe.Response<Stripe.ApiSearchResult<Stripe.Product>>>
-}
-// =============================================================================
-// Extended Price Management
-// =============================================================================
-export declare interface ExtendedPriceManager {
-  create: (params: Stripe.PriceCreateParams) => Promise<Stripe.Response<Stripe.Price>>
-  retrieve: (priceId: string) => Promise<Stripe.Response<Stripe.Price>>
-  update: (priceId: string, params: Stripe.PriceUpdateParams) => Promise<Stripe.Response<Stripe.Price>>
-  list: (params?: Stripe.PriceListParams) => Promise<Stripe.Response<Stripe.ApiList<Stripe.Price>>>
-  listByProduct: (productId: string, params?: Stripe.PriceListParams) => Promise<Stripe.Response<Stripe.ApiList<Stripe.Price>>>
-  search: (query: string, params?: Stripe.PriceSearchParams) => Promise<Stripe.Response<Stripe.ApiSearchResult<Stripe.Price>>>
-  archive: (priceId: string) => Promise<Stripe.Response<Stripe.Price>>
-}
-// =============================================================================
-// Coupon and Promotion Code Management
-// =============================================================================
-export declare interface CouponManager {
-  create: (params: Stripe.CouponCreateParams) => Promise<Stripe.Response<Stripe.Coupon>>
-  retrieve: (couponId: string) => Promise<Stripe.Response<Stripe.Coupon>>
-  update: (couponId: string, params: Stripe.CouponUpdateParams) => Promise<Stripe.Response<Stripe.Coupon>>
-  delete: (couponId: string) => Promise<Stripe.Response<Stripe.DeletedCoupon>>
-  list: (params?: Stripe.CouponListParams) => Promise<Stripe.Response<Stripe.ApiList<Stripe.Coupon>>>
-  createPromotionCode: (params: Stripe.PromotionCodeCreateParams) => Promise<Stripe.Response<Stripe.PromotionCode>>
-  retrievePromotionCode: (code: string) => Promise<Stripe.PromotionCode | null>
-}

package/dist/billable/setup-products.d.ts

@@ -1,2 +0,0 @@
-import type { Result } from '@stacksjs/error-handling';
-export declare function createStripeProduct(): Promise<Result<string, Error>>;

package/dist/billable/subscription.d.ts

@@ -1,12 +0,0 @@
-import type { UserModel } from '@stacksjs/orm';
-import type Stripe from 'stripe';
-export declare const manageSubscription: SubscriptionManager;
-export declare interface SubscriptionManager {
-  create: (user: UserModel, type: string, lookupKey: string, params: Partial<Stripe.SubscriptionCreateParams>) => Promise<Stripe.Response<Stripe.Subscription>>
-  update: (user: UserModel, type: string, lookupKey: string, params: Partial<Stripe.SubscriptionUpdateParams>) => Promise<Stripe.Response<Stripe.Subscription>>
-  cancel: (subscriptionId: string, params?: Partial<Stripe.SubscriptionCreateParams>) => Promise<Stripe.Response<Stripe.Subscription>>
-  retrieve: (user: UserModel, subscriptionId: string) => Promise<Stripe.Response<Stripe.Subscription>>
-  isValid: (user: UserModel, type: string) => Promise<boolean>
-  isIncomplete: (user: UserModel, type: string) => Promise<boolean>
-}
-declare type SubscriptionsTable = Record<string, unknown>;

package/dist/billable/transaction.d.ts

@@ -1,14 +0,0 @@
-import { PaymentTransaction } from '@stacksjs/orm';
-import type { ModelRow, UserModel } from '@stacksjs/orm';
-export declare const manageTransaction: ManageTransaction;
-export declare interface StoreTransactionOptions {
-  brand: string
-  provider_id: string
-  description?: string
-  type?: string
-}
-export declare interface ManageTransaction {
-  store: (user: UserModel, productId: number, options: StoreTransactionOptions) => Promise<PaymentTransactionsTable | undefined>
-  list: (user: UserModel) => Promise<PaymentTransactionsTable[]>
-}
-declare type PaymentTransactionsTable = ModelRow<typeof PaymentTransaction>;

package/dist/billable/webhook.d.ts

@@ -1,155 +0,0 @@
-import type Stripe from 'stripe';
-/**
- * Register a webhook event handler
- */
-export declare function onWebhookEvent(eventType: WebhookEventType, handler: WebhookHandler): void;
-/**
- * Register multiple webhook handlers at once
- */
-export declare function registerWebhookHandlers(handlerMap: Record<WebhookEventType, WebhookHandler>): void;
-/**
- * Construct and verify a webhook event from the raw request.
- *
- * `tolerance` (in seconds) controls how much clock skew between Stripe and
- * this server is acceptable before signatures are rejected. Stripe's SDK
- * default is 300s; tightening this is recommended in production but the
- * previous code dropped the value entirely, so a configured tolerance was
- * silently ignored.
- */
-export declare function constructEvent(payload: string | Buffer, signature: string, secret: string, tolerance?: number): Stripe.Event;
-/**
- * Async variant of {@link constructEvent}. Some runtimes (notably Bun) resolve
- * the Stripe SDK's crypto provider to WebCrypto's `SubtleCrypto`, which is
- * async-only — the synchronous `constructEvent` then throws
- * "SubtleCryptoProvider cannot be used in a synchronous context". Verifying via
- * `constructEventAsync` works across Node and Bun, so webhook processing uses
- * this path.
- */
-export declare function constructEventAsync(payload: string | Buffer, signature: string, secret: string, tolerance?: number): Promise<Stripe.Event>;
-/**
- * Handle an incoming webhook event
- */
-export declare function handleWebhookEvent(event: Stripe.Event): Promise<{ handled: boolean, eventType: string, errors?: string[] }>;
-/**
- * Process a webhook request
- */
-export declare function processWebhook(payload: string | Buffer, signature: string, config: WebhookConfig): Promise<{ success: boolean, eventType?: string, error?: string }>;
-/**
- * Register payment intent handlers
- */
-export declare function onPaymentIntent(handlers: {
-  succeeded?: WebhookHandler
-  failed?: WebhookHandler
-  created?: WebhookHandler
-  canceled?: WebhookHandler
-}): void;
-/**
- * Register subscription handlers
- */
-export declare function onSubscription(handlers: {
-  created?: WebhookHandler
-  updated?: WebhookHandler
-  deleted?: WebhookHandler
-  trialWillEnd?: WebhookHandler
-}): void;
-/**
- * Register invoice handlers
- */
-export declare function onInvoice(handlers: {
-  paid?: WebhookHandler
-  paymentFailed?: WebhookHandler
-  created?: WebhookHandler
-  finalized?: WebhookHandler
-}): void;
-/**
- * Register checkout session handlers
- */
-export declare function onCheckout(handlers: {
-  completed?: WebhookHandler
-  expired?: WebhookHandler
-}): void;
-/**
- * Register charge handlers
- */
-export declare function onCharge(handlers: {
-  succeeded?: WebhookHandler
-  failed?: WebhookHandler
-  refunded?: WebhookHandler
-  disputed?: WebhookHandler
-}): void;
-/**
- * Extract payment intent from event
- */
-export declare function getPaymentIntent(event: Stripe.Event): Stripe.PaymentIntent | null;
-/**
- * Extract subscription from event
- */
-export declare function getSubscription(event: Stripe.Event): Stripe.Subscription | null;
-/**
- * Extract invoice from event
- */
-export declare function getInvoice(event: Stripe.Event): Stripe.Invoice | null;
-/**
- * Extract checkout session from event
- */
-export declare function getCheckoutSession(event: Stripe.Event): Stripe.Checkout.Session | null;
-/**
- * Extract charge from event
- */
-export declare function getCharge(event: Stripe.Event): Stripe.Charge | null;
-/**
- * Extract customer from event
- */
-export declare function getCustomer(event: Stripe.Event): Stripe.Customer | null;
-declare const handlers: Map<WebhookEventType, WebhookHandler[]>;
-export declare const manageWebhook: {
-  onWebhookEvent: typeof onWebhookEvent;
-  registerWebhookHandlers: typeof registerWebhookHandlers;
-  constructEvent: typeof constructEvent;
-  constructEventAsync: typeof constructEventAsync;
-  handleWebhookEvent: typeof handleWebhookEvent;
-  processWebhook: typeof processWebhook;
-  onPaymentIntent: typeof onPaymentIntent;
-  onSubscription: typeof onSubscription;
-  onInvoice: typeof onInvoice;
-  onCheckout: typeof onCheckout;
-  onCharge: typeof onCharge;
-  getPaymentIntent: typeof getPaymentIntent;
-  getSubscription: typeof getSubscription;
-  getInvoice: typeof getInvoice;
-  getCheckoutSession: typeof getCheckoutSession;
-  getCharge: typeof getCharge;
-  getCustomer: typeof getCustomer
-};
-export declare interface WebhookConfig {
-  secret: string
-  tolerance?: number
-}
-export type WebhookEventType = | 'payment_intent.succeeded'
-  | 'payment_intent.payment_failed'
-  | 'payment_intent.created'
-  | 'payment_intent.canceled'
-  | 'customer.subscription.created'
-  | 'customer.subscription.updated'
-  | 'customer.subscription.deleted'
-  | 'customer.subscription.trial_will_end'
-  | 'customer.created'
-  | 'customer.updated'
-  | 'customer.deleted'
-  | 'invoice.paid'
-  | 'invoice.payment_failed'
-  | 'invoice.finalized'
-  | 'invoice.created'
-  | 'checkout.session.completed'
-  | 'checkout.session.expired'
-  | 'charge.succeeded'
-  | 'charge.failed'
-  | 'charge.refunded'
-  | 'charge.dispute.created'
-  | 'charge.dispute.closed'
-  | 'payment_method.attached'
-  | 'payment_method.detached'
-  | 'setup_intent.succeeded'
-  | 'setup_intent.setup_failed'
-  | string;
-export type WebhookHandler = (_event: Stripe.Event) => Promise<void> | void;

package/dist/drivers/stripe.d.ts

@@ -1,8 +0,0 @@
-import type Stripe from 'stripe';
-/**
- * Lazy-initialized Stripe instance.
- * Only throws when you actually try to use Stripe, not at module load time.
- * This allows the payments package to be imported without a configured key
- * (e.g., in tests, CLI, or environments that don't use Stripe).
- */
-export declare const stripe: Stripe;

package/dist/idempotency.d.ts

@@ -1,26 +0,0 @@
-/**
- * Build a deterministic Stripe idempotency key for an operation.
- * The `scope` should be a stable string identifying the call site
- * (e.g. `'customer.create'`, `'subscription.create'`); `parts` are
- * any extra identifying values (user id, lookup key, etc.) that
- * uniquely scope the operation within that user's lifetime.
- *
- * @param scope - stable operation name; never user input
- * @param parts - identifying values appended after scope (coerced
- *                to string; nullish values are skipped)
- */
-export declare function stacksIdempotencyKey(scope: string, ...parts: Array<string | number | null | undefined>): string;
-/**
- * Build a one-shot idempotency key for operations that are NOT
- * naturally retryable (a unique-per-attempt key that won't collide
- * with anything). Used when the caller WANTS a fresh Stripe object
- * each time but still wants the safety of a single network retry
- * within a single attempt. The key includes a random suffix so
- * sequential attempts produce different keys.
- *
- * Used for payment intents, checkout sessions — operations where
- * "create another one" is the right semantic on a retry by the
- * caller, but where a single network blip during a single attempt
- * still benefits from in-flight idempotency.
- */
-export declare function freshIdempotencyKey(scope: string, ...parts: Array<string | number | null | undefined>): string;

package/dist/index.d.ts

@@ -1,16 +0,0 @@
-export type * as Stripe from 'stripe';
-/**
- * Payments Package
- *
- * Provides payment processing capabilities with Stripe integration.
- */
-// Main Payment facade
-export * from './payment';
-export { default as Payment } from './payment';
-// Billable modules
-export * from './billable/index';
-// Stripe driver and SDK
-export * from './drivers/stripe';
-// Idempotency-key helpers — passed to every Stripe create/update so
-// retries don't produce duplicate objects (stacksjs/stacks#1876 X-1).
-export { freshIdempotencyKey, stacksIdempotencyKey } from './idempotency';

package/dist/index.js

@@ -1,2 +0,0 @@
-// @bun
-import{createRequire as t}from"module";import{services as u}from"@stacksjs/config";var e=t(import.meta.url);function TT(){try{return e("stripe")}catch{throw Error("Stripe payments are being used but the `stripe` package is not installed. "+"It is an opt-in dependency \u2014 run `bun add stripe` to enable server-side Stripe payments.")}}var b=null,_=new Proxy({},{get(T,x){if(!b){let w=u?.stripe?.secretKey;if(!w)throw Error("Stripe secret key is not configured. Set STRIPE_SECRET_KEY in your .env file.");let $="2026-03-25.dahlia",z=u?.stripe?.apiVersion;if(z&&z!==$)throw Error(`Stripe API version ${z} does not match the installed SDK version ${$}`);b=new(TT())(w,{apiVersion:$})}return b[x]}});import{config as wT}from"@stacksjs/config";import{log as _T}from"@stacksjs/logging";import{createHash as d}from"crypto";var I="stacks",y="v1",xT=255;function D(T,...x){let w=x.filter((Q)=>Q!==null&&Q!==void 0&&Q!=="").map((Q)=>String(Q)).join(":"),$=w?`${I}:${T}:${w}:${y}`:`${I}:${T}:${y}`;if($.length<=xT)return $;let z=d("sha256").update(w).digest("hex").slice(0,32);return`${I}:${T}:${z}:${y}`}function W(T,...x){let w=d("sha256").update(`${Date.now()}:${Math.random()}`).digest("hex").slice(0,16);return D(T,...x,w)}function i(){let T=wT||{};return(T.payment?.currency||T.billing?.currency||process.env.STRIPE_CURRENCY||"usd").toLowerCase()}var C=(()=>{async function T(z,Q,X){let B={currency:i(),amount:Q};if(z.hasStripeId())B.customer=z.stripe_id??void 0;let H={...B,...X};return await _.paymentIntents.create(H,{idempotencyKey:W("payment_intent.create",z.id,Q)})}async function x(z){try{return await _.paymentIntents.retrieve(z)}catch(Q){return _T.error(Q),null}}async function w(z,Q={}){if(!z||typeof z!=="string")throw Error("[payments/refund] paymentIntentId is required");if(Q.amount!=null){if(typeof Q.amount!=="number"||!Number.isFinite(Q.amount)||Q.amount<=0)throw Error("[payments/refund] amount must be a positive finite number");try{let J=await _.paymentIntents.retrieve(z),L=J.amount_received??J.amount;if(L&&Q.amount>L)throw Error(`[payments/refund] amount ${Q.amount} exceeds captured amount ${L}`)}catch(J){if(J instanceof Error&&J.message.startsWith("[payments/refund]"))throw J}}let{idempotencyKey:X,...B}=Q,H={payment_intent:z,...B},N={idempotencyKey:X||`refund:${z}:${B.amount??"full"}`};return await _.refunds.create(H,N)}async function $(z,Q,X,B){let N={...{confirmation_method:"automatic",confirm:!0,payment_method:X,currency:i(),amount:Q},...B};return await T(z,Q,N)}return{createPayment:T,charge:$,findPayment:x,refund:w}})();import{config as FT}from"@stacksjs/config";function a(T,x){if(!T)return;let w;try{w=new URL(T)}catch{throw Error(`[payments/checkout] ${x} is not a valid URL: ${T}`)}let $=FT?.app?.url;if(!$)return;let z;try{z=new URL($.startsWith("http")?$:`https://${$}`).origin}catch{return}if(w.origin!==z)throw Error(`[payments/checkout] ${x} origin (${w.origin}) does not match app origin (${z})`)}var l=(()=>{async function T(x,w){let $=w.customer||x.stripe_id;if(!$)throw Error("User has no Stripe customer");a(w.success_url,"success_url"),a(w.cancel_url,"cancel_url");let Q={...{customer:$,mode:"payment",success_url:w.success_url,cancel_url:w.cancel_url},...w};return await _.checkout.sessions.create(Q,{idempotencyKey:W("checkout.session.create",x.id)})}return{create:T}})();var O=(()=>{function T(F){return F.stripe_id||""}function x(F){return{line1:F.address?.line1,city:F.address?.city,state:F.address?.state,postal_code:F.address?.postal_code,country:F.address?.country}}function w(){return[]}function $(F){return F}function z(F){return Boolean(F.stripe_id)}async function Q(F,Z={}){if(z(F))throw Error("Customer already created");if(!Z.name&&G(F))Z.name=G(F);if(!Z.email&&R(F))Z.email=R(F);let A=await _.customers.create(Z,{idempotencyKey:D("customer.create",F.id)});return await F.update({stripe_id:A.id}),A}async function X(F,Z={}){if(!F.stripe_id)throw Error("User does not have a Stripe customer ID. Create a customer first.");return await _.customers.update(F.stripe_id,Z,{idempotencyKey:D("customer.update",F.id,F.stripe_id)})}async function B(F){if(!z(F))throw Error("User does not have a Stripe ID");try{if(!F.stripe_id)throw Error("User has no Stripe ID");let Z=await _.customers.del(F.stripe_id);return await F.update({stripe_id:""}),Z}catch(Z){if(Z.statusCode===404)throw Error("Customer not found in Stripe");throw Z}}async function H(F,Z={}){if(!z(F))return await Q(F,Z);try{let A=await _.customers.retrieve(F.stripe_id);if(A.deleted)throw Error("Customer was deleted");return A}catch(A){if(A.statusCode===404)return await Q(F,Z);throw A}}async function N(F){if(!z(F))return;try{let Z=await _.customers.retrieve(F.stripe_id);if(Z.deleted)throw Error("Customer was deleted in Stripe");return Z}catch(Z){if(Z.statusCode===404)throw Error("Customer not found in Stripe");throw Z}}async function J(F,Z){if(!z(F))return await Q(F,Z);try{if((await _.customers.retrieve(F.stripe_id)).deleted)return await Q(F,Z);return await X(F,Z)}catch(A){if(A.statusCode===404)return await Q(F,Z);throw A}}async function L(F,Z){return await X(F,{name:G(F),email:R(F),address:x(Z),preferred_locales:w(),metadata:Z.metadata?$(Z.metadata):{}})}function G(F){return F.name||""}function R(F){return F.email||""}return{stripeId:T,hasStripeId:z,createStripeCustomer:Q,updateStripeCustomer:X,createOrGetStripeUser:H,createOrUpdateStripeUser:J,deleteStripeUser:B,retrieveStripeUser:N,syncStripeCustomerDetails:L}})();var p=(()=>{async function T(x){if(!x.hasStripeId())throw Error("Customer does not exist in Stripe");if(!x.stripe_id)throw Error("User has no Stripe ID");return await _.invoices.list({customer:x.stripe_id,expand:["data.payment_intent.payment_method"]})}return{list:T}})();import{db as V}from"@stacksjs/database";import{PaymentMethod as h}from"@stacksjs/orm";var k=(()=>{async function T(J,L){if(!J.hasStripeId())throw Error("Customer does not exist in Stripe");let G;if(typeof L==="string")G=await _.paymentMethods.retrieve(L);else G=L;if(G.customer!==J.stripe_id)G=await _.paymentMethods.attach(G.id,{customer:J.stripe_id});return await $(J,G),G}async function x(J,L){if(!J.hasStripeId())throw Error("Customer does not exist in Stripe");let G=await _.paymentMethods.retrieve(L),R=await V.selectFrom("payment_methods").where("provider_id","=",L).selectAll().executeTakeFirst();if(!J.stripe_id)throw Error("User has no Stripe ID");if(G.customer!==J.stripe_id)await _.paymentMethods.attach(G.id,{customer:J.stripe_id});let F=await _.customers.update(J.stripe_id,{invoice_settings:{default_payment_method:L}});if(await V.updateTable("payment_methods").set({is_default:!1}).where("user_id","=",J.id).executeTakeFirst(),R)await z(R);return F}async function w(J,L){if(!J.hasStripeId())throw Error("Customer does not exist in Stripe");let G=await V.selectFrom("payment_methods").where("id","=",L).selectAll().executeTakeFirst();if(!G?.provider_id)throw Error(`Payment method with id ${L} not found`);let R=await _.paymentMethods.retrieve(String(G.provider_id));if(R.customer!==J.stripe_id)await _.paymentMethods.attach(R.id,{customer:J.stripe_id});if(!J.stripe_id)throw Error("User has no Stripe ID");let F=await _.customers.update(J.stripe_id,{invoice_settings:{default_payment_method:String(G.provider_id)}});return await V.updateTable("payment_methods").set({is_default:!1}).where("user_id","=",J.id).executeTakeFirst(),await V.updateTable("payment_methods").set({is_default:!0}).where("id","=",L).executeTakeFirst(),F}async function $(J,L){if(!J.hasStripeId())throw Error("Customer does not exist in Stripe");if(!L.card?.brand||!L.card?.exp_year||!L.card?.exp_month)throw Error("Invalid payment method: missing required card details");let G={type:"card",last_four:String(L.card.last4),brand:L.card.brand,exp_year:L.card.exp_year,exp_month:L.card.exp_month,user_id:J.id,provider_id:L.id};if(L.customer!==J.stripe_id)await _.paymentMethods.attach(L.id,{customer:J.stripe_id});return await h.create(G)}async function z(J){return await J.update({is_default:!0})}async function Q(J,L){if(!J.hasStripeId())throw Error("Customer does not exist in Stripe");let G=typeof L==="string"?await V.selectFrom("payment_methods").where("provider_id","=",L).selectAll().executeTakeFirst():await h.find(L);if(!G?.provider_id)throw Error(`Payment method with id ${L} not found`);if((await _.paymentMethods.retrieve(String(G.provider_id))).customer!==J.stripe_id)throw Error("Payment method does not belong to this customer");return await G.delete(),await _.paymentMethods.detach(String(G.provider_id))}async function X(J,L,G){if(!J.hasStripeId())throw Error("Customer does not exist in Stripe");if((await _.paymentMethods.retrieve(L)).customer!==J.stripe_id)throw Error("Payment method does not belong to this customer");return await _.paymentMethods.update(L,G)}async function B(J){if(!J.hasStripeId())throw Error("Customer does not exist in Stripe");return await V.selectFrom("payment_methods").selectAll().where("user_id","=",J.id).execute()}async function H(J,L){if(!J.hasStripeId())throw Error("Customer does not exist in Stripe");return await V.selectFrom("payment_methods").where("id","=",L).selectAll().executeTakeFirst()}async function N(J){if(!J.hasStripeId())throw Error("Customer does not exist in Stripe");return await h.where("user_id",J.id).where("is_default",!0).first()}return{addPaymentMethod:T,deletePaymentMethod:Q,retrieveDefaultPaymentMethod:N,updatePaymentMethod:X,listPaymentMethods:B,setDefaultPaymentMethod:w,storePaymentMethod:$,retrievePaymentMethod:H,setUserDefaultPayment:x}})();var E=(()=>{async function T(w){let $=await _.prices.list({lookup_keys:[w]});if(!$.data.length)return;return $.data[0]}async function x(w,$){let z=await T(w);if(z)return z;return await _.prices.create({...$,lookup_key:w})}return{retrieveByLookupKey:T,createOrGet:x}})();var c=(()=>{async function T(B){return await _.products.create(B)}async function x(B){return await _.products.retrieve(B)}async function w(B,H){return await _.products.update(B,H)}async function $(B={}){return await _.products.list({active:!0,...B})}async function z(B){return await _.products.update(B,{active:!1})}async function Q(B,H){let N=await _.products.create(B),J=await _.prices.create({...H,product:N.id});return{product:N,price:J}}async function X(B,H={query:""}){return await _.products.search({...H,query:B})}return{create:T,retrieve:x,update:w,list:$,archive:z,createWithPrice:Q,search:X}})(),$T=(()=>{async function T(B){return await _.prices.create(B)}async function x(B){return await _.prices.retrieve(B)}async function w(B,H){return await _.prices.update(B,H)}async function $(B={}){return await _.prices.list({active:!0,...B})}async function z(B,H={}){return await _.prices.list({product:B,active:!0,...H})}async function Q(B,H={query:""}){return await _.prices.search({...H,query:B})}async function X(B){return await _.prices.update(B,{active:!1})}return{create:T,retrieve:x,update:w,list:$,listByProduct:z,search:Q,archive:X}})(),M=(()=>{async function T(B){return await _.coupons.create(B)}async function x(B){return await _.coupons.retrieve(B)}async function w(B,H){return await _.coupons.update(B,H)}async function $(B){return await _.coupons.del(B)}async function z(B={}){return await _.coupons.list(B)}async function Q(B){return await _.promotionCodes.create(B)}async function X(B){try{let H=await _.promotionCodes.list({code:B,active:!0});if(H.data.length>0)return H.data[0]??null;return null}catch{return null}}return{create:T,retrieve:x,update:w,delete:$,list:z,createPromotionCode:Q,retrievePromotionCode:X}})();import{db as f}from"@stacksjs/database";import{HttpError as zT}from"@stacksjs/error-handling";import{isUniqueViolation as BT}from"@stacksjs/orm";var P=(()=>{async function T(G,R,F,Z){let A=await E.retrieveByLookupKey(F);if(!A)throw Error("Price does not exist in Stripe");let U=[{price:A.id,quantity:1}],j={...{customer:await O.createOrGetStripeUser(G,{}).then((g)=>{if(!g||!g.id)throw Error("Customer does not exist in Stripe");return g.id}),payment_behavior:"allow_incomplete",expand:["latest_invoice.payment_intent"],items:U},...Z},K=await _.subscriptions.create(j,{idempotencyKey:D("subscription.create",G.id,R,F)});return await N(G,R,F,K),K}async function x(G,R,F,Z={}){let A=await E.retrieveByLookupKey(F),U=await G?.activeSubscription();if(!A)throw Error("New price does not exist in Stripe");if(!U)throw Error("No active subscription for user!");let q=U.subscription?.provider_id;if(!q)throw Error("Active subscription has no provider ID");let S=await _.subscriptions.retrieve(q);if(!S)throw Error("Subscription does not exist in Stripe");let j=S.items.data[0]?.id;if(!j)throw Error("No subscription items found in the subscription");await _.subscriptions.update(q,{items:[{id:j,price:A.id,quantity:1}],proration_behavior:"create_prorations"},{idempotencyKey:D("subscription.update",q,A.id)});let K=await _.subscriptions.retrieve(q);if(!U.subscription?.id)throw Error("Active subscription has no database ID");return await J(U.subscription.id,R,K),K}async function w(G,R){if(!await _.subscriptions.retrieve(G))throw Error("Subscription does not exist or does not belong to the user");let Z=await _.subscriptions.cancel(G,R,{idempotencyKey:D("subscription.cancel",G)});return await z(G),Z}async function $(G,R){if(!G.hasStripeId())throw Error("Customer does not exist in Stripe");return await _.subscriptions.retrieve(R)}async function z(G){await f.updateTable("subscriptions").set({provider_status:"canceled"}).where("provider_id","=",G).executeTakeFirst()}function Q(G){return G.provider_status==="active"}function X(G){return G.provider_status==="trialing"}async function B(G,R){let F=await f.selectFrom("subscriptions").where("user_id","=",G.id).where("type","=",R).selectAll().executeTakeFirst();if(!F)return!1;return F.provider_status==="incomplete"}async function H(G,R){let F=await f.selectFrom("subscriptions").where("user_id","=",G.id).where("type","=",R).selectAll().executeTakeFirst();if(!F)return!1;let Z=await Q(F),A=await X(F);return Z||A}async function N(G,R,F,Z){let A=Z.items.data[0];if(!A)throw Error("Stripe subscription contains no line items \u2014 cannot store subscription");let U=L({user_id:G.id,type:R,unit_price:Number(A.price.unit_amount),provider_id:Z.id,provider_status:Z.status,provider_price_id:A.price.id,quantity:A.quantity,trial_ends_at:Z.trial_end!=null?String(Z.trial_end):void 0,ends_at:Z.current_period_end!=null?String(Z.current_period_end):void 0,provider_type:"stripe",last_used_at:Z.current_period_end!=null?String(Z.current_period_end):void 0}),q;try{q=await f.insertInto("subscriptions").values(U).executeTakeFirst()}catch(j){if(BT(j))throw new zT(409,"A subscription with this provider ID already exists");throw j}if(!q)throw Error("Failed to insert subscription record");return await f.selectFrom("subscriptions").where("id","=",Number(q.insertId)).selectAll().executeTakeFirst()}async function J(G,R,F){let Z=await f.selectFrom("subscriptions").where("id","=",G).selectAll().executeTakeFirst(),A=F.items.data[0];if(!A)throw Error("Stripe subscription contains no line items \u2014 cannot update subscription");return await f?.updateTable("subscriptions").set({type:R,provider_price_id:A.price.id,unit_price:Number(A.price.unit_amount)}).where("id","=",G).executeTakeFirst(),Z}function L(G){return Object.fromEntries(Object.entries(G).filter(([R,F])=>F!=null))}return{create:T,update:x,isValid:H,isIncomplete:B,cancel:w,retrieve:$}})();var n=(()=>{async function T(x,w){let Q={...{customer:await O.createOrGetStripeUser(x,{}).then((X)=>{if(!X||!X.id)throw Error("Customer does not exist in Stripe");return X.id}),payment_method_types:["card"]},...w};return await _.setupIntents.create(Q,{idempotencyKey:W("setup_intent.create",x.id)})}return{create:T}})();var m=new Map;function Y(T,x){let w=m.get(T)||[];w.push(x),m.set(T,w)}function GT(T){for(let[x,w]of Object.entries(T))Y(x,w)}function JT(T,x,w,$){if($!=null&&Number.isFinite($)&&$>0)return _.webhooks.constructEvent(T,x,w,$);return _.webhooks.constructEvent(T,x,w)}async function o(T,x,w,$){if($!=null&&Number.isFinite($)&&$>0)return await _.webhooks.constructEventAsync(T,x,w,$);return await _.webhooks.constructEventAsync(T,x,w)}async function r(T){let x=m.get(T.type)||[];if(x.length===0)return{handled:!1,eventType:T.type};let w=[];for(let $ of x)try{await $(T)}catch(z){w.push(z instanceof Error?z.message:String(z))}return{handled:!0,eventType:T.type,...w.length>0?{errors:w}:{}}}async function QT(T,x,w){try{let $=await o(T,x,w.secret,w.tolerance),z=await r($);if(z.errors&&z.errors.length>0)return{success:!1,eventType:z.eventType,error:z.errors.join("; ")};return{success:!0,eventType:z.eventType}}catch($){return{success:!1,error:$ instanceof Error?$.message:"Unknown error"}}}function ZT(T){if(T.succeeded)Y("payment_intent.succeeded",T.succeeded);if(T.failed)Y("payment_intent.payment_failed",T.failed);if(T.created)Y("payment_intent.created",T.created);if(T.canceled)Y("payment_intent.canceled",T.canceled)}function LT(T){if(T.created)Y("customer.subscription.created",T.created);if(T.updated)Y("customer.subscription.updated",T.updated);if(T.deleted)Y("customer.subscription.deleted",T.deleted);if(T.trialWillEnd)Y("customer.subscription.trial_will_end",T.trialWillEnd)}function AT(T){if(T.paid)Y("invoice.paid",T.paid);if(T.paymentFailed)Y("invoice.payment_failed",T.paymentFailed);if(T.created)Y("invoice.created",T.created);if(T.finalized)Y("invoice.finalized",T.finalized)}function RT(T){if(T.completed)Y("checkout.session.completed",T.completed);if(T.expired)Y("checkout.session.expired",T.expired)}function HT(T){if(T.succeeded)Y("charge.succeeded",T.succeeded);if(T.failed)Y("charge.failed",T.failed);if(T.refunded)Y("charge.refunded",T.refunded);if(T.disputed)Y("charge.dispute.created",T.disputed)}function XT(T){if(T.type.startsWith("payment_intent."))return T.data.object;return null}function YT(T){if(T.type.startsWith("customer.subscription."))return T.data.object;return null}function NT(T){if(T.type.startsWith("invoice."))return T.data.object;return null}function qT(T){if(T.type.startsWith("checkout.session."))return T.data.object;return null}function UT(T){if(T.type.startsWith("charge."))return T.data.object;return null}function DT(T){if(T.type.startsWith("customer.")&&!T.type.includes("subscription"))return T.data.object;return null}var Jx={onWebhookEvent:Y,registerWebhookHandlers:GT,constructEvent:JT,constructEventAsync:o,handleWebhookEvent:r,processWebhook:QT,onPaymentIntent:ZT,onSubscription:LT,onInvoice:AT,onCheckout:RT,onCharge:HT,getPaymentIntent:XT,getSubscription:YT,getInvoice:NT,getCheckoutSession:qT,getCharge:UT,getCustomer:DT};async function Dx(T,x,w,$={}){return C.charge(T,x,w,$)}async function Ox(T,x,w={}){return C.createPayment(T,x,w)}async function Vx(T,x,w={}){return C.refund(T,{amount:x,...w})}async function jx(T,x,w={}){return l.create(T,{line_items:x,mode:"payment",...w})}async function fx(T,x,w={}){return l.create(T,{line_items:[{price:x,quantity:1}],mode:"subscription",...w})}async function Wx(T,x,w={}){return P.create(T,"default",x,w)}async function Kx(T,x=!1){return P.cancel(T,{prorate:!x,invoice_now:x})}async function Ex(T,x="default"){return P.isValid(T,x)}async function Px(T,x,w="default"){return P.update(T,w,x,{})}async function Sx(T,x={}){return O.createOrGetStripeUser(T,x)}async function Cx(T,x){return O.updateStripeCustomer(T,x)}async function kx(T){return O.deleteStripeUser(T)}async function Mx(T,x){return k.addPaymentMethod(T,x)}async function vx(T,x){return k.setUserDefaultPayment(T,x)}async function gx(T,x){return k.deletePaymentMethod(T,x)}async function bx(T,x={}){return n.create(T,x)}async function Ix(T){return p.list(T)}async function yx(T,x={}){return _.invoices.create({customer:T,...x})}async function lx(T){return _.invoices.pay(T)}async function hx(T,x,w={}){let{currency:$="usd",interval:z,description:Q,metadata:X}=w,B={unit_amount:x,currency:$};if(z)B.recurring={interval:z};return c.createWithPrice({name:T,description:Q,metadata:X},B)}async function cx(T){return E.retrieveByLookupKey(T)}async function mx(T={}){return c.list(T)}async function ux(T){let x={duration:T.duration||"once"};if(T.percentOff)x.percent_off=T.percentOff;else if(T.amountOff)x.amount_off=T.amountOff,x.currency=T.currency||"usd";if(T.name)x.name=T.name;if(T.durationInMonths)x.duration_in_months=T.durationInMonths;if(T.maxRedemptions)x.max_redemptions=T.maxRedemptions;return M.create(x)}async function dx(T,x,w={}){return M.createPromotionCode({promotion:{type:"coupon",coupon:T},code:x,...w})}async function ix(T){return M.retrievePromotionCode(T)}function ax(T,x){let w=globalThis.config||{},$=(x||w.payment?.currency||w.billing?.currency||process.env.STRIPE_CURRENCY||"usd").toLowerCase(),z=w.app?.locale||"en-US";return new Intl.NumberFormat(z,{style:"currency",currency:$.toUpperCase()}).format(T/100)}function px(T){return Math.round(T*100)}function nx(T){return T/100}import{saas as OT}from"@stacksjs/config";import{err as VT,ok as jT}from"@stacksjs/error-handling";import{log as fT}from"@stacksjs/logging";import{stripe as s}from"@stacksjs/payments";async function Tw(){let T=OT.plans;try{if(T!==void 0&&T.length)for(let x of T){let w=await s.products.create({name:x.productName,description:x.description,metadata:x.metadata});for(let $ of x.pricing)if(w){let z={unit_amount:$.price,currency:$.currency,product:w.id,lookup_key:$.key};if($.interval)z.recurring={interval:$.interval};await s.prices.create(z)}}return jT("Migrations generated")}catch(x){let w=x instanceof Error?x:Error(String(x));return fT.error(w),VT(w)}}import{db as v}from"@stacksjs/database";var _w=(()=>{async function T(w,$,z){let Q=await v.selectFrom("payment_products").where("id","=",$).selectAll().executeTakeFirst();if(!Q)throw Error(`Payment product with id ${$} not found.`);let X={name:Q.name,description:z.description??"",amount:Q.unit_price,brand:z.brand,type:z.type??"one-time",provider_id:z.provider_id,user_id:w.id},B=await v.insertInto("payment_transactions").values(X).executeTakeFirst();if(!B)throw Error("Failed to insert payment transaction");return await v.selectFrom("payment_transactions").where("id","=",Number(B.insertId)).selectAll().executeTakeFirst()}async function x(w){return await v.selectFrom("payment_transactions").where("user_id","=",w.id).selectAll().execute()}return{store:T,list:x}})();export{ix as validatePromoCode,Cx as updateCustomer,nx as toDollars,px as toCents,fx as subscriptionCheckout,Wx as subscribe,_ as stripe,Aw as stacksIdempotencyKey,vx as setDefaultPaymentMethod,gx as removePaymentMethod,GT as registerWebhookHandlers,Vx as refund,QT as processWebhook,lx as payInvoice,Y as onWebhookEvent,LT as onSubscription,ZT as onPaymentIntent,AT as onInvoice,RT as onCheckout,HT as onCharge,Jx as manageWebhook,_w as manageTransaction,P as manageSubscription,n as manageSetupIntent,c as manageProduct,$T as managePriceExtended,E as managePrice,k as managePaymentMethod,p as manageInvoice,O as manageCustomer,M as manageCoupon,l as manageCheckout,C as manageCharge,mx as listProducts,Ex as hasActiveSubscription,r as handleWebhookEvent,YT as getSubscription,cx as getPrice,XT as getPaymentIntent,Sx as getOrCreateCustomer,Ix as getInvoices,NT as getInvoice,DT as getCustomer,qT as getCheckoutSession,UT as getCharge,Lw as freshIdempotencyKey,ax as formatAmount,kx as deleteCustomer,Tw as createStripeProduct,bx as createSetupIntent,dx as createPromoCode,hx as createProduct,Ox as createPayment,yx as createInvoice,ux as createCoupon,o as constructEventAsync,JT as constructEvent,jx as checkout,Dx as charge,Px as changeSubscription,Kx as cancelSubscription,Mx as addPaymentMethod,Gw as Payment};

package/dist/payment.d.ts

@@ -1,182 +0,0 @@
-import type { UserModel } from '@stacksjs/orm';
-import type Stripe from 'stripe';
-/**
- * Create a one-time charge
- */
-export declare function charge(user: UserModel, amount: number, paymentMethod: string, options?: Partial<Stripe.PaymentIntentCreateParams>): Promise<Stripe.PaymentIntent>;
-/**
- * Create a payment intent (for client-side confirmation)
- */
-export declare function createPayment(user: UserModel, amount: number, options?: Partial<Stripe.PaymentIntentCreateParams>): Promise<Stripe.PaymentIntent>;
-/**
- * Refund a payment
- */
-export declare function refund(paymentIntentId: string, amount?: number, options?: Partial<Stripe.RefundCreateParams>): Promise<Stripe.Refund>;
-/**
- * Create a Stripe Checkout session
- */
-export declare function checkout(user: UserModel, lineItems: Stripe.Checkout.SessionCreateParams.LineItem[], options?: Partial<Stripe.Checkout.SessionCreateParams>): Promise<Stripe.Checkout.Session>;
-/**
- * Create a subscription checkout session
- */
-export declare function subscriptionCheckout(user: UserModel, priceId: string, options?: Partial<Stripe.Checkout.SessionCreateParams>): Promise<Stripe.Checkout.Session>;
-/**
- * Create a new subscription
- */
-export declare function subscribe(user: UserModel, lookupKey: string, options?: Partial<Stripe.SubscriptionCreateParams>): Promise<Stripe.Subscription>;
-/**
- * Cancel a subscription
- */
-export declare function cancelSubscription(subscriptionId: string, immediately?: boolean): Promise<Stripe.Subscription>;
-/**
- * Check if user has an active subscription
- */
-export declare function hasActiveSubscription(user: UserModel, type?: string): Promise<boolean>;
-/**
- * Update subscription to a new price
- */
-export declare function changeSubscription(user: UserModel, newLookupKey: string, type?: string): Promise<Stripe.Subscription>;
-/**
- * Get or create a Stripe customer for a user
- */
-export declare function getOrCreateCustomer(user: UserModel, options?: Stripe.CustomerCreateParams): Promise<Stripe.Customer>;
-/**
- * Update customer details
- */
-export declare function updateCustomer(user: UserModel, options: Stripe.CustomerCreateParams): Promise<Stripe.Customer>;
-/**
- * Delete a customer from Stripe
- */
-export declare function deleteCustomer(user: UserModel): Promise<Stripe.DeletedCustomer>;
-/**
- * Add a payment method to a customer
- */
-export declare function addPaymentMethod(user: UserModel, paymentMethodId: string): Promise<Stripe.PaymentMethod>;
-/**
- * Set the default payment method
- */
-export declare function setDefaultPaymentMethod(user: UserModel, paymentMethodId: string): Promise<Stripe.Customer>;
-/**
- * Remove a payment method.
- * Accepts either a numeric database ID or a Stripe payment method ID string (pm_xxx).
- */
-export declare function removePaymentMethod(user: UserModel, paymentMethodId: string | number): Promise<Stripe.PaymentMethod>;
-/**
- * Create a setup intent for adding payment methods
- */
-export declare function createSetupIntent(user: UserModel, options?: Partial<Stripe.SetupIntentCreateParams>): Promise<Stripe.SetupIntent>;
-/**
- * Get user's invoices
- */
-export declare function getInvoices(user: UserModel): Promise<Stripe.ApiList<Stripe.Invoice>>;
-/**
- * Create an invoice
- */
-export declare function createInvoice(customerId: string, options?: Partial<Stripe.InvoiceCreateParams>): Promise<Stripe.Invoice>;
-/**
- * Pay an invoice
- */
-export declare function payInvoice(invoiceId: string): Promise<Stripe.Invoice>;
-/**
- * Create a product with a price
- */
-export declare function createProduct(name: string, price: number, options?: {
-    currency?: string
-    interval?: 'day' | 'week' | 'month' | 'year'
-    description?: string
-    metadata?: Stripe.MetadataParam
-  }): Promise<{ product: Stripe.Product, price: Stripe.Price }>;
-/**
- * Get a price by lookup key
- */
-export declare function getPrice(lookupKey: string): Promise<Stripe.Price | undefined>;
-/**
- * List all products
- */
-export declare function listProducts(options?: Stripe.ProductListParams): Promise<Stripe.ApiList<Stripe.Product>>;
-/**
- * Create a discount coupon
- */
-export declare function createCoupon(options: {
-    percentOff?: number
-    amountOff?: number
-    currency?: string
-    duration?: 'forever' | 'once' | 'repeating'
-    durationInMonths?: number
-    name?: string
-    maxRedemptions?: number
-  }): Promise<Stripe.Coupon>;
-/**
- * Create a promotion code from a coupon
- */
-export declare function createPromoCode(couponId: string, code: string, options?: Partial<Stripe.PromotionCodeCreateParams>): Promise<Stripe.PromotionCode>;
-/**
- * Validate a promo code
- */
-export declare function validatePromoCode(code: string): Promise<Stripe.PromotionCode | null>;
-/**
- * Format amount for display.
- *
- * Currency defaults to the project's configured payment currency
- * (`config.payment.currency` / `STRIPE_CURRENCY`), falling back to USD only
- * when nothing else is set. Locale follows the same pattern via
- * `config.app.locale` so EU merchants see €1.234,56 not $1,234.56.
- */
-export declare function formatAmount(amount: number, currency?: string): string;
-/**
- * Convert dollars to cents
- */
-export declare function toCents(dollars: number): number;
-/**
- * Convert cents to dollars
- */
-export declare function toDollars(cents: number): number;
-// =============================================================================
-// Payment Facade Object
-// =============================================================================
-export declare const Payment: {
-  charge: typeof charge;
-  createPayment: typeof createPayment;
-  refund: typeof refund;
-  checkout: typeof checkout;
-  subscriptionCheckout: typeof subscriptionCheckout;
-  subscribe: typeof subscribe;
-  cancelSubscription: typeof cancelSubscription;
-  hasActiveSubscription: typeof hasActiveSubscription;
-  changeSubscription: typeof changeSubscription;
-  getOrCreateCustomer: typeof getOrCreateCustomer;
-  updateCustomer: typeof updateCustomer;
-  deleteCustomer: typeof deleteCustomer;
-  addPaymentMethod: typeof addPaymentMethod;
-  setDefaultPaymentMethod: typeof setDefaultPaymentMethod;
-  removePaymentMethod: typeof removePaymentMethod;
-  createSetupIntent: typeof createSetupIntent;
-  getInvoices: typeof getInvoices;
-  createInvoice: typeof createInvoice;
-  payInvoice: typeof payInvoice;
-  createProduct: typeof createProduct;
-  getPrice: typeof getPrice;
-  listProducts: typeof listProducts;
-  createCoupon: typeof createCoupon;
-  createPromoCode: typeof createPromoCode;
-  validatePromoCode: typeof validatePromoCode;
-  formatAmount: typeof formatAmount;
-  toCents: typeof toCents;
-  toDollars: typeof toDollars;
-  webhook: unknown;
-  onPaymentIntent: typeof onPaymentIntent;
-  onSubscription: typeof onSubscription;
-  onInvoice: typeof onInvoice;
-  onCheckout: typeof onCheckout;
-  onCharge: typeof onCharge;
-  processWebhook: typeof processWebhook;
-  stripe: typeof stripe;
-  customer: unknown;
-  subscription: unknown;
-  invoice: unknown;
-  paymentMethod: unknown;
-  product: unknown;
-  price: unknown;
-  coupon: unknown
-};
-export default Payment;