@askdialog/dialog-sdk 2.3.0 → 2.4.0

package/README.md

@@ -21,11 +21,11 @@ Before using the Dialog SDK, you need:
 ### Installation
 
 ```bash
-npm install @dialog/dialog-sdk
+npm install @askdialog/dialog-sdk
 # or
-pnpm add @dialog/dialog-sdk
+pnpm add @askdialog/dialog-sdk
 # or
-yarn add @dialog/dialog-sdk
+yarn add @askdialog/dialog-sdk
 ```
 
 You can also use our CDN link if you’re not using a package manager.
@@ -47,7 +47,7 @@ const client = new window.DialogSDK.Dialog({
 ### Instantiate the client
 
 ```typescript
-import { Dialog } from '@dialog/dialog-sdk';
+import { Dialog } from '@askdialog/dialog-sdk';
 
 const client = new Dialog({
   apiKey: 'YOUR_API_KEY', // required
@@ -87,7 +87,9 @@ The optional `countryCode` (ISO 3166 alpha-2, e.g. `'FR'`, `'US'`) sets the regi
 The addToCart function is triggered when a user clicks the AddToCart button.
 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`.
+`callbacks` is **optional**: a search-only integration can construct the client with just `apiKey` and `locale`. Only `getProduct()` and `addToCart()` require their callback — they throw an explicit configuration error when it is absent; every other feature works without callbacks.
+
+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.
 
 ### Getters
 
@@ -163,6 +165,62 @@ 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.
+
+```typescript
+import { Dialog, DialogSearchError } 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)
+});
+// response.hits[n].product: { id, title?, url?, imageUrl?, priceRange?, inStock? }
+```
+
+With the IIFE bundle the results are plain runtime JSON (same shape, no types):
+
+```html
+<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));
+</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.
+
+The SDK is stateless: no debounce, no cache, no automatic cancellation of previous searches. For search-as-you-type, own those in the integration:
+
+```typescript
+let controller: AbortController | undefined;
+let latestRequestId = 0;
+let debounceTimer: number | undefined;
+
+const onInput = (query: string) => {
+  window.clearTimeout(debounceTimer);
+  debounceTimer = window.setTimeout(async () => {
+    controller?.abort(); // cancel the in-flight request
+    controller = new AbortController();
+    const requestId = ++latestRequestId;
+    try {
+      const response = await client.search({ query }, { signal: controller.signal });
+      if (requestId !== latestRequestId) return; // stale response, ignore
+      render(response.hits);
+    } catch (error) {
+      if (error instanceof DOMException && error.name === 'AbortError') return;
+      if (error instanceof DialogSearchError) renderError(error.message);
+      else throw error;
+    }
+  }, 200);
+};
+```
+
 - Handler for fetch product
 
 The `getProduct` callback is called by the assistant to display product information. You must return an object matching the `SimplifiedProduct` interface.

package/dist/Dialog.d.ts

@@ -2,16 +2,17 @@ import { DialogConstructor } from "./types/constructor";
 import { Theme } from "./types/theme";
 import { DetailedLocaleInfo } from "./utils/localization";
 import { Suggestion } from "./types/suggestion";
-import { GenericQuestionPayload, LegacyCheckoutParams, OpenAssistantPayload, ProductQuestionPayload, SubmitCheckoutParams } from "./types/events";
+import { AddToCartInput, GenericQuestionPayload, LegacyCheckoutParams, OpenAssistantPayload, ProductQuestionPayload, SubmitCheckoutParams } from "./types/events";
 import { SimplifiedProduct } from "./types/product";
 import { EventsHandler } from "./EventsHandler";
+import { SearchOptions, SearchRequest, SearchResponse } from "./types/search";
 import { AssistantEvent } from "./types/assistantEvent";
 export declare class Dialog {
     static readonly VERSION: string;
     private _apiKey;
     private _locale;
     private _countryCode?;
-    private _callbacks;
+    private _callbacks?;
     private _theme;
     private _userId;
     private _eventsHandler;
@@ -24,6 +25,14 @@ export declare class Dialog {
     getLocalizationInformations(): DetailedLocaleInfo | null;
     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.
+     */
+    search(request: SearchRequest, options?: SearchOptions): Promise<SearchResponse>;
     openAssistant(params: OpenAssistantPayload): void;
     closeAssistant(): void;
     sendProductMessage(params: ProductQuestionPayload): void;
@@ -31,20 +40,9 @@ export declare class Dialog {
     onAssistantEvent(listener: (event: AssistantEvent) => void): void;
     dispatchAssistantEvent(event: AssistantEvent): void;
     getProduct(productId: string, variantId?: string): Promise<SimplifiedProduct>;
-    addToCart({ productId, quantity, currency, variantId, price, }: {
-        productId: string;
-        quantity: number;
-        price?: string;
-        currency?: string;
-        variantId?: string;
-    }): Promise<void>;
-    registerAddToCartEvent({ productId, quantity, currency, variantId, price, }: {
-        productId: string;
-        quantity: number;
-        price?: string;
-        currency?: string;
-        variantId?: string;
-    }): void;
+    addToCart(input: AddToCartInput): Promise<void>;
+    private _getCallbacksOrThrow;
+    registerAddToCartEvent(input: AddToCartInput): void;
     registerSubmitCheckoutEvent(params: SubmitCheckoutParams | LegacyCheckoutParams): void;
     private _loadAssistant;
 }

package/dist/Dialog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Dialog.d.ts","sourceRoot":"","sources":["../src/Dialog.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,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,EAEL,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,oBAAoB,EACrB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,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,CAGhB;IACF,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,cAAc,CAAgB;gBAE1B,EACV,MAAM,EACN,MAAM,EACN,WAAW,EACX,SAAS,EACT,KAAK,EACL,MAAM,GACP,EAAE,iBAAiB;IAYpB,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;IAK5D,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;IAIhB,SAAS,CAAC,EACrB,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,KAAK,GACN,EAAE;QACD,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBV,sBAAsB,CAAC,EAC5B,SAAS,EACT,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,KAAK,GACN,EAAE;QACD,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,IAAI;IAkBD,2BAA2B,CAChC,MAAM,EAAE,oBAAoB,GAAG,oBAAoB,GAClD,IAAI;IA0BP,OAAO,CAAC,cAAc;CA4BvB"}
+{"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,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;gBAE1B,EACV,MAAM,EACN,MAAM,EACN,WAAW,EACX,SAAS,EACT,KAAK,EACL,MAAM,GACP,EAAE,iBAAiB;IAYpB,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,OAAO,CAAC,cAAc;CA4BvB"}

package/dist/Dialog.js

@@ -7,6 +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 { config } from "./config";
 import { exposeSdkOnWindowDialog } from "./windowAudit";
 export class Dialog {
@@ -63,6 +64,16 @@ export class Dialog {
     async getSuggestions(productId) {
         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.
+     */
+    search(request, options) {
+        return searchProducts(this._apiKey, request, options);
+    }
     // TODO: Not yet implemented on assistant
     openAssistant(params) {
         this._eventsHandler.emitExternalEvent(DialogEvents.OPEN_ASSISTANT, params);
@@ -84,33 +95,28 @@ export class Dialog {
         this._eventsHandler.emitAssistantEvent(event.type, event.payload);
     }
     getProduct(productId, variantId) {
-        return this._callbacks.getProduct(productId, variantId);
-    }
-    async addToCart({ productId, quantity, currency, variantId, price, }) {
-        await this._callbacks.addToCart({
-            productId,
-            variantId,
-            quantity,
-            currency,
-            price,
-        });
-        this.registerAddToCartEvent({
-            productId,
-            variantId,
-            quantity,
-            currency,
-            price,
-        });
+        return this._getCallbacksOrThrow("getProduct").getProduct(productId, variantId);
+    }
+    // The full input (including the optional enriched product fields) is
+    // 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) {
+        await this._getCallbacksOrThrow("addToCart").addToCart(input);
+        this.registerAddToCartEvent(input);
         return;
     }
-    registerAddToCartEvent({ productId, quantity, currency, variantId, price, }) {
+    // Callbacks are optional at construction; the two commerce methods assert
+    // theirs at call time with an integration-facing configuration error.
+    _getCallbacksOrThrow(name) {
+        if (this._callbacks?.[name] === undefined) {
+            throw new Error(`Dialog: \`callbacks.${name}\` was not provided to the constructor; ${name}() is unavailable on this instance.`);
+        }
+        return this._callbacks;
+    }
+    registerAddToCartEvent(input) {
         this._eventsHandler.emitExternalEvent(DialogEvents.TRACK_ADD_TO_CART, {
             userId: this._userId,
-            productId,
-            variantId,
-            quantity,
-            price,
-            currency,
+            ...input,
         });
     }
     // Order-level: call ONCE per completed order with the order total.

