@rovela-ai/sdk 0.4.0 → 0.4.1

package/dist/checkout/hooks/usePaymentStatus.js

@@ -1,71 +0,0 @@
-/**
- * @rovela/sdk/checkout/hooks/usePaymentStatus
- *
- * React hook for checking if payments are configured.
- * Use this to conditionally render checkout UI.
- */
-'use client';
-import { useState, useEffect, useCallback } from 'react';
-// =============================================================================
-// Hook
-// =============================================================================
-/**
- * Hook for checking if payments are configured for this store.
- *
- * @example
- * ```tsx
- * import { usePaymentStatus, CheckoutButton } from '@rovela/sdk/checkout'
- *
- * function CartFooter() {
- *   const { canAcceptPayments, status, message } = usePaymentStatus()
- *
- *   if (!canAcceptPayments) {
- *     return (
- *       <div className="text-amber-600 text-sm">
- *         {message}
- *       </div>
- *     )
- *   }
- *
- *   return <CheckoutButton />
- * }
- * ```
- */
-export function usePaymentStatus() {
-    const [state, setState] = useState({
-        canAcceptPayments: false,
-        status: 'loading',
-        message: 'Checking payment status...',
-    });
-    const fetchStatus = useCallback(async () => {
-        setState((prev) => ({ ...prev, status: 'loading' }));
-        try {
-            const response = await fetch('/api/checkout/status');
-            if (!response.ok) {
-                throw new Error('Failed to check payment status');
-            }
-            const data = (await response.json());
-            setState({
-                canAcceptPayments: data.canAcceptPayments,
-                status: data.status,
-                message: data.message,
-            });
-        }
-        catch (error) {
-            setState({
-                canAcceptPayments: false,
-                status: 'error',
-                message: 'Unable to verify payment configuration.',
-            });
-        }
-    }, []);
-    useEffect(() => {
-        fetchStatus();
-    }, [fetchStatus]);
-    return {
-        ...state,
-        isLoading: state.status === 'loading',
-        refresh: fetchStatus,
-    };
-}
-//# sourceMappingURL=usePaymentStatus.js.map

package/dist/checkout/hooks/usePaymentStatus.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"usePaymentStatus.js","sourceRoot":"","sources":["../../../src/checkout/hooks/usePaymentStatus.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,CAAA;AAEZ,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AAoBxD,gFAAgF;AAChF,OAAO;AACP,gFAAgF;AAEhF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,UAAU,gBAAgB;IAC9B,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAI/B;QACD,iBAAiB,EAAE,KAAK;QACxB,MAAM,EAAE,SAAS;QACjB,OAAO,EAAE,4BAA4B;KACtC,CAAC,CAAA;IAEF,MAAM,WAAW,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QACzC,QAAQ,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC,CAAA;QAEpD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,sBAAsB,CAAC,CAAA;YAEpD,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAA;YACnD,CAAC;YAED,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA0B,CAAA;YAE7D,QAAQ,CAAC;gBACP,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;gBACzC,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,OAAO,EAAE,IAAI,CAAC,OAAO;aACtB,CAAC,CAAA;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,QAAQ,CAAC;gBACP,iBAAiB,EAAE,KAAK;gBACxB,MAAM,EAAE,OAAO;gBACf,OAAO,EAAE,yCAAyC;aACnD,CAAC,CAAA;QACJ,CAAC;IACH,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,SAAS,CAAC,GAAG,EAAE;QACb,WAAW,EAAE,CAAA;IACf,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,CAAA;IAEjB,OAAO;QACL,GAAG,KAAK;QACR,SAAS,EAAE,KAAK,CAAC,MAAM,KAAK,SAAS;QACrC,OAAO,EAAE,WAAW;KACrB,CAAA;AACH,CAAC"}

package/dist/checkout/index.js

