@magicx-eng/ai-autocomplete-vanilla 0.38.3 → 0.40.0

package/README.md

@@ -80,6 +80,7 @@ const ac = new AIAutocomplete(container, {
   maskCompletedText: false, // when true, omits completed params' text from API requests (PII masking)
   commitOnWordEnd: false,   // true = a word still being typed never becomes a chip until a space, Enter, or Tab ends it (exact matches and server identified params). Picking an option is unchanged.
   additionalContext: { tier: "gold" }, // optional user context, to personalize suggestions and options
+  language: "es",           // BCP 47 tag sent with every suggestion request and telemetry event. Default: navigator.language, else "en-US"
 
   // Appearance
   mode: "auto",               // "light" | "dark" | "auto"
@@ -729,13 +730,14 @@ A discriminated union: `APIKeyConfig | AccessTokenConfig`.
   getAccessToken: async () => {
     const res = await fetch("/api/ac-token");
     const { access_token, expires_at } = await res.json();
-    return { accessToken: access_token, expiresAt: expires_at };
+    // expires_at is Unix seconds; the SDK's expiresAt is Unix milliseconds.
+    return { accessToken: access_token, expiresAt: expires_at * 1000 };
   },
   endpoint: "https://api.ai-autocomplete.com/api/suggest", // optional, this is the default
 }
 ```
 
-The SDK handles token refresh transparently: if a request returns 401, it calls `getAccessToken` once, retries, and only surfaces an error if the retry also fails. Concurrent 401s share a single refresh call. Tokens are refreshed proactively 30 seconds before `expiresAt`.
+The SDK handles token refresh transparently: if a request returns 401, it calls `getAccessToken` once, retries, and only surfaces an error if the retry also fails. Concurrent 401s share a single refresh call. Tokens are refreshed proactively 30 seconds before `expiresAt` (Unix milliseconds).
 
 ### `AutocompleteResult`
 

package/dist/index.d.mts

@@ -138,6 +138,12 @@ interface AutocompleteResponse {
         request_at: string;
         /** The server's funnel-telemetry switch. Absent means off: send no funnel events. */
         funnel_telemetry?: boolean;
+        /**
+         * The server's phrase exact match switch. When true, a typed phrase that
+         * starts at the word the last request ended in can match an option
+         * exactly. Absent means off.
+         */
+        phrase_exact_match?: boolean;
         /** The request's `schema_version`, echoed back. */
         schema_version?: string;
     };
@@ -931,6 +937,11 @@ interface CoreOptions {
      * parameters and options to them.
      */
     additionalContext?: Record<string, unknown>;
+    /**
+     * BCP 47 language tag (e.g. `"es"`), sent with every suggestion request and telemetry event.
+     * Default: the browser language (`navigator.language`), else `"en-US"`.
+     */
+    language?: string;
     /**
      * Stable id for this visitor, kept by the host across page loads (e.g. a
      * first-party cookie). Rides on funnel telemetry so searches can be joined

package/dist/index.d.ts

@@ -138,6 +138,12 @@ interface AutocompleteResponse {
         request_at: string;
         /** The server's funnel-telemetry switch. Absent means off: send no funnel events. */
         funnel_telemetry?: boolean;
+        /**
+         * The server's phrase exact match switch. When true, a typed phrase that
+         * starts at the word the last request ended in can match an option
+         * exactly. Absent means off.
+         */
+        phrase_exact_match?: boolean;
         /** The request's `schema_version`, echoed back. */
         schema_version?: string;
     };
@@ -931,6 +937,11 @@ interface CoreOptions {
      * parameters and options to them.
      */
     additionalContext?: Record<string, unknown>;
+    /**
+     * BCP 47 language tag (e.g. `"es"`), sent with every suggestion request and telemetry event.
+     * Default: the browser language (`navigator.language`), else `"en-US"`.
+     */
+    language?: string;
     /**
      * Stable id for this visitor, kept by the host across page loads (e.g. a
      * first-party cookie). Rides on funnel telemetry so searches can be joined