@pisell/pisellos 2.2.311 → 2.2.312-vm.0

package/dist/solution/VenueBooking/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/solution/VenueBooking/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,SAAS,EACT,gBAAgB,EAChB,2BAA2B,EAC3B,sCAAsC,EACtC,2BAA2B,EAC3B,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,uBAAuB,EACvB,+BAA+B,EAC/B,sBAAsB,EACtB,yBAAyB,EACzB,sCAAsC,EACtC,uBAAuB,EACvB,eAAe,EACf,qBAAqB,GACtB,MAAM,oBAAoB,CAAC"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/solution/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC"}

package/dist/store/createStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"createStore.d.ts","sourceRoot":"","sources":["../../src/store/createStore.ts"],"names":[],"mappings":"AAQA,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,EAC1C,YAAY,EAAE,CAAC,EACf,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,GAC5C;IAAE,KAAK,EAAE,CAAC,CAAA;CAAE,CAiCd"}

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"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"}

package/dist/utils/os-private-payload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"os-private-payload.d.ts","sourceRoot":"","sources":["../../src/utils/os-private-payload.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,CASzD"}

package/dist/utils/payment-number.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment-number.d.ts","sourceRoot":"","sources":["../../src/utils/payment-number.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,0BAA0B,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;AAUlE;;GAEG;AACH,wBAAgB,4CAA4C,CAC1D,UAAU,EAAE,0BAA0B,GACrC,MAAM,CASR;AAED;;GAEG;AACH,wBAAsB,gCAAgC,CACpD,UAAU,EAAE,0BAA0B,GACrC,OAAO,CAAC,MAAM,CAAC,CAejB"}

package/dist/utils/platform.d.ts

@@ -6,3 +6,5 @@ export declare function normalizeRuntimePlatform(platform: unknown): string;
  * PC and H5 are authenticated-customer clients rather than staff terminals.
  */
 export declare function isCustomerUserPlatform(platform: unknown): boolean;
+/** Kiosk and vending retain distinct channels but share self-service checkout behavior. */
+export declare function isSelfServicePlatform(platform: unknown): boolean;

package/dist/utils/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/utils/platform.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAElE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAEjE;AAED,2FAA2F;AAC3F,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAEhE"}

package/dist/utils/platform.js

@@ -1,4 +1,5 @@
 var CUSTOMER_USER_PLATFORMS = new Set(['pc', 'h5']);
+var SELF_SERVICE_PLATFORMS = new Set(['kiosk', 'vending']);
 
 /**
  * Normalize the runtime platform passed through solution/module otherParams.
@@ -12,4 +13,9 @@ export function normalizeRuntimePlatform(platform) {
  */
 export function isCustomerUserPlatform(platform) {
   return CUSTOMER_USER_PLATFORMS.has(normalizeRuntimePlatform(platform));
+}
+
+/** Kiosk and vending retain distinct channels but share self-service checkout behavior. */
+export function isSelfServicePlatform(platform) {
+  return SELF_SERVICE_PLATFORMS.has(normalizeRuntimePlatform(platform));
 }

package/dist/utils/task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../src/utils/task.ts"],"names":[],"mappings":"AAAA,KAAK,MAAM,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAC;AAC/C,KAAK,IAAI,GAAG;IACV,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CACpC,CAAC;AACF,cAAM,KAAK;IACT,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,SAAS,CAAc;IAC/B,SAAS,UAAS;gBACN,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAMzC;;OAEG;IACI,KAAK;IAMZ;;OAEG;IACI,cAAc;IAKrB;;;;OAIG;IACI,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAI7C;;;OAGG;IACI,OAAO,CAAC,IAAI,EAAE,IAAI;IAMzB;;OAEG;IACU,GAAG;IA8ChB;;OAEG;IACI,WAAW,CAAC,IAAI,EAAE,MAAM;CAGhC;AAED,eAAe,KAAK,CAAC"}