package/dist/DialogSearchError.d.ts

@@ -0,0 +1,19 @@
+interface DialogSearchErrorParams {
+    status: number;
+    code?: string;
+    message: string;
+}
+/**
+ * Non-2xx answer from the search endpoint. `status` is the HTTP status,
+ * `code` the stable machine-readable error code the API carries when the
+ * body is JSON (e.g. "SEARCH_INDEX_NOT_FOUND"), `message` the API message
+ * or the HTTP statusText when the body is not JSON. Aborts and network
+ * failures are NOT wrapped: they reject with their native errors.
+ */
+export declare class DialogSearchError extends Error {
+    readonly status: number;
+    readonly code?: string;
+    constructor({ status, code, message }: DialogSearchErrorParams);
+}
+export {};
+//# sourceMappingURL=DialogSearchError.d.ts.map

package/dist/DialogSearchError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DialogSearchError.d.ts","sourceRoot":"","sources":["../src/DialogSearchError.ts"],"names":[],"mappings":"AAAA,UAAU,uBAAuB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,IAAI,CAAC,EAAE,MAAM,CAAC;gBAElB,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,uBAAuB;CAM/D"}

package/dist/DialogSearchError.js

@@ -0,0 +1,17 @@
+/**
+ * Non-2xx answer from the search endpoint. `status` is the HTTP status,
+ * `code` the stable machine-readable error code the API carries when the
+ * body is JSON (e.g. "SEARCH_INDEX_NOT_FOUND"), `message` the API message
+ * or the HTTP statusText when the body is not JSON. Aborts and network
+ * failures are NOT wrapped: they reject with their native errors.
+ */
+export class DialogSearchError extends Error {
+    status;
+    code;
+    constructor({ status, code, message }) {
+        super(message);
+        this.name = "DialogSearchError";
+        this.status = status;
+        this.code = code;
+    }
+}

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

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

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

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

