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

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

@@ -0,0 +1,178 @@
+/**
+ * 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 const 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.
+ */
+export const 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).
+ */
+export 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 || (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.
+ */
+export 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 || (QuoteStatusUpdateBackendErrorType = {}));
+/**
+ * Error types whose response payload carries no `currentStatus`. Used by the
+ * response validator to define the base (non-mismatch) error response schema.
+ */
+export const 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.
+ */
+export const 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.
+ */
+export const 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.
+ */
+export const 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.
+ */
+export 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 || (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.
+ */
+export const 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.
+ */
+export const 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.
+ */
+export 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 || (QuoteStatusFetchWithRetryOutcomeType = {}));
+//# sourceMappingURL=constants.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constants.mjs","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/errors.cjs

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QuoteStatusGetError = exports.QuoteStatusUpdateError = void 0;
+/**
+ * Error thrown for quote status update failures.
+ *
+ * The error message is prefixed with the error type when provided, and
+ * structured details are preserved on the instance for downstream handling.
+ */
+class QuoteStatusUpdateError extends Error {
+    /**
+     * Creates a quote status update error with structured context.
+     *
+     * @param message - Human-readable error message.
+     * @param details - Structured metadata about the failed quote update.
+     * @param details.errorType - Optional category for known update failures.
+     * @param details.quoteId - Unique quote identifier associated with the error.
+     */
+    constructor(message, details) {
+        super(`${details.errorType ? `[${details.errorType}] ` : ''}${message}`);
+        this.details = details;
+        this.name = QuoteStatusUpdateError.name;
+        Object.setPrototypeOf(this, QuoteStatusUpdateError.prototype);
+    }
+}
+exports.QuoteStatusUpdateError = QuoteStatusUpdateError;
+/**
+ * Error thrown for quote status fetch failures.
+ *
+ * Structured details are preserved on the instance for downstream handling.
+ */
+class QuoteStatusGetError extends Error {
+    /**
+     * Creates a quote status fetch error with structured context.
+     *
+     * @param message - Human-readable error message.
+     * @param details - Structured metadata about the failed quote status fetch.
+     * @param details.quoteId - Unique quote identifier associated with the error.
+     * @param retryable - Whether the error is transient and may resolve on retry.
+     * Defaults to `false`.
+     */
+    constructor(message, details, retryable = false) {
+        super(message);
+        this.details = details;
+        this.retryable = retryable;
+        this.name = QuoteStatusGetError.name;
+        Object.setPrototypeOf(this, QuoteStatusGetError.prototype);
+    }
+}
+exports.QuoteStatusGetError = QuoteStatusGetError;
+//# sourceMappingURL=errors.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.cjs","sourceRoot":"","sources":["../../src/quote-status-manager/errors.ts"],"names":[],"mappings":";;;AAKA;;;;;GAKG;AACH,MAAa,sBAAuB,SAAQ,KAAK;IAG/C;;;;;;;OAOG;IACH,YAAY,OAAe,EAAE,OAAsC;QACjE,KAAK,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;QACzE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC,IAAI,CAAC;QACxC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,sBAAsB,CAAC,SAAS,CAAC,CAAC;IAChE,CAAC;CACF;AAjBD,wDAiBC;AAED;;;;GAIG;AACH,MAAa,mBAAoB,SAAQ,KAAK;IAW5C;;;;;;;;OAQG;IACH,YACE,OAAe,EACf,OAAmC,EACnC,SAAS,GAAG,KAAK;QAEjB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC,IAAI,CAAC;QACrC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAC7D,CAAC;CACF;AA/BD,kDA+BC","sourcesContent":["import {\n  QuoteStatusGetErrorDetails,\n  QuoteStatusUpdateErrorDetails,\n} from './types';\n\n/**\n * Error thrown for quote status update failures.\n *\n * The error message is prefixed with the error type when provided, and\n * structured details are preserved on the instance for downstream handling.\n */\nexport class QuoteStatusUpdateError extends Error {\n  readonly details?: QuoteStatusUpdateErrorDetails;\n\n  /**\n   * Creates a quote status update error with structured context.\n   *\n   * @param message - Human-readable error message.\n   * @param details - Structured metadata about the failed quote update.\n   * @param details.errorType - Optional category for known update failures.\n   * @param details.quoteId - Unique quote identifier associated with the error.\n   */\n  constructor(message: string, details: QuoteStatusUpdateErrorDetails) {\n    super(`${details.errorType ? `[${details.errorType}] ` : ''}${message}`);\n    this.details = details;\n    this.name = QuoteStatusUpdateError.name;\n    Object.setPrototypeOf(this, QuoteStatusUpdateError.prototype);\n  }\n}\n\n/**\n * Error thrown for quote status fetch failures.\n *\n * Structured details are preserved on the instance for downstream handling.\n */\nexport class QuoteStatusGetError extends Error {\n  readonly details?: QuoteStatusGetErrorDetails;\n\n  /**\n   * Whether the error is transient and the request may succeed on a retry.\n   *\n   * `true` for 5xx (server-side) HTTP errors; `false` for 4xx (client-side)\n   * errors and response-validation failures.\n   */\n  readonly retryable: boolean;\n\n  /**\n   * Creates a quote status fetch error with structured context.\n   *\n   * @param message - Human-readable error message.\n   * @param details - Structured metadata about the failed quote status fetch.\n   * @param details.quoteId - Unique quote identifier associated with the error.\n   * @param retryable - Whether the error is transient and may resolve on retry.\n   * Defaults to `false`.\n   */\n  constructor(\n    message: string,\n    details: QuoteStatusGetErrorDetails,\n    retryable = false,\n  ) {\n    super(message);\n    this.details = details;\n    this.retryable = retryable;\n    this.name = QuoteStatusGetError.name;\n    Object.setPrototypeOf(this, QuoteStatusGetError.prototype);\n  }\n}\n"]}

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

