@askdialog/dialog-sdk 2.10.0 → 2.12.0

package/dist/types/searchController.d.ts

@@ -1,97 +1,74 @@
-import { SearchHit, SearchOptions, SearchRequest, SearchResponse, SearchResult } from "./search";
+import { SearchHit, SearchIndex, SearchOptions, SearchRequest, SearchResponse, SearchResult } from "./search";
 import { SearchSurface, SelectSearchResultParams, ViewSearchResultsParams } from "./searchAnalytics";
 export declare const SearchStatus: {
     readonly IDLE: "idle";
     readonly LOADING: "loading";
     readonly SUCCESS: "success";
-    /** The request succeeded with zero hits — distinct from `success` so views render a no-results state. */
+    /** Successful request with zero hits. */
     readonly EMPTY: "empty";
     readonly ERROR: "error";
 };
 export type SearchStatus = (typeof SearchStatus)[keyof typeof SearchStatus];
+export interface SearchSection {
+    index: Exclude<SearchIndex, "products">;
+    hitsPerPage?: number;
+}
 export interface SearchControllerState {
     status: SearchStatus;
-    /** Last committed (run) query — not the text currently being typed. */
+    /** Last submitted query, excluding pending input. */
     query: string;
-    /** Zero-indexed page of the last run. */
+    /** Zero-based page of the last request. */
     page: number;
-    /**
-     * Products entry of the last landed response; kept while the next page
-     * loads, cleared on error. Hits are flat records (`objectID`, `title`, …).
-     */
+    /** Last products result; retained while loading and cleared on error or reset. */
     response?: SearchResult;
+    sections?: Partial<Record<SearchIndex, SearchResult>>;
     error?: unknown;
 }
 export type SearchFunction = (request: SearchRequest, options?: SearchOptions) => Promise<SearchResponse>;
-/**
- * Analytics sinks for the DEC-2448 storefront-search contract — wire the two
- * track methods to the `Dialog` instance. Impressions (viewport batching,
- * dedup, click-forced) and the zero-items no-results event are owned by the
- * controller; integrations only declare where results are displayed.
- */
+/** Event callbacks; the controller handles impression batching and deduplication. */
 export interface SearchControllerAnalytics {
     surface: SearchSurface;
     trackViewSearchResults: (params: ViewSearchResultsParams) => void;
     trackSelectSearchResult: (params: SelectSearchResultParams) => void;
 }
 export interface SearchControllerOptions {
-    /** The bound `dialog.search` function. */
+    /** Search function bound to its client, or a custom transport. */
     search: SearchFunction;
+    /** Lowercase ISO 639-1 language code, e.g. `fr`. */
+    language: string;
+    /** ISO 4217 currency, independent of language. */
+    currency: string;
     analytics: SearchControllerAnalytics;
-    /**
-     * Platform navigation adapter, called by `selectResult` AFTER attribution
-     * is recorded, with the product URL of the selected hit. Omit it when the
-     * rendering layer navigates natively (plain `<a href>`): attribution still
-     * fires, the events are designed to survive navigation.
-     */
+    /** Navigate after recording selection. Omit to use native link navigation. */
     navigate?: (url: string, hit: SearchHit) => void;
     debounceMs?: number;
     hitsPerPage?: number;
-    locale: string;
+    sections?: readonly SearchSection[] | (() => readonly SearchSection[]);
 }
