raffel 0.1.2

package/dist/channels/channel-manager.js

@@ -0,0 +1,274 @@
+/**
+ * Channel Manager
+ *
+ * Core state management for WebSocket channels.
+ * Handles subscriptions, broadcasting, and presence tracking.
+ */
+import { getChannelType } from './types.js';
+/**
+ * Create a channel manager instance
+ *
+ * @param options - Channel configuration
+ * @param sendToSocket - Function to send messages to sockets
+ * @returns ChannelManager instance
+ *
+ * @example
+ * ```typescript
+ * const manager = createChannelManager(
+ *   {
+ *     authorize: async (socketId, channel, ctx) => {
+ *       return ctx.auth?.authenticated ?? false
+ *     },
+ *     presenceData: (socketId, channel, ctx) => ({
+ *       userId: ctx.auth?.principal,
+ *       name: ctx.auth?.claims?.name,
+ *     }),
+ *   },
+ *   (socketId, message) => {
+ *     const client = clients.get(socketId)
+ *     if (client) client.send(JSON.stringify(message))
+ *   }
+ * )
+ * ```
+ */
+export function createChannelManager(options, sendToSocket) {
+    /** Channel state storage */
+    const channels = new Map();
+    /** Reverse index: socket → channels */
+    const socketChannels = new Map();
+    /**
+     * Get or create a channel
+     */
+    function getOrCreateChannel(name) {
+        let channel = channels.get(name);
+        if (!channel) {
+            const type = getChannelType(name);
+            channel = {
+                name,
+                type,
+                subscribers: new Set(),
+                members: type === 'presence' ? new Map() : undefined,
+                createdAt: Date.now(),
+            };
+            channels.set(name, channel);
+        }
+        return channel;
+    }
+    /**
+     * Track socket → channel relationship
+     */
+    function trackSubscription(socketId, channel) {
+        let subs = socketChannels.get(socketId);
+        if (!subs) {
+            subs = new Set();
+            socketChannels.set(socketId, subs);
+        }
+        subs.add(channel);
+    }
+    /**
+     * Untrack socket → channel relationship
+     */
+    function untrackSubscription(socketId, channel) {
+        const subs = socketChannels.get(socketId);
+        if (subs) {
+            subs.delete(channel);
+            if (subs.size === 0) {
+                socketChannels.delete(socketId);
+            }
+        }
+    }
+    /**
+     * Broadcast a message to channel subscribers
+     */
+    function broadcastMessage(channelName, event, data, except) {
+        const channel = channels.get(channelName);
+        if (!channel)
+            return;
+        const message = {
+            type: 'event',
+            channel: channelName,
+            event,
+            data,
+        };
+        for (const socketId of channel.subscribers) {
+            if (socketId !== except) {
+                sendToSocket(socketId, message);
+            }
+        }
+    }
+    /**
+     * Clean up channel if empty
+     */
+    function cleanupIfEmpty(channelName) {
+        const channel = channels.get(channelName);
+        if (channel && channel.subscribers.size === 0) {
+            channels.delete(channelName);
+        }
+    }
+    const manager = {
+        // ─────────────────────────────────────────────────────────────
+        // Subscription Management
+        // ─────────────────────────────────────────────────────────────
+        async subscribe(socketId, channelName, ctx) {
+            const type = getChannelType(channelName);
+            // Authorization check (all channels when authorize is provided)
+            if (options.authorize) {
+                const allowed = await options.authorize(socketId, channelName, ctx);
+                if (!allowed) {
+                    return {
+                        success: false,
+                        error: {
+                            code: 'PERMISSION_DENIED',
+                            status: 403,
+                            message: `Not authorized to subscribe to ${channelName}`,
+                        },
+                    };
+                }
+            }
+            else if (type !== 'public') {
+                // No authorize function → deny by default for private/presence
+                return {
+                    success: false,
+                    error: {
+                        code: 'PERMISSION_DENIED',
+                        status: 403,
+                        message: `Authorization required for ${type} channels`,
+                    },
+                };
+            }
+            const channel = getOrCreateChannel(channelName);
+            // Already subscribed?
+            if (channel.subscribers.has(socketId)) {
+                // For presence, return current members
+                if (type === 'presence' && channel.members) {
+                    return {
+                        success: true,
+                        members: Array.from(channel.members.values()),
+                    };
+                }
+                return { success: true };
+            }
+            // Add subscriber
+            channel.subscribers.add(socketId);
+            trackSubscription(socketId, channelName);
+            // Presence: track member and notify others
+            if (type === 'presence' && channel.members) {
+                const info = options.presenceData?.(socketId, channelName, ctx) ?? {};
+                const member = {
+                    id: socketId,
+                    userId: ctx.auth?.principal,
+                    info,
+                    joinedAt: Date.now(),
+                };
+                channel.members.set(socketId, member);
+                // Notify existing members (not the new one)
+                broadcastMessage(channelName, 'member_added', {
+                    id: member.id,
+                    userId: member.userId,
+                    info: member.info,
+                }, socketId);
+                return {
+                    success: true,
+                    members: Array.from(channel.members.values()),
+                };
+            }
+            return { success: true };
+        },
+        unsubscribe(socketId, channelName) {
+            const channel = channels.get(channelName);
+            if (!channel)
+                return;
+            if (!channel.subscribers.has(socketId))
+                return;
+            channel.subscribers.delete(socketId);
+            untrackSubscription(socketId, channelName);
+            // Presence: remove member and notify others
+            if (channel.type === 'presence' && channel.members) {
+                const member = channel.members.get(socketId);
+                if (member) {
+                    channel.members.delete(socketId);
+                    broadcastMessage(channelName, 'member_removed', {
+                        id: socketId,
+                        userId: member.userId,
+                    });
+                }
+            }
+            cleanupIfEmpty(channelName);
+        },
+        unsubscribeAll(socketId) {
+            const subs = socketChannels.get(socketId);
+            if (!subs)
+                return;
+            // Copy because we're modifying during iteration
+            const channelNames = Array.from(subs);
+            for (const channelName of channelNames) {
+                manager.unsubscribe(socketId, channelName);
+            }
+            socketChannels.delete(socketId);
+        },
+        isSubscribed(socketId, channelName) {
+            const channel = channels.get(channelName);
+            return channel?.subscribers.has(socketId) ?? false;
+        },
+        getSubscriptions(socketId) {
+            const subs = socketChannels.get(socketId);
+            return subs ? Array.from(subs) : [];
+        },
+        // ─────────────────────────────────────────────────────────────
+        // Broadcasting
+        // ─────────────────────────────────────────────────────────────
+        broadcast(channelName, event, data, except) {
+            broadcastMessage(channelName, event, data, except);
+        },
+        sendToSocket(socketId, channelName, event, data) {
+            const channel = channels.get(channelName);
+            if (!channel || !channel.subscribers.has(socketId))
+                return;
+            sendToSocket(socketId, {
+                type: 'event',
+                channel: channelName,
+                event,
+                data,
+            });
+        },
+        // ─────────────────────────────────────────────────────────────
+        // Presence
+        // ─────────────────────────────────────────────────────────────
+        getMembers(channelName) {
+            const channel = channels.get(channelName);
+            if (!channel || !channel.members)
+                return [];
+            return Array.from(channel.members.values());
+        },
+        getMember(channelName, socketId) {
+            const channel = channels.get(channelName);
+            return channel?.members?.get(socketId);
+        },
+        getMemberCount(channelName) {
+            const channel = channels.get(channelName);
+            return channel?.members?.size ?? 0;
+        },
+        // ─────────────────────────────────────────────────────────────
+        // Admin
+        // ─────────────────────────────────────────────────────────────
+        kick(channelName, socketId) {
+            manager.unsubscribe(socketId, channelName);
+        },
+        getChannels() {
+            return Array.from(channels.keys());
+        },
+        getSubscribers(channelName) {
+            const channel = channels.get(channelName);
+            return channel ? Array.from(channel.subscribers) : [];
+        },
+        hasChannel(channelName) {
+            return channels.has(channelName);
+        },
+        getSubscriberCount(channelName) {
+            const channel = channels.get(channelName);
+            return channel?.subscribers.size ?? 0;
+        },
+    };
+    return manager;
+}
+//# sourceMappingURL=channel-manager.js.map

