feat: add missing file for WS

Author: AleksandrSl

cmp/compiler/src/translation-server/ws-events.ts

@@ -0,0 +1,152 @@
+/**
+ * WebSocket event types for real-time translation progress
+ * Sent from translation server to dev widget clients
+ */
+
+/**
+ * Base event structure
+ */
+interface BaseEvent {
+  type: string;
+  timestamp: number;
+}
+
+/**
+ * Server connection established
+ */
+export interface ConnectedEvent extends BaseEvent {
+  type: "connected";
+  serverUrl: string;
+  version: string;
+}
+
+/**
+ * Single translation started
+ */
+export interface TranslationStartEvent extends BaseEvent {
+  type: "translation:start";
+  hash: string;
+  locale: string;
+  sourceText: string;
+}
+
+/**
+ * Single translation completed successfully
+ */
+export interface TranslationCompleteEvent extends BaseEvent {
+  type: "translation:complete";
+  hash: string;
+  locale: string;
+  translatedText: string;
+  duration: number; // ms
+}
+
+/**
+ * Single translation failed
+ */
+export interface TranslationErrorEvent extends BaseEvent {
+  type: "translation:error";
+  hash: string;
+  locale: string;
+  error: string;
+}
+
+/**
+ * Batch translation started
+ */
+export interface BatchStartEvent extends BaseEvent {
+  type: "batch:start";
+  locale: string;
+  total: number;
+  hashes: string[];
+}
+
+/**
+ * Batch translation progress update
+ */
+export interface BatchProgressEvent extends BaseEvent {
+  type: "batch:progress";
+  locale: string;
+  completed: number;
+  total: number;
+  percent: number;
+}
+
+/**
+ * Batch translation completed
+ */
+export interface BatchCompleteEvent extends BaseEvent {
+  type: "batch:complete";
+  locale: string;
+  total: number;
+  successful: number;
+  failed: number;
+  duration: number; // ms
+}
+
+/**
+ * Metadata updated (new translatable text discovered)
+ */
+export interface MetadataUpdateEvent extends BaseEvent {
+  type: "metadata:update";
+  newEntries: number;
+  totalEntries: number;
+}
+
+/**
+ * Cache updated
+ */
+export interface CacheUpdateEvent extends BaseEvent {
+  type: "cache:update";
+  locale: string;
+  entriesCount: number;
+}
+
+/**
+ * Server is now busy processing translations
+ */
+export interface ServerBusyEvent extends BaseEvent {
+  type: "server:busy";
+  activeTranslations: number;
+}
+
+/**
+ * Server is now idle (no active translations)
+ */
+export interface ServerIdleEvent extends BaseEvent {
+  type: "server:idle";
+}
+
+/**
+ * Union type of all possible events
+ */
+export type TranslationServerEvent =
+  | ConnectedEvent
+  | TranslationStartEvent
+  | TranslationCompleteEvent
+  | TranslationErrorEvent
+  | BatchStartEvent
+  | BatchProgressEvent
+  | BatchCompleteEvent
+  | MetadataUpdateEvent
+  | CacheUpdateEvent
+  | ServerBusyEvent
+  | ServerIdleEvent;
+
+type TranslationServerEventByType = {
+  [T in TranslationServerEvent as T["type"]]: T;
+};
+
+/**
+ * Helper to create events with timestamp
+ */
+export function createEvent<T extends keyof TranslationServerEventByType>(
+  type: T,
+  event?: Omit<TranslationServerEventByType[T], "timestamp" | "type">,
+): TranslationServerEventByType[T] {
+  return {
+    ...event,
+    timestamp: Date.now(),
+    type,
+  } as TranslationServerEventByType[T];
+}