@pisell/pisellos 2.3.72 → 2.3.74

package/lib/server/modules/products/index.js

@@ -192,7 +192,7 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
    * Server 层负责传入完整 schedule 模块，Products 只负责把报价单计算结果转成价格响应形状。
    */
   async setupQuotationPriceBridge(params) {
-    var _a;
+    var _a, _b, _c;
     if (!this.core) {
       this.logWarning("setupQuotationPriceBridge: core 尚未初始化");
       return;
@@ -211,13 +211,13 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
         this.quotationScheduleCacheSource = params.scheduleModule;
       }
       this.quotationPriceBridge.setScheduleResolver((id) => {
-        var _a2, _b, _c, _d, _e, _f;
+        var _a2, _b2, _c2, _d, _e, _f;
         const scheduleId = String(id);
         if (this.quotationScheduleCache.has(scheduleId)) {
           return this.quotationScheduleCache.get(scheduleId);
         }
         if (!this.quotationScheduleCacheLoaded) {
-          const scheduleList = ((_b = (_a2 = params.scheduleModule).getScheduleList) == null ? void 0 : _b.call(_a2)) || [];
+          const scheduleList = ((_b2 = (_a2 = params.scheduleModule).getScheduleList) == null ? void 0 : _b2.call(_a2)) || [];
           for (const schedule of scheduleList) {
             this.quotationScheduleCache.set(String(schedule.id), schedule);
           }
@@ -226,12 +226,21 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
         if (this.quotationScheduleCache.has(scheduleId)) {
           return this.quotationScheduleCache.get(scheduleId);
         }
-        const schedules = ((_d = (_c = params.scheduleModule).getScheduleListByIds) == null ? void 0 : _d.call(_c, [id])) || ((_f = (_e = params.scheduleModule).getScheduleByIds) == null ? void 0 : _f.call(_e, [id])) || [];
+        const schedules = ((_d = (_c2 = params.scheduleModule).getScheduleListByIds) == null ? void 0 : _d.call(_c2, [id])) || ((_f = (_e = params.scheduleModule).getScheduleByIds) == null ? void 0 : _f.call(_e, [id])) || [];
         if (schedules[0])
           this.quotationScheduleCache.set(scheduleId, schedules[0]);
         return schedules[0];
       });
     }
+    if (params.onQuotationUpdated) {
+      this.quotationBridgeUpdatedCallback = params.onQuotationUpdated;
+    }
+    (_c = (_b = this.quotationPriceBridge).setQuotationListUpdatedListener) == null ? void 0 : _c.call(_b, () => {
+      var _a2;
+      this.quotationBridgeLoadedKey = this.getQuotationBridgeScopeKey();
+      this.clearPriceCache();
+      (_a2 = this.quotationBridgeUpdatedCallback) == null ? void 0 : _a2.call(this);
+    });
     await this.refreshQuotationPriceBridge({ customer_id: params.customer_id });
   }
   /**
@@ -798,17 +807,20 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
    */
   clearPriceCache() {
     this.productsPriceCache.clear();
+    this.quotationScheduleCache.clear();
+    this.quotationScheduleCacheLoaded = false;
     console.log("[ProductsModule] 🗑️ 商品价格缓存已清空");
   }
   /**
    * 通过 ProductDataSource SSE 加载完整商品列表
    */
