@pisell/pisellos 0.0.547 → 0.0.551

package/dist/solution/VenueBooking/types.d.ts

@@ -1,5 +1,6 @@
 import { OrderModule, ProductList, SalesSummaryModule, ScanOrderLogInput, ScanOrderLoggerModule, ScanOrderLoggerProviderConfig, ScanOrderLoggerProviderType, DateModule, ScheduleModule, QuotationModule, OpenDataModule } from '../../modules';
 import type { QuantityCheckResult, QuantityLimitResult } from '../../model/strategy/adapter/itemRule';
+import { HolderModule } from '../../modules/Holder';
 export type { ScanOrderOrderProductIdentity, ScanOrderOrderProduct, ScanOrderSubmitProduct, ScanOrderSummary, ScanOrderTempOrder, ScanOrderSubmitPayload, } from '../ScanOrder/types';
 export declare enum VenueBookingHooks {
     onInited = "venueBooking:onInited",
@@ -145,6 +146,7 @@ export interface VenueBookingState {
         passed: boolean | null;
         failures: QuantityCheckResult[];
     };
+    holder?: HolderModule;
 }
 export interface VenueBookingLoggerRuntimeConfig {
     provider?: ScanOrderLoggerProviderType;

package/dist/types/index.d.ts

@@ -6,6 +6,7 @@ export interface Plugin {
     version: string;
     initialize: () => Promise<void> | void;
     destroy?: () => Promise<void> | void;
+    getLocalStorage?: (key: string) => string | null;
 }
 export interface PluginOptions {
     dependencies?: string[];

package/lib/modules/Holder/index.d.ts

@@ -0,0 +1,42 @@
+import { Module, PisellCore, ModuleOptions } from '../../types';
+import { BaseModule } from '../BaseModule';
+import { IFormInfo, IFormRecord, IFormItemData, IFetchFormInfoParams, IFetchFormRecordsParams, IAddFormRecordParams, IAppendFormRecordParams, IEnsureFormDataParams, IEnsureFormByProductParams, HolderModuleAPI, HolderFormMap } from './types';
+export * from './types';
+export * from './utils';
+export declare class HolderModule extends BaseModule implements Module, HolderModuleAPI {
+    protected defaultName: string;
+    protected defaultVersion: string;
+    private store;
+    private request;
+    private cacheId;
+    private openCache;
+    private fatherModule;
+    private isLoading;
+    private error;
+    /** 已加载过表单数据的 form_id 缓存标记 */
+    private loadedFormIds;
+    constructor(name?: string, version?: string);
+    initialize(core: PisellCore, options: ModuleOptions): Promise<void>;
+    /** 统一提交 formMap，仅此处触发 store changed */
+    private commitFormMap;
+    /** 通知 UI 刷新（数据未变但需要 re-read 的场景） */
+    private notifyFormMapChanged;
+    getHolderFormMap(): HolderFormMap;
+    getHolderFormData(formId: number | string): IFormItemData | undefined;
+    setFormData(formId: number | string, data: Partial<IFormItemData>): void;
+    private ensureFormItem;
+    private hasFormData;
+    private patchFormMap;
+    fetchFormInfo(params: IFetchFormInfoParams): Promise<IFormInfo | IFormInfo[]>;
+    fetchRecords(params: IFetchFormRecordsParams): Promise<any>;
+    ensureFormData(params: IEnsureFormDataParams): Promise<IFormItemData>;
+    ensureFormByProduct(params: IEnsureFormByProductParams): Promise<IFormItemData | null>;
+    addFormRecord(params: IAddFormRecordParams): Promise<any>;
+    /**
+     * UI 层自行请求添加接口后，将返回记录合并到 holderMap 对应 form_id 的 records 中
+     */
+    appendFormRecord(params: IAppendFormRecordParams): IFormRecord;
+    removeFormRecord(formId: number | string, formRecordId: number): void;
+    clearFormData(formId?: number | string): void;
+    storeChange(path?: string): void;
+}

package/lib/modules/Holder/index.js

@@ -0,0 +1,329 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/modules/Holder/index.ts
+var Holder_exports = {};
+__export(Holder_exports, {
+  HolderModule: () => HolderModule
+});
+module.exports = __toCommonJS(Holder_exports);
+var import_lodash_es = require("lodash-es");
+var import_BaseModule = require("../BaseModule");
+var import_utils = require("./utils");
+__reExport(Holder_exports, require("./types"), module.exports);
+__reExport(Holder_exports, require("./utils"), module.exports);
+var HolderModule = class extends import_BaseModule.BaseModule {
+  constructor(name, version) {
+    super(name, version);
+    this.defaultName = "holder";
+    this.defaultVersion = "1.0.0";
+    this.openCache = false;
+    this.isLoading = false;
+    this.error = null;
+    /** 已加载过表单数据的 form_id 缓存标记 */
+    this.loadedFormIds = /* @__PURE__ */ new Set();
+  }
+  async initialize(core, options) {
+    var _a, _b, _c;
+    this.core = core;
+    this.store = options.store;
+    this.request = this.core.getPlugin("request");
+    if ((_a = options.initialState) == null ? void 0 : _a.holderMap) {
+      this.commitFormMap((0, import_lodash_es.cloneDeep)(options.initialState.holderMap));
+      Object.keys(this.store.holderMap).forEach((formId) => {
+        if (this.hasFormData(formId)) {
+          this.loadedFormIds.add(formId);
+        }
+      });
+    }
+    if (!this.store.holderMap || typeof this.store.holderMap !== "object") {
+      this.store.holderMap = {};
+    }
+    if ((_b = options.otherParams) == null ? void 0 : _b.cacheId) {
+      this.openCache = options.otherParams.openCache;
+      this.cacheId = options.otherParams.cacheId;
+    }
+    if ((_c = options.otherParams) == null ? void 0 : _c.fatherModule) {
+      this.fatherModule = options.otherParams.fatherModule;
+    }
+  }
+  /** 统一提交 formMap，仅此处触发 store changed */
+  commitFormMap(holderMap) {
+    this.store.holderMap = holderMap;
+  }
+  /** 通知 UI 刷新（数据未变但需要 re-read 的场景） */
+  notifyFormMapChanged() {
+    this.commitFormMap({ ...this.store.holderMap });
+  }
+  getHolderFormMap() {
+    return (0, import_lodash_es.cloneDeep)(this.store.holderMap);
+  }
+  getHolderFormData(formId) {
+    const formData = this.store.holderMap[(0, import_utils.normalizeFormId)(formId)];
+    return formData ? (0, import_lodash_es.cloneDeep)(formData) : void 0;
+  }
+  setFormData(formId, data) {
+    const key = (0, import_utils.normalizeFormId)(formId);
+    const current = this.store.holderMap[key] || (0, import_utils.createEmptyFormItemData)();
+    this.commitFormMap({
+      ...this.store.holderMap,
+      [key]: {
+        records: data.records ?? current.records,
+        form: data.form ?? current.form
+      }
+    });
+  }
+  ensureFormItem(formId, holderMap = this.store.holderMap) {
+    const key = (0, import_utils.normalizeFormId)(formId);
+    if (!holderMap[key]) {
+      holderMap[key] = (0, import_utils.createEmptyFormItemData)();
+    }
+    return holderMap[key];
+  }
+  hasFormData(formId) {
+    const item = this.store.holderMap[formId];
+    return !!item && (Object.keys(item.form || {}).length > 0 || item.records.length > 0);
+  }
+  patchFormMap(holderMap, formId, patch) {
+    const current = this.ensureFormItem(formId, holderMap);
+    holderMap[formId] = {
+      records: patch.records ?? current.records,
+      form: patch.form ?? current.form
+    };
+  }
+  async fetchFormInfo(params) {
+    const { form_id } = params.query || {};
+    const url = params.url || `/form/${form_id}`;
+    const useCache = params.useCache !== false;
+    this.isLoading = true;
+    this.error = null;
+    try {
+      const res = await this.request.get(url, {}, { useCache });
+      const formData = res == null ? void 0 : res.data;
+      const formList = Array.isArray(formData == null ? void 0 : formData.list) ? formData.list : formData ? [formData] : [];
+      const nextFormMap = { ...this.store.holderMap };
+      formList.forEach((form) => {
+        const key = (0, import_utils.normalizeFormId)(form.form_id ?? form_id ?? form.id);
+        this.patchFormMap(nextFormMap, key, { form });
+      });
+      if (!formList.length && form_id !== void 0) {
+        const key = (0, import_utils.normalizeFormId)(form_id);
+        this.patchFormMap(nextFormMap, key, { form: formData || {} });
+      }
+      this.commitFormMap(nextFormMap);
+      return formList.length === 1 ? formList[0] : formList;
+    } catch (error) {
+      this.error = error instanceof Error ? error.message : String(error);
+      throw error;
+    } finally {
+      this.isLoading = false;
+    }
+  }
+  async fetchRecords(params) {
+    var _a;
+    const url = params.url || "/form/data/v1";
+    const { form_id, shop_id, num, skip, customer_id, ...rest } = params.query || {};
+    const formId = (0, import_utils.normalizeFormId)(form_id);
+    const useCache = params.useCache !== false;
+    this.isLoading = true;
+    this.error = null;
+    try {
+      const res = await this.request.get(
+        url,
+        {
+          customer_id,
+          form_id,
+          shop_id,
+          num: num || 100,
+          skip: skip || 1,
+          front_end_cache_id: useCache && this.cacheId,
+          ...rest
+        },
+        { useCache }
+      );
+      const records = ((_a = res == null ? void 0 : res.data) == null ? void 0 : _a.list) || [];
+      const nextFormMap = { ...this.store.holderMap };
+      this.patchFormMap(nextFormMap, formId, { records });
+      this.commitFormMap(nextFormMap);
+      return records;
+    } catch (error) {
+      this.error = error instanceof Error ? error.message : String(error);
+      throw error;
+    } finally {
+      this.isLoading = false;
+    }
+  }
+  async ensureFormData(params) {
+    const formId = (0, import_utils.normalizeFormId)(params.form_id);
+    const useCache = params.useCache !== false;
+    if (useCache && !params.forceRefresh && this.loadedFormIds.has(formId)) {
+      this.notifyFormMapChanged();
+      return this.ensureFormItem(formId);
+    }
+    const current = this.ensureFormItem(formId);
+    const tasks = [];
+    if (params.forceRefresh || !Object.keys(current.form || {}).length) {
+      tasks.push(
+        this.fetchFormInfo({
+          url: params.formInfoUrl,
+          query: {
+            form_id: params.form_id
+          },
+          useCache
+        })
+      );
+    }
+    if (params.forceRefresh || !current.records.length) {
+      tasks.push(
+        this.fetchRecords({
+          url: params.recordsUrl,
+          query: {
+            form_id: params.form_id,
+            shop_id: params.shop_id,
+            customer_id: params.customer_id
+          },
+          useCache
+        })
+      );
+    }
+    if (!tasks.length) {
+      this.notifyFormMapChanged();
+    } else {
+      await Promise.all(tasks);
+    }
+    this.loadedFormIds.add(formId);
+    return this.ensureFormItem(formId);
+  }
+  async ensureFormByProduct(params) {
+    const holderConfig = (0, import_utils.getProductHolderConfig)(params.product);
+    if (!holderConfig)
+      return null;
+    const formId = (0, import_utils.getFormIdFromHolderConfig)(holderConfig);
+    const shopId = params.shop_id ?? params.product.shop_id;
+    return this.ensureFormData({
+      form_id: formId,
+      shop_id: shopId,
+      customer_id: params.customer_id,
+      useCache: params.useCache,
+      skip: 1,
+      num: 100
+    });
+  }
+  async addFormRecord(params) {
+    const url = params.url || "/form/record";
+    const formId = (0, import_utils.normalizeFormId)(params.body.form_id);
+    this.isLoading = true;
+    this.error = null;
+    try {
+      await this.request.post(url, params.body);
+      const records = await this.fetchRecords({
+        query: {
+          form_id: params.body.form_id,
+          shop_id: params.body.shop_id,
+          customer_id: params.body.customer_id
+        },
+        useCache: false
+      });
+      this.loadedFormIds.add(formId);
+      return records[records.length - 1];
+    } catch (error) {
+      this.error = error instanceof Error ? error.message : String(error);
+      throw error;
+    } finally {
+      this.isLoading = false;
+    }
+  }
+  /**
+   * UI 层自行请求添加接口后，将返回记录合并到 holderMap 对应 form_id 的 records 中
+   */
+  appendFormRecord(params) {
+    let record = params.record;
+    if ((record == null ? void 0 : record.data) && record.form_record_id === void 0) {
+      record = record.data;
+    }
+    const normalizedRecord = (0, import_lodash_es.cloneDeep)(record);
+    const formId = (0, import_utils.normalizeFormId)(
+      params.form_id ?? normalizedRecord.form_id
+    );
+    if (!formId) {
+      throw new Error("[HolderModule] appendFormRecord: form_id is required");
+    }
+    if (!normalizedRecord.form_record_id) {
+      throw new Error(
+        "[HolderModule] appendFormRecord: form_record_id is required"
+      );
+    }
+    normalizedRecord.form_id = Number(formId) || normalizedRecord.form_id;
+    const nextFormMap = { ...this.store.holderMap };
+    const current = this.ensureFormItem(formId, nextFormMap);
+    const recordIndex = current.records.findIndex(
+      (item) => item.form_record_id === normalizedRecord.form_record_id
+    );
+    const records = recordIndex >= 0 ? current.records.map(
+      (item, index) => index === recordIndex ? { ...item, ...normalizedRecord } : item
+    ) : [...current.records, normalizedRecord];
+    this.patchFormMap(nextFormMap, formId, { records });
+    this.commitFormMap(nextFormMap);
+    this.loadedFormIds.add(formId);
+    return normalizedRecord;
+  }
+  removeFormRecord(formId, formRecordId) {
+    const key = (0, import_utils.normalizeFormId)(formId);
+    const current = this.store.holderMap[key] || (0, import_utils.createEmptyFormItemData)();
+    const nextFormMap = { ...this.store.holderMap };
+    this.patchFormMap(nextFormMap, key, {
+      records: current.records.filter(
+        (record) => record.form_record_id !== formRecordId
+      )
+    });
+    this.commitFormMap(nextFormMap);
+  }
+  clearFormData(formId) {
+    if (formId !== void 0) {
+      const key = (0, import_utils.normalizeFormId)(formId);
+      const nextFormMap = { ...this.store.holderMap };
+      delete nextFormMap[key];
+      this.loadedFormIds.delete(key);
+      this.commitFormMap(nextFormMap);
+    } else {
+      this.loadedFormIds.clear();
+      this.commitFormMap({});
+    }
+  }
+  storeChange(path) {
+    if (path !== "holderMap" && path !== void 0) {
+      return;
+    }
+    if (this.openCache) {
+      const store = (0, import_lodash_es.cloneDeep)(this.store);
+      this.checkSaveCache({
+        cacheId: this.cacheId,
+        fatherModule: this.fatherModule,
+        store,
+        cacheKey: ["holderMap"]
+      });
+    }
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  HolderModule,
+  ...require("./types"),
+  ...require("./utils")
+});

package/lib/modules/Holder/types.d.ts

@@ -0,0 +1,115 @@
+import { ProductData } from '../Product/types';
+/**
+ * 商品 holder 配置
+ */
+export interface IHolderConfig {
+    required?: number;
+    resource_id: number;
+    status?: string;
+    [key: string]: any;
+}
+/**
+ * 表单记录
+ */
+export interface IFormRecord {
+    form_id: number;
+    form_record_id: number;
+    main_field: string;
+    customer_cover?: string;
+    created_at?: string;
+    customer_id?: number;
+    [key: string]: any;
+}
+/**
+ * 表单配置/定义
+ */
+export interface IFormInfo {
+    form_id: number;
+    name: string;
+    fields?: Record<string, any>[];
+    [key: string]: any;
+}
+/**
+ * 单个 form_id 下的数据结构
+ */
+export interface IFormItemData {
+    records: IFormRecord[];
+    form: IFormInfo | Record<string, any>;
+}
+/**
+ * form_id 为 key 的 map 结构，如 948: { records: [], form: {} }
+ */
+export type HolderFormMap = Record<string, IFormItemData>;
+/**
+ * Holder 模块 reactive store，仅 holderMap 会触发 changed 事件
+ */
+export interface HolderState {
+    holderMap: HolderFormMap;
+}
+export interface IFetchFormInfoParams {
+    url?: string;
+    query: {
+        form_id: string | number;
+    };
+    useCache?: boolean;
+}
+export interface IFetchFormRecordsParams {
+    url?: string;
+    query: {
+        customer_id?: number;
+        form_id: string | number;
+        shop_id: string | number;
+        num?: number;
+        skip?: number;
+        [key: string]: any;
+    };
+    useCache?: boolean;
+}
+export interface IAddFormRecordParams {
+    url?: string;
+    body: {
+        form_id: number | string;
+        shop_id: number | string;
+        customer_id?: number;
+        [key: string]: any;
+    };
+}
+/**
+ * UI 层自行调用添加接口后，将返回记录写入 holderMap
+ */
+export interface IAppendFormRecordParams {
+    /** 接口返回的 data，或完整响应 { data: {...} } */
+    record: IFormRecord | Record<string, any>;
+    /** 可选，未传则从 record.form_id 读取 */
+    form_id?: number | string;
+}
+export interface IEnsureFormDataParams {
+    form_id: number | string;
+    shop_id: number | string;
+    customer_id?: number;
+    useCache?: boolean;
+    forceRefresh?: boolean;
+    formInfoUrl?: string;
+    recordsUrl?: string;
+    skip?: number;
+    num?: number;
+}
+export interface IEnsureFormByProductParams {
+    product: ProductData | Record<string, any>;
+    customer_id?: number;
+    shop_id?: number | string;
+    useCache?: boolean;
+}
+export interface HolderModuleAPI {
+    getHolderFormMap: () => HolderFormMap;
+    getHolderFormData: (formId: number | string) => IFormItemData | undefined;
+    setFormData: (formId: number | string, data: Partial<IFormItemData>) => void;
+    fetchFormInfo: (params: IFetchFormInfoParams) => Promise<IFormInfo | IFormInfo[]>;
+    fetchRecords: (params: IFetchFormRecordsParams) => Promise<IFormRecord[]>;
+    ensureFormData: (params: IEnsureFormDataParams) => Promise<IFormItemData>;
+    ensureFormByProduct: (params: IEnsureFormByProductParams) => Promise<IFormItemData | null>;
+    addFormRecord: (params: IAddFormRecordParams) => Promise<IFormRecord>;
+    appendFormRecord: (params: IAppendFormRecordParams) => IFormRecord;
+    removeFormRecord: (formId: number | string, formRecordId: number) => void;
+    clearFormData: (formId?: number | string) => void;
+}

package/lib/modules/Holder/types.js

@@ -0,0 +1,17 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/modules/Holder/types.ts
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);

package/lib/modules/Holder/utils.d.ts

@@ -0,0 +1,9 @@
+import { ProductData } from '../Product/types';
+import { IHolderConfig } from './types';
+export declare function getProductHolderConfig(product?: ProductData | Record<string, any> | null): IHolderConfig | null;
+export declare function getFormIdFromHolderConfig(config: IHolderConfig): string;
+export declare function normalizeFormId(formId: number | string): string;
+export declare function createEmptyFormItemData(): {
+    records: any[];
+    form: Record<string, any>;
+};

package/lib/modules/Holder/utils.js

@@ -0,0 +1,57 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/modules/Holder/utils.ts
+var utils_exports = {};
+__export(utils_exports, {
+  createEmptyFormItemData: () => createEmptyFormItemData,
+  getFormIdFromHolderConfig: () => getFormIdFromHolderConfig,
+  getProductHolderConfig: () => getProductHolderConfig,
+  normalizeFormId: () => normalizeFormId
+});
+module.exports = __toCommonJS(utils_exports);
+function getProductHolderConfig(product) {
+  var _a;
+  if (!product)
+    return null;
+  const config = (product == null ? void 0 : product.holder_config) ?? ((_a = product == null ? void 0 : product.origin) == null ? void 0 : _a.holder_config);
+  if ((config == null ? void 0 : config.status) && (config == null ? void 0 : config.status) !== "enable")
+    return null;
+  if (!(config == null ? void 0 : config.resource_id))
+    return null;
+  return config;
+}
+function getFormIdFromHolderConfig(config) {
+  return String(config == null ? void 0 : config.resource_id);
+}
+function normalizeFormId(formId) {
+  return String(formId);
+}
+function createEmptyFormItemData() {
+  return {
+    records: [],
+    form: {}
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createEmptyFormItemData,
+  getFormIdFromHolderConfig,
+  getProductHolderConfig,
+  normalizeFormId
+});

package/lib/modules/Order/index.d.ts

@@ -57,6 +57,7 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     private getTempOrderStorageKey;
     private restoreTempOrderFromStorage;
     persistTempOrder(): void;
+    notifyTempOrderChanged(): void;
     private createDefaultTempOrderInstance;
     ensureTempOrder(): ScanOrderTempOrder;
     restoreOrder(): ScanOrderTempOrder;

package/lib/modules/Order/index.js

@@ -328,6 +328,16 @@ var OrderModule = class extends import_BaseModule.BaseModule {
       return;
     this.window.localStorage.setItem(key, JSON.stringify(this.store.tempOrder));
   }
+  notifyTempOrderChanged() {
+    if (!this.store.tempOrder)
+      return;
+    this.store.tempOrder = {
+      ...this.store.tempOrder,
+      products: [...this.store.tempOrder.products],
+      bookings: this.store.tempOrder.bookings ? [...this.store.tempOrder.bookings] : []
+    };
+    this.persistTempOrder();
+  }
   // ─── TempOrder: 创建 & 获取 ───
   createDefaultTempOrderInstance() {
     return (0, import_utils.createDefaultTempOrder)({
@@ -605,6 +615,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
         }
         const discountList = (0, import_utils.getAllDiscountList)(item);
         item._origin.product.discount_list = discountList;
+        (0, import_utils.ensureCartItemOriginHolder)(item);
         if ((0, import_utils2.isNormalProduct)(item._origin)) {
           order.relation_products.push(item._origin.product);
           const relationForms = item._origin.relation_forms || [];

package/lib/modules/Order/types.d.ts

@@ -235,6 +235,8 @@ export interface OrderModuleAPI {
     updateProductInOrder: (params: UpdateProductInOrderParams) => Promise<ScanOrderOrderProduct[]>;
     removeProductFromOrder: (identity: ScanOrderOrderProductIdentity) => Promise<ScanOrderOrderProduct[]>;
     persistTempOrder: () => void;
+    /** 提交 tempOrder 变更并触发 `{moduleName}:changed` 事件 */
+    notifyTempOrderChanged: () => void;
     submitTempOrder: <T = any>(params?: {
         cacheId?: string;
         platform?: string;

package/lib/modules/Order/utils.d.ts

@@ -86,6 +86,15 @@ export declare const mergeRelationForms: (relationForms: {
     form_id: number;
     form_record_ids: number[];
 }[];
+export interface CartOrderHolder {
+    customer_id?: number;
+    form_id: number | string;
+    form_record: (number | string)[] | null;
+}
+/**
+ * 为购物车行补齐订单所需的 holder 信息（与 cartAccount 结构保持一致）
+ */
+export declare function ensureCartItemOriginHolder(cartItem: CartItem): void;
 export declare const getAllDiscountList: (cartItem: CartItem) => any;
 export declare function createUuidV4(): string;
 export declare function isTempOrder(data: any): data is ScanOrderTempOrder;