@pisell/pisellos 0.0.549 → 0.0.552

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

@@ -1,6 +1,6 @@
 import { Module, PisellCore, ModuleOptions } from '../../types';
 import { BaseModule } from '../BaseModule';
-import { IFormInfo, IFormRecord, IFormItemData, IFetchFormInfoParams, IFetchFormRecordsParams, IAddFormRecordParams, IAppendFormRecordParams, IEnsureFormDataParams, IEnsureFormByProductParams, HolderModuleAPI, HolderFormMap } from './types';
+import { IFormInfo, IFormRecord, IFormItemData, IFetchFormInfoParams, IFetchFormRecordsParams, IAddFormRecordParams, IAppendFormRecordParams, IEnsureFormDataParams, IEnsureFormByProductParams, IRefreshAllFormRecordsParams, HolderModuleAPI, HolderFormMap } from './types';
 export * from './types';
 export * from './utils';
 export declare class HolderModule extends BaseModule implements Module, HolderModuleAPI {
@@ -15,6 +15,7 @@ export declare class HolderModule extends BaseModule implements Module, HolderMo
     private error;
     /** 已加载过表单数据的 form_id 缓存标记 */
     private loadedFormIds;
+    private window;
     constructor(name?: string, version?: string);
     initialize(core: PisellCore, options: ModuleOptions): Promise<void>;
     /** 统一提交 formMap，仅此处触发 store changed */
@@ -38,5 +39,10 @@ export declare class HolderModule extends BaseModule implements Module, HolderMo
     appendFormRecord(params: IAppendFormRecordParams): IFormRecord;
     removeFormRecord(formId: number | string, formRecordId: number): void;
     clearFormData(formId?: number | string): void;
+    /**
+     * 登录后按当前 holderMap 批量刷新所有表单的 records。
+     * 遍历 holderMap，从 form.form 中读取 form_id、shop_id，结合 customer_id 重新拉取记录。
+     */
+    refreshAllFormRecords(params?: IRefreshAllFormRecordsParams): Promise<HolderFormMap>;
     storeChange(path?: string): void;
 }

package/lib/modules/Holder/index.js

