@posthog/core 1.27.9 → 1.28.1

package/dist/surveys/index.js

@@ -0,0 +1,83 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, definition)=>{
+        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+            enumerable: true,
+            get: definition[key]
+        });
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    getSurveyInteractionProperty: ()=>external_events_js_namespaceObject.getSurveyInteractionProperty,
+    getSurveyOldResponseKey: ()=>external_events_js_namespaceObject.getSurveyOldResponseKey,
+    getBaseLanguage: ()=>external_translations_js_namespaceObject.getBaseLanguage,
+    getSurveyResponseValue: ()=>external_events_js_namespaceObject.getSurveyResponseValue,
+    SURVEY_LANGUAGE_PROPERTY: ()=>external_events_js_namespaceObject.SURVEY_LANGUAGE_PROPERTY,
+    detectSurveyLanguage: ()=>external_translations_js_namespaceObject.detectSurveyLanguage,
+    applySurveyTranslation: ()=>external_translations_js_namespaceObject.applySurveyTranslation,
+    getValidationError: ()=>external_validation_js_namespaceObject.getValidationError,
+    getLanguageFromStoredPersonProperties: ()=>external_translations_js_namespaceObject.getLanguageFromStoredPersonProperties,
+    buildSurveyResponseProperties: ()=>external_events_js_namespaceObject.buildSurveyResponseProperties,
+    getRequirementsHint: ()=>external_validation_js_namespaceObject.getRequirementsHint,
+    findBestTranslationMatch: ()=>external_translations_js_namespaceObject.findBestTranslationMatch,
+    normalizeLanguageCode: ()=>external_translations_js_namespaceObject.normalizeLanguageCode,
+    getSurveyResponseKey: ()=>external_events_js_namespaceObject.getSurveyResponseKey,
+    getLengthFromRules: ()=>external_validation_js_namespaceObject.getLengthFromRules,
+    surveyHasResponses: ()=>external_events_js_namespaceObject.surveyHasResponses
+});
+const external_validation_js_namespaceObject = require("./validation.js");
+const external_events_js_namespaceObject = require("./events.js");
+const external_translations_js_namespaceObject = require("./translations.js");
+exports.SURVEY_LANGUAGE_PROPERTY = __webpack_exports__.SURVEY_LANGUAGE_PROPERTY;
+exports.applySurveyTranslation = __webpack_exports__.applySurveyTranslation;
+exports.buildSurveyResponseProperties = __webpack_exports__.buildSurveyResponseProperties;
+exports.detectSurveyLanguage = __webpack_exports__.detectSurveyLanguage;
+exports.findBestTranslationMatch = __webpack_exports__.findBestTranslationMatch;
+exports.getBaseLanguage = __webpack_exports__.getBaseLanguage;
+exports.getLanguageFromStoredPersonProperties = __webpack_exports__.getLanguageFromStoredPersonProperties;
+exports.getLengthFromRules = __webpack_exports__.getLengthFromRules;
+exports.getRequirementsHint = __webpack_exports__.getRequirementsHint;
+exports.getSurveyInteractionProperty = __webpack_exports__.getSurveyInteractionProperty;
+exports.getSurveyOldResponseKey = __webpack_exports__.getSurveyOldResponseKey;
+exports.getSurveyResponseKey = __webpack_exports__.getSurveyResponseKey;
+exports.getSurveyResponseValue = __webpack_exports__.getSurveyResponseValue;
+exports.getValidationError = __webpack_exports__.getValidationError;
+exports.normalizeLanguageCode = __webpack_exports__.normalizeLanguageCode;
+exports.surveyHasResponses = __webpack_exports__.surveyHasResponses;
+for(var __webpack_i__ in __webpack_exports__)if (-1 === [
+    "SURVEY_LANGUAGE_PROPERTY",
+    "applySurveyTranslation",
+    "buildSurveyResponseProperties",
+    "detectSurveyLanguage",
+    "findBestTranslationMatch",
+    "getBaseLanguage",
+    "getLanguageFromStoredPersonProperties",
+    "getLengthFromRules",
+    "getRequirementsHint",
+    "getSurveyInteractionProperty",
+    "getSurveyOldResponseKey",
+    "getSurveyResponseKey",
+    "getSurveyResponseValue",
+    "getValidationError",
+    "normalizeLanguageCode",
+    "surveyHasResponses"
+].indexOf(__webpack_i__)) exports[__webpack_i__] = __webpack_exports__[__webpack_i__];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/surveys/index.mjs