@@ -1,135 +0,0 @@
-/**
- * @rovela/sdk/checkout
- *
- * Stripe Checkout integration with Direct Charges for connected accounts.
- *
- * ## Overview
- *
- * This module provides complete Stripe Checkout integration:
- * - Stripe Checkout (hosted) for payment collection
- * - Direct Charges to connected accounts
- * - Automatic platform fee calculation
- * - Webhook handling for order creation
- *
- * ## Quick Start
- *
- * ### 1. Environment Variables
- *
- * ```env
- * # Platform (Rovela) credentials
- * STRIPE_SECRET_KEY=sk_live_...
- * STRIPE_PUBLISHABLE_KEY=pk_live_...
- * STRIPE_WEBHOOK_SECRET=whsec_...
- *
- * # Per-store connected account (set during store setup)
- * STRIPE_CONNECTED_ACCOUNT_ID=acct_...
- *
- * # Optional configuration
- * STRIPE_PLATFORM_FEE_PERCENT=5    # Platform takes 5%
- * STORE_CURRENCY=USD               # Store currency
- * ```
- *
- * ### 2. API Routes
- *
- * ```typescript
- * // app/api/checkout/route.ts
- * export { POST } from '@rovela/sdk/checkout/api'
- *
- * // app/api/webhooks/stripe/route.ts
- * import { handleStripeWebhook } from '@rovela/sdk/checkout/server'
- *
- * export async function POST(request: Request) {
- *   const payload = await request.text()
- *   const signature = request.headers.get('stripe-signature')!
- *   const result = await handleStripeWebhook(payload, signature)
- *   return Response.json(result)
- * }
- * ```
- *
- * ### 3. Checkout Button
- *
- * ```tsx
- * // In your cart or product page
- * import { CheckoutButton } from '@rovela/sdk/checkout'
- *
- * function Cart() {
- *   return (
- *     <div>
- *       <CartItems />
- *       <CartSummary />
- *       <CheckoutButton size="lg" fullWidth>
- *         Proceed to Checkout
- *       </CheckoutButton>
- *     </div>
- *   )
- * }
- * ```
- *
- * ### 4. Success Page
- *
- * ```tsx
- * // app/checkout/success/page.tsx
- * import { CheckoutSuccess } from '@rovela/sdk/checkout'
- * import { useCart } from '@rovela/sdk/cart'
- *
- * export default function SuccessPage() {
- *   const { clearCart } = useCart()
- *
- *   return (
- *     <CheckoutSuccess
- *       continueShoppingHref="/products"
- *       viewOrderHref="/account/orders/{orderId}"
- *       onMount={clearCart}
- *     />
- *   )
- * }
- * ```
- *
- * ## Architecture
- *
- * ```
- * Cart → CheckoutButton → /api/checkout → Stripe Checkout (hosted)
- *                                              ↓
- * Database ← Webhook ← /api/webhooks/stripe ← Stripe
- *                              ↓
- *                     Order Created
- * ```
- *
- * ## Direct Charges Model
- *
- * With Direct Charges, payments are made directly on the connected account:
- * - Payment shows connected account name on customer statement
- * - Connected account handles disputes
- * - Platform collects application fee automatically
- */
-// =============================================================================
-// Components
-// =============================================================================
-export { CheckoutButton, CheckoutFlow, CheckoutSuccess, OrderSummary, ShippingForm, ShippingOptions, } from './components';
-// =============================================================================
-// Hooks
-// =============================================================================
-export { useCheckout, usePaymentStatus } from './hooks';
-// =============================================================================
-// Server Functions
-// =============================================================================
-export { 
-// Session creation
-createCheckoutSession, getCheckoutSession, 
-// Order management
-createOrderFromCheckout, extractOrderParamsFromSession, handleRefund, 
-// Webhook handler
-handleStripeWebhook, } from './server';
-// =============================================================================
-// API Route Handlers
-// =============================================================================
-export { CountriesGET } from './api';
-// =============================================================================
-// Stripe Client Utilities
-// =============================================================================
-export { getStripe, getConnectedAccountId, hasConnectedAccount, getPlatformFeePercent, calculateApplicationFee, getWebhookSecret, getStoreCurrency, getAllowedShippingCountries, getPublishableKey, } from './stripe';
-// =============================================================================
-// Address Constants & Utilities
-// =============================================================================
-export { COMMON_COUNTRIES, US_STATES, getCountryName, getStateName, countryRequiresState, } from './constants';
-//# sourceMappingURL=index.js.map