-/**
- * Framework-agnostic stateful search behavior around the stateless
- * `dialog.search()` transport: debounce, cancellation, stale-response
- * protection, pagination, retry and DEC-2448 attribution. Rendering and
- * routing stay in the integration (raw JavaScript, React, Vue, Shopify).
- */
+/** Manage search requests, pagination and analytics independently of rendering. */
 export interface SearchController {
-    /** Debounced entry point for keystrokes. */
+    /** Submit after the debounce delay. */
     setQuery(rawQuery: string): void;
-    /** Immediate (non-debounced) submission, e.g. Enter or a search button. */
+    /** Submit immediately. */
     submit(rawQuery: string): void;
-    /** Immediate pagination of the current results (zero-indexed). */
+    /** Request a zero-based page immediately. Pending input starts at page zero. */
     setPage(page: number): void;
-    /** Re-run the failed request; no-op unless the state is `error`. */
+    /** Retry the last request when the state is `error`. */
     retry(): void;
-    /**
-     * Watch the rendered element of `state.response.hits[index]` for a
-     * viewport impression. Call it for every result element after rendering.
-     */
+    /** Track impressions for the element representing `response.hits[index]`. */
     observeResult(element: Element, index: number): void;
     /**
-     * Record selection attribution for `state.response.hits[index]` (forced
-     * impression + select event), then — unless `options.navigate` is `false` —
-     * hand navigation to the `navigate` adapter. Call it on click AND
-     * middle-click/cmd+click.
-     *
-     * Pass `{ navigate: false }` for gestures the browser should handle natively
-     * (middle-click, or cmd/ctrl/shift/alt+click → new tab/window): attribution
-     * is still recorded, but the in-app adapter — which cannot open a new tab —
-     * is skipped so the native `<a href>` navigation runs.
-     *
-     * Returns `true` when the adapter handled the transition, so a rendering
-     * layer wrapping results in `<a href>` can `preventDefault()` and avoid a
-     * second (native) navigation. Returns `false` otherwise (adapter skipped, no
-     * adapter, or the hit has no URL) — let the native navigation proceed.
+     * Record the impression and selection for `response.hits[index]`.
+     * Pass `{ navigate: false }` for middle-clicks or modified clicks.
+     * Returns true if the navigation adapter ran; call `preventDefault()` then.
      */
     selectResult(index: number, options?: {
         navigate?: boolean;
     }): boolean;
-    /** Register a state listener; returns its unsubscribe function. */
+    /** Subscribe to state changes; returns an unsubscribe function. */
     subscribe(listener: (state: SearchControllerState) => void): () => void;
     getState(): SearchControllerState;
-    /** Cancel everything in flight and detach listeners/observers. */
+    /** Cancel pending requests and remove listeners and observers. */
     dispose(): void;
 }
 //# sourceMappingURL=searchController.d.ts.map

