@pisell/pisellos 0.0.568 → 0.0.570

package/lib/modules/BookingContext/index.js

@@ -0,0 +1,390 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+var _exportNames = {
+  __clearBookingContextSharedCacheForTest: true,
+  buildBookingConfigQueryKey: true,
+  buildBookingResourcesQueryKey: true,
+  BookingContextModule: true
+};
+exports.BookingContextModule = void 0;
+exports.__clearBookingContextSharedCacheForTest = __clearBookingContextSharedCacheForTest;
+exports.buildBookingConfigQueryKey = buildBookingConfigQueryKey;
+exports.buildBookingResourcesQueryKey = buildBookingResourcesQueryKey;
+var _dayjs = _interopRequireDefault(require("dayjs"));
+var _BaseModule = require("../BaseModule");
+var _request = require("../../plugins/request");
+var _types = require("./types");
+Object.keys(_types).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _types[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _types[key];
+    }
+  });
+});
+var _formatResourceList = require("./utils/formatResourceList");
+var _utils = require("./utils");
+Object.keys(_utils).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _utils[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _utils[key];
+    }
+  });
+});
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+const EMPTY_STATE = {
+  bookingConfig: null,
+  resourcesOrigin: [],
+  resourcesOriginMap: {},
+  date: null
+};
+const DEFAULT_BOOKING_CONFIG_PARAMS = {
+  item_type: 'appointment_booking',
+  sub_type: 'ticket'
+};
+const BOARD_CONFIG_CACHE = {
+  useCache: true,
+  cache: {
+    mode: _request.RequestModeENUM.REMOTE_LOCAL,
+    type: 'indexDB',
+    updateCache: true
+  }
+};
+const RESOURCE_LIST_CACHE = {
+  useCache: true,
+  cache: {
+    mode: _request.RequestModeENUM.REMOTE_LOCAL,
+    type: 'memory'
+  }
+};
+const requestScopeIds = new WeakMap();
+let nextRequestScopeId = 1;
+const sharedBookingConfigCache = new Map();
+const sharedBookingConfigPending = new Map();
+const sharedResourcesCache = new Map();
+const sharedResourcesPending = new Map();
+
+/**
+ * 为 request 插件生成稳定作用域，避免不同 request 客户端之间共享缓存数据。
+ *
+ * @example
+ * const scopedKey = buildSharedCacheKey(requestPlugin, '{"sub_type":"ticket"}');
+ */
+function getRequestScopeId(request) {
+  const key = request;
+  const existed = requestScopeIds.get(key);
+  if (existed) return existed;
+  const id = nextRequestScopeId++;
+  requestScopeIds.set(key, id);
+  return id;
+}
+
+/**
+ * 共享缓存 key = request 作用域 + 已稳定序列化的业务参数。
+ *
+ * @example
+ * const cacheKey = buildSharedCacheKey(requestPlugin, '2026-06-10|1,2');
+ */
+function buildSharedCacheKey(request, queryKey) {
+  return `${getRequestScopeId(request)}:${queryKey}`;
+}
+
+/**
+ * 清理跨实例共享缓存，仅供单元测试隔离使用。
+ *
+ * @example
+ * __clearBookingContextSharedCacheForTest();
+ */
+function __clearBookingContextSharedCacheForTest() {
+  sharedBookingConfigCache.clear();
+  sharedBookingConfigPending.clear();
+  sharedResourcesCache.clear();
+  sharedResourcesPending.clear();
+}
+
+/**
+ * 把多形态 date 入参 normalize 成字符串。
+ * - dayjs 实例：调用 format()（无参 ISO）。
+ * - Date 实例：toISOString()。
+ * - 字符串：原样保留。
+ * - null/undefined/空串：→ null。
+ */
+function normalizeDate(input) {
+  if (input === null || input === undefined) return null;
+  if (typeof input === 'string') return input || null;
+  if (input instanceof Date) return input.toISOString();
+  if (typeof input.format === 'function') {
+    try {
+      return input.format() || null;
+    } catch {
+      return null;
+    }
+  }
+  return null;
+}
+
+/** 资源接口使用的 `YYYY-MM-DD` 日期串。 */
+function toScheduleQueryDate(input) {
+  const normalized = normalizeDate(input);
+  if (!normalized) return (0, _dayjs.default)().format('YYYY-MM-DD');
+  const parsed = (0, _dayjs.default)(normalized);
+  return parsed.isValid() ? parsed.format('YYYY-MM-DD') : (0, _dayjs.default)().format('YYYY-MM-DD');
+}
+
+/**
+ * 由 resources 数组派生出以 id 为 key 的 map，便于 `getResourceByIds` 直接命中。
+ */
+function buildResourcesMap(resources) {
+  const map = {};
+  resources.forEach(resource => {
+    if (resource && resource.id !== undefined && resource.id !== null) {
+      map[String(resource.id)] = resource;
+    }
+  });
+  return map;
+}
+
+/** 稳定序列化 config 查询参数，用于判断是否与上次 loadBookingConfig 一致。 */
+function buildBookingConfigQueryKey(params = {}) {
+  const merged = {
+    ...DEFAULT_BOOKING_CONFIG_PARAMS,
+    ...params
+  };
+  const keys = Object.keys(merged).sort();
+  const sorted = {};
+  keys.forEach(k => {
+    sorted[k] = merged[k];
+  });
+  return JSON.stringify(sorted);
+}
+
+/** 稳定序列化资源列表查询（date + bookingIds），用于跳过重复 loadResources。 */
+function buildBookingResourcesQueryKey(params = {}) {
+  const date = toScheduleQueryDate(params.date);
+  const ids = (params.bookingIds || []).filter(id => typeof id === 'number' && Number.isFinite(id)).sort((a, b) => a - b);
+  return `${date}|${ids.join(',')}`;
+}
+class BookingContextModule extends _BaseModule.BaseModule {
+  defaultName = 'bookingContext';
+  defaultVersion = '1.0.0';
+  request;
+  store = {
+    ...EMPTY_STATE
+  };
+  /** 上次成功 loadBookingConfig 的 query key；命中则不再请求。 */
+  lastConfigQueryKey = null;
+  /** 上次成功 loadResources 的 query key（date|bookingIds）；命中则不再请求。 */
+  lastResourcesQueryKey = null;
+  constructor(name, version) {
+    super(name, version);
+  }
+  async initialize(core, options = {}) {
+    this.core = core;
+    this.request = core.getPlugin('request');
+    if (!this.request) {
+      throw new Error('BookingContextModule 需要 request 插件支持');
+    }
+    this.store = {
+      bookingConfig: null,
+      resourcesOrigin: [],
+      resourcesOriginMap: {},
+      date: null
+    };
+    const initialState = options.initialState || {};
+    if (initialState.bookingConfig) {
+      this.store.bookingConfig = initialState.bookingConfig;
+    }
+    if (Array.isArray(initialState.resourcesOrigin)) {
+      this.store.resourcesOrigin = initialState.resourcesOrigin;
+      this.store.resourcesOriginMap = buildResourcesMap(initialState.resourcesOrigin);
+    }
+    if (initialState.date) {
+      this.store.date = initialState.date;
+    }
+  }
+  async loadBookingConfig(params = {}, options = {}) {
+    const configKey = buildBookingConfigQueryKey(params);
+    if (!options.forceRefresh && this.store.bookingConfig != null && this.lastConfigQueryKey === configKey) {
+      return this.store.bookingConfig;
+    }
+    const query = {
+      ...DEFAULT_BOOKING_CONFIG_PARAMS,
+      ...params
+    };
+    const sharedKey = buildSharedCacheKey(this.request, configKey);
+    if (!options.forceRefresh && sharedBookingConfigCache.has(sharedKey)) {
+      const cached = sharedBookingConfigCache.get(sharedKey) ?? null;
+      this.setBookingConfig(cached);
+      this.lastConfigQueryKey = configKey;
+      return cached;
+    }
+    let pending = !options.forceRefresh ? sharedBookingConfigPending.get(sharedKey) : undefined;
+    if (!pending) {
+      const requestPromise = (async () => {
+        try {
+          const res = await this.request.get('/core/board/management/config', query, BOARD_CONFIG_CACHE);
+          const config = res?.data ?? null;
+          sharedBookingConfigCache.set(sharedKey, config);
+          return config;
+        } finally {
+          sharedBookingConfigPending.delete(sharedKey);
+        }
+      })();
+      pending = requestPromise;
+      sharedBookingConfigPending.set(sharedKey, requestPromise);
+    }
+    const config = await pending;
+    this.setBookingConfig(config);
+    this.lastConfigQueryKey = configKey;
+    return config;
+  }
+  async loadResources(params = {}, options = {}) {
+    const date = toScheduleQueryDate(params.date ?? this.store.date);
+    const resourcesKey = buildBookingResourcesQueryKey({
+      date,
+      bookingIds: params.bookingIds
+    });
+    if (!options.forceRefresh && this.lastResourcesQueryKey === resourcesKey) {
+      return this.getResourcesOrigin();
+    }
+    const sharedKey = buildSharedCacheKey(this.request, resourcesKey);
+    if (!options.forceRefresh && sharedResourcesCache.has(sharedKey)) {
+      const cached = sharedResourcesCache.get(sharedKey) ?? [];
+      this.setResources(cached);
+      this.lastResourcesQueryKey = resourcesKey;
+      return this.getResourcesOrigin();
+    }
+    let pending = !options.forceRefresh ? sharedResourcesPending.get(sharedKey) : undefined;
+    if (!pending) {
+      const requestPromise = (async () => {
+        try {
+          const res = await this.request.get('/schedule/resource/list', {
+            date
+          }, RESOURCE_LIST_CACHE);
+          const {
+            list
+          } = (0, _formatResourceList.formatResourceListAndMap)(res?.data, params.bookingIds || []);
+          sharedResourcesCache.set(sharedKey, list);
+          return list;
+        } finally {
+          sharedResourcesPending.delete(sharedKey);
+        }
+      })();
+      pending = requestPromise;
+      sharedResourcesPending.set(sharedKey, requestPromise);
+    }
+    const list = await pending;
+    this.setResources(list);
+    this.lastResourcesQueryKey = resourcesKey;
+    return this.getResourcesOrigin();
+  }
+
+  /**
+   * store 内是否已具备与本次 init 入参等价的 config / resources（不再打接口）。
+   */
+  isBookingContextReady(params = {}) {
+    const configKey = buildBookingConfigQueryKey(params.bookingConfigParams);
+    const dateInput = params.date ?? this.store.date ?? (0, _dayjs.default)();
+    const queryDate = toScheduleQueryDate(dateInput);
+    const resourcesKey = buildBookingResourcesQueryKey({
+      date: queryDate,
+      bookingIds: params.bookingIds
+    });
+    const configReady = this.store.bookingConfig != null && this.lastConfigQueryKey === configKey;
+    const resourcesReady = params.loadResources === false || this.lastResourcesQueryKey === resourcesKey;
+    return configReady && resourcesReady;
+  }
+  async initBookingContext(params = {}) {
+    const dateInput = params.date ?? this.store.date ?? (0, _dayjs.default)();
+    const queryDate = toScheduleQueryDate(dateInput);
+    this.setDate(dateInput);
+    if (!params.forceRefresh && this.isBookingContextReady(params)) {
+      return this.getState();
+    }
+    const configKey = buildBookingConfigQueryKey(params.bookingConfigParams);
+    const resourcesKey = buildBookingResourcesQueryKey({
+      date: queryDate,
+      bookingIds: params.bookingIds
+    });
+    const needConfig = params.forceRefresh || this.store.bookingConfig == null || this.lastConfigQueryKey !== configKey;
+    const needResources = params.loadResources !== false && (params.forceRefresh || this.lastResourcesQueryKey !== resourcesKey);
+    if (needConfig) {
+      await this.loadBookingConfig(params.bookingConfigParams, {
+        forceRefresh: params.forceRefresh
+      });
+    }
+    if (needResources) {
+      await this.loadResources({
+        date: queryDate,
+        bookingIds: params.bookingIds
+      }, {
+        forceRefresh: params.forceRefresh
+      });
+    }
+    return this.getState();
+  }
+  setBookingConfig(config) {
+    this.store.bookingConfig = config || null;
+    this.core.effects.emit(`${this.name}:${_types.BookingContextEvent.OnBookingConfigChange}`, this.store.bookingConfig);
+  }
+  getBookingConfig() {
+    return this.store.bookingConfig;
+  }
+  setResources(resources) {
+    const list = Array.isArray(resources) ? resources : [];
+    this.store.resourcesOrigin = list;
+    this.store.resourcesOriginMap = buildResourcesMap(list);
+    this.core.effects.emit(`${this.name}:${_types.BookingContextEvent.OnResourcesChange}`, {
+      resourcesOrigin: this.store.resourcesOrigin,
+      resourcesOriginMap: this.store.resourcesOriginMap
+    });
+  }
+  getResourcesOrigin() {
+    return [...this.store.resourcesOrigin];
+  }
+  getResourcesOriginMap() {
+    return this.store.resourcesOriginMap;
+  }
+  setDate(date) {
+    this.store.date = normalizeDate(date);
+    this.core.effects.emit(`${this.name}:${_types.BookingContextEvent.OnDateChange}`, this.store.date);
+  }
+  getDate() {
+    return this.store.date;
+  }
+  getState() {
+    return {
+      bookingConfig: this.store.bookingConfig,
+      resourcesOrigin: [...this.store.resourcesOrigin],
+      resourcesOriginMap: this.store.resourcesOriginMap,
+      date: this.store.date
+    };
+  }
+  clear() {
+    this.lastConfigQueryKey = null;
+    this.lastResourcesQueryKey = null;
+    this.store = {
+      bookingConfig: null,
+      resourcesOrigin: [],
+      resourcesOriginMap: {},
+      date: null
+    };
+    this.core.effects.emit(`${this.name}:${_types.BookingContextEvent.OnBookingConfigChange}`, null);
+    this.core.effects.emit(`${this.name}:${_types.BookingContextEvent.OnResourcesChange}`, {
+      resourcesOrigin: [],
+      resourcesOriginMap: {}
+    });
+    this.core.effects.emit(`${this.name}:${_types.BookingContextEvent.OnDateChange}`, null);
+  }
+}
+exports.BookingContextModule = BookingContextModule;

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