@@ -0,0 +1,4 @@
+import { getLengthFromRules, getRequirementsHint, getValidationError } from "./validation.mjs";
+import { SURVEY_LANGUAGE_PROPERTY, buildSurveyResponseProperties, getSurveyInteractionProperty, getSurveyOldResponseKey, getSurveyResponseKey, getSurveyResponseValue, surveyHasResponses } from "./events.mjs";
+import { applySurveyTranslation, detectSurveyLanguage, findBestTranslationMatch, getBaseLanguage, getLanguageFromStoredPersonProperties, normalizeLanguageCode } from "./translations.mjs";
+export { SURVEY_LANGUAGE_PROPERTY, applySurveyTranslation, buildSurveyResponseProperties, detectSurveyLanguage, findBestTranslationMatch, getBaseLanguage, getLanguageFromStoredPersonProperties, getLengthFromRules, getRequirementsHint, getSurveyInteractionProperty, getSurveyOldResponseKey, getSurveyResponseKey, getSurveyResponseValue, getValidationError, normalizeLanguageCode, surveyHasResponses };

package/dist/surveys/translations.d.ts

@@ -0,0 +1,38 @@
+import { SurveyQuestionTranslation, SurveyTranslation } from '../types';
+export type DetectSurveyLanguageOptions = {
+    overrideLanguage?: unknown;
+    storedPersonProperties?: unknown;
+    locale?: unknown;
+};
+export declare function getLanguageFromStoredPersonProperties(storedPersonProperties: unknown): string | null;
+export declare function detectSurveyLanguage({ overrideLanguage, storedPersonProperties, locale, }: DetectSurveyLanguageOptions): string | null;
+export declare function normalizeLanguageCode(languageCode: string): string;
+export declare function getBaseLanguage(languageCode: string): string;
+export declare function findBestTranslationMatch(translations: Record<string, unknown> | undefined, targetLanguage: string): string | null;
+type TranslatableSurveyAppearance = {
+    thankYouMessageHeader?: string;
+    thankYouMessageDescription?: string | null;
+    thankYouMessageCloseButtonText?: string;
+};
+type TranslatableSurveyQuestion = {
+    question: string;
+    description?: string | null;
+    buttonText?: string;
+    link?: string | null;
+    lowerBoundLabel?: string;
+    upperBoundLabel?: string;
+    choices?: string[];
+    translations?: Record<string, SurveyQuestionTranslation>;
+};
+type TranslatableSurvey<TQuestion extends TranslatableSurveyQuestion = TranslatableSurveyQuestion> = {
+    name: string;
+    translations?: Record<string, SurveyTranslation>;
+    appearance?: TranslatableSurveyAppearance | null;
+    questions: TQuestion[];
+};
+export declare function applySurveyTranslation<TQuestion extends TranslatableSurveyQuestion, TSurvey extends TranslatableSurvey<TQuestion>>(survey: TSurvey, targetLanguage: string): {
+    survey: TSurvey;
+    matchedKey: string | null;
+};
+export {};
+//# sourceMappingURL=translations.d.ts.map

