@pisell/pisellos 2.1.41 → 2.2.2

package/dist/server/index.d.ts

@@ -0,0 +1,152 @@
+import { ProductsModule } from './modules/products';
+import { MenuModule } from './modules/menu';
+import { QuotationModule } from './modules/quotation';
+import { ScheduleModuleEx } from './modules/schedule';
+import { PisellCore, ServerModuleConfig, InitializeServerOptions } from '../types';
+import type { RouteHandler, HttpMethod, RouteDefinition, Router, ModuleRegistryConfig, RequestSetting } from './types';
+export type { RouteHandler, HttpMethod, RouteDefinition, Router, ModuleRegistryConfig, };
+/**
+ * Server 类
+ * 用于注册和管理服务端模块
+ */
+declare class Server {
+    private core;
+    products?: ProductsModule;
+    menu?: MenuModule;
+    quotation?: QuotationModule;
+    schedule?: ScheduleModuleEx;
+    router: Router;
+    private moduleRegistry;
+    constructor(core: PisellCore);
+    /**
+     * 注册路由
+     * @param routes 路由定义数组
+     */
+    private registerRoutes;
+    /**
+     * 注册单个模块并自动注册其路由
+     * @param module 模块实例
+     * @param options 模块配置
+     * @param moduleName 模块名称（用于日志）
+     */
+    private registerModuleWithRoutes;
+    /**
+     * 根据模块名称注册单个模块
+     * @param moduleConfig 模块配置（可以是字符串或配置对象）
+     */
+    private registerModuleByName;
+    /**
+     * 注册指定的服务端模块
+     * @param moduleConfigs 要注册的模块配置数组（模块名称或配置对象）
+     */
+    registerModules(moduleConfigs?: (string | ServerModuleConfig)[]): Promise<{
+        module: any;
+        config: ModuleRegistryConfig;
+        shouldPreload: boolean;
+    }[]>;
+    /**
+     * 预加载指定模块的数据
+     * @param registeredModules 已注册的模块信息
+     */
+    preloadModulesData(registeredModules: Array<{
+        module: any;
+        config: ModuleRegistryConfig;
+        shouldPreload: boolean;
+    }>, options?: InitializeServerOptions): Promise<void>;
+    /**
+     * 初始化 Server（注册模块并预加载数据）
+     * @param moduleConfigs 要注册的模块配置
+     * @param autoPreload 是否自动预加载数据
+     */
+    initialize(moduleConfigs?: (string | ServerModuleConfig)[], autoPreload?: boolean, options?: InitializeServerOptions): Promise<{
+        module: any;
+        config: ModuleRegistryConfig;
+        shouldPreload: boolean;
+    }[]>;
+    /**
+     * 获取 Products 模块实例
+     */
+    getProducts(): ProductsModule | undefined;
+    /**
+     * 获取 Menu 模块实例
+     */
+    getMenu(): MenuModule | undefined;
+    /**
+     * 获取 Quotation 模块实例
+     */
+    getQuotation(): QuotationModule | undefined;
+    /**
+     * 获取 Schedule 模块实例
+     */
+    getSchedule(): ScheduleModuleEx | undefined;
+    /**
+     * 获取所有已注册的模块列表
+     */
+    getRegisteredModules(): string[];
+    /**
+     * 清空所有server模块的IndexedDB缓存
+     * @returns Promise<void>
+     */
+    clearAllIndexDB(): Promise<void>;
+    /**
+     * 获取所有注册的路由
+     */
+    getRoutes(): Router;
+    /**
+     * 根据方法和路径获取路由处理函数
+     * @param method HTTP 方法
+     * @param path 路径
+     */
+    getRouteHandler(method: HttpMethod, path: string): RouteHandler | undefined;
+    /**
+     * 检查路由是否存在
+     * @param method HTTP 方法
+     * @param path 路径
+     */
+    hasRoute(method: HttpMethod, path: string): boolean;
+    /**
+     * 执行路由处理函数
+     * @param method HTTP 方法
+     * @param path 路径
+     * @param params 请求参数
+     */
+    handleRoute(method: HttpMethod, path: string, params: {
+        url: string;
+        method: HttpMethod;
+        data?: any;
+        config?: RequestSetting;
+    }): Promise<any>;
+    /**
+     * 获取所有路由列表（用于调试和文档）
+     */
+    getAllRoutes(): Array<{
+        method: HttpMethod;
+        path: string;
+    }>;
+    /**
+     * 注册 Server 层的业务路由
+     * 这些路由需要编排多个模块的数据
+     * @private
+     */
+    private registerServerRoutes;
+    /**
+     * 处理商品查询请求（编排 Products、Menu、Schedule 模块）
+     * 这是一个业务编排方法，协调多个模块完成复杂的业务需求
+     */
+    private handleProductQuery;
+    /**
+     * 根据餐牌配置过滤商品
+     * @param products 所有商品列表
+     * @param activeMenuList 生效的餐牌列表
+     * @returns 过滤后的商品列表
+     * @private
+     */
+    private filterProductsByMenuConfig;
+    /**
+     * 处理获取日程时间段点的请求
+     * 通过餐牌ID列表获取所有相关日程的时间段点
+     */
+    private handleGetScheduleTimePoints;
+}
+export default Server;
+export * from './modules';