@athoscommerce/snap-store-mobx 1.5.1-beta.114 → 1.5.1

package/dist/esm/Chat/ChatStore.d.ts

@@ -1,91 +0,0 @@
-import { ChatStoreConfig, StoreServices } from '../types';
-import { MetaStore } from '../Meta/MetaStore';
-import type { MetaResponseModel, SearchResponseModelFacet } from '@athoscommerce/snapi-types';
-import { AbstractStore } from '../Abstract/AbstractStore';
-import type { ChatResponseModel, ChatRequestModel, ProductsResponseModel } from '@athoscommerce/snap-client';
-import type { UrlManager } from '@athoscommerce/snap-url-manager';
-import { StorageStore } from '@athoscommerce/snap-toolbox';
-import { ChatSessionStore } from './Stores/ChatSessionStore';
-import { ChatStatusResponse } from '@athoscommerce/snap-client';
-import { Product } from '../Search/Stores/SearchResultStore';
-import { SearchFacetStore } from '../Search/Stores/SearchFacetStore';
-export declare class ChatStore extends AbstractStore<ChatStoreConfig> {
-    meta?: MetaStore;
-    inputValue: string;
-    open: boolean;
-    storage: StorageStore;
-    services: StoreServices;
-    /** Detached UrlManager — holds the in-progress facet selection for the active facets display.
-     * Detached so .go() updates state without navigating the page. */
-    urlManager: UrlManager;
-    /** The single facet store rendered in chat — backed by the active message's facets. */
-    facets: SearchFacetStore;
-    chats: ChatSessionStore[];
-    currentChatId: string;
-    chatEnabled: boolean | null;
-    initChatLoading: boolean;
-    suggestedQuestions: string[];
-    welcomeMessage: string;
-    features: ChatStatusResponse['features'];
-    productQuickview: Product | null;
-    productQuickviewError: string | null;
-    /** Raw meta kept for lazy hydration of inactive chat sessions. */
-    private storedMetaData;
-    /** Tracks which message currently owns the displayed facets — guards against redundant rebuilds. */
-    private activeFacetsMessageId;
-    /** Bumps on every detached-urlManager change so observers re-evaluate isFacetSelected. */
-    urlVersion: number;
-    /** Snapshot of the applied filter state captured the last time the active message was seeded.
-     * Compared against the live urlManager state to decide whether there are pending changes.
-     * `null` means no facets have been seeded yet — there are no pending changes in that case. */
-    private appliedFilterSnapshot;
-    constructor(config: ChatStoreConfig, services: StoreServices);
-    /** Build a SearchFacetStore from raw facet data using the current detached urlManager.
-     * Synthesizes meta entries for each facet so SearchFacetStore's display/meta filter
-     * doesn't drop chat facets (the chat backend already decided what to send). */
-    private buildFacetStore;
-    /** Reset the detached urlManager and seed it with this message's filtered facet values,
-     * then rebuild the root SearchFacetStore so the UI shows the matching display. */
-    setActiveFacets(facets: SearchResponseModelFacet[], messageId: string | null): void;
-    /** Total number of selected facet values in the in-progress urlManager state, summed
-     * across all filter fields. Each value in a value facet, each range in a range-bucket
-     * facet, and the single range on a slider facet each count as one. */
-    get pendingFacetCount(): number;
-    /** True when the in-progress facet selection differs from the filters that were applied
-     * by the active productSearchResult — i.e. the user has selected/removed something that
-     * hasn't been sent yet. Used to decide whether to show the Apply button. */
-    get hasPendingFacetChanges(): boolean;
-    get currentChat(): ChatSessionStore | undefined;
-    get chatsIds(): string[];
-    get blocked(): boolean;
-    private applyChatStatusResponse;
-    handleChatStatusResponse(response: ChatStatusResponse): boolean;
-    reset(): void;
-    setProductQuickview(product: Product): void;
-    updateProductQuickview(response: ProductsResponseModel): void;
-    setProductQuickviewError(message: string): void;
-    clearProductQuickview(): void;
-    clearHistory(): void;
-    createChat(data?: {
-        sessionId: string;
-        sessionEndTime?: Date;
-    }): ChatSessionStore;
-    switchChat(id: string): void;
-    sendProductQuery(result: any, options: {
-        requestType: 'productQuery' | 'productSimilar' | 'productComparison';
-    }): void;
-    compareProduct(result: any): void;
-    addFacet(facet: {
-        key: string;
-        value: string;
-    }): void;
-    removeFacet(key: string, value: string): void;
-    clearPendingFacets(): void;
-    isFacetSelected(key: string, value: string): boolean;
-    request(request: ChatRequestModel): void;
-    update(data: {
-        chat: ChatResponseModel;
-        meta: MetaResponseModel;
-    }): void;
-}
-//# sourceMappingURL=ChatStore.d.ts.map

