@pisell/pisellos 2.2.244 → 2.2.246

package/lib/modules/BookingContext/index.js

@@ -0,0 +1,368 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/modules/BookingContext/index.ts
+var BookingContext_exports = {};
+__export(BookingContext_exports, {
+  BookingContextModule: () => BookingContextModule,
+  __clearBookingContextSharedCacheForTest: () => __clearBookingContextSharedCacheForTest,
+  buildBookingConfigQueryKey: () => buildBookingConfigQueryKey,
+  buildBookingResourcesQueryKey: () => buildBookingResourcesQueryKey
+});
+module.exports = __toCommonJS(BookingContext_exports);
+var import_dayjs = __toESM(require("dayjs"));
+var import_BaseModule = require("../BaseModule");
+var import_request = require("../../plugins/request");
+var import_types = require("./types");
+var import_formatResourceList = require("./utils/formatResourceList");
+__reExport(BookingContext_exports, require("./types"), module.exports);
+__reExport(BookingContext_exports, require("./utils"), module.exports);
+var EMPTY_STATE = {
+  bookingConfig: null,
+  resourcesOrigin: [],
+  resourcesOriginMap: {},
+  date: null
+};
+var DEFAULT_BOOKING_CONFIG_PARAMS = {
+  item_type: "appointment_booking",
+  sub_type: "ticket"
+};
+var BOARD_CONFIG_CACHE = {
+  useCache: true,
+  cache: {
+    mode: import_request.RequestModeENUM.REMOTE_LOCAL,
+    type: "indexDB",
+    updateCache: true
+  }
+};
+var RESOURCE_LIST_CACHE = {
+  useCache: true,
+  cache: {
+    mode: import_request.RequestModeENUM.REMOTE_LOCAL,
+    type: "memory"
+  }
+};
+var requestScopeIds = /* @__PURE__ */ new WeakMap();
+var nextRequestScopeId = 1;
+var sharedBookingConfigCache = /* @__PURE__ */ new Map();
+var sharedBookingConfigPending = /* @__PURE__ */ new Map();
+var sharedResourcesCache = /* @__PURE__ */ new Map();
+var sharedResourcesPending = /* @__PURE__ */ new Map();
+function getRequestScopeId(request) {
+  const key = request;
+  const existed = requestScopeIds.get(key);
+  if (existed)
+    return existed;
+  const id = nextRequestScopeId++;
+  requestScopeIds.set(key, id);
+  return id;
+}
+function buildSharedCacheKey(request, queryKey) {
+  return `${getRequestScopeId(request)}:${queryKey}`;
+}
+function __clearBookingContextSharedCacheForTest() {
+  sharedBookingConfigCache.clear();
+  sharedBookingConfigPending.clear();
+  sharedResourcesCache.clear();
+  sharedResourcesPending.clear();
+}
+function normalizeDate(input) {
+  if (input === null || input === void 0)
+    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;
+}
+function toScheduleQueryDate(input) {
+  const normalized = normalizeDate(input);
+  if (!normalized)
+    return (0, import_dayjs.default)().format("YYYY-MM-DD");
+  const parsed = (0, import_dayjs.default)(normalized);
+  return parsed.isValid() ? parsed.format("YYYY-MM-DD") : (0, import_dayjs.default)().format("YYYY-MM-DD");
+}
+function buildResourcesMap(resources) {
+  const map = {};
+  resources.forEach((resource) => {
+    if (resource && resource.id !== void 0 && resource.id !== null) {
+      map[String(resource.id)] = resource;
+    }
+  });
+  return map;
+}
+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);
+}
+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(",")}`;
+}
+var BookingContextModule = class extends import_BaseModule.BaseModule {
+  constructor(name, version) {
+    super(name, version);
+    this.defaultName = "bookingContext";
+    this.defaultVersion = "1.0.0";
+    this.store = { ...EMPTY_STATE };
+    /** 上次成功 loadBookingConfig 的 query key；命中则不再请求。 */
+    this.lastConfigQueryKey = null;
+    /** 上次成功 loadResources 的 query key（date|bookingIds）；命中则不再请求。 */
+    this.lastResourcesQueryKey = null;
+  }
+  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) : void 0;
+    if (!pending) {
+      const requestPromise = (async () => {
+        try {
+          const res = await this.request.get(
+            "/core/board/management/config",
+            query,
+            BOARD_CONFIG_CACHE
+          );
+          const config2 = (res == null ? void 0 : res.data) ?? null;
+          sharedBookingConfigCache.set(sharedKey, config2);
+          return config2;
+        } 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) : void 0;
+    if (!pending) {
+      const requestPromise = (async () => {
+        try {
+          const res = await this.request.get(
+            "/schedule/resource/list",
+            { date },
+            RESOURCE_LIST_CACHE
+          );
+          const { list: list2 } = (0, import_formatResourceList.formatResourceListAndMap)(res == null ? void 0 : res.data, params.bookingIds || []);
+          sharedResourcesCache.set(sharedKey, list2);
+          return list2;
+        } 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, import_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, import_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}:${import_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}:${import_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}:${import_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}:${import_types.BookingContextEvent.OnBookingConfigChange}`, null);
+    this.core.effects.emit(`${this.name}:${import_types.BookingContextEvent.OnResourcesChange}`, {
+      resourcesOrigin: [],
+      resourcesOriginMap: {}
+    });
+    this.core.effects.emit(`${this.name}:${import_types.BookingContextEvent.OnDateChange}`, null);
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BookingContextModule,
+  __clearBookingContextSharedCacheForTest,
+  buildBookingConfigQueryKey,
+  buildBookingResourcesQueryKey,
+  ...require("./types"),
+  ...require("./utils")
+});

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 type BookingContextResource = Record<string, any>;
+export type BookingContextResourceMap = Record<string, BookingContextResource>;
+/**
+ * 形参 booking_config（结构来自 `/core/board/management/config` 接口）。
+ * OS 不强制 schema，保留 `Record<string, any>` 兼容现网；常用路径文档化在 SDK docs。
+ */
+export type BookingContextConfig = Record<string, any>;
+/**
+ * 日期入参：接受 dayjs 实例、ISO 字符串、Date 实例；内部统一 normalize 为 ISO 字符串保存。
+ */
+export 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,34 @@
+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/BookingContext/types.ts
+var types_exports = {};
+__export(types_exports, {
+  BookingContextEvent: () => BookingContextEvent
+});
+module.exports = __toCommonJS(types_exports);
+var BookingContextEvent = /* @__PURE__ */ ((BookingContextEvent2) => {
+  BookingContextEvent2["OnBookingConfigChange"] = "onBookingConfigChange";
+  BookingContextEvent2["OnResourcesChange"] = "onResourcesChange";
+  BookingContextEvent2["OnDateChange"] = "onDateChange";
+  return BookingContextEvent2;
+})(BookingContextEvent || {});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  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>;