storefront-layouts-staging 1.0.0-staging.0

package/dist/lib/utils/editor-preview.d.ts

@@ -0,0 +1,42 @@
+import type { StoreCategory, StoreConfig, StoreMenuItem, StoreProduct, StoreService } from '../store-types';
+/** Prefer the first non-empty catalog list; empty persisted `[]` must not block API data. */
+export declare function coalesceCatalog<T>(...sources: (T[] | undefined | null)[]): T[];
+export type EditorCatalogOverlay = {
+    products?: StoreProduct[];
+    categories?: StoreCategory[];
+    services?: StoreService[];
+};
+/** Food layouts read `menuItems`; derive from products when the editor only injected products. */
+export declare function syncFoodMenuItemsFromProducts(config: Pick<StoreConfig, 'layout' | 'type' | 'products' | 'menuItems'>, layoutId?: string): StoreMenuItem[] | undefined;
+/** Merge host-fetched catalog (editor Phase 2) into live preview config. */
+export declare function applyEditorCatalogOverlay(config: StoreConfig, overlay: EditorCatalogOverlay, layoutId?: string): StoreConfig;
+/** Merge getStore catalog into config when persisted layout JSON has empty catalog arrays. */
+export declare function applyStoreCatalogFromApi(config: StoreConfig, storeData: Pick<StoreConfig, 'products' | 'services' | 'categories'> | null | undefined, layoutId?: string): StoreConfig;
+/** True when rendering inside the template editor iframe or preview host. */
+export declare function isEditorPreviewMode(storeConfig?: Pick<StoreConfig, 'isPreview' | 'layoutConfig'>): boolean;
+/**
+ * Products for listing/detail pages: prefer active catalog, but in editor preview
+ * fall back to all injected products (including drafts) so merchants see real inventory.
+ */
+export declare function resolveStoreProductsForDisplay(products: StoreProduct[] | undefined, isPreview?: boolean): StoreProduct[];
+/** Resolve product detail slug in storefront; in preview, map preview-item to first product. */
+export declare function resolveProductBySlugForDisplay(products: StoreProduct[] | undefined, slug: string | undefined, isPreview?: boolean): StoreProduct | undefined;
+/** Map store products to menu rows when food layouts only receive `products` in the editor. */
+export declare function productsToMenuItems(products: StoreProduct[]): StoreMenuItem[];
+export declare function resolveMenuItemsForDisplay(menuItems: StoreMenuItem[] | undefined, products: StoreProduct[] | undefined, isPreview?: boolean): StoreMenuItem[];
+/** Categories for listing pages; preview placeholders only when catalog is still empty. */
+export declare function resolveStoreCategoriesForDisplay(categories: StoreCategory[] | undefined, isPreview?: boolean): StoreCategory[];
+/** Resolve category detail slug; in preview, map preview-category to first category. */
+export declare function resolveCategoryBySlugForDisplay(categories: StoreCategory[] | undefined, slug: string | undefined, isPreview?: boolean): StoreCategory | undefined;
+/**
+ * Services for listing/detail pages: prefer active catalog, but in editor preview
+ * fall back to all injected services (including drafts) so merchants see real inventory.
+ */
+export declare function resolveStoreServicesForDisplay(services: StoreService[] | undefined, isPreview?: boolean): StoreService[];
+/** Resolve service detail slug in storefront; in preview, map preview-service to first service. */
+export declare function resolveServiceBySlugForDisplay(services: StoreService[] | undefined, slug: string | undefined, isPreview?: boolean): StoreService | undefined;
+/** Products belonging to a category, with preview-aware active/draft resolution. */
+export declare function resolveCategoryProductsForDisplay(products: StoreProduct[] | undefined, categoryId: string | undefined, isPreview?: boolean): StoreProduct[];
+/** Services belonging to a category, with preview-aware active/draft resolution. */
+export declare function resolveCategoryServicesForDisplay(services: StoreService[] | undefined, categoryId: string | undefined, isPreview?: boolean): StoreService[];
+//# sourceMappingURL=editor-preview.d.ts.map

