@almadar/runtime 1.0.0

package/dist/ServerBridge.d.ts

@@ -0,0 +1,118 @@
+import { I as IEventBus } from './types-JFCKD0FU.js';
+
+/**
+ * ServerBridge - Client-Server Trait Communication
+ *
+ * Bridges the client EventBus with the server OrbitalRuntime:
+ * 1. Forwards specified events from client to server
+ * 2. Receives events from server (via polling or WebSocket)
+ * 3. Puts server events onto client EventBus
+ *
+ * This enables cross-orbital communication between client and server traits.
+ *
+ * @example
+ * ```typescript
+ * import { ServerBridge } from '@kflow-builder/shared/runtime';
+ * import { useEventBus } from './hooks/useEventBus';
+ *
+ * // In your app initialization
+ * const eventBus = useEventBus();
+ * const bridge = new ServerBridge({
+ *   eventBus,
+ *   serverUrl: '/api/orbitals',
+ *   // Events to forward from client to server
+ *   forwardEvents: ['ORDER_PLACED', 'PAYMENT_COMPLETED'],
+ * });
+ *
+ * bridge.connect();
+ *
+ * // Now when client emits ORDER_PLACED, server traits receive it
+ * eventBus.emit('ORDER_PLACED', { orderId: '123' });
+ * ```
+ *
+ * @packageDocumentation
+ */
+
+interface ServerBridgeConfig {
+    /** Client EventBus to bridge */
+    eventBus: IEventBus;
+    /** Base URL for orbital server API */
+    serverUrl: string;
+    /** Events to forward from client to server */
+    forwardEvents?: string[];
+    /** Forward all events matching pattern (e.g., 'Order*', '*') */
+    forwardPattern?: string;
+    /** Target orbital for forwarded events (or 'broadcast' for all) */
+    targetOrbital?: string;
+    /** Enable WebSocket for real-time server events */
+    useWebSocket?: boolean;
+    /** Polling interval in ms (if not using WebSocket) */
+    pollInterval?: number;
+    /** Enable debug logging */
+    debug?: boolean;
+    /** Custom fetch function (for testing or custom auth) */
+    fetch?: typeof fetch;
+}
+interface ServerBridgeState {
+    connected: boolean;
+    lastError?: string;
+    eventsForwarded: number;
+    eventsReceived: number;
+}
+/**
+ * Bridges client EventBus with server OrbitalRuntime
+ */
+declare class ServerBridge {
+    private config;
+    private state;
+    private unsubscribes;
+    private pollTimer?;
+    private ws?;
+    private fetchFn;
+    constructor(config: ServerBridgeConfig);
+    /**
+     * Connect the bridge - start forwarding events
+     */
+    connect(): void;
+    /**
+     * Disconnect the bridge
+     */
+    disconnect(): void;
+    /**
+     * Get current bridge state
+     */
+    getState(): ServerBridgeState;
+    private setupEventForwarding;
+    private forwardToServer;
+    private sendEventToOrbital;
+    private fetchOrbitals;
+    private setupPolling;
+    private setupWebSocket;
+    /**
+     * Send an event directly to a specific orbital (bypassing EventBus)
+     */
+    sendEvent(orbitalName: string, event: string, payload?: Record<string, unknown>): Promise<{
+        success: boolean;
+        states?: Record<string, string>;
+        emittedEvents?: Array<{
+            event: string;
+            payload?: unknown;
+        }>;
+        error?: string;
+    }>;
+    /**
+     * Get current state of an orbital's traits
+     */
+    getOrbitalState(orbitalName: string): Promise<{
+        success: boolean;
+        states?: Record<string, string>;
+        error?: string;
+    }>;
+    private log;
+}
+/**
+ * Create a ServerBridge instance
+ */
+declare function createServerBridge(config: ServerBridgeConfig): ServerBridge;
+
+export { ServerBridge, type ServerBridgeConfig, type ServerBridgeState, createServerBridge };

package/dist/ServerBridge.js

