lingo.dev 0.111.4 → 0.111.5

package/build/cli.cjs

@@ -1,4 +1,4 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }// src/cli/index.ts
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireWildcard(obj) { if (obj && obj.__esModule) { return obj; } else { var newObj = {}; if (obj != null) { for (var key in obj) { if (Object.prototype.hasOwnProperty.call(obj, key)) { newObj[key] = obj[key]; } } } newObj.default = obj; return newObj; } } function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; } var _class; var _class2; var _class3; var _class4; var _class5; var _class6;// src/cli/index.ts
 var _dotenv = require('dotenv'); var _dotenv2 = _interopRequireDefault(_dotenv);
 var _interactivecommander = require('interactive-commander');
 var _figlet = require('figlet'); var _figlet2 = _interopRequireDefault(_figlet);
@@ -214,15 +214,147 @@ var docLinks = {
   invalidBucketType: "https://lingo.dev/cli",
   invalidStringDict: "https://lingo.dev/cli"
 };
-var CLIError = class extends Error {
+var CLIError = (_class = class extends Error {
   
+  __init() {this.errorType = "cli_error"}
   constructor({ message, docUrl }) {
-    super(message);
+    super(message);_class.prototype.__init.call(this);;
     this.docUrl = docLinks[docUrl];
     this.message = `${this.message}
  visit: ${this.docUrl}`;
   }
-};
+}, _class);
+var ConfigError = (_class2 = class extends CLIError {
+  __init2() {this.errorType = "config_error"}
+  constructor({ message, docUrl }) {
+    super({ message, docUrl });_class2.prototype.__init2.call(this);;
+    this.name = "ConfigError";
+  }
+}, _class2);
+var AuthenticationError = (_class3 = class extends CLIError {
+  __init3() {this.errorType = "auth_error"}
+  constructor({ message, docUrl }) {
+    super({ message, docUrl });_class3.prototype.__init3.call(this);;
+    this.name = "AuthenticationError";
+  }
+}, _class3);
+var ValidationError = (_class4 = class extends CLIError {
+  __init4() {this.errorType = "validation_error"}
+  constructor({ message, docUrl }) {
+    super({ message, docUrl });_class4.prototype.__init4.call(this);;
+    this.name = "ValidationError";
+  }
+}, _class4);
+var LocalizationError = (_class5 = class extends Error {
+  __init5() {this.errorType = "locale_error"}
+  
+  
+  
+  
+  constructor(message, context) {
+    super(message);_class5.prototype.__init5.call(this);;
+    this.name = "LocalizationError";
+    this.bucket = _optionalChain([context, 'optionalAccess', _68 => _68.bucket]);
+    this.sourceLocale = _optionalChain([context, 'optionalAccess', _69 => _69.sourceLocale]);
+    this.targetLocale = _optionalChain([context, 'optionalAccess', _70 => _70.targetLocale]);
+    this.pathPattern = _optionalChain([context, 'optionalAccess', _71 => _71.pathPattern]);
+  }
+}, _class5);
+var BucketProcessingError = (_class6 = class extends Error {
+  __init6() {this.errorType = "bucket_error"}
+  
+  constructor(message, bucket) {
+    super(message);_class6.prototype.__init6.call(this);;
+    this.name = "BucketProcessingError";
+    this.bucket = bucket;
+  }
+}, _class6);
+function isConfigError(error) {
+  return error instanceof ConfigError || error.errorType === "config_error";
+}
+function isAuthenticationError(error) {
+  return error instanceof AuthenticationError || error.errorType === "auth_error";
+}
+function isValidationError(error) {
+  return error instanceof ValidationError || error.errorType === "validation_error";
+}
+function isLocalizationError(error) {
+  return error instanceof LocalizationError || error.errorType === "locale_error";
+}
+function isBucketProcessingError(error) {
+  return error instanceof BucketProcessingError || error.errorType === "bucket_error";
+}
+function getCLIErrorType(error) {
+  if (isConfigError(error)) return "config_error";
+  if (isAuthenticationError(error)) return "auth_error";
+  if (isValidationError(error)) return "validation_error";
+  if (isLocalizationError(error)) return "locale_error";
+  if (isBucketProcessingError(error)) return "bucket_error";
+  if (error instanceof CLIError) return "cli_error";
+  return "unknown_error";
+}
+function createPreviousErrorContext(errorDetails) {
+  if (errorDetails.length === 0) return void 0;
+  return {
+    count: errorDetails.length,
+    types: [...new Set(errorDetails.map((e) => e.type))],
+    buckets: [...new Set(errorDetails.map((e) => e.bucket).filter(Boolean))]
+  };
+}
+function aggregateErrorAnalytics(errorDetails, buckets, targetLocales, i18nConfig) {
+  if (errorDetails.length === 0) {
+    return {
+      errorCount: 0,
+      errorTypes: [],
+      errorsByBucket: {},
+      errorsByType: {},
+      firstError: void 0,
+      bucketCount: buckets.length,
+      localeCount: targetLocales.length,
+      i18nConfig: {
+        sourceLocale: i18nConfig.locale.source,
+        targetLocales: i18nConfig.locale.targets,
+        bucketTypes: Object.keys(i18nConfig.buckets)
+      }
+    };
+  }
+  const errorsByBucket = errorDetails.reduce(
+    (acc, error) => {
+      if (error.bucket) {
+        acc[error.bucket] = (acc[error.bucket] || 0) + 1;
+      }
+      return acc;
+    },
+    {}
+  );
+  const errorsByType = errorDetails.reduce(
+    (acc, error) => {
+      acc[error.type] = (acc[error.type] || 0) + 1;
+      return acc;
+    },
+    {}
+  );
+  return {
+    errorCount: errorDetails.length,
+    errorTypes: [...new Set(errorDetails.map((e) => e.type))],
+    errorsByBucket,
+    errorsByType,
+    firstError: {
+      type: errorDetails[0].type,
+      bucket: errorDetails[0].bucket,
+      locale: errorDetails[0].locale,
+      pathPattern: errorDetails[0].pathPattern,
+      message: errorDetails[0].message
+    },
+    bucketCount: buckets.length,
+    localeCount: targetLocales.length,
+    i18nConfig: {
+      sourceLocale: i18nConfig.locale.source,
+      targetLocales: i18nConfig.locale.targets,
+      bucketTypes: Object.keys(i18nConfig.buckets)
+    }
+  };
+}
 
 // src/cli/utils/cloudflare-status.ts
 async function checkCloudflareStatus() {
@@ -261,7 +393,7 @@ function createAuthenticator(params) {
         });
         if (res.ok) {
           const payload = await res.json();
-          if (!_optionalChain([payload, 'optionalAccess', _68 => _68.email])) {
+          if (!_optionalChain([payload, 'optionalAccess', _72 => _72.email])) {
             return null;
           }
           return {
@@ -1088,7 +1220,7 @@ var init_default = new (0, _interactivecommander.InteractiveCommand)().command("
         });
         const auth2 = await newAuthenticator.whoami();
         if (auth2) {
-          _ora2.default.call(void 0, ).succeed(`Authenticated as ${_optionalChain([auth2, 'optionalAccess', _69 => _69.email])}`);
+          _ora2.default.call(void 0, ).succeed(`Authenticated as ${_optionalChain([auth2, 'optionalAccess', _73 => _73.email])}`);
         } else {
           _ora2.default.call(void 0, ).fail("Authentication failed.");
         }
@@ -1175,7 +1307,7 @@ function getBuckets(i18nConfig) {
       const includeItems = bucketEntry.include.map(
         (item) => resolveBucketItem(item)
       );
-      const excludeItems = _optionalChain([bucketEntry, 'access', _70 => _70.exclude, 'optionalAccess', _71 => _71.map, 'call', _72 => _72(
+      const excludeItems = _optionalChain([bucketEntry, 'access', _74 => _74.exclude, 'optionalAccess', _75 => _75.map, 'call', _76 => _76(
         (item) => resolveBucketItem(item)
       )]);
       const config = {
@@ -1213,7 +1345,7 @@ function extractPathPatterns(sourceLocale, include, exclude) {
       delimiter: pattern.delimiter
     }))
   );
-  const excludedPatterns = _optionalChain([exclude, 'optionalAccess', _73 => _73.flatMap, 'call', _74 => _74(
+  const excludedPatterns = _optionalChain([exclude, 'optionalAccess', _77 => _77.flatMap, 'call', _78 => _78(
     (pattern) => expandPlaceholderedGlob(
       pattern.path,
       __spec.resolveOverriddenLocale.call(void 0, sourceLocale, pattern.delimiter)
@@ -1503,12 +1635,12 @@ function composeLoaders(...loaders) {
   return {
     init: async () => {
       for (const loader of loaders) {
-        await _optionalChain([loader, 'access', _75 => _75.init, 'optionalCall', _76 => _76()]);
+        await _optionalChain([loader, 'access', _79 => _79.init, 'optionalCall', _80 => _80()]);
       }
     },
     setDefaultLocale(locale) {
       for (const loader of loaders) {
-        _optionalChain([loader, 'access', _77 => _77.setDefaultLocale, 'optionalCall', _78 => _78(locale)]);
+        _optionalChain([loader, 'access', _81 => _81.setDefaultLocale, 'optionalCall', _82 => _82(locale)]);
       }
       return this;
     },
@@ -1529,7 +1661,7 @@ function composeLoaders(...loaders) {
     pullHints: async (originalInput) => {
       let result = originalInput;
       for (let i = 0; i < loaders.length; i++) {
-        const subResult = await _optionalChain([loaders, 'access', _79 => _79[i], 'access', _80 => _80.pullHints, 'optionalCall', _81 => _81(result)]);
+        const subResult = await _optionalChain([loaders, 'access', _83 => _83[i], 'access', _84 => _84.pullHints, 'optionalCall', _85 => _85(result)]);
         if (subResult) {
           result = subResult;
         }
@@ -1551,7 +1683,7 @@ function createLoader(lDefinition) {
       if (state.initCtx) {
         return state.initCtx;
       }
-      state.initCtx = await _optionalChain([lDefinition, 'access', _82 => _82.init, 'optionalCall', _83 => _83()]);
+      state.initCtx = await _optionalChain([lDefinition, 'access', _86 => _86.init, 'optionalCall', _87 => _87()]);
       return state.initCtx;
     },
     setDefaultLocale(locale) {
@@ -1562,7 +1694,7 @@ function createLoader(lDefinition) {
       return this;
     },
     async pullHints() {
-      return _optionalChain([lDefinition, 'access', _84 => _84.pullHints, 'optionalCall', _85 => _85(state.originalInput)]);
+      return _optionalChain([lDefinition, 'access', _88 => _88.pullHints, 'optionalCall', _89 => _89(state.originalInput)]);
     },
     async pull(locale, input2) {
       if (!state.defaultLocale) {
@@ -1867,7 +1999,7 @@ function createNormalizeLoader() {
       return normalized;
     },
     push: async (locale, data, originalInput) => {
-      const keysMap = _nullishCoalesce(_optionalChain([originalInput, 'optionalAccess', _86 => _86.keysMap]), () => ( {}));
+      const keysMap = _nullishCoalesce(_optionalChain([originalInput, 'optionalAccess', _90 => _90.keysMap]), () => ( {}));
       const input2 = mapDenormalizedKeys(data, keysMap);
       const denormalized = _flat.unflatten.call(void 0, input2, {
         delimiter: "/",
@@ -2001,8 +2133,8 @@ async function getTrailingNewLine(pathPattern, locale, originalLocale) {
   if (!templateData) {
     templateData = await readFileForLocale(pathPattern, originalLocale);
   }
-  if (_optionalChain([templateData, 'optionalAccess', _87 => _87.match, 'call', _88 => _88(/[\r\n]$/)])) {
-    const ending = _optionalChain([templateData, 'optionalAccess', _89 => _89.includes, 'call', _90 => _90("\r\n")]) ? "\r\n" : _optionalChain([templateData, 'optionalAccess', _91 => _91.includes, 'call', _92 => _92("\r")]) ? "\r" : "\n";
+  if (_optionalChain([templateData, 'optionalAccess', _91 => _91.match, 'call', _92 => _92(/[\r\n]$/)])) {
+    const ending = _optionalChain([templateData, 'optionalAccess', _93 => _93.includes, 'call', _94 => _94("\r\n")]) ? "\r\n" : _optionalChain([templateData, 'optionalAccess', _95 => _95.includes, 'call', _96 => _96("\r")]) ? "\r" : "\n";
     return ending;
   }
   return "";
@@ -2273,7 +2405,7 @@ var _sync3 = require('csv-stringify/sync');
 
 function detectKeyColumnName(csvString) {
   const row = _sync.parse.call(void 0, csvString)[0];
-  const firstColumn = _optionalChain([row, 'optionalAccess', _93 => _93[0], 'optionalAccess', _94 => _94.trim, 'call', _95 => _95()]);
+  const firstColumn = _optionalChain([row, 'optionalAccess', _97 => _97[0], 'optionalAccess', _98 => _98.trim, 'call', _99 => _99()]);
   return firstColumn || "KEY";
 }
 function createCsvLoader() {
@@ -2375,7 +2507,7 @@ function createHtmlLoader() {
             break;
           }
           const siblings = Array.from(parent.childNodes).filter(
-            (n) => n.nodeType === 1 || n.nodeType === 3 && _optionalChain([n, 'access', _96 => _96.textContent, 'optionalAccess', _97 => _97.trim, 'call', _98 => _98()])
+            (n) => n.nodeType === 1 || n.nodeType === 3 && _optionalChain([n, 'access', _100 => _100.textContent, 'optionalAccess', _101 => _101.trim, 'call', _102 => _102()])
           );
           const index = siblings.indexOf(current);
           if (index !== -1) {
@@ -2411,15 +2543,15 @@ function createHtmlLoader() {
             }
           });
           Array.from(element.childNodes).filter(
-            (n) => n.nodeType === 1 || n.nodeType === 3 && _optionalChain([n, 'access', _99 => _99.textContent, 'optionalAccess', _100 => _100.trim, 'call', _101 => _101()])
+            (n) => n.nodeType === 1 || n.nodeType === 3 && _optionalChain([n, 'access', _103 => _103.textContent, 'optionalAccess', _104 => _104.trim, 'call', _105 => _105()])
           ).forEach(processNode);
         }
       };
       Array.from(document.head.childNodes).filter(
-        (n) => n.nodeType === 1 || n.nodeType === 3 && _optionalChain([n, 'access', _102 => _102.textContent, 'optionalAccess', _103 => _103.trim, 'call', _104 => _104()])
+        (n) => n.nodeType === 1 || n.nodeType === 3 && _optionalChain([n, 'access', _106 => _106.textContent, 'optionalAccess', _107 => _107.trim, 'call', _108 => _108()])
       ).forEach(processNode);
       Array.from(document.body.childNodes).filter(
-        (n) => n.nodeType === 1 || n.nodeType === 3 && _optionalChain([n, 'access', _105 => _105.textContent, 'optionalAccess', _106 => _106.trim, 'call', _107 => _107()])
+        (n) => n.nodeType === 1 || n.nodeType === 3 && _optionalChain([n, 'access', _109 => _109.textContent, 'optionalAccess', _110 => _110.trim, 'call', _111 => _111()])
       ).forEach(processNode);
       return result;
     },
@@ -2444,7 +2576,7 @@ function createHtmlLoader() {
         for (let i = 0; i < indices.length; i++) {
           const index = parseInt(indices[i]);
           const siblings = Array.from(parent.childNodes).filter(
-            (n) => n.nodeType === 1 || n.nodeType === 3 && _optionalChain([n, 'access', _108 => _108.textContent, 'optionalAccess', _109 => _109.trim, 'call', _110 => _110()])
+            (n) => n.nodeType === 1 || n.nodeType === 3 && _optionalChain([n, 'access', _112 => _112.textContent, 'optionalAccess', _113 => _113.trim, 'call', _114 => _114()])
           );
           if (index >= siblings.length) {
             if (i === indices.length - 1) {
@@ -2495,7 +2627,7 @@ function createMarkdownLoader() {
           yaml: yamlEngine
         }
       });
-      const sections = content.split(SECTION_REGEX).map((section) => _nullishCoalesce(_optionalChain([section, 'optionalAccess', _111 => _111.trim, 'call', _112 => _112()]), () => ( ""))).filter(Boolean);
+      const sections = content.split(SECTION_REGEX).map((section) => _nullishCoalesce(_optionalChain([section, 'optionalAccess', _115 => _115.trim, 'call', _116 => _116()]), () => ( ""))).filter(Boolean);
       return {
         ...Object.fromEntries(
           sections.map((section, index) => [`${MD_SECTION_PREFIX}${index}`, section]).filter(([, section]) => Boolean(section))
@@ -2514,7 +2646,7 @@ function createMarkdownLoader() {
       );
       let content = Object.entries(data).filter(([key]) => key.startsWith(MD_SECTION_PREFIX)).sort(
         ([a], [b]) => Number(a.split("-").pop()) - Number(b.split("-").pop())
-      ).map(([, value]) => _nullishCoalesce(_optionalChain([value, 'optionalAccess', _113 => _113.trim, 'call', _114 => _114()]), () => ( ""))).filter(Boolean).join("\n\n");
+      ).map(([, value]) => _nullishCoalesce(_optionalChain([value, 'optionalAccess', _117 => _117.trim, 'call', _118 => _118()]), () => ( ""))).filter(Boolean).join("\n\n");
       if (Object.keys(frontmatter).length > 0) {
         content = `
 ${content}`;
@@ -2558,7 +2690,7 @@ function isSkippableLine(line) {
 function parsePropertyLine(line) {
   const [key, ...valueParts] = line.split("=");
   return {
-    key: _optionalChain([key, 'optionalAccess', _115 => _115.trim, 'call', _116 => _116()]) || "",
+    key: _optionalChain([key, 'optionalAccess', _119 => _119.trim, 'call', _120 => _120()]) || "",
     value: valueParts.join("=").trim()
   };
 }
@@ -2646,7 +2778,7 @@ function createXcodeXcstringsLoader(defaultLocale) {
         if (rootTranslationEntity.shouldTranslate === false) {
           continue;
         }
-        const langTranslationEntity = _optionalChain([rootTranslationEntity, 'optionalAccess', _117 => _117.localizations, 'optionalAccess', _118 => _118[locale]]);
+        const langTranslationEntity = _optionalChain([rootTranslationEntity, 'optionalAccess', _121 => _121.localizations, 'optionalAccess', _122 => _122[locale]]);
         if (langTranslationEntity) {
           if ("stringUnit" in langTranslationEntity) {
             resultData[translationKey] = langTranslationEntity.stringUnit.value;
@@ -2655,7 +2787,7 @@ function createXcodeXcstringsLoader(defaultLocale) {
               resultData[translationKey] = {};
               const pluralForms = langTranslationEntity.variations.plural;
               for (const form in pluralForms) {
-                if (_optionalChain([pluralForms, 'access', _119 => _119[form], 'optionalAccess', _120 => _120.stringUnit, 'optionalAccess', _121 => _121.value])) {
+                if (_optionalChain([pluralForms, 'access', _123 => _123[form], 'optionalAccess', _124 => _124.stringUnit, 'optionalAccess', _125 => _125.value])) {
                   resultData[translationKey][form] = pluralForms[form].stringUnit.value;
                 }
               }
@@ -2681,7 +2813,7 @@ function createXcodeXcstringsLoader(defaultLocale) {
         const hasDoNotTranslateFlag = originalInput && originalInput.strings && originalInput.strings[key] && originalInput.strings[key].shouldTranslate === false;
         if (typeof value === "string") {
           langDataToMerge.strings[key] = {
-            extractionState: _optionalChain([originalInput, 'optionalAccess', _122 => _122.strings, 'optionalAccess', _123 => _123[key], 'optionalAccess', _124 => _124.extractionState]),
+            extractionState: _optionalChain([originalInput, 'optionalAccess', _126 => _126.strings, 'optionalAccess', _127 => _127[key], 'optionalAccess', _128 => _128.extractionState]),
             localizations: {
               [locale]: {
                 stringUnit: {
@@ -2739,7 +2871,7 @@ function createXcodeXcstringsLoader(defaultLocale) {
           for (const [locale, localization] of Object.entries(
             entity.localizations
           )) {
-            if (_optionalChain([localization, 'access', _125 => _125.variations, 'optionalAccess', _126 => _126.plural])) {
+            if (_optionalChain([localization, 'access', _129 => _129.variations, 'optionalAccess', _130 => _130.plural])) {
               const pluralForms = localization.variations.plural;
               for (const form in pluralForms) {
                 const pluralKey = `${translationKey}/${form}`;
@@ -2759,7 +2891,7 @@ function _removeLocale(input2, locale) {
   const { strings } = input2;
   const newStrings = _lodash2.default.cloneDeep(strings);
   for (const [key, value] of Object.entries(newStrings)) {
-    if (_optionalChain([value, 'access', _127 => _127.localizations, 'optionalAccess', _128 => _128[locale]])) {
+    if (_optionalChain([value, 'access', _131 => _131.localizations, 'optionalAccess', _132 => _132[locale]])) {
       delete value.localizations[locale];
     }
   }
@@ -2919,7 +3051,7 @@ function createPoDataLoader(params) {
         Object.entries(entries).forEach(([msgid, entry]) => {
           if (msgid && entry.msgid) {
             const context = entry.msgctxt || "";
-            const fullEntry = _optionalChain([parsedPo, 'access', _129 => _129.translations, 'access', _130 => _130[context], 'optionalAccess', _131 => _131[msgid]]);
+            const fullEntry = _optionalChain([parsedPo, 'access', _133 => _133.translations, 'access', _134 => _134[context], 'optionalAccess', _135 => _135[msgid]]);
             if (fullEntry) {
               result[msgid] = fullEntry;
             }
@@ -2929,8 +3061,8 @@ function createPoDataLoader(params) {
       return result;
     },
     async push(locale, data, originalInput, originalLocale, pullInput) {
-      const currentSections = _optionalChain([pullInput, 'optionalAccess', _132 => _132.split, 'call', _133 => _133("\n\n"), 'access', _134 => _134.filter, 'call', _135 => _135(Boolean)]) || [];
-      const originalSections = _optionalChain([originalInput, 'optionalAccess', _136 => _136.split, 'call', _137 => _137("\n\n"), 'access', _138 => _138.filter, 'call', _139 => _139(Boolean)]) || [];
+      const currentSections = _optionalChain([pullInput, 'optionalAccess', _136 => _136.split, 'call', _137 => _137("\n\n"), 'access', _138 => _138.filter, 'call', _139 => _139(Boolean)]) || [];
+      const originalSections = _optionalChain([originalInput, 'optionalAccess', _140 => _140.split, 'call', _141 => _141("\n\n"), 'access', _142 => _142.filter, 'call', _143 => _143(Boolean)]) || [];
       const result = originalSections.map((section) => {
         const sectionPo = _gettextparser2.default.po.parse(section);
         if (Object.keys(sectionPo.translations).length === 0) {
@@ -2999,8 +3131,8 @@ function createPoContentLoader() {
         {
           ...entry,
           msgstr: [
-            _optionalChain([data, 'access', _140 => _140[entry.msgid], 'optionalAccess', _141 => _141.singular]),
-            _optionalChain([data, 'access', _142 => _142[entry.msgid], 'optionalAccess', _143 => _143.plural]) || null
+            _optionalChain([data, 'access', _144 => _144[entry.msgid], 'optionalAccess', _145 => _145.singular]),
+            _optionalChain([data, 'access', _146 => _146[entry.msgid], 'optionalAccess', _147 => _147.plural]) || null
           ].filter(Boolean)
         }
       ]).fromPairs().value();
@@ -3122,7 +3254,7 @@ function pullV1(xliffElement, locale, originalLocale) {
     let key = getTransUnitKey(unit);
     if (!key) return;
     if (seenKeys.has(key)) {
-      const id = _optionalChain([unit, 'access', _144 => _144.getAttribute, 'call', _145 => _145("id"), 'optionalAccess', _146 => _146.trim, 'call', _147 => _147()]);
+      const id = _optionalChain([unit, 'access', _148 => _148.getAttribute, 'call', _149 => _149("id"), 'optionalAccess', _150 => _150.trim, 'call', _151 => _151()]);
       if (id) {
         key = `${key}#${id}`;
       } else {
@@ -3170,7 +3302,7 @@ function pushV1(dom, xliffElement, locale, translations, originalLocale, origina
     let key = getTransUnitKey(unit);
     if (!key) return;
     if (seenKeys.has(key)) {
-      const id = _optionalChain([unit, 'access', _148 => _148.getAttribute, 'call', _149 => _149("id"), 'optionalAccess', _150 => _150.trim, 'call', _151 => _151()]);
+      const id = _optionalChain([unit, 'access', _152 => _152.getAttribute, 'call', _153 => _153("id"), 'optionalAccess', _154 => _154.trim, 'call', _155 => _155()]);
       if (id) {
         key = `${key}#${id}`;
       } else {
@@ -3212,7 +3344,7 @@ function pushV1(dom, xliffElement, locale, translations, originalLocale, origina
   const translationKeys = new Set(Object.keys(translations));
   existingUnits.forEach((unit, key) => {
     if (!translationKeys.has(key)) {
-      _optionalChain([unit, 'access', _152 => _152.parentNode, 'optionalAccess', _153 => _153.removeChild, 'call', _154 => _154(unit)]);
+      _optionalChain([unit, 'access', _156 => _156.parentNode, 'optionalAccess', _157 => _157.removeChild, 'call', _158 => _158(unit)]);
     }
   });
   return serializeWithDeclaration(
@@ -3255,18 +3387,18 @@ function traverseUnitsV2(container, fileId, currentPath, result) {
   Array.from(container.children).forEach((child) => {
     const tagName = child.tagName;
     if (tagName === "unit") {
-      const unitId = _optionalChain([child, 'access', _155 => _155.getAttribute, 'call', _156 => _156("id"), 'optionalAccess', _157 => _157.trim, 'call', _158 => _158()]);
+      const unitId = _optionalChain([child, 'access', _159 => _159.getAttribute, 'call', _160 => _160("id"), 'optionalAccess', _161 => _161.trim, 'call', _162 => _162()]);
       if (!unitId) return;
       const key = `resources/${fileId}/${currentPath}${unitId}/source`;
       const segment = child.querySelector("segment");
-      const source = _optionalChain([segment, 'optionalAccess', _159 => _159.querySelector, 'call', _160 => _160("source")]);
+      const source = _optionalChain([segment, 'optionalAccess', _163 => _163.querySelector, 'call', _164 => _164("source")]);
       if (source) {
         result[key] = extractTextContent(source);
       } else {
         result[key] = unitId;
       }
     } else if (tagName === "group") {
-      const groupId = _optionalChain([child, 'access', _161 => _161.getAttribute, 'call', _162 => _162("id"), 'optionalAccess', _163 => _163.trim, 'call', _164 => _164()]);
+      const groupId = _optionalChain([child, 'access', _165 => _165.getAttribute, 'call', _166 => _166("id"), 'optionalAccess', _167 => _167.trim, 'call', _168 => _168()]);
       const newPath = groupId ? `${currentPath}${groupId}/groupUnits/` : currentPath;
       traverseUnitsV2(child, fileId, newPath, result);
     }
@@ -3302,12 +3434,12 @@ function indexUnitsV2(container, fileId, currentPath, index) {
   Array.from(container.children).forEach((child) => {
     const tagName = child.tagName;
     if (tagName === "unit") {
-      const unitId = _optionalChain([child, 'access', _165 => _165.getAttribute, 'call', _166 => _166("id"), 'optionalAccess', _167 => _167.trim, 'call', _168 => _168()]);
+      const unitId = _optionalChain([child, 'access', _169 => _169.getAttribute, 'call', _170 => _170("id"), 'optionalAccess', _171 => _171.trim, 'call', _172 => _172()]);
       if (!unitId) return;
       const key = `resources/${fileId}/${currentPath}${unitId}/source`;
       index.set(key, child);
     } else if (tagName === "group") {
-      const groupId = _optionalChain([child, 'access', _169 => _169.getAttribute, 'call', _170 => _170("id"), 'optionalAccess', _171 => _171.trim, 'call', _172 => _172()]);
+      const groupId = _optionalChain([child, 'access', _173 => _173.getAttribute, 'call', _174 => _174("id"), 'optionalAccess', _175 => _175.trim, 'call', _176 => _176()]);
       const newPath = groupId ? `${currentPath}${groupId}/groupUnits/` : currentPath;
       indexUnitsV2(child, fileId, newPath, index);
     }
@@ -3328,9 +3460,9 @@ function updateUnitV2(unit, value) {
   setTextContent(source, value);
 }
 function getTransUnitKey(transUnit) {
-  const resname = _optionalChain([transUnit, 'access', _173 => _173.getAttribute, 'call', _174 => _174("resname"), 'optionalAccess', _175 => _175.trim, 'call', _176 => _176()]);
+  const resname = _optionalChain([transUnit, 'access', _177 => _177.getAttribute, 'call', _178 => _178("resname"), 'optionalAccess', _179 => _179.trim, 'call', _180 => _180()]);
   if (resname) return resname;
-  const id = _optionalChain([transUnit, 'access', _177 => _177.getAttribute, 'call', _178 => _178("id"), 'optionalAccess', _179 => _179.trim, 'call', _180 => _180()]);
+  const id = _optionalChain([transUnit, 'access', _181 => _181.getAttribute, 'call', _182 => _182("id"), 'optionalAccess', _183 => _183.trim, 'call', _184 => _184()]);
   if (id) return id;
   const sourceElement = transUnit.querySelector("source");
   if (sourceElement) {
@@ -3387,7 +3519,7 @@ function formatXml(xml) {
     if (cdataNode) {
       return `${indent2}${openTag}<![CDATA[${cdataNode.nodeValue}]]></${tagName}>`;
     }
-    const textContent = _optionalChain([element, 'access', _181 => _181.textContent, 'optionalAccess', _182 => _182.trim, 'call', _183 => _183()]) || "";
+    const textContent = _optionalChain([element, 'access', _185 => _185.textContent, 'optionalAccess', _186 => _186.trim, 'call', _187 => _187()]) || "";
     const hasOnlyText = element.childNodes.length === 1 && element.childNodes[0].nodeType === 3;
     if (hasOnlyText && textContent) {
       return `${indent2}${openTag}${textContent}</${tagName}>`;
@@ -3680,7 +3812,7 @@ function createDatoClient(params) {
           ids: !records.length ? void 0 : records.join(",")
         }
       }).catch(
-        (error) => Promise.reject(_optionalChain([error, 'optionalAccess', _184 => _184.response, 'optionalAccess', _185 => _185.body, 'optionalAccess', _186 => _186.data, 'optionalAccess', _187 => _187[0]]) || error)
+        (error) => Promise.reject(_optionalChain([error, 'optionalAccess', _188 => _188.response, 'optionalAccess', _189 => _189.body, 'optionalAccess', _190 => _190.data, 'optionalAccess', _191 => _191[0]]) || error)
       );
     },
     findRecordsForModel: async (modelId, records) => {
@@ -3691,10 +3823,10 @@ function createDatoClient(params) {
           filter: {
             type: modelId,
             only_valid: "true",
-            ids: !_optionalChain([records, 'optionalAccess', _188 => _188.length]) ? void 0 : records.join(",")
+            ids: !_optionalChain([records, 'optionalAccess', _192 => _192.length]) ? void 0 : records.join(",")
           }
         }).catch(
-          (error) => Promise.reject(_optionalChain([error, 'optionalAccess', _189 => _189.response, 'optionalAccess', _190 => _190.body, 'optionalAccess', _191 => _191.data, 'optionalAccess', _192 => _192[0]]) || error)
+          (error) => Promise.reject(_optionalChain([error, 'optionalAccess', _193 => _193.response, 'optionalAccess', _194 => _194.body, 'optionalAccess', _195 => _195.data, 'optionalAccess', _196 => _196[0]]) || error)
         );
         return result;
       } catch (_error) {
@@ -3710,10 +3842,10 @@ function createDatoClient(params) {
     updateRecord: async (id, payload) => {
       try {
         await dato.items.update(id, payload).catch(
-          (error) => Promise.reject(_optionalChain([error, 'optionalAccess', _193 => _193.response, 'optionalAccess', _194 => _194.body, 'optionalAccess', _195 => _195.data, 'optionalAccess', _196 => _196[0]]) || error)
+          (error) => Promise.reject(_optionalChain([error, 'optionalAccess', _197 => _197.response, 'optionalAccess', _198 => _198.body, 'optionalAccess', _199 => _199.data, 'optionalAccess', _200 => _200[0]]) || error)
         );
       } catch (_error) {
-        if (_optionalChain([_error, 'optionalAccess', _197 => _197.attributes, 'optionalAccess', _198 => _198.details, 'optionalAccess', _199 => _199.message])) {
+        if (_optionalChain([_error, 'optionalAccess', _201 => _201.attributes, 'optionalAccess', _202 => _202.details, 'optionalAccess', _203 => _203.message])) {
           throw new Error(
             [
               `${_error.attributes.details.message}`,
@@ -3735,10 +3867,10 @@ function createDatoClient(params) {
     enableFieldLocalization: async (args) => {
       try {
         await dato.fields.update(`${args.modelId}::${args.fieldId}`, { localized: true }).catch(
-          (error) => Promise.reject(_optionalChain([error, 'optionalAccess', _200 => _200.response, 'optionalAccess', _201 => _201.body, 'optionalAccess', _202 => _202.data, 'optionalAccess', _203 => _203[0]]) || error)
+          (error) => Promise.reject(_optionalChain([error, 'optionalAccess', _204 => _204.response, 'optionalAccess', _205 => _205.body, 'optionalAccess', _206 => _206.data, 'optionalAccess', _207 => _207[0]]) || error)
         );
       } catch (_error) {
-        if (_optionalChain([_error, 'optionalAccess', _204 => _204.attributes, 'optionalAccess', _205 => _205.code]) === "NOT_FOUND") {
+        if (_optionalChain([_error, 'optionalAccess', _208 => _208.attributes, 'optionalAccess', _209 => _209.code]) === "NOT_FOUND") {
           throw new Error(
             [
               `Field "${args.fieldId}" not found in model "${args.modelId}".`,
@@ -3746,7 +3878,7 @@ function createDatoClient(params) {
             ].join("\n\n")
           );
         }
-        if (_optionalChain([_error, 'optionalAccess', _206 => _206.attributes, 'optionalAccess', _207 => _207.details, 'optionalAccess', _208 => _208.message])) {
+        if (_optionalChain([_error, 'optionalAccess', _210 => _210.attributes, 'optionalAccess', _211 => _211.details, 'optionalAccess', _212 => _212.message])) {
           throw new Error(
             [
               `${_error.attributes.details.message}`,
@@ -3824,7 +3956,7 @@ function createDatoApiLoader(config, onConfigUpdate) {
           const records = await dato.findRecordsForModel(modelId);
           const recordChoices = createRecordChoices(
             records,
-            _optionalChain([config, 'access', _209 => _209.models, 'access', _210 => _210[modelId], 'optionalAccess', _211 => _211.records]) || [],
+            _optionalChain([config, 'access', _213 => _213.models, 'access', _214 => _214[modelId], 'optionalAccess', _215 => _215.records]) || [],
             project
           );
           const selectedRecords = await promptRecordSelection(
@@ -3843,14 +3975,14 @@ function createDatoApiLoader(config, onConfigUpdate) {
     },
     async pull(locale, input2, initCtx) {
       const result = {};
-      for (const modelId of _lodash2.default.keys(_optionalChain([initCtx, 'optionalAccess', _212 => _212.models]) || {})) {
-        let records = _optionalChain([initCtx, 'optionalAccess', _213 => _213.models, 'access', _214 => _214[modelId], 'access', _215 => _215.records]) || [];
+      for (const modelId of _lodash2.default.keys(_optionalChain([initCtx, 'optionalAccess', _216 => _216.models]) || {})) {
+        let records = _optionalChain([initCtx, 'optionalAccess', _217 => _217.models, 'access', _218 => _218[modelId], 'access', _219 => _219.records]) || [];
         const recordIds = records.map((record) => record.id);
         records = await dato.findRecords(recordIds);
         console.log(`Fetched ${records.length} records for model ${modelId}`);
         if (records.length > 0) {
           result[modelId] = {
-            fields: _optionalChain([initCtx, 'optionalAccess', _216 => _216.models, 'optionalAccess', _217 => _217[modelId], 'optionalAccess', _218 => _218.fields]) || [],
+            fields: _optionalChain([initCtx, 'optionalAccess', _220 => _220.models, 'optionalAccess', _221 => _221[modelId], 'optionalAccess', _222 => _222.fields]) || [],
             records
           };
         }
@@ -3913,7 +4045,7 @@ function createRecordChoices(records, selectedIds = [], project) {
   return records.map((record) => ({
     name: `${record.id} - https://${project.internal_domain}/editor/item_types/${record.item_type.id}/items/${record.id}`,
     value: record.id,
-    checked: _optionalChain([selectedIds, 'optionalAccess', _219 => _219.includes, 'call', _220 => _220(record.id)])
+    checked: _optionalChain([selectedIds, 'optionalAccess', _223 => _223.includes, 'call', _224 => _224(record.id)])
   }));
 }
 async function promptRecordSelection(modelName, choices) {
@@ -4232,7 +4364,7 @@ function createVttLoader() {
       if (!input2) {
         return "";
       }
-      const vtt = _optionalChain([_nodewebvtt2.default, 'access', _221 => _221.parse, 'call', _222 => _222(input2), 'optionalAccess', _223 => _223.cues]);
+      const vtt = _optionalChain([_nodewebvtt2.default, 'access', _225 => _225.parse, 'call', _226 => _226(input2), 'optionalAccess', _227 => _227.cues]);
       if (Object.keys(vtt).length === 0) {
         return {};
       } else {
@@ -4286,7 +4418,7 @@ function variableExtractLoader(params) {
         for (let i = 0; i < matches.length; i++) {
           const match2 = matches[i];
           const currentValue = result[key].value;
-          const newValue = _optionalChain([currentValue, 'optionalAccess', _224 => _224.replace, 'call', _225 => _225(match2, `{variable:${i}}`)]);
+          const newValue = _optionalChain([currentValue, 'optionalAccess', _228 => _228.replace, 'call', _229 => _229(match2, `{variable:${i}}`)]);
           result[key].value = newValue;
           result[key].variables[i] = match2;
         }
@@ -4300,7 +4432,7 @@ function variableExtractLoader(params) {
         for (let i = 0; i < valueObj.variables.length; i++) {
           const variable = valueObj.variables[i];
           const currentValue = result[key];
-          const newValue = _optionalChain([currentValue, 'optionalAccess', _226 => _226.replace, 'call', _227 => _227(`{variable:${i}}`, variable)]);
+          const newValue = _optionalChain([currentValue, 'optionalAccess', _230 => _230.replace, 'call', _231 => _231(`{variable:${i}}`, variable)]);
           result[key] = newValue;
         }
       }
@@ -4500,7 +4632,7 @@ function createVueJsonLoader() {
   return createLoader({
     pull: async (locale, input2, ctx) => {
       const parsed = parseVueFile(input2);
-      return _nullishCoalesce(_optionalChain([parsed, 'optionalAccess', _228 => _228.i18n, 'optionalAccess', _229 => _229[locale]]), () => ( {}));
+      return _nullishCoalesce(_optionalChain([parsed, 'optionalAccess', _232 => _232.i18n, 'optionalAccess', _233 => _233[locale]]), () => ( {}));
     },
     push: async (locale, data, originalInput) => {
       const parsed = parseVueFile(_nullishCoalesce(originalInput, () => ( "")));
@@ -4685,7 +4817,7 @@ function updateStringsInObjectExpression(objectExpression, data) {
   objectExpression.properties.forEach((prop) => {
     if (!t.isObjectProperty(prop)) return;
     const key = getPropertyKey(prop);
-    const incomingVal = _optionalChain([data, 'optionalAccess', _230 => _230[key]]);
+    const incomingVal = _optionalChain([data, 'optionalAccess', _234 => _234[key]]);
     if (incomingVal === void 0) {
       return;
     }
@@ -4721,7 +4853,7 @@ function updateStringsInArrayExpression(arrayExpression, incoming) {
   let modified = false;
   arrayExpression.elements.forEach((element, index) => {
     if (!element) return;
-    const incomingVal = _optionalChain([incoming, 'optionalAccess', _231 => _231[index]]);
+    const incomingVal = _optionalChain([incoming, 'optionalAccess', _235 => _235[index]]);
     if (incomingVal === void 0) return;
     if (t.isStringLiteral(element) && typeof incomingVal === "string") {
       if (element.value !== incomingVal) {
@@ -5212,7 +5344,7 @@ var AST = class _AST {
     const ret = this.type === null ? this.#parts.slice().map((p) => typeof p === "string" ? p : p.toJSON()) : [this.type, ...this.#parts.map((p) => p.toJSON())];
     if (this.isStart() && !this.type)
       ret.unshift([]);
-    if (this.isEnd() && (this === this.#root || this.#root.#filledNegs && _optionalChain([this, 'access', _232 => _232.#parent, 'optionalAccess', _233 => _233.type]) === "!")) {
+    if (this.isEnd() && (this === this.#root || this.#root.#filledNegs && _optionalChain([this, 'access', _236 => _236.#parent, 'optionalAccess', _237 => _237.type]) === "!")) {
       ret.push({});
     }
     return ret;
@@ -5220,7 +5352,7 @@ var AST = class _AST {
   isStart() {
     if (this.#root === this)
       return true;
-    if (!_optionalChain([this, 'access', _234 => _234.#parent, 'optionalAccess', _235 => _235.isStart, 'call', _236 => _236()]))
+    if (!_optionalChain([this, 'access', _238 => _238.#parent, 'optionalAccess', _239 => _239.isStart, 'call', _240 => _240()]))
       return false;
     if (this.#parentIndex === 0)
       return true;
@@ -5236,12 +5368,12 @@ var AST = class _AST {
   isEnd() {
     if (this.#root === this)
       return true;
-    if (_optionalChain([this, 'access', _237 => _237.#parent, 'optionalAccess', _238 => _238.type]) === "!")
+    if (_optionalChain([this, 'access', _241 => _241.#parent, 'optionalAccess', _242 => _242.type]) === "!")
       return true;
-    if (!_optionalChain([this, 'access', _239 => _239.#parent, 'optionalAccess', _240 => _240.isEnd, 'call', _241 => _241()]))
+    if (!_optionalChain([this, 'access', _243 => _243.#parent, 'optionalAccess', _244 => _244.isEnd, 'call', _245 => _245()]))
       return false;
     if (!this.type)
-      return _optionalChain([this, 'access', _242 => _242.#parent, 'optionalAccess', _243 => _243.isEnd, 'call', _244 => _244()]);
+      return _optionalChain([this, 'access', _246 => _246.#parent, 'optionalAccess', _247 => _247.isEnd, 'call', _248 => _248()]);
     const pl = this.#parent ? this.#parent.#parts.length : 0;
     return this.#parentIndex === pl - 1;
   }
@@ -5486,7 +5618,7 @@ var AST = class _AST {
         }
       }
       let end = "";
-      if (this.isEnd() && this.#root.#filledNegs && _optionalChain([this, 'access', _245 => _245.#parent, 'optionalAccess', _246 => _246.type]) === "!") {
+      if (this.isEnd() && this.#root.#filledNegs && _optionalChain([this, 'access', _249 => _249.#parent, 'optionalAccess', _250 => _250.type]) === "!") {
         end = "(?:$|\\/)";
       }
       const final2 = start2 + src + end;
@@ -6563,7 +6695,7 @@ function createMdxSectionsSplit2Loader() {
       const content = _lodash2.default.chain(data.sections).values().join("\n\n").value();
       const result = {
         frontmatter: data.frontmatter,
-        codePlaceholders: _optionalChain([pullInput, 'optionalAccess', _247 => _247.codePlaceholders]) || {},
+        codePlaceholders: _optionalChain([pullInput, 'optionalAccess', _251 => _251.codePlaceholders]) || {},
         content
       };
       return result;
@@ -7300,7 +7432,7 @@ function createBasicTranslator(model, systemPrompt) {
       ]
     });
     const result = JSON.parse(response.text);
-    return _optionalChain([result, 'optionalAccess', _248 => _248.data]) || {};
+    return _optionalChain([result, 'optionalAccess', _252 => _252.data]) || {};
   }
 }
 function extractPayloadChunks(payload) {
@@ -7382,7 +7514,7 @@ function getPureModelProvider(provider) {
 
   ${_chalk2.default.hex(colors.blue)("Docs: https://lingo.dev/go/docs")}
   `;
-  switch (_optionalChain([provider, 'optionalAccess', _249 => _249.id])) {
+  switch (_optionalChain([provider, 'optionalAccess', _253 => _253.id])) {
     case "openai": {
       if (!process.env.OPENAI_API_KEY) {
         throw new Error(
@@ -7440,7 +7572,7 @@ function getPureModelProvider(provider) {
       })(provider.model);
     }
     default: {
-      throw new Error(createUnsupportedProviderErrorMessage(_optionalChain([provider, 'optionalAccess', _250 => _250.id])));
+      throw new Error(createUnsupportedProviderErrorMessage(_optionalChain([provider, 'optionalAccess', _254 => _254.id])));
     }
   }
 }
@@ -7483,7 +7615,11 @@ function trackEvent(distinctId, event, properties) {
         properties: {
           ...properties,
           $lib: "lingo.dev-cli",
-          $lib_version: process.env.npm_package_version || "unknown"
+          $lib_version: process.env.npm_package_version || "unknown",
+          // Essential debugging context only
+          node_version: process.version,
+          is_ci: !!process.env.CI,
+          debug_enabled: process.env.DEBUG === "true"
         },
         timestamp: (/* @__PURE__ */ new Date()).toISOString()
       };
@@ -7683,7 +7819,21 @@ var i18n_default = new (0, _interactivecommander.Command)().command("i18n").desc
 ).action(async function(options) {
   updateGitignore();
   const ora = _ora2.default.call(void 0, );
-  const flags = parseFlags(options);
+  let flags;
+  try {
+    flags = parseFlags(options);
+  } catch (parseError) {
+    await trackEvent("unknown", "cmd.i18n.error", {
+      errorType: "validation_error",
+      errorName: parseError.name || "ValidationError",
+      errorMessage: parseError.message || "Invalid command line options",
+      errorStack: parseError.stack,
+      fatal: true,
+      errorCount: 1,
+      stage: "flag_validation"
+    });
+    throw parseError;
+  }
   if (flags.debug) {
     const { debug } = await _inquirer2.default.prompt([
       {
@@ -7695,6 +7845,7 @@ var i18n_default = new (0, _interactivecommander.Command)().command("i18n").desc
   }
   let hasErrors = false;
   let authId = null;
+  const errorDetails = [];
   try {
     ora.start("Loading configuration...");
     const i18nConfig = getConfig();
@@ -7704,7 +7855,7 @@ var i18n_default = new (0, _interactivecommander.Command)().command("i18n").desc
     validateParams(i18nConfig, flags);
     ora.succeed("Localization configuration is valid");
     ora.start("Connecting to Lingo.dev Localization Engine...");
-    const isByokMode = !!_optionalChain([i18nConfig, 'optionalAccess', _251 => _251.provider]);
+    const isByokMode = !!_optionalChain([i18nConfig, 'optionalAccess', _255 => _255.provider]);
     if (isByokMode) {
       authId = null;
       ora.succeed("Using external provider (BYOK mode)");
@@ -7718,16 +7869,16 @@ var i18n_default = new (0, _interactivecommander.Command)().command("i18n").desc
       flags
     });
     let buckets = getBuckets(i18nConfig);
-    if (_optionalChain([flags, 'access', _252 => _252.bucket, 'optionalAccess', _253 => _253.length])) {
+    if (_optionalChain([flags, 'access', _256 => _256.bucket, 'optionalAccess', _257 => _257.length])) {
       buckets = buckets.filter(
         (bucket) => flags.bucket.includes(bucket.type)
       );
     }
     ora.succeed("Buckets retrieved");
-    if (_optionalChain([flags, 'access', _254 => _254.file, 'optionalAccess', _255 => _255.length])) {
+    if (_optionalChain([flags, 'access', _258 => _258.file, 'optionalAccess', _259 => _259.length])) {
       buckets = buckets.map((bucket) => {
         const paths = bucket.paths.filter(
-          (path18) => flags.file.find((file) => _optionalChain([path18, 'access', _256 => _256.pathPattern, 'optionalAccess', _257 => _257.includes, 'call', _258 => _258(file)]))
+          (path18) => flags.file.find((file) => _optionalChain([path18, 'access', _260 => _260.pathPattern, 'optionalAccess', _261 => _261.includes, 'call', _262 => _262(file)]))
         );
         return { ...bucket, paths };
       }).filter((bucket) => bucket.paths.length > 0);
@@ -7748,7 +7899,7 @@ var i18n_default = new (0, _interactivecommander.Command)().command("i18n").desc
         });
       }
     }
-    const targetLocales = _optionalChain([flags, 'access', _259 => _259.locale, 'optionalAccess', _260 => _260.length]) ? flags.locale : i18nConfig.locale.targets;
+    const targetLocales = _optionalChain([flags, 'access', _263 => _263.locale, 'optionalAccess', _264 => _264.length]) ? flags.locale : i18nConfig.locale.targets;
     ora.start("Setting up localization cache...");
     const checkLockfileProcessor = createDeltaProcessor("");
     const lockfileExists = await checkLockfileProcessor.checkIfLockExists();
@@ -7996,9 +8147,23 @@ var i18n_default = new (0, _interactivecommander.Command)().command("i18n").desc
                 );
               }
             } catch (_error) {
-              const error = new Error(
-                `[${sourceLocale} -> ${targetLocale}] Localization failed: ${_error.message}`
+              const error = new LocalizationError(
+                `[${sourceLocale} -> ${targetLocale}] Localization failed: ${_error.message}`,
+                {
+                  bucket: bucket.type,
+                  sourceLocale,
+                  targetLocale,
+                  pathPattern: bucketPath.pathPattern
+                }
               );
+              errorDetails.push({
+                type: "locale_error",
+                bucket: bucket.type,
+                locale: `${sourceLocale} -> ${targetLocale}`,
+                pathPattern: bucketPath.pathPattern,
+                message: _error.message,
+                stack: _error.stack
+              });
               if (flags.strict) {
                 throw error;
               } else {
@@ -8009,14 +8174,21 @@ var i18n_default = new (0, _interactivecommander.Command)().command("i18n").desc
           }
           const deltaProcessor = createDeltaProcessor(bucketPath.pathPattern);
           const checksums = await deltaProcessor.createChecksums(sourceData);
-          if (!_optionalChain([flags, 'access', _261 => _261.locale, 'optionalAccess', _262 => _262.length])) {
+          if (!_optionalChain([flags, 'access', _265 => _265.locale, 'optionalAccess', _266 => _266.length])) {
             await deltaProcessor.saveChecksums(checksums);
           }
         }
       } catch (_error) {
-        const error = new Error(
-          `Failed to process bucket ${bucket.type}: ${_error.message}`
+        const error = new BucketProcessingError(
+          `Failed to process bucket ${bucket.type}: ${_error.message}`,
+          bucket.type
         );
+        errorDetails.push({
+          type: "bucket_error",
+          bucket: bucket.type,
+          message: _error.message,
+          stack: _error.stack
+        });
         if (flags.strict) {
           throw error;
         } else {
@@ -8029,20 +8201,54 @@ var i18n_default = new (0, _interactivecommander.Command)().command("i18n").desc
     if (!hasErrors) {
       ora.succeed("Localization completed.");
       await trackEvent(authId, "cmd.i18n.success", {
-        i18nConfig,
-        flags
+        i18nConfig: {
+          sourceLocale: i18nConfig.locale.source,
+          targetLocales: i18nConfig.locale.targets,
+          bucketTypes: Object.keys(i18nConfig.buckets)
+        },
+        flags,
+        bucketCount: buckets.length,
+        localeCount: targetLocales.length,
+        processedSuccessfully: true
       });
     } else {
       ora.warn("Localization completed with errors.");
       await trackEvent(authId || "unknown", "cmd.i18n.error", {
-        flags
+        flags,
+        ...aggregateErrorAnalytics(
+          errorDetails,
+          buckets,
+          targetLocales,
+          i18nConfig
+        )
       });
     }
   } catch (error) {
     ora.fail(error.message);
+    const errorType = getCLIErrorType(error);
+    let errorContext = {};
+    if (isLocalizationError(error)) {
+      errorContext = {
+        bucket: error.bucket,
+        sourceLocale: error.sourceLocale,
+        targetLocale: error.targetLocale,
+        pathPattern: error.pathPattern
+      };
+    } else if (isBucketProcessingError(error)) {
+      errorContext = {
+        bucket: error.bucket
+      };
+    }
     await trackEvent(authId || "unknown", "cmd.i18n.error", {
       flags,
-      error
+      errorType,
+      errorName: error.name || "Error",
+      errorMessage: error.message,
+      errorStack: error.stack,
+      errorContext,
+      fatal: true,
+      errorCount: errorDetails.length + 1,
+      previousErrors: createPreviousErrorContext(errorDetails)
     });
   }
 });
@@ -8063,7 +8269,7 @@ function parseFlags(options) {
 }
 async function validateAuth(settings) {
   if (!settings.auth.apiKey) {
-    throw new CLIError({
+    throw new AuthenticationError({
       message: "Not authenticated. Please run `lingo.dev login` to authenticate.",
       docUrl: "authError"
     });
@@ -8074,7 +8280,7 @@ async function validateAuth(settings) {
   });
   const user = await authenticator.whoami();
   if (!user) {
-    throw new CLIError({
+    throw new AuthenticationError({
       message: "Invalid API key. Please run `lingo.dev login` to authenticate.",
       docUrl: "authError"
     });
@@ -8083,24 +8289,24 @@ async function validateAuth(settings) {
 }
 function validateParams(i18nConfig, flags) {
   if (!i18nConfig) {
-    throw new CLIError({
+    throw new ConfigError({
       message: "i18n.json not found. Please run `lingo.dev init` to initialize the project.",
       docUrl: "i18nNotFound"
     });
   } else if (!i18nConfig.buckets || !Object.keys(i18nConfig.buckets).length) {
-    throw new CLIError({
+    throw new ConfigError({
       message: "No buckets found in i18n.json. Please add at least one bucket containing i18n content.",
       docUrl: "bucketNotFound"
     });
-  } else if (_optionalChain([flags, 'access', _263 => _263.locale, 'optionalAccess', _264 => _264.some, 'call', _265 => _265((locale) => !i18nConfig.locale.targets.includes(locale))])) {
-    throw new CLIError({
+  } else if (_optionalChain([flags, 'access', _267 => _267.locale, 'optionalAccess', _268 => _268.some, 'call', _269 => _269((locale) => !i18nConfig.locale.targets.includes(locale))])) {
+    throw new ValidationError({
       message: `One or more specified locales do not exist in i18n.json locale.targets. Please add them to the list and try again.`,
       docUrl: "localeTargetNotFound"
     });
-  } else if (_optionalChain([flags, 'access', _266 => _266.bucket, 'optionalAccess', _267 => _267.some, 'call', _268 => _268(
+  } else if (_optionalChain([flags, 'access', _270 => _270.bucket, 'optionalAccess', _271 => _271.some, 'call', _272 => _272(
     (bucket) => !i18nConfig.buckets[bucket]
   )])) {
-    throw new CLIError({
+    throw new ValidationError({
       message: `One or more specified buckets do not exist in i18n.json. Please add them to the list and try again.`,
       docUrl: "bucketNotFound"
     });
@@ -8605,7 +8811,7 @@ function createLingoDotDevLocalizer(explicitApiKey) {
         const response = await engine.whoami();
         return {
           authenticated: !!response,
-          username: _optionalChain([response, 'optionalAccess', _269 => _269.email])
+          username: _optionalChain([response, 'optionalAccess', _273 => _273.email])
         };
       } catch (e2) {
         return { authenticated: false };
@@ -8713,7 +8919,7 @@ function createExplicitLocalizer(provider) {
 }
 function createAiSdkLocalizer(params) {
   const skipAuth = params.skipAuth === true;
-  const apiKey = process.env[_nullishCoalesce(_optionalChain([params, 'optionalAccess', _270 => _270.apiKeyName]), () => ( ""))];
+  const apiKey = process.env[_nullishCoalesce(_optionalChain([params, 'optionalAccess', _274 => _274.apiKeyName]), () => ( ""))];
   if (!skipAuth && !apiKey || !params.apiKeyName) {
     throw new Error(
       _dedent2.default`
@@ -8838,8 +9044,8 @@ async function setup(input2) {
             throw new Error(
               "No buckets found in i18n.json. Please add at least one bucket containing i18n content."
             );
-          } else if (_optionalChain([ctx, 'access', _271 => _271.flags, 'access', _272 => _272.bucket, 'optionalAccess', _273 => _273.some, 'call', _274 => _274(
-            (bucket) => !_optionalChain([ctx, 'access', _275 => _275.config, 'optionalAccess', _276 => _276.buckets, 'access', _277 => _277[bucket]])
+          } else if (_optionalChain([ctx, 'access', _275 => _275.flags, 'access', _276 => _276.bucket, 'optionalAccess', _277 => _277.some, 'call', _278 => _278(
+            (bucket) => !_optionalChain([ctx, 'access', _279 => _279.config, 'optionalAccess', _280 => _280.buckets, 'access', _281 => _281[bucket]])
           )])) {
             throw new Error(
               `One or more specified buckets do not exist in i18n.json. Please add them to the list first and try again.`
@@ -8852,7 +9058,7 @@ async function setup(input2) {
         title: "Selecting localization provider",
         task: async (ctx, task) => {
           ctx.localizer = createLocalizer(
-            _optionalChain([ctx, 'access', _278 => _278.config, 'optionalAccess', _279 => _279.provider]),
+            _optionalChain([ctx, 'access', _282 => _282.config, 'optionalAccess', _283 => _283.provider]),
             ctx.flags.apiKey
           );
           if (!ctx.localizer) {
@@ -9171,7 +9377,7 @@ function createWorkerTask(args) {
             const processableData = _lodash2.default.chain(sourceData).entries().filter(
               ([key, value]) => delta.added.includes(key) || delta.updated.includes(key) || !!args.ctx.flags.force
             ).filter(
-              ([key]) => !assignedTask.onlyKeys.length || _optionalChain([assignedTask, 'access', _280 => _280.onlyKeys, 'optionalAccess', _281 => _281.some, 'call', _282 => _282(
+              ([key]) => !assignedTask.onlyKeys.length || _optionalChain([assignedTask, 'access', _284 => _284.onlyKeys, 'optionalAccess', _285 => _285.some, 'call', _286 => _286(
                 (pattern) => minimatch(key, pattern)
               )])
             ).fromPairs().value();
@@ -9234,7 +9440,7 @@ function createWorkerTask(args) {
                 finalRenamedTargetData
               );
               const checksums2 = await deltaProcessor.createChecksums(sourceData);
-              if (!_optionalChain([args, 'access', _283 => _283.ctx, 'access', _284 => _284.flags, 'access', _285 => _285.targetLocale, 'optionalAccess', _286 => _286.length])) {
+              if (!_optionalChain([args, 'access', _287 => _287.ctx, 'access', _288 => _288.flags, 'access', _289 => _289.targetLocale, 'optionalAccess', _290 => _290.length])) {
                 await deltaProcessor.saveChecksums(checksums2);
               }
             });
@@ -9425,13 +9631,13 @@ var flagsSchema2 = _zod.z.object({
 
 // src/cli/cmd/run/_utils.ts
 async function determineAuthId(ctx) {
-  const isByokMode = !!_optionalChain([ctx, 'access', _287 => _287.config, 'optionalAccess', _288 => _288.provider]);
+  const isByokMode = !!_optionalChain([ctx, 'access', _291 => _291.config, 'optionalAccess', _292 => _292.provider]);
   if (isByokMode) {
     return null;
   } else {
     try {
-      const authStatus = await _optionalChain([ctx, 'access', _289 => _289.localizer, 'optionalAccess', _290 => _290.checkAuth, 'call', _291 => _291()]);
-      return _optionalChain([authStatus, 'optionalAccess', _292 => _292.username]) || null;
+      const authStatus = await _optionalChain([ctx, 'access', _293 => _293.localizer, 'optionalAccess', _294 => _294.checkAuth, 'call', _295 => _295()]);
+      return _optionalChain([authStatus, 'optionalAccess', _296 => _296.username]) || null;
     } catch (e3) {
       return null;
     }
@@ -9626,7 +9832,7 @@ var InBranchFlow = class extends IntegrationFlow {
     _child_process.execSync.call(void 0, `git config --global safe.directory ${process.cwd()}`);
     _child_process.execSync.call(void 0, `git config user.name "${gitConfig.userName}"`);
     _child_process.execSync.call(void 0, `git config user.email "${gitConfig.userEmail}"`);
-    _optionalChain([this, 'access', _293 => _293.platformKit, 'optionalAccess', _294 => _294.gitConfig, 'call', _295 => _295()]);
+    _optionalChain([this, 'access', _297 => _297.platformKit, 'optionalAccess', _298 => _298.gitConfig, 'call', _299 => _299()]);
     _child_process.execSync.call(void 0, `git fetch origin ${baseBranchName}`, { stdio: "inherit" });
     _child_process.execSync.call(void 0, `git checkout ${baseBranchName} --`, { stdio: "inherit" });
     if (!processOwnCommits) {
@@ -9658,7 +9864,7 @@ var InBranchFlow = class extends IntegrationFlow {
 // src/cli/cmd/ci/flows/pull-request.ts
 var PullRequestFlow = class extends InBranchFlow {
   async preRun() {
-    const canContinue = await _optionalChain([super.preRun.bind(this), 'optionalCall', _296 => _296()]);
+    const canContinue = await _optionalChain([super.preRun.bind(this), 'optionalCall', _300 => _300()]);
     if (!canContinue) {
       return false;
     }
@@ -9921,10 +10127,10 @@ var BitbucketPlatformKit = class extends PlatformKit {
       repo_slug: this.platformConfig.repositoryName,
       state: "OPEN"
     }).then(({ data: { values } }) => {
-      return _optionalChain([values, 'optionalAccess', _297 => _297.find, 'call', _298 => _298(
-        ({ source, destination }) => _optionalChain([source, 'optionalAccess', _299 => _299.branch, 'optionalAccess', _300 => _300.name]) === branch && _optionalChain([destination, 'optionalAccess', _301 => _301.branch, 'optionalAccess', _302 => _302.name]) === this.platformConfig.baseBranchName
+      return _optionalChain([values, 'optionalAccess', _301 => _301.find, 'call', _302 => _302(
+        ({ source, destination }) => _optionalChain([source, 'optionalAccess', _303 => _303.branch, 'optionalAccess', _304 => _304.name]) === branch && _optionalChain([destination, 'optionalAccess', _305 => _305.branch, 'optionalAccess', _306 => _306.name]) === this.platformConfig.baseBranchName
       )]);
-    }).then((pr) => _optionalChain([pr, 'optionalAccess', _303 => _303.id]));
+    }).then((pr) => _optionalChain([pr, 'optionalAccess', _307 => _307.id]));
   }
   async closePullRequest({ pullRequestNumber }) {
     await this.bb.repositories.declinePullRequest({
@@ -10020,7 +10226,7 @@ var GitHubPlatformKit = class extends PlatformKit {
       repo: this.platformConfig.repositoryName,
       base: this.platformConfig.baseBranchName,
       state: "open"
-    }).then(({ data }) => data[0]).then((pr) => _optionalChain([pr, 'optionalAccess', _304 => _304.number]));
+    }).then(({ data }) => data[0]).then((pr) => _optionalChain([pr, 'optionalAccess', _308 => _308.number]));
   }
   async closePullRequest({ pullRequestNumber }) {
     await this.octokit.rest.pulls.update({
@@ -10147,7 +10353,7 @@ var GitlabPlatformKit = class extends PlatformKit {
       sourceBranch: branch,
       state: "opened"
     });
-    return _optionalChain([mergeRequests, 'access', _305 => _305[0], 'optionalAccess', _306 => _306.iid]);
+    return _optionalChain([mergeRequests, 'access', _309 => _309[0], 'optionalAccess', _310 => _310.iid]);
   }
   async closePullRequest({
     pullRequestNumber
@@ -10237,7 +10443,7 @@ var ci_default = new (0, _interactivecommander.Command)().command("ci").descript
   }
   const env = {
     LINGODOTDEV_API_KEY: settings.auth.apiKey,
-    LINGODOTDEV_PULL_REQUEST: _optionalChain([options, 'access', _307 => _307.pullRequest, 'optionalAccess', _308 => _308.toString, 'call', _309 => _309()]) || "false",
+    LINGODOTDEV_PULL_REQUEST: _optionalChain([options, 'access', _311 => _311.pullRequest, 'optionalAccess', _312 => _312.toString, 'call', _313 => _313()]) || "false",
     ...options.commitMessage && {
       LINGODOTDEV_COMMIT_MESSAGE: options.commitMessage
     },
@@ -10257,7 +10463,7 @@ var ci_default = new (0, _interactivecommander.Command)().command("ci").descript
   const { isPullRequestMode } = platformKit.config;
   ora.info(`Pull request mode: ${isPullRequestMode ? "on" : "off"}`);
   const flow = isPullRequestMode ? new PullRequestFlow(ora, platformKit) : new InBranchFlow(ora, platformKit);
-  const canRun = await _optionalChain([flow, 'access', _310 => _310.preRun, 'optionalCall', _311 => _311()]);
+  const canRun = await _optionalChain([flow, 'access', _314 => _314.preRun, 'optionalCall', _315 => _315()]);
   if (canRun === false) {
     return;
   }
@@ -10267,7 +10473,7 @@ var ci_default = new (0, _interactivecommander.Command)().command("ci").descript
   if (!hasChanges) {
     return;
   }
-  await _optionalChain([flow, 'access', _312 => _312.postRun, 'optionalCall', _313 => _313()]);
+  await _optionalChain([flow, 'access', _316 => _316.postRun, 'optionalCall', _317 => _317()]);
 });
 function parseBooleanArg(val) {
   if (val === true) return true;
@@ -10304,8 +10510,8 @@ function exitGracefully(elapsedMs = 0) {
   }
 }
 function checkForPendingOperations() {
-  const activeHandles = _optionalChain([process, 'access', _314 => _314._getActiveHandles, 'optionalCall', _315 => _315()]) || [];
-  const activeRequests = _optionalChain([process, 'access', _316 => _316._getActiveRequests, 'optionalCall', _317 => _317()]) || [];
+  const activeHandles = _optionalChain([process, 'access', _318 => _318._getActiveHandles, 'optionalCall', _319 => _319()]) || [];
+  const activeRequests = _optionalChain([process, 'access', _320 => _320._getActiveRequests, 'optionalCall', _321 => _321()]) || [];
   const nonStandardHandles = activeHandles.filter((handle) => {
     if (handle === process.stdin || handle === process.stdout || handle === process.stderr) {
       return false;
@@ -10371,17 +10577,17 @@ var status_default = new (0, _interactivecommander.Command)().command("status").
       flags
     });
     let buckets = getBuckets(i18nConfig);
-    if (_optionalChain([flags, 'access', _318 => _318.bucket, 'optionalAccess', _319 => _319.length])) {
+    if (_optionalChain([flags, 'access', _322 => _322.bucket, 'optionalAccess', _323 => _323.length])) {
       buckets = buckets.filter(
         (bucket) => flags.bucket.includes(bucket.type)
       );
     }
     ora.succeed("Buckets retrieved");
-    if (_optionalChain([flags, 'access', _320 => _320.file, 'optionalAccess', _321 => _321.length])) {
+    if (_optionalChain([flags, 'access', _324 => _324.file, 'optionalAccess', _325 => _325.length])) {
       buckets = buckets.map((bucket) => {
         const paths = bucket.paths.filter(
           (path18) => flags.file.find(
-            (file) => _optionalChain([path18, 'access', _322 => _322.pathPattern, 'optionalAccess', _323 => _323.includes, 'call', _324 => _324(file)]) || _optionalChain([path18, 'access', _325 => _325.pathPattern, 'optionalAccess', _326 => _326.match, 'call', _327 => _327(file)]) || minimatch(path18.pathPattern, file)
+            (file) => _optionalChain([path18, 'access', _326 => _326.pathPattern, 'optionalAccess', _327 => _327.includes, 'call', _328 => _328(file)]) || _optionalChain([path18, 'access', _329 => _329.pathPattern, 'optionalAccess', _330 => _330.match, 'call', _331 => _331(file)]) || minimatch(path18.pathPattern, file)
           )
         );
         return { ...bucket, paths };
@@ -10401,7 +10607,7 @@ var status_default = new (0, _interactivecommander.Command)().command("status").
         });
       }
     }
-    const targetLocales = _optionalChain([flags, 'access', _328 => _328.locale, 'optionalAccess', _329 => _329.length]) ? flags.locale : i18nConfig.locale.targets;
+    const targetLocales = _optionalChain([flags, 'access', _332 => _332.locale, 'optionalAccess', _333 => _333.length]) ? flags.locale : i18nConfig.locale.targets;
     let totalSourceKeyCount = 0;
     let uniqueKeysToTranslate = 0;
     let totalExistingTranslations = 0;
@@ -10806,12 +11012,12 @@ function validateParams2(i18nConfig, flags) {
       message: "No buckets found in i18n.json. Please add at least one bucket containing i18n content.",
       docUrl: "bucketNotFound"
     });
-  } else if (_optionalChain([flags, 'access', _330 => _330.locale, 'optionalAccess', _331 => _331.some, 'call', _332 => _332((locale) => !i18nConfig.locale.targets.includes(locale))])) {
+  } else if (_optionalChain([flags, 'access', _334 => _334.locale, 'optionalAccess', _335 => _335.some, 'call', _336 => _336((locale) => !i18nConfig.locale.targets.includes(locale))])) {
     throw new CLIError({
       message: `One or more specified locales do not exist in i18n.json locale.targets. Please add them to the list and try again.`,
       docUrl: "localeTargetNotFound"
     });
-  } else if (_optionalChain([flags, 'access', _333 => _333.bucket, 'optionalAccess', _334 => _334.some, 'call', _335 => _335(
+  } else if (_optionalChain([flags, 'access', _337 => _337.bucket, 'optionalAccess', _338 => _338.some, 'call', _339 => _339(
     (bucket) => !i18nConfig.buckets[bucket]
   )])) {
     throw new CLIError({
@@ -10903,7 +11109,7 @@ async function renderHero2() {
 // package.json
 var package_default = {
   name: "lingo.dev",
-  version: "0.111.4",
+  version: "0.111.5",
   description: "Lingo.dev CLI",
   private: false,
   publishConfig: {
@@ -11181,7 +11387,7 @@ var purge_default = new (0, _interactivecommander.Command)().command("purge").de
     if (options.file && options.file.length) {
       buckets = buckets.map((bucket) => {
         const paths = bucket.paths.filter(
-          (bucketPath) => _optionalChain([options, 'access', _336 => _336.file, 'optionalAccess', _337 => _337.some, 'call', _338 => _338((f) => bucketPath.pathPattern.includes(f))])
+          (bucketPath) => _optionalChain([options, 'access', _340 => _340.file, 'optionalAccess', _341 => _341.some, 'call', _342 => _342((f) => bucketPath.pathPattern.includes(f))])
         );
         return { ...bucket, paths };
       }).filter((bucket) => bucket.paths.length > 0);