package/dist/surveys/translations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translations.d.ts","sourceRoot":"","sources":["../../src/surveys/translations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAKvE,MAAM,MAAM,2BAA2B,GAAG;IACxC,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,sBAAsB,CAAC,EAAE,OAAO,CAAA;IAChC,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB,CAAA;AAMD,wBAAgB,qCAAqC,CAAC,sBAAsB,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CAUpG;AAED,wBAAgB,oBAAoB,CAAC,EACnC,gBAAgB,EAChB,sBAAsB,EACtB,MAAM,GACP,EAAE,2BAA2B,GAAG,MAAM,GAAG,IAAI,CAqB7C;AAED,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAElE;AAED,wBAAgB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,EACjD,cAAc,EAAE,MAAM,GACrB,MAAM,GAAG,IAAI,CAuBf;AAgBD,KAAK,4BAA4B,GAAG;IAClC,qBAAqB,CAAC,EAAE,MAAM,CAAA;IAC9B,0BAA0B,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1C,8BAA8B,CAAC,EAAE,MAAM,CAAA;CACxC,CAAA;AAED,KAAK,0BAA0B,GAAG;IAChC,QAAQ,EAAE,MAAM,CAAA;IAChB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAA;CACzD,CAAA;AAED,KAAK,kBAAkB,CAAC,SAAS,SAAS,0BAA0B,GAAG,0BAA0B,IAAI;IACnG,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;IAChD,UAAU,CAAC,EAAE,4BAA4B,GAAG,IAAI,CAAA;IAChD,SAAS,EAAE,SAAS,EAAE,CAAA;CACvB,CAAA;AA0DD,wBAAgB,sBAAsB,CACpC,SAAS,SAAS,0BAA0B,EAC5C,OAAO,SAAS,kBAAkB,CAAC,SAAS,CAAC,EAC7C,MAAM,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAwDzF"}

package/dist/surveys/translations.js