package/dist/channels/channel-manager.js.map

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

package/dist/channels/index.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Channels Module
+ *
+ * Pusher-like WebSocket channels for real-time communication.
+ *
+ * Channel Types:
+ * - Public: `chat-room` - Anyone can subscribe
+ * - Private: `private-xyz` - Requires authorization
+ * - Presence: `presence-xyz` - Auth + member tracking
+ *
+ * @example
+ * ```typescript
+ * import { createChannelManager } from '@raffel/channels'
+ *
+ * const channels = createChannelManager(
+ *   {
+ *     authorize: async (socketId, channel, ctx) => {
+ *       if (channel.startsWith('private-') || channel.startsWith('presence-')) {
+ *         return ctx.auth?.authenticated ?? false
+ *       }
+ *       return true
+ *     },
+ *     presenceData: (socketId, channel, ctx) => ({
+ *       userId: ctx.auth?.principal,
+ *       name: ctx.auth?.claims?.name,
+ *     }),
+ *   },
+ *   (socketId, message) => sendToClient(socketId, message)
+ * )
+ *
+ * // Subscribe
+ * const result = await channels.subscribe('socket-1', 'presence-lobby', ctx)
+ * if (result.success) {
+ *   console.log('Members:', result.members)
+ * }
+ *
+ * // Broadcast
+ * channels.broadcast('chat-room', 'message', { text: 'Hello!' })
+ *
+ * // Presence
+ * const members = channels.getMembers('presence-lobby')
+ * ```
+ */
+export { createChannelManager } from './channel-manager.js';
+export type { SendToSocketFn } from './channel-manager.js';
+export { type ChannelType, type ChannelOptions, type ChannelMember, type ChannelState, type ChannelManager, type SubscribeResult, type SubscribeMessage, type SubscribedMessage, type UnsubscribeMessage, type UnsubscribedMessage, type PublishMessage, type ChannelEventMessage, type ChannelErrorMessage, type ChannelMessage, isChannelMessage, getChannelType, requiresAuth, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/channels/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/channels/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAC3D,YAAY,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D,OAAO,EAEL,KAAK,WAAW,EAChB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,eAAe,EAGpB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EAGnB,gBAAgB,EAChB,cAAc,EACd,YAAY,GACb,MAAM,YAAY,CAAA"}

package/dist/channels/index.js

@@ -0,0 +1,48 @@
+/**
+ * Channels Module
+ *
+ * Pusher-like WebSocket channels for real-time communication.
+ *
+ * Channel Types:
+ * - Public: `chat-room` - Anyone can subscribe
+ * - Private: `private-xyz` - Requires authorization
+ * - Presence: `presence-xyz` - Auth + member tracking
+ *
+ * @example
+ * ```typescript
+ * import { createChannelManager } from '@raffel/channels'
+ *
+ * const channels = createChannelManager(
+ *   {
+ *     authorize: async (socketId, channel, ctx) => {
+ *       if (channel.startsWith('private-') || channel.startsWith('presence-')) {
+ *         return ctx.auth?.authenticated ?? false
+ *       }
+ *       return true
+ *     },
+ *     presenceData: (socketId, channel, ctx) => ({
+ *       userId: ctx.auth?.principal,
+ *       name: ctx.auth?.claims?.name,
+ *     }),
+ *   },
+ *   (socketId, message) => sendToClient(socketId, message)
+ * )
+ *
+ * // Subscribe
+ * const result = await channels.subscribe('socket-1', 'presence-lobby', ctx)
+ * if (result.success) {
+ *   console.log('Members:', result.members)
+ * }
+ *
+ * // Broadcast
+ * channels.broadcast('chat-room', 'message', { text: 'Hello!' })
+ *
+ * // Presence
+ * const members = channels.getMembers('presence-lobby')
+ * ```
+ */
+export { createChannelManager } from './channel-manager.js';
+export { 
+// Helpers
+isChannelMessage, getChannelType, requiresAuth, } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/channels/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/channels/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAG3D,OAAO;AAmBL,UAAU;AACV,gBAAgB,EAChB,cAAc,EACd,YAAY,GACb,MAAM,YAAY,CAAA"}

package/dist/channels/types.d.ts

@@ -0,0 +1,265 @@
+/**
+ * Channel Types
+ *
+ * Type definitions for Pusher-like WebSocket channels.
+ *
+ * Channel naming convention:
+ * - `chat-room` → Public channel (anyone can subscribe)
+ * - `private-xyz` → Private channel (requires authorization)
+ * - `presence-xyz` → Presence channel (auth + member tracking)
+ */
+import type { Context } from '../types/index.js';
+/**
+ * Channel type based on name prefix
+ */
+export type ChannelType = 'public' | 'private' | 'presence';
+/**
+ * Configuration options for channels
+ */
+export interface ChannelOptions {
+    /**
+     * Authorize subscription to private/presence channels.
+     * Called before allowing subscription to channels starting with
+     * `private-` or `presence-`.
+     *
+     * @param socketId - Unique identifier of the WebSocket connection
+     * @param channel - Channel name being subscribed to
+     * @param ctx - Request context (may contain auth info)
+     * @returns true to allow, false to deny
+     *
+     * @example
+     * ```typescript
+     * authorize: async (socketId, channel, ctx) => {
+     *   if (!ctx.auth?.authenticated) return false
+     *   // private-user-123 → only user 123 can subscribe
+     *   const userId = channel.replace('private-user-', '')
+     *   return ctx.auth.userId === userId
+     * }
+     * ```
+     */
+    authorize?: (socketId: string, channel: string, ctx: Context) => boolean | Promise<boolean>;
+    /**
+     * Get presence data for a member when joining a presence channel.
+     * This data is broadcast to other members and returned in the member list.
+     *
+     * @param socketId - Unique identifier of the WebSocket connection
+     * @param channel - Channel name being subscribed to
+     * @param ctx - Request context
+     * @returns Data to associate with this member
+     *
+     * @example
+     * ```typescript
+     * presenceData: (socketId, channel, ctx) => ({
+     *   userId: ctx.auth.userId,
+     *   name: ctx.auth.displayName,
+     *   avatar: ctx.auth.avatarUrl,
+     * })
+     * ```
+     */
+    presenceData?: (socketId: string, channel: string, ctx: Context) => Record<string, unknown>;
+    /**
+     * Called when a client publishes a message to a channel.
+     * Return false to reject the publish.
+     *
+     * @param socketId - Publishing socket
+     * @param channel - Target channel
+     * @param event - Event name
+     * @param data - Event data
+     * @param ctx - Request context
+     * @returns true to allow, false to reject
+     */
+    onPublish?: (socketId: string, channel: string, event: string, data: unknown, ctx: Context) => boolean | Promise<boolean>;
+}
+/**
+ * A member in a presence channel
+ */
+export interface ChannelMember {
+    /** Socket/connection ID */
+    id: string;
+    /** User ID from auth context (if available) */
+    userId?: string;
+    /** Custom presence data from presenceData callback */
+    info: Record<string, unknown>;
+    /** Timestamp when member joined */
+    joinedAt: number;
+}
+/**
+ * Internal state for a channel
+ */
+export interface ChannelState {
+    /** Channel name */
+    name: string;
+    /** Channel type (derived from name prefix) */
+    type: ChannelType;
+    /** Set of subscribed socket IDs */
+    subscribers: Set<string>;
+    /** Member tracking (only for presence channels) */
+    members?: Map<string, ChannelMember>;
+    /** When channel was created */
+    createdAt: number;
+}
+/**
+ * Result of a subscribe operation
+ */
+export interface SubscribeResult {
+    /** Whether subscription succeeded */
+    success: boolean;
+    /** Error details if failed */
+    error?: {
+        code: string;
+        status: number;
+        message: string;
+    };
+    /** Current members (only for presence channels) */
+    members?: ChannelMember[];
+}
+/**
+ * Channel manager interface for managing subscriptions and broadcasting
+ */
+export interface ChannelManager {
+    /**
+     * Subscribe a socket to a channel
+     */
+    subscribe(socketId: string, channel: string, ctx: Context): Promise<SubscribeResult>;
+    /**
+     * Unsubscribe a socket from a channel
+     */
+    unsubscribe(socketId: string, channel: string): void;
+    /**
+     * Unsubscribe a socket from all channels (called on disconnect)
+     */
+    unsubscribeAll(socketId: string): void;
+    /**
+     * Check if a socket is subscribed to a channel
+     */
+    isSubscribed(socketId: string, channel: string): boolean;
+    /**
+     * Get all channels a socket is subscribed to
+     */
+    getSubscriptions(socketId: string): string[];
+    /**
+     * Broadcast an event to all subscribers of a channel
+     *
+     * @param channel - Target channel
+     * @param event - Event name
+     * @param data - Event data
+     * @param except - Optional socket ID to exclude (e.g., the sender)
+     */
+    broadcast(channel: string, event: string, data: unknown, except?: string): void;
+    /**
+     * Send an event to a specific socket on a channel
+     */
+    sendToSocket(socketId: string, channel: string, event: string, data: unknown): void;
+    /**
+     * Get all members in a presence channel
+     */
+    getMembers(channel: string): ChannelMember[];
+    /**
+     * Get a specific member in a presence channel
+     */
+    getMember(channel: string, socketId: string): ChannelMember | undefined;
+    /**
+     * Get member count for a channel
+     */
+    getMemberCount(channel: string): number;
+    /**
+     * Kick a socket from a channel
+     */
+    kick(channel: string, socketId: string): void;
+    /**
+     * Get all active channel names
+     */
+    getChannels(): string[];
+    /**
+     * Get all subscriber socket IDs for a channel
+     */
+    getSubscribers(channel: string): string[];
+    /**
+     * Check if a channel exists (has any subscribers)
+     */
+    hasChannel(channel: string): boolean;
+    /**
+     * Get subscriber count for a channel
+     */
+    getSubscriberCount(channel: string): number;
+}
+/**
+ * Client → Server: Subscribe to a channel
+ */
+export interface SubscribeMessage {
+    id: string;
+    type: 'subscribe';
+    channel: string;
+}
+/**
+ * Server → Client: Subscription successful
+ */
+export interface SubscribedMessage {
+    id: string;
+    type: 'subscribed';
+    channel: string;
+    /** Members list (only for presence channels) */
+    members?: ChannelMember[];
+}
+/**
+ * Client → Server: Unsubscribe from a channel
+ */
+export interface UnsubscribeMessage {
+    id: string;
+    type: 'unsubscribe';
+    channel: string;
+}
+/**
+ * Server → Client: Unsubscription confirmed
+ */
+export interface UnsubscribedMessage {
+    id: string;
+    type: 'unsubscribed';
+    channel: string;
+}
+/**
+ * Client → Server: Publish event to channel
+ */
+export interface PublishMessage {
+    id: string;
+    type: 'publish';
+    channel: string;
+    event: string;
+    data: unknown;
+}
+/**
+ * Server → Client: Event broadcast
+ */
+export interface ChannelEventMessage {
+    type: 'event';
+    channel: string;
+    event: string;
+    data: unknown;
+}
+/**
+ * Server → Client: Channel error
+ */
+export interface ChannelErrorMessage {
+    id: string;
+    type: 'error';
+    code: string;
+    status: number;
+    message: string;
+}
+/**
+ * All channel-related message types
+ */
+export type ChannelMessage = SubscribeMessage | SubscribedMessage | UnsubscribeMessage | UnsubscribedMessage | PublishMessage | ChannelEventMessage | ChannelErrorMessage;
+/**
+ * Check if a message is a channel-related message
+ */
+export declare function isChannelMessage(message: unknown): message is SubscribeMessage | UnsubscribeMessage | PublishMessage;
+/**
+ * Get channel type from name
+ */
+export declare function getChannelType(name: string): ChannelType;
+/**
+ * Check if channel requires authorization
+ */
+export declare function requiresAuth(channel: string): boolean;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/channels/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAEhD;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,CAAA;AAE3D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;;;;;;;;;;;;;;;OAmBG;IACH,SAAS,CAAC,EAAE,CACV,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,OAAO,KACT,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IAE/B;;;;;;;;;;;;;;;;;OAiBG;IACH,YAAY,CAAC,EAAE,CACb,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,OAAO,KACT,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAE5B;;;;;;;;;;OAUG;IACH,SAAS,CAAC,EAAE,CACV,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,OAAO,EACb,GAAG,EAAE,OAAO,KACT,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,2BAA2B;IAC3B,EAAE,EAAE,MAAM,CAAA;IACV,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7B,mCAAmC;IACnC,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,8CAA8C;IAC9C,IAAI,EAAE,WAAW,CAAA;IACjB,mCAAmC;IACnC,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAA;IACxB,mDAAmD;IACnD,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;IACpC,+BAA+B;IAC/B,SAAS,EAAE,MAAM,CAAA;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,qCAAqC;IACrC,OAAO,EAAE,OAAO,CAAA;IAChB,8BAA8B;IAC9B,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAA;QACZ,MAAM,EAAE,MAAM,CAAA;QACd,OAAO,EAAE,MAAM,CAAA;KAChB,CAAA;IACD,mDAAmD;IACnD,OAAO,CAAC,EAAE,aAAa,EAAE,CAAA;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAK7B;;OAEG;IACH,SAAS,CACP,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,eAAe,CAAC,CAAA;IAE3B;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAEpD;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IAEtC;;OAEG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAA;IAExD;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IAM5C;;;;;;;OAOG;IACH,SAAS,CACP,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,OAAO,EACb,MAAM,CAAC,EAAE,MAAM,GACd,IAAI,CAAA;IAEP;;OAEG;IACH,YAAY,CACV,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,OAAO,GACZ,IAAI,CAAA;IAMP;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,EAAE,CAAA;IAE5C;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAAA;IAEvE;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;IAMvC;;OAEG;IACH,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IAE7C;;OAEG;IACH,WAAW,IAAI,MAAM,EAAE,CAAA;IAEvB;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IAEzC;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAA;IAEpC;;OAEG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAA;CAC5C;AAMD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,WAAW,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,YAAY,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,gDAAgD;IAChD,OAAO,CAAC,EAAE,aAAa,EAAE,CAAA;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,aAAa,CAAA;IACnB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,cAAc,CAAA;IACpB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,SAAS,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,OAAO,CAAA;CACd;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,OAAO,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,OAAO,CAAA;CACd;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,OAAO,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,gBAAgB,GAChB,iBAAiB,GACjB,kBAAkB,GAClB,mBAAmB,GACnB,cAAc,GACd,mBAAmB,GACnB,mBAAmB,CAAA;AAEvB;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,OAAO,GACf,OAAO,IAAI,gBAAgB,GAAG,kBAAkB,GAAG,cAAc,CAQnE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAIxD;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAGrD"}