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

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

@@ -0,0 +1,145 @@
+import { BridgeClientId } from "@metamask/bridge-controller";
+import { Infer } from "@metamask/superstruct";
+import { BridgeStatusControllerMessenger } from "../types.cjs";
+import { QuoteStatusState, QuoteStatusUpdateBackendErrorType } from "./constants.cjs";
+import { QuoteStatusGetError, QuoteStatusUpdateError } from "./errors.cjs";
+import { QuoteStatusStateFsm } from "./quote-status-state-fsm.cjs";
+import { QuoteStatusGetResponseSchema, QuoteStatusUpdateResponseSchema } from "./validators.cjs";
+/**
+ * Persisted queue entry describing a single quote status update attempt.
+ */
+export type QuoteStatusPersistEntry = {
+    /**
+     * Unique quote identifier.
+     */
+    quoteId: string;
+    /**
+     * Source transaction hash used to correlate updates.
+     */
+    srcTxHash: string;
+    /**
+     * Current persisted status lifecycle value.
+     */
+    status: QuoteStatusState;
+    /**
+     * Timestamp in milliseconds when the entry was first created.
+     */
+    createdAt: number;
+    /**
+     * Timestamp in milliseconds for the most recent attempt.
+     */
+    lastAttemptAt: number;
+    /**
+     * Optional transaction metadata identifier assigned after submission.
+     */
+    txMetaId?: string;
+    /**
+     * The lifecycle status most recently accepted (2xx) by the backend, if any.
+     *
+     * Used to avoid redundantly re-sending a status the backend has already
+     * acknowledged. In particular, a `Submitted` entry stays tracked while it
+     * awaits finalization, and this flag stops the retry loop from re-sending the
+     * already-accepted `SUBMITTED` update (which the backend would reject as an
+     * invalid/duplicate transition). It is implicitly superseded once the status
+     * advances past it (e.g. via {@link QuoteStatusUpdateManager.reportFinalised}).
+     */
+    acknowledgedState?: QuoteStatusState;
+};
+/**
+ * In-memory queue entry with an FSM instance for status transitions.
+ */
+export type QuoteStatusRuntimeEntry = Omit<QuoteStatusPersistEntry, 'status'> & {
+    /**
+     * Runtime status FSM used to validate and apply transitions.
+     */
+    status: QuoteStatusStateFsm;
+};
+/**
+ * Validated non-`2xx` response payload from the quote update status API.
+ */
+export type QuoteStatusUpdateResponse = Infer<typeof QuoteStatusUpdateResponseSchema>;
+/**
+ * Validated non-`2xx` response payload from the quote get status API.
+ */
+export type QuoteStatusGetResponse = Infer<typeof QuoteStatusGetResponseSchema>;
+/**
+ * Options required to create quote status API service instances.
+ */
+export type QuoteStatusApiServiceOptions = {
+    /**
+     * Messenger used to retrieve the authentication token.
+     */
+    messenger: BridgeStatusControllerMessenger;
+    /**
+     * Bridge client identifier used for request headers.
+     */
+    clientId: BridgeClientId;
+    /**
+     * Product name sent as the `x-metamask-clientproduct` header.
+     */
+    clientProduct: string;
+    /**
+     * Optional client version sent as the `x-metamask-clientversion` header.
+     */
+    clientVersion?: string;
+    /**
+     * Base URL for the quote status API.
+     */
+    apiBaseUrl: string;
+    /**
+     * Optional callback invoked when an unexpected error response shape is returned.
+     */
+    onError?: (error: QuoteStatusUpdateError | QuoteStatusGetError) => void;
+};
+/**
+ * Context information attached to a {@link QuoteStatusUpdateError}.
+ */
+export type QuoteStatusUpdateErrorDetails = {
+    /**
+     * Unique quote identifier associated with the error.
+     */
+    quoteId: string;
+    /**
+     * Optional error type used to categorize known quote update failures.
+     */
+    errorType?: QuoteStatusUpdateBackendErrorType;
+};
+/**
+ * Context information attached to a {@link QuoteStatusGetError}.
+ */
+export type QuoteStatusGetErrorDetails = {
+    /**
+     * Unique quote identifier associated with the error.
+     */
+    quoteId: string;
+    validationFailures?: string[];
+};
+/**
+ * Construction options for quote status entry store instances.
+ */
+export type QuoteStatusEntryStoreOptions = {
+    /**
+     * Callback used to persist the current in-memory queue snapshot.
+     */
+    onPersistUpdates: (updates: Record<string, QuoteStatusPersistEntry>) => void;
+    /**
+     * Entry time-to-live in milliseconds before automatic eviction.
+     */
+    entryTtlMs: number;
+    /**
+     * Optional initial persisted entries used to seed the store.
+     */
+    initial?: Record<string, QuoteStatusPersistEntry>;
+};
+/**
+ * Event payload emitted whenever the FSM state changes.
+ */
+export type QuoteStatusStateUpdateEvent = {
+    previousState: QuoteStatusState;
+    nextState: QuoteStatusState;
+};
+/**
+ * Listener signature for quote-status state changes.
+ */
+export type QuoteStatusStateUpdateListener = (event: QuoteStatusStateUpdateEvent) => void;
+//# sourceMappingURL=types.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.cts","sourceRoot":"","sources":["../../src/quote-status-manager/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,oCAAoC;AAC7D,OAAO,EAAE,KAAK,EAAE,8BAA8B;AAE9C,OAAO,EAAE,+BAA+B,EAAE,qBAAiB;AAC3D,OAAO,EACL,gBAAgB,EAChB,iCAAiC,EAClC,wBAAoB;AACrB,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,qBAAiB;AACvE,OAAO,EAAE,mBAAmB,EAAE,qCAAiC;AAC/D,OAAO,EACL,4BAA4B,EAC5B,+BAA+B,EAChC,yBAAqB;AAEtB;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,MAAM,EAAE,gBAAgB,CAAC;IAEzB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;;;;;OASG;IACH,iBAAiB,CAAC,EAAE,gBAAgB,CAAC;CACtC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,IAAI,CACxC,uBAAuB,EACvB,QAAQ,CACT,GAAG;IACF;;OAEG;IACH,MAAM,EAAE,mBAAmB,CAAC;CAC7B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,KAAK,CAC3C,OAAO,+BAA+B,CACvC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAEhF;;GAEG;AACH,MAAM,MAAM,4BAA4B,GAAG;IACzC;;OAEG;IACH,SAAS,EAAE,+BAA+B,CAAC;IAE3C;;OAEG;IACH,QAAQ,EAAE,cAAc,CAAC;IAEzB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,sBAAsB,GAAG,mBAAmB,KAAK,IAAI,CAAC;CACzE,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG;IAC1C;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,SAAS,CAAC,EAAE,iCAAiC,CAAC;CAC/C,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,4BAA4B,GAAG;IACzC;;OAEG;IACH,gBAAgB,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,KAAK,IAAI,CAAC;IAC7E;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;CACnD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC,aAAa,EAAE,gBAAgB,CAAC;IAChC,SAAS,EAAE,gBAAgB,CAAC;CAC7B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,8BAA8B,GAAG,CAC3C,KAAK,EAAE,2BAA2B,KAC/B,IAAI,CAAC"}

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