package/dist/checkout/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/checkout/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuGG;AAwCH,gFAAgF;AAChF,aAAa;AACb,gFAAgF;AAEhF,OAAO,EACL,cAAc,EACd,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,eAAe,GAChB,MAAM,cAAc,CAAA;AAErB,gFAAgF;AAChF,QAAQ;AACR,gFAAgF;AAEhF,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAGvD,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF,OAAO;AACL,mBAAmB;AACnB,qBAAqB,EACrB,kBAAkB;AAClB,mBAAmB;AACnB,uBAAuB,EACvB,6BAA6B,EAC7B,YAAY;AACZ,kBAAkB;AAClB,mBAAmB,GACpB,MAAM,UAAU,CAAA;AAIjB,gFAAgF;AAChF,qBAAqB;AACrB,gFAAgF;AAEhF,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAA;AAEpC,gFAAgF;AAChF,0BAA0B;AAC1B,gFAAgF;AAEhF,OAAO,EACL,SAAS,EACT,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,gBAAgB,EAChB,gBAAgB,EAChB,2BAA2B,EAC3B,iBAAiB,GAClB,MAAM,UAAU,CAAA;AAEjB,gFAAgF;AAChF,gCAAgC;AAChC,gFAAgF;AAEhF,OAAO,EACL,gBAAgB,EAChB,SAAS,EACT,cAAc,EACd,YAAY,EACZ,oBAAoB,GACrB,MAAM,aAAa,CAAA"}

package/dist/checkout/server/coupons.d.ts

