@objectstack/client 7.2.1 → 7.4.0

package/dist/index.mjs

@@ -2714,6 +2714,7 @@ var ObjectStackClient = class {
     this.baseUrl = config.baseUrl.replace(/\/$/, "");
     this.token = config.token;
     this.environmentId = config.environmentId;
+    this.locale = config.locale;
     this.fetchImpl = config.fetch || globalThis.fetch.bind(globalThis);
     this.logger = config.logger || createLogger({
       level: config.debug ? "debug" : "info",
@@ -2848,6 +2849,23 @@ var ObjectStackClient = class {
   getProjectId() {
     return this.environmentId;
   }
+  /**
+   * Update the active UI locale used for subsequent requests. Apps should
+   * call this from their language switcher so server-translated metadata
+   * (object/field labels, view headers, action text) follows the in-app
+   * language without a page refresh. Pass `undefined` to clear and fall
+   * back to the browser's `Accept-Language` (issue #1319).
+   */
+  setLocale(locale) {
+    this.locale = locale;
+    this.logger.debug("Active locale changed", { locale });
+  }
+  /**
+   * Current active UI locale (if set).
+   */
+  getLocale() {
+    return this.locale;
+  }
   /**
    * Event Subscription API
    * Provides real-time event subscriptions for metadata and data changes
@@ -2891,6 +2909,9 @@ var ObjectStackClient = class {
     if (this.environmentId) {
       headers["X-Environment-Id"] = this.environmentId;
     }
+    if (this.locale && !Object.keys(headers).some((h) => h.toLowerCase() === "accept-language")) {
+      headers["Accept-Language"] = this.locale;
+    }
     const res = await this.fetchImpl(url, { ...options, headers });
     this.logger.debug("HTTP response", {
       method: options.method || "GET",