@rovela-ai/sdk 0.1.2 → 0.1.4

package/dist/checkout/server/create-checkout-session.js

@@ -0,0 +1,190 @@
+"use strict";
+/**
+ * @rovela/sdk/checkout/server/create-checkout-session
+ *
+ * Creates a Stripe Checkout session using Direct Charges.
+ * The payment is processed ON the connected account, not the platform.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCheckoutSession = createCheckoutSession;
+exports.deserializeItemsFromMetadata = deserializeItemsFromMetadata;
+exports.getCheckoutSession = getCheckoutSession;
+const client_1 = require("../stripe/client");
+// =============================================================================
+// Main Function
+// =============================================================================
+/**
+ * Create a Stripe Checkout session for Direct Charges.
+ *
+ * This creates the checkout session ON the connected account (Direct Charge),
+ * meaning the payment shows up in the connected account's dashboard, and
+ * the application fee is transferred to the platform.
+ *
+ * @example
+ * ```typescript
+ * const session = await createCheckoutSession({
+ *   items: [
+ *     { name: 'T-Shirt', price: 2999, quantity: 1 }
+ *   ],
+ *   customerEmail: 'customer@example.com',
+ *   successUrl: 'https://store.example.com/success?session_id={CHECKOUT_SESSION_ID}',
+ *   cancelUrl: 'https://store.example.com/cart',
+ * })
+ *
+ * // Redirect customer to Stripe Checkout
+ * redirect(session.url)
+ * ```
+ */
+async function createCheckoutSession(request, options = {}) {
+    const stripe = (0, client_1.getStripe)();
+    const connectedAccountId = (0, client_1.getConnectedAccountId)();
+    const currency = (0, client_1.getStoreCurrency)();
+    const { collectShippingAddress = true, collectPhoneNumber = false, allowPromotionCodes = false, automaticTax = false, applicationFeeAmount, } = options;
+    // Validate request
+    if (!request.items || request.items.length === 0) {
+        throw new Error('No items provided for checkout');
+    }
+    if (!request.successUrl || !request.cancelUrl) {
+        throw new Error('Success and cancel URLs are required');
+    }
+    // Calculate subtotal and application fee
+    const subtotal = request.items.reduce((sum, item) => sum + item.price * item.quantity, 0);
+    const appFee = applicationFeeAmount ?? (0, client_1.calculateApplicationFee)(subtotal);
+    // Build line items for Stripe
+    const lineItems = request.items.map((item) => ({
+        price_data: {
+            currency,
+            product_data: {
+                name: item.name,
+                description: item.description,
+                images: item.image ? [item.image] : undefined,
+                metadata: {
+                    productId: item.productId || '',
+                    variantId: item.variantId || '',
+                },
+            },
+            unit_amount: item.price,
+        },
+        quantity: item.quantity,
+    }));
+    // Build session parameters
+    const sessionParams = {
+        mode: 'payment',
+        line_items: lineItems,
+        payment_intent_data: {
+            // Application fee goes to the platform (Rovela)
+            application_fee_amount: appFee,
+            // Metadata for the payment intent
+            metadata: {
+                rovela_platform: 'true',
+                ...request.metadata,
+            },
+        },
+        success_url: request.successUrl,
+        cancel_url: request.cancelUrl,
+        // Store metadata on the session
+        metadata: {
+            // Store items as JSON for order creation in webhook
+            items: JSON.stringify(serializeItemsForMetadata(request.items)),
+            // Store customer ID for authenticated checkout
+            ...(request.customerId && { customerId: request.customerId }),
+            ...request.metadata,
+        },
+    };
+    // Add customer email if provided
+    if (request.customerEmail) {
+        sessionParams.customer_email = request.customerEmail;
+    }
+    // Collect shipping address if enabled
+    if (collectShippingAddress) {
+        sessionParams.shipping_address_collection = {
+            allowed_countries: (0, client_1.getAllowedShippingCountries)(),
+        };
+    }
+    // Collect phone number if enabled
+    if (collectPhoneNumber) {
+        sessionParams.phone_number_collection = {
+            enabled: true,
+        };
+    }
+    // Allow promotion codes if enabled
+    if (allowPromotionCodes) {
+        sessionParams.allow_promotion_codes = true;
+    }
+    // Enable automatic tax if configured
+    if (automaticTax) {
+        sessionParams.automatic_tax = {
+            enabled: true,
+        };
+    }
+    // Create the session ON the connected account (Direct Charge)
+    const session = await stripe.checkout.sessions.create(sessionParams, {
+        stripeAccount: connectedAccountId,
+    });
+    if (!session.url) {
+        throw new Error('Failed to create checkout session: no URL returned');
+    }
+    return {
+        sessionId: session.id,
+        url: session.url,
+    };
+}
+// =============================================================================
+// Helpers
+// =============================================================================
+/**
+ * Serialize items for storing in Stripe metadata.
+ * Metadata has a 500 character limit per value.
+ */
+function serializeItemsForMetadata(items) {
+    return items.map((item) => ({
+        pid: item.productId,
+        vid: item.variantId,
+        n: item.name.substring(0, 100), // Limit name length
+        p: item.price,
+        q: item.quantity,
+    }));
+}
+/**
+ * Deserialize items from Stripe metadata.
+ */
+function deserializeItemsFromMetadata(json) {
+    try {
+        const items = JSON.parse(json);
+        return items.map((item) => ({
+            productId: item.pid,
+            variantId: item.vid,
+            name: item.n,
+            price: item.p,
+            quantity: item.q,
+        }));
+    }
+    catch {
+        console.error('[Checkout] Failed to parse items from metadata:', json);
+        return [];
+    }
+}
+// =============================================================================
+// Session Retrieval
+// =============================================================================
+/**
+ * Retrieve a checkout session by ID.
+ * Useful for the success page to get order details.
+ */
+async function getCheckoutSession(sessionId) {
+    const stripe = (0, client_1.getStripe)();
+    const connectedAccountId = (0, client_1.getConnectedAccountId)();
+    try {
+        const session = await stripe.checkout.sessions.retrieve(sessionId, {
+            expand: ['line_items', 'payment_intent', 'customer'],
+        }, {
+            stripeAccount: connectedAccountId,
+        });
+        return session;
+    }
+    catch (error) {
+        console.error('[Checkout] Failed to retrieve session:', error);
+        return null;
+    }
+}
+//# sourceMappingURL=create-checkout-session.js.map

