@lingo.dev/compiler 0.1.2 → 0.1.4

package/build/plugin/build-translator.cjs

@@ -2,6 +2,7 @@ const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
 const require_logger = require('../utils/logger.cjs');
 const require_api = require('../translators/api.cjs');
 const require_cache_factory = require('../translators/cache-factory.cjs');
+const require_translation_service = require('../translators/translation-service.cjs');
 const require_manager = require('../metadata/manager.cjs');
 const require_translation_server = require('../translation-server/translation-server.cjs');
 let fs_promises = require("fs/promises");
@@ -27,7 +28,6 @@ async function processBuildTranslations(options) {
 	const { config, publicOutputPath, metadataFilePath } = options;
 	const buildMode = process.env.LINGO_BUILD_MODE || config.buildMode;
 	require_logger.logger.info(`🌍 Build mode: ${buildMode}`);
-	if (metadataFilePath) require_logger.logger.info(`📋 Using build metadata file: ${metadataFilePath}`);
 	const metadata = await require_manager.loadMetadata(metadataFilePath);
 	if (!metadata || Object.keys(metadata.entries).length === 0) {
 		require_logger.logger.info("No translations to process (metadata is empty)");
@@ -53,7 +53,7 @@ async function processBuildTranslations(options) {
 	let translationServer;
 	try {
 		translationServer = await require_translation_server.startTranslationServer({
-			startPort: config.dev.translationServerStartPort,
+			translationService: new require_translation_service.TranslationService(config, require_logger.logger),
 			onError: (err) => {
 				require_logger.logger.error("Translation server error:", err);
 			},
@@ -93,7 +93,7 @@ async function processBuildTranslations(options) {
 			stats
 		};
 	} catch (error) {
-		require_logger.logger.error("❌ Translation generation failed:", error);
+		require_logger.logger.error("❌ Translation generation failed:\n", error instanceof Error ? error.message : error);
 		process.exit(1);
 	} finally {
 		if (translationServer) {

package/build/plugin/build-translator.mjs

@@ -1,6 +1,7 @@
 import { logger } from "../utils/logger.mjs";
 import { dictionaryFrom } from "../translators/api.mjs";
 import { createCache } from "../translators/cache-factory.mjs";
+import { TranslationService } from "../translators/translation-service.mjs";
 import { loadMetadata } from "../metadata/manager.mjs";
 import { startTranslationServer } from "../translation-server/translation-server.mjs";
 import fsPromises from "fs/promises";
@@ -24,7 +25,6 @@ async function processBuildTranslations(options) {
 	const { config, publicOutputPath, metadataFilePath } = options;
 	const buildMode = process.env.LINGO_BUILD_MODE || config.buildMode;
 	logger.info(`🌍 Build mode: ${buildMode}`);
-	if (metadataFilePath) logger.info(`📋 Using build metadata file: ${metadataFilePath}`);
 	const metadata = await loadMetadata(metadataFilePath);
 	if (!metadata || Object.keys(metadata.entries).length === 0) {
 		logger.info("No translations to process (metadata is empty)");
@@ -50,7 +50,7 @@ async function processBuildTranslations(options) {
 	let translationServer;
 	try {
 		translationServer = await startTranslationServer({
-			startPort: config.dev.translationServerStartPort,
+			translationService: new TranslationService(config, logger),
 			onError: (err) => {
 				logger.error("Translation server error:", err);
 			},
@@ -90,7 +90,7 @@ async function processBuildTranslations(options) {
 			stats
 		};
 	} catch (error) {
-		logger.error("❌ Translation generation failed:", error);
+		logger.error("❌ Translation generation failed:\n", error instanceof Error ? error.message : error);
 		process.exit(1);
 	} finally {
 		if (translationServer) {

package/build/plugin/build-translator.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"build-translator.mjs","names":["translationServer: TranslationServer | undefined","stats: BuildTranslationResult[\"stats\"]","errors: Array<{ locale: LocaleCode; error: string }>","missingLocales: string[]","incompleteLocales: Array<{\n    locale: LocaleCode;\n    missing: number;\n    total: number;\n  }>","fs"],"sources":["../../src/plugin/build-translator.ts"],"sourcesContent":["/**\n * Build-time translation processor\n *\n * Handles translation generation and validation at build time\n * Supports two modes:\n * - \"translate\": Generate all translations, fail if translation fails\n * - \"cache-only\": Validate cache completeness, fail if incomplete\n */\n// TODO (AleksandrSl 08/12/2025): Add ICU validation for messages? The problem is that we don't know which will be rendered as a simple text\nimport fs from \"fs/promises\";\nimport path from \"path\";\nimport type { LingoConfig, MetadataSchema } from \"../types\";\nimport { logger } from \"../utils/logger\";\nimport {\n  startTranslationServer,\n  type TranslationServer,\n} from \"../translation-server\";\nimport { loadMetadata } from \"../metadata/manager\";\nimport { createCache, type TranslationCache } from \"../translators\";\nimport { dictionaryFrom } from \"../translators/api\";\nimport type { LocaleCode } from \"lingo.dev/spec\";\n\nexport interface BuildTranslationOptions {\n  config: LingoConfig;\n  publicOutputPath: string;\n  metadataFilePath: string;\n}\n\nexport interface BuildTranslationResult {\n  /**\n   * Whether the build succeeded\n   */\n  success: boolean;\n\n  /**\n   * Error message if build failed\n   */\n  error?: string;\n\n  /**\n   * Translation statistics per locale\n   */\n  stats: Record<\n    string,\n    {\n      total: number;\n      translated: number;\n      failed: number;\n    }\n  >;\n}\n\n/**\n * Process translations at build time\n *\n * @throws Error if validation or translation fails (causes build to fail)\n */\nexport async function processBuildTranslations(\n  options: BuildTranslationOptions,\n): Promise<BuildTranslationResult> {\n  const { config, publicOutputPath, metadataFilePath } = options;\n\n  // Determine build mode (env var > options > config)\n  const buildMode =\n    (process.env.LINGO_BUILD_MODE as \"translate\" | \"cache-only\") ||\n    config.buildMode;\n\n  logger.info(`🌍 Build mode: ${buildMode}`);\n\n  if (metadataFilePath) {\n    logger.info(`📋 Using build metadata file: ${metadataFilePath}`);\n  }\n\n  const metadata = await loadMetadata(metadataFilePath);\n\n  if (!metadata || Object.keys(metadata.entries).length === 0) {\n    logger.info(\"No translations to process (metadata is empty)\");\n    return {\n      success: true,\n      stats: {},\n    };\n  }\n\n  const totalEntries = Object.keys(metadata.entries).length;\n  logger.info(`📊 Found ${totalEntries} translatable entries`);\n\n  const cache = createCache(config);\n\n  // Handle cache-only mode\n  if (buildMode === \"cache-only\") {\n    logger.info(\"🔍 Validating translation cache...\");\n    await validateCache(config, metadata, cache);\n    logger.info(\"✅ Cache validation passed\");\n\n    if (publicOutputPath) {\n      await copyStaticFiles(config, publicOutputPath, metadata, cache);\n    }\n\n    return {\n      success: true,\n      stats: buildCacheStats(config, metadata),\n    };\n  }\n\n  // Handle translate mode\n  logger.info(\"🔄 Generating translations...\");\n  let translationServer: TranslationServer | undefined;\n\n  try {\n    translationServer = await startTranslationServer({\n      startPort: config.dev.translationServerStartPort,\n      onError: (err) => {\n        logger.error(\"Translation server error:\", err);\n      },\n      config,\n    });\n\n    // When pluralization is enabled, we need to generate the source locale file too\n    // because pluralization modifies the sourceText\n    const needsSourceLocale = config.pluralization?.enabled !== false;\n    const allLocales = needsSourceLocale\n      ? [config.sourceLocale, ...config.targetLocales]\n      : config.targetLocales;\n\n    logger.info(\n      `Processing translations for ${allLocales.length} locale(s)${needsSourceLocale ? \" (including source locale for pluralization)\" : \"\"}...`,\n    );\n\n    const stats: BuildTranslationResult[\"stats\"] = {};\n    const errors: Array<{ locale: LocaleCode; error: string }> = [];\n\n    // Translate all locales in parallel\n    const localePromises = allLocales.map(async (locale) => {\n      logger.info(`Translating to ${locale}...`);\n\n      const result = await translationServer!.translateAll(locale);\n\n      stats[locale] = {\n        total: totalEntries,\n        translated: Object.keys(result.translations).length,\n        failed: result.errors.length,\n      };\n\n      if (result.errors.length > 0) {\n        logger.warn(\n          `⚠️  ${result.errors.length} translation error(s) for ${locale}`,\n        );\n        errors.push({\n          locale,\n          error: `${result.errors.length} translation(s) failed`,\n        });\n      } else {\n        logger.info(`✅ ${locale} completed successfully`);\n      }\n    });\n\n    await Promise.all(localePromises);\n\n    // Fail build if any translations failed in translate mode\n    if (errors.length > 0) {\n      const errorMsg = formatTranslationErrors(errors);\n      logger.error(errorMsg);\n      process.exit(1);\n    }\n\n    // Copy cache to public directory if requested\n    if (publicOutputPath) {\n      await copyStaticFiles(config, publicOutputPath, metadata, cache);\n    }\n\n    logger.info(\"✅ Translation generation completed successfully\");\n\n    return {\n      success: true,\n      stats,\n    };\n  } catch (error) {\n    logger.error(\"❌ Translation generation failed:\", error);\n    process.exit(1);\n  } finally {\n    if (translationServer) {\n      await translationServer.stop();\n      logger.info(\"✅ Translation server stopped\");\n    }\n  }\n}\n\n/**\n * Validate that all required translations exist in cache\n * @throws Error if cache is incomplete or missing\n */\nasync function validateCache(\n  config: LingoConfig,\n  metadata: MetadataSchema,\n  cache: TranslationCache,\n): Promise<void> {\n  const allHashes = Object.keys(metadata.entries);\n  const missingLocales: string[] = [];\n  const incompleteLocales: Array<{\n    locale: LocaleCode;\n    missing: number;\n    total: number;\n  }> = [];\n\n  // Include source locale if pluralization is enabled\n  const needsSourceLocale = config.pluralization?.enabled !== false;\n  const allLocales = needsSourceLocale\n    ? [config.sourceLocale, ...config.targetLocales]\n    : config.targetLocales;\n\n  for (const locale of allLocales) {\n    try {\n      const entries = await cache.get(locale);\n\n      if (Object.keys(entries).length === 0) {\n        missingLocales.push(locale);\n        logger.debug(`Cache file not found or empty for ${locale}`);\n        continue;\n      }\n\n      const missingHashes = allHashes.filter((hash) => !entries[hash]);\n\n      if (missingHashes.length > 0) {\n        incompleteLocales.push({\n          locale,\n          missing: missingHashes.length,\n          total: allHashes.length,\n        });\n\n        // Log first few missing hashes for debugging\n        logger.debug(\n          `Missing hashes in ${locale}: ${missingHashes.slice(0, 5).join(\", \")}${\n            missingHashes.length > 5 ? \"...\" : \"\"\n          }`,\n        );\n      }\n    } catch (error) {\n      missingLocales.push(locale);\n      logger.debug(`Failed to read cache for ${locale}:`, error);\n    }\n  }\n\n  if (missingLocales.length > 0 || incompleteLocales.length > 0) {\n    const errorMsg = formatCacheValidationError(\n      missingLocales,\n      incompleteLocales,\n    );\n    logger.error(errorMsg);\n    process.exit(1);\n  }\n}\n\nfunction buildCacheStats(\n  config: LingoConfig,\n  metadata: MetadataSchema,\n): BuildTranslationResult[\"stats\"] {\n  const totalEntries = Object.keys(metadata.entries).length;\n  const stats: BuildTranslationResult[\"stats\"] = {};\n\n  // Include source locale if pluralization is enabled\n  const needsSourceLocale = config.pluralization?.enabled !== false;\n  const allLocales = needsSourceLocale\n    ? [config.sourceLocale, ...config.targetLocales]\n    : config.targetLocales;\n\n  for (const locale of allLocales) {\n    stats[locale] = {\n      total: totalEntries,\n      translated: totalEntries, // Assumed complete if validation passed\n      failed: 0,\n    };\n  }\n\n  return stats;\n}\n\nasync function copyStaticFiles(\n  config: LingoConfig,\n  publicOutputPath: string,\n  metadata: MetadataSchema,\n  cache: TranslationCache,\n): Promise<void> {\n  logger.info(`📦 Generating static translation files in ${publicOutputPath}`);\n\n  await fs.mkdir(publicOutputPath, { recursive: true });\n\n  const usedHashes = new Set(Object.keys(metadata.entries));\n  logger.info(`📊 Filtering translations to ${usedHashes.size} used hash(es)`);\n\n  // Include source locale if pluralization is enabled\n  const needsSourceLocale = config.pluralization?.enabled !== false;\n  const allLocales = needsSourceLocale\n    ? [config.sourceLocale, ...config.targetLocales]\n    : config.targetLocales;\n\n  for (const locale of allLocales) {\n    const publicFilePath = path.join(publicOutputPath, `${locale}.json`);\n\n    try {\n      const entries = await cache.get(locale, Array.from(usedHashes));\n      const outputData = dictionaryFrom(locale, entries);\n\n      await fs.writeFile(\n        publicFilePath,\n        JSON.stringify(outputData, null, 2),\n        \"utf-8\",\n      );\n\n      logger.info(\n        `✓ Generated ${locale}.json (${Object.keys(entries).length} translations)`,\n      );\n    } catch (error) {\n      logger.error(`❌ Failed to generate ${locale}.json:`, error);\n      process.exit(1);\n    }\n  }\n}\n\nfunction formatCacheValidationError(\n  missingLocales: string[],\n  incompleteLocales: Array<{\n    locale: LocaleCode;\n    missing: number;\n    total: number;\n  }>,\n): string {\n  let msg = \"❌ Cache validation failed in cache-only mode:\\n\\n\";\n\n  if (missingLocales.length > 0) {\n    msg += `  📁 Missing cache files:\\n`;\n    msg += missingLocales.map((locale) => `    - ${locale}.json`).join(\"\\n\");\n    msg += \"\\n\\n\";\n  }\n\n  if (incompleteLocales.length > 0) {\n    msg += `  📊 Incomplete cache:\\n`;\n    msg += incompleteLocales\n      .map(\n        (item) =>\n          `    - ${item.locale}: ${item.missing}/${item.total} translations missing`,\n      )\n      .join(\"\\n\");\n    msg += \"\\n\\n\";\n  }\n\n  msg += `  💡 To fix:\\n`;\n  msg += `    1. Set LINGO_BUILD_MODE=translate to generate translations\\n`;\n  msg += `    2. Commit the generated .lingo/cache/*.json files\\n`;\n  msg += `    3. Ensure translation API keys are available if generating translations`;\n\n  return msg;\n}\n\nfunction formatTranslationErrors(\n  errors: Array<{ locale: LocaleCode; error: string }>,\n): string {\n  let msg = \"❌ Translation generation failed:\\n\\n\";\n\n  msg += errors.map((err) => `  - ${err.locale}: ${err.error}`).join(\"\\n\");\n\n  msg += \"\\n\\n\";\n  msg += `  💡 Translation errors must be resolved in \"translate\" mode.\\n`;\n  msg += `     Check translation server logs for details.`;\n\n  return msg;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAyDA,eAAsB,yBACpB,SACiC;CACjC,MAAM,EAAE,QAAQ,kBAAkB,qBAAqB;CAGvD,MAAM,YACH,QAAQ,IAAI,oBACb,OAAO;AAET,QAAO,KAAK,kBAAkB,YAAY;AAE1C,KAAI,iBACF,QAAO,KAAK,iCAAiC,mBAAmB;CAGlE,MAAM,WAAW,MAAM,aAAa,iBAAiB;AAErD,KAAI,CAAC,YAAY,OAAO,KAAK,SAAS,QAAQ,CAAC,WAAW,GAAG;AAC3D,SAAO,KAAK,iDAAiD;AAC7D,SAAO;GACL,SAAS;GACT,OAAO,EAAE;GACV;;CAGH,MAAM,eAAe,OAAO,KAAK,SAAS,QAAQ,CAAC;AACnD,QAAO,KAAK,YAAY,aAAa,uBAAuB;CAE5D,MAAM,QAAQ,YAAY,OAAO;AAGjC,KAAI,cAAc,cAAc;AAC9B,SAAO,KAAK,qCAAqC;AACjD,QAAM,cAAc,QAAQ,UAAU,MAAM;AAC5C,SAAO,KAAK,4BAA4B;AAExC,MAAI,iBACF,OAAM,gBAAgB,QAAQ,kBAAkB,UAAU,MAAM;AAGlE,SAAO;GACL,SAAS;GACT,OAAO,gBAAgB,QAAQ,SAAS;GACzC;;AAIH,QAAO,KAAK,gCAAgC;CAC5C,IAAIA;AAEJ,KAAI;AACF,sBAAoB,MAAM,uBAAuB;GAC/C,WAAW,OAAO,IAAI;GACtB,UAAU,QAAQ;AAChB,WAAO,MAAM,6BAA6B,IAAI;;GAEhD;GACD,CAAC;EAIF,MAAM,oBAAoB,OAAO,eAAe,YAAY;EAC5D,MAAM,aAAa,oBACf,CAAC,OAAO,cAAc,GAAG,OAAO,cAAc,GAC9C,OAAO;AAEX,SAAO,KACL,+BAA+B,WAAW,OAAO,YAAY,oBAAoB,iDAAiD,GAAG,KACtI;EAED,MAAMC,QAAyC,EAAE;EACjD,MAAMC,SAAuD,EAAE;EAG/D,MAAM,iBAAiB,WAAW,IAAI,OAAO,WAAW;AACtD,UAAO,KAAK,kBAAkB,OAAO,KAAK;GAE1C,MAAM,SAAS,MAAM,kBAAmB,aAAa,OAAO;AAE5D,SAAM,UAAU;IACd,OAAO;IACP,YAAY,OAAO,KAAK,OAAO,aAAa,CAAC;IAC7C,QAAQ,OAAO,OAAO;IACvB;AAED,OAAI,OAAO,OAAO,SAAS,GAAG;AAC5B,WAAO,KACL,OAAO,OAAO,OAAO,OAAO,4BAA4B,SACzD;AACD,WAAO,KAAK;KACV;KACA,OAAO,GAAG,OAAO,OAAO,OAAO;KAChC,CAAC;SAEF,QAAO,KAAK,KAAK,OAAO,yBAAyB;IAEnD;AAEF,QAAM,QAAQ,IAAI,eAAe;AAGjC,MAAI,OAAO,SAAS,GAAG;GACrB,MAAM,WAAW,wBAAwB,OAAO;AAChD,UAAO,MAAM,SAAS;AACtB,WAAQ,KAAK,EAAE;;AAIjB,MAAI,iBACF,OAAM,gBAAgB,QAAQ,kBAAkB,UAAU,MAAM;AAGlE,SAAO,KAAK,kDAAkD;AAE9D,SAAO;GACL,SAAS;GACT;GACD;UACM,OAAO;AACd,SAAO,MAAM,oCAAoC,MAAM;AACvD,UAAQ,KAAK,EAAE;WACP;AACR,MAAI,mBAAmB;AACrB,SAAM,kBAAkB,MAAM;AAC9B,UAAO,KAAK,+BAA+B;;;;;;;;AASjD,eAAe,cACb,QACA,UACA,OACe;CACf,MAAM,YAAY,OAAO,KAAK,SAAS,QAAQ;CAC/C,MAAMC,iBAA2B,EAAE;CACnC,MAAMC,oBAID,EAAE;CAIP,MAAM,aADoB,OAAO,eAAe,YAAY,QAExD,CAAC,OAAO,cAAc,GAAG,OAAO,cAAc,GAC9C,OAAO;AAEX,MAAK,MAAM,UAAU,WACnB,KAAI;EACF,MAAM,UAAU,MAAM,MAAM,IAAI,OAAO;AAEvC,MAAI,OAAO,KAAK,QAAQ,CAAC,WAAW,GAAG;AACrC,kBAAe,KAAK,OAAO;AAC3B,UAAO,MAAM,qCAAqC,SAAS;AAC3D;;EAGF,MAAM,gBAAgB,UAAU,QAAQ,SAAS,CAAC,QAAQ,MAAM;AAEhE,MAAI,cAAc,SAAS,GAAG;AAC5B,qBAAkB,KAAK;IACrB;IACA,SAAS,cAAc;IACvB,OAAO,UAAU;IAClB,CAAC;AAGF,UAAO,MACL,qBAAqB,OAAO,IAAI,cAAc,MAAM,GAAG,EAAE,CAAC,KAAK,KAAK,GAClE,cAAc,SAAS,IAAI,QAAQ,KAEtC;;UAEI,OAAO;AACd,iBAAe,KAAK,OAAO;AAC3B,SAAO,MAAM,4BAA4B,OAAO,IAAI,MAAM;;AAI9D,KAAI,eAAe,SAAS,KAAK,kBAAkB,SAAS,GAAG;EAC7D,MAAM,WAAW,2BACf,gBACA,kBACD;AACD,SAAO,MAAM,SAAS;AACtB,UAAQ,KAAK,EAAE;;;AAInB,SAAS,gBACP,QACA,UACiC;CACjC,MAAM,eAAe,OAAO,KAAK,SAAS,QAAQ,CAAC;CACnD,MAAMH,QAAyC,EAAE;CAIjD,MAAM,aADoB,OAAO,eAAe,YAAY,QAExD,CAAC,OAAO,cAAc,GAAG,OAAO,cAAc,GAC9C,OAAO;AAEX,MAAK,MAAM,UAAU,WACnB,OAAM,UAAU;EACd,OAAO;EACP,YAAY;EACZ,QAAQ;EACT;AAGH,QAAO;;AAGT,eAAe,gBACb,QACA,kBACA,UACA,OACe;AACf,QAAO,KAAK,6CAA6C,mBAAmB;AAE5E,OAAMI,WAAG,MAAM,kBAAkB,EAAE,WAAW,MAAM,CAAC;CAErD,MAAM,aAAa,IAAI,IAAI,OAAO,KAAK,SAAS,QAAQ,CAAC;AACzD,QAAO,KAAK,gCAAgC,WAAW,KAAK,gBAAgB;CAI5E,MAAM,aADoB,OAAO,eAAe,YAAY,QAExD,CAAC,OAAO,cAAc,GAAG,OAAO,cAAc,GAC9C,OAAO;AAEX,MAAK,MAAM,UAAU,YAAY;EAC/B,MAAM,iBAAiB,KAAK,KAAK,kBAAkB,GAAG,OAAO,OAAO;AAEpE,MAAI;GACF,MAAM,UAAU,MAAM,MAAM,IAAI,QAAQ,MAAM,KAAK,WAAW,CAAC;GAC/D,MAAM,aAAa,eAAe,QAAQ,QAAQ;AAElD,SAAMA,WAAG,UACP,gBACA,KAAK,UAAU,YAAY,MAAM,EAAE,EACnC,QACD;AAED,UAAO,KACL,eAAe,OAAO,SAAS,OAAO,KAAK,QAAQ,CAAC,OAAO,gBAC5D;WACM,OAAO;AACd,UAAO,MAAM,wBAAwB,OAAO,SAAS,MAAM;AAC3D,WAAQ,KAAK,EAAE;;;;AAKrB,SAAS,2BACP,gBACA,mBAKQ;CACR,IAAI,MAAM;AAEV,KAAI,eAAe,SAAS,GAAG;AAC7B,SAAO;AACP,SAAO,eAAe,KAAK,WAAW,SAAS,OAAO,OAAO,CAAC,KAAK,KAAK;AACxE,SAAO;;AAGT,KAAI,kBAAkB,SAAS,GAAG;AAChC,SAAO;AACP,SAAO,kBACJ,KACE,SACC,SAAS,KAAK,OAAO,IAAI,KAAK,QAAQ,GAAG,KAAK,MAAM,uBACvD,CACA,KAAK,KAAK;AACb,SAAO;;AAGT,QAAO;AACP,QAAO;AACP,QAAO;AACP,QAAO;AAEP,QAAO;;AAGT,SAAS,wBACP,QACQ;CACR,IAAI,MAAM;AAEV,QAAO,OAAO,KAAK,QAAQ,OAAO,IAAI,OAAO,IAAI,IAAI,QAAQ,CAAC,KAAK,KAAK;AAExE,QAAO;AACP,QAAO;AACP,QAAO;AAEP,QAAO"}
+{"version":3,"file":"build-translator.mjs","names":["translationServer: TranslationServer | undefined","stats: BuildTranslationResult[\"stats\"]","errors: Array<{ locale: LocaleCode; error: string }>","missingLocales: string[]","incompleteLocales: Array<{\n    locale: LocaleCode;\n    missing: number;\n    total: number;\n  }>","fs"],"sources":["../../src/plugin/build-translator.ts"],"sourcesContent":["/**\n * Build-time translation processor\n *\n * Handles translation generation and validation at build time\n * Supports two modes:\n * - \"translate\": Generate all translations, fail if translation fails\n * - \"cache-only\": Validate cache completeness, fail if incomplete\n */\n// TODO (AleksandrSl 08/12/2025): Add ICU validation for messages? The problem is that we don't know which will be rendered as a simple text\nimport fs from \"fs/promises\";\nimport path from \"path\";\nimport type { LingoConfig, MetadataSchema } from \"../types\";\nimport { logger } from \"../utils/logger\";\nimport { startTranslationServer, type TranslationServer, } from \"../translation-server\";\nimport { loadMetadata } from \"../metadata/manager\";\nimport { createCache, type TranslationCache, TranslationService, } from \"../translators\";\nimport { dictionaryFrom } from \"../translators/api\";\nimport type { LocaleCode } from \"lingo.dev/spec\";\n\nexport interface BuildTranslationOptions {\n  config: LingoConfig;\n  publicOutputPath: string;\n  metadataFilePath: string;\n}\n\nexport interface BuildTranslationResult {\n  /**\n   * Whether the build succeeded\n   */\n  success: boolean;\n\n  /**\n   * Error message if build failed\n   */\n  error?: string;\n\n  /**\n   * Translation statistics per locale\n   */\n  stats: Record<\n    string,\n    {\n      total: number;\n      translated: number;\n      failed: number;\n    }\n  >;\n}\n\n/**\n * Process translations at build time\n *\n * @throws Error if validation or translation fails (causes build to fail)\n */\nexport async function processBuildTranslations(\n  options: BuildTranslationOptions,\n): Promise<BuildTranslationResult> {\n  const { config, publicOutputPath, metadataFilePath } = options;\n\n  // Determine build mode (env var > options > config)\n  const buildMode =\n    (process.env.LINGO_BUILD_MODE as \"translate\" | \"cache-only\") ||\n    config.buildMode;\n\n  logger.info(`🌍 Build mode: ${buildMode}`);\n\n  const metadata = await loadMetadata(metadataFilePath);\n\n  if (!metadata || Object.keys(metadata.entries).length === 0) {\n    logger.info(\"No translations to process (metadata is empty)\");\n    return {\n      success: true,\n      stats: {},\n    };\n  }\n\n  const totalEntries = Object.keys(metadata.entries).length;\n  logger.info(`📊 Found ${totalEntries} translatable entries`);\n\n  const cache = createCache(config);\n\n  // Handle cache-only mode\n  if (buildMode === \"cache-only\") {\n    logger.info(\"🔍 Validating translation cache...\");\n    await validateCache(config, metadata, cache);\n    logger.info(\"✅ Cache validation passed\");\n\n    if (publicOutputPath) {\n      await copyStaticFiles(config, publicOutputPath, metadata, cache);\n    }\n\n    return {\n      success: true,\n      stats: buildCacheStats(config, metadata),\n    };\n  }\n\n  // Handle translate mode\n  logger.info(\"🔄 Generating translations...\");\n  let translationServer: TranslationServer | undefined;\n\n  try {\n    translationServer = await startTranslationServer({\n      translationService: new TranslationService(config, logger),\n      onError: (err) => {\n        logger.error(\"Translation server error:\", err);\n      },\n      config,\n    });\n\n    // When pluralization is enabled, we need to generate the source locale file too\n    // because pluralization modifies the sourceText\n    const needsSourceLocale = config.pluralization?.enabled !== false;\n    const allLocales = needsSourceLocale\n      ? [config.sourceLocale, ...config.targetLocales]\n      : config.targetLocales;\n\n    logger.info(\n      `Processing translations for ${allLocales.length} locale(s)${needsSourceLocale ? \" (including source locale for pluralization)\" : \"\"}...`,\n    );\n\n    const stats: BuildTranslationResult[\"stats\"] = {};\n    const errors: Array<{ locale: LocaleCode; error: string }> = [];\n\n    // Translate all locales in parallel\n    const localePromises = allLocales.map(async (locale) => {\n      logger.info(`Translating to ${locale}...`);\n\n      const result = await translationServer!.translateAll(locale);\n\n      stats[locale] = {\n        total: totalEntries,\n        translated: Object.keys(result.translations).length,\n        failed: result.errors.length,\n      };\n\n      if (result.errors.length > 0) {\n        logger.warn(\n          `⚠️  ${result.errors.length} translation error(s) for ${locale}`,\n        );\n        errors.push({\n          locale,\n          error: `${result.errors.length} translation(s) failed`,\n        });\n      } else {\n        logger.info(`✅ ${locale} completed successfully`);\n      }\n    });\n\n    await Promise.all(localePromises);\n\n    // Fail build if any translations failed in translate mode\n    if (errors.length > 0) {\n      const errorMsg = formatTranslationErrors(errors);\n      logger.error(errorMsg);\n      process.exit(1);\n    }\n\n    // Copy cache to public directory if requested\n    if (publicOutputPath) {\n      await copyStaticFiles(config, publicOutputPath, metadata, cache);\n    }\n\n    logger.info(\"✅ Translation generation completed successfully\");\n\n    return {\n      success: true,\n      stats,\n    };\n  } catch (error) {\n    logger.error(\n      \"❌ Translation generation failed:\\n\",\n      error instanceof Error ? error.message : error,\n    );\n    process.exit(1);\n  } finally {\n    if (translationServer) {\n      await translationServer.stop();\n      logger.info(\"✅ Translation server stopped\");\n    }\n  }\n}\n\n/**\n * Validate that all required translations exist in cache\n * @throws Error if cache is incomplete or missing\n */\nasync function validateCache(\n  config: LingoConfig,\n  metadata: MetadataSchema,\n  cache: TranslationCache,\n): Promise<void> {\n  const allHashes = Object.keys(metadata.entries);\n  const missingLocales: string[] = [];\n  const incompleteLocales: Array<{\n    locale: LocaleCode;\n    missing: number;\n    total: number;\n  }> = [];\n\n  // Include source locale if pluralization is enabled\n  const needsSourceLocale = config.pluralization?.enabled !== false;\n  const allLocales = needsSourceLocale\n    ? [config.sourceLocale, ...config.targetLocales]\n    : config.targetLocales;\n\n  for (const locale of allLocales) {\n    try {\n      const entries = await cache.get(locale);\n\n      if (Object.keys(entries).length === 0) {\n        missingLocales.push(locale);\n        logger.debug(`Cache file not found or empty for ${locale}`);\n        continue;\n      }\n\n      const missingHashes = allHashes.filter((hash) => !entries[hash]);\n\n      if (missingHashes.length > 0) {\n        incompleteLocales.push({\n          locale,\n          missing: missingHashes.length,\n          total: allHashes.length,\n        });\n\n        // Log first few missing hashes for debugging\n        logger.debug(\n          `Missing hashes in ${locale}: ${missingHashes.slice(0, 5).join(\", \")}${\n            missingHashes.length > 5 ? \"...\" : \"\"\n          }`,\n        );\n      }\n    } catch (error) {\n      missingLocales.push(locale);\n      logger.debug(`Failed to read cache for ${locale}:`, error);\n    }\n  }\n\n  if (missingLocales.length > 0 || incompleteLocales.length > 0) {\n    const errorMsg = formatCacheValidationError(\n      missingLocales,\n      incompleteLocales,\n    );\n    logger.error(errorMsg);\n    process.exit(1);\n  }\n}\n\nfunction buildCacheStats(\n  config: LingoConfig,\n  metadata: MetadataSchema,\n): BuildTranslationResult[\"stats\"] {\n  const totalEntries = Object.keys(metadata.entries).length;\n  const stats: BuildTranslationResult[\"stats\"] = {};\n\n  // Include source locale if pluralization is enabled\n  const needsSourceLocale = config.pluralization?.enabled !== false;\n  const allLocales = needsSourceLocale\n    ? [config.sourceLocale, ...config.targetLocales]\n    : config.targetLocales;\n\n  for (const locale of allLocales) {\n    stats[locale] = {\n      total: totalEntries,\n      translated: totalEntries, // Assumed complete if validation passed\n      failed: 0,\n    };\n  }\n\n  return stats;\n}\n\nasync function copyStaticFiles(\n  config: LingoConfig,\n  publicOutputPath: string,\n  metadata: MetadataSchema,\n  cache: TranslationCache,\n): Promise<void> {\n  logger.info(`📦 Generating static translation files in ${publicOutputPath}`);\n\n  await fs.mkdir(publicOutputPath, { recursive: true });\n\n  const usedHashes = new Set(Object.keys(metadata.entries));\n  logger.info(`📊 Filtering translations to ${usedHashes.size} used hash(es)`);\n\n  // Include source locale if pluralization is enabled\n  const needsSourceLocale = config.pluralization?.enabled !== false;\n  const allLocales = needsSourceLocale\n    ? [config.sourceLocale, ...config.targetLocales]\n    : config.targetLocales;\n\n  for (const locale of allLocales) {\n    const publicFilePath = path.join(publicOutputPath, `${locale}.json`);\n\n    try {\n      const entries = await cache.get(locale, Array.from(usedHashes));\n      const outputData = dictionaryFrom(locale, entries);\n\n      await fs.writeFile(\n        publicFilePath,\n        JSON.stringify(outputData, null, 2),\n        \"utf-8\",\n      );\n\n      logger.info(\n        `✓ Generated ${locale}.json (${Object.keys(entries).length} translations)`,\n      );\n    } catch (error) {\n      logger.error(`❌ Failed to generate ${locale}.json:`, error);\n      process.exit(1);\n    }\n  }\n}\n\nfunction formatCacheValidationError(\n  missingLocales: string[],\n  incompleteLocales: Array<{\n    locale: LocaleCode;\n    missing: number;\n    total: number;\n  }>,\n): string {\n  let msg = \"❌ Cache validation failed in cache-only mode:\\n\\n\";\n\n  if (missingLocales.length > 0) {\n    msg += `  📁 Missing cache files:\\n`;\n    msg += missingLocales.map((locale) => `    - ${locale}.json`).join(\"\\n\");\n    msg += \"\\n\\n\";\n  }\n\n  if (incompleteLocales.length > 0) {\n    msg += `  📊 Incomplete cache:\\n`;\n    msg += incompleteLocales\n      .map(\n        (item) =>\n          `    - ${item.locale}: ${item.missing}/${item.total} translations missing`,\n      )\n      .join(\"\\n\");\n    msg += \"\\n\\n\";\n  }\n\n  msg += `  💡 To fix:\\n`;\n  msg += `    1. Set LINGO_BUILD_MODE=translate to generate translations\\n`;\n  msg += `    2. Commit the generated .lingo/cache/*.json files\\n`;\n  msg += `    3. Ensure translation API keys are available if generating translations`;\n\n  return msg;\n}\n\nfunction formatTranslationErrors(\n  errors: Array<{ locale: LocaleCode; error: string }>,\n): string {\n  let msg = \"❌ Translation generation failed:\\n\\n\";\n\n  msg += errors.map((err) => `  - ${err.locale}: ${err.error}`).join(\"\\n\");\n\n  msg += \"\\n\\n\";\n  msg += `  💡 Translation errors must be resolved in \"translate\" mode.\\n`;\n  msg += `     Check translation server logs for details.`;\n\n  return msg;\n}\n"],"mappings":"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"}

package/build/plugin/next.cjs

@@ -1,5 +1,6 @@
 const require_logger = require('../utils/logger.cjs');
 const require_config_factory = require('../utils/config-factory.cjs');
+const require_translation_service = require('../translators/translation-service.cjs');
 const require_manager = require('../metadata/manager.cjs');
 const require_translation_server = require('../translation-server/translation-server.cjs');
 const require_build_translator = require('./build-translator.cjs');
@@ -134,7 +135,7 @@ async function withLingo(nextConfig = {}, lingoOptions) {
 	require_logger.logger.debug(`Initializing Lingo.dev compiler. Is dev mode: ${isDev}. Is main runner: ${isMainRunner()}`);
 	if (isDev && !process.env.LINGO_TRANSLATION_SERVER_URL) {
 		const translationServer = await require_translation_server.startOrGetTranslationServer({
-			startPort: lingoConfig.dev.translationServerStartPort,
+			translationService: new require_translation_service.TranslationService(lingoConfig, require_logger.logger),
 			onError: (err) => {
 				require_logger.logger.error("Translation server error:", err);
 			},
@@ -182,7 +183,6 @@ async function withLingo(nextConfig = {}, lingoOptions) {
 			projectDir
 		});
 		require_logger.logger.info("Running post-build translation generation...");
-		require_logger.logger.info(`Build mode: Using metadata file: ${metadataFilePath}`);
 		try {
 			await require_build_translator.processBuildTranslations({
 				config: lingoConfig,
@@ -190,7 +190,7 @@ async function withLingo(nextConfig = {}, lingoOptions) {
 				metadataFilePath
 			});
 		} catch (error) {
-			require_logger.logger.error("Translation generation failed:", error);
+			require_logger.logger.error("Translation generation failed:", error instanceof Error ? error.message : error);
 			throw error;
 		}
 	};

package/build/plugin/next.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"next.d.cts","names":[],"sources":["../../src/plugin/next.ts"],"sourcesContent":[],"mappings":";;;;KAeY,sBAAA,GAAyB;iBAoLf,SAAA,aACR,sCACE,yBACb,QAAQ"}
+{"version":3,"file":"next.d.cts","names":[],"sources":["../../src/plugin/next.ts"],"sourcesContent":[],"mappings":";;;;KAgBY,sBAAA,GAAyB;iBAoLf,SAAA,aACR,sCACE,yBACb,QAAQ"}

package/build/plugin/next.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"next.d.mts","names":[],"sources":["../../src/plugin/next.ts"],"sourcesContent":[],"mappings":";;;;KAeY,sBAAA,GAAyB;iBAoLf,SAAA,aACR,sCACE,yBACb,QAAQ"}
+{"version":3,"file":"next.d.mts","names":[],"sources":["../../src/plugin/next.ts"],"sourcesContent":[],"mappings":";;;;KAgBY,sBAAA,GAAyB;iBAoLf,SAAA,aACR,sCACE,yBACb,QAAQ"}

package/build/plugin/next.mjs

@@ -1,6 +1,7 @@
 import { __require } from "../_virtual/rolldown_runtime.mjs";
 import { logger } from "../utils/logger.mjs";
 import { createLingoConfig } from "../utils/config-factory.mjs";
+import { TranslationService } from "../translators/translation-service.mjs";
 import { cleanupExistingMetadata, getMetadataPath } from "../metadata/manager.mjs";
 import { startOrGetTranslationServer } from "../translation-server/translation-server.mjs";
 import { processBuildTranslations } from "./build-translator.mjs";
@@ -135,7 +136,7 @@ async function withLingo(nextConfig = {}, lingoOptions) {
 	logger.debug(`Initializing Lingo.dev compiler. Is dev mode: ${isDev}. Is main runner: ${isMainRunner()}`);
 	if (isDev && !process.env.LINGO_TRANSLATION_SERVER_URL) {
 		const translationServer = await startOrGetTranslationServer({
-			startPort: lingoConfig.dev.translationServerStartPort,
+			translationService: new TranslationService(lingoConfig, logger),
 			onError: (err) => {
 				logger.error("Translation server error:", err);
 			},
@@ -183,7 +184,6 @@ async function withLingo(nextConfig = {}, lingoOptions) {
 			projectDir
 		});
 		logger.info("Running post-build translation generation...");
-		logger.info(`Build mode: Using metadata file: ${metadataFilePath}`);
 		try {
 			await processBuildTranslations({
 				config: lingoConfig,
@@ -191,7 +191,7 @@ async function withLingo(nextConfig = {}, lingoOptions) {
 				metadataFilePath
 			});
 		} catch (error) {
-			logger.error("Translation generation failed:", error);
+			logger.error("Translation generation failed:", error instanceof Error ? error.message : error);
 			throw error;
 		}
 	};

package/build/plugin/next.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"next.mjs","names":["turbopackConfig: Partial<NextConfig>","webpack: NextJsWebpackConfig"],"sources":["../../src/plugin/next.ts"],"sourcesContent":["import type { NextConfig } from \"next\";\nimport type {\n  NextJsWebpackConfig,\n  TurbopackOptions,\n  WebpackConfigContext,\n} from \"next/dist/server/config-shared\";\nimport { createLingoConfig } from \"../utils/config-factory\";\nimport { logger } from \"../utils/logger\";\nimport type { LingoConfig, PartialLingoConfig } from \"../types\";\nimport { processBuildTranslations } from \"./build-translator\";\nimport { startOrGetTranslationServer } from \"../translation-server/translation-server\";\nimport { cleanupExistingMetadata, getMetadataPath } from \"../metadata/manager\";\nimport { registerCleanupOnCurrentProcess } from \"./cleanup\";\nimport { useI18nRegex } from \"./transform/use-i18n\";\n\nexport type LingoNextPluginOptions = PartialLingoConfig;\n\ntype RuleKey = \"compiler\" | \"devConfig\" | \"localeServer\" | \"localeClient\";\n\nfunction loaders({\n  lingoConfig,\n  metadataFilePath,\n  translationServerUrl,\n}: {\n  lingoConfig: LingoConfig;\n  metadataFilePath: string;\n  translationServerUrl?: string;\n}): Record<RuleKey, { turbopack?: any; webpack?: any }> {\n  const common = {\n    sourceRoot: lingoConfig.sourceRoot,\n    lingoDir: lingoConfig.lingoDir,\n    sourceLocale: lingoConfig.sourceLocale,\n  };\n\n  // TODO (AleksandrSl 14/12/2025): Type options.\n  const compilerLoader = {\n    loader: \"@lingo.dev/compiler/next-compiler-loader\",\n    options: {\n      ...common,\n      useDirective: lingoConfig.useDirective,\n      metadataFilePath,\n    },\n  };\n\n  const configLoader = {\n    loader: \"@lingo.dev/compiler/next-config-loader\",\n    options: {\n      ...common,\n      dev: {\n        translationServerUrl,\n        ...lingoConfig.dev,\n      },\n    },\n  };\n  const localeServerLoader = {\n    loader: \"@lingo.dev/compiler/next-locale-server-loader\",\n    options: {\n      ...common,\n      localePersistence: lingoConfig.localePersistence,\n    },\n  };\n\n  const localeClientLoader = {\n    loader: \"@lingo.dev/compiler/next-locale-client-loader\",\n    options: {\n      ...common,\n      localePersistence: lingoConfig.localePersistence,\n    },\n  };\n\n  return {\n    compiler: {\n      turbopack: {\n        pattern: \"*.{tsx,jsx}\",\n        config: {\n          condition: {\n            content: lingoConfig.useDirective ? useI18nRegex : undefined,\n          },\n          loaders: [compilerLoader],\n        },\n      },\n      webpack: {\n        enforce: \"pre\",\n        test: /\\.(tsx|jsx)$/i,\n        exclude: /node_modules/,\n        use: [compilerLoader],\n      },\n    },\n\n    devConfig: translationServerUrl\n      ? {\n          turbopack: {\n            pattern: \"**/virtual/config.mjs\",\n            config: {\n              loaders: [configLoader],\n            },\n          },\n          webpack: {\n            enforce: \"pre\",\n            test: /virtual\\/config\\.mjs$/i,\n            use: [configLoader],\n          },\n        }\n      : {},\n\n    localeServer: {\n      turbopack: {\n        pattern: \"**/virtual/locale/server.mjs\",\n        config: {\n          loaders: [localeServerLoader],\n        },\n      },\n      webpack: {\n        enforce: \"pre\",\n        test: /virtual\\/locale[\\\\/]server\\.mjs$/i,\n        use: [localeServerLoader],\n      },\n    },\n\n    localeClient: {\n      turbopack: {\n        pattern: \"**/virtual/locale/client.mjs\",\n        config: {\n          loaders: [localeClientLoader],\n        },\n      },\n      webpack: {\n        enforce: \"pre\",\n        test: /virtual\\/locale[\\\\/]client\\.mjs$/i,\n        use: [localeClientLoader],\n      },\n    },\n  };\n}\n\n/**\n * Check if Next.js supports stable turbopack config (Next.js 16+)\n */\nfunction hasStableTurboConfig(): boolean {\n  try {\n    const nextPackage = require(\"next/package.json\");\n    const majorVersion = parseInt(nextPackage.version.split(\".\")[0], 10);\n    return majorVersion >= 16;\n  } catch {\n    return false;\n  }\n}\n\nfunction getTurbopackConfig(userConfig: NextConfig): TurbopackOptions {\n  return (\n    (hasStableTurboConfig()\n      ? userConfig?.turbopack?.rules\n      : // @ts-expect-error - experimental.turbo for Next.js <16\n        userConfig?.experimental?.turbo) || {}\n  );\n}\n\n/**\n * Merge Turbopack rules without mutating original\n */\nfunction mergeTurbopackRules(\n  existingRules: Record<string, any>,\n  newRules: ({ pattern: string; config: any } | undefined)[],\n): Record<string, any> {\n  const mergedRules = { ...existingRules };\n\n  for (const newRule of newRules) {\n    if (!newRule) continue;\n    const { pattern, config } = newRule;\n\n    if (mergedRules[pattern]) {\n      if (Array.isArray(mergedRules[pattern])) {\n        mergedRules[pattern] = [...mergedRules[pattern], config];\n      } else {\n        mergedRules[pattern] = [mergedRules[pattern], config];\n      }\n    } else {\n      mergedRules[pattern] = config;\n    }\n  }\n\n  return mergedRules;\n}\n\n// Next read config several times. Once in the main runner,\n// and ~ twice in the build workers which cannot get the config otherwise, because it's not serializable.\n// Workers start in separate processed by get most of the env from the main loader\nfunction isMainRunner() {\n  return (\n    !process.env.NEXT_PRIVATE_BUILD_WORKER &&\n    !process.env.IS_NEXT_WORKER &&\n    !process.env.NEXT_PRIVATE_WORKER\n  );\n}\n\nexport async function withLingo(\n  nextConfig: NextConfig = {},\n  lingoOptions: LingoNextPluginOptions,\n): Promise<NextConfig> {\n  const lingoConfig = createLingoConfig(lingoOptions);\n  let metadataFilePath = getMetadataPath(lingoConfig);\n  const isDev = lingoConfig.environment === \"development\";\n\n  logger.debug(\n    `Initializing Lingo.dev compiler. Is dev mode: ${isDev}. Is main runner: ${isMainRunner()}`,\n  );\n\n  // TODO (AleksandrSl 12/12/2025): Add API keys validation too, so we can log it nicely.\n\n  // Try to start up the translation server once.\n  // We have two barriers, a simple one here and a more complex one inside the startTranslationServer which doesn't start the server if it can find one running.\n  // We do not use isMainRunner here, because we need to start the server as early as possible, so the loaders get the translation server url. The main runner in dev mode runs after a dev server process is started.\n  if (isDev && !process.env.LINGO_TRANSLATION_SERVER_URL) {\n    const translationServer = await startOrGetTranslationServer({\n      startPort: lingoConfig.dev.translationServerStartPort,\n      onError: (err) => {\n        logger.error(\"Translation server error:\", err);\n      },\n      onReady: (port) => {\n        logger.info(`Translation server started successfully on port: ${port}`);\n      },\n      config: lingoConfig,\n    });\n    process.env.LINGO_TRANSLATION_SERVER_URL = translationServer.url;\n    if (translationServer.server) {\n      // We start the server in the same process, so we should be fine without any sync cleanup. Server should be killed with the process.\n      registerCleanupOnCurrentProcess({\n        asyncCleanup: async () => {\n          await translationServer.server.stop();\n        },\n      });\n    }\n  }\n\n  const translationServerUrl = process.env.LINGO_TRANSLATION_SERVER_URL;\n\n  if (isMainRunner()) {\n    // We need to cleaup the file only once, to avoid having extra translation introduced into the build, or old translation to pile up.\n    cleanupExistingMetadata(metadataFilePath);\n\n    registerCleanupOnCurrentProcess({\n      cleanup: () => {\n        cleanupExistingMetadata(metadataFilePath);\n      },\n    });\n  }\n\n  const existingTurbopackConfig = getTurbopackConfig(nextConfig);\n  let mergedRules = mergeTurbopackRules(\n    existingTurbopackConfig.rules ?? {},\n    Object.values(\n      loaders({ lingoConfig, metadataFilePath, translationServerUrl }),\n    ).map((rules) => rules.turbopack),\n  );\n\n  const existingResolveAlias = existingTurbopackConfig.resolveAlias;\n  const mergedResolveAlias = {\n    ...existingResolveAlias,\n    // TODO (AleksandrSl 08/12/2025): Describe what have to be done to support custom resolvers\n  };\n\n  let turbopackConfig: Partial<NextConfig>;\n  if (hasStableTurboConfig()) {\n    turbopackConfig = {\n      turbopack: {\n        ...nextConfig.turbopack, // Preserve existing turbopack options\n        rules: mergedRules,\n        resolveAlias: mergedResolveAlias,\n      },\n    };\n  } else {\n    turbopackConfig = {\n      experimental: {\n        ...nextConfig.experimental, // Preserve ALL experimental options\n        // @ts-expect-error - turbo for Next.js <16\n        turbo: {\n          // @ts-expect-error - turbo for Next.js <16\n          ...nextConfig.experimental?.turbo, // Preserve existing turbo options\n          rules: mergedRules,\n          resolveAlias: mergedResolveAlias,\n        },\n      },\n    };\n  }\n\n  const runAfterProductionCompile = async ({\n    distDir,\n    projectDir,\n  }: {\n    distDir: string;\n    projectDir: string;\n  }) => {\n    if (typeof nextConfig.compiler?.runAfterProductionCompile === \"function\") {\n      await nextConfig.compiler.runAfterProductionCompile({\n        distDir,\n        projectDir,\n      });\n    }\n\n    logger.info(\"Running post-build translation generation...\");\n    logger.info(`Build mode: Using metadata file: ${metadataFilePath}`);\n\n    try {\n      await processBuildTranslations({\n        config: lingoConfig,\n        publicOutputPath: distDir,\n        metadataFilePath,\n      });\n    } catch (error) {\n      logger.error(\"Translation generation failed:\", error);\n      throw error;\n    }\n  };\n\n  const webpack: NextJsWebpackConfig = (\n    config: any,\n    options: WebpackConfigContext,\n  ) => {\n    // Apply user's webpack config first if it exists\n    let modifiedConfig = config;\n    if (typeof nextConfig.webpack === \"function\") {\n      modifiedConfig = nextConfig.webpack(config, options);\n    }\n\n    const lingoRules = Object.values(\n      loaders({ lingoConfig, metadataFilePath, translationServerUrl }),\n    )\n      .map((rules) => rules.webpack)\n      .filter(Boolean);\n\n    // I tried using plugin from unplugin, but with all the loaders stuff it works poorly.\n    // Failing with weird errors which appear on the later compilations, probably something with the cache and virtual modules\n    modifiedConfig.module.rules.unshift(...lingoRules);\n\n    return modifiedConfig;\n  };\n\n  return {\n    ...nextConfig,\n    ...turbopackConfig,\n    compiler: {\n      ...nextConfig.compiler,\n      runAfterProductionCompile,\n    },\n    webpack,\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"next.mjs","names":["turbopackConfig: Partial<NextConfig>","webpack: NextJsWebpackConfig"],"sources":["../../src/plugin/next.ts"],"sourcesContent":["import type { NextConfig } from \"next\";\nimport type {\n  NextJsWebpackConfig,\n  TurbopackOptions,\n  WebpackConfigContext,\n} from \"next/dist/server/config-shared\";\nimport { createLingoConfig } from \"../utils/config-factory\";\nimport { logger } from \"../utils/logger\";\nimport type { LingoConfig, PartialLingoConfig } from \"../types\";\nimport { processBuildTranslations } from \"./build-translator\";\nimport { startOrGetTranslationServer } from \"../translation-server/translation-server\";\nimport { cleanupExistingMetadata, getMetadataPath } from \"../metadata/manager\";\nimport { registerCleanupOnCurrentProcess } from \"./cleanup\";\nimport { useI18nRegex } from \"./transform/use-i18n\";\nimport { TranslationService } from \"../translators\";\n\nexport type LingoNextPluginOptions = PartialLingoConfig;\n\ntype RuleKey = \"compiler\" | \"devConfig\" | \"localeServer\" | \"localeClient\";\n\nfunction loaders({\n  lingoConfig,\n  metadataFilePath,\n  translationServerUrl,\n}: {\n  lingoConfig: LingoConfig;\n  metadataFilePath: string;\n  translationServerUrl?: string;\n}): Record<RuleKey, { turbopack?: any; webpack?: any }> {\n  const common = {\n    sourceRoot: lingoConfig.sourceRoot,\n    lingoDir: lingoConfig.lingoDir,\n    sourceLocale: lingoConfig.sourceLocale,\n  };\n\n  // TODO (AleksandrSl 14/12/2025): Type options.\n  const compilerLoader = {\n    loader: \"@lingo.dev/compiler/next-compiler-loader\",\n    options: {\n      ...common,\n      useDirective: lingoConfig.useDirective,\n      metadataFilePath,\n    },\n  };\n\n  const configLoader = {\n    loader: \"@lingo.dev/compiler/next-config-loader\",\n    options: {\n      ...common,\n      dev: {\n        translationServerUrl,\n        ...lingoConfig.dev,\n      },\n    },\n  };\n  const localeServerLoader = {\n    loader: \"@lingo.dev/compiler/next-locale-server-loader\",\n    options: {\n      ...common,\n      localePersistence: lingoConfig.localePersistence,\n    },\n  };\n\n  const localeClientLoader = {\n    loader: \"@lingo.dev/compiler/next-locale-client-loader\",\n    options: {\n      ...common,\n      localePersistence: lingoConfig.localePersistence,\n    },\n  };\n\n  return {\n    compiler: {\n      turbopack: {\n        pattern: \"*.{tsx,jsx}\",\n        config: {\n          condition: {\n            content: lingoConfig.useDirective ? useI18nRegex : undefined,\n          },\n          loaders: [compilerLoader],\n        },\n      },\n      webpack: {\n        enforce: \"pre\",\n        test: /\\.(tsx|jsx)$/i,\n        exclude: /node_modules/,\n        use: [compilerLoader],\n      },\n    },\n\n    devConfig: translationServerUrl\n      ? {\n          turbopack: {\n            pattern: \"**/virtual/config.mjs\",\n            config: {\n              loaders: [configLoader],\n            },\n          },\n          webpack: {\n            enforce: \"pre\",\n            test: /virtual\\/config\\.mjs$/i,\n            use: [configLoader],\n          },\n        }\n      : {},\n\n    localeServer: {\n      turbopack: {\n        pattern: \"**/virtual/locale/server.mjs\",\n        config: {\n          loaders: [localeServerLoader],\n        },\n      },\n      webpack: {\n        enforce: \"pre\",\n        test: /virtual\\/locale[\\\\/]server\\.mjs$/i,\n        use: [localeServerLoader],\n      },\n    },\n\n    localeClient: {\n      turbopack: {\n        pattern: \"**/virtual/locale/client.mjs\",\n        config: {\n          loaders: [localeClientLoader],\n        },\n      },\n      webpack: {\n        enforce: \"pre\",\n        test: /virtual\\/locale[\\\\/]client\\.mjs$/i,\n        use: [localeClientLoader],\n      },\n    },\n  };\n}\n\n/**\n * Check if Next.js supports stable turbopack config (Next.js 16+)\n */\nfunction hasStableTurboConfig(): boolean {\n  try {\n    const nextPackage = require(\"next/package.json\");\n    const majorVersion = parseInt(nextPackage.version.split(\".\")[0], 10);\n    return majorVersion >= 16;\n  } catch {\n    return false;\n  }\n}\n\nfunction getTurbopackConfig(userConfig: NextConfig): TurbopackOptions {\n  return (\n    (hasStableTurboConfig()\n      ? userConfig?.turbopack?.rules\n      : // @ts-expect-error - experimental.turbo for Next.js <16\n        userConfig?.experimental?.turbo) || {}\n  );\n}\n\n/**\n * Merge Turbopack rules without mutating original\n */\nfunction mergeTurbopackRules(\n  existingRules: Record<string, any>,\n  newRules: ({ pattern: string; config: any } | undefined)[],\n): Record<string, any> {\n  const mergedRules = { ...existingRules };\n\n  for (const newRule of newRules) {\n    if (!newRule) continue;\n    const { pattern, config } = newRule;\n\n    if (mergedRules[pattern]) {\n      if (Array.isArray(mergedRules[pattern])) {\n        mergedRules[pattern] = [...mergedRules[pattern], config];\n      } else {\n        mergedRules[pattern] = [mergedRules[pattern], config];\n      }\n    } else {\n      mergedRules[pattern] = config;\n    }\n  }\n\n  return mergedRules;\n}\n\n// Next read config several times. Once in the main runner,\n// and ~ twice in the build workers which cannot get the config otherwise, because it's not serializable.\n// Workers start in separate processed by get most of the env from the main loader\nfunction isMainRunner() {\n  return (\n    !process.env.NEXT_PRIVATE_BUILD_WORKER &&\n    !process.env.IS_NEXT_WORKER &&\n    !process.env.NEXT_PRIVATE_WORKER\n  );\n}\n\nexport async function withLingo(\n  nextConfig: NextConfig = {},\n  lingoOptions: LingoNextPluginOptions,\n): Promise<NextConfig> {\n  const lingoConfig = createLingoConfig(lingoOptions);\n  let metadataFilePath = getMetadataPath(lingoConfig);\n  const isDev = lingoConfig.environment === \"development\";\n\n  logger.debug(\n    `Initializing Lingo.dev compiler. Is dev mode: ${isDev}. Is main runner: ${isMainRunner()}`,\n  );\n\n  // Try to start up the translation server once.\n  // We have two barriers, a simple one here and a more complex one inside the startTranslationServer which doesn't start the server if it can find one running.\n  // We do not use isMainRunner here, because we need to start the server as early as possible, so the loaders get the translation server url. The main runner in dev mode runs after a dev server process is started.\n  if (isDev && !process.env.LINGO_TRANSLATION_SERVER_URL) {\n    const translationServer = await startOrGetTranslationServer({\n      translationService: new TranslationService(lingoConfig, logger),\n      onError: (err) => {\n        logger.error(\"Translation server error:\", err);\n      },\n      onReady: (port) => {\n        logger.info(`Translation server started successfully on port: ${port}`);\n      },\n      config: lingoConfig,\n    });\n    process.env.LINGO_TRANSLATION_SERVER_URL = translationServer.url;\n    if (translationServer.server) {\n      // We start the server in the same process, so we should be fine without any sync cleanup. Server should be killed with the process.\n      registerCleanupOnCurrentProcess({\n        asyncCleanup: async () => {\n          await translationServer.server.stop();\n        },\n      });\n    }\n  }\n\n  const translationServerUrl = process.env.LINGO_TRANSLATION_SERVER_URL;\n\n  if (isMainRunner()) {\n    // We need to cleaup the file only once, to avoid having extra translation introduced into the build, or old translation to pile up.\n    cleanupExistingMetadata(metadataFilePath);\n\n    registerCleanupOnCurrentProcess({\n      cleanup: () => {\n        cleanupExistingMetadata(metadataFilePath);\n      },\n    });\n  }\n\n  const existingTurbopackConfig = getTurbopackConfig(nextConfig);\n  let mergedRules = mergeTurbopackRules(\n    existingTurbopackConfig.rules ?? {},\n    Object.values(\n      loaders({ lingoConfig, metadataFilePath, translationServerUrl }),\n    ).map((rules) => rules.turbopack),\n  );\n\n  const existingResolveAlias = existingTurbopackConfig.resolveAlias;\n  const mergedResolveAlias = {\n    ...existingResolveAlias,\n    // TODO (AleksandrSl 08/12/2025): Describe what have to be done to support custom resolvers\n  };\n\n  let turbopackConfig: Partial<NextConfig>;\n  if (hasStableTurboConfig()) {\n    turbopackConfig = {\n      turbopack: {\n        ...nextConfig.turbopack, // Preserve existing turbopack options\n        rules: mergedRules,\n        resolveAlias: mergedResolveAlias,\n      },\n    };\n  } else {\n    turbopackConfig = {\n      experimental: {\n        ...nextConfig.experimental, // Preserve ALL experimental options\n        // @ts-expect-error - turbo for Next.js <16\n        turbo: {\n          // @ts-expect-error - turbo for Next.js <16\n          ...nextConfig.experimental?.turbo, // Preserve existing turbo options\n          rules: mergedRules,\n          resolveAlias: mergedResolveAlias,\n        },\n      },\n    };\n  }\n\n  const runAfterProductionCompile = async ({\n    distDir,\n    projectDir,\n  }: {\n    distDir: string;\n    projectDir: string;\n  }) => {\n    if (typeof nextConfig.compiler?.runAfterProductionCompile === \"function\") {\n      await nextConfig.compiler.runAfterProductionCompile({\n        distDir,\n        projectDir,\n      });\n    }\n\n    logger.info(\"Running post-build translation generation...\");\n\n    try {\n      await processBuildTranslations({\n        config: lingoConfig,\n        publicOutputPath: distDir,\n        metadataFilePath,\n      });\n    } catch (error) {\n      logger.error(\n        \"Translation generation failed:\",\n        error instanceof Error ? error.message : error,\n      );\n      throw error;\n    }\n  };\n\n  const webpack: NextJsWebpackConfig = (\n    config: any,\n    options: WebpackConfigContext,\n  ) => {\n    // Apply user's webpack config first if it exists\n    let modifiedConfig = config;\n    if (typeof nextConfig.webpack === \"function\") {\n      modifiedConfig = nextConfig.webpack(config, options);\n    }\n\n    const lingoRules = Object.values(\n      loaders({ lingoConfig, metadataFilePath, translationServerUrl }),\n    )\n      .map((rules) => rules.webpack)\n      .filter(Boolean);\n\n    // I tried using plugin from unplugin, but with all the loaders stuff it works poorly.\n    // Failing with weird errors which appear on the later compilations, probably something with the cache and virtual modules\n    modifiedConfig.module.rules.unshift(...lingoRules);\n\n    return modifiedConfig;\n  };\n\n  return {\n    ...nextConfig,\n    ...turbopackConfig,\n    compiler: {\n      ...nextConfig.compiler,\n      runAfterProductionCompile,\n    },\n    webpack,\n  };\n}\n"],"mappings":"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"}

package/build/plugin/unplugin.cjs

@@ -1,6 +1,7 @@
 const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
 const require_logger = require('../utils/logger.cjs');
 const require_config_factory = require('../utils/config-factory.cjs');
+const require_translation_service = require('../translators/translation-service.cjs');
 const require_manager = require('../metadata/manager.cjs');
 const require_translation_server = require('../translation-server/translation-server.cjs');
 const require_build_translator = require('./build-translator.cjs');
@@ -8,6 +9,8 @@ const require_cleanup = require('./cleanup.cjs');
 const require_use_i18n = require('./transform/use-i18n.cjs');
 const require_index = require('./transform/index.cjs');
 const require_code_generator = require('../virtual/code-generator.cjs');
+const require_tracking_events = require('../utils/tracking-events.cjs');
+const require_observability = require('../utils/observability.cjs');
 let path = require("path");
 path = require_rolldown_runtime.__toESM(path);
 let fs = require("fs");
@@ -17,6 +20,12 @@ let unplugin = require("unplugin");
 //#region src/plugin/unplugin.ts
 let translationServer;
 const PLUGIN_NAME = "lingo-compiler";
+let alreadySentBuildStartEvent = false;
+let buildStartTime = null;
+let filesTransformedCount = 0;
+let totalEntriesCount = 0;
+let hasTransformErrors = false;
+let currentFramework = null;
 function tryLocalOrReturnVirtual(config, fileName, virtualName) {
 	const customPath = path.default.join(config.sourceRoot, config.lingoDir, fileName);
 	if (fs.default.existsSync(customPath)) return customPath;
@@ -48,13 +57,25 @@ const virtualModules = {
 const virtualModulesResolvers = Object.fromEntries(Object.entries(virtualModules).map(([importPath, module$1]) => [importPath, (config) => module$1.customFileCheck ? tryLocalOrReturnVirtual(config, module$1.customFileCheck, module$1.virtualId) : module$1.virtualId]));
 const virtualModulesLoaders = Object.fromEntries(Object.values(virtualModules).map((value) => [value.virtualId, value.loader]));
 /**
+* Send build start tracking event
+*/
+function sendBuildStartEvent(framework, config) {
+	if (alreadySentBuildStartEvent) return;
+	alreadySentBuildStartEvent = true;
+	require_observability.default(require_tracking_events.TRACKING_EVENTS.BUILD_START, {
+		framework,
+		configuration: require_tracking_events.sanitizeConfigForTracking(config),
+		environment: config.environment
+	});
+}
+/**
 * Universal plugin for Lingo.dev compiler
 * Supports Vite, Webpack
 */
 const lingoUnplugin = (0, unplugin.createUnplugin)((options) => {
 	const config = require_config_factory.createLingoConfig(options);
 	const isDev = config.environment === "development";
-	const startPort = config.dev.translationServerStartPort;
+	config.dev.translationServerStartPort;
 	let webpackMode;
 	const getMetadataPath$1 = () => {
 		return require_manager.getMetadataPath(webpackMode ? {
@@ -64,7 +85,7 @@ const lingoUnplugin = (0, unplugin.createUnplugin)((options) => {
 	};
 	async function startServer() {
 		const server = await require_translation_server.startTranslationServer({
-			startPort,
+			translationService: new require_translation_service.TranslationService(config, require_logger.logger),
 			onError: (err) => {
 				require_logger.logger.error("Translation server error:", err);
 			},
@@ -88,6 +109,12 @@ const lingoUnplugin = (0, unplugin.createUnplugin)((options) => {
 			},
 			async buildStart() {
 				const metadataFilePath = getMetadataPath$1();
+				currentFramework = "vite";
+				sendBuildStartEvent("vite", config);
+				buildStartTime = Date.now();
+				filesTransformedCount = 0;
+				totalEntriesCount = 0;
+				hasTransformErrors = false;
 				require_manager.cleanupExistingMetadata(metadataFilePath);
 				require_cleanup.registerCleanupOnCurrentProcess({ cleanup: () => require_manager.cleanupExistingMetadata(metadataFilePath) });
 				if (isDev && !translationServer) translationServer = await startServer();
@@ -100,9 +127,27 @@ const lingoUnplugin = (0, unplugin.createUnplugin)((options) => {
 						publicOutputPath: "public/translations",
 						metadataFilePath
 					});
+					if (buildStartTime && !hasTransformErrors) require_observability.default(require_tracking_events.TRACKING_EVENTS.BUILD_SUCCESS, {
+						framework: "vite",
+						stats: {
+							totalEntries: totalEntriesCount,
+							filesTransformed: filesTransformedCount,
+							buildDuration: Date.now() - buildStartTime
+						},
+						environment: config.environment
+					});
 				} catch (error) {
 					require_logger.logger.error("Build-time translation processing failed:", error);
 				}
+				else if (buildStartTime && !hasTransformErrors) require_observability.default(require_tracking_events.TRACKING_EVENTS.BUILD_SUCCESS, {
+					framework: "vite",
+					stats: {
+						totalEntries: totalEntriesCount,
+						filesTransformed: filesTransformedCount,
+						buildDuration: Date.now() - buildStartTime
+					},
+					environment: config.environment
+				});
 			}
 		},
 		webpack(compiler) {
@@ -110,6 +155,12 @@ const lingoUnplugin = (0, unplugin.createUnplugin)((options) => {
 			const metadataFilePath = getMetadataPath$1();
 			config.environment = webpackMode;
 			compiler.hooks.initialize.tap(PLUGIN_NAME, () => {
+				currentFramework = "webpack";
+				sendBuildStartEvent("webpack", config);
+				buildStartTime = Date.now();
+				filesTransformedCount = 0;
+				totalEntriesCount = 0;
+				hasTransformErrors = false;
 				require_manager.cleanupExistingMetadata(metadataFilePath);
 				require_cleanup.registerCleanupOnCurrentProcess({ cleanup: () => require_manager.cleanupExistingMetadata(metadataFilePath) });
 			});
@@ -123,10 +174,28 @@ const lingoUnplugin = (0, unplugin.createUnplugin)((options) => {
 						publicOutputPath: "public/translations",
 						metadataFilePath
 					});
+					if (buildStartTime && !hasTransformErrors) require_observability.default(require_tracking_events.TRACKING_EVENTS.BUILD_SUCCESS, {
+						framework: "webpack",
+						stats: {
+							totalEntries: totalEntriesCount,
+							filesTransformed: filesTransformedCount,
+							buildDuration: Date.now() - buildStartTime
+						},
+						environment: config.environment
+					});
 				} catch (error) {
 					require_logger.logger.error("Build-time translation processing failed:", error);
 					throw error;
 				}
+				else if (buildStartTime && !hasTransformErrors) require_observability.default(require_tracking_events.TRACKING_EVENTS.BUILD_SUCCESS, {
+					framework: "webpack",
+					stats: {
+						totalEntries: totalEntriesCount,
+						filesTransformed: filesTransformedCount,
+						buildDuration: Date.now() - buildStartTime
+					},
+					environment: config.environment
+				});
 			});
 			compiler.hooks.shutdown.tapPromise(PLUGIN_NAME, async () => {
 				require_manager.cleanupExistingMetadata(metadataFilePath);
@@ -168,6 +237,8 @@ const lingoUnplugin = (0, unplugin.createUnplugin)((options) => {
 					const metadataManager = new require_manager.MetadataManager(getMetadataPath$1());
 					if (result.newEntries && result.newEntries.length > 0) {
 						await metadataManager.saveMetadataWithEntries(result.newEntries);
+						totalEntriesCount += result.newEntries.length;
+						filesTransformedCount++;
 						require_logger.logger.debug(`Found ${result.newEntries.length} translatable text(s) in ${id}`);
 					}
 					require_logger.logger.debug(`Returning transformed code for ${id}`);
@@ -176,6 +247,14 @@ const lingoUnplugin = (0, unplugin.createUnplugin)((options) => {
 						map: result.map
 					};
 				} catch (error) {
+					hasTransformErrors = true;
+					if (currentFramework) require_observability.default(require_tracking_events.TRACKING_EVENTS.BUILD_ERROR, {
+						framework: currentFramework,
+						errorType: "transform",
+						errorMessage: error instanceof Error ? error.message : "Unknown transform error",
+						filePath: id,
+						environment: config.environment
+					});
 					require_logger.logger.error(`Transform error in ${id}:`, error);
 					return null;
 				}

package/build/plugin/unplugin.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"unplugin.d.cts","names":[],"sources":["../../src/plugin/unplugin.ts"],"sourcesContent":[],"mappings":";;;;KA6BY,kBAAA,GAAqB"}
+{"version":3,"file":"unplugin.d.cts","names":[],"sources":["../../src/plugin/unplugin.ts"],"sourcesContent":[],"mappings":";;;;KAmCY,kBAAA,GAAqB"}

package/build/plugin/unplugin.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"unplugin.d.mts","names":[],"sources":["../../src/plugin/unplugin.ts"],"sourcesContent":[],"mappings":";;;;KA6BY,kBAAA,GAAqB"}
+{"version":3,"file":"unplugin.d.mts","names":[],"sources":["../../src/plugin/unplugin.ts"],"sourcesContent":[],"mappings":";;;;KAmCY,kBAAA,GAAqB"}

package/build/plugin/unplugin.mjs

@@ -1,5 +1,6 @@
 import { logger } from "../utils/logger.mjs";
 import { createLingoConfig } from "../utils/config-factory.mjs";
+import { TranslationService } from "../translators/translation-service.mjs";
 import { MetadataManager, cleanupExistingMetadata, getMetadataPath } from "../metadata/manager.mjs";
 import { startTranslationServer } from "../translation-server/translation-server.mjs";
 import { processBuildTranslations } from "./build-translator.mjs";
@@ -7,6 +8,8 @@ import { registerCleanupOnCurrentProcess } from "./cleanup.mjs";
 import { useI18nRegex } from "./transform/use-i18n.mjs";
 import { transformComponent } from "./transform/index.mjs";
 import { generateClientLocaleModule, generateConfigModule, generateServerLocaleModule } from "../virtual/code-generator.mjs";
+import { TRACKING_EVENTS, sanitizeConfigForTracking } from "../utils/tracking-events.mjs";
+import trackEvent from "../utils/observability.mjs";
 import path from "path";
 import fs from "fs";
 import { createUnplugin } from "unplugin";
@@ -14,6 +17,12 @@ import { createUnplugin } from "unplugin";
 //#region src/plugin/unplugin.ts
 let translationServer;
 const PLUGIN_NAME = "lingo-compiler";
+let alreadySentBuildStartEvent = false;
+let buildStartTime = null;
+let filesTransformedCount = 0;
+let totalEntriesCount = 0;
+let hasTransformErrors = false;
+let currentFramework = null;
 function tryLocalOrReturnVirtual(config, fileName, virtualName) {
 	const customPath = path.join(config.sourceRoot, config.lingoDir, fileName);
 	if (fs.existsSync(customPath)) return customPath;
@@ -45,13 +54,25 @@ const virtualModules = {
 const virtualModulesResolvers = Object.fromEntries(Object.entries(virtualModules).map(([importPath, module]) => [importPath, (config) => module.customFileCheck ? tryLocalOrReturnVirtual(config, module.customFileCheck, module.virtualId) : module.virtualId]));
 const virtualModulesLoaders = Object.fromEntries(Object.values(virtualModules).map((value) => [value.virtualId, value.loader]));
 /**
+* Send build start tracking event
+*/
+function sendBuildStartEvent(framework, config) {
+	if (alreadySentBuildStartEvent) return;
+	alreadySentBuildStartEvent = true;
+	trackEvent(TRACKING_EVENTS.BUILD_START, {
+		framework,
+		configuration: sanitizeConfigForTracking(config),
+		environment: config.environment
+	});
+}
+/**
 * Universal plugin for Lingo.dev compiler
 * Supports Vite, Webpack
 */
 const lingoUnplugin = createUnplugin((options) => {
 	const config = createLingoConfig(options);
 	const isDev = config.environment === "development";
-	const startPort = config.dev.translationServerStartPort;
+	config.dev.translationServerStartPort;
 	let webpackMode;
 	const getMetadataPath$1 = () => {
 		return getMetadataPath(webpackMode ? {
@@ -61,7 +82,7 @@ const lingoUnplugin = createUnplugin((options) => {
 	};
 	async function startServer() {
 		const server = await startTranslationServer({
-			startPort,
+			translationService: new TranslationService(config, logger),
 			onError: (err) => {
 				logger.error("Translation server error:", err);
 			},
@@ -85,6 +106,12 @@ const lingoUnplugin = createUnplugin((options) => {
 			},
 			async buildStart() {
 				const metadataFilePath = getMetadataPath$1();
+				currentFramework = "vite";
+				sendBuildStartEvent("vite", config);
+				buildStartTime = Date.now();
+				filesTransformedCount = 0;
+				totalEntriesCount = 0;
+				hasTransformErrors = false;
 				cleanupExistingMetadata(metadataFilePath);
 				registerCleanupOnCurrentProcess({ cleanup: () => cleanupExistingMetadata(metadataFilePath) });
 				if (isDev && !translationServer) translationServer = await startServer();
@@ -97,9 +124,27 @@ const lingoUnplugin = createUnplugin((options) => {
 						publicOutputPath: "public/translations",
 						metadataFilePath
 					});
+					if (buildStartTime && !hasTransformErrors) trackEvent(TRACKING_EVENTS.BUILD_SUCCESS, {
+						framework: "vite",
+						stats: {
+							totalEntries: totalEntriesCount,
+							filesTransformed: filesTransformedCount,
+							buildDuration: Date.now() - buildStartTime
+						},
+						environment: config.environment
+					});
 				} catch (error) {
 					logger.error("Build-time translation processing failed:", error);
 				}
+				else if (buildStartTime && !hasTransformErrors) trackEvent(TRACKING_EVENTS.BUILD_SUCCESS, {
+					framework: "vite",
+					stats: {
+						totalEntries: totalEntriesCount,
+						filesTransformed: filesTransformedCount,
+						buildDuration: Date.now() - buildStartTime
+					},
+					environment: config.environment
+				});
 			}
 		},
 		webpack(compiler) {
@@ -107,6 +152,12 @@ const lingoUnplugin = createUnplugin((options) => {
 			const metadataFilePath = getMetadataPath$1();
 			config.environment = webpackMode;
 			compiler.hooks.initialize.tap(PLUGIN_NAME, () => {
+				currentFramework = "webpack";
+				sendBuildStartEvent("webpack", config);
+				buildStartTime = Date.now();
+				filesTransformedCount = 0;
+				totalEntriesCount = 0;
+				hasTransformErrors = false;
 				cleanupExistingMetadata(metadataFilePath);
 				registerCleanupOnCurrentProcess({ cleanup: () => cleanupExistingMetadata(metadataFilePath) });
 			});
@@ -120,10 +171,28 @@ const lingoUnplugin = createUnplugin((options) => {
 						publicOutputPath: "public/translations",
 						metadataFilePath
 					});
+					if (buildStartTime && !hasTransformErrors) trackEvent(TRACKING_EVENTS.BUILD_SUCCESS, {
+						framework: "webpack",
+						stats: {
+							totalEntries: totalEntriesCount,
+							filesTransformed: filesTransformedCount,
+							buildDuration: Date.now() - buildStartTime
+						},
+						environment: config.environment
+					});
 				} catch (error) {
 					logger.error("Build-time translation processing failed:", error);
 					throw error;
 				}
+				else if (buildStartTime && !hasTransformErrors) trackEvent(TRACKING_EVENTS.BUILD_SUCCESS, {
+					framework: "webpack",
+					stats: {
+						totalEntries: totalEntriesCount,
+						filesTransformed: filesTransformedCount,
+						buildDuration: Date.now() - buildStartTime
+					},
+					environment: config.environment
+				});
 			});
 			compiler.hooks.shutdown.tapPromise(PLUGIN_NAME, async () => {
 				cleanupExistingMetadata(metadataFilePath);
@@ -165,6 +234,8 @@ const lingoUnplugin = createUnplugin((options) => {
 					const metadataManager = new MetadataManager(getMetadataPath$1());
 					if (result.newEntries && result.newEntries.length > 0) {
 						await metadataManager.saveMetadataWithEntries(result.newEntries);
+						totalEntriesCount += result.newEntries.length;
+						filesTransformedCount++;
 						logger.debug(`Found ${result.newEntries.length} translatable text(s) in ${id}`);
 					}
 					logger.debug(`Returning transformed code for ${id}`);
@@ -173,6 +244,14 @@ const lingoUnplugin = createUnplugin((options) => {
 						map: result.map
 					};
 				} catch (error) {
+					hasTransformErrors = true;
+					if (currentFramework) trackEvent(TRACKING_EVENTS.BUILD_ERROR, {
+						framework: currentFramework,
+						errorType: "transform",
+						errorMessage: error instanceof Error ? error.message : "Unknown transform error",
+						filePath: id,
+						environment: config.environment
+					});
 					logger.error(`Transform error in ${id}:`, error);
 					return null;
 				}