@roj-ai/transport 0.0.2

package/dist/index.js

@@ -0,0 +1,26 @@
+/**
+ * @roj-ai/transport
+ *
+ * Platform-agnostic WebSocket transport infrastructure with RPC-like protocol API.
+ */
+// ============================================================================
+// Core Exports
+// ============================================================================
+// Protocol Definition API
+export { defineProtocol, method, notification } from './core/protocol.js';
+// Result Type
+export { Err, flatMapResult, isErr, isOk, mapResult, Ok, unwrapOr, unwrapOrThrow } from './core/result.js';
+export { DEFAULT_RECONNECT_OPTIONS } from './core/types.js';
+// Core Components
+export { createRouter, MessageRouter } from './core/router.js';
+export { Connection } from './core/connection.js';
+export { WebSocketReadyState } from './platform/types.js';
+// ============================================================================
+// Client Exports
+// ============================================================================
+export { ClientConnection, createClientConnection } from './client/client-connection.js';
+// ============================================================================
+// Server Exports
+// ============================================================================
+export { createServerConnection, ServerConnection } from './server/server-connection.js';
+export { ConnectionManager } from './server/connection-manager.js';

package/dist/platform/browser.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Browser WebSocket Adapter
+ *
+ * Wraps the native browser WebSocket to conform to IWebSocket interface.
+ */
+import type { ICloseEvent, IWebSocket, IWebSocketFactory } from './types.js';
+import { WebSocketReadyState } from './types.js';
+/**
+ * Browser WebSocket factory.
+ */
+export declare const browserWebSocketFactory: IWebSocketFactory;
+export { WebSocketReadyState };
+export type { ICloseEvent, IWebSocket, IWebSocketFactory };
+//# sourceMappingURL=browser.d.ts.map

package/dist/platform/browser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../../src/platform/browser.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAA;AAC5E,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AA4DhD;;GAEG;AACH,eAAO,MAAM,uBAAuB,EAAE,iBAIrC,CAAA;AAGD,OAAO,EAAE,mBAAmB,EAAE,CAAA;AAC9B,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,iBAAiB,EAAE,CAAA"}

package/dist/platform/browser.js

@@ -0,0 +1,65 @@
+/**
+ * Browser WebSocket Adapter
+ *
+ * Wraps the native browser WebSocket to conform to IWebSocket interface.
+ */
+import { WebSocketReadyState } from './types.js';
+/**
+ * Browser WebSocket adapter that wraps native WebSocket.
+ */
+class BrowserWebSocketAdapter {
+    ws;
+    onopen = null;
+    onclose = null;
+    onerror = null;
+    onmessage = null;
+    constructor(url) {
+        this.ws = new WebSocket(url);
+        this.ws.onopen = () => {
+            this.onopen?.();
+        };
+        this.ws.onclose = (event) => {
+            this.onclose?.({
+                code: event.code,
+                reason: event.reason,
+            });
+        };
+        this.ws.onerror = () => {
+            // Browser WebSocket doesn't provide error details
+            this.onerror?.(new Error('WebSocket error'));
+        };
+        this.ws.onmessage = (event) => {
+            // Handle text data only
+            if (typeof event.data === 'string') {
+                this.onmessage?.(event.data);
+            }
+            else if (event.data instanceof Blob) {
+                // Convert Blob to string for text-only protocol
+                event.data.text().then((text) => {
+                    this.onmessage?.(text);
+                });
+            }
+        };
+    }
+    get readyState() {
+        return this.ws.readyState;
+    }
+    send(data) {
+        if (this.ws.readyState === WebSocketReadyState.OPEN) {
+            this.ws.send(data);
+        }
+    }
+    close(code, reason) {
+        this.ws.close(code, reason);
+    }
+}
+/**
+ * Browser WebSocket factory.
+ */
+export const browserWebSocketFactory = {
+    create(url) {
+        return new BrowserWebSocketAdapter(url);
+    },
+};
+// Re-export types for convenience
+export { WebSocketReadyState };

