@pisell/pisellos 2.2.291 → 2.2.293

package/lib/modules/ResourcePlanner/types.d.ts

@@ -1,227 +1,399 @@
-export type ResourcePlannerMode = 'appointment' | 'scan_order' | 'venue_grid';
-export type ResourcePlannerProductKind = 'normal' | 'duration' | 'session' | 'venue_slot';
-export type ResourcePlannerResourceType = 'single' | 'multiple' | 'capacity';
-export type ResourcePlannerStatus = 'available' | 'limited' | 'full' | 'conflict' | 'unavailable' | 'past';
-export interface ResourcePlannerTimeRange {
-    start_at: string;
-    end_at: string;
-}
-export interface ResourcePlannerEvent extends ResourcePlannerTimeRange {
-    resourceId?: number | string;
-    resource_id?: number | string;
-    pax?: number;
-    product_uid?: string;
-    source?: 'remote' | 'cart' | 'selection';
-    [key: string]: any;
+export type AvailabilityId = number | string;
+export type AvailabilityMode = 'appointment' | 'scan_order' | 'venue_grid';
+export type AvailabilityProductKind = 'normal' | 'duration' | 'session' | 'venue_slot';
+export type AvailabilityResourceType = 'single' | 'multiple' | 'capacity';
+export type AvailabilityStatus = 'available' | 'limited' | 'full' | 'conflict' | 'unavailable' | 'past';
+export type AvailabilityScheduleMode = 'daily' | 'weekly' | 'designation';
+export type AvailabilityErrorCode = 'MISSING_ANCHOR' | 'MISSING_CATALOG_SCOPE' | 'AVAILABILITY_CONTEXT_NOT_FOUND' | 'AVAILABILITY_SELECTION_STALE' | 'AVAILABILITY_COMMIT_IN_PROGRESS' | 'OPERATING_HOURS_RESOLVE_FAILED' | 'INVALID_DATE_RANGE' | 'RANGE_TOO_LARGE' | 'OUT_OF_PROJECTION_COVERAGE' | 'STALE_PROJECTION' | 'INVALID_TARGET_FILTER' | 'MISSING_TIME_CANDIDATES' | 'MISSING_SELECTED_RANGE' | 'PRODUCT_LINE_NOT_FOUND' | 'SELF_EXCLUSION_RESOLVE_FAILED' | 'INVALID_RESERVATION_QUANTITY' | 'REVALIDATION_FAILED';
+export interface AvailabilityAbsoluteRange {
+    startAt: string;
+    endAt: string;
 }
-export interface ResourcePlannerResourceRequirement {
-    formId?: number | string;
-    resourceIds?: Array<number | string>;
-    resourceType?: ResourcePlannerResourceType;
-    capacityRequired?: number;
+export interface AvailabilityDisplayRange extends AvailabilityAbsoluteRange {
+    date: string;
+    startTime: string;
+    endTime: string;
+    timezone: string;
+}
+export interface AvailabilityDateRange {
+    startDate: string;
+    endDate: string;
+}
+export interface AvailabilityScheduleRef {
+    scheduleId?: AvailabilityId;
+    timeSlotId?: AvailabilityId;
+    ruleId?: string;
+    source?: string;
+    label?: string;
+}
+export interface AvailabilityScheduleRule {
+    id: string;
+    mode: AvailabilityScheduleMode;
+    startTime: string;
+    endTime: string;
+    startDate?: string;
+    endDate?: string;
+    frequency?: number;
+    weekdays?: number[];
+    dates?: string[];
+    includeDates?: string[];
+    excludeDates?: string[];
+    scheduleRef?: AvailabilityScheduleRef;
+}
+export interface AvailabilitySessionRange extends AvailabilityAbsoluteRange {
+    scheduleRefs?: AvailabilityScheduleRef[];
+}
+export interface AvailabilityRequirementGroup {
+    id: string;
+    formId?: AvailabilityId;
+    title?: string;
+    code?: string;
+    resourceType: AvailabilityResourceType;
     required?: boolean;
+    min?: number;
+    max?: number;
+    resourceIds?: AvailabilityId[];
+    capacityRequired?: number;
+    raw?: Record<string, any>;
 }
-export interface ResourcePlannerProduct {
-    id: number | string;
+export type AvailabilityCutOffPolicy = {
+    type: 'ongoing';
+    mode: 'before_end';
+    futureDay?: number;
+} | {
+    type: 'ongoing';
+    mode: 'after_start';
+    graceMinutes: number;
+    futureDay?: number;
+} | {
+    type: 'before_start';
+    futureDay?: number;
+} | {
+    type: 'advance';
+    unit: number;
+    unitType: 'days' | 'hours' | 'minutes';
+    futureDay?: number;
+} | {
+    type: 'invalid';
+    reason: string;
+};
+export interface AvailabilityProduct {
+    id: AvailabilityId;
     title?: string;
-    kind: ResourcePlannerProductKind;
+    kind: AvailabilityProductKind;
+    isFlexibleDuration?: boolean;
     durationMinutes?: number;
-    schedule?: ResourcePlannerTimeRange[];
-    resourceRequirements?: ResourcePlannerResourceRequirement[];
-    capacityRequired?: number;
     quantity?: number;
-    price?: string | number | null;
+    capacityRequired?: number;
+    cutOffPolicy?: AvailabilityCutOffPolicy;
+    requirementGroups?: AvailabilityRequirementGroup[];
+    sessionRules?: AvailabilityScheduleRule[];
+    sessionRanges?: AvailabilitySessionRange[];
+    raw?: Record<string, any>;
+}
+export interface AvailabilityResourceWindow extends AvailabilityAbsoluteRange {
+    source?: string;
     raw?: Record<string, any>;
 }
-export interface ResourcePlannerResource {
-    id: number | string;
-    formId?: number | string;
+export type AvailabilityOperatingHoursSource = 'prepare_business_hours' | 'open_data_schedule' | 'default_business_hours';
+export interface AvailabilityOperatingHoursSnapshot {
+    source: AvailabilityOperatingHoursSource;
+    scheduleIds: AvailabilityId[];
+    missingScheduleIds: AvailabilityId[];
+    windows: AvailabilityResourceWindow[];
+}
+export interface AvailabilityResource {
+    id: AvailabilityId;
+    formId?: AvailabilityId;
     name?: string;
-    resourceType: ResourcePlannerResourceType;
+    code?: string;
+    resourceType: AvailabilityResourceType;
     capacity: number;
-    times: Array<ResourcePlannerTimeRange & {
-        event_list?: ResourcePlannerEvent[];
-        [key: string]: any;
-    }>;
-    childResourceIds?: Array<number | string>;
+    windows: AvailabilityResourceWindow[];
     raw?: Record<string, any>;
 }
-export interface ResourcePlannerContextInput {
-    products?: ResourcePlannerProduct[];
-    resources?: ResourcePlannerResource[];
-    externalEvents?: ResourcePlannerEvent[];
-    slotDurationMinutes?: number;
-    businessStartTime?: string;
-    businessEndTime?: string;
-}
-export interface ResourcePlannerQuery {
-    mode?: ResourcePlannerMode;
-    productIds?: Array<number | string>;
-    date?: string;
-    dateRange?: {
-        start: string;
-        end: string;
-    };
-    startTime?: string;
-    endTime?: string;
-    resourceIds?: Array<number | string>;
-    serviceObjectIds?: Array<number | string>;
-    holderIds?: Array<number | string>;
+export interface AvailabilityOccupancy extends AvailabilityAbsoluteRange {
+    id?: string;
+    resourceId: AvailabilityId;
     pax?: number;
-    slotDurationMinutes?: number;
-}
-export interface ResourcePlannerSelection {
-    productIds: Array<number | string>;
-    date?: string;
-    startTime?: string;
-    endTime?: string;
-    resourceIds: Array<number | string>;
-    assignments: ResourcePlannerAssignment[];
-    mode?: ResourcePlannerMode;
+    source?: 'remote' | 'cart' | 'selection';
+    serverEventId?: AvailabilityId;
+    bookingUid?: AvailabilityId;
+    productUid?: AvailabilityId;
+    scheduleEventId?: AvailabilityId;
+    raw?: Record<string, any>;
 }
-export interface ResourcePlannerSelectionPatch extends Partial<ResourcePlannerSelection> {
-    replaceAssignments?: boolean;
+export interface AvailabilityProjectionMeta {
+    readonly snapshotId: string;
+    readonly preparedAt: string;
+    readonly timezone: string;
+    readonly orderRevision?: AvailabilityId;
+    readonly mode: AvailabilityMode;
+    readonly coverage: Readonly<AvailabilityDateRange & AvailabilityAbsoluteRange>;
+    readonly defaults: {
+        readonly slotStepMinutes: number;
+        readonly businessHours: {
+            readonly startTime: string;
+            readonly endTime: string;
+        };
+        readonly operatingHours: Readonly<AvailabilityOperatingHoursSnapshot>;
+    };
+    readonly now: string;
+    readonly durationCandidateAnchorAt: string;
+    readonly prepareParams?: Readonly<Record<string, any>>;
+    readonly anchors?: {
+        readonly productIds?: readonly AvailabilityId[];
+        readonly resourceIds?: readonly AvailabilityId[];
+        readonly dateRange?: Readonly<AvailabilityDateRange>;
+    };
 }
-export interface ResourcePlannerDemandInterval {
-    id: string;
-    productId: number | string;
-    source: Extract<ResourcePlannerProductKind, 'duration' | 'session' | 'venue_slot'>;
-    date: string;
-    start_at: string;
-    end_at: string;
-    durationMinutes: number;
-    quantity: number;
-    capacityRequired: number;
-    resourceRequirements: ResourcePlannerResourceRequirement[];
-}
-export interface ResourcePlannerConflict {
-    type: 'outside_resource_time' | 'remote_event_overlap' | 'cart_overlap' | 'capacity_full' | 'missing_time' | 'missing_resource' | 'missing_assignment' | 'past';
-    message: string;
-    event?: ResourcePlannerEvent;
-    resourceId?: number | string;
-    productId?: number | string;
+export interface AvailabilityProjectionInput {
+    products: AvailabilityProduct[];
+    resources: AvailabilityResource[];
+    resourceOccupancies?: AvailabilityOccupancy[];
+    mode?: AvailabilityMode;
+    timezone: string;
+    coverage: AvailabilityDateRange;
+    slotStepMinutes?: number;
+    businessHours?: {
+        startTime: string;
+        endTime: string;
+    };
+    operatingHours?: AvailabilityOperatingHoursSnapshot;
+    snapshotId?: string;
+    preparedAt?: string;
+    now?: string;
+    durationCandidateAnchorAt?: string;
+    orderRevision?: AvailabilityId;
+    anchors?: AvailabilityProjectionMeta['anchors'];
+    prepareParams?: Record<string, any>;
 }
-export interface ResourcePlannerAvailabilityCell {
+export interface AvailabilityCell extends AvailabilityDisplayRange {
     key: string;
-    productId: number | string;
-    resourceId?: number | string;
-    date?: string;
-    start_at: string;
-    end_at: string;
-    startTime?: string;
-    endTime?: string;
-    durationMinutes?: number;
-    cellType: 'availability_range' | 'fixed_interval' | 'unavailable';
-    status: ResourcePlannerStatus;
+    productId: AvailabilityId;
+    requirementGroupId?: string;
+    requirementFormId?: AvailabilityId;
+    resourceId?: AvailabilityId;
+    resourceName?: string;
+    resourceType?: AvailabilityResourceType;
+    status: AvailabilityStatus;
     remainingCapacity?: number;
     maxCapacity?: number;
     reasonCodes: string[];
-    conflicts: ResourcePlannerConflict[];
+    occupancyRefs: Array<{
+        id?: string;
+        resourceId: AvailabilityId;
+        source?: AvailabilityOccupancy['source'];
+        serverEventId?: AvailabilityId;
+        bookingUid?: AvailabilityId;
+        productUid?: AvailabilityId;
+        scheduleEventId?: AvailabilityId;
+    }>;
+}
+export interface AvailabilityProjection {
+    readonly meta: AvailabilityProjectionMeta;
+    readonly products: readonly AvailabilityProduct[];
+    readonly resources: readonly AvailabilityResource[];
+    readonly resourceOccupancies: readonly AvailabilityOccupancy[];
+    readonly cells: readonly AvailabilityCell[];
 }
-export interface ResourcePlannerProductOption {
-    productId: number | string;
+export interface ProductTimeRange extends AvailabilityDisplayRange {
+    key: string;
+    productId: AvailabilityId;
+    source: 'session_schedule' | 'duration_window';
+    /** Actual interval start used by availability evaluation, assignments, and cart booking. */
+    bookingStartAt: string;
+    /** Actual interval end kept explicitly for availability evaluation and cart compatibility. */
+    bookingEndAt: string;
+    scheduleRefs: AvailabilityScheduleRef[];
+    primaryScheduleRef?: AvailabilityScheduleRef;
+}
+export interface ProductTimeRangeGroup {
+    productId: AvailabilityId;
     title?: string;
-    status: ResourcePlannerStatus;
-    reasonCodes: string[];
+    kind: AvailabilityProductKind;
+    slotStepMinutes?: number;
+    ranges: ProductTimeRange[];
+}
+export interface AvailabilityAssignment extends AvailabilityAbsoluteRange {
+    productId: AvailabilityId;
+    resourceId: AvailabilityId;
+    formId?: AvailabilityId;
+    capacityRequired?: number;
+    scheduleId?: AvailabilityId;
+    timeSlotId?: AvailabilityId;
 }
-export interface ResourcePlannerResourceOption {
-    resourceId: number | string;
+export interface AvailabilityRequirementSelection {
+    requirementGroupId?: string;
+    formId?: AvailabilityId;
+    resourceIds: AvailabilityId[];
+}
+export interface GetProductTimeRangesRequest {
+    productIds?: AvailabilityId[];
+    dateRange?: Partial<AvailabilityDateRange>;
+    resourceIds?: AvailabilityId[];
+    partySize?: number;
+    durationMinutesByProductId?: Record<string, number>;
+    durationStartTimesByProductId?: Record<string, string[]>;
+    /**
+     * POS 手工输入时间的兼容开关：只为明确请求的 start time 补候选，
+     * 不改变常规候选列表仍按营业时间生成的规则。
+     */
+    allowOutsideOperatingHoursForRequestedStartTimes?: boolean;
+}
+export interface GetProductTimeRangesRuntimeOptions {
+    evaluatedAt?: string;
+}
+export interface QueryAvailabilityBaseRequest {
+    productIds?: AvailabilityId[];
+    resourceIds?: AvailabilityId[];
+    partySize?: number;
+}
+export interface ProductAvailabilityQuery extends QueryAvailabilityBaseRequest {
+    target: 'product';
+    dateRange?: Partial<AvailabilityDateRange>;
+}
+export interface DateAvailabilityQuery extends QueryAvailabilityBaseRequest {
+    target: 'date';
+    dateRange?: Partial<AvailabilityDateRange>;
+}
+export interface TimeAvailabilityQuery extends QueryAvailabilityBaseRequest {
+    target: 'time';
+    candidates: ProductTimeRange[];
+}
+export interface ResourceAvailabilityQuery extends QueryAvailabilityBaseRequest {
+    target: 'resource';
+    selectedRanges: ProductTimeRange[];
+}
+export type AvailabilityQuery = ProductAvailabilityQuery | DateAvailabilityQuery | TimeAvailabilityQuery | ResourceAvailabilityQuery;
+export interface AvailabilityResourceOption {
+    resourceId: AvailabilityId;
     resourceName?: string;
-    resourceFormId?: number | string;
-    resourceType: ResourcePlannerResourceType;
-    status: ResourcePlannerStatus;
+    resourceFormId?: AvailabilityId;
+    policyId?: AvailabilityId;
+    resourceType: AvailabilityResourceType;
+    status: AvailabilityStatus;
+    remainingCapacity?: number;
+    maxCapacity?: number;
+    maxPartySize: number;
+    reasonCodes: string[];
+}
+export interface AvailabilityRequirementGroupResult {
+    groupId: string;
+    formId?: AvailabilityId;
+    title?: string;
+    code?: string;
+    resourceType: AvailabilityResourceType;
+    required: boolean;
+    min: number;
+    max: number;
+    status: AvailabilityStatus;
+    availableResourceCount: number;
+    totalResourceCount: number;
+    maxPartySize: number;
     remainingCapacity?: number;
     maxCapacity?: number;
     reasonCodes: string[];
+    options: AvailabilityResourceOption[];
+}
+export interface TimeAvailabilityItem extends ProductTimeRange {
+    status: AvailabilityStatus;
+    maxPartySize: number;
+    reasonCodes: string[];
+    requirementGroups: AvailabilityRequirementGroupResult[];
 }
-export interface ResourcePlannerDateSummary {
+export interface ProductAvailabilityItem {
+    productId: AvailabilityId;
+    title?: string;
+    status: AvailabilityStatus;
+    reasonCodes: string[];
+    availableDateCount: number;
+    totalDateCount: number;
+    availableTimeCount: number;
+    totalTimeCount: number;
+    maxPartySize: number;
+}
+export interface DateAvailabilityItem {
     date: string;
-    status: ResourcePlannerStatus;
+    status: AvailabilityStatus;
     availableCount: number;
     totalCount: number;
+    maxPartySize: number;
+    remainingCapacity: number;
+    maxCapacity: number;
+    reasonCodes: string[];
 }
-export interface ResourcePlannerTimeSlot {
-    startTime: string;
-    endTime: string;
-    status: ResourcePlannerStatus;
-    resourceId: number | string;
-    productId?: number | string;
-    remainingCapacity?: number;
-    maxCapacity?: number;
+export interface ProductAvailabilityGroup {
+    productId: AvailabilityId;
+    title?: string;
+    item: ProductAvailabilityItem;
+}
+export interface DateAvailabilityGroup {
+    productId: AvailabilityId;
+    title?: string;
+    dates: DateAvailabilityItem[];
+}
+export interface TimeAvailabilityGroup {
+    productId: AvailabilityId;
+    title?: string;
+    times: TimeAvailabilityItem[];
+}
+export interface ResourceAvailabilityRangeGroup {
+    range: ProductTimeRange;
+    status: AvailabilityStatus;
+    maxPartySize: number;
     reasonCodes: string[];
+    requirementGroups: AvailabilityRequirementGroupResult[];
 }
-export interface ResourcePlannerTimeGridRow {
-    resourceId: number | string;
-    resourceName?: string;
-    resourceFormId?: number | string;
-    slots: ResourcePlannerTimeSlot[];
-}
-export interface ResourcePlannerTimeGrid {
-    date?: string;
-    timeLabels: string[];
-    resources: ResourcePlannerTimeGridRow[];
-}
-export interface ResourcePlannerProjection {
-    query: ResourcePlannerQuery;
-    demandIntervals: ResourcePlannerDemandInterval[];
-    productOptions: ResourcePlannerProductOption[];
-    resourceOptions: ResourcePlannerResourceOption[];
-    dateSummary: ResourcePlannerDateSummary[];
-    timeGrid: ResourcePlannerTimeGrid;
-    cells: ResourcePlannerAvailabilityCell[];
-}
-export interface ResourcePlannerAssignment {
-    productId: number | string;
-    resourceId: number | string;
-    start_at: string;
-    end_at: string;
-    capacityRequired?: number;
+export interface ResourceAvailabilityGroup {
+    productId: AvailabilityId;
+    title?: string;
+    ranges: ResourceAvailabilityRangeGroup[];
+}
+export interface AvailabilityQueryResultBase<TTarget extends AvailabilityQuery['target'], TData> {
+    target: TTarget;
+    evaluatedAt: string;
+    snapshotId: string;
+    data: TData;
 }
-export interface ResourcePlannerAssignableSlotResource {
-    resourceId: number | string;
+export type ProductAvailabilityQueryResult = AvailabilityQueryResultBase<'product', ProductAvailabilityGroup[]>;
+export type DateAvailabilityQueryResult = AvailabilityQueryResultBase<'date', DateAvailabilityGroup[]>;
+export type TimeAvailabilityQueryResult = AvailabilityQueryResultBase<'time', TimeAvailabilityGroup[]>;
+export type ResourceAvailabilityQueryResult = AvailabilityQueryResultBase<'resource', ResourceAvailabilityGroup[]>;
+export type AvailabilityQueryResult = ProductAvailabilityQueryResult | DateAvailabilityQueryResult | TimeAvailabilityQueryResult | ResourceAvailabilityQueryResult;
+export interface AvailabilityValidationConflict {
+    code: string;
+    message: string;
+    reasonCodes?: string[];
+    productId?: AvailabilityId;
+    requirementGroupId?: string;
+    formId?: AvailabilityId;
+    resourceId?: AvailabilityId;
     resourceName?: string;
-    resourceFormId?: number | string;
-    resourceType?: ResourcePlannerResourceType;
-    capacityRequired?: number;
+    candidateKey?: string;
+    requestedQuantity?: number;
+    availableQuantity?: number;
     remainingCapacity?: number;
-    maxCapacity?: number;
+    capacityPerBooking?: number;
 }
-export interface ResourcePlannerAssignableSlot {
-    key: string;
-    productId: number | string;
-    date: string;
-    start_at: string;
-    end_at: string;
-    startTime: string;
-    endTime: string;
-    durationMinutes: number;
-    status: ResourcePlannerStatus;
-    resources: ResourcePlannerAssignableSlotResource[];
-    assignments: ResourcePlannerAssignment[];
-    conflicts: ResourcePlannerConflict[];
-}
-export interface ResourcePlannerAssignableSlotResult {
-    projection: ResourcePlannerProjection;
-    slots: ResourcePlannerAssignableSlot[];
-    conflicts: ResourcePlannerConflict[];
-}
-export interface ResourcePlannerAssignmentResult {
-    assignments: ResourcePlannerAssignment[];
-    conflicts: ResourcePlannerConflict[];
-}
-export interface ResourcePlannerValidationResult {
+export interface AvailabilitySelectionValidationParams {
+    candidate: ProductTimeRange;
+    partySize?: number;
+    bookingCount?: number;
+    requirementSelections: AvailabilityRequirementSelection[];
+}
+export interface AvailabilitySelectionValidationResult {
     ok: boolean;
-    conflicts: ResourcePlannerConflict[];
-}
-export interface ResourcePlannerSnapshot {
-    context: Required<ResourcePlannerContextInput>;
-    selection: ResourcePlannerSelection;
-    projection: ResourcePlannerProjection | null;
-    version: number;
-}
-export interface ResourcePlannerState {
-    context: Required<ResourcePlannerContextInput>;
-    selection: ResourcePlannerSelection;
-    projection: ResourcePlannerProjection | null;
-    version: number;
+    status: AvailabilityStatus;
+    assignments: AvailabilityAssignment[];
+    conflicts: AvailabilityValidationConflict[];
+    availability: TimeAvailabilityItem;
+}
+export interface AvailabilityErrorDetails {
+    [key: string]: any;
+}
+export declare class AvailabilityError extends Error {
+    code: AvailabilityErrorCode;
+    details?: AvailabilityErrorDetails;
+    constructor(code: AvailabilityErrorCode, message: string, details?: AvailabilityErrorDetails);
 }

package/lib/modules/ResourcePlanner/types.js

@@ -2,4 +2,16 @@
 
 Object.defineProperty(exports, "__esModule", {
   value: true
-});
+});
+exports.AvailabilityError = void 0;
+class AvailabilityError extends Error {
+  code;
+  details;
+  constructor(code, message, details) {
+    super(message);
+    this.name = 'AvailabilityError';
+    this.code = code;
+    this.details = details;
+  }
+}
+exports.AvailabilityError = AvailabilityError;

package/lib/plugins/request.d.ts

@@ -68,6 +68,7 @@ export interface RequestOptions {
     useCache?: boolean;
     customToast?: () => void;
     cache?: CacheProps;
+    cacheUpdateChange?: (data: any) => void;
     osServer?: boolean;
     prefix?: boolean;
     callback?: (res: any) => void;

package/lib/server/index.d.ts

@@ -51,6 +51,8 @@ declare class Server {
     private productQueryScheduleTimers;
     /** 餐牌筛选为空时才触发的菜单/日程缓存自愈，避免每次商品查询都请求远端。 */
     private menuScheduleRefreshInFlight;
+    /** 启动阶段模块预加载任务；预渲染商品查询复用该任务，避免缓存尚未 ready 时误触发远端自愈。 */
+    private startupModulePreloadInFlight;
     private lastMenuScheduleRefreshAt;
     private readonly MENU_SCHEDULE_REFRESH_COOLDOWN_MS;
     private orderQuerySubscribers;
@@ -126,6 +128,9 @@ declare class Server {
     private runCheckoutSync;
     private omitCheckoutSyncMode;
     private buildRemoteCheckoutData;
+    private buildCheckoutDeviceHeaders;
+    private applyKioskCheckoutOperator;
+    private resolveKioskCheckoutOperatorId;
     private mergeCheckoutSyncPayments;
     private persistSyncedCheckoutOrder;
     /**
@@ -157,13 +162,17 @@ declare class Server {
      * 重新拉取全量 SSE 接口，更新本地数据后触发 onProductsSyncCompleted
      * 不影响当前界面展示，适用于切回前台、定时刷新等场景
      */
-    refreshProductsInBackground(): Promise<void>;
+    refreshProductsInBackground(options?: {
+        trigger?: string;
+    }): Promise<void>;
     /**
      * 后台静默刷新订单数据
      * 重新拉取全量 SSE 接口，更新本地数据后触发 onOrdersSyncCompleted
      * 不影响当前界面展示，适用于切回前台、定时刷新等场景
      */
-    refreshOrdersInBackground(): Promise<void>;
+    refreshOrdersInBackground(options?: {
+        trigger?: string;
+    }): Promise<void>;
     /**
      * 编辑正式订单时强制查询 Server 最新快照并覆盖本地缓存。
      * 商品成员增删由 OrderModule 在 SQLite/Store 更新完成后广播，
@@ -511,6 +520,12 @@ declare class Server {
     private stringifyCheckoutResourceIdentifier;
     private normalizeCheckoutSubmitData;
     private ensureCheckoutOrderNumbers;
+    /**
+     * Notes 允许在本地草稿阶段暂存空订单目标；checkout 的统一出口负责用最终
+     * shop_order_number 完成绑定并校验，保证后端请求、pending、设备任务和打印
+     * 都使用同一份完整快照。
+     */
+    private finalizeCheckoutSalesNotes;
     private dispatchCheckoutSyncTask;
     private dispatchPrintOtherReceiptTask;
     private buildPrintOtherReceiptIdempotencyKey;