@@ -0,0 +1,145 @@
+import { BridgeClientId } from "@metamask/bridge-controller";
+import { Infer } from "@metamask/superstruct";
+import { BridgeStatusControllerMessenger } from "../types.mjs";
+import { QuoteStatusState, QuoteStatusUpdateBackendErrorType } from "./constants.mjs";
+import { QuoteStatusGetError, QuoteStatusUpdateError } from "./errors.mjs";
+import { QuoteStatusStateFsm } from "./quote-status-state-fsm.mjs";
+import { QuoteStatusGetResponseSchema, QuoteStatusUpdateResponseSchema } from "./validators.mjs";
+/**
+ * Persisted queue entry describing a single quote status update attempt.
+ */
+export type QuoteStatusPersistEntry = {
+    /**
+     * Unique quote identifier.
+     */
+    quoteId: string;
+    /**
+     * Source transaction hash used to correlate updates.
+     */
+    srcTxHash: string;
+    /**
+     * Current persisted status lifecycle value.
+     */
+    status: QuoteStatusState;
+    /**
+     * Timestamp in milliseconds when the entry was first created.
+     */
+    createdAt: number;
+    /**
+     * Timestamp in milliseconds for the most recent attempt.
+     */
+    lastAttemptAt: number;
+    /**
+     * Optional transaction metadata identifier assigned after submission.
+     */
+    txMetaId?: string;
+    /**
+     * The lifecycle status most recently accepted (2xx) by the backend, if any.
+     *
+     * Used to avoid redundantly re-sending a status the backend has already
+     * acknowledged. In particular, a `Submitted` entry stays tracked while it
+     * awaits finalization, and this flag stops the retry loop from re-sending the
+     * already-accepted `SUBMITTED` update (which the backend would reject as an
+     * invalid/duplicate transition). It is implicitly superseded once the status
+     * advances past it (e.g. via {@link QuoteStatusUpdateManager.reportFinalised}).
+     */
+    acknowledgedState?: QuoteStatusState;
+};
+/**
+ * In-memory queue entry with an FSM instance for status transitions.
+ */
+export type QuoteStatusRuntimeEntry = Omit<QuoteStatusPersistEntry, 'status'> & {
+    /**
+     * Runtime status FSM used to validate and apply transitions.
+     */
+    status: QuoteStatusStateFsm;
+};
+/**
+ * Validated non-`2xx` response payload from the quote update status API.
+ */
+export type QuoteStatusUpdateResponse = Infer<typeof QuoteStatusUpdateResponseSchema>;
+/**
+ * Validated non-`2xx` response payload from the quote get status API.
+ */
+export type QuoteStatusGetResponse = Infer<typeof QuoteStatusGetResponseSchema>;
+/**
+ * Options required to create quote status API service instances.
+ */
+export type QuoteStatusApiServiceOptions = {
+    /**
+     * Messenger used to retrieve the authentication token.
+     */
+    messenger: BridgeStatusControllerMessenger;
+    /**
+     * Bridge client identifier used for request headers.
+     */
+    clientId: BridgeClientId;
+    /**
+     * Product name sent as the `x-metamask-clientproduct` header.
+     */
+    clientProduct: string;
+    /**
+     * Optional client version sent as the `x-metamask-clientversion` header.
+     */
+    clientVersion?: string;
+    /**
+     * Base URL for the quote status API.
+     */
+    apiBaseUrl: string;
+    /**
+     * Optional callback invoked when an unexpected error response shape is returned.
+     */
+    onError?: (error: QuoteStatusUpdateError | QuoteStatusGetError) => void;
+};
+/**
+ * Context information attached to a {@link QuoteStatusUpdateError}.
+ */
+export type QuoteStatusUpdateErrorDetails = {
+    /**
+     * Unique quote identifier associated with the error.
+     */
+    quoteId: string;
+    /**
+     * Optional error type used to categorize known quote update failures.
+     */
+    errorType?: QuoteStatusUpdateBackendErrorType;
+};
+/**
+ * Context information attached to a {@link QuoteStatusGetError}.
+ */
+export type QuoteStatusGetErrorDetails = {
+    /**
+     * Unique quote identifier associated with the error.
+     */
+    quoteId: string;
+    validationFailures?: string[];
+};
+/**
+ * Construction options for quote status entry store instances.
+ */
+export type QuoteStatusEntryStoreOptions = {
+    /**
+     * Callback used to persist the current in-memory queue snapshot.
+     */
+    onPersistUpdates: (updates: Record<string, QuoteStatusPersistEntry>) => void;
+    /**
+     * Entry time-to-live in milliseconds before automatic eviction.
+     */
+    entryTtlMs: number;
+    /**
+     * Optional initial persisted entries used to seed the store.
+     */
+    initial?: Record<string, QuoteStatusPersistEntry>;
+};
+/**
+ * Event payload emitted whenever the FSM state changes.
+ */
+export type QuoteStatusStateUpdateEvent = {
+    previousState: QuoteStatusState;
+    nextState: QuoteStatusState;
+};
+/**
+ * Listener signature for quote-status state changes.
+ */
+export type QuoteStatusStateUpdateListener = (event: QuoteStatusStateUpdateEvent) => void;
+//# sourceMappingURL=types.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","sourceRoot":"","sources":["../../src/quote-status-manager/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,oCAAoC;AAC7D,OAAO,EAAE,KAAK,EAAE,8BAA8B;AAE9C,OAAO,EAAE,+BAA+B,EAAE,qBAAiB;AAC3D,OAAO,EACL,gBAAgB,EAChB,iCAAiC,EAClC,wBAAoB;AACrB,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,qBAAiB;AACvE,OAAO,EAAE,mBAAmB,EAAE,qCAAiC;AAC/D,OAAO,EACL,4BAA4B,EAC5B,+BAA+B,EAChC,yBAAqB;AAEtB;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG;IACpC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,MAAM,EAAE,gBAAgB,CAAC;IAEzB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;;;;;OASG;IACH,iBAAiB,CAAC,EAAE,gBAAgB,CAAC;CACtC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,IAAI,CACxC,uBAAuB,EACvB,QAAQ,CACT,GAAG;IACF;;OAEG;IACH,MAAM,EAAE,mBAAmB,CAAC;CAC7B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,KAAK,CAC3C,OAAO,+BAA+B,CACvC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAEhF;;GAEG;AACH,MAAM,MAAM,4BAA4B,GAAG;IACzC;;OAEG;IACH,SAAS,EAAE,+BAA+B,CAAC;IAE3C;;OAEG;IACH,QAAQ,EAAE,cAAc,CAAC;IAEzB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,sBAAsB,GAAG,mBAAmB,KAAK,IAAI,CAAC;CACzE,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,6BAA6B,GAAG;IAC1C;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,SAAS,CAAC,EAAE,iCAAiC,CAAC;CAC/C,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG;IACvC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC/B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,4BAA4B,GAAG;IACzC;;OAEG;IACH,gBAAgB,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,KAAK,IAAI,CAAC;IAC7E;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,uBAAuB,CAAC,CAAC;CACnD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC,aAAa,EAAE,gBAAgB,CAAC;IAChC,SAAS,EAAE,gBAAgB,CAAC;CAC7B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,8BAA8B,GAAG,CAC3C,KAAK,EAAE,2BAA2B,KAC/B,IAAI,CAAC"}

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