package/dist/__tests__/dialogAddToCart.spec.js

@@ -0,0 +1,59 @@
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { Dialog } from "../Dialog";
+import { EventsHandler } from "../EventsHandler";
+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 eventsHandler = new EventsHandler("fr", "user-1");
+    const emitExternalEvent = vi.fn();
+    eventsHandler.emitExternalEvent =
+        emitExternalEvent;
+    const dialog = Object.create(Dialog.prototype);
+    Object.assign(dialog, {
+        _callbacks: { addToCart: addToCartCallback, getProduct: vi.fn() },
+        _eventsHandler: eventsHandler,
+        _userId: "user-1",
+    });
+    return { dialog, emitExternalEvent };
+};
+const enrichedInput = {
+    productId: "gid://shopify/Product/42",
+    variantId: "gid://shopify/ProductVariant/4242",
+    quantity: 2,
+    price: "19.90",
+    currency: "EUR",
+    productTitle: "Suggested product",
+    variantTitle: "50ml",
+    productUrl: "https://shop.example/products/suggested",
+    pageProductId: "gid://shopify/Product/1",
+    pageVariantId: "gid://shopify/ProductVariant/11",
+};
+afterEach(() => {
+    vi.clearAllMocks();
+});
+describe("Dialog.addToCart", () => {
+    it("forwards the full enriched input to the merchant callback", async () => {
+        const addToCartCallback = vi.fn().mockResolvedValue(undefined);
+        const { dialog } = buildDialog(addToCartCallback);
+        await dialog.addToCart(enrichedInput);
+        expect(addToCartCallback).toHaveBeenCalledWith(enrichedInput);
+    });
+    it("emits TRACK_ADD_TO_CART with the enriched fields and the userId", async () => {
+        const { dialog, emitExternalEvent } = buildDialog(vi.fn().mockResolvedValue(undefined));
+        await dialog.addToCart(enrichedInput);
+        expect(emitExternalEvent).toHaveBeenCalledWith(DialogEvents.TRACK_ADD_TO_CART, { userId: "user-1", ...enrichedInput });
+    });
+    it("keeps working with the legacy minimal input", async () => {
+        const addToCartCallback = vi.fn().mockResolvedValue(undefined);
+        const { dialog, emitExternalEvent } = buildDialog(addToCartCallback);
+        const legacyInput = {
+            productId: "gid://shopify/Product/42",
+            quantity: 1,
+        };
+        await dialog.addToCart(legacyInput);
+        expect(addToCartCallback).toHaveBeenCalledWith(legacyInput);
+        expect(emitExternalEvent).toHaveBeenCalledWith(DialogEvents.TRACK_ADD_TO_CART, { userId: "user-1", ...legacyInput });
+    });
+});

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

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

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

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

