@wix/headless-gift-voucher 0.0.1

package/dist/react/index.d.ts

@@ -0,0 +1,2 @@
+export * as GiftCard from './GiftCard.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/react/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC"}

package/dist/react/index.js

@@ -0,0 +1 @@
+export * as GiftCard from './GiftCard.js';

package/dist/services/gift-card-checkout-service.d.ts

@@ -0,0 +1,133 @@
+import type { giftVoucherProducts } from '@wix/gift-vouchers';
+import * as checkout from '@wix/auto_sdk_ecom_checkout';
+import { type Signal, type ReadOnlySignal } from '@wix/services-definitions/core-services/signals';
+export type LineItem = checkout.LineItem;
+/**
+ * Gift card catalog options for cart line items
+ */
+export interface GiftCardCatalogOptions {
+    quantity: number;
+    currency: string;
+    variantId?: string;
+    customAmount?: number;
+    giftingInfo?: {
+        recipientInfo: {
+            firstName: string;
+            lastName: string;
+            email: string;
+        };
+        greetingMessage?: string;
+        deliverAt?: Date;
+    };
+    wixGiftCardsAppNewCatalog: true;
+}
+/**
+ * MultiCurrencyPrice type from the Wix Gift Vouchers API
+ */
+export type MultiCurrencyPrice = giftVoucherProducts.MultiCurrencyPrice;
+/**
+ * Current price data based on selected variant.
+ * Contains raw numeric amounts - use Money component for formatting.
+ */
+export interface CurrentPriceData {
+    /** Price amount as number (what the customer pays) */
+    price: number;
+    /** Original value as number (what the gift card is worth) */
+    value: number;
+    /** Whether current selection has a discount (price < value) */
+    hasDiscount: boolean;
+}
+/**
+ * Custom amount input data for min/max validation
+ */
+export interface CustomAmountData {
+    /** Minimum allowed custom amount */
+    min: number | null;
+    /** Maximum allowed custom amount */
+    max: number | null;
+}
+/**
+ * API interface for the GiftCardCheckout service.
+ * Manages variant selection state and computed values based on selection.
+ */
+export interface GiftCardCheckoutServiceAPI {
+    /** Currently selected variant ID (preset variant _id or 'custom') */
+    selectedVariantId: Signal<string | null>;
+    /** Current image based on selection (selectedVariant.image ?? product.image) */
+    currentImage: ReadOnlySignal<string | null>;
+    /** Current price data based on selection (price, value, discount info) */
+    currentPriceData: ReadOnlySignal<CurrentPriceData | null>;
+    /** User-entered custom amount (defaults to 0) */
+    customAmount: Signal<number>;
+    /** Whether the custom amount is valid (within min/max range) */
+    isCustomAmountValid: ReadOnlySignal<boolean>;
+    /** Custom amount validation data (min/max values) */
+    customAmountData: ReadOnlySignal<CustomAmountData>;
+    /** Current quantity of gift cards to purchase (default: 1) */
+    quantity: Signal<number>;
+    /** Whether this is a gift purchase (for someone else) or self-purchase */
+    isGift: Signal<boolean>;
+    /** Recipient email address */
+    recipientEmail: Signal<string>;
+    /** Whether the recipient email is valid */
+    isRecipientEmailValid: ReadOnlySignal<boolean>;
+    /** Recipient name (optional) */
+    recipientName: Signal<string>;
+    /** Delivery date for the gift card (default: immediate delivery) */
+    deliverAt: Signal<Date>;
+    /** Personal message to include with the gift card (optional) */
+    recipientMessage: Signal<string>;
+    /** Whether to show validation errors (set to true after form submission attempt) */
+    showErrors: Signal<boolean>;
+    /** Whether the form is valid and can add to cart */
+    canAddToCart: ReadOnlySignal<boolean>;
+    /** Computed line items ready for cart API */
+    lineItems: ReadOnlySignal<LineItem[]>;
+    /** Set the selected variant by ID */
+    setVariant: (variantId: string | null) => void;
+    /** Set the custom amount value */
+    setCustomAmount: (amount: number) => void;
+    /** Set the quantity value */
+    setQuantity: (quantity: number) => void;
+    /** Set whether this is a gift purchase */
+    setIsGift: (value: boolean) => void;
+    /** Set the recipient email */
+    setRecipientEmail: (email: string) => void;
+    /** Set the recipient name */
+    setRecipientName: (name: string) => void;
+    /** Set the delivery date */
+    setDeliverAt: (date: Date) => void;
+    /** Set the recipient message */
+    setRecipientMessage: (message: string) => void;
+    /** Set whether to show validation errors */
+    setShowErrors: (show: boolean) => void;
+    /** Validates the form and triggers error display. */
+    validateAndShowErrors: () => boolean;
+}
+/**
+ * Service definition for the GiftCardCheckout service.
+ */
+export declare const GiftCardCheckoutServiceDefinition: string & {
+    __api: GiftCardCheckoutServiceAPI;
+    __config: {};
+    isServiceDefinition?: boolean;
+} & GiftCardCheckoutServiceAPI;
+/**
+ * Configuration interface for the GiftCardCheckoutService.
+ * Currently empty, but can be extended for initial state.
+ */
+export interface GiftCardCheckoutServiceConfig {
+}
+/**
+ * Implementation of the GiftCardCheckout service.
+ * Manages variant selection and provides computed values based on selection.
+ *
+ * Dependencies:
+ * - GiftCardServiceDefinition: to get product data
+ */
+export declare const GiftCardCheckoutService: import("@wix/services-definitions").ServiceFactory<string & {
+    __api: GiftCardCheckoutServiceAPI;
+    __config: {};
+    isServiceDefinition?: boolean;
+} & GiftCardCheckoutServiceAPI, GiftCardCheckoutServiceConfig>;
+//# sourceMappingURL=gift-card-checkout-service.d.ts.map