@@ -0,0 +1,207 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, definition)=>{
+        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+            enumerable: true,
+            get: definition[key]
+        });
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    normalizeLanguageCode: ()=>normalizeLanguageCode,
+    getBaseLanguage: ()=>getBaseLanguage,
+    detectSurveyLanguage: ()=>detectSurveyLanguage,
+    applySurveyTranslation: ()=>applySurveyTranslation,
+    findBestTranslationMatch: ()=>findBestTranslationMatch,
+    getLanguageFromStoredPersonProperties: ()=>getLanguageFromStoredPersonProperties
+});
+const index_js_namespaceObject = require("../utils/index.js");
+const logger = (0, index_js_namespaceObject.createLogger)('[SurveyTranslations]');
+function getTrimmedLanguage(value) {
+    return 'string' == typeof value && value.trim() ? value.trim() : null;
+}
+function getLanguageFromStoredPersonProperties(storedPersonProperties) {
+    if (!storedPersonProperties || 'object' != typeof storedPersonProperties || !('language' in storedPersonProperties)) return null;
+    return getTrimmedLanguage(storedPersonProperties.language);
+}
+function detectSurveyLanguage({ overrideLanguage, storedPersonProperties, locale }) {
+    const explicitLanguage = getTrimmedLanguage(overrideLanguage);
+    if (explicitLanguage) {
+        logger.info(`Using override display language: ${explicitLanguage}`);
+        return explicitLanguage;
+    }
+    const personLanguage = getLanguageFromStoredPersonProperties(storedPersonProperties);
+    if (personLanguage) {
+        logger.info(`Using person property language: ${personLanguage}`);
+        return personLanguage;
+    }
+    const detectedLocale = getTrimmedLanguage(locale);
+    if (detectedLocale) {
+        logger.info(`Using detected locale: ${detectedLocale}`);
+        return detectedLocale;
+    }
+    logger.info('No user language detected');
+    return null;
+}
+function normalizeLanguageCode(languageCode) {
+    return languageCode.toLowerCase();
+}
+function getBaseLanguage(languageCode) {
+    return languageCode.split('-')[0];
+}
+function findBestTranslationMatch(translations, targetLanguage) {
+    if (!translations || !targetLanguage) return null;
+    const normalizedTarget = normalizeLanguageCode(targetLanguage);
+    const exactMatch = Object.keys(translations).find((key)=>normalizeLanguageCode(key) === normalizedTarget);
+    if (exactMatch) {
+        logger.debug(`Found exact translation match: ${exactMatch}`);
+        return exactMatch;
+    }
+    if (normalizedTarget.includes('-')) {
+        const baseLanguage = getBaseLanguage(normalizedTarget);
+        const baseMatch = Object.keys(translations).find((key)=>normalizeLanguageCode(key) === baseLanguage);
+        if (baseMatch) {
+            logger.debug(`Found base language translation match: ${baseMatch} (from ${targetLanguage})`);
+            return baseMatch;
+        }
+    }
+    return null;
+}
+function isTranslatedChoices(questionTranslation) {
+    return (0, index_js_namespaceObject.isArray)(questionTranslation.choices);
+}
+function hasThankYouTranslation(translation) {
+    return !(0, index_js_namespaceObject.isUndefined)(translation.thankYouMessageHeader) || !(0, index_js_namespaceObject.isUndefined)(translation.thankYouMessageDescription) || !(0, index_js_namespaceObject.isUndefined)(translation.thankYouMessageCloseButtonText);
+}
+function mergeQuestionTranslation(question, targetLanguage) {
+    const translationKey = findBestTranslationMatch(question.translations, targetLanguage);
+    if (!translationKey) return {
+        question,
+        matchedKey: null,
+        hasChanges: false
+    };
+    const questionTranslation = question.translations?.[translationKey];
+    if (!questionTranslation) return {
+        question,
+        matchedKey: null,
+        hasChanges: false
+    };
+    const translated = {
+        ...question
+    };
+    let hasChanges = false;
+    if (!(0, index_js_namespaceObject.isUndefined)(questionTranslation.question)) {
+        translated.question = questionTranslation.question;
+        hasChanges = true;
+    }
+    if (!(0, index_js_namespaceObject.isUndefined)(questionTranslation.description)) {
+        translated.description = questionTranslation.description;
+        hasChanges = true;
+    }
+    if (!(0, index_js_namespaceObject.isUndefined)(questionTranslation.buttonText)) {
+        translated.buttonText = questionTranslation.buttonText;
+        hasChanges = true;
+    }
+    if ('link' in translated && !(0, index_js_namespaceObject.isUndefined)(questionTranslation.link)) {
+        translated.link = questionTranslation.link;
+        hasChanges = true;
+    }
+    if ('lowerBoundLabel' in translated && !(0, index_js_namespaceObject.isUndefined)(questionTranslation.lowerBoundLabel)) {
+        translated.lowerBoundLabel = questionTranslation.lowerBoundLabel;
+        hasChanges = true;
+    }
+    if ('upperBoundLabel' in translated && !(0, index_js_namespaceObject.isUndefined)(questionTranslation.upperBoundLabel)) {
+        translated.upperBoundLabel = questionTranslation.upperBoundLabel;
+        hasChanges = true;
+    }
+    if ('choices' in translated && isTranslatedChoices(questionTranslation)) {
+        translated.choices = questionTranslation.choices;
+        hasChanges = true;
+    }
+    return {
+        question: hasChanges ? translated : question,
+        matchedKey: hasChanges ? translationKey : null,
+        hasChanges
+    };
+}
+function applySurveyTranslation(survey, targetLanguage) {
+    const translationKey = findBestTranslationMatch(survey.translations, targetLanguage);
+    const translated = {
+        ...survey
+    };
+    let hasTranslation = false;
+    if (translationKey) {
+        const translation = survey.translations?.[translationKey];
+        if (translation) {
+            logger.info(`Applying survey-level translation for language: ${translationKey}`);
+            if (!(0, index_js_namespaceObject.isUndefined)(translation.name)) {
+                translated.name = translation.name;
+                hasTranslation = true;
+            }
+            if (translated.appearance) {
+                translated.appearance = {
+                    ...translated.appearance
+                };
+                if (!(0, index_js_namespaceObject.isUndefined)(translation.thankYouMessageHeader)) {
+                    translated.appearance.thankYouMessageHeader = translation.thankYouMessageHeader;
+                    hasTranslation = true;
+                }
+                if (!(0, index_js_namespaceObject.isUndefined)(translation.thankYouMessageDescription)) {
+                    translated.appearance.thankYouMessageDescription = translation.thankYouMessageDescription;
+                    hasTranslation = true;
+                }
+                if (!(0, index_js_namespaceObject.isUndefined)(translation.thankYouMessageCloseButtonText)) {
+                    translated.appearance.thankYouMessageCloseButtonText = translation.thankYouMessageCloseButtonText;
+                    hasTranslation = true;
+                }
+            } else if (hasThankYouTranslation(translation)) hasTranslation = true;
+        }
+    }
+    const translatedResults = survey.questions.map((question)=>mergeQuestionTranslation(question, targetLanguage));
+    const translatedQuestions = translatedResults.map((result)=>result.question);
+    const anyQuestionTranslated = translatedResults.some((result)=>result.hasChanges);
+    let questionMatchedKey = null;
+    if (!translationKey) questionMatchedKey = translatedResults.find((result)=>result.matchedKey)?.matchedKey || null;
+    if (anyQuestionTranslated) {
+        translated.questions = translatedQuestions;
+        hasTranslation = true;
+        logger.info(`Applied question-level translations for language: ${targetLanguage}`);
+    }
+    return {
+        survey: translated,
+        matchedKey: hasTranslation ? translationKey || questionMatchedKey : null
+    };
+}
+exports.applySurveyTranslation = __webpack_exports__.applySurveyTranslation;
+exports.detectSurveyLanguage = __webpack_exports__.detectSurveyLanguage;
+exports.findBestTranslationMatch = __webpack_exports__.findBestTranslationMatch;
+exports.getBaseLanguage = __webpack_exports__.getBaseLanguage;
+exports.getLanguageFromStoredPersonProperties = __webpack_exports__.getLanguageFromStoredPersonProperties;
+exports.normalizeLanguageCode = __webpack_exports__.normalizeLanguageCode;
+for(var __webpack_i__ in __webpack_exports__)if (-1 === [
+    "applySurveyTranslation",
+    "detectSurveyLanguage",
+    "findBestTranslationMatch",
+    "getBaseLanguage",
+    "getLanguageFromStoredPersonProperties",
+    "normalizeLanguageCode"
+].indexOf(__webpack_i__)) exports[__webpack_i__] = __webpack_exports__[__webpack_i__];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/surveys/translations.mjs

