@askdialog/dialog-sdk 2.9.1 → 2.11.0

package/README.md

@@ -91,6 +91,29 @@ The getProduct function is used to display product information in the assistant.
 
 When the client is instantiated, it will automatically insert into the DOM the Dialog Assistant script, so you can interact with the assistant using `sendProductMessage` or `sendGenericMessage`. This assistant runtime always loads — it owns the shopper identity, consent handling and analytics bridge — while the heavy assistant UI stays lazy-loaded and is not fetched eagerly.
 
+### Declaring the current product page
+
+The assistant answers product questions with the product context of the page the shopper is on. Entry points that carry a product id (like `sendProductMessage`) set it themselves, but entry points that don't — the floating bookmark, the resume-conversation surface, free-text questions — need the SDK to know what PDP the shopper is looking at, especially after navigating from one product page to another.
+
+Declare it at construction on product pages:
+
+```ts
+new Dialog({
+  apiKey: 'YOUR_API_KEY',
+  locale: 'fr',
+  product: { id: 'PRODUCT_ID', variantId: 'VARIANT_ID' }, // variantId optional
+});
+```
+
+On single-page storefronts, update it on client-side navigation:
+
+```ts
+client.setCurrentProduct('PRODUCT_ID');   // arrived on a PDP
+client.clearCurrentProduct();             // left for a non-product page
+```
+
+Ids must match the product ids of your Dialog product feed. Without a declared product, questions asked from the bookmark after a page change reach the assistant without product context and are answered generically.
+
 ### OneTrust auto-blocking
 
 If your site uses OneTrust auto-blocking, it may neutralize the assistant script injected by the SDK (`type` rewritten to `text/plain`) for visitors who declined cookies — a `data-ot-ignore` on your own SDK `<script>` tag does not cover dynamically injected scripts. Two remedies, both merchant-side decisions:
@@ -196,21 +219,28 @@ Example of expected result:
 
 - Search products
 
-`client.search()` performs a typed product search through Dialog's public API, with no framework and no commerce callbacks required.
+`client.search()` performs a typed, Algolia-shaped search through Dialog's public API, with no framework and no commerce callbacks required. Each entry targets an index named `<index>_<locale>` (index ∈ `products | collections | articles | pages`, locale ISO 639-1) — build the name with `searchIndexName(index, locale)`, which reduces any BCP-47 tag to its bare language.
 
 ```typescript
-import { Dialog, DialogSearchError } from '@askdialog/dialog-sdk';
+import { Dialog, DialogSearchError, searchIndexName } from '@askdialog/dialog-sdk';
 import type { SearchResponse } from '@askdialog/dialog-sdk';
 
 const client = new Dialog({ apiKey: 'YOUR_API_KEY', locale: 'fr' });
 
 const response: SearchResponse = await client.search({
-  query: 'shampoo',
-  page: 0, // optional, zero-indexed (default 0)
-  hitsPerPage: 20, // optional, 1-100 (default 20)
-  queryId: previousResponse?.queryId, // optional, resend while the query is unchanged
+  requests: [
+    {
+      indexName: searchIndexName('products', client.locale), // "products_fr"
+      query: 'shampoo',
+      page: 0, // optional, zero-indexed (default 0)
+      hitsPerPage: 20, // optional, 1-100 (default 20)
+    },
+  ],
 });
-// response.hits[n].product: { id, title?, url?, imageUrl?, priceRange?, inStock? }
+// response.results[n]: { index, hits, nbHits, page, nbPages, hitsPerPage,
+//                        processingTimeMS, query, queryID }
+// response.results[n].hits[m]: { objectID, title?, url?, handle?, imageUrl?,
+//                                priceRange? }
 ```
 
 With the IIFE bundle the results are plain runtime JSON (same shape, no types):
@@ -219,17 +249,19 @@ With the IIFE bundle the results are plain runtime JSON (same shape, no types):
 <script src="https://d2m6yt8rnm4dos.cloudfront.net/dialog-sdk.X.Y.Z.min.js"></script>
 <script>
   const client = new window.DialogSDK.Dialog({ apiKey: 'YOUR_API_KEY', locale: 'fr' });