package/dist/services/gift-card-checkout-service.d.ts.map

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

package/dist/services/gift-card-checkout-service.js

@@ -0,0 +1,159 @@
+import { defineService, implementService } from '@wix/services-definitions';
+import { SignalsServiceDefinition, } from '@wix/services-definitions/core-services/signals';
+import { GiftCardServiceDefinition } from './gift-card-service.js';
+import { getCurrentImage, getCurrentPriceData, getCustomAmountData, canAddToCartCheck, productToLineItems, } from '../utils/gift-card-utils.js';
+import { validateCustomAmount, validateEmail, } from '../utils/validation-utils.js';
+/**
+ * Service definition for the GiftCardCheckout service.
+ */
+export const GiftCardCheckoutServiceDefinition = defineService('gift-card-checkout');
+/**
+ * Implementation of the GiftCardCheckout service.
+ * Manages variant selection and provides computed values based on selection.
+ *
+ * Dependencies:
+ * - GiftCardServiceDefinition: to get product data
+ */
+export const GiftCardCheckoutService = implementService.withConfig()(GiftCardCheckoutServiceDefinition, ({ getService }) => {
+    const signalsService = getService(SignalsServiceDefinition);
+    const giftCardService = getService(GiftCardServiceDefinition);
+    const getInitialVariantId = () => {
+        const product = giftCardService.product.get();
+        const firstVariant = product?.presetVariants?.[0];
+        return firstVariant?._id ?? null;
+    };
+    const selectedVariantId = signalsService.signal(getInitialVariantId());
+    const customAmount = signalsService.signal(undefined);
+    const quantity = signalsService.signal(1);
+    const isGift = signalsService.signal(true);
+    const recipientEmail = signalsService.signal('');
+    const recipientName = signalsService.signal('');
+    const deliverAt = signalsService.signal(new Date());
+    const recipientMessage = signalsService.signal('');
+    const showErrors = signalsService.signal(false);
+    const currentImage = signalsService.computed(() => {
+        const product = giftCardService.product.get();
+        const variantId = selectedVariantId.get();
+        return getCurrentImage(product, variantId);
+    });
+    const currentPriceData = signalsService.computed(() => {
+        const product = giftCardService.product.get();
+        const variantId = selectedVariantId.get();
+        const customAmountValue = customAmount.get();
+        return getCurrentPriceData(product, variantId, customAmountValue);
+    });
+    const customAmountData = signalsService.computed(() => {
+        const product = giftCardService.product.get();
+        return getCustomAmountData(product);
+    });
+    const isCustomAmountValid = signalsService.computed(() => {
+        const amount = customAmount.get();
+        const data = customAmountData.get();
+        return validateCustomAmount(amount, data);
+    });
+    const isRecipientEmailValid = signalsService.computed(() => {
+        const email = recipientEmail.get();
+        return validateEmail(email);
+    });
+    const canAddToCart = signalsService.computed(() => {
+        const product = giftCardService.product.get();
+        const variantId = selectedVariantId.get();
+        const isGiftPurchase = isGift.get();
+        const isCustomAmountValidCheck = isCustomAmountValid.get();
+        const isRecipientEmailValidCheck = isRecipientEmailValid.get();
+        return canAddToCartCheck(product, variantId, isGiftPurchase, isCustomAmountValidCheck, isRecipientEmailValidCheck);
+    });
+    const lineItems = signalsService.computed(() => {
+        const product = giftCardService.product.get();
+        const currency = giftCardService.currencyCode.get();
+        const variantId = selectedVariantId.get();
+        const customAmountValue = customAmount.get();
+        const qty = quantity.get();
+        const isGiftPurchase = isGift.get();
+        const recipientEmailValue = recipientEmail.get();
+        const recipientNameValue = recipientName.get();
+        const deliverAtValue = deliverAt.get();
+        const recipientMessageValue = recipientMessage.get();
+        return productToLineItems(product, currency, variantId, customAmountValue, qty, isGiftPurchase, recipientEmailValue, recipientNameValue, deliverAtValue, recipientMessageValue);
+    });
+    const validateAndShowErrors = () => {
+        setShowErrors(true);
+        return canAddToCart.get();
+    };
+    const setVariant = (variantId) => {
+        selectedVariantId.set(variantId);
+    };
+    const setCustomAmount = (amount) => {
+        customAmount.set(amount);
+    };
+    const setQuantity = (value) => {
+        if (value >= 1) {
+            quantity.set(value);
+        }
+    };
+    const setIsGift = (value) => {
+        isGift.set(value);
+    };
+    const setRecipientEmail = (email) => {
+        recipientEmail.set(email);
+    };
+    const setRecipientName = (name) => {
+        recipientName.set(name);
+    };
+    const setDeliverAt = (date) => {
+        deliverAt.set(date);
+    };
+    const setRecipientMessage = (message) => {
+        recipientMessage.set(message);
+    };
+    const setShowErrors = (show) => {
+        showErrors.set(show);
+    };
+    // Use effect to set initial variant when product loads (if not already set)
+    signalsService.effect(() => {
+        const loadedProduct = giftCardService.product.get();
+        if (loadedProduct && !selectedVariantId.get()) {
+            const firstVariant = loadedProduct.presetVariants?.[0];
+            if (firstVariant?._id) {
+                selectedVariantId.set(firstVariant._id);
+            }
+        }
+    });
+    // Use effect to set initial custom amount to min value when product loads
+    signalsService.effect(() => {
+        const loadedProduct = giftCardService.product.get();
+        const currentAmount = customAmount.get();
+        if (loadedProduct && currentAmount === undefined) {
+            const minValue = loadedProduct.customVariant?.minValue?.amount;
+            customAmount.set(minValue ? parseFloat(minValue) : 1);
+        }
+    });
+    return {
+        selectedVariantId,
+        currentImage,
+        currentPriceData,
+        customAmount,
+        isCustomAmountValid,
+        customAmountData,
+        quantity,
+        isGift,
+        recipientEmail,
+        isRecipientEmailValid,
+        recipientName,
+        deliverAt,
+        recipientMessage,
+        showErrors,
+        canAddToCart,
+        lineItems,
+        setVariant,
+        setCustomAmount,
+        setQuantity,
+        setIsGift,
+        setRecipientEmail,
+        setRecipientName,
+        setDeliverAt,
+        setRecipientMessage,
+        setShowErrors,
+        validateAndShowErrors,
+    };
+});

