@yumerijs/core 1.0.34 → 1.1.0-alpha.1

package/dist/platform.d.ts

@@ -1,11 +1,152 @@
 import { Session } from './session';
 import { Core } from './core';
+/**
+ * Platform 基类
+ * 作为平台接入的基础类，提供标准化的接口和通用能力
+ * 各平台实现类需继承此类并实现所有抽象方法
+ */
 export declare abstract class Platform {
+    protected status: 'idle' | 'starting' | 'running' | 'stopping' | 'error';
+    protected errorMessage: string | null;
+    protected config: Record<string, any>;
+    protected instanceId: string;
+    protected eventListeners: Record<string, Array<(...args: any[]) => void>>;
+    /**
+     * 构造函数
+     * @param config 平台配置
+     */
+    constructor(config?: Record<string, any>);
+    /**
+     * 生成平台实例ID
+     * @returns 实例ID字符串
+     */
+    protected generateInstanceId(): string;
+    /**
+     * 向客户端发送消息
+     * @param session 会话对象
+     * @param data 要发送的数据
+     * @returns 发送结果
+     */
     abstract sendMessage(session: Session, data: any): any;
+    /**
+     * 结束会话
+     * @param session 会话对象
+     * @param message 结束消息
+     * @returns 结束结果
+     */
     abstract terminationSession(session: Session, message: any): any;
+    /**
+     * 获取平台名称
+     * @returns 平台名称
+     */
     abstract getPlatformName(): string;
+    /**
+     * 获取平台版本号
+     * @returns 平台版本号
+     */
     abstract getPlatformVersionCode(): string;
+    /**
+     * 获取平台ID
+     * @returns 平台ID
+     */
     abstract getPlatformId(): string;
-    abstract getPlatformStatus(): any;
-    abstract startPlatform(core?: Core): any;
+    /**
+     * 获取平台状态
+     * @returns 平台状态对象
+     */
+    abstract getPlatformStatus(): Record<string, any>;
+    /**
+     * 启动平台
+     * @param core Core实例
+     * @returns 启动结果
+     */
+    abstract startPlatform(core?: Core): Promise<any>;
+    /**
+     * 停止平台
+     * @returns 停止结果
+     */
+    abstract stopPlatform(): Promise<void>;
+    /**
+     * 重启平台
+     * @param core Core实例
+     * @returns 重启结果
+     */
+    restartPlatform(core?: Core): Promise<any>;
+    /**
+     * 设置平台配置
+     * @param key 配置键
+     * @param value 配置值
+     */
+    setConfig(key: string, value: any): void;
+    /**
+     * 获取平台配置
+     * @param key 配置键
+     * @param defaultValue 默认值
+     * @returns 配置值
+     */
+    getConfig<T>(key: string, defaultValue?: T): T;
+    /**
+     * 获取平台实例ID
+     * @returns 实例ID
+     */
+    getInstanceId(): string;
+    /**
+     * 获取当前平台状态
+     * @returns 状态字符串
+     */
+    getStatus(): 'idle' | 'starting' | 'running' | 'stopping' | 'error';
+    /**
+     * 获取错误信息
+     * @returns 错误信息
+     */
+    getErrorMessage(): string | null;
+    /**
+     * 添加平台事件监听器
+     * @param event 事件名称
+     * @param listener 监听器函数
+     */
+    on(event: string, listener: (...args: any[]) => void): void;
+    /**
+     * 移除平台事件监听器
+     * @param event 事件名称
+     * @param listener 监听器函数
+     */
+    off(event: string, listener: (...args: any[]) => void): void;
+    /**
+     * 触发平台事件
+     * @param event 事件名称
+     * @param args 事件参数
+     */
+    protected emit(event: string, ...args: any[]): void;
+    /**
+     * 创建会话
+     * @param ip 客户端IP
+     * @param cookie Cookie对象
+     * @param query 查询参数
+     * @returns 会话对象
+     */
+    createSession(ip: string, cookie: Record<string, string>, query?: Record<string, string>): Session;
+    /**
+     * 处理会话数据
+     * @param session 会话对象
+     * @param data 会话数据
+     * @returns 处理结果
+     */
+    processSessionData(session: Session, data: any): any;
+    /**
+     * 验证会话
+     * @param session 会话对象
+     * @returns 验证结果
+     */
+    validateSession(session: Session): boolean;
+    /**
+     * 获取平台支持的MIME类型
+     * @returns MIME类型数组
+     */
+    getSupportedMimeTypes(): string[];
+    /**
+     * 获取平台元数据
+     * @returns 平台元数据
+     */
+    getMetadata(): Record<string, any>;
 }

package/dist/platform.js

