@pisell/pisellos 0.0.568 → 0.10.1

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

@@ -0,0 +1,183 @@
+import type { Module } 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 { BookingTicket } from '../BookingTicket';
+export * from './types';
+/**
+ * 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
+ * it actually discounted a planner product.
+ */
+export declare function buildPlannerDiscountResult(params: {
+    customerId: number | null;
+    discountList: Record<string, any>[];
+    products: Record<string, any>[];
+    summaryBefore?: unknown;
+    summaryAfter?: unknown;
+    status: UnifiedBookingSalesDiscountResult['status'];
+    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;
+/**
+ * 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
+ * response nesting and lets one resource response serve any requested date range.
+ */
+export declare function buildPlannerResourcesFromV2(params: {
+    rawResources: Record<string, any>[];
+    scheduleList: ScheduleItem[];
+    dateRange?: ResourcePlannerQuery['dateRange'];
+}): {
+    resources: ResourcePlannerResource[];
+    externalEvents: ResourcePlannerEvent[];
+};
+/** 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;
+}): 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;
+}): 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;
+    protected store: UnifiedBookingSalesState;
+    private unifiedProductCatalog;
+    private openDataTarget;
+    private loadOpenDataInFlight;
+    private loadOpenDataInFlightTarget;
+    /**
+     * Kiosk 不能把已收款订单留在本地等待重试：默认直接等待云端 checkout。
+     * 兼容仍需要 WebPOS 待同步模式的入口可显式传 checkoutSyncTaskEnabled: true。
+     */
+    protected shouldUseCheckoutSyncTask(): boolean;
+    /** UnifiedBookingSales 的真实结账默认请求收据数据，供云端确认后再本地打印。 */
+    protected getDefaultCheckoutSmallTicketDataFlag(): number;
+    protected getRegisteredModuleNames(): readonly string[];
+    protected createSubModule(moduleName: string): Module | null;
+    /**
+     * Loads OpenData without borrowing BookingTicket. Cache ownership is tied to the exact
+     * business/channel target so a reused solution instance cannot leak another entry's menus.
+     */
+    loadOpenData(params: UnifiedBookingSalesLoadOpenDataParams): Promise<OpenDataConfig>;
+    getOpenData(): Promise<OpenDataConfig | null>;
+    /**
+     * Loads the product catalog used by both UI and Planner. Schedule data is requested with each
+     * product because session products carry their fixed intervals there.
+     */
+    loadProducts(params?: ProductListLoadProductsParams, options?: {
+        callback?: (result: any) => void;
+        subscriberId?: string;
+    }): Promise<ProductData[]>;
+    /** Date-first entry point. It delegates protocol details and cache ownership to ScheduleModule. */
+    loadScheduleAvailableDate(params: LoadScheduleAvailableDateParams): Promise<import("../../modules/Date/types").ITime[]>;
+    /**
+     * Implements the date-first product pool: the chosen date's product ids plus globally sellable
+     * other_product_ids. If a batch product query is unexpectedly empty, retry one id at a time so
+     * a partial backend incompatibility does not hide the entire date's catalog.
+     */
+    loadProductsByScheduleDate(params: UnifiedBookingSalesLoadProductsByScheduleDateParams): Promise<ProductData[]>;
+    /** Returns a copy so UI consumers cannot accidentally mutate the solution's product cache. */
+    getProductCatalog(): {
+        products: ProductData[];
+    };
+    /**
+     * Read-only compatibility view for salesSdk skins. It reconnects a booking to its product but
+     * must not be used to mutate tempOrder; all writes go through BaseSales / planner APIs.
+     */
+    getCart(): {
+        items: any[];
+        bookings: any[];
+    };
+    /**
+     * Loads the current customer's product coupons and discount cards after planner lines exist,
+     * then optionally lets the existing Rules engine select the best valid combination. This is a
+     * 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.
+     */
+    stageRetailProducts(params: UnifiedBookingSalesStageRetailProductsParams): Promise<Record<string, any> | null>;
+    /**
+     * Adds one retail line without replacing the cart's existing retail selection.
+     * This is intentionally separate from stageRetailProducts(), whose contract is
+     * "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;
+    /**
+     * Fetches resource metadata plus flat occupied events. Work windows are intentionally derived
+     * locally in buildPlannerResourcesFromV2 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>;
+}
+export declare const UnifiedBookingSales: typeof UnifiedBookingSalesImpl;