@pisell/pisellos 2.3.138 → 2.3.140

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

@@ -1,5 +1,7 @@
 import type { Module, ModuleOptions, PisellCore } from '../../types';
 import { BaseModule } from '../../modules/BaseModule';
+import { type CustomerInvoiceLanguageCode, type CustomerInvoiceLanguageOption } from '../../shared/receipt/customerInvoiceLanguages';
+export type { CustomerInvoiceLanguageCode, CustomerInvoiceLanguageOption, } from '../../shared/receipt/customerInvoiceLanguages';
 import type { InvoiceLayoutConfig } from '../../modules/OpenData';
 import { type SmallTicketData } from '../../shared/receipt/small-ticket';
 export interface OrderInvoicePreviewInput {
@@ -19,6 +21,9 @@ export interface OrderInvoicePreviewResult {
     sourceRevision: string;
     generatedAt: string;
     locale: string;
+    secondaryLocale?: string;
+    languageOptions: CustomerInvoiceLanguageOption[];
+    selectedLanguage: CustomerInvoiceLanguageCode;
     orderId: string | number;
     source: Record<string, any>;
     shop: Record<string, any>;
@@ -40,6 +45,7 @@ export declare class OrderInvoicePreviewImpl extends BaseModule implements Modul
     private disposed;
     private input?;
     private activeKey;
+    private languageSelection?;
     private pending?;
     private snapshotCache;
     constructor(name?: string);
@@ -51,6 +57,10 @@ export declare class OrderInvoicePreviewImpl extends BaseModule implements Modul
     private loadContext;
     private loadSource;
     prepare(input: OrderInvoicePreviewInput): Promise<OrderInvoicePreviewResult>;
+    private getSelectionScope;
+    private documentIdentity;
+    /** Switch only the ready receipt projection; no fetching or rebuilding data. */
+    selectLanguage(code: string): OrderInvoicePreviewResult;
     retry(): Promise<OrderInvoicePreviewResult>;
     destroy(): void;
 }

package/dist/solution/OrderInvoicePreview/index.js

@@ -1,4 +1,11 @@
+var _excluded = ["secondaryLocale"];
+function _objectWithoutProperties(source, excluded) { if (source == null) return {}; var target = _objectWithoutPropertiesLoose(source, excluded); var key, i; if (Object.getOwnPropertySymbols) { var sourceSymbolKeys = Object.getOwnPropertySymbols(source); for (i = 0; i < sourceSymbolKeys.length; i++) { key = sourceSymbolKeys[i]; if (excluded.indexOf(key) >= 0) continue; if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue; target[key] = source[key]; } } return target; }
+function _objectWithoutPropertiesLoose(source, excluded) { if (source == null) return {}; var target = {}; var sourceKeys = Object.keys(source); var key, i; for (i = 0; i < sourceKeys.length; i++) { key = sourceKeys[i]; if (excluded.indexOf(key) >= 0) continue; target[key] = source[key]; } return target; }
 function _regeneratorRuntime() { "use strict"; /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/facebook/regenerator/blob/main/LICENSE */ _regeneratorRuntime = function _regeneratorRuntime() { return e; }; var t, e = {}, r = Object.prototype, n = r.hasOwnProperty, o = Object.defineProperty || function (t, e, r) { t[e] = r.value; }, i = "function" == typeof Symbol ? Symbol : {}, a = i.iterator || "@@iterator", c = i.asyncIterator || "@@asyncIterator", u = i.toStringTag || "@@toStringTag"; function define(t, e, r) { return Object.defineProperty(t, e, { value: r, enumerable: !0, configurable: !0, writable: !0 }), t[e]; } try { define({}, ""); } catch (t) { define = function define(t, e, r) { return t[e] = r; }; } function wrap(t, e, r, n) { var i = e && e.prototype instanceof Generator ? e : Generator, a = Object.create(i.prototype), c = new Context(n || []); return o(a, "_invoke", { value: makeInvokeMethod(t, r, c) }), a; } function tryCatch(t, e, r) { try { return { type: "normal", arg: t.call(e, r) }; } catch (t) { return { type: "throw", arg: t }; } } e.wrap = wrap; var h = "suspendedStart", l = "suspendedYield", f = "executing", s = "completed", y = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} var p = {}; define(p, a, function () { return this; }); var d = Object.getPrototypeOf, v = d && d(d(values([]))); v && v !== r && n.call(v, a) && (p = v); var g = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(p); function defineIteratorMethods(t) { ["next", "throw", "return"].forEach(function (e) { define(t, e, function (t) { return this._invoke(e, t); }); }); } function AsyncIterator(t, e) { function invoke(r, o, i, a) { var c = tryCatch(t[r], t, o); if ("throw" !== c.type) { var u = c.arg, h = u.value; return h && "object" == _typeof(h) && n.call(h, "__await") ? e.resolve(h.__await).then(function (t) { invoke("next", t, i, a); }, function (t) { invoke("throw", t, i, a); }) : e.resolve(h).then(function (t) { u.value = t, i(u); }, function (t) { return invoke("throw", t, i, a); }); } a(c.arg); } var r; o(this, "_invoke", { value: function value(t, n) { function callInvokeWithMethodAndArg() { return new e(function (e, r) { invoke(t, n, e, r); }); } return r = r ? r.then(callInvokeWithMethodAndArg, callInvokeWithMethodAndArg) : callInvokeWithMethodAndArg(); } }); } function makeInvokeMethod(e, r, n) { var o = h; return function (i, a) { if (o === f) throw new Error("Generator is already running"); if (o === s) { if ("throw" === i) throw a; return { value: t, done: !0 }; } for (n.method = i, n.arg = a;;) { var c = n.delegate; if (c) { var u = maybeInvokeDelegate(c, n); if (u) { if (u === y) continue; return u; } } if ("next" === n.method) n.sent = n._sent = n.arg;else if ("throw" === n.method) { if (o === h) throw o = s, n.arg; n.dispatchException(n.arg); } else "return" === n.method && n.abrupt("return", n.arg); o = f; var p = tryCatch(e, r, n); if ("normal" === p.type) { if (o = n.done ? s : l, p.arg === y) continue; return { value: p.arg, done: n.done }; } "throw" === p.type && (o = s, n.method = "throw", n.arg = p.arg); } }; } function maybeInvokeDelegate(e, r) { var n = r.method, o = e.iterator[n]; if (o === t) return r.delegate = null, "throw" === n && e.iterator.return && (r.method = "return", r.arg = t, maybeInvokeDelegate(e, r), "throw" === r.method) || "return" !== n && (r.method = "throw", r.arg = new TypeError("The iterator does not provide a '" + n + "' method")), y; var i = tryCatch(o, e.iterator, r.arg); if ("throw" === i.type) return r.method = "throw", r.arg = i.arg, r.delegate = null, y; var a = i.arg; return a ? a.done ? (r[e.resultName] = a.value, r.next = e.nextLoc, "return" !== r.method && (r.method = "next", r.arg = t), r.delegate = null, y) : a : (r.method = "throw", r.arg = new TypeError("iterator result is not an object"), r.delegate = null, y); } function pushTryEntry(t) { var e = { tryLoc: t[0] }; 1 in t && (e.catchLoc = t[1]), 2 in t && (e.finallyLoc = t[2], e.afterLoc = t[3]), this.tryEntries.push(e); } function resetTryEntry(t) { var e = t.completion || {}; e.type = "normal", delete e.arg, t.completion = e; } function Context(t) { this.tryEntries = [{ tryLoc: "root" }], t.forEach(pushTryEntry, this), this.reset(!0); } function values(e) { if (e || "" === e) { var r = e[a]; if (r) return r.call(e); if ("function" == typeof e.next) return e; if (!isNaN(e.length)) { var o = -1, i = function next() { for (; ++o < e.length;) if (n.call(e, o)) return next.value = e[o], next.done = !1, next; return next.value = t, next.done = !0, next; }; return i.next = i; } } throw new TypeError(_typeof(e) + " is not iterable"); } return GeneratorFunction.prototype = GeneratorFunctionPrototype, o(g, "constructor", { value: GeneratorFunctionPrototype, configurable: !0 }), o(GeneratorFunctionPrototype, "constructor", { value: GeneratorFunction, configurable: !0 }), GeneratorFunction.displayName = define(GeneratorFunctionPrototype, u, "GeneratorFunction"), e.isGeneratorFunction = function (t) { var e = "function" == typeof t && t.constructor; return !!e && (e === GeneratorFunction || "GeneratorFunction" === (e.displayName || e.name)); }, e.mark = function (t) { return Object.setPrototypeOf ? Object.setPrototypeOf(t, GeneratorFunctionPrototype) : (t.__proto__ = GeneratorFunctionPrototype, define(t, u, "GeneratorFunction")), t.prototype = Object.create(g), t; }, e.awrap = function (t) { return { __await: t }; }, defineIteratorMethods(AsyncIterator.prototype), define(AsyncIterator.prototype, c, function () { return this; }), e.AsyncIterator = AsyncIterator, e.async = function (t, r, n, o, i) { void 0 === i && (i = Promise); var a = new AsyncIterator(wrap(t, r, n, o), i); return e.isGeneratorFunction(r) ? a : a.next().then(function (t) { return t.done ? t.value : a.next(); }); }, defineIteratorMethods(g), define(g, u, "Generator"), define(g, a, function () { return this; }), define(g, "toString", function () { return "[object Generator]"; }), e.keys = function (t) { var e = Object(t), r = []; for (var n in e) r.push(n); return r.reverse(), function next() { for (; r.length;) { var t = r.pop(); if (t in e) return next.value = t, next.done = !1, next; } return next.done = !0, next; }; }, e.values = values, Context.prototype = { constructor: Context, reset: function reset(e) { if (this.prev = 0, this.next = 0, this.sent = this._sent = t, this.done = !1, this.delegate = null, this.method = "next", this.arg = t, this.tryEntries.forEach(resetTryEntry), !e) for (var r in this) "t" === r.charAt(0) && n.call(this, r) && !isNaN(+r.slice(1)) && (this[r] = t); }, stop: function stop() { this.done = !0; var t = this.tryEntries[0].completion; if ("throw" === t.type) throw t.arg; return this.rval; }, dispatchException: function dispatchException(e) { if (this.done) throw e; var r = this; function handle(n, o) { return a.type = "throw", a.arg = e, r.next = n, o && (r.method = "next", r.arg = t), !!o; } for (var o = this.tryEntries.length - 1; o >= 0; --o) { var i = this.tryEntries[o], a = i.completion; if ("root" === i.tryLoc) return handle("end"); if (i.tryLoc <= this.prev) { var c = n.call(i, "catchLoc"), u = n.call(i, "finallyLoc"); if (c && u) { if (this.prev < i.catchLoc) return handle(i.catchLoc, !0); if (this.prev < i.finallyLoc) return handle(i.finallyLoc); } else if (c) { if (this.prev < i.catchLoc) return handle(i.catchLoc, !0); } else { if (!u) throw new Error("try statement without catch or finally"); if (this.prev < i.finallyLoc) return handle(i.finallyLoc); } } } }, abrupt: function abrupt(t, e) { for (var r = this.tryEntries.length - 1; r >= 0; --r) { var o = this.tryEntries[r]; if (o.tryLoc <= this.prev && n.call(o, "finallyLoc") && this.prev < o.finallyLoc) { var i = o; break; } } i && ("break" === t || "continue" === t) && i.tryLoc <= e && e <= i.finallyLoc && (i = null); var a = i ? i.completion : {}; return a.type = t, a.arg = e, i ? (this.method = "next", this.next = i.finallyLoc, y) : this.complete(a); }, complete: function complete(t, e) { if ("throw" === t.type) throw t.arg; return "break" === t.type || "continue" === t.type ? this.next = t.arg : "return" === t.type ? (this.rval = this.arg = t.arg, this.method = "return", this.next = "end") : "normal" === t.type && e && (this.next = e), y; }, finish: function finish(t) { for (var e = this.tryEntries.length - 1; e >= 0; --e) { var r = this.tryEntries[e]; if (r.finallyLoc === t) return this.complete(r.completion, r.afterLoc), resetTryEntry(r), y; } }, catch: function _catch(t) { for (var e = this.tryEntries.length - 1; e >= 0; --e) { var r = this.tryEntries[e]; if (r.tryLoc === t) { var n = r.completion; if ("throw" === n.type) { var o = n.arg; resetTryEntry(r); } return o; } } throw new Error("illegal catch attempt"); }, delegateYield: function delegateYield(e, r, n) { return this.delegate = { iterator: values(e), resultName: r, nextLoc: n }, "next" === this.method && (this.arg = t), y; } }, e; }
