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

package/dist/quote-status-manager/quote-status-api-service.cjs

@@ -0,0 +1,241 @@
+"use strict";
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _QuoteStatusApiService_messenger, _QuoteStatusApiService_clientId, _QuoteStatusApiService_clientProduct, _QuoteStatusApiService_clientVersion, _QuoteStatusApiService_apiBaseUrl, _QuoteStatusApiService_onError;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QuoteStatusApiService = void 0;
+const bridge_controller_1 = require("@metamask/bridge-controller");
+const superstruct_1 = require("@metamask/superstruct");
+const types_1 = require("../types.cjs");
+const authentication_1 = require("../utils/authentication.cjs");
+const constants_1 = require("./constants.cjs");
+const errors_1 = require("./errors.cjs");
+const quote_status_get_with_retry_outcome_1 = require("./quote-status-get-with-retry-outcome.cjs");
+const quote_status_update_with_retry_outcome_1 = require("./quote-status-update-with-retry-outcome.cjs");
+const utils_1 = require("./utils.cjs");
+const validators_1 = require("./validators.cjs");
+/**
+ * Service responsible for calling bridge quote status update APIs.
+ *
+ * It performs authentication, sends properly-scoped client headers, and validates
+ * error responses so callers can handle known update-status failures.
+ */
+class QuoteStatusApiService {
+    /**
+     * Creates an API service for quote status update requests.
+     *
+     * @param options - Service dependencies and request configuration.
+     * @param options.messenger - Messenger used to retrieve the authentication token.
+     * @param options.clientId - Bridge client identifier used for request headers.
+     * @param options.clientProduct - Product name sent in client product headers.
+     * @param options.clientVersion - Optional client version sent in headers.
+     * @param options.apiBaseUrl - Base URL for the quote status API.
+     * @param options.onError - Optional callback for unexpected response-shape errors.
+     */
+    constructor({ messenger, clientId, clientProduct, clientVersion, apiBaseUrl, onError, }) {
+        _QuoteStatusApiService_messenger.set(this, void 0);
+        _QuoteStatusApiService_clientId.set(this, void 0);
+        _QuoteStatusApiService_clientProduct.set(this, void 0);
+        _QuoteStatusApiService_clientVersion.set(this, void 0);
+        _QuoteStatusApiService_apiBaseUrl.set(this, void 0);
+        _QuoteStatusApiService_onError.set(this, void 0);
+        __classPrivateFieldSet(this, _QuoteStatusApiService_messenger, messenger, "f");
+        __classPrivateFieldSet(this, _QuoteStatusApiService_clientId, clientId, "f");
+        __classPrivateFieldSet(this, _QuoteStatusApiService_clientProduct, clientProduct, "f");
+        __classPrivateFieldSet(this, _QuoteStatusApiService_clientVersion, clientVersion, "f");
+        __classPrivateFieldSet(this, _QuoteStatusApiService_apiBaseUrl, apiBaseUrl, "f");
+        __classPrivateFieldSet(this, _QuoteStatusApiService_onError, onError, "f");
+    }
+    /**
+     * Updates a quote status in the bridge quote-status API.
+     *
+     * The endpoint returns no payload on success (`2xx`) and a structured payload
+     * on non-`2xx` responses. This method returns `null` for successful updates and
+     * the validated error payload for unsuccessful updates.
+     *
+     * @param data - Request payload identifying quote and target status transition.
+     * @param data.quoteId - Unique quote identifier to update.
+     * @param data.srcTxHash - Source transaction hash associated with the quote.
+     * @param data.newStatus - Target quote status to persist.
+     * @param signal - Optional abort signal for canceling the request.
+     * @returns `null` for `2xx` responses, or a validated error response for non-`2xx`.
+     * @throws If the non-`2xx` response body does not match the expected schema.
+     */
+    async updateQuoteStatus(data, signal) {
+        const jwt = await (0, authentication_1.getJwt)(__classPrivateFieldGet(this, _QuoteStatusApiService_messenger, "f"));
+        // This method uses `globalThis.fetch` and reads the raw
+        // `Response` (including JSON on non-2xx). Wrappers like `handleFetch` that
+        // throw on non-2xx would prevent typed error handling in callers.
+        const res = await globalThis.fetch(`${__classPrivateFieldGet(this, _QuoteStatusApiService_apiBaseUrl, "f")}/quote/updateStatus`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'x-metamask-clientproduct': __classPrivateFieldGet(this, _QuoteStatusApiService_clientProduct, "f"),
+                ...(__classPrivateFieldGet(this, _QuoteStatusApiService_clientVersion, "f")
+                    ? { 'x-metamask-clientversion': __classPrivateFieldGet(this, _QuoteStatusApiService_clientVersion, "f") }
+                    : {}),
+                ...(0, bridge_controller_1.getClientHeaders)({
+                    clientId: __classPrivateFieldGet(this, _QuoteStatusApiService_clientId, "f"),
+                    jwt,
+                }),
+            },
+            body: JSON.stringify(data),
+            signal,
+        });
+        if (res.ok) {
+            return null;
+        }
+        const responseData = await res.json();
+        try {
+            (0, validators_1.validateQuoteStatusUpdateResponse)(responseData);
+            return responseData;
+        }
+        catch (error) {
+            __classPrivateFieldGet(this, _QuoteStatusApiService_onError, "f")?.call(this, new errors_1.QuoteStatusUpdateError('unexpected response shape from quote/updateStatus', { quoteId: data.quoteId }));
+            throw error;
+        }
+    }
+    async getQuoteStatus(data, signal) {
+        const jwt = await (0, authentication_1.getJwt)(__classPrivateFieldGet(this, _QuoteStatusApiService_messenger, "f"));
+        // This method uses `globalThis.fetch` and reads the raw
+        // `Response` (including JSON on non-2xx). Wrappers like `handleFetch` that
+        // throw on non-2xx would prevent typed error handling in callers.
+        const res = await globalThis.fetch(`${__classPrivateFieldGet(this, _QuoteStatusApiService_apiBaseUrl, "f")}/getQuoteStatus?quoteId=${data.quoteId}`, {
+            method: 'GET',
+            headers: {
+                'Content-Type': 'application/json',
+                'x-metamask-clientproduct': __classPrivateFieldGet(this, _QuoteStatusApiService_clientProduct, "f"),
+                ...(__classPrivateFieldGet(this, _QuoteStatusApiService_clientVersion, "f")
+                    ? { 'x-metamask-clientversion': __classPrivateFieldGet(this, _QuoteStatusApiService_clientVersion, "f") }
+                    : {}),
+                ...(0, bridge_controller_1.getClientHeaders)({
+                    clientId: __classPrivateFieldGet(this, _QuoteStatusApiService_clientId, "f"),
+                    jwt,
+                }),
+            },
+            signal,
+        });
+        if (!res.ok) {
+            // 5xx errors are transient (server-side); 4xx errors are client-side and
+            // non-retryable. The `retryable` flag lets `getQuoteStatusWithRetry`
+            // distinguish the two and only exit early for permanent failures.
+            const retryable = res.status >= 500;
+            const error = new errors_1.QuoteStatusGetError(`request error to getQuoteStatus [${res.status}: ${res.statusText}]`, { quoteId: data.quoteId }, retryable);
+            __classPrivateFieldGet(this, _QuoteStatusApiService_onError, "f")?.call(this, error);
+            throw error;
+        }
+        const responseData = await res.json();
+        try {
+            (0, validators_1.validateQuoteStatusGetResponse)(responseData);
+            return responseData;
+        }
+        catch (error) {
+            if (error instanceof superstruct_1.StructError) {
+                const validationFailures = [];
+                for (const { path } of error.failures()) {
+                    const aggregatorId = responseData?.submittedTx?.bridge ??
+                        'unknown';
+                    const pathString = path?.join('.') || 'unknown';
+                    validationFailures.push([aggregatorId, pathString].join('|'));
+                }
+                const validationError = new errors_1.QuoteStatusGetError('unexpected response shape from getQuoteStatus', { quoteId: data.quoteId, validationFailures });
+                __classPrivateFieldGet(this, _QuoteStatusApiService_onError, "f")?.call(this, validationError);
+                throw validationError;
+            }
+            throw error;
+        }
+    }
+    /**
+     * Updates a quote status, retrying on transient backend failures.
+     *
+     * Wraps {@link updateQuoteStatus} in a bounded retry loop. A request is only
+     * retried when the backend returns an error whose type is in
+     * {@link QuoteStatusUpdateRetryableBackendTypes}; any other error response
+     * resolves immediately as non-retryable. Retries are spaced by
+     * `options.delayMsBetweenRetries`, and both the abort signal and the optional
+     * `options.retry` predicate are checked before each attempt so an
+     * in-flight or pending retry can be cancelled (e.g. when the entry's status
+     * changed while sleeping between retries).
+     *
+     * @param data - Request payload identifying the quote and target transition.
+     * @param data.quoteId - Unique quote identifier to update.
+     * @param data.srcTxHash - Source transaction hash associated with the quote.
+     * @param data.newStatus - Target quote status to persist.
+     * @param options - Retry configuration.
+     * @param options.maxRetries - Maximum number of retries after the initial attempt.
+     * @param options.delayMsBetweenRetries - Delay in milliseconds between attempts.
+     * @param options.retry - Optional predicate checked before each attempt;
+     * when it returns `false` the loop stops early and resolves as `Interrupted`.
+     * @param signal - Optional abort signal for canceling the request and its retries.
+     * @returns An outcome describing how the update resolved:
+     * `Accepted` when the backend accepted the update, `NonRetryable` for a
+     * non-retryable error response, `Interrupted` when aborted, or
+     * `RetryableExhausted` when all retries were used up on retryable errors.
+     * @throws If a request rejects for a reason other than the abort signal (e.g.
+     * an unexpected response shape from {@link updateQuoteStatus}).
+     */
+    async updateQuoteStatusWithRetry(data, options, signal) {
+        for (let attempt = 0; attempt <= options.maxRetries; attempt += 1) {
+            if (attempt > 0) {
+                await (0, utils_1.sleep)(options.delayMsBetweenRetries);
+            }
+            if (signal?.aborted || options.retry?.() === false) {
+                return new quote_status_update_with_retry_outcome_1.QuoteStatusUpdateWithRetryOutcome(constants_1.QuoteStatusFetchWithRetryOutcomeType.Interrupted);
+            }
+            try {
+                const response = await this.updateQuoteStatus(data, signal);
+                if (response === null) {
+                    return new quote_status_update_with_retry_outcome_1.QuoteStatusUpdateWithRetryOutcome(constants_1.QuoteStatusFetchWithRetryOutcomeType.Accepted);
+                }
+                if (!constants_1.QuoteStatusUpdateRetryableBackendTypes.includes(response.type)) {
+                    return new quote_status_update_with_retry_outcome_1.QuoteStatusUpdateWithRetryOutcome(constants_1.QuoteStatusFetchWithRetryOutcomeType.NonRetryable, response);
+                }
+            }
+            catch (error) {
+                if (signal?.aborted) {
+                    return new quote_status_update_with_retry_outcome_1.QuoteStatusUpdateWithRetryOutcome(constants_1.QuoteStatusFetchWithRetryOutcomeType.Interrupted);
+                }
+                throw error;
+            }
+        }
+        return new quote_status_update_with_retry_outcome_1.QuoteStatusUpdateWithRetryOutcome(constants_1.QuoteStatusFetchWithRetryOutcomeType.RetryableExhausted);
+    }
+    async getQuoteStatusWithRetry(data, options, signal) {
+        for (let attempt = 0; attempt <= options.maxRetries; attempt += 1) {
+            if (attempt > 0) {
+                await (0, utils_1.sleep)(options.delayMsBetweenRetries);
+            }
+            if (signal?.aborted) {
+                return new quote_status_get_with_retry_outcome_1.QuoteStatusGetWithRetryOutcome(constants_1.QuoteStatusFetchWithRetryOutcomeType.Interrupted);
+            }
+            try {
+                const response = await this.getQuoteStatus(data, signal);
+                return new quote_status_get_with_retry_outcome_1.QuoteStatusGetWithRetryOutcome(constants_1.QuoteStatusFetchWithRetryOutcomeType.Accepted, response);
+            }
+            catch (error) {
+                if (signal?.aborted) {
+                    return new quote_status_get_with_retry_outcome_1.QuoteStatusGetWithRetryOutcome(constants_1.QuoteStatusFetchWithRetryOutcomeType.Interrupted);
+                }
+                // Only short-circuit for non-retryable errors (e.g. 4xx, validation
+                // failures). Retryable errors (e.g. 5xx) fall through so the loop can
+                // attempt the next retry instead of returning NonRetryable immediately.
+                if (error instanceof errors_1.QuoteStatusGetError && !error.retryable) {
+                    return new quote_status_get_with_retry_outcome_1.QuoteStatusGetWithRetryOutcome(constants_1.QuoteStatusFetchWithRetryOutcomeType.NonRetryable, undefined, error);
+                }
+            }
+        }
+        return new quote_status_get_with_retry_outcome_1.QuoteStatusGetWithRetryOutcome(constants_1.QuoteStatusFetchWithRetryOutcomeType.RetryableExhausted);
+    }
+}
+exports.QuoteStatusApiService = QuoteStatusApiService;
+_QuoteStatusApiService_messenger = new WeakMap(), _QuoteStatusApiService_clientId = new WeakMap(), _QuoteStatusApiService_clientProduct = new WeakMap(), _QuoteStatusApiService_clientVersion = new WeakMap(), _QuoteStatusApiService_apiBaseUrl = new WeakMap(), _QuoteStatusApiService_onError = new WeakMap();
+//# sourceMappingURL=quote-status-api-service.cjs.map

