@rimori/react-client 0.1.0 → 0.1.1

package/dist/rimori-client/src/fromRimori/EventBus.js

@@ -1,263 +0,0 @@
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
-export class EventBusHandler {
-    constructor() {
-        this.listeners = new Map();
-        this.responseResolvers = new Map();
-        this.debugEnabled = false;
-        this.evName = "";
-        //private constructor
-    }
-    static getInstance(name) {
-        if (!EventBusHandler.instance) {
-            EventBusHandler.instance = new EventBusHandler();
-            EventBusHandler.instance.on("global.system.requestDebug", () => {
-                EventBusHandler.instance.debugEnabled = true;
-                console.log(`[${EventBusHandler.instance.evName}] Debug mode enabled. Make sure debugging messages are enabled in the browser console.`);
-            });
-        }
-        if (name && EventBusHandler.instance.evName === "") {
-            EventBusHandler.instance.evName = name;
-        }
-        return EventBusHandler.instance;
-    }
-    createEvent(sender, topic, data, eventId) {
-        const generatedEventId = eventId || Math.floor(Math.random() * 10000000000);
-        return {
-            eventId: generatedEventId,
-            timestamp: new Date().toISOString(),
-            sender,
-            topic,
-            data,
-            debug: this.debugEnabled,
-        };
-    }
-    /**
-     * 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(sender, topic, data, eventId) {
-        this.emitInternal(sender, topic, data || {}, eventId);
-    }
-    emitInternal(sender, topic, data, eventId, skipResponseTrigger = false) {
-        if (!this.validateTopic(topic)) {
-            this.logAndThrowError(false, `Invalid topic: ` + topic);
-            return;
-        }
-        const event = this.createEvent(sender, topic, data, eventId);
-        const handlers = this.getMatchingHandlers(event.topic);
-        handlers.forEach(handler => {
-            if (handler.ignoreSender && handler.ignoreSender.includes(sender)) {
-                // console.log("ignore event as its in the ignoreSender list", { event, ignoreList: handler.ignoreSender });
-                return;
-            }
-            handler.handler(event);
-        });
-        this.logIfDebug(`Emitting event to ` + topic, event);
-        if (handlers.size === 0) {
-            this.logAndThrowError(false, `No handlers found for topic: ` + topic);
-        }
-        // If it's a response to a request
-        if (eventId && this.responseResolvers.has(eventId) && !skipResponseTrigger) {
-            // console.log("[Rimori] Resolving response to request: " + eventId, event.data);
-            this.responseResolvers.get(eventId)(event);
-            this.responseResolvers.delete(eventId);
-        }
-    }
-    /**
-     * 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 An EventListener object containing an off() method to unsubscribe the listeners.
-     */
-    on(topics, handler, ignoreSender = []) {
-        const ids = this.toArray(topics).map(topic => {
-            this.logIfDebug(`Subscribing to ` + topic, { ignoreSender });
-            if (!this.validateTopic(topic)) {
-                this.logAndThrowError(true, `Invalid topic: ` + topic);
-            }
-            if (!this.listeners.has(topic)) {
-                this.listeners.set(topic, new Set());
-            }
-            const id = Math.floor(Math.random() * 10000000000);
-            // Type assertion to handle the generic type mismatch
-            const eventHandler = handler;
-            this.listeners.get(topic).add({ id, handler: eventHandler, ignoreSender });
-            this.logIfDebug(`Subscribed to ` + topic, { listenerId: id, ignoreSender });
-            return btoa(JSON.stringify({ topic, id }));
-        });
-        return {
-            off: () => this.off(ids)
-        };
-    }
-    /**
-     * 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 An EventListener object containing an off() method to unsubscribe the listeners.
-     */
-    respond(sender, topic, handler) {
-        const topics = Array.isArray(topic) ? topic : [topic];
-        const listeners = topics.map(topic => {
-            const blackListedEventIds = [];
-            //To allow event communication inside the same plugin the sender needs to be ignored but the events still need to be checked for the same event just reaching the subscriber to prevent infinite loops
-            const finalIgnoreSender = !topic.startsWith("self.") ? [sender] : [];
-            const listener = this.on(topic, (data) => __awaiter(this, void 0, void 0, function* () {
-                if (blackListedEventIds.includes(data.eventId)) {
-                    // console.log("BLACKLISTED EVENT ID", data.eventId);
-                    return;
-                }
-                blackListedEventIds.push(data.eventId);
-                if (blackListedEventIds.length > 20) {
-                    blackListedEventIds.shift();
-                }
-                const response = typeof handler === "function" ? yield handler(data) : handler;
-                this.emit(sender, topic, response, data.eventId);
-            }), finalIgnoreSender);
-            this.logIfDebug(`Added respond listener ` + sender + " to topic " + topic, { listener, sender });
-            return {
-                off: () => listener.off()
-            };
-        });
-        return {
-            off: () => listeners.forEach(listener => listener.off())
-        };
-    }
-    /**
-     * 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(topic, handler) {
-        if (!this.validateTopic(topic)) {
-            this.logAndThrowError(false, `Invalid topic: ` + topic);
-            return;
-        }
-        let listener;
-        const wrapper = (event) => {
-            handler(event);
-            listener === null || listener === void 0 ? void 0 : listener.off();
-        };
-        listener = this.on(topic, wrapper);
-        this.logIfDebug(`Added once listener ` + topic, { listener, topic });
-    }
-    /**
-     * Unsubscribes from an event on the event bus.
-     * @param listenerIds - The ids of the listeners to unsubscribe from.
-     */
-    off(listenerIds) {
-        this.toArray(listenerIds).forEach(fullId => {
-            const { topic, id } = JSON.parse(atob(fullId));
-            const listeners = this.listeners.get(topic) || new Set();
-            listeners.forEach(listener => {
-                if (listener.id === Number(id)) {
-                    listeners.delete(listener);
-                    this.logIfDebug(`Removed listener ` + fullId, { topic, listenerId: id });
-                }
-            });
-        });
-    }
-    toArray(item) {
-        return Array.isArray(item) ? item : [item];
-    }
-    /**
-     * 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(sender, topic, data) {
-        return __awaiter(this, void 0, void 0, function* () {
-            if (!this.validateTopic(topic)) {
-                this.logAndThrowError(true, `Invalid topic: ` + topic);
-            }
-            const event = this.createEvent(sender, topic, data || {});
-            this.logIfDebug(`Requesting data from ` + topic, { event });
-            return new Promise(resolve => {
-                this.responseResolvers.set(event.eventId, (value) => resolve(value));
-                this.emitInternal(sender, topic, data || {}, event.eventId, true);
-            });
-        });
-    }
-    /**
-     * Gets the matching handlers for an event.
-     * @param topic - The topic of the event.
-     * @returns A set of handlers that match the event type.
-     */
-    getMatchingHandlers(topic) {
-        const exact = this.listeners.get(topic) || new Set();
-        // Find wildcard matches
-        const wildcard = [...this.listeners.entries()]
-            .filter(([key]) => key.endsWith("*") && topic.startsWith(key.slice(0, -1)))
-            .flatMap(([_, handlers]) => [...handlers]);
-        return new Set([...exact, ...wildcard]);
-    }
-    /**
-     * Validates the topic of an event.
-     * @param topic - The topic of the event.
-     * @returns True if the topic is valid, false otherwise.
-     */
-    validateTopic(topic) {
-        // Split event type into parts
-        const parts = topic.split(".");
-        const [plugin, area, action] = parts;
-        if (parts.length !== 3) {
-            if (parts.length === 1 && plugin === "*") {
-                return true;
-            }
-            if (parts.length === 2 && plugin !== "*" && area === "*") {
-                return true;
-            }
-            this.logAndThrowError(false, `Event type must have 3 parts separated by dots. Received: ` + topic);
-            return false;
-        }
-        if (action === "*") {
-            return true;
-        }
-        // Validate action part
-        const validActions = ["request", "create", "update", "delete", "trigger"];
-        if (validActions.some(a => action.startsWith(a))) {
-            return true;
-        }
-        this.logAndThrowError(false, `Invalid event topic name. The action: ` + action + ". Must be or start with one of: " + validActions.join(", "));
-        return false;
-    }
-    logIfDebug(...args) {
-        if (this.debugEnabled) {
-            console.debug(`[${this.evName}] ` + args[0], ...args.slice(1));
-        }
-    }
-    logAndThrowError(throwError, ...args) {
-        const message = `[${this.evName}] ` + args[0];
-        console.error(message, ...args.slice(1));
-        if (throwError) {
-            throw new Error(message);
-        }
-    }
-}
-EventBusHandler.instance = null;
-export const EventBus = EventBusHandler.getInstance();