package/dist/platform/bun.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Bun WebSocket Adapters
+ *
+ * Provides both client and server WebSocket adapters for Bun runtime.
+ */
+import type { ICloseEvent, IServerWebSocket, IWebSocket, IWebSocketFactory } from './types.js';
+import { WebSocketReadyState } from './types.js';
+/**
+ * Bun WebSocket client factory.
+ */
+export declare const bunWebSocketFactory: IWebSocketFactory;
+/**
+ * Server WebSocket data interface.
+ */
+export interface ServerWebSocketData<T = unknown> {
+    /** User-attached data */
+    userData: T;
+    /** Topics this connection is subscribed to */
+    topics: Set<string>;
+}
+type BunServerWebSocket = any;
+/**
+ * Bun server WebSocket adapter.
+ * Wraps Bun's ServerWebSocket to conform to IServerWebSocket interface.
+ */
+export declare class BunServerWebSocketAdapter<T = unknown> implements IServerWebSocket<T> {
+    private readonly ws;
+    private wsData;
+    onopen: (() => void) | null;
+    onclose: ((event: ICloseEvent) => void) | null;
+    onerror: ((error: Error) => void) | null;
+    onmessage: ((data: string) => void) | null;
+    constructor(ws: BunServerWebSocket, data: T);
+    get data(): T;
+    set data(value: T);
+    get readyState(): WebSocketReadyState;
+    send(data: string): void;
+    close(code?: number, reason?: string): void;
+    subscribe(topic: string): void;
+    unsubscribe(topic: string): void;
+    publish(topic: string, message: string): void;
+    isSubscribed(topic: string): boolean;
+    /**
+     * Get the underlying Bun WebSocket (for advanced use cases).
+     */
+    getRawWebSocket(): BunServerWebSocket;
+}
+/**
+ * Helper to create Bun WebSocket handlers that integrate with the transport layer.
+ */
+export interface BunWebSocketHandlers<T> {
+    open: (ws: BunServerWebSocket) => void;
+    close: (ws: BunServerWebSocket, code: number, reason: string) => void;
+    message: (ws: BunServerWebSocket, message: string | Buffer) => void;
+    error: (ws: BunServerWebSocket, error: Error) => void;
+}
+/**
+ * Create Bun WebSocket handlers with adapter integration.
+ */
+export declare function createBunWebSocketHandlers<T>(callbacks: {
+    onOpen: (ws: IServerWebSocket<T>) => void;
+    onClose: (ws: IServerWebSocket<T>, code: number, reason: string) => void;
+    onMessage: (ws: IServerWebSocket<T>, message: string) => void;
+    onError: (ws: IServerWebSocket<T>, error: Error) => void;
+    getData: (ws: BunServerWebSocket) => T;
+}): BunWebSocketHandlers<T>;
+export { WebSocketReadyState };
+export type { ICloseEvent, IServerWebSocket, IWebSocket, IWebSocketFactory };
+//# sourceMappingURL=bun.d.ts.map

package/dist/platform/bun.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bun.d.ts","sourceRoot":"","sources":["../../src/platform/bun.ts"],"names":[],"mappings":"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"}

package/dist/platform/bun.js