package/dist/utils/watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../src/utils/watch.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAC;AAC1D,MAAM,MAAM,cAAc,GAAG;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,kBAAkB,CAAC;CAC9B,CAAC;AAEF,MAAM,WAAW,sBAAsB;IACrC,WAAW,EAAE,MAAM,IAAI,CAAC;CACzB;AAED,cAAM,KAAK;IAET,OAAO,CAAC,MAAM,CAGA;IAEd,OAAO,CAAC,aAAa,CAAoC;IAEzD;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,sBAAsB;IAuB1E;;;;OAIG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IAerD;;;;OAIG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IActD;;;OAGG;IACH,0BAA0B,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKlD;;;OAGG;IACH,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAQhD;;;;;OAKG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,IAAI;IAc1D;;;;OAIG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IA2B/C;;;;;OAKG;IACH,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAQ3E;;;;OAIG;IACH,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,GAAG,SAAS;IAW1E;;;;OAIG;IACH,UAAU,CAAC,QAAQ,EAAE,MAAM;IAO3B;;OAEG;IACH,cAAc,IAAI,IAAI;IAOtB;;;;OAIG;IACH,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IAOzC;;;;OAIG;IACH,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;IAKtC;;;;;OAKG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,sBAAsB;CActE;AAGD,QAAA,MAAM,KAAK,OAAc,CAAC;AAE1B,eAAe,KAAK,CAAC"}

package/lib/index.d.ts

@@ -7,6 +7,7 @@ export * from './modules';
 export * from './plugins';
 export * from './solution';
 export * from './model';
+export * from './inventory';
 export { PisellOSCore } from './core';
 import PisellOSCore from './core';
 export default PisellOSCore;

package/lib/index.js

@@ -73,6 +73,18 @@ Object.keys(_model).forEach(function (key) {
     }
   });
 });
+var _inventory = require("./inventory");
+Object.keys(_inventory).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _inventory[key]) return;
+  Object.defineProperty(exports, key, {
+    enumerable: true,
+    get: function () {
+      return _inventory[key];
+    }
+  });
+});
 var _core = _interopRequireWildcard(require("./core"));
 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/inventory/index.d.ts

@@ -0,0 +1,92 @@
+/** Optional, instance-scoped sales inventory. Never stored in ProductData or order payloads. */
+export type InventoryRecord = Record<string, any>;
+export type InventoryRefreshReason = 'catalog-entry' | 'detail-open' | 'checkout' | 'manual';
+export interface InventoryAvailability {
+    status: 'ready' | 'loading' | 'stale' | 'error' | 'unmapped';
+    quantity?: number;
+    message?: string;
+}
+export interface InventorySelectionAvailability {
+    availability: InventoryAvailability;
+    /** Stock remaining after other cart lines using the same inventory key. */
+    availableQuantity: number;
+    /** The existing line can still be reduced when stock is unavailable. */
+    retainedQuantity: number;
+    maxQuantity: number;
+}
+export interface InventorySource {
+    readonly scopeKey: string;
+    assertCurrent(): void;
+    keyOf(product: InventoryRecord, variant?: InventoryRecord): string | undefined;
+    read(context: {
+        reason: InventoryRefreshReason;
+        signal: AbortSignal;
+    }): Promise<ReadonlyMap<string, {
+        quantity: number | null;
+        message?: string;
+    }>>;
+    message(reason: 'unavailable' | 'unmapped' | 'insufficient', values?: {
+        key: string;
+        quantity: number;
+    }): string;
+}
+export interface CheckoutInventoryLine {
+    readonly lineId: string;
+    readonly productId: string | number;
+    readonly variantId: string | number;
+    readonly quantity: number;
+    readonly inventoryKey: string;
+}
+export interface CheckoutRuntimeSnapshot {
+    readonly scopeKey: string;
+    readonly revision: number;
+    readonly lines: readonly CheckoutInventoryLine[];
+}
+export interface SalesCheckoutHooks {
+    beforeCheckout?(context: {
+        items: readonly InventoryRecord[];
+        signal?: AbortSignal;
+    }): Promise<void>;
+}
+export declare const salesGuardError: (message: string) => Error & {
+    code: string;
+};
+export declare class InventoryController {
+    private readonly source;
+    readonly identity: symbol;
+    readonly scopeKey: string;
+    private entries;
+    private lastQuantities;
+    private products;
+    private keys;
+    private catalogProducts;
+    private listeners;
+    private revision;
+    private state;
+    private pending?;
+    private disposed;
+    constructor(source: InventorySource);
+    getRevision: () => number;
+    subscribe: (listener: () => void) => () => void;
+    private publish;
+    private assertCurrent;
+    activate(): void;
+    dispose(): void;
+    invalidate(): void;
+    /** Catalog replaces identities; partial detail only merges its variants, never its prices. */
+    registerProducts(products: readonly InventoryRecord[], complete?: boolean): void;
+    /** Consumers share I/O; cancelling one detail does not cancel another consumer. */
+    refresh(context: {
+        reason: InventoryRefreshReason;
+        signal?: AbortSignal;
+        force?: boolean;
+    }): Promise<void>;
+    availabilityForKey(key?: string): InventoryAvailability;
+    availability(product: InventoryRecord, variantId?: string | number): InventoryAvailability;
+    private keyForLine;
+    /** Advisory UI limit only. The serialized cart guard remains authoritative. */
+    selectionAvailability(product: InventoryRecord, variantId: string | number, items: readonly InventoryRecord[], editingItem?: InventoryRecord): InventorySelectionAvailability;
+    private totals;
+    validate(proposed: readonly InventoryRecord[], current?: readonly InventoryRecord[], allowReductions?: boolean): void;
+    freezeCheckout(items: readonly InventoryRecord[]): CheckoutRuntimeSnapshot;
+}

