@askdialog/dialog-sdk 2.11.0 → 2.13.0

package/dist/__tests__/searchController.spec.js

@@ -1,4 +1,4 @@
-/* eslint max-lines: ["error", 460] */
+/* eslint max-lines: ["error", 490] */
 import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { createSearchController } from "../searchController";
 import { SearchStatus } from "../types/searchController";
@@ -15,7 +15,7 @@ const DEBOUNCE_MS = 250;
 const response = (overrides = {}) => ({
     results: [
         {
-            index: "products_fr",
+            index: "products_fr_eur",
             hits: [{ objectID: "p1" }, { objectID: "p2" }],
             nbHits: 2,
             page: 0,
@@ -37,7 +37,7 @@ const deferred = () => {
     });
     return { promise, resolve, reject };
 };
-// Lets the controller's `await search(...)` continuation run.
+// Flush the search promise continuation.
 const settle = async () => {
     await Promise.resolve();
     await Promise.resolve();
@@ -49,12 +49,13 @@ const states = [];
 const createController = () => {
     const controller = createSearchController({
         search,
+        language: "fr",
+        currency: "EUR",
         analytics: {
             surface: "search_page",
             trackViewSearchResults,
             trackSelectSearchResult,
         },
-        locale: "fr",
     });
     controller.subscribe((state) => states.push(state));
     return controller;
@@ -93,22 +94,28 @@ describe("createSearchController", () => {
         });
         expect(controller.getState().status).toBe(SearchStatus.SUCCESS);
     });
-    it("sends one products entry named after the bare-language locale", async () => {
+    it("sends one products entry with independent language and currency", async () => {
         const controller = createSearchController({
             search,
+            language: "fr",
+            currency: "USD",
             analytics: {
                 surface: "search_page",
                 trackViewSearchResults,
                 trackSelectSearchResult,
             },
-            locale: "fr-FR",
         });
-        search.mockResolvedValue(response({ query: "shoes" }));
+        search.mockResolvedValue(response({ query: "shoes", index: "products_fr_usd" }));
         controller.submit("shoes");
         await settle();
         expect(search.mock.calls[0][0]).toEqual({
             requests: [
-                { indexName: "products_fr", query: "shoes", page: 0, hitsPerPage: 12 },
+                {
+                    indexName: "products_fr_usd",
+                    query: "shoes",
+                    page: 0,
+                    hitsPerPage: 12,
+                },
             ],
         });
         controller.dispose();
@@ -125,7 +132,7 @@ describe("createSearchController", () => {
         });
         expect(controller.getState().status).toBe(SearchStatus.SUCCESS);
     });
-    it("aborts the previous in-flight request when a new one starts", async () => {
+    it("invalidates the previous request as soon as new input is queued", async () => {
         const controller = createController();
         const first = deferred();
         const second = deferred();
@@ -134,8 +141,14 @@ describe("createSearchController", () => {
             .mockReturnValueOnce(second.promise);
         controller.submit("shoes");
         const firstSignal = search.mock.calls[0][1]?.signal;
-        controller.submit("boots");
+        controller.setQuery("boots");
+        first.resolve(response({ query: "shoes" }));
+        await settle();
         expect(firstSignal?.aborted).toBe(true);
+        expect(search).toHaveBeenCalledTimes(1);
+        expect(controller.getState().response).toBeUndefined();
+        expect(controller.getState().status).toBe(SearchStatus.LOADING);
+        vi.advanceTimersByTime(DEBOUNCE_MS);
         second.resolve(response({ query: "boots", queryID: "qid-2" }));
         await settle();
         expect(controller.getState().response?.query).toBe("boots");
@@ -151,7 +164,7 @@ describe("createSearchController", () => {
         controller.submit("boots");
         fresh.resolve(response({ query: "boots", queryID: "qid-2" }));
         await settle();
-        // The stale transport ignored the abort and answers after the fresh one.
+        // Simulate a late response from a transport that ignores cancellation.
         stale.resolve(response({ query: "shoes", queryID: "qid-1" }));
         await settle();
         expect(controller.getState().status).toBe(SearchStatus.SUCCESS);
@@ -291,42 +304,54 @@ describe("createSearchController", () => {
     it("requests the sections on their first page with the products and exposes their entries", async () => {
         const controller = createSearchController({
             search,
+            language: "fr",
+            currency: "USD",
             analytics: {
                 surface: "search_page",
                 trackViewSearchResults,
                 trackSelectSearchResult,
             },
-            locale: "fr",
             sections: [{ index: "collections", hitsPerPage: 5 }],
         });
         const collections = {
             ...response().results[0],
-            index: "collections_fr",
+            index: "collections_fr_usd",
             hits: [{ objectID: "c1" }],
             nbHits: 1,
         };
         search.mockResolvedValueOnce({
-            results: [...response().results, collections],
+            results: [...response({ index: "products_fr_usd" }).results, collections],
         });
         controller.submit("shoes");
         await settle();
         expect(search.mock.calls[0][0].requests).toEqual([
-            { indexName: "products_fr", query: "shoes", page: 0, hitsPerPage: 12 },
-            { indexName: "collections_fr", query: "shoes", page: 0, hitsPerPage: 5 },
+            {
+                indexName: "products_fr_usd",
+                query: "shoes",
+                page: 0,
+                hitsPerPage: 12,
+            },
+            {
+                indexName: "collections_fr_usd",
+                query: "shoes",
+                page: 0,
+                hitsPerPage: 5,
+            },
         ]);
-        expect(controller.getState().response?.index).toBe("products_fr");
+        expect(controller.getState().response?.index).toBe("products_fr_usd");
         expect(controller.getState().sections).toEqual({ collections });
     });
     it("resolves a sections function per request and leaves a missing entry out", async () => {
         let enabled = false;
         const controller = createSearchController({
             search,
+            language: "fr",
+            currency: "EUR",
             analytics: {
                 surface: "search_page",
                 trackViewSearchResults,
                 trackSelectSearchResult,
             },
-            locale: "fr",
             sections: () => (enabled ? [{ index: "collections" }] : []),
         });
         search.mockResolvedValue(response());
@@ -338,7 +363,7 @@ describe("createSearchController", () => {
         expect(search.mock.calls[0][0].requests).toHaveLength(1);
         expect(search.mock.calls[1][0].requests).toHaveLength(2);
         expect(search.mock.calls[1][0].requests[1]).toMatchObject({
-            indexName: "collections_fr",
+            indexName: "collections_fr_eur",
             hitsPerPage: 12,
         });
         expect(controller.getState().sections).toEqual({});
@@ -347,12 +372,13 @@ describe("createSearchController", () => {
         const failure = new Error("entitlement lookup failed");
         const controller = createSearchController({
             search,
+            language: "fr",
+            currency: "EUR",
             analytics: {
                 surface: "search_page",
                 trackViewSearchResults,
                 trackSelectSearchResult,
             },
-            locale: "fr",
             sections: () => {
                 throw failure;
             },

package/dist/__tests__/searchControllerAttribution.spec.js

@@ -14,7 +14,7 @@ vi.mock("../utils/searchImpressions", () => ({
 const response = (overrides = {}) => ({
     results: [
         {
-            index: "products_fr",
+            index: "products_fr_eur",
             hits: [
                 { objectID: "p1", url: "https://shop.example/p1" },
                 { objectID: "p2" },
@@ -36,13 +36,14 @@ const trackSelectSearchResult = vi.fn();
 const navigate = vi.fn();
 const createController = () => createSearchController({
     search,
+    language: "fr",
+    currency: "EUR",
     analytics: {
         surface: "search_page",
         trackViewSearchResults,
         trackSelectSearchResult,
     },
     navigate,
-    locale: "fr",
 });
 beforeEach(() => {
     vi.useFakeTimers();
@@ -75,7 +76,7 @@ describe("search controller attribution", () => {
         await settle();
         expect(tracker.setContext).toHaveBeenCalledWith({
             query_id: "qid-1",
-            index: "products_fr",
+            index: "products_fr_eur",
             surface: "search_page",
             search_type: "lexical",
             page: 2,
@@ -105,7 +106,7 @@ describe("search controller attribution", () => {
         await settle();
         expect(trackViewSearchResults).toHaveBeenCalledWith({
             query_id: "qid-1",
-            index: "products_fr",
+            index: "products_fr_eur",
             surface: "search_page",
             search_type: "lexical",
             page: 1,
@@ -151,7 +152,7 @@ describe("search controller attribution", () => {
         });
         expect(trackSelectSearchResult).toHaveBeenCalledWith({
             query_id: "qid-1",
-            index: "products_fr",
+            index: "products_fr_eur",
             surface: "search_page",
             search_type: "lexical",
             page: 1,
@@ -201,12 +202,13 @@ describe("search controller attribution", () => {
     it("returns false when no navigate adapter is configured", async () => {
         const controller = createSearchController({
             search,
+            language: "fr",
+            currency: "EUR",
             analytics: {
                 surface: "search_page",
                 trackViewSearchResults,
                 trackSelectSearchResult,
             },
-            locale: "fr",
         });
         search.mockResolvedValue(response());
         controller.submit("shoes");

package/dist/__tests__/searchImpressions.spec.js

@@ -3,7 +3,7 @@ import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
 import { createSearchImpressionTracker } from "../utils/searchImpressions";
 const envelope = {
     query_id: "query-1",
-    index: "products_fr",
+    index: "products_fr_eur",
     surface: "search_page",
     search_type: "lexical",
     page: 1,
@@ -184,8 +184,7 @@ describe("createSearchImpressionTracker", () => {
         vi.advanceTimersByTime(300);
         windowListeners.get("pageshow")?.({ persisted: true });
         intersect(card, 0.6);
-        // A stale pre-restore timer (200ms left) would record at 200ms and flush
-        // at 1700ms; a fresh dwell records at 500ms and flushes at 2000ms.
+        // Fresh dwell: record at 500ms and flush at 2000ms, not at 200ms and 1700ms.
         vi.advanceTimersByTime(1700);
         expect(emit).not.toHaveBeenCalled();
         vi.advanceTimersByTime(300);

package/dist/__tests__/searchService.spec.js

@@ -5,7 +5,7 @@ const API_KEY = "pk_test_abcdef";
 const request = {
     requests: [
         {
-            indexName: "products_fr",
+            indexName: "products_fr_eur",
             query: "running shoes",
             page: 2,
             hitsPerPage: 50,
@@ -15,7 +15,7 @@ const request = {
 const emptyResponse = {
     results: [
         {
-            index: "products_fr",
+            index: "products_fr_eur",
             hits: [],
             nbHits: 0,
             page: 0,
@@ -41,15 +41,17 @@ afterEach(() => {
 });
 describe("searchIndexName", () => {
     it.each([
-        ["fr-FR", "products_fr"],
-        ["pt-BR", "products_pt"],
-        ["fr", "products_fr"],
-        ["not a locale", "products_not a locale"],
-    ])("reduces the locale %s to a bare-language index name", (locale, name) => {
-        expect(searchIndexName("products", locale)).toBe(name);
+        ["fr", "EUR", "products_fr_eur"],
+        ["pt", "BRL", "products_pt_brl"],
+        ["fr", "CAD", "products_fr_cad"],
+        ["en", "EUR", "products_en_eur"],
+    ])("builds an index name from language %s and currency", (locale, currency, name) => {
+        expect(searchIndexName("products", locale, currency)).toBe(name);
     });
     it("names every logical index", () => {
-        expect(searchIndexName("collections", "en-US")).toBe("collections_en");
+        expect(searchIndexName("collections", "en", "USD")).toBe("collections_en_usd");
+        expect(() => searchIndexName("products", "fr-FR", "EUR")).toThrow(/ISO 639-1/);
+        expect(() => searchIndexName("products", "fr", "")).toThrow(/ISO 4217/);
     });
 });
 describe("searchLexical", () => {
@@ -69,11 +71,11 @@ describe("searchLexical", () => {
     it("keeps optional per-entry fields the caller did not provide off the wire", async () => {
         fetchMock.mockResolvedValue(jsonResponse(emptyResponse));
         await searchLexical(API_KEY, {
-            requests: [{ indexName: "products_fr", query: "running shoes" }],
+            requests: [{ indexName: "products_fr_eur", query: "running shoes" }],
         });
         const [, init] = fetchMock.mock.calls[0];
         expect(JSON.parse(init.body)).toEqual({
-            requests: [{ indexName: "products_fr", query: "running shoes" }],
+            requests: [{ indexName: "products_fr_eur", query: "running shoes" }],
         });
     });
     it("resolves the typed response, including empty results", async () => {

package/dist/searchController.d.ts

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

package/dist/searchController.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"searchController.d.ts","sourceRoot":"","sources":["../src/searchController.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EAIxB,MAAM,0BAA0B,CAAC;AAqBlC,wBAAgB,sBAAsB,CAAC,EACrC,MAAM,EACN,SAAS,EACT,QAAQ,EACR,UAAgC,EAChC,WAAmC,EACnC,MAAM,EACN,QAAa,GACd,EAAE,uBAAuB,GAAG,gBAAgB,CA6L5C"}
+{"version":3,"file":"searchController.d.ts","sourceRoot":"","sources":["../src/searchController.ts"],"names":[],"mappings":"AACA,OAAO,EACL,gBAAgB,EAChB,uBAAuB,EAGxB,MAAM,0BAA0B,CAAC;AAiBlC,wBAAgB,sBAAsB,CAAC,EACrC,MAAM,EACN,QAAQ,EACR,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,UAAgB,EAChB,WAAgB,EAChB,QAAa,GACd,EAAE,uBAAuB,GAAG,gBAAgB,CAuK5C"}

package/dist/searchController.js

@@ -1,16 +1,7 @@
-// This controller is one cohesive unit: `selectResult` reports whether the
-// navigate adapter handled the transition and the response is split into the
-// products entry plus its sections, pushing the file past the default 200-line
-// cap — raised modestly rather than split artificially.
-/* eslint max-lines: ["error", 240] */
 import { searchIndexName } from "./services/search";
 import { SearchStatus, } from "./types/searchController";
 import { createControllerAnalytics } from "./utils/searchControllerAnalytics";
-import { buildSectionQueries, pickSectionResults, } from "./utils/searchSections";
-const DEFAULT_DEBOUNCE_MS = 250;
-const DEFAULT_HITS_PER_PAGE = 12;
-// `SearchRequest` rejects queries under two visible characters (code points).
-const MIN_QUERY_CODE_POINTS = 2;
+import { buildSearchRequest, normalizeQuery, readSearchResults, } from "./utils/searchRequests";
 const INITIAL_STATE = {
     status: SearchStatus.IDLE,
     query: "",
@@ -19,18 +10,19 @@ const INITIAL_STATE = {
     sections: undefined,
     error: undefined,
 };
-export function createSearchController({ search, analytics, navigate, debounceMs = DEFAULT_DEBOUNCE_MS, hitsPerPage = DEFAULT_HITS_PER_PAGE, locale, sections = [], }) {
-    const indexName = searchIndexName("products", locale);
-    const resolveSections = () => typeof sections === "function" ? sections() : sections;
+export function createSearchController({ search, language, currency, analytics, navigate, debounceMs = 250, hitsPerPage = 12, sections = [], }) {
+    const requestConfig = {
+        indexName: searchIndexName("products", language, currency),
+        language,
+        currency,
+        hitsPerPage,
+    };
     let state = INITIAL_STATE;
     const listeners = new Set();
     const controllerAnalytics = createControllerAnalytics(analytics);
     let debounceTimer;
-    // Query typed but not yet run: `state.query` only holds committed queries, so
-    // without this, `setPage()` would cancel the debounce and paginate stale results.
     let pendingQuery;
     let abortController;
-    // Monotonic token: a response only lands if it belongs to the latest request.
     let requestId = 0;
     let disposed = false;
     const setState = (patch) => {
@@ -39,45 +31,40 @@ export function createSearchController({ search, analytics, navigate, debounceMs
             listener(state);
         }
     };
-    const cancelInFlight = () => {
+    const cancelPendingSearch = () => {
         clearTimeout(debounceTimer);
+        pendingQuery = undefined;
+        requestId += 1;
         abortController?.abort();
         abortController = undefined;
     };
-    const buildRequest = (query, page, requested) => ({
-        requests: [
-            { indexName, query, page, hitsPerPage },
-            ...buildSectionQueries(requested, query, locale, hitsPerPage),
-        ],
-    });
     const run = async (query, page) => {
-        cancelInFlight();
+        cancelPendingSearch();
         abortController = new AbortController();
-        const id = ++requestId;
+        const id = requestId;
         setState({ status: SearchStatus.LOADING, query, page });
         try {
-            const requested = resolveSections();
-            const response = await search(buildRequest(query, page, requested), {
+            const requested = typeof sections === "function" ? sections() : sections;
+            const request = buildSearchRequest(query, page, requested, requestConfig);
+            const response = await search(request, {
                 signal: abortController.signal,
             });
             if (id !== requestId) {
-                return; // A newer request landed first: this response is stale.
-            }
-            const result = response.results.find((entry) => entry.index === indexName);
-            if (result === undefined) {
-                throw new Error(`Dialog search returned no ${indexName} entry`);
+                return; // Ignore a superseded request.
             }
-            controllerAnalytics.onResponse(result);
+            const results = readSearchResults(response, requested, requestConfig);
+            controllerAnalytics.onResponse(results.response);
             setState({
-                status: result.nbHits === 0 ? SearchStatus.EMPTY : SearchStatus.SUCCESS,
-                response: result,
-                sections: pickSectionResults(response, requested, locale),
+                ...results,
+                status: results.response.nbHits === 0
+                    ? SearchStatus.EMPTY
+                    : SearchStatus.SUCCESS,
                 error: undefined,
             });
         }
         catch (error) {
             if (error instanceof DOMException && error.name === "AbortError") {
-                return; // Superseded by a newer request — never surfaced.
+                return; // Cancellation is not a search error.
             }
             if (id !== requestId) {
                 return;
@@ -90,33 +77,28 @@ export function createSearchController({ search, analytics, navigate, debounceMs
             });
         }
     };
-    // Shared by `setQuery`/`submit`: undefined = reset to idle (query too short).
-    const prepare = (rawQuery) => {
-        const query = rawQuery.trim();
-        cancelInFlight();
-        pendingQuery = undefined;
-        if ([...query].length < MIN_QUERY_CODE_POINTS) {
-            requestId += 1; // Invalidate anything in flight.
-            setState(INITIAL_STATE);
-            return undefined;
-        }
-        return query;
-    };
     return {
         setQuery(rawQuery) {
-            const query = disposed ? undefined : prepare(rawQuery);
+            if (disposed) {
+                return;
+            }
+            cancelPendingSearch();
+            const query = normalizeQuery(rawQuery);
             if (query === undefined) {
+                setState(INITIAL_STATE);
                 return;
             }
             pendingQuery = query;
-            debounceTimer = setTimeout(() => {
-                pendingQuery = undefined;
-                void run(query, 0);
-            }, debounceMs);
+            debounceTimer = setTimeout(() => void run(query, 0), debounceMs);
         },
         submit(rawQuery) {
-            const query = disposed ? undefined : prepare(rawQuery);
+            if (disposed) {
+                return;
+            }
+            cancelPendingSearch();
+            const query = normalizeQuery(rawQuery);
             if (query === undefined) {
+                setState(INITIAL_STATE);
                 return;
             }
             void run(query, 0);
@@ -126,15 +108,12 @@ export function createSearchController({ search, analytics, navigate, debounceMs
                 return;
             }
             if (pendingQuery !== undefined) {
-                // A query change is pending: the click targeted stale results, so the
-                // new query supersedes pagination — flush it now instead of debouncing.
-                const query = pendingQuery;
-                pendingQuery = undefined;
-                void run(query, 0);
+                // Submit pending input on page zero before allowing pagination.
+                void run(pendingQuery, 0);
                 return;
             }
             if (state.query === "") {
-                return; // Pagination requires a committed non-empty query.
+                return; // No query to paginate.
             }
             void run(state.query, page);
         },
@@ -173,9 +152,7 @@ export function createSearchController({ search, analytics, navigate, debounceMs
         getState: () => state,
         dispose() {
             disposed = true;
-            cancelInFlight();
-            requestId += 1;
-            pendingQuery = undefined;
+            cancelPendingSearch();
             listeners.clear();
             controllerAnalytics.dispose();
         },

package/dist/services/search.d.ts

@@ -1,8 +1,6 @@
 import { SearchIndex, SearchOptions, SearchRequest, SearchResponse } from "../types/search";
-export declare const searchIndexName: (index: SearchIndex, locale: string) => string;
-/**
- * One POST per invocation — no debounce, cache, retry or request state; the
- * caller owns cancellation through `options.signal`.
- */
+/** Build an index name from an ISO 639-1 language and ISO 4217 currency. */
+export declare const searchIndexName: (index: SearchIndex, language: string, currency: string) => string;
+/** Send one request. The caller controls cancellation through `options.signal`. */
 export declare const searchLexical: (apiKey: string, request: SearchRequest, options?: SearchOptions) => Promise<SearchResponse>;
 //# sourceMappingURL=search.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/services/search.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,WAAW,EACX,aAAa,EACb,aAAa,EACb,cAAc,EACf,MAAM,iBAAiB,CAAC;AAMzB,eAAO,MAAM,eAAe,GAAI,OAAO,WAAW,EAAE,QAAQ,MAAM,KAAG,MACzB,CAAC;AAoB7C;;;GAGG;AACH,eAAO,MAAM,aAAa,GACxB,QAAQ,MAAM,EACd,SAAS,aAAa,EACtB,UAAU,aAAa,KACtB,OAAO,CAAC,cAAc,CAgBxB,CAAC"}
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/services/search.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,WAAW,EACX,aAAa,EACb,aAAa,EACb,cAAc,EACf,MAAM,iBAAiB,CAAC;AAKzB,4EAA4E;AAC5E,eAAO,MAAM,eAAe,GAC1B,OAAO,WAAW,EAClB,UAAU,MAAM,EAChB,UAAU,MAAM,KACf,MASF,CAAC;AAoBF,mFAAmF;AACnF,eAAO,MAAM,aAAa,GACxB,QAAQ,MAAM,EACd,SAAS,aAAa,EACtB,UAAU,aAAa,KACtB,OAAO,CAAC,cAAc,CAgBxB,CAAC"}

package/dist/services/search.js

@@ -1,9 +1,17 @@
 import { config } from "../config";
 import { DialogSearchError } from "../DialogSearchError";
-import { toIso639LanguageCode } from "../utils/localization";
 const SEARCH_PATH = "/public/search/lexical";
 const API_KEY_HEADER = "x-dialog-api-key";
-export const searchIndexName = (index, locale) => `${index}_${toIso639LanguageCode(locale)}`;
+/** Build an index name from an ISO 639-1 language and ISO 4217 currency. */
+export const searchIndexName = (index, language, currency) => {
+    if (!/^[a-z]{2}$/.test(language)) {
+        throw new Error("Search language must be a lowercase ISO 639-1 code.");
+    }
+    if (!/^[A-Za-z]{3}$/.test(currency)) {
+        throw new Error("Search currency must be an ISO 4217 code.");
+    }
+    return `${index}_${language}_${currency.toLowerCase()}`;
+};
 const toSearchError = async (response) => {
     let body;
     try {
@@ -18,10 +26,7 @@ const toSearchError = async (response) => {
         : 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`.
- */
+/** Send one request. The caller controls cancellation through `options.signal`. */
 export const searchLexical = async (apiKey, request, options) => {
     const response = await fetch(`${config.monolithApiUrl}${SEARCH_PATH}`, {
         method: "POST",

package/dist/types/constructor.d.ts

@@ -1,9 +1,10 @@
-import { AddToCartInput } from "./events";
+import { AddToCartInput, ChangeCartQuantityInput } 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>;
+    changeCartQuantity?: (input: ChangeCartQuantityInput) => Promise<void>;
 }
 export interface CurrentProduct {
     /** The catalog product id — must match the id in the Dialog product feed. */
@@ -12,7 +13,10 @@ export interface CurrentProduct {
 }
 export interface DialogConstructor {
     apiKey: string;
+    /** BCP-47 locale, e.g. `fr-FR`. */
     locale: string;
+    /** Currency (ISO 4217), independent of language. */
+    currency: string;
     /**
      * Optional ISO 3166 country code used to format prices (e.g. 'FR', 'US').
      * When provided it takes precedence over the country derived from `locale`.
@@ -21,8 +25,10 @@ export interface DialogConstructor {
     countryCode?: string;
     /**
      * 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.
+     * the assistant runtime still loads, and `getProduct()`, `addToCart()` and
+     * `changeCartQuantity()` throw a configuration error when their callback is
+     * absent. `changeCartQuantity` is optional within the set: check
+     * `canChangeCartQuantity()` before calling it.
      */
     callbacks?: DialogCallbacks;
     theme?: Partial<Theme>;

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,cAAc;IAC7B,6EAA6E;IAC7E,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;OAIG;IACH,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC;;;;;;;;OAQG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B"}
+{"version":3,"file":"constructor.d.ts","sourceRoot":"","sources":["../../src/types/constructor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AACnE,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;IAChC,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,uBAAuB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACxE;AAED,MAAM,WAAW,cAAc;IAC7B,6EAA6E;IAC7E,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,KAAK,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC;;;;;;;;OAQG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B"}

package/dist/types/events.d.ts

@@ -51,6 +51,11 @@ export interface AddToCartInput extends AddToCartProductDetails {
     currency?: string;
     variantId?: string;
 }
+export interface ChangeCartQuantityInput {
+    productId: string;
+    variantId?: string;
+    quantity: number;
+}
 export interface TrackEventPayload extends AddToCartProductDetails {
     userId?: string;
     productId: string;

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

@@ -1 +1 @@
-{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/types/events.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/types/events.ts"],"names":[],"mappings":"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"}