package/dist/quote-status-manager/quote-status-api-service.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"quote-status-api-service.cjs","sourceRoot":"","sources":["../../src/quote-status-manager/quote-status-api-service.ts"],"names":[],"mappings":"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","sourcesContent":["import { getClientHeaders } from '@metamask/bridge-controller';\nimport { StructError } from '@metamask/superstruct';\n\nimport { BridgeClientId, BridgeStatusControllerMessenger } from '../types';\nimport { getJwt } from '../utils/authentication';\nimport {\n  QuoteStatusBackendStatus,\n  QuoteStatusUpdateRetryableBackendTypes,\n  QuoteStatusFetchWithRetryOutcomeType,\n} from './constants';\nimport { QuoteStatusGetError, QuoteStatusUpdateError } from './errors';\nimport { QuoteStatusGetWithRetryOutcome } from './quote-status-get-with-retry-outcome';\nimport { QuoteStatusUpdateWithRetryOutcome } from './quote-status-update-with-retry-outcome';\nimport {\n  QuoteStatusApiServiceOptions,\n  QuoteStatusGetResponse,\n  QuoteStatusUpdateResponse,\n} from './types';\nimport { sleep } from './utils';\nimport {\n  validateQuoteStatusGetResponse,\n  validateQuoteStatusUpdateResponse,\n} from './validators';\n\n/**\n * Service responsible for calling bridge quote status update APIs.\n *\n * It performs authentication, sends properly-scoped client headers, and validates\n * error responses so callers can handle known update-status failures.\n */\nexport class QuoteStatusApiService {\n  readonly #messenger: BridgeStatusControllerMessenger;\n\n  readonly #clientId: BridgeClientId;\n\n  readonly #clientProduct: string;\n\n  readonly #clientVersion: string | undefined;\n\n  readonly #apiBaseUrl: string;\n\n  readonly #onError: ((error: QuoteStatusUpdateError) => void) | undefined;\n\n  /**\n   * Creates an API service for quote status update requests.\n   *\n   * @param options - Service dependencies and request configuration.\n   * @param options.messenger - Messenger used to retrieve the authentication token.\n   * @param options.clientId - Bridge client identifier used for request headers.\n   * @param options.clientProduct - Product name sent in client product headers.\n   * @param options.clientVersion - Optional client version sent in headers.\n   * @param options.apiBaseUrl - Base URL for the quote status API.\n   * @param options.onError - Optional callback for unexpected response-shape errors.\n   */\n  constructor({\n    messenger,\n    clientId,\n    clientProduct,\n    clientVersion,\n    apiBaseUrl,\n    onError,\n  }: QuoteStatusApiServiceOptions) {\n    this.#messenger = messenger;\n    this.#clientId = clientId;\n    this.#clientProduct = clientProduct;\n    this.#clientVersion = clientVersion;\n    this.#apiBaseUrl = apiBaseUrl;\n    this.#onError = onError;\n  }\n\n  /**\n   * Updates a quote status in the bridge quote-status API.\n   *\n   * The endpoint returns no payload on success (`2xx`) and a structured payload\n   * on non-`2xx` responses. This method returns `null` for successful updates and\n   * the validated error payload for unsuccessful updates.\n   *\n   * @param data - Request payload identifying quote and target status transition.\n   * @param data.quoteId - Unique quote identifier to update.\n   * @param data.srcTxHash - Source transaction hash associated with the quote.\n   * @param data.newStatus - Target quote status to persist.\n   * @param signal - Optional abort signal for canceling the request.\n   * @returns `null` for `2xx` responses, or a validated error response for non-`2xx`.\n   * @throws If the non-`2xx` response body does not match the expected schema.\n   */\n  async updateQuoteStatus(\n    data: {\n      quoteId: string;\n      srcTxHash: string;\n      newStatus: QuoteStatusBackendStatus;\n    },\n    signal?: AbortSignal,\n  ): Promise<QuoteStatusUpdateResponse | null> {\n    const jwt = await getJwt(this.#messenger);\n\n    // This method uses `globalThis.fetch` and reads the raw\n    // `Response` (including JSON on non-2xx). Wrappers like `handleFetch` that\n    // throw on non-2xx would prevent typed error handling in callers.\n    const res = await globalThis.fetch(\n      `${this.#apiBaseUrl}/quote/updateStatus`,\n      {\n        method: 'POST',\n        headers: {\n          'Content-Type': 'application/json',\n          'x-metamask-clientproduct': this.#clientProduct,\n          ...(this.#clientVersion\n            ? { 'x-metamask-clientversion': this.#clientVersion }\n            : {}),\n          ...getClientHeaders({\n            clientId: this.#clientId,\n            jwt,\n          }),\n        },\n        body: JSON.stringify(data),\n        signal,\n      },\n    );\n\n    if (res.ok) {\n      return null;\n    }\n\n    const responseData = await res.json();\n\n    try {\n      validateQuoteStatusUpdateResponse(responseData);\n      return responseData;\n    } catch (error) {\n      this.#onError?.(\n        new QuoteStatusUpdateError(\n          'unexpected response shape from quote/updateStatus',\n          { quoteId: data.quoteId },\n        ),\n      );\n      throw error;\n    }\n  }\n\n  async getQuoteStatus(\n    data: {\n      quoteId: string;\n    },\n    signal?: AbortSignal,\n  ): Promise<QuoteStatusGetResponse> {\n    const jwt = await getJwt(this.#messenger);\n\n    // This method uses `globalThis.fetch` and reads the raw\n    // `Response` (including JSON on non-2xx). Wrappers like `handleFetch` that\n    // throw on non-2xx would prevent typed error handling in callers.\n    const res = await globalThis.fetch(\n      `${this.#apiBaseUrl}/getQuoteStatus?quoteId=${data.quoteId}`,\n      {\n        method: 'GET',\n        headers: {\n          'Content-Type': 'application/json',\n          'x-metamask-clientproduct': this.#clientProduct,\n          ...(this.#clientVersion\n            ? { 'x-metamask-clientversion': this.#clientVersion }\n            : {}),\n          ...getClientHeaders({\n            clientId: this.#clientId,\n            jwt,\n          }),\n        },\n        signal,\n      },\n    );\n\n    if (!res.ok) {\n      // 5xx errors are transient (server-side); 4xx errors are client-side and\n      // non-retryable. The `retryable` flag lets `getQuoteStatusWithRetry`\n      // distinguish the two and only exit early for permanent failures.\n      const retryable = res.status >= 500;\n      const error = new QuoteStatusGetError(\n        `request error to getQuoteStatus [${res.status}: ${res.statusText}]`,\n        { quoteId: data.quoteId },\n        retryable,\n      );\n      this.#onError?.(error);\n      throw error;\n    }\n\n    const responseData = await res.json();\n\n    try {\n      validateQuoteStatusGetResponse(responseData);\n      return responseData;\n    } catch (error) {\n      if (error instanceof StructError) {\n        const validationFailures = [];\n\n        for (const { path } of error.failures()) {\n          const aggregatorId =\n            (responseData as QuoteStatusGetResponse)?.submittedTx?.bridge ??\n            ('unknown' as string);\n          const pathString = path?.join('.') || 'unknown';\n          validationFailures.push([aggregatorId, pathString].join('|'));\n        }\n\n        const validationError = new QuoteStatusGetError(\n          'unexpected response shape from getQuoteStatus',\n          { quoteId: data.quoteId, validationFailures },\n        );\n\n        this.#onError?.(validationError);\n\n        throw validationError;\n      }\n\n      throw error;\n    }\n  }\n\n  /**\n   * Updates a quote status, retrying on transient backend failures.\n   *\n   * Wraps {@link updateQuoteStatus} in a bounded retry loop. A request is only\n   * retried when the backend returns an error whose type is in\n   * {@link QuoteStatusUpdateRetryableBackendTypes}; any other error response\n   * resolves immediately as non-retryable. Retries are spaced by\n   * `options.delayMsBetweenRetries`, and both the abort signal and the optional\n   * `options.retry` predicate are checked before each attempt so an\n   * in-flight or pending retry can be cancelled (e.g. when the entry's status\n   * changed while sleeping between retries).\n   *\n   * @param data - Request payload identifying the quote and target transition.\n   * @param data.quoteId - Unique quote identifier to update.\n   * @param data.srcTxHash - Source transaction hash associated with the quote.\n   * @param data.newStatus - Target quote status to persist.\n   * @param options - Retry configuration.\n   * @param options.maxRetries - Maximum number of retries after the initial attempt.\n   * @param options.delayMsBetweenRetries - Delay in milliseconds between attempts.\n   * @param options.retry - Optional predicate checked before each attempt;\n   * when it returns `false` the loop stops early and resolves as `Interrupted`.\n   * @param signal - Optional abort signal for canceling the request and its retries.\n   * @returns An outcome describing how the update resolved:\n   * `Accepted` when the backend accepted the update, `NonRetryable` for a\n   * non-retryable error response, `Interrupted` when aborted, or\n   * `RetryableExhausted` when all retries were used up on retryable errors.\n   * @throws If a request rejects for a reason other than the abort signal (e.g.\n   * an unexpected response shape from {@link updateQuoteStatus}).\n   */\n  async updateQuoteStatusWithRetry(\n    data: {\n      quoteId: string;\n      srcTxHash: string;\n      newStatus: QuoteStatusBackendStatus;\n    },\n    options: {\n      maxRetries: number;\n      delayMsBetweenRetries: number;\n      retry?: () => boolean;\n    },\n    signal?: AbortSignal,\n  ): Promise<QuoteStatusUpdateWithRetryOutcome> {\n    for (let attempt = 0; attempt <= options.maxRetries; attempt += 1) {\n      if (attempt > 0) {\n        await sleep(options.delayMsBetweenRetries);\n      }\n\n      if (signal?.aborted || options.retry?.() === false) {\n        return new QuoteStatusUpdateWithRetryOutcome(\n          QuoteStatusFetchWithRetryOutcomeType.Interrupted,\n        );\n      }\n\n      try {\n        const response = await this.updateQuoteStatus(data, signal);\n\n        if (response === null) {\n          return new QuoteStatusUpdateWithRetryOutcome(\n            QuoteStatusFetchWithRetryOutcomeType.Accepted,\n          );\n        }\n\n        if (!QuoteStatusUpdateRetryableBackendTypes.includes(response.type)) {\n          return new QuoteStatusUpdateWithRetryOutcome(\n            QuoteStatusFetchWithRetryOutcomeType.NonRetryable,\n            response,\n          );\n        }\n      } catch (error) {\n        if (signal?.aborted) {\n          return new QuoteStatusUpdateWithRetryOutcome(\n            QuoteStatusFetchWithRetryOutcomeType.Interrupted,\n          );\n        }\n\n        throw error;\n      }\n    }\n\n    return new QuoteStatusUpdateWithRetryOutcome(\n      QuoteStatusFetchWithRetryOutcomeType.RetryableExhausted,\n    );\n  }\n\n  async getQuoteStatusWithRetry(\n    data: {\n      quoteId: string;\n    },\n    options: {\n      maxRetries: number;\n      delayMsBetweenRetries: number;\n    },\n    signal?: AbortSignal,\n  ): Promise<QuoteStatusGetWithRetryOutcome> {\n    for (let attempt = 0; attempt <= options.maxRetries; attempt += 1) {\n      if (attempt > 0) {\n        await sleep(options.delayMsBetweenRetries);\n      }\n\n      if (signal?.aborted) {\n        return new QuoteStatusGetWithRetryOutcome(\n          QuoteStatusFetchWithRetryOutcomeType.Interrupted,\n        );\n      }\n\n      try {\n        const response = await this.getQuoteStatus(data, signal);\n\n        return new QuoteStatusGetWithRetryOutcome(\n          QuoteStatusFetchWithRetryOutcomeType.Accepted,\n          response,\n        );\n      } catch (error) {\n        if (signal?.aborted) {\n          return new QuoteStatusGetWithRetryOutcome(\n            QuoteStatusFetchWithRetryOutcomeType.Interrupted,\n          );\n        }\n\n        // Only short-circuit for non-retryable errors (e.g. 4xx, validation\n        // failures). Retryable errors (e.g. 5xx) fall through so the loop can\n        // attempt the next retry instead of returning NonRetryable immediately.\n        if (error instanceof QuoteStatusGetError && !error.retryable) {\n          return new QuoteStatusGetWithRetryOutcome(\n            QuoteStatusFetchWithRetryOutcomeType.NonRetryable,\n            undefined,\n            error,\n          );\n        }\n      }\n    }\n\n    return new QuoteStatusGetWithRetryOutcome(\n      QuoteStatusFetchWithRetryOutcomeType.RetryableExhausted,\n    );\n  }\n}\n"]}