package/lib/inventory/index.js

@@ -0,0 +1,287 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.salesGuardError = exports.InventoryController = void 0;
+/** Optional, instance-scoped sales inventory. Never stored in ProductData or order payloads. */
+
+const salesGuardError = message => Object.assign(new Error(message), {
+  code: 'SALES_GUARD_REJECTED'
+});
+exports.salesGuardError = salesGuardError;
+const cancelled = () => Object.assign(new Error('Inventory request cancelled'), {
+  name: 'AbortError'
+});
+const variantIdentity = (productId, variantId) => JSON.stringify([String(productId), String(variantId ?? 0)]);
+class InventoryController {
+  identity = Symbol('sales-inventory-instance');
+  scopeKey;
+  entries = new Map();
+  lastQuantities = new Map();
+  products = new Map();
+  keys = new Map();
+  catalogProducts = new Map();
+  listeners = new Set();
+  revision = 0;
+  state = 'stale';
+  pending;
+  disposed = false;
+  constructor(source) {
+    this.source = source;
+    this.scopeKey = source.scopeKey;
+  }
+  getRevision = () => this.revision;
+  subscribe = listener => {
+    this.listeners.add(listener);
+    return () => {
+      this.listeners.delete(listener);
+    };
+  };
+  publish() {
+    this.revision += 1;
+    this.listeners.forEach(listener => {
+      try {
+        listener();
+      } catch {/* A view cannot interrupt a stock update. */}
+    });
+  }
+  assertCurrent(signal) {
+    if (this.disposed || signal?.aborted) throw cancelled();
+    this.source.assertCurrent();
+  }
+  activate() {
+    this.disposed = false;
+  }
+  dispose() {
+    this.disposed = true;
+    this.invalidate();
+  }
+  invalidate() {
+    this.pending?.controller.abort();
+    this.pending = undefined;
+    this.state = 'stale';
+    this.publish();
+  }
+
+  /** Catalog replaces identities; partial detail only merges its variants, never its prices. */
+  registerProducts(products, complete = false) {
+    this.assertCurrent();
+    let changed = false;
+    for (const product of products) {
+      const id = String(product.id ?? product.product_id);
+      if (complete && this.catalogProducts.get(id) === product) continue;
+      if (complete) this.catalogProducts.set(id, product);
+      const previous = this.products.get(id);
+      if (complete) for (const variantId of previous?.keys() || []) this.keys.delete(variantIdentity(id, variantId));
+      const variants = complete ? new Map() : new Map(previous);
+      const list = product.variant?.length ? product.variant : [{
+        id: 0,
+        code: product.code
+      }];
+      for (const variant of list) {
+        const variantId = String(variant.id ?? variant.product_variant_id ?? 0);
+        const key = this.source.keyOf(product, variant) ?? previous?.get(variantId);
+        variants.set(variantId, key);
+        this.keys.set(variantIdentity(id, variantId), key);
+      }
+      if (!previous || previous.size !== variants.size || [...variants].some(([id, key]) => previous.get(id) !== key)) changed = true;
+      this.products.set(id, variants);
+    }
+    if (changed) this.publish();
+  }
+
+  /** Consumers share I/O; cancelling one detail does not cancel another consumer. */
+  async refresh(context) {
+    this.assertCurrent(context.signal);
+    if (context.force) this.invalidate();
+    let read = this.pending;
+    if (!read) {
+      read = {
+        controller: new AbortController(),
+        consumers: 0,
+        promise: Promise.resolve()
+      };
+      const current = read;
+      this.pending = current;
+      this.state = 'loading';
+      this.publish();
+      current.promise = (async () => {
+        try {
+          const entries = await this.source.read({
+            reason: context.reason,
+            signal: current.controller.signal
+          });
+          this.assertCurrent(current.controller.signal);
+          if (this.pending !== current) throw cancelled();
+          this.entries = entries;
+          for (const [key, stock] of entries) if (stock.quantity !== null && Number.isSafeInteger(stock.quantity) && stock.quantity >= 0) this.lastQuantities.set(key, stock.quantity);
+          this.state = 'ready';
+        } catch (error) {
+          if (this.pending !== current || current.controller.signal.aborted) throw cancelled();
+          this.state = 'error';
+          throw error;
+        } finally {
+          if (this.pending === current) {
+            this.pending = undefined;
+            this.publish();
+          }
+        }
+      })();
+    }
+    read.consumers += 1;
+    try {
+      if (!context.signal) await read.promise;else await new Promise((resolve, reject) => {
+        const signal = context.signal;
+        const abort = () => reject(cancelled());
+        signal.addEventListener('abort', abort, {
+          once: true
+        });
+        read.promise.then(resolve, reject).finally(() => signal.removeEventListener('abort', abort));
+        if (signal.aborted) abort();
+      });
+      this.assertCurrent(context.signal);
+    } finally {
+      read.consumers -= 1;
+      if (this.pending === read && read.consumers === 0) this.invalidate();
+    }
+  }
+  availabilityForKey(key) {
+    const stock = key ? this.entries.get(key) : undefined;
+    const quantity = key ? this.lastQuantities.get(key) : undefined;
+    if (this.state !== 'ready') return {
+      status: this.state,
+      quantity,
+      message: this.source.message('unavailable')
+    };
+    if (!stock) return {
+      status: 'unmapped',
+      quantity,
+      message: this.source.message('unmapped')
+    };
+    if (stock.quantity === null || !Number.isSafeInteger(stock.quantity) || stock.quantity < 0) return {
+      status: 'error',
+      quantity,
+      message: stock.message || this.source.message('unavailable')
+    };
+    return {
+      status: 'ready',
+      quantity: stock.quantity
+    };
+  }
+  availability(product, variantId) {
+    const id = product.id ?? product.product_id;
+    if (variantId !== undefined && variantId !== null) return this.availabilityForKey(this.keys.get(variantIdentity(id, variantId)));
+    const keys = [...new Set(this.products.get(String(id))?.values() || [])];
+    const states = keys.map(key => this.availabilityForKey(key));
+    if (!states.length) return this.availabilityForKey();
+    // Unmapped variants are not offered by this source. Exclude even their last
+    // known quantities, while preserving errors on variants that are configured.
+    const mappedStates = states.filter(entry => entry.status !== 'unmapped');
+    if (!mappedStates.length) return {
+      status: 'unmapped',
+      message: this.source.message('unmapped')
+    };
+    const quantity = mappedStates.every(entry => entry.quantity !== undefined) ? mappedStates.reduce((sum, entry) => sum + entry.quantity, 0) : undefined;
+    const failed = mappedStates.find(entry => entry.status !== 'ready');
+    if (quantity !== undefined && !Number.isSafeInteger(quantity)) return {
+      status: 'error',
+      message: this.source.message('unavailable')
+    };
+    return {
+      status: failed?.status || 'ready',
+      quantity,
+      message: failed?.message
+    };
+  }
+  keyForLine(item) {
+    return this.keys.get(variantIdentity(item.product_id, item.product_variant_id ?? item.product_sku?.product_variant_id));
+  }
+  /** Advisory UI limit only. The serialized cart guard remains authoritative. */
+  selectionAvailability(product, variantId, items, editingItem) {
+    const identity = variantIdentity(product.id ?? product.product_id, variantId);
+    const key = this.keys.get(identity);
+    let availability = this.availabilityForKey(key);
+    let reserved = 0;
+    let retainedQuantity = 0;
+    for (const item of items) {
+      const matches = key ? this.keyForLine(item) === key : variantIdentity(item.product_id, item.product_variant_id ?? item.product_sku?.product_variant_id) === identity;
+      if (!matches) continue;
+      const count = Number(item.num ?? item.quantity);
+      if (!Number.isSafeInteger(count) || count < 0) {
+        availability = {
+          ...availability,
+          status: 'error',
+          message: this.source.message('unavailable')
+        };
+        continue;
+      }
+      if (item === editingItem) retainedQuantity = count;else reserved += count;
+    }
+    if (!Number.isSafeInteger(reserved)) {
+      availability = {
+        ...availability,
+        status: 'error',
+        message: this.source.message('unavailable')
+      };
+    }
+    const availableQuantity = availability.status === 'ready' ? Math.max(0, availability.quantity - reserved) : 0;
+    return {
+      availability,
+      availableQuantity,
+      retainedQuantity,
+      maxQuantity: Math.max(availableQuantity, retainedQuantity)
+    };
+  }
+  totals(items) {
+    const totals = new Map();
+    for (const item of items) {
+      const key = this.keyForLine(item);
+      const identity = key ? JSON.stringify(['inventory', key]) : variantIdentity(item.product_id, item.product_variant_id);
+      const quantity = Number(item.num ?? item.quantity);
+      if (!Number.isSafeInteger(quantity) || quantity < 0) throw salesGuardError(this.source.message('unavailable'));
+      if (!quantity) continue;
+      const total = (totals.get(identity)?.quantity || 0) + quantity;
+      if (!Number.isSafeInteger(total)) throw salesGuardError(this.source.message('unavailable'));
+      totals.set(identity, {
+        key,
+        quantity: total
+      });
+    }
+    return totals;
+  }
+  validate(proposed, current = [], allowReductions = true) {
+    this.assertCurrent();
+    const previous = this.totals(current);
+    for (const [identity, {
+      key,
+      quantity
+    }] of this.totals(proposed)) {
+      if (allowReductions && quantity <= (previous.get(identity)?.quantity || 0)) continue;
+      const stock = this.availabilityForKey(key);
+      if (stock.status !== 'ready') throw salesGuardError(stock.message || this.source.message('unavailable'));
+      if (quantity > stock.quantity) throw salesGuardError(this.source.message('insufficient', {
+        key: key,
+        quantity: stock.quantity
+      }));
+    }
+  }
+  freezeCheckout(items) {
+    if (!items.length || items.some(item => Number(item.num ?? item.quantity) <= 0)) {
+      throw salesGuardError(this.source.message('unavailable'));
+    }
+    this.validate(items, [], false);
+    return Object.freeze({
+      scopeKey: this.scopeKey,
+      revision: this.revision,
+      lines: Object.freeze(items.map((item, index) => Object.freeze({
+        lineId: String(item.metadata?.unique_identification_number ?? item.unique_identification_number ?? item.order_detail_id ?? index),
+        productId: item.product_id,
+        variantId: item.product_variant_id ?? item.product_sku?.product_variant_id ?? 0,
+        quantity: Number(item.num ?? item.quantity),
+        inventoryKey: this.keyForLine(item)
+      })))
+    });
+  }
+}
+exports.InventoryController = InventoryController;