@@ -0,0 +1,45 @@
+import { QuoteStatusGetErrorDetails, QuoteStatusUpdateErrorDetails } from "./types.cjs";
+/**
+ * Error thrown for quote status update failures.
+ *
+ * The error message is prefixed with the error type when provided, and
+ * structured details are preserved on the instance for downstream handling.
+ */
+export declare class QuoteStatusUpdateError extends Error {
+    readonly details?: QuoteStatusUpdateErrorDetails;
+    /**
+     * Creates a quote status update error with structured context.
+     *
+     * @param message - Human-readable error message.
+     * @param details - Structured metadata about the failed quote update.
+     * @param details.errorType - Optional category for known update failures.
+     * @param details.quoteId - Unique quote identifier associated with the error.
+     */
+    constructor(message: string, details: QuoteStatusUpdateErrorDetails);
+}
+/**
+ * Error thrown for quote status fetch failures.
+ *
+ * Structured details are preserved on the instance for downstream handling.
+ */
+export declare class QuoteStatusGetError extends Error {
+    readonly details?: QuoteStatusGetErrorDetails;
+    /**
+     * Whether the error is transient and the request may succeed on a retry.
+     *
+     * `true` for 5xx (server-side) HTTP errors; `false` for 4xx (client-side)
+     * errors and response-validation failures.
+     */
+    readonly retryable: boolean;
+    /**
+     * Creates a quote status fetch error with structured context.
+     *
+     * @param message - Human-readable error message.
+     * @param details - Structured metadata about the failed quote status fetch.
+     * @param details.quoteId - Unique quote identifier associated with the error.
+     * @param retryable - Whether the error is transient and may resolve on retry.
+     * Defaults to `false`.
+     */
+    constructor(message: string, details: QuoteStatusGetErrorDetails, retryable?: boolean);
+}
+//# sourceMappingURL=errors.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.cts","sourceRoot":"","sources":["../../src/quote-status-manager/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,6BAA6B,EAC9B,oBAAgB;AAEjB;;;;;GAKG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,OAAO,CAAC,EAAE,6BAA6B,CAAC;IAEjD;;;;;;;OAOG;gBACS,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,6BAA6B;CAMpE;AAED;;;;GAIG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,OAAO,CAAC,EAAE,0BAA0B,CAAC;IAE9C;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAE5B;;;;;;;;OAQG;gBAED,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,0BAA0B,EACnC,SAAS,UAAQ;CAQpB"}

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