package/dist/rimori-client/src/fromRimori/PluginTypes.d.ts

@@ -1,174 +0,0 @@
-export type Plugin<T extends {} = {}> = Omit<RimoriPluginConfig<T>, 'context_menu_actions'> & {
-    version: string;
-    endpoint: string;
-    assetEndpoint: string;
-    context_menu_actions: MenuEntry[];
-    release_channel: "alpha" | "beta" | "stable";
-};
-export type ActivePlugin = Plugin<{
-    active?: boolean;
-}>;
-export interface PluginPage {
-    id: string;
-    name: string;
-    url: string;
-    show: boolean;
-    description: string;
-    root: "vocabulary" | "grammar" | "reading" | "listening" | "watching" | "writing" | "speaking" | "other" | "community";
-    action?: {
-        key: string;
-        parameters: ObjectTool;
-    };
-}
-export interface SidebarPage {
-    id: string;
-    name: string;
-    description: string;
-    url: string;
-    icon: string;
-}
-export interface MenuEntry {
-    plugin_id: string;
-    action_key: string;
-    text: string;
-    icon?: React.ReactNode;
-}
-export type MainPanelAction = {
-    plugin_id: string;
-    action_key: string;
-} & Record<string, string>;
-export interface ContextMenuAction {
-    text: string;
-    plugin_id: string;
-    action_key: string;
-}
-/**
- * Rimori plugin structure representing the complete configuration
- * of a Rimori plugin with all metadata and configuration options.
- */
-export interface RimoriPluginConfig<T extends {} = {}> {
-    id: string;
-    /**
-     * Basic information about the plugin including branding and core details.
-     */
-    info: {
-        /** The display name of the plugin shown to users */
-        title: string;
-        /** Detailed description introducing the plugin */
-        description: string;
-        /** relative or absolute URL or path to the plugin's logo/icon image */
-        logo: string;
-        /** Optional website URL for the plugin's homepage or link to plugins owner for contributions */
-        website?: string;
-    };
-    /**
-     * Configuration for different types of pages.
-     */
-    pages: {
-        /** Optional external URL where the plugin is hosted instead of the default CDN */
-        external_hosted_url?: string;
-        /** Array of main plugin pages that appear in the application's main navigation (can be disabled using the 'show' flag) */
-        main: (PluginPage & T)[];
-        /** Array of sidebar pages that appear in the sidebar for quick access (can be disabled using the 'show' flag) */
-        sidebar: (SidebarPage & T)[];
-        /** Optional path to the plugin's settings/configuration page */
-        settings?: string;
-        /** Optional array of event topics the plugin pages can listen to for cross-plugin communication */
-        topics?: string[];
-    };
-    /**
-     * Context menu actions that the plugin registers to appear in right-click menus throughout the application.
-     */
-    context_menu_actions: Omit<MenuEntry, "plugin_id">[];
-    /**
-     * Documentation paths for different types of plugin documentation.
-     */
-    documentation: {
-        /** Path to the general overview documentation. It's shown upon installation of the plugin. */
-        overview_path: string;
-        /** Path to user-facing documentation and guides */
-        user_path: string;
-        /** Path to developer documentation for plugin development */
-        developer_path: string;
-    };
-    /**
-     * Configuration for the plugin's web worker if it uses background processing or exposes actions to other plugins.
-     */
-    worker?: {
-        /** Relative path to the web worker JavaScript file. Mostly it's 'web-worker.js' which is located in the public folder. */
-        url: string;
-        /** Optional array of event topics the worker should listen to in addition to events having the pluginId in the topic. Can be a wildcard. Example: 'global.topic.*' or 'pluginId.*' */
-        topics?: string[];
-    };
-}
-export interface Tool {
-    name: string;
-    description: string;
-    parameters: {
-        name: string;
-        description: string;
-        type: "string" | "number" | "boolean";
-    }[];
-    execute?: (args: Record<string, any>) => Promise<unknown> | unknown | void;
-}
-/**
- * The tool definition structure is used for LLM function calling and plugin action parameters.
- * It defines the schema for tools that can be used by Language Learning Models (LLMs)
- * and plugin actions.
- *
- * @example
- * ```typescript
- * const flashcardTool: Tool = {
- *   total_amount: {
- *     type: 'string',
- *     enum: ['default', '10', '20', '50'],
- *     description: 'Number of flashcards to practice'
- *   },
- *   deck: {
- *     type: 'string',
- *     enum: ['latest', 'random', 'oldest', 'mix', 'best_known'],
- *     description: 'Type of deck to practice'
- *   }
- * };
- * ```
- *
- */
-export type ObjectTool = {
-    [key: string]: ToolParameter;
-};
-/**
- * Parameter definition for LLM tools and plugin actions.
- * Defines the structure, validation rules, and metadata for individual tool parameters.
- * Used to create type-safe interfaces between LLMs, plugins, and the Rimori platform.
- */
-interface ToolParameter {
-    /** The data type of the parameter - can be primitive, nested object, or array */
-    type: ToolParameterType;
-    /** Human-readable description of the parameter's purpose and usage */
-    description: string;
-    /** Optional array of allowed values for enumerated parameters */
-    enum?: string[];
-    /** Whether the parameter is optional */
-    optional?: boolean;
-}
-/**
- * Union type defining all possible parameter types for LLM tools.
- * Supports primitive types, nested objects for complex data structures,
- * and arrays of objects for collections. The tuple notation [{}] indicates
- * arrays of objects with a specific structure.
- *
- * @example Primitive: 'string' | 'number' | 'boolean'
- * @example Nested object: { name: { type: 'string' }, age: { type: 'number' } }
- * @example Array of objects: [{ id: { type: 'string' }, value: { type: 'number' } }]
- */
-type ToolParameterType = PrimitiveType | {
-    [key: string]: ToolParameter;
-} | [{
-    [key: string]: ToolParameter;
-}];
-/**
- * Primitive data types supported by the LLM tool system.
- * These align with JSON schema primitive types and TypeScript basic types.
- */
-type PrimitiveType = 'string' | 'number' | 'boolean';
-export {};

