@parsrun/payments 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,388 @@
+export { CardDetails, CreatePaymentIntentRequest, CreateRefundRequest, IyzicoConfig, Money, PaddleConfig, CreateCustomerRequest as ParsCreateCustomerRequest, CreateSubscriptionRequest as ParsCreateSubscriptionRequest, CurrencyCode as ParsCurrencyCode, PaymentIntent as ParsPaymentIntentType, PaymentMethod as ParsPaymentMethod, Price as ParsPrice, Subscription as ParsSubscription, SubscriptionStatus as ParsSubscriptionStatus, WebhookEvent as ParsWebhookEvent, WebhookEventType as ParsWebhookEventType, PaymentCustomer, PaymentIntentStatus, PaymentsConfig, PriceInterval, Refund, RefundStatus, StripeConfig, cardDetails, createCustomerRequest, createPaymentIntentRequest, createRefundRequest, createSubscriptionRequest, currencyCode, iyzicoConfig, money, paddleConfig, paymentIntent as parsPaymentIntent, price as parsPrice, subscription as parsSubscription, subscriptionStatus as parsSubscriptionStatus, paymentCustomer, paymentIntentStatus, paymentMethod, paymentsConfig, priceInterval, refund, refundStatus, stripeConfig, type, webhookEvent, webhookEventType } from '@parsrun/types';
+
+/**
+ * @parsrun/payments - Type Definitions
+ * Payment types and interfaces
+ */
+
+/**
+ * Payment provider type
+ */
+type PaymentProviderType = "stripe" | "paddle" | "iyzico";
+/**
+ * Currency code (ISO 4217)
+ */
+type CurrencyCode = "USD" | "EUR" | "GBP" | "TRY" | "JPY" | "CAD" | "AUD" | string;
+/**
+ * Payment status
+ */
+type PaymentStatus = "pending" | "processing" | "succeeded" | "failed" | "canceled" | "refunded" | "partially_refunded";
+/**
+ * Subscription status
+ */
+type SubscriptionStatus = "active" | "past_due" | "unpaid" | "canceled" | "incomplete" | "incomplete_expired" | "trialing" | "paused";
+/**
+ * Billing interval
+ */
+type BillingInterval = "day" | "week" | "month" | "year";
+/**
+ * Customer data
+ */
+interface Customer {
+    /** Provider customer ID */
+    id: string;
+    /** Customer email */
+    email: string;
+    /** Customer name */
+    name?: string | undefined;
+    /** Phone number */
+    phone?: string | undefined;
+    /** Billing address */
+    address?: Address | undefined;
+    /** Custom metadata */
+    metadata?: Record<string, string> | undefined;
+    /** Provider-specific data */
+    providerData?: unknown;
+}
+/**
+ * Address
+ */
+interface Address {
+    line1?: string | undefined;
+    line2?: string | undefined;
+    city?: string | undefined;
+    state?: string | undefined;
+    postalCode?: string | undefined;
+    country?: string | undefined;
+}
+/**
+ * Create customer options
+ */
+interface CreateCustomerOptions {
+    email: string;
+    name?: string | undefined;
+    phone?: string | undefined;
+    address?: Address | undefined;
+    metadata?: Record<string, string> | undefined;
+}
+/**
+ * Product
+ */
+interface Product {
+    /** Provider product ID */
+    id: string;
+    /** Product name */
+    name: string;
+    /** Description */
+    description?: string | undefined;
+    /** Active status */
+    active: boolean;
+    /** Custom metadata */
+    metadata?: Record<string, string> | undefined;
+    /** Provider-specific data */
+    providerData?: unknown;
+}
+/**
+ * Price
+ */
+interface Price {
+    /** Provider price ID */
+    id: string;
+    /** Product ID */
+    productId: string;
+    /** Price in smallest currency unit (cents) */
+    unitAmount: number;
+    /** Currency */
+    currency: CurrencyCode;
+    /** Recurring billing details */
+    recurring?: {
+        interval: BillingInterval;
+        intervalCount: number;
+    } | undefined;
+    /** Active status */
+    active: boolean;
+    /** Custom metadata */
+    metadata?: Record<string, string> | undefined;
+    /** Provider-specific data */
+    providerData?: unknown;
+}
+/**
+ * Checkout line item
+ */
+interface CheckoutLineItem {
+    /** Price ID */
+    priceId: string;
+    /** Quantity */
+    quantity: number;
+}
+/**
+ * Create checkout options
+ */
+interface CreateCheckoutOptions {
+    /** Customer ID (optional, creates new if not provided) */
+    customerId?: string | undefined;
+    /** Customer email (for new customers) */
+    customerEmail?: string | undefined;
+    /** Line items */
+    lineItems: CheckoutLineItem[];
+    /** Success redirect URL */
+    successUrl: string;
+    /** Cancel redirect URL */
+    cancelUrl: string;
+    /** Checkout mode */
+    mode: "payment" | "subscription" | "setup";
+    /** Allow promotion codes */
+    allowPromotionCodes?: boolean | undefined;
+    /** Trial period days (subscription only) */
+    trialDays?: number | undefined;
+    /** Custom metadata */
+    metadata?: Record<string, string> | undefined;
+    /** Tenant ID for multi-tenant */
+    tenantId?: string | undefined;
+}
+/**
+ * Checkout session
+ */
+interface CheckoutSession {
+    /** Provider session ID */
+    id: string;
+    /** Checkout URL */
+    url: string;
+    /** Customer ID */
+    customerId?: string | undefined;
+    /** Payment status */
+    status: "open" | "complete" | "expired";
+    /** Mode */
+    mode: "payment" | "subscription" | "setup";
+    /** Amount total */
+    amountTotal?: number | undefined;
+    /** Currency */
+    currency?: CurrencyCode | undefined;
+    /** Provider-specific data */
+    providerData?: unknown;
+}
+/**
+ * Subscription
+ */
+interface Subscription {
+    /** Provider subscription ID */
+    id: string;
+    /** Customer ID */
+    customerId: string;
+    /** Status */
+    status: SubscriptionStatus;
+    /** Price ID */
+    priceId: string;
+    /** Product ID */
+    productId?: string | undefined;
+    /** Current period start */
+    currentPeriodStart: Date;
+    /** Current period end */
+    currentPeriodEnd: Date;
+    /** Cancel at period end */
+    cancelAtPeriodEnd: boolean;
+    /** Canceled at */
+    canceledAt?: Date | undefined;
+    /** Trial start */
+    trialStart?: Date | undefined;
+    /** Trial end */
+    trialEnd?: Date | undefined;
+    /** Custom metadata */
+    metadata?: Record<string, string> | undefined;
+    /** Provider-specific data */
+    providerData?: unknown;
+}
+/**
+ * Create subscription options
+ */
+interface CreateSubscriptionOptions {
+    /** Customer ID */
+    customerId: string;
+    /** Price ID */
+    priceId: string;
+    /** Trial period days */
+    trialDays?: number | undefined;
+    /** Custom metadata */
+    metadata?: Record<string, string> | undefined;
+    /** Payment behavior */
+    paymentBehavior?: "default_incomplete" | "error_if_incomplete" | "allow_incomplete" | undefined;
+}
+/**
+ * Update subscription options
+ */
+interface UpdateSubscriptionOptions {
+    /** New price ID */
+    priceId?: string | undefined;
+    /** Cancel at period end */
+    cancelAtPeriodEnd?: boolean | undefined;
+    /** Custom metadata */
+    metadata?: Record<string, string> | undefined;
+    /** Proration behavior */
+    prorationBehavior?: "create_prorations" | "none" | "always_invoice" | undefined;
+}
+/**
+ * Payment intent
+ */
+interface PaymentIntent {
+    /** Provider payment ID */
+    id: string;
+    /** Amount */
+    amount: number;
+    /** Currency */
+    currency: CurrencyCode;
+    /** Status */
+    status: PaymentStatus;
+    /** Customer ID */
+    customerId?: string | undefined;
+    /** Provider-specific data */
+    providerData?: unknown;
+}
+/**
+ * Invoice
+ */
+interface Invoice {
+    /** Provider invoice ID */
+    id: string;
+    /** Customer ID */
+    customerId: string;
+    /** Subscription ID */
+    subscriptionId?: string | undefined;
+    /** Status */
+    status: "draft" | "open" | "paid" | "void" | "uncollectible";
+    /** Amount due */
+    amountDue: number;
+    /** Amount paid */
+    amountPaid: number;
+    /** Currency */
+    currency: CurrencyCode;
+    /** Invoice URL */
+    hostedInvoiceUrl?: string | undefined;
+    /** PDF URL */
+    invoicePdf?: string | undefined;
+    /** Due date */
+    dueDate?: Date | undefined;
+    /** Provider-specific data */
+    providerData?: unknown;
+}
+/**
+ * Customer portal session
+ */
+interface PortalSession {
+    /** Portal URL */
+    url: string;
+    /** Return URL */
+    returnUrl: string;
+}
+/**
+ * Create portal options
+ */
+interface CreatePortalOptions {
+    /** Customer ID */
+    customerId: string;
+    /** Return URL */
+    returnUrl: string;
+}
+/**
+ * Webhook event types
+ */
+type WebhookEventType = "checkout.session.completed" | "checkout.session.expired" | "customer.created" | "customer.updated" | "customer.deleted" | "subscription.created" | "subscription.updated" | "subscription.deleted" | "subscription.trial_will_end" | "payment.succeeded" | "payment.failed" | "invoice.created" | "invoice.paid" | "invoice.payment_failed" | "invoice.upcoming" | "refund.created" | "refund.updated";
+/**
+ * Webhook event
+ */
+interface WebhookEvent<T = unknown> {
+    /** Event ID */
+    id: string;
+    /** Event type */
+    type: WebhookEventType;
+    /** Event data */
+    data: T;
+    /** Created timestamp */
+    created: Date;
+    /** Provider type */
+    provider: PaymentProviderType;
+    /** Raw event data */
+    raw: unknown;
+}
+/**
+ * Webhook handler
+ */
+type WebhookHandler<T = unknown> = (event: WebhookEvent<T>) => void | Promise<void>;
+/**
+ * Payment provider interface
+ */
+interface PaymentProvider {
+    /** Provider type */
+    readonly type: PaymentProviderType;
+    createCustomer(options: CreateCustomerOptions): Promise<Customer>;
+    getCustomer(customerId: string): Promise<Customer | null>;
+    updateCustomer(customerId: string, options: Partial<CreateCustomerOptions>): Promise<Customer>;
+    deleteCustomer(customerId: string): Promise<void>;
+    createCheckout(options: CreateCheckoutOptions): Promise<CheckoutSession>;
+    getCheckout(sessionId: string): Promise<CheckoutSession | null>;
+    createSubscription(options: CreateSubscriptionOptions): Promise<Subscription>;
+    getSubscription(subscriptionId: string): Promise<Subscription | null>;
+    updateSubscription(subscriptionId: string, options: UpdateSubscriptionOptions): Promise<Subscription>;
+    cancelSubscription(subscriptionId: string, cancelAtPeriodEnd?: boolean): Promise<Subscription>;
+    listSubscriptions(customerId: string): Promise<Subscription[]>;
+    createPortalSession(options: CreatePortalOptions): Promise<PortalSession>;
+    verifyWebhook(payload: string | Uint8Array, signature: string): Promise<WebhookEvent | null>;
+    getProduct?(productId: string): Promise<Product | null>;
+    getPrice?(priceId: string): Promise<Price | null>;
+    listPrices?(productId?: string): Promise<Price[]>;
+}
+/**
+ * Stripe provider config
+ */
+interface StripeProviderConfig {
+    /** Stripe secret key */
+    secretKey: string;
+    /** Webhook signing secret */
+    webhookSecret?: string | undefined;
+    /** API version */
+    apiVersion?: string | undefined;
+}
+/**
+ * Paddle provider config
+ */
+interface PaddleProviderConfig {
+    /** Paddle API key */
+    apiKey: string;
+    /** Paddle environment */
+    environment?: "sandbox" | "production" | undefined;
+    /** Webhook secret key */
+    webhookSecret?: string | undefined;
+    /** Seller ID */
+    sellerId?: string | undefined;
+}
+/**
+ * Payment service config
+ */
+interface PaymentServiceConfig {
+    /** Payment provider */
+    provider: PaymentProvider;
+    /** Enable debug logging */
+    debug?: boolean | undefined;
+}
+/**
+ * Payment error
+ */
+declare class PaymentError extends Error {
+    readonly code: string;
+    readonly cause?: unknown | undefined;
+    constructor(message: string, code: string, cause?: unknown | undefined);
+}
+/**
+ * Common payment error codes
+ */
+declare const PaymentErrorCodes: {
+    readonly INVALID_CONFIG: "INVALID_CONFIG";
+    readonly CUSTOMER_NOT_FOUND: "CUSTOMER_NOT_FOUND";
+    readonly SUBSCRIPTION_NOT_FOUND: "SUBSCRIPTION_NOT_FOUND";
+    readonly CHECKOUT_FAILED: "CHECKOUT_FAILED";
+    readonly PAYMENT_FAILED: "PAYMENT_FAILED";
+    readonly WEBHOOK_VERIFICATION_FAILED: "WEBHOOK_VERIFICATION_FAILED";
+    readonly API_ERROR: "API_ERROR";
+    readonly RATE_LIMITED: "RATE_LIMITED";
+};
+
+export { type Address, type BillingInterval, type CheckoutLineItem, type CheckoutSession, type CreateCheckoutOptions, type CreateCustomerOptions, type CreatePortalOptions, type CreateSubscriptionOptions, type CurrencyCode, type Customer, type Invoice, type PaddleProviderConfig, PaymentError, PaymentErrorCodes, type PaymentIntent, type PaymentProvider, type PaymentProviderType, type PaymentServiceConfig, type PaymentStatus, type PortalSession, type Price, type Product, type StripeProviderConfig, type Subscription, type SubscriptionStatus, type UpdateSubscriptionOptions, type WebhookEvent, type WebhookEventType, type WebhookHandler };