@@ -0,0 +1,45 @@
+import { QuoteStatusGetErrorDetails, QuoteStatusUpdateErrorDetails } from "./types.mjs";
+/**
+ * Error thrown for quote status update failures.
+ *
+ * The error message is prefixed with the error type when provided, and
+ * structured details are preserved on the instance for downstream handling.
+ */
+export declare class QuoteStatusUpdateError extends Error {
+    readonly details?: QuoteStatusUpdateErrorDetails;
+    /**
+     * Creates a quote status update error with structured context.
+     *
+     * @param message - Human-readable error message.
+     * @param details - Structured metadata about the failed quote update.
+     * @param details.errorType - Optional category for known update failures.
+     * @param details.quoteId - Unique quote identifier associated with the error.
+     */
+    constructor(message: string, details: QuoteStatusUpdateErrorDetails);
+}
+/**
+ * Error thrown for quote status fetch failures.
+ *
+ * Structured details are preserved on the instance for downstream handling.
+ */
+export declare class QuoteStatusGetError extends Error {
+    readonly details?: QuoteStatusGetErrorDetails;
+    /**
+     * Whether the error is transient and the request may succeed on a retry.
+     *
+     * `true` for 5xx (server-side) HTTP errors; `false` for 4xx (client-side)
+     * errors and response-validation failures.
+     */
+    readonly retryable: boolean;
+    /**
+     * Creates a quote status fetch error with structured context.
+     *
+     * @param message - Human-readable error message.
+     * @param details - Structured metadata about the failed quote status fetch.
+     * @param details.quoteId - Unique quote identifier associated with the error.
+     * @param retryable - Whether the error is transient and may resolve on retry.
+     * Defaults to `false`.
+     */
+    constructor(message: string, details: QuoteStatusGetErrorDetails, retryable?: boolean);
+}
+//# sourceMappingURL=errors.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.mts","sourceRoot":"","sources":["../../src/quote-status-manager/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,6BAA6B,EAC9B,oBAAgB;AAEjB;;;;;GAKG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,QAAQ,CAAC,OAAO,CAAC,EAAE,6BAA6B,CAAC;IAEjD;;;;;;;OAOG;gBACS,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,6BAA6B;CAMpE;AAED;;;;GAIG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,OAAO,CAAC,EAAE,0BAA0B,CAAC;IAE9C;;;;;OAKG;IACH,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAE5B;;;;;;;;OAQG;gBAED,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,0BAA0B,EACnC,SAAS,UAAQ;CAQpB"}

package/dist/quote-status-manager/errors.mjs