@@ -1,91 +0,0 @@
-/**
- * @rovela/sdk/checkout/server/coupons
- *
- * Thin wrappers around Stripe Coupons + PromotionCodes APIs.
- *
- * Used by feature cards that need to issue discount codes:
- * - M4 birthday discount automation
- * - M5 win-back campaign
- * - M7 bulk coupon generator
- * - M10 spinner wheel reward
- *
- * Stripe model:
- *   Coupon (the discount itself: e.g. "10% off") → 1
- *   PromotionCode (a unique code like "BIRTHDAY-AB12") → 1..N per coupon
- *
- * Single-use codes: max_redemptions: 1 (default for these helpers).
- * Bulk codes: each gets its own PromotionCode bound to a single shared
- * coupon. 200ms throttle between PromotionCode creates respects Stripe's
- * 25-req/s rate limit on this endpoint with comfortable headroom.
- *
- * NOTE: Coupons + PromotionCodes are platform-level (live on the Rovela
- * Stripe account, NOT on the merchant's connected account). They apply
- * via the existing Stripe Checkout Session flow when `allow_promotion_codes`
- * is enabled. See checkout-session creation for that wiring.
- */
-export interface CreateCouponWithCodeOptions {
-    /** Discount in cents (e.g. 1000 = $10 off). Mutually exclusive with `percentOff`. */
-    amountOff?: number;
-    /** Discount percentage (1–100). Mutually exclusive with `amountOff`. */
-    percentOff?: number;
-    /** ISO currency code (required when `amountOff` is set). */
-    currency?: string;
-    /** The promotion code string (e.g. "BIRTHDAY-AB12"). Auto-generated if omitted. */
-    code?: string;
-    /** Whether the coupon applies once or repeats. Defaults to 'once'. */
-    duration?: 'once' | 'forever';
-    /** Max redemptions for the PromotionCode. Defaults to 1 (single-use). */
-    maxRedemptions?: number;
-    /** Code expiration. Defaults to 30 days from creation. */
-    expiresAt?: Date;
-    /** Optional metadata attached to the coupon (Stripe limit: 50 keys / 500 chars). */
-    metadata?: Record<string, string>;
-    /** Human-readable name for Stripe dashboard. Optional. */
-    name?: string;
-}
-export interface CreateCouponResult {
-    couponId: string;
-    promotionCodeId: string;
-    /** The actual code string customers enter at checkout. */
-    code: string;
-}
-export interface CreateBulkPromotionCodesOptions {
-    /** Discount in cents. Mutually exclusive with `percentOff`. */
-    amountOff?: number;
-    /** Discount percentage (1–100). */
-    percentOff?: number;
-    currency?: string;
-    /** Optional code prefix (e.g. "BFCM2026" → codes look like "BFCM2026-XYZ123"). */
-    prefix?: string;
-    /** Number of codes to create. Hard cap: 1000. */
-    count: number;
-    expiresAt?: Date;
-    metadata?: Record<string, string>;
-    name?: string;
-}
-export interface CreateBulkResult {
-    couponId: string;
-    codes: string[];
-}
-/**
- * Create a Stripe Coupon and a single PromotionCode bound to it.
- *
- * Use for one-off rewards: birthday code, win-back code, spinner-wheel win.
- * For bulk distribution (1000 codes for an email blast), use
- * `createBulkPromotionCodes` instead — it shares one coupon across all codes
- * for cleaner Stripe dashboard accounting.
- */
-export declare function createCouponWithCode(options: CreateCouponWithCodeOptions): Promise<CreateCouponResult>;
-/**
- * Create one Stripe Coupon and N PromotionCodes bound to it.
- *
- * Used for bulk-code campaigns (M7 coupon generator). All codes share the
- * same coupon, so Stripe dashboard shows a single discount entry with a
- * tally of redemptions — cleaner than N separate coupons.
- *
- * Hard cap: 1000 codes per call (Stripe rate-limits PromotionCode creation).
- * Codes are created sequentially with a 200ms throttle (yields ~5/s, well
- * under Stripe's 25/s limit on this endpoint).
- */
-export declare function createBulkPromotionCodes(options: CreateBulkPromotionCodesOptions): Promise<CreateBulkResult>;
-//# sourceMappingURL=coupons.d.ts.map

package/dist/checkout/server/coupons.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"coupons.d.ts","sourceRoot":"","sources":["../../../src/checkout/server/coupons.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AASH,MAAM,WAAW,2BAA2B;IAC1C,qFAAqF;IACrF,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,wEAAwE;IACxE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,4DAA4D;IAC5D,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,mFAAmF;IACnF,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC7B,yEAAyE;IACzE,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,IAAI,CAAA;IAChB,oFAAoF;IACpF,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACjC,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAA;IAChB,eAAe,EAAE,MAAM,CAAA;IACvB,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAA;CACb;AAED,MAAM,WAAW,+BAA+B;IAC9C,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,kFAAkF;IAClF,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAA;IACb,SAAS,CAAC,EAAE,IAAI,CAAA;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACjC,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAA;IAChB,KAAK,EAAE,MAAM,EAAE,CAAA;CAChB;AAuDD;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,kBAAkB,CAAC,CAgD7B;AAMD;;;;;;;;;;GAUG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,+BAA+B,GACvC,OAAO,CAAC,gBAAgB,CAAC,CA+F3B"}

package/dist/checkout/server/coupons.js

