@rovela-ai/sdk 0.1.2 → 0.1.4

package/dist/checkout/server/order-service.js

@@ -0,0 +1,196 @@
+"use strict";
+/**
+ * @rovela/sdk/checkout/server/order-service
+ *
+ * Order creation and management from Stripe Checkout sessions.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createOrderFromCheckout = createOrderFromCheckout;
+exports.extractOrderParamsFromSession = extractOrderParamsFromSession;
+exports.handleRefund = handleRefund;
+const queries_1 = require("../../core/db/queries");
+const create_checkout_session_1 = require("./create-checkout-session");
+// =============================================================================
+// Order Creation
+// =============================================================================
+/**
+ * Create an order from a completed Stripe Checkout session.
+ *
+ * This function:
+ * 1. Checks for existing order (idempotency)
+ * 2. Creates the order record
+ * 3. Creates order items
+ * 4. Returns the created order
+ *
+ * @example
+ * ```typescript
+ * // In webhook handler
+ * const order = await createOrderFromCheckout({
+ *   sessionId: session.id,
+ *   email: session.customer_details?.email || '',
+ *   items: JSON.parse(session.metadata?.items || '[]'),
+ *   subtotal: session.amount_subtotal || 0,
+ *   // ... other params
+ * })
+ * ```
+ */
+async function createOrderFromCheckout(params) {
+    // Idempotency check: don't create duplicate orders
+    const existingOrder = await (0, queries_1.findOrderByPaymentIntent)(params.stripePaymentIntentId);
+    if (existingOrder) {
+        console.log('[Order] Order already exists for payment intent:', params.stripePaymentIntentId);
+        return { orderId: existingOrder.id, isNew: false };
+    }
+    // Create the order
+    const order = await (0, queries_1.createOrder)({
+        email: params.email,
+        status: 'paid',
+        subtotal: centsToDecimal(params.subtotal),
+        tax: centsToDecimal(params.tax),
+        shipping: centsToDecimal(params.shipping),
+        total: centsToDecimal(params.total),
+        shippingAddress: params.shippingAddress,
+        billingAddress: params.billingAddress,
+        stripePaymentIntentId: params.stripePaymentIntentId,
+        customerId: params.customerId, // Customer ID if authenticated, undefined for guest
+    });
+    // Create order items
+    if (params.items.length > 0) {
+        const orderItems = params.items.map((item) => ({
+            orderId: order.id,
+            productId: item.productId || generatePlaceholderId(),
+            variantId: item.variantId,
+            name: item.name,
+            price: centsToDecimal(item.price),
+            quantity: item.quantity,
+            attributes: item.attributes,
+        }));
+        await (0, queries_1.createOrderItems)(orderItems);
+    }
+    console.log('[Order] Created order:', order.id, 'for session:', params.sessionId);
+    return { orderId: order.id, isNew: true };
+}
+// =============================================================================
+// Order from Stripe Session
+// =============================================================================
+/**
+ * Extract order parameters from a Stripe Checkout Session.
+ * Used to convert Stripe's session object to our CreateOrderParams.
+ */
+function extractOrderParamsFromSession(session) {
+    // Parse items from metadata
+    const items = session.metadata?.items
+        ? (0, create_checkout_session_1.deserializeItemsFromMetadata)(session.metadata.items)
+        : extractItemsFromLineItems(session.line_items?.data);
+    // Extract shipping address
+    // Note: In Stripe API v20+, shipping is accessed via collected_information or shipping_details
+    const shippingInfo = session.shipping_details;
+    const shippingAddress = parseStripeAddress(shippingInfo?.address, shippingInfo?.name);
+    // Extract billing address (if different)
+    const billingAddress = session.customer_details?.address
+        ? parseStripeAddress(session.customer_details.address, session.customer_details.name || undefined)
+        : undefined;
+    return {
+        sessionId: session.id,
+        email: session.customer_details?.email || session.customer_email || '',
+        items,
+        subtotal: session.amount_subtotal || 0,
+        tax: session.total_details?.amount_tax || 0,
+        shipping: session.total_details?.amount_shipping || 0,
+        total: session.amount_total || 0,
+        shippingAddress,
+        billingAddress,
+        stripePaymentIntentId: typeof session.payment_intent === 'string'
+            ? session.payment_intent
+            : session.payment_intent?.id || '',
+        stripeCustomerId: typeof session.customer === 'string'
+            ? session.customer
+            : session.customer?.id,
+        // Extract customer ID from metadata (for authenticated checkout)
+        customerId: session.metadata?.customerId,
+    };
+}
+// =============================================================================
+// Refund Handling
+// =============================================================================
+/**
+ * Handle a refund event from Stripe.
+ * Updates the order status to 'refunded'.
+ */
+async function handleRefund(paymentIntentId, refundAmount, totalAmount) {
+    const order = await (0, queries_1.findOrderByPaymentIntent)(paymentIntentId);
+    if (!order) {
+        console.warn('[Order] No order found for refund:', paymentIntentId);
+        return;
+    }
+    // Check if full or partial refund
+    const isFullRefund = refundAmount >= totalAmount;
+    if (isFullRefund) {
+        await (0, queries_1.updateOrderStatus)(order.id, 'refunded');
+        console.log('[Order] Order refunded:', order.id);
+    }
+    else {
+        // For partial refunds, we could track this separately
+        // For MVP, we just log it
+        console.log('[Order] Partial refund processed:', order.id, `$${refundAmount / 100} of $${totalAmount / 100}`);
+    }
+}
+// =============================================================================
+// Helpers
+// =============================================================================
+/**
+ * Convert cents to decimal string for database storage.
+ * Stripe uses cents (integer), our database uses decimal.
+ */
+function centsToDecimal(cents) {
+    return (cents / 100).toFixed(2);
+}
+/**
+ * Parse Stripe address to our Address type.
+ */
+function parseStripeAddress(stripeAddress, name) {
+    if (!stripeAddress) {
+        return {
+            firstName: '',
+            lastName: '',
+            line1: '',
+            city: '',
+            state: '',
+            postalCode: '',
+            country: '',
+        };
+    }
+    // Parse name into first/last
+    const [firstName, ...lastParts] = (name || '').split(' ');
+    const lastName = lastParts.join(' ');
+    return {
+        firstName: firstName || '',
+        lastName: lastName || '',
+        line1: stripeAddress.line1 || '',
+        line2: stripeAddress.line2 || undefined,
+        city: stripeAddress.city || '',
+        state: stripeAddress.state || '',
+        postalCode: stripeAddress.postal_code || '',
+        country: stripeAddress.country || '',
+    };
+}
+/**
+ * Extract items from Stripe line items (fallback if metadata parsing fails).
+ */
+function extractItemsFromLineItems(lineItems) {
+    if (!lineItems)
+        return [];
+    return lineItems.map((item) => ({
+        name: item.description || 'Product',
+        price: item.amount_total || 0,
+        quantity: item.quantity || 1,
+    }));
+}
+/**
+ * Generate a placeholder product ID for orders without product tracking.
+ * This ensures we can always create order items.
+ */
+function generatePlaceholderId() {
+    return `guest-${Date.now()}-${Math.random().toString(36).substring(2, 9)}`;
+}
+//# sourceMappingURL=order-service.js.map

