@pisell/pisellos 0.10.53 → 0.10.55

package/dist/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/dist/index.js

@@ -15,4 +15,6 @@ export { PisellOSCore } from "./core";
 
 // 导出框架主类
 import PisellOSCore from "./core";
-export default PisellOSCore;
+export default PisellOSCore;
+export * from "./shared/receipt/small-ticket";
+export { loadSalesOrderSnapshot } from "./shared/sales/loadSalesOrderSnapshot";

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

@@ -0,0 +1,9 @@
+// 导出评估器
+export { PromotionEvaluator } from "./evaluator";
+
+// 导出适配器
+export { PromotionAdapter } from "./adapter";
+export { default } from "./adapter";
+
+// 导出策略配置示例常量
+export { X_ITEMS_FOR_Y_PRICE_STRATEGY, BUY_X_GET_Y_FREE_STRATEGY, ITEM_REWARD_STRATEGY } from "./examples";

package/dist/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/dist/modules/BusinessAvailability/index.js

@@ -0,0 +1,204 @@
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it.return != null) it.return(); } finally { if (didErr) throw err; } } }; }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
+function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
+function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
+import dayjs from 'dayjs';
+import isSameOrAfter from 'dayjs/plugin/isSameOrAfter';
+import isSameOrBefore from 'dayjs/plugin/isSameOrBefore';
+import { getScheduleStartEndTimePoints } from "../Schedule/getDateIsInSchedule";
+dayjs.extend(isSameOrAfter);
+dayjs.extend(isSameOrBefore);
+var DAY = 86400000;
+var behavior = function behavior(value) {
+  return value === 'show_menu_disabled' ? value : 'hide_all';
+};
+var message = function message(value) {
+  return typeof value === 'string' || value !== null && _typeof(value) === 'object' && !Array.isArray(value) ? value : null;
+};
+export function normalizeBusinessAvailabilityConfig(data) {
+  var rawIds = data['availability.operating_hours'];
+  var ids = Array.isArray(rawIds) ? rawIds.map(function (id) {
+    return typeof id === 'number' || typeof id === 'string' ? Number(id) : NaN;
+  }) : [];
+  var validIds = ids.filter(function (id) {
+    return Number.isInteger(id) && id > 0;
+  });
+  var 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: _toConsumableArray(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.');
+  var 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'
+  });
+  var local = function local(timestamp) {
+    var parts = {};
+    formatter.formatToParts(timestamp).forEach(function (part) {
+      parts[part.type] = part.value;
+    });
+    var date = "".concat(parts.year, "-").concat(parts.month, "-").concat(parts.day);
+    return {
+      date: date,
+      scalar: Date.parse("".concat(date, "T").concat(parts.hour, ":").concat(parts.minute, ":").concat(parts.second, "Z"))
+    };
+  };
+  var offsets = new Set();
+  var instants = function instants(scalar) {
+    offsets.clear();
+    for (var hours = -36; hours <= 36; hours += 6) {
+      var sample = scalar + hours * 3600000;
+      offsets.add(local(sample).scalar - sample);
+    }
+    return _toConsumableArray(offsets).map(function (offset) {
+      return scalar - offset;
+    }).filter(function (instant) {
+      return local(instant).scalar === scalar;
+    }).sort(function (a, b) {
+      return a - b;
+    });
+  };
+  return {
+    local: local,
+    instants: instants
+  };
+}
+
+/** Business ordering is independent of reservation switches and Pickup slot availability. */
+export function computeBusinessAvailability(input) {
+  var config = input.config,
+    schedules = input.schedules,
+    timezone = input.timezone,
+    now = input.now;
+  var nowAt = now.getTime();
+  var base = {
+    requirePaymentOnSubmit: config.requirePaymentOnSubmit,
+    nextChangeAt: nowAt + DAY
+  };
+  if (config.paused) {
+    return _objectSpread(_objectSpread({}, 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 _objectSpread(_objectSpread({}, base), {}, {
+    status: 'open',
+    behavior: null,
+    message: null
+  });
+  var selected = schedules.filter(function (schedule) {
+    return config.scheduleIds.includes(Number(schedule.id));
+  });
+  if (config.scheduleIds.some(function (id) {
+    return !selected.some(function (schedule) {
+      return Number(schedule.id) === id;
+    });
+  })) {
+    throw new Error('A configured business operating-hours schedule is unavailable.');
+  }
+  var clock = createClock(timezone);
+  var current = clock.local(nowAt);
+  var today = Date.parse("".concat(current.date, "T00:00:00Z"));
+  var nextMidnight = clock.instants(today + DAY).find(function (instant) {
+    return instant > nowAt;
+  });
+  var nextChangeAt = nextMidnight !== null && nextMidnight !== void 0 ? nextMidnight : nowAt + 60000;
+  var open = false;
+  // Yesterday contributes the tail of overnight windows; today supplies the next boundary.
+  for (var _i = 0, _arr = [today - DAY, today]; _i < _arr.length; _i++) {
+    var dateAt = _arr[_i];
+    var date = new Date(dateAt).toISOString().slice(0, 10);
+    // Schedule's resolver merges by time-of-day, so resolve each schedule independently.
+    var _iterator = _createForOfIteratorHelper(selected),
+      _step;
+    try {
+      for (_iterator.s(); !(_step = _iterator.n()).done;) {
+        var schedule = _step.value;
+        var _iterator2 = _createForOfIteratorHelper(getScheduleStartEndTimePoints(date, [schedule])),
+          _step2;
+        try {
+          for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+            var window = _step2.value;
+            var toMinutes = function 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.');
+              }
+              var _value$split$map = value.split(':').map(Number),
+                _value$split$map2 = _slicedToArray(_value$split$map, 2),
+                hours = _value$split$map2[0],
+                minutes = _value$split$map2[1];
+              return hours * 60 + minutes;
+            };
+            var start = dateAt + toMinutes(window.start_time) * 60000;
+            var end = dateAt + toMinutes(window.end_time) * 60000;
+            if (end <= start) end += DAY;
+            if (current.scalar >= start && current.scalar < end) open = true;
+            for (var _i2 = 0, _arr2 = [start, end]; _i2 < _arr2.length; _i2++) {
+              var boundary = _arr2[_i2];
+              var _iterator3 = _createForOfIteratorHelper(clock.instants(boundary)),
+                _step3;
+              try {
+                for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
+                  var instant = _step3.value;
+                  if (instant > nowAt) nextChangeAt = Math.min(nextChangeAt, instant);
+                }
+              } catch (err) {
+                _iterator3.e(err);
+              } finally {
+                _iterator3.f();
+              }
+            }
+          }
+        } catch (err) {
+          _iterator2.e(err);
+        } finally {
+          _iterator2.f();
+        }
+      }
+    } catch (err) {
+      _iterator.e(err);
+    } finally {
+      _iterator.f();
+    }
+  }
+  // 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 + 60000);
+  return _objectSpread(_objectSpread({}, base), {}, {
+    nextChangeAt: nextChangeAt,
+    status: open ? 'open' : 'closed',
+    behavior: open ? null : config.closedBehavior,
+    message: open ? null : config.closedMessage
+  });
+}

package/dist/modules/OpenData/index.js

@@ -132,7 +132,7 @@ export var OpenDataModule = /*#__PURE__*/function (_BaseModule) {
     key: "shouldSkipInvoiceTemplateDocument",
     value: function shouldSkipInvoiceTemplateDocument() {
       var _this$otherParams;
-      return String(((_this$otherParams = this.otherParams) === null || _this$otherParams === void 0 ? void 0 : _this$otherParams.platform) || '').trim().toLowerCase() === 'h5';
+      return this.otherParams.invoiceDocument !== true && String(((_this$otherParams = this.otherParams) === null || _this$otherParams === void 0 ? void 0 : _this$otherParams.platform) || '').trim().toLowerCase() === 'h5';
     }
   }, {
     key: "fetchOpenData",

package/dist/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/dist/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;