@pisell/pisellos 0.10.53 → 0.10.55

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

@@ -216,6 +216,8 @@ export interface UnifiedBookingSalesDiscountResult {
     summaryAfter?: unknown;
 }
 export interface UnifiedBookingSalesApi {
+    /** Uses cached business settings and evaluates the current store-local clock. */
+    getBusinessAvailability: () => Promise<import('../../modules/BusinessAvailability').BusinessAvailability>;
     loadOpenData: (params: UnifiedBookingSalesLoadOpenDataParams) => Promise<OpenDataConfig>;
     /** Returns the latest OpenData payload cached by this solution instance. */
     getOpenData: () => Promise<OpenDataConfig | null>;

package/dist/solution/index.d.ts

@@ -9,3 +9,4 @@ export * from './ScanOrder';
 export * from './BaseSales';
 export * from './VenueBooking';
 export * from './UnifiedBookingSales';
+export * from './OrderInvoicePreview';

package/dist/solution/index.js

@@ -8,4 +8,5 @@ export * from "./Sales";
 export * from "./ScanOrder";
 export * from "./BaseSales";
 export * from "./VenueBooking";
-export * from "./UnifiedBookingSales";
+export * from "./UnifiedBookingSales";
+export * from "./OrderInvoicePreview";

package/lib/index.d.ts

@@ -10,3 +10,5 @@ export * from './model';
 export { PisellOSCore } from './core';
 import PisellOSCore from './core';
 export default PisellOSCore;
+export * from './shared/receipt/small-ticket';
+export { loadSalesOrderSnapshot } from './shared/sales/loadSalesOrderSnapshot';

package/lib/index.js

@@ -4,7 +4,8 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 var _exportNames = {
-  PisellOSCore: true
+  PisellOSCore: true,
+  loadSalesOrderSnapshot: true
 };
 Object.defineProperty(exports, "PisellOSCore", {
   enumerable: true,
@@ -13,6 +14,12 @@ Object.defineProperty(exports, "PisellOSCore", {
   }
 });
 exports.default = void 0;
+Object.defineProperty(exports, "loadSalesOrderSnapshot", {
+  enumerable: true,
+  get: function () {
+    return _loadSalesOrderSnapshot.loadSalesOrderSnapshot;
+  }
+});
 var _types = require("./types");
 Object.keys(_types).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
@@ -74,6 +81,19 @@ Object.keys(_model).forEach(function (key) {
   });
 });
 var _core = _interopRequireWildcard(require("./core"));
+var _smallTicket = require("./shared/receipt/small-ticket");
+Object.keys(_smallTicket).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _smallTicket[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _smallTicket[key];
+    }
+  });
+});
+var _loadSalesOrderSnapshot = require("./shared/sales/loadSalesOrderSnapshot");
 function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
 function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && Object.prototype.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
 /**

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

@@ -0,0 +1,30 @@
+import type { MultiLangObject } from '../OpenData/types';
+import type { ScheduleItem } from '../Schedule/types';
+export type BusinessClosedBehavior = 'show_menu_disabled' | 'hide_all';
+export interface BusinessAvailability {
+    status: 'open' | 'paused' | 'closed' | 'error';
+    behavior: BusinessClosedBehavior | null;
+    message: string | MultiLangObject | null;
+    /** Epoch milliseconds. Re-evaluate the cached configuration at this time. */
+    nextChangeAt: number;
+    requirePaymentOnSubmit: boolean;
+    error?: string;
+}
+export interface BusinessAvailabilityConfig {
+    paused: boolean;
+    pauseBehavior: BusinessClosedBehavior;
+    closedBehavior: BusinessClosedBehavior;
+    pauseMessage: BusinessAvailability['message'];
+    closedMessage: BusinessAvailability['message'];
+    scheduleIds: number[];
+    invalidScheduleIds: boolean;
+    requirePaymentOnSubmit: boolean;
+}
+export declare function normalizeBusinessAvailabilityConfig(data: Record<string, unknown>): BusinessAvailabilityConfig;
+/** Business ordering is independent of reservation switches and Pickup slot availability. */
+export declare function computeBusinessAvailability(input: {
+    config: BusinessAvailabilityConfig;
+    schedules: ScheduleItem[];
+    timezone: string;
+    now: Date;
+}): BusinessAvailability;