+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 _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 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 asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) { try { var info = gen[key](arg); var value = info.value; } catch (error) { reject(error); return; } if (info.done) { resolve(value); } else { Promise.resolve(value).then(_next, _throw); } }
@@ -26,7 +33,8 @@ function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key i
 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); }
 import { BaseModule } from "../../modules/BaseModule";
-import { loadCustomerInvoiceLayout } from "../../shared/receipt/loadCustomerInvoiceLayout";
+import { loadCustomerInvoiceTemplate } from "../../shared/receipt/loadCustomerInvoiceLayout";
+import { resolveCustomerInvoiceLanguages } from "../../shared/receipt/customerInvoiceLanguages";
 import { buildSmallTicketData } from "../../shared/receipt/small-ticket";
 import { loadSalesOrderSnapshot } from "../../shared/sales/loadSalesOrderSnapshot";
 import { loadPaymentMethods, withPaymentMethodNames } from "../../shared/payment/loadPaymentMethods";
@@ -53,6 +61,8 @@ export var OrderInvoicePreviewImpl = /*#__PURE__*/function (_BaseModule) {
     _defineProperty(_assertThisInitialized(_this), "disposed", false);
     _defineProperty(_assertThisInitialized(_this), "input", void 0);
     _defineProperty(_assertThisInitialized(_this), "activeKey", '');
+    // Hosts retain this readonly instance while the same order modal is closed.
+    _defineProperty(_assertThisInitialized(_this), "languageSelection", void 0);
     _defineProperty(_assertThisInitialized(_this), "pending", void 0);
     _defineProperty(_assertThisInitialized(_this), "snapshotCache", new Map());
     _defineProperty(_assertThisInitialized(_this), "getState", function () {
@@ -95,7 +105,7 @@ export var OrderInvoicePreviewImpl = /*#__PURE__*/function (_BaseModule) {
         cache = new Map();
         contextCaches.set(this.request, cache);
       }
-      var key = JSON.stringify([input.tenantId, input.shopId, input.identity, input.locale]);
+      var key = JSON.stringify([input.tenantId, input.shopId, input.identity]);
       var cached = cache.get(key);
       if (cached) return cached;
       var task = Promise.all([this.request.get('/shop/show', {}, {
@@ -154,6 +164,7 @@ export var OrderInvoicePreviewImpl = /*#__PURE__*/function (_BaseModule) {
       var _this$core$getPlugin,
         _this$core$getPlugin$,
         _this$core$getPlugin$2,
+        _this$languageSelecti,
         _this3 = this;
       if (this.disposed) return Promise.reject(new Error('Invoice preview disposed'));
       var currentShop = (_this$core$getPlugin = this.core.getPlugin('app')) === null || _this$core$getPlugin === void 0 || (_this$core$getPlugin$ = _this$core$getPlugin.getData) === null || _this$core$getPlugin$ === void 0 || (_this$core$getPlugin$2 = _this$core$getPlugin$.call(_this$core$getPlugin)) === null || _this$core$getPlugin$2 === void 0 ? void 0 : _this$core$getPlugin$2('shop_id');
@@ -166,6 +177,7 @@ export var OrderInvoicePreviewImpl = /*#__PURE__*/function (_BaseModule) {
         if (this.state.status === 'ready' && this.state.result) return Promise.resolve(this.state.result);
       }
       if (this.input && this.getScope(this.input) !== this.getScope(input)) this.snapshotCache.clear();
+      if (((_this$languageSelecti = this.languageSelection) === null || _this$languageSelecti === void 0 ? void 0 : _this$languageSelecti.scope) !== this.getSelectionScope(input)) this.languageSelection = undefined;
       this.input = input;
       this.activeKey = key;
       var generation = ++this.generation;
@@ -175,19 +187,19 @@ export var OrderInvoicePreviewImpl = /*#__PURE__*/function (_BaseModule) {
         error: null
       });
       var task = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee() {
-        var _this3$core$getPlugin, _this3$core$getPlugin2, _coreData$core;
-        var _yield$Promise$all, _yield$Promise$all2, snapshot, context, layout, source, getData, coreData, shop, requestedLocale, locale, result;
+        var _this3$core$getPlugin, _this3$core$getPlugin2, _coreData$core, _this3$languageSelect;
+        var _yield$Promise$all, _yield$Promise$all2, snapshot, context, template, source, getData, coreData, shop, languageOptions, remembered, selected, locale, result;
         return _regeneratorRuntime().wrap(function _callee$(_context) {
           while (1) switch (_context.prev = _context.next) {
             case 0:
               _context.next = 2;
-              return Promise.all([_this3.loadSource(input), _this3.loadContext(input), loadCustomerInvoiceLayout(_this3.request, input)]);
+              return Promise.all([_this3.loadSource(input), _this3.loadContext(input), loadCustomerInvoiceTemplate(_this3.request, input)]);
             case 2:
               _yield$Promise$all = _context.sent;
               _yield$Promise$all2 = _slicedToArray(_yield$Promise$all, 3);
               snapshot = _yield$Promise$all2[0];
               context = _yield$Promise$all2[1];
-              layout = _yield$Promise$all2[2];
+              template = _yield$Promise$all2[2];
               source = withPaymentMethodNames(snapshot, context.methods);
               getData = (_this3$core$getPlugin = _this3.core.getPlugin('app')) === null || _this3$core$getPlugin === void 0 || (_this3$core$getPlugin2 = _this3$core$getPlugin.getData) === null || _this3$core$getPlugin2 === void 0 ? void 0 : _this3$core$getPlugin2.call(_this3$core$getPlugin);
               if (!((getData === null || getData === void 0 ? void 0 : getData('shop_id')) != null && String(getData('shop_id')) !== String(input.shopId))) {
@@ -206,30 +218,42 @@ export var OrderInvoicePreviewImpl = /*#__PURE__*/function (_BaseModule) {
               }
               throw new Error('Invoice request superseded');
             case 15:
-              requestedLocale = input.locale.toLowerCase().replace(/_/g, '-');
-              locale = requestedLocale.startsWith('zh-tw') || requestedLocale.startsWith('zh-hk') ? 'zh_HK' : requestedLocale.startsWith('zh') ? 'zh_CN' : requestedLocale.startsWith('ja') ? 'ja' : requestedLocale.startsWith('pt') ? 'pt' : 'en';
-              result = {
-                identity: key,
+              languageOptions = resolveCustomerInvoiceLanguages(template.language, input.locale);
+              remembered = (_this3$languageSelect = _this3.languageSelection) === null || _this3$languageSelect === void 0 ? void 0 : _this3$languageSelect.code;
+              selected = languageOptions.find(function (option) {
+                return option.code === remembered;
+              }) || languageOptions[0];
+              locale = selected.locales[0];
+              result = _objectSpread(_objectSpread({
+                identity: _this3.documentIdentity(key, selected.code),
+                languageOptions: languageOptions,
+                selectedLanguage: selected.code
+              }, selected.locales[1] ? {
+                secondaryLocale: selected.locales[1]
+              } : {}), {}, {
                 orderId: input.orderId,
                 sourceRevision: input.sourceRevision,
                 generatedAt: new Date().toISOString(),
                 locale: locale,
                 source: source,
                 shop: shop,
-                layout: layout,
+                layout: template.layout,
                 smallTicketData: buildSmallTicketData({
                   order: source,
                   shopInfo: shop,
-                  locales: [locale]
+                  locales: _toConsumableArray(new Set(languageOptions.flatMap(function (option) {
+                    return option.locales;
+                  }))),
+                  includeReceiptKeys: true
                 })
-              };
+              });
               _this3.publish({
                 status: 'ready',
                 result: result,
                 error: null
               });
               return _context.abrupt("return", result);
-            case 20:
+            case 22:
             case "end":
               return _context.stop();
           }
@@ -249,6 +273,52 @@ export var OrderInvoicePreviewImpl = /*#__PURE__*/function (_BaseModule) {
       this.pending = task;
       return task;
     }
+  }, {
+    key: "getSelectionScope",
+    value: function getSelectionScope(input) {
+      return JSON.stringify([this.getScope(input), input.orderId]);
+    }
+  }, {
+    key: "documentIdentity",
+    value: function documentIdentity(key, language) {
+      return JSON.stringify([key, language]);
+    }
+
+    /** Switch only the ready receipt projection; no fetching or rebuilding data. */
+  }, {
+    key: "selectLanguage",
+    value: function selectLanguage(code) {
+      var _this$core$getPlugin2, _this$core$getPlugin3, _this$core$getPlugin4;
+      if (this.disposed) throw new Error('Invoice preview disposed');
+      var current = this.state.result;
+      if (this.state.status !== 'ready' || !current || !this.input) throw new Error('Invoice preview is not ready');
+      var currentShop = (_this$core$getPlugin2 = this.core.getPlugin('app')) === null || _this$core$getPlugin2 === void 0 || (_this$core$getPlugin3 = _this$core$getPlugin2.getData) === null || _this$core$getPlugin3 === void 0 || (_this$core$getPlugin4 = _this$core$getPlugin3.call(_this$core$getPlugin2)) === null || _this$core$getPlugin4 === void 0 ? void 0 : _this$core$getPlugin4('shop_id');
+      if (currentShop != null && String(currentShop) !== String(this.input.shopId)) throw new Error('Invoice shop changed');
+      var selected = current.languageOptions.find(function (option) {
+        return option.code === code;
+      });
+      if (!selected) throw new Error('Invoice language is unavailable');
+      this.languageSelection = {
+        scope: this.getSelectionScope(this.input),
+        code: selected.code
+      };
+      if (selected.code === current.selectedLanguage) return current;
+      var _previousSecondary = current.secondaryLocale,
+        rest = _objectWithoutProperties(current, _excluded);
+      var result = _objectSpread(_objectSpread({}, rest), {}, {
+        identity: this.documentIdentity(this.activeKey, selected.code),
+        selectedLanguage: selected.code,
+        locale: selected.locales[0]
+      }, selected.locales[1] ? {
+        secondaryLocale: selected.locales[1]
+      } : {});
+      this.publish({
+        status: 'ready',
+        result: result,
+        error: null
+      });
+      return result;
+    }
   }, {
     key: "retry",
     value: function retry() {

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

@@ -1,46 +1 @@
-"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; }
+"use strict";

package/lib/modules/Order/utils.js

@@ -1540,7 +1540,7 @@ function buildSubmitPayload(params) {
     shop_discount: tempOrder.shop_discount || '0.00',
     surcharge_fee: tempOrder.surcharge_fee || '0.00',
     note: tempOrder.note || '',
-    delivery_type: tempOrder.delivery_type || 'nil',
+    delivery_type: tempOrder.delivery_type || 'shop_service',
     schedule_date: scheduleDate,
     // created_at: tempOrder.created_at || formatDateTime(now), 和后端协定这个字段先不提交到接口
     bookings: (tempOrder.bookings || []).filter(booking => (0, _pickupTiming.isFulfillmentTimingBooking)(booking) || Number(booking.parent_id) !== 0).map(booking => normalizeSubmitBooking(booking)),

package/lib/server/modules/floor-plan/index.js

@@ -9,6 +9,30 @@ var _types = require("./types");
 const FLOOR_PLAN_SYNC_DEBOUNCE_MS = 3000;
 const FLOOR_PLAN_STORE_NAME = 'floor_plans';
 
+/**
+ * Request failures can be plain response objects (rather than Error instances).
+ * Keep diagnostics useful without allowing the UI bridge to stringify them as
+ * "[object Object]".
+ */
+function getRequestErrorInfo(error) {
+  if (error instanceof Error && error.message) return {
+    message: error.message
+  };
+  if (typeof error === 'string' && error) return {
+    message: error
+  };
+  const value = error;
+  const response = value?.resData?.res ?? value?.response?.data ?? value?.data ?? value;
+  const candidates = [value?.message, value?.error, response?.message, response?.error];
+  const message = candidates.find(candidate => typeof candidate === 'string' && candidate.trim() !== '');
+  return {
+    message: message || '平面图加载失败（未提供错误详情）',
+    code: response?.code ?? value?.code,
+    status: response?.status ?? value?.status,
+    httpStatus: value?.response?.status
+  };
+}
+
 /**
  * 平面图模块：预加载列表、pubsub 同步、供 OS Server 路由读本地 store
  */
@@ -144,8 +168,12 @@ class FloorPlanModule extends _BaseModule.BaseModule {
       const list = Array.isArray(raw) ? raw : [];
       return list;
     } catch (e) {
+      const errorInfo = getRequestErrorInfo(e);
       this.logWarning('loadListFromServer 失败', {
-        error: e instanceof Error ? e.message : String(e)
+        error: errorInfo.message,
+        code: errorInfo.code,
+        status: errorInfo.status,
+        httpStatus: errorInfo.httpStatus
       });
       return [];
     }

package/lib/server/test.json

@@ -132,7 +132,7 @@
     "contacts_info": null,
     "holder": null,
     "metadata": {},
-    "delivery_type": "nil",
+    "delivery_type": "shop_service",
     "small_ticket_data_flag": 1,
     "need_sync": 1,
     "payment_info": {

package/lib/shared/receipt/customerInvoiceLanguages.d.ts

@@ -0,0 +1,8 @@
+export type CustomerInvoiceLanguageCode = 'en' | 'zh_CN' | 'zh_HK' | 'ja' | 'pt' | 'cn_en';
+export interface CustomerInvoiceLanguageOption {
+    code: CustomerInvoiceLanguageCode;
+    locales: string[];
+}
+export declare function normalizeCustomerInvoiceLanguage(value: string): CustomerInvoiceLanguageCode | undefined;
+/** Preserve configured insertion order; a print count never repeats an option. */
+export declare function resolveCustomerInvoiceLanguages(language: Record<string, unknown>, pageLocale: string): CustomerInvoiceLanguageOption[];

package/lib/shared/receipt/customerInvoiceLanguages.js

@@ -0,0 +1,58 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.normalizeCustomerInvoiceLanguage = normalizeCustomerInvoiceLanguage;
+exports.resolveCustomerInvoiceLanguages = resolveCustomerInvoiceLanguages;
+const aliases = {
+  en: 'en',
+  en_us: 'en',
+  en_gb: 'en',
+  en_au: 'en',
+  cn: 'zh_CN',
+  zh: 'zh_CN',
+  zh_cn: 'zh_CN',
+  zh_hans: 'zh_CN',
+  zh_sg: 'zh_CN',
+  hk: 'zh_HK',
+  zh_hk: 'zh_HK',
+  zh_tw: 'zh_HK',
+  zh_hant: 'zh_HK',
+  ja: 'ja',
+  ja_jp: 'ja',
+  jp: 'ja',
+  pt: 'pt',
+  pt_br: 'pt',
+  pt_pt: 'pt',
+  cn_en: 'cn_en',
+  en_cn: 'cn_en'
+};
+function normalizeCustomerInvoiceLanguage(value) {
+  return aliases[value.trim().toLowerCase().replace(/-/g, '_')];
+}
+function option(code) {
+  return {
+    code,
+    locales: code === 'cn_en' ? ['en', 'zh_CN'] : [code]
+  };
+}
+
+/** Preserve configured insertion order; a print count never repeats an option. */
+function resolveCustomerInvoiceLanguages(language, pageLocale) {
+  const options = [];
+  const seen = new Set();
+  Object.entries(language).forEach(([key, count]) => {
+    if (typeof count !== 'number' || !Number.isFinite(count) || count <= 0) return;
+    const code = normalizeCustomerInvoiceLanguage(key);
+    if (!code || seen.has(code)) return;
+    seen.add(code);
+    options.push(option(code));
+  });
+  if (options.length) return options;
+  const normalized = normalizeCustomerInvoiceLanguage(pageLocale);
+  // A page locale is a single language, never a bilingual printer mode.
+  const requested = pageLocale.toLowerCase().replace(/_/g, '-');
+  const fallback = normalized && normalized !== 'cn_en' ? normalized : requested.startsWith('zh-tw') || requested.startsWith('zh-hk') ? 'zh_HK' : requested.startsWith('zh') ? 'zh_CN' : requested.startsWith('ja') ? 'ja' : requested.startsWith('pt') ? 'pt' : 'en';
+  return [option(fallback)];
+}

package/lib/shared/receipt/loadCustomerInvoiceLayout.d.ts

@@ -11,6 +11,10 @@ export interface PublicInvoiceDocumentResponse {
         } | null;
     } | null;
 }
+export interface CustomerInvoiceTemplate {
+    layout: InvoiceLayoutConfig;
+    language: Record<string, unknown>;
+}
 interface TemplateScope {
     tenantId: string | number;
     shopId: string | number;
@@ -18,5 +22,6 @@ interface TemplateScope {
     businessCode: string;
     channel: string;
 }
+export declare function loadCustomerInvoiceTemplate(request: RequestPlugin, scope: TemplateScope): Promise<CustomerInvoiceTemplate>;
 export declare function loadCustomerInvoiceLayout(request: RequestPlugin, scope: TemplateScope): Promise<InvoiceLayoutConfig>;
 export {};

package/lib/shared/receipt/loadCustomerInvoiceLayout.js

@@ -4,6 +4,7 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.loadCustomerInvoiceLayout = loadCustomerInvoiceLayout;
+exports.loadCustomerInvoiceTemplate = loadCustomerInvoiceTemplate;
 var _OpenData = require("../../modules/OpenData");
 // Page-runtime caches: also retain DEFAULT on failure, without automatic retries.
 const caches = new WeakMap();
@@ -15,7 +16,7 @@ function documentId(value) {
   const id = Number(text);
   return Number.isSafeInteger(id) && id > 0 ? String(id) : null;
 }
-function loadCustomerInvoiceLayout(request, scope) {
+function loadCustomerInvoiceTemplate(request, scope) {
   let cache = caches.get(request);
   if (!cache) {
     cache = {
@@ -51,7 +52,10 @@ function loadCustomerInvoiceLayout(request, scope) {
     if (!id) {
       // Preserve the existing non-numeric legacy template / invoice_edit contract.
       const numericLike = /^[+-]?(?:\d+\.?\d*|\.\d+)(?:e[+-]?\d+)?$/i;
-      return typeof raw === 'string' && raw.trim() && !numericLike.test(raw.trim()) ? (0, _OpenData.normalizeInvoiceLayoutFromTemplateSettings)((0, _OpenData.normalizeInvoiceTemplateSettings)(config)) : (0, _OpenData.getDefaultInvoiceLayoutConfig)();
+      return typeof raw === 'string' && raw.trim() && !numericLike.test(raw.trim()) ? {
+        layout: (0, _OpenData.normalizeInvoiceLayoutFromTemplateSettings)((0, _OpenData.normalizeInvoiceTemplateSettings)(config)),
+        language: readLanguage(config['documents.invoice_edit'])
+      } : defaultTemplate();
     }
     const docKey = JSON.stringify([key, id]);
     let pending = cache.documents.get(docKey);
@@ -67,7 +71,10 @@ function loadCustomerInvoiceLayout(request, scope) {
         if (!isRecord(doc.data) || !isRecord(doc.data.template_settings)) throw new Error('Invoice Document has no template_settings');
         const settings = (0, _OpenData.normalizeRawInvoiceTemplateSettings)(doc.data.template_settings);
         if (settings.modules.length === 0) throw new Error('Invoice Document has no usable template modules');
-        return (0, _OpenData.normalizeInvoiceLayoutFromTemplateSettings)(settings);
+        return {
+          layout: (0, _OpenData.normalizeInvoiceLayoutFromTemplateSettings)(settings),
+          language: readLanguage(doc.data.template_settings)
+        };
       })().catch(error => fallback(error, target, expectedId));
       cache.documents.set(docKey, pending);
     }
@@ -82,5 +89,36 @@ function fallback(error, target, id) {
     documentId: id,
     message: error instanceof Error ? error.message : 'Template request failed'
   });
-  return (0, _OpenData.getDefaultInvoiceLayoutConfig)();
+  return defaultTemplate();
+}
+
+// Keep the existing layout-only API and its in-flight promise identity intact.
+const layoutPromises = new WeakMap();
+function loadCustomerInvoiceLayout(request, scope) {
+  const template = loadCustomerInvoiceTemplate(request, scope);
+  let layout = layoutPromises.get(template);
+  if (!layout) {
+    layout = template.then(value => value.layout);
+    layoutPromises.set(template, layout);
+  }
+  return layout;
+}
+function defaultTemplate() {
+  return {
+    layout: (0, _OpenData.getDefaultInvoiceLayoutConfig)(),
+    language: {}
+  };
+}
+function readLanguage(value) {
+  let settings = value;
+  if (typeof settings === 'string') {
+    try {
+      settings = JSON.parse(settings);
+    } catch {
+      return {};
+    }
+  }
+  return isRecord(settings) && isRecord(settings.language) ? {
+    ...settings.language
+  } : {};
 }

package/lib/shared/receipt/small-ticket.d.ts

@@ -22,8 +22,13 @@ export interface BuildSmallTicketDataParams {
     shopInfo?: SmallTicketShopInfo | null;
     locales?: string[];
     productMap?: Record<string | number, Record<string, any>>;
+    /** Customer preview only: stable source identities for bilingual rows. */
+    includeReceiptKeys?: boolean;
 }
 export interface SmallTicketItem {
+    receipt_key?: string;
+    receipt_value_kind?: 'shared' | 'text';
+    receipt_item_kind?: 'shared';
     item: string;
     value: string;
     size?: number;
@@ -32,6 +37,8 @@ export interface SmallTicketItem {
     booking_uid?: string | number;
 }
 export interface SmallTicketProduct {
+    receipt_key?: string;
+    receipt_source_index?: number;
     product_title: string;
     product_quantity: number;
     selling_price: string;
@@ -47,6 +54,8 @@ export interface SmallTicketProduct {
     product_note?: string;
     allergy?: string;
     options?: Array<{
+        receipt_key?: string;
+        receipt_source_index?: number;
         name: string;
         num?: number;
         price?: string;