@qontinui/ui-bridge 0.1.1 → 0.3.0

package/dist/types-CEQLnFMv.d.mts

@@ -0,0 +1,156 @@
+import { U as UIBridgeConfig } from './types-jKVgTI6_.mjs';
+import { d as ControlSnapshot, b as ControlActionRequest, c as ControlActionResponse, C as ComponentActionRequest, a as ComponentActionResponse, F as FindRequest, g as FindResponse, j as WorkflowRunRequest, k as WorkflowRunResponse } from './types-B7J7noLK.mjs';
+import { S as SearchCriteria, n as SearchResponse, N as NLActionRequest, l as NLActionResponse, d as AssertionRequest, e as AssertionResult, B as BatchAssertionRequest, g as BatchAssertionResult, t as SemanticSnapshot, p as SemanticDiff, q as SemanticSearchCriteria, r as SemanticSearchResponse } from './types-B5Q0GVo0.mjs';
+import { RenderLogEntryType, RenderLogEntry } from './render-log/index.mjs';
+
+/**
+ * UI Bridge Server Types
+ *
+ * Shared types for server adapters.
+ */
+
+/**
+ * Server configuration
+ */
+interface UIBridgeServerConfig extends UIBridgeConfig {
+    /** Base path for API routes */
+    basePath?: string;
+    /** Enable CORS */
+    cors?: boolean | CORSOptions;
+    /** Authentication middleware */
+    authenticate?: (req: unknown) => boolean | Promise<boolean>;
+    /** Rate limiting */
+    rateLimit?: RateLimitOptions;
+}
+/**
+ * CORS options
+ */
+interface CORSOptions {
+    /** Allowed origins */
+    origin?: string | string[] | boolean;
+    /** Allowed methods */
+    methods?: string[];
+    /** Allowed headers */
+    headers?: string[];
+    /** Expose headers */
+    exposeHeaders?: string[];
+    /** Allow credentials */
+    credentials?: boolean;
+    /** Max age for preflight cache */
+    maxAge?: number;
+}
+/**
+ * Rate limit options
+ */
+interface RateLimitOptions {
+    /** Time window in milliseconds */
+    windowMs?: number;
+    /** Max requests per window */
+    max?: number;
+    /** Message when rate limited */
+    message?: string;
+}
+/**
+ * API response wrapper
+ */
+interface APIResponse<T = unknown> {
+    /** Whether the request succeeded */
+    success: boolean;
+    /** Response data */
+    data?: T;
+    /** Error message if failed */
+    error?: string;
+    /** Error code */
+    code?: string;
+    /** Request timestamp */
+    timestamp: number;
+}
+/**
+ * Render log query parameters
+ */
+interface RenderLogQuery {
+    /** Filter by entry type */
+    type?: RenderLogEntryType;
+    /** Filter entries since timestamp */
+    since?: number;
+    /** Filter entries until timestamp */
+    until?: number;
+    /** Limit number of results */
+    limit?: number;
+}
+/**
+ * Server handler interface
+ *
+ * Implementations provide these handlers for different frameworks.
+ */
+interface UIBridgeServerHandlers {
+    getRenderLog: (query?: RenderLogQuery) => Promise<APIResponse<RenderLogEntry[]>>;
+    clearRenderLog: () => Promise<APIResponse<void>>;
+    captureSnapshot: () => Promise<APIResponse<unknown>>;
+    getRenderLogPath: () => Promise<APIResponse<{
+        path: string;
+    }>>;
+    getElements: () => Promise<APIResponse<ControlSnapshot['elements']>>;
+    getElement: (id: string) => Promise<APIResponse<ControlSnapshot['elements'][0]>>;
+    getElementState: (id: string) => Promise<APIResponse<unknown>>;
+    executeElementAction: (id: string, request: ControlActionRequest) => Promise<APIResponse<ControlActionResponse>>;
+    getComponents: () => Promise<APIResponse<ControlSnapshot['components']>>;
+    getComponent: (id: string) => Promise<APIResponse<ControlSnapshot['components'][0]>>;
+    getComponentState: (id: string) => Promise<APIResponse<{
+        state: Record<string, unknown>;
+        computed: Record<string, unknown>;
+        timestamp: number;
+    }>>;
+    executeComponentAction: (id: string, request: ComponentActionRequest) => Promise<APIResponse<ComponentActionResponse>>;
+    find: (request?: FindRequest) => Promise<APIResponse<FindResponse>>;
+    /**
+     * @deprecated Use find() instead
+     */
+    discover: (request?: FindRequest) => Promise<APIResponse<FindResponse>>;
+    getControlSnapshot: () => Promise<APIResponse<ControlSnapshot>>;
+    getWorkflows: () => Promise<APIResponse<ControlSnapshot['workflows']>>;
+    runWorkflow: (id: string, request?: WorkflowRunRequest) => Promise<APIResponse<WorkflowRunResponse>>;
+    getWorkflowStatus: (runId: string) => Promise<APIResponse<WorkflowRunResponse>>;
+    getActionHistory: (limit?: number) => Promise<APIResponse<unknown[]>>;
+    getMetrics: () => Promise<APIResponse<unknown>>;
+    highlightElement: (id: string) => Promise<APIResponse<void>>;
+    getElementTree: () => Promise<APIResponse<unknown>>;
+    aiSearch: (criteria: SearchCriteria) => Promise<APIResponse<SearchResponse>>;
+    aiExecute: (request: NLActionRequest) => Promise<APIResponse<NLActionResponse>>;
+    aiAssert: (request: AssertionRequest) => Promise<APIResponse<AssertionResult>>;
+    aiAssertBatch: (request: BatchAssertionRequest) => Promise<APIResponse<BatchAssertionResult>>;
+    getSemanticSnapshot: () => Promise<APIResponse<SemanticSnapshot>>;
+    getSemanticDiff: (since?: number) => Promise<APIResponse<SemanticDiff | null>>;
+    getPageSummary: () => Promise<APIResponse<string>>;
+    aiSemanticSearch: (criteria: SemanticSearchCriteria) => Promise<APIResponse<SemanticSearchResponse>>;
+}
+/**
+ * Route definition
+ */
+interface RouteDefinition {
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    path: string;
+    handler: string;
+    params?: string[];
+    bodyRequired?: boolean;
+}
+/**
+ * All UI Bridge routes
+ */
+declare const UI_BRIDGE_ROUTES: RouteDefinition[];
+/**
+ * WebSocket message types
+ */
+type WebSocketMessageType = 'subscribe' | 'unsubscribe' | 'event' | 'snapshot' | 'action' | 'error';
+/**
+ * WebSocket message
+ */
+interface WebSocketMessage<T = unknown> {
+    type: WebSocketMessageType;
+    channel?: string;
+    data?: T;
+    error?: string;
+    timestamp: number;
+}
+
+export { type APIResponse as A, type CORSOptions as C, type RateLimitOptions as R, type UIBridgeServerConfig as U, type WebSocketMessage as W, type RenderLogQuery as a, type RouteDefinition as b, type UIBridgeServerHandlers as c, UI_BRIDGE_ROUTES as d, type WebSocketMessageType as e };

