@metamask-previews/bridge-status-controller 73.1.0-preview-e12e4a38f → 74.0.0-preview-4f9d41d

package/dist/quote-status-manager/constants.cjs

@@ -0,0 +1,181 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QuoteStatusFetchWithRetryOutcomeType = exports.AllowedQuoteStatusStateTransitions = exports.QuoteStatusStateToBackendStatus = exports.QuoteStatusState = exports.QuoteStatusUpdateRetryableBackendTypes = exports.QuoteStatusUpdateBackendOnChainMismatchTypes = exports.QuoteStatusBackendValues = exports.BaseQuoteStatusUpdateErrorTypes = exports.QuoteStatusUpdateBackendErrorType = exports.QuoteStatusBackendStatus = exports.QUOTE_STATUS_UPDATE_ENTRY_TTL = exports.QUOTE_STATUS_UPDATE_RETRY_INTERVAL_MS = void 0;
+/**
+ * How often the manager re-processes entries that have not yet reached a
+ * terminal state (`Completed`/`Expired`).
+ *
+ * Drives the periodic retry timer in `QuoteStatusUpdateManager`: on each tick
+ * every non-terminal entry is re-sent to the backend until it is accepted or
+ * evicted. The timer only runs while there is outstanding work.
+ */
+exports.QUOTE_STATUS_UPDATE_RETRY_INTERVAL_MS = 30 * 60 * 1000; // 30 minutes
+/**
+ * Maximum lifetime of a tracked quote-status entry, measured from when it was
+ * created.
+ *
+ * Once an entry is older than this it is considered `Expired`, evicted from the
+ * store on the next read, and never retried again. This bounds how long the
+ * manager keeps trying to report a status that the backend may never accept.
+ */
+exports.QUOTE_STATUS_UPDATE_ENTRY_TTL = 12 * 60 * 60 * 1000; // 12 hours
+/**
+ * Quote lifecycle statuses as understood by the backend `quote/updateStatus`
+ * API. These are the values sent over the wire (and echoed back in error
+ * responses).
+ */
+var QuoteStatusBackendStatus;
+(function (QuoteStatusBackendStatus) {
+    /**
+     * Quote was served to the client. Unused locally, kept for parity with the backend enum.
+     */
+    QuoteStatusBackendStatus["Served"] = "SERVED";
+    /**
+     * User has submitted the source transaction.
+     */
+    QuoteStatusBackendStatus["Submitted"] = "SUBMITTED";
+    /**
+     * Transaction finalized successfully on-chain.
+     */
+    QuoteStatusBackendStatus["FinalizedSuccess"] = "FINALIZED_SUCCESS";
+    /**
+     * Transaction failed or reverted on-chain.
+     */
+    QuoteStatusBackendStatus["FinalizedFailed"] = "FINALIZED_FAILED";
+})(QuoteStatusBackendStatus || (exports.QuoteStatusBackendStatus = QuoteStatusBackendStatus = {}));
+/**
+ * Machine-readable error `type` values returned by the backend
+ * `quote/updateStatus` API on non-2xx responses. The comments record the HTTP
+ * status the backend pairs with each type.
+ */
+var QuoteStatusUpdateBackendErrorType;
+(function (QuoteStatusUpdateBackendErrorType) {
+    QuoteStatusUpdateBackendErrorType["QuoteNotFound"] = "QUOTE_NOT_FOUND";
+    QuoteStatusUpdateBackendErrorType["ConcurrentUpdate"] = "CONCURRENT_UPDATE";
+    QuoteStatusUpdateBackendErrorType["InvalidStatusTransaction"] = "INVALID_STATUS_TRANSITION";
+    QuoteStatusUpdateBackendErrorType["SrcTxHashRequiredForFinalized"] = "SRC_TX_HASH_REQUIRED_FOR_FINALIZED";
+    QuoteStatusUpdateBackendErrorType["PersistQuoteStatusFailed"] = "PERSIST_QUOTE_STATUS_FAILED";
+    QuoteStatusUpdateBackendErrorType["TransactionNotIndexed"] = "TRANSACTION_NOT_INDEXED";
+    QuoteStatusUpdateBackendErrorType["TxDataMissingHash"] = "TX_DATA_MISSING_HASH";
+    QuoteStatusUpdateBackendErrorType["TxDataMissingTrade"] = "TX_DATA_MISSING_TRADE";
+    /**
+     * On-chain tx payload does not match the served quote (EVM calldata, SVM message, TVM raw_data_hex).
+     */
+    QuoteStatusUpdateBackendErrorType["TxDataMismatch"] = "TX_DATA_MISMATCH";
+    QuoteStatusUpdateBackendErrorType["SvmTradeDeserializeFailed"] = "SVM_TRADE_DESERIALIZE_FAILED";
+    /**
+     * Requested lifecycle status is inconsistent with observed on-chain tx status.
+     */
+    QuoteStatusUpdateBackendErrorType["QuoteStatusOnChainMismatch"] = "QUOTE_STATUS_ONCHAIN_MISMATCH";
+})(QuoteStatusUpdateBackendErrorType || (exports.QuoteStatusUpdateBackendErrorType = QuoteStatusUpdateBackendErrorType = {}));
+/**
+ * Error types whose response payload carries no `currentStatus`. Used by the
+ * response validator to define the base (non-mismatch) error response schema.
+ */
+exports.BaseQuoteStatusUpdateErrorTypes = [
+    QuoteStatusUpdateBackendErrorType.QuoteNotFound,
+    QuoteStatusUpdateBackendErrorType.ConcurrentUpdate,
+    QuoteStatusUpdateBackendErrorType.SrcTxHashRequiredForFinalized,
+    QuoteStatusUpdateBackendErrorType.PersistQuoteStatusFailed,
+    QuoteStatusUpdateBackendErrorType.TransactionNotIndexed,
+    QuoteStatusUpdateBackendErrorType.TxDataMissingHash,
+    QuoteStatusUpdateBackendErrorType.TxDataMissingTrade,
+    QuoteStatusUpdateBackendErrorType.TxDataMismatch,
+    QuoteStatusUpdateBackendErrorType.SvmTradeDeserializeFailed,
+];
+/**
+ * The full set of valid backend status values. Used by the response validator
+ * to constrain the `currentStatus`/`newStatus` fields of error responses.
+ */
+exports.QuoteStatusBackendValues = [
+    QuoteStatusBackendStatus.Served,
+    QuoteStatusBackendStatus.Submitted,
+    QuoteStatusBackendStatus.FinalizedSuccess,
+    QuoteStatusBackendStatus.FinalizedFailed,
+];
+/**
+ * Error types whose response payload includes a `currentStatus` describing the
+ * backend's observed status. Used by the validator for the mismatch response
+ * schema and by the manager to reconcile local state with the backend.
+ */
+exports.QuoteStatusUpdateBackendOnChainMismatchTypes = [
+    QuoteStatusUpdateBackendErrorType.InvalidStatusTransaction,
+    QuoteStatusUpdateBackendErrorType.QuoteStatusOnChainMismatch,
+];
+/**
+ * Error types that represent transient backend conditions. A response with one
+ * of these types is retried by `updateQuoteStatusWithRetry`; any other error
+ * type is treated as non-retryable.
+ */
+exports.QuoteStatusUpdateRetryableBackendTypes = [
+    QuoteStatusUpdateBackendErrorType.ConcurrentUpdate,
+    QuoteStatusUpdateBackendErrorType.TransactionNotIndexed,
+];
+/**
+ * Local quote-status lifecycle states tracked by the state machine. These are
+ * the states the manager owns; a subset maps onto backend statuses while
+ * `Completed`/`Expired` are terminal, client-only states.
+ */
+var QuoteStatusState;
+(function (QuoteStatusState) {
+    /** Source transaction submitted; awaiting finalization. */
+    QuoteStatusState["Submitted"] = "Submitted";
+    /** Transaction finalized successfully on-chain. */
+    QuoteStatusState["FinalizedSuccess"] = "FinalizedSuccess";
+    /** Transaction failed or reverted on-chain. */
+    QuoteStatusState["FinalizedFailed"] = "FinalizedFailed";
+    /** Terminal: the backend accepted the final status; nothing left to report. */
+    QuoteStatusState["Completed"] = "Completed";
+    /** Terminal: the entry outlived its TTL and was abandoned. */
+    QuoteStatusState["Expired"] = "Expired";
+})(QuoteStatusState || (exports.QuoteStatusState = QuoteStatusState = {}));
+/**
+ * Maps each local lifecycle state to the backend status to report for it, or
+ * `null` for terminal states that require no backend update. The manager uses a
+ * `null` mapping as the signal to remove the entry instead of calling the API.
+ */
+exports.QuoteStatusStateToBackendStatus = {
+    [QuoteStatusState.Submitted]: QuoteStatusBackendStatus.Submitted,
+    [QuoteStatusState.FinalizedSuccess]: QuoteStatusBackendStatus.FinalizedSuccess,
+    [QuoteStatusState.FinalizedFailed]: QuoteStatusBackendStatus.FinalizedFailed,
+    [QuoteStatusState.Completed]: null,
+    [QuoteStatusState.Expired]: null,
+};
+/**
+ * Adjacency list defining the allowed forward-only transitions between
+ * lifecycle states. Enforced by `QuoteStatusStateFsm`; terminal states map to
+ * an empty array. Any state not present is treated as terminal.
+ */
+exports.AllowedQuoteStatusStateTransitions = {
+    [QuoteStatusState.Submitted]: [
+        QuoteStatusState.FinalizedFailed,
+        QuoteStatusState.FinalizedSuccess,
+        QuoteStatusState.Expired,
+    ],
+    [QuoteStatusState.FinalizedFailed]: [
+        QuoteStatusState.Completed,
+        QuoteStatusState.Expired,
+    ],
+    [QuoteStatusState.FinalizedSuccess]: [
+        QuoteStatusState.Completed,
+        QuoteStatusState.Expired,
+    ],
+    [QuoteStatusState.Completed]: [],
+    [QuoteStatusState.Expired]: [],
+};
+/**
+ * Outcome of a retrying status fetch call. Tells the
+ * manager how to proceed after an update attempt completes.
+ */
+var QuoteStatusFetchWithRetryOutcomeType;
+(function (QuoteStatusFetchWithRetryOutcomeType) {
+    /** The backend accepted the update (2xx); the entry can be finalized/removed. */
+    QuoteStatusFetchWithRetryOutcomeType["Accepted"] = "accepted";
+    /** All retry attempts for a retryable error were used up; back off and try again later. */
+    QuoteStatusFetchWithRetryOutcomeType["RetryableExhausted"] = "retryableExhausted";
+    /** The backend returned a non-retryable error; the entry must be reconciled or evicted. */
+    QuoteStatusFetchWithRetryOutcomeType["NonRetryable"] = "nonRetryable";
+    /** The request was aborted (e.g. via abort signal) before completing. */
+    QuoteStatusFetchWithRetryOutcomeType["Interrupted"] = "interrupted";
+})(QuoteStatusFetchWithRetryOutcomeType || (exports.QuoteStatusFetchWithRetryOutcomeType = QuoteStatusFetchWithRetryOutcomeType = {}));
+//# sourceMappingURL=constants.cjs.map

