@lingo.dev/compiler 0.1.0

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

@@ -0,0 +1,544 @@
+import { getLogger } from "./logger.mjs";
+import { createTranslator } from "../translators/translator-factory.mjs";
+import { TranslationService } from "../translators/translation-service.mjs";
+import { createCache } from "../translators/cache-factory.mjs";
+import { createEmptyMetadata, getMetadataPath, loadMetadata } from "../metadata/manager.mjs";
+import { createEvent } from "./ws-events.mjs";
+import { parseLocaleOrThrow } from "../utils/is-valid-locale.mjs";
+import http from "http";
+import crypto from "crypto";
+import { URL } from "url";
+import { WebSocket, WebSocketServer } from "ws";
+
+//#region src/translation-server/translation-server.ts
+/**
+* Simple HTTP server for serving translations during development
+*
+* This server:
+* - Finds a free port automatically
+* - Serves translations via:
+*   - GET /translations/:locale - Full dictionary (cached)
+*   - POST /translations/:locale (body: { hashes: string[] }) - Batch translation
+* - Uses the same translation logic as middleware
+* - Can be started/stopped programmatically
+*/
+var TranslationServer = class {
+	server = null;
+	url = void 0;
+	logger;
+	config;
+	configHash;
+	startPort;
+	onReadyCallback;
+	onErrorCallback;
+	translationService = null;
+	metadata = null;
+	connections = /* @__PURE__ */ new Set();
+	wss = null;
+	wsClients = /* @__PURE__ */ new Set();
+	activeTranslations = 0;
+	isBusy = false;
+	busyTimeout = null;
+	BUSY_DEBOUNCE_MS = 500;
+	constructor(options) {
+		this.config = options.config;
+		this.configHash = hashConfig(options.config);
+		this.startPort = options.startPort || 6e4;
+		this.onReadyCallback = options.onReady;
+		this.onErrorCallback = options.onError;
+		this.logger = getLogger(this.config);
+	}
+	/**
+	* Start the server and find an available port
+	*/
+	async start() {
+		if (this.server) throw new Error("Server is already running");
+		this.logger.info(`🔧 Initializing translator...`);
+		this.translationService = new TranslationService(createTranslator(this.config, this.logger), createCache(this.config), {
+			sourceLocale: this.config.sourceLocale,
+			pluralization: this.config.pluralization
+		}, this.logger);
+		const port = await this.findAvailablePort(this.startPort);
+		return new Promise((resolve, reject) => {
+			this.server = http.createServer((req, res) => {
+				this.logger.info(`📥 Received: ${req.method} ${req.url}`);
+				this.handleRequest(req, res).catch((error) => {
+					this.logger.error(`Request handler error:`, error);
+					this.logger.error(error.stack);
+					if (!res.headersSent) {
+						res.writeHead(500, { "Content-Type": "application/json" });
+						res.end(JSON.stringify({ error: "Internal Server Error" }));
+					}
+				});
+			});
+			this.logger.debug(`Starting translation server on port ${port}`);
+			this.server.on("connection", (socket) => {
+				this.connections.add(socket);
+				socket.once("close", () => {
+					this.connections.delete(socket);
+				});
+			});
+			this.server.on("error", (error) => {
+				if (error.code === "EADDRINUSE") reject(/* @__PURE__ */ new Error(`Port ${port} is already in use`));
+				else {
+					this.logger.error(`Translation server error: ${error.message}\n`);
+					this.onErrorCallback?.(error);
+					reject(error);
+				}
+			});
+			this.server.listen(port, "127.0.0.1", () => {
+				this.url = `http://127.0.0.1:${port}`;
+				this.logger.info(`Translation server listening on ${this.url}`);
+				this.initializeWebSocket();
+				this.onReadyCallback?.(port);
+				resolve(port);
+			});
+		});
+	}
+	/**
+	* Initialize WebSocket server for real-time dev widget updates
+	*/
+	initializeWebSocket() {
+		if (!this.server) throw new Error("HTTP server must be started before WebSocket");
+		this.wss = new WebSocketServer({ server: this.server });
+		this.wss.on("connection", (ws) => {
+			this.wsClients.add(ws);
+			this.logger.debug(`WebSocket client connected. Total clients: ${this.wsClients.size}`);
+			this.sendToClient(ws, createEvent("connected", { serverUrl: this.url }));
+			ws.on("close", () => {
+				this.wsClients.delete(ws);
+				this.logger.debug(`WebSocket client disconnected. Total clients: ${this.wsClients.size}`);
+			});
+			ws.on("error", (error) => {
+				this.logger.error(`WebSocket client error:`, error);
+				this.wsClients.delete(ws);
+			});
+		});
+		this.wss.on("error", (error) => {
+			this.logger.error(`WebSocket server error:`, error);
+			this.onErrorCallback?.(error);
+		});
+		this.logger.info(`WebSocket server initialized`);
+	}
+	/**
+	* Send event to a specific WebSocket client
+	*/
+	sendToClient(ws, event) {
+		if (ws.readyState === WebSocket.OPEN) ws.send(JSON.stringify(event));
+	}
+	/**
+	* Broadcast event to all connected WebSocket clients
+	*/
+	broadcast(event) {
+		const message = JSON.stringify(event);
+		for (const client of this.wsClients) if (client.readyState === WebSocket.OPEN) client.send(message);
+	}
+	/**
+	* Stop the server
+	*/
+	async stop() {
+		if (!this.server) {
+			this.logger.debug("Translation server is not running. Nothing to stop.");
+			return;
+		}
+		if (this.busyTimeout) {
+			clearTimeout(this.busyTimeout);
+			this.busyTimeout = null;
+		}
+		for (const client of this.wsClients) client.close();
+		this.wsClients.clear();
+		if (this.wss) {
+			this.wss.close();
+			this.wss = null;
+		}
+		for (const socket of this.connections) socket.destroy();
+		this.connections.clear();
+		return new Promise((resolve, reject) => {
+			this.server.close((error) => {
+				if (error) reject(error);
+				else {
+					this.logger.info(`Translation server stopped`);
+					this.server = null;
+					this.url = void 0;
+					resolve();
+				}
+			});
+		});
+	}
+	/**
+	* Get the current port (null if not running)
+	*/
+	getUrl() {
+		return this.url;
+	}
+	/**
+	* Start a new server or get the URL of an existing one on the preferred port.
+	*
+	* This method optimizes for the common case where a translation server is already
+	* running on port 60000. If that port is taken, it checks if it's our service
+	* by calling the health check endpoint. If it is, we reuse it instead of starting
+	* a new server on a different port.
+	*
+	* @returns URL of the running server (new or existing)
+	*/
+	async startOrGetUrl() {
+		if (this.server && this.url) {
+			this.logger.info(`Using existing server instance at ${this.url}`);
+			return this.url;
+		}
+		const preferredPort = this.startPort;
+		const preferredUrl = `http://127.0.0.1:${preferredPort}`;
+		if (await this.isPortAvailable(preferredPort)) {
+			this.logger.info(`Port ${preferredPort} is available, starting new server...`);
+			await this.start();
+			return this.url;
+		}
+		this.logger.info(`Port ${preferredPort} is in use, checking if it's a translation server...`);
+		if (await this.checkIfTranslationServer(preferredUrl)) {
+			this.logger.info(`✅ Found existing translation server at ${preferredUrl}, reusing it`);
+			this.url = preferredUrl;
+			return preferredUrl;
+		}
+		this.logger.info(`Port ${preferredPort} is in use by another service, finding alternative...`);
+		await this.start();
+		return this.url;
+	}
+	/**
+	* Check if server is running
+	*/
+	isRunning() {
+		return this.server !== null && this.url !== null;
+	}
+	/**
+	* Reload metadata from disk
+	* Useful when metadata has been updated during runtime (e.g., new transformations)
+	*/
+	async reloadMetadata() {
+		try {
+			this.metadata = await loadMetadata(getMetadataPath(this.config));
+			this.logger.debug(`Reloaded metadata: ${Object.keys(this.metadata.entries).length} entries`);
+		} catch (error) {
+			this.logger.warn("Failed to reload metadata:", error);
+			this.metadata = createEmptyMetadata();
+		}
+	}
+	/**
+	* Translate the entire dictionary for a given locale
+	*
+	* This method always reloads metadata from disk before translating to ensure
+	* all entries added during build-time transformations are included.
+	*
+	* This is the recommended method for build-time translation generation.
+	*/
+	async translateAll(locale) {
+		if (!this.translationService) throw new Error("Translation server not initialized");
+		await this.reloadMetadata();
+		if (!this.metadata) throw new Error("Failed to load metadata");
+		const allHashes = Object.keys(this.metadata.entries);
+		this.logger.info(`Translating all ${allHashes.length} entries to ${locale}`);
+		const startTime = Date.now();
+		this.broadcast(createEvent("batch:start", {
+			locale,
+			total: allHashes.length,
+			hashes: allHashes
+		}));
+		const result = await this.translationService.translate(locale, this.metadata, allHashes);
+		const duration = Date.now() - startTime;
+		this.broadcast(createEvent("batch:complete", {
+			locale,
+			total: allHashes.length,
+			successful: Object.keys(result.translations).length,
+			failed: result.errors.length,
+			duration
+		}));
+		return result;
+	}
+	/**
+	* Find an available port starting from the given port
+	*/
+	async findAvailablePort(startPort, maxAttempts = 100) {
+		for (let port = startPort; port < startPort + maxAttempts; port++) if (await this.isPortAvailable(port)) return port;
+		throw new Error(`Could not find available port in range ${startPort}-${startPort + maxAttempts}`);
+	}
+	/**
+	* Check if a port is available
+	*/
+	async isPortAvailable(port) {
+		return new Promise((resolve) => {
+			const testServer = http.createServer();
+			testServer.once("error", (error) => {
+				if (error.code === "EADDRINUSE") resolve(false);
+				else resolve(false);
+			});
+			testServer.once("listening", () => {
+				testServer.close(() => {
+					resolve(true);
+				});
+			});
+			testServer.listen(port, "127.0.0.1");
+		});
+	}
+	/**
+	* Mark translation activity start - emits busy event if not already busy
+	*/
+	startTranslationActivity() {
+		this.activeTranslations++;
+		if (this.busyTimeout) {
+			clearTimeout(this.busyTimeout);
+			this.busyTimeout = null;
+		}
+		if (!this.isBusy && this.activeTranslations > 0) {
+			this.isBusy = true;
+			this.broadcast(createEvent("server:busy", { activeTranslations: this.activeTranslations }));
+			this.logger.debug(`[BUSY] Server is now busy (${this.activeTranslations} active)`);
+		}
+	}
+	/**
+	* Mark translation activity end - emits idle event after debounce period
+	*/
+	endTranslationActivity() {
+		this.activeTranslations = Math.max(0, this.activeTranslations - 1);
+		if (this.activeTranslations === 0 && this.isBusy) {
+			if (this.busyTimeout) clearTimeout(this.busyTimeout);
+			this.busyTimeout = setTimeout(() => {
+				if (this.activeTranslations === 0) {
+					this.isBusy = false;
+					this.broadcast(createEvent("server:idle", {}));
+					this.logger.debug("[IDLE] Server is now idle");
+				}
+			}, this.BUSY_DEBOUNCE_MS);
+		}
+	}
+	/**
+	* Check if a given URL is running our translation server by calling the health endpoint
+	* Also verifies that the config hash matches to ensure compatible configuration
+	*/
+	async checkIfTranslationServer(url) {
+		return new Promise((resolve) => {
+			const healthUrl = `${url}/health`;
+			const req = http.get(healthUrl, { timeout: 2e3 }, (res) => {
+				let data = "";
+				res.on("data", (chunk) => {
+					data += chunk.toString();
+				});
+				res.on("end", () => {
+					try {
+						if (res.statusCode === 200) {
+							const json = JSON.parse(data);
+							if (json.configHash && json.configHash !== this.configHash) {
+								this.logger.warn(`Existing server has different config (hash: ${json.configHash} vs ${this.configHash}), will start new server`);
+								resolve(false);
+								return;
+							}
+							resolve(true);
+							return;
+						}
+						resolve(false);
+					} catch (error) {
+						resolve(false);
+					}
+				});
+			});
+			req.on("error", () => {
+				resolve(false);
+			});
+			req.on("timeout", () => {
+				req.destroy();
+				resolve(false);
+			});
+		});
+	}
+	/**
+	* Handle incoming HTTP request
+	*/
+	async handleRequest(req, res) {
+		this.logger.info(`🔄 Processing: ${req.method} ${req.url}`);
+		try {
+			const url = new URL(req.url || "", `http://${req.headers.host}`);
+			this.logger.debug(`${req.method} ${url.pathname}`);
+			res.setHeader("Access-Control-Allow-Origin", "*");
+			res.setHeader("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
+			res.setHeader("Access-Control-Allow-Headers", "Content-Type");
+			res.setHeader("Access-Control-Expose-Headers", "Content-Type, Cache-Control");
+			if (req.method === "OPTIONS") {
+				res.writeHead(204);
+				res.end();
+				return;
+			}
+			if (url.pathname === "/health") {
+				res.writeHead(200, { "Content-Type": "application/json" });
+				res.end(JSON.stringify({
+					port: this.url,
+					configHash: this.configHash
+				}));
+				return;
+			}
+			const postMatch = url.pathname.match(/^\/translations\/([^/]+)$/);
+			if (postMatch && req.method === "POST") {
+				const [, locale] = postMatch;
+				await this.handleBatchTranslationRequest(locale, req, res);
+				return;
+			}
+			const dictMatch = url.pathname.match(/^\/translations\/([^/]+)$/);
+			if (dictMatch && req.method === "GET") {
+				const [, locale] = dictMatch;
+				await this.handleDictionaryRequest(locale, res);
+				return;
+			}
+			res.writeHead(404, { "Content-Type": "application/json" });
+			res.end(JSON.stringify({
+				error: "Not Found",
+				message: "Unknown endpoint",
+				availableEndpoints: [
+					"GET /health",
+					"GET /translations/:locale",
+					"POST /translations/:locale (with body: { hashes: string[] })"
+				]
+			}));
+		} catch (error) {
+			this.logger.error("Error handling request:", error);
+			res.writeHead(500, { "Content-Type": "application/json" });
+			res.end(JSON.stringify({
+				error: "Internal Server Error",
+				message: error instanceof Error ? error.message : "Unknown error"
+			}));
+		}
+	}
+	/**
+	* Handle batch translation request
+	*/
+	async handleBatchTranslationRequest(locale, req, res) {
+		try {
+			const parsedLocale = parseLocaleOrThrow(locale);
+			let body = "";
+			this.logger.debug("Reading request body...");
+			for await (const chunk of req) {
+				body += chunk.toString();
+				this.logger.debug(`Chunk read, body: ${body}`);
+			}
+			const { hashes } = JSON.parse(body);
+			this.logger.debug(`Parsed hashes: ${hashes.join(",")}`);
+			if (!Array.isArray(hashes)) {
+				res.writeHead(400, { "Content-Type": "application/json" });
+				res.end(JSON.stringify({
+					error: "Bad Request",
+					message: "Body must contain 'hashes' array"
+				}));
+				return;
+			}
+			if (!this.translationService) throw new Error("Translation service not initialized");
+			await this.reloadMetadata();
+			if (!this.metadata) throw new Error("Failed to load metadata");
+			this.logger.info(`🔄 Translating ${hashes.length} hashes to ${locale}`);
+			this.logger.debug(`🔄 Hashes: ${hashes.join(", ")}`);
+			this.startTranslationActivity();
+			try {
+				const result = await this.translationService.translate(parsedLocale, this.metadata, hashes);
+				res.writeHead(200, {
+					"Content-Type": "application/json",
+					"Cache-Control": "no-cache"
+				});
+				res.end(JSON.stringify({
+					locale,
+					translations: result.translations,
+					errors: result.errors
+				}));
+			} finally {
+				this.endTranslationActivity();
+			}
+		} catch (error) {
+			this.logger.error(`Error getting batch translations for ${locale}:`, error);
+			res.writeHead(500, { "Content-Type": "application/json" });
+			res.end(JSON.stringify({
+				error: "Translation generation failed",
+				message: error instanceof Error ? error.message : "Unknown error"
+			}));
+		}
+	}
+	/**
+	* Handle request for full translation dictionary
+	*/
+	async handleDictionaryRequest(locale, res) {
+		try {
+			const parsedLocale = parseLocaleOrThrow(locale);
+			if (!this.translationService) throw new Error("Translation service not initialized");
+			await this.reloadMetadata();
+			if (!this.metadata) throw new Error("Failed to load metadata");
+			this.logger.info(`🌐 Requesting full dictionary for ${locale}`);
+			const allHashes = Object.keys(this.metadata.entries);
+			const result = await this.translationService.translate(parsedLocale, this.metadata, allHashes);
+			res.writeHead(200, {
+				"Content-Type": "application/json",
+				"Cache-Control": "public, max-age=3600"
+			});
+			res.end(JSON.stringify({
+				locale,
+				translations: result.translations,
+				errors: result.errors
+			}));
+		} catch (error) {
+			this.logger.error(`Error getting dictionary for ${locale}:`, error);
+			res.writeHead(500, { "Content-Type": "application/json" });
+			res.end(JSON.stringify({
+				error: "Translation generation failed",
+				message: error instanceof Error ? error.message : "Unknown error"
+			}));
+		}
+	}
+};
+function stableStringify(value) {
+	const normalize = (v) => {
+		if (v === void 0) return void 0;
+		if (typeof v === "function") return void 0;
+		if (v === null) return null;
+		if (Array.isArray(v)) return v.map(normalize).filter((x) => x !== void 0);
+		if (typeof v === "object") {
+			const out = {};
+			for (const key of Object.keys(v).sort()) {
+				const next = normalize(v[key]);
+				if (next !== void 0) out[key] = next;
+			}
+			return out;
+		}
+		return v;
+	};
+	return JSON.stringify(normalize(value));
+}
+/**
+* Generate a stable hash of a config object
+* Filters out functions and non-serializable values
+* Sorts keys for stability
+*/
+function hashConfig(config) {
+	const serialized = stableStringify(config);
+	return crypto.createHash("md5").update(serialized).digest("hex").slice(0, 12);
+}
+/**
+* Create and start a translation server
+*/
+async function startTranslationServer(options) {
+	const server = new TranslationServer(options);
+	await server.start();
+	return server;
+}
+/**
+* Create a translation server and start it or reuse an existing one on the preferred port
+*
+* Since we have little control over the dev server start in next, we can start the translation server only in the loader,
+* and loaders could be started from multiple processes (it seems) or similar we need a way to avoid starting multiple servers.
+* This one will try to start a server on the preferred port (which seems to be an atomic operation), and if it fails,
+* it checks if the server already started is ours and returns its url.
+*
+* @returns Object containing the server instance and its URL
+*/
+async function startOrGetTranslationServer(options) {
+	const server = new TranslationServer(options);
+	return {
+		server,
+		url: await server.startOrGetUrl()
+	};
+}
+
+//#endregion
+export { startOrGetTranslationServer, startTranslationServer };
+//# sourceMappingURL=translation-server.mjs.map

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

@@ -0,0 +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 {\n  createCache,\n  createTranslator,\n  TranslationService,\n} from \"../translators\";\nimport {\n  createEmptyMetadata,\n  getMetadataPath,\n  loadMetadata,\n} 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  /**\n   * Starting port to try (will find next available if taken)\n   * @default 3456\n   */\n  startPort?: number;\n\n  /**\n   * Configuration for translation generation\n   */\n  config: TranslationMiddlewareConfig;\n\n  /**\n   * Callback when server is ready\n   */\n  onReady?: (port: number) => void;\n\n  /**\n   * Callback on error\n   */\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 config: TranslationMiddlewareConfig;\n  private configHash: string;\n  private startPort: number;\n  private onReadyCallback?: (port: number) => void;\n  private onErrorCallback?: (error: Error) => void;\n  private translationService: TranslationService | null = null;\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\n  constructor(options: TranslationServerOptions) {\n    this.config = options.config;\n    this.configHash = hashConfig(options.config);\n    this.startPort = options.startPort || 60000;\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 translator = createTranslator(this.config, this.logger);\n    const cache = createCache(this.config);\n\n    this.translationService = new TranslationService(\n      translator,\n      cache,\n      {\n        sourceLocale: this.config.sourceLocale,\n        pluralization: this.config.pluralization,\n      },\n      this.logger,\n    );\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 port 60000. 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 instance already has a server running, return its URL\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.entries).length} entries`,\n      );\n    } catch (error) {\n      this.logger.warn(\"Failed to reload metadata:\", error);\n      this.metadata = createEmptyMetadata();\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.entries);\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            // Check if response is valid and has the expected structure\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\n      if (!this.translationService) {\n        throw new Error(\"Translation service not initialized\");\n      }\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      if (!this.translationService) {\n        throw new Error(\"Translation service not initialized\");\n      }\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.entries);\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\n/**\n * Create and start a translation server\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 loader,\n * and loaders could be started from multiple processes (it seems) or similar 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 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/translation-server/ws-events.cjs

@@ -0,0 +1,15 @@
+
+//#region src/translation-server/ws-events.ts
+/**
+* Helper to create events with timestamp
+*/
+function createEvent(type, event) {
+	return {
+		...event,
+		timestamp: Date.now(),
+		type
+	};
+}
+
+//#endregion
+exports.createEvent = createEvent;

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

@@ -0,0 +1,15 @@
+//#region src/translation-server/ws-events.ts
+/**
+* Helper to create events with timestamp
+*/
+function createEvent(type, event) {
+	return {
+		...event,
+		timestamp: Date.now(),
+		type
+	};
+}
+
+//#endregion
+export { createEvent };
+//# sourceMappingURL=ws-events.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ws-events.mjs","names":[],"sources":["../../src/translation-server/ws-events.ts"],"sourcesContent":["/**\n * WebSocket event types for real-time translation progress\n * Sent from translation server to dev widget clients\n */\n\nimport type { LocaleCode } from \"lingo.dev/spec\";\n\n/**\n * Base event structure\n */\ninterface BaseEvent {\n  type: string;\n  timestamp: number;\n}\n\n/**\n * Server connection established\n */\nexport interface ConnectedEvent extends BaseEvent {\n  type: \"connected\";\n  serverUrl: string;\n}\n\n/**\n * Single translation started\n */\nexport interface TranslationStartEvent extends BaseEvent {\n  type: \"translation:start\";\n  hash: string;\n  locale: LocaleCode;\n  sourceText: string;\n}\n\n/**\n * Single translation completed successfully\n */\nexport interface TranslationCompleteEvent extends BaseEvent {\n  type: \"translation:complete\";\n  hash: string;\n  locale: LocaleCode;\n  translatedText: string;\n  duration: number; // ms\n}\n\n/**\n * Single translation failed\n */\nexport interface TranslationErrorEvent extends BaseEvent {\n  type: \"translation:error\";\n  hash: string;\n  locale: LocaleCode;\n  error: string;\n}\n\n/**\n * Batch translation started\n */\nexport interface BatchStartEvent extends BaseEvent {\n  type: \"batch:start\";\n  locale: LocaleCode;\n  total: number;\n  hashes: string[];\n}\n\n/**\n * Batch translation progress update\n */\nexport interface BatchProgressEvent extends BaseEvent {\n  type: \"batch:progress\";\n  locale: LocaleCode;\n  completed: number;\n  total: number;\n  percent: number;\n}\n\n/**\n * Batch translation completed\n */\nexport interface BatchCompleteEvent extends BaseEvent {\n  type: \"batch:complete\";\n  locale: LocaleCode;\n  total: number;\n  successful: number;\n  failed: number;\n  duration: number; // ms\n}\n\n/**\n * Metadata updated (new translatable text discovered)\n */\nexport interface MetadataUpdateEvent extends BaseEvent {\n  type: \"metadata:update\";\n  newEntries: number;\n  totalEntries: number;\n}\n\n/**\n * Cache updated\n */\nexport interface CacheUpdateEvent extends BaseEvent {\n  type: \"cache:update\";\n  locale: LocaleCode;\n  entriesCount: number;\n}\n\n/**\n * Server is now busy processing translations\n */\nexport interface ServerBusyEvent extends BaseEvent {\n  type: \"server:busy\";\n  activeTranslations: number;\n}\n\n/**\n * Server is now idle (no active translations)\n */\nexport interface ServerIdleEvent extends BaseEvent {\n  type: \"server:idle\";\n}\n\n/**\n * Union type of all possible events\n */\nexport type TranslationServerEvent =\n  | ConnectedEvent\n  | TranslationStartEvent\n  | TranslationCompleteEvent\n  | TranslationErrorEvent\n  | BatchStartEvent\n  | BatchProgressEvent\n  | BatchCompleteEvent\n  | MetadataUpdateEvent\n  | CacheUpdateEvent\n  | ServerBusyEvent\n  | ServerIdleEvent;\n\ntype TranslationServerEventByType = {\n  [T in TranslationServerEvent as T[\"type\"]]: T;\n};\n\n/**\n * Helper to create events with timestamp\n */\nexport function createEvent<T extends keyof TranslationServerEventByType>(\n  type: T,\n  event: Omit<TranslationServerEventByType[T], \"timestamp\" | \"type\">,\n): TranslationServerEventByType[T] {\n  return {\n    ...event,\n    timestamp: Date.now(),\n    type,\n  } as TranslationServerEventByType[T];\n}\n"],"mappings":";;;;AA+IA,SAAgB,YACd,MACA,OACiC;AACjC,QAAO;EACL,GAAG;EACH,WAAW,KAAK,KAAK;EACrB;EACD"}