-  async loadProductsByServer() {
+  async loadProductsByServer(options = {}) {
     if (!this.productDataSource) {
       this.logWarning("loadProductsByServer: ProductDataSource 不可用");
       return [];
     }
-    this.logInfo("开始通过 DataSource SSE 加载商品列表");
+    const trigger = options.trigger || "unknown";
+    this.logInfo("开始通过 DataSource SSE 加载商品列表", { trigger });
     const t0 = performance.now();
     try {
       const tSSE = performance.now();
@@ -816,6 +828,7 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
       const list = productList || [];
       (0, import_product.perfMark)("loadProductsByServer.SSE", performance.now() - tSSE, { count: list.length });
       this.logInfo("通过 DataSource SSE 加载商品列表成功", {
+        trigger,
         productCount: list.length,
         duration: `${Math.round(performance.now() - t0)}ms`
       });
@@ -829,6 +842,7 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
       const errorMessage = error instanceof Error ? error.message : String(error);
       console.error("[Products] 加载商品数据失败:", error);
       this.logError("通过 DataSource SSE 加载商品列表失败", {
+        trigger,
         duration: `${duration}ms`,
         error: errorMessage
       });
@@ -1019,7 +1033,9 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
   async refreshProducts() {
     const tTotal = performance.now();
     this.logInfo("refreshProducts 开始");
-    const products = await this.loadProductsByServer();
+    const products = await this.loadProductsByServer({
+      trigger: "product_sync"
+    });
     if (products && products.length > 0) {
       this.store.list = products;
       this.syncProductsMap();
@@ -1064,18 +1080,23 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
       this.logWarning("loadProductsFromIndexDB: dbManager 不可用");
       return [];
     }
+    const startedAt = performance.now();
     try {
-      const t0 = performance.now();
       const products = await this.dbManager.getAll(INDEXDB_STORE_NAME);
-      (0, import_product.perfMark)("loadProductsFromIndexDB", performance.now() - t0, { count: (products == null ? void 0 : products.length) ?? 0 });
+      const durationMs = +(performance.now() - startedAt).toFixed(2);
+      (0, import_product.perfMark)("loadProductsFromIndexDB", durationMs, { count: (products == null ? void 0 : products.length) ?? 0 });
       this.logInfo("从 IndexDB 加载商品数据", {
-        productCount: (products == null ? void 0 : products.length) ?? 0
+        productCount: (products == null ? void 0 : products.length) ?? 0,
+        durationMs
       });
       return products || [];
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : String(error);
       console.error("[Products] 从 IndexDB 读取数据失败:", error);
-      this.logError("从 IndexDB 读取数据失败", { error: errorMessage });
+      this.logError("从 IndexDB 读取数据失败", {
+        durationMs: +(performance.now() - startedAt).toFixed(2),
+        error: errorMessage
+      });
       return [];
     }
   }
@@ -1103,22 +1124,54 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
       this.logWarning("replaceProductsSnapshotInIndexDB: dbManager 不可用");
       return;
     }
+    const enqueuedAt = performance.now();
+    let queueWaitMs = 0;
+    let clearDurationMs = 0;
+    let writeDurationMs = 0;
     try {
       await this.runInProductIndexDBSaveQueue(async () => {
-        this.logInfo("replaceProductsSnapshotInIndexDB 开始", { source, productCount: products.length });
-        const t0 = performance.now();
-        await this.dbManager.clear(INDEXDB_STORE_NAME);
+        const operationStartedAt = performance.now();
+        queueWaitMs = +(operationStartedAt - enqueuedAt).toFixed(2);
+        this.logInfo("replaceProductsSnapshotInIndexDB 开始", {
+          source,
+          productCount: products.length,
+          queueWaitMs
+        });
+        const clearStartedAt = performance.now();
+        try {
+          await this.dbManager.clear(INDEXDB_STORE_NAME);
+        } finally {
+          clearDurationMs = +(performance.now() - clearStartedAt).toFixed(2);
+        }
         if (products.length > 0) {
-          await this.dbManager.bulkUpdate(INDEXDB_STORE_NAME, products);
+          const writeStartedAt = performance.now();
+          try {
+            await this.dbManager.bulkUpdate(INDEXDB_STORE_NAME, products);
+          } finally {
+            writeDurationMs = +(performance.now() - writeStartedAt).toFixed(2);
+          }
         }
-        (0, import_product.perfMark)("replaceProductsSnapshotInIndexDB", performance.now() - t0, { count: products.length });
-        this.logInfo("replaceProductsSnapshotInIndexDB 完成", { source, productCount: products.length });
+        const executeDurationMs = +(performance.now() - operationStartedAt).toFixed(2);
+        (0, import_product.perfMark)("replaceProductsSnapshotInIndexDB", executeDurationMs, { count: products.length });
+        this.logInfo("replaceProductsSnapshotInIndexDB 完成", {
+          source,
+          productCount: products.length,
+          queueWaitMs,
+          clearDurationMs,
+          writeDurationMs,
+          executeDurationMs,
+          totalDurationMs: +(performance.now() - enqueuedAt).toFixed(2)
+        });
       });
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : String(error);
       this.logError("全量保存商品到 IndexDB 失败", {
         source,
         productCount: products.length,
+        queueWaitMs,
+        clearDurationMs,
+        writeDurationMs,
+        totalDurationMs: +(performance.now() - enqueuedAt).toFixed(2),
         error: errorMessage
       });
     }
@@ -1200,6 +1253,7 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
           source: "IndexDB"
         });
         this.logInfo("预加载完成（从 IndexDB）", {
+          trigger: "preload",
           productCount: cachedData.length,
           duration: `${Math.round(performance.now() - tTotal)}ms`,
           source: "IndexDB"
@@ -1215,7 +1269,9 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
       this.logWarning("从 IndexDB 加载数据失败，准备从服务器加载", { error: errorMessage });
     }
     const tServer = performance.now();
-    const products = await this.loadProductsByServer();
+    const products = await this.loadProductsByServer({
+      trigger: "preload"
+    });
     (0, import_product.perfMark)("preload.loadFromServer", performance.now() - tServer, { count: (products == null ? void 0 : products.length) ?? 0 });
     if (products && products.length > 0) {
       this.store.list = products;
@@ -1228,6 +1284,7 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
         source: "Server"
       });
       this.logInfo("预加载完成（从服务器）", {
+        trigger: "preload",
         productCount: products.length,
         duration: `${Math.round(performance.now() - tTotal)}ms`,
         source: "Server"
@@ -1592,17 +1649,31 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
    * 拿到完整数据后一次性替换 store，清除价格缓存，触发 onProductsSyncCompleted
    * @returns 刷新后的商品列表
    */
-  async silentRefresh() {
+  async silentRefresh(options = {}) {
     const t0 = performance.now();
     const now = Date.now();
-    const elapsedSincePreload = now - this.lastPreloadCompletedAtMs;
-    const elapsedSinceFullFetch = now - this.lastServerFullFetchAtMs;
-    if (this.lastPreloadCompletedAtMs > 0 && elapsedSincePreload < PRODUCT_SILENT_REFRESH_MIN_INTERVAL_MS || this.lastServerFullFetchAtMs > 0 && elapsedSinceFullFetch < PRODUCT_SILENT_REFRESH_MIN_INTERVAL_MS) {
+    const trigger = options.trigger || "background";
+    const elapsedSincePreloadMs = now - this.lastPreloadCompletedAtMs;
+    const elapsedSinceFullFetchMs = now - this.lastServerFullFetchAtMs;
+    if (this.lastPreloadCompletedAtMs > 0 && elapsedSincePreloadMs < PRODUCT_SILENT_REFRESH_MIN_INTERVAL_MS || this.lastServerFullFetchAtMs > 0 && elapsedSinceFullFetchMs < PRODUCT_SILENT_REFRESH_MIN_INTERVAL_MS) {
+      this.logInfo("silentRefresh 跳过全量 SSE", {
+        trigger,
+        reason: "within_min_interval",
+        minIntervalMs: PRODUCT_SILENT_REFRESH_MIN_INTERVAL_MS,
+        elapsedSincePreloadMs,
+        elapsedSinceFullFetchMs,
+        productCount: this.store.list.length
+      });
       return this.store.list;
     }
-    this.logInfo("silentRefresh 开始");
+    this.logInfo("silentRefresh 开始", {
+      trigger,
+      elapsedSincePreloadMs,
+      elapsedSinceFullFetchMs,
+      productCount: this.store.list.length
+    });
     try {
-      const products = await this.loadProductsByServer();
+      const products = await this.loadProductsByServer({ trigger });
       if (products && products.length > 0) {
         this.store.list = products;
         this.syncProductsMap();
@@ -1610,6 +1681,7 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
         this.core.effects.emit(import_types.ProductsHooks.onProductsChanged, this.store.list);
         await this.core.effects.emit(import_types.ProductsHooks.onProductsSyncCompleted, null);
         this.logInfo("silentRefresh 完成", {
+          trigger,
           productCount: products.length,
           duration: `${Math.round(performance.now() - t0)}ms`
         });
@@ -1621,6 +1693,7 @@ var ProductsModule = class extends import_BaseModule.BaseModule {
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : String(error);
       this.logError("silentRefresh 失败", {
+        trigger,
         duration: `${Math.round(performance.now() - t0)}ms`,
         error: errorMessage
       });

package/lib/server/modules/resource/index.js

@@ -88,13 +88,18 @@ var ResourceModule = class extends import_BaseModule.BaseModule {
     }
   }
   async preload() {
-    await this.setupResourceSync();
     const cachedResources = await this.loadResourcesFromSQLite();
     if (cachedResources.length > 0) {
       this.store.list = (0, import_lodash_es.cloneDeep)(cachedResources).map((item) => this.normalizeResource(item));
       this.syncResourcesMap();
       await this.safeEmit(import_types.ResourceHooks.onResourcesChanged, this.store.list);
-    } else {
+      void this.setupResourceSync().catch((error) => {
+        this.logError("后台初始化资源同步失败", error);
+      });
+      return;
+    }
+    await this.setupResourceSync();
+    if (this.store.list.length === 0) {
       const resources = await this.loadResourcesByServer();
       if (resources.length > 0) {
         this.store.list = (0, import_lodash_es.cloneDeep)(resources).map((item) => this.normalizeResource(item));

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

@@ -326,7 +326,7 @@ export declare class BookingByStepImpl extends BaseModule implements Module {
         date: string;
         status: string;
         week: string;
-        weekNum: 0 | 1 | 2 | 6 | 4 | 3 | 5;
+        weekNum: 0 | 2 | 1 | 3 | 4 | 5 | 6;
     }[]>;
     submitTimeSlot(timeSlots: TimeSliceItem): void;
     private getScheduleDataByIds;

package/lib/solution/BookingTicket/index.js

@@ -1398,7 +1398,8 @@ var BookingTicketImpl = class extends import_BaseSales.BaseSalesImpl {
       date,
       presetStartTime: (extra == null ? void 0 : extra.presetStartTime) ?? (0, import_BookingContext.derivePresetStartTimeFromDate)(date),
       customerId: orderCustomerId,
-      ...extra || {}
+      ...extra || {},
+      channel: this.getSubmitOrderSalesChannel()
     };
   }
   /**

package/lib/solution/BookingTicket/utils/addProductDecision.d.ts

@@ -5,7 +5,7 @@ import type { OrderProduct, OrderProductIdentity, AddProductBookingInput } from
  * cart.addProduct 两阶段决策（与 ticketBooking `handleSelectProduct` 对齐）：
  *
  * 1. `requiresDetail`：规格 / SKU / 套餐 / Session / 称重弹窗（门禁：`isOpenDetailModal` / `cartDetailValue` / `open_sold_weight`）
- * 2. `requiresBookingEdit`：资源 / 时间编辑抽屉（门禁：`getIsAutoClose` on prepared cacheItem）
+ * 2. `requiresBookingEdit`：资源 / 时间编辑抽屉（kiosk 强制进入；其他渠道由 `getIsAutoClose` 决定）
  * 3. `add`：两关均通过，直接 transform + 加车
  */
 export type AddProductDecision = {
@@ -65,6 +65,7 @@ export interface AddProductDecideContext extends BookingCalcContext {
     type?: 'select' | 'detail';
     quantity?: number;
     customerId?: number | string;
+    channel?: string;
 }
 /**
  * 统一补齐预约商品的运行态字段。

package/lib/solution/BookingTicket/utils/addProductDecision.js

@@ -57,6 +57,8 @@ function needsSpecDetailModal(item) {
 function needsBookingEdit(cacheItem, ctx) {
   if (isNormalBookingProduct(cacheItem))
     return false;
+  if ((ctx == null ? void 0 : ctx.channel) === "kiosk")
+    return true;
   const isAutoAllocationOn = (ctx == null ? void 0 : ctx.isAutoAllocationOn) || (() => true);
   return !(0, import_BookingContext.getIsAutoClose)(cacheItem, isAutoAllocationOn);
 }

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

@@ -1,12 +1,13 @@
-import type { Module } from '../../types';
+import type { Module, ModuleOptions, PisellCore } from '../../types';
 import type { ProductData } from '../../modules';
 import type { OpenDataConfig } from '../../modules/OpenData';
 import type { LoadScheduleAvailableDateParams, ScheduleItem } from '../../modules/Schedule/types';
 import type { ProductListLoadProductsParams } from '../../modules/ProductList';
-import type { ResourcePlannerAssignment, ResourcePlannerAssignableSlotResult, ResourcePlannerEvent, ResourcePlannerProduct, ResourcePlannerProjection, ResourcePlannerQuery, ResourcePlannerResource, ResourcePlannerSelectionPatch, ResourcePlannerSnapshot, ResourcePlannerValidationResult } from '../../modules/ResourcePlanner';
-import type { UnifiedBookingSalesCommitPlannerSelectionParams, UnifiedBookingSalesCommitResult, UnifiedBookingSalesAddRetailProductParams, UnifiedBookingSalesApplyPlannerDiscountsParams, UnifiedBookingSalesDiscountResult, UnifiedBookingSalesLoadProductsByScheduleDateParams, UnifiedBookingSalesLoadPlannerContextParams, UnifiedBookingSalesLoadOpenDataParams, UnifiedBookingSalesStagePlannerProductsParams, UnifiedBookingSalesStageRetailProductsParams, UnifiedBookingSalesState } from './types';
+import type { AvailabilityDateRange, AvailabilityOccupancy, AvailabilityProduct, AvailabilityResource, GetProductTimeRangesRequest } from '../../modules/ResourcePlanner';
+import type { AvailabilityContextRef, ContextualAvailabilityQuery, ContextualAvailabilityQueryResult, ContextualCommitAvailabilitySelectionParams, ContextualProductTimeRangeGroup, UnifiedBookingSalesAddRetailProductParams, UnifiedBookingSalesApplyPlannerDiscountsParams, UnifiedBookingSalesCommitAvailabilitySelectionResult, UnifiedBookingSalesDiscountResult, UnifiedBookingSalesLoadProductsByScheduleDateParams, UnifiedBookingSalesLoadOpenDataParams, UnifiedBookingSalesPrepareAvailabilityProjectionParams, UnifiedBookingSalesStageRetailProductsParams, UnifiedBookingSalesState } from './types';
 import { BookingTicket } from '../BookingTicket';
 export * from './types';
+export { AvailabilityError } from '../../modules/ResourcePlanner';
 /**
  * Converts Rules/Order discount internals into a small UI-facing diagnostic. The result keeps
  * candidate-card state separate from line-level applications: a selected card is not proof that
@@ -22,39 +23,37 @@ export declare function buildPlannerDiscountResult(params: {
     preferredDiscountId?: number | string;
     preferredDiscountFound?: boolean;
 }): UnifiedBookingSalesDiscountResult;
-/** Converts a ProductList record into the pure input shape consumed by ResourcePlanner. */
-export declare function normalizeProductForPlanner(product: ProductData | Record<string, any>): ResourcePlannerProduct;
+/** Converts ProductList and schedule records into the pure Availability vocabulary. */
+export declare function normalizeProductForAvailability(product: ProductData | Record<string, any>, scheduleList?: ScheduleItem[], fixedOffsetMinutes?: number): AvailabilityProduct;
 /**
  * Materializes resource work windows locally from v2's schedule ids, then keeps its flat
- * event_list as planner events. This deliberately avoids the older API's times -> event_list
+ * event_list as resource occupancy records. This deliberately avoids the older API's times -> event_list
  * response nesting and lets one resource response serve any requested date range.
  */
-export declare function buildPlannerResourcesFromV2(params: {
+export declare function buildAvailabilityResourcesFromV2(params: {
     rawResources: Record<string, any>[];
     scheduleList: ScheduleItem[];
-    dateRange?: ResourcePlannerQuery['dateRange'];
+    dateRange?: AvailabilityDateRange;
+    fixedOffsetMinutes?: number;
 }): {
-    resources: ResourcePlannerResource[];
-    externalEvents: ResourcePlannerEvent[];
+    resources: AvailabilityResource[];
+    resourceOccupancies: AvailabilityOccupancy[];
 };
 /** Combines URL-locked resources with every resource referenced by the selected products. */
-export declare function collectPlannerResourceIds(products: ResourcePlannerProduct[], explicitResourceIds?: Array<number | string>): Array<number | string>;
-/** Convenience wrapper for the usual one-resource booking case. */
-export declare function buildBookingFromAssignment(params: {
-    assignment: ResourcePlannerAssignment;
-    product: ResourcePlannerProduct;
+export declare function collectAvailabilityResourceIds(products: AvailabilityProduct[], explicitResourceIds?: Array<number | string>): Array<number | string>;
+export declare function buildAvailabilityLineIdentity(product: Record<string, any>): Record<string, any>;
+export declare function buildBookingFromAvailabilityAssignment(params: {
+    assignment: Record<string, any>;
+    product: AvailabilityProduct;
+    timezone?: string;
+    fixedOffsetMinutes?: number;
 }): Record<string, any>;
-/**
- * Converts all resources needed by one product/time interval into the one booking expected by
- * OrderModule. Callers must group assignments before this function so a multi-form booking does
- * not become several competing bookings.
- */
-export declare function buildBookingFromAssignments(params: {
-    assignments: ResourcePlannerAssignment[];
-    product: ResourcePlannerProduct;
+export declare function buildBookingFromAvailabilityAssignments(params: {
+    assignments: Record<string, any>[];
+    product: AvailabilityProduct;
+    timezone?: string;
+    fixedOffsetMinutes?: number;
 }): Record<string, any>;
-/** Builds the exact identity BaseSales needs to remove only this solution's order lines. */
-export declare function buildPlannerLineIdentity(product: Record<string, any>): Record<string, any>;
 export declare class UnifiedBookingSalesImpl extends BookingTicket {
     protected defaultName: string;
     protected defaultVersion: string;
@@ -63,7 +62,52 @@ export declare class UnifiedBookingSalesImpl extends BookingTicket {
     private openDataTarget;
     private loadOpenDataInFlight;
     private loadOpenDataInFlightTarget;
+    private availabilityRuntimeOffsetMinutes;
+    private availabilityScheduleCatalog;
+    private availabilityProjectionSequence;
+    private availabilityContextSequence;
+    private availabilityLifecycleGeneration;
+    private availabilityContextRegistry;
+    private availabilityProjectionPool;
+    private availabilityPrepareInFlight;
+    private availabilityProjectionRefreshInFlight;
+    private availabilityRemoteOccupancyCache;
+    private availabilityRemoteResourceQueryInFlight;
+    private availabilityRemoteResourceQuerySequence;
+    private availabilityRemoteResourceEpoch;
+    private availabilityCommitLocks;
+    initialize(core: PisellCore, options?: ModuleOptions): Promise<void>;
     protected getSubmitOrderSalesChannel(): string;
+    private createAvailabilityFacadeError;
+    private getAvailabilityScopeDescriptor;
+    private normalizeAvailabilityIdList;
+    private normalizeAvailabilityStringList;
+    private normalizeAvailabilityPrepareDescriptor;
+    private resolveAvailabilityPrepareDefaults;
+    private buildAvailabilityPrepareKey;
+    private clearAvailabilityRemoteResourceState;
+    private buildAvailabilityRemoteResourceScopeKey;
+    private buildAvailabilityRemoteResourceQueryKey;
+    setOtherParams(params: Record<string, any>, { cover }?: {
+        cover?: boolean;
+    }): Promise<void>;
+    destroy(): Promise<void>;
+    private createAvailabilityContextId;
+    private buildAvailabilityProjectionKey;
+    private getAvailabilityRuntimeOffsetMinutes;
+    private getAvailabilityRuntimeDateTime;
+    private cloneAvailabilityPrepareParams;
+    private getAvailabilityDurationCandidateAnchorAt;
+    private createAvailabilityContextRef;
+    private emitAvailabilityDiagnostic;
+    private touchAvailabilityContext;
+    private touchAvailabilityProjection;
+    private removeAvailabilityProjection;
+    private removeAvailabilityContext;
+    private evictAvailabilityProjectionPool;
+    private evictAvailabilityContextRegistry;
+    private invalidateAvailabilityContextsAfterCommit;
+    private resetAvailabilityProjectionState;
     protected isSessionStoragePersistEnabled(): boolean;
     protected shouldUseSessionStorageForSubModule(moduleName?: string): boolean;
     /**
@@ -133,17 +177,10 @@ export declare class UnifiedBookingSalesImpl extends BookingTicket {
      * diagnostic boundary for new booking skins: no pricing logic is duplicated in the planner.
      */
     applyPlannerDiscounts(params?: UnifiedBookingSalesApplyPlannerDiscountsParams): Promise<UnifiedBookingSalesDiscountResult>;
-    /** ResourcePlanner is a required child module; fail early instead of producing partial availability. */
-    private getPlanner;
     private buildUnifiedOrderProduct;
     /** Replacing a staged selection is idempotent and never removes unrelated cart lines. */
     private removeExistingStagedLines;
     private stageProducts;
-    /**
-     * Adds the current product choice to an otherwise clean planner cart without creating bookings.
-     * This separates "what the customer wants" from the later time/resource confirmation step.
-     */
-    stagePlannerProducts(params: UnifiedBookingSalesStagePlannerProductsParams): Promise<Record<string, any> | null>;
     /**
      * Adds ordinary retail products without asking ResourcePlanner for booking facts.
      * Its staged lines have separate ownership so planner and retail skins can coexist safely.
@@ -155,50 +192,50 @@ export declare class UnifiedBookingSalesImpl extends BookingTicket {
      * "replace the staged selection" for demo and wizard-like callers.
      */
     addRetailProduct(params: UnifiedBookingSalesAddRetailProductParams): Promise<Record<string, any>[]>;
-    /** Normalizes caller-provided products or loads the catalog before any resource request is made. */
-    private loadPlannerProducts;
-    /** Loads the reusable store-level schedule catalog on demand. */
-    private ensurePlannerSchedulesLoaded;
-    /**
-     * v2 resources reference schedule ids rather than expanded work times. Refresh once when the
-     * cached schedule catalog cannot materialize all referenced ids.
-     */
-    private ensurePlannerSchedulesForResources;
+    private normalizeAvailabilityDateRange;
+    private assertAvailabilityPrepareParams;
+    private captureAvailabilityScheduleCatalog;
+    /** Returns the solution-lifetime schedule snapshot captured after initialization. */
+    private getAvailabilityScheduleCatalog;
+    private buildAvailabilityOperatingHoursSnapshot;
+    private loadAvailabilityProducts;
     /**
      * Fetches resource metadata plus flat occupied events. Work windows are intentionally derived
-     * locally in buildPlannerResourcesFromV2 from /schedule, rather than requested from the legacy
+     * locally in buildAvailabilityResourcesFromV2 from /schedule, rather than requested from the legacy
      * resource dates endpoint.
      */
-    private fetchPlannerResourcesV2;
-    /**
-     * Resolves the Planner context in precedence order: explicit normalized context, test raw data,
-     * then the v2 resource API inferred from selected product requirements and any URL lock.
-     */
-    private loadPlannerResources;
-    /**
-     * Boundary between IO and pure planning. Once this returns, all later availability/slot calls
-     * operate on the ResourcePlanner snapshot and do not issue resource requests themselves.
-     */
-    loadPlannerContext(params?: UnifiedBookingSalesLoadPlannerContextParams): Promise<ResourcePlannerSnapshot>;
-    /** Returns cells, date summaries and a derived grid; cells are continuous ranges, not UI slots. */
-    queryPlannerAvailability(query?: ResourcePlannerQuery): Promise<ResourcePlannerProjection>;
-    /** Turns compatible availability ranges into user-selectable intervals and ready-to-commit assignments. */
-    resolveAssignableSlots(query?: ResourcePlannerQuery): ResourcePlannerAssignableSlotResult;
-    /** Stores a UI choice only. It is deliberately side-effect free with respect to tempOrder. */
-    setPlannerSelection(patch: ResourcePlannerSelectionPatch): ResourcePlannerSnapshot;
-    /**
-     * Legacy-friendly automatic assignment for already fixed intervals. Duration products without a
-     * start time intentionally remain unresolved; callers offering a picker should use slots.
-     */
-    autoAssignPlanner(query?: ResourcePlannerQuery): Promise<ResourcePlannerSnapshot>;
-    /** Rechecks remote events, capacity and conflicts among the current selection before committing. */
-    validatePlannerSelection(): ResourcePlannerValidationResult;
-    /** Read-only snapshot for UI diagnostics and progressive flow steps. */
-    getPlannerSnapshot(): ResourcePlannerSnapshot;
-    /**
-     * Validates then writes assignments to tempOrder. Real order submission is opt-in so UI callers
-     * can safely preview the cart; pass submitAfterCommit only after an explicit confirmation.
-     */
-    commitPlannerSelection(params?: UnifiedBookingSalesCommitPlannerSelectionParams): Promise<UnifiedBookingSalesCommitResult>;
+    private fetchAvailabilityResourcesV2;
+    private fetchAndPublishAvailabilityResourcesV2;
+    private refreshAvailabilityRemoteResourceQuery;
+    private loadAvailabilityResources;
+    private resolveEditingOccupancyExclusions;
+    private occupancyIsExcluded;
+    private collectCartResourceOccupancies;
+    private getCurrentOrderRevision;
+    private getAvailabilityContextEntry;
+    private getAvailabilityProjectionByKey;
+    private getActiveAvailabilityProjectionEntry;
+    private decorateAvailabilityCandidate;
+    private assertAvailabilityCandidateFreshness;
+    private assertContextualQueryFreshness;
+    private storeAvailabilityProjectionEntry;
+    private buildAvailabilityProjectionSnapshot;
+    private getSharedPreparedAvailabilitySnapshot;
+    private refreshAvailabilityContextProjection;
+    private ensureAvailabilityContextProjection;
+    private tryAcquireAvailabilityCommitLock;
+    private releaseAvailabilityCommitLock;
+    /** IO boundary: loads catalog, schedules, resources, occupancies, and registers one context. */
+    prepareAvailabilityProjection(params: UnifiedBookingSalesPrepareAvailabilityProjectionParams): Promise<AvailabilityContextRef>;
+    /** Pure configuration calculation over the current context projection. */
+    getProductTimeRanges(contextId: string, request?: GetProductTimeRangesRequest): Promise<ContextualProductTimeRangeGroup[]>;
+    /** Thin facade: auto-refresh on cart drift, then delegate to the pure projection query. */
+    queryBookingAvailability(contextId: string, request: ContextualAvailabilityQuery): Promise<ContextualAvailabilityQueryResult>;
+    releaseAvailabilityContext(contextId: string): void;
+    private assertAvailabilityCommitWriteCAS;
+    private findProductLineByUid;
+    private findLinkedBooking;
+    /** Revalidates against the latest landed occupancy cache, then mutates exactly one product line. */
+    commitAvailabilitySelection(contextId: string, params: ContextualCommitAvailabilitySelectionParams): Promise<UnifiedBookingSalesCommitAvailabilitySelectionResult>;
 }
 export declare const UnifiedBookingSales: typeof UnifiedBookingSalesImpl;