package/dist/quote-status-manager/constants.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.cjs","sourceRoot":"","sources":["../../src/quote-status-manager/constants.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * How often the manager re-processes entries that have not yet reached a\n * terminal state (`Completed`/`Expired`).\n *\n * Drives the periodic retry timer in `QuoteStatusUpdateManager`: on each tick\n * every non-terminal entry is re-sent to the backend until it is accepted or\n * evicted. The timer only runs while there is outstanding work.\n */\nexport const QUOTE_STATUS_UPDATE_RETRY_INTERVAL_MS = 30 * 60 * 1000; // 30 minutes\n\n/**\n * Maximum lifetime of a tracked quote-status entry, measured from when it was\n * created.\n *\n * Once an entry is older than this it is considered `Expired`, evicted from the\n * store on the next read, and never retried again. This bounds how long the\n * manager keeps trying to report a status that the backend may never accept.\n */\nexport const QUOTE_STATUS_UPDATE_ENTRY_TTL = 12 * 60 * 60 * 1000; // 12 hours\n\n/**\n * Quote lifecycle statuses as understood by the backend `quote/updateStatus`\n * API. These are the values sent over the wire (and echoed back in error\n * responses).\n */\nexport enum QuoteStatusBackendStatus {\n  /**\n   * Quote was served to the client. Unused locally, kept for parity with the backend enum.\n   */\n  Served = 'SERVED',\n  /**\n   * User has submitted the source transaction.\n   */\n  Submitted = 'SUBMITTED',\n  /**\n   * Transaction finalized successfully on-chain.\n   */\n  FinalizedSuccess = 'FINALIZED_SUCCESS',\n  /**\n   * Transaction failed or reverted on-chain.\n   */\n  FinalizedFailed = 'FINALIZED_FAILED',\n}\n\n/**\n * Machine-readable error `type` values returned by the backend\n * `quote/updateStatus` API on non-2xx responses. The comments record the HTTP\n * status the backend pairs with each type.\n */\nexport enum QuoteStatusUpdateBackendErrorType {\n  QuoteNotFound = 'QUOTE_NOT_FOUND', // Http status: 404\n  ConcurrentUpdate = 'CONCURRENT_UPDATE', // Http status: 409\n  InvalidStatusTransaction = 'INVALID_STATUS_TRANSITION', // Http status: 400\n  SrcTxHashRequiredForFinalized = 'SRC_TX_HASH_REQUIRED_FOR_FINALIZED', // Http status: 400\n  PersistQuoteStatusFailed = 'PERSIST_QUOTE_STATUS_FAILED', // Http status: 400\n  TransactionNotIndexed = 'TRANSACTION_NOT_INDEXED', // Http status: 409\n  TxDataMissingHash = 'TX_DATA_MISSING_HASH', // Http status: 400\n  TxDataMissingTrade = 'TX_DATA_MISSING_TRADE', // Http status: 400\n  /**\n   * On-chain tx payload does not match the served quote (EVM calldata, SVM message, TVM raw_data_hex).\n   */\n  TxDataMismatch = 'TX_DATA_MISMATCH', // Http status: 400\n  SvmTradeDeserializeFailed = 'SVM_TRADE_DESERIALIZE_FAILED', // Http status: 400\n  /**\n   * Requested lifecycle status is inconsistent with observed on-chain tx status.\n   */\n  QuoteStatusOnChainMismatch = 'QUOTE_STATUS_ONCHAIN_MISMATCH', // Http status: 400\n}\n\n/**\n * Error types whose response payload carries no `currentStatus`. Used by the\n * response validator to define the base (non-mismatch) error response schema.\n */\nexport const BaseQuoteStatusUpdateErrorTypes = [\n  QuoteStatusUpdateBackendErrorType.QuoteNotFound,\n  QuoteStatusUpdateBackendErrorType.ConcurrentUpdate,\n  QuoteStatusUpdateBackendErrorType.SrcTxHashRequiredForFinalized,\n  QuoteStatusUpdateBackendErrorType.PersistQuoteStatusFailed,\n  QuoteStatusUpdateBackendErrorType.TransactionNotIndexed,\n  QuoteStatusUpdateBackendErrorType.TxDataMissingHash,\n  QuoteStatusUpdateBackendErrorType.TxDataMissingTrade,\n  QuoteStatusUpdateBackendErrorType.TxDataMismatch,\n  QuoteStatusUpdateBackendErrorType.SvmTradeDeserializeFailed,\n] as const;\n\n/**\n * The full set of valid backend status values. Used by the response validator\n * to constrain the `currentStatus`/`newStatus` fields of error responses.\n */\nexport const QuoteStatusBackendValues = [\n  QuoteStatusBackendStatus.Served,\n  QuoteStatusBackendStatus.Submitted,\n  QuoteStatusBackendStatus.FinalizedSuccess,\n  QuoteStatusBackendStatus.FinalizedFailed,\n] as const;\n\n/**\n * Error types whose response payload includes a `currentStatus` describing the\n * backend's observed status. Used by the validator for the mismatch response\n * schema and by the manager to reconcile local state with the backend.\n */\nexport const QuoteStatusUpdateBackendOnChainMismatchTypes = [\n  QuoteStatusUpdateBackendErrorType.InvalidStatusTransaction,\n  QuoteStatusUpdateBackendErrorType.QuoteStatusOnChainMismatch,\n] as const;\n\n/**\n * Error types that represent transient backend conditions. A response with one\n * of these types is retried by `updateQuoteStatusWithRetry`; any other error\n * type is treated as non-retryable.\n */\nexport const QuoteStatusUpdateRetryableBackendTypes = [\n  QuoteStatusUpdateBackendErrorType.ConcurrentUpdate,\n  QuoteStatusUpdateBackendErrorType.TransactionNotIndexed,\n];\n\n/**\n * Local quote-status lifecycle states tracked by the state machine. These are\n * the states the manager owns; a subset maps onto backend statuses while\n * `Completed`/`Expired` are terminal, client-only states.\n */\nexport enum QuoteStatusState {\n  /** Source transaction submitted; awaiting finalization. */\n  Submitted = 'Submitted',\n  /** Transaction finalized successfully on-chain. */\n  FinalizedSuccess = 'FinalizedSuccess',\n  /** Transaction failed or reverted on-chain. */\n  FinalizedFailed = 'FinalizedFailed',\n  /** Terminal: the backend accepted the final status; nothing left to report. */\n  Completed = 'Completed',\n  /** Terminal: the entry outlived its TTL and was abandoned. */\n  Expired = 'Expired',\n}\n\n/**\n * Maps each local lifecycle state to the backend status to report for it, or\n * `null` for terminal states that require no backend update. The manager uses a\n * `null` mapping as the signal to remove the entry instead of calling the API.\n */\nexport const QuoteStatusStateToBackendStatus = {\n  [QuoteStatusState.Submitted]: QuoteStatusBackendStatus.Submitted,\n  [QuoteStatusState.FinalizedSuccess]:\n    QuoteStatusBackendStatus.FinalizedSuccess,\n  [QuoteStatusState.FinalizedFailed]: QuoteStatusBackendStatus.FinalizedFailed,\n  [QuoteStatusState.Completed]: null,\n  [QuoteStatusState.Expired]: null,\n};\n\n/**\n * Adjacency list defining the allowed forward-only transitions between\n * lifecycle states. Enforced by `QuoteStatusStateFsm`; terminal states map to\n * an empty array. Any state not present is treated as terminal.\n */\nexport const AllowedQuoteStatusStateTransitions: Record<\n  QuoteStatusState,\n  readonly QuoteStatusState[]\n> = {\n  [QuoteStatusState.Submitted]: [\n    QuoteStatusState.FinalizedFailed,\n    QuoteStatusState.FinalizedSuccess,\n    QuoteStatusState.Expired,\n  ],\n  [QuoteStatusState.FinalizedFailed]: [\n    QuoteStatusState.Completed,\n    QuoteStatusState.Expired,\n  ],\n  [QuoteStatusState.FinalizedSuccess]: [\n    QuoteStatusState.Completed,\n    QuoteStatusState.Expired,\n  ],\n  [QuoteStatusState.Completed]: [],\n  [QuoteStatusState.Expired]: [],\n};\n\n/**\n * Outcome of a retrying status fetch call. Tells the\n * manager how to proceed after an update attempt completes.\n */\nexport enum QuoteStatusFetchWithRetryOutcomeType {\n  /** The backend accepted the update (2xx); the entry can be finalized/removed. */\n  Accepted = 'accepted',\n  /** All retry attempts for a retryable error were used up; back off and try again later. */\n  RetryableExhausted = 'retryableExhausted',\n  /** The backend returned a non-retryable error; the entry must be reconciled or evicted. */\n  NonRetryable = 'nonRetryable',\n  /** The request was aborted (e.g. via abort signal) before completing. */\n  Interrupted = 'interrupted',\n}\n"]}

