@askdialog/dialog-sdk 2.6.1 → 2.8.0

package/README.md

@@ -100,6 +100,26 @@ If your site uses OneTrust auto-blocking, it may neutralize the assistant script
 
 Either is compliance-safe with regard to analytics: the assistant gates all analytics on consent internally and sends nothing without an explicit opt-in (inspect `window.dialog.audit.consent`).
 
+### Disabling add-to-cart
+
+Some sessions must hide purchasing actions — for example a B2B storefront that hides its own add-to-cart when a B2B customer is logged in. Pass the optional `disableAddToCart: true` constructor flag (type `boolean`, default `false`) to suppress Dialog add-to-cart for that widget instance/session:
+
+```ts
+new Dialog({
+  apiKey: 'YOUR_API_KEY',
+  locale: 'fr',
+  disableAddToCart: true, // hide the add-to-cart CTA for this session
+});
+```
+
+When set:
+
+- the assistant hides/disables the add-to-cart CTA on both product recommendation cards and conversational product cards;
+- `client.addToCart(...)` becomes a no-op — it never invokes your `callbacks.addToCart` and emits no `TRACK_ADD_TO_CART` event, so a stale UI cannot add to the cart or pollute analytics;
+- product links and recommendation browsing are unaffected.
+
+Omit the flag (or set it to `false`) to keep the default behavior — the add-to-cart CTA and analytics are unchanged.
+
 ### Getters
 
 - apiKey

package/dist/Dialog.d.ts