package/dist/types.js

@@ -0,0 +1,74 @@
+// src/types.ts
+import {
+  type,
+  currencyCode,
+  money,
+  paymentCustomer,
+  createCustomerRequest,
+  cardDetails,
+  paymentMethod,
+  paymentIntentStatus,
+  paymentIntent,
+  createPaymentIntentRequest,
+  subscriptionStatus,
+  priceInterval,
+  price,
+  subscription,
+  createSubscriptionRequest,
+  refundStatus,
+  refund,
+  createRefundRequest,
+  webhookEventType,
+  webhookEvent,
+  stripeConfig,
+  paddleConfig,
+  iyzicoConfig,
+  paymentsConfig
+} from "@parsrun/types";
+var PaymentError = class extends Error {
+  constructor(message, code, cause) {
+    super(message);
+    this.code = code;
+    this.cause = cause;
+    this.name = "PaymentError";
+  }
+};
+var PaymentErrorCodes = {
+  INVALID_CONFIG: "INVALID_CONFIG",
+  CUSTOMER_NOT_FOUND: "CUSTOMER_NOT_FOUND",
+  SUBSCRIPTION_NOT_FOUND: "SUBSCRIPTION_NOT_FOUND",
+  CHECKOUT_FAILED: "CHECKOUT_FAILED",
+  PAYMENT_FAILED: "PAYMENT_FAILED",
+  WEBHOOK_VERIFICATION_FAILED: "WEBHOOK_VERIFICATION_FAILED",
+  API_ERROR: "API_ERROR",
+  RATE_LIMITED: "RATE_LIMITED"
+};
+export {
+  PaymentError,
+  PaymentErrorCodes,
+  cardDetails,
+  createCustomerRequest,
+  createPaymentIntentRequest,
+  createRefundRequest,
+  createSubscriptionRequest,
+  currencyCode,
+  iyzicoConfig,
+  money,
+  paddleConfig,
+  paymentIntent as parsPaymentIntent,
+  price as parsPrice,
+  subscription as parsSubscription,
+  subscriptionStatus as parsSubscriptionStatus,
+  paymentCustomer,
+  paymentIntentStatus,
+  paymentMethod,
+  paymentsConfig,
+  priceInterval,
+  refund,
+  refundStatus,
+  stripeConfig,
+  type,
+  webhookEvent,
+  webhookEventType
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["/**\n * @parsrun/payments - Type Definitions\n * Payment types and interfaces\n */\n\n// Re-export types from @parsrun/types for convenience\nexport {\n  type,\n  currencyCode,\n  money,\n  paymentCustomer,\n  createCustomerRequest,\n  cardDetails,\n  paymentMethod,\n  paymentIntentStatus,\n  paymentIntent as parsPaymentIntent,\n  createPaymentIntentRequest,\n  subscriptionStatus as parsSubscriptionStatus,\n  priceInterval,\n  price as parsPrice,\n  subscription as parsSubscription,\n  createSubscriptionRequest,\n  refundStatus,\n  refund,\n  createRefundRequest,\n  webhookEventType,\n  webhookEvent,\n  stripeConfig,\n  paddleConfig,\n  iyzicoConfig,\n  paymentsConfig,\n  type CurrencyCode as ParsCurrencyCode,\n  type Money,\n  type PaymentCustomer,\n  type CreateCustomerRequest as ParsCreateCustomerRequest,\n  type CardDetails,\n  type PaymentMethod as ParsPaymentMethod,\n  type PaymentIntentStatus,\n  type PaymentIntent as ParsPaymentIntentType,\n  type CreatePaymentIntentRequest,\n  type SubscriptionStatus as ParsSubscriptionStatus,\n  type PriceInterval,\n  type Price as ParsPrice,\n  type Subscription as ParsSubscription,\n  type CreateSubscriptionRequest as ParsCreateSubscriptionRequest,\n  type RefundStatus,\n  type Refund,\n  type CreateRefundRequest,\n  type WebhookEventType as ParsWebhookEventType,\n  type WebhookEvent as ParsWebhookEvent,\n  type StripeConfig,\n  type PaddleConfig,\n  type IyzicoConfig,\n  type PaymentsConfig,\n} from \"@parsrun/types\";\n\n/**\n * Payment provider type\n */\nexport type PaymentProviderType = \"stripe\" | \"paddle\" | \"iyzico\";\n\n/**\n * Currency code (ISO 4217)\n */\nexport type CurrencyCode = \"USD\" | \"EUR\" | \"GBP\" | \"TRY\" | \"JPY\" | \"CAD\" | \"AUD\" | string;\n\n/**\n * Payment status\n */\nexport type PaymentStatus =\n  | \"pending\"\n  | \"processing\"\n  | \"succeeded\"\n  | \"failed\"\n  | \"canceled\"\n  | \"refunded\"\n  | \"partially_refunded\";\n\n/**\n * Subscription status\n */\nexport type SubscriptionStatus =\n  | \"active\"\n  | \"past_due\"\n  | \"unpaid\"\n  | \"canceled\"\n  | \"incomplete\"\n  | \"incomplete_expired\"\n  | \"trialing\"\n  | \"paused\";\n\n/**\n * Billing interval\n */\nexport type BillingInterval = \"day\" | \"week\" | \"month\" | \"year\";\n\n// ============================================================================\n// Customer\n// ============================================================================\n\n/**\n * Customer data\n */\nexport interface Customer {\n  /** Provider customer ID */\n  id: string;\n  /** Customer email */\n  email: string;\n  /** Customer name */\n  name?: string | undefined;\n  /** Phone number */\n  phone?: string | undefined;\n  /** Billing address */\n  address?: Address | undefined;\n  /** Custom metadata */\n  metadata?: Record<string, string> | undefined;\n  /** Provider-specific data */\n  providerData?: unknown;\n}\n\n/**\n * Address\n */\nexport interface Address {\n  line1?: string | undefined;\n  line2?: string | undefined;\n  city?: string | undefined;\n  state?: string | undefined;\n  postalCode?: string | undefined;\n  country?: string | undefined;\n}\n\n/**\n * Create customer options\n */\nexport interface CreateCustomerOptions {\n  email: string;\n  name?: string | undefined;\n  phone?: string | undefined;\n  address?: Address | undefined;\n  metadata?: Record<string, string> | undefined;\n}\n\n// ============================================================================\n// Products & Prices\n// ============================================================================\n\n/**\n * Product\n */\nexport interface Product {\n  /** Provider product ID */\n  id: string;\n  /** Product name */\n  name: string;\n  /** Description */\n  description?: string | undefined;\n  /** Active status */\n  active: boolean;\n  /** Custom metadata */\n  metadata?: Record<string, string> | undefined;\n  /** Provider-specific data */\n  providerData?: unknown;\n}\n\n/**\n * Price\n */\nexport interface Price {\n  /** Provider price ID */\n  id: string;\n  /** Product ID */\n  productId: string;\n  /** Price in smallest currency unit (cents) */\n  unitAmount: number;\n  /** Currency */\n  currency: CurrencyCode;\n  /** Recurring billing details */\n  recurring?: {\n    interval: BillingInterval;\n    intervalCount: number;\n  } | undefined;\n  /** Active status */\n  active: boolean;\n  /** Custom metadata */\n  metadata?: Record<string, string> | undefined;\n  /** Provider-specific data */\n  providerData?: unknown;\n}\n\n// ============================================================================\n// Checkout\n// ============================================================================\n\n/**\n * Checkout line item\n */\nexport interface CheckoutLineItem {\n  /** Price ID */\n  priceId: string;\n  /** Quantity */\n  quantity: number;\n}\n\n/**\n * Create checkout options\n */\nexport interface CreateCheckoutOptions {\n  /** Customer ID (optional, creates new if not provided) */\n  customerId?: string | undefined;\n  /** Customer email (for new customers) */\n  customerEmail?: string | undefined;\n  /** Line items */\n  lineItems: CheckoutLineItem[];\n  /** Success redirect URL */\n  successUrl: string;\n  /** Cancel redirect URL */\n  cancelUrl: string;\n  /** Checkout mode */\n  mode: \"payment\" | \"subscription\" | \"setup\";\n  /** Allow promotion codes */\n  allowPromotionCodes?: boolean | undefined;\n  /** Trial period days (subscription only) */\n  trialDays?: number | undefined;\n  /** Custom metadata */\n  metadata?: Record<string, string> | undefined;\n  /** Tenant ID for multi-tenant */\n  tenantId?: string | undefined;\n}\n\n/**\n * Checkout session\n */\nexport interface CheckoutSession {\n  /** Provider session ID */\n  id: string;\n  /** Checkout URL */\n  url: string;\n  /** Customer ID */\n  customerId?: string | undefined;\n  /** Payment status */\n  status: \"open\" | \"complete\" | \"expired\";\n  /** Mode */\n  mode: \"payment\" | \"subscription\" | \"setup\";\n  /** Amount total */\n  amountTotal?: number | undefined;\n  /** Currency */\n  currency?: CurrencyCode | undefined;\n  /** Provider-specific data */\n  providerData?: unknown;\n}\n\n// ============================================================================\n// Subscriptions\n// ============================================================================\n\n/**\n * Subscription\n */\nexport interface Subscription {\n  /** Provider subscription ID */\n  id: string;\n  /** Customer ID */\n  customerId: string;\n  /** Status */\n  status: SubscriptionStatus;\n  /** Price ID */\n  priceId: string;\n  /** Product ID */\n  productId?: string | undefined;\n  /** Current period start */\n  currentPeriodStart: Date;\n  /** Current period end */\n  currentPeriodEnd: Date;\n  /** Cancel at period end */\n  cancelAtPeriodEnd: boolean;\n  /** Canceled at */\n  canceledAt?: Date | undefined;\n  /** Trial start */\n  trialStart?: Date | undefined;\n  /** Trial end */\n  trialEnd?: Date | undefined;\n  /** Custom metadata */\n  metadata?: Record<string, string> | undefined;\n  /** Provider-specific data */\n  providerData?: unknown;\n}\n\n/**\n * Create subscription options\n */\nexport interface CreateSubscriptionOptions {\n  /** Customer ID */\n  customerId: string;\n  /** Price ID */\n  priceId: string;\n  /** Trial period days */\n  trialDays?: number | undefined;\n  /** Custom metadata */\n  metadata?: Record<string, string> | undefined;\n  /** Payment behavior */\n  paymentBehavior?: \"default_incomplete\" | \"error_if_incomplete\" | \"allow_incomplete\" | undefined;\n}\n\n/**\n * Update subscription options\n */\nexport interface UpdateSubscriptionOptions {\n  /** New price ID */\n  priceId?: string | undefined;\n  /** Cancel at period end */\n  cancelAtPeriodEnd?: boolean | undefined;\n  /** Custom metadata */\n  metadata?: Record<string, string> | undefined;\n  /** Proration behavior */\n  prorationBehavior?: \"create_prorations\" | \"none\" | \"always_invoice\" | undefined;\n}\n\n// ============================================================================\n// Payments & Invoices\n// ============================================================================\n\n/**\n * Payment intent\n */\nexport interface PaymentIntent {\n  /** Provider payment ID */\n  id: string;\n  /** Amount */\n  amount: number;\n  /** Currency */\n  currency: CurrencyCode;\n  /** Status */\n  status: PaymentStatus;\n  /** Customer ID */\n  customerId?: string | undefined;\n  /** Provider-specific data */\n  providerData?: unknown;\n}\n\n/**\n * Invoice\n */\nexport interface Invoice {\n  /** Provider invoice ID */\n  id: string;\n  /** Customer ID */\n  customerId: string;\n  /** Subscription ID */\n  subscriptionId?: string | undefined;\n  /** Status */\n  status: \"draft\" | \"open\" | \"paid\" | \"void\" | \"uncollectible\";\n  /** Amount due */\n  amountDue: number;\n  /** Amount paid */\n  amountPaid: number;\n  /** Currency */\n  currency: CurrencyCode;\n  /** Invoice URL */\n  hostedInvoiceUrl?: string | undefined;\n  /** PDF URL */\n  invoicePdf?: string | undefined;\n  /** Due date */\n  dueDate?: Date | undefined;\n  /** Provider-specific data */\n  providerData?: unknown;\n}\n\n// ============================================================================\n// Portal\n// ============================================================================\n\n/**\n * Customer portal session\n */\nexport interface PortalSession {\n  /** Portal URL */\n  url: string;\n  /** Return URL */\n  returnUrl: string;\n}\n\n/**\n * Create portal options\n */\nexport interface CreatePortalOptions {\n  /** Customer ID */\n  customerId: string;\n  /** Return URL */\n  returnUrl: string;\n}\n\n// ============================================================================\n// Webhooks\n// ============================================================================\n\n/**\n * Webhook event types\n */\nexport type WebhookEventType =\n  // Checkout\n  | \"checkout.session.completed\"\n  | \"checkout.session.expired\"\n  // Customer\n  | \"customer.created\"\n  | \"customer.updated\"\n  | \"customer.deleted\"\n  // Subscription\n  | \"subscription.created\"\n  | \"subscription.updated\"\n  | \"subscription.deleted\"\n  | \"subscription.trial_will_end\"\n  // Payment\n  | \"payment.succeeded\"\n  | \"payment.failed\"\n  // Invoice\n  | \"invoice.created\"\n  | \"invoice.paid\"\n  | \"invoice.payment_failed\"\n  | \"invoice.upcoming\"\n  // Refund\n  | \"refund.created\"\n  | \"refund.updated\";\n\n/**\n * Webhook event\n */\nexport interface WebhookEvent<T = unknown> {\n  /** Event ID */\n  id: string;\n  /** Event type */\n  type: WebhookEventType;\n  /** Event data */\n  data: T;\n  /** Created timestamp */\n  created: Date;\n  /** Provider type */\n  provider: PaymentProviderType;\n  /** Raw event data */\n  raw: unknown;\n}\n\n/**\n * Webhook handler\n */\nexport type WebhookHandler<T = unknown> = (\n  event: WebhookEvent<T>\n) => void | Promise<void>;\n\n// ============================================================================\n// Provider Interface\n// ============================================================================\n\n/**\n * Payment provider interface\n */\nexport interface PaymentProvider {\n  /** Provider type */\n  readonly type: PaymentProviderType;\n\n  // Customer\n  createCustomer(options: CreateCustomerOptions): Promise<Customer>;\n  getCustomer(customerId: string): Promise<Customer | null>;\n  updateCustomer(customerId: string, options: Partial<CreateCustomerOptions>): Promise<Customer>;\n  deleteCustomer(customerId: string): Promise<void>;\n\n  // Checkout\n  createCheckout(options: CreateCheckoutOptions): Promise<CheckoutSession>;\n  getCheckout(sessionId: string): Promise<CheckoutSession | null>;\n\n  // Subscriptions\n  createSubscription(options: CreateSubscriptionOptions): Promise<Subscription>;\n  getSubscription(subscriptionId: string): Promise<Subscription | null>;\n  updateSubscription(subscriptionId: string, options: UpdateSubscriptionOptions): Promise<Subscription>;\n  cancelSubscription(subscriptionId: string, cancelAtPeriodEnd?: boolean): Promise<Subscription>;\n  listSubscriptions(customerId: string): Promise<Subscription[]>;\n\n  // Portal\n  createPortalSession(options: CreatePortalOptions): Promise<PortalSession>;\n\n  // Webhooks\n  verifyWebhook(payload: string | Uint8Array, signature: string): Promise<WebhookEvent | null>;\n\n  // Products & Prices (optional)\n  getProduct?(productId: string): Promise<Product | null>;\n  getPrice?(priceId: string): Promise<Price | null>;\n  listPrices?(productId?: string): Promise<Price[]>;\n}\n\n// ============================================================================\n// Provider Config\n// ============================================================================\n\n/**\n * Stripe provider config\n */\nexport interface StripeProviderConfig {\n  /** Stripe secret key */\n  secretKey: string;\n  /** Webhook signing secret */\n  webhookSecret?: string | undefined;\n  /** API version */\n  apiVersion?: string | undefined;\n}\n\n/**\n * Paddle provider config\n */\nexport interface PaddleProviderConfig {\n  /** Paddle API key */\n  apiKey: string;\n  /** Paddle environment */\n  environment?: \"sandbox\" | \"production\" | undefined;\n  /** Webhook secret key */\n  webhookSecret?: string | undefined;\n  /** Seller ID */\n  sellerId?: string | undefined;\n}\n\n// ============================================================================\n// Service Config\n// ============================================================================\n\n/**\n * Payment service config\n */\nexport interface PaymentServiceConfig {\n  /** Payment provider */\n  provider: PaymentProvider;\n  /** Enable debug logging */\n  debug?: boolean | undefined;\n}\n\n// ============================================================================\n// Errors\n// ============================================================================\n\n/**\n * Payment error\n */\nexport class PaymentError extends Error {\n  constructor(\n    message: string,\n    public readonly code: string,\n    public readonly cause?: unknown\n  ) {\n    super(message);\n    this.name = \"PaymentError\";\n  }\n}\n\n/**\n * Common payment error codes\n */\nexport const PaymentErrorCodes = {\n  INVALID_CONFIG: \"INVALID_CONFIG\",\n  CUSTOMER_NOT_FOUND: \"CUSTOMER_NOT_FOUND\",\n  SUBSCRIPTION_NOT_FOUND: \"SUBSCRIPTION_NOT_FOUND\",\n  CHECKOUT_FAILED: \"CHECKOUT_FAILED\",\n  PAYMENT_FAILED: \"PAYMENT_FAILED\",\n  WEBHOOK_VERIFICATION_FAILED: \"WEBHOOK_VERIFICATION_FAILED\",\n  API_ERROR: \"API_ERROR\",\n  RATE_LIMITED: \"RATE_LIMITED\",\n} as const;\n"],"mappings":";AAMA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACiB;AAAA,EACjB;AAAA,EACsB;AAAA,EACtB;AAAA,EACS;AAAA,EACO;AAAA,EAChB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAwBK;AAseA,IAAM,eAAN,cAA2B,MAAM;AAAA,EACtC,YACE,SACgB,MACA,OAChB;AACA,UAAM,OAAO;AAHG;AACA;AAGhB,SAAK,OAAO;AAAA,EACd;AACF;AAKO,IAAM,oBAAoB;AAAA,EAC/B,gBAAgB;AAAA,EAChB,oBAAoB;AAAA,EACpB,wBAAwB;AAAA,EACxB,iBAAiB;AAAA,EACjB,gBAAgB;AAAA,EAChB,6BAA6B;AAAA,EAC7B,WAAW;AAAA,EACX,cAAc;AAChB;","names":[]}