@pisell/pisellos 2.2.314 → 2.2.316

package/lib/solution/BookingTicket/index.js

@@ -39,6 +39,10 @@ var _orderLineDisplay = require("../../modules/BookingContext/utils/orderLineDis
 var _bookingStatus = require("./utils/bookingStatus");
 var _resolveBestAddTimePlan = require("./utils/resolveBestAddTimePlan");
 var _utils = require("../../modules/Order/utils");
+var _contactInfo = require("../../modules/OpenData/contactInfo");
+var _platform = require("../../utils/platform");
+var _lodashEs = require("lodash-es");
+var _types2 = require("../../server/modules/form/types");
 function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }
 const OPEN_DATA_SECTION_CODES = ['sale', 'reservation', 'fulfillment', 'menu', 'workflow', 'documents'];
 const OPEN_DATA_CACHE_TTL = 5 * 60 * 1000;
@@ -162,6 +166,7 @@ class BookingTicketImpl extends _BaseSales.BaseSalesImpl {
   orderCustomerDiscountRefreshCustomerId = null;
   orderCustomerDiscountRefreshTarget = null;
   orderCustomerPromotionRefreshInFlight = null;
+  orderCustomerContactRequest = null;
   customerResolveRequests = new Map();
   loadOpenDataInFlight = null;
   loadOpenDataInFlightTarget = null;
@@ -179,6 +184,16 @@ class BookingTicketImpl extends _BaseSales.BaseSalesImpl {
     return !channel || channel === 'system' ? 'pos' : channel;
   }
 
+  /** 供销售展示层按 booking.resources[].form_id 读取当前多语言表单标题。 */
+  getFormTitleMap() {
+    return this.core?.server?.form?.getTitleMap?.() || {};
+  }
+
+  /** 表单定义由 Ably 更新后通知展示层刷新，不改动订单里的历史 metadata。 */
+  onFormTitlesChanged(callback) {
+    return this.core.effects.on(_types2.FormHooks.onChanged, callback);
+  }
+
   /**
    * 业务侧子模块工厂：BookingTicket 自带的 createBookingTicketModule 优先匹配；
    * 未识别的模块名（如 BookingByStep 公共类型）回退到父类工厂。
@@ -289,6 +304,12 @@ class BookingTicketImpl extends _BaseSales.BaseSalesImpl {
   async getOpenData() {
     return this.loadOpenDataConfig();
   }
+  async loadContactInfoOpenData() {
+    return this.store.openData ? this.getOpenData() : super.loadContactInfoOpenData();
+  }
+  async loadFulfillmentItemRuleOpenData() {
+    return this.store.openData ? this.getOpenData() : super.loadFulfillmentItemRuleOpenData();
+  }
   async getInvoiceLayoutConfig() {
     const openData = await this.loadOpenDataConfig();
     if (!openData) return (0, _OpenData.getDefaultInvoiceLayoutConfig)();
@@ -364,9 +385,10 @@ class BookingTicketImpl extends _BaseSales.BaseSalesImpl {
         config: {
           prefix,
           deviceCode: deviceId,
-          // TODO 现在 picoding 没这个配置的 key
-          padReceiptSequence: false,
+          padReceiptSequence: openDataConfig?.['sale.pad_with_leading_zeros'] === true,
           receiptSequenceLength,
+          receiptSequenceMax: this.normalizeShortNumberMaximum(openDataConfig?.['sale.maximum_number']),
+          randomReceiptSequence: openDataConfig?.['sale.short_number_random'] === true,
           resetReceiptSequenceDaily,
           receiptSequenceResetTime: operatingDayBoundary?.time,
           receiptSequenceStart,
@@ -382,6 +404,17 @@ class BookingTicketImpl extends _BaseSales.BaseSalesImpl {
     if (!Number.isInteger(numeric) || numeric <= 0) return fallback;
     return numeric;
   }
+  normalizeShortNumberMaximum(value) {
+    if (value === undefined || value === null || typeof value === 'string' && !value.trim()) return null;
+    if (typeof value !== 'number' && typeof value !== 'string') {
+      throw new Error('sale.maximum_number 必须是安全正整数或空值');
+    }
+    const numeric = Number(value);
+    if (!Number.isSafeInteger(numeric) || numeric <= 0) {
+      throw new Error('sale.maximum_number 必须是安全正整数或空值');
+    }
+    return numeric;
+  }
   normalizeIdPrefix(value, fallback) {
     if (value === undefined || value === null) return fallback;
     const normalized = String(value).trim().toUpperCase();
@@ -1009,7 +1042,9 @@ class BookingTicketImpl extends _BaseSales.BaseSalesImpl {
    */
   setOrderCustomer(customer, options) {
     if (!customer) {
-      this.clearOrderCustomer();
+      this.clearOrderCustomer({
+        preserveContactInfo: options?.source === 'detailHydrate'
+      });
       return;
     }
     const previousCustomerId = this.store.order.getOrderCustomer()?.customer_id;
@@ -1020,7 +1055,16 @@ class BookingTicketImpl extends _BaseSales.BaseSalesImpl {
       this.discountConfigCacheKey = null;
       this.hasManualDiscountSelection = false;
     }
+    if (!customerUnchanged && options?.source !== 'detailHydrate') {
+      this.resetOrderCustomerContactInfo();
+      this.store.order.updateTempOrderContactsInfo((0, _lodashEs.cloneDeep)((0, _contactInfo.extractCustomerContactInfo)(customer)));
+    }
     this.store.order.setOrderCustomer(patch, customer);
+    if (options?.source === 'detailHydrate') {
+      this.orderCustomerContactRequest = null;
+    } else {
+      this.prefillOrderCustomerContactInfo(customer, !customerUnchanged);
+    }
     const snapshotAfterOrderSet = this.store.order.getOrderCustomerSnapshot();
     if (customerUnchanged) {
       // hydrate 后 customer_id 已存在但 _extend.customerSnapshot 仍为空时，
@@ -1053,6 +1097,105 @@ class BookingTicketImpl extends _BaseSales.BaseSalesImpl {
       this.orderCustomerPromotionRefreshInFlight = null;
     });
   }
+  resetOrderCustomerContactInfo() {
+    this.orderCustomerContactRequest = null;
+    const order = this.getTempOrder();
+    if (order?._extend) delete order._extend.contactInfoEdited;
+  }
+
+  /** Explicit edits, including clearing the contact, must win over a pending default. */
+  updateTempOrderContactsInfo(contact) {
+    const order = this.store.order.ensureTempOrder();
+    order._extend || (order._extend = {});
+    order._extend.contactInfoEdited = true;
+    this.orderCustomerContactRequest = null;
+    return super.updateTempOrderContactsInfo(contact);
+  }
+  getCustomerContactScope() {
+    return JSON.stringify([this.getPickupTimingScope(), this.otherParams?.channel, this.otherParams?.shop_id, this.otherParams?.tenantId]);
+  }
+  getCustomerContactOrderKey() {
+    const order = this.getTempOrder();
+    // Cart mutations can replace the object without changing the order.
+    const identity = order?.external_sale_number || order?.request_unique_idempotency_token || order?._extend?.localId || order?.order_id;
+    return identity ? JSON.stringify([identity, order?.order_id]) : order;
+  }
+  async replaceTempOrder(...args) {
+    this.orderCustomerContactRequest = null;
+    return super.replaceTempOrder(...args);
+  }
+  async applyDefaultOrderCustomerContactInfo(contact) {
+    this.store.order.updateTempOrderContactsInfo((0, _lodashEs.cloneDeep)(contact));
+    // Metadata may finish after promotion/discount refresh; publish the updated cart explicitly.
+    await this.effectsEmit('onTempOrderReplaced', {
+      tempOrder: this.getTempOrder()
+    });
+  }
+  prefillOrderCustomerContactInfo(customer, customerChanged) {
+    const order = this.getTempOrder();
+    const customerId = Number(order?.customer_id);
+    if (!order || !Number.isInteger(customerId) || customerId <= 1 || order.contacts_info != null || order._extend?.contactInfoEdited) return;
+    // A restored new cart may already have its customer ID. Existing sales keep their snapshot,
+    // even when it is empty; only an explicit customer switch replaces it.
+    if (!customerChanged && order.order_id && !String(order.order_id).startsWith('local_order')) return;
+    const contact = (0, _contactInfo.extractCustomerContactInfo)(customer);
+    if (contact) {
+      this.orderCustomerContactRequest = null;
+      void this.applyDefaultOrderCustomerContactInfo(contact);
+      return;
+    }
+    // A relation explicitly returned as null is authoritative. Only a missing relation needs fetching.
+    if (customer.contacts_info !== undefined) return;
+    const userPlatform = (0, _platform.isCustomerUserPlatform)(this.otherParams?.platform);
+    const getAuthenticatedCustomerId = () => Number(this.core?.getPlugin?.('user')?.get?.()?.id);
+    if (userPlatform && getAuthenticatedCustomerId() !== customerId) return;
+    const scope = this.getCustomerContactScope();
+    const orderKey = this.getCustomerContactOrderKey();
+    const previous = this.orderCustomerContactRequest;
+    if (previous?.orderKey === orderKey && previous.customerId === customerId && previous.scope === scope) return;
+    const pending = {
+      orderKey,
+      customerId,
+      scope,
+      promise: Promise.resolve()
+    };
+    this.orderCustomerContactRequest = pending;
+    const loadContact = async () => {
+      if (userPlatform) {
+        // Same endpoint as BookingByStep.getContactInfo; the PC/H5 host adds /h5 and login headers.
+        const result = await this.request.get('/customer/metadata', {
+          key: 'contacts_info'
+        });
+        if (result?.code !== 200 || result?.status === false) throw new Error('Customer contact lookup failed');
+        return (0, _contactInfo.isContactRecord)(result.data) ? result.data : null;
+      }
+      // POS and physical Kiosk share the /shop request plugin and current-shop customer resolver.
+      const resolved = await this.resolveCustomerById(customerId);
+      return Number(resolved?.id) === customerId ? (0, _contactInfo.extractCustomerContactInfo)(resolved) : null;
+    };
+    pending.promise = loadContact().then(async value => {
+      const current = this.getTempOrder();
+      if (this.orderCustomerContactRequest !== pending || this.getCustomerContactOrderKey() !== orderKey || Number(current?.customer_id) !== customerId || scope !== this.getCustomerContactScope() || current?._extend?.contactInfoEdited || current?.contacts_info != null || userPlatform && getAuthenticatedCustomerId() !== customerId) return;
+      if (value) await this.applyDefaultOrderCustomerContactInfo(value);
+    }).catch(() => {
+      // A failed default does not prevent manual entry; a subsequent sync can retry.
+      if (this.orderCustomerContactRequest === pending) this.orderCustomerContactRequest = null;
+      console.warn('[BookingTicket] Failed to load saved customer contact information');
+    });
+  }
+  waitForOrderCustomerContactInfo() {
+    return this.orderCustomerContactRequest?.promise ?? Promise.resolve();
+  }
+  async validateContactInfo() {
+    const orderKey = this.getCustomerContactOrderKey();
+    const customerId = this.getTempOrder()?.customer_id;
+    const scope = this.getCustomerContactScope();
+    await this.waitForOrderCustomerContactInfo();
+    if (this.getCustomerContactOrderKey() !== orderKey || this.getTempOrder()?.customer_id !== customerId || this.getCustomerContactScope() !== scope) {
+      throw new Error('The order changed. Please try again.');
+    }
+    await super.validateContactInfo();
+  }
 
   /**
    * 读取 tempOrder 上的下单客户协议字段；customer_id 缺失时返回 null。
@@ -1071,7 +1214,10 @@ class BookingTicketImpl extends _BaseSales.BaseSalesImpl {
   /**
    * 清空下单客户（协议字段 + snapshot）。
    */
-  clearOrderCustomer() {
+  clearOrderCustomer(options) {
+    this.orderCustomerContactRequest = null;
+    if (!options?.preserveContactInfo) this.resetOrderCustomerContactInfo();
+    if (!options?.preserveContactInfo) this.store.order.updateTempOrderContactsInfo(null);
     this.store.order.clearOrderCustomer();
     this.discountConfigCacheKey = null;
     this.hasManualDiscountSelection = false;
@@ -1641,7 +1787,10 @@ class BookingTicketImpl extends _BaseSales.BaseSalesImpl {
    * 从已加车的普通商品 order line 反查 SkuDetailModal edit 所需的 cacheItem。
    */
   buildNormalProductCacheItemFromOrderLine(input) {
-    return (0, _buildNormalProductCacheItemFromOrderLine.buildNormalProductCacheItemFromOrderLine)(input);
+    return (0, _buildNormalProductCacheItemFromOrderLine.buildNormalProductCacheItemFromOrderLine)({
+      ...input,
+      holder_relations: input.holder_relations ?? this.store.order?.getTempOrder()?.holder_relations
+    });
   }
 
   /** 文档别名：与 OrderModule.updateOrderProduct 一致。 */
@@ -1672,6 +1821,30 @@ class BookingTicketImpl extends _BaseSales.BaseSalesImpl {
       };
     }
     try {
+      // Capture before lookup/UI awaits, so a result cannot land in a new cart.
+      // Unscoped POS Order modules return a no-op guard.
+      const beforeScanCommit = this.store.order.createCartIntentCommitGuard('add_product');
+      const beforeScanDialog = this.store.order.createCartIntentCommitGuard('add_product');
+      const guardCallback = callback => callback ? (...args) => {
+        beforeScanCommit();
+        return callback(...args);
+      } : undefined;
+      const guardedBridge = bridge ? {
+        ...bridge,
+        confirmDetail: guardCallback(bridge.confirmDetail),
+        confirmBookingEdit: guardCallback(bridge.confirmBookingEdit),
+        applyPromotionCode: guardCallback(bridge.applyPromotionCode),
+        openOrder: guardCallback(bridge.openOrder),
+        requestCustomerSwitch: guardCallback(bridge.requestCustomerSwitch),
+        openProductDetail: bridge.openProductDetail ? payload => {
+          beforeScanDialog();
+          return bridge.openProductDetail(payload);
+        } : undefined,
+        openBookingEdit: bridge.openBookingEdit ? payload => {
+          beforeScanDialog();
+          return bridge.openBookingEdit(payload);
+        } : undefined
+      } : undefined;
       const localSearch = v => this.store.products.findProductsByCodeOrBarcode(v);
       const scanCallback = (0, _handleScan.handleGlobalScan)(this.request, localSearch, this.getSubmitOrderSalesChannel());
       const raw = await scanCallback({
@@ -1687,7 +1860,10 @@ class BookingTicketImpl extends _BaseSales.BaseSalesImpl {
         };
       }
       const result = await (0, _applyGlobalScan.applyGlobalScan)({
-        setOrderCustomer: customer => this.setOrderCustomer(customer),
+        setOrderCustomer: customer => {
+          beforeScanCommit();
+          this.setOrderCustomer(customer);
+        },
         getOrderCustomerSnapshot: () => this.getOrderCustomerSnapshot(),
         resolveCustomerById: customerId => this.resolveCustomerById(customerId),
         getBusinessCode: () => this.otherParams?.businessCode,
@@ -1695,10 +1871,16 @@ class BookingTicketImpl extends _BaseSales.BaseSalesImpl {
         decideAddProduct: (item, options) => this.decideAddProduct(item, options),
         decideAfterDetail: (cacheItem, options) => this.decideAfterDetail(cacheItem, options),
         transformDetailToProductAndBooking: input => this.transformDetailToProductAndBooking(input),
-        addProductToOrder: (product, booking) => this.addProductToOrder(product, booking),
+        addProductToOrder: (product, booking) => {
+          beforeScanCommit();
+          return this.addProductToOrder(product, booking);
+        },
         refreshWalletAssets: params => this.refreshWalletAssets(params),
-        scanWalletAsset: scanCode => this.scanWalletAsset(scanCode)
-      }, formatted, bridge);
+        scanWalletAsset: scanCode => {
+          beforeScanCommit();
+          return this.scanWalletAsset(scanCode);
+        }
+      }, formatted, guardedBridge);
       bridge?.refresh?.();
       return result;
     } catch (error) {
@@ -1841,6 +2023,11 @@ class BookingTicketImpl extends _BaseSales.BaseSalesImpl {
   async setOtherParams(params, {
     cover = false
   } = {}) {
+    const nextParams = cover ? params : {
+      ...this.otherParams,
+      ...params
+    };
+    if (['businessCode', 'business_code', 'channel', 'platform', 'shop_id', 'tenantId', 'cacheId'].some(key => nextParams?.[key] !== this.otherParams?.[key])) this.orderCustomerContactRequest = null;
     await super.setOtherParams(params, {
       cover
     });
@@ -1956,6 +2143,7 @@ class BookingTicketImpl extends _BaseSales.BaseSalesImpl {
    * 再清理 BookingTicket 自有资源（scan 监听 + scan 内存缓存）。
    */
   async destroy() {
+    this.orderCustomerContactRequest = null;
     await super.destroy();
     try {
       this.scan?.removeAllListeners();

package/lib/solution/BookingTicket/utils/addProductDecision.d.ts

@@ -65,7 +65,6 @@ export interface AddProductDecideContext extends BookingCalcContext {
     type?: 'select' | 'detail';
     quantity?: number;
     customerId?: number | string;
-    channel?: string;
 }
 /**
  * 统一补齐预约商品的运行态字段。

package/lib/solution/BookingTicket/utils/addProductDecision.js

@@ -146,7 +146,7 @@ function isMultiDayLike(cacheItem) {
  * `_extend.resource / capacity / startDate / endDate` 等后续 booking mapper 需要的字段。
  */
 function prepareBookingCacheItem(cacheItem, ctx) {
-  if (isNormalBookingProduct(cacheItem) || hasPreparedBookingExtend(cacheItem)) {
+  if (ctx?.rememberedTime === undefined && (isNormalBookingProduct(cacheItem) || hasPreparedBookingExtend(cacheItem))) {
     return cacheItem;
   }
   return (0, _BookingContext.getProductExtend)({

package/lib/solution/BookingTicket/utils/cartView.js

@@ -8,12 +8,14 @@ exports.buildCustomerView = buildCustomerView;
 exports.indexBookingsByProductUid = indexBookingsByProductUid;
 exports.isWalkInCustomer = isWalkInCustomer;
 var _addTimeAvailability = require("./addTimeAvailability");
+var _pickupTiming = require("../../../modules/Order/pickupTiming");
 /**
  * 仅按 booking.product_uid 建索引，避免发明 booking 与商品行之间的其它等价关系。
  */
 function indexBookingsByProductUid(bookings) {
   if (!Array.isArray(bookings) || bookings.length === 0) return {};
   return bookings.reduce((acc, booking) => {
+    if ((0, _pickupTiming.isFulfillmentTimingBooking)(booking)) return acc;
     const uid = booking?.product_uid;
     if (uid === undefined || uid === null || uid === '') return acc;
     const key = String(uid);
@@ -105,7 +107,7 @@ function isGiftProductLine(line) {
 function buildCartView(lines, bookings, options = {}) {
   const productLines = Array.isArray(lines) ? lines : [];
   const bookingList = Array.isArray(bookings) ? bookings : [];
-  const childBookings = bookingList.filter(booking => booking.parent_id !== 0);
+  const childBookings = bookingList.filter(booking => booking.parent_id !== 0 && !(0, _pickupTiming.isFulfillmentTimingBooking)(booking));
   const bookingsByProductUid = indexBookingsByProductUid(childBookings);
   const linesByUid = indexProductsByUid(productLines);
   const addTimeLinesByBookingUid = indexAddTimeProductsByBookingUid(productLines);

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

@@ -0,0 +1,66 @@
+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 {
+    orderId: string | number;
+    tenantId: string | number;
+    shopId: string | number;
+    /** Changes on login/logout, without exposing credentials in state or cache keys. */
+    identity: string;
+    businessCode: string;
+    channel: string;
+    locale: string;
+    sourceRevision: string;
+    shop?: Record<string, any>;
+}
+export interface OrderInvoicePreviewResult {
+    identity: string;
+    sourceRevision: string;
+    generatedAt: string;
+    locale: string;
+    secondaryLocale?: string;
+    languageOptions: CustomerInvoiceLanguageOption[];
+    selectedLanguage: CustomerInvoiceLanguageCode;
+    orderId: string | number;
+    source: Record<string, any>;
+    shop: Record<string, any>;
+    layout: InvoiceLayoutConfig;
+    smallTicketData: SmallTicketData;
+}
+export interface OrderInvoicePreviewState {
+    status: 'idle' | 'loading' | 'ready' | 'error';
+    result: OrderInvoicePreviewResult | null;
+    error: string | null;
+}
+/** Read-only, page-owned solution. No Order, Schedule, quotation or payment modules. */
+export declare class OrderInvoicePreviewImpl extends BaseModule implements Module {
+    isSolution: boolean;
+    private request;
+    private state;
+    private listeners;
+    private generation;
+    private disposed;
+    private input?;
+    private activeKey;
+    private languageSelection?;
+    private pending?;
+    private snapshotCache;
+    constructor(name?: string);
+    initialize(core: PisellCore, _options: ModuleOptions): void;
+    getState: () => OrderInvoicePreviewState;
+    subscribe: (listener: () => void) => (() => void);
+    private publish;
+    private getScope;
+    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/lib/solution/OrderInvoicePreview/index.js

@@ -0,0 +1,246 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.OrderInvoicePreviewImpl = void 0;
+var _BaseModule = require("../../modules/BaseModule");
+var _loadCustomerInvoiceLayout = require("../../shared/receipt/loadCustomerInvoiceLayout");
+var _customerInvoiceLanguages = require("../../shared/receipt/customerInvoiceLanguages");
+var _smallTicket = require("../../shared/receipt/small-ticket");
+var _loadSalesOrderSnapshot = require("../../shared/sales/loadSalesOrderSnapshot");
+var _loadPaymentMethods = require("../../shared/payment/loadPaymentMethods");
+// Page-runtime cache shared by preview instances, scoped to host, shop and identity.
+const contextCaches = new WeakMap();
+/** Read-only, page-owned solution. No Order, Schedule, quotation or payment modules. */
+class OrderInvoicePreviewImpl extends _BaseModule.BaseModule {
+  isSolution = true;
+  request;
+  state = {
+    status: 'idle',
+    result: null,
+    error: null
+  };
+  listeners = new Set();
+  generation = 0;
+  disposed = false;
+  input;
+  activeKey = '';
+  // Hosts retain this readonly instance while the same order modal is closed.
+  languageSelection;
+  pending;
+  snapshotCache = new Map();
+  constructor(name = 'orderInvoicePreview') {
+    super(name);
+  }
+  initialize(core, _options) {
+    this.core = core;
+    const request = core.getPlugin('request');
+    if (!request) throw new Error('OrderInvoicePreview requires request plugin');
+    this.request = request;
+  }
+  getState = () => this.state;
+  subscribe = listener => {
+    this.listeners.add(listener);
+    return () => {
+      this.listeners.delete(listener);
+    };
+  };
+  publish(state) {
+    this.state = state;
+    this.listeners.forEach(listener => listener());
+  }
+  getScope(input) {
+    return JSON.stringify([input.tenantId, input.shopId, input.identity, input.businessCode, input.channel]);
+  }
+  loadContext(input) {
+    let cache = contextCaches.get(this.request);
+    if (!cache) {
+      cache = new Map();
+      contextCaches.set(this.request, cache);
+    }
+    const key = JSON.stringify([input.tenantId, input.shopId, input.identity]);
+    const cached = cache.get(key);
+    if (cached) return cached;
+    const task = Promise.all([this.request.get('/shop/show', {}, {
+      manualErrorHandling: true,
+      skipErrorHandler: true
+    }), (0, _loadPaymentMethods.loadPaymentMethods)(this.request, {
+      transport: 'remote',
+      filterPaymentMethods: false
+    })]).then(([response, methods]) => {
+      const shop = response?.data;
+      if (!shop || typeof shop !== 'object' || Array.isArray(shop)) throw new Error('Invoice shop information is unavailable');
+      if (String(shop.id) !== String(input.shopId)) throw new Error('Invoice shop identity mismatch');
+      return {
+        shop,
+        methods
+      };
+    }).catch(error => {
+      if (cache.get(key) === task) cache.delete(key);
+      throw error;
+    });
+    cache.set(key, task);
+    return task;
+  }
+  loadSource(input) {
+    const key = JSON.stringify([this.getScope(input), input.orderId, input.sourceRevision]);
+    const cached = this.snapshotCache.get(key);
+    if (cached) return cached;
+    const task = (0, _loadSalesOrderSnapshot.loadSalesOrderSnapshot)(this.request, {
+      lookup: input.orderId,
+      transport: 'remote'
+    }).then(response => {
+      if (response?.code !== 200 || !response.data || typeof response.data !== 'object' || Array.isArray(response.data)) {
+        throw new Error(response?.message || 'Invoice order is unavailable');
+      }
+      const source = response.data;
+      if (source.order_id != null && String(source.order_id) !== String(input.orderId)) {
+        throw new Error('Invoice order identity mismatch');
+      }
+      return source;
+    }).catch(error => {
+      if (this.snapshotCache.get(key) === task) this.snapshotCache.delete(key);
+      throw error;
+    });
+    this.snapshotCache.set(key, task);
+    return task;
+  }
+  prepare(input) {
+    if (this.disposed) return Promise.reject(new Error('Invoice preview disposed'));
+    const currentShop = this.core.getPlugin('app')?.getData?.()?.('shop_id');
+    if (currentShop != null && String(currentShop) !== String(input.shopId)) {
+      return Promise.reject(new Error('Invoice shop changed'));
+    }
+    const key = JSON.stringify([this.getScope(input), input.orderId, input.sourceRevision, input.locale]);
+    if (key === this.activeKey) {
+      if (this.pending) return this.pending;
+      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.languageSelection?.scope !== this.getSelectionScope(input)) this.languageSelection = undefined;
+    this.input = input;
+    this.activeKey = key;
+    const generation = ++this.generation;
+    this.publish({
+      status: 'loading',
+      result: null,
+      error: null
+    });
+    const task = (async () => {
+      const [snapshot, context, template] = await Promise.all([this.loadSource(input), this.loadContext(input), (0, _loadCustomerInvoiceLayout.loadCustomerInvoiceTemplate)(this.request, input)]);
+      const source = (0, _loadPaymentMethods.withPaymentMethodNames)(snapshot, context.methods);
+      const getData = this.core.getPlugin('app')?.getData?.();
+      if (getData?.('shop_id') != null && String(getData('shop_id')) !== String(input.shopId)) throw new Error('Invoice shop changed');
+      const coreData = getData?.('core');
+      const shop = {
+        ...(coreData?.core?.shop || coreData?.shop || {}),
+        ...(getData?.('shop_info') || {}),
+        ...input.shop,
+        ...context.shop,
+        ...(getData?.('tax_country_code') ? {
+          tax_country_code: getData('tax_country_code')
+        } : {})
+      };
+      if (generation !== this.generation || this.disposed) throw new Error('Invoice request superseded');
+      const languageOptions = (0, _customerInvoiceLanguages.resolveCustomerInvoiceLanguages)(template.language, input.locale);
+      const remembered = this.languageSelection?.code;
+      const selected = languageOptions.find(option => option.code === remembered) || languageOptions[0];
+      const locale = selected.locales[0];
+      const result = {
+        identity: this.documentIdentity(key, selected.code),
+        languageOptions,
+        selectedLanguage: selected.code,
+        ...(selected.locales[1] ? {
+          secondaryLocale: selected.locales[1]
+        } : {}),
+        orderId: input.orderId,
+        sourceRevision: input.sourceRevision,
+        generatedAt: new Date().toISOString(),
+        locale,
+        source,
+        shop,
+        layout: template.layout,
+        smallTicketData: (0, _smallTicket.buildSmallTicketData)({
+          order: source,
+          shopInfo: shop,
+          locales: [...new Set(languageOptions.flatMap(option => option.locales))],
+          includeReceiptKeys: true,
+          templateSettings: template.layout
+        })
+      };
+      this.publish({
+        status: 'ready',
+        result,
+        error: null
+      });
+      return result;
+    })().catch(error => {
+      if (generation === this.generation && !this.disposed) {
+        this.publish({
+          status: 'error',
+          result: null,
+          error: error instanceof Error ? error.message : String(error)
+        });
+      }
+      throw error;
+    }).finally(() => {
+      if (this.pending === task) this.pending = undefined;
+    });
+    this.pending = task;
+    return task;
+  }
+  getSelectionScope(input) {
+    return JSON.stringify([this.getScope(input), input.orderId]);
+  }
+  documentIdentity(key, language) {
+    return JSON.stringify([key, language]);
+  }
+
+  /** Switch only the ready receipt projection; no fetching or rebuilding data. */
+  selectLanguage(code) {
+    if (this.disposed) throw new Error('Invoice preview disposed');
+    const current = this.state.result;
+    if (this.state.status !== 'ready' || !current || !this.input) throw new Error('Invoice preview is not ready');
+    const currentShop = this.core.getPlugin('app')?.getData?.()?.('shop_id');
+    if (currentShop != null && String(currentShop) !== String(this.input.shopId)) throw new Error('Invoice shop changed');
+    const selected = current.languageOptions.find(option => 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;
+    const {
+      secondaryLocale: _previousSecondary,
+      ...rest
+    } = current;
+    const result = {
+      ...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,
+      error: null
+    });
+    return result;
+  }
+  retry() {
+    if (!this.input) return Promise.reject(new Error('Invoice input is missing'));
+    return this.prepare(this.input);
+  }
+  destroy() {
+    this.disposed = true;
+    this.generation++;
+    this.listeners.clear();
+    this.snapshotCache.clear();
+    if (this.core.getModule(this.name) === this) super.destroy();
+  }
+}
+exports.OrderInvoicePreviewImpl = OrderInvoicePreviewImpl;