@nuskin/react-search-sdk 1.0.0-comx-2233.1

package/README.md

@@ -0,0 +1,27 @@
+# @nuskin/react-search-sdk
+
+Business logic, hooks, and API services for the NuSkin search experience.
+
+- **Phase 0 (in progress)** — Lift-and-shift of the existing Equinox typeahead search from `header-mfe` into a reusable SDK.
+- **Phase 1** — AI-enabled conversational search (NuI chat + product recommendations). See `react-search-components/docs/AI-Search-Design-Document.md`.
+
+This package is a pure TypeScript library (no JSX, no framework coupling). UI lives in [`@nuskin/react-search-components`](../react-search-components).
+
+## Requirements
+
+- Node.js `>=22.0.0 <23.0.0`
+- React `^18.2.0` (peer)
+
+## Scripts
+
+| Script             | Purpose                                              |
+| ------------------ | ---------------------------------------------------- |
+| `yarn build`       | Build CJS + ESM + `.d.ts` bundle via tsup.           |
+| `yarn test`        | Run Jest with coverage (80% threshold).              |
+| `yarn types:check` | Type-check without emitting.                         |
+| `yarn lint`        | ESLint on `src/**/*.{ts,tsx}`.                       |
+| `yarn validate`    | Full pipeline: format → lint → types → test → build. |
+
+## Public API
+
+See [`src/index.ts`](src/index.ts). The API surface grows as each Phase 0 module lands.

package/dist/index.d.mts