@@ -0,0 +1,242 @@
+// src/ServerBridge.ts
+var ServerBridge = class {
+  config;
+  state = {
+    connected: false,
+    eventsForwarded: 0,
+    eventsReceived: 0
+  };
+  unsubscribes = [];
+  pollTimer;
+  ws;
+  fetchFn;
+  constructor(config) {
+    this.config = {
+      pollInterval: 5e3,
+      ...config
+    };
+    this.fetchFn = config.fetch || fetch.bind(globalThis);
+  }
+  // ==========================================================================
+  // Connection Management
+  // ==========================================================================
+  /**
+   * Connect the bridge - start forwarding events
+   */
+  connect() {
+    if (this.state.connected) {
+      this.log("warn", "Already connected");
+      return;
+    }
+    this.log("info", "Connecting bridge...");
+    this.setupEventForwarding();
+    if (this.config.useWebSocket) {
+      this.setupWebSocket();
+    } else if (this.config.pollInterval && this.config.pollInterval > 0) {
+      this.setupPolling();
+    }
+    this.state.connected = true;
+    this.log("info", "Bridge connected");
+  }
+  /**
+   * Disconnect the bridge
+   */
+  disconnect() {
+    for (const unsub of this.unsubscribes) {
+      unsub();
+    }
+    this.unsubscribes = [];
+    if (this.pollTimer) {
+      clearInterval(this.pollTimer);
+      this.pollTimer = void 0;
+    }
+    if (this.ws) {
+      this.ws.close();
+      this.ws = void 0;
+    }
+    this.state.connected = false;
+    this.log("info", "Bridge disconnected");
+  }
+  /**
+   * Get current bridge state
+   */
+  getState() {
+    return { ...this.state };
+  }
+  // ==========================================================================
+  // Event Forwarding (Client -> Server)
+  // ==========================================================================
+  setupEventForwarding() {
+    const { eventBus, forwardEvents, forwardPattern } = this.config;
+    if (forwardEvents && forwardEvents.length > 0) {
+      for (const eventType of forwardEvents) {
+        const unsub = eventBus.on(eventType, (event) => {
+          this.forwardToServer(event);
+        });
+        this.unsubscribes.push(unsub);
+      }
+    } else if (forwardPattern) {
+      if (forwardPattern === "*") {
+        const unsub = eventBus.on("*", (event) => {
+          if (!event.type.startsWith("UI:") && !event.type.startsWith("BRIDGE:")) {
+            this.forwardToServer(event);
+          }
+        });
+        this.unsubscribes.push(unsub);
+      } else {
+        const prefix = forwardPattern.replace("*", "");
+        const unsub = eventBus.on("*", (event) => {
+          if (event.type.startsWith(prefix)) {
+            this.forwardToServer(event);
+          }
+        });
+        this.unsubscribes.push(unsub);
+      }
+    }
+  }
+  async forwardToServer(event) {
+    const { serverUrl, targetOrbital } = this.config;
+    try {
+      if (targetOrbital && targetOrbital !== "broadcast") {
+        await this.sendEventToOrbital(targetOrbital, event);
+      } else {
+        const orbitals = await this.fetchOrbitals();
+        for (const orbital of orbitals) {
+          await this.sendEventToOrbital(orbital.name, event);
+        }
+      }
+      this.state.eventsForwarded++;
+      this.log("debug", `Forwarded event: ${event.type}`);
+    } catch (error) {
+      this.state.lastError = String(error);
+      this.log("error", `Failed to forward event: ${event.type}`, error);
+    }
+  }
+  async sendEventToOrbital(orbitalName, event) {
+    const { serverUrl } = this.config;
+    const url = `${serverUrl}/${orbitalName}/events`;
+    const response = await this.fetchFn(url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        event: event.type,
+        payload: event.payload
+      })
+    });
+    if (!response.ok) {
+      throw new Error(`Server returned ${response.status}`);
+    }
+    const result = await response.json();
+    if (result.emittedEvents && result.emittedEvents.length > 0) {
+      for (const emitted of result.emittedEvents) {
+        this.config.eventBus.emit(`SERVER:${emitted.event}`, emitted.payload);
+        this.state.eventsReceived++;
+      }
+    }
+  }
+  async fetchOrbitals() {
+    const response = await this.fetchFn(this.config.serverUrl);
+    if (!response.ok) {
+      throw new Error(`Failed to fetch orbitals: ${response.status}`);
+    }
+    const data = await response.json();
+    return data.orbitals || [];
+  }
+  // ==========================================================================
+  // Server -> Client (Polling)
+  // ==========================================================================
+  setupPolling() {
+    this.log("debug", "Polling mode - events received via forward response");
+  }
+  // ==========================================================================
+  // Server -> Client (WebSocket)
+  // ==========================================================================
+  setupWebSocket() {
+    const { serverUrl } = this.config;
+    const wsUrl = serverUrl.replace(/^http:/, "ws:").replace(/^https:/, "wss:").replace(/\/api\/orbitals$/, "/ws/orbitals");
+    try {
+      this.ws = new WebSocket(wsUrl);
+      this.ws.onopen = () => {
+        this.log("info", "WebSocket connected");
+      };
+      this.ws.onmessage = (msg) => {
+        try {
+          const data = JSON.parse(msg.data);
+          if (data.type === "event") {
+            this.config.eventBus.emit(`SERVER:${data.event}`, data.payload);
+            this.state.eventsReceived++;
+            this.log("debug", `Received server event: ${data.event}`);
+          }
+        } catch (error) {
+          this.log("error", "Failed to parse WebSocket message", error);
+        }
+      };
+      this.ws.onerror = (error) => {
+        this.state.lastError = "WebSocket error";
+        this.log("error", "WebSocket error", error);
+      };
+      this.ws.onclose = () => {
+        this.log("info", "WebSocket closed");
+      };
+    } catch (error) {
+      this.log("error", "Failed to create WebSocket", error);
+    }
+  }
+  // ==========================================================================
+  // Direct Methods
+  // ==========================================================================
+  /**
+   * Send an event directly to a specific orbital (bypassing EventBus)
+   */
+  async sendEvent(orbitalName, event, payload) {
+    const { serverUrl } = this.config;
+    const url = `${serverUrl}/${orbitalName}/events`;
+    try {
+      const response = await this.fetchFn(url, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ event, payload })
+      });
+      return await response.json();
+    } catch (error) {
+      return { success: false, error: String(error) };
+    }
+  }
+  /**
+   * Get current state of an orbital's traits
+   */
+  async getOrbitalState(orbitalName) {
+    const { serverUrl } = this.config;
+    const url = `${serverUrl}/${orbitalName}`;
+    try {
+      const response = await this.fetchFn(url);
+      const data = await response.json();
+      if (data.success && data.orbital) {
+        const states = {};
+        for (const trait of data.orbital.traits) {
+          states[trait.name] = trait.currentState;
+        }
+        return { success: true, states };
+      }
+      return { success: false, error: data.error };
+    } catch (error) {
+      return { success: false, error: String(error) };
+    }
+  }
+  // ==========================================================================
+  // Utilities
+  // ==========================================================================
+  log(level, message, data) {
+    if (!this.config.debug && level === "debug") return;
+    const prefix = "[ServerBridge]";
+    const logFn = level === "error" ? console.error : level === "warn" ? console.warn : console.log;
+    logFn(prefix, message, data !== void 0 ? data : "");
+  }
+};
+function createServerBridge(config) {
+  return new ServerBridge(config);
+}
+
+export { ServerBridge, createServerBridge };
+//# sourceMappingURL=ServerBridge.js.map
+//# sourceMappingURL=ServerBridge.js.map