package/dist/checkout/server/order-service.js.map

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

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

@@ -0,0 +1,72 @@
+/**
+ * @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.
+ * Default is US and CA if not configured.
+ */
+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

@@ -0,0 +1 @@
+{"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;;;GAGG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,EAAE,CAQtD;AAMD;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAY1C"}

package/dist/checkout/stripe/client.js

@@ -0,0 +1,189 @@
+"use strict";
+/**
+ * @rovela/sdk/checkout/stripe/client
+ *
+ * Stripe SDK initialization for server-side operations.
+ * Uses Direct Charges with connected accounts.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getStripe = getStripe;
+exports.getConnectedAccountId = getConnectedAccountId;
+exports.hasConnectedAccount = hasConnectedAccount;
+exports.getPlatformFeePercent = getPlatformFeePercent;
+exports.calculateApplicationFee = calculateApplicationFee;
+exports.getWebhookSecret = getWebhookSecret;
+exports.getConnectWebhookSecret = getConnectWebhookSecret;
+exports.getAllWebhookSecrets = getAllWebhookSecrets;
+exports.getStoreCurrency = getStoreCurrency;
+exports.getAllowedShippingCountries = getAllowedShippingCountries;
+exports.getPublishableKey = getPublishableKey;
+const stripe_1 = __importDefault(require("stripe"));
+// =============================================================================
+// Singleton Stripe Client
+// =============================================================================
+let stripeClient = null;
+/**
+ * Get the Stripe client instance (server-side).
+ * Lazily initialized on first use.
+ *
+ * @throws Error if STRIPE_SECRET_KEY is not set
+ */
+function getStripe() {
+    if (!stripeClient) {
+        const secretKey = process.env.STRIPE_SECRET_KEY;
+        if (!secretKey) {
+            throw new Error('STRIPE_SECRET_KEY environment variable is not set. ' +
+                'Please add your Stripe secret key to .env.local:\n' +
+                'STRIPE_SECRET_KEY=sk_test_xxx');
+        }
+        stripeClient = new stripe_1.default(secretKey, {
+            // Use the latest API version for best compatibility
+            apiVersion: '2025-11-17.clover',
+            typescript: true,
+            // Telemetry helps Stripe improve the SDK
+            telemetry: true,
+        });
+    }
+    return stripeClient;
+}
+// =============================================================================
+// Connected Account
+// =============================================================================
+/**
+ * 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
+ */
+function getConnectedAccountId() {
+    const accountId = process.env.STRIPE_CONNECTED_ACCOUNT_ID;
+    if (!accountId) {
+        throw new Error('STRIPE_CONNECTED_ACCOUNT_ID environment variable is not set. ' +
+            'The store owner must complete Stripe onboarding before accepting payments.\n' +
+            'Set STRIPE_CONNECTED_ACCOUNT_ID=acct_xxx in .env.local');
+    }
+    return accountId;
+}
+/**
+ * Check if the store has a connected Stripe account.
+ * Use this to conditionally show checkout UI.
+ */
+function hasConnectedAccount() {
+    return !!process.env.STRIPE_CONNECTED_ACCOUNT_ID;
+}
+// =============================================================================
+// Platform Configuration
+// =============================================================================
+/**
+ * Get the platform fee percentage for transactions.
+ * Default is 5% if not configured.
+ */
+function getPlatformFeePercent() {
+    const feePercent = process.env.STRIPE_PLATFORM_FEE_PERCENT;
+    if (!feePercent) {
+        return 5; // Default 5% platform fee
+    }
+    const parsed = parseFloat(feePercent);
+    if (isNaN(parsed) || parsed < 0 || parsed > 100) {
+        console.warn(`Invalid STRIPE_PLATFORM_FEE_PERCENT: ${feePercent}. Using default 5%.`);
+        return 5;
+    }
+    return parsed;
+}
+/**
+ * Calculate the application fee amount in cents.
+ *
+ * @param amountInCents - The total transaction amount in cents
+ * @returns The application fee in cents (rounded)
+ */
+function calculateApplicationFee(amountInCents) {
+    const feePercent = getPlatformFeePercent();
+    return Math.round(amountInCents * (feePercent / 100));
+}
+// =============================================================================
+// Webhook Configuration
+// =============================================================================
+/**
+ * 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
+ */
+function getWebhookSecret() {
+    const secret = process.env.STRIPE_WEBHOOK_SECRET;
+    if (!secret) {
+        throw new Error('STRIPE_WEBHOOK_SECRET environment variable is not set. ' +
+            'Please add your Stripe webhook signing secret to .env.local:\n' +
+            'STRIPE_WEBHOOK_SECRET=whsec_xxx');
+    }
+    return secret;
+}
+/**
+ * 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.
+ */
+function getConnectWebhookSecret() {
+    return process.env.STRIPE_CONNECT_WEBHOOK_SECRET || null;
+}
+/**
+ * Get all webhook secrets to try during verification.
+ * Returns array of secrets to attempt (primary first, then connect).
+ */
+function getAllWebhookSecrets() {
+    const secrets = [];
+    const primarySecret = process.env.STRIPE_WEBHOOK_SECRET;
+    if (primarySecret) {
+        secrets.push(primarySecret);
+    }
+    const connectSecret = process.env.STRIPE_CONNECT_WEBHOOK_SECRET;
+    if (connectSecret && connectSecret !== primarySecret) {
+        secrets.push(connectSecret);
+    }
+    if (secrets.length === 0) {
+        throw new Error('No webhook secrets configured. ' +
+            'Please add STRIPE_WEBHOOK_SECRET and/or STRIPE_CONNECT_WEBHOOK_SECRET to .env.local');
+    }
+    return secrets;
+}
+// =============================================================================
+// Store Configuration
+// =============================================================================
+/**
+ * Get the store's currency code.
+ * Default is USD if not configured.
+ */
+function getStoreCurrency() {
+    return process.env.STORE_CURRENCY || 'usd';
+}
+/**
+ * Get allowed countries for shipping.
+ * Default is US and CA if not configured.
+ */
+function getAllowedShippingCountries() {
+    const countries = process.env.SHIPPING_COUNTRIES;
+    if (!countries) {
+        return ['US', 'CA']; // Default to US and Canada
+    }
+    return countries.split(',').map((c) => c.trim().toUpperCase());
+}
+// =============================================================================
+// Client-side Stripe
+// =============================================================================
+/**
+ * Get the publishable key for client-side Stripe.js
+ * This is safe to expose to the browser.
+ */
+function getPublishableKey() {
+    const key = process.env.NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY;
+    if (!key) {
+        throw new Error('NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY environment variable is not set. ' +
+            'Please add your Stripe publishable key to .env.local:\n' +
+            'NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY=pk_test_xxx');
+    }
+    return key;
+}
+//# sourceMappingURL=client.js.map