@@ -0,0 +1,513 @@
+import React from 'react';
+import * as zustand_middleware from 'zustand/middleware';
+import * as zustand from 'zustand';
+
+/**
+ * Shared TypeScript types for the search SDK.
+ *
+ * Kept intentionally permissive at the boundary (`unknown`, `[key: string]: unknown`)
+ * to preserve the drop-in behavior of the ported JavaScript service. Downstream
+ * consumers can narrow at their integration point.
+ */
+
+/** Normalised locale parts as consumed by the SDK. */
+interface LocaleParts {
+    /** ISO 3166-1 alpha-2, upper-case. Example: `"US"`. */
+    country: string;
+    /** ISO 639-1, lower-case. Example: `"en"`. */
+    language: string;
+    /** Full Contentstack-style locale string. Example: `"US-en"`. */
+    locale: string;
+}
+/**
+ * Shape returned by the market-config lookup. Only the fields the SDK reads
+ * are typed; consumers may pass through additional properties.
+ */
+interface MarketConfig {
+    api_gateway_path?: string;
+    store_id?: string | number;
+    [key: string]: unknown;
+}
+/** Callback the consumer wires in to resolve market config on demand. */
+type GetMarketConfig = (context: {
+    locationLike: LocationLike | null;
+    country: string;
+}) => Promise<MarketConfig | null | undefined>;
+/**
+ * The subset of the DOM `Location` interface the SDK depends on. Every
+ * property is optional so tests can pass minimal fakes.
+ */
+interface LocationLike {
+    origin?: string;
+    hostname?: string;
+    pathname?: string;
+    search?: string;
+    href?: string;
+    assign?: (url: string) => void;
+}
+/**
+ * A raw suggestion / option payload used for navigation. Fields mirror the
+ * shapes the original service defensively read from — none are required.
+ */
+interface SuggestionOption {
+    slug?: string | undefined;
+    productSlug?: string | undefined;
+    product_slug?: string | undefined;
+    href?: string | undefined;
+    url?: string | undefined;
+    value?: string | undefined;
+    label?: string | undefined;
+    identifier?: string | undefined;
+    [key: string]: unknown;
+}
+/** Response shape returned by `fetchSuggestions`. */
+interface SuggestionsResponse {
+    /** Suggestions array. May be empty when the API returns no matches. */
+    suggestions: unknown[];
+    /** "Did you mean?" alternate-query suggestions. */
+    didYouMean: unknown[];
+    /** Total match count reported by the API. */
+    totalResultsCount: number;
+    /** Original product array from the catalog API. */
+    product?: unknown;
+    /** Pageable metadata from the catalog API. */
+    pageableInfo?: {
+        totalCount?: number;
+    } & Record<string, unknown>;
+    /** Original snake_case field name from some API variants. */
+    did_you_mean?: unknown;
+    [key: string]: unknown;
+}
+/** Copy strings surfaced to the input chrome. */
+interface SearchChromeCopy {
+    placeholder: string;
+    inputAriaLabel: string;
+}
+/** Mapped product type after normalisation. */
+type ProductType = 'bundle' | 'single';
+/**
+ * A catalog suggestion item produced by `mapCatalogProductToSuggestion`.
+ * All navigation fields are preserved from the original service shape.
+ */
+interface CatalogSuggestionItem {
+    id: string;
+    identifier: string;
+    sku: string;
+    label: string;
+    value: string;
+    imageURL: string;
+    thumbnail: string;
+    productType: ProductType;
+    product_type: ProductType;
+    outOfStock: boolean;
+    productStatus: string | undefined;
+    status: string | undefined;
+    cartActionDisabled: boolean;
+    customProductType: string;
+    slug: string | null;
+    productSlug: string | null;
+    url: string | null;
+    href: string | null;
+    keywords: string;
+    ingredientTerms: string[];
+}
+/**
+ * A "Did You Mean?" item produced by `normalizeDidYouMean`. Additional
+ * fields from the raw API response are preserved via index signature.
+ */
+interface DidYouMeanItem {
+    id: string;
+    value: string;
+    suggestionType: 'did-you-mean';
+    [key: string]: unknown;
+}
+/** Options accepted by `useSearchSuggestions`. */
+interface UseSearchSuggestionsOptions {
+    /** The `SearchService` instance created by `createSearchService`. */
+    service: SearchService;
+    /**
+     * When `false` the hook clears state and skips all API calls.
+     * Useful for suppressing suggestions while the user is typing a question.
+     * Defaults to `true`.
+     */
+    enabled?: boolean;
+}
+/** State and actions returned by `useSearchSuggestions`. */
+interface UseSearchSuggestionsResult {
+    /**
+     * Resets the query to `""` and clears all suggestions state.
+     * Call when the user clicks the Clear button.
+     */
+    clearQuery: () => void;
+    /**
+     * `true` after a fetch completes with an empty result set.
+     * Use this to show a "No suggestions" message.
+     */
+    emptyFetched: boolean;
+    /** `true` when the server has more matches than `MAX_VISIBLE_SUGGESTIONS`. */
+    hasMoreResults: boolean;
+    /** `true` when the trimmed query is non-empty. */
+    hasQuery: boolean;
+    /** Normalised "Did You Mean?" items from the API. */
+    didYouMean: DidYouMeanItem[];
+    /** `true` while a debounced fetch is in flight. */
+    loading: boolean;
+    /** The current query string (unmodified, as typed by the user). */
+    query: string;
+    /** Raw React state setter — prefer `updateQuery` for controlled inputs. */
+    setQuery: React.Dispatch<React.SetStateAction<string>>;
+    /** Normalised product suggestion items from the catalog API. */
+    suggestions: CatalogSuggestionItem[];
+    /** Total match count reported by the Equinox API. */
+    totalResultsCount: number;
+    /**
+     * Preferred setter — updates `query`, optimistically sets `loading`, and
+     * clears `emptyFetched` before the debounce fires.
+     */
+    updateQuery: (query: string) => void;
+}
+/** Options accepted by `createSearchService`. */
+interface SearchServiceOptions {
+    /** Custom `fetch` implementation. Defaults to the global `fetch` when available. */
+    fetchImpl?: typeof fetch | null | undefined;
+    /** DOM `Location`-like object. Defaults to `window.location` in the browser. */
+    location?: LocationLike | null | undefined;
+    /** Storage-like object. Defaults to `window.sessionStorage` in the browser. */
+    storage?: Storage | null | undefined;
+    /**
+     * Explicit suggestions URL or path. When provided, overrides the market-config
+     * lookup. Absolute URLs are used as-is; paths are resolved against
+     * `location.origin`.
+     */
+    suggestionsApi?: string | undefined;
+    /** Explicit Equinox store ID. When provided, overrides the market-config lookup. */
+    storeId?: string | number | undefined;
+    /** ISO 3166-1 alpha-2 country code. Normalised to upper-case. */
+    country?: string | undefined;
+    /** ISO 639-1 language code. Normalised to lower-case. */
+    language?: string | undefined;
+    /** Full Contentstack-style locale string. Falls back to `"UNKNOWN"`. */
+    locale?: string | undefined;
+    /** Placeholder text for the expanded input. */
+    searchPlaceholder?: string | undefined;
+    /** Aria-label for the expanded input. */
+    inputAriaLabel?: string | undefined;
+    /**
+     * Async callback resolving to a `MarketConfig`. Required for automatic
+     * suggestion-URL/storeId resolution when `suggestionsApi`/`storeId` are
+     * not passed explicitly.
+     */
+    getMarketConfig?: GetMarketConfig | undefined;
+    /**
+     * Optional callback invoked when a suggestion action (cart icon click) is activated.
+     * Allows consumers to implement custom behavior (e.g., add-to-cart) before navigation.
+     * If this returns `true`, navigation is skipped; if `false` or undefined, normal navigation proceeds.
+     */
+    onSuggestionAction?: (option: SuggestionOption) => Promise<boolean> | boolean | undefined;
+}
+/** Public API returned by `createSearchService`. Behaviour matches header-mfe. */
+interface SearchService {
+    /** Returns fallback placeholder + aria-label copy. */
+    getSearchChromeCopy: () => Promise<SearchChromeCopy>;
+    /** Fetches typeahead suggestions from the Equinox catalog. */
+    fetchSuggestions: (searchTerm: string) => Promise<SuggestionsResponse>;
+    /**
+     * Records the query in recent searches, then navigates to the option URL
+     * or to the fallback search-results path. Returns the URL that was used.
+     */
+    submitProductSearch: (query: string, option?: SuggestionOption) => string | undefined;
+    /**
+     * Follows the suggestion's URL if one is resolvable; otherwise submits
+     * the suggestion's textual value as a product search.
+     */
+    activateSuggestionAction: (option: SuggestionOption) => string | undefined;
+    /** Returns the navigable URL for a suggestion option (or `""`). */
+    getSuggestionHref: (option: SuggestionOption) => string;
+    /** Navigates to the search-results page for `query`. */
+    viewMoreResults: (input: {
+        query: string;
+    }) => string | undefined;
+    /** Returns the persisted recent searches for the current locale bucket. */
+    getRecentSearches: () => string[];
+    /** Removes all persisted recent searches for the current locale bucket. */
+    clearRecentSearches: () => void;
+}
+
+/**
+ * SearchApiService — Phase 0 lift-and-shift of
+ * `header-mfe/src/services/HeaderSearchService.js`.
+ *
+ * Behaviour is intentionally preserved verbatim: same URL formats, same
+ * `sessionStorage` key format, same fetch parameter shape, same fallback
+ * values. See the ported source for context.
+ *
+ * Two responsibilities were intentionally moved OUT of the SDK to preserve
+ * the SDK-narrow boundary:
+ *   1. Market-config resolution (`equinoxMarketsConfig.js` — depends on
+ *      `@nuskin/configuration-sdk`). Consumers inject a `getMarketConfig`
+ *      callback if they want automatic URL/store-id resolution.
+ *   2. Locale resolution from the browser URL (`getLocale`). Consumers must
+ *      pass `country`/`language` explicitly.
+ */
+
+/**
+ * Replaces `{api_name}` in a market-config gateway path with the given API
+ * name, then trims a single trailing slash. Ported from the equivalent helper
+ * in `equinoxMarketsConfig.js` so the SDK has no runtime dependency on it.
+ */
+declare function resolveApiGatewayPath(apiGatewayPath: string | undefined | null, apiName?: string): string;
+/**
+ * Creates a search service instance. All options are optional; sensible
+ * fallbacks are used when the browser environment is absent (SSR).
+ */
+declare function createSearchService(options?: SearchServiceOptions): SearchService;
+
+/**
+ * ChatService — two-step NuSkin AI chat API.
+ *
+ * Step 1: POST /chat/conversations  → receives conversation_id
+ * Step 2: POST /chat/messages       → SSE stream parsed with eventsource-parser
+ *
+ * Products are embedded in AI response content as ```products [...] ``` code blocks.
+ */
+interface ChatProduct {
+    sku: string;
+    name: string;
+    category?: string;
+    pv?: number;
+    retail_price?: number;
+    description?: string;
+    image_url?: string;
+    badge?: string;
+    [key: string]: unknown;
+}
+interface ChatMessageResult {
+    summary: string;
+    products: ChatProduct[];
+    /** Raw accumulated content including markdown, for downstream rendering. */
+    rawContent: string;
+}
+interface ChatServiceOptions {
+    /** POST endpoint for creating a conversation. */
+    conversationsUrl?: string;
+    /** POST endpoint for sending a message (SSE response). */
+    messagesUrl?: string;
+    /** X-Tenant-Id header value (used for conversations call). */
+    tenantId?: string;
+    /** Returns the current Bearer token, or null if unauthenticated. */
+    getAuthToken?: () => string | null;
+    /** Override fetch for testing. */
+    fetchImpl?: typeof fetch | null;
+}
+interface ChatService {
+    /** Creates a conversation and returns the numeric conversation ID. */
+    createConversation: (title?: string) => Promise<number>;
+    /** Sends a message and streams back a parsed result. */
+    sendMessage: (conversationId: number, content: string, onChunk?: (type: string, text: string) => void) => Promise<ChatMessageResult>;
+}
+declare function createChatService(options: ChatServiceOptions): ChatService;
+
+/**
+ * useSearchSuggestions — Phase 0 lift-and-shift of
+ * `header-mfe/src/components/search/auto-complete/hooks/useAutoComplete.js`
+ * (`useAutoCompleteSuggestions` export).
+ *
+ * Behaviour is preserved verbatim:
+ *   - 220 ms debounce (DEBOUNCE_MS constant — do not change)
+ *   - Request-ID stale-response guard (replaces AbortController in the original)
+ *   - `MAX_VISIBLE_SUGGESTIONS` cap applied before setting state
+ *   - `didYouMean` items take precedence: when present, `suggestions` is set
+ *     to `[]` and the DYM items are used as the visible list
+ *   - `emptyFetched` is only set to `true` when BOTH arrays are empty after
+ *     a successful fetch
+ *   - `enabled = false` clears state without firing an API call
+ *
+ * Keyboard navigation (`useAutoCompleteKeyboard`) and all display-data helpers
+ * live in `react-search-components` — they depend on DOM refs and component props.
+ */
+
+/**
+ * Manages debounced typeahead suggestions from the Equinox catalog API.
+ *
+ * @example
+ * ```tsx
+ * const service = createSearchService({ country, language, locale, suggestionsApi, storeId });
+ * const { suggestions, didYouMean, loading, updateQuery, clearQuery } =
+ *   useSearchSuggestions({ service });
+ * ```
+ */
+declare function useSearchSuggestions({ service, enabled, }: UseSearchSuggestionsOptions): UseSearchSuggestionsResult;
+
+interface SearchHistoryEntry {
+    query: string;
+    isAI: boolean;
+    /** Serialized AI result payload; consumers cast to their concrete result type */
+    aiResult?: unknown;
+    timestamp: number;
+}
+interface SearchHistoryState {
+    entries: SearchHistoryEntry[];
+    /** Save a full entry (AI or non-AI); deduplicates by query (case-insensitive). */
+    addEntry: (entry: Omit<SearchHistoryEntry, 'timestamp'>) => void;
+    /** Convenience alias — saves a plain non-AI query entry. */
+    addQuery: (query: string) => void;
+    removeEntry: (query: string) => void;
+    clearAll: () => void;
+}
+declare const useSearchHistoryStore: zustand.UseBoundStore<Omit<zustand.StoreApi<SearchHistoryState>, "persist"> & {
+    persist: {
+        setOptions: (options: Partial<zustand_middleware.PersistOptions<SearchHistoryState, unknown>>) => void;
+        clearStorage: () => void;
+        rehydrate: () => Promise<void> | void;
+        hasHydrated: () => boolean;
+        onHydrate: (fn: (state: SearchHistoryState) => void) => () => void;
+        onFinishHydration: (fn: (state: SearchHistoryState) => void) => () => void;
+        getOptions: () => Partial<zustand_middleware.PersistOptions<SearchHistoryState, unknown>>;
+    };
+}>;
+
+interface UseSearchHistoryResult {
+    entries: SearchHistoryEntry[];
+    /** Derived string list of queries (backward compat) */
+    queries: string[];
+    addEntry: (entry: Omit<SearchHistoryEntry, 'timestamp'>) => void;
+    /** @deprecated prefer addEntry */
+    addQuery: (query: string) => void;
+    removeEntry: (query: string) => void;
+    clearAll: () => void;
+}
+/** React hook that subscribes to the tab-scoped search history store. */
+declare function useSearchHistory(): UseSearchHistoryResult;
+
+interface SpeechRecognitionErrorEventLike {
+    error: string;
+}
+interface UseVoiceSearchOptions {
+    lang?: string;
+    onResult: (transcript: string) => void;
+    onError?: (error: SpeechRecognitionErrorEventLike) => void;
+}
+interface UseVoiceSearchResult {
+    listening: boolean;
+    supported: boolean;
+    start: () => void;
+    stop: () => void;
+}
+declare function useVoiceSearch({ lang, onResult, onError, }: UseVoiceSearchOptions): UseVoiceSearchResult;
+
+/**
+ * Catalog-product normalisation helpers — Phase 0 lift-and-shift of the
+ * relevant portions of
+ * `header-mfe/src/components/search/auto-complete/autoComplete.helpers.js`.
+ *
+ * Only the data-processing helpers are included here. UI-specific helpers
+ * (keyboard event handlers, ARIA attribute computation, display-data
+ * extraction) live in `react-search-components` because they depend on DOM
+ * refs and component-level props.
+ *
+ * Key difference from the original:
+ *   `resolveSuggestionImageSrc` returns `""` when the source is absent
+ *   instead of falling back to a bundled PNG asset. Components apply their
+ *   own `<img onError>` / CSS placeholder; the SDK must not bundle assets.
+ */
+
+/** Returns `true` when `productStatus` is `"sellable"`. */
+declare function isSellableProductStatus(productStatus: unknown): boolean;
+/**
+ * Returns `true` when the suggestion option should not allow add-to-cart
+ * (out of stock, discontinued, inactive, etc.).
+ */
+declare function isCartActionDisabled(suggestionOption: Record<string, unknown> | null | undefined): boolean;
+/**
+ * Returns `true` when the suggestion row should be displayed as
+ * non-interactive (out-of-stock only — a subset of `isCartActionDisabled`).
+ */
+declare function isSuggestionDisabled(suggestionOption: Record<string, unknown> | null | undefined): boolean;
+/**
+ * Reads the first non-empty image URL from a Contentstack / catalog property
+ * bag. Returns `""` when no image is found.
+ */
+declare function getImageFromProperty(properties?: Record<string, unknown>): string;
+/**
+ * Normalises an image source value. Returns `""` when the source is absent or
+ * blank. Components are responsible for applying a fallback placeholder image.
+ */
+declare function resolveSuggestionImageSrc(imageSrc: unknown): string;
+/**
+ * Extracts a flat list of ingredient terms from a Contentstack ingredient
+ * structure. Used to populate `CatalogSuggestionItem.ingredientTerms`.
+ */
+declare function getIngredientTerms(rawIngredients: unknown): string[];
+/**
+ * Maps a raw Equinox catalog product object to the normalised
+ * `CatalogSuggestionItem` shape consumed by the UI components.
+ * Returns `null` for invalid input so callers can `.filter(Boolean)`.
+ */
+declare function mapCatalogProductToSuggestion(product: unknown, index?: number): CatalogSuggestionItem | null;
+/**
+ * Normalises the raw `didYouMean` / `did_you_mean` array from the Equinox
+ * API into a consistent shape consumed by `useSearchSuggestions`.
+ */
+declare function normalizeDidYouMean(didYouMean: unknown): DidYouMeanItem[];
+/**
+ * Returns the items that should actually be rendered in the suggestions list.
+ * When "Did You Mean?" results are present they take precedence over product
+ * suggestions (matching the original header-mfe behaviour).
+ */
+declare function getVisibleSuggestions(opts: {
+    didYouMean: DidYouMeanItem[];
+    suggestions: CatalogSuggestionItem[];
+}): DidYouMeanItem[] | CatalogSuggestionItem[];
+/**
+ * Builds the analytics payload emitted when the user clicks "See More Results".
+ */
+declare function getSeeMoreResultsPayload(query: string, totalResultsCount: number, suggestions: CatalogSuggestionItem[]): {
+    query: string;
+    source: string;
+    totalResultsCount: number;
+    visibleResultsCount: number;
+};
+
+/**
+ * Constants for the search SDK. Ported from
+ * `header-mfe/src/utils/search/search.constants.js` — only the values the
+ * SDK itself needs (Phase 0 lift-and-shift). CMS keys, GTM tracking config,
+ * and mobile-only placeholder rotation constants stay in header-mfe.
+ */
+/** API shopping-context segment used when resolving the Equinox gateway URL. */
+declare const STOREFRONT_SHOPPING_CONTEXT = "storefront";
+/** Catalog suggestions path appended when the market gateway is not already
+ *  under the storefront shopping context. */
+declare const CATALOG_SUGGESTIONS_PATH = "/storefront/catalogs/search/suggestions";
+/** Prefix for the `sessionStorage` key that persists recent searches.
+ *  Full key format: `${RECENT_SEARCHES_PREFIX}:{locale}:{COUNTRY}:{lang}`.
+ *  Must not change — existing sessions rely on this key. */
+declare const RECENT_SEARCHES_PREFIX = "nuskin:header:recentSearches";
+/** Maximum number of recent searches persisted per locale bucket. */
+declare const RECENT_SEARCHES_DEFAULT_LIMIT = 10;
+/** Equinox suggestion pagination — page is 1-indexed. */
+declare const DEFAULT_SUGGESTION_PAGE = 1;
+/** Number of suggestion rows requested from the Equinox catalog per call. */
+declare const DEFAULT_SUGGESTION_SIZE = 6;
+/** Segment used when building the fallback search-results URL. */
+declare const DEFAULT_SEARCH_PATH = "/search";
+/** Debounce for typeahead input → API dispatch. Preserved from header-mfe. */
+declare const DEBOUNCE_MS = 220;
+/** Cap on suggestions rendered in the dropdown, regardless of API response size. */
+declare const MAX_VISIBLE_SUGGESTIONS = 6;
+/** Fallback placeholder shown inside the expanded search input. */
+declare const SEARCH_PLACEHOLDER = "Search by product name, ingredient, benefits, or SKU";
+/** Fallback placeholder shown on the collapsed search trigger. */
+declare const TRIGGER_PLACEHOLDER = "Product Search";
+/**
+ * Full path segment for the AI commerce chat SSE endpoint.
+ * Appended to the consumer-provided `chatBaseUrl`.
+ * Source: https://admin.tst.nuskin.ai/api/analytics/v1/commerce/chat
+ */
+declare const DEFAULT_AI_CHAT_BASE_URL = "https://admin.tst.nuskin.ai/api/analytics/v1/chat";
+/** Default POST endpoint for creating an AI chat conversation. */
+declare const DEFAULT_AI_CHAT_CONVERSATIONS_URL = "https://admin.tst.nuskin.ai/api/analytics/v1/chat/conversations";
+/** Default POST endpoint for sending AI chat messages. */
+declare const DEFAULT_AI_CHAT_MESSAGES_URL = "https://admin.tst.nuskin.ai/api/analytics/v1/chat/messages";
+
+export { CATALOG_SUGGESTIONS_PATH, type CatalogSuggestionItem, type ChatMessageResult, type ChatProduct, type ChatService, type ChatServiceOptions, DEBOUNCE_MS, DEFAULT_AI_CHAT_BASE_URL, DEFAULT_AI_CHAT_CONVERSATIONS_URL, DEFAULT_AI_CHAT_MESSAGES_URL, DEFAULT_SEARCH_PATH, DEFAULT_SUGGESTION_PAGE, DEFAULT_SUGGESTION_SIZE, type DidYouMeanItem, type GetMarketConfig, type LocaleParts, type LocationLike, MAX_VISIBLE_SUGGESTIONS, type MarketConfig, type ProductType, RECENT_SEARCHES_DEFAULT_LIMIT, RECENT_SEARCHES_PREFIX, SEARCH_PLACEHOLDER, STOREFRONT_SHOPPING_CONTEXT, type SearchChromeCopy, type SearchHistoryEntry, type SearchHistoryState, type SearchHistoryEntry as SearchHistoryStoreEntry, type SearchService, type SearchServiceOptions, type SuggestionOption, type SuggestionsResponse, TRIGGER_PLACEHOLDER, type UseSearchHistoryResult, type UseSearchSuggestionsOptions, type UseSearchSuggestionsResult, type UseVoiceSearchOptions, type UseVoiceSearchResult, createChatService, createSearchService, getImageFromProperty, getIngredientTerms, getSeeMoreResultsPayload, getVisibleSuggestions, isCartActionDisabled, isSellableProductStatus, isSuggestionDisabled, mapCatalogProductToSuggestion, normalizeDidYouMean, resolveApiGatewayPath, resolveSuggestionImageSrc, useSearchHistory, useSearchHistoryStore, useSearchSuggestions, useVoiceSearch };