package/dist/__tests__/dialogCallbacks.spec.js

@@ -0,0 +1,40 @@
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { Dialog } from "../Dialog";
+// The full Dialog constructor loads the assistant into the DOM; these tests
+// only exercise the callback plumbing, so the instance is built from the
+// prototype with just the fields the tested methods read.
+const buildDialog = (callbacks) => {
+    const dialog = Object.create(Dialog.prototype);
+    Object.assign(dialog, { _callbacks: callbacks });
+    return dialog;
+};
+afterEach(() => {
+    vi.clearAllMocks();
+});
+describe("Dialog without commerce callbacks", () => {
+    it("throws an explicit configuration error from getProduct()", async () => {
+        const dialog = buildDialog(undefined);
+        expect(() => dialog.getProduct("product-1")).toThrowError(/callbacks\.getProduct/);
+    });
+    it("throws an explicit configuration error from addToCart()", async () => {
+        const dialog = buildDialog(undefined);
+        await expect(dialog.addToCart({
+            productId: "product-1",
+            variantId: "variant-1",
+            quantity: 1,
+        })).rejects.toThrowError(/callbacks\.addToCart/);
+    });
+    it("throws when only the other callback was provided", () => {
+        const dialog = buildDialog({ addToCart: vi.fn() });
+        expect(() => dialog.getProduct("product-1")).toThrowError(/callbacks\.getProduct/);
+    });
+});
+describe("Dialog with commerce callbacks (historical construction)", () => {
+    it("keeps forwarding getProduct() to the merchant callback", async () => {
+        const product = { id: "product-1" };
+        const getProduct = vi.fn().mockResolvedValue(product);
+        const dialog = buildDialog({ getProduct });
+        await expect(dialog.getProduct("product-1", "variant-1")).resolves.toBe(product);
+        expect(getProduct).toHaveBeenCalledWith("product-1", "variant-1");
+    });
+});

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

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

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

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

package/dist/__tests__/publicTypes.spec.js