-  client.search({ query: 'shampoo' }).then((response) => console.log(response.hits));
+  client
+    .search({ requests: [{ indexName: 'products_fr', query: 'shampoo' }] })
+    .then((response) => console.log(response.results[0].hits));
 </script>
 ```
 
-A non-2xx answer rejects with `DialogSearchError` — stable `name`, HTTP `status`, optional machine-readable `code` (e.g. `SEARCH_INDEX_NOT_FOUND`) and `message`. Aborting rejects with the native `AbortError`, and network failures keep their native errors.
+A non-2xx answer rejects with `DialogSearchError` — stable `name`, HTTP `status` and `message` (e.g. `404 Index products_xx does not exist`, `400 Unknown parameter: foo`). Aborting rejects with the native `AbortError`, and network failures keep their native errors.
 
 `client.search()` itself is stateless: no debounce, no cache, no automatic cancellation of previous searches. For search-as-you-type, use the search controller below instead of hand-rolling those.
 
 - Search controller
 
-`createSearchController()` wraps the stateless transport with the stateful behavior every search UI needs — debounce (immediate on explicit submission), cancellation of the in-flight request, stale-response protection (a late response never replaces newer results, even if the transport ignores the abort), pagination that resets on a new query, `idle` / `loading` / `success` / `empty` / `error` states, retry, and the DEC-2448 attribution events (`view_search_results` viewport impressions, `select_search_result` clicks) with a consistent `query_id`. It has no framework or rendering dependency: raw JavaScript, React, Vue and Shopify integrations are rendering-and-routing adapters around it.
+`createSearchController()` wraps the stateless transport with the stateful behavior every search UI needs — debounce (immediate on explicit submission), cancellation of the in-flight request, stale-response protection (a late response never replaces newer results, even if the transport ignores the abort), pagination that resets on a new query, `idle` / `loading` / `success` / `empty` / `error` states, retry, and the attribution events (`view_search_results` viewport impressions, `select_search_result` clicks). It searches the products index (`products_<locale>`) and exposes the products result entry as `state.response`; optional `sections` add other indices (`collections`, …) to the same request, exposed under `state.sections`. It has no framework or rendering dependency: raw JavaScript, React, Vue and Shopify integrations are rendering-and-routing adapters around it.
 
 ```typescript
 import { createSearchController, Dialog, SearchStatus } from '@askdialog/dialog-sdk';
