locize-cli 12.3.0 → 12.3.1

package/CHANGELOG.md

@@ -5,6 +5,13 @@ 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.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/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.3.1'); // 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})`);
 

package/dist/cjs/package.json

@@ -1,5 +1,5 @@
 {
   "name": "locize-cli",
-  "version": "12.3.0",
+  "version": "12.3.1",
   "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.3.1 (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.3.1'); // 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})`);
 

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.3.1 (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.3.1",
   "description": "locize cli to import locales",
   "type": "module",
   "main": "./dist/cjs/index.js",