@survicate/survicate-web-package 28.13.10-npm → 28.14.0-npm

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "28.13.10-npm",
+  "version": "28.14.0-npm",
   "name": "@survicate/survicate-web-package",
   "description": "Survicate Web Package",
   "author": {

package/survicate_widget.d.ts

@@ -122,6 +122,8 @@ export interface ConfigModel {
   disableTargeting?: true;
   /** Disable persistence of sensitive visitor data */
   disableSensitiveDataPersistence?: boolean;
+  /** Force surveys to display in a specific language (IETF language tag, e.g., "en", "fr", "pt-BR") */
+  forcedLanguage?: string;
   /** Array of survey IDs to hide from targeting */
   hiddenSurveys?: string[];
   /** Content Security Policy nonce for script injection */
@@ -292,6 +294,31 @@ export interface SurveyApi {
    */
   retarget: () => void;
 
+  /**
+   * Force the survey language to a specific IETF language tag
+   *
+   * This method overrides all automatic language detection methods (URL parameters,
+   * path segments, TLD, and browser language). The language will be applied to all
+   * surveys until explicitly changed or cleared.
+   *
+   * The argument must be a valid IETF language tag such as:
+   * - A two-letter ISO 639 code (e.g., "en", "fr")
+   * - A three-letter code for languages without the two-letter equivalent (e.g., "haw", "yue")
+   * - A language tag with region (e.g., "en-US", "pt-BR")
+   *
+   * @param languageTag - IETF language tag to force for all surveys
+   *
+   * @example
+   * ```javascript
+   * // Force surveys to display in French
+   * Survicate.setSurveyLanguage('fr');
+   *
+   * // Force surveys to display in Brazilian Portuguese
+   * Survicate.setSurveyLanguage('pt-BR');
+   * ```
+   */
+  setSurveyLanguage: (languageTag: string) => void;
+
   /**
    * Set visitor traits/attributes for targeting and identification
    * @param attributes - Object containing visitor attributes
@@ -489,6 +516,31 @@ declare const Survicate: {
    */
   retarget: () => void;
 
+  /**
+   * Force the survey language to a specific IETF language tag
+   *
+   * This method overrides all automatic language detection methods (URL parameters,
+   * path segments, TLD, and browser language). The language will be applied to all
+   * surveys until explicitly changed or cleared.
+   *
+   * The argument must be a valid IETF language tag such as:
+   * - A two-letter ISO 639 code (e.g., "en", "fr")
+   * - A three-letter code for languages without the two-letter equivalent (e.g., "haw", "yue")
+   * - A language tag with region (e.g., "en-US", "pt-BR")
+   *
+   * @example
+   * ```javascript
+   * // Force surveys to display in French
+   * Survicate.setSurveyLanguage('fr');
+   *
+   * // Force surveys to display in Brazilian Portuguese
+   * Survicate.setSurveyLanguage('pt-BR');
+   * ```
+   *
+   * @param languageTag - IETF language tag to force for all surveys
+   */
+  setSurveyLanguage: (languageTag: string) => void;
+
   /**
    * Set visitor traits/attributes for targeting and identification
    *