package/dist/lib/utils/editor-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editor-preview.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/editor-preview.ts"],"names":[],"mappings":"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"}

package/dist/lib/utils/editor-preview.js

@@ -0,0 +1,214 @@
+import { filterActiveProducts, filterActiveServices } from './product-catalog.js';
+import { richFieldPlainTextForDisplay } from '../rich-html.js';
+import { normalizeStoreProductsForDisplay, resolveProductImageUrls } from './product-images.js';
+/** Prefer the first non-empty catalog list; empty persisted `[]` must not block API data. */
+export function coalesceCatalog(...sources) {
+    for (const list of sources) {
+        if (Array.isArray(list) && list.length > 0)
+            return list;
+    }
+    return [];
+}
+/** Food layouts read `menuItems`; derive from products when the editor only injected products. */
+export function syncFoodMenuItemsFromProducts(config, layoutId) {
+    const layout = String(layoutId || config.layout || config.type || '').toLowerCase();
+    if (!layout.startsWith('food'))
+        return config.menuItems;
+    const products = config.products;
+    if (!Array.isArray(products) || products.length === 0)
+        return config.menuItems;
+    if (Array.isArray(config.menuItems) && config.menuItems.length > 0)
+        return config.menuItems;
+    return productsToMenuItems(products);
+}
+function withFoodMenuItems(config, layoutId) {
+    const menuItems = syncFoodMenuItemsFromProducts(config, layoutId);
+    if (!menuItems?.length)
+        return config;
+    return { ...config, menuItems };
+}
+/** Merge host-fetched catalog (editor Phase 2) into live preview config. */
+export function applyEditorCatalogOverlay(config, overlay, layoutId) {
+    const mergedProducts = coalesceCatalog(overlay.products, config.products);
+    const next = {
+        ...config,
+        isPreview: config.isPreview ?? true,
+        products: normalizeStoreProductsForDisplay(mergedProducts, {
+            isPreview: true,
+            placeholderInPreview: true,
+        }),
+        categories: coalesceCatalog(overlay.categories, config.categories),
+        services: coalesceCatalog(overlay.services, config.services),
+    };
+    return withFoodMenuItems(next, layoutId);
+}
+/** Merge getStore catalog into config when persisted layout JSON has empty catalog arrays. */
+export function applyStoreCatalogFromApi(config, storeData, layoutId) {
+    if (!storeData)
+        return withFoodMenuItems(config, layoutId);
+    const mergedProducts = coalesceCatalog(config.products, storeData.products);
+    const next = {
+        ...config,
+        products: normalizeStoreProductsForDisplay(mergedProducts, {
+            isPreview: true,
+            placeholderInPreview: true,
+        }),
+        categories: coalesceCatalog(config.categories, storeData.categories),
+        services: coalesceCatalog(config.services, storeData.services),
+    };
+    return withFoodMenuItems(next, layoutId);
+}
+/** True when rendering inside the template editor iframe or preview host. */
+export function isEditorPreviewMode(storeConfig) {
+    return ((typeof window !== 'undefined' &&
+        !!window.__IS_PREVIEW__) ||
+        !!storeConfig?.isPreview ||
+        !!storeConfig?.layoutConfig?.isPreview);
+}
+/**
+ * Products for listing/detail pages: prefer active catalog, but in editor preview
+ * fall back to all injected products (including drafts) so merchants see real inventory.
+ */
+export function resolveStoreProductsForDisplay(products, isPreview) {
+    const raw = Array.isArray(products) ? products : [];
+    const active = filterActiveProducts(raw);
+    if (active.length > 0)
+        return active;
+    if (isPreview && raw.length > 0)
+        return raw;
+    return [];
+}
+/** Resolve product detail slug in storefront; in preview, map preview-item to first product. */
+export function resolveProductBySlugForDisplay(products, slug, isPreview) {
+    const list = resolveStoreProductsForDisplay(products, isPreview);
+    if (!list.length)
+        return undefined;
+    const normalized = (slug || '').trim();
+    if (normalized) {
+        const match = list.find((p) => p.slug === normalized || p.id === normalized);
+        if (match)
+            return match;
+    }
+    if (isPreview &&
+        (!normalized || normalized === 'preview-item' || normalized === 'preview-product')) {
+        return list[0];
+    }
+    return undefined;
+}
+/** Map store products to menu rows when food layouts only receive `products` in the editor. */
+export function productsToMenuItems(products) {
+    return products.map((p) => {
+        const image = resolveProductImageUrls(p.images)[0];
+        let inStock = true;
+        const inventoryProduct = p;
+        if (inventoryProduct.trackInventory !== false && Array.isArray(inventoryProduct.inventory)) {
+            inStock = inventoryProduct.inventory.some((inv) => (inv.quantity || 0) > 0);
+        }
+        else if (p.inStock === false) {
+            inStock = false;
+        }
+        return {
+            id: p.id,
+            name: p.name,
+            description: richFieldPlainTextForDisplay(p.description),
+            price: typeof p.price === 'number' ? p.price : Number(p.price) || 0,
+            image,
+            categoryId: p.categoryId || '',
+            inStock,
+        };
+    });
+}
+export function resolveMenuItemsForDisplay(menuItems, products, isPreview) {
+    const items = Array.isArray(menuItems) ? menuItems : [];
+    if (items.length > 0)
+        return items;
+    const catalog = resolveStoreProductsForDisplay(products, isPreview);
+    return catalog.length > 0 ? productsToMenuItems(catalog) : [];
+}
+const PREVIEW_CATEGORY_PLACEHOLDERS = [
+    {
+        id: 'preview-cat-1',
+        name: 'Menswear',
+        slug: 'men',
+        image: 'https://images.unsplash.com/photo-1490481651871-ab68de25d43d?q=80&w=1200',
+    },
+    {
+        id: 'preview-cat-2',
+        name: 'Womenswear',
+        slug: 'women',
+        image: 'https://images.unsplash.com/photo-1483985988355-763728e1935b?q=80&w=1200',
+    },
+];
+/** Categories for listing pages; preview placeholders only when catalog is still empty. */
+export function resolveStoreCategoriesForDisplay(categories, isPreview) {
+    const raw = Array.isArray(categories) ? categories : [];
+    if (raw.length > 0)
+        return raw;
+    if (isPreview)
+        return PREVIEW_CATEGORY_PLACEHOLDERS;
+    return [];
+}
+/** Resolve category detail slug; in preview, map preview-category to first category. */
+export function resolveCategoryBySlugForDisplay(categories, slug, isPreview) {
+    const list = resolveStoreCategoriesForDisplay(categories, isPreview);
+    if (!list.length)
+        return undefined;
+    const normalized = (slug || '').trim();
+    if (normalized) {
+        const match = list.find((c) => c.slug === normalized || c.id === normalized);
+        if (match)
+            return match;
+    }
+    if (isPreview &&
+        (!normalized ||
+            normalized === 'preview-category' ||
+            normalized === 'preview-item' ||
+            normalized === 'preview-product')) {
+        return list[0];
+    }
+    return undefined;
+}
+/**
+ * Services for listing/detail pages: prefer active catalog, but in editor preview
+ * fall back to all injected services (including drafts) so merchants see real inventory.
+ */
+export function resolveStoreServicesForDisplay(services, isPreview) {
+    const raw = Array.isArray(services) ? services : [];
+    const active = filterActiveServices(raw);
+    if (active.length > 0)
+        return active;
+    if (isPreview && raw.length > 0)
+        return raw;
+    return [];
+}
+/** Resolve service detail slug in storefront; in preview, map preview-service to first service. */
+export function resolveServiceBySlugForDisplay(services, slug, isPreview) {
+    const list = resolveStoreServicesForDisplay(services, isPreview);
+    if (!list.length)
+        return undefined;
+    const normalized = (slug || '').trim();
+    if (normalized) {
+        const match = list.find((s) => s.slug === normalized || s.id === normalized);
+        if (match)
+            return match;
+    }
+    if (isPreview &&
+        (!normalized || normalized === 'preview-service' || normalized === 'preview-item')) {
+        return list[0];
+    }
+    return undefined;
+}
+/** Products belonging to a category, with preview-aware active/draft resolution. */
+export function resolveCategoryProductsForDisplay(products, categoryId, isPreview) {
+    if (!categoryId)
+        return [];
+    const inCategory = (Array.isArray(products) ? products : []).filter((p) => p.categoryId === categoryId);
+    return resolveStoreProductsForDisplay(inCategory, isPreview);
+}
+/** Services belonging to a category, with preview-aware active/draft resolution. */
+export function resolveCategoryServicesForDisplay(services, categoryId, isPreview) {
+    if (!categoryId)
+        return [];
+    const inCategory = (Array.isArray(services) ? services : []).filter((s) => s.categoryId === categoryId);
+    return resolveStoreServicesForDisplay(inCategory, isPreview);
+}