package/dist/checkout/stripe/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../../src/checkout/stripe/client.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;AAgBH,8BAsBC;AAYD,sDAYC;AAMD,kDAEC;AAUD,sDAgBC;AAQD,0DAGC;AAYD,4CAYC;AAOD,0DAEC;AAMD,oDAqBC;AAUD,4CAEC;AAMD,kEAQC;AAUD,8CAYC;AArND,oDAA2B;AAE3B,gFAAgF;AAChF,0BAA0B;AAC1B,gFAAgF;AAEhF,IAAI,YAAY,GAAkB,IAAI,CAAA;AAEtC;;;;;GAKG;AACH,SAAgB,SAAS;IACvB,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAA;QAE/C,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACb,qDAAqD;gBACnD,oDAAoD;gBACpD,+BAA+B,CAClC,CAAA;QACH,CAAC;QAED,YAAY,GAAG,IAAI,gBAAM,CAAC,SAAS,EAAE;YACnC,oDAAoD;YACpD,UAAU,EAAE,mBAAmB;YAC/B,UAAU,EAAE,IAAI;YAChB,yCAAyC;YACzC,SAAS,EAAE,IAAI;SAChB,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,YAAY,CAAA;AACrB,CAAC;AAED,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAEhF;;;;;GAKG;AACH,SAAgB,qBAAqB;IACnC,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAA;IAEzD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,+DAA+D;YAC3D,8EAA8E;YAC9E,wDAAwD,CAC7D,CAAA;IACH,CAAC;IAED,OAAO,SAAS,CAAA;AAClB,CAAC;AAED;;;GAGG;AACH,SAAgB,mBAAmB;IACjC,OAAO,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAA;AAClD,CAAC;AAED,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF;AAEhF;;;GAGG;AACH,SAAgB,qBAAqB;IACnC,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,2BAA2B,CAAA;IAE1D,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,CAAC,CAAA,CAAC,0BAA0B;IACrC,CAAC;IAED,MAAM,MAAM,GAAG,UAAU,CAAC,UAAU,CAAC,CAAA;IACrC,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,IAAI,MAAM,GAAG,GAAG,EAAE,CAAC;QAChD,OAAO,CAAC,IAAI,CACV,wCAAwC,UAAU,qBAAqB,CACxE,CAAA;QACD,OAAO,CAAC,CAAA;IACV,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;;GAKG;AACH,SAAgB,uBAAuB,CAAC,aAAqB;IAC3D,MAAM,UAAU,GAAG,qBAAqB,EAAE,CAAA;IAC1C,OAAO,IAAI,CAAC,KAAK,CAAC,aAAa,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,CAAA;AACvD,CAAC;AAED,gFAAgF;AAChF,wBAAwB;AACxB,gFAAgF;AAEhF;;;;;GAKG;AACH,SAAgB,gBAAgB;IAC9B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAA;IAEhD,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CACb,yDAAyD;YACrD,gEAAgE;YAChE,iCAAiC,CACtC,CAAA;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;GAIG;AACH,SAAgB,uBAAuB;IACrC,OAAO,OAAO,CAAC,GAAG,CAAC,6BAA6B,IAAI,IAAI,CAAA;AAC1D,CAAC;AAED;;;GAGG;AACH,SAAgB,oBAAoB;IAClC,MAAM,OAAO,GAAa,EAAE,CAAA;IAE5B,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAA;IACvD,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;IAC7B,CAAC;IAED,MAAM,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAA;IAC/D,IAAI,aAAa,IAAI,aAAa,KAAK,aAAa,EAAE,CAAC;QACrD,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAAA;IAC7B,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACb,iCAAiC;YAC7B,qFAAqF,CAC1F,CAAA;IACH,CAAC;IAED,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,gFAAgF;AAChF,sBAAsB;AACtB,gFAAgF;AAEhF;;;GAGG;AACH,SAAgB,gBAAgB;IAC9B,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,KAAK,CAAA;AAC5C,CAAC;AAED;;;GAGG;AACH,SAAgB,2BAA2B;IACzC,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAA;IAEhD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA,CAAC,2BAA2B;IACjD,CAAC;IAED,OAAO,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAA;AAChE,CAAC;AAED,gFAAgF;AAChF,qBAAqB;AACrB,gFAAgF;AAEhF;;;GAGG;AACH,SAAgB,iBAAiB;IAC/B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAA;IAE1D,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,sEAAsE;YAClE,yDAAyD;YACzD,gDAAgD,CACrD,CAAA;IACH,CAAC;IAED,OAAO,GAAG,CAAA;AACZ,CAAC"}

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

