@nurama/sdk 0.0.0-stage → 1.4.0

package/dist/routes/socket.js

@@ -0,0 +1,555 @@
+/* eslint-disable no-console */
+/**
+ * Listener-set keys that the built-in socket handlers bound in connect()/
+ * connectPublic() dispatch to directly (rather than via a subscribe()-bound
+ * `socket.on`). When re-establishing subscriptions after an in-place reconnect
+ * these must be repopulated on the new connection's listener set, NOT re-run
+ * through subscribe() — doing so would bind a second `socket.on` dispatcher and
+ * fire each callback twice.
+ */
+const LIFECYCLE_LISTENER_EVENTS = new Set([
+    'disconnect',
+    'tokenExpired',
+    'tokenBlacklisted',
+    'reconnect_failed',
+    'reconnect',
+]);
+export default function createSocketMethods(client) {
+    // Track active socket connections
+    const activeConnections = {};
+    // Extract configuration from client
+    const debug = client.debug;
+    /**
+     * Log helper for socket-related messages
+     */
+    const _log = (...args) => {
+        if (debug) {
+            console.log('[SOCKET]', ...args);
+        }
+    };
+    // We'll need to dynamically import socket.io-client since it's not available in all environments
+    const getSocketIO = async () => {
+        try {
+            // Handle different versions of socket.io-client
+            const socketModule = await import('socket.io-client');
+            // Socket.io 4.x exports the io function directly
+            return socketModule.default || socketModule;
+        }
+        catch (error) {
+            throw new Error('socket.io-client is not installed. Please install it with: npm install socket.io-client');
+        }
+    };
+    /**
+     * Get an authentication token for WebSocket connection.
+     * Returns the long-lived API key when the client is in bot mode, otherwise the JWT.
+     */
+    const getAuthToken = () => {
+        return client._apiKey || client._getAccessToken();
+    };
+    /** True when the client is authenticating with a bot API key. */
+    const isApiKeyMode = () => Boolean(client._apiKey);
+    /**
+     * Get the WebSocket server URL
+     *
+     * Priority:
+     * 1. Connection-specific websocketURL (from options)
+     * 2. Client-level websocketURL (from client options)
+     * 3. Use the baseURL directly - Socket.IO handles protocol conversion
+     */
+    const getWebSocketURL = (connectionOptions) => {
+        // 1. Check connection-specific override
+        if (connectionOptions?.websocketURL) {
+            return connectionOptions.websocketURL;
+        }
+        // 2. Check client-level websocketURL
+        if (client.websocketURL) {
+            return client.websocketURL;
+        }
+        // 3. Use baseURL directly - Socket.IO handles protocol conversion
+        return client.baseURL;
+    };
+    /**
+     * Connect to a socket channel
+     * @param channel Channel path to connect to (e.g., '/user/123')
+     * @param options Socket connection options
+     * @returns Promise that resolves with the socket channel
+     */
+    const connect = async (channel, options = {}) => {
+        _log(`Connecting to channel: ${channel}`);
+        // Default options
+        const socketOptions = {
+            autoRefresh: true,
+            autoReconnect: true,
+            autoReconnectOnTokenExpiry: true,
+            debug: client.debug,
+            ...options
+        };
+        // Check if already connected
+        if (activeConnections[channel]) {
+            _log(`Already connected to channel: ${channel}`);
+            return activeConnections[channel];
+        }
+        // Get access token
+        const token = getAuthToken();
+        if (!token) {
+            throw new Error('Authentication required. Please login first.');
+        }
+        // Get WebSocket URL using the helper function - no protocol conversion needed
+        const wsUrl = getWebSocketURL(options);
+        _log(`Using Socket.IO URL: ${wsUrl}`);
+        // Dynamically import socket.io-client
+        const io = await getSocketIO();
+        // Create socket connection with enhanced reconnection configuration
+        const socket = io(`${wsUrl}${channel}`, {
+            query: { token },
+            // Reconnection configuration for resilience
+            reconnection: socketOptions.autoReconnect,
+            reconnectionAttempts: 10, // Maximum reconnection attempts before giving up
+            reconnectionDelay: 1000, // Start with 1 second delay
+            reconnectionDelayMax: 30000, // Max delay of 30 seconds between attempts
+            randomizationFactor: 0.5, // Add jitter to avoid thundering herd problem
+            // Connection timeout
+            timeout: 20000, // 20 seconds to establish initial connection
+            // Transport configuration
+            transports: ['websocket', 'polling'], // Prefer WebSocket, fallback to polling
+            upgrade: true, // Allow transport upgrade
+            rememberUpgrade: true, // Remember successful upgrade
+            // Ping/pong for connection health
+            forceNew: false, // Reuse existing connection if available
+        });
+        // Create channel object
+        const socketChannel = {
+            socket,
+            channel,
+            listeners: {},
+        };
+        // Store connection immediately so subscribers can register socket.on handlers
+        // even before the connection is fully established. Socket.io preserves
+        // handlers across reconnections, so they will fire once connected.
+        activeConnections[channel] = socketChannel;
+        // Setup event listeners
+        return new Promise((resolve, reject) => {
+            let settled = false;
+            // Handle connection (initial or after reconnection)
+            socket.on('connect', () => {
+                _log(`Connected to channel: ${channel}`);
+                activeConnections[channel] = socketChannel;
+                if (!settled) {
+                    settled = true;
+                    resolve(socketChannel);
+                }
+            });
+            // Handle connection error — log but let socket.io retry
+            socket.on('connect_error', (error) => {
+                _log(`Connection error for channel ${channel}:`, error);
+                // Don't reject — socket.io's auto-reconnect will keep trying
+                // Resolve the promise so callers aren't blocked — subscriptions
+                // registered via socket.on will fire once the connection succeeds
+                if (!settled) {
+                    settled = true;
+                    resolve(socketChannel);
+                }
+            });
+            // Handle reconnection attempts
+            socket.on('reconnect_attempt', (attempt) => {
+                _log(`Reconnection attempt ${attempt} for channel: ${channel}`);
+            });
+            // Handle successful reconnection
+            socket.on('reconnect', (attempt) => {
+                _log(`Reconnected to channel ${channel} after ${attempt} attempts`);
+                // Ensure activeConnections is up to date after reconnect
+                activeConnections[channel] = socketChannel;
+                // Notify app-level onReconnect listeners so they can REST-refetch any
+                // gap of server->client messages missed while the transport was down
+                // (socket.io has no replay across a reconnect).
+                const reconnectListeners = socketChannel.listeners['reconnect'] || new Set();
+                reconnectListeners.forEach(listener => listener({ type: 'reconnect', attempt }));
+            });
+            // Handle reconnection failure — only reject when socket.io gives up entirely
+            socket.on('reconnect_failed', () => {
+                _log(`Reconnection failed for channel ${channel} after maximum attempts`);
+                // Emit to listeners for UI feedback
+                const eventListeners = socketChannel.listeners['reconnect_failed'] || new Set();
+                eventListeners.forEach(listener => listener({ type: 'reconnect_failed' }));
+                if (!settled) {
+                    settled = true;
+                    reject(new Error(`Connection to ${channel} failed after maximum reconnection attempts`));
+                }
+            });
+            // Handle token events
+            socket.on('tokenEvent', (event) => {
+                _log(`Token event on channel ${channel}:`, event);
+                if (event === 'TokenExpired' && socketOptions.autoReconnectOnTokenExpiry) {
+                    // API keys don't expire client-side; if the server emits TokenExpired
+                    // for a bot, treat it as terminal — there's nothing to refresh.
+                    if (isApiKeyMode()) {
+                        _log('Token expired event in API key mode — disconnecting (no refresh path)');
+                        disconnect(channel);
+                        const eventListeners = socketChannel.listeners['tokenExpired'] || new Set();
+                        eventListeners.forEach(listener => listener({ type: 'tokenExpired' }));
+                        return;
+                    }
+                    // Refresh token and reconnect
+                    _log('Token expired, attempting to refresh and reconnect');
+                    // Call the client's _refreshToken method (using 'as any' for TypeScript)
+                    client._refreshToken()
+                        .then(() => {
+                        _log('Token refreshed, reconnecting');
+                        // Preserve event subscriptions across the reconnect. connect()
+                        // builds a brand-new socket whose listeners map starts empty, so
+                        // without re-binding these the channel reconnects but silently
+                        // stops delivering 'notification' events — the app-level
+                        // subscription is lost until a full page reload. This fires on the
+                        // server's token-expiry sweep (~every 30 min for a long-lived
+                        // session), so the reconnect must carry the subscriptions over.
+                        const preservedListeners = socketChannel.listeners;
+                        disconnect(channel)
+                            .then(() => connect(channel, options))
+                            .then((newConnection) => {
+                            Object.entries(preservedListeners).forEach(([listenerEvent, callbacks]) => {
+                                callbacks.forEach((callback) => {
+                                    if (LIFECYCLE_LISTENER_EVENTS.has(listenerEvent)) {
+                                        // Built-in handlers on the fresh socket already dispatch
+                                        // these; just repopulate the set they read from.
+                                        if (!newConnection.listeners[listenerEvent]) {
+                                            newConnection.listeners[listenerEvent] = new Set();
+                                        }
+                                        newConnection.listeners[listenerEvent].add(callback);
+                                    }
+                                    else {
+                                        subscribe(channel, listenerEvent, callback);
+                                    }
+                                });
+                            });
+                            // The fresh socket fired 'connect', not 'reconnect', so notify
+                            // onReconnect listeners here too — a token-refresh reconnect is
+                            // still a gap that needs the same REST catch-up.
+                            (newConnection.listeners['reconnect'] || new Set()).forEach(listener => listener({ type: 'reconnect', reason: 'tokenRefresh' }));
+                        })
+                            .catch((error) => {
+                            _log(`Failed to re-establish subscriptions after token refresh on ${channel}:`, error);
+                        });
+                    })
+                        .catch((error) => {
+                        _log('Failed to refresh token', error);
+                        // Emit disconnect event to listeners
+                        const eventListeners = socketChannel.listeners['tokenExpired'] || new Set();
+                        eventListeners.forEach(listener => listener({ type: 'tokenExpired', error }));
+                    });
+                }
+                else if (event === 'tokenBlacklisted') {
+                    // Force disconnect
+                    _log('Token blacklisted, disconnecting');
+                    disconnect(channel);
+                    // Emit disconnect event to listeners
+                    const eventListeners = socketChannel.listeners['tokenBlacklisted'] || new Set();
+                    eventListeners.forEach(listener => listener({ type: 'tokenBlacklisted' }));
+                }
+            });
+            // Handle disconnect
+            socket.on('disconnect', (reason) => {
+                _log(`Disconnected from channel ${channel}:`, reason);
+                // Emit disconnect event to listeners
+                const eventListeners = socketChannel.listeners['disconnect'] || new Set();
+                eventListeners.forEach(listener => listener({ type: 'disconnect', reason }));
+                // Remove from active connections
+                delete activeConnections[channel];
+            });
+        });
+    };
+    /**
+     * Connect to a public socket channel without authentication
+     * @param publicToken Public file system token (10-character alphanumeric)
+     * @param options Socket connection options
+     * @returns Promise that resolves with the socket channel
+     */
+    const connectPublic = async (publicToken, options = {}) => {
+        const channel = `public/${publicToken}`;
+        _log(`Connecting to public channel: ${channel}`);
+        // Default options
+        const socketOptions = {
+            autoReconnect: true,
+            debug: client.debug,
+            ...options
+        };
+        // Check if already connected
+        if (activeConnections[channel]) {
+            _log(`Already connected to public channel: ${channel}`);
+            return activeConnections[channel];
+        }
+        // Get WebSocket URL using the helper function
+        const wsUrl = getWebSocketURL(options);
+        _log(`Using Socket.IO URL for public connection: ${wsUrl}`);
+        // Dynamically import socket.io-client
+        const io = await getSocketIO();
+        // Create socket connection - no token needed for public channels
+        const socket = io(`${wsUrl}${channel}`, {
+            query: { publicToken },
+            // Reconnection configuration for resilience
+            reconnection: socketOptions.autoReconnect,
+            reconnectionAttempts: 10,
+            reconnectionDelay: 1000,
+            reconnectionDelayMax: 30000,
+            randomizationFactor: 0.5,
+            // Connection timeout
+            timeout: 20000,
+            // Transport configuration
+            transports: ['websocket', 'polling'],
+            upgrade: true,
+            rememberUpgrade: true,
+            forceNew: false,
+        });
+        // Create channel object
+        const socketChannel = {
+            socket,
+            channel,
+            listeners: {},
+        };
+        // Setup event listeners
+        return new Promise((resolve, reject) => {
+            // Handle connection
+            socket.on('connect', () => {
+                _log(`Connected to public channel: ${channel}`);
+                activeConnections[channel] = socketChannel;
+                resolve(socketChannel);
+            });
+            // Handle connection error
+            socket.on('connect_error', (error) => {
+                _log(`Connection error for public channel ${channel}:`, error);
+                reject(error);
+            });
+            // Handle reconnection attempts
+            socket.on('reconnect_attempt', (attempt) => {
+                _log(`Reconnection attempt ${attempt} for public channel: ${channel}`);
+            });
+            // Handle successful reconnection
+            socket.on('reconnect', (attempt) => {
+                _log(`Reconnected to public channel ${channel} after ${attempt} attempts`);
+            });
+            // Handle reconnection failure
+            socket.on('reconnect_failed', () => {
+                _log(`Reconnection failed for public channel ${channel} after maximum attempts`);
+                const eventListeners = socketChannel.listeners['reconnect_failed'] || new Set();
+                eventListeners.forEach(listener => listener({ type: 'reconnect_failed' }));
+            });
+            // Handle disconnect
+            socket.on('disconnect', (reason) => {
+                _log(`Disconnected from public channel ${channel}:`, reason);
+                // Emit disconnect event to listeners
+                const eventListeners = socketChannel.listeners['disconnect'] || new Set();
+                eventListeners.forEach(listener => listener({ type: 'disconnect', reason }));
+                // Remove from active connections
+                delete activeConnections[channel];
+            });
+        });
+    };
+    /**
+     * Disconnect from a socket channel
+     * @param channel Channel to disconnect from
+     */
+    const disconnect = async (channel) => {
+        const connection = activeConnections[channel];
+        if (connection) {
+            _log(`Disconnecting from channel: ${channel}`);
+            connection.socket.disconnect();
+            delete activeConnections[channel];
+        }
+    };
+    /**
+     * Subscribe to an event on a channel
+     * @param channel Channel to subscribe to
+     * @param event Event name to listen for
+     * @param callback Callback function to handle events
+     */
+    const subscribe = async (channel, event, callback) => {
+        // Get or create connection
+        let connection = activeConnections[channel];
+        if (!connection) {
+            connection = await connect(channel);
+        }
+        // Initialize listeners set for this event if needed
+        if (!connection.listeners[event]) {
+            connection.listeners[event] = new Set();
+            // Add socket listener for this event
+            connection.socket.on(event, (eventData) => {
+                _log(`Received event '${event}' on channel ${channel}:`, eventData);
+                // Call all registered callbacks
+                const eventListeners = connection.listeners[event] || new Set();
+                eventListeners.forEach(listener => listener(eventData));
+            });
+        }
+        // Add callback to listeners
+        connection.listeners[event].add(callback);
+        _log(`Subscribed to event '${event}' on channel ${channel}`);
+    };
+    /**
+     * Subscribe to an event on a public channel
+     * Automatically connects to the public channel if not already connected
+     * @param publicToken Public file system token (10-character alphanumeric)
+     * @param event Event name to listen for
+     * @param callback Callback function to handle events
+     */
+    const subscribePublic = async (publicToken, event, callback) => {
+        const channel = `public/${publicToken}`;
+        // Get or create public connection
+        let connection = activeConnections[channel];
+        if (!connection) {
+            connection = await connectPublic(publicToken);
+        }
+        // Initialize listeners set for this event if needed
+        if (!connection.listeners[event]) {
+            connection.listeners[event] = new Set();
+            // Add socket listener for this event
+            connection.socket.on(event, (eventData) => {
+                _log(`Received event '${event}' on public channel ${channel}:`, eventData);
+                // Call all registered callbacks
+                const eventListeners = connection.listeners[event] || new Set();
+                eventListeners.forEach(listener => listener(eventData));
+            });
+        }
+        // Add callback to listeners
+        connection.listeners[event].add(callback);
+        _log(`Subscribed to event '${event}' on public channel ${channel}`);
+    };
+    /**
+     * Unsubscribe from an event on a channel
+     * @param channel Channel to unsubscribe from
+     * @param event Event name to stop listening for
+     * @param callback Callback function to remove (if not provided, all callbacks will be removed)
+     */
+    /**
+     * Stop listening for an event on a channel. If `callback` is provided,
+     * only that specific listener is removed; otherwise every listener for
+     * that event is cleared.
+     *
+     * @param channel Channel to unsubscribe from
+     * @param event Event name to stop listening for
+     * @param callback Specific callback to remove (optional)
+     */
+    const unsubscribe = (channel, event, callback) => {
+        const connection = activeConnections[channel];
+        if (!connection || !connection.listeners[event]) {
+            return;
+        }
+        if (callback) {
+            // Remove specific callback
+            connection.listeners[event].delete(callback);
+            _log(`Unsubscribed specific callback from event '${event}' on channel ${channel}`);
+        }
+        else {
+            // Remove all callbacks
+            connection.listeners[event].clear();
+            connection.socket.off(event);
+            _log(`Unsubscribed all callbacks from event '${event}' on channel ${channel}`);
+        }
+    };
+    /**
+     * Check if connected to a channel
+     * @param channel Channel to check
+     * @returns True if connected, false otherwise
+     */
+    const isConnected = (channel) => {
+        return !!activeConnections[channel]?.socket.connected;
+    };
+    /**
+     * Emit an event to a connected channel
+     * @param channel Channel to emit to
+     * @param event Event name
+     * @param data Event data
+     */
+    const emit = (channel, event, data) => {
+        const connection = activeConnections[channel];
+        if (!connection?.socket.connected) {
+            _log(`Cannot emit to channel ${channel}: not connected`);
+            return;
+        }
+        _log(`Emitting '${event}' on channel ${channel}`);
+        connection.socket.emit(event, data);
+    };
+    /**
+     * Emit an event with a timeout-bounded server acknowledgement. Resolves
+     * `true` if the server acks within `timeoutMs`, `false` on timeout or
+     * transport error. Used by the FE WS layer (`WebSocketManager.probeChannel`)
+     * to actively verify a channel's liveness when `socket.connected` may be
+     * stale — most notably after a backgrounded tab returns to focus, where
+     * the flag can remain `true` for up to socket.io's own heartbeat window
+     * (~25–45s) even after the underlying TCP transport has died.
+     *
+     * Relies on socket.io v4's `socket.timeout(ms).emit(ev, data, cb)`
+     * pattern: the BE handler invokes `ack()` (its trailing callback arg);
+     * if no ack arrives within `timeoutMs` the cb is invoked with an Error.
+     */
+    const emitWithAck = (channel, event, data, timeoutMs) => {
+        const connection = activeConnections[channel];
+        if (!connection)
+            return Promise.resolve(false);
+        return new Promise((resolve) => {
+            try {
+                connection.socket.timeout(timeoutMs).emit(event, data, (err) => {
+                    resolve(!err);
+                });
+            }
+            catch (error) {
+                _log(`emitWithAck error on channel ${channel}:`, error);
+                resolve(false);
+            }
+        });
+    };
+    /**
+     * Disconnect from all channels
+     */
+    const disconnectAll = async () => {
+        _log('Disconnecting from all channels');
+        const channels = Object.keys(activeConnections);
+        for (const channel of channels) {
+            await disconnect(channel);
+        }
+    };
+    /**
+     * Register a callback for when Socket.IO exhausts all reconnection attempts
+     * @param channel Channel to monitor
+     * @param callback Callback invoked when reconnection fails permanently
+     */
+    const onReconnectFailed = (channel, callback) => {
+        const connection = activeConnections[channel];
+        if (connection) {
+            // Add to the channel's listener set so the existing reconnect_failed
+            // handler in connect()/connectPublic() dispatches to it
+            if (!connection.listeners['reconnect_failed']) {
+                connection.listeners['reconnect_failed'] = new Set();
+            }
+            connection.listeners['reconnect_failed'].add(callback);
+        }
+    };
+    /**
+     * Register a callback for when the channel reconnects — a socket.io
+     * transport-level reconnect, or the token-refresh reconnect. Use it to recover
+     * any gap of server->client messages missed while the connection was down;
+     * socket.io does not replay those. Dispatched from the 'reconnect' handler in
+     * connect() and from the token-refresh path.
+     */
+    const onReconnect = (channel, callback) => {
+        const connection = activeConnections[channel];
+        if (connection) {
+            if (!connection.listeners['reconnect']) {
+                connection.listeners['reconnect'] = new Set();
+            }
+            connection.listeners['reconnect'].add(callback);
+        }
+    };
+    return {
+        connect,
+        connectPublic,
+        disconnect,
+        disconnectAll,
+        subscribe,
+        subscribePublic,
+        unsubscribe,
+        isConnected,
+        emit,
+        emitWithAck,
+        onReconnect,
+        onReconnectFailed,
+    };
+}
+//# sourceMappingURL=socket.js.map

