@qontinui/ui-bridge 0.2.0 → 0.3.1

package/dist/native/server/index.mjs

@@ -0,0 +1,435 @@
+// src/native/server/types.ts
+var UI_BRIDGE_NATIVE_ROUTES = {
+  // Control - Elements
+  GET_ELEMENTS: {
+    method: "GET",
+    path: "/ui-bridge/control/elements",
+    description: "List all registered elements"
+  },
+  GET_ELEMENT: {
+    method: "GET",
+    path: "/ui-bridge/control/element/:id",
+    description: "Get element details"
+  },
+  GET_ELEMENT_STATE: {
+    method: "GET",
+    path: "/ui-bridge/control/element/:id/state",
+    description: "Get element state"
+  },
+  EXECUTE_ACTION: {
+    method: "POST",
+    path: "/ui-bridge/control/element/:id/action",
+    description: "Execute action on element"
+  },
+  // Control - Components
+  GET_COMPONENTS: {
+    method: "GET",
+    path: "/ui-bridge/control/components",
+    description: "List all registered components"
+  },
+  GET_COMPONENT: {
+    method: "GET",
+    path: "/ui-bridge/control/component/:id",
+    description: "Get component details"
+  },
+  EXECUTE_COMPONENT_ACTION: {
+    method: "POST",
+    path: "/ui-bridge/control/component/:id/action/:actionId",
+    description: "Execute component action"
+  },
+  // Discovery
+  FIND: {
+    method: "POST",
+    path: "/ui-bridge/control/find",
+    description: "Find elements matching criteria"
+  },
+  GET_SNAPSHOT: {
+    method: "GET",
+    path: "/ui-bridge/control/snapshot",
+    description: "Get full bridge snapshot"
+  },
+  // Workflows
+  GET_WORKFLOWS: {
+    method: "GET",
+    path: "/ui-bridge/control/workflows",
+    description: "List all workflows"
+  },
+  RUN_WORKFLOW: {
+    method: "POST",
+    path: "/ui-bridge/control/workflow/:id/run",
+    description: "Run a workflow"
+  },
+  // Page Navigation
+  PAGE_REFRESH: {
+    method: "POST",
+    path: "/ui-bridge/control/page/refresh",
+    description: "Refresh the current page"
+  },
+  PAGE_NAVIGATE: {
+    method: "POST",
+    path: "/ui-bridge/control/page/navigate",
+    description: "Navigate to a URL"
+  },
+  PAGE_GO_BACK: {
+    method: "POST",
+    path: "/ui-bridge/control/page/back",
+    description: "Go back in navigation history"
+  },
+  PAGE_GO_FORWARD: {
+    method: "POST",
+    path: "/ui-bridge/control/page/forward",
+    description: "Go forward in navigation history"
+  },
+  // Health
+  HEALTH: {
+    method: "GET",
+    path: "/ui-bridge/health",
+    description: "Health check"
+  }
+};
+
+// src/native/server/handlers.ts
+function success(data) {
+  return {
+    success: true,
+    data,
+    timestamp: Date.now()
+  };
+}
+function error(message, code) {
+  return {
+    success: false,
+    error: message,
+    code,
+    timestamp: Date.now()
+  };
+}
+function createServerHandlers(registry, executor) {
+  return {
+    // Elements
+    getElements: async () => {
+      const elements = registry.getAllElements().map((e) => ({
+        id: e.id,
+        type: e.type,
+        label: e.label,
+        identifier: e.getIdentifier(),
+        state: e.getState(),
+        actions: e.actions,
+        customActions: e.customActions ? Object.keys(e.customActions) : void 0
+      }));
+      return success({ elements });
+    },
+    getElement: async (ctx) => {
+      const { id } = ctx.params;
+      const element = registry.getElement(id);
+      if (!element) {
+        return error(`Element not found: ${id}`, "ELEMENT_NOT_FOUND");
+      }
+      return success({
+        element: {
+          id: element.id,
+          type: element.type,
+          label: element.label,
+          identifier: element.getIdentifier(),
+          state: element.getState(),
+          actions: element.actions,
+          customActions: element.customActions ? Object.keys(element.customActions) : void 0
+        }
+      });
+    },
+    getElementState: async (ctx) => {
+      const { id } = ctx.params;
+      const element = registry.getElement(id);
+      if (!element) {
+        return error(`Element not found: ${id}`, "ELEMENT_NOT_FOUND");
+      }
+      return success({ state: element.getState() });
+    },
+    executeAction: async (ctx) => {
+      const { id } = ctx.params;
+      const body = ctx.body;
+      if (!body?.action) {
+        return error("Action is required", "INVALID_REQUEST");
+      }
+      const response = await executor.executeAction(id, {
+        action: body.action,
+        params: body.params,
+        waitOptions: body.waitOptions
+      });
+      if (!response.success) {
+        return error(response.error || "Action failed", "ACTION_FAILED");
+      }
+      return success(response);
+    },
+    // Components
+    getComponents: async () => {
+      const components = registry.getAllComponents().map((c) => ({
+        id: c.id,
+        name: c.name,
+        description: c.description,
+        actions: c.actions.map((a) => ({ id: a.id, label: a.label })),
+        elementIds: c.elementIds
+      }));
+      return success({ components });
+    },
+    getComponent: async (ctx) => {
+      const { id } = ctx.params;
+      const component = registry.getComponent(id);
+      if (!component) {
+        return error(`Component not found: ${id}`, "COMPONENT_NOT_FOUND");
+      }
+      return success({
+        component: {
+          id: component.id,
+          name: component.name,
+          description: component.description,
+          actions: component.actions.map((a) => ({
+            id: a.id,
+            label: a.label,
+            description: a.description
+          })),
+          elementIds: component.elementIds
+        }
+      });
+    },
+    executeComponentAction: async (ctx) => {
+      const { id, actionId } = ctx.params;
+      const body = ctx.body;
+      const response = await executor.executeComponentAction(id, {
+        action: actionId,
+        params: body?.params
+      });
+      if (!response.success) {
+        return error(response.error || "Action failed", "ACTION_FAILED");
+      }
+      return success(response);
+    },
+    // Discovery
+    find: async (ctx) => {
+      const body = ctx.body;
+      const response = await executor.find({
+        types: body?.types,
+        testIdPattern: body?.testIdPattern,
+        accessibilityLabelPattern: body?.accessibilityLabelPattern,
+        visibleOnly: body?.visibleOnly,
+        limit: body?.limit
+      });
+      return success(response);
+    },
+    getSnapshot: async () => {
+      const snapshot = registry.createSnapshot();
+      return success(snapshot);
+    },
+    // Workflows
+    getWorkflows: async () => {
+      const workflows = registry.getAllWorkflows().map((w) => ({
+        id: w.id,
+        name: w.name,
+        description: w.description,
+        stepCount: w.steps.length
+      }));
+      return success({ workflows });
+    },
+    runWorkflow: async (ctx) => {
+      const { id } = ctx.params;
+      const workflow = registry.getWorkflow(id);
+      if (!workflow) {
+        return error(`Workflow not found: ${id}`, "WORKFLOW_NOT_FOUND");
+      }
+      return success({
+        runId: `run-${Date.now()}`,
+        status: "pending"
+      });
+    },
+    // Page Navigation (stubs — React Native apps should override with their navigation provider)
+    pageRefresh: async () => {
+      return error("Page refresh not supported on native platform", "NOT_SUPPORTED");
+    },
+    pageNavigate: async () => {
+      return error("Page navigation not supported on native platform", "NOT_SUPPORTED");
+    },
+    pageGoBack: async () => {
+      return error("Page go back not supported on native platform", "NOT_SUPPORTED");
+    },
+    pageGoForward: async () => {
+      return error("Page go forward not supported on native platform", "NOT_SUPPORTED");
+    },
+    // Health
+    health: async () => {
+      const stats = registry.getStats();
+      return success({
+        status: "healthy",
+        timestamp: Date.now(),
+        ...stats
+      });
+    }
+  };
+}
+
+// src/native/server/http-server.ts
+var NativeUIBridgeServer = class {
+  constructor(registry, executor, config = {}) {
+    this.registry = registry;
+    this.executor = executor;
+    this.running = false;
+    this.config = {
+      serverPort: 9876,
+      cors: true,
+      ...config
+    };
+    this.handlers = createServerHandlers(registry, executor);
+  }
+  /**
+   * Set the server adapter
+   */
+  setAdapter(adapter) {
+    this.adapter = adapter;
+  }
+  /**
+   * Start the HTTP server
+   */
+  async start() {
+    if (this.running) {
+      console.warn("[ui-bridge-native] Server already running");
+      return;
+    }
+    if (!this.adapter) {
+      console.warn("[ui-bridge-native] No server adapter configured. Call setAdapter() first.");
+      console.warn("[ui-bridge-native] See documentation for supported adapters.");
+      return;
+    }
+    await this.adapter.start(this.config.serverPort, this.handleRequest.bind(this));
+    this.running = true;
+    console.log(`[ui-bridge-native] HTTP server started on port ${this.config.serverPort}`);
+  }
+  /**
+   * Stop the HTTP server
+   */
+  async stop() {
+    if (!this.running || !this.adapter) {
+      return;
+    }
+    await this.adapter.stop();
+    this.running = false;
+    console.log("[ui-bridge-native] HTTP server stopped");
+  }
+  /**
+   * Check if server is running
+   */
+  isRunning() {
+    return this.running;
+  }
+  /**
+   * Handle incoming HTTP request
+   */
+  async handleRequest(request) {
+    const headers = {
+      "Content-Type": "application/json"
+    };
+    if (this.config.cors) {
+      headers["Access-Control-Allow-Origin"] = this.config.allowedOrigins ? this.config.allowedOrigins.join(",") : "*";
+      headers["Access-Control-Allow-Methods"] = "GET, POST, PUT, DELETE, OPTIONS";
+      headers["Access-Control-Allow-Headers"] = "Content-Type, Authorization";
+    }
+    if (request.method === "OPTIONS") {
+      return { status: 204, headers, body: "" };
+    }
+    try {
+      const response = await this.routeRequest(request);
+      return {
+        status: response.success ? 200 : 400,
+        headers,
+        body: JSON.stringify(response)
+      };
+    } catch (error2) {
+      const errorResponse = {
+        success: false,
+        error: error2 instanceof Error ? error2.message : "Internal server error",
+        code: "INTERNAL_ERROR",
+        timestamp: Date.now()
+      };
+      return {
+        status: 500,
+        headers,
+        body: JSON.stringify(errorResponse)
+      };
+    }
+  }
+  /**
+   * Route request to appropriate handler
+   */
+  async routeRequest(request) {
+    const { method, path, query, body } = request;
+    const parsePath = (pattern, actual) => {
+      const patternParts = pattern.split("/");
+      const actualParts = actual.split("/");
+      if (patternParts.length !== actualParts.length) {
+        return null;
+      }
+      const params2 = {};
+      for (let i = 0; i < patternParts.length; i++) {
+        if (patternParts[i].startsWith(":")) {
+          params2[patternParts[i].slice(1)] = actualParts[i];
+        } else if (patternParts[i] !== actualParts[i]) {
+          return null;
+        }
+      }
+      return params2;
+    };
+    if (method === "GET" && path === "/ui-bridge/health") {
+      return this.handlers.health({ params: {}, query, body });
+    }
+    if (method === "GET" && path === "/ui-bridge/control/elements") {
+      return this.handlers.getElements({ params: {}, query, body });
+    }
+    let params = parsePath("/ui-bridge/control/element/:id", path);
+    if (method === "GET" && params) {
+      return this.handlers.getElement({ params, query, body });
+    }
+    params = parsePath("/ui-bridge/control/element/:id/state", path);
+    if (method === "GET" && params) {
+      return this.handlers.getElementState({ params, query, body });
+    }
+    params = parsePath("/ui-bridge/control/element/:id/action", path);
+    if (method === "POST" && params) {
+      return this.handlers.executeAction({ params, query, body });
+    }
+    if (method === "GET" && path === "/ui-bridge/control/components") {
+      return this.handlers.getComponents({ params: {}, query, body });
+    }
+    params = parsePath("/ui-bridge/control/component/:id", path);
+    if (method === "GET" && params) {
+      return this.handlers.getComponent({ params, query, body });
+    }
+    params = parsePath("/ui-bridge/control/component/:id/action/:actionId", path);
+    if (method === "POST" && params) {
+      return this.handlers.executeComponentAction({ params, query, body });
+    }
+    if (method === "POST" && path === "/ui-bridge/control/find") {
+      return this.handlers.find({ params: {}, query, body });
+    }
+    if (method === "GET" && path === "/ui-bridge/control/snapshot") {
+      return this.handlers.getSnapshot({ params: {}, query, body });
+    }
+    if (method === "GET" && path === "/ui-bridge/control/workflows") {
+      return this.handlers.getWorkflows({ params: {}, query, body });
+    }
+    params = parsePath("/ui-bridge/control/workflow/:id/run", path);
+    if (method === "POST" && params) {
+      return this.handlers.runWorkflow({ params, query, body });
+    }
+    return {
+      success: false,
+      error: `Route not found: ${method} ${path}`,
+      code: "NOT_FOUND",
+      timestamp: Date.now()
+    };
+  }
+};
+function createNativeServer(registry, executor, config) {
+  return new NativeUIBridgeServer(registry, executor, config);
+}
+
+export { NativeUIBridgeServer, UI_BRIDGE_NATIVE_ROUTES, createNativeServer, createServerHandlers };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/native/server/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/native/server/types.ts","../../../src/native/server/handlers.ts","../../../src/native/server/http-server.ts"],"names":["error","params"],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * UI Bridge Native Server Types\n *\n * Types for the embedded HTTP server.\n */\n\nimport type {\n  NativeUIBridgeConfig,\n  NativeActionResponse,\n  NativeFindResponse,\n  NativeBridgeSnapshot,\n} from '../core/types';\nimport type { ComponentActionResponse, PageNavigationResponse } from '../control/types';\n\n/**\n * Server configuration\n */\nexport interface NativeServerConfig extends NativeUIBridgeConfig {\n  /** Enable CORS */\n  cors?: boolean;\n  /** Allowed origins for CORS */\n  allowedOrigins?: string[];\n}\n\n/**\n * Route definition\n */\nexport interface RouteDefinition {\n  method: 'GET' | 'POST' | 'PUT' | 'DELETE';\n  path: string;\n  description: string;\n}\n\n/**\n * All UI Bridge Native routes\n */\nexport const UI_BRIDGE_NATIVE_ROUTES: Record<string, RouteDefinition> = {\n  // Control - Elements\n  GET_ELEMENTS: {\n    method: 'GET',\n    path: '/ui-bridge/control/elements',\n    description: 'List all registered elements',\n  },\n  GET_ELEMENT: {\n    method: 'GET',\n    path: '/ui-bridge/control/element/:id',\n    description: 'Get element details',\n  },\n  GET_ELEMENT_STATE: {\n    method: 'GET',\n    path: '/ui-bridge/control/element/:id/state',\n    description: 'Get element state',\n  },\n  EXECUTE_ACTION: {\n    method: 'POST',\n    path: '/ui-bridge/control/element/:id/action',\n    description: 'Execute action on element',\n  },\n\n  // Control - Components\n  GET_COMPONENTS: {\n    method: 'GET',\n    path: '/ui-bridge/control/components',\n    description: 'List all registered components',\n  },\n  GET_COMPONENT: {\n    method: 'GET',\n    path: '/ui-bridge/control/component/:id',\n    description: 'Get component details',\n  },\n  EXECUTE_COMPONENT_ACTION: {\n    method: 'POST',\n    path: '/ui-bridge/control/component/:id/action/:actionId',\n    description: 'Execute component action',\n  },\n\n  // Discovery\n  FIND: {\n    method: 'POST',\n    path: '/ui-bridge/control/find',\n    description: 'Find elements matching criteria',\n  },\n  GET_SNAPSHOT: {\n    method: 'GET',\n    path: '/ui-bridge/control/snapshot',\n    description: 'Get full bridge snapshot',\n  },\n\n  // Workflows\n  GET_WORKFLOWS: {\n    method: 'GET',\n    path: '/ui-bridge/control/workflows',\n    description: 'List all workflows',\n  },\n  RUN_WORKFLOW: {\n    method: 'POST',\n    path: '/ui-bridge/control/workflow/:id/run',\n    description: 'Run a workflow',\n  },\n\n  // Page Navigation\n  PAGE_REFRESH: {\n    method: 'POST',\n    path: '/ui-bridge/control/page/refresh',\n    description: 'Refresh the current page',\n  },\n  PAGE_NAVIGATE: {\n    method: 'POST',\n    path: '/ui-bridge/control/page/navigate',\n    description: 'Navigate to a URL',\n  },\n  PAGE_GO_BACK: {\n    method: 'POST',\n    path: '/ui-bridge/control/page/back',\n    description: 'Go back in navigation history',\n  },\n  PAGE_GO_FORWARD: {\n    method: 'POST',\n    path: '/ui-bridge/control/page/forward',\n    description: 'Go forward in navigation history',\n  },\n\n  // Health\n  HEALTH: {\n    method: 'GET',\n    path: '/ui-bridge/health',\n    description: 'Health check',\n  },\n};\n\n/**\n * API response wrapper\n */\nexport interface APIResponse<T = unknown> {\n  success: boolean;\n  data?: T;\n  error?: string;\n  code?: string;\n  timestamp: number;\n}\n\n/**\n * Handler context\n */\nexport interface HandlerContext {\n  params: Record<string, string>;\n  query: Record<string, string>;\n  body: unknown;\n}\n\n/**\n * Handler function type\n */\nexport type HandlerFunction<T = unknown> = (context: HandlerContext) => Promise<APIResponse<T>>;\n\n/**\n * Server handlers interface\n */\nexport interface NativeServerHandlers {\n  // Elements\n  getElements: HandlerFunction<{ elements: unknown[] }>;\n  getElement: HandlerFunction<{ element: unknown }>;\n  getElementState: HandlerFunction<{ state: unknown }>;\n  executeAction: HandlerFunction<NativeActionResponse>;\n\n  // Components\n  getComponents: HandlerFunction<{ components: unknown[] }>;\n  getComponent: HandlerFunction<{ component: unknown }>;\n  executeComponentAction: HandlerFunction<ComponentActionResponse>;\n\n  // Discovery\n  find: HandlerFunction<NativeFindResponse>;\n  getSnapshot: HandlerFunction<NativeBridgeSnapshot>;\n\n  // Workflows\n  getWorkflows: HandlerFunction<{ workflows: unknown[] }>;\n  runWorkflow: HandlerFunction<{ runId: string; status: string }>;\n\n  // Page Navigation\n  pageRefresh: HandlerFunction<PageNavigationResponse>;\n  pageNavigate: HandlerFunction<PageNavigationResponse>;\n  pageGoBack: HandlerFunction<PageNavigationResponse>;\n  pageGoForward: HandlerFunction<PageNavigationResponse>;\n\n  // Health\n  health: HandlerFunction<{ status: string; timestamp: number }>;\n}\n","/**\n * UI Bridge Native Server Handlers\n *\n * Request handlers for the HTTP API endpoints.\n */\n\nimport type { NativeUIBridgeRegistry } from '../core/registry';\nimport type { NativeActionExecutor } from '../control/types';\nimport type { APIResponse, HandlerContext, NativeServerHandlers } from './types';\n\n/**\n * Create a success response\n */\nfunction success<T>(data: T): APIResponse<T> {\n  return {\n    success: true,\n    data,\n    timestamp: Date.now(),\n  };\n}\n\n/**\n * Create an error response\n */\nfunction error<T = unknown>(message: string, code?: string): APIResponse<T> {\n  return {\n    success: false,\n    error: message,\n    code,\n    timestamp: Date.now(),\n  };\n}\n\n/**\n * Create server handlers\n */\nexport function createServerHandlers(\n  registry: NativeUIBridgeRegistry,\n  executor: NativeActionExecutor\n): NativeServerHandlers {\n  return {\n    // Elements\n    getElements: async () => {\n      const elements = registry.getAllElements().map((e) => ({\n        id: e.id,\n        type: e.type,\n        label: e.label,\n        identifier: e.getIdentifier(),\n        state: e.getState(),\n        actions: e.actions,\n        customActions: e.customActions ? Object.keys(e.customActions) : undefined,\n      }));\n\n      return success({ elements });\n    },\n\n    getElement: async (ctx: HandlerContext) => {\n      const { id } = ctx.params;\n      const element = registry.getElement(id);\n\n      if (!element) {\n        return error(`Element not found: ${id}`, 'ELEMENT_NOT_FOUND');\n      }\n\n      return success({\n        element: {\n          id: element.id,\n          type: element.type,\n          label: element.label,\n          identifier: element.getIdentifier(),\n          state: element.getState(),\n          actions: element.actions,\n          customActions: element.customActions ? Object.keys(element.customActions) : undefined,\n        },\n      });\n    },\n\n    getElementState: async (ctx: HandlerContext) => {\n      const { id } = ctx.params;\n      const element = registry.getElement(id);\n\n      if (!element) {\n        return error(`Element not found: ${id}`, 'ELEMENT_NOT_FOUND');\n      }\n\n      return success({ state: element.getState() });\n    },\n\n    executeAction: async (ctx: HandlerContext) => {\n      const { id } = ctx.params;\n      const body = ctx.body as {\n        action: string;\n        params?: Record<string, unknown>;\n        waitOptions?: Record<string, unknown>;\n      };\n\n      if (!body?.action) {\n        return error('Action is required', 'INVALID_REQUEST');\n      }\n\n      const response = await executor.executeAction(id, {\n        action: body.action,\n        params: body.params,\n        waitOptions: body.waitOptions as any,\n      });\n\n      if (!response.success) {\n        return error(response.error || 'Action failed', 'ACTION_FAILED');\n      }\n\n      return success(response);\n    },\n\n    // Components\n    getComponents: async () => {\n      const components = registry.getAllComponents().map((c) => ({\n        id: c.id,\n        name: c.name,\n        description: c.description,\n        actions: c.actions.map((a) => ({ id: a.id, label: a.label })),\n        elementIds: c.elementIds,\n      }));\n\n      return success({ components });\n    },\n\n    getComponent: async (ctx: HandlerContext) => {\n      const { id } = ctx.params;\n      const component = registry.getComponent(id);\n\n      if (!component) {\n        return error(`Component not found: ${id}`, 'COMPONENT_NOT_FOUND');\n      }\n\n      return success({\n        component: {\n          id: component.id,\n          name: component.name,\n          description: component.description,\n          actions: component.actions.map((a) => ({\n            id: a.id,\n            label: a.label,\n            description: a.description,\n          })),\n          elementIds: component.elementIds,\n        },\n      });\n    },\n\n    executeComponentAction: async (ctx: HandlerContext) => {\n      const { id, actionId } = ctx.params;\n      const body = ctx.body as { params?: Record<string, unknown> };\n\n      const response = await executor.executeComponentAction(id, {\n        action: actionId,\n        params: body?.params,\n      });\n\n      if (!response.success) {\n        return error(response.error || 'Action failed', 'ACTION_FAILED');\n      }\n\n      return success(response);\n    },\n\n    // Discovery\n    find: async (ctx: HandlerContext) => {\n      const body = ctx.body as {\n        types?: string[];\n        testIdPattern?: string;\n        accessibilityLabelPattern?: string;\n        visibleOnly?: boolean;\n        limit?: number;\n      };\n\n      const response = await executor.find({\n        types: body?.types as any,\n        testIdPattern: body?.testIdPattern,\n        accessibilityLabelPattern: body?.accessibilityLabelPattern,\n        visibleOnly: body?.visibleOnly,\n        limit: body?.limit,\n      });\n\n      return success(response);\n    },\n\n    getSnapshot: async () => {\n      const snapshot = registry.createSnapshot();\n      return success(snapshot);\n    },\n\n    // Workflows\n    getWorkflows: async () => {\n      const workflows = registry.getAllWorkflows().map((w) => ({\n        id: w.id,\n        name: w.name,\n        description: w.description,\n        stepCount: w.steps.length,\n      }));\n\n      return success({ workflows });\n    },\n\n    runWorkflow: async (ctx: HandlerContext) => {\n      const { id } = ctx.params;\n      const workflow = registry.getWorkflow(id);\n\n      if (!workflow) {\n        return error(`Workflow not found: ${id}`, 'WORKFLOW_NOT_FOUND');\n      }\n\n      // TODO: Implement workflow execution\n      return success({\n        runId: `run-${Date.now()}`,\n        status: 'pending',\n      });\n    },\n\n    // Page Navigation (stubs — React Native apps should override with their navigation provider)\n    pageRefresh: async () => {\n      return error('Page refresh not supported on native platform', 'NOT_SUPPORTED');\n    },\n\n    pageNavigate: async () => {\n      return error('Page navigation not supported on native platform', 'NOT_SUPPORTED');\n    },\n\n    pageGoBack: async () => {\n      return error('Page go back not supported on native platform', 'NOT_SUPPORTED');\n    },\n\n    pageGoForward: async () => {\n      return error('Page go forward not supported on native platform', 'NOT_SUPPORTED');\n    },\n\n    // Health\n    health: async () => {\n      const stats = registry.getStats();\n      return success({\n        status: 'healthy',\n        timestamp: Date.now(),\n        ...stats,\n      });\n    },\n  };\n}\n","/**\n * UI Bridge Native HTTP Server\n *\n * Abstract HTTP server implementation for React Native.\n * This provides a framework-agnostic server interface that can be\n * implemented using various React Native HTTP server libraries.\n *\n * Supported libraries:\n * - react-native-http-bridge (recommended)\n * - @aspect/react-native-http-server\n * - Custom implementations\n */\n\nimport type { NativeUIBridgeRegistry } from '../core/registry';\nimport type { NativeActionExecutor } from '../control/types';\nimport type { NativeServerConfig, NativeServerHandlers, APIResponse } from './types';\nimport { createServerHandlers } from './handlers';\n\n/**\n * HTTP Request interface (library-agnostic)\n */\nexport interface HTTPRequest {\n  method: string;\n  path: string;\n  headers: Record<string, string>;\n  query: Record<string, string>;\n  body?: unknown;\n}\n\n/**\n * HTTP Response interface (library-agnostic)\n */\nexport interface HTTPResponse {\n  status: number;\n  headers: Record<string, string>;\n  body: string;\n}\n\n/**\n * Request handler type\n */\nexport type RequestHandler = (request: HTTPRequest) => Promise<HTTPResponse>;\n\n/**\n * Server adapter interface\n *\n * Implement this interface to integrate with your chosen HTTP server library.\n */\nexport interface ServerAdapter {\n  /** Start the server */\n  start(port: number, handler: RequestHandler): Promise<void>;\n  /** Stop the server */\n  stop(): Promise<void>;\n  /** Check if server is running */\n  isRunning(): boolean;\n}\n\n/**\n * Native UI Bridge HTTP Server\n */\nexport class NativeUIBridgeServer {\n  private config: NativeServerConfig;\n  private handlers: NativeServerHandlers;\n  private adapter?: ServerAdapter;\n  private running = false;\n\n  constructor(\n    private registry: NativeUIBridgeRegistry,\n    private executor: NativeActionExecutor,\n    config: NativeServerConfig = {}\n  ) {\n    this.config = {\n      serverPort: 9876,\n      cors: true,\n      ...config,\n    };\n    this.handlers = createServerHandlers(registry, executor);\n  }\n\n  /**\n   * Set the server adapter\n   */\n  setAdapter(adapter: ServerAdapter): void {\n    this.adapter = adapter;\n  }\n\n  /**\n   * Start the HTTP server\n   */\n  async start(): Promise<void> {\n    if (this.running) {\n      console.warn('[ui-bridge-native] Server already running');\n      return;\n    }\n\n    if (!this.adapter) {\n      console.warn('[ui-bridge-native] No server adapter configured. Call setAdapter() first.');\n      console.warn('[ui-bridge-native] See documentation for supported adapters.');\n      return;\n    }\n\n    await this.adapter.start(this.config.serverPort!, this.handleRequest.bind(this));\n    this.running = true;\n\n    console.log(`[ui-bridge-native] HTTP server started on port ${this.config.serverPort}`);\n  }\n\n  /**\n   * Stop the HTTP server\n   */\n  async stop(): Promise<void> {\n    if (!this.running || !this.adapter) {\n      return;\n    }\n\n    await this.adapter.stop();\n    this.running = false;\n\n    console.log('[ui-bridge-native] HTTP server stopped');\n  }\n\n  /**\n   * Check if server is running\n   */\n  isRunning(): boolean {\n    return this.running;\n  }\n\n  /**\n   * Handle incoming HTTP request\n   */\n  private async handleRequest(request: HTTPRequest): Promise<HTTPResponse> {\n    // Add CORS headers if enabled\n    const headers: Record<string, string> = {\n      'Content-Type': 'application/json',\n    };\n\n    if (this.config.cors) {\n      headers['Access-Control-Allow-Origin'] = this.config.allowedOrigins\n        ? this.config.allowedOrigins.join(',')\n        : '*';\n      headers['Access-Control-Allow-Methods'] = 'GET, POST, PUT, DELETE, OPTIONS';\n      headers['Access-Control-Allow-Headers'] = 'Content-Type, Authorization';\n    }\n\n    // Handle CORS preflight\n    if (request.method === 'OPTIONS') {\n      return { status: 204, headers, body: '' };\n    }\n\n    try {\n      const response = await this.routeRequest(request);\n      return {\n        status: response.success ? 200 : 400,\n        headers,\n        body: JSON.stringify(response),\n      };\n    } catch (error) {\n      const errorResponse: APIResponse = {\n        success: false,\n        error: error instanceof Error ? error.message : 'Internal server error',\n        code: 'INTERNAL_ERROR',\n        timestamp: Date.now(),\n      };\n      return {\n        status: 500,\n        headers,\n        body: JSON.stringify(errorResponse),\n      };\n    }\n  }\n\n  /**\n   * Route request to appropriate handler\n   */\n  private async routeRequest(request: HTTPRequest): Promise<APIResponse> {\n    const { method, path, query, body } = request;\n\n    // Parse path parameters\n    const parsePath = (pattern: string, actual: string): Record<string, string> | null => {\n      const patternParts = pattern.split('/');\n      const actualParts = actual.split('/');\n\n      if (patternParts.length !== actualParts.length) {\n        return null;\n      }\n\n      const params: Record<string, string> = {};\n\n      for (let i = 0; i < patternParts.length; i++) {\n        if (patternParts[i].startsWith(':')) {\n          params[patternParts[i].slice(1)] = actualParts[i];\n        } else if (patternParts[i] !== actualParts[i]) {\n          return null;\n        }\n      }\n\n      return params;\n    };\n\n    // Health check\n    if (method === 'GET' && path === '/ui-bridge/health') {\n      return this.handlers.health({ params: {}, query, body });\n    }\n\n    // Elements\n    if (method === 'GET' && path === '/ui-bridge/control/elements') {\n      return this.handlers.getElements({ params: {}, query, body });\n    }\n\n    let params = parsePath('/ui-bridge/control/element/:id', path);\n    if (method === 'GET' && params) {\n      return this.handlers.getElement({ params, query, body });\n    }\n\n    params = parsePath('/ui-bridge/control/element/:id/state', path);\n    if (method === 'GET' && params) {\n      return this.handlers.getElementState({ params, query, body });\n    }\n\n    params = parsePath('/ui-bridge/control/element/:id/action', path);\n    if (method === 'POST' && params) {\n      return this.handlers.executeAction({ params, query, body });\n    }\n\n    // Components\n    if (method === 'GET' && path === '/ui-bridge/control/components') {\n      return this.handlers.getComponents({ params: {}, query, body });\n    }\n\n    params = parsePath('/ui-bridge/control/component/:id', path);\n    if (method === 'GET' && params) {\n      return this.handlers.getComponent({ params, query, body });\n    }\n\n    params = parsePath('/ui-bridge/control/component/:id/action/:actionId', path);\n    if (method === 'POST' && params) {\n      return this.handlers.executeComponentAction({ params, query, body });\n    }\n\n    // Discovery\n    if (method === 'POST' && path === '/ui-bridge/control/find') {\n      return this.handlers.find({ params: {}, query, body });\n    }\n\n    if (method === 'GET' && path === '/ui-bridge/control/snapshot') {\n      return this.handlers.getSnapshot({ params: {}, query, body });\n    }\n\n    // Workflows\n    if (method === 'GET' && path === '/ui-bridge/control/workflows') {\n      return this.handlers.getWorkflows({ params: {}, query, body });\n    }\n\n    params = parsePath('/ui-bridge/control/workflow/:id/run', path);\n    if (method === 'POST' && params) {\n      return this.handlers.runWorkflow({ params, query, body });\n    }\n\n    // Not found\n    return {\n      success: false,\n      error: `Route not found: ${method} ${path}`,\n      code: 'NOT_FOUND',\n      timestamp: Date.now(),\n    };\n  }\n}\n\n/**\n * Create a UI Bridge Native server\n */\nexport function createNativeServer(\n  registry: NativeUIBridgeRegistry,\n  executor: NativeActionExecutor,\n  config?: NativeServerConfig\n): NativeUIBridgeServer {\n  return new NativeUIBridgeServer(registry, executor, config);\n}\n\n/**\n * Example adapter using react-native-http-bridge\n *\n * To use this adapter:\n * 1. Install: npm install react-native-http-bridge\n * 2. Link native modules\n * 3. Create adapter and pass to server\n *\n * ```tsx\n * import httpBridge from 'react-native-http-bridge';\n *\n * const adapter: ServerAdapter = {\n *   start: async (port, handler) => {\n *     httpBridge.start(port, 'ui-bridge', async (request) => {\n *       const response = await handler({\n *         method: request.type,\n *         path: request.url,\n *         headers: request.headers || {},\n *         query: parseQuery(request.url),\n *         body: request.postData ? JSON.parse(request.postData) : undefined,\n *       });\n *       httpBridge.respond(\n *         request.requestId,\n *         response.status,\n *         response.headers['Content-Type'],\n *         response.body\n *       );\n *     });\n *   },\n *   stop: async () => {\n *     httpBridge.stop();\n *   },\n *   isRunning: () => true,\n * };\n *\n * server.setAdapter(adapter);\n * await server.start();\n * ```\n */\n"]}