package/dist/quote-status-manager/quote-status-api-service.d.cts

@@ -0,0 +1,93 @@
+import { QuoteStatusBackendStatus } from "./constants.cjs";
+import { QuoteStatusGetWithRetryOutcome } from "./quote-status-get-with-retry-outcome.cjs";
+import { QuoteStatusUpdateWithRetryOutcome } from "./quote-status-update-with-retry-outcome.cjs";
+import { QuoteStatusApiServiceOptions, QuoteStatusGetResponse, QuoteStatusUpdateResponse } from "./types.cjs";
+/**
+ * Service responsible for calling bridge quote status update APIs.
+ *
+ * It performs authentication, sends properly-scoped client headers, and validates
+ * error responses so callers can handle known update-status failures.
+ */
+export declare class QuoteStatusApiService {
+    #private;
+    /**
+     * Creates an API service for quote status update requests.
+     *
+     * @param options - Service dependencies and request configuration.
+     * @param options.messenger - Messenger used to retrieve the authentication token.
+     * @param options.clientId - Bridge client identifier used for request headers.
+     * @param options.clientProduct - Product name sent in client product headers.
+     * @param options.clientVersion - Optional client version sent in headers.
+     * @param options.apiBaseUrl - Base URL for the quote status API.
+     * @param options.onError - Optional callback for unexpected response-shape errors.
+     */
+    constructor({ messenger, clientId, clientProduct, clientVersion, apiBaseUrl, onError, }: QuoteStatusApiServiceOptions);
+    /**
+     * Updates a quote status in the bridge quote-status API.
+     *
+     * The endpoint returns no payload on success (`2xx`) and a structured payload
+     * on non-`2xx` responses. This method returns `null` for successful updates and
+     * the validated error payload for unsuccessful updates.
+     *
+     * @param data - Request payload identifying quote and target status transition.
+     * @param data.quoteId - Unique quote identifier to update.
+     * @param data.srcTxHash - Source transaction hash associated with the quote.
+     * @param data.newStatus - Target quote status to persist.
+     * @param signal - Optional abort signal for canceling the request.
+     * @returns `null` for `2xx` responses, or a validated error response for non-`2xx`.
+     * @throws If the non-`2xx` response body does not match the expected schema.
+     */
+    updateQuoteStatus(data: {
+        quoteId: string;
+        srcTxHash: string;
+        newStatus: QuoteStatusBackendStatus;
+    }, signal?: AbortSignal): Promise<QuoteStatusUpdateResponse | null>;
+    getQuoteStatus(data: {
+        quoteId: string;
+    }, signal?: AbortSignal): Promise<QuoteStatusGetResponse>;
+    /**
+     * Updates a quote status, retrying on transient backend failures.
+     *
+     * Wraps {@link updateQuoteStatus} in a bounded retry loop. A request is only
+     * retried when the backend returns an error whose type is in
+     * {@link QuoteStatusUpdateRetryableBackendTypes}; any other error response
+     * resolves immediately as non-retryable. Retries are spaced by
+     * `options.delayMsBetweenRetries`, and both the abort signal and the optional
+     * `options.retry` predicate are checked before each attempt so an
+     * in-flight or pending retry can be cancelled (e.g. when the entry's status
+     * changed while sleeping between retries).
+     *
+     * @param data - Request payload identifying the quote and target transition.
+     * @param data.quoteId - Unique quote identifier to update.
+     * @param data.srcTxHash - Source transaction hash associated with the quote.
+     * @param data.newStatus - Target quote status to persist.
+     * @param options - Retry configuration.
+     * @param options.maxRetries - Maximum number of retries after the initial attempt.
+     * @param options.delayMsBetweenRetries - Delay in milliseconds between attempts.
+     * @param options.retry - Optional predicate checked before each attempt;
+     * when it returns `false` the loop stops early and resolves as `Interrupted`.
+     * @param signal - Optional abort signal for canceling the request and its retries.
+     * @returns An outcome describing how the update resolved:
+     * `Accepted` when the backend accepted the update, `NonRetryable` for a
+     * non-retryable error response, `Interrupted` when aborted, or
+     * `RetryableExhausted` when all retries were used up on retryable errors.
+     * @throws If a request rejects for a reason other than the abort signal (e.g.
+     * an unexpected response shape from {@link updateQuoteStatus}).
+     */
+    updateQuoteStatusWithRetry(data: {
+        quoteId: string;
+        srcTxHash: string;
+        newStatus: QuoteStatusBackendStatus;
+    }, options: {
+        maxRetries: number;
+        delayMsBetweenRetries: number;
+        retry?: () => boolean;
+    }, signal?: AbortSignal): Promise<QuoteStatusUpdateWithRetryOutcome>;
+    getQuoteStatusWithRetry(data: {
+        quoteId: string;
+    }, options: {
+        maxRetries: number;
+        delayMsBetweenRetries: number;
+    }, signal?: AbortSignal): Promise<QuoteStatusGetWithRetryOutcome>;
+}
+//# sourceMappingURL=quote-status-api-service.d.cts.map