@@ -1,7 +1,187 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Platform = void 0;
+const session_1 = require("./session");
+/**
+ * Platform 基类
+ * 作为平台接入的基础类，提供标准化的接口和通用能力
+ * 各平台实现类需继承此类并实现所有抽象方法
+ */
 class Platform {
+    /**
+     * 构造函数
+     * @param config 平台配置
+     */
+    constructor(config) {
+        // 平台状态
+        this.status = 'idle';
+        // 平台错误信息
+        this.errorMessage = null;
+        // 平台配置
+        this.config = {};
+        // 平台实例ID
+        this.instanceId = '';
+        // 平台事件监听器
+        this.eventListeners = {};
+        if (config) {
+            this.config = { ...config };
+        }
+        this.instanceId = this.generateInstanceId();
+    }
+    /**
+     * 生成平台实例ID
+     * @returns 实例ID字符串
+     */
+    generateInstanceId() {
+        return `${this.getPlatformId()}-${Date.now()}-${Math.floor(Math.random() * 1000)}`;
+    }
+    /**
+     * 重启平台
+     * @param core Core实例
+     * @returns 重启结果
+     */
+    async restartPlatform(core) {
+        await this.stopPlatform();
+        return this.startPlatform(core);
+    }
+    /**
+     * 设置平台配置
+     * @param key 配置键
+     * @param value 配置值
+     */
+    setConfig(key, value) {
+        this.config[key] = value;
+    }
+    /**
+     * 获取平台配置
+     * @param key 配置键
+     * @param defaultValue 默认值
+     * @returns 配置值
+     */
+    getConfig(key, defaultValue) {
+        return (this.config[key] !== undefined) ? this.config[key] : defaultValue;
+    }
+    /**
+     * 获取平台实例ID
+     * @returns 实例ID
+     */
+    getInstanceId() {
+        return this.instanceId;
+    }
+    /**
+     * 获取当前平台状态
+     * @returns 状态字符串
+     */
+    getStatus() {
+        return this.status;
+    }
+    /**
+     * 获取错误信息
+     * @returns 错误信息
+     */
+    getErrorMessage() {
+        return this.errorMessage;
+    }
+    /**
+     * 添加平台事件监听器
+     * @param event 事件名称
+     * @param listener 监听器函数
+     */
+    on(event, listener) {
+        if (!this.eventListeners[event]) {
+            this.eventListeners[event] = [];
+        }
+        this.eventListeners[event].push(listener);
+    }
+    /**
+     * 移除平台事件监听器
+     * @param event 事件名称
+     * @param listener 监听器函数
+     */
+    off(event, listener) {
+        if (!this.eventListeners[event]) {
+            return;
+        }
+        this.eventListeners[event] = this.eventListeners[event].filter(l => l !== listener);
+    }
+    /**
+     * 触发平台事件
+     * @param event 事件名称
+     * @param args 事件参数
+     */
+    emit(event, ...args) {
+        if (!this.eventListeners[event]) {
+            return;
+        }
+        for (const listener of this.eventListeners[event]) {
+            try {
+                listener(...args);
+            }
+            catch (error) {
+                console.error(`Error in platform event listener for "${event}":`, error);
+            }
+        }
+    }
+    /**
+     * 创建会话
+     * @param ip 客户端IP
+     * @param cookie Cookie对象
+     * @param query 查询参数
+     * @returns 会话对象
+     */
+    createSession(ip, cookie, query) {
+        return new session_1.Session(ip, cookie, this, query);
+    }
+    /**
+     * 处理会话数据
+     * @param session 会话对象
+     * @param data 会话数据
+     * @returns 处理结果
+     */
+    processSessionData(session, data) {
+        // 默认实现，子类可覆盖
+        return data;
+    }
+    /**
+     * 验证会话
+     * @param session 会话对象
+     * @returns 验证结果
+     */
+    validateSession(session) {
+        // 默认实现，子类可覆盖
+        return true;
+    }
+    /**
+     * 获取平台支持的MIME类型
+     * @returns MIME类型数组
+     */
+    getSupportedMimeTypes() {
+        // 默认实现，子类可覆盖
+        return [
+            'text/plain',
+            'text/html',
+            'application/json',
+            'application/xml',
+            'image/png',
+            'image/jpeg',
+            'application/pdf'
+        ];
+    }
+    /**
+     * 获取平台元数据
+     * @returns 平台元数据
+     */
+    getMetadata() {
+        return {
+            id: this.getPlatformId(),
+            name: this.getPlatformName(),
+            version: this.getPlatformVersionCode(),
+            status: this.getStatus(),
+            instanceId: this.getInstanceId(),
+            supportedMimeTypes: this.getSupportedMimeTypes(),
+            ...this.getPlatformStatus()
+        };
+    }
 }
 exports.Platform = Platform;
 //# sourceMappingURL=platform.js.map

package/dist/platform.js.map

@@ -1 +1 @@
-{"version":3,"file":"platform.js","sourceRoot":"","sources":["../src/platform.ts"],"names":[],"mappings":";;;AAGA,MAAsB,QAAQ;CAgB7B;AAhBD,4BAgBC"}
+{"version":3,"file":"platform.js","sourceRoot":"","sources":["../src/platform.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yumerijs/core",
-  "version": "1.0.34",
+  "version": "1.1.0-alpha.1",
   "description": "Core module for yumeri",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",