@selwise/widget 0.0.1

package/dist/npm/esm/shared/product-card/types.js

@@ -0,0 +1,63 @@
+/**
+ * Unified Product Type
+ * Normalizes Product (recommendation) and SearchHit (search) into a common interface
+ */
+/**
+ * Adapter: Convert recommendation Product to UnifiedProduct
+ */
+export function fromRecommendationProduct(product) {
+    return {
+        id: product.id,
+        itemCode: product.itemCode,
+        sku: product.sku,
+        title: product.title,
+        description: product.description,
+        shortDescription: product.shortDescription,
+        imageUrl: product.imageUrl, // Changed from 'image'
+        url: product.url,
+        price: product.price,
+        originalPrice: product.originalPrice,
+        discountRate: product.discountRate,
+        inStock: product.inStock,
+        stock: product.stock,
+        categories: product.categories, // Changed from 'category' (singular)
+        brand: product.brand,
+        productType: product.productType,
+        categoryHierarchy: product.categoryHierarchy,
+        isNew: product.isNew,
+        isSale: product.isSale ?? (product.originalPrice && product.originalPrice > product.price),
+        isBestseller: product.isBestseller,
+        rating: product.rating,
+        reviewCount: product.reviewCount,
+        variantId: product.variantId,
+        wooProductId: product.wooProductId,
+        magentoProductId: product.magentoProductId,
+        prestaProductId: product.prestaProductId,
+        attributeId: product.attributeId,
+    };
+}
+/**
+ * Adapter: Convert search SearchHit to UnifiedProduct
+ */
+export function fromSearchHit(hit) {
+    return {
+        id: hit.id,
+        itemCode: hit.itemCode,
+        title: hit.title, // Changed from 'name'
+        description: hit.description,
+        imageUrl: hit.imageUrl || '',
+        url: hit.url || '#', // Changed from 'link'
+        price: hit.price,
+        originalPrice: hit.originalPrice, // Changed from 'oldPrice'
+        discountRate: hit.discountRate,
+        inStock: hit.inStock,
+        categories: hit.categories,
+        brand: hit.brand,
+        rating: hit.rating,
+        reviewCount: hit.reviewCount,
+        isNew: hit.isNew,
+        isBestseller: hit.isBestseller,
+        isSale: hit.originalPrice && hit.originalPrice > hit.price,
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/npm/esm/shared/product-card/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/shared/product-card/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA6FH;;GAEG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAAY;IACpD,OAAO;QACL,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,QAAQ,EAAE,OAAO,CAAC,QAAQ;QAC1B,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;QAC1C,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAI,uBAAuB;QACrD,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,UAAU,EAAE,OAAO,CAAC,UAAU,EAAG,qCAAqC;QACtE,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;QAC5C,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,IAAI,OAAO,CAAC,aAAa,GAAG,OAAO,CAAC,KAAK,CAAC;QAC1F,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;QAC1C,eAAe,EAAE,OAAO,CAAC,eAAe;QACxC,WAAW,EAAE,OAAO,CAAC,WAAW;KACjC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,GAAQ;IACpC,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,QAAQ,EAAE,GAAG,CAAC,QAAQ;QACtB,KAAK,EAAE,GAAG,CAAC,KAAK,EAAS,sBAAsB;QAC/C,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,QAAQ,EAAE,GAAG,CAAC,QAAQ,IAAI,EAAE;QAC5B,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI,GAAG,EAAM,sBAAsB;QAC/C,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,aAAa,EAAE,GAAG,CAAC,aAAa,EAAG,0BAA0B;QAC7D,YAAY,EAAE,GAAG,CAAC,YAAY;QAC9B,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,YAAY,EAAE,GAAG,CAAC,YAAY;QAC9B,MAAM,EAAE,GAAG,CAAC,aAAa,IAAI,GAAG,CAAC,aAAa,GAAG,GAAG,CAAC,KAAK;KAC3D,CAAC;AACJ,CAAC"}

package/dist/npm/esm/types/config.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Widget Configuration Types
+ */
+export interface WidgetConfig {
+    siteKey: string;
+    apiUrl?: string;
+}
+export interface WidgetEntity {
+    id: string;
+    type: string;
+    isTestMode?: boolean;
+    contentJson: Record<string, any>;
+    stylesJson: Record<string, any>;
+    placementConfigJson: Record<string, any>;
+    pageTargetingJson?: {
+        showOnAllPages?: boolean;
+        includeUrls?: string[];
+        excludeUrls?: string[];
+    };
+    segmentTargetingMode?: string;
+    segmentIds?: string[] | any;
+}
+export interface Campaign extends WidgetEntity {
+}
+export interface Widget extends WidgetEntity {
+}

package/dist/npm/esm/types/config.js

@@ -0,0 +1,5 @@
+/**
+ * Widget Configuration Types
+ */
+export {};
+//# sourceMappingURL=config.js.map

package/dist/npm/esm/types/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../../src/types/config.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/npm/esm/types/experiments.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Experiment Type Definitions
+ */
+/**
+ * Experiment modes determine how variants are applied
+ * - CONFIG_OVERRIDE: Variant config overrides original entity config
+ * - DIFFERENT_MODULE: Variant replaces the original entity entirely
+ */
+export declare enum ExperimentMode {
+    CONFIG_OVERRIDE = "config_override",
+    DIFFERENT_MODULE = "different_module"
+}
+/**
+ * Module data for different_module mode experiments
+ * Contains the full module data to render instead of the original
+ */
+export interface ExperimentModuleData {
+    targetType: string;
+    data: any;
+}
+/**
+ * Experiment assignment for a visitor
+ * Returned from the public experiments/assign endpoint
+ */
+export interface ExperimentAssignment {
+    experimentId: string;
+    /** The mode of this experiment */
+    experimentMode?: ExperimentMode;
+    variantId: string;
+    variantName: string;
+    /** Legacy field for backwards compatibility */
+    targetId?: string;
+    /** The effective target ID (variant module for different_module, same as targetId for config_override) */
+    effectiveTargetId?: string;
+    /** Legacy field for backwards compatibility */
+    targetType?: string;
+    /** Legacy field for backwards compatibility */
+    controlTargetId?: string;
+    /** Variant config (for config_override mode) */
+    variantConfig?: Record<string, any>;
+    /** Legacy: config object */
+    config?: Record<string, any>;
+    /** Legacy: excluded target IDs */
+    excludedTargetIds?: string[];
+    /** Module data for different_module mode */
+    moduleData?: ExperimentModuleData;
+}

package/dist/npm/esm/types/experiments.js

@@ -0,0 +1,14 @@
+/**
+ * Experiment Type Definitions
+ */
+/**
+ * Experiment modes determine how variants are applied
+ * - CONFIG_OVERRIDE: Variant config overrides original entity config
+ * - DIFFERENT_MODULE: Variant replaces the original entity entirely
+ */
+export var ExperimentMode;
+(function (ExperimentMode) {
+    ExperimentMode["CONFIG_OVERRIDE"] = "config_override";
+    ExperimentMode["DIFFERENT_MODULE"] = "different_module";
+})(ExperimentMode || (ExperimentMode = {}));
+//# sourceMappingURL=experiments.js.map

package/dist/npm/esm/types/experiments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"experiments.js","sourceRoot":"","sources":["../../../../src/types/experiments.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;GAIG;AACH,MAAM,CAAN,IAAY,cAGX;AAHD,WAAY,cAAc;IACxB,qDAAmC,CAAA;IACnC,uDAAqC,CAAA;AACvC,CAAC,EAHW,cAAc,KAAd,cAAc,QAGzB"}

package/dist/npm/esm/types/global-api.d.ts

@@ -0,0 +1,40 @@
+import type { ConsentState, SelwiseDataLayer } from '../datalayer/types';
+import type { WidgetConfig } from './config';
+export interface SelwiseGlobalApi {
+    siteKey?: string;
+    apiUrl?: string;
+    trackingConfig?: any;
+    init?: (config: Partial<WidgetConfig>) => Promise<void>;
+    destroy?: () => void;
+    track?: (name: string, args?: {
+        entityType?: string;
+        entityId?: string;
+        metadata?: Record<string, any>;
+    }) => void;
+    trackOrder?: (order: Record<string, any>) => Promise<void>;
+    identify?: (userId: string, metadata?: Record<string, any>) => Promise<{
+        success: boolean;
+        merged?: boolean;
+    }>;
+    setTraits?: (traits: Record<string, any>) => Promise<boolean>;
+    getSiteUserId?: () => string | undefined;
+    getVisitorId?: () => string;
+    getSessionId?: () => string;
+    getJourneyId?: () => string | null;
+    getJourneyState?: () => {
+        journeyId: string | null;
+        age: number | null;
+        isValid: boolean;
+    };
+    endJourney?: () => void;
+    getVariant?: (experimentId: string) => any;
+    getExperimentVariant?: (experimentId: string) => string | null;
+    getActiveExperiments?: () => any[];
+    pushDataLayer?: (data: SelwiseDataLayer) => void;
+    getDataLayer?: () => SelwiseDataLayer[];
+    getConsentState?: () => ConsentState | null;
+    grantConsent?: (categories?: Partial<ConsentState>) => void;
+    revokeConsent?: (categories?: (keyof ConsentState)[]) => void;
+    _flushConsentQueue?: () => void;
+    _consentChangeCallback?: string;
+}

package/dist/npm/esm/types/global-api.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=global-api.js.map

package/dist/npm/esm/types/global-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-api.js","sourceRoot":"","sources":["../../../../src/types/global-api.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,9 @@
+/**
+ * Central Type Exports
+ */
+export * from './config';
+export * from './experiments';
+export * from './renderer';
+export * from './recommendation';
+export * from './search';
+export * from './global-api';

package/dist/npm/esm/types/index.js

@@ -0,0 +1,11 @@
+/**
+ * Central Type Exports
+ */
+// Re-export all types
+export * from './config.js';
+export * from './experiments.js';
+export * from './renderer.js';
+export * from './recommendation.js';
+export * from './search.js';
+export * from './global-api.js';
+//# sourceMappingURL=index.js.map

package/dist/npm/esm/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,sBAAsB;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC"}

package/dist/npm/esm/types/recommendation.d.ts

@@ -0,0 +1,186 @@
+/**
+ * Recommendation Module Type Definitions
+ */
+export type RecommendationInsertPosition = 'append' | 'prepend' | 'before' | 'after' | 'replace';
+export interface RecommendationWidget {
+    id: string;
+    name: string;
+    strategy: string;
+    displayType: string;
+    title: string;
+    subtitle: string;
+    maxProducts: number;
+    slidesPerView: number;
+    slidesPerViewMobile: number;
+    slidesPerViewTablet: number;
+    slideGap: number;
+    autoplay: boolean;
+    autoplaySpeed: number;
+    loop: boolean;
+    pauseOnHover: boolean;
+    arrowStyles: ArrowStyles;
+    dotStyles: DotStyles;
+    titleStyles: TitleStyles;
+    subtitleStyles: SubtitleStyles;
+    containerStyles: ContainerStyles;
+    containerSelector: string;
+    insertPosition: RecommendationInsertPosition;
+    addToCartEnabled: boolean;
+    cartPlatform?: string;
+    addToCartConfig?: any;
+    cartButtonText?: string;
+    customCartScript?: string;
+    customCSS?: string;
+    customJS?: string;
+    productCard?: ProductCardDefinition;
+    pageTargetingJson?: {
+        showOnAllPages: boolean;
+        includeUrls: string[];
+        excludeUrls: string[];
+        containerSelector?: string;
+        insertPosition?: RecommendationInsertPosition;
+    };
+    segmentTargetingMode?: 'all' | 'include' | 'exclude';
+    segmentIds?: string[];
+}
+export interface ArrowStyles {
+    enabled: boolean;
+    style: string;
+    size: number;
+    color: string;
+    backgroundColor: string;
+    borderColor: string;
+    borderWidth: number;
+    borderRadius: number;
+    iconSize: number;
+    hoverColor: string;
+    hoverBackgroundColor: string;
+    position: string;
+    offset: number;
+}
+export interface DotStyles {
+    enabled: boolean;
+    style: string;
+    size: number;
+    color: string;
+    activeColor: string;
+    gap: number;
+    position: string;
+    offset: number;
+}
+export interface TitleStyles {
+    enabled: boolean;
+    fontSize: number;
+    fontWeight: string;
+    color: string;
+    textAlign: string;
+    marginBottom: number;
+}
+export interface SubtitleStyles {
+    enabled: boolean;
+    fontSize: number;
+    fontWeight: string;
+    color: string;
+    textAlign: string;
+    marginBottom: number;
+}
+export interface ContainerStyles {
+    backgroundColor: string;
+    padding: string;
+    borderRadius: number;
+    maxWidth: string;
+    margin: string;
+}
+export interface ProductCardDefinition {
+    id: string;
+    template: string;
+    fields: any[];
+    layoutType?: string;
+    imagePosition?: string;
+    imageSize?: string;
+    showBadges?: boolean;
+    showButton?: boolean;
+    buttonText?: string;
+    buttonStyle?: any;
+    cardStyles?: any;
+    imageStyles?: any;
+    titleStyles?: any;
+    priceStyles?: any;
+    buttonStyles?: any;
+    badgeConfig?: any;
+    hoverEffect?: string;
+    customCSS?: string;
+    customHTML?: string;
+    customJs?: string;
+    jsTiming?: 'immediate' | 'domReady' | 'customEvent';
+    jsEventName?: string;
+}
+/**
+ * Product interface
+ *
+ * IMPORTANT: Product Identification
+ * - `id` is the primary merchant product identifier for tracking events
+ * - `_uuid` is the internal database UUID and must not be used in tracking
+ * - `itemCode` mirrors the primary product identifier
+ *
+ * When tracking events, always use `id` (or mirrored `itemCode`), never `_uuid`.
+ */
+export interface Product {
+    /**
+     * PRIMARY PRODUCT IDENTIFIER
+     * Merchant product identifier used in tracking events
+     */
+    id: string;
+    /**
+     * Internal database UUID
+     * WARNING: Never send this in tracking events!
+     * This is only used for internal server-side joins and references.
+     */
+    _uuid?: string;
+    /**
+     * Merchant's product ID (same as `id`)
+     * Mirrored merchant product identifier
+     */
+    itemCode?: string;
+    /**
+     * Optional separate SKU field
+     * Some merchants have different SKU than their main product ID
+     */
+    sku?: string;
+    title: string;
+    description?: string;
+    shortDescription?: string;
+    price: number;
+    originalPrice?: number;
+    imageUrl: string;
+    url: string;
+    categories?: string;
+    brand?: string;
+    rating?: number;
+    reviewCount?: number;
+    inStock?: boolean;
+    stock?: number;
+    isNew?: boolean;
+    isSale?: boolean;
+    isBestseller?: boolean;
+    productType?: string;
+    categoryHierarchy?: string;
+    [key: string]: any;
+}
+export interface RecommendationConfig {
+    siteKey: string;
+    apiEndpoint: string;
+    experimentManager?: any;
+    segmentManager?: any;
+    widgets?: RecommendationWidget[];
+    currentProductId?: string;
+    detectCurrentProduct?: () => string | null;
+}
+export interface SliderState {
+    currentIndex: number;
+    totalSlides: number;
+    slidesPerView: number;
+    autoplayInterval?: number;
+    touchStartX: number;
+    touchEndX: number;
+}

package/dist/npm/esm/types/recommendation.js

@@ -0,0 +1,5 @@
+/**
+ * Recommendation Module Type Definitions
+ */
+export {};
+//# sourceMappingURL=recommendation.js.map

package/dist/npm/esm/types/recommendation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recommendation.js","sourceRoot":"","sources":["../../../../src/types/recommendation.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/npm/esm/types/renderer.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Renderer Type Definitions
+ */
+export interface RendererWidget {
+    id: string;
+    type: string;
+    placementConfigJson: {
+        placementType?: 'fixed' | 'selector' | 'both';
+        position?: 'top' | 'bottom' | 'left' | 'right' | 'top-left' | 'top-right' | 'center' | 'center-modal' | 'bottom-left' | 'bottom-right';
+        selector?: string;
+        insertPosition?: 'before' | 'after' | 'inside-start' | 'inside-end' | 'replace';
+    };
+}
+export interface RendererCampaign {
+    id: string;
+    contentJson: {
+        title?: string;
+        headline?: string;
+        text?: string;
+        subtext?: string;
+        buttonText?: string;
+        buttonUrl?: string;
+        imageUrl?: string;
+        iconType?: string;
+        tooltip?: string;
+        endDate?: string;
+        closeable?: boolean;
+        html?: string;
+        declineButtonText?: string;
+        customizeButtonText?: string;
+        [key: string]: any;
+    };
+    stylesJson?: {
+        backgroundColor?: string;
+        textColor?: string;
+        buttonColor?: string;
+        buttonTextColor?: string;
+        closeButtonColor?: string;
+        declineButtonColor?: string;
+        declineButtonTextColor?: string;
+        customizeButtonColor?: string;
+        customizeButtonTextColor?: string;
+        timerBgColor?: string;
+        overlayColor?: string;
+        overlayOpacity?: string | number;
+        tooltipBgColor?: string;
+        tooltipTextColor?: string;
+        linkColor?: string;
+        padding?: string;
+        fontSize?: string;
+        fontWeight?: string;
+        borderRadius?: string;
+        maxWidth?: string;
+        width?: string;
+        size?: string;
+        offsetX?: string;
+        offsetY?: string;
+        shadow?: string;
+        border?: string;
+        borderTop?: string;
+        borderBottom?: string;
+        overlayBlur?: string;
+        animation?: string;
+        showCloseButton?: boolean;
+        pulseAnimation?: boolean;
+        compactMode?: boolean;
+        showBadge?: boolean;
+        imageSize?: string;
+        imageBorderRadius?: string;
+        imageAspectRatio?: string;
+        imageObjectFit?: string;
+        imageMode?: 'thumbnail' | 'cover' | 'contain' | 'fullWidth' | 'background';
+        imagePosition?: 'top' | 'bottom' | 'left' | 'right';
+        imageSpacing?: string;
+        contentDirection?: 'row' | 'column';
+        contentAlignment?: 'left' | 'center' | 'right';
+        timerFontSize?: string;
+        timerFontWeight?: string;
+        separatorStyle?: string;
+        headlineFontSize?: string;
+        headlineFontWeight?: string;
+        textFontSize?: string;
+        buttonFontSize?: string;
+        buttonFontWeight?: string;
+        granularEnabled?: boolean;
+        requiredCategories?: string | string[];
+        timeoutMs?: number;
+        autoHideAfterMs?: number;
+        containerPadding?: string;
+        containerBackground?: string;
+        badgeText?: string;
+        badgeColor?: string;
+        badgeTextColor?: string;
+        css?: string;
+        javascript?: string;
+        jsTiming?: 'immediate' | 'domReady' | 'customEvent';
+        [key: string]: any;
+    };
+}

package/dist/npm/esm/types/renderer.js

@@ -0,0 +1,5 @@
+/**
+ * Renderer Type Definitions
+ */
+export {};
+//# sourceMappingURL=renderer.js.map

package/dist/npm/esm/types/renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.js","sourceRoot":"","sources":["../../../../src/types/renderer.ts"],"names":[],"mappings":"AAAA;;GAEG"}