package/dist/quote-status-manager/quote-status-api-service.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quote-status-api-service.d.cts","sourceRoot":"","sources":["../../src/quote-status-manager/quote-status-api-service.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,wBAAwB,EAGzB,wBAAoB;AAErB,OAAO,EAAE,8BAA8B,EAAE,kDAA8C;AACvF,OAAO,EAAE,iCAAiC,EAAE,qDAAiD;AAC7F,OAAO,EACL,4BAA4B,EAC5B,sBAAsB,EACtB,yBAAyB,EAC1B,oBAAgB;AAOjB;;;;;GAKG;AACH,qBAAa,qBAAqB;;IAahC;;;;;;;;;;OAUG;gBACS,EACV,SAAS,EACT,QAAQ,EACR,aAAa,EACb,aAAa,EACb,UAAU,EACV,OAAO,GACR,EAAE,4BAA4B;IAS/B;;;;;;;;;;;;;;OAcG;IACG,iBAAiB,CACrB,IAAI,EAAE;QACJ,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,wBAAwB,CAAC;KACrC,EACD,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC;IA8CtC,cAAc,CAClB,IAAI,EAAE;QACJ,OAAO,EAAE,MAAM,CAAC;KACjB,EACD,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,sBAAsB,CAAC;IAsElC;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACG,0BAA0B,CAC9B,IAAI,EAAE;QACJ,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,wBAAwB,CAAC;KACrC,EACD,OAAO,EAAE;QACP,UAAU,EAAE,MAAM,CAAC;QACnB,qBAAqB,EAAE,MAAM,CAAC;QAC9B,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC;KACvB,EACD,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,iCAAiC,CAAC;IA2CvC,uBAAuB,CAC3B,IAAI,EAAE;QACJ,OAAO,EAAE,MAAM,CAAC;KACjB,EACD,OAAO,EAAE;QACP,UAAU,EAAE,MAAM,CAAC;QACnB,qBAAqB,EAAE,MAAM,CAAC;KAC/B,EACD,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,8BAA8B,CAAC;CA2C3C"}