package/dist/quote-status-manager/constants.d.cts

@@ -0,0 +1,137 @@
+/**
+ * How often the manager re-processes entries that have not yet reached a
+ * terminal state (`Completed`/`Expired`).
+ *
+ * Drives the periodic retry timer in `QuoteStatusUpdateManager`: on each tick
+ * every non-terminal entry is re-sent to the backend until it is accepted or
+ * evicted. The timer only runs while there is outstanding work.
+ */
+export declare const QUOTE_STATUS_UPDATE_RETRY_INTERVAL_MS: number;
+/**
+ * Maximum lifetime of a tracked quote-status entry, measured from when it was
+ * created.
+ *
+ * Once an entry is older than this it is considered `Expired`, evicted from the
+ * store on the next read, and never retried again. This bounds how long the
+ * manager keeps trying to report a status that the backend may never accept.
+ */
+export declare const QUOTE_STATUS_UPDATE_ENTRY_TTL: number;
+/**
+ * Quote lifecycle statuses as understood by the backend `quote/updateStatus`
+ * API. These are the values sent over the wire (and echoed back in error
+ * responses).
+ */
+export declare enum QuoteStatusBackendStatus {
+    /**
+     * Quote was served to the client. Unused locally, kept for parity with the backend enum.
+     */
+    Served = "SERVED",
+    /**
+     * User has submitted the source transaction.
+     */
+    Submitted = "SUBMITTED",
+    /**
+     * Transaction finalized successfully on-chain.
+     */
+    FinalizedSuccess = "FINALIZED_SUCCESS",
+    /**
+     * Transaction failed or reverted on-chain.
+     */
+    FinalizedFailed = "FINALIZED_FAILED"
+}
+/**
+ * Machine-readable error `type` values returned by the backend
+ * `quote/updateStatus` API on non-2xx responses. The comments record the HTTP
+ * status the backend pairs with each type.
+ */
+export declare enum QuoteStatusUpdateBackendErrorType {
+    QuoteNotFound = "QUOTE_NOT_FOUND",// Http status: 404
+    ConcurrentUpdate = "CONCURRENT_UPDATE",// Http status: 409
+    InvalidStatusTransaction = "INVALID_STATUS_TRANSITION",// Http status: 400
+    SrcTxHashRequiredForFinalized = "SRC_TX_HASH_REQUIRED_FOR_FINALIZED",// Http status: 400
+    PersistQuoteStatusFailed = "PERSIST_QUOTE_STATUS_FAILED",// Http status: 400
+    TransactionNotIndexed = "TRANSACTION_NOT_INDEXED",// Http status: 409
+    TxDataMissingHash = "TX_DATA_MISSING_HASH",// Http status: 400
+    TxDataMissingTrade = "TX_DATA_MISSING_TRADE",// Http status: 400
+    /**
+     * On-chain tx payload does not match the served quote (EVM calldata, SVM message, TVM raw_data_hex).
+     */
+    TxDataMismatch = "TX_DATA_MISMATCH",// Http status: 400
+    SvmTradeDeserializeFailed = "SVM_TRADE_DESERIALIZE_FAILED",// Http status: 400
+    /**
+     * Requested lifecycle status is inconsistent with observed on-chain tx status.
+     */
+    QuoteStatusOnChainMismatch = "QUOTE_STATUS_ONCHAIN_MISMATCH"
+}
+/**
+ * Error types whose response payload carries no `currentStatus`. Used by the
+ * response validator to define the base (non-mismatch) error response schema.
+ */
+export declare const BaseQuoteStatusUpdateErrorTypes: readonly [QuoteStatusUpdateBackendErrorType.QuoteNotFound, QuoteStatusUpdateBackendErrorType.ConcurrentUpdate, QuoteStatusUpdateBackendErrorType.SrcTxHashRequiredForFinalized, QuoteStatusUpdateBackendErrorType.PersistQuoteStatusFailed, QuoteStatusUpdateBackendErrorType.TransactionNotIndexed, QuoteStatusUpdateBackendErrorType.TxDataMissingHash, QuoteStatusUpdateBackendErrorType.TxDataMissingTrade, QuoteStatusUpdateBackendErrorType.TxDataMismatch, QuoteStatusUpdateBackendErrorType.SvmTradeDeserializeFailed];
+/**
+ * The full set of valid backend status values. Used by the response validator
+ * to constrain the `currentStatus`/`newStatus` fields of error responses.
+ */
+export declare const QuoteStatusBackendValues: readonly [QuoteStatusBackendStatus.Served, QuoteStatusBackendStatus.Submitted, QuoteStatusBackendStatus.FinalizedSuccess, QuoteStatusBackendStatus.FinalizedFailed];
+/**
+ * Error types whose response payload includes a `currentStatus` describing the
+ * backend's observed status. Used by the validator for the mismatch response
+ * schema and by the manager to reconcile local state with the backend.
+ */
+export declare const QuoteStatusUpdateBackendOnChainMismatchTypes: readonly [QuoteStatusUpdateBackendErrorType.InvalidStatusTransaction, QuoteStatusUpdateBackendErrorType.QuoteStatusOnChainMismatch];
+/**
+ * Error types that represent transient backend conditions. A response with one
+ * of these types is retried by `updateQuoteStatusWithRetry`; any other error
+ * type is treated as non-retryable.
+ */
+export declare const QuoteStatusUpdateRetryableBackendTypes: QuoteStatusUpdateBackendErrorType[];
+/**
+ * Local quote-status lifecycle states tracked by the state machine. These are
+ * the states the manager owns; a subset maps onto backend statuses while
+ * `Completed`/`Expired` are terminal, client-only states.
+ */
+export declare enum QuoteStatusState {
+    /** Source transaction submitted; awaiting finalization. */
+    Submitted = "Submitted",
+    /** Transaction finalized successfully on-chain. */
+    FinalizedSuccess = "FinalizedSuccess",
+    /** Transaction failed or reverted on-chain. */
+    FinalizedFailed = "FinalizedFailed",
+    /** Terminal: the backend accepted the final status; nothing left to report. */
+    Completed = "Completed",
+    /** Terminal: the entry outlived its TTL and was abandoned. */
+    Expired = "Expired"
+}
+/**
+ * Maps each local lifecycle state to the backend status to report for it, or
+ * `null` for terminal states that require no backend update. The manager uses a
+ * `null` mapping as the signal to remove the entry instead of calling the API.
+ */
+export declare const QuoteStatusStateToBackendStatus: {
+    Submitted: QuoteStatusBackendStatus;
+    FinalizedSuccess: QuoteStatusBackendStatus;
+    FinalizedFailed: QuoteStatusBackendStatus;
+    Completed: null;
+    Expired: null;
+};
+/**
+ * Adjacency list defining the allowed forward-only transitions between
+ * lifecycle states. Enforced by `QuoteStatusStateFsm`; terminal states map to
+ * an empty array. Any state not present is treated as terminal.
+ */
+export declare const AllowedQuoteStatusStateTransitions: Record<QuoteStatusState, readonly QuoteStatusState[]>;
+/**
+ * Outcome of a retrying status fetch call. Tells the
+ * manager how to proceed after an update attempt completes.
+ */
+export declare enum QuoteStatusFetchWithRetryOutcomeType {
+    /** The backend accepted the update (2xx); the entry can be finalized/removed. */
+    Accepted = "accepted",
+    /** All retry attempts for a retryable error were used up; back off and try again later. */
+    RetryableExhausted = "retryableExhausted",
+    /** The backend returned a non-retryable error; the entry must be reconciled or evicted. */
+    NonRetryable = "nonRetryable",
+    /** The request was aborted (e.g. via abort signal) before completing. */
+    Interrupted = "interrupted"
+}
+//# sourceMappingURL=constants.d.cts.map

