@aptos-scp/scp-component-store-selling-features-domain-model 2.50.0 → 3.0.0

package/lib/config/CoreStateModel.js

@@ -381,6 +381,58 @@ const coreStateModel = {
             ],
             uiBusinessEvents: [],
         },
+        {
+            /**
+             * State-agnostic catch-all for any TerminalControlTransaction
+             * in ctx. PEPS calls findLogicalStateName on every UI business event; if
+             * no matcher returns a name it throws SSC_PEPS_CANNOT_FIND_STATE_FOR_CONTEXT_ERROR_CODE
+             * which becomes UI_MODE_FATAL_ERROR -> FatalErrorScreen.
+             *
+             * During fresh-install boot DB sync, a redundant TerminalStateSync flow can leave
+             * a closed TerminalControlTransaction in ctx.transaction while a late
+             * LookupExchangeRatesEvent is still being processed. At the throw moment we
+             * captured: state="Closed", isOpen()=false, isWaitingToClose()=false,
+             * isClosing()=false, isClosed()=true. UserSession is also LoggedOff (pre-login).
+             *
+             * Unlike IN_TILL_CONTROL_TRANSACTION (which is a post-login operational state
+             * requiring loggedOn=true + isOpen=true), this matcher is purely a fallback to
+             * keep PEPS off the fatal path. fieldMatchers like isOpen=true or loggedOn=true
+             * would miss the actual race window. fieldMatchers:[] makes the matcher match
+             * any state of a TerminalControlTransaction in ctx.
+             *
+             * Pairs with a same IN_TERMINAL_CONTROL_TRANSACTION UIBE registration in scp-component-store-selling-features-user-employee
+             * that add AUTO_LOG_OFF_OR_LOCK_EVENT + LOCK_USER_SESSION_EVENT to satisfy the
+             * engine's "every logical state has at least one event" rule.
+             */
+            logicalName: exports.IN_TERMINAL_CONTROL_TRANSACTION,
+            stateMatchers: [
+                {
+                    matcherType: scp_component_store_selling_core_1.StateMatcherDefinitionType.Transaction,
+                    transactionType: domain_1.TERMINAL_CONTROL_TRANSACTION_TYPE,
+                    fieldMatchers: [],
+                },
+            ],
+            uiBusinessEvents: [],
+        },
+        {
+            /**
+             * NOTE: this is kept as a no-op alias for the WAITING_TO_CLOSE name. The matcher
+             * above already wins because both share the same transactionType-only predicate
+             * (first match wins in findLogicalStateName). This entry exists so the constant
+             * IN_TERMINAL_CONTROL_TRANSACTION_WAITING_TO_CLOSE (apparently defined for symmetry
+             * with the IN_TILL family) still resolves to *some* matcher should a downstream
+             * dependency reference it; otherwise it would be unreachable.
+             */
+            logicalName: exports.IN_TERMINAL_CONTROL_TRANSACTION_WAITING_TO_CLOSE,
+            stateMatchers: [
+                {
+                    matcherType: scp_component_store_selling_core_1.StateMatcherDefinitionType.Transaction,
+                    transactionType: domain_1.TERMINAL_CONTROL_TRANSACTION_TYPE,
+                    fieldMatchers: [],
+                },
+            ],
+            uiBusinessEvents: [],
+        },
         {
             logicalName: exports.IN_FISCAL_CONTROL_TRANSACTION,
             stateMatchers: [

package/lib/domain/model/ReprintReceiptTransaction.d.ts

@@ -1,6 +1,7 @@
 import { DeviceIdentity, ITransaction, ITransactionLineFactory, IUser } from "@aptos-scp/scp-component-store-selling-core";
 import { IFiscalSignature } from "@aptos-scp/scp-types-commerce-transaction";
 import { IFiscalTransactionNumberMaintainer } from "./IFiscalTransactionNumberMaintainer";
+import { ICountryBoxFiscalError } from "./MerchandiseTransaction";
 import { RetailTransaction } from "./RetailTransaction";
 import { IInvoiceOperation } from "./IInvoiceOperation";
 import { Customer } from "./Customer";
@@ -18,10 +19,13 @@ export declare class ReprintReceiptTransaction extends RetailTransaction impleme
     private _invoiceFiscalTransactionNumber?;
     private _invoiceTransactionNumber?;
     private _accountingCurrency?;
+    private _countryBoxFiscalError?;
     static createFromJsonObj(transactionJsonObj: any, transactionLineFactory: ITransactionLineFactory): ReprintReceiptTransaction;
     constructor(deviceIdentity: DeviceIdentity, businessDayDate: string, transactionNumber: number, user?: IUser, transactionId?: string, invoiceNumber?: string, invoiceSequenceNumber?: number, invoiceSequenceNumberGenerator?: string, fiscalSignature?: IFiscalSignature, customer?: Customer, accountingCurrency?: string);
     clone(): ITransaction;
     get transactionStateValues(): Readonly<Map<string, any>>;
+    get countryBoxFiscalError(): ICountryBoxFiscalError;
+    setCountryBoxFiscalError(countryBoxFiscalError: ICountryBoxFiscalError): ITransaction;
     get invoiceNumber(): string;
     get invoiceSequenceNumber(): number;
     get invoiceSequenceNumberGenerator(): string;

package/lib/domain/model/ReprintReceiptTransaction.js

@@ -14,6 +14,7 @@ class ReprintReceiptTransaction extends RetailTransaction_1.RetailTransaction {
         this._fiscalSignature = fiscalSignature;
         this._customer = customer;
         this._accountingCurrency = accountingCurrency;
+        this._countryBoxFiscalError = undefined;
     }
     static createFromJsonObj(transactionJsonObj, transactionLineFactory) {
         const transactionId = RetailTransaction_1.RetailTransaction.getTransactionIdFromJsonObject(transactionJsonObj);
@@ -66,7 +67,21 @@ class ReprintReceiptTransaction extends RetailTransaction_1.RetailTransaction {
         return transaction;
     }
     get transactionStateValues() {
-        return super.transactionStateValues;
+        if (!this._countryBoxFiscalError) {
+            return super.transactionStateValues;
+        }
+        return new Map([
+            ...super.transactionStateValues.entries(),
+            ["transaction.countryBoxFiscalError", this._countryBoxFiscalError],
+        ]);
+    }
+    get countryBoxFiscalError() {
+        return this._countryBoxFiscalError;
+    }
+    setCountryBoxFiscalError(countryBoxFiscalError) {
+        const newTransaction = this.clone();
+        newTransaction._countryBoxFiscalError = countryBoxFiscalError;
+        return newTransaction;
     }
     get invoiceNumber() {
         return this._invoiceNumber;
@@ -169,6 +184,7 @@ class ReprintReceiptTransaction extends RetailTransaction_1.RetailTransaction {
         this._invoiceFiscalTransactionNumber = transactionJsonObj._invoiceFiscalTransactionNumber;
         this._invoiceTransactionNumber = transactionJsonObj._invoiceTransactionNumber;
         this._accountingCurrency = transactionJsonObj._accountingCurrency;
+        this._countryBoxFiscalError = transactionJsonObj._countryBoxFiscalError;
     }
 }
 exports.ReprintReceiptTransaction = ReprintReceiptTransaction;

package/lib/domain/model/RetailTransaction.js

@@ -112,6 +112,9 @@ class RetailTransaction {
         transaction._taxFreeCreditNoteNumber = this._taxFreeCreditNoteNumber;
         transaction._taxFreeCreditNoteSequenceNumber = this._taxFreeCreditNoteSequenceNumber;
         transaction._taxFreeCreditNoteSequenceNumberGenerator = this._taxFreeCreditNoteSequenceNumberGenerator;
+        if ("_countryBoxFiscalError" in this) {
+            transaction._countryBoxFiscalError = this._countryBoxFiscalError;
+        }
         return transaction;
     }
     setTransactionProperty(propertyName, propertyValue) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aptos-scp/scp-component-store-selling-features-domain-model",
-  "version": "2.50.0",
+  "version": "3.0.0",
   "description": "This component library provides the common components to handle the coordination of processing the business events from the UI.",
   "private": false,
   "license": "SEE LICENSE IN LICENSE.md",