package/lib/modules/BusinessAvailability/index.js

@@ -0,0 +1,146 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.computeBusinessAvailability = computeBusinessAvailability;
+exports.normalizeBusinessAvailabilityConfig = normalizeBusinessAvailabilityConfig;
+var _dayjs = _interopRequireDefault(require("dayjs"));
+var _isSameOrAfter = _interopRequireDefault(require("dayjs/plugin/isSameOrAfter"));
+var _isSameOrBefore = _interopRequireDefault(require("dayjs/plugin/isSameOrBefore"));
+var _getDateIsInSchedule = require("../Schedule/getDateIsInSchedule");
+function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
+_dayjs.default.extend(_isSameOrAfter.default);
+_dayjs.default.extend(_isSameOrBefore.default);
+const DAY = 86_400_000;
+const behavior = value => value === 'show_menu_disabled' ? value : 'hide_all';
+const message = value => typeof value === 'string' || value !== null && typeof value === 'object' && !Array.isArray(value) ? value : null;
+function normalizeBusinessAvailabilityConfig(data) {
+  const rawIds = data['availability.operating_hours'];
+  const ids = Array.isArray(rawIds) ? rawIds.map(id => typeof id === 'number' || typeof id === 'string' ? Number(id) : NaN) : [];
+  const validIds = ids.filter(id => Number.isInteger(id) && id > 0);
+  const paused = data['availability.paused'];
+  return {
+    paused: paused === true || paused === 1 || paused === 'true' || paused === '1',
+    pauseBehavior: behavior(data['availability.pause_behavior']),
+    closedBehavior: behavior(data['availability.closed_behavior']),
+    pauseMessage: message(data['availability.pause_message']),
+    closedMessage: message(data['availability.closed_message']),
+    scheduleIds: [...new Set(validIds)],
+    invalidScheduleIds: rawIds != null && (!Array.isArray(rawIds) || validIds.length !== ids.length),
+    // Only an explicitly disabled setting changes the existing payment flow.
+    requirePaymentOnSubmit: data['sale.require_payment_on_submit'] !== false
+  };
+}
+function createClock(timezone) {
+  if (!timezone) throw new Error('Store timezone is unavailable.');
+  const formatter = new Intl.DateTimeFormat('en-GB', {
+    timeZone: timezone,
+    year: 'numeric',
+    month: '2-digit',
+    day: '2-digit',
+    hour: '2-digit',
+    minute: '2-digit',
+    second: '2-digit',
+    hourCycle: 'h23'
+  });
+  const local = timestamp => {
+    const parts = {};
+    formatter.formatToParts(timestamp).forEach(part => {
+      parts[part.type] = part.value;
+    });
+    const date = `${parts.year}-${parts.month}-${parts.day}`;
+    return {
+      date,
+      scalar: Date.parse(`${date}T${parts.hour}:${parts.minute}:${parts.second}Z`)
+    };
+  };
+  const offsets = new Set();
+  const instants = scalar => {
+    offsets.clear();
+    for (let hours = -36; hours <= 36; hours += 6) {
+      const sample = scalar + hours * 3_600_000;
+      offsets.add(local(sample).scalar - sample);
+    }
+    return [...offsets].map(offset => scalar - offset).filter(instant => local(instant).scalar === scalar).sort((a, b) => a - b);
+  };
+  return {
+    local,
+    instants
+  };
+}
+
+/** Business ordering is independent of reservation switches and Pickup slot availability. */
+function computeBusinessAvailability(input) {
+  const {
+    config,
+    schedules,
+    timezone,
+    now
+  } = input;
+  const nowAt = now.getTime();
+  const base = {
+    requirePaymentOnSubmit: config.requirePaymentOnSubmit,
+    nextChangeAt: nowAt + DAY
+  };
+  if (config.paused) {
+    return {
+      ...base,
+      status: 'paused',
+      behavior: config.pauseBehavior,
+      message: config.pauseMessage
+    };
+  }
+  if (config.invalidScheduleIds) throw new Error('Business operating-hours configuration is invalid.');
+  if (!config.scheduleIds.length) return {
+    ...base,
+    status: 'open',
+    behavior: null,
+    message: null
+  };
+  const selected = schedules.filter(schedule => config.scheduleIds.includes(Number(schedule.id)));
+  if (config.scheduleIds.some(id => !selected.some(schedule => Number(schedule.id) === id))) {
+    throw new Error('A configured business operating-hours schedule is unavailable.');
+  }
+  const clock = createClock(timezone);
+  const current = clock.local(nowAt);
+  const today = Date.parse(`${current.date}T00:00:00Z`);
+  const nextMidnight = clock.instants(today + DAY).find(instant => instant > nowAt);
+  let nextChangeAt = nextMidnight ?? nowAt + 60_000;
+  let open = false;
+  // Yesterday contributes the tail of overnight windows; today supplies the next boundary.
+  for (const dateAt of [today - DAY, today]) {
+    const date = new Date(dateAt).toISOString().slice(0, 10);
+    // Schedule's resolver merges by time-of-day, so resolve each schedule independently.
+    for (const schedule of selected) {
+      for (const window of (0, _getDateIsInSchedule.getScheduleStartEndTimePoints)(date, [schedule])) {
+        const toMinutes = value => {
+          if (!/^(?:[01]\d|2[0-3]):[0-5]\d$/.test(value) && value !== '24:00') {
+            throw new Error('Business operating-hours schedule contains an invalid time.');
+          }
+          const [hours, minutes] = value.split(':').map(Number);
+          return hours * 60 + minutes;
+        };
+        const start = dateAt + toMinutes(window.start_time) * 60_000;
+        let end = dateAt + toMinutes(window.end_time) * 60_000;
+        if (end <= start) end += DAY;
+        if (current.scalar >= start && current.scalar < end) open = true;
+        for (const boundary of [start, end]) {
+          for (const instant of clock.instants(boundary)) {
+            if (instant > nowAt) nextChangeAt = Math.min(nextChangeAt, instant);
+          }
+        }
+      }
+    }
+  }
+  // A timezone offset change can repeat/skip a wall-clock boundary. A local-only safety
+  // check also covers throttled timers; it does not fetch either configuration source.
+  nextChangeAt = Math.min(nextChangeAt, nowAt + 60_000);
+  return {
+    ...base,
+    nextChangeAt,
+    status: open ? 'open' : 'closed',
+    behavior: open ? null : config.closedBehavior,
+    message: open ? null : config.closedMessage
+  };
+}