package/dist/quote-status-manager/constants.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.cts","sourceRoot":"","sources":["../../src/quote-status-manager/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,qCAAqC,QAAiB,CAAC;AAEpE;;;;;;;GAOG;AACH,eAAO,MAAM,6BAA6B,QAAsB,CAAC;AAEjE;;;;GAIG;AACH,oBAAY,wBAAwB;IAClC;;OAEG;IACH,MAAM,WAAW;IACjB;;OAEG;IACH,SAAS,cAAc;IACvB;;OAEG;IACH,gBAAgB,sBAAsB;IACtC;;OAEG;IACH,eAAe,qBAAqB;CACrC;AAED;;;;GAIG;AACH,oBAAY,iCAAiC;IAC3C,aAAa,oBAAoB,CAAE,mBAAmB;IACtD,gBAAgB,sBAAsB,CAAE,mBAAmB;IAC3D,wBAAwB,8BAA8B,CAAE,mBAAmB;IAC3E,6BAA6B,uCAAuC,CAAE,mBAAmB;IACzF,wBAAwB,gCAAgC,CAAE,mBAAmB;IAC7E,qBAAqB,4BAA4B,CAAE,mBAAmB;IACtE,iBAAiB,yBAAyB,CAAE,mBAAmB;IAC/D,kBAAkB,0BAA0B,CAAE,mBAAmB;IACjE;;OAEG;IACH,cAAc,qBAAqB,CAAE,mBAAmB;IACxD,yBAAyB,iCAAiC,CAAE,mBAAmB;IAC/E;;OAEG;IACH,0BAA0B,kCAAkC;CAC7D;AAED;;;GAGG;AACH,eAAO,MAAM,+BAA+B,ggBAUlC,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,wBAAwB,qKAK3B,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,4CAA4C,qIAG/C,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,sCAAsC,qCAGlD,CAAC;AAEF;;;;GAIG;AACH,oBAAY,gBAAgB;IAC1B,2DAA2D;IAC3D,SAAS,cAAc;IACvB,mDAAmD;IACnD,gBAAgB,qBAAqB;IACrC,+CAA+C;IAC/C,eAAe,oBAAoB;IACnC,+EAA+E;IAC/E,SAAS,cAAc;IACvB,8DAA8D;IAC9D,OAAO,YAAY;CACpB;AAED;;;;GAIG;AACH,eAAO,MAAM,+BAA+B;;;;;;CAO3C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kCAAkC,EAAE,MAAM,CACrD,gBAAgB,EAChB,SAAS,gBAAgB,EAAE,CAiB5B,CAAC;AAEF;;;GAGG;AACH,oBAAY,oCAAoC;IAC9C,iFAAiF;IACjF,QAAQ,aAAa;IACrB,2FAA2F;IAC3F,kBAAkB,uBAAuB;IACzC,2FAA2F;IAC3F,YAAY,iBAAiB;IAC7B,yEAAyE;IACzE,WAAW,gBAAgB;CAC5B"}