package/dist/services/gift-card-service.d.ts

@@ -0,0 +1,102 @@
+import { giftVoucherProducts } from '@wix/gift-vouchers';
+import { type Signal } from '@wix/services-definitions/core-services/signals';
+/**
+ * Gift card product type from the Wix Gift Vouchers API
+ */
+export type GiftCardProduct = giftVoucherProducts.GiftCardProduct;
+/**
+ * API interface for the GiftCard service.
+ * Provides reactive gift card product data management.
+ */
+export interface GiftCardServiceAPI {
+    /** Reactive signal containing the gift card product data */
+    product: Signal<GiftCardProduct | undefined>;
+    /** Reactive signal indicating if the product is currently being loaded */
+    isLoading: Signal<boolean>;
+    /** Reactive signal containing any error message, or null if no error */
+    error: Signal<string | null>;
+    /** Reactive signal containing the currency code (e.g., "EUR", "USD") */
+    currencyCode: Signal<string>;
+    /** Reactive signal containing the locale code (e.g., "en-US", "he-IL") */
+    locale: Signal<string>;
+    /** Function to load the gift card product */
+    loadProduct: () => Promise<void>;
+}
+/**
+ * Service definition for the GiftCard service.
+ */
+export declare const GiftCardServiceDefinition: string & {
+    __api: GiftCardServiceAPI;
+    __config: {};
+    isServiceDefinition?: boolean;
+} & GiftCardServiceAPI;
+/**
+ * Configuration interface for the GiftCardService.
+ * Either provide a product directly (SSR) or leave undefined to auto-fetch.
+ */
+export interface GiftCardServiceConfig {
+    /** The gift card product data (optional - if not provided, will be fetched) */
+    product?: GiftCardProduct;
+    /** ISO currency code (e.g., "EUR", "USD"). If not provided, resolved internally from site settings */
+    currencyCode?: string;
+}
+export declare const GiftCardService: import("@wix/services-definitions").ServiceFactory<string & {
+    __api: GiftCardServiceAPI;
+    __config: {};
+    isServiceDefinition?: boolean;
+} & GiftCardServiceAPI, GiftCardServiceConfig>;
+/**
+ * Success result interface for gift card service configuration loading.
+ */
+export interface SuccessGiftCardServiceConfigResult {
+    type: 'success';
+    config: GiftCardServiceConfig;
+}
+/**
+ * Not found result interface for gift card service configuration loading.
+ */
+export interface NotFoundGiftCardServiceConfigResult {
+    type: 'notFound';
+}
+/**
+ * Options for loading gift card service configuration.
+ */
+export interface LoadGiftCardServiceConfigOptions {
+    /** ISO currency code (e.g., "EUR", "USD") to use for price formatting.
+     * If not provided, it will be fetched from site settings. */
+    currency?: string;
+}
+/**
+ * Loads gift card service configuration for SSR.
+ * Fetches the first gift card product from the API and optionally
+ * fetches the site currency from Wix site settings.
+ *
+ * @param options - Optional configuration for loading
+ * @returns Promise that resolves to GiftCardServiceConfigResult (success with config or notFound)
+ *
+ * @example
+ * ```astro
+ * ---
+ * import { loadGiftCardServiceConfig } from '@wix/headless-gift-voucher/services';
+ * import { GiftCard } from '@wix/headless-gift-voucher/react';
+ *
+ * // Option 1: Auto-fetch currency from site settings (default)
+ * const result = await loadGiftCardServiceConfig();
+ *
+ * // Option 2: Provide explicit currency (skips site settings fetch)
+ * const result = await loadGiftCardServiceConfig({
+ *   currency: 'EUR'
+ * });
+ *
+ * if (result.type === 'notFound') {
+ *   return Astro.redirect('/404');
+ * }
+ * ---
+ *
+ * <GiftCard.Root giftCardServiceConfig={result.config}>
+ *   <GiftCard.Name />
+ * </GiftCard.Root>
+ * ```
+ */
+export declare function loadGiftCardServiceConfig(options?: LoadGiftCardServiceConfigOptions): Promise<SuccessGiftCardServiceConfigResult | NotFoundGiftCardServiceConfigResult>;
+//# sourceMappingURL=gift-card-service.d.ts.map