package/dist/checkout/server/create-checkout-session.js.map

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

package/dist/checkout/server/handle-webhook.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @rovela/sdk/checkout/server/handle-webhook
+ *
+ * Stripe webhook handler for processing payment events.
+ * Handles events from both the platform account and connected accounts.
+ */
+import type { WebhookResult } from '../types';
+/**
+ * Handle incoming Stripe webhook events.
+ *
+ * This function:
+ * 1. Verifies the webhook signature (tries both account and connect secrets)
+ * 2. Parses the event
+ * 3. Routes to the appropriate handler
+ * 4. Returns the result
+ *
+ * Supports dual webhook endpoints:
+ * - STRIPE_WEBHOOK_SECRET: For platform account events (account.updated)
+ * - STRIPE_CONNECT_WEBHOOK_SECRET: For connected account events (checkout.*, payment_intent.*, charge.*)
+ *
+ * @example
+ * ```typescript
+ * // In app/api/webhooks/stripe/route.ts
+ * 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)
+ * }
+ * ```
+ */
+export declare function handleStripeWebhook(payload: string | Buffer, signature: string): Promise<WebhookResult>;
+//# sourceMappingURL=handle-webhook.d.ts.map

package/dist/checkout/server/handle-webhook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-webhook.d.ts","sourceRoot":"","sources":["../../../src/checkout/server/handle-webhook.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAc7C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,aAAa,CAAC,CAmDxB"}

package/dist/checkout/server/handle-webhook.js