package/dist/lib/utils/fee-calculations.d.ts

@@ -0,0 +1,35 @@
+export interface VATConfig {
+    type: 'flat' | 'percentage';
+    value: number;
+    enabled: boolean;
+}
+export interface ServiceChargeConfig {
+    type: 'flat' | 'percentage';
+    value: number;
+    enabled: boolean;
+    applyTo: 'pos' | 'online' | 'both';
+}
+/**
+ * Calculate VAT amount based on configuration
+ * @param subtotal - Subtotal amount
+ * @param vatConfig - VAT configuration
+ * @param taxRate - Deprecated: fallback tax rate (as decimal, e.g., 0.08 for 8%)
+ * @returns VAT amount
+ */
+export declare function calculateVAT(subtotal: number, vatConfig?: VATConfig | null, taxRate?: number): number;
+/**
+ * Calculate service charge amount based on configuration
+ * @param subtotal - Subtotal amount
+ * @param serviceChargeConfig - Service charge configuration
+ * @param applyTo - Context: 'pos' or 'online'
+ * @returns Service charge amount
+ */
+export declare function calculateServiceCharge(subtotal: number, serviceChargeConfig?: ServiceChargeConfig | null, applyTo?: 'pos' | 'online'): number;
+/**
+ * Get VAT label based on configuration
+ * @param vatConfig - VAT configuration
+ * @param taxRate - Deprecated: fallback tax rate
+ * @returns Label string ('VAT' or 'Tax')
+ */
+export declare function getVATLabel(vatConfig?: VATConfig | null, taxRate?: number): string;
+//# sourceMappingURL=fee-calculations.d.ts.map