package/dist/services/gift-card-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gift-card-service.d.ts","sourceRoot":"","sources":["../../src/services/gift-card-service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAGzD,OAAO,EAEL,KAAK,MAAM,EACZ,MAAM,iDAAiD,CAAC;AAGzD;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,mBAAmB,CAAC,eAAe,CAAC;AAElE;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC,eAAe,GAAG,SAAS,CAAC,CAAC;IAC7C,0EAA0E;IAC1E,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAC3B,wEAAwE;IACxE,KAAK,EAAE,MAAM,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC7B,wEAAwE;IACxE,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAC7B,0EAA0E;IAC1E,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACvB,6CAA6C;IAC7C,WAAW,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAClC;AAED;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;sBACU,CAAC;AAEjD;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,+EAA+E;IAC/E,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,sGAAsG;IACtG,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAmDD,eAAO,MAAM,eAAe;;;;8CAsEzB,CAAC;AAEJ;;GAEG;AACH,MAAM,WAAW,kCAAkC;IACjD,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,qBAAqB,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,mCAAmC;IAClD,IAAI,EAAE,UAAU,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gCAAgC;IAC/C;iEAC6D;IAC7D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,CAAC,EAAE,gCAAgC,GACzC,OAAO,CACR,kCAAkC,GAAG,mCAAmC,CACzE,CAwBA"}