@@ -0,0 +1,279 @@
+"use strict";
+/**
+ * @rovela/sdk/checkout/server/handle-webhook
+ *
+ * Stripe webhook handler for processing payment events.
+ * Handles events from both the platform account and connected accounts.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleStripeWebhook = handleStripeWebhook;
+const client_1 = require("../stripe/client");
+const order_service_1 = require("./order-service");
+const emails_1 = require("../../emails");
+// =============================================================================
+// Main Webhook Handler
+// =============================================================================
+/**
+ * Handle incoming Stripe webhook events.
+ *
+ * This function:
+ * 1. Verifies the webhook signature (tries both account and connect secrets)
+ * 2. Parses the event
+ * 3. Routes to the appropriate handler
+ * 4. Returns the result
+ *
+ * Supports dual webhook endpoints:
+ * - STRIPE_WEBHOOK_SECRET: For platform account events (account.updated)
+ * - STRIPE_CONNECT_WEBHOOK_SECRET: For connected account events (checkout.*, payment_intent.*, charge.*)
+ *
+ * @example
+ * ```typescript
+ * // In app/api/webhooks/stripe/route.ts
+ * 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)
+ * }
+ * ```
+ */
+async function handleStripeWebhook(payload, signature) {
+    const stripe = (0, client_1.getStripe)();
+    const webhookSecrets = (0, client_1.getAllWebhookSecrets)();
+    // Try to verify with each webhook secret
+    // This handles both account webhooks and connect webhooks
+    let event = null;
+    let lastError = null;
+    for (const secret of webhookSecrets) {
+        try {
+            event = stripe.webhooks.constructEvent(payload, signature, secret);
+            // Successfully verified with this secret
+            break;
+        }
+        catch (err) {
+            lastError = err instanceof Error ? err : new Error('Unknown error');
+            // Try next secret
+            continue;
+        }
+    }
+    if (!event) {
+        const message = lastError?.message || 'Unknown signature error';
+        console.error('[Webhook] Signature verification failed with all secrets:', message);
+        return {
+            received: false,
+            error: `Webhook signature verification failed: ${message}`,
+        };
+    }
+    // Log the event for debugging
+    console.log('[Webhook] Received event:', event.type, 'from account:', event.account || 'platform');
+    // Route to appropriate handler
+    try {
+        const result = await routeWebhookEvent(event);
+        return result;
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Unknown error';
+        console.error('[Webhook] Error processing event:', event.type, message);
+        return {
+            received: true,
+            event: event.type,
+            error: message,
+        };
+    }
+}
+// =============================================================================
+// Event Routing
+// =============================================================================
+/**
+ * Route webhook event to the appropriate handler.
+ */
+async function routeWebhookEvent(event) {
+    switch (event.type) {
+        // Checkout Events
+        case 'checkout.session.completed':
+            return handleCheckoutSessionCompleted(event.data.object);
+        case 'checkout.session.expired':
+            return handleCheckoutSessionExpired(event.data.object);
+        // Payment Events
+        case 'payment_intent.succeeded':
+            return handlePaymentIntentSucceeded(event.data.object);
+        case 'payment_intent.payment_failed':
+            return handlePaymentIntentFailed(event.data.object);
+        // Refund Events
+        case 'charge.refunded':
+            return handleChargeRefunded(event.data.object);
+        // Account Events (for monitoring)
+        case 'account.updated':
+            return handleAccountUpdated(event.data.object);
+        // Unhandled events - acknowledge receipt
+        default:
+            console.log('[Webhook] Unhandled event type:', event.type);
+            return { received: true, event: event.type };
+    }
+}
+// =============================================================================
+// Checkout Event Handlers
+// =============================================================================
+/**
+ * Handle successful checkout session completion.
+ * This is the primary event for creating orders.
+ */
+async function handleCheckoutSessionCompleted(session) {
+    console.log('[Webhook] Checkout completed:', session.id);
+    // Only process completed payment sessions
+    if (session.payment_status !== 'paid') {
+        console.log('[Webhook] Skipping - payment status:', session.payment_status);
+        return { received: true, event: 'checkout.session.completed' };
+    }
+    // Extract order parameters from session
+    const orderParams = (0, order_service_1.extractOrderParamsFromSession)(session);
+    // Create the order
+    const { orderId, isNew } = await (0, order_service_1.createOrderFromCheckout)(orderParams);
+    console.log('[Webhook] Order', isNew ? 'created' : 'already exists', orderId);
+    // Send order confirmation email (fire-and-forget, don't block webhook response)
+    if (isNew && orderParams.email) {
+        sendOrderConfirmationEmail(orderId, orderParams, session);
+    }
+    return {
+        received: true,
+        event: 'checkout.session.completed',
+        orderId,
+    };
+}
+/**
+ * Handle expired checkout session.
+ * Used for cleanup and analytics.
+ */
+async function handleCheckoutSessionExpired(session) {
+    console.log('[Webhook] Checkout expired:', session.id);
+    // Could be used for:
+    // - Cart abandonment tracking
+    // - Sending recovery emails
+    // - Analytics
+    return { received: true, event: 'checkout.session.expired' };
+}
+// =============================================================================
+// Payment Event Handlers
+// =============================================================================
+/**
+ * Handle successful payment intent.
+ * This is a backup to checkout.session.completed.
+ */
+async function handlePaymentIntentSucceeded(paymentIntent) {
+    console.log('[Webhook] Payment succeeded:', paymentIntent.id);
+    // Payment intent success is already handled by checkout.session.completed
+    // This is here as a backup and for logging
+    return { received: true, event: 'payment_intent.succeeded' };
+}
+/**
+ * Handle failed payment intent.
+ * Used for logging and potential notification.
+ */
+async function handlePaymentIntentFailed(paymentIntent) {
+    console.log('[Webhook] Payment failed:', paymentIntent.id, paymentIntent.last_payment_error?.message);
+    // Could be used for:
+    // - Alerting store owner
+    // - Customer notification
+    // - Analytics
+    return { received: true, event: 'payment_intent.payment_failed' };
+}
+// =============================================================================
+// Refund Event Handlers
+// =============================================================================
+/**
+ * Handle charge refund.
+ * Updates order status when a refund is processed.
+ */
+async function handleChargeRefunded(charge) {
+    console.log('[Webhook] Charge refunded:', charge.id);
+    const paymentIntentId = typeof charge.payment_intent === 'string'
+        ? charge.payment_intent
+        : charge.payment_intent?.id;
+    if (paymentIntentId) {
+        await (0, order_service_1.handleRefund)(paymentIntentId, charge.amount_refunded, charge.amount);
+    }
+    return { received: true, event: 'charge.refunded' };
+}
+// =============================================================================
+// Account Event Handlers
+// =============================================================================
+/**
+ * Handle connected account updates.
+ * Used to monitor account status.
+ */
+async function handleAccountUpdated(account) {
+    console.log('[Webhook] Account updated:', account.id);
+    console.log('  - Charges enabled:', account.charges_enabled);
+    console.log('  - Payouts enabled:', account.payouts_enabled);
+    console.log('  - Details submitted:', account.details_submitted);
+    // Could be used for:
+    // - Updating store status when account is verified
+    // - Notifying platform when account has issues
+    // - Blocking checkout if account is disabled
+    return { received: true, event: 'account.updated' };
+}
+/**
+ * Send order confirmation email after checkout completion.
+ * This is fire-and-forget - errors are logged but don't block the webhook.
+ */
+function sendOrderConfirmationEmail(orderId, params, session) {
+    // Extract customer name from session or email
+    const customerName = session.customer_details?.name ||
+        params.email.split('@')[0] ||
+        'Customer';
+    // Convert order items to email format
+    const items = params.items.map((item) => ({
+        name: item.name,
+        quantity: item.quantity,
+        price: (0, emails_1.formatPrice)(item.price), // Convert cents to formatted price
+        imageUrl: item.image, // Note: CheckoutLineItem uses 'image' not 'imageUrl'
+    }));
+    // Convert shipping address to email format
+    const shippingAddress = {
+        name: session.customer_details?.name || customerName,
+        line1: params.shippingAddress.line1,
+        line2: params.shippingAddress.line2,
+        city: params.shippingAddress.city,
+        state: params.shippingAddress.state,
+        postalCode: params.shippingAddress.postalCode,
+        country: params.shippingAddress.country,
+    };
+    // Build order tracking URL (store can customize this)
+    const storeUrl = process.env.NEXT_PUBLIC_APP_URL || '';
+    const orderTrackingUrl = `${storeUrl}/account/orders/${orderId}`;
+    (0, emails_1.sendOrderConfirmationAsync)({
+        to: params.email,
+        customerName,
+        orderNumber: (0, emails_1.formatOrderNumber)(orderId),
+        orderDate: (0, emails_1.formatDate)(new Date()),
+        paymentStatus: 'Paid',
+        items,
+        subtotal: (0, emails_1.formatPrice)(params.subtotal),
+        shippingCost: params.shipping > 0 ? (0, emails_1.formatPrice)(params.shipping) : 'Free',
+        tax: (0, emails_1.formatPrice)(params.tax),
+        total: (0, emails_1.formatPrice)(params.total),
+        shippingAddress,
+        orderTrackingUrl,
+    });
+    console.log('[Webhook] Order confirmation email queued for:', params.email);
+}
+/**
+ * Send refund processed email.
+ * This is fire-and-forget - errors are logged but don't block the webhook.
+ */
+function sendRefundEmail(email, customerName, orderNumber, refundAmount, paymentMethod) {
+    (0, emails_1.sendRefundProcessedAsync)({
+        to: email,
+        customerName,
+        orderNumber: (0, emails_1.formatOrderNumber)(orderNumber),
+        refundAmount: (0, emails_1.formatPrice)(refundAmount),
+        refundDate: (0, emails_1.formatDate)(new Date()),
+        paymentMethod,
+        estimatedArrival: '5-10 business days',
+        businessDays: '5-10',
+    });
+    console.log('[Webhook] Refund email queued for:', email);
+}
+//# sourceMappingURL=handle-webhook.js.map