package/dist/lib/utils/fee-calculations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fee-calculations.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/fee-calculations.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,GAAG,YAAY,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,GAAG,YAAY,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CACpC;AAoBD;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,EAC5B,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAeR;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,mBAAmB,CAAC,EAAE,mBAAmB,GAAG,IAAI,EAChD,OAAO,GAAE,KAAK,GAAG,QAAmB,GACnC,MAAM,CAuBR;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAOlF"}

package/dist/lib/utils/fee-calculations.js

@@ -0,0 +1,81 @@
+function isPercentageFeeType(type) {
+    return type === 'percentage';
+}
+function isFlatFeeType(type) {
+    return type === 'flat' || type === 'fixed';
+}
+/**
+ * Coerces a config value (which may arrive as a string or be missing) to a
+ * finite, non-negative number. Returns 0 for anything invalid so fee math
+ * never produces NaN (formatCurrency renders NaN as 0, silently corrupting totals).
+ */
+function safeFeeValue(value) {
+    const parsed = typeof value === 'string' ? parseFloat(value) : Number(value);
+    return Number.isFinite(parsed) && parsed >= 0 ? parsed : 0;
+}
+/**
+ * Calculate VAT amount based on configuration
+ * @param subtotal - Subtotal amount
+ * @param vatConfig - VAT configuration
+ * @param taxRate - Deprecated: fallback tax rate (as decimal, e.g., 0.08 for 8%)
+ * @returns VAT amount
+ */
+export function calculateVAT(subtotal, vatConfig, taxRate) {
+    const safeSubtotal = safeFeeValue(subtotal);
+    if (vatConfig?.enabled) {
+        const value = safeFeeValue(vatConfig.value);
+        if (isPercentageFeeType(vatConfig.type)) {
+            return safeSubtotal * (value / 100);
+        }
+        if (isFlatFeeType(vatConfig.type)) {
+            return value;
+        }
+    }
+    else if (taxRate !== undefined && taxRate !== null) {
+        // Fallback to deprecated taxRate for backward compatibility
+        return safeSubtotal * safeFeeValue(taxRate);
+    }
+    return 0;
+}
+/**
+ * Calculate service charge amount based on configuration
+ * @param subtotal - Subtotal amount
+ * @param serviceChargeConfig - Service charge configuration
+ * @param applyTo - Context: 'pos' or 'online'
+ * @returns Service charge amount
+ */
+export function calculateServiceCharge(subtotal, serviceChargeConfig, applyTo = 'online') {
+    if (!serviceChargeConfig?.enabled) {
+        return 0;
+    }
+    // Check if service charge should apply to this context
+    const shouldApply = serviceChargeConfig.applyTo === applyTo ||
+        serviceChargeConfig.applyTo === 'both' ||
+        !serviceChargeConfig.applyTo; // Default to 'both' if not specified
+    if (!shouldApply) {
+        return 0;
+    }
+    const value = safeFeeValue(serviceChargeConfig.value);
+    if (isPercentageFeeType(serviceChargeConfig.type)) {
+        return safeFeeValue(subtotal) * (value / 100);
+    }
+    if (isFlatFeeType(serviceChargeConfig.type)) {
+        return value;
+    }
+    return 0;
+}
+/**
+ * Get VAT label based on configuration
+ * @param vatConfig - VAT configuration
+ * @param taxRate - Deprecated: fallback tax rate
+ * @returns Label string ('VAT' or 'Tax')
+ */
+export function getVATLabel(vatConfig, taxRate) {
+    if (vatConfig?.enabled) {
+        return 'VAT';
+    }
+    else if (taxRate !== undefined && taxRate !== null) {
+        return 'Tax';
+    }
+    return 'Tax'; // Default
+}