package/dist/esm/Chat/ChatStore.d.ts.map

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

package/dist/esm/Chat/ChatStore.js

@@ -1,568 +0,0 @@
-import { makeObservable, observable, computed, reaction } from 'mobx';
-import { MetaStore } from '../Meta/MetaStore';
-import { AbstractStore } from '../Abstract/AbstractStore';
-import { StorageStore } from '@athoscommerce/snap-toolbox';
-import { ChatSessionStore } from './Stores/ChatSessionStore';
-import { Product, Variants } from '../Search/Stores/SearchResultStore';
-import { SearchFacetStore } from '../Search/Stores/SearchFacetStore';
-const CHAT_STATUS_EXPIRATION_TIME = 1000 * 60 * 60 * 12; // 12 hours
-export class ChatStore extends AbstractStore {
-    constructor(config, services) {
-        super(config);
-        this.meta = undefined;
-        this.inputValue = '';
-        this.open = false;
-        this.chats = [];
-        this.chatEnabled = null;
-        this.initChatLoading = false;
-        this.suggestedQuestions = [];
-        this.welcomeMessage = '';
-        this.features = { imageSearch: { enabled: false }, similarProducts: { enabled: false } };
-        this.productQuickview = null;
-        this.productQuickviewError = null;
-        /** Raw meta kept for lazy hydration of inactive chat sessions. */
-        this.storedMetaData = null;
-        /** Tracks which message currently owns the displayed facets — guards against redundant rebuilds. */
-        this.activeFacetsMessageId = null;
-        /** Bumps on every detached-urlManager change so observers re-evaluate isFacetSelected. */
-        this.urlVersion = 0;
-        /** Snapshot of the applied filter state captured the last time the active message was seeded.
-         * Compared against the live urlManager state to decide whether there are pending changes.
-         * `null` means no facets have been seeded yet — there are no pending changes in that case. */
-        this.appliedFilterSnapshot = null;
-        this.services = services;
-        this.urlManager = services.urlManager.detach(true);
-        this.urlManager.subscribe(() => {
-            this.urlVersion++;
-        });
-        const legacyKey = `ss-${this.config.id}`;
-        const storageKey = this.config.siteId ? `ss-${this.config.siteId}-${this.config.id}` : legacyKey;
-        this.storage = new StorageStore({
-            type: 'local',
-            key: storageKey,
-        });
-        this.facets = this.buildFacetStore();
-        const storedChatStatusResponse = this.storage.get('chatStatusResponse');
-        if (storedChatStatusResponse) {
-            try {
-                const storedChatStatus = JSON.parse(storedChatStatusResponse);
-                if (storedChatStatus.checkTime && Date.now() - storedChatStatus.checkTime > CHAT_STATUS_EXPIRATION_TIME) {
-                    // chat status is expired, remove from storage to trigger a new check
-                    this.storage.set('chatStatusResponse', null);
-                }
-                else {
-                    // Apply the stored response without persisting, so the 12-hour
-                    // checkTime keeps counting from the last real API call rather
-                    // than resetting on every page load.
-                    this.applyChatStatusResponse(storedChatStatus.response);
-                }
-            }
-            catch {
-                this.storage.set('chatStatusResponse', null);
-            }
-        }
-        // check for entries in storage
-        let latestChatId = '';
-        const storedChats = this.storage.get('chats');
-        storedChats &&
-            Object.keys(storedChats || {}).forEach((chatId) => {
-                const chatData = storedChats[chatId];
-                if (chatData) {
-                    const restoredChat = new ChatSessionStore({
-                        data: {
-                            ...chatData,
-                            id: chatId,
-                        },
-                        stores: {
-                            storage: this.storage,
-                        },
-                    });
-                    // Mark as unhydrated — results are still raw JSON from storage.
-                    // Only the active session will be hydrated below.
-                    restoredChat.hydrated = false;
-                    this.chats.push(restoredChat);
-                    latestChatId = chatId;
-                }
-            });
-        // Prefer the persisted active chat ID so switching chats survives page reloads.
-        // Fall back to the most recently created chat if the stored ID is missing or stale.
-        const storedCurrentChatId = this.storage.get('currentChatId');
-        const activeChatId = storedCurrentChatId && this.chats.some((chat) => chat.id === storedCurrentChatId) ? storedCurrentChatId : latestChatId;
-        const storedMeta = this.storage.get('meta');
-        if (storedMeta) {
-            try {
-                const metaData = JSON.parse(storedMeta);
-                this.meta = new MetaStore({
-                    data: {
-                        meta: metaData,
-                    },
-                });
-                // Keep raw meta for lazy hydration of inactive sessions
-                this.storedMetaData = metaData;
-                // Only hydrate the active chat session — inactive sessions will be
-                // hydrated lazily when switched to via switchChat()
-                const activeChat = this.chats.find((chat) => chat.id === activeChatId);
-                if (activeChat) {
-                    activeChat.hydrateResults(metaData);
-                    activeChat.hydrated = true;
-                }
-            }
-            catch {
-                this.storage.set('meta', null);
-            }
-        }
-        this.currentChatId = activeChatId;
-        makeObservable(this, {
-            meta: observable,
-            inputValue: observable,
-            open: observable,
-            chats: observable,
-            currentChatId: observable,
-            chatEnabled: observable,
-            initChatLoading: observable,
-            blocked: computed,
-            currentChat: computed,
-            chatsIds: computed,
-            features: observable,
-            suggestedQuestions: observable,
-            welcomeMessage: observable,
-            productQuickview: observable,
-            productQuickviewError: observable,
-            facets: observable,
-            urlVersion: observable,
-            hasPendingFacetChanges: computed,
-            pendingFacetCount: computed,
-        });
-        // Sync the root facets display with the active message. Only productSearchResult
-        // messages carry facets — for any other active message, clear the display so a
-        // stale facet bar from a previous response doesn't linger.
-        // Exception: when the user clicks "discuss product" on a carousel result, the
-        // active message becomes the productQuery side-chat, but the carousel is still
-        // the last real message — keep its facets visible alongside the product context.
-        reaction(() => {
-            const chat = this.currentChat;
-            const active = chat?.activeMessage;
-            if (active?.messageType === 'productSearchResult')
-                return active;
-            if (active?.messageType === 'productQuery' && chat) {
-                const messages = chat.chat;
-                const activeIdx = messages.findIndex((m) => m.id === active.id);
-                if (activeIdx > 0 && messages[activeIdx - 1].messageType === 'productSearchResult') {
-                    return messages[activeIdx - 1];
-                }
-            }
-            return null;
-        }, (active) => {
-            if (active && active.id !== this.activeFacetsMessageId) {
-                const facets = active.facets;
-                this.setActiveFacets(facets || [], active.id);
-            }
-            else if (!active && this.activeFacetsMessageId !== null) {
-                this.setActiveFacets([], null);
-            }
-        }, { fireImmediately: true });
-        // Mirror the urlManager's pending range filters into each RangeFacet's `active`.
-        // Slider facets are remounted whenever their dropdown closes/reopens and the
-        // FacetSlider seeds its state from facet.active — without this sync the slider
-        // would snap back to the server-provided active on every reopen, losing the
-        // user's pending selection until Apply is clicked.
-        // Note: range filters round-trip through the detached urlManager's URL form,
-        // so they come back as `[{low, high}]` arrays even though they were set as objects.
-        const readRangeFilter = (raw) => {
-            const entry = Array.isArray(raw) ? raw[raw.length - 1] : raw;
-            if (!entry || typeof entry !== 'object')
-                return null;
-            if (typeof entry.low === 'undefined' && typeof entry.high === 'undefined')
-                return null;
-            return {
-                low: entry.low === null || typeof entry.low === 'undefined' ? undefined : Number(entry.low),
-                high: entry.high === null || typeof entry.high === 'undefined' ? undefined : Number(entry.high),
-            };
-        };
-        reaction(() => {
-            void this.urlVersion;
-            const filterState = this.urlManager.state?.filter || {};
-            return this.facets
-                .filter((f) => f.type === 'range')
-                .map((f) => {
-                const pending = readRangeFilter(filterState[f.field]);
-                return `${f.field}:${pending?.low ?? '*'}:${pending?.high ?? '*'}`;
-            })
-                .join('|');
-        }, () => {
-            const filterState = this.urlManager.state?.filter || {};
-            for (const facet of this.facets) {
-                if (facet.type !== 'range')
-                    continue;
-                const rangeFacet = facet;
-                const pending = readRangeFilter(filterState[rangeFacet.field]);
-                const desired = pending
-                    ? {
-                        low: typeof pending.low !== 'undefined' ? pending.low : rangeFacet.range?.low,
-                        high: typeof pending.high !== 'undefined' ? pending.high : rangeFacet.range?.high,
-                    }
-                    : rangeFacet.range
-                        ? { low: rangeFacet.range.low, high: rangeFacet.range.high }
-                        : null;
-                if (!desired)
-                    continue;
-                if (rangeFacet.active?.low !== desired.low || rangeFacet.active?.high !== desired.high) {
-                    rangeFacet.active = desired;
-                }
-            }
-        }, { fireImmediately: true });
-    }
-    /** Build a SearchFacetStore from raw facet data using the current detached urlManager.
-     * Synthesizes meta entries for each facet so SearchFacetStore's display/meta filter
-     * doesn't drop chat facets (the chat backend already decided what to send). */
-    buildFacetStore(facets = []) {
-        const baseMeta = this.meta?.data || {};
-        const baseFacetMeta = baseMeta.facets || {};
-        const facetMeta = { ...baseFacetMeta };
-        facets.forEach((facet) => {
-            if (!facet.field)
-                return;
-            const expectedDisplay = facet.type === 'range' ? 'slider' : 'list';
-            const existing = facetMeta[facet.field];
-            if (!existing || existing.display !== expectedDisplay) {
-                facetMeta[facet.field] = {
-                    ...(existing || {}),
-                    field: facet.field,
-                    label: facet.label,
-                    display: expectedDisplay,
-                };
-            }
-        });
-        return new SearchFacetStore({
-            config: {},
-            services: { ...this.services, urlManager: this.urlManager },
-            stores: { storage: this.storage },
-            data: {
-                search: { facets },
-                meta: { ...baseMeta, facets: facetMeta },
-            },
-        });
-    }
-    /** Reset the detached urlManager and seed it with this message's filtered facet values,
-     * then rebuild the root SearchFacetStore so the UI shows the matching display. */
-    setActiveFacets(facets, messageId) {
-        // reset url state, then seed with the API-reported filtered values
-        this.urlManager.reset().go();
-        facets.forEach((facet) => {
-            // Slider/range facets carry the active selection on the facet itself rather
-            // than on individual bucket values.
-            if (facet.type === 'range') {
-                const active = facet.active;
-                const range = facet.range;
-                if (active && range && (active.low !== range.low || active.high !== range.high)) {
-                    this.urlManager.set(`filter.${facet.field}`, { low: active.low, high: active.high }).go();
-                }
-                return;
-            }
-            const filteredValues = (facet.values || []).filter((v) => v?.filtered);
-            filteredValues.forEach((v) => {
-                if (typeof v.low !== 'undefined' || typeof v.high !== 'undefined') {
-                    this.urlManager.merge(`filter.${facet.field}`, [{ low: v.low, high: v.high }]).go();
-                }
-                else if (typeof v.value !== 'undefined') {
-                    this.urlManager.merge(`filter.${facet.field}`, v.value).go();
-                }
-            });
-        });
-        this.facets = this.buildFacetStore(facets);
-        this.activeFacetsMessageId = messageId;
-        this.appliedFilterSnapshot = stableStringify(this.urlManager.state?.filter);
-    }
-    /** Total number of selected facet values in the in-progress urlManager state, summed
-     * across all filter fields. Each value in a value facet, each range in a range-bucket
-     * facet, and the single range on a slider facet each count as one. */
-    get pendingFacetCount() {
-        void this.urlVersion;
-        const filterState = this.urlManager.state?.filter;
-        if (!filterState)
-            return 0;
-        let count = 0;
-        for (const key of Object.keys(filterState)) {
-            const value = filterState[key];
-            if (Array.isArray(value)) {
-                count += value.length;
-            }
-            else if (typeof value !== 'undefined') {
-                count += 1;
-            }
-        }
-        return count;
-    }
-    /** True when the in-progress facet selection differs from the filters that were applied
-     * by the active productSearchResult — i.e. the user has selected/removed something that
-     * hasn't been sent yet. Used to decide whether to show the Apply button. */
-    get hasPendingFacetChanges() {
-        // touch the version so mobx re-runs this when urlManager state changes
-        void this.urlVersion;
-        const filterState = this.urlManager.state?.filter;
-        if (this.appliedFilterSnapshot === null) {
-            // No facets have been seeded — pending changes exist only if
-            // the user has manually added filters via addFacet.
-            return filterState !== undefined && Object.keys(filterState).length > 0;
-        }
-        return stableStringify(filterState) !== this.appliedFilterSnapshot;
-    }
-    get currentChat() {
-        return this.chats.find((chat) => chat.id === this.currentChatId);
-    }
-    get chatsIds() {
-        return this.chats.map((chat) => chat.id);
-    }
-    get blocked() {
-        let isBlocked = false;
-        const blockedAttachments = this.currentChat?.attachments.items.some((item) => item.type === 'image' && item.state === 'loading');
-        if (this.loading || blockedAttachments) {
-            isBlocked = true;
-        }
-        return isBlocked;
-    }
-    applyChatStatusResponse(response) {
-        const { chatbot, features } = response;
-        const { status, suggestedQuestions, welcomeMessage } = chatbot;
-        this.chatEnabled = status.enabled === true;
-        this.features = features;
-        this.suggestedQuestions = suggestedQuestions || [];
-        this.welcomeMessage = welcomeMessage || '';
-        return this.chatEnabled;
-    }
-    handleChatStatusResponse(response) {
-        const enabled = this.applyChatStatusResponse(response);
-        // Always persist on a real API response — restarts the 12-hour expiration
-        // so each new chat session refreshes the cache.
-        this.storage.set('chatStatusResponse', JSON.stringify({ response, checkTime: Date.now() }));
-        return enabled;
-    }
-    reset() {
-        this.chats = [];
-        this.clearProductQuickview();
-        this.storage.clear();
-        this.createChat();
-    }
-    setProductQuickview(product) {
-        // Clone the product so variant selections (and the parent-mappings merge done
-        // in updateProductQuickview) only affect the quickview — the carousel and any
-        // other surfaces still hold the original instance.
-        this.productQuickview = cloneProductForQuickview(product, this.meta?.data);
-        this.productQuickviewError = null;
-    }
-    updateProductQuickview(response) {
-        if (!this.productQuickview) {
-            return;
-        }
-        // merge parent-level mappings from the API response into the Product
-        this.productQuickview.mappings = {
-            ...this.productQuickview.mappings,
-            core: { ...this.productQuickview.mappings.core, ...response.mappings.core },
-        };
-        const meta = this.meta?.data || {};
-        if (this.productQuickview.variants) {
-            // update existing Variants with new data from the Products API
-            this.productQuickview.variants.optionConfig = response.variants.optionConfig;
-            this.productQuickview.variants.update(response.variants.data);
-        }
-        else {
-            // create Variants for the first time using the Products API data
-            this.productQuickview.variants = new Variants({
-                data: {
-                    mask: this.productQuickview.mask,
-                    variants: response.variants.data,
-                    optionConfig: response.variants.optionConfig,
-                    meta,
-                },
-            });
-        }
-    }
-    setProductQuickviewError(message) {
-        this.productQuickviewError = message;
-    }
-    clearProductQuickview() {
-        this.productQuickview = null;
-        this.productQuickviewError = null;
-    }
-    clearHistory() {
-        // drop previous chats while keeping the conversation the user is currently in;
-        // if there is no current chat, fall back to a full reset
-        const currentChat = this.currentChat;
-        if (!currentChat) {
-            this.reset();
-            return;
-        }
-        const storedChats = this.storage.get('chats') || {};
-        const filtered = {};
-        if (storedChats[currentChat.id]) {
-            filtered[currentChat.id] = storedChats[currentChat.id];
-        }
-        this.storage.set('chats', filtered);
-        this.chats = [currentChat];
-    }
-    createChat(data) {
-        // abandon any in-flight request state from the previous chat — its
-        // response will be discarded by the controller, so the UI shouldn't
-        // keep showing its loading spinner or stale error
-        this.loading = false;
-        this.error = undefined;
-        // Prune old sessions before creating a new one to keep storage bounded
-        ChatSessionStore.pruneStoredSessions(this.storage);
-        const newChat = new ChatSessionStore({
-            data: {
-                sessionId: data?.sessionId,
-                sessionEndTime: data?.sessionEndTime,
-            },
-            stores: {
-                storage: this.storage,
-            },
-        });
-        this.currentChatId = newChat.id;
-        this.storage.set('currentChatId', newChat.id);
-        this.chats.push(newChat);
-        return newChat;
-    }
-    switchChat(id) {
-        const chatExists = this.chats.find((chat) => chat.id === id);
-        if (chatExists) {
-            // Lazily hydrate results when switching to a session for the first time
-            if (!chatExists.hydrated && this.storedMetaData) {
-                chatExists.hydrateResults(this.storedMetaData);
-                chatExists.hydrated = true;
-            }
-            this.currentChatId = id;
-            this.storage.set('currentChatId', id);
-        }
-    }
-    sendProductQuery(result, options) {
-        const display = result?.display || result;
-        this.currentChat?.attachments.add({
-            type: 'product',
-            requestType: options.requestType,
-            productId: result.id,
-            name: display.mappings?.core?.name,
-            thumbnailUrl: display.mappings?.core?.thumbnailImageUrl || display.mappings?.core?.imageUrl || display.mappings?.core?.parentImageUrl,
-        });
-        // for the productQuery flow we want the secondary chat to immediately
-        // show the product details panel — push a productQuery message so it
-        // becomes the active side-chat message until a productAnswer arrives
-        if (options.requestType === 'productQuery' && this.currentChat) {
-            this.currentChat.pushProductQueryMessage(result);
-        }
-    }
-    compareProduct(result) {
-        this.currentChat?.comparisons.add({
-            result,
-        });
-    }
-    addFacet(facet) {
-        const value = parseFacetValue(facet.value);
-        this.urlManager.merge(`filter.${facet.key}`, Array.isArray(value) ? value : value).go();
-    }
-    removeFacet(key, value) {
-        const parsed = parseFacetValue(value);
-        this.urlManager.remove(`filter.${key}`, parsed).go();
-    }
-    clearPendingFacets() {
-        this.urlManager.remove('filter').go();
-    }
-    isFacetSelected(key, value) {
-        // touch the version so mobx re-runs this when urlManager state changes (the
-        // underlying UrlManager isn't a mobx observable, so we mirror its updates here)
-        void this.urlVersion;
-        const filterState = this.urlManager.state?.filter;
-        if (!filterState || !filterState[key])
-            return false;
-        const stored = Array.isArray(filterState[key]) ? filterState[key] : [filterState[key]];
-        const parsed = parseFacetValue(value);
-        return stored.some((entry) => facetValueEquals(entry, parsed));
-    }
-    request(request) {
-        // snapshot facet labels (field + per-value) from the active facets display so the
-        // outgoing user message can render "Filter by Color Red" rather than raw keys
-        const filterLabels = {};
-        for (const facet of this.facets) {
-            const valueFacet = facet;
-            const values = {};
-            (valueFacet.values || []).forEach((v) => {
-                if (typeof v.low !== 'undefined' || typeof v.high !== 'undefined') {
-                    values[`${v.low ?? '*'}:${v.high ?? '*'}`] = v.label;
-                }
-                else if (typeof v.value !== 'undefined') {
-                    values[v.value] = v.label;
-                }
-            });
-            filterLabels[valueFacet.field] = { facetLabel: valueFacet.label || valueFacet.field, values };
-        }
-        this.currentChat?.request(request, filterLabels);
-        // remove any productSimilar attachments after request
-        const productSimilarAttachments = this.currentChat?.attachments.attached.filter((item) => item.type === 'product' && item.requestType === 'productSimilar') || [];
-        productSimilarAttachments.forEach((item) => {
-            this.currentChat?.attachments.remove(item.id);
-        });
-    }
-    update(data) {
-        // TODO: handle error
-        // if(err?.responseBody?.errorMessage || err?.responseBody?.errorCode) {
-        // 	const errorMessage = err?.responseBody?.errorMessage || 'An unknown error has occurred.';
-        // }
-        this.currentChat?.update(data);
-        if (!this.meta) {
-            this.storage.set('meta', JSON.stringify(data.meta));
-        }
-        this.meta = new MetaStore({
-            data: {
-                meta: data.meta,
-            },
-        });
-        // Keep raw meta in sync for lazy hydration of inactive sessions
-        this.storedMetaData = data.meta;
-    }
-}
-/** Deterministic JSON.stringify — sorts object keys recursively so equality comparisons
- * aren't sensitive to insertion order. */
-function stableStringify(value) {
-    if (value === null || value === undefined)
-        return 'null';
-    if (typeof value !== 'object')
-        return JSON.stringify(value);
-    if (Array.isArray(value)) {
-        return `[${value.map((v) => stableStringify(v)).join(',')}]`;
-    }
-    const keys = Object.keys(value).sort();
-    return `{${keys.map((k) => `${JSON.stringify(k)}:${stableStringify(value[k])}`).join(',')}}`;
-}
-/** Convert a chat-facet UI value into the URL-state shape — range buckets arrive as "low:high". */
-function parseFacetValue(value) {
-    if (typeof value === 'string' && value.includes(':')) {
-        const [low, high] = value.split(':');
-        return {
-            low: low === '*' ? undefined : Number(low),
-            high: high === '*' ? undefined : Number(high),
-        };
-    }
-    return value;
-}
-function facetValueEquals(a, b) {
-    if (typeof a === 'object' && a !== null && typeof b === 'object' && b !== null) {
-        return a.low === b.low && a.high === b.high;
-    }
-    return a === b;
-}
-/** Build a fresh observable Product from an existing one. Variants are intentionally
- * omitted — `updateProductQuickview` populates them from the products API response. */
-function cloneProductForQuickview(product, meta) {
-    const result = {
-        id: product.id,
-        responseId: product.responseId,
-        mappings: JSON.parse(JSON.stringify(product.mappings || {})),
-        attributes: JSON.parse(JSON.stringify(product.attributes || {})),
-        badges: product.badges?.all?.map((b) => ({ tag: b.tag })) || [],
-    };
-    return new Product({
-        config: {},
-        data: { result, meta: meta || {} },
-        position: product.position ?? 0,
-        responseId: product.responseId,
-    });
-}