@@ -0,0 +1,46 @@
+/**
+ * Error thrown for quote status update failures.
+ *
+ * The error message is prefixed with the error type when provided, and
+ * structured details are preserved on the instance for downstream handling.
+ */
+export class QuoteStatusUpdateError extends Error {
+    /**
+     * Creates a quote status update error with structured context.
+     *
+     * @param message - Human-readable error message.
+     * @param details - Structured metadata about the failed quote update.
+     * @param details.errorType - Optional category for known update failures.
+     * @param details.quoteId - Unique quote identifier associated with the error.
+     */
+    constructor(message, details) {
+        super(`${details.errorType ? `[${details.errorType}] ` : ''}${message}`);
+        this.details = details;
+        this.name = QuoteStatusUpdateError.name;
+        Object.setPrototypeOf(this, QuoteStatusUpdateError.prototype);
+    }
+}
+/**
+ * Error thrown for quote status fetch failures.
+ *
+ * Structured details are preserved on the instance for downstream handling.
+ */
+export class QuoteStatusGetError extends Error {
+    /**
+     * Creates a quote status fetch error with structured context.
+     *
+     * @param message - Human-readable error message.
+     * @param details - Structured metadata about the failed quote status fetch.
+     * @param details.quoteId - Unique quote identifier associated with the error.
+     * @param retryable - Whether the error is transient and may resolve on retry.
+     * Defaults to `false`.
+     */
+    constructor(message, details, retryable = false) {
+        super(message);
+        this.details = details;
+        this.retryable = retryable;
+        this.name = QuoteStatusGetError.name;
+        Object.setPrototypeOf(this, QuoteStatusGetError.prototype);
+    }
+}
+//# sourceMappingURL=errors.mjs.map

package/dist/quote-status-manager/errors.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.mjs","sourceRoot":"","sources":["../../src/quote-status-manager/errors.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAG/C;;;;;;;OAOG;IACH,YAAY,OAAe,EAAE,OAAsC;QACjE,KAAK,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;QACzE,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC,IAAI,CAAC;QACxC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,sBAAsB,CAAC,SAAS,CAAC,CAAC;IAChE,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAW5C;;;;;;;;OAQG;IACH,YACE,OAAe,EACf,OAAmC,EACnC,SAAS,GAAG,KAAK;QAEjB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC,IAAI,CAAC;QACrC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAC7D,CAAC;CACF","sourcesContent":["import {\n  QuoteStatusGetErrorDetails,\n  QuoteStatusUpdateErrorDetails,\n} from './types';\n\n/**\n * Error thrown for quote status update failures.\n *\n * The error message is prefixed with the error type when provided, and\n * structured details are preserved on the instance for downstream handling.\n */\nexport class QuoteStatusUpdateError extends Error {\n  readonly details?: QuoteStatusUpdateErrorDetails;\n\n  /**\n   * Creates a quote status update error with structured context.\n   *\n   * @param message - Human-readable error message.\n   * @param details - Structured metadata about the failed quote update.\n   * @param details.errorType - Optional category for known update failures.\n   * @param details.quoteId - Unique quote identifier associated with the error.\n   */\n  constructor(message: string, details: QuoteStatusUpdateErrorDetails) {\n    super(`${details.errorType ? `[${details.errorType}] ` : ''}${message}`);\n    this.details = details;\n    this.name = QuoteStatusUpdateError.name;\n    Object.setPrototypeOf(this, QuoteStatusUpdateError.prototype);\n  }\n}\n\n/**\n * Error thrown for quote status fetch failures.\n *\n * Structured details are preserved on the instance for downstream handling.\n */\nexport class QuoteStatusGetError extends Error {\n  readonly details?: QuoteStatusGetErrorDetails;\n\n  /**\n   * Whether the error is transient and the request may succeed on a retry.\n   *\n   * `true` for 5xx (server-side) HTTP errors; `false` for 4xx (client-side)\n   * errors and response-validation failures.\n   */\n  readonly retryable: boolean;\n\n  /**\n   * Creates a quote status fetch error with structured context.\n   *\n   * @param message - Human-readable error message.\n   * @param details - Structured metadata about the failed quote status fetch.\n   * @param details.quoteId - Unique quote identifier associated with the error.\n   * @param retryable - Whether the error is transient and may resolve on retry.\n   * Defaults to `false`.\n   */\n  constructor(\n    message: string,\n    details: QuoteStatusGetErrorDetails,\n    retryable = false,\n  ) {\n    super(message);\n    this.details = details;\n    this.retryable = retryable;\n    this.name = QuoteStatusGetError.name;\n    Object.setPrototypeOf(this, QuoteStatusGetError.prototype);\n  }\n}\n"]}