package/dist/lib/utils/footer-nav-defaults.d.ts

@@ -0,0 +1,11 @@
+import type { StoreConfig } from '../store-types';
+export type FooterNavLink = {
+    label: string;
+    href: string;
+};
+/** Primary footer column links when merchant navigation.main is empty. */
+export declare function getDefaultFooterMainLinks(storeConfig: Pick<StoreConfig, 'layout' | 'type'>): FooterNavLink[];
+/** Support column links — layout-aware when navigation.main is empty. */
+export declare function getDefaultFooterSupportLinks(storeConfig: Pick<StoreConfig, 'layout' | 'type'>): FooterNavLink[];
+export declare function getFooterPrimaryColumnTitle(storeConfig: Pick<StoreConfig, 'layout' | 'type'>): string;
+//# sourceMappingURL=footer-nav-defaults.d.ts.map

package/dist/lib/utils/footer-nav-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"footer-nav-defaults.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/footer-nav-defaults.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,MAAM,MAAM,aAAa,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAM5D,0EAA0E;AAC1E,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,GAAG,MAAM,CAAC,GAChD,aAAa,EAAE,CAiCjB;AAED,yEAAyE;AACzE,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,GAAG,MAAM,CAAC,GAChD,aAAa,EAAE,CAwBjB;AAED,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,GAAG,MAAM,CAAC,GAChD,MAAM,CAMR"}

package/dist/lib/utils/footer-nav-defaults.js