package/dist/quote-status-manager/constants.d.mts

@@ -0,0 +1,137 @@
+/**
+ * How often the manager re-processes entries that have not yet reached a
+ * terminal state (`Completed`/`Expired`).
+ *
+ * Drives the periodic retry timer in `QuoteStatusUpdateManager`: on each tick
+ * every non-terminal entry is re-sent to the backend until it is accepted or
+ * evicted. The timer only runs while there is outstanding work.
+ */
+export declare const QUOTE_STATUS_UPDATE_RETRY_INTERVAL_MS: number;
+/**
+ * Maximum lifetime of a tracked quote-status entry, measured from when it was
+ * created.
+ *
+ * Once an entry is older than this it is considered `Expired`, evicted from the
+ * store on the next read, and never retried again. This bounds how long the
+ * manager keeps trying to report a status that the backend may never accept.
+ */
+export declare const QUOTE_STATUS_UPDATE_ENTRY_TTL: number;
+/**
+ * Quote lifecycle statuses as understood by the backend `quote/updateStatus`
+ * API. These are the values sent over the wire (and echoed back in error
+ * responses).
+ */
+export declare enum QuoteStatusBackendStatus {
+    /**
+     * Quote was served to the client. Unused locally, kept for parity with the backend enum.
+     */
+    Served = "SERVED",
+    /**
+     * User has submitted the source transaction.
+     */
+    Submitted = "SUBMITTED",
+    /**
+     * Transaction finalized successfully on-chain.
+     */
+    FinalizedSuccess = "FINALIZED_SUCCESS",
+    /**
+     * Transaction failed or reverted on-chain.
+     */
+    FinalizedFailed = "FINALIZED_FAILED"
+}
+/**
+ * Machine-readable error `type` values returned by the backend
+ * `quote/updateStatus` API on non-2xx responses. The comments record the HTTP
+ * status the backend pairs with each type.
+ */
+export declare enum QuoteStatusUpdateBackendErrorType {
+    QuoteNotFound = "QUOTE_NOT_FOUND",// Http status: 404
+    ConcurrentUpdate = "CONCURRENT_UPDATE",// Http status: 409
+    InvalidStatusTransaction = "INVALID_STATUS_TRANSITION",// Http status: 400
+    SrcTxHashRequiredForFinalized = "SRC_TX_HASH_REQUIRED_FOR_FINALIZED",// Http status: 400
+    PersistQuoteStatusFailed = "PERSIST_QUOTE_STATUS_FAILED",// Http status: 400
+    TransactionNotIndexed = "TRANSACTION_NOT_INDEXED",// Http status: 409
+    TxDataMissingHash = "TX_DATA_MISSING_HASH",// Http status: 400
+    TxDataMissingTrade = "TX_DATA_MISSING_TRADE",// Http status: 400
+    /**
+     * On-chain tx payload does not match the served quote (EVM calldata, SVM message, TVM raw_data_hex).
+     */
+    TxDataMismatch = "TX_DATA_MISMATCH",// Http status: 400
+    SvmTradeDeserializeFailed = "SVM_TRADE_DESERIALIZE_FAILED",// Http status: 400
+    /**
+     * Requested lifecycle status is inconsistent with observed on-chain tx status.
+     */
+    QuoteStatusOnChainMismatch = "QUOTE_STATUS_ONCHAIN_MISMATCH"
+}
+/**
+ * Error types whose response payload carries no `currentStatus`. Used by the
+ * response validator to define the base (non-mismatch) error response schema.
+ */
+export declare const BaseQuoteStatusUpdateErrorTypes: readonly [QuoteStatusUpdateBackendErrorType.QuoteNotFound, QuoteStatusUpdateBackendErrorType.ConcurrentUpdate, QuoteStatusUpdateBackendErrorType.SrcTxHashRequiredForFinalized, QuoteStatusUpdateBackendErrorType.PersistQuoteStatusFailed, QuoteStatusUpdateBackendErrorType.TransactionNotIndexed, QuoteStatusUpdateBackendErrorType.TxDataMissingHash, QuoteStatusUpdateBackendErrorType.TxDataMissingTrade, QuoteStatusUpdateBackendErrorType.TxDataMismatch, QuoteStatusUpdateBackendErrorType.SvmTradeDeserializeFailed];
+/**
+ * The full set of valid backend status values. Used by the response validator
+ * to constrain the `currentStatus`/`newStatus` fields of error responses.
+ */
+export declare const QuoteStatusBackendValues: readonly [QuoteStatusBackendStatus.Served, QuoteStatusBackendStatus.Submitted, QuoteStatusBackendStatus.FinalizedSuccess, QuoteStatusBackendStatus.FinalizedFailed];
+/**
+ * Error types whose response payload includes a `currentStatus` describing the
+ * backend's observed status. Used by the validator for the mismatch response
+ * schema and by the manager to reconcile local state with the backend.
+ */
+export declare const QuoteStatusUpdateBackendOnChainMismatchTypes: readonly [QuoteStatusUpdateBackendErrorType.InvalidStatusTransaction, QuoteStatusUpdateBackendErrorType.QuoteStatusOnChainMismatch];
+/**
+ * Error types that represent transient backend conditions. A response with one
+ * of these types is retried by `updateQuoteStatusWithRetry`; any other error
+ * type is treated as non-retryable.
+ */
+export declare const QuoteStatusUpdateRetryableBackendTypes: QuoteStatusUpdateBackendErrorType[];
+/**
+ * Local quote-status lifecycle states tracked by the state machine. These are
+ * the states the manager owns; a subset maps onto backend statuses while
+ * `Completed`/`Expired` are terminal, client-only states.
+ */
+export declare enum QuoteStatusState {
+    /** Source transaction submitted; awaiting finalization. */
+    Submitted = "Submitted",
+    /** Transaction finalized successfully on-chain. */
+    FinalizedSuccess = "FinalizedSuccess",
+    /** Transaction failed or reverted on-chain. */
+    FinalizedFailed = "FinalizedFailed",
+    /** Terminal: the backend accepted the final status; nothing left to report. */
+    Completed = "Completed",
+    /** Terminal: the entry outlived its TTL and was abandoned. */
+    Expired = "Expired"
+}
+/**
+ * Maps each local lifecycle state to the backend status to report for it, or
+ * `null` for terminal states that require no backend update. The manager uses a
+ * `null` mapping as the signal to remove the entry instead of calling the API.
+ */
+export declare const QuoteStatusStateToBackendStatus: {
+    Submitted: QuoteStatusBackendStatus;
+    FinalizedSuccess: QuoteStatusBackendStatus;
+    FinalizedFailed: QuoteStatusBackendStatus;
+    Completed: null;
+    Expired: null;
+};
+/**
+ * Adjacency list defining the allowed forward-only transitions between
+ * lifecycle states. Enforced by `QuoteStatusStateFsm`; terminal states map to
+ * an empty array. Any state not present is treated as terminal.
+ */
+export declare const AllowedQuoteStatusStateTransitions: Record<QuoteStatusState, readonly QuoteStatusState[]>;
+/**
+ * Outcome of a retrying status fetch call. Tells the
+ * manager how to proceed after an update attempt completes.
+ */
+export declare enum QuoteStatusFetchWithRetryOutcomeType {
+    /** The backend accepted the update (2xx); the entry can be finalized/removed. */
+    Accepted = "accepted",
+    /** All retry attempts for a retryable error were used up; back off and try again later. */
+    RetryableExhausted = "retryableExhausted",
+    /** The backend returned a non-retryable error; the entry must be reconciled or evicted. */
+    NonRetryable = "nonRetryable",
+    /** The request was aborted (e.g. via abort signal) before completing. */
+    Interrupted = "interrupted"
+}
+//# sourceMappingURL=constants.d.mts.map

