@lokalise/polyglot-sdk 17.0.1 → 17.0.3

package/dist/index.d.ts

@@ -18,5 +18,6 @@ export * from './sdk/schemas/translation/translateTextSegmentSchemas';
 export * from './sdk/schemas/translation/sharedSchemas';
 export { isSegmentUnderLengthLimit, isSegmentUnderLengthLimit as isSegmentExceedingLengthLimit, } from './sdk/validation/isSegmentUnderLengthLimit';
 export { getRequestSizeLimit, isRequestSizeUnderLimit } from './sdk/validation/requestSizeLimit';
+export * from './sdk/helpers/htmlEscaping';
 export * from './sdk/helpers/nonTranslatableContentHelper';
 export * from './sdk/helpers/nonTranslatableContentWrappers';

package/dist/index.js

@@ -29,6 +29,7 @@ Object.defineProperty(exports, "isSegmentExceedingLengthLimit", { enumerable: tr
 var requestSizeLimit_1 = require("./sdk/validation/requestSizeLimit");
 Object.defineProperty(exports, "getRequestSizeLimit", { enumerable: true, get: function () { return requestSizeLimit_1.getRequestSizeLimit; } });
 Object.defineProperty(exports, "isRequestSizeUnderLimit", { enumerable: true, get: function () { return requestSizeLimit_1.isRequestSizeUnderLimit; } });
+tslib_1.__exportStar(require("./sdk/helpers/htmlEscaping"), exports);
 tslib_1.__exportStar(require("./sdk/helpers/nonTranslatableContentHelper"), exports);
 tslib_1.__exportStar(require("./sdk/helpers/nonTranslatableContentWrappers"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;AAAA,uDAAqD;AAA5C,gHAAA,cAAc,OAAA;AACvB,4DAA0D;AAAjD,8GAAA,aAAa,OAAA;AAGtB,mFAAwD;AAExD,6EAAkD;AAClD,4EAAiD;AACjD,4FAGuD;AAFrD,uIAAA,0BAA0B,OAAA;AAC1B,mIAAA,sBAAsB,OAAA;AAYxB,iEAAsE;AAA7D,qHAAA,oBAAoB,OAAA;AAC7B,4EAAiD;AACjD,2EAAgD;AAChD,6EAAkD;AAClD,qFAA0D;AAC1D,uFAA4D;AAC5D,yFAA8D;AAC9D,0FAA+D;AAC/D,gGAAqE;AACrE,kFAAuD;AAEvD,wFAGmD;AAFjD,sIAAA,yBAAyB,OAAA;AACzB,0IAAA,yBAAyB,OAAiC;AAE5D,sEAAgG;AAAvF,uHAAA,mBAAmB,OAAA;AAAE,2HAAA,uBAAuB,OAAA;AAErD,qFAA0D;AAC1D,uFAA4D"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;AAAA,uDAAqD;AAA5C,gHAAA,cAAc,OAAA;AACvB,4DAA0D;AAAjD,8GAAA,aAAa,OAAA;AAGtB,mFAAwD;AAExD,6EAAkD;AAClD,4EAAiD;AACjD,4FAGuD;AAFrD,uIAAA,0BAA0B,OAAA;AAC1B,mIAAA,sBAAsB,OAAA;AAYxB,iEAAsE;AAA7D,qHAAA,oBAAoB,OAAA;AAC7B,4EAAiD;AACjD,2EAAgD;AAChD,6EAAkD;AAClD,qFAA0D;AAC1D,uFAA4D;AAC5D,yFAA8D;AAC9D,0FAA+D;AAC/D,gGAAqE;AACrE,kFAAuD;AAEvD,wFAGmD;AAFjD,sIAAA,yBAAyB,OAAA;AACzB,0IAAA,yBAAyB,OAAiC;AAE5D,sEAAgG;AAAvF,uHAAA,mBAAmB,OAAA;AAAE,2HAAA,uBAAuB,OAAA;AAErD,qEAA0C;AAC1C,qFAA0D;AAC1D,uFAA4D"}

package/dist/sdk/helpers/htmlEscaping.d.ts

@@ -0,0 +1,3 @@
+import { type IntegrationEngineEnum } from '../schemas/common/commonSchemas';
+export declare const handleHtmlEscape: (text: string, integration?: IntegrationEngineEnum) => string;
+export declare const handleHtmlUnescape: (text: string, integration?: IntegrationEngineEnum) => string;

package/dist/sdk/helpers/htmlEscaping.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleHtmlUnescape = exports.handleHtmlEscape = void 0;
+const html_escaper_1 = require("html-escaper");
+const commonSchemas_1 = require("../schemas/common/commonSchemas");
+const isEnumValue_1 = require("./isEnumValue");
+const isHtmlEscapingNeededByMtIntegration = {
+    [commonSchemas_1.MtIntegrationEngineEnum.DEEPL]: false,
+    [commonSchemas_1.MtIntegrationEngineEnum.GOOGLE_TRANSLATE]: true,
+    [commonSchemas_1.MtIntegrationEngineEnum.MICROSOFT_TRANSLATOR]: true,
+};
+const handleHtmlEscape = (text, integration) => {
+    if (!integration || !(0, isEnumValue_1.isEnumValue)(commonSchemas_1.MtIntegrationEngineEnum, integration)) {
+        return text;
+    }
+    return isHtmlEscapingNeededByMtIntegration[integration] ? (0, html_escaper_1.escape)(text) : text;
+};
+exports.handleHtmlEscape = handleHtmlEscape;
+const handleHtmlUnescape = (text, integration) => {
+    if (!integration || !(0, isEnumValue_1.isEnumValue)(commonSchemas_1.MtIntegrationEngineEnum, integration)) {
+        return text;
+    }
+    return isHtmlEscapingNeededByMtIntegration[integration] ? (0, html_escaper_1.unescape)(text) : text;
+};
+exports.handleHtmlUnescape = handleHtmlUnescape;
+//# sourceMappingURL=htmlEscaping.js.map

package/dist/sdk/helpers/htmlEscaping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"htmlEscaping.js","sourceRoot":"","sources":["../../../src/sdk/helpers/htmlEscaping.ts"],"names":[],"mappings":";;;AAAA,+CAA6E;AAC7E,mEAGwC;AACxC,+CAA2C;AAE3C,MAAM,mCAAmC,GAA6C;IACpF,CAAC,uCAAuB,CAAC,KAAK,CAAC,EAAE,KAAK;IACtC,CAAC,uCAAuB,CAAC,gBAAgB,CAAC,EAAE,IAAI;IAChD,CAAC,uCAAuB,CAAC,oBAAoB,CAAC,EAAE,IAAI;CACrD,CAAA;AAEM,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAE,WAAmC,EAAU,EAAE;IAC5F,IAAI,CAAC,WAAW,IAAI,CAAC,IAAA,yBAAW,EAAC,uCAAuB,EAAE,WAAW,CAAC,EAAE,CAAC;QACvE,OAAO,IAAI,CAAA;IACb,CAAC;IAED,OAAO,mCAAmC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAA,qBAAU,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AACnF,CAAC,CAAA;AANY,QAAA,gBAAgB,oBAM5B;AAEM,MAAM,kBAAkB,GAAG,CAAC,IAAY,EAAE,WAAmC,EAAU,EAAE;IAC9F,IAAI,CAAC,WAAW,IAAI,CAAC,IAAA,yBAAW,EAAC,uCAAuB,EAAE,WAAW,CAAC,EAAE,CAAC;QACvE,OAAO,IAAI,CAAA;IACb,CAAC;IAED,OAAO,mCAAmC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,IAAA,uBAAY,EAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AACrF,CAAC,CAAA;AANY,QAAA,kBAAkB,sBAM9B"}

package/dist/sdk/helpers/isEnumValue.d.ts

@@ -0,0 +1 @@
+export declare const isEnumValue: <T extends Record<string, string>>(enumObj: T, value: string) => value is T[keyof T];

package/dist/sdk/helpers/isEnumValue.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isEnumValue = void 0;
+const isEnumValue = (enumObj, value) => {
+    return Object.values(enumObj).includes(value);
+};
+exports.isEnumValue = isEnumValue;
+//# sourceMappingURL=isEnumValue.js.map

package/dist/sdk/helpers/isEnumValue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isEnumValue.js","sourceRoot":"","sources":["../../../src/sdk/helpers/isEnumValue.ts"],"names":[],"mappings":";;;AAAO,MAAM,WAAW,GAAG,CACzB,OAAU,EACV,KAAa,EACQ,EAAE;IACvB,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,KAAmB,CAAC,CAAA;AAC7D,CAAC,CAAA;AALY,QAAA,WAAW,eAKvB"}

package/dist/sdk/validation/isSegmentUnderLengthLimit.js

@@ -1,11 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isSegmentUnderLengthLimit = void 0;
+const htmlEscaping_1 = require("../helpers/htmlEscaping");
 const nonTranslatableContentHelper_1 = require("../helpers/nonTranslatableContentHelper");
 const requestSizeLimit_1 = require("./requestSizeLimit");
 const isSegmentUnderLengthLimit = (value, integration) => {
     const limit = (0, requestSizeLimit_1.getRequestSizeLimit)(integration);
-    const ntcWrapped = (0, nonTranslatableContentHelper_1.wrapNonTranslatableRegions)(value, integration);
+    const htmlEscaped = (0, htmlEscaping_1.handleHtmlEscape)(value, integration);
+    const ntcWrapped = (0, nonTranslatableContentHelper_1.wrapNonTranslatableRegions)(htmlEscaped, integration);
     return ntcWrapped.length <= limit;
 };
 exports.isSegmentUnderLengthLimit = isSegmentUnderLengthLimit;

package/dist/sdk/validation/isSegmentUnderLengthLimit.js.map

@@ -1 +1 @@
-{"version":3,"file":"isSegmentUnderLengthLimit.js","sourceRoot":"","sources":["../../../src/sdk/validation/isSegmentUnderLengthLimit.ts"],"names":[],"mappings":";;;AAAA,0FAAoF;AAEpF,yDAAwD;AAEjD,MAAM,yBAAyB,GAAG,CACvC,KAAa,EACb,WAAmC,EAC1B,EAAE;IACX,MAAM,KAAK,GAAG,IAAA,sCAAmB,EAAC,WAAW,CAAC,CAAA;IAC9C,MAAM,UAAU,GAAG,IAAA,yDAA0B,EAAC,KAAK,EAAE,WAAW,CAAC,CAAA;IACjE,OAAO,UAAU,CAAC,MAAM,IAAI,KAAK,CAAA;AACnC,CAAC,CAAA;AAPY,QAAA,yBAAyB,6BAOrC"}
+{"version":3,"file":"isSegmentUnderLengthLimit.js","sourceRoot":"","sources":["../../../src/sdk/validation/isSegmentUnderLengthLimit.ts"],"names":[],"mappings":";;;AAAA,0DAA0D;AAC1D,0FAAoF;AAEpF,yDAAwD;AAEjD,MAAM,yBAAyB,GAAG,CACvC,KAAa,EACb,WAAmC,EAC1B,EAAE;IACX,MAAM,KAAK,GAAG,IAAA,sCAAmB,EAAC,WAAW,CAAC,CAAA;IAC9C,MAAM,WAAW,GAAG,IAAA,+BAAgB,EAAC,KAAK,EAAE,WAAW,CAAC,CAAA;IACxD,MAAM,UAAU,GAAG,IAAA,yDAA0B,EAAC,WAAW,EAAE,WAAW,CAAC,CAAA;IAEvE,OAAO,UAAU,CAAC,MAAM,IAAI,KAAK,CAAA;AACnC,CAAC,CAAA;AATY,QAAA,yBAAyB,6BASrC"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@lokalise/polyglot-sdk",
-    "version": "17.0.1",
+    "version": "17.0.3",
     "author": {
         "name": "Lokalise",
         "url": "https://lokalise.com/"
@@ -42,6 +42,7 @@
         "@lokalise/non-translatable-markup": "^2.9.1",
         "@lokalise/supported-languages": "^2.1.0",
         "@lokalise/zod-extras": "^2.1.0",
+        "html-escaper": "^3.0.3",
         "undici": "^7.2.3",
         "undici-retry": "^6.0.0",
         "zod": "^3.24.2"
@@ -54,6 +55,7 @@
         "@biomejs/biome": "^1.9.4",
         "@lokalise/biome-config": "^1.5.0",
         "@lokalise/fastify-extras": "^26.0.0",
+        "@types/html-escaper": "^3.0.4",
         "@types/node": "^22.13.8",
         "@vitest/coverage-v8": "^3.0.7",
         "auto-changelog": "^2.5.0",