@@ -0,0 +1,67 @@
+function layoutKey(storeConfig) {
+    return String(storeConfig.layout || storeConfig.type || '').toLowerCase();
+}
+/** Primary footer column links when merchant navigation.main is empty. */
+export function getDefaultFooterMainLinks(storeConfig) {
+    const key = layoutKey(storeConfig);
+    if (key === 'booking' || key === 'booking-agenda') {
+        return [
+            { label: 'Services', href: '/services' },
+            { label: 'Book Appointment', href: '/book' },
+            { label: 'About', href: '/about' },
+            { label: 'Contact', href: '/contact' },
+        ];
+    }
+    if (key === 'food' || key === 'food-modern') {
+        return [
+            { label: 'Menu', href: '/products' },
+            { label: 'Categories', href: '/categories' },
+            { label: 'Order Online', href: '/products' },
+        ];
+    }
+    if (key === 'motivational-speaker') {
+        return [
+            { label: 'Events', href: '/products' },
+            { label: 'About', href: '/about' },
+            { label: 'Contact', href: '/contact' },
+        ];
+    }
+    return [
+        { label: 'All Products', href: '/products' },
+        { label: 'New Arrivals', href: '/products?sort=newest' },
+        { label: 'Featured', href: '/products?featured=true' },
+    ];
+}
+/** Support column links — layout-aware when navigation.main is empty. */
+export function getDefaultFooterSupportLinks(storeConfig) {
+    const key = layoutKey(storeConfig);
+    if (key === 'booking' || key === 'booking-agenda') {
+        return [
+            { label: 'Help Center', href: '/help-center' },
+            { label: 'Book Appointment', href: '/book' },
+            { label: 'Contact Us', href: '/contact' },
+        ];
+    }
+    if (key === 'food' || key === 'food-modern') {
+        return [
+            { label: 'Help Center', href: '/help-center' },
+            { label: 'Track Order', href: '/track-order' },
+            { label: 'Contact', href: '/contact' },
+        ];
+    }
+    return [
+        { label: 'Help Center', href: '/help-center' },
+        { label: 'Track Order', href: '/track-order' },
+        { label: 'Style Guide', href: '/style-guide' },
+    ];
+}
+export function getFooterPrimaryColumnTitle(storeConfig) {
+    const key = layoutKey(storeConfig);
+    if (key === 'booking' || key === 'booking-agenda')
+        return 'Services';
+    if (key === 'food' || key === 'food-modern')
+        return 'Menu';
+    if (key === 'motivational-speaker')
+        return 'Explore';
+    return 'Shop';
+}

package/dist/lib/utils/idempotency-key.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Generate a client-side idempotency key for safe HTTP retries.
+ * Reuse the same key when retrying the same user action (e.g. checkout click).
+ */
+export declare function createIdempotencyKey(): string;
+/**
+ * Return an existing key from the ref or create a new one for this checkout attempt.
+ */
+export declare function getOrCreateIdempotencyKey(ref: {
+    current: string | null;
+}): string;
+export declare function resetIdempotencyKey(ref: {
+    current: string | null;
+}): void;
+//# sourceMappingURL=idempotency-key.d.ts.map

package/dist/lib/utils/idempotency-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"idempotency-key.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/idempotency-key.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAK7C;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE;IAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,MAAM,CAKjF;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE;IAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GAAG,IAAI,CAEzE"}

package/dist/lib/utils/idempotency-key.js

@@ -0,0 +1,22 @@
+/**
+ * Generate a client-side idempotency key for safe HTTP retries.
+ * Reuse the same key when retrying the same user action (e.g. checkout click).
+ */
+export function createIdempotencyKey() {
+    if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {
+        return crypto.randomUUID();
+    }
+    return `idem-${Date.now()}-${Math.random().toString(36).slice(2, 12)}`;
+}
+/**
+ * Return an existing key from the ref or create a new one for this checkout attempt.
+ */
+export function getOrCreateIdempotencyKey(ref) {
+    if (!ref.current) {
+        ref.current = createIdempotencyKey();
+    }
+    return ref.current;
+}
+export function resetIdempotencyKey(ref) {
+    ref.current = null;
+}

package/dist/lib/utils/index.d.ts