@@ -18,7 +18,8 @@ export declare class Dialog {
     private _userId;
     private _eventsHandler;
     private _ignoreOneTrustAutoBlock;
-    constructor({ apiKey, locale, countryCode, callbacks, theme, userId, ignoreOneTrustAutoBlock, }: DialogConstructor);
+    private _disableAddToCart;
+    constructor({ apiKey, locale, countryCode, callbacks, theme, userId, ignoreOneTrustAutoBlock, disableAddToCart, }: DialogConstructor);
     get apiKey(): string;
     get theme(): Theme;
     get userId(): string;

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;gBAE9B,EACV,MAAM,EACN,MAAM,EACN,WAAW,EACX,SAAS,EACT,KAAK,EACL,MAAM,EACN,uBAAuB,GACxB,EAAE,iBAAiB;IAapB,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;IAKnB,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;IAS5D,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;CAkCvB"}
+{"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;IAKnB,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;CAsCvB"}

package/dist/Dialog.js

@@ -20,12 +20,14 @@ export class Dialog {
     _userId;
     _eventsHandler;
     _ignoreOneTrustAutoBlock;
-    constructor({ apiKey, locale, countryCode, callbacks, theme, userId, ignoreOneTrustAutoBlock, }) {
+    _disableAddToCart;
+    constructor({ apiKey, locale, countryCode, callbacks, theme, userId, ignoreOneTrustAutoBlock, disableAddToCart, }) {
         this._apiKey = apiKey;
         this._locale = locale;
         this._countryCode = countryCode;
         this._callbacks = callbacks;
         this._ignoreOneTrustAutoBlock = ignoreOneTrustAutoBlock ?? false;
+        this._disableAddToCart = disableAddToCart ?? false;
         this._theme = { ...defaultTheme, ...theme };
         this._userId = this._createOrRetrieveUserId(userId);
         this._eventsHandler = new EventsHandler(locale, userId);
@@ -103,6 +105,12 @@ export class Dialog {
     // forwarded to the merchant callback and to the tracking event, so
     // integrations can consume the added-product data wherever they hook in.
     async addToCart(input) {
+        // No-op when disabled, so a stale UI that still surfaced the CTA cannot
+        // add to the cart or emit analytics.
+        if (this._disableAddToCart) {
+            console.warn("Dialog: addToCart is disabled on this instance (disableAddToCart); ignoring the call.");
+            return;
+        }
         await this._getCallbacksOrThrow("addToCart").addToCart(input);
         this.registerAddToCartEvent(input);
         return;
@@ -182,6 +190,10 @@ export class Dialog {
         div.dataset.userId = this._userId;
         div.dataset.countryCode = localeInfo.countryCode;
         div.dataset.language = localeInfo.language;
+        if (this._disableAddToCart) {
+            // Read by the assistant runtime to hide the add-to-cart CTA.
+            div.dataset.disableAddToCart = "true";
+        }
         document.body.appendChild(div);
         setTimeout(() => {
             const script = document.createElement("script");

package/dist/__tests__/dialogAddToCart.spec.js

@@ -5,7 +5,7 @@ import { DialogEvents } from "../types/events";
 // The full Dialog constructor loads the assistant into the DOM; these tests
 // only exercise the add-to-cart pass-through, so the instance is built from
 // the prototype with just the fields addToCart/registerAddToCartEvent read.
-const buildDialog = (addToCartCallback) => {
+const buildDialog = (addToCartCallback, disableAddToCart = false) => {
     const eventsHandler = new EventsHandler("fr", "user-1");
     const emitExternalEvent = vi.fn();
     eventsHandler.emitExternalEvent =
@@ -15,6 +15,7 @@ const buildDialog = (addToCartCallback) => {
         _callbacks: { addToCart: addToCartCallback, getProduct: vi.fn() },
         _eventsHandler: eventsHandler,
         _userId: "user-1",
+        _disableAddToCart: disableAddToCart,
     });
     return { dialog, emitExternalEvent };
 };
@@ -56,4 +57,14 @@ describe("Dialog.addToCart", () => {
         expect(addToCartCallback).toHaveBeenCalledWith(legacyInput);
         expect(emitExternalEvent).toHaveBeenCalledWith(DialogEvents.TRACK_ADD_TO_CART, { userId: "user-1", ...legacyInput });
     });
+    it("is a no-op when disableAddToCart is set: no callback, no event", async () => {
+        const addToCartCallback = vi.fn().mockResolvedValue(undefined);
+        const { dialog, emitExternalEvent } = buildDialog(addToCartCallback, true);
+        const warn = vi.spyOn(console, "warn").mockImplementation(() => undefined);
+        await expect(dialog.addToCart(enrichedInput)).resolves.toBeUndefined();
+        expect(addToCartCallback).not.toHaveBeenCalled();
+        expect(emitExternalEvent).not.toHaveBeenCalled();
+        expect(warn).toHaveBeenCalledOnce();
+        warn.mockRestore();
+    });
 });

package/dist/__tests__/dialogLoadAssistant.spec.js

@@ -3,25 +3,28 @@ import { Dialog } from "../Dialog";
 // The full Dialog constructor touches window/localStorage; these tests only
 // exercise the assistant script injection, so the instance is built from the
 // prototype with just the fields _loadAssistant reads.
-const buildDialog = (ignoreOneTrustAutoBlock) => {
+const buildDialog = (overrides = {}) => {
     const dialog = Object.create(Dialog.prototype);
     Object.assign(dialog, {
         _apiKey: "api-key-1",
         _userId: "user-1",
         _locale: "fr-FR",
-        _ignoreOneTrustAutoBlock: ignoreOneTrustAutoBlock,
+        _ignoreOneTrustAutoBlock: false,
+        _disableAddToCart: false,
+        ...overrides,
     });
     return dialog;
 };
 const stubDocument = () => {
     const script = { setAttribute: vi.fn() };
+    const div = { dataset: {} };
     const insertBefore = vi.fn();
     vi.stubGlobal("document", {
-        createElement: (tag) => tag === "script" ? script : { dataset: {} },
+        createElement: (tag) => (tag === "script" ? script : div),
         body: { appendChild: vi.fn() },
         head: { insertBefore, firstChild: null },
     });
-    return { script, insertBefore };
+    return { script, div, insertBefore };
 };
 const loadAssistant = (dialog) => {
     dialog._loadAssistant();
@@ -36,15 +39,29 @@ describe("Dialog._loadAssistant OneTrust exemption", () => {
     it("sets data-ot-ignore on the injected script when opted in", () => {
         vi.useFakeTimers();
         const { script, insertBefore } = stubDocument();
-        loadAssistant(buildDialog(true));
+        loadAssistant(buildDialog({ _ignoreOneTrustAutoBlock: true }));
         expect(script.setAttribute).toHaveBeenCalledWith("data-ot-ignore", "");
         expect(insertBefore).toHaveBeenCalledWith(script, null);
     });
     it("leaves the injected script untouched by default", () => {
         vi.useFakeTimers();
         const { script, insertBefore } = stubDocument();
-        loadAssistant(buildDialog(false));
+        loadAssistant(buildDialog({ _ignoreOneTrustAutoBlock: false }));
         expect(script.setAttribute).not.toHaveBeenCalled();
         expect(insertBefore).toHaveBeenCalledWith(script, null);
     });
 });
+describe("Dialog._loadAssistant add-to-cart toggle", () => {
+    it("flags the injected div when disableAddToCart is set", () => {
+        vi.useFakeTimers();
+        const { div } = stubDocument();
+        loadAssistant(buildDialog({ _disableAddToCart: true }));
+        expect(div.dataset.disableAddToCart).toBe("true");
+    });
+    it("leaves the div free of the flag by default", () => {
+        vi.useFakeTimers();
+        const { div } = stubDocument();
+        loadAssistant(buildDialog({ _disableAddToCart: false }));
+        expect(div.dataset.disableAddToCart).toBeUndefined();
+    });
+});

package/dist/__tests__/searchControllerAttribution.spec.js

@@ -165,6 +165,48 @@ describe("search controller attribution", () => {
         expect(trackSelectSearchResult).toHaveBeenCalledWith(expect.objectContaining({ items: [{ product_id: "p2", position: 2 }] }));
         expect(navigate).not.toHaveBeenCalled();
     });
+    it("returns true when the navigate adapter handles the transition", async () => {
+        const controller = createController();
+        search.mockResolvedValue(response());
+        controller.submit("shoes");
+        await settle();
+        expect(controller.selectResult(0)).toBe(true);
+        expect(navigate).toHaveBeenCalledTimes(1);
+    });
+    it("returns false when the selected hit has no URL", async () => {
+        const controller = createController();
+        search.mockResolvedValue(response());
+        controller.submit("shoes");
+        await settle();
+        expect(controller.selectResult(1)).toBe(false);
+    });
+    it("returns false before any response", () => {
+        expect(createController().selectResult(0)).toBe(false);
+    });
+    it("records attribution but skips the adapter when navigation is opted out", async () => {
+        const controller = createController();
+        search.mockResolvedValue(response());
+        controller.submit("shoes");
+        await settle();
+        expect(controller.selectResult(0, { navigate: false })).toBe(false);
+        expect(trackSelectSearchResult).toHaveBeenCalledTimes(1);
+        expect(navigate).not.toHaveBeenCalled();
+    });
+    it("returns false when no navigate adapter is configured", async () => {
+        const controller = createSearchController({
+            search,
+            analytics: {
+                surface: "search_page",
+                trackViewSearchResults,
+                trackSelectSearchResult,
+            },
+        });
+        search.mockResolvedValue(response());
+        controller.submit("shoes");
+        await settle();
+        expect(controller.selectResult(0)).toBe(false);
+        expect(navigate).not.toHaveBeenCalled();
+    });
     it("disconnects the impression tracker on dispose", async () => {
         const controller = createController();
         search.mockResolvedValue(response());

package/dist/index.d.ts

@@ -2,7 +2,9 @@ export * from "./Dialog";
 export * from "./DialogSearchError";
 export * from "./EventsHandler";
 export * from "./searchController";
+export * from "./services/search";
 export * from "./types";
+export { isRtlLanguageCode, resolveTextDirection, type TextDirection, } from "./utils/localization";
 export * from "./utils/searchImpressions";
 export * from "./windowAudit";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,SAAS,CAAC;AACxB,cAAc,2BAA2B,CAAC;AAC1C,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,SAAS,CAAC;AACxB,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,KAAK,aAAa,GACnB,MAAM,sBAAsB,CAAC;AAC9B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -2,6 +2,8 @@ export * from "./Dialog";
 export * from "./DialogSearchError";
 export * from "./EventsHandler";
 export * from "./searchController";
+export * from "./services/search";
 export * from "./types";
+export { isRtlLanguageCode, resolveTextDirection, } from "./utils/localization";
 export * from "./utils/searchImpressions";
 export * from "./windowAudit";

package/dist/searchController.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"searchController.d.ts","sourceRoot":"","sources":["../src/searchController.ts"],"names":[],"mappings":"AACA,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EAGxB,MAAM,0BAA0B,CAAC;AAgBlC,wBAAgB,sBAAsB,CAAC,EACrC,MAAM,EACN,SAAS,EACT,QAAQ,EACR,UAAgC,EAChC,WAAmC,GACpC,EAAE,uBAAuB,GAAG,gBAAgB,CA2K5C"}
+{"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,GACpC,EAAE,uBAAuB,GAAG,gBAAgB,CAgL5C"}

package/dist/searchController.js

@@ -134,16 +134,19 @@ export function createSearchController({ search, analytics, navigate, debounceMs
             }
             controllerAnalytics.observeResult(element, state.response, index);
         },
-        selectResult(index) {
+        selectResult(index, options) {
             const response = state.response;
             if (response === undefined) {
-                return;
+                return false;
             }
             controllerAnalytics.select(response, index);
             const url = response.hits[index].product.url;
-            if (navigate !== undefined && url !== undefined) {
+            const runAdapter = options?.navigate ?? true;
+            if (runAdapter && navigate !== undefined && url !== undefined) {
                 navigate(url, response.hits[index]);
+                return true;
             }
+            return false;
         },
         subscribe(listener) {
             listeners.add(listener);

package/dist/types/constructor.d.ts

@@ -30,5 +30,15 @@ export interface DialogConstructor {
      * call, hence opt-in. No effect outside OneTrust auto-blocking setups.
      */
     ignoreOneTrustAutoBlock?: boolean;
+    /**
+     * Disables Dialog add-to-cart for this widget instance/session. Defaults to
+     * `false`. When `true`, the SDK flags the injected assistant so it hides the
+     * add-to-cart CTA on product recommendation and conversational product cards,
+     * and `addToCart()` becomes a no-op that emits no tracking event — nothing is
+     * added to the cart even if a stale UI still calls it. Meant for sessions
+     * where the merchant hides purchasing actions (e.g. logged-in B2B shoppers).
+     * Product links and recommendation browsing are unaffected.
+     */
+    disableAddToCart?: boolean;
 }
 //# 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;CACnC"}
+{"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"}

package/dist/types/searchController.d.ts

@@ -67,10 +67,23 @@ export interface SearchController {
     observeResult(element: Element, index: number): void;
     /**
      * Record selection attribution for `state.response.hits[index]` (forced
-     * impression + select event), then hand navigation to the `navigate`
-     * adapter. Call it on click AND middle-click/cmd+click.
+     * 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.
      */
-    selectResult(index: number): void;
+    selectResult(index: number, options?: {
+        navigate?: boolean;
+    }): boolean;
     /** Register a state listener; returns its unsubscribe function. */
     subscribe(listener: (state: SearchControllerState) => void): () => void;
     getState(): SearchControllerState;

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,EACf,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,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,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;CACtB;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;;;;OAIG;IACH,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,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,aAAa,EACb,aAAa,EACb,cAAc,EACf,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,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,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;CACtB;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"}

package/dist/utils/localization.d.ts

@@ -6,6 +6,9 @@ export interface DetailedLocaleInfo {
     locale: string;
 }
 export declare const isValidCountryCode: (countryCode: string | undefined) => countryCode is string;
+export type TextDirection = "ltr" | "rtl";
+export declare const isRtlLanguageCode: (code?: string) => boolean;
+export declare const resolveTextDirection: (code?: string) => TextDirection;
 /**
  * Resolves the detailed locale information used by the assistant.
  *

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;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,qBAAqB,GAChC,QAAQ,MAAM,EACd,sBAAsB,MAAM,KAC3B,kBAAkB,GAAG,IAoCvB,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

@@ -1,4 +1,12 @@
 export const isValidCountryCode = (countryCode) => countryCode !== undefined && /^[A-Za-z]{2}$/.test(countryCode);
+// ISO-639 codes whose scripts read right-to-left. `iw` is the legacy code for
+// Hebrew that some storefronts still emit.
+const RTL_LANGUAGE_CODES = new Set(["ar", "he", "iw", "fa", "ur"]);
+// Accepts a bare ISO-639 code ("ar") or a full BCP-47 locale ("ar-SA"): only
+// the leading language subtag decides direction.
+export const isRtlLanguageCode = (code) => code !== undefined &&
+    RTL_LANGUAGE_CODES.has(code.trim().toLowerCase().slice(0, 2));
+export const resolveTextDirection = (code) => isRtlLanguageCode(code) ? "rtl" : "ltr";
 /**
  * Resolves the detailed locale information used by the assistant.
  *

package/package.json

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