package/lib/model/strategy/adapter/promotion/index.js

@@ -1 +1,46 @@
-"use strict";
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "BUY_X_GET_Y_FREE_STRATEGY", {
+  enumerable: true,
+  get: function () {
+    return _examples.BUY_X_GET_Y_FREE_STRATEGY;
+  }
+});
+Object.defineProperty(exports, "ITEM_REWARD_STRATEGY", {
+  enumerable: true,
+  get: function () {
+    return _examples.ITEM_REWARD_STRATEGY;
+  }
+});
+Object.defineProperty(exports, "PromotionAdapter", {
+  enumerable: true,
+  get: function () {
+    return _adapter.PromotionAdapter;
+  }
+});
+Object.defineProperty(exports, "PromotionEvaluator", {
+  enumerable: true,
+  get: function () {
+    return _evaluator.PromotionEvaluator;
+  }
+});
+Object.defineProperty(exports, "X_ITEMS_FOR_Y_PRICE_STRATEGY", {
+  enumerable: true,
+  get: function () {
+    return _examples.X_ITEMS_FOR_Y_PRICE_STRATEGY;
+  }
+});
+Object.defineProperty(exports, "default", {
+  enumerable: true,
+  get: function () {
+    return _adapter.default;
+  }
+});
+var _evaluator = require("./evaluator");
+var _adapter = _interopRequireWildcard(require("./adapter"));
+var _examples = require("./examples");
+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/Discount/index.js