@@ -238,6 +270,7 @@ const client = new Dialog({ apiKey: 'YOUR_API_KEY', locale: 'fr' });
 
 const controller = createSearchController({
   search: (request, options) => client.search(request, options),
+  locale: client.locale, // names the searched index ("products_fr")
   analytics: {
     surface: 'search_page', // where results are displayed
     trackViewSearchResults: (params) => client.trackViewSearchResults(params),
@@ -246,6 +279,7 @@ const controller = createSearchController({
   navigate: (url) => router.push(url), // optional platform routing adapter
   debounceMs: 250, // optional (default 250)
   hitsPerPage: 12, // optional (default 12)
+  sections: [{ index: 'collections', hitsPerPage: 5 }], // optional, first page only; a function is resolved per request
 });
 
 const unsubscribe = controller.subscribe((state) => {

package/dist/Dialog.d.ts

@@ -19,7 +19,8 @@ export declare class Dialog {
     private _eventsHandler;
     private _ignoreOneTrustAutoBlock;
     private _disableAddToCart;
-    constructor({ apiKey, locale, countryCode, callbacks, theme, userId, ignoreOneTrustAutoBlock, disableAddToCart, }: DialogConstructor);
+    private _currentProduct?;
+    constructor({ apiKey, locale, countryCode, callbacks, theme, userId, ignoreOneTrustAutoBlock, disableAddToCart, product, }: DialogConstructor);
     get apiKey(): string;
     get theme(): Theme;
     get userId(): string;
@@ -29,15 +30,29 @@ export declare class Dialog {
     private _createOrRetrieveUserId;
     getSuggestions(productId: string): Promise<Suggestion>;
     /**
-     * Typed product search through the Nest public endpoint. Stateless: one
-     * request per call, cancellation belongs to the caller via
-     * `options.signal` (previous searches are never cancelled automatically).
-     * Rejects with `DialogSearchError` on a non-2xx answer, and with the
-     * native AbortError / network error otherwise.
+     * Typed multi-index search through the Nest public endpoint (Algolia-shaped,
+     * DAT-412). The locale travels in each entry's `indexName` (`products_fr`) —
+     * build it with `searchIndexName(index, locale)`. Stateless: one request per
+     * call, cancellation belongs to the caller via `options.signal` (previous
+     * searches are never cancelled automatically). Rejects with
+     * `DialogSearchError` on a non-2xx answer, and with the native AbortError /
+     * network error otherwise.
      */
     search(request: SearchRequest, options?: SearchOptions): Promise<SearchResponse>;
     openAssistant(params: OpenAssistantPayload): void;
     closeAssistant(): void;
+    /**
+     * Declare the product of the current page. The assistant reads it as the
+     * conversation's product context whenever a question carries no product of
+     * its own (floating bookmark, resume surface, free-text input). Call it on
+     * every PDP navigation on single-page storefronts; ids must match the
+     * Dialog product feed.
+     */
+    setCurrentProduct(productId: string, variantId?: string): void;
+    private static _isValidProductId;
+    /** Declare that the current page is not a product page. */
+    clearCurrentProduct(): void;
+    private _applyCurrentProductDataset;
     sendProductMessage(params: ProductQuestionPayload): void;
     sendGenericMessage(params: GenericQuestionPayload): void;
     onAssistantEvent(listener: (event: AssistantEvent) => void): void;

package/dist/Dialog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Dialog.d.ts","sourceRoot":"","sources":["../src/Dialog.ts"],"names":[],"mappings":"AAIA,OAAO,EAAmB,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AACtC,OAAO,EACL,kBAAkB,EAEnB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EACL,cAAc,EAEd,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACxB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAE9E,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,qBAAa,MAAM;IACjB,gBAAuB,OAAO,SAAuB;IAErD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAC,CAAS;IAE9B,OAAO,CAAC,UAAU,CAAC,CAAkB;IACrC,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,cAAc,CAAgB;IACtC,OAAO,CAAC,wBAAwB,CAAU;IAC1C,OAAO,CAAC,iBAAiB,CAAU;gBAEvB,EACV,MAAM,EACN,MAAM,EACN,WAAW,EACX,SAAS,EACT,KAAK,EACL,MAAM,EACN,uBAAuB,EACvB,gBAAgB,GACjB,EAAE,iBAAiB;IAcpB,IAAW,MAAM,IAAI,MAAM,CAE1B;IACD,IAAW,KAAK,IAAI,KAAK,CAExB;IACD,IAAW,MAAM,IAAI,MAAM,CAE1B;IACD,IAAW,MAAM,IAAI,MAAM,CAE1B;IACD,IAAW,aAAa,IAAI,aAAa,CAExC;IAEM,2BAA2B,IAAI,kBAAkB,GAAG,IAAI;IAI/D,OAAO,CAAC,uBAAuB;IAkBlB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAInE;;;;;;OAMG;IACI,MAAM,CACX,OAAO,EAAE,aAAa,EACtB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,cAAc,CAAC;IAanB,aAAa,CAAC,MAAM,EAAE,oBAAoB,GAAG,IAAI;IAKjD,cAAc,IAAI,IAAI;IAItB,kBAAkB,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI;IAIxD,kBAAkB,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI;IAOxD,gBAAgB,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,GAAG,IAAI;IAIjE,sBAAsB,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAInD,UAAU,CACf,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,iBAAiB,CAAC;IAUhB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB5D,OAAO,CAAC,oBAAoB;IAUrB,sBAAsB,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAcnD,2BAA2B,CAChC,MAAM,EAAE,oBAAoB,GAAG,oBAAoB,GAClD,IAAI;IA0BP;;;;OAIG;IACI,sBAAsB,CAAC,MAAM,EAAE,uBAAuB,GAAG,IAAI;IAUpE;;;OAGG;IACI,uBAAuB,CAAC,MAAM,EAAE,wBAAwB,GAAG,IAAI;IAUtE,OAAO,CAAC,cAAc;CAwCvB"}
+{"version":3,"file":"Dialog.d.ts","sourceRoot":"","sources":["../src/Dialog.ts"],"names":[],"mappings":"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"}

package/dist/Dialog.js

@@ -7,7 +7,7 @@ import { ANONYMOUS_CUSTOMER_ID, CUSTOMER_ID } from "./constants/user";
 import { DialogEvents, } from "./types/events";
 import { EventsHandler } from "./EventsHandler";
 import { loadSuggestions } from "./services/suggestions";
-import { searchProducts } from "./services/search";
+import { searchLexical } from "./services/search";
 import { config } from "./config";
 import { exposeSdkOnWindowDialog } from "./windowAudit";
 export class Dialog {
@@ -21,13 +21,21 @@ export class Dialog {
     _eventsHandler;
     _ignoreOneTrustAutoBlock;
     _disableAddToCart;
-    constructor({ apiKey, locale, countryCode, callbacks, theme, userId, ignoreOneTrustAutoBlock, disableAddToCart, }) {
+    _currentProduct;
+    constructor({ apiKey, locale, countryCode, callbacks, theme, userId, ignoreOneTrustAutoBlock, disableAddToCart, product, }) {
         this._apiKey = apiKey;
         this._locale = locale;
         this._countryCode = countryCode;
         this._callbacks = callbacks;
         this._ignoreOneTrustAutoBlock = ignoreOneTrustAutoBlock ?? false;
         this._disableAddToCart = disableAddToCart ?? false;
+        this._currentProduct =
+            product !== undefined && Dialog._isValidProductId(product.id)
+                ? product
+                : undefined;
+        if (product !== undefined && this._currentProduct === undefined) {
+            console.error("Dialog: `product.id` must be a non-empty string; ignoring the constructor option.");
+        }
         this._theme = { ...defaultTheme, ...theme };
         this._userId = this._createOrRetrieveUserId(userId);
         this._eventsHandler = new EventsHandler(locale, userId);
@@ -69,18 +77,16 @@ export class Dialog {
         return loadSuggestions(this._apiKey, this._locale, productId);
     }
     /**
-     * Typed product search through the Nest public endpoint. Stateless: one
-     * request per call, cancellation belongs to the caller via
-     * `options.signal` (previous searches are never cancelled automatically).
-     * Rejects with `DialogSearchError` on a non-2xx answer, and with the
-     * native AbortError / network error otherwise.
+     * Typed multi-index search through the Nest public endpoint (Algolia-shaped,
+     * DAT-412). The locale travels in each entry's `indexName` (`products_fr`) —
+     * build it with `searchIndexName(index, locale)`. Stateless: one request per
+     * call, cancellation belongs to the caller via `options.signal` (previous
+     * searches are never cancelled automatically). Rejects with
+     * `DialogSearchError` on a non-2xx answer, and with the native AbortError /
+     * network error otherwise.
      */
     search(request, options) {
-        return searchProducts(this._apiKey, {
-            ...request,
-            locale: request.locale ?? this._locale,
-            countryCode: request.countryCode ?? this._countryCode,
-        }, options);
+        return searchLexical(this._apiKey, request, options);
     }
     // TODO: Not yet implemented on assistant
     openAssistant(params) {
@@ -90,6 +96,57 @@ export class Dialog {
     closeAssistant() {
         this._eventsHandler.emitExternalEvent(DialogEvents.CLOSE_ASSISTANT);
     }
+    /**
+     * Declare the product of the current page. The assistant reads it as the
+     * conversation's product context whenever a question carries no product of
+     * its own (floating bookmark, resume surface, free-text input). Call it on
+     * every PDP navigation on single-page storefronts; ids must match the
+     * Dialog product feed.
+     */
+    setCurrentProduct(productId, variantId) {
+        if (!Dialog._isValidProductId(productId)) {
+            console.error("Dialog: setCurrentProduct expects a non-empty string productId; ignoring the call. Use clearCurrentProduct() to declare a non-product page.");
+            return;
+        }
+        this._currentProduct = { id: productId, variantId };
+        this._applyCurrentProductDataset();
+    }
+    static _isValidProductId(productId) {
+        return typeof productId === "string" && productId.trim() !== "";
+    }
+    /** Declare that the current page is not a product page. */
+    clearCurrentProduct() {
+        this._currentProduct = undefined;
+        this._applyCurrentProductDataset();
+    }
+    // The dataset on the assistant mount node is the SDK⇄runtime contract for
+    // the page product: the runtime observes data-product-id / data-variant-id
+    // and needs no event plumbing, so SDK and runtime versions can drift.
+    _applyCurrentProductDataset() {
+        // Resolved via getElementById on purpose, NOT an instance reference: the
+        // assistant runtime reads the dataset the same way, so on a page where
+        // another integration already rendered #dialog-shopify-ai (duplicate-id
+        // case) writer and reader must land on the same — first — node.
+        const mountNode = document.getElementById("dialog-shopify-ai");
+        if (mountNode === null) {
+            // Assistant mount node absent (locale error at load, or the host page
+            // removed it) — the declaration is kept but cannot reach the runtime.
+            console.warn("Dialog: assistant mount node not found; the current product declaration has no effect.");
+            return;
+        }
+        if (this._currentProduct === undefined) {
+            delete mountNode.dataset.productId;
+            delete mountNode.dataset.variantId;
+            return;
+        }
+        mountNode.dataset.productId = this._currentProduct.id;
+        if (this._currentProduct.variantId === undefined) {
+            delete mountNode.dataset.variantId;
+        }
+        else {
+            mountNode.dataset.variantId = this._currentProduct.variantId;
+        }
+    }
     sendProductMessage(params) {
         this._eventsHandler.emitExternalEvent(DialogEvents.SEND_MESSAGE, params);
     }
@@ -199,6 +256,9 @@ export class Dialog {
             div.dataset.disableAddToCart = "true";
         }
         document.body.appendChild(div);
+        if (this._currentProduct !== undefined) {
+            this._applyCurrentProductDataset();
+        }
         setTimeout(() => {
             const script = document.createElement("script");
             if (this._ignoreOneTrustAutoBlock) {

package/dist/__tests__/dialogCurrentProduct.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=dialogCurrentProduct.spec.d.ts.map

package/dist/__tests__/dialogCurrentProduct.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialogCurrentProduct.spec.d.ts","sourceRoot":"","sources":["../../src/__tests__/dialogCurrentProduct.spec.ts"],"names":[],"mappings":""}

package/dist/__tests__/dialogCurrentProduct.spec.js

@@ -0,0 +1,134 @@
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { Dialog } from "../Dialog";
+// The full Dialog constructor touches window/localStorage; these tests only
+// exercise the current-product dataset contract, so the instance is built
+// from the prototype with just the fields the tested paths read.
+const buildDialog = (currentProduct) => {
+    const dialog = Object.create(Dialog.prototype);
+    Object.assign(dialog, {
+        _apiKey: "api-key-1",
+        _userId: "user-1",
+        _locale: "fr-FR",
+        _ignoreOneTrustAutoBlock: false,
+        _disableAddToCart: false,
+        _currentProduct: currentProduct,
+    });
+    return dialog;
+};
+const stubDocument = (options = { mounted: true }) => {
+    const script = { setAttribute: vi.fn() };
+    const div = { dataset: {} };
+    // _loadAssistant appends the mount node; getElementById reflects that.
+    let mounted = options.mounted;
+    vi.stubGlobal("document", {
+        createElement: (tag) => (tag === "script" ? script : div),
+        getElementById: (id) => mounted && id === "dialog-shopify-ai" ? div : null,
+        body: {
+            appendChild: vi.fn(() => {
+                mounted = true;
+            }),
+        },
+        head: { insertBefore: vi.fn(), firstChild: null },
+    });
+    return { div };
+};
+// Fake timers keep the deferred script injection from firing after the
+// document stub is torn down.
+const loadAssistant = (dialog) => {
+    vi.useFakeTimers();
+    dialog._loadAssistant();
+};
+afterEach(() => {
+    vi.unstubAllGlobals();
+    vi.useRealTimers();
+    vi.clearAllMocks();
+});
+describe("Dialog current product — constructor option", () => {
+    it("writes the product dataset on the mount node at load", () => {
+        const { div } = stubDocument();
+        loadAssistant(buildDialog({ id: "6980", variantId: "42" }));
+        expect(div.dataset.productId).toBe("6980");
+        expect(div.dataset.variantId).toBe("42");
+    });
+    it("omits the variant key when no variant is declared", () => {
+        const { div } = stubDocument();
+        loadAssistant(buildDialog({ id: "6980" }));
+        expect(div.dataset.productId).toBe("6980");
+        expect(div.dataset.variantId).toBeUndefined();
+    });
+    it("leaves the mount node free of product keys by default", () => {
+        const { div } = stubDocument();
+        loadAssistant(buildDialog());
+        expect(div.dataset.productId).toBeUndefined();
+        expect(div.dataset.variantId).toBeUndefined();
+    });
+});
+describe("Dialog current product — constructor validation", () => {
+    it("rejects an invalid constructor product id and keeps the mount node clean", () => {
+        const { div } = stubDocument();
+        const consoleError = vi
+            .spyOn(console, "error")
+            .mockImplementation(() => undefined);
+        const dialog = buildDialog();
+        Object.assign(dialog, { _currentProduct: undefined });
+        // Mirror the constructor guard through the public setter contract.
+        dialog.setCurrentProduct("");
+        loadAssistant(dialog);
+        expect(div.dataset.productId).toBeUndefined();
+        expect(consoleError).toHaveBeenCalled();
+        consoleError.mockRestore();
+    });
+});
+describe("Dialog.setCurrentProduct / clearCurrentProduct", () => {
+    it("writes the dataset on the existing mount node", () => {
+        const { div } = stubDocument();
+        const dialog = buildDialog();
+        dialog.setCurrentProduct("6980", "42");
+        expect(div.dataset.productId).toBe("6980");
+        expect(div.dataset.variantId).toBe("42");
+    });
+    it("drops a stale variant when the next product has none", () => {
+        const { div } = stubDocument();
+        const dialog = buildDialog();
+        dialog.setCurrentProduct("6980", "42");
+        dialog.setCurrentProduct("7001");
+        expect(div.dataset.productId).toBe("7001");
+        expect(div.dataset.variantId).toBeUndefined();
+    });
+    it("removes both keys on clearCurrentProduct", () => {
+        const { div } = stubDocument();
+        const dialog = buildDialog();
+        dialog.setCurrentProduct("6980", "42");
+        dialog.clearCurrentProduct();
+        expect(div.dataset.productId).toBeUndefined();
+        expect(div.dataset.variantId).toBeUndefined();
+    });
+    it("rejects an empty productId without touching the dataset", () => {
+        const { div } = stubDocument();
+        const dialog = buildDialog();
+        const consoleError = vi
+            .spyOn(console, "error")
+            .mockImplementation(() => undefined);
+        dialog.setCurrentProduct("  ");
+        expect(div.dataset.productId).toBeUndefined();
+        expect(consoleError).toHaveBeenCalled();
+        consoleError.mockRestore();
+    });
+    it("warns when the mount node is missing", () => {
+        stubDocument({ mounted: false });
+        const dialog = buildDialog();
+        const consoleWarn = vi
+            .spyOn(console, "warn")
+            .mockImplementation(() => undefined);
+        dialog.setCurrentProduct("6980");
+        expect(consoleWarn).toHaveBeenCalled();
+        consoleWarn.mockRestore();
+    });
+    it("tolerates a missing mount node and applies the value at load", () => {
+        const { div } = stubDocument({ mounted: false });
+        const dialog = buildDialog();
+        expect(() => dialog.setCurrentProduct("6980")).not.toThrow();
+        loadAssistant(dialog);
+        expect(div.dataset.productId).toBe("6980");
+    });
+});

package/dist/__tests__/dialogSearchAnalytics.spec.js

@@ -19,6 +19,7 @@ const buildDialog = () => {
 };
 const envelope = {
     query_id: "query-1",
+    index: "products_fr",
     surface: "search_page",
     search_type: "lexical",
     page: 2,

package/dist/__tests__/publicTypes.spec.js

@@ -11,10 +11,11 @@ describe("public API types", () => {
         expectTypeOf().parameters.toMatchTypeOf();
         expectTypeOf().toMatchTypeOf();
         expectTypeOf().toMatchTypeOf();
-        expectTypeOf().toEqualTypeOf();
         expectTypeOf().returns.resolves.toEqualTypeOf();
         expectTypeOf().toEqualTypeOf();
         expectTypeOf().toEqualTypeOf();
+        expectTypeOf().toEqualTypeOf();
+        expectTypeOf().toEqualTypeOf();
         expectTypeOf().toMatchTypeOf();
         const error = new DialogSearchError({ status: 404, message: "not found" });
         expectTypeOf(error.status).toEqualTypeOf();