@pisell/pisellos 2.1.38 → 2.2.1

package/dist/server/modules/menu/types.js

@@ -0,0 +1,16 @@
+/**
+ * 餐牌模块状态
+ */
+
+/**
+ * 餐牌数据结构
+ */
+
+/**
+ * 餐牌模块钩子
+ */
+export var MenuHooks = /*#__PURE__*/function (MenuHooks) {
+  MenuHooks["onMenuLoaded"] = "menu:onMenuLoaded";
+  MenuHooks["onMenuChanged"] = "menu:onMenuChanged";
+  return MenuHooks;
+}({});

package/dist/server/modules/products/index.d.ts

@@ -0,0 +1,141 @@
+import { Module, PisellCore } from '../../../types';
+import { BaseModule } from '../../../modules/BaseModule';
+import { ProductData } from '../../../modules/Product/types';
+import type { RouteDefinition } from '../../types';
+import { ProductFormatter, ProductFormatterContext } from './types';
+/**
+ * Products 模块 - 用于获取和管理完整的商品详细数据
+ * 相比 ProductList 模块，Products 会获取所有详细信息并缓存
+ */
+export declare class ProductsModule extends BaseModule implements Module {
+    protected defaultName: string;
+    protected defaultVersion: string;
+    private store;
+    private request;
+    private dbManager;
+    private otherParams;
+    private productsPriceCache;
+    private readonly CACHE_MAX_DAYS;
+    private formatters;
+    private isPriceFormatterRegistered;
+    constructor(name?: string, version?: string);
+    initialize(core: PisellCore, options: any): Promise<void>;
+    /**
+     * 加载商品价格（原始方法，不带缓存）
+     * @private
+     */
+    private loadProductsPrice;
+    /**
+     * 获取应用了价格的商品列表（带缓存）
+     * 使用日期作为缓存 key，同一天的商品价格会被缓存
+     * 缓存的是已经应用了价格的完整商品列表，避免重复转换
+     * @param schedule_date 日期
+     * @param extraContext 额外的上下文数据（可选，由 Server 层传入）
+     * @returns 应用了价格的商品列表
+     */
+    getProductsWithPrice(schedule_date: string, extraContext?: Partial<ProductFormatterContext>): Promise<ProductData[]>;
+    /**
+     * 准备带价格的商品数据（通过格式化器流程处理）
+     * @param schedule_date 日期
+     * @param extraContext 额外的上下文数据（可选）
+     * @returns 完整处理后的商品列表
+     * @private
+     */
+    private prepareProductsWithPrice;
+    /**
+     * 应用所有已注册的格式化器
+     * @param products 商品列表
+     * @param context 上下文信息
+     * @returns 格式化后的商品列表
+     * @private
+     */
+    private applyFormatters;
+    /**
+     * 注册内置的价格格式化器
+     * 这个格式化器负责将价格数据应用到商品上
+     * @private
+     */
+    private registerBuiltinPriceFormatter;
+    /**
+     * 注册商品格式化器
+     * 格式化器会按注册顺序依次执行（内置价格格式化器始终是第一个）
+     * @param formatter 格式化函数
+     * @param prepend 是否插入到队列开头（默认 false，追加到末尾）
+     * @example
+     * ```ts
+     * productsModule.registerFormatter((products, context) => {
+     *   return products.map(p => ({
+     *     ...p,
+     *     custom_field: 'custom_value'
+     *   }));
+     * });
+     * ```
+     */
+    registerFormatter(formatter: ProductFormatter, prepend?: boolean): void;
+    /**
+     * 清空所有格式化器（包括内置价格格式化器）
+     * @param keepBuiltin 是否保留内置价格格式化器（默认 true）
+     */
+    clearFormatters(keepBuiltin?: boolean): void;
+    /**
+     * 清理过期的价格缓存
+     * 当缓存数量超过限制时，删除最老的缓存
+     * @private
+     */
+    private cleanExpiredPriceCache;
+    /**
+     * 清空商品价格缓存
+     * 可用于手动刷新价格数据
+     */
+    clearPriceCache(): void;
+    /**
+     * 加载完整商品列表通过接口（包含所有详细数据）
+     * @param params 查询参数
+     */
+    loadProductsByServer(params?: {
+        category_ids?: number[];
+        product_ids?: number[];
+        collection?: number | string[];
+        customer_id?: number;
+        cacheId?: string;
+    }): Promise<any>;
+    /**
+     * 获取商品列表（从缓存）
+     */
+    getProducts(): Promise<ProductData[]>;
+    /**
+     * 根据ID获取单个商品（从内存缓存）
+     * 使用 Map 快速查询，时间复杂度 O(1)
+     */
+    getProductById(id: number): Promise<ProductData | undefined>;
+    /**
+     * 清空缓存
+     */
+    clear(): Promise<void>;
+    /**
+     * 从 IndexDB 加载商品数据
+     * @private
+     */
+    private loadProductsFromIndexDB;
+    /**
+     * 保存商品数据到 IndexDB（平铺存储）
+     * @private
+     */
+    private saveProductsToIndexDB;
+    /**
+     * 同步更新商品 Map 缓存
+     * 将 list 中的商品同步到 map，以 id 为 key
+     * @private
+     */
+    private syncProductsMap;
+    /**
+     * 预加载模块数据（统一接口）
+     * 在模块注册后自动调用
+     */
+    preload(): Promise<void>;
+    /**
+     * 获取模块的路由定义
+     * Products 模块暂不提供路由，由 Server 层统一处理
+     */
+    getRoutes(): RouteDefinition[];
+}