@@ -136,18 +136,22 @@ var HolderModule = class extends import_BaseModule.BaseModule {
     }
   }
   async fetchRecords(params) {
-    var _a;
+    var _a, _b, _c;
     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;
+    const customer = JSON.parse(((_b = (_a = this.window) == null ? void 0 : _a.getLocalStorage) == null ? void 0 : _b.call(_a, "customer")) || "{}");
+    const customerId = customer_id ?? customer.id;
+    if (!customerId)
+      return [];
     this.isLoading = true;
     this.error = null;
     try {
       const res = await this.request.get(
         url,
         {
-          customer_id,
+          customer_id: customerId,
           form_id,
           shop_id,
           num: num || 100,
@@ -157,7 +161,7 @@ var HolderModule = class extends import_BaseModule.BaseModule {
         },
         { useCache }
       );
-      const records = ((_a = res == null ? void 0 : res.data) == null ? void 0 : _a.list) || [];
+      const records = ((_c = res == null ? void 0 : res.data) == null ? void 0 : _c.list) || [];
       const nextFormMap = { ...this.store.holderMap };
       this.patchFormMap(nextFormMap, formId, { records });
       this.commitFormMap(nextFormMap);
@@ -306,6 +310,74 @@ var HolderModule = class extends import_BaseModule.BaseModule {
       this.commitFormMap({});
     }
   }
+  /**
+   * 登录后按当前 holderMap 批量刷新所有表单的 records。
+   * 遍历 holderMap，从 form.form 中读取 form_id、shop_id，结合 customer_id 重新拉取记录。
+   */
+  async refreshAllFormRecords(params = {}) {
+    const { customer_id, recordsUrl, num, skip } = params;
+    const useCache = params.useCache ?? false;
+    if (!customer_id) {
+      return this.getHolderFormMap();
+    }
+    const entries = Object.entries(this.store.holderMap);
+    if (!entries.length) {
+      return this.getHolderFormMap();
+    }
+    const url = recordsUrl || "/form/data/v1";
+    this.isLoading = true;
+    this.error = null;
+    try {
+      const results = await Promise.all(
+        entries.map(async ([mapKey, item]) => {
+          var _a;
+          const meta = (0, import_utils.resolveFormMetaFromHolderItem)(mapKey, item);
+          if (!meta)
+            return null;
+          try {
+            const res = await this.request.get(
+              url,
+              {
+                customer_id,
+                form_id: meta.form_id,
+                shop_id: meta.shop_id,
+                num: num || 100,
+                skip: skip || 1,
+                front_end_cache_id: useCache && this.cacheId
+              },
+              { useCache }
+            );
+            return {
+              formId: meta.form_id,
+              records: ((_a = res == null ? void 0 : res.data) == null ? void 0 : _a.list) || []
+            };
+          } catch (error) {
+            console.error(
+              `[HolderModule] refreshAllFormRecords failed for form ${meta.form_id}`,
+              error
+            );
+            return null;
+          }
+        })
+      );
+      const nextFormMap = { ...this.store.holderMap };
+      results.forEach((result) => {
+        if (!result)
+          return;
+        this.patchFormMap(nextFormMap, result.formId, {
+          records: result.records
+        });
+        this.loadedFormIds.add(result.formId);
+      });
+      this.commitFormMap(nextFormMap);
+      return (0, import_lodash_es.cloneDeep)(nextFormMap);
+    } catch (error) {
+      this.error = error instanceof Error ? error.message : String(error);
+      throw error;
+    } finally {
+      this.isLoading = false;
+    }
+  }
   storeChange(path) {
     if (path !== "holderMap" && path !== void 0) {
       return;

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

@@ -68,7 +68,7 @@ export interface IFetchFormRecordsParams {
 export interface IAddFormRecordParams {
     url?: string;
     body: {
-        form_id: number | string;
+        form_id: number;
         shop_id: number | string;
         customer_id?: number;
         [key: string]: any;
@@ -100,6 +100,13 @@ export interface IEnsureFormByProductParams {
     shop_id?: number | string;
     useCache?: boolean;
 }
+export interface IRefreshAllFormRecordsParams {
+    customer_id?: number;
+    useCache?: boolean;
+    recordsUrl?: string;
+    num?: number;
+    skip?: number;
+}
 export interface HolderModuleAPI {
     getHolderFormMap: () => HolderFormMap;
     getHolderFormData: (formId: number | string) => IFormItemData | undefined;
@@ -112,4 +119,5 @@ export interface HolderModuleAPI {
     appendFormRecord: (params: IAppendFormRecordParams) => IFormRecord;
     removeFormRecord: (formId: number | string, formRecordId: number) => void;
     clearFormData: (formId?: number | string) => void;
+    refreshAllFormRecords: (params?: IRefreshAllFormRecordsParams) => Promise<HolderFormMap>;
 }

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

@@ -1,9 +1,13 @@
 import { ProductData } from '../Product/types';
-import { IHolderConfig } from './types';
+import { IFormItemData, 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 getFormIdFromHolderConfig(config: IHolderConfig): number;
+export declare function normalizeFormId(formId: number | string): number;
 export declare function createEmptyFormItemData(): {
     records: any[];
     form: Record<string, any>;
 };
+export declare function resolveFormMetaFromHolderItem(mapKey: string, item: IFormItemData): {
+    form_id: string | number;
+    shop_id: number | string;
+} | null;

package/lib/modules/Holder/utils.js

@@ -22,7 +22,8 @@ __export(utils_exports, {
   createEmptyFormItemData: () => createEmptyFormItemData,
   getFormIdFromHolderConfig: () => getFormIdFromHolderConfig,
   getProductHolderConfig: () => getProductHolderConfig,
-  normalizeFormId: () => normalizeFormId
+  normalizeFormId: () => normalizeFormId,
+  resolveFormMetaFromHolderItem: () => resolveFormMetaFromHolderItem
 });
 module.exports = __toCommonJS(utils_exports);
 function getProductHolderConfig(product) {
@@ -37,10 +38,10 @@ function getProductHolderConfig(product) {
   return config;
 }
 function getFormIdFromHolderConfig(config) {
-  return String(config == null ? void 0 : config.resource_id);
+  return Number(config == null ? void 0 : config.resource_id);
 }
 function normalizeFormId(formId) {
-  return String(formId);
+  return Number(formId);
 }
 function createEmptyFormItemData() {
   return {
@@ -48,10 +49,23 @@ function createEmptyFormItemData() {
     form: {}
   };
 }
+function resolveFormMetaFromHolderItem(mapKey, item) {
+  const formInfo = item.form || {};
+  const nestedForm = formInfo.form || {};
+  const form_id = normalizeFormId(
+    nestedForm.id ?? formInfo.form_id ?? formInfo.id ?? mapKey
+  );
+  const shop_id = nestedForm.shop_id ?? formInfo.shop_id;
+  if (shop_id === void 0 || shop_id === null || shop_id === "") {
+    return null;
+  }
+  return { form_id, shop_id };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   createEmptyFormItemData,
   getFormIdFromHolderConfig,
   getProductHolderConfig,
-  normalizeFormId
+  normalizeFormId,
+  resolveFormMetaFromHolderItem
 });

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;
@@ -83,7 +84,7 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
         enhancePayload?: SubmitPayloadEnhancer;
     }): Promise<T>;
     createOrder(params: CommitOrderParams['query']): {
-        type: "virtual" | "appointment_booking";
+        type: "appointment_booking" | "virtual";
         platform: string;
         sales_channel: string;
         order_sales_channel: string;

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)({
@@ -598,6 +608,7 @@ var OrderModule = class extends import_BaseModule.BaseModule {
     let is_deposit = 0;
     if (params.cartItems.length > 0) {
       params.cartItems.forEach((item) => {
+        var _a2;
         if (!item._origin.duration) {
           const { duration, durationType } = (0, import_utils.generateDuration)(item);
           item._origin.duration = duration;
@@ -605,6 +616,9 @@ var OrderModule = class extends import_BaseModule.BaseModule {
         }
         const discountList = (0, import_utils.getAllDiscountList)(item);
         item._origin.product.discount_list = discountList;
+        if ((_a2 = params == null ? void 0 : params.extraData) == null ? void 0 : _a2.is_add_holder_info) {
+          (0, import_utils.ensureCartItemOriginHolder)(item, this.window);
+        }
         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

@@ -2,6 +2,7 @@ import Decimal from 'decimal.js';
 import { CartItem } from "../Cart";
 import type { ScanOrderSubmitPayload, ScanOrderSubmitProduct, ScanOrderSummary, ScanOrderTempOrder } from '../../solution/ScanOrder/types';
 import type { RulesParamsHooks } from '../Rules/types';
+import type { WindowPlugin } from '../../plugins';
 /**
  * 把"含 option 的主商品单价"与 bundle 合成"单行 composite 单价"。
  *
@@ -86,6 +87,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, window?: WindowPlugin): void;
 export declare const getAllDiscountList: (cartItem: CartItem) => any;
 export declare function createUuidV4(): string;
 export declare function isTempOrder(data: any): data is ScanOrderTempOrder;

package/lib/modules/Order/utils.js

@@ -33,8 +33,9 @@ __export(utils_exports, {
   composeLinePrice: () => composeLinePrice,
   createDefaultOrderRulesHooks: () => createDefaultOrderRulesHooks,
   createDefaultTempOrder: () => createDefaultTempOrder,
-  createEmptySummary: () => import_utils2.createEmptySummary,
+  createEmptySummary: () => import_utils3.createEmptySummary,
   createUuidV4: () => createUuidV4,
+  ensureCartItemOriginHolder: () => ensureCartItemOriginHolder,
   filterProductsForScanOrderMore: () => filterProductsForScanOrderMore,
   formatDateTime: () => formatDateTime,
   formatV1Product: () => formatV1Product,
@@ -50,8 +51,9 @@ __export(utils_exports, {
 module.exports = __toCommonJS(utils_exports);
 var import_dayjs = __toESM(require("dayjs"));
 var import_decimal = __toESM(require("decimal.js"));
-var import_utils = require("../../solution/ScanOrder/utils");
+var import_utils = require("../Holder/utils");
 var import_utils2 = require("../../solution/ScanOrder/utils");
+var import_utils3 = require("../../solution/ScanOrder/utils");
 function composeLinePrice(params) {
   const { mainPrice, bundle, useOriginalBundle } = params;
   let total = new import_decimal.default(Number(mainPrice) || 0);
@@ -113,7 +115,7 @@ function createDefaultOrderRulesHooks() {
         // 否则同 SKU 不同小料会在 calcDiscount 重组时互相覆盖。
         // 不透明 identity 契约下，normalizeOrderProduct / restoreTempOrderFromStorage 已保证 identity_key 必存在；
         // 留 fingerprint 分支仅作 Rules 单测里直接传裸 product 时的兜底。
-        _id: product.identity_key ? `${product.product_id}_${product.product_variant_id}_${product.identity_key}` : `${product.product_id}_${product.product_variant_id}_${(0, import_utils.buildProductLineFingerprint)(
+        _id: product.identity_key ? `${product.product_id}_${product.product_variant_id}_${product.identity_key}` : `${product.product_id}_${product.product_variant_id}_${(0, import_utils2.buildProductLineFingerprint)(
           product.product_option_item,
           product.product_bundle
         )}`,
@@ -196,6 +198,34 @@ var mergeRelationForms = (relationForms) => {
     }, {})
   ).filter((item) => item.form_record_ids.length > 0);
 };
+function getCustomerIdFromStorage(window) {
+  var _a;
+  try {
+    const customer = JSON.parse(((_a = window == null ? void 0 : window.getLocalStorage) == null ? void 0 : _a.call(window, "customer")) || "{}");
+    const customerId = Number(customer == null ? void 0 : customer.id);
+    return Number.isFinite(customerId) && customerId > 0 ? customerId : void 0;
+  } catch {
+    return void 0;
+  }
+}
+function ensureCartItemOriginHolder(cartItem, window) {
+  var _a;
+  if ((_a = cartItem == null ? void 0 : cartItem._origin) == null ? void 0 : _a.holder) {
+    return;
+  }
+  const holderConfig = (0, import_utils.getProductHolderConfig)(
+    (cartItem == null ? void 0 : cartItem._productInit) ?? (cartItem == null ? void 0 : cartItem._productOrigin)
+  );
+  const formRecordId = cartItem == null ? void 0 : cartItem.holder_id;
+  if (!(holderConfig == null ? void 0 : holderConfig.resource_id) || formRecordId == null) {
+    return;
+  }
+  cartItem._origin.holder = {
+    customer_id: getCustomerIdFromStorage(window),
+    form_id: holderConfig.resource_id,
+    form_record: [formRecordId]
+  };
+}
 var getAllDiscountList = (cartItem) => {
   var _a, _b, _c, _d;
   let discountList = ((_b = (_a = cartItem == null ? void 0 : cartItem._origin) == null ? void 0 : _a.product) == null ? void 0 : _b.discount_list) || [];
@@ -378,7 +408,7 @@ function resolveSubmitCollectPax(tempOrder) {
   return normalizeSubmitCollectPaxValue((_a = tempOrder.metadata) == null ? void 0 : _a.collect_pax);
 }
 function createDefaultTempOrder(params) {
-  const summary = params.summary || (0, import_utils.createEmptySummary)();
+  const summary = params.summary || (0, import_utils2.createEmptySummary)();
   return {
     order_id: null,
     relation_id: void 0,
@@ -437,7 +467,7 @@ function buildSubmitPayload(params) {
     enhance
   } = params;
   const scheduleDate = tempOrder.schedule_date || tempOrder.created_at || formatDateTime(now);
-  const summary = tempOrder.summary || (0, import_utils.createEmptySummary)();
+  const summary = tempOrder.summary || (0, import_utils2.createEmptySummary)();
   const relationId = tempOrder.relation_id;
   const tableFormId = tempOrder.table_form_id;
   const bookingUuid = createUuidV4();
@@ -540,6 +570,7 @@ function formatV1Product(products) {
   createDefaultTempOrder,
   createEmptySummary,
   createUuidV4,
+  ensureCartItemOriginHolder,
   filterProductsForScanOrderMore,
   formatDateTime,
   formatV1Product,

package/lib/plugins/window.d.ts

@@ -16,6 +16,7 @@ export interface WindowPlugin extends Plugin {
     history: History;
     interaction?: any;
     getWalletPassEvaluator?: () => WalletPassEvaluator;
+    getLocalStorage?: (key: string) => string | null;
 }
 /**
  * 简单的 Storage 接口实现

package/lib/solution/BookingByStep/index.d.ts

@@ -131,6 +131,12 @@ export declare class BookingByStepImpl extends BaseModule implements Module {
      * 获取 holder 表单 map
      */
     getHolderFormMap(): import("../../modules").HolderFormMap;
+    /**
+     * 登录后或外部触发时，按当前 holderMap 批量刷新所有表单的 records
+     */
+    refreshAllHolderFormRecords(params?: {
+        customer_id?: number;
+    }): Promise<import("../../modules").HolderFormMap>;
     /**
      * 添加表单记录
      */
@@ -320,7 +326,7 @@ export declare class BookingByStepImpl extends BaseModule implements Module {
         date: string;
         status: string;
         week: string;
-        weekNum: 0 | 1 | 2 | 3 | 4 | 5 | 6;
+        weekNum: 0 | 5 | 1 | 4 | 2 | 3 | 6;
     }[]>;
     submitTimeSlot(timeSlots: TimeSliceItem): void;
     private getScheduleDataByIds;

package/lib/solution/BookingByStep/index.js

@@ -386,6 +386,15 @@ var BookingByStepImpl = class extends import_BaseModule.BaseModule {
   getHolderFormMap() {
     return this.store.holder.getHolderFormMap();
   }
+  /**
+   * 登录后或外部触发时，按当前 holderMap 批量刷新所有表单的 records
+   */
+  async refreshAllHolderFormRecords(params) {
+    return this.store.holder.refreshAllFormRecords({
+      customer_id: params == null ? void 0 : params.customer_id,
+      useCache: false
+    });
+  }
   /**
    * 添加表单记录
    */
@@ -499,6 +508,14 @@ var BookingByStepImpl = class extends import_BaseModule.BaseModule {
           date = (normalProductCartItem == null ? void 0 : normalProductCartItem.start_date) || "";
         }
         this.updateQuotationPriceAndCart(date);
+        try {
+          const customerId = Number(accountInfo.id);
+          await this.refreshAllHolderFormRecords({
+            customer_id: customerId
+          });
+        } catch (error) {
+          console.error("[BookingByStep] 登录后刷新 holder 表单失败", error);
+        }
       }
     } else {
       throw new Error(`没有找到${accountId}账户`);
@@ -646,7 +663,6 @@ var BookingByStepImpl = class extends import_BaseModule.BaseModule {
     try {
       this.store.holder.ensureFormByProduct({
         product: productData,
-        customer_id: (account == null ? void 0 : account.id) ? Number(account.id) : 16121,
         shop_id: (productData == null ? void 0 : productData.shop_id) || "",
         useCache: true
       });

package/lib/solution/ScanOrder/types.d.ts

@@ -34,6 +34,7 @@ export interface ScanOrderOrderProductIdentity {
     /** 参与合并/匹配；与 remove 通配语义见 isSkuOnlyDeleteIdentity */
     product_option_item?: any[];
     product_bundle?: any[];
+    shop_id?: number | string;
 }
 export interface ScanOrderOrderProduct extends ScanOrderOrderProductIdentity {
     order_detail_id: number | null;

package/lib/solution/VenueBooking/index.d.ts

@@ -7,6 +7,7 @@ import type { OpenDataAvailabilityResult } from '../../modules/OpenData';
 import type { ProductData } from '../../modules/Product/types';
 import { type CartItemSummary, type PaxInfo, type QuantityCheckResult, type QuantityLimitResult } from '../../model/strategy/adapter/itemRule';
 import type { StrategyConfig } from '../../model/strategy/type';
+import type { IAppendFormRecordParams, IRefreshAllFormRecordsParams } from '../../modules/Holder/types';
 export * from './types';
 interface VenueBookingItemRuleRuntimeConfig {
     strategyConfigs?: StrategyConfig[];
@@ -52,6 +53,12 @@ export declare class VenueBookingImpl extends BaseModule implements Module {
     constructor(name?: string, version?: string);
     private normalizeCustomerId;
     private resolveCustomerIdFromLoginPayload;
+    private resolveHolderCustomerId;
+    /**
+     * 按商品 holder_config 预加载表单数据到 holderMap。
+     * appointment_booking 在加购时触发；venueBooking 在商品加载后预加载，避免 getHolderFormMap 为空。
+     */
+    private preloadHolderForms;
     private clearLoginEffectListeners;
     private registerLoginEffect;
     private registerCustomerLoginListeners;
@@ -193,6 +200,19 @@ export declare class VenueBookingImpl extends BaseModule implements Module {
     setUIState(key: string, value: any): void;
     getUIState<T = any>(key: string): T | undefined;
     deleteUIState(key: string): void;
+    setBookingHolder(bookingUid: string, holder: any): void;
+    /**
+     * 获取 holder 表单 map
+     */
+    getHolderFormMap(): import("../../modules/Holder").HolderFormMap;
+    /**
+     * UI 层触发：按当前 holderMap 批量刷新所有表单的 records
+     */
+    refreshAllHolderFormRecords(params?: Pick<IRefreshAllFormRecordsParams, 'customer_id' | 'useCache' | 'recordsUrl' | 'num' | 'skip'>): Promise<import("../../modules/Holder").HolderFormMap>;
+    /**
+     * 添加表单记录
+     */
+    appendFormRecord(params: IAppendFormRecordParams): import("../../modules/Holder").IFormRecord;
     checkOpenDataAvailability(): Promise<OpenDataAvailabilityResult>;
     setOtherParams(params: Record<string, any>, { cover }?: {
         cover?: boolean;