@@ -0,0 +1,158 @@
+import { createLogger, isArray, isUndefined } from "../utils/index.mjs";
+const logger = createLogger('[SurveyTranslations]');
+function getTrimmedLanguage(value) {
+    return 'string' == typeof value && value.trim() ? value.trim() : null;
+}
+function getLanguageFromStoredPersonProperties(storedPersonProperties) {
+    if (!storedPersonProperties || 'object' != typeof storedPersonProperties || !('language' in storedPersonProperties)) return null;
+    return getTrimmedLanguage(storedPersonProperties.language);
+}
+function detectSurveyLanguage({ overrideLanguage, storedPersonProperties, locale }) {
+    const explicitLanguage = getTrimmedLanguage(overrideLanguage);
+    if (explicitLanguage) {
+        logger.info(`Using override display language: ${explicitLanguage}`);
+        return explicitLanguage;
+    }
+    const personLanguage = getLanguageFromStoredPersonProperties(storedPersonProperties);
+    if (personLanguage) {
+        logger.info(`Using person property language: ${personLanguage}`);
+        return personLanguage;
+    }
+    const detectedLocale = getTrimmedLanguage(locale);
+    if (detectedLocale) {
+        logger.info(`Using detected locale: ${detectedLocale}`);
+        return detectedLocale;
+    }
+    logger.info('No user language detected');
+    return null;
+}
+function normalizeLanguageCode(languageCode) {
+    return languageCode.toLowerCase();
+}
+function getBaseLanguage(languageCode) {
+    return languageCode.split('-')[0];
+}
+function findBestTranslationMatch(translations, targetLanguage) {
+    if (!translations || !targetLanguage) return null;
+    const normalizedTarget = normalizeLanguageCode(targetLanguage);
+    const exactMatch = Object.keys(translations).find((key)=>normalizeLanguageCode(key) === normalizedTarget);
+    if (exactMatch) {
+        logger.debug(`Found exact translation match: ${exactMatch}`);
+        return exactMatch;
+    }
+    if (normalizedTarget.includes('-')) {
+        const baseLanguage = getBaseLanguage(normalizedTarget);
+        const baseMatch = Object.keys(translations).find((key)=>normalizeLanguageCode(key) === baseLanguage);
+        if (baseMatch) {
+            logger.debug(`Found base language translation match: ${baseMatch} (from ${targetLanguage})`);
+            return baseMatch;
+        }
+    }
+    return null;
+}
+function isTranslatedChoices(questionTranslation) {
+    return isArray(questionTranslation.choices);
+}
+function hasThankYouTranslation(translation) {
+    return !isUndefined(translation.thankYouMessageHeader) || !isUndefined(translation.thankYouMessageDescription) || !isUndefined(translation.thankYouMessageCloseButtonText);
+}
+function mergeQuestionTranslation(question, targetLanguage) {
+    const translationKey = findBestTranslationMatch(question.translations, targetLanguage);
+    if (!translationKey) return {
+        question,
+        matchedKey: null,
+        hasChanges: false
+    };
+    const questionTranslation = question.translations?.[translationKey];
+    if (!questionTranslation) return {
+        question,
+        matchedKey: null,
+        hasChanges: false
+    };
+    const translated = {
+        ...question
+    };
+    let hasChanges = false;
+    if (!isUndefined(questionTranslation.question)) {
+        translated.question = questionTranslation.question;
+        hasChanges = true;
+    }
+    if (!isUndefined(questionTranslation.description)) {
+        translated.description = questionTranslation.description;
+        hasChanges = true;
+    }
+    if (!isUndefined(questionTranslation.buttonText)) {
+        translated.buttonText = questionTranslation.buttonText;
+        hasChanges = true;
+    }
+    if ('link' in translated && !isUndefined(questionTranslation.link)) {
+        translated.link = questionTranslation.link;
+        hasChanges = true;
+    }
+    if ('lowerBoundLabel' in translated && !isUndefined(questionTranslation.lowerBoundLabel)) {
+        translated.lowerBoundLabel = questionTranslation.lowerBoundLabel;
+        hasChanges = true;
+    }
+    if ('upperBoundLabel' in translated && !isUndefined(questionTranslation.upperBoundLabel)) {
+        translated.upperBoundLabel = questionTranslation.upperBoundLabel;
+        hasChanges = true;
+    }
+    if ('choices' in translated && isTranslatedChoices(questionTranslation)) {
+        translated.choices = questionTranslation.choices;
+        hasChanges = true;
+    }
+    return {
+        question: hasChanges ? translated : question,
+        matchedKey: hasChanges ? translationKey : null,
+        hasChanges
+    };
+}
+function applySurveyTranslation(survey, targetLanguage) {
+    const translationKey = findBestTranslationMatch(survey.translations, targetLanguage);
+    const translated = {
+        ...survey
+    };
+    let hasTranslation = false;
+    if (translationKey) {
+        const translation = survey.translations?.[translationKey];
+        if (translation) {
+            logger.info(`Applying survey-level translation for language: ${translationKey}`);
+            if (!isUndefined(translation.name)) {
+                translated.name = translation.name;
+                hasTranslation = true;
+            }
+            if (translated.appearance) {
+                translated.appearance = {
+                    ...translated.appearance
+                };
+                if (!isUndefined(translation.thankYouMessageHeader)) {
+                    translated.appearance.thankYouMessageHeader = translation.thankYouMessageHeader;
+                    hasTranslation = true;
+                }
+                if (!isUndefined(translation.thankYouMessageDescription)) {
+                    translated.appearance.thankYouMessageDescription = translation.thankYouMessageDescription;
+                    hasTranslation = true;
+                }
+                if (!isUndefined(translation.thankYouMessageCloseButtonText)) {
+                    translated.appearance.thankYouMessageCloseButtonText = translation.thankYouMessageCloseButtonText;
+                    hasTranslation = true;
+                }
+            } else if (hasThankYouTranslation(translation)) hasTranslation = true;
+        }
+    }
+    const translatedResults = survey.questions.map((question)=>mergeQuestionTranslation(question, targetLanguage));
+    const translatedQuestions = translatedResults.map((result)=>result.question);
+    const anyQuestionTranslated = translatedResults.some((result)=>result.hasChanges);
+    let questionMatchedKey = null;
+    if (!translationKey) questionMatchedKey = translatedResults.find((result)=>result.matchedKey)?.matchedKey || null;
+    if (anyQuestionTranslated) {
+        translated.questions = translatedQuestions;
+        hasTranslation = true;
+        logger.info(`Applied question-level translations for language: ${targetLanguage}`);
+    }
+    return {
+        survey: translated,
+        matchedKey: hasTranslation ? translationKey || questionMatchedKey : null
+    };
+}
+export { applySurveyTranslation, detectSurveyLanguage, findBestTranslationMatch, getBaseLanguage, getLanguageFromStoredPersonProperties, normalizeLanguageCode };