package/dist/services/gift-card-service.js

@@ -0,0 +1,165 @@
+import { i18n } from '@wix/essentials';
+import { giftVoucherProducts } from '@wix/gift-vouchers';
+import { defineService, implementService } from '@wix/services-definitions';
+import { ecommerceSettings } from '@wix/ecom';
+import { SignalsServiceDefinition, } from '@wix/services-definitions/core-services/signals';
+import { DEFAULT_CURRENCY_CODE, DEFAULT_LOCALE } from '../enums/index.js';
+/**
+ * Service definition for the GiftCard service.
+ */
+export const GiftCardServiceDefinition = defineService('gift-card');
+/**
+ * Internal helper function to load the gift card product from the Wix API.
+ */
+const loadGiftCardProduct = async () => {
+    const result = await giftVoucherProducts.queryGiftCardProducts().find();
+    return result?.items?.[0];
+};
+/**
+ * Implementation of the GiftCard service.
+ * Supports both SSR (config with product) and client-side (auto-fetch).
+ *
+ * @example
+ * ```tsx
+ * // With SSR config (product pre-loaded)
+ * <GiftCard.Root giftCardServiceConfig={{ product: myGiftCardProduct }}>
+ *   <GiftCard.Name />
+ * </GiftCard.Root>
+ *
+ * // Without config (will auto-fetch)
+ * <GiftCard.Root giftCardServiceConfig={{}}>
+ *   <GiftCard.Name />
+ * </GiftCard.Root>
+ * ```
+ */
+/**
+ * Internal helper function to load the site currency from Wix site settings.
+ * @returns Promise that resolves to the site currency code (e.g., "USD", "EUR")
+ */
+const loadSiteCurrency = async () => {
+    const settings = await ecommerceSettings.getEcommerceSettings([
+        'BUSINESS_INFO',
+    ]);
+    return settings.ecommerceSettings?.businessInfo?.currency;
+};
+/**
+ * Internal helper function to get the locale from i18n service.
+ * @returns The locale code (e.g., "en-US", "he-IL")
+ */
+const loadLocale = () => {
+    try {
+        return i18n.getLocale() ?? DEFAULT_LOCALE;
+    }
+    catch (e) {
+        console.warn('Failed to get locale, using default:', e);
+        return DEFAULT_LOCALE;
+    }
+};
+export const GiftCardService = implementService.withConfig()(GiftCardServiceDefinition, ({ getService, config }) => {
+    const signalsService = getService(SignalsServiceDefinition);
+    const product = signalsService.signal(config.product);
+    const currencyCode = signalsService.signal(config.currencyCode ?? '');
+    const locale = signalsService.signal(loadLocale());
+    const isLoading = signalsService.signal(!config.product || !config.currencyCode);
+    const error = signalsService.signal(null);
+    const loadCurrency = async () => {
+        isLoading.set(true);
+        error.set(null);
+        try {
+            const siteCurrency = await loadSiteCurrency();
+            currencyCode.set(siteCurrency);
+        }
+        catch (e) {
+            console.warn('Failed to load currency, using default:', e);
+            currencyCode.set(DEFAULT_CURRENCY_CODE);
+        }
+        isLoading.set(false);
+    };
+    const loadProduct = async () => {
+        isLoading.set(true);
+        error.set(null);
+        try {
+            const giftCardProduct = await loadGiftCardProduct();
+            if (!giftCardProduct) {
+                error.set('Gift card product not found');
+            }
+            else {
+                product.set(giftCardProduct);
+            }
+        }
+        catch (e) {
+            error.set(e instanceof Error ? e.message : 'Failed to load gift card');
+        }
+        isLoading.set(false);
+    };
+    if (!config.currencyCode) {
+        loadCurrency();
+    }
+    if (!config.product) {
+        loadProduct();
+    }
+    return {
+        product,
+        isLoading,
+        error,
+        currencyCode,
+        locale,
+        loadProduct,
+    };
+});
+/**
+ * Loads gift card service configuration for SSR.
+ * Fetches the first gift card product from the API and optionally
+ * fetches the site currency from Wix site settings.
+ *
+ * @param options - Optional configuration for loading
+ * @returns Promise that resolves to GiftCardServiceConfigResult (success with config or notFound)
+ *
+ * @example
+ * ```astro
+ * ---
+ * import { loadGiftCardServiceConfig } from '@wix/headless-gift-voucher/services';
+ * import { GiftCard } from '@wix/headless-gift-voucher/react';
+ *
+ * // Option 1: Auto-fetch currency from site settings (default)
+ * const result = await loadGiftCardServiceConfig();
+ *
+ * // Option 2: Provide explicit currency (skips site settings fetch)
+ * const result = await loadGiftCardServiceConfig({
+ *   currency: 'EUR'
+ * });
+ *
+ * if (result.type === 'notFound') {
+ *   return Astro.redirect('/404');
+ * }
+ * ---
+ *
+ * <GiftCard.Root giftCardServiceConfig={result.config}>
+ *   <GiftCard.Name />
+ * </GiftCard.Root>
+ * ```
+ */
+export async function loadGiftCardServiceConfig(options) {
+    try {
+        // Load product and optionally currency in parallel
+        // Currency is fetched from site settings only if not provided in options
+        const [giftCardProduct, siteCurrency] = await Promise.all([
+            loadGiftCardProduct(),
+            options?.currency ? Promise.resolve(undefined) : loadSiteCurrency(),
+        ]);
+        if (!giftCardProduct) {
+            return { type: 'notFound' };
+        }
+        return {
+            type: 'success',
+            config: {
+                product: giftCardProduct,
+                currencyCode: options?.currency ?? siteCurrency,
+            },
+        };
+    }
+    catch (error) {
+        console.error('Failed to load gift card product:', error);
+        return { type: 'notFound' };
+    }
+}