package/dist/ServerBridge.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ServerBridge.ts"],"names":[],"mappings":";AA0EO,IAAM,eAAN,MAAmB;AAAA,EAChB,MAAA;AAAA,EACA,KAAA,GAA2B;AAAA,IACjC,SAAA,EAAW,KAAA;AAAA,IACX,eAAA,EAAiB,CAAA;AAAA,IACjB,cAAA,EAAgB;AAAA,GAClB;AAAA,EACQ,eAAkC,EAAC;AAAA,EACnC,SAAA;AAAA,EACA,EAAA;AAAA,EACA,OAAA;AAAA,EAER,YAAY,MAAA,EAA4B;AACtC,IAAA,IAAA,CAAK,MAAA,GAAS;AAAA,MACZ,YAAA,EAAc,GAAA;AAAA,MACd,GAAG;AAAA,KACL;AACA,IAAA,IAAA,CAAK,OAAA,GAAU,MAAA,CAAO,KAAA,IAAS,KAAA,CAAM,KAAK,UAAU,CAAA;AAAA,EACtD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,OAAA,GAAgB;AACd,IAAA,IAAI,IAAA,CAAK,MAAM,SAAA,EAAW;AACxB,MAAA,IAAA,CAAK,GAAA,CAAI,QAAQ,mBAAmB,CAAA;AACpC,MAAA;AAAA,IACF;AAEA,IAAA,IAAA,CAAK,GAAA,CAAI,QAAQ,sBAAsB,CAAA;AAGvC,IAAA,IAAA,CAAK,oBAAA,EAAqB;AAG1B,IAAA,IAAI,IAAA,CAAK,OAAO,YAAA,EAAc;AAC5B,MAAA,IAAA,CAAK,cAAA,EAAe;AAAA,IACtB,WAAW,IAAA,CAAK,MAAA,CAAO,gBAAgB,IAAA,CAAK,MAAA,CAAO,eAAe,CAAA,EAAG;AACnE,MAAA,IAAA,CAAK,YAAA,EAAa;AAAA,IACpB;AAEA,IAAA,IAAA,CAAK,MAAM,SAAA,GAAY,IAAA;AACvB,IAAA,IAAA,CAAK,GAAA,CAAI,QAAQ,kBAAkB,CAAA;AAAA,EACrC;AAAA;AAAA;AAAA;AAAA,EAKA,UAAA,GAAmB;AAEjB,IAAA,KAAA,MAAW,KAAA,IAAS,KAAK,YAAA,EAAc;AACrC,MAAA,KAAA,EAAM;AAAA,IACR;AACA,IAAA,IAAA,CAAK,eAAe,EAAC;AAGrB,IAAA,IAAI,KAAK,SAAA,EAAW;AAClB,MAAA,aAAA,CAAc,KAAK,SAAS,CAAA;AAC5B,MAAA,IAAA,CAAK,SAAA,GAAY,MAAA;AAAA,IACnB;AAGA,IAAA,IAAI,KAAK,EAAA,EAAI;AACX,MAAA,IAAA,CAAK,GAAG,KAAA,EAAM;AACd,MAAA,IAAA,CAAK,EAAA,GAAK,MAAA;AAAA,IACZ;AAEA,IAAA,IAAA,CAAK,MAAM,SAAA,GAAY,KAAA;AACvB,IAAA,IAAA,CAAK,GAAA,CAAI,QAAQ,qBAAqB,CAAA;AAAA,EACxC;AAAA;AAAA;AAAA;AAAA,EAKA,QAAA,GAA8B;AAC5B,IAAA,OAAO,EAAE,GAAG,IAAA,CAAK,KAAA,EAAM;AAAA,EACzB;AAAA;AAAA;AAAA;AAAA,EAMQ,oBAAA,GAA6B;AACnC,IAAA,MAAM,EAAE,QAAA,EAAU,aAAA,EAAe,cAAA,KAAmB,IAAA,CAAK,MAAA;AAEzD,IAAA,IAAI,aAAA,IAAiB,aAAA,CAAc,MAAA,GAAS,CAAA,EAAG;AAE7C,MAAA,KAAA,MAAW,aAAa,aAAA,EAAe;AACrC,QAAA,MAAM,KAAA,GAAQ,QAAA,CAAS,EAAA,CAAG,SAAA,EAAW,CAAC,KAAA,KAAwB;AAC5D,UAAA,IAAA,CAAK,gBAAgB,KAAK,CAAA;AAAA,QAC5B,CAAC,CAAA;AACD,QAAA,IAAA,CAAK,YAAA,CAAa,KAAK,KAAK,CAAA;AAAA,MAC9B;AAAA,IACF,WAAW,cAAA,EAAgB;AAEzB,MAAA,IAAI,mBAAmB,GAAA,EAAK;AAE1B,QAAA,MAAM,KAAA,GAAQ,QAAA,CAAS,EAAA,CAAG,GAAA,EAAK,CAAC,KAAA,KAAwB;AAEtD,UAAA,IACE,CAAC,KAAA,CAAM,IAAA,CAAK,UAAA,CAAW,KAAK,CAAA,IAC5B,CAAC,KAAA,CAAM,IAAA,CAAK,UAAA,CAAW,SAAS,CAAA,EAChC;AACA,YAAA,IAAA,CAAK,gBAAgB,KAAK,CAAA;AAAA,UAC5B;AAAA,QACF,CAAC,CAAA;AACD,QAAA,IAAA,CAAK,YAAA,CAAa,KAAK,KAAK,CAAA;AAAA,MAC9B,CAAA,MAAO;AAEL,QAAA,MAAM,MAAA,GAAS,cAAA,CAAe,OAAA,CAAQ,GAAA,EAAK,EAAE,CAAA;AAC7C,QAAA,MAAM,KAAA,GAAQ,QAAA,CAAS,EAAA,CAAG,GAAA,EAAK,CAAC,KAAA,KAAwB;AACtD,UAAA,IAAI,KAAA,CAAM,IAAA,CAAK,UAAA,CAAW,MAAM,CAAA,EAAG;AACjC,YAAA,IAAA,CAAK,gBAAgB,KAAK,CAAA;AAAA,UAC5B;AAAA,QACF,CAAC,CAAA;AACD,QAAA,IAAA,CAAK,YAAA,CAAa,KAAK,KAAK,CAAA;AAAA,MAC9B;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAc,gBAAgB,KAAA,EAAoC;AAChE,IAAA,MAAM,EAAE,SAAA,EAAW,aAAA,EAAc,GAAI,IAAA,CAAK,MAAA;AAE1C,IAAA,IAAI;AAEF,MAAA,IAAI,aAAA,IAAiB,kBAAkB,WAAA,EAAa;AAElD,QAAA,MAAM,IAAA,CAAK,kBAAA,CAAmB,aAAA,EAAe,KAAK,CAAA;AAAA,MACpD,CAAA,MAAO;AAEL,QAAA,MAAM,QAAA,GAAW,MAAM,IAAA,CAAK,aAAA,EAAc;AAC1C,QAAA,KAAA,MAAW,WAAW,QAAA,EAAU;AAC9B,UAAA,MAAM,IAAA,CAAK,kBAAA,CAAmB,OAAA,CAAQ,IAAA,EAAM,KAAK,CAAA;AAAA,QACnD;AAAA,MACF;AAEA,MAAA,IAAA,CAAK,KAAA,CAAM,eAAA,EAAA;AACX,MAAA,IAAA,CAAK,GAAA,CAAI,OAAA,EAAS,CAAA,iBAAA,EAAoB,KAAA,CAAM,IAAI,CAAA,CAAE,CAAA;AAAA,IACpD,SAAS,KAAA,EAAO;AACd,MAAA,IAAA,CAAK,KAAA,CAAM,SAAA,GAAY,MAAA,CAAO,KAAK,CAAA;AACnC,MAAA,IAAA,CAAK,IAAI,OAAA,EAAS,CAAA,yBAAA,EAA4B,KAAA,CAAM,IAAI,IAAI,KAAK,CAAA;AAAA,IACnE;AAAA,EACF;AAAA,EAEA,MAAc,kBAAA,CACZ,WAAA,EACA,KAAA,EACe;AACf,IAAA,MAAM,EAAE,SAAA,EAAU,GAAI,IAAA,CAAK,MAAA;AAC3B,IAAA,MAAM,GAAA,GAAM,CAAA,EAAG,SAAS,CAAA,CAAA,EAAI,WAAW,CAAA,OAAA,CAAA;AAEvC,IAAA,MAAM,QAAA,GAAW,MAAM,IAAA,CAAK,OAAA,CAAQ,GAAA,EAAK;AAAA,MACvC,MAAA,EAAQ,MAAA;AAAA,MACR,OAAA,EAAS,EAAE,cAAA,EAAgB,kBAAA,EAAmB;AAAA,MAC9C,IAAA,EAAM,KAAK,SAAA,CAAU;AAAA,QACnB,OAAO,KAAA,CAAM,IAAA;AAAA,QACb,SAAS,KAAA,CAAM;AAAA,OAChB;AAAA,KACF,CAAA;AAED,IAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,gBAAA,EAAmB,QAAA,CAAS,MAAM,CAAA,CAAE,CAAA;AAAA,IACtD;AAEA,IAAA,MAAM,MAAA,GAAU,MAAM,QAAA,CAAS,IAAA,EAAK;AAKpC,IAAA,IAAI,MAAA,CAAO,aAAA,IAAiB,MAAA,CAAO,aAAA,CAAc,SAAS,CAAA,EAAG;AAC3D,MAAA,KAAA,MAAW,OAAA,IAAW,OAAO,aAAA,EAAe;AAC1C,QAAA,IAAA,CAAK,MAAA,CAAO,SAAS,IAAA,CAAK,CAAA,OAAA,EAAU,QAAQ,KAAK,CAAA,CAAA,EAAI,QAAQ,OAAO,CAAA;AACpE,QAAA,IAAA,CAAK,KAAA,CAAM,cAAA,EAAA;AAAA,MACb;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAc,aAAA,GAAkD;AAC9D,IAAA,MAAM,WAAW,MAAM,IAAA,CAAK,OAAA,CAAQ,IAAA,CAAK,OAAO,SAAS,CAAA;AACzD,IAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,MAAA,MAAM,IAAI,KAAA,CAAM,CAAA,0BAAA,EAA6B,QAAA,CAAS,MAAM,CAAA,CAAE,CAAA;AAAA,IAChE;AACA,IAAA,MAAM,IAAA,GAAQ,MAAM,QAAA,CAAS,IAAA,EAAK;AAClC,IAAA,OAAO,IAAA,CAAK,YAAY,EAAC;AAAA,EAC3B;AAAA;AAAA;AAAA;AAAA,EAMQ,YAAA,GAAqB;AAG3B,IAAA,IAAA,CAAK,GAAA,CAAI,SAAS,qDAAqD,CAAA;AAAA,EACzE;AAAA;AAAA;AAAA;AAAA,EAMQ,cAAA,GAAuB;AAC7B,IAAA,MAAM,EAAE,SAAA,EAAU,GAAI,IAAA,CAAK,MAAA;AAG3B,IAAA,MAAM,KAAA,GAAQ,SAAA,CACX,OAAA,CAAQ,QAAA,EAAU,KAAK,CAAA,CACvB,OAAA,CAAQ,SAAA,EAAW,MAAM,CAAA,CACzB,OAAA,CAAQ,kBAAA,EAAoB,cAAc,CAAA;AAE7C,IAAA,IAAI;AACF,MAAA,IAAA,CAAK,EAAA,GAAK,IAAI,SAAA,CAAU,KAAK,CAAA;AAE7B,MAAA,IAAA,CAAK,EAAA,CAAG,SAAS,MAAM;AACrB,QAAA,IAAA,CAAK,GAAA,CAAI,QAAQ,qBAAqB,CAAA;AAAA,MACxC,CAAA;AAEA,MAAA,IAAA,CAAK,EAAA,CAAG,SAAA,GAAY,CAAC,GAAA,KAAQ;AAC3B,QAAA,IAAI;AACF,UAAA,MAAM,IAAA,GAAO,IAAA,CAAK,KAAA,CAAM,GAAA,CAAI,IAAI,CAAA;AAChC,UAAA,IAAI,IAAA,CAAK,SAAS,OAAA,EAAS;AAEzB,YAAA,IAAA,CAAK,MAAA,CAAO,SAAS,IAAA,CAAK,CAAA,OAAA,EAAU,KAAK,KAAK,CAAA,CAAA,EAAI,KAAK,OAAO,CAAA;AAC9D,YAAA,IAAA,CAAK,KAAA,CAAM,cAAA,EAAA;AACX,YAAA,IAAA,CAAK,GAAA,CAAI,OAAA,EAAS,CAAA,uBAAA,EAA0B,IAAA,CAAK,KAAK,CAAA,CAAE,CAAA;AAAA,UAC1D;AAAA,QACF,SAAS,KAAA,EAAO;AACd,UAAA,IAAA,CAAK,GAAA,CAAI,OAAA,EAAS,mCAAA,EAAqC,KAAK,CAAA;AAAA,QAC9D;AAAA,MACF,CAAA;AAEA,MAAA,IAAA,CAAK,EAAA,CAAG,OAAA,GAAU,CAAC,KAAA,KAAU;AAC3B,QAAA,IAAA,CAAK,MAAM,SAAA,GAAY,iBAAA;AACvB,QAAA,IAAA,CAAK,GAAA,CAAI,OAAA,EAAS,iBAAA,EAAmB,KAAK,CAAA;AAAA,MAC5C,CAAA;AAEA,MAAA,IAAA,CAAK,EAAA,CAAG,UAAU,MAAM;AACtB,QAAA,IAAA,CAAK,GAAA,CAAI,QAAQ,kBAAkB,CAAA;AAAA,MAErC,CAAA;AAAA,IACF,SAAS,KAAA,EAAO;AACd,MAAA,IAAA,CAAK,GAAA,CAAI,OAAA,EAAS,4BAAA,EAA8B,KAAK,CAAA;AAAA,IACvD;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,SAAA,CACJ,WAAA,EACA,KAAA,EACA,OAAA,EAMC;AACD,IAAA,MAAM,EAAE,SAAA,EAAU,GAAI,IAAA,CAAK,MAAA;AAC3B,IAAA,MAAM,GAAA,GAAM,CAAA,EAAG,SAAS,CAAA,CAAA,EAAI,WAAW,CAAA,OAAA,CAAA;AAEvC,IAAA,IAAI;AACF,MAAA,MAAM,QAAA,GAAW,MAAM,IAAA,CAAK,OAAA,CAAQ,GAAA,EAAK;AAAA,QACvC,MAAA,EAAQ,MAAA;AAAA,QACR,OAAA,EAAS,EAAE,cAAA,EAAgB,kBAAA,EAAmB;AAAA,QAC9C,MAAM,IAAA,CAAK,SAAA,CAAU,EAAE,KAAA,EAAO,SAAS;AAAA,OACxC,CAAA;AAED,MAAA,OAAQ,MAAM,SAAS,IAAA,EAAK;AAAA,IAM9B,SAAS,KAAA,EAAO;AACd,MAAA,OAAO,EAAE,OAAA,EAAS,KAAA,EAAO,KAAA,EAAO,MAAA,CAAO,KAAK,CAAA,EAAE;AAAA,IAChD;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,gBAAgB,WAAA,EAInB;AACD,IAAA,MAAM,EAAE,SAAA,EAAU,GAAI,IAAA,CAAK,MAAA;AAC3B,IAAA,MAAM,GAAA,GAAM,CAAA,EAAG,SAAS,CAAA,CAAA,EAAI,WAAW,CAAA,CAAA;AAEvC,IAAA,IAAI;AACF,MAAA,MAAM,QAAA,GAAW,MAAM,IAAA,CAAK,OAAA,CAAQ,GAAG,CAAA;AACvC,MAAA,MAAM,IAAA,GAAQ,MAAM,QAAA,CAAS,IAAA,EAAK;AAMlC,MAAA,IAAI,IAAA,CAAK,OAAA,IAAW,IAAA,CAAK,OAAA,EAAS;AAChC,QAAA,MAAM,SAAiC,EAAC;AACxC,QAAA,KAAA,MAAW,KAAA,IAAS,IAAA,CAAK,OAAA,CAAQ,MAAA,EAAQ;AACvC,UAAA,MAAA,CAAO,KAAA,CAAM,IAAI,CAAA,GAAI,KAAA,CAAM,YAAA;AAAA,QAC7B;AACA,QAAA,OAAO,EAAE,OAAA,EAAS,IAAA,EAAM,MAAA,EAAO;AAAA,MACjC;AAEA,MAAA,OAAO,EAAE,OAAA,EAAS,KAAA,EAAO,KAAA,EAAO,KAAK,KAAA,EAAM;AAAA,IAC7C,SAAS,KAAA,EAAO;AACd,MAAA,OAAO,EAAE,OAAA,EAAS,KAAA,EAAO,KAAA,EAAO,MAAA,CAAO,KAAK,CAAA,EAAE;AAAA,IAChD;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAMQ,GAAA,CACN,KAAA,EACA,OAAA,EACA,IAAA,EACM;AACN,IAAA,IAAI,CAAC,IAAA,CAAK,MAAA,CAAO,KAAA,IAAS,UAAU,OAAA,EAAS;AAE7C,IAAA,MAAM,MAAA,GAAS,gBAAA;AACf,IAAA,MAAM,KAAA,GACJ,UAAU,OAAA,GACN,OAAA,CAAQ,QACR,KAAA,KAAU,MAAA,GACR,OAAA,CAAQ,IAAA,GACR,OAAA,CAAQ,GAAA;AAChB,IAAA,KAAA,CAAM,MAAA,EAAQ,OAAA,EAAS,IAAA,KAAS,MAAA,GAAY,OAAO,EAAE,CAAA;AAAA,EACvD;AACF;AAKO,SAAS,mBAAmB,MAAA,EAA0C;AAC3E,EAAA,OAAO,IAAI,aAAa,MAAM,CAAA;AAChC","file":"ServerBridge.js","sourcesContent":["/**\n * ServerBridge - Client-Server Trait Communication\n *\n * Bridges the client EventBus with the server OrbitalRuntime:\n * 1. Forwards specified events from client to server\n * 2. Receives events from server (via polling or WebSocket)\n * 3. Puts server events onto client EventBus\n *\n * This enables cross-orbital communication between client and server traits.\n *\n * @example\n * ```typescript\n * import { ServerBridge } from '@kflow-builder/shared/runtime';\n * import { useEventBus } from './hooks/useEventBus';\n *\n * // In your app initialization\n * const eventBus = useEventBus();\n * const bridge = new ServerBridge({\n *   eventBus,\n *   serverUrl: '/api/orbitals',\n *   // Events to forward from client to server\n *   forwardEvents: ['ORDER_PLACED', 'PAYMENT_COMPLETED'],\n * });\n *\n * bridge.connect();\n *\n * // Now when client emits ORDER_PLACED, server traits receive it\n * eventBus.emit('ORDER_PLACED', { orderId: '123' });\n * ```\n *\n * @packageDocumentation\n */\n\nimport type { IEventBus, RuntimeEvent } from \"./types.js\";\n\n// ============================================================================\n// Types\n// ============================================================================\n\nexport interface ServerBridgeConfig {\n  /** Client EventBus to bridge */\n  eventBus: IEventBus;\n  /** Base URL for orbital server API */\n  serverUrl: string;\n  /** Events to forward from client to server */\n  forwardEvents?: string[];\n  /** Forward all events matching pattern (e.g., 'Order*', '*') */\n  forwardPattern?: string;\n  /** Target orbital for forwarded events (or 'broadcast' for all) */\n  targetOrbital?: string;\n  /** Enable WebSocket for real-time server events */\n  useWebSocket?: boolean;\n  /** Polling interval in ms (if not using WebSocket) */\n  pollInterval?: number;\n  /** Enable debug logging */\n  debug?: boolean;\n  /** Custom fetch function (for testing or custom auth) */\n  fetch?: typeof fetch;\n}\n\nexport interface ServerBridgeState {\n  connected: boolean;\n  lastError?: string;\n  eventsForwarded: number;\n  eventsReceived: number;\n}\n\n// ============================================================================\n// ServerBridge\n// ============================================================================\n\n/**\n * Bridges client EventBus with server OrbitalRuntime\n */\nexport class ServerBridge {\n  private config: ServerBridgeConfig;\n  private state: ServerBridgeState = {\n    connected: false,\n    eventsForwarded: 0,\n    eventsReceived: 0,\n  };\n  private unsubscribes: Array<() => void> = [];\n  private pollTimer?: ReturnType<typeof setInterval>;\n  private ws?: WebSocket;\n  private fetchFn: typeof fetch;\n\n  constructor(config: ServerBridgeConfig) {\n    this.config = {\n      pollInterval: 5000,\n      ...config,\n    };\n    this.fetchFn = config.fetch || fetch.bind(globalThis);\n  }\n\n  // ==========================================================================\n  // Connection Management\n  // ==========================================================================\n\n  /**\n   * Connect the bridge - start forwarding events\n   */\n  connect(): void {\n    if (this.state.connected) {\n      this.log(\"warn\", \"Already connected\");\n      return;\n    }\n\n    this.log(\"info\", \"Connecting bridge...\");\n\n    // Subscribe to events to forward\n    this.setupEventForwarding();\n\n    // Set up server -> client channel\n    if (this.config.useWebSocket) {\n      this.setupWebSocket();\n    } else if (this.config.pollInterval && this.config.pollInterval > 0) {\n      this.setupPolling();\n    }\n\n    this.state.connected = true;\n    this.log(\"info\", \"Bridge connected\");\n  }\n\n  /**\n   * Disconnect the bridge\n   */\n  disconnect(): void {\n    // Clean up event subscriptions\n    for (const unsub of this.unsubscribes) {\n      unsub();\n    }\n    this.unsubscribes = [];\n\n    // Clean up polling\n    if (this.pollTimer) {\n      clearInterval(this.pollTimer);\n      this.pollTimer = undefined;\n    }\n\n    // Clean up WebSocket\n    if (this.ws) {\n      this.ws.close();\n      this.ws = undefined;\n    }\n\n    this.state.connected = false;\n    this.log(\"info\", \"Bridge disconnected\");\n  }\n\n  /**\n   * Get current bridge state\n   */\n  getState(): ServerBridgeState {\n    return { ...this.state };\n  }\n\n  // ==========================================================================\n  // Event Forwarding (Client -> Server)\n  // ==========================================================================\n\n  private setupEventForwarding(): void {\n    const { eventBus, forwardEvents, forwardPattern } = this.config;\n\n    if (forwardEvents && forwardEvents.length > 0) {\n      // Forward specific events\n      for (const eventType of forwardEvents) {\n        const unsub = eventBus.on(eventType, (event: RuntimeEvent) => {\n          this.forwardToServer(event);\n        });\n        this.unsubscribes.push(unsub);\n      }\n    } else if (forwardPattern) {\n      // Forward events matching pattern\n      if (forwardPattern === \"*\") {\n        // Forward all events\n        const unsub = eventBus.on(\"*\", (event: RuntimeEvent) => {\n          // Don't forward internal events\n          if (\n            !event.type.startsWith(\"UI:\") &&\n            !event.type.startsWith(\"BRIDGE:\")\n          ) {\n            this.forwardToServer(event);\n          }\n        });\n        this.unsubscribes.push(unsub);\n      } else {\n        // Pattern matching (simple prefix match)\n        const prefix = forwardPattern.replace(\"*\", \"\");\n        const unsub = eventBus.on(\"*\", (event: RuntimeEvent) => {\n          if (event.type.startsWith(prefix)) {\n            this.forwardToServer(event);\n          }\n        });\n        this.unsubscribes.push(unsub);\n      }\n    }\n  }\n\n  private async forwardToServer(event: RuntimeEvent): Promise<void> {\n    const { serverUrl, targetOrbital } = this.config;\n\n    try {\n      // Determine which orbital(s) to send to\n      if (targetOrbital && targetOrbital !== \"broadcast\") {\n        // Send to specific orbital\n        await this.sendEventToOrbital(targetOrbital, event);\n      } else {\n        // Broadcast to all orbitals\n        const orbitals = await this.fetchOrbitals();\n        for (const orbital of orbitals) {\n          await this.sendEventToOrbital(orbital.name, event);\n        }\n      }\n\n      this.state.eventsForwarded++;\n      this.log(\"debug\", `Forwarded event: ${event.type}`);\n    } catch (error) {\n      this.state.lastError = String(error);\n      this.log(\"error\", `Failed to forward event: ${event.type}`, error);\n    }\n  }\n\n  private async sendEventToOrbital(\n    orbitalName: string,\n    event: RuntimeEvent,\n  ): Promise<void> {\n    const { serverUrl } = this.config;\n    const url = `${serverUrl}/${orbitalName}/events`;\n\n    const response = await this.fetchFn(url, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify({\n        event: event.type,\n        payload: event.payload,\n      }),\n    });\n\n    if (!response.ok) {\n      throw new Error(`Server returned ${response.status}`);\n    }\n\n    const result = (await response.json()) as {\n      emittedEvents?: Array<{ event: string; payload?: Record<string, unknown> }>;\n    };\n\n    // If server emitted events, put them on client EventBus\n    if (result.emittedEvents && result.emittedEvents.length > 0) {\n      for (const emitted of result.emittedEvents) {\n        this.config.eventBus.emit(`SERVER:${emitted.event}`, emitted.payload);\n        this.state.eventsReceived++;\n      }\n    }\n  }\n\n  private async fetchOrbitals(): Promise<Array<{ name: string }>> {\n    const response = await this.fetchFn(this.config.serverUrl);\n    if (!response.ok) {\n      throw new Error(`Failed to fetch orbitals: ${response.status}`);\n    }\n    const data = (await response.json()) as { orbitals?: Array<{ name: string }> };\n    return data.orbitals || [];\n  }\n\n  // ==========================================================================\n  // Server -> Client (Polling)\n  // ==========================================================================\n\n  private setupPolling(): void {\n    // For now, polling is handled by the response to forwarded events\n    // A more sophisticated implementation would poll a /events endpoint\n    this.log(\"debug\", \"Polling mode - events received via forward response\");\n  }\n\n  // ==========================================================================\n  // Server -> Client (WebSocket)\n  // ==========================================================================\n\n  private setupWebSocket(): void {\n    const { serverUrl } = this.config;\n\n    // Convert HTTP URL to WebSocket URL\n    const wsUrl = serverUrl\n      .replace(/^http:/, \"ws:\")\n      .replace(/^https:/, \"wss:\")\n      .replace(/\\/api\\/orbitals$/, \"/ws/orbitals\");\n\n    try {\n      this.ws = new WebSocket(wsUrl);\n\n      this.ws.onopen = () => {\n        this.log(\"info\", \"WebSocket connected\");\n      };\n\n      this.ws.onmessage = (msg) => {\n        try {\n          const data = JSON.parse(msg.data);\n          if (data.type === \"event\") {\n            // Server pushed an event - put it on client EventBus\n            this.config.eventBus.emit(`SERVER:${data.event}`, data.payload);\n            this.state.eventsReceived++;\n            this.log(\"debug\", `Received server event: ${data.event}`);\n          }\n        } catch (error) {\n          this.log(\"error\", \"Failed to parse WebSocket message\", error);\n        }\n      };\n\n      this.ws.onerror = (error) => {\n        this.state.lastError = \"WebSocket error\";\n        this.log(\"error\", \"WebSocket error\", error);\n      };\n\n      this.ws.onclose = () => {\n        this.log(\"info\", \"WebSocket closed\");\n        // Could implement reconnection logic here\n      };\n    } catch (error) {\n      this.log(\"error\", \"Failed to create WebSocket\", error);\n    }\n  }\n\n  // ==========================================================================\n  // Direct Methods\n  // ==========================================================================\n\n  /**\n   * Send an event directly to a specific orbital (bypassing EventBus)\n   */\n  async sendEvent(\n    orbitalName: string,\n    event: string,\n    payload?: Record<string, unknown>,\n  ): Promise<{\n    success: boolean;\n    states?: Record<string, string>;\n    emittedEvents?: Array<{ event: string; payload?: unknown }>;\n    error?: string;\n  }> {\n    const { serverUrl } = this.config;\n    const url = `${serverUrl}/${orbitalName}/events`;\n\n    try {\n      const response = await this.fetchFn(url, {\n        method: \"POST\",\n        headers: { \"Content-Type\": \"application/json\" },\n        body: JSON.stringify({ event, payload }),\n      });\n\n      return (await response.json()) as {\n        success: boolean;\n        states?: Record<string, string>;\n        emittedEvents?: Array<{ event: string; payload?: unknown }>;\n        error?: string;\n      };\n    } catch (error) {\n      return { success: false, error: String(error) };\n    }\n  }\n\n  /**\n   * Get current state of an orbital's traits\n   */\n  async getOrbitalState(orbitalName: string): Promise<{\n    success: boolean;\n    states?: Record<string, string>;\n    error?: string;\n  }> {\n    const { serverUrl } = this.config;\n    const url = `${serverUrl}/${orbitalName}`;\n\n    try {\n      const response = await this.fetchFn(url);\n      const data = (await response.json()) as {\n        success: boolean;\n        orbital?: { traits: Array<{ name: string; currentState: string }> };\n        error?: string;\n      };\n\n      if (data.success && data.orbital) {\n        const states: Record<string, string> = {};\n        for (const trait of data.orbital.traits) {\n          states[trait.name] = trait.currentState;\n        }\n        return { success: true, states };\n      }\n\n      return { success: false, error: data.error };\n    } catch (error) {\n      return { success: false, error: String(error) };\n    }\n  }\n\n  // ==========================================================================\n  // Utilities\n  // ==========================================================================\n\n  private log(\n    level: \"debug\" | \"info\" | \"warn\" | \"error\",\n    message: string,\n    data?: unknown,\n  ): void {\n    if (!this.config.debug && level === \"debug\") return;\n\n    const prefix = \"[ServerBridge]\";\n    const logFn =\n      level === \"error\"\n        ? console.error\n        : level === \"warn\"\n          ? console.warn\n          : console.log;\n    logFn(prefix, message, data !== undefined ? data : \"\");\n  }\n}\n\n/**\n * Create a ServerBridge instance\n */\nexport function createServerBridge(config: ServerBridgeConfig): ServerBridge {\n  return new ServerBridge(config);\n}\n"]}