@@ -0,0 +1,21 @@
+// Compile-time contract of the public API: these assertions are checked by
+// `tsc` (test-type), the runtime test only anchors the file in the suite.
+import { describe, expect, expectTypeOf, it } from "vitest";
+import { DialogSearchError, } from "../index";
+describe("public API types", () => {
+    it("accepts construction with and without commerce callbacks", () => {
+        expectTypeOf().toMatchTypeOf();
+        expectTypeOf().toMatchTypeOf();
+        // Invalid callback values must be rejected.
+        expectTypeOf().not.toMatchTypeOf();
+        expectTypeOf().parameters.toMatchTypeOf();
+        expectTypeOf().returns.resolves.toEqualTypeOf();
+        expectTypeOf().toEqualTypeOf();
+        expectTypeOf().toEqualTypeOf();
+        expectTypeOf().toMatchTypeOf();
+        const error = new DialogSearchError({ status: 404, message: "not found" });
+        expectTypeOf(error.status).toEqualTypeOf();
+        expectTypeOf(error.code).toEqualTypeOf();
+        expect(error.name).toBe("DialogSearchError");
+    });
+});

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

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

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

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

package/dist/__tests__/searchService.spec.js

@@ -0,0 +1,111 @@
+import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
+import { DialogSearchError } from "../DialogSearchError";
+import { searchProducts } from "../services/search";
+const API_KEY = "pk_test_abcdef";
+const emptyResponse = {
+    queryId: "0198c3f2-0000-7000-8000-000000000000",
+    hits: [],
+    nbHits: 0,
+    page: 0,
+    nbPages: 0,
+    hitsPerPage: 20,
+    processingTimeMs: 3,
+    query: "running shoes",
+};
+const jsonResponse = (body, status = 200) => new Response(JSON.stringify(body), {
+    status,
+    headers: { "Content-Type": "application/json" },
+});
+const fetchMock = vi.fn();
+beforeEach(() => {
+    vi.stubGlobal("fetch", fetchMock);
+});
+afterEach(() => {
+    vi.unstubAllGlobals();
+    vi.clearAllMocks();
+});
+describe("searchProducts", () => {
+    it("POSTs the exact request to /public/search with only the api key header", async () => {
+        fetchMock.mockResolvedValue(jsonResponse(emptyResponse));
+        await searchProducts(API_KEY, {
+            query: "running shoes",
+            page: 2,
+            hitsPerPage: 50,
+        });
+        expect(fetchMock).toHaveBeenCalledTimes(1);
+        const [url, init] = fetchMock.mock.calls[0];
+        expect(url).toMatch(/\/public\/search$/);
+        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,
+        });
+    });
+    it("omits pagination fields the caller did not provide", async () => {
+        fetchMock.mockResolvedValue(jsonResponse(emptyResponse));
+        await searchProducts(API_KEY, { query: "running shoes" });
+        const [, init] = fetchMock.mock.calls[0];
+        expect(JSON.parse(init.body)).toEqual({
+            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);
+    });
+    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);
+        expect(error).toBeInstanceOf(DialogSearchError);
+        expect(error).toMatchObject({
+            name: "DialogSearchError",
+            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);
+        expect(error).toBeInstanceOf(DialogSearchError);
+        expect(error).toMatchObject({
+            status: 502,
+            code: undefined,
+            message: "Bad Gateway",
+        });
+    });
+    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);
+    });
+    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);
+        const [, init] = fetchMock.mock.calls[0];
+        expect(init.signal).toBe(controller.signal);
+    });
+});

package/dist/config/config.development.d.ts

@@ -1,5 +1,6 @@
 export declare const config: {
     baseApiUrl: string;
+    monolithApiUrl: string;
     assistantUrl: string;
 };
 export type Config = typeof config;

