@askdialog/dialog-sdk 2.0.1 → 2.2.0

package/README.md

@@ -52,6 +52,7 @@ import { Dialog } from '@dialog/dialog-sdk';
 const client = new Dialog({
   apiKey: 'YOUR_API_KEY', // required
   locale: 'TARGETED_LOCALE', // required
+  countryCode: 'FR', // optional, ISO 3166 alpha-2
   callbacks: {
     addToCart: async ({
     productId,
@@ -76,6 +77,13 @@ const client = new Dialog({
 
 The apiKey is required to authenticate with our API and interact with our assistant.
 The locale specifies the language you want to use.
+
+The optional `countryCode` (ISO 3166 alpha-2, e.g. `'FR'`, `'US'`) sets the region used to format prices (separators, symbol placement) and the language variant. It does not change the currency itself, which comes from each product. The effective region is resolved in this order:
+
+1. the `countryCode` parameter, when provided;
+2. the region embedded in `locale` (e.g. `'en-US'` → `US`);
+3. the region guessed from the language (e.g. `'fr'` → `FR`).
+
 The addToCart function is triggered when a user clicks the AddToCart button.
 The getProduct function is used to display product information in the assistant.
 
@@ -330,12 +338,25 @@ client.registerAddToCartEvent({
     price: '12.00' // {string} - Optional
 });
 
+// Checkout is order-level: call ONCE per completed order with the order total.
+// `orderValue` is what the "Revenue generated" dashboard reads.
+// Do NOT call this per line item — without an order total, revenue resolves to 0.
 client.registerSubmitCheckoutEvent({
-    productId: 'ProductIdentifier', // {string} - Required
-    quantity: 1, // {number} - Required
-    price: '12.00', // {string} - Required
+    orderValue: 59.98, // {number} - Required - the order total
     currency: 'EUR', // {string} - Optional
-    variantId: 'VariantIdentifier' // {string} - Optional
+    transactionId: 'OrderIdentifier', // {string} - Optional - order id, used to de-duplicate reloads
+    items: [ // {array} - Optional - line items, for product-level attribution only
+        { productId: 'ProductIdentifier', quantity: 1, price: 29.99, variantId: 'VariantIdentifier' },
+    ],
+});
+
+// Deprecated per-line signature — still accepted for backward compatibility,
+// but carries no order total so revenue cannot be computed. Prefer the call above.
+client.registerSubmitCheckoutEvent({
+    productId: 'ProductIdentifier',
+    quantity: 1,
+    price: '12.00',
+    currency: 'EUR',
 });
 ```
 

package/dist/Dialog.d.ts

@@ -2,7 +2,7 @@ import { DialogConstructor } from "./types/constructor";
 import { Theme } from "./types/theme";
 import { DetailedLocaleInfo } from "./utils/localization";
 import { Suggestion } from "./types/suggestion";
-import { GenericQuestionPayload, OpenAssistantPayload, ProductQuestionPayload } from "./types/events";
+import { GenericQuestionPayload, LegacyCheckoutParams, OpenAssistantPayload, ProductQuestionPayload, SubmitCheckoutParams } from "./types/events";
 import { SimplifiedProduct } from "./types/product";
 import { EventsHandler } from "./EventsHandler";
 import { AssistantEvent } from "./types/assistantEvent";
@@ -10,11 +10,12 @@ export declare class Dialog {
     static readonly VERSION: string;
     private _apiKey;
     private _locale;
+    private _countryCode?;
     private _callbacks;
     private _theme;
     private _userId;
     private _eventsHandler;
-    constructor({ apiKey, locale, callbacks, theme, userId }: DialogConstructor);
+    constructor({ apiKey, locale, countryCode, callbacks, theme, userId, }: DialogConstructor);
     get apiKey(): string;
     get theme(): Theme;
     get userId(): string;
@@ -44,13 +45,7 @@ export declare class Dialog {
         currency?: string;
         variantId?: string;
     }): void;
-    registerSubmitCheckoutEvent({ productId, quantity, currency, variantId, price, }: {
-        productId: string;
-        quantity: number;
-        price: string;
-        currency?: string;
-        variantId?: string;
-    }): void;
+    registerSubmitCheckoutEvent(params: SubmitCheckoutParams | LegacyCheckoutParams): void;
     private _loadAssistant;
 }
 //# sourceMappingURL=Dialog.d.ts.map

package/dist/Dialog.d.ts.map

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

package/dist/Dialog.js

@@ -12,13 +12,15 @@ export class Dialog {
     static VERSION = packageJson.version;
     _apiKey;
     _locale;
+    _countryCode;
     _callbacks;
     _theme;
     _userId;
     _eventsHandler;
-    constructor({ apiKey, locale, callbacks, theme, userId }) {
+    constructor({ apiKey, locale, countryCode, callbacks, theme, userId, }) {
         this._apiKey = apiKey;
         this._locale = locale;
+        this._countryCode = countryCode;
         this._callbacks = callbacks;
         this._theme = { ...defaultTheme, ...theme };
         this._userId = this._createOrRetrieveUserId(userId);
@@ -45,7 +47,7 @@ export class Dialog {
         return this._eventsHandler;
     }
     getLocalizationInformations() {
-        return getDetailedLocaleInfo(this._locale);
+        return getDetailedLocaleInfo(this._locale, this._countryCode);
     }
     _createOrRetrieveUserId(userId) {
         if (userId !== undefined) {
@@ -113,25 +115,42 @@ export class Dialog {
             currency,
         });
     }
-    registerSubmitCheckoutEvent({ productId, quantity, currency, variantId, price, }) {
+    // Order-level: call ONCE per completed order with the order total.
+    // `orderValue` is what the dashboard's "Revenue generated" reads — do not
+    // call this per line item (that has no total and revenue resolves to 0).
+    //
+    // The legacy per-line signature (`{ productId, quantity, price }`) is still
+    // accepted for backward compatibility so existing installs keep working
+    // after an upgrade, but it is deprecated: it carries no order total.
+    registerSubmitCheckoutEvent(params) {
+        if ("orderValue" in params) {
+            this._eventsHandler.emitExternalEvent(DialogEvents.TRACK_SUBMIT_CHECKOUT, {
+                userId: this._userId,
+                orderValue: params.orderValue,
+                currency: params.currency,
+                transactionId: params.transactionId,
+                items: params.items,
+            });
+            return;
+        }
         this._eventsHandler.emitExternalEvent(DialogEvents.TRACK_SUBMIT_CHECKOUT, {
             userId: this._userId,
-            productId,
-            variantId,
-            quantity,
-            price,
-            currency,
+            productId: params.productId,
+            variantId: params.variantId,
+            quantity: params.quantity,
+            price: params.price,
+            currency: params.currency,
         });
     }
     _loadAssistant() {
-        const localeInfo = getDetailedLocaleInfo(this._locale);
+        const localeInfo = getDetailedLocaleInfo(this._locale, this._countryCode);
         if (localeInfo === null) {
             console.error("Missing locale information");
             return;
         }
         const div = document.createElement("div");
         div.id = "dialog-shopify-ai";
-        div.dataset.shopIsoCode = this._locale;
+        div.dataset.shopIsoCode = localeInfo.languageCode;
         div.dataset.apiKey = this._apiKey;
         div.dataset.userId = this._userId;
         div.dataset.countryCode = localeInfo.countryCode;

package/dist/types/constructor.d.ts

@@ -3,6 +3,12 @@ import { Theme } from "./theme";
 export interface DialogConstructor {
     apiKey: string;
     locale: 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`.
+     * Omit it to keep deriving the country from the locale (backward compatible).
+     */
+    countryCode?: string;
     callbacks: {
         addToCart: ({ productId, quantity, price, variantId, currency, }: {
             productId: 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,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,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"}

package/dist/types/events.d.ts

@@ -42,7 +42,38 @@ export interface TrackEventPayload {
     price?: string;
     currency?: string;
 }
-export type DialogEventPayload = ProductQuestionPayload | GenericQuestionPayload | DiagnosticPayload | OpenAssistantPayload | TrackEventPayload;
+export interface CheckoutLineItem {
+    productId: string;
+    variantId?: string;
+    quantity: number;
+    price?: number;
+}
+export interface SubmitCheckoutEventPayload {
+    userId?: string;
+    orderValue: number;
+    currency?: string;
+    transactionId?: string;
+    items?: CheckoutLineItem[];
+}
+export interface SubmitCheckoutParams {
+    orderValue: number;
+    currency?: string;
+    transactionId?: string;
+    items?: CheckoutLineItem[];
+}
+/**
+ * @deprecated Per-line checkout has no order total, so "Revenue generated"
+ * resolves to 0. Pass the order total via {@link SubmitCheckoutParams} instead,
+ * once per completed order.
+ */
+export interface LegacyCheckoutParams {
+    productId: string;
+    quantity: number;
+    price?: string;
+    currency?: string;
+    variantId?: string;
+}
+export type DialogEventPayload = ProductQuestionPayload | GenericQuestionPayload | DiagnosticPayload | OpenAssistantPayload | TrackEventPayload | SubmitCheckoutEventPayload;
 export interface DialogEvent<T = DialogEventPayload> {
     type: DialogEvents;
     payload: T;

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;AAMD,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;AAED,MAAM,MAAM,kBAAkB,GAC1B,sBAAsB,GACtB,sBAAsB,GACtB,iBAAiB,GACjB,oBAAoB,GACpB,iBAAiB,CAAC;AAEtB,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":"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"}

package/dist/utils/localization.d.ts

@@ -1,8 +1,23 @@
 export interface DetailedLocaleInfo {
     language: string;
+    languageCode: string;
     countryCode: string;
     formatted: string;
     locale: string;
 }
-export declare const getDetailedLocaleInfo: (locale: string) => DetailedLocaleInfo | null;
+export declare const isValidCountryCode: (countryCode: string | undefined) => countryCode is string;
+/**
+ * Resolves the detailed locale information used by the assistant.
+ *
+ * The effective region follows this precedence:
+ *   1. `countryCodeOverride` (explicit SDK parameter),
+ *   2. the region embedded in `locale` (e.g. `en-US` -> `US`),
+ *   3. the region guessed from the language via `Intl.Locale.maximize()`.
+ *
+ * The override (1) and the locale region (2) are considered "explicit" and also
+ * drive the language display name (e.g. `en-GB` -> "British English"). The
+ * `maximize()` fallback (3) only feeds the country code: a bare language code
+ * therefore keeps a generic language name ("French", not "French (France)").
+ */
+export declare const getDetailedLocaleInfo: (locale: string, countryCodeOverride?: string) => DetailedLocaleInfo | null;
 //# sourceMappingURL=localization.d.ts.map

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,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,qBAAqB,GAChC,QAAQ,MAAM,KACb,kBAAkB,GAAG,IAsBvB,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;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,qBAAqB,GAChC,QAAQ,MAAM,EACd,sBAAsB,MAAM,KAC3B,kBAAkB,GAAG,IAoCvB,CAAC"}

package/dist/utils/localization.js

@@ -1,15 +1,40 @@
-export const getDetailedLocaleInfo = (locale) => {
+export const isValidCountryCode = (countryCode) => countryCode !== undefined && /^[A-Za-z]{2}$/.test(countryCode);
+/**
+ * Resolves the detailed locale information used by the assistant.
+ *
+ * The effective region follows this precedence:
+ *   1. `countryCodeOverride` (explicit SDK parameter),
+ *   2. the region embedded in `locale` (e.g. `en-US` -> `US`),
+ *   3. the region guessed from the language via `Intl.Locale.maximize()`.
+ *
+ * The override (1) and the locale region (2) are considered "explicit" and also
+ * drive the language display name (e.g. `en-GB` -> "British English"). The
+ * `maximize()` fallback (3) only feeds the country code: a bare language code
+ * therefore keeps a generic language name ("French", not "French (France)").
+ */
+export const getDetailedLocaleInfo = (locale, countryCodeOverride) => {
     try {
         const localeObj = new Intl.Locale(locale);
         const language = localeObj.language;
-        const countryCode = localeObj.region ?? localeObj.maximize().region;
+        const overrideRegion = isValidCountryCode(countryCodeOverride)
+            ? countryCodeOverride.toUpperCase()
+            : undefined;
+        const explicitRegion = overrideRegion ?? localeObj.region;
+        const countryCode = explicitRegion ?? localeObj.maximize().region;
+        if (countryCode === undefined) {
+            return null;
+        }
+        const baseNameForLanguage = explicitRegion !== undefined
+            ? `${language}-${explicitRegion}`
+            : localeObj.baseName;
         const languageNames = new Intl.DisplayNames(["en"], { type: "language" });
-        const languageName = languageNames.of(localeObj.baseName);
-        if (languageName === undefined || countryCode === undefined) {
+        const languageName = languageNames.of(baseNameForLanguage);
+        if (languageName === undefined) {
             return null;
         }
         return {
             language: languageName,
+            languageCode: language,
             countryCode,
             formatted: `${language}-${countryCode}`,
             locale,

package/package.json

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