@@ -0,0 +1,102 @@
+/**
+ * BookingContext 子模块：承载「预约 UI 上下文」三件套。
+ *
+ *  - bookingConfig：来自 `/core/board/management/config` 的整套预约配置（service_time / resource_tab /
+ *    appointment_subject / subject_require / stock_setting / basic / capacity 等）。
+ *  - resourcesOrigin / resourcesOriginMap：来自 `/schedule/resource/list` 的资源全集，含 times / event_list /
+ *    combined_resource 等运行态信息，是 getResourceByIds / getResourceTimeIsUsable 的输入。
+ *  - date：当前选择的日期（dayjs 或 ISO 字符串，迁移后内部统一存原始 ISO 字符串，UI 可自行解析）。
+ *
+ * 设计原则（与 BookingTicket 现状对齐）：
+ *  - 默认由 `loadBookingConfig` / `loadResources` 拉取并写入 store；也支持消费方 `set*` 直接灌入（复用 ticketBooking 已拉到的数据）。
+ *  - 所有读 API 返回浅克隆（数组）或原引用（map / config），避免 UI 写穿。
+ */
+/** `loadBookingConfig` 入参，与 ticketBooking `getBookingConfig` 一致。 */
+export interface LoadBookingConfigParams {
+    item_type?: string;
+    sub_type?: string;
+    source_type?: string;
+    [key: string]: any;
+}
+/** `loadResources` 入参，与 info2 `getResourceList` 一致。 */
+export interface LoadBookingResourcesParams {
+    /** 查询日期，`YYYY-MM-DD`；缺省用 store 内已 set 的 date，再缺省为当天。 */
+    date?: string;
+    /** 编辑态排除容量占用用的 booking id 列表。 */
+    bookingIds?: number[];
+}
+/** `initBookingContext` 入参（BookingTicket 聚合入口）。 */
+export interface InitBookingContextParams {
+    bookingConfigParams?: LoadBookingConfigParams;
+    date?: BookingContextDateInput;
+    /** 是否拉资源列表，默认 true。 */
+    loadResources?: boolean;
+    bookingIds?: number[];
+    /** 为 true 时忽略内存命中，强制重新请求（默认 false）。 */
+    forceRefresh?: boolean;
+}
+/**
+ * 资源全集 map：key 为资源 id（数字），value 为资源原始对象，含 times / event_list 等运行态。
+ * 这里只声明 Record 形态；具体字段保留 `any`，与 ticketBooking 现网传入的数据形状兼容。
+ */
+export declare type BookingContextResource = Record<string, any>;
+export declare type BookingContextResourceMap = Record<string, BookingContextResource>;
+/**
+ * 形参 booking_config（结构来自 `/core/board/management/config` 接口）。
+ * OS 不强制 schema，保留 `Record<string, any>` 兼容现网；常用路径文档化在 SDK docs。
+ */
+export declare type BookingContextConfig = Record<string, any>;
+/**
+ * 日期入参：接受 dayjs 实例、ISO 字符串、Date 实例；内部统一 normalize 为 ISO 字符串保存。
+ */
+export declare type BookingContextDateInput = string | Date | {
+    format?: (fmt?: string) => string;
+} | null | undefined;
+/**
+ * 内部 store 形态。`resourcesOriginMap` 由 `setResources` 派生，不允许外部直接 set。
+ */
+export interface BookingContextState {
+    bookingConfig: BookingContextConfig | null;
+    resourcesOrigin: BookingContextResource[];
+    resourcesOriginMap: BookingContextResourceMap;
+    /**
+     * 当前选择的日期，统一 ISO 字符串（'YYYY-MM-DD HH:mm:ss' 或 'YYYY-MM-DD'）。
+     * UI 取出后可自行 dayjs 解析；OS 内的计算 helper 都接受 string，不做 dayjs 依赖。
+     */
+    date: string | null;
+}
+/**
+ * BookingContextModule 对外 API（给 BookingTicket / SDK Provider 透传消费）。
+ */
+export interface BookingContextModuleAPI {
+    setBookingConfig(config: BookingContextConfig | null): void;
+    getBookingConfig(): BookingContextConfig | null;
+    setResources(resources: BookingContextResource[] | null | undefined): void;
+    getResourcesOrigin(): BookingContextResource[];
+    getResourcesOriginMap(): BookingContextResourceMap;
+    setDate(date: BookingContextDateInput): void;
+    getDate(): string | null;
+    /** 当前 store 的浅克隆，调试 / 测试用。 */
+    getState(): BookingContextState;
+    /** 一键清空，destroy / 切租户场景用。 */
+    clear(): void;
+    /** 拉取 board config 并写入 store（`/core/board/management/config`）。 */
+    loadBookingConfig(params?: LoadBookingConfigParams): Promise<BookingContextConfig | null>;
+    /** 拉取资源全集并写入 store（`/schedule/resource/list`）。 */
+    loadResources(params?: LoadBookingResourcesParams): Promise<BookingContextResource[]>;
+    /**
+     * 依次 setDate → loadBookingConfig → loadResources。
+     * SalesSdkProvider 挂载时默认调用 BookingTicket.initBookingContext。
+     */
+    initBookingContext(params?: InitBookingContextParams): Promise<BookingContextState>;
+    /** store 是否已具备与入参等价的 config / resources（无需再请求）。 */
+    isBookingContextReady(params?: InitBookingContextParams): boolean;
+}
+/**
+ * BookingContextModule 事件名常量（采用 `${this.name}:` 前缀，与现有模块一致）。
+ */
+export declare enum BookingContextEvent {
+    OnBookingConfigChange = "onBookingConfigChange",
+    OnResourcesChange = "onResourcesChange",
+    OnDateChange = "onDateChange"
+}

