@metamask-previews/snap-networks-utils 3.0.0-preview-3ca061e → 3.0.0-preview-80f0b922

package/CHANGELOG.md

@@ -7,6 +7,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- Add `executeWithFetchPolicy` for wrapping transport-only operations in a policy created by `createFetchPolicy`, passing `SyntaxError` and abort errors through unchanged, passing errors already in the policy shape through unchanged, and mapping any other error with an optional mapper (defaulting to a network failure) ([#478](https://github.com/MetaMask/internal-snaps/pull/478))
+- Add `fetchWithPolicy` for the common policy-wrapped HTTP call: a fetch with a 10 second timeout, a status check that throws a `FetchPolicyError` for non-2xx responses (honouring `Retry-After`), and a body read inside the policy ([#478](https://github.com/MetaMask/internal-snaps/pull/478))
+- Add `parseRetryAfter` for parsing a `Retry-After` header value as milliseconds ([#478](https://github.com/MetaMask/internal-snaps/pull/478))
+- Add the `FetchPolicy` type, the minimal policy surface `executeWithFetchPolicy` and `fetchWithPolicy` accept ([#478](https://github.com/MetaMask/internal-snaps/pull/478))
+
 ## [3.0.0]
 
 ### Added

package/dist/index.d.mts

@@ -34,6 +34,8 @@ export { createSnapErrorHandling, createTrackError, createWithCatchAndThrowSnapE
 export { InFlightCoalescer } from "./utils/dedupe/InFlightCoalescer.mjs";
 export { BrokenCircuitError, createFetchPolicy, createFetchPolicyError, FetchPolicyErrorName, isTransientError, MAX_RETRY_AFTER_MS, } from "./utils/fetchPolicy/createFetchPolicy.mjs";
 export type { CreateFetchPolicyOptions, FetchPolicyError, } from "./utils/fetchPolicy/createFetchPolicy.mjs";
+export { executeWithFetchPolicy, fetchWithPolicy, parseRetryAfter, } from "./utils/fetchPolicy/executeWithFetchPolicy.mjs";
+export type { FetchPolicy } from "./utils/fetchPolicy/executeWithFetchPolicy.mjs";
 export { ActionHeader } from "./ui/ActionHeader/ActionHeader.mjs";
 export type { ActionHeaderProps } from "./ui/ActionHeader/ActionHeader.mjs";
 export { Asset, AssetIcon } from "./ui/Asset/Asset.mjs";

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,KAAK,uBAAuB,GAC7B,8CAA0C;AAC3C,OAAO,EACL,kCAAkC,EAClC,0BAA0B,EAC1B,KAAK,mCAAmC,GACzC,wEAAoE;AACrE,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,GACrB,kDAA8C;AAC/C,YAAY,EACV,uBAAuB,EACvB,oCAAoC,EACpC,oCAAoC,EACpC,qBAAqB,EACrB,yBAAyB,EACzB,0BAA0B,EAC1B,mCAAmC,EACnC,wCAAwC,GACzC,kDAA8C;AAC/C,OAAO,EAAE,SAAS,EAAE,wCAAoC;AACxD,OAAO,EACL,0BAA0B,EAC1B,iCAAiC,GAClC,oDAAgD;AACjD,OAAO,EAAE,QAAQ,EAAE,sCAAkC;AACrD,YAAY,EAAE,cAAc,EAAE,sCAAkC;AAChE,OAAO,EACL,yBAAyB,EACzB,WAAW,GACZ,sCAAkC;AACnC,OAAO,EAAE,SAAS,EAAE,wCAAoC;AACxD,OAAO,EAAE,UAAU,EAAE,0CAAsC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,kDAA8C;AAC/E,YAAY,EACV,sBAAsB,EACtB,uBAAuB,GACxB,kDAA8C;AAC/C,OAAO,EAAE,QAAQ,EAAE,oCAAgC;AACnD,OAAO,EAAE,kBAAkB,EAAE,8CAA0C;AACvE,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,GACjB,sCAAkC;AACnC,OAAO,EAAE,cAAc,EAAE,0CAAsC;AAC/D,OAAO,EACL,WAAW,EACX,iBAAiB,GAClB,6CAAyC;AAC1C,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,2BAA2B,EAC3B,oBAAoB,EACpB,MAAM,GACP,gCAA4B;AAC7B,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,kCAA8B;AACzD,YAAY,EACV,aAAa,EACb,YAAY,EACZ,SAAS,EACT,kBAAkB,EAClB,gBAAgB,GACjB,kCAA8B;AAC/B,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,gDAA4C;AAC7E,YAAY,EAAE,YAAY,EAAE,wCAAoC;AAChE,OAAO,EACL,4BAA4B,EAC5B,gCAAgC,EAChC,uCAAuC,EACvC,sCAAsC,EACtC,wCAAwC,EACxC,mCAAmC,EACnC,kCAAkC,EAClC,6BAA6B,EAC7B,iCAAiC,GAClC,sDAAkD;AACnD,YAAY,EACV,0BAA0B,EAC1B,iCAAiC,EACjC,gCAAgC,EAChC,kCAAkC,EAClC,6BAA6B,EAC7B,4BAA4B,EAC5B,uBAAuB,GACxB,sDAAkD;AACnD,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,uBAAuB,GACxB,8DAA0D;AAC3D,YAAY,EAAE,6BAA6B,EAAE,8DAA0D;AACvG,OAAO,EAAE,cAAc,EAAE,qDAAiD;AAC1E,OAAO,EAAE,KAAK,EAAE,gCAA4B;AAC5C,YAAY,EAAE,WAAW,EAAE,gCAA4B;AACvD,OAAO,EAAE,aAAa,EAAE,wCAAoC;AAC5D,YAAY,EAAE,aAAa,EAAE,wCAAoC;AACjE,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,gCAAgC,EAChC,yBAAyB,EACzB,gCAAgC,EAChC,cAAc,EACd,cAAc,EACd,eAAe,EACf,oBAAoB,GACrB,iCAAuB;AACxB,OAAO,EAAE,iBAAiB,EAAE,6CAAyC;AACrE,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,GACnB,kDAA8C;AAC/C,YAAY,EACV,wBAAwB,EACxB,gBAAgB,GACjB,kDAA8C;AAC/C,OAAO,EAAE,YAAY,EAAE,2CAAuC;AAC9D,YAAY,EAAE,iBAAiB,EAAE,2CAAuC;AACxE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,6BAAyB;AACpD,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,6BAAyB;AACnE,OAAO,EAAE,gBAAgB,EAAE,mDAA+C;AAC1E,YAAY,EACV,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,GACtB,mDAA+C;AAChD,OAAO,EAAE,gBAAgB,EAAE,mDAA+C;AAC1E,YAAY,EACV,qBAAqB,EACrB,sBAAsB,EACtB,qBAAqB,EACrB,0BAA0B,GAC3B,mDAA+C;AAChD,OAAO,EAAE,aAAa,EAAE,wCAAoC;AAC5D,OAAO,EAAE,UAAU,EAAE,qCAAiC;AACtD,OAAO,EAAE,QAAQ,EAAE,mCAA+B;AAClD,OAAO,EAAE,aAAa,EAAE,wCAAoC;AAC5D,YAAY,EAAE,YAAY,EAAE,mCAA+B;AAC3D,YAAY,EACV,iBAAiB,EACjB,gBAAgB,GACjB,wCAAoC;AACrC,YAAY,EACV,MAAM,EACN,UAAU,EACV,qBAAqB,GACtB,gCAA4B;AAC7B,YAAY,EACV,iBAAiB,EACjB,UAAU,EACV,WAAW,EACX,UAAU,GACX,qCAAiC;AAClC,OAAO,EACL,iBAAiB,EACjB,gBAAgB,GACjB,8CAA0C;AAC3C,YAAY,EACV,YAAY,EACZ,0BAA0B,GAC3B,8CAA0C;AAC3C,YAAY,EACV,kBAAkB,EAClB,8BAA8B,EAC9B,uBAAuB,EACvB,uCAAuC,EACvC,UAAU,EACV,gBAAgB,EAChB,yBAAyB,EACzB,kBAAkB,EAClB,YAAY,EACZ,qBAAqB,EACrB,yBAAyB,EACzB,YAAY,GACb,iCAAuB"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.mjs

@@ -24,6 +24,7 @@ export { InMemoryState } from "./utils/state/InMemoryState.mjs";
 export { createSnapErrorHandling, createTrackError, createWithCatchAndThrowSnapError, formatAccountSyncFailures, getSyncFailuresFromSettledResult, isSnapRpcError, normalizeError, stringifyReason, SynchronizationError } from "./utils/errors/index.mjs";
 export { InFlightCoalescer } from "./utils/dedupe/InFlightCoalescer.mjs";
 export { BrokenCircuitError, createFetchPolicy, createFetchPolicyError, FetchPolicyErrorName, isTransientError, MAX_RETRY_AFTER_MS } from "./utils/fetchPolicy/createFetchPolicy.mjs";
+export { executeWithFetchPolicy, fetchWithPolicy, parseRetryAfter } from "./utils/fetchPolicy/executeWithFetchPolicy.mjs";
 export { ActionHeader } from "./ui/ActionHeader/ActionHeader.mjs";
 export { Asset, AssetIcon } from "./ui/Asset/Asset.mjs";
 export { EstimatedChanges } from "./ui/EstimatedChanges/EstimatedChanges.mjs";

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,cAAc,EAEf,8CAA0C;AAC3C,OAAO,EACL,kCAAkC,EAClC,0BAA0B,EAE3B,wEAAoE;AACrE,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACrB,kDAA8C;AAW/C,OAAO,EAAE,SAAS,EAAE,wCAAoC;AACxD,OAAO,EACL,0BAA0B,EAC1B,iCAAiC,EAClC,oDAAgD;AACjD,OAAO,EAAE,QAAQ,EAAE,sCAAkC;AAErD,OAAO,EACL,yBAAyB,EACzB,WAAW,EACZ,sCAAkC;AACnC,OAAO,EAAE,SAAS,EAAE,wCAAoC;AACxD,OAAO,EAAE,UAAU,EAAE,0CAAsC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,kDAA8C;AAK/E,OAAO,EAAE,QAAQ,EAAE,oCAAgC;AACnD,OAAO,EAAE,kBAAkB,EAAE,8CAA0C;AACvE,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EACjB,sCAAkC;AACnC,OAAO,EAAE,cAAc,EAAE,0CAAsC;AAC/D,OAAO,EACL,WAAW,EACX,iBAAiB,EAClB,6CAAyC;AAC1C,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,2BAA2B,EAC3B,oBAAoB,EACpB,MAAM,EACP,gCAA4B;AAC7B,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,kCAA8B;AAQzD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,gDAA4C;AAE7E,OAAO,EACL,4BAA4B,EAC5B,gCAAgC,EAChC,uCAAuC,EACvC,sCAAsC,EACtC,wCAAwC,EACxC,mCAAmC,EACnC,kCAAkC,EAClC,6BAA6B,EAC7B,iCAAiC,EAClC,sDAAkD;AAUnD,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,uBAAuB,EACxB,8DAA0D;AAE3D,OAAO,EAAE,cAAc,EAAE,qDAAiD;AAC1E,OAAO,EAAE,KAAK,EAAE,gCAA4B;AAE5C,OAAO,EAAE,aAAa,EAAE,wCAAoC;AAE5D,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,gCAAgC,EAChC,yBAAyB,EACzB,gCAAgC,EAChC,cAAc,EACd,cAAc,EACd,eAAe,EACf,oBAAoB,EACrB,iCAAuB;AACxB,OAAO,EAAE,iBAAiB,EAAE,6CAAyC;AACrE,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EACnB,kDAA8C;AAK/C,OAAO,EAAE,YAAY,EAAE,2CAAuC;AAE9D,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,6BAAyB;AAEpD,OAAO,EAAE,gBAAgB,EAAE,mDAA+C;AAM1E,OAAO,EAAE,gBAAgB,EAAE,mDAA+C;AAO1E,OAAO,EAAE,aAAa,EAAE,wCAAoC;AAC5D,OAAO,EAAE,UAAU,EAAE,qCAAiC;AACtD,OAAO,EAAE,QAAQ,EAAE,mCAA+B;AAClD,OAAO,EAAE,aAAa,EAAE,wCAAoC;AAiB5D,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EACjB,8CAA0C","sourcesContent":["export {\n  ASSETS_PROVIDER_NAME,\n  AssetsProvider,\n  type AssetsProviderMessenger,\n} from './providers/assets/AssetsProvider';\nexport {\n  REMOTE_FEATURE_FLAGS_PROVIDER_NAME,\n  RemoteFeatureFlagsProvider,\n  type RemoteFeatureFlagsProviderMessenger,\n} from './providers/remote-feature-flags/RemoteFeatureFlagsProvider';\nexport {\n  AnalyticsService,\n  SecurityEventType,\n  TransactionEventType,\n} from './services/analytics/AnalyticsService';\nexport type {\n  AnalyticsServiceOptions,\n  SecurityAlertDetectedEventProperties,\n  SecurityScanCompletedEventProperties,\n  SnapTrackEventRequest,\n  TrackEventCapableProvider,\n  TransactionEventProperties,\n  TransactionFinalizedEventProperties,\n  WebSocketConnectionClosedEventProperties,\n} from './services/analytics/AnalyticsService';\nexport { safeMerge } from './utils/safeMerge/safeMerge';\nexport {\n  resolveFlowTransactionType,\n  resolveUnifiedSwapTransactionType,\n} from './utils/transactionType/transactionType';\nexport { buildUrl } from './utils/buildUrl/buildUrl';\nexport type { BuildUrlParams } from './utils/buildUrl/buildUrl';\nexport {\n  sanitizeControlCharacters,\n  sanitizeUri,\n} from './utils/sanitize/sanitize';\nexport { UrlStruct } from './utils/urlStruct/urlStruct';\nexport { UuidStruct } from './utils/uuidStruct/uuidStruct';\nexport { asStrictKeyringAccount } from './utils/keyringAccount/keyringAccount';\nexport type {\n  ExtendedKeyringAccount,\n  KeyringAccountExtension,\n} from './utils/keyringAccount/keyringAccount';\nexport { parseEnv } from './utils/config/parseEnv';\nexport { BaseConfigProvider } from './utils/config/BaseConfigProvider';\nexport {\n  commaSeparatedListOf,\n  defaultedUrlStruct,\n  emptyToUndefined,\n  parseIntegerStruct,\n  parseFloatStruct,\n} from './utils/config/envStructs';\nexport { LogLevelStruct } from './utils/config/logLevelStruct';\nexport {\n  Environment,\n  EnvironmentStruct,\n} from './utils/config/environmentStruct';\nexport {\n  batchesAll,\n  batchesAllSettled,\n  batchesAllSettledWithChunks,\n  batchesAllWithChunks,\n  chunks,\n} from './utils/async/async';\nexport { Logger, LogLevel } from './utils/logger/Logger';\nexport type {\n  LoggerOptions,\n  LoggerMethod,\n  LogMethod,\n  LogMethodDecorator,\n  LoggerDecorators,\n} from './utils/logger/Logger';\nexport { serialize, deserialize } from './utils/serialization/serialization';\nexport type { Serializable } from './utils/serialization/types';\nexport {\n  parseProofOfOwnershipMessage,\n  ProofOfOwnershipBatchErrorStruct,\n  ProofOfOwnershipBatchItemResponseStruct,\n  ProofOfOwnershipBatchRequestItemStruct,\n  ProofOfOwnershipBatchRequestParamsStruct,\n  ProofOfOwnershipBatchResponseStruct,\n  ProofOfOwnershipBatchSuccessStruct,\n  ProofOfOwnershipMessageStruct,\n  PROOF_OF_OWNERSHIP_MESSAGE_PREFIX,\n} from './utils/proofOfOwnership/proofOfOwnership';\nexport type {\n  ProofOfOwnershipBatchError,\n  ProofOfOwnershipBatchItemResponse,\n  ProofOfOwnershipBatchRequestItem,\n  ProofOfOwnershipBatchRequestParams,\n  ProofOfOwnershipBatchResponse,\n  ProofOfOwnershipBatchSuccess,\n  ProofOfOwnershipMessage,\n} from './utils/proofOfOwnership/proofOfOwnership';\nexport {\n  createOriginPermissions,\n  DEFAULT_PROD_ORIGINS,\n  DEFAULT_DEV_ORIGINS,\n  DEFAULT_METAMASK_ORIGIN,\n} from './utils/originPermissions/createOriginPermissions';\nexport type { CreateOriginPermissionsParams } from './utils/originPermissions/createOriginPermissions';\nexport { validateOrigin } from './utils/originPermissions/validateOrigin';\nexport { State } from './utils/state/State';\nexport type { StateConfig } from './utils/state/State';\nexport { InMemoryState } from './utils/state/InMemoryState';\nexport type { IStateManager } from './utils/state/IStateManager';\nexport {\n  createSnapErrorHandling,\n  createTrackError,\n  createWithCatchAndThrowSnapError,\n  formatAccountSyncFailures,\n  getSyncFailuresFromSettledResult,\n  isSnapRpcError,\n  normalizeError,\n  stringifyReason,\n  SynchronizationError,\n} from './utils/errors';\nexport { InFlightCoalescer } from './utils/dedupe/InFlightCoalescer';\nexport {\n  BrokenCircuitError,\n  createFetchPolicy,\n  createFetchPolicyError,\n  FetchPolicyErrorName,\n  isTransientError,\n  MAX_RETRY_AFTER_MS,\n} from './utils/fetchPolicy/createFetchPolicy';\nexport type {\n  CreateFetchPolicyOptions,\n  FetchPolicyError,\n} from './utils/fetchPolicy/createFetchPolicy';\nexport { ActionHeader } from './ui/ActionHeader/ActionHeader';\nexport type { ActionHeaderProps } from './ui/ActionHeader/ActionHeader';\nexport { Asset, AssetIcon } from './ui/Asset/Asset';\nexport type { AssetIconProps, AssetProps } from './ui/Asset/Asset';\nexport { EstimatedChanges } from './ui/EstimatedChanges/EstimatedChanges';\nexport type {\n  EstimatedChangesAsset,\n  EstimatedChangesLabels,\n  EstimatedChangesProps,\n} from './ui/EstimatedChanges/EstimatedChanges';\nexport { TransactionAlert } from './ui/TransactionAlert/TransactionAlert';\nexport type {\n  TransactionAlertError,\n  TransactionAlertLabels,\n  TransactionAlertProps,\n  TransactionAlertValidation,\n} from './ui/TransactionAlert/TransactionAlert';\nexport { InMemoryCache } from './utils/cache/InMemoryCache';\nexport { StateCache } from './utils/cache/StateCache';\nexport { useCache } from './utils/cache/useCache';\nexport { useCacheUntil } from './utils/cache/useCacheUntil';\nexport type { CacheOptions } from './utils/cache/useCache';\nexport type {\n  CacheUntilOptions,\n  ResultWithExpiry,\n} from './utils/cache/useCacheUntil';\nexport type {\n  ICache,\n  CacheEntry,\n  TimestampMilliseconds,\n} from './utils/cache/types';\nexport type {\n  CacheStateManager,\n  CacheStore,\n  CachePrefix,\n  StateValue,\n} from './utils/cache/StateCache';\nexport {\n  noopAssetHandlers,\n  wrapSnapHandlers,\n} from './utils/handlers/wrapSnapHandlers';\nexport type {\n  SnapHandlers,\n  WithCatchAndThrowSnapError,\n} from './utils/handlers/wrapSnapHandlers';\nexport type {\n  AccountSyncFailure,\n  CreateSnapErrorHandlingOptions,\n  CreateTrackErrorOptions,\n  CreateWithCatchAndThrowSnapErrorOptions,\n  LogErrorFn,\n  NormalizeErrorFn,\n  PrepareErrorForTrackingFn,\n  ShouldTrackErrorFn,\n  SnapRpcError,\n  SnapTrackErrorRequest,\n  TrackErrorCapableProvider,\n  TrackErrorFn,\n} from './utils/errors';\n"]}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,cAAc,EAEf,8CAA0C;AAC3C,OAAO,EACL,kCAAkC,EAClC,0BAA0B,EAE3B,wEAAoE;AACrE,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,oBAAoB,EACrB,kDAA8C;AAW/C,OAAO,EAAE,SAAS,EAAE,wCAAoC;AACxD,OAAO,EACL,0BAA0B,EAC1B,iCAAiC,EAClC,oDAAgD;AACjD,OAAO,EAAE,QAAQ,EAAE,sCAAkC;AAErD,OAAO,EACL,yBAAyB,EACzB,WAAW,EACZ,sCAAkC;AACnC,OAAO,EAAE,SAAS,EAAE,wCAAoC;AACxD,OAAO,EAAE,UAAU,EAAE,0CAAsC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,kDAA8C;AAK/E,OAAO,EAAE,QAAQ,EAAE,oCAAgC;AACnD,OAAO,EAAE,kBAAkB,EAAE,8CAA0C;AACvE,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EACjB,sCAAkC;AACnC,OAAO,EAAE,cAAc,EAAE,0CAAsC;AAC/D,OAAO,EACL,WAAW,EACX,iBAAiB,EAClB,6CAAyC;AAC1C,OAAO,EACL,UAAU,EACV,iBAAiB,EACjB,2BAA2B,EAC3B,oBAAoB,EACpB,MAAM,EACP,gCAA4B;AAC7B,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,kCAA8B;AAQzD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,gDAA4C;AAE7E,OAAO,EACL,4BAA4B,EAC5B,gCAAgC,EAChC,uCAAuC,EACvC,sCAAsC,EACtC,wCAAwC,EACxC,mCAAmC,EACnC,kCAAkC,EAClC,6BAA6B,EAC7B,iCAAiC,EAClC,sDAAkD;AAUnD,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,uBAAuB,EACxB,8DAA0D;AAE3D,OAAO,EAAE,cAAc,EAAE,qDAAiD;AAC1E,OAAO,EAAE,KAAK,EAAE,gCAA4B;AAE5C,OAAO,EAAE,aAAa,EAAE,wCAAoC;AAE5D,OAAO,EACL,uBAAuB,EACvB,gBAAgB,EAChB,gCAAgC,EAChC,yBAAyB,EACzB,gCAAgC,EAChC,cAAc,EACd,cAAc,EACd,eAAe,EACf,oBAAoB,EACrB,iCAAuB;AACxB,OAAO,EAAE,iBAAiB,EAAE,6CAAyC;AACrE,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,EACnB,kDAA8C;AAK/C,OAAO,EACL,sBAAsB,EACtB,eAAe,EACf,eAAe,EAChB,uDAAmD;AAEpD,OAAO,EAAE,YAAY,EAAE,2CAAuC;AAE9D,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,6BAAyB;AAEpD,OAAO,EAAE,gBAAgB,EAAE,mDAA+C;AAM1E,OAAO,EAAE,gBAAgB,EAAE,mDAA+C;AAO1E,OAAO,EAAE,aAAa,EAAE,wCAAoC;AAC5D,OAAO,EAAE,UAAU,EAAE,qCAAiC;AACtD,OAAO,EAAE,QAAQ,EAAE,mCAA+B;AAClD,OAAO,EAAE,aAAa,EAAE,wCAAoC;AAiB5D,OAAO,EACL,iBAAiB,EACjB,gBAAgB,EACjB,8CAA0C","sourcesContent":["export {\n  ASSETS_PROVIDER_NAME,\n  AssetsProvider,\n  type AssetsProviderMessenger,\n} from './providers/assets/AssetsProvider';\nexport {\n  REMOTE_FEATURE_FLAGS_PROVIDER_NAME,\n  RemoteFeatureFlagsProvider,\n  type RemoteFeatureFlagsProviderMessenger,\n} from './providers/remote-feature-flags/RemoteFeatureFlagsProvider';\nexport {\n  AnalyticsService,\n  SecurityEventType,\n  TransactionEventType,\n} from './services/analytics/AnalyticsService';\nexport type {\n  AnalyticsServiceOptions,\n  SecurityAlertDetectedEventProperties,\n  SecurityScanCompletedEventProperties,\n  SnapTrackEventRequest,\n  TrackEventCapableProvider,\n  TransactionEventProperties,\n  TransactionFinalizedEventProperties,\n  WebSocketConnectionClosedEventProperties,\n} from './services/analytics/AnalyticsService';\nexport { safeMerge } from './utils/safeMerge/safeMerge';\nexport {\n  resolveFlowTransactionType,\n  resolveUnifiedSwapTransactionType,\n} from './utils/transactionType/transactionType';\nexport { buildUrl } from './utils/buildUrl/buildUrl';\nexport type { BuildUrlParams } from './utils/buildUrl/buildUrl';\nexport {\n  sanitizeControlCharacters,\n  sanitizeUri,\n} from './utils/sanitize/sanitize';\nexport { UrlStruct } from './utils/urlStruct/urlStruct';\nexport { UuidStruct } from './utils/uuidStruct/uuidStruct';\nexport { asStrictKeyringAccount } from './utils/keyringAccount/keyringAccount';\nexport type {\n  ExtendedKeyringAccount,\n  KeyringAccountExtension,\n} from './utils/keyringAccount/keyringAccount';\nexport { parseEnv } from './utils/config/parseEnv';\nexport { BaseConfigProvider } from './utils/config/BaseConfigProvider';\nexport {\n  commaSeparatedListOf,\n  defaultedUrlStruct,\n  emptyToUndefined,\n  parseIntegerStruct,\n  parseFloatStruct,\n} from './utils/config/envStructs';\nexport { LogLevelStruct } from './utils/config/logLevelStruct';\nexport {\n  Environment,\n  EnvironmentStruct,\n} from './utils/config/environmentStruct';\nexport {\n  batchesAll,\n  batchesAllSettled,\n  batchesAllSettledWithChunks,\n  batchesAllWithChunks,\n  chunks,\n} from './utils/async/async';\nexport { Logger, LogLevel } from './utils/logger/Logger';\nexport type {\n  LoggerOptions,\n  LoggerMethod,\n  LogMethod,\n  LogMethodDecorator,\n  LoggerDecorators,\n} from './utils/logger/Logger';\nexport { serialize, deserialize } from './utils/serialization/serialization';\nexport type { Serializable } from './utils/serialization/types';\nexport {\n  parseProofOfOwnershipMessage,\n  ProofOfOwnershipBatchErrorStruct,\n  ProofOfOwnershipBatchItemResponseStruct,\n  ProofOfOwnershipBatchRequestItemStruct,\n  ProofOfOwnershipBatchRequestParamsStruct,\n  ProofOfOwnershipBatchResponseStruct,\n  ProofOfOwnershipBatchSuccessStruct,\n  ProofOfOwnershipMessageStruct,\n  PROOF_OF_OWNERSHIP_MESSAGE_PREFIX,\n} from './utils/proofOfOwnership/proofOfOwnership';\nexport type {\n  ProofOfOwnershipBatchError,\n  ProofOfOwnershipBatchItemResponse,\n  ProofOfOwnershipBatchRequestItem,\n  ProofOfOwnershipBatchRequestParams,\n  ProofOfOwnershipBatchResponse,\n  ProofOfOwnershipBatchSuccess,\n  ProofOfOwnershipMessage,\n} from './utils/proofOfOwnership/proofOfOwnership';\nexport {\n  createOriginPermissions,\n  DEFAULT_PROD_ORIGINS,\n  DEFAULT_DEV_ORIGINS,\n  DEFAULT_METAMASK_ORIGIN,\n} from './utils/originPermissions/createOriginPermissions';\nexport type { CreateOriginPermissionsParams } from './utils/originPermissions/createOriginPermissions';\nexport { validateOrigin } from './utils/originPermissions/validateOrigin';\nexport { State } from './utils/state/State';\nexport type { StateConfig } from './utils/state/State';\nexport { InMemoryState } from './utils/state/InMemoryState';\nexport type { IStateManager } from './utils/state/IStateManager';\nexport {\n  createSnapErrorHandling,\n  createTrackError,\n  createWithCatchAndThrowSnapError,\n  formatAccountSyncFailures,\n  getSyncFailuresFromSettledResult,\n  isSnapRpcError,\n  normalizeError,\n  stringifyReason,\n  SynchronizationError,\n} from './utils/errors';\nexport { InFlightCoalescer } from './utils/dedupe/InFlightCoalescer';\nexport {\n  BrokenCircuitError,\n  createFetchPolicy,\n  createFetchPolicyError,\n  FetchPolicyErrorName,\n  isTransientError,\n  MAX_RETRY_AFTER_MS,\n} from './utils/fetchPolicy/createFetchPolicy';\nexport type {\n  CreateFetchPolicyOptions,\n  FetchPolicyError,\n} from './utils/fetchPolicy/createFetchPolicy';\nexport {\n  executeWithFetchPolicy,\n  fetchWithPolicy,\n  parseRetryAfter,\n} from './utils/fetchPolicy/executeWithFetchPolicy';\nexport type { FetchPolicy } from './utils/fetchPolicy/executeWithFetchPolicy';\nexport { ActionHeader } from './ui/ActionHeader/ActionHeader';\nexport type { ActionHeaderProps } from './ui/ActionHeader/ActionHeader';\nexport { Asset, AssetIcon } from './ui/Asset/Asset';\nexport type { AssetIconProps, AssetProps } from './ui/Asset/Asset';\nexport { EstimatedChanges } from './ui/EstimatedChanges/EstimatedChanges';\nexport type {\n  EstimatedChangesAsset,\n  EstimatedChangesLabels,\n  EstimatedChangesProps,\n} from './ui/EstimatedChanges/EstimatedChanges';\nexport { TransactionAlert } from './ui/TransactionAlert/TransactionAlert';\nexport type {\n  TransactionAlertError,\n  TransactionAlertLabels,\n  TransactionAlertProps,\n  TransactionAlertValidation,\n} from './ui/TransactionAlert/TransactionAlert';\nexport { InMemoryCache } from './utils/cache/InMemoryCache';\nexport { StateCache } from './utils/cache/StateCache';\nexport { useCache } from './utils/cache/useCache';\nexport { useCacheUntil } from './utils/cache/useCacheUntil';\nexport type { CacheOptions } from './utils/cache/useCache';\nexport type {\n  CacheUntilOptions,\n  ResultWithExpiry,\n} from './utils/cache/useCacheUntil';\nexport type {\n  ICache,\n  CacheEntry,\n  TimestampMilliseconds,\n} from './utils/cache/types';\nexport type {\n  CacheStateManager,\n  CacheStore,\n  CachePrefix,\n  StateValue,\n} from './utils/cache/StateCache';\nexport {\n  noopAssetHandlers,\n  wrapSnapHandlers,\n} from './utils/handlers/wrapSnapHandlers';\nexport type {\n  SnapHandlers,\n  WithCatchAndThrowSnapError,\n} from './utils/handlers/wrapSnapHandlers';\nexport type {\n  AccountSyncFailure,\n  CreateSnapErrorHandlingOptions,\n  CreateTrackErrorOptions,\n  CreateWithCatchAndThrowSnapErrorOptions,\n  LogErrorFn,\n  NormalizeErrorFn,\n  PrepareErrorForTrackingFn,\n  ShouldTrackErrorFn,\n  SnapRpcError,\n  SnapTrackErrorRequest,\n  TrackErrorCapableProvider,\n  TrackErrorFn,\n} from './utils/errors';\n"]}

package/dist/utils/fetchPolicy/executeWithFetchPolicy.d.mts

@@ -0,0 +1,60 @@
+import type { ServicePolicy } from "@metamask/base-data-service";
+import type { FetchPolicyError } from "./createFetchPolicy.mjs";
+/**
+ * The minimal policy surface `executeWithFetchPolicy` and `fetchWithPolicy`
+ * accept: the `execute` method of a policy created by
+ * {@link createFetchPolicy}.
+ */
+export type FetchPolicy = Pick<ServicePolicy, 'execute'>;
+/**
+ * Parse a `Retry-After` header value as milliseconds.
+ *
+ * @param value - The header value: a delay in seconds or an HTTP date.
+ * @returns The delay in milliseconds, or `undefined` if the value is invalid.
+ */
+export declare const parseRetryAfter: (value: unknown) => number | undefined;
+/**
+ * Execute a transport-only operation through a fetch policy, mapping errors to
+ * the shape the policy decides on.
+ *
+ * The operation must contain only transport work: a fetch, a status check and
+ * a body read. Parsing and validation belong outside it, so their errors
+ * propagate unchanged instead of being counted as failures.
+ *
+ * - `SyntaxError` and abort errors pass through unchanged: the policy must not
+ * retry or count them.
+ * - Errors already in the policy shape (with an `httpStatus`, or a network or
+ * timeout name) pass through unchanged.
+ * - Any other error is mapped with `mapError`, which defaults to treating it
+ * as a network failure. The catch-all is intentional: real `fetch` network
+ * failures are not recognisable by name or code across runtimes, so they can
+ * only be identified by being the residual case.
+ *
+ * @param policy - The shared fetch policy.
+ * @param operation - The transport operation.
+ * @param mapError - An optional mapper for unrecognized errors. Use it to
+ * extract statuses from protocol-specific error shapes (e.g. axios responses
+ * or Solana transport errors).
+ * @param signal - Optional caller abort signal. When aborted, skips or
+ * interrupts retry backoff immediately without another transport invocation.
+ * @returns The operation result.
+ */
+export declare const executeWithFetchPolicy: <Result>(policy: FetchPolicy, operation: () => Promise<Result>, mapError?: (error: unknown) => FetchPolicyError, signal?: AbortSignal | null) => Promise<Result>;
+/**
+ * Fetch a URL through a fetch policy, throwing a {@link FetchPolicyError} on a
+ * non-2xx response and returning the body as text.
+ *
+ * This is the common shape of every policy-wrapped HTTP call in the snaps: a
+ * fetch with a timeout, a status check that turns a non-2xx response into a
+ * policy error (honouring `Retry-After`), and a body read inside the policy so
+ * a truncated response is retried too.
+ *
+ * @param policy - The shared fetch policy.
+ * @param url - The URL to fetch.
+ * @param init - Optional fetch options. A caller-provided `signal` replaces
+ * the default timeout signal.
+ * @param fetchImpl - The fetch implementation, defaulting to `globalThis.fetch`.
+ * @returns The response body as text.
+ */
+export declare const fetchWithPolicy: (policy: FetchPolicy, url: string, init?: RequestInit, fetchImpl?: typeof globalThis.fetch) => Promise<string>;
+//# sourceMappingURL=executeWithFetchPolicy.d.mts.map

package/dist/utils/fetchPolicy/executeWithFetchPolicy.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executeWithFetchPolicy.d.mts","sourceRoot":"","sources":["../../../src/utils/fetchPolicy/executeWithFetchPolicy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,oCAAoC;AAEjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,gCAA4B;AAM5D;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;AAOzD;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAI,OAAO,OAAO,KAAG,MAAM,GAAG,SAYzD,CAAC;AA0DF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,sBAAsB,GAAU,MAAM,EACjD,QAAQ,WAAW,EACnB,WAAW,MAAM,OAAO,CAAC,MAAM,CAAC,EAChC,WAAU,CAAC,KAAK,EAAE,OAAO,KAAK,gBAAiC,EAC/D,SAAS,WAAW,GAAG,IAAI,KAC1B,OAAO,CAAC,MAAM,CAyChB,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,eAAe,GAC1B,QAAQ,WAAW,EACnB,KAAK,MAAM,EACX,OAAO,WAAW,EAClB,YAAW,OAAO,UAAU,CAAC,KAAwB,KACpD,OAAO,CAAC,MAAM,CAoBhB,CAAC"}

package/dist/utils/fetchPolicy/executeWithFetchPolicy.mjs

@@ -0,0 +1,167 @@
+import { createFetchPolicyError, FetchPolicyErrorName } from "./createFetchPolicy.mjs";
+/**
+ * The default timeout for a `fetchWithPolicy` request, in milliseconds.
+ */
+const DEFAULT_TIMEOUT_MS = 10_000;
+/**
+ * Parse a `Retry-After` header value as milliseconds.
+ *
+ * @param value - The header value: a delay in seconds or an HTTP date.
+ * @returns The delay in milliseconds, or `undefined` if the value is invalid.
+ */
+export const parseRetryAfter = (value) => {
+    if (typeof value !== 'string') {
+        return undefined;
+    }
+    const seconds = Number(value);
+    if (Number.isFinite(seconds) && seconds >= 0) {
+        return seconds * 1000;
+    }
+    const date = Date.parse(value);
+    return Number.isNaN(date) ? undefined : Math.max(0, date - Date.now());
+};
+/**
+ * Convert an unrecognized error to a network failure.
+ *
+ * @param error - The upstream error.
+ * @returns The error in the policy shape.
+ */
+const toNetworkError = (error) => error instanceof Error
+    ? createFetchPolicyError(error.message, {
+        name: FetchPolicyErrorName.Network,
+        cause: error,
+    })
+    : createFetchPolicyError('Network request failed', {
+        name: FetchPolicyErrorName.Network,
+        cause: error,
+    });
+const createAbortError = () => Object.assign(new Error('The operation was aborted.'), {
+    name: 'AbortError',
+});
+/**
+ * Race a promise against an abort signal so caller cancellation interrupts
+ * retry backoff waits without waiting for the timer to expire.
+ *
+ * @param promise - The operation promise.
+ * @param signal - Optional abort signal from the caller.
+ * @returns The operation result, or rejects with the abort reason.
+ */
+const raceWithSignal = async (promise, signal) => {
+    if (!signal) {
+        return promise;
+    }
+    let onAbort;
+    const abortPromise = new Promise((_resolve, reject) => {
+        onAbort = () => {
+            reject(createAbortError());
+        };
+        signal.addEventListener('abort', onAbort, { once: true });
+        if (signal.aborted) {
+            onAbort();
+        }
+    });
+    // Suppress unhandled rejection if `promise` settles after `abortPromise` wins.
+    promise.catch(() => undefined);
+    try {
+        return await Promise.race([promise, abortPromise]);
+    }
+    finally {
+        signal.removeEventListener('abort', onAbort);
+    }
+};
+/**
+ * Execute a transport-only operation through a fetch policy, mapping errors to
+ * the shape the policy decides on.
+ *
+ * The operation must contain only transport work: a fetch, a status check and
+ * a body read. Parsing and validation belong outside it, so their errors
+ * propagate unchanged instead of being counted as failures.
+ *
+ * - `SyntaxError` and abort errors pass through unchanged: the policy must not
+ * retry or count them.
+ * - Errors already in the policy shape (with an `httpStatus`, or a network or
+ * timeout name) pass through unchanged.
+ * - Any other error is mapped with `mapError`, which defaults to treating it
+ * as a network failure. The catch-all is intentional: real `fetch` network
+ * failures are not recognisable by name or code across runtimes, so they can
+ * only be identified by being the residual case.
+ *
+ * @param policy - The shared fetch policy.
+ * @param operation - The transport operation.
+ * @param mapError - An optional mapper for unrecognized errors. Use it to
+ * extract statuses from protocol-specific error shapes (e.g. axios responses
+ * or Solana transport errors).
+ * @param signal - Optional caller abort signal. When aborted, skips or
+ * interrupts retry backoff immediately without another transport invocation.
+ * @returns The operation result.
+ */
+export const executeWithFetchPolicy = async (policy, operation, mapError = toNetworkError, signal) => {
+    if (signal?.aborted) {
+        throw signal.reason ?? createAbortError();
+    }
+    try {
+        return await raceWithSignal(policy.execute(async () => {
+            if (signal?.aborted) {
+                throw createAbortError();
+            }
+            try {
+                return await operation();
+            }
+            catch (error) {
+                if (signal?.aborted) {
+                    throw createAbortError();
+                }
+                if (error instanceof SyntaxError ||
+                    error?.name === 'AbortError') {
+                    throw error;
+                }
+                if (error instanceof Error &&
+                    (error.httpStatus !== undefined ||
+                        error.name === FetchPolicyErrorName.Network ||
+                        error.name === FetchPolicyErrorName.Timeout)) {
+                    throw error;
+                }
+                throw mapError(error);
+            }
+        }, signal ?? undefined), signal ?? undefined);
+    }
+    catch (error) {
+        if (signal?.aborted) {
+            throw signal.reason ?? error;
+        }
+        throw error;
+    }
+};
+/**
+ * Fetch a URL through a fetch policy, throwing a {@link FetchPolicyError} on a
+ * non-2xx response and returning the body as text.
+ *
+ * This is the common shape of every policy-wrapped HTTP call in the snaps: a
+ * fetch with a timeout, a status check that turns a non-2xx response into a
+ * policy error (honouring `Retry-After`), and a body read inside the policy so
+ * a truncated response is retried too.
+ *
+ * @param policy - The shared fetch policy.
+ * @param url - The URL to fetch.
+ * @param init - Optional fetch options. A caller-provided `signal` replaces
+ * the default timeout signal.
+ * @param fetchImpl - The fetch implementation, defaulting to `globalThis.fetch`.
+ * @returns The response body as text.
+ */
+export const fetchWithPolicy = async (policy, url, init, fetchImpl = globalThis.fetch) => {
+    const callerSignal = init?.signal;
+    return executeWithFetchPolicy(policy, async () => {
+        const response = await fetchImpl(url, {
+            ...init,
+            signal: callerSignal ?? AbortSignal.timeout(DEFAULT_TIMEOUT_MS),
+        });
+        if (!response.ok) {
+            throw createFetchPolicyError(`HTTP error! status: ${response.status}`, {
+                httpStatus: response.status,
+                retryAfterMs: parseRetryAfter(response.headers?.get('Retry-After')),
+            });
+        }
+        return response.text();
+    }, toNetworkError, callerSignal);
+};
+//# sourceMappingURL=executeWithFetchPolicy.mjs.map

package/dist/utils/fetchPolicy/executeWithFetchPolicy.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"executeWithFetchPolicy.mjs","sourceRoot":"","sources":["../../../src/utils/fetchPolicy/executeWithFetchPolicy.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ServicePolicy } from '@metamask/base-data-service';\n\nimport type { FetchPolicyError } from './createFetchPolicy';\nimport {\n  createFetchPolicyError,\n  FetchPolicyErrorName,\n} from './createFetchPolicy';\n\n/**\n * The minimal policy surface `executeWithFetchPolicy` and `fetchWithPolicy`\n * accept: the `execute` method of a policy created by\n * {@link createFetchPolicy}.\n */\nexport type FetchPolicy = Pick<ServicePolicy, 'execute'>;\n\n/**\n * The default timeout for a `fetchWithPolicy` request, in milliseconds.\n */\nconst DEFAULT_TIMEOUT_MS = 10_000;\n\n/**\n * Parse a `Retry-After` header value as milliseconds.\n *\n * @param value - The header value: a delay in seconds or an HTTP date.\n * @returns The delay in milliseconds, or `undefined` if the value is invalid.\n */\nexport const parseRetryAfter = (value: unknown): number | undefined => {\n  if (typeof value !== 'string') {\n    return undefined;\n  }\n\n  const seconds = Number(value);\n  if (Number.isFinite(seconds) && seconds >= 0) {\n    return seconds * 1000;\n  }\n\n  const date = Date.parse(value);\n  return Number.isNaN(date) ? undefined : Math.max(0, date - Date.now());\n};\n\n/**\n * Convert an unrecognized error to a network failure.\n *\n * @param error - The upstream error.\n * @returns The error in the policy shape.\n */\nconst toNetworkError = (error: unknown): FetchPolicyError =>\n  error instanceof Error\n    ? createFetchPolicyError(error.message, {\n        name: FetchPolicyErrorName.Network,\n        cause: error,\n      })\n    : createFetchPolicyError('Network request failed', {\n        name: FetchPolicyErrorName.Network,\n        cause: error,\n      });\n\nconst createAbortError = (): Error =>\n  Object.assign(new Error('The operation was aborted.'), {\n    name: 'AbortError',\n  });\n\n/**\n * Race a promise against an abort signal so caller cancellation interrupts\n * retry backoff waits without waiting for the timer to expire.\n *\n * @param promise - The operation promise.\n * @param signal - Optional abort signal from the caller.\n * @returns The operation result, or rejects with the abort reason.\n */\nconst raceWithSignal = async <Result>(\n  promise: Promise<Result>,\n  signal: AbortSignal | undefined,\n): Promise<Result> => {\n  if (!signal) {\n    return promise;\n  }\n  let onAbort!: () => void;\n  const abortPromise = new Promise<never>((_resolve, reject) => {\n    onAbort = (): void => {\n      reject(createAbortError());\n    };\n    signal.addEventListener('abort', onAbort, { once: true });\n    if (signal.aborted) {\n      onAbort();\n    }\n  });\n  // Suppress unhandled rejection if `promise` settles after `abortPromise` wins.\n  promise.catch(() => undefined);\n  try {\n    return await Promise.race([promise, abortPromise]);\n  } finally {\n    signal.removeEventListener('abort', onAbort);\n  }\n};\n\n/**\n * Execute a transport-only operation through a fetch policy, mapping errors to\n * the shape the policy decides on.\n *\n * The operation must contain only transport work: a fetch, a status check and\n * a body read. Parsing and validation belong outside it, so their errors\n * propagate unchanged instead of being counted as failures.\n *\n * - `SyntaxError` and abort errors pass through unchanged: the policy must not\n * retry or count them.\n * - Errors already in the policy shape (with an `httpStatus`, or a network or\n * timeout name) pass through unchanged.\n * - Any other error is mapped with `mapError`, which defaults to treating it\n * as a network failure. The catch-all is intentional: real `fetch` network\n * failures are not recognisable by name or code across runtimes, so they can\n * only be identified by being the residual case.\n *\n * @param policy - The shared fetch policy.\n * @param operation - The transport operation.\n * @param mapError - An optional mapper for unrecognized errors. Use it to\n * extract statuses from protocol-specific error shapes (e.g. axios responses\n * or Solana transport errors).\n * @param signal - Optional caller abort signal. When aborted, skips or\n * interrupts retry backoff immediately without another transport invocation.\n * @returns The operation result.\n */\nexport const executeWithFetchPolicy = async <Result>(\n  policy: FetchPolicy,\n  operation: () => Promise<Result>,\n  mapError: (error: unknown) => FetchPolicyError = toNetworkError,\n  signal?: AbortSignal | null,\n): Promise<Result> => {\n  if (signal?.aborted) {\n    throw signal.reason ?? createAbortError();\n  }\n  try {\n    return await raceWithSignal(\n      policy.execute(async () => {\n        if (signal?.aborted) {\n          throw createAbortError();\n        }\n        try {\n          return await operation();\n        } catch (error) {\n          if (signal?.aborted) {\n            throw createAbortError();\n          }\n          if (\n            error instanceof SyntaxError ||\n            (error as { name?: unknown } | undefined)?.name === 'AbortError'\n          ) {\n            throw error;\n          }\n          if (\n            error instanceof Error &&\n            ((error as FetchPolicyError).httpStatus !== undefined ||\n              error.name === FetchPolicyErrorName.Network ||\n              error.name === FetchPolicyErrorName.Timeout)\n          ) {\n            throw error;\n          }\n          throw mapError(error);\n        }\n      }, signal ?? undefined),\n      signal ?? undefined,\n    );\n  } catch (error) {\n    if (signal?.aborted) {\n      throw signal.reason ?? error;\n    }\n    throw error;\n  }\n};\n\n/**\n * Fetch a URL through a fetch policy, throwing a {@link FetchPolicyError} on a\n * non-2xx response and returning the body as text.\n *\n * This is the common shape of every policy-wrapped HTTP call in the snaps: a\n * fetch with a timeout, a status check that turns a non-2xx response into a\n * policy error (honouring `Retry-After`), and a body read inside the policy so\n * a truncated response is retried too.\n *\n * @param policy - The shared fetch policy.\n * @param url - The URL to fetch.\n * @param init - Optional fetch options. A caller-provided `signal` replaces\n * the default timeout signal.\n * @param fetchImpl - The fetch implementation, defaulting to `globalThis.fetch`.\n * @returns The response body as text.\n */\nexport const fetchWithPolicy = async (\n  policy: FetchPolicy,\n  url: string,\n  init?: RequestInit,\n  fetchImpl: typeof globalThis.fetch = globalThis.fetch,\n): Promise<string> => {\n  const callerSignal = init?.signal;\n  return executeWithFetchPolicy(\n    policy,\n    async () => {\n      const response = await fetchImpl(url, {\n        ...init,\n        signal: callerSignal ?? AbortSignal.timeout(DEFAULT_TIMEOUT_MS),\n      });\n      if (!response.ok) {\n        throw createFetchPolicyError(`HTTP error! status: ${response.status}`, {\n          httpStatus: response.status,\n          retryAfterMs: parseRetryAfter(response.headers?.get('Retry-After')),\n        });\n      }\n      return response.text();\n    },\n    toNetworkError,\n    callerSignal,\n  );\n};\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamask-previews/snap-networks-utils",
-  "version": "3.0.0-preview-3ca061e",
+  "version": "3.0.0-preview-80f0b922",
   "description": "Shared utilities for MetaMask network snaps",
   "keywords": [
     "Ethereum",