package/dist/checkout/server/handle-webhook.js.map

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

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

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

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

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

package/dist/checkout/server/index.js

@@ -0,0 +1,19 @@
+"use strict";
+/**
+ * @rovela/sdk/checkout/server
+ *
+ * Server-side checkout functions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleRefund = exports.extractOrderParamsFromSession = exports.createOrderFromCheckout = exports.handleStripeWebhook = exports.deserializeItemsFromMetadata = exports.getCheckoutSession = exports.createCheckoutSession = void 0;
+var create_checkout_session_1 = require("./create-checkout-session");
+Object.defineProperty(exports, "createCheckoutSession", { enumerable: true, get: function () { return create_checkout_session_1.createCheckoutSession; } });
+Object.defineProperty(exports, "getCheckoutSession", { enumerable: true, get: function () { return create_checkout_session_1.getCheckoutSession; } });
+Object.defineProperty(exports, "deserializeItemsFromMetadata", { enumerable: true, get: function () { return create_checkout_session_1.deserializeItemsFromMetadata; } });
+var handle_webhook_1 = require("./handle-webhook");
+Object.defineProperty(exports, "handleStripeWebhook", { enumerable: true, get: function () { return handle_webhook_1.handleStripeWebhook; } });
+var order_service_1 = require("./order-service");
+Object.defineProperty(exports, "createOrderFromCheckout", { enumerable: true, get: function () { return order_service_1.createOrderFromCheckout; } });
+Object.defineProperty(exports, "extractOrderParamsFromSession", { enumerable: true, get: function () { return order_service_1.extractOrderParamsFromSession; } });
+Object.defineProperty(exports, "handleRefund", { enumerable: true, get: function () { return order_service_1.handleRefund; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/checkout/server/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,qEAIkC;AAHhC,gIAAA,qBAAqB,OAAA;AACrB,6HAAA,kBAAkB,OAAA;AAClB,uIAAA,4BAA4B,OAAA;AAK9B,mDAAsD;AAA7C,qHAAA,mBAAmB,OAAA;AAE5B,iDAIwB;AAHtB,wHAAA,uBAAuB,OAAA;AACvB,8HAAA,6BAA6B,OAAA;AAC7B,6GAAA,YAAY,OAAA"}

package/dist/checkout/server/order-service.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @rovela/sdk/checkout/server/order-service
+ *
+ * Order creation and management from Stripe Checkout sessions.
+ */
+import type Stripe from 'stripe';
+import type { CreateOrderParams } from '../types';
+/**
+ * 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
+ * })
+ * ```
+ */
+export declare function createOrderFromCheckout(params: CreateOrderParams): Promise<{
+    orderId: string;
+    isNew: boolean;
+}>;
+/**
+ * Extract order parameters from a Stripe Checkout Session.
+ * Used to convert Stripe's session object to our CreateOrderParams.
+ */
+export declare function extractOrderParamsFromSession(session: Stripe.Checkout.Session): CreateOrderParams;
+/**
+ * Handle a refund event from Stripe.
+ * Updates the order status to 'refunded'.
+ */
+export declare function handleRefund(paymentIntentId: string, refundAmount: number, totalAmount: number): Promise<void>;
+//# sourceMappingURL=order-service.d.ts.map

package/dist/checkout/server/order-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"order-service.d.ts","sourceRoot":"","sources":["../../../src/checkout/server/order-service.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,MAAM,QAAQ,CAAA;AAShC,OAAO,KAAK,EAAE,iBAAiB,EAAoB,MAAM,UAAU,CAAA;AAOnE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,CA8C9C;AAMD;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO,GAC/B,iBAAiB,CA2CnB;AAMD;;;GAGG;AACH,wBAAsB,YAAY,CAChC,eAAe,EAAE,MAAM,EACvB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAuBf"}