package/dist/services/index.d.ts

@@ -0,0 +1,3 @@
+export { GiftCardService, GiftCardServiceDefinition, type GiftCardServiceConfig, type GiftCardServiceAPI, type GiftCardProduct, loadGiftCardServiceConfig, type LoadGiftCardServiceConfigOptions, } from './gift-card-service.js';
+export { GiftCardCheckoutService, GiftCardCheckoutServiceDefinition, type GiftCardCheckoutServiceConfig, type GiftCardCheckoutServiceAPI, type CurrentPriceData, type MultiCurrencyPrice, type CustomAmountData, type LineItem, type GiftCardCatalogOptions, } from './gift-card-checkout-service.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,yBAAyB,EACzB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,yBAAyB,EACzB,KAAK,gCAAgC,GACtC,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,uBAAuB,EACvB,iCAAiC,EACjC,KAAK,6BAA6B,EAClC,KAAK,0BAA0B,EAC/B,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,QAAQ,EACb,KAAK,sBAAsB,GAC5B,MAAM,iCAAiC,CAAC"}

package/dist/services/index.js

@@ -0,0 +1,2 @@
+export { GiftCardService, GiftCardServiceDefinition, loadGiftCardServiceConfig, } from './gift-card-service.js';
+export { GiftCardCheckoutService, GiftCardCheckoutServiceDefinition, } from './gift-card-checkout-service.js';