package/lib/modules/OpenData/index.js

@@ -153,7 +153,7 @@ class OpenDataModule extends _BaseModule.BaseModule {
     this.fatherModule = this.otherParams.fatherModule;
   }
   shouldSkipInvoiceTemplateDocument() {
-    return String(this.otherParams?.platform || '').trim().toLowerCase() === 'h5';
+    return this.otherParams.invoiceDocument !== true && String(this.otherParams?.platform || '').trim().toLowerCase() === 'h5';
   }
   async fetchOpenData(params) {
     const fetchRevision = ++this.fetchRevision;

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

@@ -69,6 +69,8 @@ export interface OpenDataConfig {
     'reservation.time_slice'?: number | string;
     'sale.allow_item_notes'?: boolean;
     'sale.allow_order_notes'?: boolean;
+    /** False submits an order without starting or confirming payment. */
+    'sale.require_payment_on_submit'?: boolean | null;
     'sale.enable_item_rules'?: boolean;
     'sale.enable_short_number'?: boolean;
     'sale.short_number_daily_reset'?: boolean;

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

@@ -4,7 +4,7 @@ import { OrderModuleAPI, CommitOrderParams, UpdateOrderBookingParams, UpdateOrde
 import { CartItem } from '../Cart/types';
 import { type SubmitPayloadEnhancer } from './utils';
 import { type PickupTimingBooking, type PickupTimingBookingInput } from './pickupTiming';
-import type { OrderAmountSnapshot, AddProductBookingInput, AddProductToOrderOptions, OrderIdentitySnapshot, OrderPaymentSource, OrderSnapshot, OrderSyncState, SyncPaymentsToOrderParams, SyncPaymentsToOrderResult, SubmitSalesOrderParams, OrderProduct, OrderProductIdentity, OrderSummary, OrderTempOrder, OrderPaymentData, OrderPaymentUpdateOptions, OrderPaymentUpdateResult, SendCustomerPayLinkParams, UpdateTempOrderCustomerInput, OrderCustomerPatch, OrderCustomerView, ReplaceTempOrderOptions, OrderPromotionEvaluator, OrderGiftSelectResolver, OrderUnfulfilledPromotion, OrderLastGiftActions, RemoveProductsFromOrderOptions, SalesNote, SalesNotesMutationSnapshot, SetSalesNoteInput, PickupReferenceMode, PointCardSnapshotMergeContext, PointCardSnapshotItem, ShopServiceData, ShopServiceType } from './types';
+import type { OrderAmountSnapshot, AddProductBookingInput, AddProductToOrderOptions, OrderIdentitySnapshot, OrderPaymentSource, OrderSnapshot, OrderSyncState, SyncPaymentsToOrderParams, SyncPaymentsToOrderResult, SubmitSalesOrderParams, OrderProduct, OrderProductIdentity, OrderSummary, OrderTempOrder, OrderPaymentData, OrderPaymentUpdateOptions, OrderPaymentUpdateResult, SendCustomerPayLinkParams, UpdateTempOrderCustomerInput, OrderCustomerPatch, OrderCustomerView, OrderCartIntentCommitContext, ReplaceTempOrderOptions, OrderPromotionEvaluator, OrderGiftSelectResolver, OrderUnfulfilledPromotion, OrderLastGiftActions, RemoveProductsFromOrderOptions, SalesNote, SalesNotesMutationSnapshot, SetSalesNoteInput, PickupReferenceMode, PointCardSnapshotMergeContext, PointCardSnapshotItem, ShopServiceData, ShopServiceType } from './types';
 import type { ICustomer } from '../AccountList/types';
 import type { Discount } from '../Discount/types';
 import { UnavailableReason } from '../Rules/types';
@@ -67,6 +67,8 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
      * orderModule.updateOtherParams({ cacheId: 'cache-2', channel: 'pos' });
      */
     updateOtherParams(params: Record<string, any>): void;
+    /** Internal intent boundary shared with asynchronous scanner/detail flows. */
+    createCartIntentCommitGuard(action: OrderCartIntentCommitContext['action'], tempOrder?: OrderTempOrder | null): () => void;
     /** PC/H5 属于在线店铺；其它或缺失平台统一沿用 POS 行为。 */
     isOnlineStorePlatform(): boolean;
     /**
@@ -501,6 +503,7 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     private hasSameEntitlementMergePriceConfig;
     private getBundleRuntimeIdentity;
     private preservePersistedBundlePriceFields;
+    private isRestrictedCartProductUpdate;
     private applyOrderProductUpdateToTempOrder;
     updateOrderProduct(params: UpdateOrderProductParams): Promise<OrderProduct[]>;
     updateOrderProducts(paramsList: UpdateOrderProductParams[]): Promise<OrderProduct[]>;
@@ -588,7 +591,7 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     generateIdempotencyToken(): string;
     syncPaymentsToOrder<T = any>(params: SyncPaymentsToOrderParams): Promise<SyncPaymentsToOrderResult<T>>;
     createOrder(params: CommitOrderParams['query']): {
-        type: "appointment_booking" | "virtual";
+        type: "virtual" | "appointment_booking";
         platform: string;
         sales_channel: string;
         order_sales_channel: string;

package/lib/modules/Order/index.js

@@ -10,6 +10,7 @@ Object.defineProperty(exports, "isFulfillmentTimingBooking", {
     return _pickupTiming.isFulfillmentTimingBooking;
   }
 });
+var _loadSalesOrderSnapshot = require("../../shared/sales/loadSalesOrderSnapshot");
 var _BaseModule = require("../BaseModule");
 var _types = require("./types");
 var _utils = require("./utils");
@@ -439,6 +440,29 @@ class OrderModule extends _BaseModule.BaseModule {
     this.otherParams = otherParams;
   }
 
+  /** Internal intent boundary shared with asynchronous scanner/detail flows. */
+  createCartIntentCommitGuard(action, tempOrder = this.store.tempOrder) {
+    const hook = this.orderHooks?.beforeCartIntentCommit;
+    if (!hook) return () => {};
+    const getScope = this.orderHooks?.getCartIntentScope;
+    const scope = getScope?.();
+    const otherParams = this.otherParams;
+    let committed = false;
+    return () => {
+      if (this.store.tempOrder !== tempOrder || this.otherParams !== otherParams || this.orderHooks?.beforeCartIntentCommit !== hook || this.orderHooks?.getCartIntentScope !== getScope || getScope?.() !== scope) {
+        throw new Error('[Order] Cart intent belongs to a previous order or business');
+      }
+      // Derived gifts, discounts and persistence belong to the accepted intent,
+      // but an asynchronous continuation must never target a different cart.
+      if (committed) return;
+      hook({
+        action,
+        tempOrder
+      });
+      committed = true;
+    };
+  }
+
   /** PC/H5 属于在线店铺；其它或缺失平台统一沿用 POS 行为。 */
   isOnlineStorePlatform() {
     const platform = String(this.otherParams?.platform || '').trim().toLowerCase();
@@ -667,6 +691,7 @@ class OrderModule extends _BaseModule.BaseModule {
     });
   }
   async scanCode(code, customerId) {
+    const beforeCommit = this.createCartIntentCommitGuard('scan_promotion');
     if (this.isActiveVirtualSettlementOrder(this.store.tempOrder)) {
       return {
         type: 'clientCalc',
@@ -714,6 +739,7 @@ class OrderModule extends _BaseModule.BaseModule {
     }));
     const currentSelected = this.getDiscountList().filter(n => n.isSelected);
     if (currentSelected.length && currentSelected.some(n => withScanList.some(m => m.id === n.id))) {
+      beforeCommit();
       await this.syncScannedDiscountsToOriginalDiscountList(this.getDiscountList());
       return {
         type: 'clientCalc',
@@ -747,6 +773,7 @@ class OrderModule extends _BaseModule.BaseModule {
     const normalizedNewDiscountList = newDiscountList ? markScannedDiscounts(newDiscountList, withScanList) : undefined;
     let resolvedDiscountList = normalizedNewDiscountList || this.getDiscountList();
     if (isAvailable && normalizedNewDiscountList) {
+      beforeCommit();
       await this.store.discount?.setDiscountList(normalizedNewDiscountList);
       // 实际写回商品时沿用扫码试算的优先级，避免旧商品行的选卡覆盖本次扫码。
       this.applyDiscount({
@@ -755,6 +782,7 @@ class OrderModule extends _BaseModule.BaseModule {
       await this.syncScannedDiscountsToOriginalDiscountList(this.getDiscountList());
       resolvedDiscountList = this.getDiscountList();
     } else if (shouldRetainForLater) {
+      beforeCommit();
       // 只合并本次识别的卡券；不把试算产生的其他选券状态写回订单。
       const retainedDiscounts = new Map(this.getDiscountList().map(discount => [String(discount.id), discount]));
       evaluatedScannedDiscounts.forEach(discount => {
@@ -3461,7 +3489,6 @@ class OrderModule extends _BaseModule.BaseModule {
     }) : null;
     const productToAdd = linked?.product || product;
     const disableMerge = options?.disableMerge === true;
-    this.assertAndLockProductSettlement(tempOrder, productToAdd);
     const incomingFingerprint = disableMerge ? '' : (0, _utils3.buildProductLineFingerprint)((0, _utils.getProductSkuOptions)(productToAdd), productToAdd.product_bundle);
     const normalizedIncoming = this.normalizeVirtualSettlementProductIfEnabled((0, _utils.mergeOrderProductDisplayFields)(productToAdd, (0, _utils3.normalizeOrderProduct)(productToAdd)));
     if (disableMerge) {
@@ -3522,6 +3549,8 @@ class OrderModule extends _BaseModule.BaseModule {
     const matchedProduct = matchedIndex === -1 ? null : tempOrder.products[matchedIndex];
     const existedFingerprint = matchedProduct ? (0, _utils3.buildProductLineFingerprint)((0, _utils.getProductSkuOptions)(matchedProduct), matchedProduct.product_bundle) : '';
     const commitProductLine = shouldMerge => {
+      options?.beforeCommit?.();
+      this.assertAndLockProductSettlement(tempOrder, productToAdd);
       let committedProduct;
       if (matchedIndex === -1 || !matchedProduct || !shouldMerge) {
         this.captureProductRuntime(tempOrder, productToAdd, normalizedIncoming);
@@ -3674,6 +3703,7 @@ class OrderModule extends _BaseModule.BaseModule {
    */
   async addProductToOrder(product, booking, options) {
     const tempOrder = this.ensureTempOrder();
+    const beforeCommit = this.createCartIntentCommitGuard('add_product', tempOrder);
     const salesNoteDrafts = (options?.salesNotes || []).map(draft => ({
       note_type: String(draft.note_type || '').trim(),
       text: {
@@ -3744,7 +3774,8 @@ class OrderModule extends _BaseModule.BaseModule {
             }
             const committedProduct = await this.appendProductLineToTempOrder(tempOrder, splitLine.product, splitLine.booking, {
               insertAtIndex,
-              disableMerge: options?.disableMerge
+              disableMerge: options?.disableMerge,
+              beforeCommit
             });
             attachSalesNoteDrafts(committedProduct);
             if (insertAtIndex !== undefined) insertAtIndex += 1;
@@ -3752,14 +3783,16 @@ class OrderModule extends _BaseModule.BaseModule {
         } else {
           const committedProduct = await this.appendProductLineToTempOrder(tempOrder, product, (0, _lodashEs.cloneDeep)(booking), {
             insertAtIndex,
-            disableMerge: options?.disableMerge
+            disableMerge: options?.disableMerge,
+            beforeCommit
           });
           attachSalesNoteDrafts(committedProduct);
         }
       } else {
         const committedProduct = await this.appendProductLineToTempOrder(tempOrder, product, undefined, {
           insertAtIndex,
-          disableMerge: options?.disableMerge
+          disableMerge: options?.disableMerge,
+          beforeCommit
         });
         attachSalesNoteDrafts(committedProduct);
       }
@@ -3787,6 +3820,7 @@ class OrderModule extends _BaseModule.BaseModule {
   async addProductsToOrder(items, options) {
     const tempOrder = this.ensureTempOrder();
     if (!Array.isArray(items) || items.length === 0) return tempOrder.products;
+    const beforeCommit = this.createCartIntentCommitGuard('add_product', tempOrder);
     for (const item of items || []) {
       const {
         product,
@@ -3799,13 +3833,17 @@ class OrderModule extends _BaseModule.BaseModule {
         if (splitCount > 1) {
           for (let i = 0; i < splitCount; i += 1) {
             const splitLine = this.createSplitBookingLine(productRecord, booking, i, splitCount);
-            const appendResult = this.appendProductLineToTempOrder(tempOrder, splitLine.product, splitLine.booking);
+            const appendResult = this.appendProductLineToTempOrder(tempOrder, splitLine.product, splitLine.booking, {
+              beforeCommit
+            });
             if (appendResult) await appendResult;
           }
           continue;
         }
       }
-      const appendResult = this.appendProductLineToTempOrder(tempOrder, product, booking);
+      const appendResult = this.appendProductLineToTempOrder(tempOrder, product, booking, {
+        beforeCommit
+      });
       if (appendResult) await appendResult;
     }
     await this.finalizeProductOrderMutation(tempOrder, options);
@@ -3890,6 +3928,16 @@ class OrderModule extends _BaseModule.BaseModule {
       };
     });
   }
+  isRestrictedCartProductUpdate(tempOrder, params) {
+    if (!this.orderHooks?.beforeCartIntentCommit) return false;
+    if (params.booking || Object.keys(params.updates || {}).some(key => key !== 'num')) {
+      return true;
+    }
+    if (params.updates?.num === undefined) return false;
+    const uid = params.unique_identification_number;
+    const product = uid !== undefined ? tempOrder.products.find(item => String(item.metadata?.unique_identification_number || item.unique_identification_number || '') === String(uid)) : tempOrder.products[(0, _utils3.getProductIdentityIndex)(tempOrder.products, params)];
+    return !product || (0, _utils3.getSafeProductNum)(params.updates.num) > product.num;
+  }
   applyOrderProductUpdateToTempOrder(tempOrder, params) {
     const {
       product_id,
@@ -4088,6 +4136,9 @@ class OrderModule extends _BaseModule.BaseModule {
   }
   async updateOrderProduct(params) {
     const tempOrder = this.ensureTempOrder();
+    if (this.isRestrictedCartProductUpdate(tempOrder, params)) {
+      this.createCartIntentCommitGuard('update_product', tempOrder)();
+    }
     const updatedProductUid = this.applyOrderProductUpdateToTempOrder(tempOrder, params);
     const promotionPayload = await this.evaluatePromotion();
     this.applyDiscount({
@@ -4109,6 +4160,9 @@ class OrderModule extends _BaseModule.BaseModule {
     if (!paramsList.length) {
       return tempOrder.products;
     }
+    if (paramsList.some(params => this.isRestrictedCartProductUpdate(tempOrder, params))) {
+      this.createCartIntentCommitGuard('update_product', tempOrder)();
+    }
     const reapplyBookingDiscountProductUids = paramsList.reduce((acc, params) => {
       const updatedProductUid = this.applyOrderProductUpdateToTempOrder(tempOrder, params);
       // 批量改预约时间时，延迟到最后一次折扣计算里统一恢复已选预约折扣卡。
@@ -4191,6 +4245,9 @@ class OrderModule extends _BaseModule.BaseModule {
         throw new _virtualSettlement.VirtualCurrencyBalanceError(balance.toFixed(2), requiredAmount.toFixed(2));
       }
     }
+    if (normalizedProduct.num > targetProduct.num) {
+      this.createCartIntentCommitGuard('increase_quantity', tempOrder)();
+    }
     tempOrder.products[productIndex] = normalizedProduct;
     this.prepareVirtualSettlementTempOrder(tempOrder);
     const isVirtualSettlement = this.isActiveVirtualSettlementOrder(tempOrder);
@@ -5017,13 +5074,10 @@ class OrderModule extends _BaseModule.BaseModule {
     if (lookup.startsWith('LOCAL_')) {
       params.forceRemote = false;
     }
-    const res = await this.request.get(`/order/sales/${encodeURIComponent(lookup)}`, {
-      with: ['products', 'bookings', 'payments', 'customer', 'summary', 'contacts_info', 'order_meta_list', 'refunds', 'notes'],
-      ...(params.forceRemote ? {
-        forceRemote: true
-      } : {})
-    }, {
-      osServer: true
+    const res = await (0, _loadSalesOrderSnapshot.loadSalesOrderSnapshot)(this.request, {
+      lookup,
+      transport: 'os-server',
+      forceRemote: params.forceRemote
     });
     if (res.code === 200) {
       this.store.lastOrderInfo = res.data;

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

@@ -517,7 +517,15 @@ export type OrderProductMergeDecisionResult = boolean | {
     reason?: string;
     [key: string]: any;
 };
+export interface OrderCartIntentCommitContext {
+    action: 'add_product' | 'update_product' | 'increase_quantity' | 'scan_promotion';
+    tempOrder: OrderTempOrder | null;
+}
 export interface OrderHooksConfig {
+    /** Optional customer-order guard; called synchronously before the first cart write. */
+    beforeCartIntentCommit?: (context: OrderCartIntentCommitContext) => void;
+    /** Captures tenant/business runtime identity for asynchronous cart intents. */
+    getCartIntentScope?: () => unknown;
     onBeforeMergeProductToOrder?: (context: OrderProductMergeDecisionContext) => OrderProductMergeDecisionResult | Promise<OrderProductMergeDecisionResult>;
 }
 /**

package/lib/modules/Payment/index.js

@@ -9,6 +9,7 @@ var _exportNames = {
 };
 exports.PaymentModule = void 0;
 exports.generateRequestUniqueId = generateRequestUniqueId;
+var _loadPaymentMethods = require("../../shared/payment/loadPaymentMethods");
 var _BaseModule = require("../BaseModule");
 var _types = require("./types");
 Object.keys(_types).forEach(function (key) {
@@ -286,12 +287,10 @@ class PaymentModule extends _BaseModule.BaseModule {
   async getPayMethodListAsync() {
     this.logInfo('Starting getPayMethodListAsync');
     try {
-      const response = await this.request.get('/pay/custom-payment/all', {
+      const payMethods = await (0, _loadPaymentMethods.loadPaymentMethods)(this.request, {
+        transport: 'os-server',
         filterPaymentMethods: true
-      }, {
-        osServer: true
       });
-      const payMethods = response?.data || response || [];
       this.logInfo('getPayMethodListAsync completed successfully', {
         payMethods
       });

package/lib/plugins/request.d.ts

@@ -56,6 +56,9 @@ export interface CacheProps {
  * 请求配置
  */
 export interface RequestOptions {
+    /** Let the caller handle read-only preview failures without host navigation/toasts. */
+    manualErrorHandling?: boolean;
+    skipErrorHandler?: boolean;
     url?: string;
     method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD' | 'OPTIONS';
     headers?: Record<string, string>;

package/lib/server/utils/small-ticket.d.ts

@@ -1,85 +1 @@
-export interface SmallTicketShopInfo {
-    name?: string;
-    phone?: string;
-    address?: string;
-    address_street?: string;
-    address_detail?: string;
-    city?: string;
-    province?: string;
-    country?: string;
-    zip?: string;
-    tax_number?: string;
-    tax_title?: string;
-    is_price_include_tax?: 0 | 1 | boolean;
-    currency_symbol?: string;
-    currency_code?: string;
-    primary_locale?: string;
-    timezone?: string;
-    [key: string]: any;
-}
-export interface BuildSmallTicketDataParams {
-    order: Record<string, any>;
-    shopInfo?: SmallTicketShopInfo | null;
-    locales?: string[];
-    productMap?: Record<string | number, Record<string, any>>;
-}
-export interface SmallTicketItem {
-    item: string;
-    value: string;
-    size?: number;
-    align?: string;
-    product_uid?: string | number;
-    booking_uid?: string | number;
-}
-export interface SmallTicketProduct {
-    product_title: string;
-    product_quantity: number;
-    selling_price: string;
-    total_selling_price: string;
-    original_price: string;
-    base_price?: string;
-    total_original_price: string;
-    options_total_price?: string;
-    package_items_total_price?: string;
-    extension_list: any[];
-    product_uid?: string | number;
-    booking_uid?: string | number;
-    product_note?: string;
-    allergy?: string;
-    options?: Array<{
-        name: string;
-        num?: number;
-        price?: string;
-        total_price: string;
-        value?: string;
-    }>;
-    variant?: string;
-    combinations?: any[];
-}
-export type SmallTicketAppointment = SmallTicketItem[];
-export interface SmallTicketLocaleData {
-    base_data: Record<string, any>;
-    products: SmallTicketProduct[];
-    fees: {
-        fees: SmallTicketItem[];
-        countFee: Record<string, any>;
-    };
-    customer: SmallTicketItem[];
-    appointment: SmallTicketAppointment;
-    delivery?: SmallTicketItem[];
-    resources: Array<{
-        id: string | number;
-        code: string;
-        title: string;
-        form_title: string;
-    }>;
-    payment_data: SmallTicketItem[][];
-    wallets: SmallTicketItem[][];
-    tickets: any[];
-    source_shop: any[];
-    refund_data: SmallTicketItem[][];
-    expend_data: any[];
-}
-export type SmallTicketData = Record<string, SmallTicketLocaleData>;
-export declare function buildSmallTicketData(params: BuildSmallTicketDataParams): SmallTicketData;
-export declare function hasSmallTicketData(value: any): boolean;
+export * from '../../shared/receipt/small-ticket';