package/dist/testing/test-utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"test-utils.d.ts","sourceRoot":"","sources":["../../src/testing/test-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAEhC,eAAO,MAAM,IAAI,GAAU,GAAG,MAAM,KAAG,OAAO,CAAC,IAAI,CAElD,CAAA;AAED,eAAO,MAAM,eAAe,QAAa,OAAO,CAAC,IAAI,CAQpD,CAAA;AAED,eAAO,MAAM,SAAS,GAAI,UAAU,GAAG,KAAG,GAIzC,CAAA;AAED,eAAO,MAAM,uBAAuB,GAAI,CAAC,OAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAM5E,CAAA;AAED,eAAO,MAAM,KAAK,GAAI,IAAI,MAAM,KAAG,OAAO,CAAC,IAAI,CAI9C,CAAA;AAED,eAAO,MAAM,gBAAgB,QAAO,MAQnC,CAAA"}
+{"version":3,"file":"test-utils.d.ts","sourceRoot":"","sources":["../../src/testing/test-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAEhC,eAAO,MAAM,IAAI,GAAU,GAAG,MAAM,KAAG,OAAO,CAAC,IAAI,CAElD,CAAA;AAED,eAAO,MAAM,eAAe,QAAa,OAAO,CAAC,IAAI,CAQpD,CAAA;AAED,eAAO,MAAM,SAAS,GAAI,UAAU,GAAG,KAAG,GAIzC,CAAA;AAED,eAAO,MAAM,uBAAuB,GAAI,CAAC,OAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAM5E,CAAA;AAED,eAAO,MAAM,KAAK,GAAI,IAAI,MAAM,KAAG,OAAO,CAAC,IAAI,CAI9C,CAAA;AAED,eAAO,MAAM,gBAAgB,QAAO,MASnC,CAAA"}

package/dist/testing/test-utils.js

@@ -60,6 +60,7 @@ const delay = (ms)=>new Promise((resolve)=>{
         setTimeout(resolve, ms);
     });
 const createMockLogger = ()=>({
+        debug: jest.fn((...args)=>console.debug(...args)),
         info: jest.fn((...args)=>console.log(...args)),
         warn: jest.fn((...args)=>console.warn(...args)),
         error: jest.fn((...args)=>console.error(...args)),

package/dist/testing/test-utils.mjs

@@ -27,6 +27,7 @@ const delay = (ms)=>new Promise((resolve)=>{
         setTimeout(resolve, ms);
     });
 const createMockLogger = ()=>({
+        debug: jest.fn((...args)=>console.debug(...args)),
         info: jest.fn((...args)=>console.log(...args)),
         warn: jest.fn((...args)=>console.warn(...args)),
         error: jest.fn((...args)=>console.error(...args)),

package/dist/types.d.ts

@@ -318,6 +318,15 @@ export type PostHogRemoteConfig = {
     capturePerformance?: boolean | {
         [key: string]: JsonType;
     };
+    /**
+     * Logs feature remote config. When a map, `captureConsoleLogs` (boolean)
+     * is the local opt-in flag for `console.*` autocapture (read by the JS
+     * SDK's `PostHogLogs` extension to decide whether to load the autocapture
+     * bundle).
+     */
+    logs?: boolean | {
+        [key: string]: JsonType;
+    };
 };
 export type FeatureFlagValue = string | boolean;
 /**
@@ -534,23 +543,39 @@ export interface SurveyValidationRule {
     value?: number;
     errorMessage?: string;
 }
+export interface SurveyTranslation {
+    name?: string;
+    thankYouMessageHeader?: string;
+    thankYouMessageDescription?: string;
+    thankYouMessageCloseButtonText?: string;
+}
+export interface SurveyQuestionTranslation {
+    question?: string;
+    description?: string | null;
+    buttonText?: string;
+    link?: string | null;
+    lowerBoundLabel?: string;
+    upperBoundLabel?: string;
+    choices?: string[];
+}
 type SurveyQuestionBase = {
     question: string;
     id: string;
-    description?: string;
+    description?: string | null;
     descriptionContentType?: SurveyQuestionDescriptionContentType;
     optional?: boolean;
     buttonText?: string;
     originalQuestionIndex: number;
     branching?: NextQuestionBranching | EndBranching | ResponseBasedBranching | SpecificQuestionBranching;
     validation?: SurveyValidationRule[];
+    translations?: Record<string, SurveyQuestionTranslation>;
 };
 export type BasicSurveyQuestion = SurveyQuestionBase & {
     type: SurveyQuestionType.Open;
 };
 export type LinkSurveyQuestion = SurveyQuestionBase & {
     type: SurveyQuestionType.Link;
-    link?: string;
+    link?: string | null;
 };
 export type RatingSurveyQuestion = SurveyQuestionBase & {
     type: SurveyQuestionType.Rating;
@@ -601,6 +626,8 @@ export type SpecificQuestionBranching = {
 export type SurveyResponse = {
     surveys: Survey[];
 };
+export type SurveyResponseValue = string | number | string[] | null;
+export type SurveyResponses = Record<string, SurveyResponseValue>;
 export type SurveyCallback = (surveys: Survey[]) => void;
 export declare enum SurveyMatchType {
     Regex = "regex",
@@ -638,6 +665,7 @@ export type Survey = {
     name: string;
     description?: string;
     type: SurveyType;
+    translations?: Record<string, SurveyTranslation>;
     feature_flag_keys?: {
         key: string;
         value?: string;
@@ -696,6 +724,7 @@ export type ActionStepType = {
     url_matching?: ActionStepStringMatching;
 };
 export type Logger = {
+    debug: (...args: any[]) => void;
     info: (...args: any[]) => void;
     warn: (...args: any[]) => void;
     error: (...args: any[]) => void;