package/dist/utils/formatting-utils.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Get currency symbol from currency code using Intl.NumberFormat
+ */
+export declare function getCurrencySymbol(currencyCode: string): string;
+/**
+ * Formats a date according to the given locale.
+ */
+export declare function formatDate(date: Date, locale: string): string;
+/**
+ * Formats a date for HTML date input (YYYY-MM-DD).
+ */
+export declare function formatDateForInput(date: Date): string;
+//# sourceMappingURL=formatting-utils.d.ts.map

package/dist/utils/formatting-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatting-utils.d.ts","sourceRoot":"","sources":["../../src/utils/formatting-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAc9D;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAM7D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAKrD"}

package/dist/utils/formatting-utils.js

@@ -0,0 +1,38 @@
+/**
+ * Get currency symbol from currency code using Intl.NumberFormat
+ */
+export function getCurrencySymbol(currencyCode) {
+    try {
+        // the locale does not matter for the narrowSymbol
+        const formatter = new Intl.NumberFormat('en', {
+            style: 'currency',
+            currency: currencyCode,
+            currencyDisplay: 'narrowSymbol',
+        });
+        const parts = formatter.formatToParts(0);
+        const symbolPart = parts.find((part) => part.type === 'currency');
+        return symbolPart?.value ?? currencyCode;
+    }
+    catch {
+        return currencyCode;
+    }
+}
+/**
+ * Formats a date according to the given locale.
+ */
+export function formatDate(date, locale) {
+    return date.toLocaleDateString(locale, {
+        year: 'numeric',
+        month: 'short',
+        day: 'numeric',
+    });
+}
+/**
+ * Formats a date for HTML date input (YYYY-MM-DD).
+ */
+export function formatDateForInput(date) {
+    const year = date.getFullYear();
+    const month = String(date.getMonth() + 1).padStart(2, '0');
+    const day = String(date.getDate()).padStart(2, '0');
+    return `${year}-${month}-${day}`;
+}

package/dist/utils/gift-card-utils.d.ts

@@ -0,0 +1,18 @@
+import { CurrentPriceData, CustomAmountData, LineItem } from '../services/gift-card-checkout-service.js';
+import { GiftCardProduct } from '../services/gift-card-service.js';
+export declare function getCurrentImage(product: GiftCardProduct | undefined, selectedVariantId: string | null): string | null;
+/**
+ * Gets the current price data based on the selected variant.
+ * Returns raw numeric amounts - use Money component for formatting.
+ */
+export declare function getCurrentPriceData(product: GiftCardProduct | undefined, selectedVariantId: string | null, customAmount: number): CurrentPriceData | null;
+/**
+ * Gets the min/max values for custom amount validation from the product.
+ */
+export declare function getCustomAmountData(product: GiftCardProduct | undefined): CustomAmountData;
+export declare function canAddToCartCheck(product: GiftCardProduct | undefined, variantId: string | null, isGiftPurchase: boolean, isCustomAmountValidCheck: boolean, isRecipientEmailValidCheck: boolean): boolean;
+/**
+ * Converts the product data to line items for the cart API.
+ */
+export declare function productToLineItems(product: GiftCardProduct | undefined, currency: string, variantId: string | null, customAmount: number, qty: number, isGiftPurchase: boolean, recipientEmail: string, recipientName: string, deliverAt: Date, recipientMessage: string): LineItem[];
+//# sourceMappingURL=gift-card-utils.d.ts.map