@@ -0,0 +1,152 @@
+/**
+ * Bun WebSocket Adapters
+ *
+ * Provides both client and server WebSocket adapters for Bun runtime.
+ */
+import { WebSocketReadyState } from './types.js';
+/**
+ * Bun WebSocket client adapter.
+ * Wraps Bun's WebSocket client to conform to IWebSocket interface.
+ */
+class BunWebSocketClientAdapter {
+    ws;
+    onopen = null;
+    onclose = null;
+    onerror = null;
+    onmessage = null;
+    constructor(url) {
+        this.ws = new WebSocket(url);
+        this.ws.onopen = () => {
+            this.onopen?.();
+        };
+        this.ws.onclose = (event) => {
+            this.onclose?.({
+                code: event.code,
+                reason: event.reason,
+            });
+        };
+        this.ws.onerror = () => {
+            this.onerror?.(new Error('WebSocket error'));
+        };
+        this.ws.onmessage = (event) => {
+            if (typeof event.data === 'string') {
+                this.onmessage?.(event.data);
+            }
+        };
+    }
+    get readyState() {
+        return this.ws.readyState;
+    }
+    send(data) {
+        if (this.ws.readyState === WebSocketReadyState.OPEN) {
+            this.ws.send(data);
+        }
+    }
+    close(code, reason) {
+        this.ws.close(code, reason);
+    }
+}
+/**
+ * Bun WebSocket client factory.
+ */
+export const bunWebSocketFactory = {
+    create(url) {
+        return new BunWebSocketClientAdapter(url);
+    },
+};
+/**
+ * Bun server WebSocket adapter.
+ * Wraps Bun's ServerWebSocket to conform to IServerWebSocket interface.
+ */
+export class BunServerWebSocketAdapter {
+    ws;
+    wsData;
+    onopen = null;
+    onclose = null;
+    onerror = null;
+    onmessage = null;
+    constructor(ws, data) {
+        this.ws = ws;
+        this.wsData = {
+            userData: data,
+            topics: new Set(),
+        };
+    }
+    get data() {
+        return this.wsData.userData;
+    }
+    set data(value) {
+        this.wsData.userData = value;
+    }
+    get readyState() {
+        return this.ws.readyState;
+    }
+    send(data) {
+        if (this.ws.readyState === WebSocketReadyState.OPEN) {
+            this.ws.send(data);
+        }
+    }
+    close(code, reason) {
+        this.ws.close(code, reason);
+    }
+    subscribe(topic) {
+        this.ws.subscribe(topic);
+        this.wsData.topics.add(topic);
+    }
+    unsubscribe(topic) {
+        this.ws.unsubscribe(topic);
+        this.wsData.topics.delete(topic);
+    }
+    publish(topic, message) {
+        this.ws.publish(topic, message);
+    }
+    isSubscribed(topic) {
+        return this.wsData.topics.has(topic);
+    }
+    /**
+     * Get the underlying Bun WebSocket (for advanced use cases).
+     */
+    getRawWebSocket() {
+        return this.ws;
+    }
+}
+/**
+ * Create Bun WebSocket handlers with adapter integration.
+ */
+export function createBunWebSocketHandlers(callbacks) {
+    // Map to store adapter instances
+    const adapters = new WeakMap();
+    const getOrCreateAdapter = (ws) => {
+        let adapter = adapters.get(ws);
+        if (!adapter) {
+            adapter = new BunServerWebSocketAdapter(ws, callbacks.getData(ws));
+            adapters.set(ws, adapter);
+        }
+        return adapter;
+    };
+    return {
+        open(ws) {
+            const adapter = getOrCreateAdapter(ws);
+            callbacks.onOpen(adapter);
+        },
+        close(ws, code, reason) {
+            const adapter = adapters.get(ws);
+            if (adapter) {
+                callbacks.onClose(adapter, code, reason);
+                adapters.delete(ws);
+            }
+        },
+        message(ws, message) {
+            const adapter = getOrCreateAdapter(ws);
+            // Convert Buffer to string if needed
+            const data = typeof message === 'string' ? message : message.toString('utf-8');
+            callbacks.onMessage(adapter, data);
+        },
+        error(ws, error) {
+            const adapter = getOrCreateAdapter(ws);
+            callbacks.onError(adapter, error);
+        },
+    };
+}
+// Re-export types for convenience
+export { WebSocketReadyState };