package/dist/quote-status-manager/quote-status-api-service.d.mts

@@ -0,0 +1,93 @@
+import { QuoteStatusBackendStatus } from "./constants.mjs";
+import { QuoteStatusGetWithRetryOutcome } from "./quote-status-get-with-retry-outcome.mjs";
+import { QuoteStatusUpdateWithRetryOutcome } from "./quote-status-update-with-retry-outcome.mjs";
+import { QuoteStatusApiServiceOptions, QuoteStatusGetResponse, QuoteStatusUpdateResponse } from "./types.mjs";
+/**
+ * Service responsible for calling bridge quote status update APIs.
+ *
+ * It performs authentication, sends properly-scoped client headers, and validates
+ * error responses so callers can handle known update-status failures.
+ */
+export declare class QuoteStatusApiService {
+    #private;
+    /**
+     * Creates an API service for quote status update requests.
+     *
+     * @param options - Service dependencies and request configuration.
+     * @param options.messenger - Messenger used to retrieve the authentication token.
+     * @param options.clientId - Bridge client identifier used for request headers.
+     * @param options.clientProduct - Product name sent in client product headers.
+     * @param options.clientVersion - Optional client version sent in headers.
+     * @param options.apiBaseUrl - Base URL for the quote status API.
+     * @param options.onError - Optional callback for unexpected response-shape errors.
+     */
+    constructor({ messenger, clientId, clientProduct, clientVersion, apiBaseUrl, onError, }: QuoteStatusApiServiceOptions);
+    /**
+     * Updates a quote status in the bridge quote-status API.
+     *
+     * The endpoint returns no payload on success (`2xx`) and a structured payload
+     * on non-`2xx` responses. This method returns `null` for successful updates and
+     * the validated error payload for unsuccessful updates.
+     *
+     * @param data - Request payload identifying quote and target status transition.
+     * @param data.quoteId - Unique quote identifier to update.
+     * @param data.srcTxHash - Source transaction hash associated with the quote.
+     * @param data.newStatus - Target quote status to persist.
+     * @param signal - Optional abort signal for canceling the request.
+     * @returns `null` for `2xx` responses, or a validated error response for non-`2xx`.
+     * @throws If the non-`2xx` response body does not match the expected schema.
+     */
+    updateQuoteStatus(data: {
+        quoteId: string;
+        srcTxHash: string;
+        newStatus: QuoteStatusBackendStatus;
+    }, signal?: AbortSignal): Promise<QuoteStatusUpdateResponse | null>;
+    getQuoteStatus(data: {
+        quoteId: string;
+    }, signal?: AbortSignal): Promise<QuoteStatusGetResponse>;
+    /**
+     * Updates a quote status, retrying on transient backend failures.
+     *
+     * Wraps {@link updateQuoteStatus} in a bounded retry loop. A request is only
+     * retried when the backend returns an error whose type is in
+     * {@link QuoteStatusUpdateRetryableBackendTypes}; any other error response
+     * resolves immediately as non-retryable. Retries are spaced by
+     * `options.delayMsBetweenRetries`, and both the abort signal and the optional
+     * `options.retry` predicate are checked before each attempt so an
+     * in-flight or pending retry can be cancelled (e.g. when the entry's status
+     * changed while sleeping between retries).
+     *
+     * @param data - Request payload identifying the quote and target transition.
+     * @param data.quoteId - Unique quote identifier to update.
+     * @param data.srcTxHash - Source transaction hash associated with the quote.
+     * @param data.newStatus - Target quote status to persist.
+     * @param options - Retry configuration.
+     * @param options.maxRetries - Maximum number of retries after the initial attempt.
+     * @param options.delayMsBetweenRetries - Delay in milliseconds between attempts.
+     * @param options.retry - Optional predicate checked before each attempt;
+     * when it returns `false` the loop stops early and resolves as `Interrupted`.
+     * @param signal - Optional abort signal for canceling the request and its retries.
+     * @returns An outcome describing how the update resolved:
+     * `Accepted` when the backend accepted the update, `NonRetryable` for a
+     * non-retryable error response, `Interrupted` when aborted, or
+     * `RetryableExhausted` when all retries were used up on retryable errors.
+     * @throws If a request rejects for a reason other than the abort signal (e.g.
+     * an unexpected response shape from {@link updateQuoteStatus}).
+     */
+    updateQuoteStatusWithRetry(data: {
+        quoteId: string;
+        srcTxHash: string;
+        newStatus: QuoteStatusBackendStatus;
+    }, options: {
+        maxRetries: number;
+        delayMsBetweenRetries: number;
+        retry?: () => boolean;
+    }, signal?: AbortSignal): Promise<QuoteStatusUpdateWithRetryOutcome>;
+    getQuoteStatusWithRetry(data: {
+        quoteId: string;
+    }, options: {
+        maxRetries: number;
+        delayMsBetweenRetries: number;
+    }, signal?: AbortSignal): Promise<QuoteStatusGetWithRetryOutcome>;
+}
+//# sourceMappingURL=quote-status-api-service.d.mts.map