@@ -1,192 +0,0 @@
-/**
- * @rovela/sdk/checkout/server/coupons
- *
- * Thin wrappers around Stripe Coupons + PromotionCodes APIs.
- *
- * Used by feature cards that need to issue discount codes:
- * - M4 birthday discount automation
- * - M5 win-back campaign
- * - M7 bulk coupon generator
- * - M10 spinner wheel reward
- *
- * Stripe model:
- *   Coupon (the discount itself: e.g. "10% off") → 1
- *   PromotionCode (a unique code like "BIRTHDAY-AB12") → 1..N per coupon
- *
- * Single-use codes: max_redemptions: 1 (default for these helpers).
- * Bulk codes: each gets its own PromotionCode bound to a single shared
- * coupon. 200ms throttle between PromotionCode creates respects Stripe's
- * 25-req/s rate limit on this endpoint with comfortable headroom.
- *
- * NOTE: Coupons + PromotionCodes are platform-level (live on the Rovela
- * Stripe account, NOT on the merchant's connected account). They apply
- * via the existing Stripe Checkout Session flow when `allow_promotion_codes`
- * is enabled. See checkout-session creation for that wiring.
- */
-import { nanoid } from 'nanoid';
-import { getStripe } from '../stripe/client';
-// =============================================================================
-// Hard caps (DO NOT lift without re-reviewing Stripe rate limits)
-// =============================================================================
-const MAX_BULK_CODES = 1000;
-const BULK_THROTTLE_MS = 200;
-// =============================================================================
-// Helpers
-// =============================================================================
-function generateCodeSegment(length = 6) {
-    // Crockford-base32-ish (skip ambiguous 0/O/1/I/L) — easier for humans to type.
-    const alphabet = 'ABCDEFGHJKMNPQRSTUVWXYZ23456789';
-    return nanoid(length).replace(/[^A-Z0-9]/gi, () => alphabet[Math.floor(Math.random() * alphabet.length)]).toUpperCase().slice(0, length);
-}
-function buildCode(prefix) {
-    const segment = generateCodeSegment(8);
-    return prefix ? `${prefix}-${segment}` : segment;
-}
-function sleep(ms) {
-    return new Promise((resolve) => setTimeout(resolve, ms));
-}
-function validateDiscountInputs(amountOff, percentOff, currency) {
-    const hasAmount = typeof amountOff === 'number' && amountOff > 0;
-    const hasPercent = typeof percentOff === 'number' && percentOff > 0;
-    if (hasAmount === hasPercent) {
-        throw new Error('createCoupon: provide exactly one of `amountOff` or `percentOff`.');
-    }
-    if (hasAmount && !currency) {
-        throw new Error('createCoupon: `currency` is required when using `amountOff`.');
-    }
-    if (hasPercent && (percentOff < 1 || percentOff > 100)) {
-        throw new Error('createCoupon: `percentOff` must be between 1 and 100.');
-    }
-}
-// =============================================================================
-// Single coupon + code (1:1)
-// =============================================================================
-/**
- * Create a Stripe Coupon and a single PromotionCode bound to it.
- *
- * Use for one-off rewards: birthday code, win-back code, spinner-wheel win.
- * For bulk distribution (1000 codes for an email blast), use
- * `createBulkPromotionCodes` instead — it shares one coupon across all codes
- * for cleaner Stripe dashboard accounting.
- */
-export async function createCouponWithCode(options) {
-    const { amountOff, percentOff, currency, code, duration = 'once', maxRedemptions = 1, expiresAt, metadata, name, } = options;
-    validateDiscountInputs(amountOff, percentOff, currency);
-    const stripe = getStripe();
-    // Default expiration: 30 days from now
-    const expires = expiresAt ?? new Date(Date.now() + 30 * 24 * 60 * 60 * 1000);
-    const redeemBy = Math.floor(expires.getTime() / 1000);
-    const coupon = await stripe.coupons.create({
-        duration,
-        ...(amountOff && currency
-            ? { amount_off: amountOff, currency }
-            : { percent_off: percentOff }),
-        redeem_by: redeemBy,
-        max_redemptions: maxRedemptions,
-        ...(name && { name }),
-        ...(metadata && { metadata }),
-    });
-    const finalCode = code ?? buildCode();
-    const promotionCode = await stripe.promotionCodes.create({
-        promotion: { type: 'coupon', coupon: coupon.id },
-        code: finalCode,
-        max_redemptions: maxRedemptions,
-        expires_at: redeemBy,
-        ...(metadata && { metadata }),
-    });
-    return {
-        couponId: coupon.id,
-        promotionCodeId: promotionCode.id,
-        code: finalCode,
-    };
-}
-// =============================================================================
-// Bulk: one coupon, N codes (1:N)
-// =============================================================================
-/**
- * Create one Stripe Coupon and N PromotionCodes bound to it.
- *
- * Used for bulk-code campaigns (M7 coupon generator). All codes share the
- * same coupon, so Stripe dashboard shows a single discount entry with a
- * tally of redemptions — cleaner than N separate coupons.
- *
- * Hard cap: 1000 codes per call (Stripe rate-limits PromotionCode creation).
- * Codes are created sequentially with a 200ms throttle (yields ~5/s, well
- * under Stripe's 25/s limit on this endpoint).
- */
-export async function createBulkPromotionCodes(options) {
-    const { amountOff, percentOff, currency, prefix, count, expiresAt, metadata, name, } = options;
-    if (!Number.isInteger(count) || count < 1) {
-        throw new Error('createBulkPromotionCodes: `count` must be a positive integer.');
-    }
-    if (count > MAX_BULK_CODES) {
-        throw new Error(`createBulkPromotionCodes: maximum ${MAX_BULK_CODES} codes per call (got ${count}).`);
-    }
-    validateDiscountInputs(amountOff, percentOff, currency);
-    const stripe = getStripe();
-    const expires = expiresAt ?? new Date(Date.now() + 90 * 24 * 60 * 60 * 1000);
-    const redeemBy = Math.floor(expires.getTime() / 1000);
-    // Create the shared coupon once.
-    const coupon = await stripe.coupons.create({
-        duration: 'once',
-        ...(amountOff && currency
-            ? { amount_off: amountOff, currency }
-            : { percent_off: percentOff }),
-        redeem_by: redeemBy,
-        max_redemptions: count,
-        ...(name && { name }),
-        ...(metadata && { metadata }),
-    });
-    const codes = [];
-    const seen = new Set();
-    for (let i = 0; i < count; i++) {
-        // Avoid collisions in case nanoid yields a dupe (extremely rare).
-        let candidate = buildCode(prefix);
-        let attempts = 0;
-        while (seen.has(candidate) && attempts < 5) {
-            candidate = buildCode(prefix);
-            attempts++;
-        }
-        seen.add(candidate);
-        try {
-            await stripe.promotionCodes.create({
-                promotion: { type: 'coupon', coupon: coupon.id },
-                code: candidate,
-                max_redemptions: 1,
-                expires_at: redeemBy,
-                ...(metadata && { metadata }),
-            });
-            codes.push(candidate);
-        }
-        catch (err) {
-            // Rare: code collision on Stripe side. Try one more nanoid before
-            // giving up the slot. Don't fail the whole batch.
-            const retry = buildCode(prefix);
-            try {
-                await stripe.promotionCodes.create({
-                    promotion: { type: 'coupon', coupon: coupon.id },
-                    code: retry,
-                    max_redemptions: 1,
-                    expires_at: redeemBy,
-                    ...(metadata && { metadata }),
-                });
-                codes.push(retry);
-            }
-            catch {
-                // Surface the original error so the caller can decide whether to
-                // continue with a partial batch or abort.
-                const remaining = count - codes.length;
-                throw new Error(`createBulkPromotionCodes: failed at code ${codes.length + 1} of ${count} (${remaining} remaining). ` +
-                    `Original error: ${err instanceof Error ? err.message : String(err)}`);
-            }
-        }
-        // Throttle every code except the last.
-        if (i < count - 1)
-            await sleep(BULK_THROTTLE_MS);
-    }
-    return {
-        couponId: coupon.id,
-        codes,
-    };
-}
-//# sourceMappingURL=coupons.js.map