package/dist/rimori-client/src/fromRimori/PluginTypes.js

@@ -1 +0,0 @@
-export {};

package/dist/rimori-client/src/index.d.ts

@@ -1,11 +0,0 @@
-export * from './plugin/CommunicationHandler';
-export * from './cli/types/DatabaseTypes';
-export * from './utils/difficultyConverter';
-export * from './fromRimori/PluginTypes';
-export * from './fromRimori/EventBus';
-export * from './plugin/RimoriClient';
-export * from './plugin/StandaloneClient';
-export { AudioController } from './controller/AudioController';
-export { Translator } from './controller/TranslationController';
-export type { Message, ToolInvocation } from './controller/AIController';
-export type { TOptions } from 'i18next';

package/dist/rimori-client/src/index.js

@@ -1,10 +0,0 @@
-// Re-export everything
-export * from './plugin/CommunicationHandler';
-export * from './cli/types/DatabaseTypes';
-export * from './utils/difficultyConverter';
-export * from './fromRimori/PluginTypes';
-export * from './fromRimori/EventBus';
-export * from './plugin/RimoriClient';
-export * from './plugin/StandaloneClient';
-export { AudioController } from './controller/AudioController';
-export { Translator } from './controller/TranslationController';

package/dist/rimori-client/src/plugin/CommunicationHandler.d.ts

