@lingo.dev/compiler 0.3.7 → 0.3.8

package/build/react/server/ServerLingoProvider.d.mts

@@ -1,12 +1,12 @@
 import { LingoProviderProps } from "../shared/LingoProvider.mjs";
-import * as react_jsx_runtime1 from "react/jsx-runtime";
+import * as react_jsx_runtime2 from "react/jsx-runtime";
 
 //#region src/react/server/ServerLingoProvider.d.ts
 declare function LingoProvider({
   initialLocale,
   initialTranslations,
   ...rest
-}: LingoProviderProps): Promise<react_jsx_runtime1.JSX.Element>;
+}: LingoProviderProps): Promise<react_jsx_runtime2.JSX.Element>;
 //#endregion
 export { LingoProvider };
 //# sourceMappingURL=ServerLingoProvider.d.mts.map

package/build/react/shared/LingoProvider.d.mts

@@ -1,5 +1,5 @@
 import { PropsWithChildren } from "react";
-import * as react_jsx_runtime3 from "react/jsx-runtime";
+import * as react_jsx_runtime1 from "react/jsx-runtime";
 import { LocaleCode } from "lingo.dev/spec";
 
 //#region src/react/shared/LingoProvider.d.ts
@@ -70,7 +70,7 @@ declare function LingoProvider__Dev({
   router,
   devWidget,
   children
-}: LingoProviderProps): react_jsx_runtime3.JSX.Element;
+}: LingoProviderProps): react_jsx_runtime1.JSX.Element;
 //#endregion
 export { LingoProvider, LingoProviderProps };
 //# sourceMappingURL=LingoProvider.d.mts.map

package/build/react/shared/LocaleSwitcher.d.mts

@@ -1,5 +1,5 @@
 import { CSSProperties } from "react";
-import * as react_jsx_runtime2 from "react/jsx-runtime";
+import * as react_jsx_runtime3 from "react/jsx-runtime";
 import { LocaleCode } from "lingo.dev/spec";
 
 //#region src/react/shared/LocaleSwitcher.d.ts
@@ -65,7 +65,7 @@ declare function LocaleSwitcher({
   style,
   className,
   showLoadingState
-}: LocaleSwitcherProps): react_jsx_runtime2.JSX.Element;
+}: LocaleSwitcherProps): react_jsx_runtime3.JSX.Element;
 //#endregion
 export { LocaleSwitcher };
 //# sourceMappingURL=LocaleSwitcher.d.mts.map

package/build/translation-server/translation-server.cjs

@@ -241,6 +241,18 @@ var TranslationServer = class {
 			hashes: allHashes
 		}));
 		const result = await this.translationService.translate(locale, this.metadata, allHashes);