@@ -0,0 +1,6 @@
+import { BridgeClientId } from "@metamask/bridge-controller";
+import { QuoteStatusState, QuoteStatusUpdateBackendErrorType } from "./constants.mjs";
+import { QuoteStatusGetError, QuoteStatusUpdateError } from "./errors.mjs";
+import { QuoteStatusStateFsm } from "./quote-status-state-fsm.mjs";
+import { QuoteStatusGetResponseSchema, QuoteStatusUpdateResponseSchema } from "./validators.mjs";
+//# sourceMappingURL=types.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.mjs","sourceRoot":"","sources":["../../src/quote-status-manager/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,oCAAoC;AAI7D,OAAO,EACL,gBAAgB,EAChB,iCAAiC,EAClC,wBAAoB;AACrB,OAAO,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,qBAAiB;AACvE,OAAO,EAAE,mBAAmB,EAAE,qCAAiC;AAC/D,OAAO,EACL,4BAA4B,EAC5B,+BAA+B,EAChC,yBAAqB","sourcesContent":["import { BridgeClientId } from '@metamask/bridge-controller';\nimport { Infer } from '@metamask/superstruct';\n\nimport { BridgeStatusControllerMessenger } from '../types';\nimport {\n  QuoteStatusState,\n  QuoteStatusUpdateBackendErrorType,\n} from './constants';\nimport { QuoteStatusGetError, QuoteStatusUpdateError } from './errors';\nimport { QuoteStatusStateFsm } from './quote-status-state-fsm';\nimport {\n  QuoteStatusGetResponseSchema,\n  QuoteStatusUpdateResponseSchema,\n} from './validators';\n\n/**\n * Persisted queue entry describing a single quote status update attempt.\n */\nexport type QuoteStatusPersistEntry = {\n  /**\n   * Unique quote identifier.\n   */\n  quoteId: string;\n\n  /**\n   * Source transaction hash used to correlate updates.\n   */\n  srcTxHash: string;\n\n  /**\n   * Current persisted status lifecycle value.\n   */\n  status: QuoteStatusState;\n\n  /**\n   * Timestamp in milliseconds when the entry was first created.\n   */\n  createdAt: number;\n\n  /**\n   * Timestamp in milliseconds for the most recent attempt.\n   */\n  lastAttemptAt: number;\n\n  /**\n   * Optional transaction metadata identifier assigned after submission.\n   */\n  txMetaId?: string;\n\n  /**\n   * The lifecycle status most recently accepted (2xx) by the backend, if any.\n   *\n   * Used to avoid redundantly re-sending a status the backend has already\n   * acknowledged. In particular, a `Submitted` entry stays tracked while it\n   * awaits finalization, and this flag stops the retry loop from re-sending the\n   * already-accepted `SUBMITTED` update (which the backend would reject as an\n   * invalid/duplicate transition). It is implicitly superseded once the status\n   * advances past it (e.g. via {@link QuoteStatusUpdateManager.reportFinalised}).\n   */\n  acknowledgedState?: QuoteStatusState;\n};\n\n/**\n * In-memory queue entry with an FSM instance for status transitions.\n */\nexport type QuoteStatusRuntimeEntry = Omit<\n  QuoteStatusPersistEntry,\n  'status'\n> & {\n  /**\n   * Runtime status FSM used to validate and apply transitions.\n   */\n  status: QuoteStatusStateFsm;\n};\n\n/**\n * Validated non-`2xx` response payload from the quote update status API.\n */\nexport type QuoteStatusUpdateResponse = Infer<\n  typeof QuoteStatusUpdateResponseSchema\n>;\n\n/**\n * Validated non-`2xx` response payload from the quote get status API.\n */\nexport type QuoteStatusGetResponse = Infer<typeof QuoteStatusGetResponseSchema>;\n\n/**\n * Options required to create quote status API service instances.\n */\nexport type QuoteStatusApiServiceOptions = {\n  /**\n   * Messenger used to retrieve the authentication token.\n   */\n  messenger: BridgeStatusControllerMessenger;\n\n  /**\n   * Bridge client identifier used for request headers.\n   */\n  clientId: BridgeClientId;\n\n  /**\n   * Product name sent as the `x-metamask-clientproduct` header.\n   */\n  clientProduct: string;\n\n  /**\n   * Optional client version sent as the `x-metamask-clientversion` header.\n   */\n  clientVersion?: string;\n\n  /**\n   * Base URL for the quote status API.\n   */\n  apiBaseUrl: string;\n\n  /**\n   * Optional callback invoked when an unexpected error response shape is returned.\n   */\n  onError?: (error: QuoteStatusUpdateError | QuoteStatusGetError) => void;\n};\n\n/**\n * Context information attached to a {@link QuoteStatusUpdateError}.\n */\nexport type QuoteStatusUpdateErrorDetails = {\n  /**\n   * Unique quote identifier associated with the error.\n   */\n  quoteId: string;\n\n  /**\n   * Optional error type used to categorize known quote update failures.\n   */\n  errorType?: QuoteStatusUpdateBackendErrorType;\n};\n\n/**\n * Context information attached to a {@link QuoteStatusGetError}.\n */\nexport type QuoteStatusGetErrorDetails = {\n  /**\n   * Unique quote identifier associated with the error.\n   */\n  quoteId: string;\n\n  validationFailures?: string[];\n};\n\n/**\n * Construction options for quote status entry store instances.\n */\nexport type QuoteStatusEntryStoreOptions = {\n  /**\n   * Callback used to persist the current in-memory queue snapshot.\n   */\n  onPersistUpdates: (updates: Record<string, QuoteStatusPersistEntry>) => void;\n  /**\n   * Entry time-to-live in milliseconds before automatic eviction.\n   */\n  entryTtlMs: number;\n\n  /**\n   * Optional initial persisted entries used to seed the store.\n   */\n  initial?: Record<string, QuoteStatusPersistEntry>;\n};\n\n/**\n * Event payload emitted whenever the FSM state changes.\n */\nexport type QuoteStatusStateUpdateEvent = {\n  previousState: QuoteStatusState;\n  nextState: QuoteStatusState;\n};\n\n/**\n * Listener signature for quote-status state changes.\n */\nexport type QuoteStatusStateUpdateListener = (\n  event: QuoteStatusStateUpdateEvent,\n) => void;\n"]}

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

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sleep = void 0;
+/**
+ * Returns a promise that resolves after the given number of milliseconds.
+ *
+ * @param ms - The number of milliseconds to wait before resolving.
+ */
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+exports.sleep = sleep;
+//# sourceMappingURL=utils.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.cjs","sourceRoot":"","sources":["../../src/quote-status-manager/utils.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACI,MAAM,KAAK,GAAG,CAAC,EAAU,EAAiB,EAAE,CACjD,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAD7C,QAAA,KAAK,SACwC","sourcesContent":["/**\n * Returns a promise that resolves after the given number of milliseconds.\n *\n * @param ms - The number of milliseconds to wait before resolving.\n */\nexport const sleep = (ms: number): Promise<void> =>\n  new Promise<void>((resolve) => setTimeout(resolve, ms));\n"]}

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

