@wix/headless-bookings 0.0.30 → 0.0.32

package/dist/services/payment/payment.def.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Payment Service Definition
+ * Defines interfaces and service contract for payment calculation management
+ */
+import type { Signal } from '@wix/services-definitions/core-services/signals';
+import type { CalculateTotalsResponse } from '@wix/auto_sdk_ecom_totals-calculator';
+import type { Service } from '@wix/auto_sdk_bookings_services';
+/**
+ * Payment option for line items
+ */
+export type PaymentOption = 'FULL_PAYMENT_ONLINE' | 'FULL_PAYMENT_OFFLINE';
+/**
+ * Additional computed info for a line item (not in SDK response)
+ */
+export interface LineItemAdditionalInfo {
+    /** Line item ID to match with SDK's calculatedLineItems */
+    lineItemId: string;
+    /** Custom price text (for CUSTOM rate type services) */
+    priceText?: string;
+}
+/**
+ * Payment calculation result with SDK response and additional computed info
+ */
+export interface PaymentDetails {
+    /** The raw SDK CalculateTotals response */
+    response: CalculateTotalsResponse;
+    /** Additional computed information per line item */
+    additionalInfo: {
+        lineItems: LineItemAdditionalInfo[];
+    };
+}
+/**
+ * Input for calculating payment for a slot/service
+ */
+export interface SlotService {
+    service: Service;
+    lineItemId: string;
+}
+/**
+ * Public config for PaymentService (SSR mode only):
+ * Pass `paymentDetails` pre-fetched via loadPaymentConfig
+ */
+export interface PaymentServiceConfig {
+    /** Pre-calculated payment details for SSR (no API call) */
+    paymentDetails?: PaymentDetails;
+}
+/**
+ * Internal config used by Core component to pass lazy loading data
+ * Not exposed publicly - Core merges this with PaymentServiceConfig
+ */
+export interface PaymentServiceInternalConfig extends PaymentServiceConfig {
+    /** Slot services for lazy loading (internal use) */
+    slotServices?: SlotService[];
+    /** Number of participants for lazy loading (internal use) */
+    numberOfParticipants?: number;
+}
+export interface PaymentServiceAPI {
+    paymentDetailsSignal: Signal<PaymentDetails | null>;
+    isLoadingSignal: Signal<boolean>;
+    errorSignal: Signal<string | null>;
+}
+export declare const PaymentServiceDefinition: string & {
+    __api: PaymentServiceAPI;
+    __config: {};
+    isServiceDefinition?: boolean;
+} & PaymentServiceAPI;

package/dist/services/payment/payment.def.js

@@ -0,0 +1,9 @@
+/**
+ * Payment Service Definition
+ * Defines interfaces and service contract for payment calculation management
+ */
+import { defineService } from '@wix/services-definitions';
+// ============================================================================
+// Service Definition
+// ============================================================================
+export const PaymentServiceDefinition = defineService('payment');

package/dist/services/payment/payment.js

