locize-cli 12.3.0 → 12.4.0

package/CHANGELOG.md

@@ -5,6 +5,28 @@ All notable changes to this project will be documented in this file.
 Project versioning adheres to [Semantic Versioning](http://semver.org/).
 Change log format is based on [Keep a Changelog](http://keepachangelog.com/).
 
+## [12.4.0](https://github.com/locize/locize-cli/compare/v12.3.1...v12.4.0) - 2026-07-06
+
+- xliff: proper support for inline elements (e.g. Angular's
+  `<x id="INTERPOLATION" equiv-text="{{ count }}"/>` placeholders, or
+  `<ph>`/`<pc>`/`<g>`/`<bpt>` tags from other TMS exports). On import they are
+  flattened into stable placeholder tokens inside the translation value
+  (previously such values were silently corrupted into arrays); on export the
+  tokens are restored as real XLIFF inline elements, so Angular `.xlf` files
+  round-trip cleanly. Requires `xliff` >= 6.4.0 (the encoding is implemented
+  in the library and shared with the locize CAT editor).
+- xliff: new formats `xliff21`, `xliff22`, `xlf21`, `xlf22` for XLIFF 2.1 and
+  2.2 (import of 2.1/2.2 files already worked via `xliff2`; exports now emit
+  the matching `version` attribute). XLIFF 2.1 exports carry the
+  OASIS-correct `urn:oasis:names:tc:xliff:document:2.0` core namespace.
+
+## [12.3.1](https://github.com/locize/locize-cli/compare/v12.3.0...v12.3.1) - 2026-06-18
+
+- request: retry transient network failures with exponential backoff and jitter
+  instead of a fixed 5s delay. This spreads retries so that bursts of
+  concurrent CLI runs (e.g. in CI) no longer retry in lockstep and hit the API
+  at the same instant.
+
 ## [12.3.0](https://github.com/locize/locize-cli/compare/v12.2.0...v12.3.0) - 2026-06-10
 
 - sync: creates missing remote languages on the fly. A project without any

package/README.md

@@ -105,7 +105,7 @@ locize download --cdn-type standard
 locize download --cdn-type pro
 ```
 
-or add a format like (json, nested, flat, xliff2, xliff12, xlf2, xlf12, android, yaml, yaml-rails, yaml-rails-ns, yaml-nested, yml, yml-rails, yml-nested, csv, xlsx, po, strings, resx, fluent, tmx, laravel, properties, xcstrings)
+or add a format like (json, nested, flat, xliff2, xliff21, xliff22, xliff12, xlf2, xlf21, xlf22, xlf12, android, yaml, yaml-rails, yaml-rails-ns, yaml-nested, yml, yml-rails, yml-nested, csv, xlsx, po, strings, resx, fluent, tmx, laravel, properties, xcstrings)
 
 *Special formats:*
 - use yaml-rails to have the language code in the resulting yaml as root object
@@ -160,7 +160,7 @@ locize sync --cdn-type standard --api-key my-api-key-d9de-4f55-9855-a9ef0ed44672
 locize sync --cdn-type pro --api-key my-api-key-d9de-4f55-9855-a9ef0ed44672 --project-id my-project-id-93e1-442a-ab35-24331fa294ba
 ```
 
-or add a format like (json, nested, flat, xliff2, xliff12, xlf2, xlf12, android, yaml, yaml-rails, yaml-rails-ns, yaml-nested, yml, yml-rails, yml-nested, csv, xlsx, po, strings, resx, fluent, tmx, laravel, properties, xcstrings)
+or add a format like (json, nested, flat, xliff2, xliff21, xliff22, xliff12, xlf2, xlf21, xlf22, xlf12, android, yaml, yaml-rails, yaml-rails-ns, yaml-nested, yml, yml-rails, yml-nested, csv, xlsx, po, strings, resx, fluent, tmx, laravel, properties, xcstrings)
 
 *Special formats:*
 - use yaml-rails to have the language code in the resulting yaml as root object
@@ -227,7 +227,7 @@ locize save-missing --cdn-type standard --api-key my-api-key-d9de-4f55-9855-a9ef
 locize save-missing --cdn-type pro --api-key my-api-key-d9de-4f55-9855-a9ef0ed44672 --project-id my-project-id-93e1-442a-ab35-24331fa294ba
 ```
 
-or add a format like (json, nested, flat, xliff2, xliff12, xlf2, xlf12, android, yaml, yaml-rails, yaml-rails-ns, yaml-nested, yml, yml-rails, yml-nested, csv, xlsx, po, strings, resx, fluent, tmx, laravel, properties, xcstrings)
+or add a format like (json, nested, flat, xliff2, xliff21, xliff22, xliff12, xlf2, xlf21, xlf22, xlf12, android, yaml, yaml-rails, yaml-rails-ns, yaml-nested, yml, yml-rails, yml-nested, csv, xlsx, po, strings, resx, fluent, tmx, laravel, properties, xcstrings)
 
 ```sh
 locize save-missing --api-key my-api-key-d9de-4f55-9855-a9ef0ed44672 --project-id my-project-id-93e1-442a-ab35-24331fa294ba --format android

package/dist/cjs/cli.js

@@ -50,7 +50,7 @@ const program = new commander.Command();
 
 program
   .description('The official locize CLI.')
-  .version('12.3.0'); // This string is replaced with the actual version at build time by rollup
+  .version('12.4.0'); // This string is replaced with the actual version at build time by rollup
 // .option('-a, --api-endpoint <url>', `Specify the api-endpoint url that should be used (default: ${defaultApiEndpoint})`)
 // .option('-C, --config-path <configPath>', `Specify the path to the optional locize config file (default: ${configInWorkingDirectory} or ${configInHome})`);
 
@@ -263,7 +263,7 @@ program
   .option('-n, --namespace <ns>', 'The namespace that should be targeted')
   .option('-p, --path <path>', `Specify the path that should be used (default: ${process.cwd()})`, process.cwd())
   .option('-k, --api-key <apiKey>', 'The api-key that should be used')
-  .option('-f, --format <json>', 'File format of namespaces (default: json; [nested, flat, xliff2, xliff12, xlf2, xlf12, android, yaml, yaml-rails, yaml-rails-ns, yaml-nested, yml, yml-rails, yml-nested, csv, xlsx, po, strings, resx, fluent, tmx, laravel, properties, xcstrings])', 'json')
+  .option('-f, --format <json>', 'File format of namespaces (default: json; [nested, flat, xliff2, xliff21, xliff22, xliff12, xlf2, xlf21, xlf22, xlf12, android, yaml, yaml-rails, yaml-rails-ns, yaml-nested, yml, yml-rails, yml-nested, csv, xlsx, po, strings, resx, fluent, tmx, laravel, properties, xcstrings])', 'json')
   .option('-s, --skip-empty <true|false>', 'Skips to download empty files (default: true)', 'true')
   .option('-P, --language-folder-prefix <prefix>', 'This will be added as a local folder name prefix in front of the language.', '')
   .option('-m, --path-mask <mask>', 'This will define the folder and file structure; do not add a file extension (default: {{language}}/{{namespace}})', `{{language}}${path.sep}{{namespace}}`)
@@ -412,7 +412,7 @@ program
   .option('-p, --path <path>', `Specify the path that should be used (default: ${process.cwd()})`, process.cwd())
   .option('-B, --backup-deleted-path <path>', 'Saves the segments that will be deleted in this path')
   .option('-A, --auto-create-path <true|false>', 'This will automatically make sure the --path is created. (default: true)', 'true')
-  .option('-f, --format <json>', 'File format of namespaces (default: json; [nested, flat, xliff2, xliff12, xlf2, xlf12, android, yaml, yaml-rails, yaml-rails-ns, yaml-nested, yml, yml-rails, yml-nested, csv, xlsx, po, strings, resx, fluent, tmx, laravel, properties, xcstrings])', 'json')
+  .option('-f, --format <json>', 'File format of namespaces (default: json; [nested, flat, xliff2, xliff21, xliff22, xliff12, xlf2, xlf21, xlf22, xlf12, android, yaml, yaml-rails, yaml-rails-ns, yaml-nested, yml, yml-rails, yml-nested, csv, xlsx, po, strings, resx, fluent, tmx, laravel, properties, xcstrings])', 'json')
   .option('-s, --skip-empty <true|false>', 'Skips to download empty files (default: false)', 'false')
   .option('-c, --clean <true|false>', 'Removes all local files by removing the whole folder (default: false)', 'false')
   .option('--cf, --clean-local-files <true|false>', 'Removes all local files without removing any folder (default: false)', 'false')
@@ -540,7 +540,7 @@ program
   .option('-i, --project-id <projectId>', 'The project-id that should be used')
   .option('-v, --ver <version>', 'Found namespaces will be matched to this version (default: latest)')
   .option('-p, --path <path>', `Specify the path that should be used (default: ${process.cwd()})`, process.cwd())
-  .option('-f, --format <json>', 'File format of namespaces (default: json; [nested, flat, xliff2, xliff12, xlf2, xlf12, android, yaml, yaml-rails, yaml-rails-ns, yaml-nested, yml, yml-rails, yml-nested, csv, xlsx, po, strings, resx, fluent, tmx, laravel, properties, xcstrings])', 'json')
+  .option('-f, --format <json>', 'File format of namespaces (default: json; [nested, flat, xliff2, xliff21, xliff22, xliff12, xlf2, xlf21, xlf22, xlf12, android, yaml, yaml-rails, yaml-rails-ns, yaml-nested, yml, yml-rails, yml-nested, csv, xlsx, po, strings, resx, fluent, tmx, laravel, properties, xcstrings])', 'json')
   .option('-m, --path-mask <mask>', 'This will define the folder and file structure; do not add a file extension (default: {{language}}/{{namespace}})', `{{language}}${path.sep}{{namespace}}`)
   .option('-P, --language-folder-prefix <prefix>', 'This will be added as a local folder name prefix in front of the language.', '')
   .option('-d, --dry <true|false>', 'Dry run (default: false)', 'false')
@@ -835,7 +835,7 @@ program
   .command('format [fileOrDirectory]')
   .alias('ft')
   .description('format local files')
-  .option('-f, --format <json>', 'File format of namespaces (default: json; [nested, flat, xliff2, xliff12, xlf2, xlf12, android, yaml, yaml-rails, yaml-rails-ns, yaml-nested, yml, yml-rails, yml-nested, csv, xlsx, po, strings, resx, fluent, tmx, laravel, properties, xcstrings])', 'json')
+  .option('-f, --format <json>', 'File format of namespaces (default: json; [nested, flat, xliff2, xliff21, xliff22, xliff12, xlf2, xlf21, xlf22, xlf12, android, yaml, yaml-rails, yaml-rails-ns, yaml-nested, yml, yml-rails, yml-nested, csv, xlsx, po, strings, resx, fluent, tmx, laravel, properties, xcstrings])', 'json')
   .option('-l, --reference-language <lng>', 'Some format conversions need to know the reference language.', 'en')
   .option('-d, --dry <true|false>', 'Dry run (default: false)', 'false')
   .action((fileOrDirectory, options) => {

package/dist/cjs/convertToDesiredFormat.js

@@ -143,19 +143,17 @@ const convertToDesiredFormat = async (
     });
     return stringsFile.compile(data)
   }
-  if (
-    opt.format === 'xliff2' ||
-    opt.format === 'xliff12' ||
-    opt.format === 'xlf2' ||
-    opt.format === 'xlf12'
-  ) {
-    const fn =
-      opt.format === 'xliff12' || opt.format === 'xlf12'
-        ? xliff.createxliff12
-        : xliff.createxliff;
+  if (['xliff2', 'xliff21', 'xliff22', 'xliff12', 'xlf2', 'xlf21', 'xlf22', 'xlf12'].indexOf(opt.format) > -1) {
     const refNs = await opt.getNamespace(opt, opt.referenceLanguage, namespace);
     const prepared = combineSubkeyPreprocessor.prepareExport(refNs, flatten(data));
-    return await fn(opt.referenceLanguage, lng, prepared.ref, prepared.trg, namespace)
+    const js = await xliff.createjs(opt.referenceLanguage, lng, prepared.ref, prepared.trg, namespace);
+    if (opt.format === 'xliff12' || opt.format === 'xlf12') {
+      return await xliff.jsToXliff12(js, { inlineAsString: true })
+    }
+    let targetXliffVersion; // default 2.0
+    if (opt.format === 'xliff21' || opt.format === 'xlf21') targetXliffVersion = '2.1';
+    if (opt.format === 'xliff22' || opt.format === 'xlf22') targetXliffVersion = '2.2';
+    return await xliff.js2xliff(js, { targetXliffVersion, inlineAsString: true })
   }
   if (opt.format === 'resx') {
     return await resx.js2resx(flatten(data))

package/dist/cjs/convertToFlatFormat.js

@@ -116,17 +116,13 @@ const convertToFlatFormat = async (opt, data, lng) => {
     // CRLF => LF
     return stringsFile.parse(data.toString().replace(/\r\n/g, '\n'), false)
   }
-  if (
-    opt.format === 'xliff2' ||
-    opt.format === 'xliff12' ||
-    opt.format === 'xlf2' ||
-    opt.format === 'xlf12'
-  ) {
+  if (['xliff2', 'xliff21', 'xliff22', 'xliff12', 'xlf2', 'xlf21', 'xlf22', 'xlf12'].indexOf(opt.format) > -1) {
+    // xliff2js parses 2.0, 2.1 and 2.2
     const fn =
       opt.format === 'xliff12' || opt.format === 'xlf12'
         ? xliff.xliff12ToJs
         : xliff.xliff2js;
-    const res = await fn(data.toString());
+    const res = await fn(data.toString(), { inlineAsString: true });
     res.resources = res.resources || {};
     const ns = Object.keys(res.resources)[0];
     const orgRes = res.resources[ns] || res.resources;

package/dist/cjs/formats.js

@@ -10,8 +10,8 @@ const fileExtensionsMap = {
   '.yaml': ['yaml', 'yaml-rails', 'yaml-rails-ns', 'yaml-nested'],
   '.yml': ['yml', 'yml-rails', 'yml-rails-ns', 'yml-nested'],
   '.xlsx': ['xlsx'],
-  '.xliff': ['xliff2', 'xliff12'],
-  '.xlf': ['xlf2', 'xlf12'],
+  '.xliff': ['xliff2', 'xliff21', 'xliff22', 'xliff12'],
+  '.xlf': ['xlf2', 'xlf21', 'xlf22', 'xlf12'],
   '.ftl': ['fluent'],
   '.tmx': ['tmx'],
   '.php': ['laravel'],

package/dist/cjs/package.json

@@ -1,5 +1,5 @@
 {
   "name": "locize-cli",
-  "version": "12.3.0",
+  "version": "12.4.0",
   "type": "commonjs"
 }

package/dist/cjs/request.js

@@ -7,6 +7,10 @@ var CacheableLookup = require('cacheable-lookup');
 const cacheable = new CacheableLookup();
 cacheable.install(https.globalAgent);
 
+const RETRY_MAX_ATTEMPTS = 3;
+const RETRY_BASE_DELAY_MS = 2000;
+const RETRY_MAX_DELAY_MS = 30000;
+
 const httpProxy = process.env.http_proxy || process.env.HTTP_PROXY || process.env.https_proxy || process.env.HTTPS_PROXY;
 const isRetriableError = (err) => {
   return err && err.message && (
@@ -39,7 +43,7 @@ async function request (url, options) {
   }
 
   options.headers = options.headers || {};
-  options.headers['User-Agent'] = `locize-cli/v12.3.0 (node/${process.version}; ${process.platform} ${process.arch})`; // This string is replaced with the actual version at build time by rollup
+  options.headers['User-Agent'] = `locize-cli/v12.4.0 (node/${process.version}; ${process.platform} ${process.arch})`; // This string is replaced with the actual version at build time by rollup
   options.headers['X-User-Agent'] = options.headers['User-Agent'];
   if (options.body || options.method !== 'get') options.headers['Content-Type'] = 'application/json';
   if (options.body) {
@@ -49,19 +53,24 @@ async function request (url, options) {
   }
   if (options.headers['Authorization'] === undefined) delete options.headers['Authorization'];
 
-  async function retriableFetch (maxRetries) {
+  async function retriableFetch (retriesLeft, attempt = 0) {
     try {
       const response = await fetch(url, options);
       const result = await handleResponse(response);
       return result
     } catch (err) {
-      if (maxRetries < 1) throw err
+      if (retriesLeft < 1) throw err
       if (!isRetriableError(err)) throw err
-      await new Promise(resolve => setTimeout(resolve, 5000));
-      return retriableFetch(--maxRetries)
+      // Exponential backoff with equal jitter: spreads retries so a burst of
+      // concurrent CLI runs (e.g. CI) doesn't all retry in lockstep and
+      // hammer the API at the same instant.
+      const expDelay = Math.min(RETRY_MAX_DELAY_MS, RETRY_BASE_DELAY_MS * (2 ** attempt));
+      const delay = Math.round(expDelay / 2 + Math.random() * (expDelay / 2));
+      await new Promise(resolve => setTimeout(resolve, delay));
+      return retriableFetch(retriesLeft - 1, attempt + 1)
     }
   }
-  return retriableFetch(3)
+  return retriableFetch(RETRY_MAX_ATTEMPTS)
 }
 
 module.exports = request;

package/dist/esm/cli.js

@@ -48,7 +48,7 @@ const program = new Command();
 
 program
   .description('The official locize CLI.')
-  .version('12.3.0'); // This string is replaced with the actual version at build time by rollup
+  .version('12.4.0'); // This string is replaced with the actual version at build time by rollup
 // .option('-a, --api-endpoint <url>', `Specify the api-endpoint url that should be used (default: ${defaultApiEndpoint})`)
 // .option('-C, --config-path <configPath>', `Specify the path to the optional locize config file (default: ${configInWorkingDirectory} or ${configInHome})`);
 
@@ -261,7 +261,7 @@ program
   .option('-n, --namespace <ns>', 'The namespace that should be targeted')
   .option('-p, --path <path>', `Specify the path that should be used (default: ${process.cwd()})`, process.cwd())
   .option('-k, --api-key <apiKey>', 'The api-key that should be used')
-  .option('-f, --format <json>', 'File format of namespaces (default: json; [nested, flat, xliff2, xliff12, xlf2, xlf12, android, yaml, yaml-rails, yaml-rails-ns, yaml-nested, yml, yml-rails, yml-nested, csv, xlsx, po, strings, resx, fluent, tmx, laravel, properties, xcstrings])', 'json')
+  .option('-f, --format <json>', 'File format of namespaces (default: json; [nested, flat, xliff2, xliff21, xliff22, xliff12, xlf2, xlf21, xlf22, xlf12, android, yaml, yaml-rails, yaml-rails-ns, yaml-nested, yml, yml-rails, yml-nested, csv, xlsx, po, strings, resx, fluent, tmx, laravel, properties, xcstrings])', 'json')
   .option('-s, --skip-empty <true|false>', 'Skips to download empty files (default: true)', 'true')
   .option('-P, --language-folder-prefix <prefix>', 'This will be added as a local folder name prefix in front of the language.', '')
   .option('-m, --path-mask <mask>', 'This will define the folder and file structure; do not add a file extension (default: {{language}}/{{namespace}})', `{{language}}${path.sep}{{namespace}}`)
@@ -410,7 +410,7 @@ program
   .option('-p, --path <path>', `Specify the path that should be used (default: ${process.cwd()})`, process.cwd())
   .option('-B, --backup-deleted-path <path>', 'Saves the segments that will be deleted in this path')
   .option('-A, --auto-create-path <true|false>', 'This will automatically make sure the --path is created. (default: true)', 'true')
-  .option('-f, --format <json>', 'File format of namespaces (default: json; [nested, flat, xliff2, xliff12, xlf2, xlf12, android, yaml, yaml-rails, yaml-rails-ns, yaml-nested, yml, yml-rails, yml-nested, csv, xlsx, po, strings, resx, fluent, tmx, laravel, properties, xcstrings])', 'json')
+  .option('-f, --format <json>', 'File format of namespaces (default: json; [nested, flat, xliff2, xliff21, xliff22, xliff12, xlf2, xlf21, xlf22, xlf12, android, yaml, yaml-rails, yaml-rails-ns, yaml-nested, yml, yml-rails, yml-nested, csv, xlsx, po, strings, resx, fluent, tmx, laravel, properties, xcstrings])', 'json')
   .option('-s, --skip-empty <true|false>', 'Skips to download empty files (default: false)', 'false')
   .option('-c, --clean <true|false>', 'Removes all local files by removing the whole folder (default: false)', 'false')
   .option('--cf, --clean-local-files <true|false>', 'Removes all local files without removing any folder (default: false)', 'false')
@@ -538,7 +538,7 @@ program
   .option('-i, --project-id <projectId>', 'The project-id that should be used')
   .option('-v, --ver <version>', 'Found namespaces will be matched to this version (default: latest)')
   .option('-p, --path <path>', `Specify the path that should be used (default: ${process.cwd()})`, process.cwd())
-  .option('-f, --format <json>', 'File format of namespaces (default: json; [nested, flat, xliff2, xliff12, xlf2, xlf12, android, yaml, yaml-rails, yaml-rails-ns, yaml-nested, yml, yml-rails, yml-nested, csv, xlsx, po, strings, resx, fluent, tmx, laravel, properties, xcstrings])', 'json')
+  .option('-f, --format <json>', 'File format of namespaces (default: json; [nested, flat, xliff2, xliff21, xliff22, xliff12, xlf2, xlf21, xlf22, xlf12, android, yaml, yaml-rails, yaml-rails-ns, yaml-nested, yml, yml-rails, yml-nested, csv, xlsx, po, strings, resx, fluent, tmx, laravel, properties, xcstrings])', 'json')
   .option('-m, --path-mask <mask>', 'This will define the folder and file structure; do not add a file extension (default: {{language}}/{{namespace}})', `{{language}}${path.sep}{{namespace}}`)
   .option('-P, --language-folder-prefix <prefix>', 'This will be added as a local folder name prefix in front of the language.', '')
   .option('-d, --dry <true|false>', 'Dry run (default: false)', 'false')
@@ -833,7 +833,7 @@ program
   .command('format [fileOrDirectory]')
   .alias('ft')
   .description('format local files')
-  .option('-f, --format <json>', 'File format of namespaces (default: json; [nested, flat, xliff2, xliff12, xlf2, xlf12, android, yaml, yaml-rails, yaml-rails-ns, yaml-nested, yml, yml-rails, yml-nested, csv, xlsx, po, strings, resx, fluent, tmx, laravel, properties, xcstrings])', 'json')
+  .option('-f, --format <json>', 'File format of namespaces (default: json; [nested, flat, xliff2, xliff21, xliff22, xliff12, xlf2, xlf21, xlf22, xlf12, android, yaml, yaml-rails, yaml-rails-ns, yaml-nested, yml, yml-rails, yml-nested, csv, xlsx, po, strings, resx, fluent, tmx, laravel, properties, xcstrings])', 'json')
   .option('-l, --reference-language <lng>', 'Some format conversions need to know the reference language.', 'en')
   .option('-d, --dry <true|false>', 'Dry run (default: false)', 'false')
   .action((fileOrDirectory, options) => {

package/dist/esm/convertToDesiredFormat.js

@@ -141,19 +141,17 @@ const convertToDesiredFormat = async (
     });
     return stringsFile.compile(data)
   }
-  if (
-    opt.format === 'xliff2' ||
-    opt.format === 'xliff12' ||
-    opt.format === 'xlf2' ||
-    opt.format === 'xlf12'
-  ) {
-    const fn =
-      opt.format === 'xliff12' || opt.format === 'xlf12'
-        ? xliff.createxliff12
-        : xliff.createxliff;
+  if (['xliff2', 'xliff21', 'xliff22', 'xliff12', 'xlf2', 'xlf21', 'xlf22', 'xlf12'].indexOf(opt.format) > -1) {
     const refNs = await opt.getNamespace(opt, opt.referenceLanguage, namespace);
     const prepared = prepareExport(refNs, flatten(data));
-    return await fn(opt.referenceLanguage, lng, prepared.ref, prepared.trg, namespace)
+    const js = await xliff.createjs(opt.referenceLanguage, lng, prepared.ref, prepared.trg, namespace);
+    if (opt.format === 'xliff12' || opt.format === 'xlf12') {
+      return await xliff.jsToXliff12(js, { inlineAsString: true })
+    }
+    let targetXliffVersion; // default 2.0
+    if (opt.format === 'xliff21' || opt.format === 'xlf21') targetXliffVersion = '2.1';
+    if (opt.format === 'xliff22' || opt.format === 'xlf22') targetXliffVersion = '2.2';
+    return await xliff.js2xliff(js, { targetXliffVersion, inlineAsString: true })
   }
   if (opt.format === 'resx') {
     return await resx.js2resx(flatten(data))

package/dist/esm/convertToFlatFormat.js

@@ -114,17 +114,13 @@ const convertToFlatFormat = async (opt, data, lng) => {
     // CRLF => LF
     return stringsFile.parse(data.toString().replace(/\r\n/g, '\n'), false)
   }
-  if (
-    opt.format === 'xliff2' ||
-    opt.format === 'xliff12' ||
-    opt.format === 'xlf2' ||
-    opt.format === 'xlf12'
-  ) {
+  if (['xliff2', 'xliff21', 'xliff22', 'xliff12', 'xlf2', 'xlf21', 'xlf22', 'xlf12'].indexOf(opt.format) > -1) {
+    // xliff2js parses 2.0, 2.1 and 2.2
     const fn =
       opt.format === 'xliff12' || opt.format === 'xlf12'
         ? xliff.xliff12ToJs
         : xliff.xliff2js;
-    const res = await fn(data.toString());
+    const res = await fn(data.toString(), { inlineAsString: true });
     res.resources = res.resources || {};
     const ns = Object.keys(res.resources)[0];
     const orgRes = res.resources[ns] || res.resources;

package/dist/esm/formats.js

@@ -8,8 +8,8 @@ const fileExtensionsMap = {
   '.yaml': ['yaml', 'yaml-rails', 'yaml-rails-ns', 'yaml-nested'],
   '.yml': ['yml', 'yml-rails', 'yml-rails-ns', 'yml-nested'],
   '.xlsx': ['xlsx'],
-  '.xliff': ['xliff2', 'xliff12'],
-  '.xlf': ['xlf2', 'xlf12'],
+  '.xliff': ['xliff2', 'xliff21', 'xliff22', 'xliff12'],
+  '.xlf': ['xlf2', 'xlf21', 'xlf22', 'xlf12'],
   '.ftl': ['fluent'],
   '.tmx': ['tmx'],
   '.php': ['laravel'],

package/dist/esm/request.js

@@ -5,6 +5,10 @@ import CacheableLookup from 'cacheable-lookup';
 const cacheable = new CacheableLookup();
 cacheable.install(https.globalAgent);
 
+const RETRY_MAX_ATTEMPTS = 3;
+const RETRY_BASE_DELAY_MS = 2000;
+const RETRY_MAX_DELAY_MS = 30000;
+
 const httpProxy = process.env.http_proxy || process.env.HTTP_PROXY || process.env.https_proxy || process.env.HTTPS_PROXY;
 const isRetriableError = (err) => {
   return err && err.message && (
@@ -37,7 +41,7 @@ async function request (url, options) {
   }
 
   options.headers = options.headers || {};
-  options.headers['User-Agent'] = `locize-cli/v12.3.0 (node/${process.version}; ${process.platform} ${process.arch})`; // This string is replaced with the actual version at build time by rollup
+  options.headers['User-Agent'] = `locize-cli/v12.4.0 (node/${process.version}; ${process.platform} ${process.arch})`; // This string is replaced with the actual version at build time by rollup
   options.headers['X-User-Agent'] = options.headers['User-Agent'];
   if (options.body || options.method !== 'get') options.headers['Content-Type'] = 'application/json';
   if (options.body) {
@@ -47,19 +51,24 @@ async function request (url, options) {
   }
   if (options.headers['Authorization'] === undefined) delete options.headers['Authorization'];
 
-  async function retriableFetch (maxRetries) {
+  async function retriableFetch (retriesLeft, attempt = 0) {
     try {
       const response = await fetch(url, options);
       const result = await handleResponse(response);
       return result
     } catch (err) {
-      if (maxRetries < 1) throw err
+      if (retriesLeft < 1) throw err
       if (!isRetriableError(err)) throw err
-      await new Promise(resolve => setTimeout(resolve, 5000));
-      return retriableFetch(--maxRetries)
+      // Exponential backoff with equal jitter: spreads retries so a burst of
+      // concurrent CLI runs (e.g. CI) doesn't all retry in lockstep and
+      // hammer the API at the same instant.
+      const expDelay = Math.min(RETRY_MAX_DELAY_MS, RETRY_BASE_DELAY_MS * (2 ** attempt));
+      const delay = Math.round(expDelay / 2 + Math.random() * (expDelay / 2));
+      await new Promise(resolve => setTimeout(resolve, delay));
+      return retriableFetch(retriesLeft - 1, attempt + 1)
     }
   }
-  return retriableFetch(3)
+  return retriableFetch(RETRY_MAX_ATTEMPTS)
 }
 
 export { request as default };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "locize-cli",
-  "version": "12.3.0",
+  "version": "12.4.0",
   "description": "locize cli to import locales",
   "type": "module",
   "main": "./dist/cjs/index.js",
@@ -32,10 +32,10 @@
     "commander": "14.0.3",
     "diff": "8.0.4",
     "dotenv": "17.4.2",
-    "fast-csv": "5.0.5",
+    "fast-csv": "5.0.7",
     "flat": "5.0.2",
     "fluent_conv": "3.3.0",
-    "gettext-converter": "1.3.1",
+    "gettext-converter": "1.3.3",
     "https-proxy-agent": "7.0.6",
     "ini": "6.0.0",
     "laravelphp": "2.0.4",
@@ -46,20 +46,20 @@
     "rimraf": "6.1.3",
     "strings-file": "0.0.5",
     "tmexchange": "2.0.6",
-    "xliff": "6.3.0",
+    "xliff": "6.4.0",
     "xlsx": "https://cdn.sheetjs.com/xlsx-0.20.3/xlsx-0.20.3.tgz",
-    "yaml": "2.8.3"
+    "yaml": "2.9.0"
   },
   "devDependencies": {
     "@rollup/plugin-replace": "6.0.3",
-    "@rollup/plugin-terser": "0.4.4",
-    "@yao-pkg/pkg": "6.14.2",
+    "@rollup/plugin-terser": "1.0.0",
+    "@yao-pkg/pkg": "6.21.0",
     "eslint": "9.39.2",
     "eslint-plugin-import": "2.32.0",
-    "gh-release": "7.0.2",
+    "gh-release": "8.1.0",
     "neostandard": "0.13.0",
-    "rollup": "4.60.1",
-    "vitest": "4.1.4"
+    "rollup": "4.62.2",
+    "vitest": "4.1.10"
   },
   "scripts": {
     "lint": "eslint .",
@@ -67,10 +67,10 @@
     "test:watch": "vitest",
     "test": "npm run lint && vitest run",
     "pkg": "mkdir -p ./bins && pkg ./dist/cjs/cli.js --output ./bins/locize --targets node24-linux-x64,node24-macos-x64,node24-win-x64,node24-alpine-x64",
-    "release": "gh-release --assets ./bins/locize-linux,./bins/locize-macos,./bins/locize-win.exe,./bins/locize-alpine",
+    "release": "GH_RELEASE_GITHUB_API_TOKEN=$(gh auth token) gh-release --assets ./bins/locize-linux,./bins/locize-macos,./bins/locize-win.exe,./bins/locize-alpine",
     "preversion": "npm run test",
     "version": "npm run build && npm run pkg",
-    "postversion": "git push && npm run release"
+    "postversion": "git push --follow-tags && npm run release"
   },
   "keywords": [
     "cli",