package/dist/types-CHnlwiTK.d.ts

@@ -0,0 +1,156 @@
+import { U as UIBridgeConfig } from './types-jKVgTI6_.js';
+import { d as ControlSnapshot, b as ControlActionRequest, c as ControlActionResponse, C as ComponentActionRequest, a as ComponentActionResponse, F as FindRequest, g as FindResponse, j as WorkflowRunRequest, k as WorkflowRunResponse } from './types-BkNRILUa.js';
+import { S as SearchCriteria, n as SearchResponse, N as NLActionRequest, l as NLActionResponse, d as AssertionRequest, e as AssertionResult, B as BatchAssertionRequest, g as BatchAssertionResult, t as SemanticSnapshot, p as SemanticDiff, q as SemanticSearchCriteria, r as SemanticSearchResponse } from './types-DfPqwU-i.js';
+import { RenderLogEntryType, RenderLogEntry } from './render-log/index.js';
+
+/**
+ * UI Bridge Server Types
+ *
+ * Shared types for server adapters.
+ */
+
+/**
+ * Server configuration
+ */
+interface UIBridgeServerConfig extends UIBridgeConfig {
+    /** Base path for API routes */
+    basePath?: string;
+    /** Enable CORS */
+    cors?: boolean | CORSOptions;
+    /** Authentication middleware */
+    authenticate?: (req: unknown) => boolean | Promise<boolean>;
+    /** Rate limiting */
+    rateLimit?: RateLimitOptions;
+}
+/**
+ * CORS options
+ */
+interface CORSOptions {
+    /** Allowed origins */
+    origin?: string | string[] | boolean;
+    /** Allowed methods */
+    methods?: string[];
+    /** Allowed headers */
+    headers?: string[];
+    /** Expose headers */
+    exposeHeaders?: string[];
+    /** Allow credentials */
+    credentials?: boolean;
+    /** Max age for preflight cache */
+    maxAge?: number;
+}
+/**
+ * Rate limit options
+ */
+interface RateLimitOptions {
+    /** Time window in milliseconds */
+    windowMs?: number;
+    /** Max requests per window */
+    max?: number;
+    /** Message when rate limited */
+    message?: string;
+}
+/**
+ * API response wrapper
+ */
+interface APIResponse<T = unknown> {
+    /** Whether the request succeeded */
+    success: boolean;
+    /** Response data */
+    data?: T;
+    /** Error message if failed */
+    error?: string;
+    /** Error code */
+    code?: string;
+    /** Request timestamp */
+    timestamp: number;
+}
+/**
+ * Render log query parameters
+ */
+interface RenderLogQuery {
+    /** Filter by entry type */
+    type?: RenderLogEntryType;
+    /** Filter entries since timestamp */
+    since?: number;
+    /** Filter entries until timestamp */
+    until?: number;
+    /** Limit number of results */
+    limit?: number;
+}
+/**
+ * Server handler interface
+ *
+ * Implementations provide these handlers for different frameworks.
+ */
+interface UIBridgeServerHandlers {
+    getRenderLog: (query?: RenderLogQuery) => Promise<APIResponse<RenderLogEntry[]>>;
+    clearRenderLog: () => Promise<APIResponse<void>>;
+    captureSnapshot: () => Promise<APIResponse<unknown>>;
+    getRenderLogPath: () => Promise<APIResponse<{
+        path: string;
+    }>>;
+    getElements: () => Promise<APIResponse<ControlSnapshot['elements']>>;
+    getElement: (id: string) => Promise<APIResponse<ControlSnapshot['elements'][0]>>;
+    getElementState: (id: string) => Promise<APIResponse<unknown>>;
+    executeElementAction: (id: string, request: ControlActionRequest) => Promise<APIResponse<ControlActionResponse>>;
+    getComponents: () => Promise<APIResponse<ControlSnapshot['components']>>;
+    getComponent: (id: string) => Promise<APIResponse<ControlSnapshot['components'][0]>>;
+    getComponentState: (id: string) => Promise<APIResponse<{
+        state: Record<string, unknown>;
+        computed: Record<string, unknown>;
+        timestamp: number;
+    }>>;
+    executeComponentAction: (id: string, request: ComponentActionRequest) => Promise<APIResponse<ComponentActionResponse>>;
+    find: (request?: FindRequest) => Promise<APIResponse<FindResponse>>;
+    /**
+     * @deprecated Use find() instead
+     */
+    discover: (request?: FindRequest) => Promise<APIResponse<FindResponse>>;
+    getControlSnapshot: () => Promise<APIResponse<ControlSnapshot>>;
+    getWorkflows: () => Promise<APIResponse<ControlSnapshot['workflows']>>;
+    runWorkflow: (id: string, request?: WorkflowRunRequest) => Promise<APIResponse<WorkflowRunResponse>>;
+    getWorkflowStatus: (runId: string) => Promise<APIResponse<WorkflowRunResponse>>;
+    getActionHistory: (limit?: number) => Promise<APIResponse<unknown[]>>;
+    getMetrics: () => Promise<APIResponse<unknown>>;
+    highlightElement: (id: string) => Promise<APIResponse<void>>;
+    getElementTree: () => Promise<APIResponse<unknown>>;
+    aiSearch: (criteria: SearchCriteria) => Promise<APIResponse<SearchResponse>>;
+    aiExecute: (request: NLActionRequest) => Promise<APIResponse<NLActionResponse>>;
+    aiAssert: (request: AssertionRequest) => Promise<APIResponse<AssertionResult>>;
+    aiAssertBatch: (request: BatchAssertionRequest) => Promise<APIResponse<BatchAssertionResult>>;
+    getSemanticSnapshot: () => Promise<APIResponse<SemanticSnapshot>>;
+    getSemanticDiff: (since?: number) => Promise<APIResponse<SemanticDiff | null>>;
+    getPageSummary: () => Promise<APIResponse<string>>;
+    aiSemanticSearch: (criteria: SemanticSearchCriteria) => Promise<APIResponse<SemanticSearchResponse>>;
+}
+/**
+ * Route definition
+ */
+interface RouteDefinition {
+    method: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+    path: string;
+    handler: string;
+    params?: string[];
+    bodyRequired?: boolean;
+}
+/**
+ * All UI Bridge routes
+ */
+declare const UI_BRIDGE_ROUTES: RouteDefinition[];
+/**
+ * WebSocket message types
+ */
+type WebSocketMessageType = 'subscribe' | 'unsubscribe' | 'event' | 'snapshot' | 'action' | 'error';
+/**
+ * WebSocket message
+ */
+interface WebSocketMessage<T = unknown> {
+    type: WebSocketMessageType;
+    channel?: string;
+    data?: T;
+    error?: string;
+    timestamp: number;
+}
+
+export { type APIResponse as A, type CORSOptions as C, type RateLimitOptions as R, type UIBridgeServerConfig as U, type WebSocketMessage as W, type RenderLogQuery as a, type RouteDefinition as b, type UIBridgeServerHandlers as c, UI_BRIDGE_ROUTES as d, type WebSocketMessageType as e };