package/dist/quote-status-manager/constants.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.mts","sourceRoot":"","sources":["../../src/quote-status-manager/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,qCAAqC,QAAiB,CAAC;AAEpE;;;;;;;GAOG;AACH,eAAO,MAAM,6BAA6B,QAAsB,CAAC;AAEjE;;;;GAIG;AACH,oBAAY,wBAAwB;IAClC;;OAEG;IACH,MAAM,WAAW;IACjB;;OAEG;IACH,SAAS,cAAc;IACvB;;OAEG;IACH,gBAAgB,sBAAsB;IACtC;;OAEG;IACH,eAAe,qBAAqB;CACrC;AAED;;;;GAIG;AACH,oBAAY,iCAAiC;IAC3C,aAAa,oBAAoB,CAAE,mBAAmB;IACtD,gBAAgB,sBAAsB,CAAE,mBAAmB;IAC3D,wBAAwB,8BAA8B,CAAE,mBAAmB;IAC3E,6BAA6B,uCAAuC,CAAE,mBAAmB;IACzF,wBAAwB,gCAAgC,CAAE,mBAAmB;IAC7E,qBAAqB,4BAA4B,CAAE,mBAAmB;IACtE,iBAAiB,yBAAyB,CAAE,mBAAmB;IAC/D,kBAAkB,0BAA0B,CAAE,mBAAmB;IACjE;;OAEG;IACH,cAAc,qBAAqB,CAAE,mBAAmB;IACxD,yBAAyB,iCAAiC,CAAE,mBAAmB;IAC/E;;OAEG;IACH,0BAA0B,kCAAkC;CAC7D;AAED;;;GAGG;AACH,eAAO,MAAM,+BAA+B,ggBAUlC,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,wBAAwB,qKAK3B,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,4CAA4C,qIAG/C,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,sCAAsC,qCAGlD,CAAC;AAEF;;;;GAIG;AACH,oBAAY,gBAAgB;IAC1B,2DAA2D;IAC3D,SAAS,cAAc;IACvB,mDAAmD;IACnD,gBAAgB,qBAAqB;IACrC,+CAA+C;IAC/C,eAAe,oBAAoB;IACnC,+EAA+E;IAC/E,SAAS,cAAc;IACvB,8DAA8D;IAC9D,OAAO,YAAY;CACpB;AAED;;;;GAIG;AACH,eAAO,MAAM,+BAA+B;;;;;;CAO3C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,kCAAkC,EAAE,MAAM,CACrD,gBAAgB,EAChB,SAAS,gBAAgB,EAAE,CAiB5B,CAAC;AAEF;;;GAGG;AACH,oBAAY,oCAAoC;IAC9C,iFAAiF;IACjF,QAAQ,aAAa;IACrB,2FAA2F;IAC3F,kBAAkB,uBAAuB;IACzC,2FAA2F;IAC3F,YAAY,iBAAiB;IAC7B,yEAAyE;IACzE,WAAW,gBAAgB;CAC5B"}