@rool-dev/client 0.1.0

package/dist/client.d.ts

@@ -0,0 +1,129 @@
+import { EventEmitter } from './event-emitter.js';
+import { RoolGraph } from './graph.js';
+import type { RoolClientConfig, RoolClientEvents, RoolGraphInfo, Account, UserResult, UserInfo } from './types.js';
+/**
+ * Rool Client - Manages authentication, graph lifecycle, and shared infrastructure.
+ *
+ * The client is lightweight - most graph operations happen on Graph instances
+ * obtained via openGraph() or createGraph().
+ *
+ * Features:
+ * - Authentication (login, logout, token management)
+ * - Graph lifecycle (list, open, create, delete)
+ * - Shared SSE subscription with event routing
+ * - Media operations
+ * - AI operations (promptGraph, image generation)
+ */
+export declare class RoolClient extends EventEmitter<RoolClientEvents> {
+    private config;
+    private authManager;
+    private graphqlClient;
+    private subscriptionManager;
+    private connectionId;
+    private subscribedGraphs;
+    constructor(config: RoolClientConfig);
+    /**
+     * Initialize the client - should be called on app startup.
+     * Processes any auth callback in the URL and sets up auto-refresh.
+     * @returns true if an auth callback was processed
+     */
+    initialize(): boolean;
+    /**
+     * Clean up resources - call when destroying the client.
+     */
+    destroy(): void;
+    /**
+     * Initiate login by redirecting to auth page.
+     */
+    login(): void;
+    /**
+     * Logout - clear all tokens and state.
+     */
+    logout(): void;
+    /**
+     * Process auth callback from URL fragment.
+     * Called automatically by initialize(), but can be called manually.
+     */
+    processAuthCallback(): boolean;
+    /**
+     * Check if user is currently authenticated.
+     */
+    isAuthenticated(): boolean;
+    /**
+     * Get current access token.
+     * Returns undefined if not authenticated.
+     */
+    getToken(): Promise<string | undefined>;
+    /**
+     * Get user info decoded from JWT token.
+     */
+    getUser(): UserInfo;
+    /**
+     * List all graphs accessible to the user.
+     */
+    listGraphs(): Promise<RoolGraphInfo[]>;
+    /**
+     * Open an existing graph.
+     * Loads the graph data from the server and returns a Graph instance.
+     */
+    openGraph(graphId: string): Promise<RoolGraph>;
+    /**
+     * Create a new graph.
+     * Creates on server and returns a Graph instance.
+     */
+    createGraph(name?: string): Promise<RoolGraph>;
+    /**
+     * Delete a graph.
+     * Note: This does not affect any open Graph instances - they become stale.
+     */
+    deleteGraph(graphId: string): Promise<void>;
+    /**
+     * Get account info from server (plan, credits, etc).
+     */
+    getAccount(): Promise<Account>;
+    /**
+     * Search for a user by email.
+     */
+    searchUser(email: string): Promise<UserResult | null>;
+    private get mediaClient();
+    /**
+     * Subscribe to real-time events.
+     * Client receives graph lifecycle events; graph-level events are routed
+     * to subscribed Graph instances.
+     */
+    subscribe(): Promise<void>;
+    /**
+     * Unsubscribe from real-time events.
+     */
+    unsubscribe(): void;
+    /**
+     * Check if currently subscribed to events.
+     */
+    isSubscribed(): boolean;
+    /**
+     * Get the connection ID used for subscriptions.
+     * Events triggered by this connection won't be echoed back.
+     */
+    getConnectionId(): string;
+    /**
+     * Generate a unique entity ID.
+     * 6-character alphanumeric string (62^6 = 56.8 billion possible values).
+     * Also available as top-level generateEntityId() export.
+     */
+    static generateId(): string;
+    /**
+     * Execute an arbitrary GraphQL query or mutation.
+     * Use this escape hatch for app-specific operations not covered by the typed API.
+     *
+     * @example
+     * const result = await client.graphql<{ lastMessages: Message[] }>(
+     *   `query LastMessages($graphId: String!) { lastMessages(graphId: $graphId) }`,
+     *   { graphId: 'abc123' }
+     * );
+     */
+    graphql<T>(query: string, variables?: Record<string, unknown>): Promise<T>;
+    private registerGraphForEvents;
+    private unregisterGraphFromEvents;
+    private handleGraphEvent;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAKlD,OAAO,EAAE,SAAS,EAAoB,MAAM,YAAY,CAAC;AACzD,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAEhB,aAAa,EAEb,OAAO,EACP,UAAU,EACV,QAAQ,EAET,MAAM,YAAY,CAAC;AASpB;;;;;;;;;;;;GAYG;AACH,qBAAa,UAAW,SAAQ,YAAY,CAAC,gBAAgB,CAAC;IAC5D,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,mBAAmB,CAAoC;IAC/D,OAAO,CAAC,YAAY,CAAS;IAG7B,OAAO,CAAC,gBAAgB,CAAgC;gBAE5C,MAAM,EAAE,gBAAgB;IA8BpC;;;;OAIG;IACH,UAAU,IAAI,OAAO;IAIrB;;OAEG;IACH,OAAO,IAAI,IAAI;IAiBf;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,MAAM,IAAI,IAAI;IAWd;;;OAGG;IACH,mBAAmB,IAAI,OAAO;IAI9B;;OAEG;IACH,eAAe,IAAI,OAAO;IAI1B;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAI7C;;OAEG;IACH,OAAO,IAAI,QAAQ;IAQnB;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAI5C;;;OAGG;IACG,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAoBpD;;;OAGG;IACG,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAoBpD;;;OAGG;IACG,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASjD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAIpC;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAQ3D,OAAO,KAAK,WAAW,GAKtB;IAMD;;;;OAIG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAmBhC;;OAEG;IACH,WAAW,IAAI,IAAI;IAOnB;;OAEG;IACH,YAAY,IAAI,OAAO;IAQvB;;;OAGG;IACH,eAAe,IAAI,MAAM;IAIzB;;;;OAIG;IACH,MAAM,CAAC,UAAU,IAAI,MAAM;IAI3B;;;;;;;;;OASG;IACG,OAAO,CAAC,CAAC,EACb,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,OAAO,CAAC,CAAC,CAAC;IAQb,OAAO,CAAC,sBAAsB;IAI9B,OAAO,CAAC,yBAAyB;IAQjC,OAAO,CAAC,gBAAgB;CA6DzB"}

package/dist/client.js

@@ -0,0 +1,343 @@
+// =============================================================================
+// Rool Client
+// Lightweight client for auth, graph lifecycle, and shared infrastructure
+// =============================================================================
+import { EventEmitter } from './event-emitter.js';
+import { AuthManager } from './auth.js';
+import { GraphQLClient } from './graphql.js';
+import { SubscriptionManager } from './subscription.js';
+import { MediaClient } from './media.js';
+import { RoolGraph, generateEntityId } from './graph.js';
+const DEFAULT_STORAGE_PREFIX = 'rool_';
+/**
+ * Rool Client - Manages authentication, graph lifecycle, and shared infrastructure.
+ *
+ * The client is lightweight - most graph operations happen on Graph instances
+ * obtained via openGraph() or createGraph().
+ *
+ * Features:
+ * - Authentication (login, logout, token management)
+ * - Graph lifecycle (list, open, create, delete)
+ * - Shared SSE subscription with event routing
+ * - Media operations
+ * - AI operations (promptGraph, image generation)
+ */
+export class RoolClient extends EventEmitter {
+    config;
+    authManager;
+    graphqlClient;
+    subscriptionManager = null;
+    connectionId;
+    // Registry of open graphs for event routing
+    subscribedGraphs = new Map();
+    constructor(config) {
+        super();
+        this.config = {
+            baseUrl: config.baseUrl.replace(/\/+$/, ''), // Remove trailing slashes
+            storagePrefix: config.storagePrefix ?? DEFAULT_STORAGE_PREFIX,
+        };
+        this.connectionId = generateEntityId();
+        this.authManager = new AuthManager({
+            baseUrl: this.config.baseUrl,
+            storagePrefix: this.config.storagePrefix,
+            authProvider: config.authProvider,
+            onAuthStateChanged: (authenticated) => {
+                this.emit('authStateChanged', authenticated);
+            },
+        });
+        this.graphqlClient = new GraphQLClient({
+            baseUrl: this.config.baseUrl,
+            authManager: this.authManager,
+            getConnectionId: () => this.connectionId,
+        });
+    }
+    // ===========================================================================
+    // Initialization
+    // ===========================================================================
+    /**
+     * Initialize the client - should be called on app startup.
+     * Processes any auth callback in the URL and sets up auto-refresh.
+     * @returns true if an auth callback was processed
+     */
+    initialize() {
+        return this.authManager.initialize();
+    }
+    /**
+     * Clean up resources - call when destroying the client.
+     */
+    destroy() {
+        this.authManager.destroy();
+        this.subscriptionManager?.destroy();
+        // Close all open graphs
+        for (const graph of this.subscribedGraphs.values()) {
+            graph.close();
+        }
+        this.subscribedGraphs.clear();
+        this.removeAllListeners();
+    }
+    // ===========================================================================
+    // Authentication
+    // ===========================================================================
+    /**
+     * Initiate login by redirecting to auth page.
+     */
+    login() {
+        this.authManager.login();
+    }
+    /**
+     * Logout - clear all tokens and state.
+     */
+    logout() {
+        this.authManager.logout();
+        this.unsubscribe();
+        // Close all open graphs
+        for (const graph of this.subscribedGraphs.values()) {
+            graph.close();
+        }
+        this.subscribedGraphs.clear();
+    }
+    /**
+     * Process auth callback from URL fragment.
+     * Called automatically by initialize(), but can be called manually.
+     */
+    processAuthCallback() {
+        return this.authManager.processCallback();
+    }
+    /**
+     * Check if user is currently authenticated.
+     */
+    isAuthenticated() {
+        return this.authManager.isAuthenticated();
+    }
+    /**
+     * Get current access token.
+     * Returns undefined if not authenticated.
+     */
+    async getToken() {
+        return this.authManager.getToken();
+    }
+    /**
+     * Get user info decoded from JWT token.
+     */
+    getUser() {
+        return this.authManager.getUser();
+    }
+    // ===========================================================================
+    // Graph Lifecycle
+    // ===========================================================================
+    /**
+     * List all graphs accessible to the user.
+     */
+    async listGraphs() {
+        return this.graphqlClient.listGraphs();
+    }
+    /**
+     * Open an existing graph.
+     * Loads the graph data from the server and returns a Graph instance.
+     */
+    async openGraph(graphId) {
+        const [graphData, graphList] = await Promise.all([
+            this.graphqlClient.getGraph(graphId),
+            this.graphqlClient.listGraphs(),
+        ]);
+        const graphInfo = graphList.find(g => g.id === graphId);
+        return new RoolGraph({
+            id: graphId,
+            name: graphInfo?.name ?? graphId,
+            role: graphInfo?.role ?? 'viewer',
+            initialData: graphData,
+            graphqlClient: this.graphqlClient,
+            mediaClient: this.mediaClient,
+            onRegisterForEvents: (id, graph) => this.registerGraphForEvents(id, graph),
+            onUnregisterFromEvents: (id) => this.unregisterGraphFromEvents(id),
+        });
+    }
+    /**
+     * Create a new graph.
+     * Creates on server and returns a Graph instance.
+     */
+    async createGraph(name) {
+        const graphId = generateEntityId();
+        const graphName = name ?? graphId;
+        const initialData = { nodes: {}, edges: {}, _meta: {} };
+        // Create on server
+        await this.graphqlClient.setGraph(graphId, initialData);
+        return new RoolGraph({
+            id: graphId,
+            name: graphName,
+            role: 'owner',
+            initialData,
+            graphqlClient: this.graphqlClient,
+            mediaClient: this.mediaClient,
+            onRegisterForEvents: (id, graph) => this.registerGraphForEvents(id, graph),
+            onUnregisterFromEvents: (id) => this.unregisterGraphFromEvents(id),
+        });
+    }
+    /**
+     * Delete a graph.
+     * Note: This does not affect any open Graph instances - they become stale.
+     */
+    async deleteGraph(graphId) {
+        await this.graphqlClient.deleteGraph(graphId);
+        // Client-level event will be emitted via SSE subscription
+    }
+    // ===========================================================================
+    // User Operations
+    // ===========================================================================
+    /**
+     * Get account info from server (plan, credits, etc).
+     */
+    async getAccount() {
+        return this.graphqlClient.getAccount();
+    }
+    /**
+     * Search for a user by email.
+     */
+    async searchUser(email) {
+        return this.graphqlClient.searchUser(email);
+    }
+    // ===========================================================================
+    // Media Client (used internally by Graph instances)
+    // ===========================================================================
+    get mediaClient() {
+        return new MediaClient({
+            baseUrl: this.config.baseUrl,
+            authManager: this.authManager,
+        });
+    }
+    // ===========================================================================
+    // Subscriptions
+    // ===========================================================================
+    /**
+     * Subscribe to real-time events.
+     * Client receives graph lifecycle events; graph-level events are routed
+     * to subscribed Graph instances.
+     */
+    async subscribe() {
+        if (this.subscriptionManager)
+            return;
+        this.subscriptionManager = new SubscriptionManager({
+            baseUrl: this.config.baseUrl,
+            authManager: this.authManager,
+            connectionId: this.connectionId,
+            onEvent: (event) => this.handleGraphEvent(event),
+            onConnectionStateChanged: (state) => {
+                this.emit('connectionStateChanged', state);
+            },
+            onError: (error) => {
+                this.emit('error', error, 'subscription');
+            },
+        });
+        await this.subscriptionManager.subscribe();
+    }
+    /**
+     * Unsubscribe from real-time events.
+     */
+    unsubscribe() {
+        if (this.subscriptionManager) {
+            this.subscriptionManager.destroy();
+            this.subscriptionManager = null;
+        }
+    }
+    /**
+     * Check if currently subscribed to events.
+     */
+    isSubscribed() {
+        return this.subscriptionManager?.isSubscribed ?? false;
+    }
+    // ===========================================================================
+    // Utilities
+    // ===========================================================================
+    /**
+     * Get the connection ID used for subscriptions.
+     * Events triggered by this connection won't be echoed back.
+     */
+    getConnectionId() {
+        return this.connectionId;
+    }
+    /**
+     * Generate a unique entity ID.
+     * 6-character alphanumeric string (62^6 = 56.8 billion possible values).
+     * Also available as top-level generateEntityId() export.
+     */
+    static generateId() {
+        return generateEntityId();
+    }
+    /**
+     * Execute an arbitrary GraphQL query or mutation.
+     * Use this escape hatch for app-specific operations not covered by the typed API.
+     *
+     * @example
+     * const result = await client.graphql<{ lastMessages: Message[] }>(
+     *   `query LastMessages($graphId: String!) { lastMessages(graphId: $graphId) }`,
+     *   { graphId: 'abc123' }
+     * );
+     */
+    async graphql(query, variables) {
+        return this.graphqlClient.query(query, variables);
+    }
+    // ===========================================================================
+    // Private Methods - Graph Registry
+    // ===========================================================================
+    registerGraphForEvents(graphId, graph) {
+        this.subscribedGraphs.set(graphId, graph);
+    }
+    unregisterGraphFromEvents(graphId) {
+        this.subscribedGraphs.delete(graphId);
+    }
+    // ===========================================================================
+    // Private Methods - Event Handling
+    // ===========================================================================
+    handleGraphEvent(event) {
+        const { type, graphId, patch } = event;
+        switch (type) {
+            case 'graph_patched':
+                // Route to subscribed Graph instance
+                if (patch) {
+                    const graph = this.subscribedGraphs.get(graphId);
+                    if (graph) {
+                        graph.handleRemotePatch(patch);
+                    }
+                }
+                break;
+            case 'graph_changed':
+                // Route to subscribed Graph instance
+                {
+                    const graph = this.subscribedGraphs.get(graphId);
+                    if (graph) {
+                        // Reload graph data and notify
+                        void this.graphqlClient.getGraph(graphId).then((data) => {
+                            graph.handleRemoteChange(data);
+                        });
+                    }
+                }
+                break;
+            case 'graph_name_changed':
+                // Emit client-level event and update any open Graph
+                {
+                    // Fetch updated name
+                    void this.graphqlClient.listGraphs().then((graphs) => {
+                        const info = graphs.find(g => g.id === graphId);
+                        if (info) {
+                            const graph = this.subscribedGraphs.get(graphId);
+                            if (graph) {
+                                graph.handleRemoteRename(info.name);
+                            }
+                            this.emit('graphRenamed', graphId, info.name);
+                        }
+                    });
+                }
+                break;
+            case 'graph_created':
+                // Client-level event only
+                this.emit('graphCreated', graphId);
+                break;
+            case 'graph_deleted':
+                // Client-level event
+                this.emit('graphDeleted', graphId);
+                // Note: Any open Graph instances become stale
+                break;
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/event-emitter.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Generic event map type - keys are event names, values are listener signatures
+ */
+export type EventMap = Record<string, (...args: any[]) => void>;
+/**
+ * Simple typed EventEmitter implementation.
+ * Works in browser and Node.js environments without dependencies.
+ */
+export declare class EventEmitter<Events extends EventMap> {
+    private listeners;
+    /**
+     * Register an event listener.
+     * @returns Unsubscribe function
+     */
+    on<K extends keyof Events>(event: K, listener: Events[K]): () => void;
+    /**
+     * Remove an event listener.
+     */
+    off<K extends keyof Events>(event: K, listener: Events[K]): void;
+    /**
+     * Register a one-time event listener.
+     * @returns Unsubscribe function
+     */
+    once<K extends keyof Events>(event: K, listener: Events[K]): () => void;
+    /**
+     * Emit an event to all registered listeners.
+     */
+    protected emit<K extends keyof Events>(event: K, ...args: Parameters<Events[K]>): void;
+    /**
+     * Remove all listeners for a specific event, or all listeners if no event specified.
+     */
+    removeAllListeners<K extends keyof Events>(event?: K): void;
+    /**
+     * Get the number of listeners for a specific event.
+     */
+    listenerCount<K extends keyof Events>(event: K): number;
+}
+//# sourceMappingURL=event-emitter.d.ts.map

package/dist/event-emitter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-emitter.d.ts","sourceRoot":"","sources":["../src/event-emitter.ts"],"names":[],"mappings":"AAKA;;GAEG;AAEH,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC,CAAC;AAEhE;;;GAGG;AACH,qBAAa,YAAY,CAAC,MAAM,SAAS,QAAQ;IAC/C,OAAO,CAAC,SAAS,CAAsD;IAEvE;;;OAGG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IASrE;;OAEG;IACH,GAAG,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI;IAUhE;;;OAGG;IACH,IAAI,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IASvE;;OAEG;IACH,SAAS,CAAC,IAAI,CAAC,CAAC,SAAS,MAAM,MAAM,EACnC,KAAK,EAAE,CAAC,EACR,GAAG,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAC7B,IAAI;IAcP;;OAEG;IACH,kBAAkB,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI;IAQ3D;;OAEG;IACH,aAAa,CAAC,CAAC,SAAS,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM;CAGxD"}

package/dist/event-emitter.js

@@ -0,0 +1,80 @@
+// =============================================================================
+// Typed EventEmitter
+// Framework-agnostic event emitter that works in browser and Node.js
+// =============================================================================
+/**
+ * Simple typed EventEmitter implementation.
+ * Works in browser and Node.js environments without dependencies.
+ */
+export class EventEmitter {
+    listeners = new Map();
+    /**
+     * Register an event listener.
+     * @returns Unsubscribe function
+     */
+    on(event, listener) {
+        if (!this.listeners.has(event)) {
+            this.listeners.set(event, new Set());
+        }
+        this.listeners.get(event).add(listener);
+        return () => this.off(event, listener);
+    }
+    /**
+     * Remove an event listener.
+     */
+    off(event, listener) {
+        const set = this.listeners.get(event);
+        if (set) {
+            set.delete(listener);
+            if (set.size === 0) {
+                this.listeners.delete(event);
+            }
+        }
+    }
+    /**
+     * Register a one-time event listener.
+     * @returns Unsubscribe function
+     */
+    once(event, listener) {
+        const wrapper = ((...args) => {
+            this.off(event, wrapper);
+            listener(...args);
+        });
+        return this.on(event, wrapper);
+    }
+    /**
+     * Emit an event to all registered listeners.
+     */
+    emit(event, ...args) {
+        const set = this.listeners.get(event);
+        if (set) {
+            // Copy to array to allow listeners to unsubscribe during emit
+            for (const listener of Array.from(set)) {
+                try {
+                    listener(...args);
+                }
+                catch (error) {
+                    console.error(`Error in event listener for "${String(event)}":`, error);
+                }
+            }
+        }
+    }
+    /**
+     * Remove all listeners for a specific event, or all listeners if no event specified.
+     */
+    removeAllListeners(event) {
+        if (event !== undefined) {
+            this.listeners.delete(event);
+        }
+        else {
+            this.listeners.clear();
+        }
+    }
+    /**
+     * Get the number of listeners for a specific event.
+     */
+    listenerCount(event) {
+        return this.listeners.get(event)?.size ?? 0;
+    }
+}
+//# sourceMappingURL=event-emitter.js.map

package/dist/event-emitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-emitter.js","sourceRoot":"","sources":["../src/event-emitter.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,qBAAqB;AACrB,qEAAqE;AACrE,gFAAgF;AAQhF;;;GAGG;AACH,MAAM,OAAO,YAAY;IACf,SAAS,GAAG,IAAI,GAAG,EAA2C,CAAC;IAEvE;;;OAGG;IACH,EAAE,CAAyB,KAAQ,EAAE,QAAmB;QACtD,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QACvC,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAEzC,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,GAAG,CAAyB,KAAQ,EAAE,QAAmB;QACvD,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,GAAG,EAAE,CAAC;YACR,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YACrB,IAAI,GAAG,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;gBACnB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC/B,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,IAAI,CAAyB,KAAQ,EAAE,QAAmB;QACxD,MAAM,OAAO,GAAG,CAAC,CAAC,GAAG,IAA2B,EAAE,EAAE;YAClD,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,OAAoB,CAAC,CAAC;YACrC,QAAqD,CAAC,GAAG,IAAI,CAAC,CAAC;QAClE,CAAC,CAAc,CAAC;QAEhB,OAAO,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACO,IAAI,CACZ,KAAQ,EACR,GAAG,IAA2B;QAE9B,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,GAAG,EAAE,CAAC;YACR,8DAA8D;YAC9D,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBACvC,IAAI,CAAC;oBACF,QAAqD,CAAC,GAAG,IAAI,CAAC,CAAC;gBAClE,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,CAAC,KAAK,CAAC,gCAAgC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;gBAC1E,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,kBAAkB,CAAyB,KAAS;QAClD,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC/B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACzB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,aAAa,CAAyB,KAAQ;QAC5C,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,IAAI,IAAI,CAAC,CAAC;IAC9C,CAAC;CACF"}