@fast-simon/dashboard-utilities 1.0.141-beta.4 → 1.0.141

package/dist/@types/autocomplete.d.ts

@@ -31,6 +31,8 @@ export interface autocompleteProps {
     variation_id?: string | null;
     force_and?: boolean;
     ps?: 'new' | 'returning' | null;
+    spv?: string | null;
+    personalization?: string | null;
 }
 export interface AutocompleteReasoningResponse {
     auto_facets?: boolean;

package/dist/@types/autocomplete.js.map

@@ -1 +1 @@
-{"version":3,"file":"autocomplete.js","sourceRoot":"","sources":["../../src/@types/autocomplete.ts"],"names":[],"mappings":"","sourcesContent":["import {ServerProduct} from \"./product\";\nimport {Facet, FastCategory, FastTurbolinks} from \"./facets\";\nimport {PopularSearch, ContextFilteringData, QueryUnderstanding} from \"./results\";\nimport {SortBy} from \"./sortBy\";\n\n\n\nexport interface AutocompleteResults {\n    totalResults: number,\n    categories?: FastCategory[],\n    products: ServerProduct[]\n    turbolinks?: FastTurbolinks[]\n    popularSearches: PopularSearch[]\n    query: string\n}\n\nexport interface autocompleteProps {\n    storeID: number\n    uuid: string\n    siteKey?:string\n    cdn?: number\n    term: string,\n    userToken: string,\n    sessionStart: number,\n    withAttributes?: boolean\n    segments?: string[],\n    hasShopifyMarkets?: boolean,\n    disable_turbolinks?:boolean\n    disable_strategies?:boolean\n    disable_merchandising?:boolean\n    disable_semantics?:boolean\n    disable_merchandising_rules?:boolean\n    disable_antonyms?:boolean\n    market_context?: string | null  // Region code for market-specific filtering (e.g., \"US\", \"CA\", \"UK\")\n    variation_id?: string | null  // A/B test variation ID for reasoning/experiment tracking\n    force_and?: boolean\n    ps?: 'new' | 'returning' | null\n}\nexport interface AutocompleteReasoningResponse {\n    auto_facets?: boolean\n    isp_quick_view_mode?: number\n    products: ServerProduct[]\n    merch: {\n        prorduct:any,\n        rules:any,\n        strategy:any,\n        visual:any\n    }\n    personalized_products:any[]\n    term:string\n    totalResults: number\n    uuid:string\n\n    //all bellow wont be never field but to keep consistent with all the AIExplainer implementation\n    sortBy?:SortBy\n    within_search_results_for?: string,\n    isNoResults?:any,\n    pageCount?:number,\n    narrow?: [string, string, string][],\n    facets?: Facet[],\n    page?: number,\n    results_for?: string,\n    id_list?:number[]\n    turbolink?: string\n    context?: ContextFilteringData  // Context-based filtering data (market contexts)\n    query_understanding?: QueryUnderstanding\n    reformulation_source?: string\n    request_url?: string  // Full URL with all params that was executed (for debugging)\n}"]}
+{"version":3,"file":"autocomplete.js","sourceRoot":"","sources":["../../src/@types/autocomplete.ts"],"names":[],"mappings":"","sourcesContent":["import {ServerProduct} from \"./product\";\nimport {Facet, FastCategory, FastTurbolinks} from \"./facets\";\nimport {PopularSearch, ContextFilteringData, QueryUnderstanding} from \"./results\";\nimport {SortBy} from \"./sortBy\";\n\n\n\nexport interface AutocompleteResults {\n    totalResults: number,\n    categories?: FastCategory[],\n    products: ServerProduct[]\n    turbolinks?: FastTurbolinks[]\n    popularSearches: PopularSearch[]\n    query: string\n}\n\nexport interface autocompleteProps {\n    storeID: number\n    uuid: string\n    siteKey?:string\n    cdn?: number\n    term: string,\n    userToken: string,\n    sessionStart: number,\n    withAttributes?: boolean\n    segments?: string[],\n    hasShopifyMarkets?: boolean,\n    disable_turbolinks?:boolean\n    disable_strategies?:boolean\n    disable_merchandising?:boolean\n    disable_semantics?:boolean\n    disable_merchandising_rules?:boolean\n    disable_antonyms?:boolean\n    market_context?: string | null  // Region code for market-specific filtering (e.g., \"US\", \"CA\", \"UK\")\n    variation_id?: string | null  // A/B test variation ID for reasoning/experiment tracking\n    force_and?: boolean\n    ps?: 'new' | 'returning' | null\n    spv?: string | null  // Session Product Views JSON for personalization preview\n    personalization?: string | null  // Comma-separated personalization types to enable (e.g., 'gender')\n}\nexport interface AutocompleteReasoningResponse {\n    auto_facets?: boolean\n    isp_quick_view_mode?: number\n    products: ServerProduct[]\n    merch: {\n        prorduct:any,\n        rules:any,\n        strategy:any,\n        visual:any\n    }\n    personalized_products:any[]\n    term:string\n    totalResults: number\n    uuid:string\n\n    //all bellow wont be never field but to keep consistent with all the AIExplainer implementation\n    sortBy?:SortBy\n    within_search_results_for?: string,\n    isNoResults?:any,\n    pageCount?:number,\n    narrow?: [string, string, string][],\n    facets?: Facet[],\n    page?: number,\n    results_for?: string,\n    id_list?:number[]\n    turbolink?: string\n    context?: ContextFilteringData  // Context-based filtering data (market contexts)\n    query_understanding?: QueryUnderstanding\n    reformulation_source?: string\n    request_url?: string  // Full URL with all params that was executed (for debugging)\n}"]}

package/dist/@types/categories.d.ts

@@ -64,6 +64,8 @@ export interface smartCollectionsProps {
     market_context?: string | null;
     variation_id?: string | null;
     ps?: 'new' | 'returning' | null;
+    spv?: string | null;
+    personalization?: string | null;
     force_and?: boolean;
 }
 export type FacetRequired = 0 | 1 | 2;

package/dist/@types/categories.js.map

@@ -1 +1 @@
-{"version":3,"file":"categories.js","sourceRoot":"","sources":["../../src/@types/categories.ts"],"names":[],"mappings":"","sourcesContent":["import {SortBy} from \"./sortBy\";\nimport {Narrow, ServerNarrow} from \"./narrow\";\nimport { ServerProduct} from \"./product\";\nimport {ServerFacet} from \"./facets\";\nimport {ContextFilteringData, QueryUnderstanding} from \"./results\";\n\n\nexport type AncestorCategory = [string, string, string] // category_id, category_name, category_url\nexport interface RelatedCategory {\n    id: string\n    l: string\n    t: string\n    u: string\n}\nexport type CategoryAncestor = [string, string, string]\nexport interface Category {\n    d: string\n    id: string\n    l: string\n    p_id: string\n    t: string\n    u: string\n    parent_name?: string\n}\nexport interface FastCategory {\n    d: string\n    id: string\n    l: string\n    p_id: string\n    t: string\n    u: string\n    parent_name?: string\n}\nexport interface smartCollectionsProps {\n    storeID: number\n    uuid: string\n    siteKey?:string\n    cdn: number\n    categoryID: string,\n    userToken: string,\n    sessionStart: number,\n    page?: number\n    productsPerPage?: number\n    sortBy?: SortBy\n    narrowBy?: ServerNarrow[]\n    facetRequired?: FacetRequired\n    withAttributes?: boolean\n    recent?: string\n    rec?: boolean\n    searchWithinSearch?: string,\n    segments?: string[],\n    hasShopifyMarkets?: boolean,\n    disable_turbolinks?:boolean\n    disable_strategies?:boolean\n    disable_merchandising?:boolean\n    disable_semantics?:boolean\n    disable_merchandising_rules?:boolean\n    disable_antonyms?:boolean\n    custom_sort_settings?:{personalization_rank: number, creation_date: number, popularity: number, inventory: number}\n    with_product_analytics?:boolean\n    market_context?: string | null  // Region code for market-specific filtering (e.g., \"US\", \"CA\", \"UK\")\n    variation_id?: string | null  // A/B test variation ID for reasoning/experiment tracking\n    ps?: 'new' | 'returning' | null  // Personalization segment for user segment coefficient preview (new/returning user)\n    force_and?: boolean\n}\nexport type FacetRequired = 0 | 1 | 2\nexport type smartCollectionsCallback = ({}: {\n    action: \"products\" | \"facets and products\"\n    payload: smartCollectionsResults\n}) => void\nexport interface smartCollectionsResults {\n    ancestors: CategoryAncestor[]\n    categoryID: string\n    name: string\n    category_name: string\n    products: ServerProduct[]\n    facets?: ServerFacet[]\n    totalResults: number\n    sortBy?: SortBy,\n    narrow?: Narrow[],\n    isNoResults?: boolean\n    page?: number\n    pageCount?: number\n    avoidPrefixList?: string[]\n    merch?: any\n    bannerHTML?: string\n    turbolink?:string\n    hiddenProducts?:ServerProduct[]\n    within_search_results_for?:string\n    results_for?: string\n    id_list?:number[]\n    context?: ContextFilteringData  // Context-based filtering data (market contexts)\n    analytics?: {\n        badges?: {\n            winners?: Record<string, string>  // Product ID -> tooltip message\n            overexposed?: Record<string, string>  // Product ID -> tooltip message\n            new_arrivals?: string[]\n        }\n        key_hidden_winners?: string\n        key_overexposed?: string\n    }\n    matching_sets?: Record<string, string>  // Product ID -> set name\n    query_understanding?: QueryUnderstanding\n    reformulation_source?: string\n    request_url?: string  // Full URL with all params that was executed (for debugging)\n\n}\nexport type inventoryCallback = ({}: {\n    action: \"products inventory\"\n    payload: {productsInventory: productsInventoryResults[]}\n}) => void\nexport interface productsInventoryResults {\n  id: string;\n  totalInventory: number;\n}"]}
+{"version":3,"file":"categories.js","sourceRoot":"","sources":["../../src/@types/categories.ts"],"names":[],"mappings":"","sourcesContent":["import {SortBy} from \"./sortBy\";\nimport {Narrow, ServerNarrow} from \"./narrow\";\nimport { ServerProduct} from \"./product\";\nimport {ServerFacet} from \"./facets\";\nimport {ContextFilteringData, QueryUnderstanding} from \"./results\";\n\n\nexport type AncestorCategory = [string, string, string] // category_id, category_name, category_url\nexport interface RelatedCategory {\n    id: string\n    l: string\n    t: string\n    u: string\n}\nexport type CategoryAncestor = [string, string, string]\nexport interface Category {\n    d: string\n    id: string\n    l: string\n    p_id: string\n    t: string\n    u: string\n    parent_name?: string\n}\nexport interface FastCategory {\n    d: string\n    id: string\n    l: string\n    p_id: string\n    t: string\n    u: string\n    parent_name?: string\n}\nexport interface smartCollectionsProps {\n    storeID: number\n    uuid: string\n    siteKey?:string\n    cdn: number\n    categoryID: string,\n    userToken: string,\n    sessionStart: number,\n    page?: number\n    productsPerPage?: number\n    sortBy?: SortBy\n    narrowBy?: ServerNarrow[]\n    facetRequired?: FacetRequired\n    withAttributes?: boolean\n    recent?: string\n    rec?: boolean\n    searchWithinSearch?: string,\n    segments?: string[],\n    hasShopifyMarkets?: boolean,\n    disable_turbolinks?:boolean\n    disable_strategies?:boolean\n    disable_merchandising?:boolean\n    disable_semantics?:boolean\n    disable_merchandising_rules?:boolean\n    disable_antonyms?:boolean\n    custom_sort_settings?:{personalization_rank: number, creation_date: number, popularity: number, inventory: number}\n    with_product_analytics?:boolean\n    market_context?: string | null  // Region code for market-specific filtering (e.g., \"US\", \"CA\", \"UK\")\n    variation_id?: string | null  // A/B test variation ID for reasoning/experiment tracking\n    ps?: 'new' | 'returning' | null  // Personalization segment for user segment coefficient preview (new/returning user)\n    spv?: string | null  // Session Product Views JSON for personalization preview (e.g., '{\"pid1\":ts,\"pid2\":ts}')\n    personalization?: string | null  // Comma-separated personalization types to enable (e.g., 'gender')\n    force_and?: boolean\n}\nexport type FacetRequired = 0 | 1 | 2\nexport type smartCollectionsCallback = ({}: {\n    action: \"products\" | \"facets and products\"\n    payload: smartCollectionsResults\n}) => void\nexport interface smartCollectionsResults {\n    ancestors: CategoryAncestor[]\n    categoryID: string\n    name: string\n    category_name: string\n    products: ServerProduct[]\n    facets?: ServerFacet[]\n    totalResults: number\n    sortBy?: SortBy,\n    narrow?: Narrow[],\n    isNoResults?: boolean\n    page?: number\n    pageCount?: number\n    avoidPrefixList?: string[]\n    merch?: any\n    bannerHTML?: string\n    turbolink?:string\n    hiddenProducts?:ServerProduct[]\n    within_search_results_for?:string\n    results_for?: string\n    id_list?:number[]\n    context?: ContextFilteringData  // Context-based filtering data (market contexts)\n    analytics?: {\n        badges?: {\n            winners?: Record<string, string>  // Product ID -> tooltip message\n            overexposed?: Record<string, string>  // Product ID -> tooltip message\n            new_arrivals?: string[]\n        }\n        key_hidden_winners?: string\n        key_overexposed?: string\n    }\n    matching_sets?: Record<string, string>  // Product ID -> set name\n    query_understanding?: QueryUnderstanding\n    reformulation_source?: string\n    request_url?: string  // Full URL with all params that was executed (for debugging)\n\n}\nexport type inventoryCallback = ({}: {\n    action: \"products inventory\"\n    payload: {productsInventory: productsInventoryResults[]}\n}) => void\nexport interface productsInventoryResults {\n  id: string;\n  totalInventory: number;\n}"]}

package/dist/@types/product.d.ts

@@ -23,6 +23,7 @@ export interface ProductAnalytics {
     is_overexposed?: boolean;
     explanation?: string;
     user_segment_coef?: number;
+    gender_coef?: number;
 }
 export declare enum FeaturedRanking {
     FEATURED_RANK_NO = 0,

package/dist/@types/product.js.map

@@ -1 +1 @@
-{"version":3,"file":"product.js","sourceRoot":"","sources":["../../src/@types/product.ts"],"names":[],"mappings":"AA4BA,MAAM,CAAN,IAAY,eAKX;AALD,WAAY,eAAe;IACvB,6EAAgB,CAAA;IAChB,yFAAsB,CAAA;IACtB,qFAAoB,CAAA;IACpB,mFAAmB,CAAA;AACvB,CAAC,EALW,eAAe,KAAf,eAAe,QAK1B","sourcesContent":["import type {Currency} from \"./currency\";\nimport {PromoTileConfig} from \"./promoTile\";\n\nexport interface ProductAnalytics {\n    global_impressions?: string\n    context_impressions?: string\n    global_cpi?: string\n    context_cpi?: string\n    global_rpi?: string\n    context_rpi?: string\n    global_rpi_corrected?: number\n    context_rpi_corrected?: number\n    global_rpi_cp_lower?: number\n    context_rpi_cp_lower?: number\n    global_rpi_corrected_cp_lower?: number\n    context_rpi_corrected_cp_lower?: number\n    beta_alpha_post_local?: number\n    beta_beta_post_local?: number\n    aov_for_cdf_local?: number\n    sales_days?: number[]\n    sales_weeks?: number[]\n    sales_months?: number[]\n    is_hidden_winner?: boolean\n    is_overexposed?: boolean\n    explanation?: string\n    user_segment_coef?: number\n}\n\nexport enum FeaturedRanking {\n    FEATURED_RANK_NO,\n    FEATURED_RANK_ON_MATCH,\n    FEATURED_RANK_ALWAYS,\n    FEATURED_RANK_NEVER,\n}\n\nexport interface ServerProduct {\n    c: Currency\n    d: string\n    f: FeaturedRanking\n    id: productID\n    iso: boolean\n    l: string\n    p: string\n    p_c: string\n    p_max: string\n    p_max_c: string\n    p_min: string\n    p_min_c: string\n    p_spl: number\n    p_spl_id?: string\n    review?: number\n    reviews_count?: number\n    s: string\n    sku: string\n    skus: string[]\n    t: string\n    t2: string\n    u: string\n    v_c: number\n    v: string\n    vra: ServerVariant[]\n    vrc: object\n    att?: Attribute[]\n    real_sku?: string\n    image_id?: string\n    alt?: AlternativeColor[]\n    inventory_lvl?: number\n    promotile?: boolean\n    imageID?: string\n    rec_src?: number\n    analytics?: ProductAnalytics\n}\n\nexport type ServerVariant = [number, VariantData[]]\nexport type VariantData = [string, string[]]\n\nexport type Attribute = [string, AttributeData[]]\nexport type AttributeData = string[] | string[][]\n\nexport interface ServerAltProductVariant {\n    sellable: boolean;\n    size: string;\n    v_id: number;\n}\n\nexport interface ServerAltProductData {\n    l: string;\n    p: string;\n    p_c: string;\n    p_spl: number;\n    p_spl_id?: number;\n    sku?: string;\n    t: string[];\n    vra: ServerAltProductVariant[];\n    review?: number;\n    reviews_count?: number;\n    att?: any[];\n    s?: string;\n    p_min: string;\n    p_max: string;\n}\n\nexport type AlternativeColor = [AlternativeColorName, AlternativeColorURL, productID?, ServerAltProductData?]\n\ntype AlternativeColorName = string\ntype AlternativeColorURL = string\ntype productID = number\n\nexport interface Badge {\n    tag: string;\n    url: string;\n}\n\nexport interface TextBadge {\n    badgeText: string;\n    tag: string;\n    badgeStyle: {\n        backgroundColor: string;\n        borderColor: string;\n        borderRadius: number;\n        horizontal: string;\n        vertical: string;\n        size: number;\n        textColor: string;\n    }\n}\n\nexport interface Products {\n    [id: string]: Product\n}\n\nexport interface Product {\n    currency: Currency\n    id: string\n    title: string\n    description: string\n    variants: Variants\n    isSoldOut: boolean\n    price: number\n    minPrice: number\n    maxPrice: number\n    maxCompare: number\n    comparePrice: number\n    maxFormattedCompare: string;\n    reviewScore: number | undefined\n    reviewCount: number | undefined\n    imageURL: string\n    imageURL2: string\n    optimizedURL?: string;\n    formattedPrice: string\n    formattedCompare: string | undefined\n    vendor: string\n    sku: string\n    s: string\n    inventory_lvl?: number\n    imagesSrcset: string\n    productURL: string\n    productBadges: Badge[]\n    productTextBadges?: TextBadge[]\n    alternativeProducts?: AlternativeProduct[]\n    tags?: string[]\n    promoTileConfig?: PromoTileConfig\n    attributes?: Attribute[]\n    p_spl?: number\n    p_spl_id?: string\n    isIspNoPrice?: boolean\n    imageID?: string\n    vrc?: object\n    analytics?: ProductAnalytics\n}\n\nexport interface Variant {\n    id: number,\n    attributes: {\n        [key: string]: VariantsAttribute\n    }\n}\n\nexport type Variants = Variant[]\n\nexport type VariantsAttribute = string | number | boolean | string[] | undefined\n\nexport interface AlternativeProduct {\n    color: string,\n    url: string,\n    id: string,\n    variants?: Variants,\n    s?: string,\n    price: number\n    comparePrice: number,\n    formattedCompare?: string,\n    formattedPrice?: string,\n    attributes?: Attribute[] | undefined\n}\n\nexport interface ServerPromotile {\n    height: number;\n    id: string;\n    image: string;\n    link: string;\n    width: number;\n    title: string;\n}"]}
+{"version":3,"file":"product.js","sourceRoot":"","sources":["../../src/@types/product.ts"],"names":[],"mappings":"AA6BA,MAAM,CAAN,IAAY,eAKX;AALD,WAAY,eAAe;IACvB,6EAAgB,CAAA;IAChB,yFAAsB,CAAA;IACtB,qFAAoB,CAAA;IACpB,mFAAmB,CAAA;AACvB,CAAC,EALW,eAAe,KAAf,eAAe,QAK1B","sourcesContent":["import type {Currency} from \"./currency\";\nimport {PromoTileConfig} from \"./promoTile\";\n\nexport interface ProductAnalytics {\n    global_impressions?: string\n    context_impressions?: string\n    global_cpi?: string\n    context_cpi?: string\n    global_rpi?: string\n    context_rpi?: string\n    global_rpi_corrected?: number\n    context_rpi_corrected?: number\n    global_rpi_cp_lower?: number\n    context_rpi_cp_lower?: number\n    global_rpi_corrected_cp_lower?: number\n    context_rpi_corrected_cp_lower?: number\n    beta_alpha_post_local?: number\n    beta_beta_post_local?: number\n    aov_for_cdf_local?: number\n    sales_days?: number[]\n    sales_weeks?: number[]\n    sales_months?: number[]\n    is_hidden_winner?: boolean\n    is_overexposed?: boolean\n    explanation?: string\n    user_segment_coef?: number\n    gender_coef?: number  // Gender-based RPI correction factor (1.0 = no change)\n}\n\nexport enum FeaturedRanking {\n    FEATURED_RANK_NO,\n    FEATURED_RANK_ON_MATCH,\n    FEATURED_RANK_ALWAYS,\n    FEATURED_RANK_NEVER,\n}\n\nexport interface ServerProduct {\n    c: Currency\n    d: string\n    f: FeaturedRanking\n    id: productID\n    iso: boolean\n    l: string\n    p: string\n    p_c: string\n    p_max: string\n    p_max_c: string\n    p_min: string\n    p_min_c: string\n    p_spl: number\n    p_spl_id?: string\n    review?: number\n    reviews_count?: number\n    s: string\n    sku: string\n    skus: string[]\n    t: string\n    t2: string\n    u: string\n    v_c: number\n    v: string\n    vra: ServerVariant[]\n    vrc: object\n    att?: Attribute[]\n    real_sku?: string\n    image_id?: string\n    alt?: AlternativeColor[]\n    inventory_lvl?: number\n    promotile?: boolean\n    imageID?: string\n    rec_src?: number\n    analytics?: ProductAnalytics\n}\n\nexport type ServerVariant = [number, VariantData[]]\nexport type VariantData = [string, string[]]\n\nexport type Attribute = [string, AttributeData[]]\nexport type AttributeData = string[] | string[][]\n\nexport interface ServerAltProductVariant {\n    sellable: boolean;\n    size: string;\n    v_id: number;\n}\n\nexport interface ServerAltProductData {\n    l: string;\n    p: string;\n    p_c: string;\n    p_spl: number;\n    p_spl_id?: number;\n    sku?: string;\n    t: string[];\n    vra: ServerAltProductVariant[];\n    review?: number;\n    reviews_count?: number;\n    att?: any[];\n    s?: string;\n    p_min: string;\n    p_max: string;\n}\n\nexport type AlternativeColor = [AlternativeColorName, AlternativeColorURL, productID?, ServerAltProductData?]\n\ntype AlternativeColorName = string\ntype AlternativeColorURL = string\ntype productID = number\n\nexport interface Badge {\n    tag: string;\n    url: string;\n}\n\nexport interface TextBadge {\n    badgeText: string;\n    tag: string;\n    badgeStyle: {\n        backgroundColor: string;\n        borderColor: string;\n        borderRadius: number;\n        horizontal: string;\n        vertical: string;\n        size: number;\n        textColor: string;\n    }\n}\n\nexport interface Products {\n    [id: string]: Product\n}\n\nexport interface Product {\n    currency: Currency\n    id: string\n    title: string\n    description: string\n    variants: Variants\n    isSoldOut: boolean\n    price: number\n    minPrice: number\n    maxPrice: number\n    maxCompare: number\n    comparePrice: number\n    maxFormattedCompare: string;\n    reviewScore: number | undefined\n    reviewCount: number | undefined\n    imageURL: string\n    imageURL2: string\n    optimizedURL?: string;\n    formattedPrice: string\n    formattedCompare: string | undefined\n    vendor: string\n    sku: string\n    s: string\n    inventory_lvl?: number\n    imagesSrcset: string\n    productURL: string\n    productBadges: Badge[]\n    productTextBadges?: TextBadge[]\n    alternativeProducts?: AlternativeProduct[]\n    tags?: string[]\n    promoTileConfig?: PromoTileConfig\n    attributes?: Attribute[]\n    p_spl?: number\n    p_spl_id?: string\n    isIspNoPrice?: boolean\n    imageID?: string\n    vrc?: object\n    analytics?: ProductAnalytics\n}\n\nexport interface Variant {\n    id: number,\n    attributes: {\n        [key: string]: VariantsAttribute\n    }\n}\n\nexport type Variants = Variant[]\n\nexport type VariantsAttribute = string | number | boolean | string[] | undefined\n\nexport interface AlternativeProduct {\n    color: string,\n    url: string,\n    id: string,\n    variants?: Variants,\n    s?: string,\n    price: number\n    comparePrice: number,\n    formattedCompare?: string,\n    formattedPrice?: string,\n    attributes?: Attribute[] | undefined\n}\n\nexport interface ServerPromotile {\n    height: number;\n    id: string;\n    image: string;\n    link: string;\n    width: number;\n    title: string;\n}"]}

package/dist/@types/results.d.ts

@@ -80,6 +80,9 @@ export interface fullTextSearchProps {
     market_context?: string | null;
     variation_id?: string | null;
     force_and?: boolean;
+    ps?: 'new' | 'returning' | null;
+    spv?: string | null;
+    personalization?: string | null;
 }
 export interface ContextFilteringData {
     hidden: number[];

package/dist/@types/results.js.map

@@ -1 +1 @@
-{"version":3,"file":"results.js","sourceRoot":"","sources":["../../src/@types/results.ts"],"names":[],"mappings":"","sourcesContent":["import type {Narrow, ServerNarrow} from \"./narrow\";\nimport type {SortBy} from \"./sortBy\";\n\nimport type { Facet} from \"./facets\";\nimport {AncestorCategory, RelatedCategory} from \"./categories\";\n\nimport {Product, ServerProduct} from \"./product\";\n\nexport interface PopularSearch {\n    label: string\n    type: \"p\"\n}\ninterface Base {\n    narrow: Narrow,\n    sortBy: SortBy,\n    totalResults: number,\n    page: number,\n    totalPages: number,\n    products: Product[],\n    facets: Facet[],\n    avoidTagPrefixes: string[],\n    sort: SortBy,\n    productIDS: string[],\n    bannerHTML: string,\n    bannerHTMLMobile: string,\n    // ancestors: Ancestor[]\n}\n\nexport interface SearchResults extends Base {\n    query: string,\n    totalCMS: number,\n    didYouMean?: string[],\n    personalizedProductIds: number[],\n    sessionProductIds: number[],\n    resultsFor?: string,\n    isRelatedResults?: boolean\n    relatedSearch?: string[]\n}\n\nexport interface CategoryResults extends Base {\n    categoryID: string,\n    categoryName: string,\n    personalizationRecencyLimit?: number,\n    personalizedProductIds: number[],\n    sessionProductIds: number[],\n    relatedCategories: RelatedCategory[],\n}\n\nexport interface LandingPageResults extends Base {\n    lpSlug: string,\n    title: string,\n    indexPage: number\n}\n\nexport type FacetRequired = 0 | 1 | 2\nexport type CategoryAncestor = [string, string, string]\n\nexport interface fullTextSearchProps {\n    term: string\n    storeID: number\n    siteKey?:string\n    uuid: string\n    cdn?: number\n    userToken: string,\n    sessionStart: number,\n    page?: number\n    productsPerPage?: number\n    sortBy?: SortBy\n    narrowBy?: ServerNarrow[]\n    facetRequired?: FacetRequired\n    withAttributes?: boolean\n    recent?: string\n    searchWithinSearch?: string,\n    segments?: string[]\n    hasShopifyMarkets?: boolean\n    disable_turbolinks?:boolean\n    disable_strategies?:boolean\n    disable_merchandising?:boolean\n    disable_semantics?:boolean\n    disable_merchandising_rules?:boolean\n    disable_antonyms?:boolean\n    custom_sort_settings?:{personalization_rank: number, creation_date: number, popularity: number, inventory: number}\n    with_product_analytics?:boolean\n    market_context?: string | null  // Region code for market-specific filtering (e.g., \"US\", \"CA\", \"UK\")\n    variation_id?: string | null  // A/B test variation ID for reasoning/experiment tracking\n    force_and?: boolean\n}\nexport interface ContextFilteringData {\n    hidden: number[]                    // Product IDs hidden by context filtering\n    unpublished: Record<number, string> // product_id -> region_code (e.g., \"US\", \"CA\")\n    unsellable: Record<number, string>  // product_id -> region_code (e.g., \"UK\", \"FR\")\n}\n\nexport interface fullTextSearchResponse {\n    products: ServerProduct[]\n    facets: Facet[]\n    total_results: number\n    facets_completed?: boolean\n    sortBy?: SortBy,\n    narrow: [string, string, string][]\n    pop_products_no_results?: boolean\n    page: number\n    total_p: number\n    personalized_products?: number[],\n    ancestor_categories?: CategoryAncestor[]\n    avoid_tag_prefixes?: string\n    merch?: any\n}\nexport interface QueryUnderstanding {\n    query: string\n    has_ai_enrichment: boolean\n    structured_attributes: Record<string, string[]>\n    social_attributes: Record<string, string[]>\n    intent_mapping: string[]\n}\n\nexport interface FullTextServerResponseAll extends fullTextSearchResponse{\n    alternatives?: string[]\n    term: string\n    cms_number_found?: number\n    within_search_results_for?: string\n    banner_html: string\n    banner_html_mobile: string\n    turbolink?: string\n    personalized_products?: number[]\n    session_products?: number[]\n    results_for?: string\n    related_results?: boolean,\n    ancestor_categories?: AncestorCategory[],\n    related_search?: string[],\n    hidden?:any,\n    isNoResults?:any,\n    totalResults?:any,\n    hiddenProducts?:ServerProduct[],\n    pageCount?:number,\n    sort_by?: SortBy,\n    id_list?:number[]\n    context?: ContextFilteringData  // Context-based filtering data (market contexts)\n    analytics?: {\n        badges?: {\n            winners?: Record<string, string>  // Product ID -> tooltip message\n            overexposed?: Record<string, string>  // Product ID -> tooltip message\n            new_arrivals?: string[]\n        }\n        key_hidden_winners?: string\n        key_overexposed?: string\n    }\n    matching_sets?: Record<string, string>  // Product ID -> set name\n    query_understanding?: QueryUnderstanding\n    reformulation_source?: string\n    request_url?: string  // Full URL with all params that was executed (for debugging)\n\n}"]}
+{"version":3,"file":"results.js","sourceRoot":"","sources":["../../src/@types/results.ts"],"names":[],"mappings":"","sourcesContent":["import type {Narrow, ServerNarrow} from \"./narrow\";\nimport type {SortBy} from \"./sortBy\";\n\nimport type { Facet} from \"./facets\";\nimport {AncestorCategory, RelatedCategory} from \"./categories\";\n\nimport {Product, ServerProduct} from \"./product\";\n\nexport interface PopularSearch {\n    label: string\n    type: \"p\"\n}\ninterface Base {\n    narrow: Narrow,\n    sortBy: SortBy,\n    totalResults: number,\n    page: number,\n    totalPages: number,\n    products: Product[],\n    facets: Facet[],\n    avoidTagPrefixes: string[],\n    sort: SortBy,\n    productIDS: string[],\n    bannerHTML: string,\n    bannerHTMLMobile: string,\n    // ancestors: Ancestor[]\n}\n\nexport interface SearchResults extends Base {\n    query: string,\n    totalCMS: number,\n    didYouMean?: string[],\n    personalizedProductIds: number[],\n    sessionProductIds: number[],\n    resultsFor?: string,\n    isRelatedResults?: boolean\n    relatedSearch?: string[]\n}\n\nexport interface CategoryResults extends Base {\n    categoryID: string,\n    categoryName: string,\n    personalizationRecencyLimit?: number,\n    personalizedProductIds: number[],\n    sessionProductIds: number[],\n    relatedCategories: RelatedCategory[],\n}\n\nexport interface LandingPageResults extends Base {\n    lpSlug: string,\n    title: string,\n    indexPage: number\n}\n\nexport type FacetRequired = 0 | 1 | 2\nexport type CategoryAncestor = [string, string, string]\n\nexport interface fullTextSearchProps {\n    term: string\n    storeID: number\n    siteKey?:string\n    uuid: string\n    cdn?: number\n    userToken: string,\n    sessionStart: number,\n    page?: number\n    productsPerPage?: number\n    sortBy?: SortBy\n    narrowBy?: ServerNarrow[]\n    facetRequired?: FacetRequired\n    withAttributes?: boolean\n    recent?: string\n    searchWithinSearch?: string,\n    segments?: string[]\n    hasShopifyMarkets?: boolean\n    disable_turbolinks?:boolean\n    disable_strategies?:boolean\n    disable_merchandising?:boolean\n    disable_semantics?:boolean\n    disable_merchandising_rules?:boolean\n    disable_antonyms?:boolean\n    custom_sort_settings?:{personalization_rank: number, creation_date: number, popularity: number, inventory: number}\n    with_product_analytics?:boolean\n    market_context?: string | null  // Region code for market-specific filtering (e.g., \"US\", \"CA\", \"UK\")\n    variation_id?: string | null  // A/B test variation ID for reasoning/experiment tracking\n    force_and?: boolean\n    ps?: 'new' | 'returning' | null  // Personalization segment for user segment coefficient preview (new/returning user)\n    spv?: string | null  // Session Product Views JSON for personalization preview (e.g., '{\"pid1\":ts,\"pid2\":ts}')\n    personalization?: string | null  // Comma-separated personalization types to enable (e.g., 'gender')\n}\nexport interface ContextFilteringData {\n    hidden: number[]                    // Product IDs hidden by context filtering\n    unpublished: Record<number, string> // product_id -> region_code (e.g., \"US\", \"CA\")\n    unsellable: Record<number, string>  // product_id -> region_code (e.g., \"UK\", \"FR\")\n}\n\nexport interface fullTextSearchResponse {\n    products: ServerProduct[]\n    facets: Facet[]\n    total_results: number\n    facets_completed?: boolean\n    sortBy?: SortBy,\n    narrow: [string, string, string][]\n    pop_products_no_results?: boolean\n    page: number\n    total_p: number\n    personalized_products?: number[],\n    ancestor_categories?: CategoryAncestor[]\n    avoid_tag_prefixes?: string\n    merch?: any\n}\nexport interface QueryUnderstanding {\n    query: string\n    has_ai_enrichment: boolean\n    structured_attributes: Record<string, string[]>\n    social_attributes: Record<string, string[]>\n    intent_mapping: string[]\n}\n\nexport interface FullTextServerResponseAll extends fullTextSearchResponse{\n    alternatives?: string[]\n    term: string\n    cms_number_found?: number\n    within_search_results_for?: string\n    banner_html: string\n    banner_html_mobile: string\n    turbolink?: string\n    personalized_products?: number[]\n    session_products?: number[]\n    results_for?: string\n    related_results?: boolean,\n    ancestor_categories?: AncestorCategory[],\n    related_search?: string[],\n    hidden?:any,\n    isNoResults?:any,\n    totalResults?:any,\n    hiddenProducts?:ServerProduct[],\n    pageCount?:number,\n    sort_by?: SortBy,\n    id_list?:number[]\n    context?: ContextFilteringData  // Context-based filtering data (market contexts)\n    analytics?: {\n        badges?: {\n            winners?: Record<string, string>  // Product ID -> tooltip message\n            overexposed?: Record<string, string>  // Product ID -> tooltip message\n            new_arrivals?: string[]\n        }\n        key_hidden_winners?: string\n        key_overexposed?: string\n    }\n    matching_sets?: Record<string, string>  // Product ID -> set name\n    query_understanding?: QueryUnderstanding\n    reformulation_source?: string\n    request_url?: string  // Full URL with all params that was executed (for debugging)\n\n}"]}

package/dist/components/FastSimonApi/FastSimonApi.js

@@ -27,6 +27,7 @@ import { newObject } from "../common";
 import { getShowSalesAnalyticsSetting } from "../../utils/getSalesAnalyticsSettings";
 import { getLSVectorSearchOn } from "../../utils/getLSVectorSearch";
 import { getPersonalizationSegment } from "../../utils/userSegmentPreview";
+import { buildPersonalizationParams } from "../../utils/personalizationPreview";
 import { FullTextSearch } from "../../services/search";
 import { SmartCollections } from "../../services/smartCollections";
 import { Autocomplete } from "../../services/autocomplete";
@@ -63,6 +64,7 @@ const FastSimonApi = (_a) => {
         variation_id: variationId,
         force_and: false,
         user_segment_preview: 'none',
+        personalization_preview: null,
         // Compare Mode state
         comparisonData: null,
         isComparing: false
@@ -70,8 +72,10 @@ const FastSimonApi = (_a) => {
     // Ref for user_segment_preview: enables synchronous reads across closures
     // so that any fetch triggered in the same handler (e.g. setCustomSort) reads the latest value
     const userSegmentPreviewRef = useRef(state.user_segment_preview);
-    const lastFetchedSegmentRef = useRef(state.user_segment_preview);
     userSegmentPreviewRef.current = state.user_segment_preview;
+    // Ref for personalization_preview: enables synchronous reads across closures
+    const personalizationPreviewRef = useRef(state.personalization_preview);
+    personalizationPreviewRef.current = state.personalization_preview;
     const [categories, setCategories] = useState([]);
     const [analyticsFetched, setAnalyticsFetched] = useState(false);
     const [lastAnalyticsQuery, setLastAnalyticsQuery] = useState('');
@@ -117,6 +121,10 @@ const FastSimonApi = (_a) => {
         userSegmentPreviewRef.current = preview;
         dispatch === null || dispatch === void 0 ? void 0 : dispatch({ type: 'setUserSegmentPreview', payload: preview });
     }
+    function setPersonalizationPreview(preview) {
+        personalizationPreviewRef.current = preview;
+        dispatch === null || dispatch === void 0 ? void 0 : dispatch({ type: 'setPersonalizationPreview', payload: preview });
+    }
     // Compute detailed comparison between Hybrid ON and Hybrid OFF using full ID lists
     function computeComparisonFromIds(hybridOnIds, hybridOffIds) {
         // Create rank maps (1-based index)
@@ -508,14 +516,9 @@ const FastSimonApi = (_a) => {
             window.removeEventListener('fast-simon-update-is-autocomplete', handleSetIsAutocomplete);
         };
     }, []);
-    // Refetch collection when user_segment_preview changes, but only if not already fetched with this value
-    // (e.g. setCustomSort may have already triggered a fetch with the correct ref value)
-    useEffect(() => {
-        if (state.collectionID && state.user_segment_preview !== lastFetchedSegmentRef.current) {
-            setCollectionID(state.collectionID);
-        }
-    }, [state.user_segment_preview]);
     // Settings modal refetch: triggered after state is updated (no race conditions)
+    // All settings (force_and, flags, custom_sort, user_segment_preview, personalization_preview)
+    // are batched via updateSettingsAndRefetch to avoid double-fetches and stale-state reads.
     useEffect(() => {
         var _a, _b, _c, _d, _e, _f, _g;
         if (!state.refetchTrigger)
@@ -545,6 +548,7 @@ const FastSimonApi = (_a) => {
         fetchResults(fetchParams, isInfiniteScroll, state.isAutocomplete);
     }, [state.refetchTrigger]);
     const onSearch = (props, isInfiniteScroll) => {
+        var _a;
         setIsLoading({ products: true, filters: true });
         // Clear previous comparison data when starting new search
         setComparisonData(null);
@@ -557,10 +561,12 @@ const FastSimonApi = (_a) => {
         const shouldFetchAnalytics = currentForceAnalytics || (isAnalyticsEnabled && (currentQuery !== lastAnalyticsQuery || lastAnalyticsMode !== 'search'));
         // Check if hybrid search is enabled - we'll need to make a comparison call
         const isHybridEnabled = getLSVectorSearchOn();
-        FullTextSearch.getReasoningFullTextSearch(Object.assign(Object.assign({}, props), { withAttributes: promoTiles || withProductAttributes, with_product_analytics: shouldFetchAnalytics, market_context: marketContext, variation_id: state.variation_id, force_and: state.force_and })).then((response) => __awaiter(void 0, void 0, void 0, function* () {
-            var _a;
+        const personalizationSegment = getPersonalizationSegment(userSegmentPreviewRef.current);
+        const personalizationParams = buildPersonalizationParams((_a = personalizationPreviewRef.current) !== null && _a !== void 0 ? _a : { enabled: false, spvJson: '', types: ['gender'] });
+        FullTextSearch.getReasoningFullTextSearch(Object.assign(Object.assign({}, props), { withAttributes: promoTiles || withProductAttributes, with_product_analytics: shouldFetchAnalytics, market_context: marketContext, variation_id: state.variation_id, force_and: state.force_and, ps: personalizationSegment, spv: personalizationParams.spv, personalization: personalizationParams.personalization })).then((response) => __awaiter(void 0, void 0, void 0, function* () {
+            var _b;
             // Mark analytics as fetched only if response contains analytics data with badges
-            if (shouldFetchAnalytics && ((_a = response.analytics) === null || _a === void 0 ? void 0 : _a.badges)) {
+            if (shouldFetchAnalytics && ((_b = response.analytics) === null || _b === void 0 ? void 0 : _b.badges)) {
                 setAnalyticsFetched(true);
                 setLastAnalyticsQuery(currentQuery);
                 setLastAnalyticsMode('search');
@@ -588,6 +594,9 @@ const FastSimonApi = (_a) => {
             listIdRequestProps.market_context = marketContext;
             listIdRequestProps.variation_id = state.variation_id;
             listIdRequestProps.force_and = state.force_and;
+            listIdRequestProps.ps = personalizationSegment;
+            listIdRequestProps.spv = personalizationParams.spv;
+            listIdRequestProps.personalization = personalizationParams.personalization;
             let listIdRes = yield FullTextSearch.getReasoningFullTextSearchProductsIds(listIdRequestProps).then((response) => {
                 return response;
             });
@@ -600,6 +609,9 @@ const FastSimonApi = (_a) => {
             facetsRequestProps.market_context = marketContext;
             facetsRequestProps.variation_id = state.variation_id;
             facetsRequestProps.force_and = state.force_and;
+            facetsRequestProps.ps = personalizationSegment;
+            facetsRequestProps.spv = personalizationParams.spv;
+            facetsRequestProps.personalization = personalizationParams.personalization;
             let facetsRes = yield FullTextSearch.getReasoningFullTextSearch(facetsRequestProps).then((response) => {
                 return response;
             });
@@ -628,7 +640,7 @@ const FastSimonApi = (_a) => {
                 console.log("[Compare Mode] Making comparison IDs call...");
                 try {
                     // Get all IDs WITHOUT hybrid_search_settings
-                    const comparisonResponse = yield FullTextSearch.getComparisonProductIds(Object.assign(Object.assign({}, props), { market_context: marketContext, variation_id: state.variation_id, force_and: state.force_and }));
+                    const comparisonResponse = yield FullTextSearch.getComparisonProductIds(Object.assign(Object.assign({}, props), { market_context: marketContext, variation_id: state.variation_id, force_and: state.force_and, ps: personalizationSegment, spv: personalizationParams.spv, personalization: personalizationParams.personalization }));
                     const hybridOffIds = (comparisonResponse.id_list || []).map(id => id.toString());
                     const hybridOnIds = (response.id_list || []).map(id => id.toString());
                     console.log("[Compare Mode] Hybrid ON IDs count:", hybridOnIds.length);
@@ -650,9 +662,11 @@ const FastSimonApi = (_a) => {
         }));
     };
     const onAutocompleteSearch = (props) => {
+        var _a;
         setIsLoading({ products: true, filters: true });
         const personalizationSegment = getPersonalizationSegment(userSegmentPreviewRef.current);
-        Autocomplete.getAutocompleteReasoning(Object.assign(Object.assign({}, props), { withAttributes: promoTiles || withProductAttributes, market_context: marketContext, variation_id: state.variation_id, force_and: state.force_and, ps: personalizationSegment })).then((response) => __awaiter(void 0, void 0, void 0, function* () {
+        const personalizationParams = buildPersonalizationParams((_a = personalizationPreviewRef.current) !== null && _a !== void 0 ? _a : { enabled: false, spvJson: '', types: ['gender'] });
+        Autocomplete.getAutocompleteReasoning(Object.assign(Object.assign({}, props), { withAttributes: promoTiles || withProductAttributes, market_context: marketContext, variation_id: state.variation_id, force_and: state.force_and, ps: personalizationSegment, spv: personalizationParams.spv, personalization: personalizationParams.personalization })).then((response) => __awaiter(void 0, void 0, void 0, function* () {
             response = getFormatedData(response);
             mergeResults(response, false);
             if (!customTitleChange) {
@@ -674,6 +688,7 @@ const FastSimonApi = (_a) => {
         }));
     };
     const onCollection = (props, isInfiniteScroll) => {
+        var _a;
         setIsLoading({ products: true, filters: true });
         // Pass with_product_analytics only on first request for this collection OR when switching from search to collection
         // AND only if merchant is enterprise or subscription level 5
@@ -683,12 +698,12 @@ const FastSimonApi = (_a) => {
         const currentForceAnalytics = forceProductAnalytics || getShowSalesAnalyticsSetting();
         const shouldFetchAnalytics = currentForceAnalytics || (isAnalyticsEnabled && (currentCollection !== lastAnalyticsCollection || lastAnalyticsMode !== 'collection'));
         const personalizationSegment = getPersonalizationSegment(userSegmentPreviewRef.current);
-        lastFetchedSegmentRef.current = userSegmentPreviewRef.current;
-        SmartCollections.getSmartCollections(Object.assign(Object.assign({}, props), { withAttributes: promoTiles || withProductAttributes, with_product_analytics: shouldFetchAnalytics, market_context: marketContext, variation_id: state.variation_id, ps: personalizationSegment, force_and: state.force_and }))
+        const personalizationParams = buildPersonalizationParams((_a = personalizationPreviewRef.current) !== null && _a !== void 0 ? _a : { enabled: false, spvJson: '', types: ['gender'] });
+        SmartCollections.getSmartCollections(Object.assign(Object.assign({}, props), { withAttributes: promoTiles || withProductAttributes, with_product_analytics: shouldFetchAnalytics, market_context: marketContext, variation_id: state.variation_id, ps: personalizationSegment, spv: personalizationParams.spv, personalization: personalizationParams.personalization, force_and: state.force_and }))
             .then((response) => __awaiter(void 0, void 0, void 0, function* () {
-            var _a;
+            var _b;
             // Mark analytics as fetched only if response contains analytics data with badges
-            if (shouldFetchAnalytics && ((_a = response.analytics) === null || _a === void 0 ? void 0 : _a.badges)) {
+            if (shouldFetchAnalytics && ((_b = response.analytics) === null || _b === void 0 ? void 0 : _b.badges)) {
                 setAnalyticsFetched(true);
                 setLastAnalyticsCollection(currentCollection);
                 setLastAnalyticsMode('collection');
@@ -705,6 +720,8 @@ const FastSimonApi = (_a) => {
             listIdRequestProps.variation_id = state.variation_id;
             listIdRequestProps.force_and = state.force_and;
             listIdRequestProps.ps = personalizationSegment;
+            listIdRequestProps.spv = personalizationParams.spv;
+            listIdRequestProps.personalization = personalizationParams.personalization;
             let listIdRes = yield SmartCollections.getSmartCollectionsProductsIds(listIdRequestProps).then((response) => {
                 return response;
             });
@@ -718,6 +735,8 @@ const FastSimonApi = (_a) => {
             facetsRequestProps.variation_id = state.variation_id;
             facetsRequestProps.force_and = state.force_and;
             facetsRequestProps.ps = personalizationSegment;
+            facetsRequestProps.spv = personalizationParams.spv;
+            facetsRequestProps.personalization = personalizationParams.personalization;
             let facetsRes = yield SmartCollections.getSmartCollections(facetsRequestProps).then((response) => {
                 return response;
             });
@@ -837,6 +856,7 @@ const FastSimonApi = (_a) => {
             setVariationId,
             setForceAnd,
             setUserSegmentPreview,
+            setPersonalizationPreview,
             updateSettingsAndRefetch
         } }, { children: _jsx(FastState.Provider, Object.assign({ value: stateContextValue }, { children: _jsx(ThemeProvider, Object.assign({ theme: mergedTheme }, { children: children })) })) })));
 };