@@ -0,0 +1,7 @@
+/**
+ * @rovela/sdk/checkout/stripe
+ *
+ * Stripe client and configuration exports
+ */
+export { getStripe, getConnectedAccountId, hasConnectedAccount, getPlatformFeePercent, calculateApplicationFee, getWebhookSecret, getConnectWebhookSecret, getAllWebhookSecrets, getStoreCurrency, getAllowedShippingCountries, getPublishableKey, } from './client';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/checkout/stripe/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,SAAS,EACT,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,uBAAuB,EACvB,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,EACpB,gBAAgB,EAChB,2BAA2B,EAC3B,iBAAiB,GAClB,MAAM,UAAU,CAAA"}

package/dist/checkout/stripe/index.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * @rovela/sdk/checkout/stripe
+ *
+ * Stripe client and configuration exports
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPublishableKey = exports.getAllowedShippingCountries = exports.getStoreCurrency = exports.getAllWebhookSecrets = exports.getConnectWebhookSecret = exports.getWebhookSecret = exports.calculateApplicationFee = exports.getPlatformFeePercent = exports.hasConnectedAccount = exports.getConnectedAccountId = exports.getStripe = void 0;
+var client_1 = require("./client");
+Object.defineProperty(exports, "getStripe", { enumerable: true, get: function () { return client_1.getStripe; } });
+Object.defineProperty(exports, "getConnectedAccountId", { enumerable: true, get: function () { return client_1.getConnectedAccountId; } });
+Object.defineProperty(exports, "hasConnectedAccount", { enumerable: true, get: function () { return client_1.hasConnectedAccount; } });
+Object.defineProperty(exports, "getPlatformFeePercent", { enumerable: true, get: function () { return client_1.getPlatformFeePercent; } });
+Object.defineProperty(exports, "calculateApplicationFee", { enumerable: true, get: function () { return client_1.calculateApplicationFee; } });
+Object.defineProperty(exports, "getWebhookSecret", { enumerable: true, get: function () { return client_1.getWebhookSecret; } });
+Object.defineProperty(exports, "getConnectWebhookSecret", { enumerable: true, get: function () { return client_1.getConnectWebhookSecret; } });
+Object.defineProperty(exports, "getAllWebhookSecrets", { enumerable: true, get: function () { return client_1.getAllWebhookSecrets; } });
+Object.defineProperty(exports, "getStoreCurrency", { enumerable: true, get: function () { return client_1.getStoreCurrency; } });
+Object.defineProperty(exports, "getAllowedShippingCountries", { enumerable: true, get: function () { return client_1.getAllowedShippingCountries; } });
+Object.defineProperty(exports, "getPublishableKey", { enumerable: true, get: function () { return client_1.getPublishableKey; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/checkout/stripe/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,mCAYiB;AAXf,mGAAA,SAAS,OAAA;AACT,+GAAA,qBAAqB,OAAA;AACrB,6GAAA,mBAAmB,OAAA;AACnB,+GAAA,qBAAqB,OAAA;AACrB,iHAAA,uBAAuB,OAAA;AACvB,0GAAA,gBAAgB,OAAA;AAChB,iHAAA,uBAAuB,OAAA;AACvB,8GAAA,oBAAoB,OAAA;AACpB,0GAAA,gBAAgB,OAAA;AAChB,qHAAA,2BAA2B,OAAA;AAC3B,2GAAA,iBAAiB,OAAA"}