package/dist/types/searchController.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"searchController.d.ts","sourceRoot":"","sources":["../../src/types/searchController.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,aAAa,EACb,aAAa,EACb,cAAc,EACd,YAAY,EACb,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,aAAa,EACb,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,mBAAmB,CAAC;AAE3B,eAAO,MAAM,YAAY;;;;IAIvB,yGAAyG;;;CAGjG,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;AAE5E,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,YAAY,CAAC;IACrB,uEAAuE;IACvE,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,MAAM,cAAc,GAAG,CAC3B,OAAO,EAAE,aAAa,EACtB,OAAO,CAAC,EAAE,aAAa,KACpB,OAAO,CAAC,cAAc,CAAC,CAAC;AAE7B;;;;;GAKG;AACH,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,aAAa,CAAC;IACvB,sBAAsB,EAAE,CAAC,MAAM,EAAE,uBAAuB,KAAK,IAAI,CAAC;IAClE,uBAAuB,EAAE,CAAC,MAAM,EAAE,wBAAwB,KAAK,IAAI,CAAC;CACrE;AAED,MAAM,WAAW,uBAAuB;IACtC,0CAA0C;IAC1C,MAAM,EAAE,cAAc,CAAC;IACvB,SAAS,EAAE,yBAAyB,CAAC;IACrC;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,KAAK,IAAI,CAAC;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,2EAA2E;IAC3E,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,kEAAkE;IAClE,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,oEAAoE;IACpE,KAAK,IAAI,IAAI,CAAC;IACd;;;OAGG;IACH,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrD;;;;;;;;;;;;;;;OAeG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC;IACvE,mEAAmE;IACnE,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACxE,QAAQ,IAAI,qBAAqB,CAAC;IAClC,kEAAkE;IAClE,OAAO,IAAI,IAAI,CAAC;CACjB"}
+{"version":3,"file":"searchController.d.ts","sourceRoot":"","sources":["../../src/types/searchController.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,SAAS,EACT,WAAW,EACX,aAAa,EACb,aAAa,EACb,cAAc,EACd,YAAY,EACb,MAAM,UAAU,CAAC;AAClB,OAAO,EACL,aAAa,EACb,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,mBAAmB,CAAC;AAE3B,eAAO,MAAM,YAAY;;;;IAIvB,yCAAyC;;;CAGjC,CAAC;AAEX,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC;AAE5E,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,OAAO,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,YAAY,CAAC;IACrB,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,kFAAkF;IAClF,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC,CAAC;IACtD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,MAAM,cAAc,GAAG,CAC3B,OAAO,EAAE,aAAa,EACtB,OAAO,CAAC,EAAE,aAAa,KACpB,OAAO,CAAC,cAAc,CAAC,CAAC;AAE7B,qFAAqF;AACrF,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,aAAa,CAAC;IACvB,sBAAsB,EAAE,CAAC,MAAM,EAAE,uBAAuB,KAAK,IAAI,CAAC;IAClE,uBAAuB,EAAE,CAAC,MAAM,EAAE,wBAAwB,KAAK,IAAI,CAAC;CACrE;AAED,MAAM,WAAW,uBAAuB;IACtC,kEAAkE;IAClE,MAAM,EAAE,cAAc,CAAC;IACvB,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,yBAAyB,CAAC;IACrC,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,KAAK,IAAI,CAAC;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,SAAS,aAAa,EAAE,GAAG,CAAC,MAAM,SAAS,aAAa,EAAE,CAAC,CAAC;CACxE;AAED,mFAAmF;AACnF,MAAM,WAAW,gBAAgB;IAC/B,uCAAuC;IACvC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,0BAA0B;IAC1B,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,gFAAgF;IAChF,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,wDAAwD;IACxD,KAAK,IAAI,IAAI,CAAC;IACd,6EAA6E;IAC7E,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrD;;;;OAIG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC;IACvE,mEAAmE;IACnE,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,qBAAqB,KAAK,IAAI,GAAG,MAAM,IAAI,CAAC;IACxE,QAAQ,IAAI,qBAAqB,CAAC;IAClC,kEAAkE;IAClE,OAAO,IAAI,IAAI,CAAC;CACjB"}

package/dist/types/searchController.js

@@ -2,7 +2,7 @@ export const SearchStatus = {
     IDLE: "idle",
     LOADING: "loading",
     SUCCESS: "success",
-    /** The request succeeded with zero hits — distinct from `success` so views render a no-results state. */
+    /** Successful request with zero hits. */
     EMPTY: "empty",
     ERROR: "error",
 };

package/dist/utils/localization.d.ts

@@ -23,5 +23,4 @@ export declare const resolveTextDirection: (code?: string) => TextDirection;
  * therefore keeps a generic language name ("French", not "French (France)").
  */
 export declare const getDetailedLocaleInfo: (locale: string, countryCodeOverride?: string) => DetailedLocaleInfo | null;
-export declare const toIso639LanguageCode: (locale: string) => string;
 //# sourceMappingURL=localization.d.ts.map

package/dist/utils/localization.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"localization.d.ts","sourceRoot":"","sources":["../../src/utils/localization.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,kBAAkB,GAC7B,aAAa,MAAM,GAAG,SAAS,KAC9B,WAAW,IAAI,MAC8C,CAAC;AAEjE,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,KAAK,CAAC;AAQ1C,eAAO,MAAM,iBAAiB,GAAI,OAAO,MAAM,KAAG,OAEa,CAAC;AAEhE,eAAO,MAAM,oBAAoB,GAAI,OAAO,MAAM,KAAG,aACZ,CAAC;AAE1C;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,qBAAqB,GAChC,QAAQ,MAAM,EACd,sBAAsB,MAAM,KAC3B,kBAAkB,GAAG,IAoCvB,CAAC;AAKF,eAAO,MAAM,oBAAoB,GAAI,QAAQ,MAAM,KAAG,MAMrD,CAAC"}
+{"version":3,"file":"localization.d.ts","sourceRoot":"","sources":["../../src/utils/localization.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,kBAAkB,GAC7B,aAAa,MAAM,GAAG,SAAS,KAC9B,WAAW,IAAI,MAC8C,CAAC;AAEjE,MAAM,MAAM,aAAa,GAAG,KAAK,GAAG,KAAK,CAAC;AAQ1C,eAAO,MAAM,iBAAiB,GAAI,OAAO,MAAM,KAAG,OAEa,CAAC;AAEhE,eAAO,MAAM,oBAAoB,GAAI,OAAO,MAAM,KAAG,aACZ,CAAC;AAE1C;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,qBAAqB,GAChC,QAAQ,MAAM,EACd,sBAAsB,MAAM,KAC3B,kBAAkB,GAAG,IAoCvB,CAAC"}

package/dist/utils/localization.js

@@ -52,14 +52,3 @@ export const getDetailedLocaleInfo = (locale, countryCodeOverride) => {
         return null;
     }
 };
-// The search backend keys its indexes on the bare ISO 639-1 language, while
-// storefronts usually hold full BCP-47 tags ("fr-FR", "pt-BR"). An unparsable
-// value is returned as-is so a search is never dropped over its locale.
-export const toIso639LanguageCode = (locale) => {
-    try {
-        return new Intl.Locale(locale).language;
-    }
-    catch {
-        return locale;
-    }
-};

package/dist/utils/searchControllerAnalytics.d.ts

@@ -1,9 +1,6 @@
 import { SearchResult } from "../types/search";
 import { SearchControllerAnalytics } from "../types/searchController";
-/**
- * Internal DEC-2448 wiring of the search controller: envelope computation,
- * viewport impressions and selection attribution. Not part of the public API.
- */
+/** Internal binding for search impressions and selections. */
 export interface ControllerAnalyticsBinding {
     onResponse(result: SearchResult): void;
     observeResult(element: Element, result: SearchResult, index: number): void;

package/dist/utils/searchControllerAnalytics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"searchControllerAnalytics.d.ts","sourceRoot":"","sources":["../../src/utils/searchControllerAnalytics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAK/C,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAMtE;;;GAGG;AACH,MAAM,WAAW,0BAA0B;IACzC,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IACvC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3E,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAClD,OAAO,IAAI,IAAI,CAAC;CACjB;AAQD,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,yBAAyB,GACnC,0BAA0B,CAkD5B"}
+{"version":3,"file":"searchControllerAnalytics.d.ts","sourceRoot":"","sources":["../../src/utils/searchControllerAnalytics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAK/C,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAMtE,8DAA8D;AAC9D,MAAM,WAAW,0BAA0B;IACzC,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAAC;IACvC,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3E,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAClD,OAAO,IAAI,IAAI,CAAC;CACjB;AAQD,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,yBAAyB,GACnC,0BAA0B,CAgD5B"}

package/dist/utils/searchControllerAnalytics.js

@@ -1,14 +1,13 @@
 import { createSearchImpressionTracker, } from "./searchImpressions";
 const resultItem = (result, index) => ({
     product_id: result.hits[index].objectID,
-    // 1-based and absolute across pages (page 2, first item, 20/page → 21).
+    // One-based position across all pages.
     position: result.page * result.hitsPerPage + index + 1,
 });
 export function createControllerAnalytics(analytics) {
     let impressions;
     let envelope;
-    // Lazy: the tracker needs window/IntersectionObserver, so a controller
-    // constructed in a non-browser context stays inert until a response lands.
+    // Defer browser-dependent tracking until a response arrives.
     const tracker = () => {
         impressions ??= createSearchImpressionTracker({
             emit: analytics.trackViewSearchResults,
@@ -21,17 +20,15 @@ export function createControllerAnalytics(analytics) {
                 query_id: result.queryID,
                 index: result.index,
                 surface: analytics.surface,
-                // The storefront search API is lexical-only today.
                 search_type: "lexical",
-                // Analytics pages are 1-based; the wire response is 0-based.
+                // Convert the API page to one-based analytics numbering.
                 page: result.page + 1,
                 total_hits: result.nbHits,
                 query_length: [...result.query].length,
             };
             tracker().setContext(envelope);
             if (result.nbHits === 0) {
-                // A rendered no-results state is the view event with zero items; it
-                // shows above the fold, no viewport gating needed.
+                // Empty results emit immediately without visibility tracking.
                 analytics.trackViewSearchResults({ ...envelope, items: [] });
             }
         },
@@ -43,7 +40,7 @@ export function createControllerAnalytics(analytics) {
                 return;
             }
             const item = resultItem(result, index);
-            // The click forces the item's impression so CTR by position stays ≤100%.
+            // Count the impression before recording the selection.
             tracker().forceImpression(item);
             analytics.trackSelectSearchResult({ ...envelope, items: [item] });
         },

package/dist/utils/searchImpressions.d.ts

@@ -1,6 +1,6 @@
 import { SearchAnalyticsEnvelope, SearchResultItem, ViewSearchResultsParams } from "../types/searchAnalytics";
 export interface SearchImpressionTrackerOptions {
-    /** Receives each flushed batch — wire it to `dialog.trackViewSearchResults`. */
+    /** Receive each batch, typically through `dialog.trackViewSearchResults`. */
     emit: (params: ViewSearchResultsParams) => void;
     visibilityThreshold?: number;
     dwellMs?: number;
@@ -8,11 +8,11 @@ export interface SearchImpressionTrackerOptions {
     maxItemsPerEvent?: number;
 }
 export interface SearchImpressionTracker {
-    /** Declare the envelope of the response being rendered; flushes the previous batch. */
+    /** Flush the previous batch and start tracking the new response. */
     setContext(envelope: SearchAnalyticsEnvelope): void;
-    /** Watch a rendered result element for viewport impressions. */
+    /** Track viewport impressions for a result element. */
     observe(element: Element, item: SearchResultItem): void;
-    /** A click counts as an impression, otherwise CTR by position can exceed 100%. */
+    /** Record and flush an impression without waiting for visibility. */
     forceImpression(item: SearchResultItem): void;
     flush(): void;
     disconnect(): void;

package/dist/utils/searchImpressions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"searchImpressions.d.ts","sourceRoot":"","sources":["../../src/utils/searchImpressions.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,uBAAuB,EACxB,MAAM,0BAA0B,CAAC;AAWlC,MAAM,WAAW,8BAA8B;IAC7C,gFAAgF;IAChF,IAAI,EAAE,CAAC,MAAM,EAAE,uBAAuB,KAAK,IAAI,CAAC;IAChD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,uBAAuB;IACtC,uFAAuF;IACvF,UAAU,CAAC,QAAQ,EAAE,uBAAuB,GAAG,IAAI,CAAC;IACpD,gEAAgE;IAChE,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACxD,kFAAkF;IAClF,eAAe,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC9C,KAAK,IAAI,IAAI,CAAC;IACd,UAAU,IAAI,IAAI,CAAC;CACpB;AAED,wBAAgB,6BAA6B,CAAC,EAC5C,IAAI,EACJ,mBAAkD,EAClD,OAA0B,EAC1B,WAAmC,EACnC,gBAA8C,GAC/C,EAAE,8BAA8B,GAAG,uBAAuB,CA+H1D"}
+{"version":3,"file":"searchImpressions.d.ts","sourceRoot":"","sources":["../../src/utils/searchImpressions.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,uBAAuB,EACxB,MAAM,0BAA0B,CAAC;AAQlC,MAAM,WAAW,8BAA8B;IAC7C,6EAA6E;IAC7E,IAAI,EAAE,CAAC,MAAM,EAAE,uBAAuB,KAAK,IAAI,CAAC;IAChD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,uBAAuB;IACtC,oEAAoE;IACpE,UAAU,CAAC,QAAQ,EAAE,uBAAuB,GAAG,IAAI,CAAC;IACpD,uDAAuD;IACvD,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACxD,qEAAqE;IACrE,eAAe,CAAC,IAAI,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC9C,KAAK,IAAI,IAAI,CAAC;IACd,UAAU,IAAI,IAAI,CAAC;CACpB;AAED,wBAAgB,6BAA6B,CAAC,EAC5C,IAAI,EACJ,mBAAkD,EAClD,OAA0B,EAC1B,WAAmC,EACnC,gBAA8C,GAC/C,EAAE,8BAA8B,GAAG,uBAAuB,CA2H1D"}

package/dist/utils/searchImpressions.js

@@ -1,7 +1,4 @@
-// An item counts as seen after being ≥50% visible for ≥500ms; qualified items
-// are batched and flushed on qualification inactivity, context change,
-// pagehide or the batch cap — in practice 1-3 events per search, not one per
-// item.
+// Defaults: 50% visibility for 500ms. Flush on idle, context change, pagehide or batch limit.
 const DEFAULT_VISIBILITY_THRESHOLD = 0.5;
 const DEFAULT_DWELL_MS = 500;
 const DEFAULT_IDLE_FLUSH_MS = 1500;
@@ -72,15 +69,11 @@ export function createSearchImpressionTracker({ emit, visibilityThreshold = DEFA
         dwellTimers.clear();
         observedItems.clear();
     };
-    // The page can die mid-batch: ship what already qualified. The host bridge
-    // captures this last event with a beacon-capable transport.
+    // Flush qualified impressions before leaving the page.
     const handlePagehide = () => {
         flush();
     };
-    // A back/forward-cache restore is a new exposure: re-qualify what is on
-    // screen instead of keeping it deduplicated forever. Dwell timers frozen
-    // mid-count resume with their remaining delay, so cancel them — the
-    // restored exposure must earn its full dwell.
+    // After a back/forward-cache restore, reset deduplication and restart dwell timers.
     const handlePageshow = (event) => {
         if (!event.persisted) {
             return;
@@ -96,7 +89,7 @@ export function createSearchImpressionTracker({ emit, visibilityThreshold = DEFA
     window.addEventListener("pageshow", handlePageshow);
     return {
         setContext(nextEnvelope) {
-            // Pending impressions belong to the envelope they qualified under.
+            // Flush under the previous context before replacing it.
             flush();
             seen.clear();
             envelope = nextEnvelope;

package/dist/utils/searchRequests.d.ts

@@ -0,0 +1,17 @@
+import { SearchIndex, SearchRequest, SearchResponse, SearchResult } from "../types/search";
+import { SearchSection } from "../types/searchController";
+export declare const normalizeQuery: (rawQuery: string) => string | undefined;
+interface SearchRequestConfig {
+    indexName: string;
+    language: string;
+    currency: string;
+    hitsPerPage: number;
+}
+interface SearchResults {
+    response: SearchResult;
+    sections: Partial<Record<SearchIndex, SearchResult>> | undefined;
+}
+export declare const buildSearchRequest: (query: string, page: number, sections: readonly SearchSection[], { indexName, language, currency, hitsPerPage }: SearchRequestConfig) => SearchRequest;
+export declare const readSearchResults: (result: SearchResponse, requested: readonly SearchSection[], { indexName, language, currency }: SearchRequestConfig) => SearchResults;
+export {};
+//# sourceMappingURL=searchRequests.d.ts.map

package/dist/utils/searchRequests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"searchRequests.d.ts","sourceRoot":"","sources":["../../src/utils/searchRequests.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,EACX,aAAa,EACb,cAAc,EACd,YAAY,EACb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAK1D,eAAO,MAAM,cAAc,GAAI,UAAU,MAAM,KAAG,MAAM,GAAG,SAI1D,CAAC;AAEF,UAAU,mBAAmB;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,UAAU,aAAa;IACrB,QAAQ,EAAE,YAAY,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,YAAY,CAAC,CAAC,GAAG,SAAS,CAAC;CAClE;AAED,eAAO,MAAM,kBAAkB,GAC7B,OAAO,MAAM,EACb,MAAM,MAAM,EACZ,UAAU,SAAS,aAAa,EAAE,EAClC,gDAAgD,mBAAmB,KAClE,aAUD,CAAC;AAEH,eAAO,MAAM,iBAAiB,GAC5B,QAAQ,cAAc,EACtB,WAAW,SAAS,aAAa,EAAE,EACnC,mCAAmC,mBAAmB,KACrD,aAwBF,CAAC"}

package/dist/utils/searchRequests.js

@@ -0,0 +1,36 @@
+import { searchIndexName } from "../services/search";
+// Match the API minimum query length.
+const MIN_QUERY_CODE_POINTS = 2;
+export const normalizeQuery = (rawQuery) => {
+    const query = rawQuery.trim();
+    return [...query].length >= MIN_QUERY_CODE_POINTS ? query : undefined;
+};
+export const buildSearchRequest = (query, page, sections, { indexName, language, currency, hitsPerPage }) => ({
+    requests: [
+        { indexName, query, page, hitsPerPage },
+        ...sections.map((section) => ({
+            indexName: searchIndexName(section.index, language, currency),
+            query,
+            page: 0,
+            hitsPerPage: section.hitsPerPage ?? hitsPerPage,
+        })),
+    ],
+});
+export const readSearchResults = (result, requested, { indexName, language, currency }) => {
+    const response = result.results.find((entry) => entry.index === indexName);
+    if (response === undefined) {
+        throw new Error(`Dialog search returned no ${indexName} entry`);
+    }
+    const sections = {};
+    for (const section of requested) {
+        const requestedIndexName = searchIndexName(section.index, language, currency);
+        const entry = result.results.find((candidate) => candidate.index === requestedIndexName);
+        if (entry !== undefined) {
+            sections[section.index] = entry;
+        }
+    }
+    return {
+        response,
+        sections: requested.length === 0 ? undefined : sections,
+    };
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@askdialog/dialog-sdk",
-  "version": "2.10.0",
+  "version": "2.12.0",
   "private": false,
   "description": "Dialog SDK",
   "main": "dist/index.js",