@@ -0,0 +1,7 @@
+/**
+ * Returns a promise that resolves after the given number of milliseconds.
+ *
+ * @param ms - The number of milliseconds to wait before resolving.
+ */
+export declare const sleep: (ms: number) => Promise<void>;
+//# sourceMappingURL=utils.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.cts","sourceRoot":"","sources":["../../src/quote-status-manager/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,KAAK,OAAQ,MAAM,KAAG,QAAQ,IAAI,CACU,CAAC"}

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

@@ -0,0 +1,7 @@
+/**
+ * Returns a promise that resolves after the given number of milliseconds.
+ *
+ * @param ms - The number of milliseconds to wait before resolving.
+ */
+export declare const sleep: (ms: number) => Promise<void>;
+//# sourceMappingURL=utils.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.mts","sourceRoot":"","sources":["../../src/quote-status-manager/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,eAAO,MAAM,KAAK,OAAQ,MAAM,KAAG,QAAQ,IAAI,CACU,CAAC"}

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

@@ -0,0 +1,7 @@
+/**
+ * Returns a promise that resolves after the given number of milliseconds.
+ *
+ * @param ms - The number of milliseconds to wait before resolving.
+ */
+export const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+//# sourceMappingURL=utils.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.mjs","sourceRoot":"","sources":["../../src/quote-status-manager/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,EAAU,EAAiB,EAAE,CACjD,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC","sourcesContent":["/**\n * Returns a promise that resolves after the given number of milliseconds.\n *\n * @param ms - The number of milliseconds to wait before resolving.\n */\nexport const sleep = (ms: number): Promise<void> =>\n  new Promise<void>((resolve) => setTimeout(resolve, ms));\n"]}

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

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateQuoteStatusGetResponse = exports.QuoteStatusGetResponseSchema = exports.validateQuoteStatusUpdateResponse = exports.QuoteStatusUpdateResponseSchema = void 0;
+const superstruct_1 = require("@metamask/superstruct");
+const validators_1 = require("../utils/validators.cjs");
+const constants_1 = require("./constants.cjs");
+const QuoteStatusUpdateResponseWithCurrentStatusSchema = (0, superstruct_1.type)({
+    statusCode: (0, superstruct_1.number)(),
+    message: (0, superstruct_1.string)(),
+    type: (0, superstruct_1.enums)(constants_1.QuoteStatusUpdateBackendOnChainMismatchTypes),
+    currentStatus: (0, superstruct_1.enums)(constants_1.QuoteStatusBackendValues),
+    newStatus: (0, superstruct_1.enums)(constants_1.QuoteStatusBackendValues),
+});
+const QuoteStatusUpdateResponseBaseSchema = (0, superstruct_1.type)({
+    statusCode: (0, superstruct_1.number)(),
+    message: (0, superstruct_1.string)(),
+    type: (0, superstruct_1.enums)(constants_1.BaseQuoteStatusUpdateErrorTypes),
+});
+exports.QuoteStatusUpdateResponseSchema = (0, superstruct_1.union)([
+    QuoteStatusUpdateResponseWithCurrentStatusSchema,
+    QuoteStatusUpdateResponseBaseSchema,
+]);
+function validateQuoteStatusUpdateResponse(data) {
+    (0, superstruct_1.assert)(data, exports.QuoteStatusUpdateResponseSchema);
+}
+exports.validateQuoteStatusUpdateResponse = validateQuoteStatusUpdateResponse;
+/**
+ * **Note**: This struct is big and not all fields are used atm.
+ * For that reason we have decided to only include the fields we
+ * consume in production. In the future, once we need it to be strongly type,
+ * we will refactor.
+ */
+exports.QuoteStatusGetResponseSchema = (0, superstruct_1.type)({
+    /**
+     * Submitted transaction: StatusResponseDto with at least srcChain (chainId + txHash).
+     * Prefilled by updateQuoteStatus; replaced with full provider status by getQuoteStatus.
+     */
+    submittedTx: (0, superstruct_1.optional)(validators_1.StatusResponseSchema),
+});
+function validateQuoteStatusGetResponse(data) {
+    (0, superstruct_1.assert)(data, exports.QuoteStatusGetResponseSchema);
+}
+exports.validateQuoteStatusGetResponse = validateQuoteStatusGetResponse;
+//# sourceMappingURL=validators.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validators.cjs","sourceRoot":"","sources":["../../src/quote-status-manager/validators.ts"],"names":[],"mappings":";;;AAAA,uDAQ+B;AAE/B,wDAA2D;AAC3D,+CAIqB;AAGrB,MAAM,gDAAgD,GAAG,IAAA,kBAAI,EAAC;IAC5D,UAAU,EAAE,IAAA,oBAAM,GAAE;IACpB,OAAO,EAAE,IAAA,oBAAM,GAAE;IACjB,IAAI,EAAE,IAAA,mBAAK,EAAC,wDAA4C,CAAC;IACzD,aAAa,EAAE,IAAA,mBAAK,EAAC,oCAAwB,CAAC;IAC9C,SAAS,EAAE,IAAA,mBAAK,EAAC,oCAAwB,CAAC;CAC3C,CAAC,CAAC;AAEH,MAAM,mCAAmC,GAAG,IAAA,kBAAI,EAAC;IAC/C,UAAU,EAAE,IAAA,oBAAM,GAAE;IACpB,OAAO,EAAE,IAAA,oBAAM,GAAE;IACjB,IAAI,EAAE,IAAA,mBAAK,EAAC,2CAA+B,CAAC;CAC7C,CAAC,CAAC;AAEU,QAAA,+BAA+B,GAAG,IAAA,mBAAK,EAAC;IACnD,gDAAgD;IAChD,mCAAmC;CACpC,CAAC,CAAC;AAEH,SAAgB,iCAAiC,CAC/C,IAAa;IAEb,IAAA,oBAAM,EAAC,IAAI,EAAE,uCAA+B,CAAC,CAAC;AAChD,CAAC;AAJD,8EAIC;AAED;;;;;GAKG;AACU,QAAA,4BAA4B,GAAG,IAAA,kBAAI,EAAC;IAC/C;;;OAGG;IACH,WAAW,EAAE,IAAA,sBAAQ,EAAC,iCAAoB,CAAC;CAC5C,CAAC,CAAC;AAEH,SAAgB,8BAA8B,CAC5C,IAAa;IAEb,IAAA,oBAAM,EAAC,IAAI,EAAE,oCAA4B,CAAC,CAAC;AAC7C,CAAC;AAJD,wEAIC","sourcesContent":["import {\n  string,\n  number,\n  enums,\n  union,\n  type,\n  assert,\n  optional,\n} from '@metamask/superstruct';\n\nimport { StatusResponseSchema } from '../utils/validators';\nimport {\n  BaseQuoteStatusUpdateErrorTypes,\n  QuoteStatusUpdateBackendOnChainMismatchTypes,\n  QuoteStatusBackendValues,\n} from './constants';\nimport { QuoteStatusGetResponse, QuoteStatusUpdateResponse } from './types';\n\nconst QuoteStatusUpdateResponseWithCurrentStatusSchema = type({\n  statusCode: number(),\n  message: string(),\n  type: enums(QuoteStatusUpdateBackendOnChainMismatchTypes),\n  currentStatus: enums(QuoteStatusBackendValues),\n  newStatus: enums(QuoteStatusBackendValues),\n});\n\nconst QuoteStatusUpdateResponseBaseSchema = type({\n  statusCode: number(),\n  message: string(),\n  type: enums(BaseQuoteStatusUpdateErrorTypes),\n});\n\nexport const QuoteStatusUpdateResponseSchema = union([\n  QuoteStatusUpdateResponseWithCurrentStatusSchema,\n  QuoteStatusUpdateResponseBaseSchema,\n]);\n\nexport function validateQuoteStatusUpdateResponse(\n  data: unknown,\n): asserts data is QuoteStatusUpdateResponse {\n  assert(data, QuoteStatusUpdateResponseSchema);\n}\n\n/**\n * **Note**: This struct is big and not all fields are used atm.\n * For that reason we have decided to only include the fields we\n * consume in production. In the future, once we need it to be strongly type,\n * we will refactor.\n */\nexport const QuoteStatusGetResponseSchema = type({\n  /**\n   * Submitted transaction: StatusResponseDto with at least srcChain (chainId + txHash).\n   * Prefilled by updateQuoteStatus; replaced with full provider status by getQuoteStatus.\n   */\n  submittedTx: optional(StatusResponseSchema),\n});\n\nexport function validateQuoteStatusGetResponse(\n  data: unknown,\n): asserts data is QuoteStatusGetResponse {\n  assert(data, QuoteStatusGetResponseSchema);\n}\n"]}

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