package/dist/config/config.development.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.development.d.ts","sourceRoot":"","sources":["../../src/config/config.development.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM;;;CAGlB,CAAC;AACF,MAAM,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC"}
+{"version":3,"file":"config.development.d.ts","sourceRoot":"","sources":["../../src/config/config.development.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM;;;;CAKlB,CAAC;AACF,MAAM,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC"}

package/dist/config/config.development.js

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

package/dist/config/config.production.d.ts

@@ -1,5 +1,6 @@
 export declare const config: {
     baseApiUrl: string;
+    monolithApiUrl: string;
     assistantUrl: string;
 };
 export type Config = typeof config;

package/dist/config/config.production.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.production.d.ts","sourceRoot":"","sources":["../../src/config/config.production.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM;;;CAGlB,CAAC;AACF,MAAM,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC"}
+{"version":3,"file":"config.production.d.ts","sourceRoot":"","sources":["../../src/config/config.production.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM;;;;CAKlB,CAAC;AACF,MAAM,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC"}

package/dist/config/config.production.js

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

package/dist/config/index.d.ts

@@ -1,5 +1,6 @@
 export declare const config: {
     baseApiUrl: string;
+    monolithApiUrl: string;
     assistantUrl: string;
 };
 export type Config = typeof config;

package/dist/config/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM;;;CAGlB,CAAC;AACF,MAAM,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM;;;;CAKlB,CAAC;AACF,MAAM,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC"}

package/dist/config/index.js

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

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from "./Dialog";
+export * from "./DialogSearchError";
 export * from "./EventsHandler";
 export * from "./types";
 export * from "./windowAudit";

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,iBAAiB,CAAC;AAChC,cAAc,SAAS,CAAC;AACxB,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,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -1,4 +1,5 @@
 export * from "./Dialog";
+export * from "./DialogSearchError";
 export * from "./EventsHandler";
 export * from "./types";
 export * from "./windowAudit";

package/dist/services/search.d.ts

@@ -0,0 +1,7 @@
+import { SearchOptions, SearchRequest, SearchResponse } from "../types/search";
+/**
+ * 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>;
+//# sourceMappingURL=search.d.ts.map

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

@@ -0,0 +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"}

package/dist/services/search.js

@@ -0,0 +1,37 @@
+import { config } from "../config";
+import { DialogSearchError } from "../DialogSearchError";
+const SEARCH_PATH = "/public/search";
+const API_KEY_HEADER = "x-dialog-api-key";
+const toSearchError = async (response) => {
+    let body;
+    try {
+        body = (await response.json());
+    }
+    catch {
+        body = undefined;
+    }
+    const code = typeof body?.error === "string" ? body.error : undefined;
+    const message = typeof body?.message === "string" && body.message.length > 0
+        ? body.message
+        : response.statusText;
+    return new DialogSearchError({ status: response.status, code, message });
+};
+/**
+ * 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) => {
+    const response = await fetch(`${config.monolithApiUrl}${SEARCH_PATH}`, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            [API_KEY_HEADER]: apiKey,
+        },
+        body: JSON.stringify(request),
+        signal: options?.signal,
+    });
+    if (!response.ok) {
+        throw await toSearchError(response);
+    }
+    return (await response.json());
+};

package/dist/types/assistantEvent.d.ts

@@ -18,6 +18,14 @@ export interface GenericAssistantEventPayload {
     userId?: string;
     productId?: string;
     variantId?: string;
+    quantity?: number;
+    price?: string;
+    currency?: string;
+    productTitle?: string;
+    variantTitle?: string;
+    productUrl?: string;
+    pageProductId?: string;
+    pageVariantId?: string;
 }
 export type AssistantEventPayload = GenericAssistantEventPayload;
 export interface AssistantEvent<T = AssistantEventPayload> {

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

@@ -1 +1 @@
-{"version":3,"file":"assistantEvent.d.ts","sourceRoot":"","sources":["../../src/types/assistantEvent.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB,yBAAyB,CAAC;AAE7D,oBAAY,eAAe;IACzB,qBAAqB,wBAAwB;IAC7C,qBAAqB,wBAAwB;IAC7C,iBAAiB,oBAAoB;IACrC,4BAA4B,6BAA6B;IACzD,0BAA0B,6BAA6B;IACvD,kBAAkB,oBAAoB;IACtC,2BAA2B,6BAA6B;IACxD,2BAA2B,6BAA6B;CACzD;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,4BAA4B;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,qBAAqB,GAAG,4BAA4B,CAAC;AAEjE,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,qBAAqB;IACvD,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,CAAC,CAAC;CACZ"}
+{"version":3,"file":"assistantEvent.d.ts","sourceRoot":"","sources":["../../src/types/assistantEvent.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB,yBAAyB,CAAC;AAE7D,oBAAY,eAAe;IACzB,qBAAqB,wBAAwB;IAC7C,qBAAqB,wBAAwB;IAC7C,iBAAiB,oBAAoB;IACrC,4BAA4B,6BAA6B;IACzD,0BAA0B,6BAA6B;IACvD,kBAAkB,oBAAoB;IACtC,2BAA2B,6BAA6B;IACxD,2BAA2B,6BAA6B;CACzD;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb;AAKD,MAAM,WAAW,4BAA4B;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,qBAAqB,GAAG,4BAA4B,CAAC;AAEjE,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,qBAAqB;IACvD,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,CAAC,CAAC;CACZ"}

package/dist/types/constructor.d.ts

@@ -1,5 +1,10 @@
+import { AddToCartInput } from "./events";
 import { SimplifiedProduct } from "./product";
 import { Theme } from "./theme";
+export interface DialogCallbacks {
+    addToCart: (input: AddToCartInput) => Promise<void>;
+    getProduct: (productId: string, variantId?: string) => Promise<SimplifiedProduct>;
+}
 export interface DialogConstructor {
     apiKey: string;
     locale: string;
@@ -9,16 +14,12 @@ export interface DialogConstructor {
      * Omit it to keep deriving the country from the locale (backward compatible).
      */
     countryCode?: string;
-    callbacks: {
-        addToCart: ({ productId, quantity, price, variantId, currency, }: {
-            productId: string;
-            quantity: number;
-            price?: string;
-            variantId?: string;
-            currency?: string;
-        }) => Promise<void>;
-        getProduct: (productId: string, variantId?: string) => Promise<SimplifiedProduct>;
-    };
+    /**
+     * Commerce callbacks. Optional: a search-only integration can omit them —
+     * the assistant runtime still loads, and only `getProduct()` / `addToCart()`
+     * throw a configuration error when their callback is absent.
+     */
+    callbacks?: DialogCallbacks;
     theme?: Partial<Theme>;
     userId?: string;
 }

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,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE;QACT,SAAS,EAAE,CAAC,EACV,SAAS,EACT,QAAQ,EACR,KAAK,EACL,SAAS,EACT,QAAQ,GACT,EAAE;YACD,SAAS,EAAE,MAAM,CAAC;YAClB,QAAQ,EAAE,MAAM,CAAC;YACjB,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;SACnB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;QACpB,UAAU,EAAE,CACV,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,KACf,OAAO,CAAC,iBAAiB,CAAC,CAAC;KACjC,CAAC;IACF,KAAK,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}
+{"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;CACjB"}