@@ -1,48 +0,0 @@
-import { SupabaseClient } from '@supabase/supabase-js';
-import { UserInfo } from '../controller/SettingsController';
-import { ActivePlugin, Plugin } from '../fromRimori/PluginTypes';
-export interface Guild {
-    id: string;
-    longTermGoalOverride: string;
-    allowUserPluginSettings: boolean;
-}
-export interface RimoriInfo {
-    url: string;
-    key: string;
-    backendUrl: string;
-    token: string;
-    expiration: Date;
-    tablePrefix: string;
-    pluginId: string;
-    guild: Guild;
-    installedPlugins: Plugin[];
-    profile: UserInfo;
-    mainPanelPlugin?: ActivePlugin;
-    sidePanelPlugin?: ActivePlugin;
-}
-export declare class RimoriCommunicationHandler {
-    private port;
-    private queryParams;
-    private supabase;
-    private rimoriInfo;
-    private pluginId;
-    private isMessageChannelReady;
-    private pendingRequests;
-    constructor(pluginId: string, standalone: boolean);
-    private initMessageChannel;
-    private sendHello;
-    getQueryParam(key: string): string | null;
-    getClient(): Promise<{
-        supabase: SupabaseClient;
-        info: RimoriInfo;
-    }>;
-    getToken(): Promise<string>;
-    /**
-     * Gets the Supabase URL.
-     * @returns The Supabase URL.
-     * @deprecated All endpoints should use the backend URL instead.
-     */
-    getSupabaseUrl(): string;
-    getBackendUrl(): string;
-    getGlobalEventTopic(preliminaryTopic: string): string;
-}