@stripe-sdk/core 1.0.0

package/dist/index-D8rM_YD4.d.mts

@@ -0,0 +1,375 @@
+import Stripe__default from 'stripe';
+
+interface StripeSDKConfig {
+    secretKey: string;
+    publishableKey: string;
+    webhookSecret?: string;
+    apiVersion?: Stripe__default.LatestApiVersion;
+    appInfo?: Stripe__default.AppInfo;
+}
+interface CreatePaymentIntentInput {
+    amount: number;
+    currency: string;
+    customerId?: string;
+    paymentMethodId?: string;
+    metadata?: Record<string, string>;
+    description?: string;
+    receiptEmail?: string;
+    setupFutureUsage?: 'on_session' | 'off_session';
+    automaticPaymentMethods?: boolean;
+    returnUrl?: string;
+}
+interface ConfirmPaymentInput {
+    paymentIntentId: string;
+    paymentMethodId?: string;
+    returnUrl?: string;
+}
+interface CreateCheckoutSessionInput {
+    mode: 'payment' | 'subscription' | 'setup';
+    lineItems: Array<{
+        priceId: string;
+        quantity: number;
+    }>;
+    successUrl: string;
+    cancelUrl: string;
+    customerId?: string;
+    customerEmail?: string;
+    metadata?: Record<string, string>;
+    allowPromotionCodes?: boolean;
+    shippingAddressCollection?: {
+        allowedCountries: string[];
+    };
+    billingAddressCollection?: 'auto' | 'required';
+    trialPeriodDays?: number;
+    taxIdCollection?: boolean;
+    automaticTax?: boolean;
+    locale?: string;
+}
+interface CreatePaymentLinkInput {
+    lineItems: Array<{
+        priceId: string;
+        quantity: number;
+        adjustableQuantity?: {
+            enabled: boolean;
+            minimum?: number;
+            maximum?: number;
+        };
+    }>;
+    metadata?: Record<string, string>;
+    afterCompletion?: {
+        type: 'redirect' | 'hosted_confirmation';
+        redirectUrl?: string;
+    };
+    allowPromotionCodes?: boolean;
+    automaticTax?: boolean;
+    billingAddressCollection?: 'auto' | 'required';
+    shippingAddressCollection?: {
+        allowedCountries: string[];
+    };
+}
+interface CreateCustomerInput {
+    email?: string;
+    name?: string;
+    phone?: string;
+    description?: string;
+    metadata?: Record<string, string>;
+    paymentMethodId?: string;
+    address?: {
+        line1?: string;
+        line2?: string;
+        city?: string;
+        state?: string;
+        postalCode?: string;
+        country?: string;
+    };
+}
+interface UpdateCustomerInput {
+    customerId: string;
+    email?: string;
+    name?: string;
+    phone?: string;
+    description?: string;
+    metadata?: Record<string, string>;
+    defaultPaymentMethodId?: string;
+    address?: {
+        line1?: string;
+        line2?: string;
+        city?: string;
+        state?: string;
+        postalCode?: string;
+        country?: string;
+    };
+}
+interface ListCustomersInput {
+    limit?: number;
+    startingAfter?: string;
+    endingBefore?: string;
+    email?: string;
+}
+interface CreateSubscriptionInput {
+    customerId: string;
+    priceId: string;
+    quantity?: number;
+    metadata?: Record<string, string>;
+    trialPeriodDays?: number;
+    couponId?: string;
+    promotionCodeId?: string;
+    paymentBehavior?: 'default_incomplete' | 'error_if_incomplete' | 'allow_incomplete' | 'pending_if_incomplete';
+    cancelAtPeriodEnd?: boolean;
+    billingCycleAnchor?: number;
+    prorationBehavior?: 'create_prorations' | 'none' | 'always_invoice';
+    items?: Array<{
+        priceId: string;
+        quantity?: number;
+    }>;
+}
+interface UpdateSubscriptionInput {
+    subscriptionId: string;
+    priceId?: string;
+    quantity?: number;
+    metadata?: Record<string, string>;
+    cancelAtPeriodEnd?: boolean;
+    prorationBehavior?: 'create_prorations' | 'none' | 'always_invoice';
+    couponId?: string;
+    items?: Array<{
+        id?: string;
+        priceId: string;
+        quantity?: number;
+    }>;
+}
+interface CancelSubscriptionInput {
+    subscriptionId: string;
+    cancelAtPeriodEnd?: boolean;
+    cancellationDetails?: {
+        comment?: string;
+        feedback?: 'customer_service' | 'low_quality' | 'missing_features' | 'other' | 'switched_service' | 'too_complex' | 'too_expensive' | 'unused';
+    };
+}
+interface CreateProductInput {
+    name: string;
+    description?: string;
+    images?: string[];
+    metadata?: Record<string, string>;
+    active?: boolean;
+    defaultPriceData?: {
+        unitAmount: number;
+        currency: string;
+        recurring?: {
+            interval: 'day' | 'week' | 'month' | 'year';
+            intervalCount?: number;
+        };
+    };
+}
+interface UpdateProductInput {
+    productId: string;
+    name?: string;
+    description?: string;
+    images?: string[];
+    metadata?: Record<string, string>;
+    active?: boolean;
+}
+interface CreatePriceInput {
+    productId: string;
+    unitAmount: number;
+    currency: string;
+    recurring?: {
+        interval: 'day' | 'week' | 'month' | 'year';
+        intervalCount?: number;
+    };
+    metadata?: Record<string, string>;
+    active?: boolean;
+    nickname?: string;
+    lookupKey?: string;
+    billingScheme?: 'per_unit' | 'tiered';
+    tiers?: Array<{
+        upTo: number | 'inf';
+        unitAmount?: number;
+        flatAmount?: number;
+    }>;
+    tiersMode?: 'graduated' | 'volume';
+}
+interface CreateInvoiceInput {
+    customerId: string;
+    collectionMethod?: 'charge_automatically' | 'send_invoice';
+    daysUntilDue?: number;
+    metadata?: Record<string, string>;
+    description?: string;
+    autoAdvance?: boolean;
+}
+interface CreateInvoiceItemInput {
+    customerId: string;
+    invoiceId?: string;
+    priceId?: string;
+    amount?: number;
+    currency?: string;
+    description?: string;
+    quantity?: number;
+    metadata?: Record<string, string>;
+}
+interface CreateRefundInput {
+    paymentIntentId?: string;
+    chargeId?: string;
+    amount?: number;
+    reason?: 'duplicate' | 'fraudulent' | 'requested_by_customer';
+    metadata?: Record<string, string>;
+}
+interface UpdateDisputeInput {
+    disputeId: string;
+    evidence?: {
+        customerName?: string;
+        customerEmailAddress?: string;
+        customerCommunication?: string;
+        productDescription?: string;
+        shippingDocumentation?: string;
+        serviceDocumentation?: string;
+        uncategorizedText?: string;
+    };
+    metadata?: Record<string, string>;
+    submit?: boolean;
+}
+interface CreateConnectAccountInput {
+    type: 'standard' | 'express' | 'custom';
+    country?: string;
+    email?: string;
+    capabilities?: {
+        cardPayments?: {
+            requested: boolean;
+        };
+        transfers?: {
+            requested: boolean;
+        };
+    };
+    businessType?: 'individual' | 'company' | 'non_profit' | 'government_entity';
+    metadata?: Record<string, string>;
+}
+interface CreateAccountLinkInput {
+    accountId: string;
+    refreshUrl: string;
+    returnUrl: string;
+    type: 'account_onboarding' | 'account_update';
+}
+interface CreateTransferInput {
+    amount: number;
+    currency: string;
+    destinationAccountId: string;
+    description?: string;
+    metadata?: Record<string, string>;
+    sourceTransaction?: string;
+}
+interface CreateCouponInput {
+    percentOff?: number;
+    amountOff?: number;
+    currency?: string;
+    duration: 'forever' | 'once' | 'repeating';
+    durationInMonths?: number;
+    maxRedemptions?: number;
+    redeemBy?: number;
+    name?: string;
+    metadata?: Record<string, string>;
+}
+interface CreatePromotionCodeInput {
+    couponId: string;
+    code?: string;
+    active?: boolean;
+    maxRedemptions?: number;
+    expiresAt?: number;
+    metadata?: Record<string, string>;
+    restrictions?: {
+        firstTimeTransaction?: boolean;
+        minimumAmount?: number;
+        minimumAmountCurrency?: string;
+    };
+}
+interface CreateSetupIntentInput {
+    customerId?: string;
+    paymentMethodTypes?: string[];
+    usage?: 'on_session' | 'off_session';
+    metadata?: Record<string, string>;
+}
+interface CreatePortalSessionInput {
+    customerId: string;
+    returnUrl: string;
+    configuration?: string;
+}
+type WebhookEventType = 'payment_intent.succeeded' | 'payment_intent.payment_failed' | 'payment_intent.canceled' | 'payment_intent.created' | 'payment_intent.processing' | 'checkout.session.completed' | 'checkout.session.expired' | 'customer.created' | 'customer.updated' | 'customer.deleted' | 'customer.subscription.created' | 'customer.subscription.updated' | 'customer.subscription.deleted' | 'customer.subscription.trial_will_end' | 'customer.subscription.paused' | 'customer.subscription.resumed' | 'invoice.created' | 'invoice.finalized' | 'invoice.paid' | 'invoice.payment_succeeded' | 'invoice.payment_failed' | 'invoice.upcoming' | 'invoice.voided' | 'charge.succeeded' | 'charge.failed' | 'charge.refunded' | 'charge.dispute.created' | 'charge.dispute.updated' | 'charge.dispute.closed' | 'product.created' | 'product.updated' | 'product.deleted' | 'price.created' | 'price.updated' | 'price.deleted' | 'payment_method.attached' | 'payment_method.detached' | 'payment_method.updated' | 'setup_intent.succeeded' | 'setup_intent.setup_failed' | 'account.updated' | 'payout.created' | 'payout.paid' | 'payout.failed' | string;
+type WebhookHandler = (event: Stripe__default.Event) => Promise<void> | void;
+interface WebhookHandlerMap {
+    [eventType: string]: WebhookHandler;
+}
+interface PaginationInput {
+    limit?: number;
+    startingAfter?: string;
+    endingBefore?: string;
+}
+interface SDKResponse<T> {
+    data: T;
+    error: null;
+}
+interface SDKError {
+    data: null;
+    error: {
+        message: string;
+        type: string;
+        code?: string;
+        statusCode?: number;
+    };
+}
+type SDKResult<T> = SDKResponse<T> | SDKError;
+
+interface WebhookConfig {
+    secret?: string;
+    handlers: WebhookHandlerMap;
+    onError?: (error: Error, event?: Stripe__default.Event) => void | Promise<void>;
+    onUnhandledEvent?: (event: Stripe__default.Event) => void | Promise<void>;
+}
+declare function createWebhookHandler(config: WebhookConfig): (body: string | Buffer, signature: string) => Promise<{
+    received: true;
+    type: string;
+}>;
+/**
+ * Helper for Next.js App Router webhook route
+ *
+ * Usage in app/api/webhooks/stripe/route.ts:
+ *
+ * ```ts
+ * import { createNextWebhookHandler } from '@stripe-sdk/core/webhooks';
+ *
+ * export const POST = createNextWebhookHandler({
+ *   handlers: {
+ *     'payment_intent.succeeded': async (event) => { ... },
+ *     'customer.subscription.created': async (event) => { ... },
+ *   },
+ * });
+ * ```
+ */
+declare function createNextWebhookHandler(config: WebhookConfig): (request: Request) => Promise<Response>;
+/**
+ * Helper for Next.js Pages Router webhook route
+ *
+ * Usage in pages/api/webhooks/stripe.ts:
+ *
+ * ```ts
+ * import { createPagesWebhookHandler } from '@stripe-sdk/core/webhooks';
+ *
+ * export const config = { api: { bodyParser: false } };
+ *
+ * export default createPagesWebhookHandler({
+ *   handlers: {
+ *     'payment_intent.succeeded': async (event) => { ... },
+ *   },
+ * });
+ * ```
+ */
+declare function createPagesWebhookHandler(webhookConfig: WebhookConfig): (req: {
+    method?: string;
+    headers: Record<string, string | string[] | undefined>;
+    body?: unknown;
+    on?: (event: string, cb: (...args: unknown[]) => void) => void;
+}, res: {
+    status: (code: number) => {
+        json: (data: unknown) => void;
+        end: () => void;
+    };
+}) => Promise<void>;
+
+export { createNextWebhookHandler as A, createPagesWebhookHandler as B, type CancelSubscriptionInput as C, createWebhookHandler as D, type WebhookConfig as E, type ListCustomersInput as L, type PaginationInput as P, type SDKError as S, type UpdateCustomerInput as U, type WebhookEventType as W, type ConfirmPaymentInput as a, type CreateAccountLinkInput as b, type CreateCheckoutSessionInput as c, type CreateConnectAccountInput as d, type CreateCouponInput as e, type CreateCustomerInput as f, type CreateInvoiceInput as g, type CreateInvoiceItemInput as h, type CreatePaymentIntentInput as i, type CreatePaymentLinkInput as j, type CreatePortalSessionInput as k, type CreatePriceInput as l, type CreateProductInput as m, type CreatePromotionCodeInput as n, type CreateRefundInput as o, type CreateSetupIntentInput as p, type CreateSubscriptionInput as q, type CreateTransferInput as r, type SDKResponse as s, type SDKResult as t, type StripeSDKConfig as u, type UpdateDisputeInput as v, type UpdateProductInput as w, type UpdateSubscriptionInput as x, type WebhookHandler as y, type WebhookHandlerMap as z };