@@ -0,0 +1,167 @@
+/**
+ * Payment Service - Pricing calculation and payment details management
+ * Handles calculating total prices, taxes, discounts, and deposit information
+ * Supports two modes: SSR (config with pre-fetched data) and lazy loading (reactive)
+ */
+import { implementService } from '@wix/services-definitions';
+import { SignalsServiceDefinition } from '@wix/services-definitions/core-services/signals';
+import { calculateTotals, } from '@wix/auto_sdk_ecom_totals-calculator';
+import { BookingServiceDefinition } from '../booking/booking.js';
+import { RateType } from '@wix/auto_sdk_bookings_services';
+import { PaymentServiceDefinition, } from './payment.def.js';
+export { PaymentServiceDefinition, } from './payment.def.js';
+// ============================================================================
+// Constants
+// ============================================================================
+const BOOKINGS_APP_DEF_ID = '13d21c63-b5ec-5912-8397-c3a5ddb27a97';
+// ============================================================================
+// Helper Functions
+// ============================================================================
+function getAdditionalInfo(service, lineItemId) {
+    const payment = service.payment;
+    const priceText = payment?.rateType === RateType.CUSTOM && payment.custom?.description
+        ? payment.custom.description
+        : undefined;
+    return { lineItemId, priceText };
+}
+function getPaymentOption(service) {
+    const options = service.payment?.options;
+    if (options?.inPerson) {
+        return 'FULL_PAYMENT_OFFLINE';
+    }
+    return 'FULL_PAYMENT_ONLINE';
+}
+function buildLineItem(service, numberOfParticipants, lineItemId) {
+    // Get fixed price from service
+    const servicePrice = service.payment?.fixed?.price?.value;
+    const price = Number(servicePrice || 0) * numberOfParticipants;
+    // Get deposit if configured
+    const deposit = service.payment?.fixed?.deposit?.value
+        ? Number(service.payment.fixed.deposit.value) * numberOfParticipants
+        : undefined;
+    // Get payment option from service configuration
+    const paymentOption = getPaymentOption(service);
+    return {
+        _id: lineItemId,
+        catalogReference: {
+            catalogItemId: service._id || '',
+            appId: BOOKINGS_APP_DEF_ID,
+        },
+        price: String(price),
+        ...(deposit ? { depositAmount: String(deposit) } : {}),
+        quantity: 1,
+        paymentOption,
+    };
+}
+async function calculatePaymentDetails(slotServices, numberOfParticipants) {
+    const lineItems = slotServices.map((input) => buildLineItem(input.service, numberOfParticipants, input.lineItemId));
+    const response = await calculateTotals({
+        lineItems,
+    });
+    const additionalInfoList = slotServices.map((input) => getAdditionalInfo(input.service, input.lineItemId));
+    return {
+        response,
+        additionalInfo: {
+            lineItems: additionalInfoList,
+        },
+    };
+}
+// ============================================================================
+// Service Implementation
+// ============================================================================
+export const PaymentService = implementService.withConfig()(PaymentServiceDefinition, ({ getService, config }) => {
+    const signalsService = getService(SignalsServiceDefinition);
+    // Try to get BookingService (optional - for reactive mode)
+    let bookingService = null;
+    try {
+        bookingService = getService(BookingServiceDefinition);
+    }
+    catch {
+        bookingService = null;
+    }
+    // Initialize signals
+    const paymentDetailsSignal = signalsService.signal(config.paymentDetails || null);
+    const isLoadingSignal = signalsService.signal(false);
+    const errorSignal = signalsService.signal(null);
+    // Internal calculate function
+    const calculate = async (slotServices, numberOfParticipants) => {
+        if (!slotServices.length) {
+            paymentDetailsSignal.set(null);
+            return;
+        }
+        isLoadingSignal.set(true);
+        errorSignal.set(null);
+        try {
+            const paymentDetails = await calculatePaymentDetails(slotServices, numberOfParticipants);
+            paymentDetailsSignal.set(paymentDetails);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error
+                ? error.message
+                : 'Failed to calculate payment';
+            errorSignal.set(errorMessage);
+            console.error('Payment calculation error:', error);
+        }
+        finally {
+            isLoadingSignal.set(false);
+        }
+    };
+    // Mode 1: SSR - paymentDetails already set in signal initialization
+    if (config.paymentDetails) {
+        // No-op - data is pre-fetched
+    }
+    // Mode 2: Lazy loading - slotServices provided via internal config
+    else if (config.slotServices?.length) {
+        void calculate(config.slotServices, config.numberOfParticipants ?? 1);
+    }
+    // Mode 3: Reactive - observe BookingService signals (client-side only)
+    else if (typeof window !== 'undefined' && bookingService) {
+        signalsService.effect(() => {
+            const selections = bookingService?.serviceSelections.get() || [];
+            // For single service mode, take the first selection
+            const firstSelection = selections[0];
+            const numParticipants = firstSelection?.totalParticipants || 1;
+            const services = selections.map((selection) => ({
+                service: selection.service,
+                lineItemId: selection.instanceId,
+            }));
+            void calculate(services, numParticipants);
+        });
+    }
+    return {
+        paymentDetailsSignal,
+        isLoadingSignal,
+        errorSignal,
+    };
+});
+/**
+ * Load payment configuration for Server-Side Rendering (SSR).
+ * Calls the pricing APIs and returns pre-calculated payment details.
+ *
+ * @param params.slotServices - Slot/service inputs for calculation
+ * @param params.numberOfParticipants - Number of participants (default: 1)
+ */
+export async function loadPaymentConfig(params) {
+    try {
+        const { slotServices, numberOfParticipants = 1 } = params;
+        if (!slotServices.length) {
+            return {
+                type: 'success',
+                config: { paymentDetails: undefined },
+            };
+        }
+        const paymentDetails = await calculatePaymentDetails(slotServices, numberOfParticipants);
+        return {
+            type: 'success',
+            config: { paymentDetails },
+        };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Failed to load payment config';
+        console.error('Failed to load payment config:', error);
+        return {
+            type: 'error',
+            error: errorMessage,
+        };
+    }
+}

package/dist/utils/money.d.ts

@@ -19,3 +19,14 @@ export declare function convertToMoneyData(sdkMoney: {
     currency?: string;
     formattedValue?: string | null;
 } | undefined): MoneyData | null;
+/**
+ * Converts ecom MultiCurrencyPrice format to MoneyData format
+ * MultiCurrencyPrice uses 'amount' as string, while MoneyData uses 'amount' as number
+ *
+ * @param price - The MultiCurrencyPrice object with amount as string
+ * @param currency - The currency code (from response level)
+ * @returns MoneyData object or null if conversion fails
+ */
+export declare function convertMultiCurrencyPriceToMoneyData(price: {
+    amount?: string;
+} | undefined, currency: string): MoneyData | null;

package/dist/utils/money.js

@@ -32,3 +32,19 @@ export function convertToMoneyData(sdkMoney) {
     }
     return null;
 }
+/**
+ * Converts ecom MultiCurrencyPrice format to MoneyData format
+ * MultiCurrencyPrice uses 'amount' as string, while MoneyData uses 'amount' as number
+ *
+ * @param price - The MultiCurrencyPrice object with amount as string
+ * @param currency - The currency code (from response level)
+ * @returns MoneyData object or null if conversion fails
+ */
+export function convertMultiCurrencyPriceToMoneyData(price, currency) {
+    if (!price?.amount)
+        return null;
+    const parsed = parseFloat(price.amount);
+    if (isNaN(parsed) || parsed < 0)
+        return null;
+    return { amount: parsed, currency };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/headless-bookings",
-  "version": "0.0.30",
+  "version": "0.0.32",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -72,5 +72,5 @@
       "groupId": "com.wixpress.headless-components"
     }
   },
-  "falconPackageHash": "d466b4eaebfa6f1258b0d9f3bfa7928fa0f0a6df920e8c143ebb52d0"
+  "falconPackageHash": "b165685e9ccb4d9fe0e8d310393e59018c8d44c874e2c7cd0fc9906a"
 }