@rimori/client 1.0.3 → 1.0.5

package/dist/plugin/PluginController.js

@@ -7,54 +7,46 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-import { Child } from "ibridge-flex";
 import { createClient } from '@supabase/supabase-js';
 import { RimoriClient } from "./RimoriClient";
+import { EventBus } from './fromRimori/EventBus';
+import { setTheme } from './ThemeSetter';
 export class PluginController {
-    constructor() {
-        this.onceListeners = new Map();
-        this.listeners = new Map();
+    constructor(pluginId) {
         this.communicationSecret = null;
-        this.initialized = false;
         this.supabase = null;
         this.supabaseInfo = null;
-        // localStorage.debug = "*";
-        this.plugin = new Child({
-            triggerChild: ({ topic, data, _id }) => {
-                var _a, _b;
-                // console.log("trigger child with topic:" + topic + " and data: ", data);
-                (_a = this.onceListeners.get(topic)) === null || _a === void 0 ? void 0 : _a.forEach((callback) => callback(_id, data));
-                this.onceListeners.set(topic, []);
-                (_b = this.listeners.get(topic)) === null || _b === void 0 ? void 0 : _b.forEach((callback) => callback(_id, data));
-            }
-        });
-        this.emit = this.emit.bind(this);
-        this.onOnce = this.onOnce.bind(this);
+        this.pluginId = pluginId;
         this.getClient = this.getClient.bind(this);
-        this.subscribe = this.subscribe.bind(this);
-        this.internalEmit = this.internalEmit.bind(this);
-        this.request = this.request.bind(this);
+        if (typeof WorkerGlobalScope === 'undefined') {
+            setTheme();
+        }
+        window.addEventListener("message", (event) => {
+            // console.log("client: message received", event);
+            const { topic, sender, data, eventId } = event.data.event;
+            // skip forwarding messages from own plugin
+            if (sender === pluginId)
+                return;
+            EventBus.emit(sender, topic, data, eventId);
+        });
+        EventBus.on("*", (event) => {
+            // skip messages which are not from the own plugin
+            if (event.sender !== this.pluginId)
+                return;
+            if (event.topic.startsWith("self."))
+                return;
+            window.parent.postMessage({ event, secret: this.getSecret() }, "*");
+        });
     }
-    static getInstance() {
+    static getInstance(sender) {
         return __awaiter(this, void 0, void 0, function* () {
             if (!PluginController.instance) {
-                PluginController.instance = new PluginController();
-                yield PluginController.instance.init();
+                PluginController.instance = new PluginController(sender);
                 PluginController.client = yield RimoriClient.getInstance(PluginController.instance);
             }
             return PluginController.client;
         });
     }
-    init() {
-        return __awaiter(this, void 0, void 0, function* () {
-            if (this.initialized)
-                return;
-            // Wait for the plugin to be ready
-            yield this.plugin.handshake().then(() => this.initialized = true).catch((error) => {
-                console.error("Failed to initialize the plugin communication:", error);
-            });
-        });
-    }
     getSecret() {
         if (!this.communicationSecret) {
             const secret = new URLSearchParams(window.location.search).get("secret");
@@ -72,7 +64,8 @@ export class PluginController {
                 this.supabaseInfo.expiration > new Date()) {
                 return { supabase: this.supabase, tablePrefix: this.supabaseInfo.tablePrefix, pluginId: this.supabaseInfo.pluginId };
             }
-            this.supabaseInfo = yield this.request("getSupabaseAccess");
+            const { data } = yield EventBus.request(this.pluginId, "global.supabase.requestAccess");
+            this.supabaseInfo = data;
             this.supabase = createClient(this.supabaseInfo.url, this.supabaseInfo.key, {
                 accessToken: () => Promise.resolve(this.getToken())
             });
@@ -84,12 +77,12 @@ export class PluginController {
             if (this.supabaseInfo && this.supabaseInfo.expiration && this.supabaseInfo.expiration > new Date()) {
                 return this.supabaseInfo.token;
             }
-            const response = yield this.request("getSupabaseAccess");
+            const { data } = yield EventBus.request(this.pluginId, "global.supabase.requestAccess");
             if (!this.supabaseInfo) {
                 throw new Error("Supabase info not found");
             }
-            this.supabaseInfo.token = response.token;
-            this.supabaseInfo.expiration = response.expiration;
+            this.supabaseInfo.token = data.token;
+            this.supabaseInfo.expiration = data.expiration;
             return this.supabaseInfo.token;
         });
     }
@@ -99,40 +92,22 @@ export class PluginController {
         }
         return this.supabaseInfo.url;
     }
-    emit(eventName, data) {
-        this.internalEmit(eventName, 0, data);
-    }
-    // the communication needs to have an id to be able to distinguish between different responses
-    internalEmit(eventName, id, data) {
-        this.init().then(() => this.plugin.emitToParent(eventName, { data, _id: id, secret: this.getSecret() }));
-    }
-    subscribe(eventName, callback) {
-        var _a;
-        if (!this.listeners.has(eventName)) {
-            this.listeners.set(eventName, []);
+    getGlobalEventTopic(preliminaryTopic) {
+        var _a, _b, _c;
+        if (preliminaryTopic.startsWith("global.")) {
+            return preliminaryTopic;
         }
-        (_a = this.listeners.get(eventName)) === null || _a === void 0 ? void 0 : _a.push(callback);
-    }
-    onOnce(eventName, callback) {
-        var _a;
-        if (!this.onceListeners.has(eventName)) {
-            this.onceListeners.set(eventName, []);
+        if (preliminaryTopic.startsWith("self.")) {
+            return preliminaryTopic;
         }
-        (_a = this.onceListeners.get(eventName)) === null || _a === void 0 ? void 0 : _a.push(callback);
-    }
-    request(topic_1) {
-        return __awaiter(this, arguments, void 0, function* (topic, data = {}) {
-            return yield new Promise((resolve) => {
-                let triggered = false;
-                const id = Math.random();
-                this.internalEmit(topic, id, data);
-                this.subscribe(topic, (_id, data) => {
-                    if (triggered || (_id !== id && _id !== 0))
-                        return;
-                    triggered = true;
-                    resolve(data);
-                });
-            });
-        });
+        const topicParts = preliminaryTopic.split(".");
+        if (topicParts.length === 3) {
+            if (![(_a = this.supabaseInfo) === null || _a === void 0 ? void 0 : _a.pluginId, "global"].includes(topicParts[0])) {
+                throw new Error("The event topic must start with the plugin id or 'global'.");
+            }
+            return preliminaryTopic;
+        }
+        const topicRoot = (_c = (_b = this.supabaseInfo) === null || _b === void 0 ? void 0 : _b.pluginId) !== null && _c !== void 0 ? _c : "global";
+        return `${topicRoot}.${preliminaryTopic}`;
     }
 }

package/dist/plugin/RimoriClient.d.ts

@@ -1,25 +1,95 @@
 import { PluginController } from "./PluginController";
 import { SupabaseClient } from "@supabase/supabase-js";
+import { EventBusMessage, EventPayload } from "./fromRimori/EventBus";
 import { GenericSchema } from "@supabase/supabase-js/dist/module/lib/types";
 import { PostgrestQueryBuilder, PostgrestFilterBuilder } from "@supabase/postgrest-js";
 import { BasicAssignment } from "../controller/SharedContentController";
 import { Message, Tool, OnLLMResponse } from "../controller/AIController";
 import { ObjectRequest } from "../controller/ObjectController";
 import { Plugin } from "../controller/SidePluginController";
-export declare class RimoriClient {
-    private static instance;
-    private superbase;
-    private plugin;
+import { UserInfo } from "../controller/SettingsController";
+import { EventHandler } from "./fromRimori/EventBus";
+interface Db {
+    from: {
+        <TableName extends string & keyof GenericSchema['Tables'], Table extends GenericSchema['Tables'][TableName]>(relation: TableName): PostgrestQueryBuilder<GenericSchema, Table, TableName>;
+        <ViewName extends string & keyof GenericSchema['Views'], View extends GenericSchema['Views'][ViewName]>(relation: ViewName): PostgrestQueryBuilder<GenericSchema, View, ViewName>;
+    };
+    rpc: <Fn extends GenericSchema['Functions'][string], FnName extends string & keyof GenericSchema['Functions']>(functionName: FnName, args?: Fn["Args"], options?: {
+        head?: boolean;
+        get?: boolean;
+        count?: "exact" | "planned" | "estimated";
+    }) => PostgrestFilterBuilder<GenericSchema, Fn["Returns"] extends any[] ? Fn["Returns"][number] extends Record<string, unknown> ? Fn["Returns"][number] : never : never, Fn["Returns"], string, null>;
     functions: SupabaseClient["functions"];
     storage: SupabaseClient["storage"];
+}
+interface PluginInterface {
     pluginId: string;
     tablePrefix: string;
+    setSettings: (settings: any) => Promise<void>;
+    /**
+     * Get the settings for the plugin. T can be any type of settings, UserSettings or SystemSettings.
+     * @param defaultSettings The default settings to use if no settings are found.
+     * @param genericSettings The type of settings to get.
+     * @returns The settings for the plugin.
+     */
+    getSettings: <T extends object>(defaultSettings: T) => Promise<T>;
+    /**
+    * Fetches all installed plugins.
+    * @returns A promise that resolves to an array of plugins
+    */
+    getInstalled: () => Promise<Plugin[]>;
+    getUserInfo: () => Promise<UserInfo>;
+}
+export declare class RimoriClient {
+    private static instance;
+    private superbase;
+    private pluginController;
     private settingsController;
     private sharedContentController;
+    private supabaseUrl;
+    db: Db;
+    plugin: PluginInterface;
     private constructor();
+    event: {
+        /**
+         * Emit an event to Rimori or a plugin.
+         * The topic schema is:
+         * {pluginId}.{eventId}
+         * Check out the event bus documentation for more information.
+         * For triggering events from Rimori like context menu actions use the "global" keyword.
+         * @param topic The topic to emit the event on.
+         * @param data The data to emit.
+         * @param eventId The event id.
+         */
+        emit: (topic: string, data: any, eventId?: number) => void;
+        /**
+         * Request an event.
+         * @param topic The topic to request the event on.
+         * @param data The data to request.
+         * @returns The response from the event.
+         */
+        request: <T>(topic: string, data?: any) => Promise<EventBusMessage<T>>;
+        /**
+         * Subscribe to an event.
+         * @param topic The topic to subscribe to.
+         * @param callback The callback to call when the event is emitted.
+         */
+        on: <T = EventPayload>(topic: string, callback: EventHandler<T>) => void;
+        /**
+         * Subscribe to an event once.
+         * @param topic The topic to subscribe to.
+         * @param callback The callback to call when the event is emitted.
+         */
+        once: <T = EventPayload>(topic: string, callback: EventHandler<T>) => void;
+        /**
+         * Respond to an event.
+         * @param topic The topic to respond to.
+         * @param data The data to respond with.
+         */
+        respond: <T = EventPayload>(topic: string, data: EventPayload | ((data: EventBusMessage<T>) => EventPayload | Promise<EventPayload>)) => void;
+    };
     static getInstance(pluginController: PluginController): Promise<RimoriClient>;
-    from<TableName extends string & keyof GenericSchema['Tables'], Table extends GenericSchema['Tables'][TableName]>(relation: TableName): PostgrestQueryBuilder<GenericSchema, Table, TableName>;
-    from<ViewName extends string & keyof GenericSchema['Views'], View extends GenericSchema['Views'][ViewName]>(relation: ViewName): PostgrestQueryBuilder<GenericSchema, View, ViewName>;
+    private from;
     /**
     * Perform a function call.
     *
@@ -43,33 +113,15 @@ export declare class RimoriClient {
     * `"estimated"`: Uses exact count for low numbers and planned count for high
     * numbers.
     */
-    rpc<Fn extends GenericSchema['Functions'][string], FnName extends string & keyof GenericSchema['Functions']>(functionName: FnName, args?: Fn['Args'], options?: {
-        head?: boolean;
-        get?: boolean;
-        count?: 'exact' | 'planned' | 'estimated';
-    }): PostgrestFilterBuilder<GenericSchema, Fn['Returns'] extends any[] ? Fn['Returns'][number] extends Record<string, unknown> ? Fn['Returns'][number] : never : never, Fn['Returns'], string, null>;
+    private rpc;
     private getTableName;
-    subscribe(eventName: string, callback: (_id: number, data: any) => void): void;
-    request<T>(eventName: string, data?: any): Promise<T>;
-    emit(eventName: string, data: any): void;
-    /**
-    * Get the settings for the plugin. T can be any type of settings, UserSettings or SystemSettings.
-    * @param defaultSettings The default settings to use if no settings are found.
-    * @param genericSettings The type of settings to get.
-    * @returns The settings for the plugin.
-    */
-    getSettings<T extends object>(defaultSettings: T, genericSettings?: "user" | "system"): Promise<T>;
-    setSettings(settings: any, genericSettings?: "user" | "system"): Promise<void>;
-    getAIResponse(messages: Message[], tools?: Tool[]): Promise<string>;
-    getAIResponseStream(messages: Message[], onMessage: OnLLMResponse, tools?: Tool[]): Promise<void>;
-    getVoiceResponse(text: string, voice?: string, speed?: number, language?: string): Promise<Blob>;
-    getVoiceToTextResponse(file: Blob): Promise<string>;
-    /**
-     * Fetches all installed plugins.
-     * @returns A promise that resolves to an array of plugins
-     */
-    getPlugins(): Promise<Plugin[]>;
-    generateObject(request: ObjectRequest): Promise<any>;
+    llm: {
+        getText: (messages: Message[], tools?: Tool[]) => Promise<string>;
+        getSteamedText: (messages: Message[], onMessage: OnLLMResponse, tools?: Tool[]) => Promise<void>;
+        getVoice: (text: string, voice?: string, speed?: number, language?: string) => Promise<Blob>;
+        getTextFromVoice: (file: Blob) => Promise<string>;
+        getObject: (request: ObjectRequest) => Promise<any>;
+    };
     /**
      * Fetch new shared content.
      * @param type The type of shared content to fetch. E.g. assignments, exercises, etc.
@@ -96,3 +148,4 @@ export declare class RimoriClient {
     completeSharedContent(type: string, assignmentId: string): Promise<void>;
     triggerSidebarAction(pluginId: string, actionKey: string, text?: string): void;
 }
+export {};

package/dist/plugin/RimoriClient.js

@@ -13,28 +13,109 @@ import { SharedContentController } from "../controller/SharedContentController";
 import { streamChatGPT, generateText } from "../controller/AIController";
 import { generateObject as generateObjectFunction } from "../controller/ObjectController";
 import { getPlugins } from "../controller/SidePluginController";
+import { EventBus } from "./fromRimori/EventBus";
 export class RimoriClient {
     constructor(options) {
+        this.event = {
+            /**
+             * Emit an event to Rimori or a plugin.
+             * The topic schema is:
+             * {pluginId}.{eventId}
+             * Check out the event bus documentation for more information.
+             * For triggering events from Rimori like context menu actions use the "global" keyword.
+             * @param topic The topic to emit the event on.
+             * @param data The data to emit.
+             * @param eventId The event id.
+             */
+            emit: (topic, data, eventId) => {
+                const globalTopic = this.pluginController.getGlobalEventTopic(topic);
+                EventBus.emit(this.plugin.pluginId, globalTopic, data, eventId);
+            },
+            /**
+             * Request an event.
+             * @param topic The topic to request the event on.
+             * @param data The data to request.
+             * @returns The response from the event.
+             */
+            request: (topic, data) => {
+                const globalTopic = this.pluginController.getGlobalEventTopic(topic);
+                return EventBus.request(this.plugin.pluginId, globalTopic, data);
+            },
+            /**
+             * Subscribe to an event.
+             * @param topic The topic to subscribe to.
+             * @param callback The callback to call when the event is emitted.
+             */
+            on: (topic, callback) => {
+                EventBus.on(this.pluginController.getGlobalEventTopic(topic), callback);
+            },
+            /**
+             * Subscribe to an event once.
+             * @param topic The topic to subscribe to.
+             * @param callback The callback to call when the event is emitted.
+             */
+            once: (topic, callback) => {
+                EventBus.once(this.pluginController.getGlobalEventTopic(topic), callback);
+            },
+            /**
+             * Respond to an event.
+             * @param topic The topic to respond to.
+             * @param data The data to respond with.
+             */
+            respond: (topic, data) => {
+                EventBus.respond(this.plugin.pluginId, this.pluginController.getGlobalEventTopic(topic), data);
+            }
+        };
+        this.llm = {
+            getText: (messages, tools) => __awaiter(this, void 0, void 0, function* () {
+                const token = yield this.pluginController.getToken();
+                return generateText(this.supabaseUrl, messages, tools || [], token).then(response => response.messages[0].content[0].text);
+            }),
+            getSteamedText: (messages, onMessage, tools) => __awaiter(this, void 0, void 0, function* () {
+                const token = yield this.pluginController.getToken();
+                streamChatGPT(this.supabaseUrl, messages, tools || [], onMessage, token);
+            }),
+            getVoice: (text_1, ...args_1) => __awaiter(this, [text_1, ...args_1], void 0, function* (text, voice = "alloy", speed = 1, language) {
+                return getTTSResponse(this.pluginController.getSupabaseUrl(), { input: text, voice, speed, language }, yield this.pluginController.getToken());
+            }),
+            getTextFromVoice: (file) => {
+                return getSTTResponse(this.superbase, file);
+            },
+            getObject: (request) => __awaiter(this, void 0, void 0, function* () {
+                const token = yield this.pluginController.getToken();
+                return generateObjectFunction(this.pluginController.getSupabaseUrl(), request, token);
+            }),
+            // getSteamedObject: this.generateObjectStream,
+        };
         this.superbase = options.supabase;
-        this.pluginId = options.pluginId;
-        this.plugin = options.pluginController;
-        this.tablePrefix = options.tablePrefix;
-        this.storage = this.superbase.storage;
-        this.functions = this.superbase.functions;
+        this.pluginController = options.pluginController;
         this.settingsController = new SettingsController(options.supabase, options.pluginId);
         this.sharedContentController = new SharedContentController(this);
+        this.supabaseUrl = this.pluginController.getSupabaseUrl();
         this.rpc = this.rpc.bind(this);
         this.from = this.from.bind(this);
-        this.emit = this.emit.bind(this);
-        this.request = this.request.bind(this);
-        this.subscribe = this.subscribe.bind(this);
-        this.getSettings = this.getSettings.bind(this);
-        this.setSettings = this.setSettings.bind(this);
-        this.getAIResponse = this.getAIResponse.bind(this);
-        this.generateObject = this.generateObject.bind(this);
-        this.getVoiceResponse = this.getVoiceResponse.bind(this);
-        this.getAIResponseStream = this.getAIResponseStream.bind(this);
-        this.getVoiceToTextResponse = this.getVoiceToTextResponse.bind(this);
+        this.db = {
+            rpc: this.rpc,
+            from: this.from,
+            storage: this.superbase.storage,
+            functions: this.superbase.functions,
+        };
+        this.plugin = {
+            pluginId: options.pluginId,
+            tablePrefix: options.tablePrefix,
+            setSettings: (settings) => __awaiter(this, void 0, void 0, function* () {
+                yield this.settingsController.setSettings(settings);
+            }),
+            getSettings: (defaultSettings) => __awaiter(this, void 0, void 0, function* () {
+                return yield this.settingsController.getSettings(defaultSettings);
+            }),
+            getInstalled: () => __awaiter(this, void 0, void 0, function* () {
+                return getPlugins(this.superbase);
+            }),
+            getUserInfo: () => __awaiter(this, void 0, void 0, function* () {
+                return this.settingsController.getUserInfo();
+            })
+        };
     }
     static getInstance(pluginController) {
         return __awaiter(this, void 0, void 0, function* () {
@@ -75,67 +156,7 @@ export class RimoriClient {
         return this.superbase.rpc(this.getTableName(functionName), args, options);
     }
     getTableName(type) {
-        return this.tablePrefix + "_" + type;
-    }
-    subscribe(eventName, callback) {
-        this.plugin.subscribe(eventName, callback);
-    }
-    request(eventName, data) {
-        return this.plugin.request(eventName, data);
-    }
-    emit(eventName, data) {
-        this.plugin.emit(eventName, data);
-    }
-    /**
-    * Get the settings for the plugin. T can be any type of settings, UserSettings or SystemSettings.
-    * @param defaultSettings The default settings to use if no settings are found.
-    * @param genericSettings The type of settings to get.
-    * @returns The settings for the plugin.
-    */
-    getSettings(defaultSettings, genericSettings) {
-        return __awaiter(this, void 0, void 0, function* () {
-            return this.settingsController.getSettings(defaultSettings, genericSettings);
-        });
-    }
-    setSettings(settings, genericSettings) {
-        return __awaiter(this, void 0, void 0, function* () {
-            yield this.settingsController.setSettings(settings, genericSettings);
-        });
-    }
-    getAIResponse(messages, tools) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const token = yield this.plugin.getToken();
-            return generateText(messages, tools || [], token).then(response => response.messages[0].content[0].text);
-        });
-    }
-    getAIResponseStream(messages, onMessage, tools) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const token = yield this.plugin.getToken();
-            streamChatGPT(messages, tools || [], onMessage, token);
-        });
-    }
-    getVoiceResponse(text_1) {
-        return __awaiter(this, arguments, void 0, function* (text, voice = "alloy", speed = 1, language) {
-            return getTTSResponse(this.plugin.getSupabaseUrl(), { input: text, voice, speed, language }, yield this.plugin.getToken());
-        });
-    }
-    getVoiceToTextResponse(file) {
-        return getSTTResponse(this.superbase, file);
-    }
-    /**
-     * Fetches all installed plugins.
-     * @returns A promise that resolves to an array of plugins
-     */
-    getPlugins() {
-        return __awaiter(this, void 0, void 0, function* () {
-            return getPlugins(this.superbase);
-        });
-    }
-    generateObject(request) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const token = yield this.plugin.getToken();
-            return generateObjectFunction(request, token);
-        });
+        return this.plugin.tablePrefix + "_" + type;
     }
     /**
      * Fetch new shared content.
@@ -171,6 +192,6 @@ export class RimoriClient {
         });
     }
     triggerSidebarAction(pluginId, actionKey, text) {
-        this.emit("triggerSidebarAction", { pluginId, actionKey, text });
+        this.event.emit("global.sidebar.triggerAction", { pluginId, actionKey, text });
     }
 }

package/dist/plugin/ThemeSetter.js

@@ -1,13 +1,13 @@
 export function setTheme() {
     const urlParams = new URLSearchParams(window.location.search);
     let theme = urlParams.get('theme');
-    const isSidebar = urlParams.get('applicationMode') === "sidebar";
     if (!theme || theme === 'system') {
         theme = window.matchMedia && window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light';
     }
     document.documentElement.classList.add("dark:text-gray-200", "bg-white");
     if (theme === 'dark') {
-        document.documentElement.classList.add('dark', isSidebar ? "bg-gray-920" : "bg-gray-950");
-        document.documentElement.style.background = isSidebar ? "rgb(6, 12, 30)" : "rgb(3, 7, 18)";
+        document.documentElement.setAttribute("data-theme", "dark");
+        document.documentElement.classList.add('dark', "bg-gray-950");
+        document.documentElement.style.background = "hsl(var(--background))";
     }
 }

package/dist/plugin/fromRimori/EventBus.d.ts

@@ -0,0 +1,98 @@
+export type EventPayload = Record<string, any>;
+/**
+ * Interface representing a message sent through the EventBus
+ *
+ * Debug capabilities:
+ * - System-wide debugging: Send an event to "global.system.requestDebug"
+ *   Example: `EventBus.emit("yourPluginId", "global.system.requestDebug");`
+ */
+export interface EventBusMessage<T = EventPayload> {
+    timestamp: string;
+    eventId: number;
+    sender: string;
+    topic: string;
+    data: T;
+    debug: boolean;
+}
+export type EventHandler<T = EventPayload> = (event: EventBusMessage<T>) => void | Promise<void>;
+export declare class EventBusHandler {
+    private listeners;
+    private responseResolvers;
+    private static instance;
+    private debugEnabled;
+    private evName;
+    private constructor();
+    static getInstance(name?: string): EventBusHandler;
+    private createEvent;
+    /**
+     * Emits an event to the event bus. Can be a new event or a response to a request.
+     * @param sender - The sender of the event.
+     * @param topic - The topic of the event.
+     * @param data - The data of the event.
+     * @param eventId - The event id of the event.
+     *
+     * The topic format is: **pluginId.area.action**
+     *
+     * Example topics:
+     * - pl1234.card.requestHard
+     * - pl1234.card.requestNew
+     * - pl1234.card.requestAll
+     * - pl1234.card.create
+     * - pl1234.card.update
+     * - pl1234.card.delete
+     * - pl1234.card.triggerBackup
+     */
+    emit<T = EventPayload>(sender: string, topic: string, data?: T, eventId?: number): void;
+    private emitInternal;
+    /**
+     * Subscribes to an event on the event bus.
+     * @param topics - The topic of the event.
+     * @param handler - The handler to be called when the event is emitted.
+     * @param ignoreSender - The senders to ignore.
+     * @returns The ids of the listeners.
+     */
+    on<T = EventPayload>(topics: string | string[], handler: EventHandler<T>, ignoreSender?: string[]): string[];
+    /**
+     * Subscribes to an event, processes the data and emits a response on the event bus.
+     * @param sender - The sender of the event.
+     * @param topic - The topic of the event.
+     * @param handler - The handler to be called when the event is received. The handler returns the data to be emitted. Can be a static object or a function.
+     * @returns The ids of the listeners.
+     */
+    respond(sender: string, topic: string, handler: EventPayload | ((data: EventBusMessage) => EventPayload | Promise<EventPayload>)): string[];
+    /**
+     * Subscribes to an event on the event bus. The handler will be called once and then removed.
+     * @param topic - The topic of the event.
+     * @param handler - The handler to be called when the event is emitted.
+     */
+    once<T = EventPayload>(topic: string, handler: EventHandler<T>): void;
+    /**
+     * Unsubscribes from an event on the event bus.
+     * @param listenerIds - The ids of the listeners to unsubscribe from.
+     */
+    off(listenerIds: string | string[]): void;
+    private toArray;
+    /**
+     * Requests data from the event bus.
+     * @param sender - The sender of the event.
+     * @param topic - The topic of the event.
+     * @param data - The data of the event.
+     * @returns A promise that resolves to the event.
+     */
+    request<T = EventPayload>(sender: string, topic: string, data?: EventPayload): Promise<EventBusMessage<T>>;
+    /**
+     * Gets the matching handlers for an event.
+     * @param topic - The topic of the event.
+     * @returns A set of handlers that match the event type.
+     */
+    private getMatchingHandlers;
+    /**
+     * Validates the topic of an event.
+     * @param topic - The topic of the event.
+     * @returns True if the topic is valid, false otherwise.
+     */
+    private validateTopic;
+    private logIfDebug;
+    private logAndThrowError;
+}
+export declare const EventBus: EventBusHandler;