package/dist/platform/types.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Platform Abstraction Types
+ *
+ * Common interfaces for WebSocket implementations across platforms (browser + Bun).
+ */
+/**
+ * WebSocket ready state values.
+ */
+export declare const WebSocketReadyState: {
+    readonly CONNECTING: 0;
+    readonly OPEN: 1;
+    readonly CLOSING: 2;
+    readonly CLOSED: 3;
+};
+export type WebSocketReadyState = (typeof WebSocketReadyState)[keyof typeof WebSocketReadyState];
+/**
+ * Close event structure.
+ */
+export interface ICloseEvent {
+    code: number;
+    reason: string;
+}
+/**
+ * Platform-agnostic WebSocket interface.
+ */
+export interface IWebSocket {
+    /** Current ready state */
+    readonly readyState: WebSocketReadyState;
+    /** Send a text message */
+    send(data: string): void;
+    /** Close the connection */
+    close(code?: number, reason?: string): void;
+    /** Called when connection opens */
+    onopen: (() => void) | null;
+    /** Called when connection closes */
+    onclose: ((event: ICloseEvent) => void) | null;
+    /** Called on error */
+    onerror: ((error: Error) => void) | null;
+    /** Called when a message is received */
+    onmessage: ((data: string) => void) | null;
+}
+/**
+ * Factory for creating WebSocket client connections.
+ */
+export interface IWebSocketFactory {
+    /** Create a new WebSocket connection to the given URL */
+    create(url: string): IWebSocket;
+}
+/**
+ * Server-side WebSocket interface (for handling incoming connections).
+ * Extended from IWebSocket with server-specific capabilities.
+ */
+export interface IServerWebSocket<T = unknown> extends IWebSocket {
+    /** Attached data for this connection */
+    data: T;
+    /** Subscribe to a topic for pub/sub messaging */
+    subscribe(topic: string): void;
+    /** Unsubscribe from a topic */
+    unsubscribe(topic: string): void;
+    /** Publish to a topic (message sent to all subscribers except sender) */
+    publish(topic: string, message: string): void;
+    /** Check if subscribed to a topic */
+    isSubscribed(topic: string): boolean;
+}
+/**
+ * WebSocket server upgrade request data.
+ */
+export interface IUpgradeData<T = unknown> {
+    /** Data to attach to the WebSocket connection */
+    data: T;
+}
+/**
+ * WebSocket server interface for handling multiple connections.
+ */
+export interface IWebSocketServer<T = unknown> {
+    /** Handle WebSocket upgrade from HTTP request */
+    upgrade(request: Request, data: T): boolean;
+    /** Publish to all connections subscribed to a topic */
+    publish(topic: string, message: string): void;
+    /** Get all active connections */
+    getConnections(): Iterable<IServerWebSocket<T>>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/platform/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/platform/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;CAKtB,CAAA;AAEV,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,OAAO,mBAAmB,CAAC,CAAA;AAEhG;;GAEG;AACH,MAAM,WAAW,WAAW;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IAC1B,0BAA0B;IAC1B,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAA;IAExC,0BAA0B;IAC1B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IAExB,2BAA2B;IAC3B,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAE3C,mCAAmC;IACnC,MAAM,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,CAAA;IAE3B,oCAAoC;IACpC,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC,GAAG,IAAI,CAAA;IAE9C,sBAAsB;IACtB,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC,GAAG,IAAI,CAAA;IAExC,wCAAwC;IACxC,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,IAAI,CAAA;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,yDAAyD;IACzD,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAAA;CAC/B;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,OAAO,CAAE,SAAQ,UAAU;IAChE,wCAAwC;IACxC,IAAI,EAAE,CAAC,CAAA;IAEP,iDAAiD;IACjD,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAE9B,+BAA+B;IAC/B,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAEhC,yEAAyE;IACzE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAE7C,qCAAqC;IACrC,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAA;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,OAAO;IACxC,iDAAiD;IACjD,IAAI,EAAE,CAAC,CAAA;CACP;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,OAAO;IAC5C,iDAAiD;IACjD,OAAO,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,GAAG,OAAO,CAAA;IAE3C,uDAAuD;IACvD,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAE7C,iCAAiC;IACjC,cAAc,IAAI,QAAQ,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAA;CAC/C"}

package/dist/platform/types.js

@@ -0,0 +1,14 @@
+/**
+ * Platform Abstraction Types
+ *
+ * Common interfaces for WebSocket implementations across platforms (browser + Bun).
+ */
+/**
+ * WebSocket ready state values.
+ */
+export const WebSocketReadyState = {
+    CONNECTING: 0,
+    OPEN: 1,
+    CLOSING: 2,
+    CLOSED: 3,
+};

package/dist/server/connection-manager.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Connection Manager
+ *
+ * Manages multiple WebSocket connections and session subscriptions.
+ */
+import type { ProtocolDef } from '../core/protocol.js';
+import type { ServerConnection } from './server-connection.js';
+/**
+ * Connection statistics.
+ */
+export interface ConnectionStats {
+    /** Total number of connections */
+    totalConnections: number;
+    /** Number of active (connected) connections */
+    activeConnections: number;
+    /** Number of unique sessions with subscribers */
+    activeSessions: number;
+    /** Connections by client type */
+    byClientType: Record<string, number>;
+}
+/**
+ * Manages multiple server connections and session subscriptions.
+ *
+ * Features:
+ * - Track all active connections
+ * - Manage session subscriptions
+ * - Broadcast to subscribed connections
+ * - Connection statistics
+ */
+export declare class ConnectionManager<TReceive extends ProtocolDef = ProtocolDef, TSend extends ProtocolDef = ProtocolDef> {
+    private connections;
+    private sessionSubscriptions;
+    /**
+     * Add a connection.
+     */
+    add(connection: ServerConnection<TReceive, TSend>): void;
+    /**
+     * Remove a connection.
+     */
+    remove(connectionId: string): void;
+    /**
+     * Get a connection by ID.
+     */
+    get(connectionId: string): ServerConnection<TReceive, TSend> | undefined;
+    /**
+     * Check if a connection exists.
+     */
+    has(connectionId: string): boolean;
+    /**
+     * Get all connections.
+     */
+    getAll(): Iterable<ServerConnection<TReceive, TSend>>;
+    /**
+     * Get all connection IDs.
+     */
+    getAllIds(): Iterable<string>;
+    /**
+     * Get connection count.
+     */
+    get size(): number;
+    /**
+     * Subscribe a connection to a session.
+     */
+    subscribe(connectionId: string, sessionId: string): boolean;
+    /**
+     * Unsubscribe a connection from a session.
+     */
+    unsubscribe(connectionId: string, sessionId: string): boolean;
+    /**
+     * Get all subscribers for a session.
+     */
+    getSubscribers(sessionId: string): ServerConnection<TReceive, TSend>[];
+    /**
+     * Get subscriber count for a session.
+     */
+    getSubscriberCount(sessionId: string): number;
+    /**
+     * Check if a session has any subscribers.
+     */
+    hasSubscribers(sessionId: string): boolean;
+    /**
+     * Broadcast a raw message to all subscribers of a session.
+     */
+    broadcast(sessionId: string, message: string): number;
+    /**
+     * Broadcast to all connections.
+     */
+    broadcastToAll(message: string): number;
+    /**
+     * Get connection statistics.
+     */
+    getStats(): ConnectionStats;
+    /**
+     * Clear all connections.
+     */
+    clear(): void;
+    /**
+     * Remove disconnected connections.
+     */
+    cleanup(): number;
+    /**
+     * Internal unsubscribe (updates subscription map only).
+     */
+    private unsubscribeInternal;
+}
+//# sourceMappingURL=connection-manager.d.ts.map

package/dist/server/connection-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-manager.d.ts","sourceRoot":"","sources":["../../src/server/connection-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAM9D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B,kCAAkC;IAClC,gBAAgB,EAAE,MAAM,CAAA;IACxB,+CAA+C;IAC/C,iBAAiB,EAAE,MAAM,CAAA;IACzB,iDAAiD;IACjD,cAAc,EAAE,MAAM,CAAA;IACtB,iCAAiC;IACjC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACpC;AAMD;;;;;;;;GAQG;AACH,qBAAa,iBAAiB,CAC7B,QAAQ,SAAS,WAAW,GAAG,WAAW,EAC1C,KAAK,SAAS,WAAW,GAAG,WAAW;IAEvC,OAAO,CAAC,WAAW,CAAuD;IAC1E,OAAO,CAAC,oBAAoB,CAAiC;IAM7D;;OAEG;IACH,GAAG,CAAC,UAAU,EAAE,gBAAgB,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,IAAI;IAIxD;;OAEG;IACH,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI;IAYlC;;OAEG;IACH,GAAG,CAAC,YAAY,EAAE,MAAM,GAAG,gBAAgB,CAAC,QAAQ,EAAE,KAAK,CAAC,GAAG,SAAS;IAIxE;;OAEG;IACH,GAAG,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO;IAIlC;;OAEG;IACH,MAAM,IAAI,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAIrD;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,MAAM,CAAC;IAI7B;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAMD;;OAEG;IACH,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;IAgB3D;;OAEG;IACH,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO;IAU7D;;OAEG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE;IA0BtE;;OAEG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAI7C;;OAEG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAQ1C;;OAEG;IACH,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM;IAarD;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAgBvC;;OAEG;IACH,QAAQ,IAAI,eAAe;IAyB3B;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,OAAO,IAAI,MAAM;IAiBjB;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAS3B"}