yt-uikit 0.8.15-MixAndMatchErrorFix.0 → 0.8.15-debug.0

package/dist/esm/types/utils/freebieValidation.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Validation utilities for Freebie Claim components
+ * Validates product data, configuration, and required props
+ */
+export interface ValidationResult {
+    isValid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * Validate that required props are present
+ */
+export declare const validateRequiredProps: (component: string, props: {
+    freebieProductsInCart?: any[];
+    addFreebieToCart?: Function;
+    freebiesInCart?: string[];
+}) => ValidationResult;
+/**
+ * Validate product data structure
+ */
+export declare const validateProductData: (component: string, product: any, index?: number) => ValidationResult;
+/**
+ * Validate all products in cart
+ */
+export declare const validateAllProducts: (component: string, products: any[]) => ValidationResult;
+/**
+ * Validate variant data
+ */
+export declare const validateVariantData: (component: string, variant: any, productId?: string) => ValidationResult;
+/**
+ * Validate checkpoint data
+ */
+export declare const validateCheckpoint: (component: string, checkpoint: any) => ValidationResult;
+/**
+ * Validate freebie claim configuration
+ */
+export declare const validateFreebieClaimData: (component: string, freebieClaimData: any) => ValidationResult;
+/**
+ * Validate that products match inventory requirements
+ */
+export declare const validateInventoryQuantity: (component: string, product: any, shouldCheckInventoryQuantity: boolean) => ValidationResult;
+/**
+ * Log validation summary
+ */
+export declare const logValidationSummary: (component: string, validationResults: ValidationResult[]) => void;

package/dist/esm/types/utils/index.d.ts

@@ -1,14 +1,14 @@
-export declare const getAdjustedTitle: (title: string, length?: number) => string;
-export declare const getAdjustedTitleByCanvas: (title: string, maxWidthPercentage: number, containerWidth: number, fontFamily?: string, fontSize?: string) => string;
-export declare function getColorWithAlpha(colorHex: string, alpha: number): string;
-export declare function hexToRGBWithOpacity(hex: any, opacity: any): string;
-export declare const getIdFromGid: (gid: string) => string | undefined;
-export declare function getCookieValue(cookieName: string): string;
-export declare const extractShopifyProductOrVariantId: (id: string) => string;
-export declare function setContrastTextColor(element: HTMLElement | null, lightColor?: string, darkColor?: string, threshold?: number): void;
-export declare const formatPriceWithCommas: (price: number | string) => string;
-export declare const shouldRenderCheckoutMessageInCartList: () => boolean;
-export declare const shouldUseBWTheme: () => boolean;
-export declare const optimizeShopifyImage: (imageUrl: string | undefined | null, size?: number, quality?: number, format?: "webp" | "auto" | "jpg" | "png") => string;
-export declare const darkenColor: (color: string | undefined, amount?: number) => string;
-export declare const extractBundleDiscountTitle: (discountTitle: string) => string;
+export declare const getAdjustedTitle: (title: string, length?: number) => string;
+export declare const getAdjustedTitleByCanvas: (title: string, maxWidthPercentage: number, containerWidth: number, fontFamily?: string, fontSize?: string) => string;
+export declare function getColorWithAlpha(colorHex: string, alpha: number): string;
+export declare function hexToRGBWithOpacity(hex: any, opacity: any): string;
+export declare const getIdFromGid: (gid: string) => string | undefined;
+export declare function getCookieValue(cookieName: string): string;
+export declare const extractShopifyProductOrVariantId: (id: string) => string;
+export declare function setContrastTextColor(element: HTMLElement | null, lightColor?: string, darkColor?: string, threshold?: number): void;
+export declare const formatPriceWithCommas: (price: number | string) => string;
+export declare const shouldRenderCheckoutMessageInCartList: () => boolean;
+export declare const shouldUseBWTheme: () => boolean;
+export declare const optimizeShopifyImage: (imageUrl: string | undefined | null, size?: number, quality?: number, format?: "webp" | "auto" | "jpg" | "png") => string;
+export declare const darkenColor: (color: string | undefined, amount?: number) => string;
+export declare const extractBundleDiscountTitle: (discountTitle: string) => string;

package/dist/esm/utils/converter.d.ts

@@ -1,2 +1,2 @@
-export declare const getCurrencyValueFromShopifyPrice: (price: number, currency: string) => number;
-export declare const getCurrencySymbol: (cartData: any, currency?: string) => string;
+export declare const getCurrencyValueFromShopifyPrice: (price: number, currency: string) => number;
+export declare const getCurrencySymbol: (cartData: any, currency?: string) => string;

package/dist/esm/utils/customVariantOptions.d.ts

@@ -1,20 +1,20 @@
-export interface CustomVariantValue {
-    name: string;
-    value: string;
-}
-export interface CustomVariantOption {
-    id?: string;
-    name: string;
-    type?: "text" | "image" | "color" | string;
-    values: CustomVariantValue[];
-}
-export interface CustomVariantOptions {
-    options: CustomVariantOption[];
-}
-export declare const normalizeVariantLabel: (label?: string) => string;
-export declare const extractHexFromLabel: (label?: string) => string | null;
-export declare const loadCustomVariantOptions: () => CustomVariantOptions | null;
-export declare const saveCustomVariantOptions: (input: CustomVariantOptions | CustomVariantOption[]) => void;
-export declare const clearCustomVariantOptions: () => void;
-export declare const findMatchingCustomVariantValue: (customOption: CustomVariantOption | undefined, optionValue?: string) => CustomVariantValue | undefined;
-export declare const useCustomVariantOptions: () => CustomVariantOptions | null;
+export interface CustomVariantValue {
+    name: string;
+    value: string;
+}
+export interface CustomVariantOption {
+    id?: string;
+    name: string;
+    type?: "text" | "image" | "color" | string;
+    values: CustomVariantValue[];
+}
+export interface CustomVariantOptions {
+    options: CustomVariantOption[];
+}
+export declare const normalizeVariantLabel: (label?: string) => string;
+export declare const extractHexFromLabel: (label?: string) => string | null;
+export declare const loadCustomVariantOptions: () => CustomVariantOptions | null;
+export declare const saveCustomVariantOptions: (input: CustomVariantOptions | CustomVariantOption[]) => void;
+export declare const clearCustomVariantOptions: () => void;
+export declare const findMatchingCustomVariantValue: (customOption: CustomVariantOption | undefined, optionValue?: string) => CustomVariantValue | undefined;
+export declare const useCustomVariantOptions: () => CustomVariantOptions | null;

package/dist/esm/utils/freebieErrorLogger.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Centralized error logging utility for Freebie Claim components
+ * Provides detailed error logging with context to help debug issues across stores
+ */
+export declare enum FreebieErrorSeverity {
+    WARNING = "WARNING",
+    ERROR = "ERROR",
+    CRITICAL = "CRITICAL"
+}
+export interface FreebieErrorContext {
+    component?: string;
+    productId?: string;
+    productTitle?: string;
+    variantId?: string;
+    checkpointId?: number;
+    storeData?: any;
+    additionalData?: any;
+}
+export interface FreebieError {
+    severity: FreebieErrorSeverity;
+    message: string;
+    context: FreebieErrorContext;
+    timestamp: string;
+}
+declare class FreebieErrorLogger {
+    private errors;
+    private maxErrors;
+    /**
+     * Log an error with context
+     */
+    log(severity: FreebieErrorSeverity, message: string, context?: FreebieErrorContext): void;
+    /**
+     * Log a warning
+     */
+    warn(message: string, context?: FreebieErrorContext): void;
+    /**
+     * Log an error
+     */
+    error(message: string, context?: FreebieErrorContext): void;
+    /**
+     * Log a critical error
+     */
+    critical(message: string, context?: FreebieErrorContext): void;
+    /**
+     * Get all logged errors
+     */
+    getErrors(): FreebieError[];
+    /**
+     * Get errors by severity
+     */
+    getErrorsBySeverity(severity: FreebieErrorSeverity): FreebieError[];
+    /**
+     * Clear all errors
+     */
+    clearErrors(): void;
+    /**
+     * Export errors as JSON for debugging
+     */
+    exportErrors(): string;
+}
+export declare const freebieErrorLogger: FreebieErrorLogger;
+export declare const logMissingProp: (component: string, propName: string, additionalContext?: any) => void;
+export declare const logInvalidData: (component: string, dataType: string, issue: string, data?: any) => void;
+export declare const logProductError: (component: string, message: string, productId?: string, productTitle?: string, additionalData?: any) => void;
+export declare const logVariantError: (component: string, message: string, productId?: string, variantId?: string, additionalData?: any) => void;
+export declare const logCheckpointError: (component: string, message: string, checkpointId?: number, additionalData?: any) => void;
+export declare const logWarning: (component: string, message: string, context?: FreebieErrorContext) => void;
+export {};

package/dist/esm/utils/freebieProductUtils.d.ts

@@ -1,23 +1,23 @@
-export declare const isVariantAvailable: (product: any, variantNode: any) => boolean;
-export interface ProcessedFreebieProduct {
-    selectedVariantId?: string;
-    selectedVariantGid?: string;
-    selectedVariantPrice: number;
-    availableVariants: any[];
-    displayVariantCount: number;
-    effectiveDiscount: number;
-    effectivePrice: number;
-    dealAmount: number;
-    showOptions: boolean;
-    isFree: boolean;
-}
-/**
- * Process freebie product data to extract pricing, variant, and display information
- * Consolidates expensive calculations that were happening in multiple components
- */
-export declare const processFreebieProduct: (product: any, freebieCouponTemplates?: any[], localVariantId?: string) => ProcessedFreebieProduct;
-/**
- * Get initial variant ID with deal amount preference
- * Used by FreebieClaimSectionCard for smart variant selection
- */
-export declare const getInitialVariantWithDealAmount: (availableVariants: any[], freebieCouponTemplates?: any[]) => string | undefined;
+export declare const isVariantAvailable: (product: any, variantNode: any) => boolean;
+export interface ProcessedFreebieProduct {
+    selectedVariantId?: string;
+    selectedVariantGid?: string;
+    selectedVariantPrice: number;
+    availableVariants: any[];
+    displayVariantCount: number;
+    effectiveDiscount: number;
+    effectivePrice: number;
+    dealAmount: number;
+    showOptions: boolean;
+    isFree: boolean;
+}
+/**
+ * Process freebie product data to extract pricing, variant, and display information
+ * Consolidates expensive calculations that were happening in multiple components
+ */
+export declare const processFreebieProduct: (product: any, freebieCouponTemplates?: any[], localVariantId?: string) => ProcessedFreebieProduct;
+/**
+ * Get initial variant ID with deal amount preference
+ * Used by FreebieClaimSectionCard for smart variant selection
+ */
+export declare const getInitialVariantWithDealAmount: (availableVariants: any[], freebieCouponTemplates?: any[]) => string | undefined;

package/dist/esm/utils/freebieUtils.d.ts

@@ -1,5 +1,5 @@
-/**
- * Shared utility function for adding freebie products to cart
- * Used by both FreebieClaimManager and FreebieClaimSection to avoid code duplication
- */
-export declare const addFreebieProductsToCart: (selectedProductIds: string[], freebieProductsInCart: any[], addFreebieToCart?: ((variantId: string, originalAllowedVariantIds?: string[]) => Promise<void>) | undefined) => Promise<void>;
+/**
+ * Shared utility function for adding freebie products to cart
+ * Used by both FreebieClaimManager and FreebieClaimSection to avoid code duplication
+ */
+export declare const addFreebieProductsToCart: (selectedProductIds: string[], freebieProductsInCart: any[], addFreebieToCart?: ((variantId: string, originalAllowedVariantIds?: string[]) => Promise<void>) | undefined) => Promise<void>;

package/dist/esm/utils/freebieValidation.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Validation utilities for Freebie Claim components
+ * Validates product data, configuration, and required props
+ */
+export interface ValidationResult {
+    isValid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * Validate that required props are present
+ */
+export declare const validateRequiredProps: (component: string, props: {
+    freebieProductsInCart?: any[];
+    addFreebieToCart?: Function;
+    freebiesInCart?: string[];
+}) => ValidationResult;
+/**
+ * Validate product data structure
+ */
+export declare const validateProductData: (component: string, product: any, index?: number) => ValidationResult;
+/**
+ * Validate all products in cart
+ */
+export declare const validateAllProducts: (component: string, products: any[]) => ValidationResult;
+/**
+ * Validate variant data
+ */
+export declare const validateVariantData: (component: string, variant: any, productId?: string) => ValidationResult;
+/**
+ * Validate checkpoint data
+ */
+export declare const validateCheckpoint: (component: string, checkpoint: any) => ValidationResult;
+/**
+ * Validate freebie claim configuration
+ */
+export declare const validateFreebieClaimData: (component: string, freebieClaimData: any) => ValidationResult;
+/**
+ * Validate that products match inventory requirements
+ */
+export declare const validateInventoryQuantity: (component: string, product: any, shouldCheckInventoryQuantity: boolean) => ValidationResult;
+/**
+ * Log validation summary
+ */
+export declare const logValidationSummary: (component: string, validationResults: ValidationResult[]) => void;

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

@@ -1,14 +1,14 @@
-export declare const getAdjustedTitle: (title: string, length?: number) => string;
-export declare const getAdjustedTitleByCanvas: (title: string, maxWidthPercentage: number, containerWidth: number, fontFamily?: string, fontSize?: string) => string;
-export declare function getColorWithAlpha(colorHex: string, alpha: number): string;
-export declare function hexToRGBWithOpacity(hex: any, opacity: any): string;
-export declare const getIdFromGid: (gid: string) => string | undefined;
-export declare function getCookieValue(cookieName: string): string;
-export declare const extractShopifyProductOrVariantId: (id: string) => string;
-export declare function setContrastTextColor(element: HTMLElement | null, lightColor?: string, darkColor?: string, threshold?: number): void;
-export declare const formatPriceWithCommas: (price: number | string) => string;
-export declare const shouldRenderCheckoutMessageInCartList: () => boolean;
-export declare const shouldUseBWTheme: () => boolean;
-export declare const optimizeShopifyImage: (imageUrl: string | undefined | null, size?: number, quality?: number, format?: "webp" | "auto" | "jpg" | "png") => string;
-export declare const darkenColor: (color: string | undefined, amount?: number) => string;
-export declare const extractBundleDiscountTitle: (discountTitle: string) => string;
+export declare const getAdjustedTitle: (title: string, length?: number) => string;
+export declare const getAdjustedTitleByCanvas: (title: string, maxWidthPercentage: number, containerWidth: number, fontFamily?: string, fontSize?: string) => string;
+export declare function getColorWithAlpha(colorHex: string, alpha: number): string;
+export declare function hexToRGBWithOpacity(hex: any, opacity: any): string;
+export declare const getIdFromGid: (gid: string) => string | undefined;
+export declare function getCookieValue(cookieName: string): string;
+export declare const extractShopifyProductOrVariantId: (id: string) => string;
+export declare function setContrastTextColor(element: HTMLElement | null, lightColor?: string, darkColor?: string, threshold?: number): void;
+export declare const formatPriceWithCommas: (price: number | string) => string;
+export declare const shouldRenderCheckoutMessageInCartList: () => boolean;
+export declare const shouldUseBWTheme: () => boolean;
+export declare const optimizeShopifyImage: (imageUrl: string | undefined | null, size?: number, quality?: number, format?: "webp" | "auto" | "jpg" | "png") => string;
+export declare const darkenColor: (color: string | undefined, amount?: number) => string;
+export declare const extractBundleDiscountTitle: (discountTitle: string) => string;