+		if (result.errors.length > 0) {
+			this.logger.error(`${result.errors.length} translation error(s) for ${locale}:`);
+			for (const err of result.errors) {
+				const prefix = `  [${locale}]`;
+				if (err.hash === "all") {
+					this.logger.error(`${prefix} ${err.error}`);
+					continue;
+				}
+				const source = err.sourceText.length > 200 ? err.sourceText.slice(0, 200) + "..." : err.sourceText;
+				this.logger.error(`${prefix} hash=${err.hash} source="${source}" error="${err.error}"`);
+			}
+		}
 		const duration = Date.now() - startTime;
 		this.broadcast(require_ws_events.createEvent("batch:complete", {
 			locale,

package/build/translation-server/translation-server.mjs

@@ -238,6 +238,18 @@ var TranslationServer = class {
 			hashes: allHashes
 		}));
 		const result = await this.translationService.translate(locale, this.metadata, allHashes);
+		if (result.errors.length > 0) {
+			this.logger.error(`${result.errors.length} translation error(s) for ${locale}:`);
+			for (const err of result.errors) {
+				const prefix = `  [${locale}]`;
+				if (err.hash === "all") {
+					this.logger.error(`${prefix} ${err.error}`);
+					continue;
+				}
+				const source = err.sourceText.length > 200 ? err.sourceText.slice(0, 200) + "..." : err.sourceText;
+				this.logger.error(`${prefix} hash=${err.hash} source="${source}" error="${err.error}"`);
+			}
+		}
 		const duration = Date.now() - startTime;
 		this.broadcast(createEvent("batch:complete", {
 			locale,

package/build/translation-server/translation-server.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"translation-server.mjs","names":["out: Record<string, any>"],"sources":["../../src/translation-server/translation-server.ts"],"sourcesContent":["/**\n * Simple HTTP server for serving translations during development\n *\n * This server:\n * - Finds a free port automatically\n * - Serves translations via:\n *   - GET /translations/:locale - Full dictionary (cached)\n *   - POST /translations/:locale (body: { hashes: string[] }) - Batch translation\n * - Uses the same translation logic as middleware\n * - Can be started/stopped programmatically\n */\n\nimport http from \"http\";\nimport crypto from \"crypto\";\nimport type { Socket } from \"net\";\nimport { URL } from \"url\";\nimport { WebSocket, WebSocketServer } from \"ws\";\nimport type { MetadataSchema, TranslationMiddlewareConfig } from \"../types\";\nimport { getLogger } from \"./logger\";\nimport { TranslationService } from \"../translators\";\nimport { getMetadataPath, loadMetadata } from \"../metadata/manager\";\nimport type { TranslationServerEvent } from \"./ws-events\";\nimport { createEvent } from \"./ws-events\";\nimport type { LocaleCode } from \"lingo.dev/spec\";\nimport { parseLocaleOrThrow } from \"../utils/is-valid-locale\";\n\nexport interface TranslationServerOptions {\n  config: TranslationMiddlewareConfig;\n  translationService?: TranslationService;\n  onReady?: (port: number) => void;\n  onError?: (error: Error) => void;\n}\n\nexport class TranslationServer {\n  private server: http.Server | null = null;\n  private url: string | undefined = undefined;\n  private logger;\n  private readonly config: TranslationMiddlewareConfig;\n  private readonly configHash: string;\n  private readonly startPort: number;\n  private readonly onReadyCallback?: (port: number) => void;\n  private readonly onErrorCallback?: (error: Error) => void;\n  private metadata: MetadataSchema | null = null;\n  private connections: Set<Socket> = new Set();\n  private wss: WebSocketServer | null = null;\n  private wsClients: Set<WebSocket> = new Set();\n\n  // Translation activity tracking for \"busy\" notifications\n  private activeTranslations = 0;\n  private isBusy = false;\n  private busyTimeout: NodeJS.Timeout | null = null;\n  private readonly BUSY_DEBOUNCE_MS = 500; // Time after last translation to send \"idle\" event\n  private readonly translationService: TranslationService;\n\n  constructor(options: TranslationServerOptions) {\n    this.config = options.config;\n    this.configHash = hashConfig(options.config);\n    this.translationService =\n      options.translationService ??\n      // Fallback is for CLI start only.\n      new TranslationService(options.config, getLogger(options.config));\n    this.startPort = options.config.dev.translationServerStartPort;\n    this.onReadyCallback = options.onReady;\n    this.onErrorCallback = options.onError;\n    this.logger = getLogger(this.config);\n  }\n\n  /**\n   * Start the server and find an available port\n   */\n  async start(): Promise<number> {\n    if (this.server) {\n      throw new Error(\"Server is already running\");\n    }\n\n    this.logger.info(`🔧 Initializing translator...`);\n\n    const port = await this.findAvailablePort(this.startPort);\n\n    return new Promise((resolve, reject) => {\n      this.server = http.createServer((req, res) => {\n        // Log that we received a request (before async handling)\n        this.logger.info(`📥 Received: ${req.method} ${req.url}`);\n\n        // Wrap async handler and catch errors explicitly\n        this.handleRequest(req, res).catch((error) => {\n          this.logger.error(`Request handler error:`, error);\n          this.logger.error(error.stack);\n\n          // Send error response if headers not sent\n          if (!res.headersSent) {\n            res.writeHead(500, { \"Content-Type\": \"application/json\" });\n            res.end(JSON.stringify({ error: \"Internal Server Error\" }));\n          }\n        });\n      });\n\n      this.logger.debug(`Starting translation server on port ${port}`);\n\n      // Track connections for graceful shutdown\n      this.server.on(\"connection\", (socket) => {\n        this.connections.add(socket);\n        socket.once(\"close\", () => {\n          this.connections.delete(socket);\n        });\n      });\n\n      this.server.on(\"error\", (error: NodeJS.ErrnoException) => {\n        if (error.code === \"EADDRINUSE\") {\n          // Port is in use, try next one\n          reject(new Error(`Port ${port} is already in use`));\n        } else {\n          this.logger.error(`Translation server error: ${error.message}\\n`);\n          this.onErrorCallback?.(error);\n          reject(error);\n        }\n      });\n\n      this.server.listen(port, \"127.0.0.1\", () => {\n        this.url = `http://127.0.0.1:${port}`;\n        this.logger.info(`Translation server listening on ${this.url}`);\n\n        // Initialize WebSocket server on the same port\n        this.initializeWebSocket();\n\n        this.onReadyCallback?.(port);\n        resolve(port);\n      });\n    });\n  }\n\n  /**\n   * Initialize WebSocket server for real-time dev widget updates\n   */\n  private initializeWebSocket(): void {\n    if (!this.server) {\n      throw new Error(\"HTTP server must be started before WebSocket\");\n    }\n\n    this.wss = new WebSocketServer({ server: this.server });\n\n    this.wss.on(\"connection\", (ws: WebSocket) => {\n      this.wsClients.add(ws);\n      this.logger.debug(\n        `WebSocket client connected. Total clients: ${this.wsClients.size}`,\n      );\n\n      // Send initial connected event\n      this.sendToClient(ws, createEvent(\"connected\", { serverUrl: this.url! }));\n\n      ws.on(\"close\", () => {\n        this.wsClients.delete(ws);\n        this.logger.debug(\n          `WebSocket client disconnected. Total clients: ${this.wsClients.size}`,\n        );\n      });\n\n      ws.on(\"error\", (error) => {\n        this.logger.error(`WebSocket client error:`, error);\n        this.wsClients.delete(ws);\n      });\n    });\n\n    this.wss.on(\"error\", (error) => {\n      this.logger.error(`WebSocket server error:`, error);\n      this.onErrorCallback?.(error);\n    });\n\n    this.logger.info(`WebSocket server initialized`);\n  }\n\n  /**\n   * Send event to a specific WebSocket client\n   */\n  private sendToClient(ws: WebSocket, event: TranslationServerEvent): void {\n    if (ws.readyState === WebSocket.OPEN) {\n      ws.send(JSON.stringify(event));\n    }\n  }\n\n  /**\n   * Broadcast event to all connected WebSocket clients\n   */\n  private broadcast(event: TranslationServerEvent): void {\n    const message = JSON.stringify(event);\n    for (const client of this.wsClients) {\n      if (client.readyState === WebSocket.OPEN) {\n        client.send(message);\n      }\n    }\n  }\n\n  /**\n   * Stop the server\n   */\n  async stop(): Promise<void> {\n    if (!this.server) {\n      this.logger.debug(\"Translation server is not running. Nothing to stop.\");\n      return;\n    }\n\n    // Clear any pending busy timeout\n    if (this.busyTimeout) {\n      clearTimeout(this.busyTimeout);\n      this.busyTimeout = null;\n    }\n\n    // Close all WebSocket connections\n    for (const client of this.wsClients) {\n      client.close();\n    }\n    this.wsClients.clear();\n\n    // Close WebSocket server\n    if (this.wss) {\n      this.wss.close();\n      this.wss = null;\n    }\n\n    // Destroy all active HTTP connections to prevent hanging\n    for (const socket of this.connections) {\n      socket.destroy();\n    }\n    this.connections.clear();\n\n    return new Promise((resolve, reject) => {\n      this.server!.close((error) => {\n        if (error) {\n          reject(error);\n        } else {\n          this.logger.info(`Translation server stopped`);\n          this.server = null;\n          this.url = undefined;\n          resolve();\n        }\n      });\n    });\n  }\n\n  /**\n   * Get the current port (null if not running)\n   */\n  getUrl(): string | undefined {\n    return this.url;\n  }\n\n  /**\n   * Start a new server or get the URL of an existing one on the preferred port.\n   *\n   * This method optimizes for the common case where a translation server is already\n   * running on a preferred port. If that port is taken, it checks if it's our service\n   * by calling the health check endpoint. If it is, we reuse it instead of starting\n   * a new server on a different port.\n   *\n   * @returns URL of the running server (new or existing)\n   */\n  async startOrGetUrl(): Promise<string> {\n    if (this.server && this.url) {\n      this.logger.info(`Using existing server instance at ${this.url}`);\n      return this.url;\n    }\n\n    const preferredPort = this.startPort;\n    const preferredUrl = `http://127.0.0.1:${preferredPort}`;\n\n    // Check if port is available\n    const portAvailable = await this.isPortAvailable(preferredPort);\n\n    if (portAvailable) {\n      // Port is free, start a new server\n      this.logger.info(\n        `Port ${preferredPort} is available, starting new server...`,\n      );\n      await this.start();\n      return this.url!;\n    }\n\n    // Port is taken, check if it's our translation server\n    this.logger.info(\n      `Port ${preferredPort} is in use, checking if it's a translation server...`,\n    );\n    const isOurServer = await this.checkIfTranslationServer(preferredUrl);\n\n    if (isOurServer) {\n      // It's our server, reuse it\n      this.logger.info(\n        `✅ Found existing translation server at ${preferredUrl}, reusing it`,\n      );\n      this.url = preferredUrl;\n      return preferredUrl;\n    }\n\n    // Port is taken by something else, start a new server on a different port\n    this.logger.info(\n      `Port ${preferredPort} is in use by another service, finding alternative...`,\n    );\n    await this.start();\n    return this.url!;\n  }\n\n  /**\n   * Check if server is running\n   */\n  isRunning(): boolean {\n    return this.server !== null && this.url !== null;\n  }\n\n  /**\n   * Reload metadata from disk\n   * Useful when metadata has been updated during runtime (e.g., new transformations)\n   */\n  async reloadMetadata(): Promise<void> {\n    try {\n      this.metadata = await loadMetadata(getMetadataPath(this.config));\n      this.logger.debug(\n        `Reloaded metadata: ${Object.keys(this.metadata).length} entries`,\n      );\n    } catch (error) {\n      this.logger.warn(\"Failed to reload metadata:\", error);\n      this.metadata = {};\n    }\n  }\n\n  /**\n   * Translate the entire dictionary for a given locale\n   *\n   * This method always reloads metadata from disk before translating to ensure\n   * all entries added during build-time transformations are included.\n   *\n   * This is the recommended method for build-time translation generation.\n   */\n  async translateAll(locale: LocaleCode): Promise<{\n    translations: Record<string, string>;\n    errors: Array<{ hash: string; error: string }>;\n  }> {\n    if (!this.translationService) {\n      throw new Error(\"Translation server not initialized\");\n    }\n\n    // Always reload metadata to get the latest entries\n    // This is critical for build-time translation where metadata is updated\n    // continuously as files are transformed\n    await this.reloadMetadata();\n\n    if (!this.metadata) {\n      throw new Error(\"Failed to load metadata\");\n    }\n\n    const allHashes = Object.keys(this.metadata);\n\n    this.logger.info(\n      `Translating all ${allHashes.length} entries to ${locale}`,\n    );\n\n    // Broadcast batch start event\n    const startTime = Date.now();\n    this.broadcast(\n      createEvent(\"batch:start\", {\n        locale,\n        total: allHashes.length,\n        hashes: allHashes,\n      }),\n    );\n\n    const result = await this.translationService.translate(\n      locale,\n      this.metadata,\n      allHashes,\n    );\n\n    // Broadcast batch complete event\n    const duration = Date.now() - startTime;\n    this.broadcast(\n      createEvent(\"batch:complete\", {\n        locale,\n        total: allHashes.length,\n        successful: Object.keys(result.translations).length,\n        failed: result.errors.length,\n        duration,\n      }),\n    );\n\n    return result;\n  }\n\n  /**\n   * Find an available port starting from the given port\n   */\n  private async findAvailablePort(\n    startPort: number,\n    maxAttempts = 100,\n  ): Promise<number> {\n    for (let port = startPort; port < startPort + maxAttempts; port++) {\n      if (await this.isPortAvailable(port)) {\n        return port;\n      }\n    }\n    throw new Error(\n      `Could not find available port in range ${startPort}-${startPort + maxAttempts}`,\n    );\n  }\n\n  /**\n   * Check if a port is available\n   */\n  private async isPortAvailable(port: number): Promise<boolean> {\n    return new Promise((resolve) => {\n      const testServer = http.createServer();\n\n      testServer.once(\"error\", (error: NodeJS.ErrnoException) => {\n        if (error.code === \"EADDRINUSE\") {\n          resolve(false);\n        } else {\n          resolve(false);\n        }\n      });\n\n      testServer.once(\"listening\", () => {\n        testServer.close(() => {\n          resolve(true);\n        });\n      });\n\n      testServer.listen(port, \"127.0.0.1\");\n    });\n  }\n\n  /**\n   * Mark translation activity start - emits busy event if not already busy\n   */\n  private startTranslationActivity(): void {\n    this.activeTranslations++;\n\n    // Clear any pending idle timeout\n    if (this.busyTimeout) {\n      clearTimeout(this.busyTimeout);\n      this.busyTimeout = null;\n    }\n\n    // Emit busy event if this is the first active translation\n    if (!this.isBusy && this.activeTranslations > 0) {\n      this.isBusy = true;\n      this.broadcast(\n        createEvent(\"server:busy\", {\n          activeTranslations: this.activeTranslations,\n        }),\n      );\n      this.logger.debug(\n        `[BUSY] Server is now busy (${this.activeTranslations} active)`,\n      );\n    }\n  }\n\n  /**\n   * Mark translation activity end - emits idle event after debounce period\n   */\n  private endTranslationActivity(): void {\n    this.activeTranslations = Math.max(0, this.activeTranslations - 1);\n\n    // If no more active translations, schedule idle notification\n    if (this.activeTranslations === 0 && this.isBusy) {\n      // Clear any existing timeout\n      if (this.busyTimeout) {\n        clearTimeout(this.busyTimeout);\n      }\n\n      // Wait for debounce period before sending idle event\n      // This prevents rapid busy->idle->busy cycles when translations come in quick succession\n      this.busyTimeout = setTimeout(() => {\n        if (this.activeTranslations === 0) {\n          this.isBusy = false;\n          this.broadcast(createEvent(\"server:idle\", {}));\n          this.logger.debug(\"[IDLE] Server is now idle\");\n        }\n      }, this.BUSY_DEBOUNCE_MS);\n    }\n  }\n\n  /**\n   * Check if a given URL is running our translation server by calling the health endpoint\n   * Also verifies that the config hash matches to ensure compatible configuration\n   */\n  private async checkIfTranslationServer(url: string): Promise<boolean> {\n    return new Promise((resolve) => {\n      const healthUrl = `${url}/health`;\n\n      const req = http.get(healthUrl, { timeout: 2000 }, (res) => {\n        let data = \"\";\n\n        res.on(\"data\", (chunk) => {\n          data += chunk.toString();\n        });\n\n        res.on(\"end\", () => {\n          try {\n            if (res.statusCode === 200) {\n              const json = JSON.parse(data);\n              // Our translation server returns { status: \"ok\", port: ..., configHash: ... }\n              // Check if config hash matches (if present)\n              // If configHash is missing (old server), accept it for backward compatibility\n              if (json.configHash && json.configHash !== this.configHash) {\n                this.logger.warn(\n                  `Existing server has different config (hash: ${json.configHash} vs ${this.configHash}), will start new server`,\n                );\n                resolve(false);\n                return;\n              }\n              resolve(true);\n              return;\n            }\n            resolve(false);\n          } catch (error) {\n            // Failed to parse JSON or invalid response\n            resolve(false);\n          }\n        });\n      });\n\n      req.on(\"error\", () => {\n        // Connection failed, not our server\n        resolve(false);\n      });\n\n      req.on(\"timeout\", () => {\n        req.destroy();\n        resolve(false);\n      });\n    });\n  }\n\n  /**\n   * Handle incoming HTTP request\n   */\n  private async handleRequest(\n    req: http.IncomingMessage,\n    res: http.ServerResponse,\n  ): Promise<void> {\n    this.logger.info(`🔄 Processing: ${req.method} ${req.url}`);\n\n    try {\n      const url = new URL(req.url || \"\", `http://${req.headers.host}`);\n\n      // Log request\n      this.logger.debug(`${req.method} ${url.pathname}`);\n\n      // Handle CORS for browser requests\n      res.setHeader(\"Access-Control-Allow-Origin\", \"*\");\n      res.setHeader(\"Access-Control-Allow-Methods\", \"GET, POST, OPTIONS\");\n      res.setHeader(\"Access-Control-Allow-Headers\", \"Content-Type\");\n      res.setHeader(\n        \"Access-Control-Expose-Headers\",\n        \"Content-Type, Cache-Control\",\n      );\n\n      if (req.method === \"OPTIONS\") {\n        res.writeHead(204);\n        res.end();\n        return;\n      }\n\n      if (url.pathname === \"/health\") {\n        res.writeHead(200, { \"Content-Type\": \"application/json\" });\n        res.end(\n          JSON.stringify({\n            port: this.url,\n            configHash: this.configHash,\n          }),\n        );\n        return;\n      }\n\n      // Batch translation endpoint: POST /translations/:locale\n      const postMatch = url.pathname.match(/^\\/translations\\/([^/]+)$/);\n      if (postMatch && req.method === \"POST\") {\n        const [, locale] = postMatch;\n\n        await this.handleBatchTranslationRequest(locale, req, res);\n        return;\n      }\n\n      // Translation dictionary endpoint: GET /translations/:locale\n      const dictMatch = url.pathname.match(/^\\/translations\\/([^/]+)$/);\n      if (dictMatch && req.method === \"GET\") {\n        const [, locale] = dictMatch;\n        await this.handleDictionaryRequest(locale, res);\n        return;\n      }\n\n      // 404 for unknown routes\n      res.writeHead(404, { \"Content-Type\": \"application/json\" });\n      res.end(\n        JSON.stringify({\n          error: \"Not Found\",\n          message: \"Unknown endpoint\",\n          availableEndpoints: [\n            \"GET /health\",\n            \"GET /translations/:locale\",\n            \"POST /translations/:locale (with body: { hashes: string[] })\",\n          ],\n        }),\n      );\n    } catch (error) {\n      this.logger.error(\"Error handling request:\", error);\n      res.writeHead(500, { \"Content-Type\": \"application/json\" });\n      res.end(\n        JSON.stringify({\n          error: \"Internal Server Error\",\n          message: error instanceof Error ? error.message : \"Unknown error\",\n        }),\n      );\n    }\n  }\n\n  /**\n   * Handle batch translation request\n   */\n  private async handleBatchTranslationRequest(\n    locale: string,\n    req: http.IncomingMessage,\n    res: http.ServerResponse,\n  ): Promise<void> {\n    try {\n      const parsedLocale = parseLocaleOrThrow(locale);\n\n      // Read request body\n      let body = \"\";\n      this.logger.debug(\"Reading request body...\");\n      for await (const chunk of req) {\n        body += chunk.toString();\n        this.logger.debug(`Chunk read, body: ${body}`);\n      }\n\n      // Parse body\n      const { hashes } = JSON.parse(body);\n\n      this.logger.debug(`Parsed hashes: ${hashes.join(\",\")}`);\n\n      if (!Array.isArray(hashes)) {\n        res.writeHead(400, { \"Content-Type\": \"application/json\" });\n        res.end(\n          JSON.stringify({\n            error: \"Bad Request\",\n            message: \"Body must contain 'hashes' array\",\n          }),\n        );\n        return;\n      }\n      // Reload metadata to ensure we have the latest entries\n      // (new entries may have been added since server started)\n      await this.reloadMetadata();\n\n      if (!this.metadata) {\n        throw new Error(\"Failed to load metadata\");\n      }\n\n      this.logger.info(`🔄 Translating ${hashes.length} hashes to ${locale}`);\n      this.logger.debug(`🔄 Hashes: ${hashes.join(\", \")}`);\n\n      // Mark translation activity start\n      this.startTranslationActivity();\n\n      try {\n        const result = await this.translationService.translate(\n          parsedLocale,\n          this.metadata,\n          hashes,\n        );\n\n        // Return successful response\n        res.writeHead(200, {\n          \"Content-Type\": \"application/json\",\n          \"Cache-Control\": \"no-cache\",\n        });\n        res.end(\n          JSON.stringify({\n            locale,\n            translations: result.translations,\n            errors: result.errors,\n          }),\n        );\n      } finally {\n        // Mark translation activity end\n        this.endTranslationActivity();\n      }\n    } catch (error) {\n      this.logger.error(\n        `Error getting batch translations for ${locale}:`,\n        error,\n      );\n      res.writeHead(500, { \"Content-Type\": \"application/json\" });\n      res.end(\n        JSON.stringify({\n          error: \"Translation generation failed\",\n          message: error instanceof Error ? error.message : \"Unknown error\",\n        }),\n      );\n    }\n  }\n\n  /**\n   * Handle request for full translation dictionary\n   */\n  private async handleDictionaryRequest(\n    locale: string,\n    res: http.ServerResponse,\n  ): Promise<void> {\n    try {\n      const parsedLocale = parseLocaleOrThrow(locale);\n\n      // Reload metadata to ensure we have the latest entries\n      // (new entries may have been added since server started)\n      await this.reloadMetadata();\n\n      if (!this.metadata) {\n        throw new Error(\"Failed to load metadata\");\n      }\n\n      this.logger.info(`🌐 Requesting full dictionary for ${locale}`);\n\n      const allHashes = Object.keys(this.metadata);\n\n      // Translate all hashes\n      const result = await this.translationService.translate(\n        parsedLocale,\n        this.metadata,\n        allHashes,\n      );\n\n      // Return successful response\n      res.writeHead(200, {\n        \"Content-Type\": \"application/json\",\n        \"Cache-Control\": \"public, max-age=3600\",\n      });\n      res.end(\n        JSON.stringify({\n          locale,\n          translations: result.translations,\n          errors: result.errors,\n        }),\n      );\n    } catch (error) {\n      this.logger.error(`Error getting dictionary for ${locale}:`, error);\n      res.writeHead(500, { \"Content-Type\": \"application/json\" });\n      res.end(\n        JSON.stringify({\n          error: \"Translation generation failed\",\n          message: error instanceof Error ? error.message : \"Unknown error\",\n        }),\n      );\n    }\n  }\n}\n\ntype SerializablePrimitive = string | number | boolean | null | undefined;\n\ntype SerializableObject = {\n  [key: string]: SerializableValue;\n};\nexport type SerializableValue =\n  | SerializablePrimitive\n  | SerializableValue[]\n  | SerializableObject;\n\nexport function stableStringify(\n  value: Record<string, SerializableValue>,\n): string {\n  const normalize = (v: any): any => {\n    if (v === undefined) return undefined;\n    if (typeof v === \"function\") return undefined;\n    if (v === null) return null;\n\n    if (Array.isArray(v)) {\n      return v.map(normalize).filter((x) => x !== undefined);\n    }\n\n    if (typeof v === \"object\") {\n      const out: Record<string, any> = {};\n      for (const key of Object.keys(v).sort()) {\n        const next = normalize(v[key]);\n        if (next !== undefined) out[key] = next;\n      }\n      return out;\n    }\n\n    return v;\n  };\n\n  return JSON.stringify(normalize(value));\n}\n\n/**\n * Generate a stable hash of a config object\n * Filters out functions and non-serializable values\n * Sorts keys for stability\n */\nexport function hashConfig(config: Record<string, SerializableValue>): string {\n  const serialized = stableStringify(config);\n  return crypto.createHash(\"md5\").update(serialized).digest(\"hex\").slice(0, 12);\n}\n\nexport async function startTranslationServer(\n  options: TranslationServerOptions,\n): Promise<TranslationServer> {\n  const server = new TranslationServer(options);\n  await server.start();\n  return server;\n}\n\n/**\n * Create a translation server and start it or reuse an existing one on the preferred port\n *\n * Since we have little control over the dev server start in next, we can start the translation server only in the async config or in the loader,\n * they both could be run in different processes, and we need a way to avoid starting multiple servers.\n * This one will try to start a server on the preferred port (which seems to be an atomic operation), and if it fails,\n * it checks if the server that is already started is ours and returns its url.\n *\n * @returns Object containing the server instance and its URL\n */\nexport async function startOrGetTranslationServer(\n  options: TranslationServerOptions,\n): Promise<{ server: TranslationServer; url: string }> {\n  const server = new TranslationServer(options);\n  const url = await server.startOrGetUrl();\n  return { server, url };\n}\n"],"mappings":"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"}
+{"version":3,"file":"translation-server.mjs","names":["out: Record<string, any>"],"sources":["../../src/translation-server/translation-server.ts"],"sourcesContent":["/**\n * Simple HTTP server for serving translations during development\n *\n * This server:\n * - Finds a free port automatically\n * - Serves translations via:\n *   - GET /translations/:locale - Full dictionary (cached)\n *   - POST /translations/:locale (body: { hashes: string[] }) - Batch translation\n * - Uses the same translation logic as middleware\n * - Can be started/stopped programmatically\n */\n\nimport http from \"http\";\nimport crypto from \"crypto\";\nimport type { Socket } from \"net\";\nimport { URL } from \"url\";\nimport { WebSocket, WebSocketServer } from \"ws\";\nimport type { MetadataSchema, TranslationMiddlewareConfig } from \"../types\";\nimport { getLogger } from \"./logger\";\nimport { TranslationService } from \"../translators\";\nimport { getMetadataPath, loadMetadata } from \"../metadata/manager\";\nimport type { TranslationServerEvent } from \"./ws-events\";\nimport { createEvent } from \"./ws-events\";\nimport type { LocaleCode } from \"lingo.dev/spec\";\nimport { parseLocaleOrThrow } from \"../utils/is-valid-locale\";\n\nexport interface TranslationServerOptions {\n  config: TranslationMiddlewareConfig;\n  translationService?: TranslationService;\n  onReady?: (port: number) => void;\n  onError?: (error: Error) => void;\n}\n\nexport class TranslationServer {\n  private server: http.Server | null = null;\n  private url: string | undefined = undefined;\n  private logger;\n  private readonly config: TranslationMiddlewareConfig;\n  private readonly configHash: string;\n  private readonly startPort: number;\n  private readonly onReadyCallback?: (port: number) => void;\n  private readonly onErrorCallback?: (error: Error) => void;\n  private metadata: MetadataSchema | null = null;\n  private connections: Set<Socket> = new Set();\n  private wss: WebSocketServer | null = null;\n  private wsClients: Set<WebSocket> = new Set();\n\n  // Translation activity tracking for \"busy\" notifications\n  private activeTranslations = 0;\n  private isBusy = false;\n  private busyTimeout: NodeJS.Timeout | null = null;\n  private readonly BUSY_DEBOUNCE_MS = 500; // Time after last translation to send \"idle\" event\n  private readonly translationService: TranslationService;\n\n  constructor(options: TranslationServerOptions) {\n    this.config = options.config;\n    this.configHash = hashConfig(options.config);\n    this.translationService =\n      options.translationService ??\n      // Fallback is for CLI start only.\n      new TranslationService(options.config, getLogger(options.config));\n    this.startPort = options.config.dev.translationServerStartPort;\n    this.onReadyCallback = options.onReady;\n    this.onErrorCallback = options.onError;\n    this.logger = getLogger(this.config);\n  }\n\n  /**\n   * Start the server and find an available port\n   */\n  async start(): Promise<number> {\n    if (this.server) {\n      throw new Error(\"Server is already running\");\n    }\n\n    this.logger.info(`🔧 Initializing translator...`);\n\n    const port = await this.findAvailablePort(this.startPort);\n\n    return new Promise((resolve, reject) => {\n      this.server = http.createServer((req, res) => {\n        // Log that we received a request (before async handling)\n        this.logger.info(`📥 Received: ${req.method} ${req.url}`);\n\n        // Wrap async handler and catch errors explicitly\n        this.handleRequest(req, res).catch((error) => {\n          this.logger.error(`Request handler error:`, error);\n          this.logger.error(error.stack);\n\n          // Send error response if headers not sent\n          if (!res.headersSent) {\n            res.writeHead(500, { \"Content-Type\": \"application/json\" });\n            res.end(JSON.stringify({ error: \"Internal Server Error\" }));\n          }\n        });\n      });\n\n      this.logger.debug(`Starting translation server on port ${port}`);\n\n      // Track connections for graceful shutdown\n      this.server.on(\"connection\", (socket) => {\n        this.connections.add(socket);\n        socket.once(\"close\", () => {\n          this.connections.delete(socket);\n        });\n      });\n\n      this.server.on(\"error\", (error: NodeJS.ErrnoException) => {\n        if (error.code === \"EADDRINUSE\") {\n          // Port is in use, try next one\n          reject(new Error(`Port ${port} is already in use`));\n        } else {\n          this.logger.error(`Translation server error: ${error.message}\\n`);\n          this.onErrorCallback?.(error);\n          reject(error);\n        }\n      });\n\n      this.server.listen(port, \"127.0.0.1\", () => {\n        this.url = `http://127.0.0.1:${port}`;\n        this.logger.info(`Translation server listening on ${this.url}`);\n\n        // Initialize WebSocket server on the same port\n        this.initializeWebSocket();\n\n        this.onReadyCallback?.(port);\n        resolve(port);\n      });\n    });\n  }\n\n  /**\n   * Initialize WebSocket server for real-time dev widget updates\n   */\n  private initializeWebSocket(): void {\n    if (!this.server) {\n      throw new Error(\"HTTP server must be started before WebSocket\");\n    }\n\n    this.wss = new WebSocketServer({ server: this.server });\n\n    this.wss.on(\"connection\", (ws: WebSocket) => {\n      this.wsClients.add(ws);\n      this.logger.debug(\n        `WebSocket client connected. Total clients: ${this.wsClients.size}`,\n      );\n\n      // Send initial connected event\n      this.sendToClient(ws, createEvent(\"connected\", { serverUrl: this.url! }));\n\n      ws.on(\"close\", () => {\n        this.wsClients.delete(ws);\n        this.logger.debug(\n          `WebSocket client disconnected. Total clients: ${this.wsClients.size}`,\n        );\n      });\n\n      ws.on(\"error\", (error) => {\n        this.logger.error(`WebSocket client error:`, error);\n        this.wsClients.delete(ws);\n      });\n    });\n\n    this.wss.on(\"error\", (error) => {\n      this.logger.error(`WebSocket server error:`, error);\n      this.onErrorCallback?.(error);\n    });\n\n    this.logger.info(`WebSocket server initialized`);\n  }\n\n  /**\n   * Send event to a specific WebSocket client\n   */\n  private sendToClient(ws: WebSocket, event: TranslationServerEvent): void {\n    if (ws.readyState === WebSocket.OPEN) {\n      ws.send(JSON.stringify(event));\n    }\n  }\n\n  /**\n   * Broadcast event to all connected WebSocket clients\n   */\n  private broadcast(event: TranslationServerEvent): void {\n    const message = JSON.stringify(event);\n    for (const client of this.wsClients) {\n      if (client.readyState === WebSocket.OPEN) {\n        client.send(message);\n      }\n    }\n  }\n\n  /**\n   * Stop the server\n   */\n  async stop(): Promise<void> {\n    if (!this.server) {\n      this.logger.debug(\"Translation server is not running. Nothing to stop.\");\n      return;\n    }\n\n    // Clear any pending busy timeout\n    if (this.busyTimeout) {\n      clearTimeout(this.busyTimeout);\n      this.busyTimeout = null;\n    }\n\n    // Close all WebSocket connections\n    for (const client of this.wsClients) {\n      client.close();\n    }\n    this.wsClients.clear();\n\n    // Close WebSocket server\n    if (this.wss) {\n      this.wss.close();\n      this.wss = null;\n    }\n\n    // Destroy all active HTTP connections to prevent hanging\n    for (const socket of this.connections) {\n      socket.destroy();\n    }\n    this.connections.clear();\n\n    return new Promise((resolve, reject) => {\n      this.server!.close((error) => {\n        if (error) {\n          reject(error);\n        } else {\n          this.logger.info(`Translation server stopped`);\n          this.server = null;\n          this.url = undefined;\n          resolve();\n        }\n      });\n    });\n  }\n\n  /**\n   * Get the current port (null if not running)\n   */\n  getUrl(): string | undefined {\n    return this.url;\n  }\n\n  /**\n   * Start a new server or get the URL of an existing one on the preferred port.\n   *\n   * This method optimizes for the common case where a translation server is already\n   * running on a preferred port. If that port is taken, it checks if it's our service\n   * by calling the health check endpoint. If it is, we reuse it instead of starting\n   * a new server on a different port.\n   *\n   * @returns URL of the running server (new or existing)\n   */\n  async startOrGetUrl(): Promise<string> {\n    if (this.server && this.url) {\n      this.logger.info(`Using existing server instance at ${this.url}`);\n      return this.url;\n    }\n\n    const preferredPort = this.startPort;\n    const preferredUrl = `http://127.0.0.1:${preferredPort}`;\n\n    // Check if port is available\n    const portAvailable = await this.isPortAvailable(preferredPort);\n\n    if (portAvailable) {\n      // Port is free, start a new server\n      this.logger.info(\n        `Port ${preferredPort} is available, starting new server...`,\n      );\n      await this.start();\n      return this.url!;\n    }\n\n    // Port is taken, check if it's our translation server\n    this.logger.info(\n      `Port ${preferredPort} is in use, checking if it's a translation server...`,\n    );\n    const isOurServer = await this.checkIfTranslationServer(preferredUrl);\n\n    if (isOurServer) {\n      // It's our server, reuse it\n      this.logger.info(\n        `✅ Found existing translation server at ${preferredUrl}, reusing it`,\n      );\n      this.url = preferredUrl;\n      return preferredUrl;\n    }\n\n    // Port is taken by something else, start a new server on a different port\n    this.logger.info(\n      `Port ${preferredPort} is in use by another service, finding alternative...`,\n    );\n    await this.start();\n    return this.url!;\n  }\n\n  /**\n   * Check if server is running\n   */\n  isRunning(): boolean {\n    return this.server !== null && this.url !== null;\n  }\n\n  /**\n   * Reload metadata from disk\n   * Useful when metadata has been updated during runtime (e.g., new transformations)\n   */\n  async reloadMetadata(): Promise<void> {\n    try {\n      this.metadata = await loadMetadata(getMetadataPath(this.config));\n      this.logger.debug(\n        `Reloaded metadata: ${Object.keys(this.metadata).length} entries`,\n      );\n    } catch (error) {\n      this.logger.warn(\"Failed to reload metadata:\", error);\n      this.metadata = {};\n    }\n  }\n\n  /**\n   * Translate the entire dictionary for a given locale\n   *\n   * This method always reloads metadata from disk before translating to ensure\n   * all entries added during build-time transformations are included.\n   *\n   * This is the recommended method for build-time translation generation.\n   */\n  async translateAll(locale: LocaleCode): Promise<{\n    translations: Record<string, string>;\n    errors: Array<{ hash: string; sourceText: string; error: string }>;\n  }> {\n    if (!this.translationService) {\n      throw new Error(\"Translation server not initialized\");\n    }\n\n    // Always reload metadata to get the latest entries\n    // This is critical for build-time translation where metadata is updated\n    // continuously as files are transformed\n    await this.reloadMetadata();\n\n    if (!this.metadata) {\n      throw new Error(\"Failed to load metadata\");\n    }\n\n    const allHashes = Object.keys(this.metadata);\n\n    this.logger.info(\n      `Translating all ${allHashes.length} entries to ${locale}`,\n    );\n\n    // Broadcast batch start event\n    const startTime = Date.now();\n    this.broadcast(\n      createEvent(\"batch:start\", {\n        locale,\n        total: allHashes.length,\n        hashes: allHashes,\n      }),\n    );\n\n    const result = await this.translationService.translate(\n      locale,\n      this.metadata,\n      allHashes,\n    );\n\n    // Log detailed error information to server log file\n    if (result.errors.length > 0) {\n      this.logger.error(\n        `${result.errors.length} translation error(s) for ${locale}:`,\n      );\n      for (const err of result.errors) {\n        const prefix = `  [${locale}]`;\n        if (err.hash === \"all\") {\n          this.logger.error(`${prefix} ${err.error}`);\n          continue;\n        }\n        const source =\n          err.sourceText.length > 200\n            ? err.sourceText.slice(0, 200) + \"...\"\n            : err.sourceText;\n        this.logger.error(\n          `${prefix} hash=${err.hash} source=\"${source}\" error=\"${err.error}\"`,\n        );\n      }\n    }\n\n    // Broadcast batch complete event\n    const duration = Date.now() - startTime;\n    this.broadcast(\n      createEvent(\"batch:complete\", {\n        locale,\n        total: allHashes.length,\n        successful: Object.keys(result.translations).length,\n        failed: result.errors.length,\n        duration,\n      }),\n    );\n\n    return result;\n  }\n\n  /**\n   * Find an available port starting from the given port\n   */\n  private async findAvailablePort(\n    startPort: number,\n    maxAttempts = 100,\n  ): Promise<number> {\n    for (let port = startPort; port < startPort + maxAttempts; port++) {\n      if (await this.isPortAvailable(port)) {\n        return port;\n      }\n    }\n    throw new Error(\n      `Could not find available port in range ${startPort}-${startPort + maxAttempts}`,\n    );\n  }\n\n  /**\n   * Check if a port is available\n   */\n  private async isPortAvailable(port: number): Promise<boolean> {\n    return new Promise((resolve) => {\n      const testServer = http.createServer();\n\n      testServer.once(\"error\", (error: NodeJS.ErrnoException) => {\n        if (error.code === \"EADDRINUSE\") {\n          resolve(false);\n        } else {\n          resolve(false);\n        }\n      });\n\n      testServer.once(\"listening\", () => {\n        testServer.close(() => {\n          resolve(true);\n        });\n      });\n\n      testServer.listen(port, \"127.0.0.1\");\n    });\n  }\n\n  /**\n   * Mark translation activity start - emits busy event if not already busy\n   */\n  private startTranslationActivity(): void {\n    this.activeTranslations++;\n\n    // Clear any pending idle timeout\n    if (this.busyTimeout) {\n      clearTimeout(this.busyTimeout);\n      this.busyTimeout = null;\n    }\n\n    // Emit busy event if this is the first active translation\n    if (!this.isBusy && this.activeTranslations > 0) {\n      this.isBusy = true;\n      this.broadcast(\n        createEvent(\"server:busy\", {\n          activeTranslations: this.activeTranslations,\n        }),\n      );\n      this.logger.debug(\n        `[BUSY] Server is now busy (${this.activeTranslations} active)`,\n      );\n    }\n  }\n\n  /**\n   * Mark translation activity end - emits idle event after debounce period\n   */\n  private endTranslationActivity(): void {\n    this.activeTranslations = Math.max(0, this.activeTranslations - 1);\n\n    // If no more active translations, schedule idle notification\n    if (this.activeTranslations === 0 && this.isBusy) {\n      // Clear any existing timeout\n      if (this.busyTimeout) {\n        clearTimeout(this.busyTimeout);\n      }\n\n      // Wait for debounce period before sending idle event\n      // This prevents rapid busy->idle->busy cycles when translations come in quick succession\n      this.busyTimeout = setTimeout(() => {\n        if (this.activeTranslations === 0) {\n          this.isBusy = false;\n          this.broadcast(createEvent(\"server:idle\", {}));\n          this.logger.debug(\"[IDLE] Server is now idle\");\n        }\n      }, this.BUSY_DEBOUNCE_MS);\n    }\n  }\n\n  /**\n   * Check if a given URL is running our translation server by calling the health endpoint\n   * Also verifies that the config hash matches to ensure compatible configuration\n   */\n  private async checkIfTranslationServer(url: string): Promise<boolean> {\n    return new Promise((resolve) => {\n      const healthUrl = `${url}/health`;\n\n      const req = http.get(healthUrl, { timeout: 2000 }, (res) => {\n        let data = \"\";\n\n        res.on(\"data\", (chunk) => {\n          data += chunk.toString();\n        });\n\n        res.on(\"end\", () => {\n          try {\n            if (res.statusCode === 200) {\n              const json = JSON.parse(data);\n              // Our translation server returns { status: \"ok\", port: ..., configHash: ... }\n              // Check if config hash matches (if present)\n              // If configHash is missing (old server), accept it for backward compatibility\n              if (json.configHash && json.configHash !== this.configHash) {\n                this.logger.warn(\n                  `Existing server has different config (hash: ${json.configHash} vs ${this.configHash}), will start new server`,\n                );\n                resolve(false);\n                return;\n              }\n              resolve(true);\n              return;\n            }\n            resolve(false);\n          } catch (error) {\n            // Failed to parse JSON or invalid response\n            resolve(false);\n          }\n        });\n      });\n\n      req.on(\"error\", () => {\n        // Connection failed, not our server\n        resolve(false);\n      });\n\n      req.on(\"timeout\", () => {\n        req.destroy();\n        resolve(false);\n      });\n    });\n  }\n\n  /**\n   * Handle incoming HTTP request\n   */\n  private async handleRequest(\n    req: http.IncomingMessage,\n    res: http.ServerResponse,\n  ): Promise<void> {\n    this.logger.info(`🔄 Processing: ${req.method} ${req.url}`);\n\n    try {\n      const url = new URL(req.url || \"\", `http://${req.headers.host}`);\n\n      // Log request\n      this.logger.debug(`${req.method} ${url.pathname}`);\n\n      // Handle CORS for browser requests\n      res.setHeader(\"Access-Control-Allow-Origin\", \"*\");\n      res.setHeader(\"Access-Control-Allow-Methods\", \"GET, POST, OPTIONS\");\n      res.setHeader(\"Access-Control-Allow-Headers\", \"Content-Type\");\n      res.setHeader(\n        \"Access-Control-Expose-Headers\",\n        \"Content-Type, Cache-Control\",\n      );\n\n      if (req.method === \"OPTIONS\") {\n        res.writeHead(204);\n        res.end();\n        return;\n      }\n\n      if (url.pathname === \"/health\") {\n        res.writeHead(200, { \"Content-Type\": \"application/json\" });\n        res.end(\n          JSON.stringify({\n            port: this.url,\n            configHash: this.configHash,\n          }),\n        );\n        return;\n      }\n\n      // Batch translation endpoint: POST /translations/:locale\n      const postMatch = url.pathname.match(/^\\/translations\\/([^/]+)$/);\n      if (postMatch && req.method === \"POST\") {\n        const [, locale] = postMatch;\n\n        await this.handleBatchTranslationRequest(locale, req, res);\n        return;\n      }\n\n      // Translation dictionary endpoint: GET /translations/:locale\n      const dictMatch = url.pathname.match(/^\\/translations\\/([^/]+)$/);\n      if (dictMatch && req.method === \"GET\") {\n        const [, locale] = dictMatch;\n        await this.handleDictionaryRequest(locale, res);\n        return;\n      }\n\n      // 404 for unknown routes\n      res.writeHead(404, { \"Content-Type\": \"application/json\" });\n      res.end(\n        JSON.stringify({\n          error: \"Not Found\",\n          message: \"Unknown endpoint\",\n          availableEndpoints: [\n            \"GET /health\",\n            \"GET /translations/:locale\",\n            \"POST /translations/:locale (with body: { hashes: string[] })\",\n          ],\n        }),\n      );\n    } catch (error) {\n      this.logger.error(\"Error handling request:\", error);\n      res.writeHead(500, { \"Content-Type\": \"application/json\" });\n      res.end(\n        JSON.stringify({\n          error: \"Internal Server Error\",\n          message: error instanceof Error ? error.message : \"Unknown error\",\n        }),\n      );\n    }\n  }\n\n  /**\n   * Handle batch translation request\n   */\n  private async handleBatchTranslationRequest(\n    locale: string,\n    req: http.IncomingMessage,\n    res: http.ServerResponse,\n  ): Promise<void> {\n    try {\n      const parsedLocale = parseLocaleOrThrow(locale);\n\n      // Read request body\n      let body = \"\";\n      this.logger.debug(\"Reading request body...\");\n      for await (const chunk of req) {\n        body += chunk.toString();\n        this.logger.debug(`Chunk read, body: ${body}`);\n      }\n\n      // Parse body\n      const { hashes } = JSON.parse(body);\n\n      this.logger.debug(`Parsed hashes: ${hashes.join(\",\")}`);\n\n      if (!Array.isArray(hashes)) {\n        res.writeHead(400, { \"Content-Type\": \"application/json\" });\n        res.end(\n          JSON.stringify({\n            error: \"Bad Request\",\n            message: \"Body must contain 'hashes' array\",\n          }),\n        );\n        return;\n      }\n      // Reload metadata to ensure we have the latest entries\n      // (new entries may have been added since server started)\n      await this.reloadMetadata();\n\n      if (!this.metadata) {\n        throw new Error(\"Failed to load metadata\");\n      }\n\n      this.logger.info(`🔄 Translating ${hashes.length} hashes to ${locale}`);\n      this.logger.debug(`🔄 Hashes: ${hashes.join(\", \")}`);\n\n      // Mark translation activity start\n      this.startTranslationActivity();\n\n      try {\n        const result = await this.translationService.translate(\n          parsedLocale,\n          this.metadata,\n          hashes,\n        );\n\n        // Return successful response\n        res.writeHead(200, {\n          \"Content-Type\": \"application/json\",\n          \"Cache-Control\": \"no-cache\",\n        });\n        res.end(\n          JSON.stringify({\n            locale,\n            translations: result.translations,\n            errors: result.errors,\n          }),\n        );\n      } finally {\n        // Mark translation activity end\n        this.endTranslationActivity();\n      }\n    } catch (error) {\n      this.logger.error(\n        `Error getting batch translations for ${locale}:`,\n        error,\n      );\n      res.writeHead(500, { \"Content-Type\": \"application/json\" });\n      res.end(\n        JSON.stringify({\n          error: \"Translation generation failed\",\n          message: error instanceof Error ? error.message : \"Unknown error\",\n        }),\n      );\n    }\n  }\n\n  /**\n   * Handle request for full translation dictionary\n   */\n  private async handleDictionaryRequest(\n    locale: string,\n    res: http.ServerResponse,\n  ): Promise<void> {\n    try {\n      const parsedLocale = parseLocaleOrThrow(locale);\n\n      // Reload metadata to ensure we have the latest entries\n      // (new entries may have been added since server started)\n      await this.reloadMetadata();\n\n      if (!this.metadata) {\n        throw new Error(\"Failed to load metadata\");\n      }\n\n      this.logger.info(`🌐 Requesting full dictionary for ${locale}`);\n\n      const allHashes = Object.keys(this.metadata);\n\n      // Translate all hashes\n      const result = await this.translationService.translate(\n        parsedLocale,\n        this.metadata,\n        allHashes,\n      );\n\n      // Return successful response\n      res.writeHead(200, {\n        \"Content-Type\": \"application/json\",\n        \"Cache-Control\": \"public, max-age=3600\",\n      });\n      res.end(\n        JSON.stringify({\n          locale,\n          translations: result.translations,\n          errors: result.errors,\n        }),\n      );\n    } catch (error) {\n      this.logger.error(`Error getting dictionary for ${locale}:`, error);\n      res.writeHead(500, { \"Content-Type\": \"application/json\" });\n      res.end(\n        JSON.stringify({\n          error: \"Translation generation failed\",\n          message: error instanceof Error ? error.message : \"Unknown error\",\n        }),\n      );\n    }\n  }\n}\n\ntype SerializablePrimitive = string | number | boolean | null | undefined;\n\ntype SerializableObject = {\n  [key: string]: SerializableValue;\n};\nexport type SerializableValue =\n  | SerializablePrimitive\n  | SerializableValue[]\n  | SerializableObject;\n\nexport function stableStringify(\n  value: Record<string, SerializableValue>,\n): string {\n  const normalize = (v: any): any => {\n    if (v === undefined) return undefined;\n    if (typeof v === \"function\") return undefined;\n    if (v === null) return null;\n\n    if (Array.isArray(v)) {\n      return v.map(normalize).filter((x) => x !== undefined);\n    }\n\n    if (typeof v === \"object\") {\n      const out: Record<string, any> = {};\n      for (const key of Object.keys(v).sort()) {\n        const next = normalize(v[key]);\n        if (next !== undefined) out[key] = next;\n      }\n      return out;\n    }\n\n    return v;\n  };\n\n  return JSON.stringify(normalize(value));\n}\n\n/**\n * Generate a stable hash of a config object\n * Filters out functions and non-serializable values\n * Sorts keys for stability\n */\nexport function hashConfig(config: Record<string, SerializableValue>): string {\n  const serialized = stableStringify(config);\n  return crypto.createHash(\"md5\").update(serialized).digest(\"hex\").slice(0, 12);\n}\n\nexport async function startTranslationServer(\n  options: TranslationServerOptions,\n): Promise<TranslationServer> {\n  const server = new TranslationServer(options);\n  await server.start();\n  return server;\n}\n\n/**\n * Create a translation server and start it or reuse an existing one on the preferred port\n *\n * Since we have little control over the dev server start in next, we can start the translation server only in the async config or in the loader,\n * they both could be run in different processes, and we need a way to avoid starting multiple servers.\n * This one will try to start a server on the preferred port (which seems to be an atomic operation), and if it fails,\n * it checks if the server that is already started is ours and returns its url.\n *\n * @returns Object containing the server instance and its URL\n */\nexport async function startOrGetTranslationServer(\n  options: TranslationServerOptions,\n): Promise<{ server: TranslationServer; url: string }> {\n  const server = new TranslationServer(options);\n  const url = await server.startOrGetUrl();\n  return { server, url };\n}\n"],"mappings":"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"}

package/build/translators/translation-service.cjs

@@ -100,13 +100,15 @@ Set the required API keys for real translations.`);
 					...translatedTexts
 				};
 			} catch (error) {
-				this.logger.error(`Translation failed:`, error);
+				const errorMessage = error instanceof Error ? error.message : String(error);
+				this.logger.error(`Translation failed for locale "${locale}": ${errorMessage}`);
+				if (error instanceof Error && error.stack) this.logger.debug(`Stack trace: ${error.stack}`);
 				return {
 					translations: this.pickTranslations(cachedTranslations, workingHashes),
 					errors: [{
 						hash: "all",
 						sourceText: "all",
-						error: error instanceof Error ? error.message : "Unknown translation error"
+						error: errorMessage
 					}],
 					stats: {
 						total: workingHashes.length,

package/build/translators/translation-service.mjs

@@ -100,13 +100,15 @@ Set the required API keys for real translations.`);
 					...translatedTexts
 				};
 			} catch (error) {
-				this.logger.error(`Translation failed:`, error);
+				const errorMessage = error instanceof Error ? error.message : String(error);
+				this.logger.error(`Translation failed for locale "${locale}": ${errorMessage}`);
+				if (error instanceof Error && error.stack) this.logger.debug(`Stack trace: ${error.stack}`);
 				return {
 					translations: this.pickTranslations(cachedTranslations, workingHashes),
 					errors: [{
 						hash: "all",
 						sourceText: "all",
-						error: error instanceof Error ? error.message : "Unknown translation error"
+						error: errorMessage
 					}],
 					stats: {
 						total: workingHashes.length,

package/build/translators/translation-service.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"translation-service.mjs","names":["config: TranslationServiceConfig","logger: Logger","filteredMetadata: MetadataSchema","overriddenTranslations: Record<string, string>","hashesNeedingTranslation: string[]","newTranslations: Record<string, string>","errors: TranslationError[]","entries: Record<string, TranslatableEntry>","result: Record<string, string>"],"sources":["../../src/translators/translation-service.ts"],"sourcesContent":["/**\n * TranslationService - Main orchestrator for translation workflow\n *\n * Responsibilities:\n * - Coordinates between metadata, cache, and translator\n * - Determines what needs translation\n * - Handles caching strategy\n * - Manages partial failures\n */\n\nimport type { TranslationCache } from \"./cache\";\nimport type { TranslatableEntry, Translator } from \"./api\";\nimport type { LingoEnvironment, MetadataSchema } from \"../types\";\nimport {\n  type PluralizationConfig,\n  PluralizationService,\n} from \"./pluralization\";\nimport type { Logger } from \"../utils/logger\";\nimport type { LocaleCode } from \"lingo.dev/spec\";\nimport { PseudoTranslator } from \"./pseudotranslator\";\nimport { LingoTranslator } from \"./lingo\";\nimport { type CacheConfig, createCache } from \"./cache-factory\";\nimport { MemoryTranslationCache } from \"./memory-cache\";\n\nexport type TranslationServiceConfig = {\n  /**\n   * Source locale (e.g., \"en\")\n   */\n  sourceLocale: LocaleCode;\n\n  /**\n   * Pluralization configuration\n   * If provided, enables automatic pluralization of source messages\n   */\n  pluralization: Omit<PluralizationConfig, \"sourceLocale\">;\n  models: \"lingo.dev\" | Record<string, string>;\n  prompt?: string;\n  environment: LingoEnvironment;\n  dev?: {\n    usePseudotranslator?: boolean;\n  };\n} & CacheConfig;\n\nexport interface TranslationResult {\n  /**\n   * Successfully translated entries (hash -> translated text)\n   */\n  translations: Record<string, string>;\n\n  errors: TranslationError[];\n\n  stats: {\n    total: number;\n    cached: number;\n    translated: number;\n    failed: number;\n  };\n}\n\nexport interface TranslationError {\n  hash: string;\n  sourceText: string;\n  error: string;\n}\n\nexport class TranslationService {\n  private pluralizationService?: PluralizationService;\n  private translator: Translator<any>;\n  private cache: TranslationCache;\n\n  constructor(\n    private config: TranslationServiceConfig,\n    private logger: Logger,\n  ) {\n    const isDev = config.environment === \"development\";\n\n    // 1. Explicit dev override takes precedence\n    if (isDev && config.dev?.usePseudotranslator) {\n      this.logger.info(\n        \"📝 Using pseudotranslator (dev.usePseudotranslator enabled)\",\n      );\n      this.translator = new PseudoTranslator({ delayMedian: 100 }, logger);\n      this.cache = new MemoryTranslationCache();\n    } else {\n      // 2. Try to create real translator\n      // LingoTranslator constructor will validate and fetch API keys\n      // If validation fails, it will throw an error with helpful message\n      try {\n        const models = config.models;\n\n        this.logger.debug(\n          `Creating Lingo translator with models: ${JSON.stringify(models)}`,\n        );\n\n        this.cache = createCache(config);\n        this.translator = new LingoTranslator(\n          {\n            models,\n            sourceLocale: config.sourceLocale,\n            prompt: config.prompt,\n          },\n          this.logger,\n        );\n\n        if (this.config.pluralization?.enabled) {\n          this.pluralizationService = new PluralizationService(\n            {\n              ...this.config.pluralization,\n              sourceLocale: this.config.sourceLocale,\n            },\n            this.logger,\n          );\n        }\n      } catch (error) {\n        // 3. Auto-fallback in dev mode if creation fails\n        if (isDev) {\n          // Use console.error to ensure visibility in all contexts (loader, server, etc.)\n          const errorMsg =\n            error instanceof Error ? error.message : String(error);\n          this.logger.warn(`⚠️ Translation setup error: \\n${errorMsg}\\n\n⚠️ Auto-fallback to pseudotranslator in development mode.\nSet the required API keys for real translations.`);\n\n          this.translator = new PseudoTranslator(\n            { delayMedian: 100 },\n            this.logger,\n          );\n          this.cache = new MemoryTranslationCache();\n        } else {\n          // 4. Fail in production\n          throw error;\n        }\n      }\n    }\n  }\n\n  /**\n   * Translate entries to target locale\n   *\n   * @param locale Target locale (including source locale)\n   * @param metadata Metadata schema with all entries\n   * @param requestedHashes Optional: only translate specific hashes\n   * @returns Translation result with translations and errors\n   */\n  async translate(\n    locale: LocaleCode,\n    metadata: MetadataSchema,\n    requestedHashes?: string[],\n  ): Promise<TranslationResult> {\n    const startTime = performance.now();\n\n    // Step 1: Determine which hashes we need to work with\n    const workingHashes = requestedHashes || Object.keys(metadata);\n\n    this.logger.debug(\n      `Translation requested for ${workingHashes.length} hashes in locale: ${locale}`,\n    );\n\n    // Step 2: Check cache first (same for all locales, including source)\n    const cachedTranslations = await this.cache.get(locale);\n\n    // Step 3: Determine what needs translation/pluralization\n    const uncachedHashes = workingHashes.filter(\n      (hash) => !cachedTranslations[hash],\n    );\n    this.logger.debug(\n      `${uncachedHashes.length} hashes need processing, ${workingHashes.length - uncachedHashes.length} are cached`,\n    );\n\n    const cachedCount = workingHashes.length - uncachedHashes.length;\n\n    if (uncachedHashes.length === 0) {\n      return {\n        translations: this.pickTranslations(cachedTranslations, workingHashes),\n        errors: [],\n        stats: {\n          total: workingHashes.length,\n          cached: cachedCount,\n          translated: 0,\n          failed: 0,\n        },\n      };\n    }\n\n    this.logger.debug(\n      `Generating translations for ${uncachedHashes.length} uncached hashes in ${locale}...`,\n    );\n\n    // Step 4: Filter metadata to only uncached entries\n    const filteredMetadata: MetadataSchema = Object.fromEntries(\n      uncachedHashes\n        .map((hash) => [hash, metadata[hash]])\n        .filter(([_, entry]) => entry !== undefined),\n    );\n\n    // Step 5: Process pluralization for filtered entries\n    if (this.pluralizationService) {\n      this.logger.debug(\n        `Processing pluralization for ${Object.keys(filteredMetadata).length} entries...`,\n      );\n      const pluralStats =\n        await this.pluralizationService.process(filteredMetadata);\n      this.logger.debug(\n        `Pluralization stats: ${pluralStats.pluralized} pluralized, ${pluralStats.rejected} rejected, ${pluralStats.failed} failed`,\n      );\n    }\n\n    // Step 6: Separate overridden entries from entries that need translation\n    const overriddenTranslations: Record<string, string> = {};\n    const hashesNeedingTranslation: string[] = [];\n\n    this.logger.debug(\n      `Checking for overrides in ${uncachedHashes.length} entries`,\n    );\n\n    for (const hash of uncachedHashes) {\n      const entry = filteredMetadata[hash];\n      if (!entry) continue;\n\n      // Check if this entry has an override for the current locale\n      if (entry.overrides && entry.overrides[locale]) {\n        overriddenTranslations[hash] = entry.overrides[locale];\n        this.logger.debug(\n          `Using override for ${hash} in locale ${locale}: \"${entry.overrides[locale]}\"`,\n        );\n      } else {\n        hashesNeedingTranslation.push(hash);\n      }\n    }\n\n    // Step 7: Prepare entries for translation (excluding overridden ones)\n    const entriesToTranslate = this.prepareEntries(\n      filteredMetadata,\n      hashesNeedingTranslation,\n    );\n\n    // Step 8: Translate or return source text\n    let newTranslations: Record<string, string> = { ...overriddenTranslations };\n    const errors: TranslationError[] = [];\n\n    if (locale === this.config.sourceLocale) {\n      // For source locale, just return the (possibly pluralized) sourceText\n      this.logger.debug(\n        `Source locale detected, returning sourceText for ${hashesNeedingTranslation.length} entries`,\n      );\n      for (const [hash, entry] of Object.entries(entriesToTranslate)) {\n        newTranslations[hash] = entry.text;\n      }\n    } else if (Object.keys(entriesToTranslate).length > 0) {\n      // For other locales, translate only entries without overrides\n      try {\n        this.logger.debug(\n          `Translating ${locale} with ${Object.keys(entriesToTranslate).length} entries`,\n        );\n        const translatedTexts = await this.translator.translate(\n          locale,\n          entriesToTranslate,\n        );\n        // Merge translated texts with overridden translations\n        newTranslations = { ...overriddenTranslations, ...translatedTexts };\n      } catch (error) {\n        this.logger.error(`Translation failed:`, error);\n\n        return {\n          translations: this.pickTranslations(\n            cachedTranslations,\n            workingHashes,\n          ),\n          errors: [\n            {\n              hash: \"all\",\n              sourceText: \"all\",\n              error:\n                error instanceof Error\n                  ? error.message\n                  : \"Unknown translation error\",\n            },\n          ],\n          stats: {\n            total: workingHashes.length,\n            cached: cachedCount,\n            translated: 0,\n            failed: uncachedHashes.length,\n          },\n        };\n      }\n\n      // Check for partial failures (some hashes didn't get translated)\n      for (const hash of uncachedHashes) {\n        if (!newTranslations[hash]) {\n          const entry = filteredMetadata[hash];\n          errors.push({\n            hash,\n            sourceText: entry?.sourceText || \"\",\n            error: \"Translator doesn't return translation\",\n          });\n        }\n      }\n    }\n\n    // Step 5: Update cache with successful translations (skip for pseudo)\n    if (Object.keys(newTranslations).length > 0) {\n      try {\n        await this.cache.update(locale, newTranslations);\n      } catch (error) {\n        this.logger.error(`Failed to update cache:`, error);\n        // Don't fail the request if cache update fails\n      }\n    }\n\n    // Step 6: Merge and return\n    const allTranslations = { ...cachedTranslations, ...newTranslations };\n    const result = this.pickTranslations(allTranslations, workingHashes);\n\n    const endTime = performance.now();\n    this.logger.debug(\n      `Translation completed for ${locale}: ${Object.keys(newTranslations).length} new, ${cachedCount} cached, ${errors.length} errors in ${(endTime - startTime).toFixed(2)}ms`,\n    );\n\n    return {\n      translations: result,\n      errors,\n      stats: {\n        total: workingHashes.length,\n        cached: cachedCount,\n        translated: Object.keys(newTranslations).length,\n        failed: errors.length,\n      },\n    };\n  }\n\n  /**\n   * Prepare metadata entries for translation\n   */\n  private prepareEntries(\n    metadata: MetadataSchema,\n    hashes: string[],\n  ): Record<string, TranslatableEntry> {\n    const entries: Record<string, TranslatableEntry> = {};\n\n    for (const hash of hashes) {\n      const entry = metadata[hash];\n      if (entry) {\n        entries[hash] = {\n          text: entry.sourceText,\n          context: entry.context || {},\n        };\n      }\n    }\n\n    return entries;\n  }\n\n  /**\n   * Pick only requested translations from the full set\n   */\n  // TODO (AleksandrSl 14/12/2025): SHould I use this in the build somehow?\n  private pickTranslations(\n    allTranslations: Record<string, string>,\n    requestedHashes: string[],\n  ): Record<string, string> {\n    const result: Record<string, string> = {};\n\n    for (const hash of requestedHashes) {\n      if (allTranslations[hash]) {\n        result[hash] = allTranslations[hash];\n      }\n    }\n\n    return result;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"translation-service.mjs","names":["config: TranslationServiceConfig","logger: Logger","filteredMetadata: MetadataSchema","overriddenTranslations: Record<string, string>","hashesNeedingTranslation: string[]","newTranslations: Record<string, string>","errors: TranslationError[]","entries: Record<string, TranslatableEntry>","result: Record<string, string>"],"sources":["../../src/translators/translation-service.ts"],"sourcesContent":["/**\n * TranslationService - Main orchestrator for translation workflow\n *\n * Responsibilities:\n * - Coordinates between metadata, cache, and translator\n * - Determines what needs translation\n * - Handles caching strategy\n * - Manages partial failures\n */\n\nimport type { TranslationCache } from \"./cache\";\nimport type { TranslatableEntry, Translator } from \"./api\";\nimport type { LingoEnvironment, MetadataSchema } from \"../types\";\nimport {\n  type PluralizationConfig,\n  PluralizationService,\n} from \"./pluralization\";\nimport type { Logger } from \"../utils/logger\";\nimport type { LocaleCode } from \"lingo.dev/spec\";\nimport { PseudoTranslator } from \"./pseudotranslator\";\nimport { LingoTranslator } from \"./lingo\";\nimport { type CacheConfig, createCache } from \"./cache-factory\";\nimport { MemoryTranslationCache } from \"./memory-cache\";\n\nexport type TranslationServiceConfig = {\n  /**\n   * Source locale (e.g., \"en\")\n   */\n  sourceLocale: LocaleCode;\n\n  /**\n   * Pluralization configuration\n   * If provided, enables automatic pluralization of source messages\n   */\n  pluralization: Omit<PluralizationConfig, \"sourceLocale\">;\n  models: \"lingo.dev\" | Record<string, string>;\n  prompt?: string;\n  environment: LingoEnvironment;\n  dev?: {\n    usePseudotranslator?: boolean;\n  };\n} & CacheConfig;\n\nexport interface TranslationResult {\n  /**\n   * Successfully translated entries (hash -> translated text)\n   */\n  translations: Record<string, string>;\n\n  errors: TranslationError[];\n\n  stats: {\n    total: number;\n    cached: number;\n    translated: number;\n    failed: number;\n  };\n}\n\nexport interface TranslationError {\n  hash: string;\n  sourceText: string;\n  error: string;\n}\n\nexport class TranslationService {\n  private pluralizationService?: PluralizationService;\n  private translator: Translator<any>;\n  private cache: TranslationCache;\n\n  constructor(\n    private config: TranslationServiceConfig,\n    private logger: Logger,\n  ) {\n    const isDev = config.environment === \"development\";\n\n    // 1. Explicit dev override takes precedence\n    if (isDev && config.dev?.usePseudotranslator) {\n      this.logger.info(\n        \"📝 Using pseudotranslator (dev.usePseudotranslator enabled)\",\n      );\n      this.translator = new PseudoTranslator({ delayMedian: 100 }, logger);\n      this.cache = new MemoryTranslationCache();\n    } else {\n      // 2. Try to create real translator\n      // LingoTranslator constructor will validate and fetch API keys\n      // If validation fails, it will throw an error with helpful message\n      try {\n        const models = config.models;\n\n        this.logger.debug(\n          `Creating Lingo translator with models: ${JSON.stringify(models)}`,\n        );\n\n        this.cache = createCache(config);\n        this.translator = new LingoTranslator(\n          {\n            models,\n            sourceLocale: config.sourceLocale,\n            prompt: config.prompt,\n          },\n          this.logger,\n        );\n\n        if (this.config.pluralization?.enabled) {\n          this.pluralizationService = new PluralizationService(\n            {\n              ...this.config.pluralization,\n              sourceLocale: this.config.sourceLocale,\n            },\n            this.logger,\n          );\n        }\n      } catch (error) {\n        // 3. Auto-fallback in dev mode if creation fails\n        if (isDev) {\n          // Use console.error to ensure visibility in all contexts (loader, server, etc.)\n          const errorMsg =\n            error instanceof Error ? error.message : String(error);\n          this.logger.warn(`⚠️ Translation setup error: \\n${errorMsg}\\n\n⚠️ Auto-fallback to pseudotranslator in development mode.\nSet the required API keys for real translations.`);\n\n          this.translator = new PseudoTranslator(\n            { delayMedian: 100 },\n            this.logger,\n          );\n          this.cache = new MemoryTranslationCache();\n        } else {\n          // 4. Fail in production\n          throw error;\n        }\n      }\n    }\n  }\n\n  /**\n   * Translate entries to target locale\n   *\n   * @param locale Target locale (including source locale)\n   * @param metadata Metadata schema with all entries\n   * @param requestedHashes Optional: only translate specific hashes\n   * @returns Translation result with translations and errors\n   */\n  async translate(\n    locale: LocaleCode,\n    metadata: MetadataSchema,\n    requestedHashes?: string[],\n  ): Promise<TranslationResult> {\n    const startTime = performance.now();\n\n    // Step 1: Determine which hashes we need to work with\n    const workingHashes = requestedHashes || Object.keys(metadata);\n\n    this.logger.debug(\n      `Translation requested for ${workingHashes.length} hashes in locale: ${locale}`,\n    );\n\n    // Step 2: Check cache first (same for all locales, including source)\n    const cachedTranslations = await this.cache.get(locale);\n\n    // Step 3: Determine what needs translation/pluralization\n    const uncachedHashes = workingHashes.filter(\n      (hash) => !cachedTranslations[hash],\n    );\n    this.logger.debug(\n      `${uncachedHashes.length} hashes need processing, ${workingHashes.length - uncachedHashes.length} are cached`,\n    );\n\n    const cachedCount = workingHashes.length - uncachedHashes.length;\n\n    if (uncachedHashes.length === 0) {\n      return {\n        translations: this.pickTranslations(cachedTranslations, workingHashes),\n        errors: [],\n        stats: {\n          total: workingHashes.length,\n          cached: cachedCount,\n          translated: 0,\n          failed: 0,\n        },\n      };\n    }\n\n    this.logger.debug(\n      `Generating translations for ${uncachedHashes.length} uncached hashes in ${locale}...`,\n    );\n\n    // Step 4: Filter metadata to only uncached entries\n    const filteredMetadata: MetadataSchema = Object.fromEntries(\n      uncachedHashes\n        .map((hash) => [hash, metadata[hash]])\n        .filter(([_, entry]) => entry !== undefined),\n    );\n\n    // Step 5: Process pluralization for filtered entries\n    if (this.pluralizationService) {\n      this.logger.debug(\n        `Processing pluralization for ${Object.keys(filteredMetadata).length} entries...`,\n      );\n      const pluralStats =\n        await this.pluralizationService.process(filteredMetadata);\n      this.logger.debug(\n        `Pluralization stats: ${pluralStats.pluralized} pluralized, ${pluralStats.rejected} rejected, ${pluralStats.failed} failed`,\n      );\n    }\n\n    // Step 6: Separate overridden entries from entries that need translation\n    const overriddenTranslations: Record<string, string> = {};\n    const hashesNeedingTranslation: string[] = [];\n\n    this.logger.debug(\n      `Checking for overrides in ${uncachedHashes.length} entries`,\n    );\n\n    for (const hash of uncachedHashes) {\n      const entry = filteredMetadata[hash];\n      if (!entry) continue;\n\n      // Check if this entry has an override for the current locale\n      if (entry.overrides && entry.overrides[locale]) {\n        overriddenTranslations[hash] = entry.overrides[locale];\n        this.logger.debug(\n          `Using override for ${hash} in locale ${locale}: \"${entry.overrides[locale]}\"`,\n        );\n      } else {\n        hashesNeedingTranslation.push(hash);\n      }\n    }\n\n    // Step 7: Prepare entries for translation (excluding overridden ones)\n    const entriesToTranslate = this.prepareEntries(\n      filteredMetadata,\n      hashesNeedingTranslation,\n    );\n\n    // Step 8: Translate or return source text\n    let newTranslations: Record<string, string> = { ...overriddenTranslations };\n    const errors: TranslationError[] = [];\n\n    if (locale === this.config.sourceLocale) {\n      // For source locale, just return the (possibly pluralized) sourceText\n      this.logger.debug(\n        `Source locale detected, returning sourceText for ${hashesNeedingTranslation.length} entries`,\n      );\n      for (const [hash, entry] of Object.entries(entriesToTranslate)) {\n        newTranslations[hash] = entry.text;\n      }\n    } else if (Object.keys(entriesToTranslate).length > 0) {\n      // For other locales, translate only entries without overrides\n      try {\n        this.logger.debug(\n          `Translating ${locale} with ${Object.keys(entriesToTranslate).length} entries`,\n        );\n        const translatedTexts = await this.translator.translate(\n          locale,\n          entriesToTranslate,\n        );\n        // Merge translated texts with overridden translations\n        newTranslations = { ...overriddenTranslations, ...translatedTexts };\n      } catch (error) {\n        const errorMessage =\n          error instanceof Error ? error.message : String(error);\n        this.logger.error(\n          `Translation failed for locale \"${locale}\": ${errorMessage}`,\n        );\n        if (error instanceof Error && error.stack) {\n          this.logger.debug(`Stack trace: ${error.stack}`);\n        }\n\n        return {\n          translations: this.pickTranslations(\n            cachedTranslations,\n            workingHashes,\n          ),\n          errors: [\n            {\n              hash: \"all\",\n              sourceText: \"all\",\n              error: errorMessage,\n            },\n          ],\n          stats: {\n            total: workingHashes.length,\n            cached: cachedCount,\n            translated: 0,\n            failed: uncachedHashes.length,\n          },\n        };\n      }\n\n      // Check for partial failures (some hashes didn't get translated)\n      for (const hash of uncachedHashes) {\n        if (!newTranslations[hash]) {\n          const entry = filteredMetadata[hash];\n          errors.push({\n            hash,\n            sourceText: entry?.sourceText || \"\",\n            error: \"Translator doesn't return translation\",\n          });\n        }\n      }\n    }\n\n    // Step 5: Update cache with successful translations (skip for pseudo)\n    if (Object.keys(newTranslations).length > 0) {\n      try {\n        await this.cache.update(locale, newTranslations);\n      } catch (error) {\n        this.logger.error(`Failed to update cache:`, error);\n        // Don't fail the request if cache update fails\n      }\n    }\n\n    // Step 6: Merge and return\n    const allTranslations = { ...cachedTranslations, ...newTranslations };\n    const result = this.pickTranslations(allTranslations, workingHashes);\n\n    const endTime = performance.now();\n    this.logger.debug(\n      `Translation completed for ${locale}: ${Object.keys(newTranslations).length} new, ${cachedCount} cached, ${errors.length} errors in ${(endTime - startTime).toFixed(2)}ms`,\n    );\n\n    return {\n      translations: result,\n      errors,\n      stats: {\n        total: workingHashes.length,\n        cached: cachedCount,\n        translated: Object.keys(newTranslations).length,\n        failed: errors.length,\n      },\n    };\n  }\n\n  /**\n   * Prepare metadata entries for translation\n   */\n  private prepareEntries(\n    metadata: MetadataSchema,\n    hashes: string[],\n  ): Record<string, TranslatableEntry> {\n    const entries: Record<string, TranslatableEntry> = {};\n\n    for (const hash of hashes) {\n      const entry = metadata[hash];\n      if (entry) {\n        entries[hash] = {\n          text: entry.sourceText,\n          context: entry.context || {},\n        };\n      }\n    }\n\n    return entries;\n  }\n\n  /**\n   * Pick only requested translations from the full set\n   */\n  // TODO (AleksandrSl 14/12/2025): SHould I use this in the build somehow?\n  private pickTranslations(\n    allTranslations: Record<string, string>,\n    requestedHashes: string[],\n  ): Record<string, string> {\n    const result: Record<string, string> = {};\n\n    for (const hash of requestedHashes) {\n      if (allTranslations[hash]) {\n        result[hash] = allTranslations[hash];\n      }\n    }\n\n    return result;\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lingo.dev/compiler",
-  "version": "0.3.7",
+  "version": "0.3.8",
   "description": "Lingo.dev Compiler",
   "private": false,
   "repository": {
@@ -161,7 +161,7 @@
     "posthog-node": "5.14.0",
     "lmdb": "3.2.6",
     "ws": "8.18.3",
-    "lingo.dev": "^0.131.1"
+    "lingo.dev": "^0.131.4"
   },
   "peerDependencies": {
     "next": "^15.0.0 || ^16.0.4",