package/dist/routes/socket.js.map

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

package/dist/routes/storage.d.ts

@@ -0,0 +1,44 @@
+import NuramaClient from '../NuramaClient.js';
+export type ResourceType = 'user' | 'workspace' | 'project' | 'chat' | 'asset';
+export interface GetStorageChartParams {
+    startDate?: number;
+    endDate?: number;
+    aggregationPeriod?: 'year' | 'month' | 'week' | 'day';
+}
+export interface ChartDataEntry {
+    period: string;
+    averageSizeInBytes: number;
+}
+export type ChartDataResponse = ChartDataEntry[];
+export interface StorageRecord {
+    resourceId: string;
+    resourceType: ResourceType;
+    sizeInBytes: number;
+    id: string;
+}
+/**
+ * Defines storage-related methods for the NuramaClient.
+ * @param {NuramaClient} client - The NuramaClient instance.
+ * @returns {object} An object containing the storage-related methods.
+ */
+export default function createStorageMethods(client: NuramaClient): {
+    /**
+         * Retrieves storage usage chart data for a specific resource.
+         * Requires authentication and permission.
+         * @param {ResourceType} resourceType - The type of the resource.
+         * @param {string} resourceId - The ID of the resource.
+         * @param {GetStorageChartParams} [params] - Optional query parameters for date range and aggregation.
+         * @returns {Promise<ChartDataResponse>} An array of chart data entries.
+         */
+    getStorageChart(resourceType: ResourceType, resourceId: string, params?: GetStorageChartParams): Promise<ChartDataResponse>;
+    /**
+         * Retrieves the latest storage record for a specific resource.
+         * Requires authentication and permission.
+         * @param {ResourceType} resourceType - The type of the resource.
+         * @param {string} resourceId - The ID of the resource.
+         * @returns {Promise<StorageRecord>} The latest storage record for the resource.
+         */
+    getStorageRecord(resourceType: ResourceType, resourceId: string): Promise<StorageRecord>;
+};
+export type StorageMethods = ReturnType<typeof createStorageMethods>;
+//# sourceMappingURL=storage.d.ts.map

package/dist/routes/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/routes/storage.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,oBAAoB,CAAC;AAG9C,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,WAAW,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;AAG/E,MAAM,WAAW,qBAAqB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;CACzD;AAGD,MAAM,WAAW,cAAc;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,MAAM,iBAAiB,GAAG,cAAc,EAAE,CAAC;AAEjD,MAAM,WAAW,aAAa;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,YAAY,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;CACd;AAID;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,oBAAoB,CAAC,MAAM,EAAE,YAAY;IAE7D;;;;;;;WAOO;kCAES,YAAY,cACd,MAAM,WACT,qBAAqB,GAC7B,OAAO,CAAC,iBAAiB,CAAC;IAW7B;;;;;;WAMO;mCAES,YAAY,cACd,MAAM,GACjB,OAAO,CAAC,aAAa,CAAC;EAU5B;AAGD,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC"}