package/dist/types/events.d.ts

@@ -34,7 +34,21 @@ export interface DiagnosticPayload {
     buttonType: DiagnosticButtonType;
     url: string;
 }
-export interface TrackEventPayload {
+export interface AddToCartProductDetails {
+    productTitle?: string;
+    variantTitle?: string;
+    productUrl?: string;
+    pageProductId?: string;
+    pageVariantId?: string;
+}
+export interface AddToCartInput extends AddToCartProductDetails {
+    productId: string;
+    quantity: number;
+    price?: string;
+    currency?: string;
+    variantId?: string;
+}
+export interface TrackEventPayload extends AddToCartProductDetails {
     userId?: string;
     productId: string;
     variantId?: string;

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

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/types/events.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,+BAA+B,CAAC;AAEhE,oBAAY,YAAY;IACtB,cAAc,mBAAmB;IACjC,eAAe,oBAAoB;IACnC,YAAY,qBAAqB;IACjC,qBAAqB,qBAAqB;IAC1C,iBAAiB,sBAAsB;IACvC,qBAAqB,0BAA0B;CAChD;AACD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,MAAM,CAAC;CAClB;AACD,MAAM,WAAW,sBAAuB,SAAQ,sBAAsB;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,MAAM,oBAAoB,GAAG,mBAAmB,GAAG,cAAc,CAAC;AAExE,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,oBAAoB,CAAC;IACjC,GAAG,EAAE,MAAM,CAAC;CACb;AAQD,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAKD,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAOD,MAAM,WAAW,0BAA0B;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC5B;AAGD,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC5B;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,kBAAkB,GAC1B,sBAAsB,GACtB,sBAAsB,GACtB,iBAAiB,GACjB,oBAAoB,GACpB,iBAAiB,GACjB,0BAA0B,CAAC;AAE/B,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,kBAAkB;IACjD,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,CAAC,CAAC;CACZ"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/types/events.ts"],"names":[],"mappings":"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"}

