@pisell/pisellos 0.0.568 → 0.10.1

package/lib/modules/BaseModule.js

@@ -1,17 +1,32 @@
-"use strict";
+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);
 
-Object.defineProperty(exports, "__esModule", {
-  value: true
+// src/modules/BaseModule.ts
+var BaseModule_exports = {};
+__export(BaseModule_exports, {
+  BaseModule: () => BaseModule
 });
-exports.BaseModule = void 0;
-class BaseModule {
-  defaultName = 'baseModule';
-  defaultVersion = '1.0.0';
-  name;
-  version;
-  isSolution = false;
-  core;
+module.exports = __toCommonJS(BaseModule_exports);
+var BaseModule = class {
   constructor(name, version) {
+    this.defaultName = "baseModule";
+    this.defaultVersion = "1.0.0";
+    this.isSolution = false;
     this.name = name || this.defaultName;
     this.version = version || this.defaultVersion;
   }
@@ -19,7 +34,6 @@ class BaseModule {
     this.core.effects.offByModuleDestroy(this.name);
     this.core.unregisterModule(this);
   }
-
   // 提供统一的缓存 module 里的数据的方法
   checkSaveCache({
     cacheId,
@@ -27,54 +41,61 @@ class BaseModule {
     store,
     cacheKey
   }) {
-    const window = this.core.getPlugin('window');
+    const window = this.core.getPlugin("window");
     if (cacheId) {
       if (fatherModule) {
         const currentCacheData = window.sessionStorage.getItem(fatherModule);
-        let currentCacheDataObj = JSON.parse(currentCacheData || '{}');
+        let currentCacheDataObj = JSON.parse(currentCacheData || "{}");
         if (!currentCacheData || !currentCacheDataObj[cacheId]) {
           currentCacheDataObj = {
             [cacheId]: {
               [this.name]: {}
-            },
-            // 防止有其他 cacheid 的数据
-            ...currentCacheDataObj
+            }
           };
         }
         if (!currentCacheDataObj[cacheId][this.name]) {
           currentCacheDataObj[cacheId][this.name] = {};
         }
-        cacheKey.forEach(key => {
-          currentCacheDataObj[cacheId][this.name][key] = store?.[key];
+        cacheKey.forEach((key) => {
+          currentCacheDataObj[cacheId][this.name][key] = store == null ? void 0 : store[key];
         });
-        window.sessionStorage.setItem(fatherModule, JSON.stringify(currentCacheDataObj));
+        window.sessionStorage.setItem(
+          fatherModule,
+          JSON.stringify(currentCacheDataObj)
+        );
       } else {
         let currentCacheData = window.sessionStorage.getItem(cacheId);
-        let currentCacheDataObj = JSON.parse(currentCacheData || '{}');
+        let currentCacheDataObj = JSON.parse(currentCacheData || "{}");
         if (!currentCacheDataObj) {
           currentCacheDataObj = {};
         }
         if (!currentCacheDataObj[this.name]) {
           currentCacheDataObj[this.name] = {};
         }
-        cacheKey.forEach(key => {
+        cacheKey.forEach((key) => {
           currentCacheDataObj[this.name][key] = store[key];
         });
-        window.sessionStorage.setItem(cacheId, JSON.stringify(currentCacheDataObj));
+        window.sessionStorage.setItem(
+          cacheId,
+          JSON.stringify(currentCacheDataObj)
+        );
       }
     }
   }
-  effectsOn(eventType, callback, force) {
-    return this.core.effects.on(`${this.name}:${eventType}`, callback, force);
+  effectsOn(eventType, callback) {
+    return this.core.effects.on(`${this.name}:${eventType}`, callback);
   }
   effectsOff(eventType, callback) {
     return this.core.effects.off(`${this.name}:${eventType}`, callback);
   }
-  effectsOnce(eventType, callback, force) {
-    return this.core.effects.once(`${this.name}:${eventType}`, callback, force);
+  effectsOnce(eventType, callback) {
+    return this.core.effects.once(`${this.name}:${eventType}`, callback);
   }
   effectsEmit(eventType, payload) {
     return this.core.effects.emit(`${this.name}:${eventType}`, payload);
   }
-}
-exports.BaseModule = BaseModule;
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BaseModule
+});

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

@@ -0,0 +1,48 @@
+import { Module, ModuleOptions, PisellCore } from '../../types';
+import { BaseModule } from '../BaseModule';
+import { BookingContextConfig, BookingContextDateInput, BookingContextModuleAPI, BookingContextResource, BookingContextResourceMap, BookingContextState, InitBookingContextParams, LoadBookingConfigParams, LoadBookingResourcesParams } from './types';
+export * from './types';
+export * from './utils';
+/**
+ * 清理跨实例共享缓存，仅供单元测试隔离使用。
+ *
+ * @example
+ * __clearBookingContextSharedCacheForTest();
+ */
+export declare function __clearBookingContextSharedCacheForTest(): void;
+/** 稳定序列化 config 查询参数，用于判断是否与上次 loadBookingConfig 一致。 */
+export declare function buildBookingConfigQueryKey(params?: LoadBookingConfigParams): string;
+/** 稳定序列化资源列表查询（date + bookingIds），用于跳过重复 loadResources。 */
+export declare function buildBookingResourcesQueryKey(params?: LoadBookingResourcesParams): string;
+export declare class BookingContextModule extends BaseModule implements Module, BookingContextModuleAPI {
+    protected defaultName: string;
+    protected defaultVersion: string;
+    private request;
+    private store;
+    /** 上次成功 loadBookingConfig 的 query key；命中则不再请求。 */
+    private lastConfigQueryKey;
+    /** 上次成功 loadResources 的 query key（date|bookingIds）；命中则不再请求。 */
+    private lastResourcesQueryKey;
+    constructor(name?: string, version?: string);
+    initialize(core: PisellCore, options?: ModuleOptions): Promise<void>;
+    loadBookingConfig(params?: LoadBookingConfigParams, options?: {
+        forceRefresh?: boolean;
+    }): Promise<BookingContextConfig | null>;
+    loadResources(params?: LoadBookingResourcesParams, options?: {
+        forceRefresh?: boolean;
+    }): Promise<BookingContextResource[]>;
+    /**
+     * store 内是否已具备与本次 init 入参等价的 config / resources（不再打接口）。
+     */
+    isBookingContextReady(params?: InitBookingContextParams): boolean;
+    initBookingContext(params?: InitBookingContextParams): Promise<BookingContextState>;
+    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;
+    getState(): BookingContextState;
+    clear(): void;
+}

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
+});