@@ -0,0 +1,45 @@
+import { type ClassValue } from "clsx";
+export declare function cn(...inputs: ClassValue[]): string;
+/**
+ * Normalizes a price value to a number
+ * Handles string, number, null, undefined, and invalid values
+ */
+export declare function normalizePrice(price: any): number;
+/**
+ * Formats display text with the first letter of each word capitalized.
+ * Normalizes ALL CAPS or inconsistent casing for UI labels (e.g. categories, brands).
+ */
+export declare function formatDisplayLabel(text: string): string;
+/** Formats a store name for UI display with the first letter of each word capitalized. */
+export declare function formatStoreDisplayName(name: string): string;
+/**
+ * Formats a price amount with the correct currency symbol and code
+ * Uses explicit currency symbol mapping for accurate symbol display
+ * @param amount - The price amount to format
+ * @param currencyCode - The ISO 4217 currency code (e.g., 'USD', 'NGN', 'EUR')
+ * @param options - Optional formatting options
+ * @returns Formatted currency string (e.g., "$1,234.56" or "₦1,234.56")
+ */
+export declare function formatCurrency(amount: number | string | null | undefined, currencyCode?: string | null | undefined, options?: {
+    minimumFractionDigits?: number;
+    maximumFractionDigits?: number;
+}): string;
+/**
+ * Converts API errors to user-friendly messages
+ */
+export declare function getUserFriendlyErrorMessage(error: any, defaultMessage?: string): string;
+export { filterActiveProducts, filterActiveServices, filterCategoriesForServices, } from './product-catalog';
+export { isEditorPreviewMode, resolveStoreProductsForDisplay, resolveProductBySlugForDisplay, resolveStoreCategoriesForDisplay, resolveCategoryBySlugForDisplay, resolveStoreServicesForDisplay, resolveServiceBySlugForDisplay, resolveCategoryProductsForDisplay, resolveCategoryServicesForDisplay, resolveMenuItemsForDisplay, productsToMenuItems, coalesceCatalog, applyEditorCatalogOverlay, applyStoreCatalogFromApi, syncFoodMenuItemsFromProducts, } from './editor-preview';
+export type { EditorCatalogOverlay } from './editor-preview';
+export { resolveProductImageUrls, getPrimaryProductImageUrl, normalizeStoreProductForDisplay, normalizeStoreProductsForDisplay, EDITOR_PRODUCT_IMAGE_PLACEHOLDER, } from './product-images';
+/**
+ * Deep clones an object using structuredClone if available, or a fallback recursive clone.
+ * This is more efficient and handles more types than JSON.parse(JSON.stringify).
+ */
+export declare function deepClone<T>(obj: T): T;
+/**
+ * Checks if two objects are deeply equal without using JSON.stringify.
+ * Optimized for performance by doing early exits and avoiding stringification.
+ */
+export declare function isDeepEqual(obj1: any, obj2: any): boolean;
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,UAAU,EAAE,MAAM,MAAM,CAAA;AAK5C,wBAAgB,EAAE,CAAC,GAAG,MAAM,EAAE,UAAU,EAAE,UAEzC;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,CASjD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKvD;AAED,0FAA0F;AAC1F,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,EAC1C,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACxC,OAAO,CAAC,EAAE;IACR,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC,GACA,MAAM,CAyDR;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,GAAG,EAAE,cAAc,GAAE,MAAkD,GAAG,MAAM,CA2ClI;AAED,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,mBAAmB,EACnB,8BAA8B,EAC9B,8BAA8B,EAC9B,gCAAgC,EAChC,+BAA+B,EAC/B,8BAA8B,EAC9B,8BAA8B,EAC9B,iCAAiC,EACjC,iCAAiC,EACjC,0BAA0B,EAC1B,mBAAmB,EACnB,eAAe,EACf,yBAAyB,EACzB,wBAAwB,EACxB,6BAA6B,GAC9B,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAE7D,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,+BAA+B,EAC/B,gCAAgC,EAChC,gCAAgC,GACjC,MAAM,kBAAkB,CAAC;AAE1B;;;GAGG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CA6BtC;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,GAAG,OAAO,CAwBzD"}