@pisell/pisellos 2.3.72 → 2.3.73

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;