package/dist/types/index.d.ts

@@ -3,5 +3,6 @@ export * from "./product";
 export * from "./suggestion";
 export * from "./theme";
 export * from "./constructor";
+export * from "./search";
 export * from "./assistantEvent";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,kBAAkB,CAAC"}

package/dist/types/index.js

@@ -3,4 +3,5 @@ export * from "./product";
 export * from "./suggestion";
 export * from "./theme";
 export * from "./constructor";
+export * from "./search";
 export * from "./assistantEvent";

package/dist/types/search.d.ts

@@ -0,0 +1,50 @@
+export interface SearchRequest {
+    /** 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;
+}
+export interface SearchOptions {
+    /** Forwarded to fetch untouched: aborting rejects with the native AbortError. */
+    signal?: AbortSignal;
+}
+export interface SearchPrice {
+    /** Decimal amount as a string, exactly as indexed (e.g. "24.90"). */
+    amount: string;
+    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.
+ */
+export interface SearchProduct {
+    id: string;
+    title?: string;
+    url?: string;
+    imageUrl?: string;
+    priceRange?: SearchPriceRange;
+    inStock?: boolean;
+}
+export interface SearchHit {
+    id: string;
+    score: number;
+    product: SearchProduct;
+}
+export interface SearchResponse {
+    /** Nest-generated id for search attribution analytics. */
+    queryId: string;
+    hits: SearchHit[];
+    nbHits: number;
+    page: number;
+    nbPages: number;
+    hitsPerPage: number;
+    processingTimeMs: number;
+    query: string;
+}
+//# sourceMappingURL=search.d.ts.map

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

@@ -0,0 +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;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,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,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,0DAA0D;IAC1D,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"}

package/dist/types/search.js

@@ -0,0 +1,4 @@
+// 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 {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@askdialog/dialog-sdk",
-  "version": "2.3.0",
+  "version": "2.4.0",
   "private": false,
   "description": "Dialog SDK",
   "main": "dist/index.js",
@@ -26,6 +26,7 @@
   "author": "Dialog",
   "license": "MIT",
   "devDependencies": {
+    "@vitest/coverage-v8": "^3.0.0",
     "esbuild": "^0.25.12",
     "eslint-import-resolver-typescript": "^4.4.4",
     "eslint-plugin-import": "^2.32.0",
@@ -46,7 +47,10 @@
     "lint": "eslint .",
     "lint:fix": "eslint . --fix",
     "test": "vitest run",
+    "test-coverage": "vitest run --coverage",
+    "test-linter": "eslint .",
     "test-type": "tsc --noEmit",
+    "smoke": "chmod +x scripts/smoke.sh && ./scripts/smoke.sh",
     "link": "pnpm link --global",
     "unlink": "pnpm unlink",
     "watch": "tsc --watch",