package/dist/checkout/server/coupons.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"coupons.js","sourceRoot":"","sources":["../../../src/checkout/server/coupons.ts"],"names":[],"mappings":"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"}

package/dist/checkout/server/index.js

@@ -1,10 +0,0 @@
-/**
- * @rovela/sdk/checkout/server
- *
- * Server-side checkout functions
- */
-export { createCheckoutSession, getCheckoutSession, deserializeItemsFromMetadata, } from './create-checkout-session';
-export { handleStripeWebhook } from './handle-webhook';
-export { createOrderFromCheckout, extractOrderParamsFromSession, handleRefund, } from './order-service';
-export { createCouponWithCode, createBulkPromotionCodes, } from './coupons';
-//# sourceMappingURL=index.js.map

package/dist/checkout/server/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/checkout/server/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,4BAA4B,GAC7B,MAAM,2BAA2B,CAAA;AAIlC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAEtD,OAAO,EACL,uBAAuB,EACvB,6BAA6B,EAC7B,YAAY,GACb,MAAM,iBAAiB,CAAA;AAExB,OAAO,EACL,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,WAAW,CAAA"}

package/dist/checkout/stripe/client.d.ts

@@ -1,74 +0,0 @@
-/**
- * @rovela/sdk/checkout/stripe/client
- *
- * Stripe SDK initialization for server-side operations.
- * Uses Direct Charges with connected accounts.
- */
-import Stripe from 'stripe';
-/**
- * Get the Stripe client instance (server-side).
- * Lazily initialized on first use.
- *
- * @throws Error if STRIPE_SECRET_KEY is not set
- */
-export declare function getStripe(): Stripe;
-/**
- * Get the connected Stripe account ID for this store.
- * Each store has its own connected account.
- *
- * @throws Error if STRIPE_CONNECTED_ACCOUNT_ID is not set
- */
-export declare function getConnectedAccountId(): string;
-/**
- * Check if the store has a connected Stripe account.
- * Use this to conditionally show checkout UI.
- */
-export declare function hasConnectedAccount(): boolean;
-/**
- * Get the platform fee percentage for transactions.
- * Default is 5% if not configured.
- */
-export declare function getPlatformFeePercent(): number;
-/**
- * Calculate the application fee amount in cents.
- *
- * @param amountInCents - The total transaction amount in cents
- * @returns The application fee in cents (rounded)
- */
-export declare function calculateApplicationFee(amountInCents: number): number;
-/**
- * Get the primary webhook signing secret (for account events).
- * Used to verify webhook signatures from platform account.
- *
- * @throws Error if STRIPE_WEBHOOK_SECRET is not set
- */
-export declare function getWebhookSecret(): string;
-/**
- * Get the Connect webhook signing secret (for connected account events).
- * Used to verify webhook signatures from connected accounts.
- * Falls back to primary secret if not set.
- */
-export declare function getConnectWebhookSecret(): string | null;
-/**
- * Get all webhook secrets to try during verification.
- * Returns array of secrets to attempt (primary first, then connect).
- */
-export declare function getAllWebhookSecrets(): string[];
-/**
- * Get the store's currency code.
- * Default is USD if not configured.
- */
-export declare function getStoreCurrency(): string;
-/**
- * Get allowed countries for shipping from environment variable.
- * This is a synchronous fallback when database is not available.
- * Prefer using getShippingCountriesFromSettings() when possible.
- * @deprecated Use getShippingCountriesFromSettings() for dynamic configuration
- */
-export declare function getAllowedShippingCountries(): string[];
-/**
- * Get the publishable key for client-side Stripe.js
- * This is safe to expose to the browser.
- */
-export declare function getPublishableKey(): string;
-//# sourceMappingURL=client.d.ts.map

package/dist/checkout/stripe/client.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/checkout/stripe/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,MAAM,MAAM,QAAQ,CAAA;AAQ3B;;;;;GAKG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAsBlC;AAMD;;;;;GAKG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAY9C;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,OAAO,CAE7C;AAMD;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CAgB9C;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAGrE;AAMD;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAYzC;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,GAAG,IAAI,CAEvD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAqB/C;AAMD;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,EAAE,CAQtD;AAMD;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAY1C"}