@aptos-scp/scp-component-store-selling-features-domain-model 2.51.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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aptos-scp/scp-component-store-selling-features-domain-model",
-  "version": "2.51.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",