@askdialog/dialog-sdk 2.9.0 → 2.10.0

package/dist/__tests__/searchControllerAttribution.spec.js

@@ -12,22 +12,23 @@ vi.mock("../utils/searchImpressions", () => ({
     createSearchImpressionTracker: () => tracker,
 }));
 const response = (overrides = {}) => ({
-    queryId: "qid-1",
-    hits: [
+    results: [
         {
-            id: "h1",
-            score: 1,
-            product: { id: "p1", url: "https://shop.example/p1" },
+            index: "products_fr",
+            hits: [
+                { objectID: "p1", url: "https://shop.example/p1" },
+                { objectID: "p2" },
+            ],
+            nbHits: 30,
+            page: 0,
+            nbPages: 3,
+            hitsPerPage: 12,
+            processingTimeMS: 5,
+            query: "shoes",
+            queryID: "qid-1",
+            ...overrides,
         },
-        { id: "h2", score: 0.9, product: { id: "p2" } },
     ],
-    nbHits: 30,
-    page: 0,
-    nbPages: 3,
-    hitsPerPage: 12,
-    processingTimeMs: 5,
-    query: "shoes",
-    ...overrides,
 });
 const search = vi.fn();
 const trackViewSearchResults = vi.fn();
@@ -41,6 +42,7 @@ const createController = () => createSearchController({
         trackSelectSearchResult,
     },
     navigate,
+    locale: "fr",
 });
 beforeEach(() => {
     vi.useFakeTimers();
@@ -54,27 +56,26 @@ const settle = async () => {
     await Promise.resolve();
 };
 describe("search controller attribution", () => {
-    it("omits queryId for a new query and resends it while the query is unchanged", async () => {
+    it("never resends a query id: each request is its own query", async () => {
         const controller = createController();
         search.mockResolvedValue(response());
         controller.submit("shoes");
         await settle();
         controller.setPage(1);
         await settle();
-        expect(search.mock.calls[0][0].queryId).toBeUndefined();
-        expect(search.mock.calls[1][0]).toMatchObject({
-            query: "shoes",
-            page: 1,
-            queryId: "qid-1",
-        });
+        for (const [request] of search.mock.calls) {
+            expect(request.requests[0]).not.toHaveProperty("queryId");
+            expect(request.requests[0]).not.toHaveProperty("queryID");
+        }
     });
-    it("declares the rendered response's envelope to the impression tracker", async () => {
+    it("declares the rendered result's envelope to the impression tracker", async () => {
         const controller = createController();
         search.mockResolvedValue(response({ page: 1, query: "shoes" }));
         controller.submit("shoes");
         await settle();
         expect(tracker.setContext).toHaveBeenCalledWith({
             query_id: "qid-1",
+            index: "products_fr",
             surface: "search_page",
             search_type: "lexical",
             page: 2,
@@ -82,12 +83,12 @@ describe("search controller attribution", () => {
             query_length: 5,
         });
     });
-    it("keeps query_id stable across pagination and rotates it on a new query", async () => {
+    it("follows the response's queryID: every page is its own query", async () => {
         const controller = createController();
         search
             .mockResolvedValueOnce(response())
-            .mockResolvedValueOnce(response({ page: 1, queryId: "qid-1" }))
-            .mockResolvedValueOnce(response({ query: "boots", queryId: "qid-2" }));
+            .mockResolvedValueOnce(response({ page: 1, queryID: "qid-2" }))
+            .mockResolvedValueOnce(response({ query: "boots", queryID: "qid-3" }));
         controller.submit("shoes");
         await settle();
         controller.setPage(1);
@@ -95,7 +96,7 @@ describe("search controller attribution", () => {
         controller.submit("boots");
         await settle();
         const queryIds = tracker.setContext.mock.calls.map(([envelope]) => envelope.query_id);
-        expect(queryIds).toEqual(["qid-1", "qid-1", "qid-2"]);
+        expect(queryIds).toEqual(["qid-1", "qid-2", "qid-3"]);
     });
     it("emits the zero-items view event for a rendered no-results state", async () => {
         const controller = createController();
@@ -104,6 +105,7 @@ describe("search controller attribution", () => {
         await settle();
         expect(trackViewSearchResults).toHaveBeenCalledWith({
             query_id: "qid-1",
+            index: "products_fr",
             surface: "search_page",
             search_type: "lexical",
             page: 1,
@@ -149,6 +151,7 @@ describe("search controller attribution", () => {
         });
         expect(trackSelectSearchResult).toHaveBeenCalledWith({
             query_id: "qid-1",
+            index: "products_fr",
             surface: "search_page",
             search_type: "lexical",
             page: 1,
@@ -156,7 +159,7 @@ describe("search controller attribution", () => {
             query_length: 5,
             items: [{ product_id: "p1", position: 1 }],
         });
-        expect(navigate).toHaveBeenCalledWith("https://shop.example/p1", landed.hits[0]);
+        expect(navigate).toHaveBeenCalledWith("https://shop.example/p1", landed.results[0].hits[0]);
         expect(order).toEqual(["impression", "select", "navigate"]);
     });
     it("still records attribution when the hit has no URL to navigate to", async () => {
@@ -203,6 +206,7 @@ describe("search controller attribution", () => {
                 trackViewSearchResults,
                 trackSelectSearchResult,
             },
+            locale: "fr",
         });
         search.mockResolvedValue(response());
         controller.submit("shoes");

package/dist/__tests__/searchImpressions.spec.js

@@ -3,6 +3,7 @@ import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { createSearchImpressionTracker } from "../utils/searchImpressions";
 const envelope = {
     query_id: "query-1",
+    index: "products_fr",
     surface: "search_page",
     search_type: "lexical",
     page: 1,
@@ -133,7 +134,7 @@ describe("createSearchImpressionTracker", () => {
         tracker.forceImpression({ product_id: "product-1", position: 1 });
         expect(emit).toHaveBeenCalledTimes(1);
     });
-    it("keeps deduplication across pagination of the same query", () => {
+    it("restarts deduplication on every context change: each response mints a fresh query_id", () => {
         const emit = vi.fn();
         const tracker = createSearchImpressionTracker({ emit });
         tracker.setContext(envelope);
@@ -141,29 +142,11 @@ describe("createSearchImpressionTracker", () => {
         tracker.observe(card, { product_id: "product-1", position: 1 });
         intersect(card, 0.6);
         vi.advanceTimersByTime(2000);
-        tracker.setContext({ ...envelope, page: 2 });
+        tracker.setContext({ ...envelope, query_id: "query-2", page: 2 });
         const cardOnPage2 = element();
         tracker.observe(cardOnPage2, { product_id: "product-1", position: 1 });
         intersect(cardOnPage2, 0.6);
         vi.advanceTimersByTime(2000);
-        expect(emit).toHaveBeenCalledTimes(1);
-    });
-    it("drops a previous query's dedup keys when the query changes", () => {
-        const emit = vi.fn();
-        const tracker = createSearchImpressionTracker({ emit });
-        tracker.setContext(envelope);
-        const card = element();
-        tracker.observe(card, { product_id: "product-1", position: 1 });
-        intersect(card, 0.6);
-        vi.advanceTimersByTime(2000);
-        tracker.setContext({ ...envelope, query_id: "query-2" });
-        // Same query_id served again (e.g. a cached response): a fresh render is
-        // a new exposure, like the bfcache restore.
-        tracker.setContext(envelope);
-        const cardAgain = element();
-        tracker.observe(cardAgain, { product_id: "product-1", position: 1 });
-        intersect(cardAgain, 0.6);
-        vi.advanceTimersByTime(2000);
         expect(emit).toHaveBeenCalledTimes(2);
     });
     it("flushes qualified impressions on pagehide", () => {

package/dist/__tests__/searchService.spec.js

@@ -1,16 +1,31 @@
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { DialogSearchError } from "../DialogSearchError";
-import { searchProducts } from "../services/search";
+import { searchIndexName, searchLexical } from "../services/search";
 const API_KEY = "pk_test_abcdef";
+const request = {
+    requests: [
+        {
+            indexName: "products_fr",
+            query: "running shoes",
+            page: 2,
+            hitsPerPage: 50,
+        },
+    ],
+};
 const emptyResponse = {
-    queryId: "0198c3f2-0000-7000-8000-000000000000",
-    hits: [],
-    nbHits: 0,
-    page: 0,
-    nbPages: 0,
-    hitsPerPage: 20,
-    processingTimeMs: 3,
-    query: "running shoes",
+    results: [
+        {
+            index: "products_fr",
+            hits: [],
+            nbHits: 0,
+            page: 0,
+            nbPages: 0,
+            hitsPerPage: 20,
+            processingTimeMS: 3,
+            query: "running shoes",
+            queryID: "0198c3f2-0000-7000-8000-000000000000",
+        },
+    ],
 };
 const jsonResponse = (body, status = 200) => new Response(JSON.stringify(body), {
     status,
@@ -24,72 +39,76 @@ afterEach(() => {
     vi.unstubAllGlobals();
     vi.clearAllMocks();
 });
-describe("searchProducts", () => {
-    it("POSTs the exact request to /public/search with only the api key header", async () => {
+describe("searchIndexName", () => {
+    it.each([
+        ["fr-FR", "products_fr"],
+        ["pt-BR", "products_pt"],
+        ["fr", "products_fr"],
+        ["not a locale", "products_not a locale"],
+    ])("reduces the locale %s to a bare-language index name", (locale, name) => {
+        expect(searchIndexName("products", locale)).toBe(name);
+    });
+    it("names every logical index", () => {
+        expect(searchIndexName("collections", "en-US")).toBe("collections_en");
+    });
+});
+describe("searchLexical", () => {
+    it("POSTs the exact request to /public/search/lexical with only the api key header", async () => {
         fetchMock.mockResolvedValue(jsonResponse(emptyResponse));
-        await searchProducts(API_KEY, {
-            query: "running shoes",
-            page: 2,
-            hitsPerPage: 50,
-            queryId: "0198c3f2-0000-7000-8000-000000000000",
-        });
+        await searchLexical(API_KEY, request);
         expect(fetchMock).toHaveBeenCalledTimes(1);
         const [url, init] = fetchMock.mock.calls[0];
-        expect(url).toMatch(/\/public\/search$/);
+        expect(url).toMatch(/\/public\/search\/lexical$/);
         expect(init.method).toBe("POST");
         expect(init.headers).toEqual({
             "Content-Type": "application/json",
             "x-dialog-api-key": API_KEY,
         });
-        expect(JSON.parse(init.body)).toEqual({
-            query: "running shoes",
-            page: 2,
-            hitsPerPage: 50,
-            queryId: "0198c3f2-0000-7000-8000-000000000000",
-        });
+        expect(JSON.parse(init.body)).toEqual(request);
     });
-    it("omits pagination fields and queryId the caller did not provide", async () => {
+    it("keeps optional per-entry fields the caller did not provide off the wire", async () => {
         fetchMock.mockResolvedValue(jsonResponse(emptyResponse));
-        await searchProducts(API_KEY, { query: "running shoes" });
+        await searchLexical(API_KEY, {
+            requests: [{ indexName: "products_fr", query: "running shoes" }],
+        });
         const [, init] = fetchMock.mock.calls[0];
         expect(JSON.parse(init.body)).toEqual({
-            query: "running shoes",
+            requests: [{ indexName: "products_fr", query: "running shoes" }],
         });
     });
     it("resolves the typed response, including empty results", async () => {
         fetchMock.mockResolvedValue(jsonResponse(emptyResponse));
-        await expect(searchProducts(API_KEY, { query: "running shoes" })).resolves.toEqual(emptyResponse);
+        await expect(searchLexical(API_KEY, request)).resolves.toEqual(emptyResponse);
     });
     it.each([
-        [401, "INVALID_WIDGET_API_KEY", "Invalid widget API key"],
-        [
-            422,
-            "VALIDATION_ERROR",
-            "query must contain at least 2 visible characters",
-        ],
-        [429, "THROTTLED", "Too many requests"],
-        [503, "STOREFRONT_SEARCH_UNAVAILABLE", "Storefront search is unavailable"],
-    ])("rejects a %i answer with a DialogSearchError carrying status, code and message", async (status, code, message) => {
-        fetchMock.mockResolvedValue(jsonResponse({ statusCode: status, error: code, message }, status));
-        const error = await searchProducts(API_KEY, {
-            query: "running shoes",
-        }).catch((caught) => caught);
+        [404, "Index products_xx does not exist"],
+        [400, "Unknown parameter: foo"],
+    ])("rejects the Algolia-shaped %i error body with a DialogSearchError", async (status, message) => {
+        fetchMock.mockResolvedValue(jsonResponse({ message, status }, status));
+        const error = await searchLexical(API_KEY, request).catch((caught) => caught);
         expect(error).toBeInstanceOf(DialogSearchError);
         expect(error).toMatchObject({
             name: "DialogSearchError",
             status,
-            code,
+            code: undefined,
             message,
         });
     });
+    it.each([
+        [401, "INVALID_WIDGET_API_KEY", "Invalid widget API key"],
+        [429, "THROTTLED", "Too many requests"],
+    ])("still reads the code of a Nest-shaped %i guard error", async (status, code, message) => {
+        fetchMock.mockResolvedValue(jsonResponse({ statusCode: status, error: code, message }, status));
+        const error = await searchLexical(API_KEY, request).catch((caught) => caught);
+        expect(error).toBeInstanceOf(DialogSearchError);
+        expect(error).toMatchObject({ status, code, message });
+    });
     it("falls back to statusText when the error body is not JSON", async () => {
         fetchMock.mockResolvedValue(new Response("<html>Bad Gateway</html>", {
             status: 502,
             statusText: "Bad Gateway",
         }));
-        const error = await searchProducts(API_KEY, {
-            query: "running shoes",
-        }).catch((caught) => caught);
+        const error = await searchLexical(API_KEY, request).catch((caught) => caught);
         expect(error).toBeInstanceOf(DialogSearchError);
         expect(error).toMatchObject({
             status: 502,
@@ -100,13 +119,13 @@ describe("searchProducts", () => {
     it("propagates network failures untouched", async () => {
         const networkError = new TypeError("Failed to fetch");
         fetchMock.mockRejectedValue(networkError);
-        await expect(searchProducts(API_KEY, { query: "running shoes" })).rejects.toBe(networkError);
+        await expect(searchLexical(API_KEY, request)).rejects.toBe(networkError);
     });
     it("forwards the AbortSignal and preserves the native AbortError", async () => {
         const abortError = new DOMException("The operation was aborted.", "AbortError");
         fetchMock.mockRejectedValue(abortError);
         const controller = new AbortController();
-        await expect(searchProducts(API_KEY, { query: "running shoes" }, { signal: controller.signal })).rejects.toBe(abortError);
+        await expect(searchLexical(API_KEY, request, { signal: controller.signal })).rejects.toBe(abortError);
         const [, init] = fetchMock.mock.calls[0];
         expect(init.signal).toBe(controller.signal);
     });

package/dist/config/config.development.js

@@ -1,6 +1,6 @@
 export const config = {
     baseApiUrl: "https://hr5buzenb1.execute-api.eu-west-1.amazonaws.com",
-    // Nest monolith (staging) — serves POST /public/search.
+    // Nest monolith (staging) — serves POST /public/search/lexical.
     monolithApiUrl: "https://fvcphlqyle.execute-api.eu-west-1.amazonaws.com",
     assistantUrl: "https://d2bycosa71tnxv.cloudfront.net/assets/index.js",
 };

package/dist/config/config.production.js

@@ -1,6 +1,6 @@
 export const config = {
     baseApiUrl: "https://rtbzcxkmwj.execute-api.eu-west-1.amazonaws.com",
-    // Nest monolith (production) — serves POST /public/search. Custom domain,
+    // Nest monolith (production) — serves POST /public/search/lexical. Custom domain,
     // same as the dashboard's VITE_MONOLITH_API_URL: the raw execute-api
     // gateway URL answers 500 on every route and must not be used.
     monolithApiUrl: "https://api.askdialog.ai",

package/dist/config/index.js

@@ -1,6 +1,6 @@
 export const config = {
     baseApiUrl: "https://rtbzcxkmwj.execute-api.eu-west-1.amazonaws.com",
-    // Nest monolith (production) — serves POST /public/search. Custom domain,
+    // Nest monolith (production) — serves POST /public/search/lexical. Custom domain,
     // same as the dashboard's VITE_MONOLITH_API_URL: the raw execute-api
     // gateway URL answers 500 on every route and must not be used.
     monolithApiUrl: "https://api.askdialog.ai",

package/dist/searchController.d.ts

@@ -1,3 +1,3 @@
 import { SearchController, SearchControllerOptions } from "./types/searchController";
-export declare function createSearchController({ search, analytics, navigate, debounceMs, hitsPerPage, locale, countryCode, }: SearchControllerOptions): SearchController;
+export declare function createSearchController({ search, analytics, navigate, debounceMs, hitsPerPage, locale, }: SearchControllerOptions): SearchController;
 //# sourceMappingURL=searchController.d.ts.map

package/dist/searchController.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"searchController.d.ts","sourceRoot":"","sources":["../src/searchController.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EAGxB,MAAM,0BAA0B,CAAC;AAgBlC,wBAAgB,sBAAsB,CAAC,EACrC,MAAM,EACN,SAAS,EACT,QAAQ,EACR,UAAgC,EAChC,WAAmC,EACnC,MAAM,EACN,WAAW,GACZ,EAAE,uBAAuB,GAAG,gBAAgB,CAsL5C"}
+{"version":3,"file":"searchController.d.ts","sourceRoot":"","sources":["../src/searchController.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EAGxB,MAAM,0BAA0B,CAAC;AAgBlC,wBAAgB,sBAAsB,CAAC,EACrC,MAAM,EACN,SAAS,EACT,QAAQ,EACR,UAAgC,EAChC,WAAmC,EACnC,MAAM,GACP,EAAE,uBAAuB,GAAG,gBAAgB,CA8K5C"}

package/dist/searchController.js

@@ -1,3 +1,8 @@
+// This controller is one cohesive unit. `selectResult` now returns whether the
+// navigate adapter handled the transition, nudging the file just past the
+// default 200-line cap — raised modestly rather than split artificially.
+/* eslint max-lines: ["error", 220] */
+import { searchIndexName } from "./services/search";
 import { SearchStatus, } from "./types/searchController";
 import { createControllerAnalytics } from "./utils/searchControllerAnalytics";
 const DEFAULT_DEBOUNCE_MS = 250;
@@ -11,7 +16,8 @@ const INITIAL_STATE = {
     response: undefined,
     error: undefined,
 };
-export function createSearchController({ search, analytics, navigate, debounceMs = DEFAULT_DEBOUNCE_MS, hitsPerPage = DEFAULT_HITS_PER_PAGE, locale, countryCode, }) {
+export function createSearchController({ search, analytics, navigate, debounceMs = DEFAULT_DEBOUNCE_MS, hitsPerPage = DEFAULT_HITS_PER_PAGE, locale, }) {
+    const indexName = searchIndexName("products", locale);
     let state = INITIAL_STATE;
     const listeners = new Set();
     const controllerAnalytics = createControllerAnalytics(analytics);
@@ -34,22 +40,9 @@ export function createSearchController({ search, analytics, navigate, debounceMs
         abortController?.abort();
         abortController = undefined;
     };
-    const buildRequest = (query, page) => {
-        const request = { query, page, hitsPerPage };
-        if (locale !== undefined) {
-            request.locale = locale;
-        }
-        if (countryCode !== undefined) {
-            request.countryCode = countryCode;
-        }
-        // Query unchanged since the last response: resend its queryId; a new
-        // query gets a fresh engine-generated one.
-        const previous = state.response;
-        if (previous?.query === query) {
-            request.queryId = previous.queryId;
-        }
-        return request;
-    };
+    const buildRequest = (query, page) => ({
+        requests: [{ indexName, query, page, hitsPerPage }],
+    });
     const run = async (query, page) => {
         cancelInFlight();
         abortController = new AbortController();
@@ -63,10 +56,14 @@ export function createSearchController({ search, analytics, navigate, debounceMs
             if (id !== requestId) {
                 return; // A newer request landed first: this response is stale.
             }
-            controllerAnalytics.onResponse(response);
+            const result = response.results.find((entry) => entry.index === indexName);
+            if (result === undefined) {
+                throw new Error(`Dialog search returned no ${indexName} entry`);
+            }
+            controllerAnalytics.onResponse(result);
             setState({
-                status: response.nbHits === 0 ? SearchStatus.EMPTY : SearchStatus.SUCCESS,
-                response,
+                status: result.nbHits === 0 ? SearchStatus.EMPTY : SearchStatus.SUCCESS,
+                response: result,
                 error: undefined,
             });
         }
@@ -146,7 +143,7 @@ export function createSearchController({ search, analytics, navigate, debounceMs
                 return false;
             }
             controllerAnalytics.select(response, index);
-            const url = response.hits[index].product.url;
+            const url = response.hits[index].url;
             const runAdapter = options?.navigate ?? true;
             if (runAdapter && navigate !== undefined && url !== undefined) {
                 navigate(url, response.hits[index]);

package/dist/services/search.d.ts

@@ -1,7 +1,8 @@
-import { SearchOptions, SearchRequest, SearchResponse } from "../types/search";
+import { SearchIndex, SearchOptions, SearchRequest, SearchResponse } from "../types/search";
+export declare const searchIndexName: (index: SearchIndex, locale: string) => string;
 /**
  * One POST per invocation — no debounce, cache, retry or request state; the
  * caller owns cancellation through `options.signal`.
  */
-export declare const searchProducts: (apiKey: string, request: SearchRequest, options?: SearchOptions) => Promise<SearchResponse>;
+export declare const searchLexical: (apiKey: string, request: SearchRequest, options?: SearchOptions) => Promise<SearchResponse>;
 //# sourceMappingURL=search.d.ts.map

package/dist/services/search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/services/search.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAuB/E;;;GAGG;AACH,eAAO,MAAM,cAAc,GACzB,QAAQ,MAAM,EACd,SAAS,aAAa,EACtB,UAAU,aAAa,KACtB,OAAO,CAAC,cAAc,CAgBxB,CAAC"}
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/services/search.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,WAAW,EACX,aAAa,EACb,aAAa,EACb,cAAc,EACf,MAAM,iBAAiB,CAAC;AAMzB,eAAO,MAAM,eAAe,GAAI,OAAO,WAAW,EAAE,QAAQ,MAAM,KAAG,MACzB,CAAC;AAoB7C;;;GAGG;AACH,eAAO,MAAM,aAAa,GACxB,QAAQ,MAAM,EACd,SAAS,aAAa,EACtB,UAAU,aAAa,KACtB,OAAO,CAAC,cAAc,CAgBxB,CAAC"}

package/dist/services/search.js

@@ -1,7 +1,9 @@
 import { config } from "../config";
 import { DialogSearchError } from "../DialogSearchError";
-const SEARCH_PATH = "/public/search";
+import { toIso639LanguageCode } from "../utils/localization";
+const SEARCH_PATH = "/public/search/lexical";
 const API_KEY_HEADER = "x-dialog-api-key";
+export const searchIndexName = (index, locale) => `${index}_${toIso639LanguageCode(locale)}`;
 const toSearchError = async (response) => {
     let body;
     try {
@@ -20,7 +22,7 @@ const toSearchError = async (response) => {
  * One POST per invocation — no debounce, cache, retry or request state; the
  * caller owns cancellation through `options.signal`.
  */
-export const searchProducts = async (apiKey, request, options) => {
+export const searchLexical = async (apiKey, request, options) => {
     const response = await fetch(`${config.monolithApiUrl}${SEARCH_PATH}`, {
         method: "POST",
         headers: {

package/dist/types/constructor.d.ts

@@ -5,6 +5,11 @@ export interface DialogCallbacks {
     addToCart: (input: AddToCartInput) => Promise<void>;
     getProduct: (productId: string, variantId?: string) => Promise<SimplifiedProduct>;
 }
+export interface CurrentProduct {
+    /** The catalog product id — must match the id in the Dialog product feed. */
+    id: string;
+    variantId?: string;
+}
 export interface DialogConstructor {
     apiKey: string;
     locale: string;
@@ -40,5 +45,15 @@ export interface DialogConstructor {
      * Product links and recommendation browsing are unaffected.
      */
     disableAddToCart?: boolean;
+    /**
+     * The product of the page the SDK is instantiated on, when it is a product
+     * page. The assistant uses it as the conversation's product context for
+     * entry points that carry no product of their own (floating bookmark,
+     * resume surface, free-text questions), so answers stay grounded on the
+     * product under the visitor's eyes after PDP-to-PDP navigation. On
+     * single-page storefronts, update it on navigation with
+     * `setCurrentProduct()` / `clearCurrentProduct()`.
+     */
+    product?: CurrentProduct;
 }
 //# sourceMappingURL=constructor.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"constructor.d.ts","sourceRoot":"","sources":["../../src/types/constructor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,UAAU,EAAE,CACV,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,KACf,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC;;;;;;;;OAQG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B"}
+{"version":3,"file":"constructor.d.ts","sourceRoot":"","sources":["../../src/types/constructor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,UAAU,EAAE,CACV,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,KACf,OAAO,CAAC,iBAAiB,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,cAAc;IAC7B,6EAA6E;IAC7E,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC;;;;;;;;OAQG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B"}

package/dist/types/search.d.ts

@@ -1,14 +1,18 @@
-export interface SearchRequest {
+/** Logical indices the public search serves; the wire name adds the locale. */
+export declare const SEARCH_INDICES: readonly ["products", "collections", "articles", "pages"];
+export type SearchIndex = (typeof SEARCH_INDICES)[number];
+export interface SearchQuery {
+    /** `<index>_<locale>` (e.g. `products_fr`), one shared locale per request; unknown or unserved → 404. */
+    indexName: string;
     /** Trimmed server-side; must keep at least two visible characters (code points). */
     query: string;
     /** Zero-indexed results page. Defaults to 0 server-side. */
     page?: number;
     /** Between 1 and 100. Defaults to 20 server-side. */
     hitsPerPage?: number;
-    /** Previous response's queryId while the query is unchanged; omit for a new query. */
-    queryId?: string;
-    locale?: string;
-    countryCode?: string;
+}
+export interface SearchRequest {
+    requests: SearchQuery[];
 }
 export interface SearchOptions {
     /** Forwarded to fetch untouched: aborting rejects with the native AbortError. */
@@ -17,41 +21,39 @@ export interface SearchOptions {
 export interface SearchPrice {
     /** Decimal amount as a string, exactly as indexed (e.g. "24.90"). */
     amount: string;
-    currencyCode: string;
+    /** Absent when the price was indexed without a currency. */
+    currencyCode?: string;
 }
 export interface SearchPriceRange {
     min: SearchPrice;
     max: SearchPrice;
 }
 /**
- * Storefront-ready projection of a search hit. Every display field is
- * best-effort: a product may carry only its id.
+ * A flat, storefront-ready record: `objectID` plus the record's attributes.
+ * Every display field is best-effort — a hit may carry only its id;
+ * `priceRange` only comes from the products index.
  */
-export interface SearchProduct {
-    id: string;
+export interface SearchHit {
+    objectID: string;
     title?: string;
     url?: string;
-    /** Shopify URL handle, lets the storefront build `/products/{handle}` when `url` is absent (DEC-2543). */
     handle?: string;
     imageUrl?: string;
     priceRange?: SearchPriceRange;
-    compareAtPriceRange?: SearchPriceRange;
-    inStock?: boolean;
 }
-export interface SearchHit {
-    id: string;
-    score: number;
-    product: SearchProduct;
-}
-export interface SearchResponse {
-    /** Engine-generated id for search attribution analytics. */
-    queryId: string;
+export interface SearchResult {
+    index: string;
     hits: SearchHit[];
     nbHits: number;
     page: number;
     nbPages: number;
     hitsPerPage: number;
-    processingTimeMs: number;
+    processingTimeMS: number;
     query: string;
+    queryID: string;
+}
+/** One entry per request entry, in request order. */
+export interface SearchResponse {
+    results: SearchResult[];
 }
 //# sourceMappingURL=search.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/types/search.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC5B,oFAAoF;IACpF,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sFAAsF;IACtF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,iFAAiF;IACjF,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,WAAW,CAAC;IACjB,GAAG,EAAE,WAAW,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,0GAA0G;IAC1G,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,mBAAmB,CAAC,EAAE,gBAAgB,CAAC;IACvC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,aAAa,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;CACf"}
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/types/search.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,eAAO,MAAM,cAAc,2DAKjB,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE1D,MAAM,WAAW,WAAW;IAC1B,yGAAyG;IACzG,SAAS,EAAE,MAAM,CAAC;IAClB,oFAAoF;IACpF,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,iFAAiF;IACjF,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,qEAAqE;IACrE,MAAM,EAAE,MAAM,CAAC;IACf,4DAA4D;IAC5D,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,WAAW,CAAC;IACjB,GAAG,EAAE,WAAW,CAAC;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qDAAqD;AACrD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB"}

package/dist/types/search.js

@@ -1,4 +1,7 @@
-// Mirrors the public Nest storefront-search DTO exactly (POST /public/search,
-// `storefrontSearchRequestSchema` / `storefrontSearchResponseSchema` in
-// @dialog/shared-schemas) — camelCase wire format, no internal Python casing.
-export {};
+/** Logical indices the public search serves; the wire name adds the locale. */
+export const SEARCH_INDICES = [
+    "products",
+    "collections",
+    "articles",
+    "pages",
+];