package/dist/quote-status-manager/quote-status-api-service.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"quote-status-api-service.d.mts","sourceRoot":"","sources":["../../src/quote-status-manager/quote-status-api-service.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,wBAAwB,EAGzB,wBAAoB;AAErB,OAAO,EAAE,8BAA8B,EAAE,kDAA8C;AACvF,OAAO,EAAE,iCAAiC,EAAE,qDAAiD;AAC7F,OAAO,EACL,4BAA4B,EAC5B,sBAAsB,EACtB,yBAAyB,EAC1B,oBAAgB;AAOjB;;;;;GAKG;AACH,qBAAa,qBAAqB;;IAahC;;;;;;;;;;OAUG;gBACS,EACV,SAAS,EACT,QAAQ,EACR,aAAa,EACb,aAAa,EACb,UAAU,EACV,OAAO,GACR,EAAE,4BAA4B;IAS/B;;;;;;;;;;;;;;OAcG;IACG,iBAAiB,CACrB,IAAI,EAAE;QACJ,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,wBAAwB,CAAC;KACrC,EACD,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC;IA8CtC,cAAc,CAClB,IAAI,EAAE;QACJ,OAAO,EAAE,MAAM,CAAC;KACjB,EACD,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,sBAAsB,CAAC;IAsElC;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;IACG,0BAA0B,CAC9B,IAAI,EAAE;QACJ,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,wBAAwB,CAAC;KACrC,EACD,OAAO,EAAE;QACP,UAAU,EAAE,MAAM,CAAC;QACnB,qBAAqB,EAAE,MAAM,CAAC;QAC9B,KAAK,CAAC,EAAE,MAAM,OAAO,CAAC;KACvB,EACD,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,iCAAiC,CAAC;IA2CvC,uBAAuB,CAC3B,IAAI,EAAE;QACJ,OAAO,EAAE,MAAM,CAAC;KACjB,EACD,OAAO,EAAE;QACP,UAAU,EAAE,MAAM,CAAC;QACnB,qBAAqB,EAAE,MAAM,CAAC;KAC/B,EACD,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,8BAA8B,CAAC;CA2C3C"}