@@ -141,6 +141,7 @@ class DiscountModule extends _BaseModule.BaseModule {
     } = options || {};
     const result = await this.request.get(`/machinecode/batch-search`, {
       code,
+      resolve_ticket_order: 1,
       translate_flag: 1,
       tags: ['entitlement_pass', 'good_pass', 'product_discount_card'],
       // available: 1,

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

@@ -3,7 +3,8 @@ import { BaseModule } from '../BaseModule';
 import { OrderModuleAPI, CommitOrderParams, UpdateOrderBookingParams, UpdateOrderProductParams, UpdateOrderProductQuantityParams, CancelOrderParams, ChangeBookingStatusParams, CheckoutOrderParams } from './types';
 import { CartItem } from '../Cart/types';
 import { type SubmitPayloadEnhancer } from './utils';
-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 ProductVoucherGroup } from './utils/productVoucherGroups';
+import type { OrderAmountSnapshot, AddProductBookingInput, AddProductToOrderOptions, OrderIdentitySnapshot, OrderPaymentSource, OrderSnapshot, OrderSyncState, SyncPaymentsToOrderParams, SyncPaymentsToOrderResult, SubmitSalesOrderParams, OrderProduct, OrderProductIdentity, OrderSummary, OrderTempOrder, OrderPaymentData, OrderPaymentUpdateOptions, OrderPaymentUpdateResult, SendCustomerPayLinkParams, UpdateTempOrderCustomerInput, OrderCustomerPatch, OrderCustomerView, OrderHooksConfig, 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';
@@ -28,6 +29,12 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     private rulesHooksOverride?;
     private moduleHooksOverride?;
     private orderHooks?;
+    private cartCommandQueue;
+    private queueCartCommand;
+    /** Use the exact Order normalizers/merge rules on a private draft, not a second projection. */
+    private beginCartMutation;
+    /** Serializes checkout preparation with local cart commands; hydration remains outside this guard. */
+    prepareCheckout<T>(prepare: (items: OrderProduct[]) => Promise<T>): Promise<T>;
     private otherParams?;
     /** 评估器引用；由 SalesSdkProvider 注入，未注入时 applyPromotion 静默跳过 */
     private promotionEvaluator;
@@ -65,7 +72,11 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
      * @example
      * orderModule.updateOtherParams({ cacheId: 'cache-2', channel: 'pos' });
      */
-    updateOtherParams(params: Record<string, any>): void;
+    updateOtherParams(params: Record<string, any>, options?: {
+        hooks?: OrderHooksConfig;
+        changedParams?: Record<string, any>;
+        cover?: boolean;
+    }): void;
     /** PC/H5 属于在线店铺；其它或缺失平台统一沿用 POS 行为。 */
     isOnlineStorePlatform(): boolean;
     /**
@@ -81,6 +92,8 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
      */
     private logError;
     private registerDiscountModules;
+    setProductVoucherGroups(groups: ProductVoucherGroup[]): void;
+    validateProductVoucherSelection(): void;
     private createDefaultRulesHooks;
     /**
      * Stable across notifyTempOrderChanged's immutable copy, but changes when a
@@ -99,7 +112,9 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     getCustomerWalletPrepareConfigEpoch(): number;
     private syncScannedDiscountsToOriginalDiscountList;
     private ensureEditDiscountConfigForProductChange;
-    scanCode(code: string, customerId?: number): Promise<{
+    scanCode(code: string, customerId?: number, options?: {
+        productVouchersOnly?: boolean;
+    }): Promise<{
         isAvailable: boolean;
         isAccepted?: boolean;
         discountList: Discount[];
@@ -475,6 +490,7 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
      * // → tempOrder.products 新增 3 行，每行 num=1，bookings 3 条
      */
     addProductToOrder(product: Partial<OrderProduct> & OrderProductIdentity, booking?: AddProductBookingInput, options?: AddProductToOrderOptions): Promise<OrderProduct[]>;
+    private addProductToOrderDraft;
     /**
      * 批量添加商品行，所有行追加完成后只触发一次促销、折扣、summary 重算与持久化。
      *
@@ -490,6 +506,7 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     }>, options?: {
         skipEditDiscountConfigRefresh?: boolean;
     }): Promise<OrderProduct[]>;
+    private addProductsToOrderDraft;
     private getFullCoveragePassDiscounts;
     private hasEntitlementPassDiscount;
     private hasGoodPassDiscount;
@@ -500,8 +517,11 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
     private preservePersistedBundlePriceFields;
     private applyOrderProductUpdateToTempOrder;
     updateOrderProduct(params: UpdateOrderProductParams): Promise<OrderProduct[]>;
+    private updateOrderProductDraft;
     updateOrderProducts(paramsList: UpdateOrderProductParams[]): Promise<OrderProduct[]>;
+    private updateOrderProductsDraft;
     updateOrderProductQuantity(params: UpdateOrderProductQuantityParams): Promise<OrderProduct[]>;
+    private updateOrderProductQuantityDraft;
     updateOrderBooking(params: UpdateOrderBookingParams): any[];
     /**
      * 商品行写路径收尾：促销 → 折扣 → 清洗 → summary → 持久化。
@@ -518,12 +538,14 @@ export declare class OrderModule extends BaseModule implements Module, OrderModu
      * await order.removeProductsFromOrder([identityA, identityB]);
      */
     removeProductsFromOrder(identities: OrderProductIdentity[], options?: RemoveProductsFromOrderOptions): Promise<OrderProduct[]>;
+    private removeProductsFromOrderDraft;
     removeProductFromOrder(identity: OrderProductIdentity, options?: RemoveProductsFromOrderOptions): Promise<OrderProduct[]>;
     /**
      * 仅清空购物车行（products / bookings），不重置整单。
      * 普通整单 note 保持不变；以商品行为主体的 Sales Notes 同步删除。
      */
     clearOrderCartLines(): Promise<OrderTempOrder>;
+    private clearOrderCartLinesDraft;
     /**
      * 切换购物车结算单位时清理所有会影响新币种的订单状态，但保留当前客户。
      */