@pisell/pisellos 3.0.93 → 3.0.95

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/Cart/utils/changePrice.js

@@ -34,7 +34,7 @@ __export(changePrice_exports, {
 module.exports = __toCommonJS(changePrice_exports);
 var import_decimal = __toESM(require("decimal.js"));
 async function updateAllCartItemPrice(cartItems, priceData, getProduct, updateCart, updateItemInitInfo) {
-  var _a, _b;
+  var _a, _b, _c, _d, _e, _f;
   for (const item of cartItems) {
     const targetProduct = priceData.find((n) => n.id === item.id);
     const cartProduct = await getProduct(
@@ -44,10 +44,14 @@ async function updateAllCartItemPrice(cartItems, priceData, getProduct, updateCa
     if (!productInfo) {
       productInfo = item._productOrigin;
     }
+    const variantId = ((_a = item == null ? void 0 : item._productOrigin) == null ? void 0 : _a.product_variant_id) ?? ((_c = (_b = item == null ? void 0 : item._origin) == null ? void 0 : _b.product) == null ? void 0 : _c.product_variant_id);
+    const targetVariant = (_d = targetProduct == null ? void 0 : targetProduct.variant) == null ? void 0 : _d.find(
+      (variant) => Number(variant.id) === Number(variantId)
+    );
     let bundle = item._bundleOrigin;
-    productInfo.price = targetProduct == null ? void 0 : targetProduct.price;
-    productInfo.base_price = targetProduct == null ? void 0 : targetProduct.base_price;
-    productInfo.product_variant_id = (_a = item._productOrigin) == null ? void 0 : _a.product_variant_id;
+    productInfo.price = (targetVariant == null ? void 0 : targetVariant.price) ?? (targetProduct == null ? void 0 : targetProduct.price) ?? productInfo.price;
+    productInfo.base_price = (targetVariant == null ? void 0 : targetVariant.base_price) ?? (targetProduct == null ? void 0 : targetProduct.base_price) ?? productInfo.base_price;
+    productInfo.product_variant_id = (_e = item._productOrigin) == null ? void 0 : _e.product_variant_id;
     bundle = bundle == null ? void 0 : bundle.map((n) => {
       var _a2;
       const targetBundle = (_a2 = targetProduct == null ? void 0 : targetProduct.bundle_group) == null ? void 0 : _a2.find(
@@ -76,14 +80,14 @@ async function updateAllCartItemPrice(cartItems, priceData, getProduct, updateCa
       return n;
     });
     if (targetProduct == null ? void 0 : targetProduct.variant) {
-      productInfo.variant = (_b = productInfo.variant) == null ? void 0 : _b.map((n) => {
+      productInfo.variant = (_f = productInfo.variant) == null ? void 0 : _f.map((n) => {
         var _a2;
-        const targetVariant = (_a2 = targetProduct.variant) == null ? void 0 : _a2.find((m) => m.id === n.id);
-        if (targetVariant) {
+        const targetVariant2 = (_a2 = targetProduct.variant) == null ? void 0 : _a2.find((m) => m.id === n.id);
+        if (targetVariant2) {
           return {
             ...n,
-            price: targetVariant.price,
-            base_price: targetVariant.base_price
+            price: targetVariant2.price,
+            base_price: targetVariant2.base_price
           };
         }
         return n;

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

@@ -0,0 +1,48 @@
+import { Module, PisellCore, ModuleOptions } from '../../types';
+import { BaseModule } from '../BaseModule';
+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 {
+    protected defaultName: string;
+    protected defaultVersion: string;
+    private store;
+    private request;
+    private cacheId;
+    private openCache;
+    private fatherModule;
+    private isLoading;
+    private error;
+    /** 已加载过表单数据的 form_id 缓存标记 */
+    private loadedFormIds;
+    private window;
+    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;
+    /**
+     * 登录后按当前 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

@@ -0,0 +1,402 @@
+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");
+    this.window = this.core.getPlugin("window");
+    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, _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: customerId,
+          form_id,
+          shop_id,
+          num: num || 100,
+          skip: skip || 1,
+          front_end_cache_id: useCache && this.cacheId,
+          ...rest
+        },
+        { useCache }
+      );
+      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);
+      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({});
+    }
+  }
+  /**
+   * 登录后按当前 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;
+    }
+    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,123 @@
+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;
+        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 IRefreshAllFormRecordsParams {
+    customer_id?: number;
+    useCache?: boolean;
+    recordsUrl?: string;
+    num?: number;
+    skip?: number;
+}
+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;
+    refreshAllFormRecords: (params?: IRefreshAllFormRecordsParams) => Promise<HolderFormMap>;
+}

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,13 @@
+import { ProductData } from '../Product/types';
+import { IFormItemData, IHolderConfig } from './types';
+export declare function getProductHolderConfig(product?: ProductData | Record<string, any> | null): IHolderConfig | null;
+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: number | string;
+    shop_id: number | string;
+} | null;