package/lib/modules/BookingContext/types.js

@@ -0,0 +1,48 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.BookingContextEvent = void 0;
+/**
+ * BookingContext 子模块：承载「预约 UI 上下文」三件套。
+ *
+ *  - bookingConfig：来自 `/core/board/management/config` 的整套预约配置（service_time / resource_tab /
+ *    appointment_subject / subject_require / stock_setting / basic / capacity 等）。
+ *  - resourcesOrigin / resourcesOriginMap：来自 `/schedule/resource/list` 的资源全集，含 times / event_list /
+ *    combined_resource 等运行态信息，是 getResourceByIds / getResourceTimeIsUsable 的输入。
+ *  - date：当前选择的日期（dayjs 或 ISO 字符串，迁移后内部统一存原始 ISO 字符串，UI 可自行解析）。
+ *
+ * 设计原则（与 BookingTicket 现状对齐）：
+ *  - 默认由 `loadBookingConfig` / `loadResources` 拉取并写入 store；也支持消费方 `set*` 直接灌入（复用 ticketBooking 已拉到的数据）。
+ *  - 所有读 API 返回浅克隆（数组）或原引用（map / config），避免 UI 写穿。
+ */
+/** `loadBookingConfig` 入参，与 ticketBooking `getBookingConfig` 一致。 */
+/** `loadResources` 入参，与 info2 `getResourceList` 一致。 */
+/** `initBookingContext` 入参（BookingTicket 聚合入口）。 */
+/**
+ * 资源全集 map：key 为资源 id（数字），value 为资源原始对象，含 times / event_list 等运行态。
+ * 这里只声明 Record 形态；具体字段保留 `any`，与 ticketBooking 现网传入的数据形状兼容。
+ */
+/**
+ * 形参 booking_config（结构来自 `/core/board/management/config` 接口）。
+ * OS 不强制 schema，保留 `Record<string, any>` 兼容现网；常用路径文档化在 SDK docs。
+ */
+/**
+ * 日期入参：接受 dayjs 实例、ISO 字符串、Date 实例；内部统一 normalize 为 ISO 字符串保存。
+ */
+/**
+ * 内部 store 形态。`resourcesOriginMap` 由 `setResources` 派生，不允许外部直接 set。
+ */
+/**
+ * BookingContextModule 对外 API（给 BookingTicket / SDK Provider 透传消费）。
+ */
+/**
+ * BookingContextModule 事件名常量（采用 `${this.name}:` 前缀，与现有模块一致）。
+ */
+let BookingContextEvent = exports.BookingContextEvent = /*#__PURE__*/function (BookingContextEvent) {
+  BookingContextEvent["OnBookingConfigChange"] = "onBookingConfigChange";
+  BookingContextEvent["OnResourcesChange"] = "onResourcesChange";
+  BookingContextEvent["OnDateChange"] = "onDateChange";
+  return BookingContextEvent;
+}({});

package/lib/modules/BookingContext/utils/buildCacheItemFromOrderLine.d.ts

@@ -0,0 +1,16 @@
+import type { OrderProduct } from '../../Order/types';
+export interface BuildCacheItemFromOrderLineInput {
+    /** tempOrder.products 中的一行 */
+    product: OrderProduct;
+    /** 与该行 product_uid 关联的 tempOrder.bookings 项 */
+    booking: Record<string, any>;
+    /** 商品 catalog / 详情，用于 capacity、duration、product_resource 等模板字段 */
+    sourceProduct?: Record<string, any> | null;
+}
+/**
+ * 从已加车的 order line + booking 反查 editService 所需的 cacheItem。
+ *
+ * 与 `buildCacheItemFromCartDetail` / `buildCacheItemFromDetail` 正向拼装互逆（在 getProductExtend 之前调用）。
+ * 调用方须传入与该行关联的 booking（通常 bookings[].product_uid === product.metadata.unique_identification_number）。
+ */
+export declare function buildCacheItemFromOrderLine(input: BuildCacheItemFromOrderLineInput): Record<string, any>;