@@ -0,0 +1,172 @@
+import { QuoteStatusGetResponse, QuoteStatusUpdateResponse } from "./types.cjs";
+export declare const QuoteStatusUpdateResponseSchema: import("@metamask/superstruct").Struct<{
+    type: import("./constants.cjs").QuoteStatusUpdateBackendErrorType.InvalidStatusTransaction | import("./constants.cjs").QuoteStatusUpdateBackendErrorType.QuoteStatusOnChainMismatch;
+    message: string;
+    statusCode: number;
+    currentStatus: import("./constants.cjs").QuoteStatusBackendStatus;
+    newStatus: import("./constants.cjs").QuoteStatusBackendStatus;
+} | {
+    type: import("./constants.cjs").QuoteStatusUpdateBackendErrorType.QuoteNotFound | import("./constants.cjs").QuoteStatusUpdateBackendErrorType.ConcurrentUpdate | import("./constants.cjs").QuoteStatusUpdateBackendErrorType.SrcTxHashRequiredForFinalized | import("./constants.cjs").QuoteStatusUpdateBackendErrorType.PersistQuoteStatusFailed | import("./constants.cjs").QuoteStatusUpdateBackendErrorType.TransactionNotIndexed | import("./constants.cjs").QuoteStatusUpdateBackendErrorType.TxDataMissingHash | import("./constants.cjs").QuoteStatusUpdateBackendErrorType.TxDataMissingTrade | import("./constants.cjs").QuoteStatusUpdateBackendErrorType.TxDataMismatch | import("./constants.cjs").QuoteStatusUpdateBackendErrorType.SvmTradeDeserializeFailed;
+    message: string;
+    statusCode: number;
+}, null>;
+export declare function validateQuoteStatusUpdateResponse(data: unknown): asserts data is QuoteStatusUpdateResponse;
+/**
+ * **Note**: This struct is big and not all fields are used atm.
+ * For that reason we have decided to only include the fields we
+ * consume in production. In the future, once we need it to be strongly type,
+ * we will refactor.
+ */
+export declare const QuoteStatusGetResponseSchema: import("@metamask/superstruct").Struct<{
+    submittedTx?: {
+        status: import("@metamask/bridge-controller").StatusTypes;
+        srcChain: {
+            chainId: number;
+            txHash?: string | undefined;
+            amount?: string | undefined;
+            token?: {} | {
+                symbol: string;
+                chainId: number;
+                address: string;
+                assetId: `${string}:${string}/${string}:${string}`;
+                name: string;
+                decimals: number;
+                icon?: string | null | undefined;
+                iconUrl?: string | null | undefined;
+            } | undefined;
+        };
+        destChain?: {
+            chainId: number;
+            txHash?: string | undefined;
+            amount?: string | undefined;
+            token?: {} | {
+                symbol: string;
+                chainId: number;
+                address: string;
+                assetId: `${string}:${string}/${string}:${string}`;
+                name: string;
+                decimals: number;
+                icon?: string | null | undefined;
+                iconUrl?: string | null | undefined;
+            } | undefined;
+        } | undefined;
+        bridge?: string | undefined;
+        isExpectedToken?: boolean | undefined;
+        isUnrecognizedRouterAddress?: boolean | undefined;
+        refuel?: {} | undefined;
+    } | undefined;
+}, {
+    /**
+     * Submitted transaction: StatusResponseDto with at least srcChain (chainId + txHash).
+     * Prefilled by updateQuoteStatus; replaced with full provider status by getQuoteStatus.
+     */
+    submittedTx: import("@metamask/superstruct").Struct<{
+        status: import("@metamask/bridge-controller").StatusTypes;
+        srcChain: {
+            chainId: number;
+            txHash?: string | undefined;
+            amount?: string | undefined;
+            token?: {} | {
+                symbol: string;
+                chainId: number;
+                address: string;
+                assetId: `${string}:${string}/${string}:${string}`;
+                name: string;
+                decimals: number;
+                icon?: string | null | undefined;
+                iconUrl?: string | null | undefined;
+            } | undefined;
+        };
+        destChain?: {
+            chainId: number;
+            txHash?: string | undefined;
+            amount?: string | undefined;
+            token?: {} | {
+                symbol: string;
+                chainId: number;
+                address: string;
+                assetId: `${string}:${string}/${string}:${string}`;
+                name: string;
+                decimals: number;
+                icon?: string | null | undefined;
+                iconUrl?: string | null | undefined;
+            } | undefined;
+        } | undefined;
+        bridge?: string | undefined;
+        isExpectedToken?: boolean | undefined;
+        isUnrecognizedRouterAddress?: boolean | undefined;
+        refuel?: {} | undefined;
+    } | undefined, {
+        status: import("@metamask/superstruct").Struct<import("@metamask/bridge-controller").StatusTypes, {
+            SUBMITTED: import("@metamask/bridge-controller").StatusTypes.SUBMITTED;
+            UNKNOWN: import("@metamask/bridge-controller").StatusTypes.UNKNOWN;
+            FAILED: import("@metamask/bridge-controller").StatusTypes.FAILED;
+            PENDING: import("@metamask/bridge-controller").StatusTypes.PENDING;
+            COMPLETE: import("@metamask/bridge-controller").StatusTypes.COMPLETE;
+        }>;
+        srcChain: import("@metamask/superstruct").Struct<{
+            chainId: number;
+            txHash?: string | undefined;
+            amount?: string | undefined;
+            token?: {} | {
+                symbol: string;
+                chainId: number;
+                address: string;
+                assetId: `${string}:${string}/${string}:${string}`;
+                name: string;
+                decimals: number;
+                icon?: string | null | undefined;
+                iconUrl?: string | null | undefined;
+            } | undefined;
+        }, {
+            chainId: import("@metamask/superstruct").Struct<number, null>;
+            txHash: import("@metamask/superstruct").Struct<string | undefined, null>;
+            amount: import("@metamask/superstruct").Struct<string | undefined, null>;
+            token: import("@metamask/superstruct").Struct<{} | {
+                symbol: string;
+                chainId: number;
+                address: string;
+                assetId: `${string}:${string}/${string}:${string}`;
+                name: string;
+                decimals: number;
+                icon?: string | null | undefined;
+                iconUrl?: string | null | undefined;
+            } | undefined, null>;
+        }>;
+        destChain: import("@metamask/superstruct").Struct<{
+            chainId: number;
+            txHash?: string | undefined;
+            amount?: string | undefined;
+            token?: {} | {
+                symbol: string;
+                chainId: number;
+                address: string;
+                assetId: `${string}:${string}/${string}:${string}`;
+                name: string;
+                decimals: number;
+                icon?: string | null | undefined;
+                iconUrl?: string | null | undefined;
+            } | undefined;
+        } | undefined, {
+            chainId: import("@metamask/superstruct").Struct<number, null>;
+            txHash: import("@metamask/superstruct").Struct<string | undefined, null>;
+            amount: import("@metamask/superstruct").Struct<string | undefined, null>;
+            token: import("@metamask/superstruct").Struct<{} | {
+                symbol: string;
+                chainId: number;
+                address: string;
+                assetId: `${string}:${string}/${string}:${string}`;
+                name: string;
+                decimals: number;
+                icon?: string | null | undefined;
+                iconUrl?: string | null | undefined;
+            } | undefined, null>;
+        }>;
+        bridge: import("@metamask/superstruct").Struct<string | undefined, null>;
+        isExpectedToken: import("@metamask/superstruct").Struct<boolean | undefined, null>;
+        isUnrecognizedRouterAddress: import("@metamask/superstruct").Struct<boolean | undefined, null>;
+        refuel: import("@metamask/superstruct").Struct<{} | undefined, {}>;
+    }>;
+}>;
+export declare function validateQuoteStatusGetResponse(data: unknown): asserts data is QuoteStatusGetResponse;
+//# sourceMappingURL=validators.d.cts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validators.d.cts","sourceRoot":"","sources":["../../src/quote-status-manager/validators.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,oBAAgB;AAgB5E,eAAO,MAAM,+BAA+B;;;;;;;;;;QAG1C,CAAC;AAEH,wBAAgB,iCAAiC,CAC/C,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,IAAI,IAAI,yBAAyB,CAE3C;AAED;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IACvC;;;OAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEH,CAAC;AAEH,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,IAAI,IAAI,sBAAsB,CAExC"}