@metamask-previews/snap-networks-utils 1.0.0-preview-0a84cd9 → 1.0.0-preview-5f4fa3b

package/CHANGELOG.md

@@ -9,6 +9,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
+- Add `SynchronizationError`, `formatAccountSyncFailures`, and the `AccountSyncFailure` type, for reporting account synchronization failures with per-account failure details embedded in the error message (details must live in the message because `snap_trackError` only serializes `name`, `message`, `stack`, and `cause`). ([#374](https://github.com/MetaMask/internal-snaps/pull/374))
 - Add `wrapSnapHandlers` to wrap any Snap entrypoint handlers with `withCatchAndThrowSnapError`, with optional per-handler `logError` overrides ([#341](https://github.com/MetaMask/internal-snaps/pull/341))
 - Add `noopAssetHandlers`, the no-op asset entrypoints network Snaps must export to keep the `endowment:assets` permission ([#341](https://github.com/MetaMask/internal-snaps/pull/341))
 - Add a shared `AnalyticsService` and typed event properties for network Snap telemetry. ([#327](https://github.com/MetaMask/internal-snaps/pull/327))

package/dist/index.cjs

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createSnapErrorHandling = exports.InMemoryState = exports.State = exports.validateOrigin = exports.DEFAULT_METAMASK_ORIGIN = exports.DEFAULT_DEV_ORIGINS = exports.DEFAULT_PROD_ORIGINS = exports.createOriginPermissions = exports.PROOF_OF_OWNERSHIP_MESSAGE_PREFIX = exports.ProofOfOwnershipMessageStruct = exports.ProofOfOwnershipBatchSuccessStruct = exports.ProofOfOwnershipBatchResponseStruct = exports.ProofOfOwnershipBatchRequestParamsStruct = exports.ProofOfOwnershipBatchRequestItemStruct = exports.ProofOfOwnershipBatchItemResponseStruct = exports.ProofOfOwnershipBatchErrorStruct = exports.parseProofOfOwnershipMessage = exports.deserialize = exports.serialize = exports.LogLevel = exports.Logger = exports.chunks = exports.batchesAllWithChunks = exports.batchesAllSettledWithChunks = exports.batchesAllSettled = exports.batchesAll = exports.EnvironmentStruct = exports.Environment = exports.LogLevelStruct = exports.parseFloatStruct = exports.parseIntegerStruct = exports.emptyToUndefined = exports.defaultedUrlStruct = exports.commaSeparatedListOf = exports.BaseConfigProvider = exports.parseEnv = exports.asStrictKeyringAccount = exports.UuidStruct = exports.UrlStruct = exports.sanitizeUri = exports.sanitizeControlCharacters = exports.buildUrl = exports.safeMerge = exports.TransactionEventType = exports.SecurityEventType = exports.AnalyticsService = exports.RemoteFeatureFlagsProvider = exports.REMOTE_FEATURE_FLAGS_PROVIDER_NAME = exports.AssetsProvider = exports.ASSETS_PROVIDER_NAME = void 0;
-exports.wrapSnapHandlers = exports.noopAssetHandlers = exports.useCacheUntil = exports.useCache = exports.StateCache = exports.InMemoryCache = exports.InFlightCoalescer = exports.normalizeError = exports.isSnapRpcError = exports.createWithCatchAndThrowSnapError = exports.createTrackError = void 0;
+exports.wrapSnapHandlers = exports.noopAssetHandlers = exports.useCacheUntil = exports.useCache = exports.StateCache = exports.InMemoryCache = exports.InFlightCoalescer = exports.SynchronizationError = exports.stringifyReason = exports.normalizeError = exports.isSnapRpcError = exports.getSyncFailuresFromSettledResult = exports.formatAccountSyncFailures = exports.createWithCatchAndThrowSnapError = exports.createTrackError = void 0;
 var AssetsProvider_1 = require("./providers/assets/AssetsProvider.cjs");
 Object.defineProperty(exports, "ASSETS_PROVIDER_NAME", { enumerable: true, get: function () { return AssetsProvider_1.ASSETS_PROVIDER_NAME; } });
 Object.defineProperty(exports, "AssetsProvider", { enumerable: true, get: function () { return AssetsProvider_1.AssetsProvider; } });
@@ -77,8 +77,12 @@ var errors_1 = require("./utils/errors/index.cjs");
 Object.defineProperty(exports, "createSnapErrorHandling", { enumerable: true, get: function () { return errors_1.createSnapErrorHandling; } });
 Object.defineProperty(exports, "createTrackError", { enumerable: true, get: function () { return errors_1.createTrackError; } });
 Object.defineProperty(exports, "createWithCatchAndThrowSnapError", { enumerable: true, get: function () { return errors_1.createWithCatchAndThrowSnapError; } });
+Object.defineProperty(exports, "formatAccountSyncFailures", { enumerable: true, get: function () { return errors_1.formatAccountSyncFailures; } });
+Object.defineProperty(exports, "getSyncFailuresFromSettledResult", { enumerable: true, get: function () { return errors_1.getSyncFailuresFromSettledResult; } });
 Object.defineProperty(exports, "isSnapRpcError", { enumerable: true, get: function () { return errors_1.isSnapRpcError; } });
 Object.defineProperty(exports, "normalizeError", { enumerable: true, get: function () { return errors_1.normalizeError; } });
+Object.defineProperty(exports, "stringifyReason", { enumerable: true, get: function () { return errors_1.stringifyReason; } });
+Object.defineProperty(exports, "SynchronizationError", { enumerable: true, get: function () { return errors_1.SynchronizationError; } });
 var InFlightCoalescer_1 = require("./utils/dedupe/InFlightCoalescer.cjs");
 Object.defineProperty(exports, "InFlightCoalescer", { enumerable: true, get: function () { return InFlightCoalescer_1.InFlightCoalescer; } });
 var InMemoryCache_1 = require("./utils/cache/InMemoryCache.cjs");

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;AAAA,wEAI2C;AAHzC,sHAAA,oBAAoB,OAAA;AACpB,gHAAA,cAAc,OAAA;AAGhB,8GAIqE;AAHnE,gJAAA,kCAAkC,OAAA;AAClC,wIAAA,0BAA0B,OAAA;AAG5B,8EAI+C;AAH7C,oHAAA,gBAAgB,OAAA;AAChB,qHAAA,iBAAiB,OAAA;AACjB,wHAAA,oBAAoB,OAAA;AAYtB,6DAAwD;AAA/C,sGAAA,SAAS,OAAA;AAClB,0DAAqD;AAA5C,oGAAA,QAAQ,OAAA;AAEjB,0DAGmC;AAFjC,qHAAA,yBAAyB,OAAA;AACzB,uGAAA,WAAW,OAAA;AAEb,6DAAwD;AAA/C,sGAAA,SAAS,OAAA;AAClB,gEAA2D;AAAlD,wGAAA,UAAU,OAAA;AACnB,4EAA+E;AAAtE,wHAAA,sBAAsB,OAAA;AAK/B,wDAAmD;AAA1C,oGAAA,QAAQ,OAAA;AACjB,4EAAuE;AAA9D,wHAAA,kBAAkB,OAAA;AAC3B,4DAMmC;AALjC,kHAAA,oBAAoB,OAAA;AACpB,gHAAA,kBAAkB,OAAA;AAClB,8GAAA,gBAAgB,OAAA;AAChB,gHAAA,kBAAkB,OAAA;AAClB,8GAAA,gBAAgB,OAAA;AAElB,oEAA+D;AAAtD,gHAAA,cAAc,OAAA;AACvB,0EAG0C;AAFxC,gHAAA,WAAW,OAAA;AACX,sHAAA,iBAAiB,OAAA;AAEnB,iDAM6B;AAL3B,mGAAA,UAAU,OAAA;AACV,0GAAA,iBAAiB,OAAA;AACjB,oHAAA,2BAA2B,OAAA;AAC3B,6GAAA,oBAAoB,OAAA;AACpB,+FAAA,MAAM,OAAA;AAER,oDAAyD;AAAhD,gGAAA,MAAM,OAAA;AAAE,kGAAA,QAAQ,OAAA;AAQzB,yEAA6E;AAApE,0GAAA,SAAS,OAAA;AAAE,4GAAA,WAAW,OAAA;AAE/B,kFAUmD;AATjD,gIAAA,4BAA4B,OAAA;AAC5B,oIAAA,gCAAgC,OAAA;AAChC,2IAAA,uCAAuC,OAAA;AACvC,0IAAA,sCAAsC,OAAA;AACtC,4IAAA,wCAAwC,OAAA;AACxC,uIAAA,mCAAmC,OAAA;AACnC,sIAAA,kCAAkC,OAAA;AAClC,iIAAA,6BAA6B,OAAA;AAC7B,qIAAA,iCAAiC,OAAA;AAWnC,iGAK2D;AAJzD,kIAAA,uBAAuB,OAAA;AACvB,+HAAA,oBAAoB,OAAA;AACpB,8HAAA,mBAAmB,OAAA;AACnB,kIAAA,uBAAuB,OAAA;AAGzB,+EAA0E;AAAjE,gHAAA,cAAc,OAAA;AACvB,iDAA4C;AAAnC,8FAAA,KAAK,OAAA;AAEd,iEAA4D;AAAnD,8GAAA,aAAa,OAAA;AAEtB,mDAMwB;AALtB,iHAAA,uBAAuB,OAAA;AACvB,0GAAA,gBAAgB,OAAA;AAChB,0HAAA,gCAAgC,OAAA;AAChC,wGAAA,cAAc,OAAA;AACd,wGAAA,cAAc,OAAA;AAEhB,0EAAqE;AAA5D,sHAAA,iBAAiB,OAAA;AAC1B,iEAA4D;AAAnD,8GAAA,aAAa,OAAA;AACtB,2DAAsD;AAA7C,wGAAA,UAAU,OAAA;AACnB,uDAAkD;AAAzC,oGAAA,QAAQ,OAAA;AACjB,iEAA4D;AAAnD,8GAAA,aAAa,OAAA;AAiBtB,0EAG2C;AAFzC,qHAAA,iBAAiB,OAAA;AACjB,oHAAA,gBAAgB,OAAA","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 { 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  isSnapRpcError,\n  normalizeError,\n} from './utils/errors';\nexport { InFlightCoalescer } from './utils/dedupe/InFlightCoalescer';\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  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.cjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;AAAA,wEAI2C;AAHzC,sHAAA,oBAAoB,OAAA;AACpB,gHAAA,cAAc,OAAA;AAGhB,8GAIqE;AAHnE,gJAAA,kCAAkC,OAAA;AAClC,wIAAA,0BAA0B,OAAA;AAG5B,8EAI+C;AAH7C,oHAAA,gBAAgB,OAAA;AAChB,qHAAA,iBAAiB,OAAA;AACjB,wHAAA,oBAAoB,OAAA;AAYtB,6DAAwD;AAA/C,sGAAA,SAAS,OAAA;AAClB,0DAAqD;AAA5C,oGAAA,QAAQ,OAAA;AAEjB,0DAGmC;AAFjC,qHAAA,yBAAyB,OAAA;AACzB,uGAAA,WAAW,OAAA;AAEb,6DAAwD;AAA/C,sGAAA,SAAS,OAAA;AAClB,gEAA2D;AAAlD,wGAAA,UAAU,OAAA;AACnB,4EAA+E;AAAtE,wHAAA,sBAAsB,OAAA;AAK/B,wDAAmD;AAA1C,oGAAA,QAAQ,OAAA;AACjB,4EAAuE;AAA9D,wHAAA,kBAAkB,OAAA;AAC3B,4DAMmC;AALjC,kHAAA,oBAAoB,OAAA;AACpB,gHAAA,kBAAkB,OAAA;AAClB,8GAAA,gBAAgB,OAAA;AAChB,gHAAA,kBAAkB,OAAA;AAClB,8GAAA,gBAAgB,OAAA;AAElB,oEAA+D;AAAtD,gHAAA,cAAc,OAAA;AACvB,0EAG0C;AAFxC,gHAAA,WAAW,OAAA;AACX,sHAAA,iBAAiB,OAAA;AAEnB,iDAM6B;AAL3B,mGAAA,UAAU,OAAA;AACV,0GAAA,iBAAiB,OAAA;AACjB,oHAAA,2BAA2B,OAAA;AAC3B,6GAAA,oBAAoB,OAAA;AACpB,+FAAA,MAAM,OAAA;AAER,oDAAyD;AAAhD,gGAAA,MAAM,OAAA;AAAE,kGAAA,QAAQ,OAAA;AAQzB,yEAA6E;AAApE,0GAAA,SAAS,OAAA;AAAE,4GAAA,WAAW,OAAA;AAE/B,kFAUmD;AATjD,gIAAA,4BAA4B,OAAA;AAC5B,oIAAA,gCAAgC,OAAA;AAChC,2IAAA,uCAAuC,OAAA;AACvC,0IAAA,sCAAsC,OAAA;AACtC,4IAAA,wCAAwC,OAAA;AACxC,uIAAA,mCAAmC,OAAA;AACnC,sIAAA,kCAAkC,OAAA;AAClC,iIAAA,6BAA6B,OAAA;AAC7B,qIAAA,iCAAiC,OAAA;AAWnC,iGAK2D;AAJzD,kIAAA,uBAAuB,OAAA;AACvB,+HAAA,oBAAoB,OAAA;AACpB,8HAAA,mBAAmB,OAAA;AACnB,kIAAA,uBAAuB,OAAA;AAGzB,+EAA0E;AAAjE,gHAAA,cAAc,OAAA;AACvB,iDAA4C;AAAnC,8FAAA,KAAK,OAAA;AAEd,iEAA4D;AAAnD,8GAAA,aAAa,OAAA;AAEtB,mDAUwB;AATtB,iHAAA,uBAAuB,OAAA;AACvB,0GAAA,gBAAgB,OAAA;AAChB,0HAAA,gCAAgC,OAAA;AAChC,mHAAA,yBAAyB,OAAA;AACzB,0HAAA,gCAAgC,OAAA;AAChC,wGAAA,cAAc,OAAA;AACd,wGAAA,cAAc,OAAA;AACd,yGAAA,eAAe,OAAA;AACf,8GAAA,oBAAoB,OAAA;AAEtB,0EAAqE;AAA5D,sHAAA,iBAAiB,OAAA;AAC1B,iEAA4D;AAAnD,8GAAA,aAAa,OAAA;AACtB,2DAAsD;AAA7C,wGAAA,UAAU,OAAA;AACnB,uDAAkD;AAAzC,oGAAA,QAAQ,OAAA;AACjB,iEAA4D;AAAnD,8GAAA,aAAa,OAAA;AAiBtB,0EAG2C;AAFzC,qHAAA,iBAAiB,OAAA;AACjB,oHAAA,gBAAgB,OAAA","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 { 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 { 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/index.d.cts

@@ -29,7 +29,7 @@ export { State } from "./utils/state/State.cjs";
 export type { StateConfig } from "./utils/state/State.cjs";
 export { InMemoryState } from "./utils/state/InMemoryState.cjs";
 export type { IStateManager } from "./utils/state/IStateManager.cjs";
-export { createSnapErrorHandling, createTrackError, createWithCatchAndThrowSnapError, isSnapRpcError, normalizeError, } from "./utils/errors/index.cjs";
+export { createSnapErrorHandling, createTrackError, createWithCatchAndThrowSnapError, formatAccountSyncFailures, getSyncFailuresFromSettledResult, isSnapRpcError, normalizeError, stringifyReason, SynchronizationError, } from "./utils/errors/index.cjs";
 export { InFlightCoalescer } from "./utils/dedupe/InFlightCoalescer.cjs";
 export { InMemoryCache } from "./utils/cache/InMemoryCache.cjs";
 export { StateCache } from "./utils/cache/StateCache.cjs";
@@ -41,5 +41,5 @@ export type { ICache, CacheEntry, TimestampMilliseconds, } from "./utils/cache/t
 export type { CacheStateManager, CacheStore, CachePrefix, StateValue, } from "./utils/cache/StateCache.cjs";
 export { noopAssetHandlers, wrapSnapHandlers, } from "./utils/handlers/wrapSnapHandlers.cjs";
 export type { SnapHandlers, WithCatchAndThrowSnapError, } from "./utils/handlers/wrapSnapHandlers.cjs";
-export type { CreateSnapErrorHandlingOptions, CreateTrackErrorOptions, CreateWithCatchAndThrowSnapErrorOptions, LogErrorFn, NormalizeErrorFn, PrepareErrorForTrackingFn, ShouldTrackErrorFn, SnapRpcError, SnapTrackErrorRequest, TrackErrorCapableProvider, TrackErrorFn, } from "./utils/errors/index.cjs";
+export type { AccountSyncFailure, CreateSnapErrorHandlingOptions, CreateTrackErrorOptions, CreateWithCatchAndThrowSnapErrorOptions, LogErrorFn, NormalizeErrorFn, PrepareErrorForTrackingFn, ShouldTrackErrorFn, SnapRpcError, SnapTrackErrorRequest, TrackErrorCapableProvider, TrackErrorFn, } from "./utils/errors/index.cjs";
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.d.mts

@@ -29,7 +29,7 @@ export { State } from "./utils/state/State.mjs";
 export type { StateConfig } from "./utils/state/State.mjs";
 export { InMemoryState } from "./utils/state/InMemoryState.mjs";
 export type { IStateManager } from "./utils/state/IStateManager.mjs";
-export { createSnapErrorHandling, createTrackError, createWithCatchAndThrowSnapError, isSnapRpcError, normalizeError, } from "./utils/errors/index.mjs";
+export { createSnapErrorHandling, createTrackError, createWithCatchAndThrowSnapError, formatAccountSyncFailures, getSyncFailuresFromSettledResult, isSnapRpcError, normalizeError, stringifyReason, SynchronizationError, } from "./utils/errors/index.mjs";
 export { InFlightCoalescer } from "./utils/dedupe/InFlightCoalescer.mjs";
 export { InMemoryCache } from "./utils/cache/InMemoryCache.mjs";
 export { StateCache } from "./utils/cache/StateCache.mjs";
@@ -41,5 +41,5 @@ export type { ICache, CacheEntry, TimestampMilliseconds, } from "./utils/cache/t
 export type { CacheStateManager, CacheStore, CachePrefix, StateValue, } from "./utils/cache/StateCache.mjs";
 export { noopAssetHandlers, wrapSnapHandlers, } from "./utils/handlers/wrapSnapHandlers.mjs";
 export type { SnapHandlers, WithCatchAndThrowSnapError, } from "./utils/handlers/wrapSnapHandlers.mjs";
-export type { CreateSnapErrorHandlingOptions, CreateTrackErrorOptions, CreateWithCatchAndThrowSnapErrorOptions, LogErrorFn, NormalizeErrorFn, PrepareErrorForTrackingFn, ShouldTrackErrorFn, SnapRpcError, SnapTrackErrorRequest, TrackErrorCapableProvider, TrackErrorFn, } from "./utils/errors/index.mjs";
+export type { AccountSyncFailure, CreateSnapErrorHandlingOptions, CreateTrackErrorOptions, CreateWithCatchAndThrowSnapErrorOptions, LogErrorFn, NormalizeErrorFn, PrepareErrorForTrackingFn, ShouldTrackErrorFn, SnapRpcError, SnapTrackErrorRequest, TrackErrorCapableProvider, TrackErrorFn, } from "./utils/errors/index.mjs";
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.mjs

@@ -20,7 +20,7 @@ export { createOriginPermissions, DEFAULT_PROD_ORIGINS, DEFAULT_DEV_ORIGINS, DEF
 export { validateOrigin } from "./utils/originPermissions/validateOrigin.mjs";
 export { State } from "./utils/state/State.mjs";
 export { InMemoryState } from "./utils/state/InMemoryState.mjs";
-export { createSnapErrorHandling, createTrackError, createWithCatchAndThrowSnapError, isSnapRpcError, normalizeError } from "./utils/errors/index.mjs";
+export { createSnapErrorHandling, createTrackError, createWithCatchAndThrowSnapError, formatAccountSyncFailures, getSyncFailuresFromSettledResult, isSnapRpcError, normalizeError, stringifyReason, SynchronizationError } from "./utils/errors/index.mjs";
 export { InFlightCoalescer } from "./utils/dedupe/InFlightCoalescer.mjs";
 export { InMemoryCache } from "./utils/cache/InMemoryCache.mjs";
 export { StateCache } from "./utils/cache/StateCache.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,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,cAAc,EACd,cAAc,EACf,iCAAuB;AACxB,OAAO,EAAE,iBAAiB,EAAE,6CAAyC;AACrE,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 { 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  isSnapRpcError,\n  normalizeError,\n} from './utils/errors';\nexport { InFlightCoalescer } from './utils/dedupe/InFlightCoalescer';\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  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,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,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 { 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 { 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/errors/index.cjs

@@ -1,12 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isSnapRpcError = exports.normalizeError = exports.createWithCatchAndThrowSnapError = exports.createTrackError = exports.createSnapErrorHandling = void 0;
+exports.isSnapRpcError = exports.stringifyReason = exports.normalizeError = exports.createWithCatchAndThrowSnapError = exports.getSyncFailuresFromSettledResult = exports.formatAccountSyncFailures = exports.SynchronizationError = exports.createTrackError = exports.createSnapErrorHandling = void 0;
 var trackError_1 = require("./trackError.cjs");
 Object.defineProperty(exports, "createSnapErrorHandling", { enumerable: true, get: function () { return trackError_1.createSnapErrorHandling; } });
 Object.defineProperty(exports, "createTrackError", { enumerable: true, get: function () { return trackError_1.createTrackError; } });
+var syncError_1 = require("./syncError.cjs");
+Object.defineProperty(exports, "SynchronizationError", { enumerable: true, get: function () { return syncError_1.SynchronizationError; } });
+Object.defineProperty(exports, "formatAccountSyncFailures", { enumerable: true, get: function () { return syncError_1.formatAccountSyncFailures; } });
+Object.defineProperty(exports, "getSyncFailuresFromSettledResult", { enumerable: true, get: function () { return syncError_1.getSyncFailuresFromSettledResult; } });
 var errors_1 = require("./errors.cjs");
 Object.defineProperty(exports, "createWithCatchAndThrowSnapError", { enumerable: true, get: function () { return errors_1.createWithCatchAndThrowSnapError; } });
 Object.defineProperty(exports, "normalizeError", { enumerable: true, get: function () { return errors_1.normalizeError; } });
+var stringifyReason_1 = require("./stringifyReason.cjs");
+Object.defineProperty(exports, "stringifyReason", { enumerable: true, get: function () { return stringifyReason_1.stringifyReason; } });
 var snapRpcError_1 = require("./snapRpcError.cjs");
 Object.defineProperty(exports, "isSnapRpcError", { enumerable: true, get: function () { return snapRpcError_1.isSnapRpcError; } });
 //# sourceMappingURL=index.cjs.map

package/dist/utils/errors/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../../src/utils/errors/index.ts"],"names":[],"mappings":";;;AAAA,+CAAyE;AAAhE,qHAAA,uBAAuB,OAAA;AAAE,8GAAA,gBAAgB,OAAA;AAClD,uCAA4E;AAAnE,0HAAA,gCAAgC,OAAA;AAAE,wGAAA,cAAc,OAAA;AACzD,mDAAgD;AAAvC,8GAAA,cAAc,OAAA","sourcesContent":["export { createSnapErrorHandling, createTrackError } from './trackError';\nexport { createWithCatchAndThrowSnapError, normalizeError } from './errors';\nexport { isSnapRpcError } from './snapRpcError';\nexport type {\n  CreateSnapErrorHandlingOptions,\n  CreateTrackErrorOptions,\n  PrepareErrorForTrackingFn,\n  ShouldTrackErrorFn,\n  SnapTrackErrorRequest,\n  TrackErrorCapableProvider,\n} from './trackError';\nexport type {\n  CreateWithCatchAndThrowSnapErrorOptions,\n  LogErrorFn,\n  NormalizeErrorFn,\n  TrackErrorFn,\n} from './errors';\nexport type { SnapRpcError } from './snapRpcError';\n"]}
+{"version":3,"file":"index.cjs","sourceRoot":"","sources":["../../../src/utils/errors/index.ts"],"names":[],"mappings":";;;AAAA,+CAAyE;AAAhE,qHAAA,uBAAuB,OAAA;AAAE,8GAAA,gBAAgB,OAAA;AAClD,6CAIqB;AAHnB,iHAAA,oBAAoB,OAAA;AACpB,sHAAA,yBAAyB,OAAA;AACzB,6HAAA,gCAAgC,OAAA;AAGlC,uCAA4E;AAAnE,0HAAA,gCAAgC,OAAA;AAAE,wGAAA,cAAc,OAAA;AACzD,yDAAoD;AAA3C,kHAAA,eAAe,OAAA;AACxB,mDAAgD;AAAvC,8GAAA,cAAc,OAAA","sourcesContent":["export { createSnapErrorHandling, createTrackError } from './trackError';\nexport {\n  SynchronizationError,\n  formatAccountSyncFailures,\n  getSyncFailuresFromSettledResult,\n} from './syncError';\nexport type { AccountSyncFailure } from './syncError';\nexport { createWithCatchAndThrowSnapError, normalizeError } from './errors';\nexport { stringifyReason } from './stringifyReason';\nexport { isSnapRpcError } from './snapRpcError';\nexport type {\n  CreateSnapErrorHandlingOptions,\n  CreateTrackErrorOptions,\n  PrepareErrorForTrackingFn,\n  ShouldTrackErrorFn,\n  SnapTrackErrorRequest,\n  TrackErrorCapableProvider,\n} from './trackError';\nexport type {\n  CreateWithCatchAndThrowSnapErrorOptions,\n  LogErrorFn,\n  NormalizeErrorFn,\n  TrackErrorFn,\n} from './errors';\nexport type { SnapRpcError } from './snapRpcError';\n"]}

package/dist/utils/errors/index.d.cts

@@ -1,5 +1,8 @@
 export { createSnapErrorHandling, createTrackError } from "./trackError.cjs";
+export { SynchronizationError, formatAccountSyncFailures, getSyncFailuresFromSettledResult, } from "./syncError.cjs";
+export type { AccountSyncFailure } from "./syncError.cjs";
 export { createWithCatchAndThrowSnapError, normalizeError } from "./errors.cjs";
+export { stringifyReason } from "./stringifyReason.cjs";
 export { isSnapRpcError } from "./snapRpcError.cjs";
 export type { CreateSnapErrorHandlingOptions, CreateTrackErrorOptions, PrepareErrorForTrackingFn, ShouldTrackErrorFn, SnapTrackErrorRequest, TrackErrorCapableProvider, } from "./trackError.cjs";
 export type { CreateWithCatchAndThrowSnapErrorOptions, LogErrorFn, NormalizeErrorFn, TrackErrorFn, } from "./errors.cjs";

package/dist/utils/errors/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../../src/utils/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,yBAAqB;AACzE,OAAO,EAAE,gCAAgC,EAAE,cAAc,EAAE,qBAAiB;AAC5E,OAAO,EAAE,cAAc,EAAE,2BAAuB;AAChD,YAAY,EACV,8BAA8B,EAC9B,uBAAuB,EACvB,yBAAyB,EACzB,kBAAkB,EAClB,qBAAqB,EACrB,yBAAyB,GAC1B,yBAAqB;AACtB,YAAY,EACV,uCAAuC,EACvC,UAAU,EACV,gBAAgB,EAChB,YAAY,GACb,qBAAiB;AAClB,YAAY,EAAE,YAAY,EAAE,2BAAuB"}
+{"version":3,"file":"index.d.cts","sourceRoot":"","sources":["../../../src/utils/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,yBAAqB;AACzE,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,gCAAgC,GACjC,wBAAoB;AACrB,YAAY,EAAE,kBAAkB,EAAE,wBAAoB;AACtD,OAAO,EAAE,gCAAgC,EAAE,cAAc,EAAE,qBAAiB;AAC5E,OAAO,EAAE,eAAe,EAAE,8BAA0B;AACpD,OAAO,EAAE,cAAc,EAAE,2BAAuB;AAChD,YAAY,EACV,8BAA8B,EAC9B,uBAAuB,EACvB,yBAAyB,EACzB,kBAAkB,EAClB,qBAAqB,EACrB,yBAAyB,GAC1B,yBAAqB;AACtB,YAAY,EACV,uCAAuC,EACvC,UAAU,EACV,gBAAgB,EAChB,YAAY,GACb,qBAAiB;AAClB,YAAY,EAAE,YAAY,EAAE,2BAAuB"}

package/dist/utils/errors/index.d.mts

@@ -1,5 +1,8 @@
 export { createSnapErrorHandling, createTrackError } from "./trackError.mjs";
+export { SynchronizationError, formatAccountSyncFailures, getSyncFailuresFromSettledResult, } from "./syncError.mjs";
+export type { AccountSyncFailure } from "./syncError.mjs";
 export { createWithCatchAndThrowSnapError, normalizeError } from "./errors.mjs";
+export { stringifyReason } from "./stringifyReason.mjs";
 export { isSnapRpcError } from "./snapRpcError.mjs";
 export type { CreateSnapErrorHandlingOptions, CreateTrackErrorOptions, PrepareErrorForTrackingFn, ShouldTrackErrorFn, SnapTrackErrorRequest, TrackErrorCapableProvider, } from "./trackError.mjs";
 export type { CreateWithCatchAndThrowSnapErrorOptions, LogErrorFn, NormalizeErrorFn, TrackErrorFn, } from "./errors.mjs";

package/dist/utils/errors/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/utils/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,yBAAqB;AACzE,OAAO,EAAE,gCAAgC,EAAE,cAAc,EAAE,qBAAiB;AAC5E,OAAO,EAAE,cAAc,EAAE,2BAAuB;AAChD,YAAY,EACV,8BAA8B,EAC9B,uBAAuB,EACvB,yBAAyB,EACzB,kBAAkB,EAClB,qBAAqB,EACrB,yBAAyB,GAC1B,yBAAqB;AACtB,YAAY,EACV,uCAAuC,EACvC,UAAU,EACV,gBAAgB,EAChB,YAAY,GACb,qBAAiB;AAClB,YAAY,EAAE,YAAY,EAAE,2BAAuB"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/utils/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,yBAAqB;AACzE,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,gCAAgC,GACjC,wBAAoB;AACrB,YAAY,EAAE,kBAAkB,EAAE,wBAAoB;AACtD,OAAO,EAAE,gCAAgC,EAAE,cAAc,EAAE,qBAAiB;AAC5E,OAAO,EAAE,eAAe,EAAE,8BAA0B;AACpD,OAAO,EAAE,cAAc,EAAE,2BAAuB;AAChD,YAAY,EACV,8BAA8B,EAC9B,uBAAuB,EACvB,yBAAyB,EACzB,kBAAkB,EAClB,qBAAqB,EACrB,yBAAyB,GAC1B,yBAAqB;AACtB,YAAY,EACV,uCAAuC,EACvC,UAAU,EACV,gBAAgB,EAChB,YAAY,GACb,qBAAiB;AAClB,YAAY,EAAE,YAAY,EAAE,2BAAuB"}

package/dist/utils/errors/index.mjs

@@ -1,4 +1,6 @@
 export { createSnapErrorHandling, createTrackError } from "./trackError.mjs";
+export { SynchronizationError, formatAccountSyncFailures, getSyncFailuresFromSettledResult } from "./syncError.mjs";
 export { createWithCatchAndThrowSnapError, normalizeError } from "./errors.mjs";
+export { stringifyReason } from "./stringifyReason.mjs";
 export { isSnapRpcError } from "./snapRpcError.mjs";
 //# sourceMappingURL=index.mjs.map

package/dist/utils/errors/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../src/utils/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,yBAAqB;AACzE,OAAO,EAAE,gCAAgC,EAAE,cAAc,EAAE,qBAAiB;AAC5E,OAAO,EAAE,cAAc,EAAE,2BAAuB","sourcesContent":["export { createSnapErrorHandling, createTrackError } from './trackError';\nexport { createWithCatchAndThrowSnapError, normalizeError } from './errors';\nexport { isSnapRpcError } from './snapRpcError';\nexport type {\n  CreateSnapErrorHandlingOptions,\n  CreateTrackErrorOptions,\n  PrepareErrorForTrackingFn,\n  ShouldTrackErrorFn,\n  SnapTrackErrorRequest,\n  TrackErrorCapableProvider,\n} from './trackError';\nexport type {\n  CreateWithCatchAndThrowSnapErrorOptions,\n  LogErrorFn,\n  NormalizeErrorFn,\n  TrackErrorFn,\n} from './errors';\nexport type { SnapRpcError } from './snapRpcError';\n"]}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../src/utils/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,yBAAqB;AACzE,OAAO,EACL,oBAAoB,EACpB,yBAAyB,EACzB,gCAAgC,EACjC,wBAAoB;AAErB,OAAO,EAAE,gCAAgC,EAAE,cAAc,EAAE,qBAAiB;AAC5E,OAAO,EAAE,eAAe,EAAE,8BAA0B;AACpD,OAAO,EAAE,cAAc,EAAE,2BAAuB","sourcesContent":["export { createSnapErrorHandling, createTrackError } from './trackError';\nexport {\n  SynchronizationError,\n  formatAccountSyncFailures,\n  getSyncFailuresFromSettledResult,\n} from './syncError';\nexport type { AccountSyncFailure } from './syncError';\nexport { createWithCatchAndThrowSnapError, normalizeError } from './errors';\nexport { stringifyReason } from './stringifyReason';\nexport { isSnapRpcError } from './snapRpcError';\nexport type {\n  CreateSnapErrorHandlingOptions,\n  CreateTrackErrorOptions,\n  PrepareErrorForTrackingFn,\n  ShouldTrackErrorFn,\n  SnapTrackErrorRequest,\n  TrackErrorCapableProvider,\n} from './trackError';\nexport type {\n  CreateWithCatchAndThrowSnapErrorOptions,\n  LogErrorFn,\n  NormalizeErrorFn,\n  TrackErrorFn,\n} from './errors';\nexport type { SnapRpcError } from './snapRpcError';\n"]}

package/dist/utils/errors/stringifyReason.cjs

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stringifyReason = stringifyReason;
+/**
+ * Stringifies a rejection reason without ever throwing: `String(reason)`
+ * throws when the reason has a hostile `toString`/`Symbol.toPrimitive`. If the
+ * reason is an error with a `cause`, the cause is appended, so the wrapped
+ * failure (e.g. the underlying network error) is part of the reported reason.
+ *
+ * Intended for building human-readable failure reasons (e.g. for
+ * `AccountSyncFailure.reason`), where wrapper errors would otherwise hide the
+ * original failure behind a generic message.
+ *
+ * @param reason - The rejection reason to stringify.
+ * @returns The reason as a string, or a placeholder when stringification fails.
+ */
+function stringifyReason(reason) {
+    try {
+        if (!(reason instanceof Error)) {
+            return String(reason);
+        }
+        const message = String(reason);
+        const { cause } = reason;
+        if (cause === null || cause === undefined) {
+            return message;
+        }
+        // Deliberately permissive: any cause detail is worth reporting, and a
+        // pathological value still ends up as the placeholder via the outer catch.
+        // eslint-disable-next-line @typescript-eslint/no-base-to-string
+        return `${message} (${String(cause)})`;
+    }
+    catch {
+        return 'Unknown error';
+    }
+}
+//# sourceMappingURL=stringifyReason.cjs.map

package/dist/utils/errors/stringifyReason.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"stringifyReason.cjs","sourceRoot":"","sources":["../../../src/utils/errors/stringifyReason.ts"],"names":[],"mappings":";;AAaA,0CAoBC;AAjCD;;;;;;;;;;;;GAYG;AACH,SAAgB,eAAe,CAAC,MAAe;IAC7C,IAAI,CAAC;QACH,IAAI,CAAC,CAAC,MAAM,YAAY,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;QACxB,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;QAC/B,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;QAEzB,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YAC1C,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,sEAAsE;QACtE,2EAA2E;QAC3E,gEAAgE;QAChE,OAAO,GAAG,OAAO,KAAK,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,eAAe,CAAC;IACzB,CAAC;AACH,CAAC","sourcesContent":["/**\n * Stringifies a rejection reason without ever throwing: `String(reason)`\n * throws when the reason has a hostile `toString`/`Symbol.toPrimitive`. If the\n * reason is an error with a `cause`, the cause is appended, so the wrapped\n * failure (e.g. the underlying network error) is part of the reported reason.\n *\n * Intended for building human-readable failure reasons (e.g. for\n * `AccountSyncFailure.reason`), where wrapper errors would otherwise hide the\n * original failure behind a generic message.\n *\n * @param reason - The rejection reason to stringify.\n * @returns The reason as a string, or a placeholder when stringification fails.\n */\nexport function stringifyReason(reason: unknown): string {\n  try {\n    if (!(reason instanceof Error)) {\n      return String(reason);\n    }\n\n    const message = String(reason);\n    const { cause } = reason;\n\n    if (cause === null || cause === undefined) {\n      return message;\n    }\n\n    // Deliberately permissive: any cause detail is worth reporting, and a\n    // pathological value still ends up as the placeholder via the outer catch.\n    // eslint-disable-next-line @typescript-eslint/no-base-to-string\n    return `${message} (${String(cause)})`;\n  } catch {\n    return 'Unknown error';\n  }\n}\n"]}

package/dist/utils/errors/stringifyReason.d.cts

@@ -0,0 +1,15 @@
+/**
+ * Stringifies a rejection reason without ever throwing: `String(reason)`
+ * throws when the reason has a hostile `toString`/`Symbol.toPrimitive`. If the
+ * reason is an error with a `cause`, the cause is appended, so the wrapped
+ * failure (e.g. the underlying network error) is part of the reported reason.
+ *
+ * Intended for building human-readable failure reasons (e.g. for
+ * `AccountSyncFailure.reason`), where wrapper errors would otherwise hide the
+ * original failure behind a generic message.
+ *
+ * @param reason - The rejection reason to stringify.
+ * @returns The reason as a string, or a placeholder when stringification fails.
+ */
+export declare function stringifyReason(reason: unknown): string;
+//# sourceMappingURL=stringifyReason.d.cts.map

package/dist/utils/errors/stringifyReason.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stringifyReason.d.cts","sourceRoot":"","sources":["../../../src/utils/errors/stringifyReason.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAoBvD"}

package/dist/utils/errors/stringifyReason.d.mts

@@ -0,0 +1,15 @@
+/**
+ * Stringifies a rejection reason without ever throwing: `String(reason)`
+ * throws when the reason has a hostile `toString`/`Symbol.toPrimitive`. If the
+ * reason is an error with a `cause`, the cause is appended, so the wrapped
+ * failure (e.g. the underlying network error) is part of the reported reason.
+ *
+ * Intended for building human-readable failure reasons (e.g. for
+ * `AccountSyncFailure.reason`), where wrapper errors would otherwise hide the
+ * original failure behind a generic message.
+ *
+ * @param reason - The rejection reason to stringify.
+ * @returns The reason as a string, or a placeholder when stringification fails.
+ */
+export declare function stringifyReason(reason: unknown): string;
+//# sourceMappingURL=stringifyReason.d.mts.map

package/dist/utils/errors/stringifyReason.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stringifyReason.d.mts","sourceRoot":"","sources":["../../../src/utils/errors/stringifyReason.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAoBvD"}

package/dist/utils/errors/stringifyReason.mjs

@@ -0,0 +1,33 @@
+/**
+ * Stringifies a rejection reason without ever throwing: `String(reason)`
+ * throws when the reason has a hostile `toString`/`Symbol.toPrimitive`. If the
+ * reason is an error with a `cause`, the cause is appended, so the wrapped
+ * failure (e.g. the underlying network error) is part of the reported reason.
+ *
+ * Intended for building human-readable failure reasons (e.g. for
+ * `AccountSyncFailure.reason`), where wrapper errors would otherwise hide the
+ * original failure behind a generic message.
+ *
+ * @param reason - The rejection reason to stringify.
+ * @returns The reason as a string, or a placeholder when stringification fails.
+ */
+export function stringifyReason(reason) {
+    try {
+        if (!(reason instanceof Error)) {
+            return String(reason);
+        }
+        const message = String(reason);
+        const { cause } = reason;
+        if (cause === null || cause === undefined) {
+            return message;
+        }
+        // Deliberately permissive: any cause detail is worth reporting, and a
+        // pathological value still ends up as the placeholder via the outer catch.
+        // eslint-disable-next-line @typescript-eslint/no-base-to-string
+        return `${message} (${String(cause)})`;
+    }
+    catch {
+        return 'Unknown error';
+    }
+}
+//# sourceMappingURL=stringifyReason.mjs.map

package/dist/utils/errors/stringifyReason.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"stringifyReason.mjs","sourceRoot":"","sources":["../../../src/utils/errors/stringifyReason.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAAC,MAAe;IAC7C,IAAI,CAAC;QACH,IAAI,CAAC,CAAC,MAAM,YAAY,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC;QACxB,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;QAC/B,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;QAEzB,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YAC1C,OAAO,OAAO,CAAC;QACjB,CAAC;QAED,sEAAsE;QACtE,2EAA2E;QAC3E,gEAAgE;QAChE,OAAO,GAAG,OAAO,KAAK,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,eAAe,CAAC;IACzB,CAAC;AACH,CAAC","sourcesContent":["/**\n * Stringifies a rejection reason without ever throwing: `String(reason)`\n * throws when the reason has a hostile `toString`/`Symbol.toPrimitive`. If the\n * reason is an error with a `cause`, the cause is appended, so the wrapped\n * failure (e.g. the underlying network error) is part of the reported reason.\n *\n * Intended for building human-readable failure reasons (e.g. for\n * `AccountSyncFailure.reason`), where wrapper errors would otherwise hide the\n * original failure behind a generic message.\n *\n * @param reason - The rejection reason to stringify.\n * @returns The reason as a string, or a placeholder when stringification fails.\n */\nexport function stringifyReason(reason: unknown): string {\n  try {\n    if (!(reason instanceof Error)) {\n      return String(reason);\n    }\n\n    const message = String(reason);\n    const { cause } = reason;\n\n    if (cause === null || cause === undefined) {\n      return message;\n    }\n\n    // Deliberately permissive: any cause detail is worth reporting, and a\n    // pathological value still ends up as the placeholder via the outer catch.\n    // eslint-disable-next-line @typescript-eslint/no-base-to-string\n    return `${message} (${String(cause)})`;\n  } catch {\n    return 'Unknown error';\n  }\n}\n"]}

package/dist/utils/errors/syncError.cjs

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SynchronizationError = void 0;
+exports.getSyncFailuresFromSettledResult = getSyncFailuresFromSettledResult;
+exports.formatAccountSyncFailures = formatAccountSyncFailures;
+const stringifyReason_1 = require("./stringifyReason.cjs");
+/**
+ * Maps settled synchronization results to account synchronization failures:
+ * each rejection is attributed to the account ID at the same index
+ * (`Promise.allSettled` preserves order).
+ *
+ * Rejection reasons are stringified with {@link stringifyReason}, so wrapped
+ * errors report their cause as well.
+ *
+ * @param results - The settled synchronization results.
+ * @param accountIds - The account IDs, in the same order as `results`.
+ * @returns The collected failures, in results order.
+ */
+function getSyncFailuresFromSettledResult(results, accountIds) {
+    const failures = [];
+    results.forEach((result, index) => {
+        const accountId = accountIds[index];
+        if (accountId && result.status === 'rejected') {
+            failures.push({
+                accountId,
+                reason: (0, stringifyReason_1.stringifyReason)(result.reason),
+            });
+        }
+    });
+    return failures;
+}
+/**
+ * Maximum number of characters kept from each failure reason. Reasons can be
+ * arbitrarily long (e.g. full network error messages), so they are truncated
+ * to keep the error message readable in Sentry.
+ */
+const MAX_REASON_LENGTH = 300;
+/**
+ * Maximum number of failures listed in the error message. When more accounts
+ * fail, the remaining ones are summarized with a `+N more` suffix.
+ */
+const MAX_LISTED_FAILURES = 10;
+/**
+ * Formats account synchronization failures as a compact, single-line summary.
+ *
+ * The summary is intended to be embedded in the error message of a
+ * `SynchronizationError`: error tracking via `snap_trackError` serializes only
+ * the error's `name`, `message`, `stack`, and `cause`, so any details stored in
+ * other properties (e.g. a `data` field) are lost before reaching Sentry.
+ *
+ * @param failures - The account synchronization failures to format.
+ * @returns A single-line summary of the failures, truncated to keep the
+ * message readable.
+ */
+function formatAccountSyncFailures(failures) {
+    const listed = failures.slice(0, MAX_LISTED_FAILURES);
+    const details = listed.map((failure) => {
+        const reason = failure.reason.length > MAX_REASON_LENGTH
+            ? `${failure.reason.slice(0, MAX_REASON_LENGTH)}…`
+            : failure.reason;
+        return `${failure.accountId}: ${reason}`;
+    });
+    const remaining = failures.length - listed.length;
+    const suffix = remaining > 0 ? `; +${remaining} more` : '';
+    return `${details.join('; ')}${suffix}`;
+}
+/**
+ * Error thrown when one or more accounts fail to synchronize.
+ *
+ * The failure details are embedded in the message (not only in a property) so
+ * that they survive error tracking: `snap_trackError` serializes only the
+ * error's `name`, `message`, `stack`, and `cause`.
+ */
+class SynchronizationError extends Error {
+    /**
+     * The structured list of account synchronization failures. Useful for logs;
+     * note that it is not preserved by error tracking.
+     */
+    failures;
+    /**
+     * Construct a new synchronization error.
+     *
+     * @param message - The error message, e.g. `'Account synchronization failures'`.
+     * @param failures - The per-account failures to append to the message.
+     * @param options - Additional error options.
+     * @param options.cause - The underlying error that caused the synchronization failure, if any.
+     */
+    constructor(message, failures = [], options) {
+        const details = failures.length > 0
+            ? ` (${failures.length} failed): ${formatAccountSyncFailures(failures)}`
+            : '';
+        super(`${message}${details}`, options);
+        this.name = 'SynchronizationError';
+        this.failures = failures;
+    }
+}
+exports.SynchronizationError = SynchronizationError;
+//# sourceMappingURL=syncError.cjs.map

package/dist/utils/errors/syncError.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"syncError.cjs","sourceRoot":"","sources":["../../../src/utils/errors/syncError.ts"],"names":[],"mappings":";;;AAyBA,4EAiBC;AA2BD,8DAiBC;AAtFD,2DAAoD;AAapD;;;;;;;;;;;GAWG;AACH,SAAgB,gCAAgC,CAC9C,OAAwC,EACxC,UAAoB;IAEpB,MAAM,QAAQ,GAAyB,EAAE,CAAC;IAE1C,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;QAChC,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,SAAS,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YAC9C,QAAQ,CAAC,IAAI,CAAC;gBACZ,SAAS;gBACT,MAAM,EAAE,IAAA,iCAAe,EAAC,MAAM,CAAC,MAAM,CAAC;aACvC,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAE9B;;;GAGG;AACH,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAE/B;;;;;;;;;;;GAWG;AACH,SAAgB,yBAAyB,CACvC,QAA8B;IAE9B,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QACrC,MAAM,MAAM,GACV,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,iBAAiB;YACvC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,iBAAiB,CAAC,GAAG;YAClD,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;QAErB,OAAO,GAAG,OAAO,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAClD,MAAM,MAAM,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,SAAS,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAE3D,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,EAAE,CAAC;AAC1C,CAAC;AAED;;;;;;GAMG;AACH,MAAa,oBAAqB,SAAQ,KAAK;IAC7C;;;OAGG;IACM,QAAQ,CAAuB;IAExC;;;;;;;OAOG;IACH,YACE,OAAe,EACf,WAAiC,EAAE,EACnC,OAAsB;QAEtB,MAAM,OAAO,GACX,QAAQ,CAAC,MAAM,GAAG,CAAC;YACjB,CAAC,CAAC,KAAK,QAAQ,CAAC,MAAM,aAAa,yBAAyB,CAAC,QAAQ,CAAC,EAAE;YACxE,CAAC,CAAC,EAAE,CAAC;QAET,KAAK,CAAC,GAAG,OAAO,GAAG,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AA7BD,oDA6BC","sourcesContent":["import { stringifyReason } from './stringifyReason';\n\n/**\n * A single account synchronization failure, with enough context to understand\n * which account failed and why.\n */\nexport type AccountSyncFailure = {\n  /** The ID of the account that failed to synchronize. */\n  accountId: string;\n  /** The failure reason, as a human-readable string. */\n  reason: string;\n};\n\n/**\n * Maps settled synchronization results to account synchronization failures:\n * each rejection is attributed to the account ID at the same index\n * (`Promise.allSettled` preserves order).\n *\n * Rejection reasons are stringified with {@link stringifyReason}, so wrapped\n * errors report their cause as well.\n *\n * @param results - The settled synchronization results.\n * @param accountIds - The account IDs, in the same order as `results`.\n * @returns The collected failures, in results order.\n */\nexport function getSyncFailuresFromSettledResult(\n  results: PromiseSettledResult<unknown>[],\n  accountIds: string[],\n): AccountSyncFailure[] {\n  const failures: AccountSyncFailure[] = [];\n\n  results.forEach((result, index) => {\n    const accountId = accountIds[index];\n    if (accountId && result.status === 'rejected') {\n      failures.push({\n        accountId,\n        reason: stringifyReason(result.reason),\n      });\n    }\n  });\n\n  return failures;\n}\n\n/**\n * Maximum number of characters kept from each failure reason. Reasons can be\n * arbitrarily long (e.g. full network error messages), so they are truncated\n * to keep the error message readable in Sentry.\n */\nconst MAX_REASON_LENGTH = 300;\n\n/**\n * Maximum number of failures listed in the error message. When more accounts\n * fail, the remaining ones are summarized with a `+N more` suffix.\n */\nconst MAX_LISTED_FAILURES = 10;\n\n/**\n * Formats account synchronization failures as a compact, single-line summary.\n *\n * The summary is intended to be embedded in the error message of a\n * `SynchronizationError`: error tracking via `snap_trackError` serializes only\n * the error's `name`, `message`, `stack`, and `cause`, so any details stored in\n * other properties (e.g. a `data` field) are lost before reaching Sentry.\n *\n * @param failures - The account synchronization failures to format.\n * @returns A single-line summary of the failures, truncated to keep the\n * message readable.\n */\nexport function formatAccountSyncFailures(\n  failures: AccountSyncFailure[],\n): string {\n  const listed = failures.slice(0, MAX_LISTED_FAILURES);\n  const details = listed.map((failure) => {\n    const reason =\n      failure.reason.length > MAX_REASON_LENGTH\n        ? `${failure.reason.slice(0, MAX_REASON_LENGTH)}…`\n        : failure.reason;\n\n    return `${failure.accountId}: ${reason}`;\n  });\n\n  const remaining = failures.length - listed.length;\n  const suffix = remaining > 0 ? `; +${remaining} more` : '';\n\n  return `${details.join('; ')}${suffix}`;\n}\n\n/**\n * Error thrown when one or more accounts fail to synchronize.\n *\n * The failure details are embedded in the message (not only in a property) so\n * that they survive error tracking: `snap_trackError` serializes only the\n * error's `name`, `message`, `stack`, and `cause`.\n */\nexport class SynchronizationError extends Error {\n  /**\n   * The structured list of account synchronization failures. Useful for logs;\n   * note that it is not preserved by error tracking.\n   */\n  readonly failures: AccountSyncFailure[];\n\n  /**\n   * Construct a new synchronization error.\n   *\n   * @param message - The error message, e.g. `'Account synchronization failures'`.\n   * @param failures - The per-account failures to append to the message.\n   * @param options - Additional error options.\n   * @param options.cause - The underlying error that caused the synchronization failure, if any.\n   */\n  constructor(\n    message: string,\n    failures: AccountSyncFailure[] = [],\n    options?: ErrorOptions,\n  ) {\n    const details =\n      failures.length > 0\n        ? ` (${failures.length} failed): ${formatAccountSyncFailures(failures)}`\n        : '';\n\n    super(`${message}${details}`, options);\n    this.name = 'SynchronizationError';\n    this.failures = failures;\n  }\n}\n"]}

package/dist/utils/errors/syncError.d.cts

@@ -0,0 +1,60 @@
+/**
+ * A single account synchronization failure, with enough context to understand
+ * which account failed and why.
+ */
+export type AccountSyncFailure = {
+    /** The ID of the account that failed to synchronize. */
+    accountId: string;
+    /** The failure reason, as a human-readable string. */
+    reason: string;
+};
+/**
+ * Maps settled synchronization results to account synchronization failures:
+ * each rejection is attributed to the account ID at the same index
+ * (`Promise.allSettled` preserves order).
+ *
+ * Rejection reasons are stringified with {@link stringifyReason}, so wrapped
+ * errors report their cause as well.
+ *
+ * @param results - The settled synchronization results.
+ * @param accountIds - The account IDs, in the same order as `results`.
+ * @returns The collected failures, in results order.
+ */
+export declare function getSyncFailuresFromSettledResult(results: PromiseSettledResult<unknown>[], accountIds: string[]): AccountSyncFailure[];
+/**
+ * Formats account synchronization failures as a compact, single-line summary.
+ *
+ * The summary is intended to be embedded in the error message of a
+ * `SynchronizationError`: error tracking via `snap_trackError` serializes only
+ * the error's `name`, `message`, `stack`, and `cause`, so any details stored in
+ * other properties (e.g. a `data` field) are lost before reaching Sentry.
+ *
+ * @param failures - The account synchronization failures to format.
+ * @returns A single-line summary of the failures, truncated to keep the
+ * message readable.
+ */
+export declare function formatAccountSyncFailures(failures: AccountSyncFailure[]): string;
+/**
+ * Error thrown when one or more accounts fail to synchronize.
+ *
+ * The failure details are embedded in the message (not only in a property) so
+ * that they survive error tracking: `snap_trackError` serializes only the
+ * error's `name`, `message`, `stack`, and `cause`.
+ */
+export declare class SynchronizationError extends Error {
+    /**
+     * The structured list of account synchronization failures. Useful for logs;
+     * note that it is not preserved by error tracking.
+     */
+    readonly failures: AccountSyncFailure[];
+    /**
+     * Construct a new synchronization error.
+     *
+     * @param message - The error message, e.g. `'Account synchronization failures'`.
+     * @param failures - The per-account failures to append to the message.
+     * @param options - Additional error options.
+     * @param options.cause - The underlying error that caused the synchronization failure, if any.
+     */
+    constructor(message: string, failures?: AccountSyncFailure[], options?: ErrorOptions);
+}
+//# sourceMappingURL=syncError.d.cts.map

package/dist/utils/errors/syncError.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"syncError.d.cts","sourceRoot":"","sources":["../../../src/utils/errors/syncError.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,oBAAoB,CAAC,OAAO,CAAC,EAAE,EACxC,UAAU,EAAE,MAAM,EAAE,GACnB,kBAAkB,EAAE,CActB;AAeD;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,kBAAkB,EAAE,GAC7B,MAAM,CAeR;AAED;;;;;;GAMG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAExC;;;;;;;OAOG;gBAED,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,kBAAkB,EAAO,EACnC,OAAO,CAAC,EAAE,YAAY;CAWzB"}

package/dist/utils/errors/syncError.d.mts

@@ -0,0 +1,60 @@
+/**
+ * A single account synchronization failure, with enough context to understand
+ * which account failed and why.
+ */
+export type AccountSyncFailure = {
+    /** The ID of the account that failed to synchronize. */
+    accountId: string;
+    /** The failure reason, as a human-readable string. */
+    reason: string;
+};
+/**
+ * Maps settled synchronization results to account synchronization failures:
+ * each rejection is attributed to the account ID at the same index
+ * (`Promise.allSettled` preserves order).
+ *
+ * Rejection reasons are stringified with {@link stringifyReason}, so wrapped
+ * errors report their cause as well.
+ *
+ * @param results - The settled synchronization results.
+ * @param accountIds - The account IDs, in the same order as `results`.
+ * @returns The collected failures, in results order.
+ */
+export declare function getSyncFailuresFromSettledResult(results: PromiseSettledResult<unknown>[], accountIds: string[]): AccountSyncFailure[];
+/**
+ * Formats account synchronization failures as a compact, single-line summary.
+ *
+ * The summary is intended to be embedded in the error message of a
+ * `SynchronizationError`: error tracking via `snap_trackError` serializes only
+ * the error's `name`, `message`, `stack`, and `cause`, so any details stored in
+ * other properties (e.g. a `data` field) are lost before reaching Sentry.
+ *
+ * @param failures - The account synchronization failures to format.
+ * @returns A single-line summary of the failures, truncated to keep the
+ * message readable.
+ */
+export declare function formatAccountSyncFailures(failures: AccountSyncFailure[]): string;
+/**
+ * Error thrown when one or more accounts fail to synchronize.
+ *
+ * The failure details are embedded in the message (not only in a property) so
+ * that they survive error tracking: `snap_trackError` serializes only the
+ * error's `name`, `message`, `stack`, and `cause`.
+ */
+export declare class SynchronizationError extends Error {
+    /**
+     * The structured list of account synchronization failures. Useful for logs;
+     * note that it is not preserved by error tracking.
+     */
+    readonly failures: AccountSyncFailure[];
+    /**
+     * Construct a new synchronization error.
+     *
+     * @param message - The error message, e.g. `'Account synchronization failures'`.
+     * @param failures - The per-account failures to append to the message.
+     * @param options - Additional error options.
+     * @param options.cause - The underlying error that caused the synchronization failure, if any.
+     */
+    constructor(message: string, failures?: AccountSyncFailure[], options?: ErrorOptions);
+}
+//# sourceMappingURL=syncError.d.mts.map

package/dist/utils/errors/syncError.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"syncError.d.mts","sourceRoot":"","sources":["../../../src/utils/errors/syncError.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,gCAAgC,CAC9C,OAAO,EAAE,oBAAoB,CAAC,OAAO,CAAC,EAAE,EACxC,UAAU,EAAE,MAAM,EAAE,GACnB,kBAAkB,EAAE,CActB;AAeD;;;;;;;;;;;GAWG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,kBAAkB,EAAE,GAC7B,MAAM,CAeR;AAED;;;;;;GAMG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAExC;;;;;;;OAOG;gBAED,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,kBAAkB,EAAO,EACnC,OAAO,CAAC,EAAE,YAAY;CAWzB"}

package/dist/utils/errors/syncError.mjs

@@ -0,0 +1,92 @@
+import { stringifyReason } from "./stringifyReason.mjs";
+/**
+ * Maps settled synchronization results to account synchronization failures:
+ * each rejection is attributed to the account ID at the same index
+ * (`Promise.allSettled` preserves order).
+ *
+ * Rejection reasons are stringified with {@link stringifyReason}, so wrapped
+ * errors report their cause as well.
+ *
+ * @param results - The settled synchronization results.
+ * @param accountIds - The account IDs, in the same order as `results`.
+ * @returns The collected failures, in results order.
+ */
+export function getSyncFailuresFromSettledResult(results, accountIds) {
+    const failures = [];
+    results.forEach((result, index) => {
+        const accountId = accountIds[index];
+        if (accountId && result.status === 'rejected') {
+            failures.push({
+                accountId,
+                reason: stringifyReason(result.reason),
+            });
+        }
+    });
+    return failures;
+}
+/**
+ * Maximum number of characters kept from each failure reason. Reasons can be
+ * arbitrarily long (e.g. full network error messages), so they are truncated
+ * to keep the error message readable in Sentry.
+ */
+const MAX_REASON_LENGTH = 300;
+/**
+ * Maximum number of failures listed in the error message. When more accounts
+ * fail, the remaining ones are summarized with a `+N more` suffix.
+ */
+const MAX_LISTED_FAILURES = 10;
+/**
+ * Formats account synchronization failures as a compact, single-line summary.
+ *
+ * The summary is intended to be embedded in the error message of a
+ * `SynchronizationError`: error tracking via `snap_trackError` serializes only
+ * the error's `name`, `message`, `stack`, and `cause`, so any details stored in
+ * other properties (e.g. a `data` field) are lost before reaching Sentry.
+ *
+ * @param failures - The account synchronization failures to format.
+ * @returns A single-line summary of the failures, truncated to keep the
+ * message readable.
+ */
+export function formatAccountSyncFailures(failures) {
+    const listed = failures.slice(0, MAX_LISTED_FAILURES);
+    const details = listed.map((failure) => {
+        const reason = failure.reason.length > MAX_REASON_LENGTH
+            ? `${failure.reason.slice(0, MAX_REASON_LENGTH)}…`
+            : failure.reason;
+        return `${failure.accountId}: ${reason}`;
+    });
+    const remaining = failures.length - listed.length;
+    const suffix = remaining > 0 ? `; +${remaining} more` : '';
+    return `${details.join('; ')}${suffix}`;
+}
+/**
+ * Error thrown when one or more accounts fail to synchronize.
+ *
+ * The failure details are embedded in the message (not only in a property) so
+ * that they survive error tracking: `snap_trackError` serializes only the
+ * error's `name`, `message`, `stack`, and `cause`.
+ */
+export class SynchronizationError extends Error {
+    /**
+     * The structured list of account synchronization failures. Useful for logs;
+     * note that it is not preserved by error tracking.
+     */
+    failures;
+    /**
+     * Construct a new synchronization error.
+     *
+     * @param message - The error message, e.g. `'Account synchronization failures'`.
+     * @param failures - The per-account failures to append to the message.
+     * @param options - Additional error options.
+     * @param options.cause - The underlying error that caused the synchronization failure, if any.
+     */
+    constructor(message, failures = [], options) {
+        const details = failures.length > 0
+            ? ` (${failures.length} failed): ${formatAccountSyncFailures(failures)}`
+            : '';
+        super(`${message}${details}`, options);
+        this.name = 'SynchronizationError';
+        this.failures = failures;
+    }
+}
+//# sourceMappingURL=syncError.mjs.map

package/dist/utils/errors/syncError.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"syncError.mjs","sourceRoot":"","sources":["../../../src/utils/errors/syncError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,8BAA0B;AAapD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gCAAgC,CAC9C,OAAwC,EACxC,UAAoB;IAEpB,MAAM,QAAQ,GAAyB,EAAE,CAAC;IAE1C,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;QAChC,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,SAAS,IAAI,MAAM,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;YAC9C,QAAQ,CAAC,IAAI,CAAC;gBACZ,SAAS;gBACT,MAAM,EAAE,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC;aACvC,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;GAIG;AACH,MAAM,iBAAiB,GAAG,GAAG,CAAC;AAE9B;;;GAGG;AACH,MAAM,mBAAmB,GAAG,EAAE,CAAC;AAE/B;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,yBAAyB,CACvC,QAA8B;IAE9B,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC;IACtD,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QACrC,MAAM,MAAM,GACV,OAAO,CAAC,MAAM,CAAC,MAAM,GAAG,iBAAiB;YACvC,CAAC,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,iBAAiB,CAAC,GAAG;YAClD,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;QAErB,OAAO,GAAG,OAAO,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;IAClD,MAAM,MAAM,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,SAAS,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAE3D,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,EAAE,CAAC;AAC1C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7C;;;OAGG;IACM,QAAQ,CAAuB;IAExC;;;;;;;OAOG;IACH,YACE,OAAe,EACf,WAAiC,EAAE,EACnC,OAAsB;QAEtB,MAAM,OAAO,GACX,QAAQ,CAAC,MAAM,GAAG,CAAC;YACjB,CAAC,CAAC,KAAK,QAAQ,CAAC,MAAM,aAAa,yBAAyB,CAAC,QAAQ,CAAC,EAAE;YACxE,CAAC,CAAC,EAAE,CAAC;QAET,KAAK,CAAC,GAAG,OAAO,GAAG,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF","sourcesContent":["import { stringifyReason } from './stringifyReason';\n\n/**\n * A single account synchronization failure, with enough context to understand\n * which account failed and why.\n */\nexport type AccountSyncFailure = {\n  /** The ID of the account that failed to synchronize. */\n  accountId: string;\n  /** The failure reason, as a human-readable string. */\n  reason: string;\n};\n\n/**\n * Maps settled synchronization results to account synchronization failures:\n * each rejection is attributed to the account ID at the same index\n * (`Promise.allSettled` preserves order).\n *\n * Rejection reasons are stringified with {@link stringifyReason}, so wrapped\n * errors report their cause as well.\n *\n * @param results - The settled synchronization results.\n * @param accountIds - The account IDs, in the same order as `results`.\n * @returns The collected failures, in results order.\n */\nexport function getSyncFailuresFromSettledResult(\n  results: PromiseSettledResult<unknown>[],\n  accountIds: string[],\n): AccountSyncFailure[] {\n  const failures: AccountSyncFailure[] = [];\n\n  results.forEach((result, index) => {\n    const accountId = accountIds[index];\n    if (accountId && result.status === 'rejected') {\n      failures.push({\n        accountId,\n        reason: stringifyReason(result.reason),\n      });\n    }\n  });\n\n  return failures;\n}\n\n/**\n * Maximum number of characters kept from each failure reason. Reasons can be\n * arbitrarily long (e.g. full network error messages), so they are truncated\n * to keep the error message readable in Sentry.\n */\nconst MAX_REASON_LENGTH = 300;\n\n/**\n * Maximum number of failures listed in the error message. When more accounts\n * fail, the remaining ones are summarized with a `+N more` suffix.\n */\nconst MAX_LISTED_FAILURES = 10;\n\n/**\n * Formats account synchronization failures as a compact, single-line summary.\n *\n * The summary is intended to be embedded in the error message of a\n * `SynchronizationError`: error tracking via `snap_trackError` serializes only\n * the error's `name`, `message`, `stack`, and `cause`, so any details stored in\n * other properties (e.g. a `data` field) are lost before reaching Sentry.\n *\n * @param failures - The account synchronization failures to format.\n * @returns A single-line summary of the failures, truncated to keep the\n * message readable.\n */\nexport function formatAccountSyncFailures(\n  failures: AccountSyncFailure[],\n): string {\n  const listed = failures.slice(0, MAX_LISTED_FAILURES);\n  const details = listed.map((failure) => {\n    const reason =\n      failure.reason.length > MAX_REASON_LENGTH\n        ? `${failure.reason.slice(0, MAX_REASON_LENGTH)}…`\n        : failure.reason;\n\n    return `${failure.accountId}: ${reason}`;\n  });\n\n  const remaining = failures.length - listed.length;\n  const suffix = remaining > 0 ? `; +${remaining} more` : '';\n\n  return `${details.join('; ')}${suffix}`;\n}\n\n/**\n * Error thrown when one or more accounts fail to synchronize.\n *\n * The failure details are embedded in the message (not only in a property) so\n * that they survive error tracking: `snap_trackError` serializes only the\n * error's `name`, `message`, `stack`, and `cause`.\n */\nexport class SynchronizationError extends Error {\n  /**\n   * The structured list of account synchronization failures. Useful for logs;\n   * note that it is not preserved by error tracking.\n   */\n  readonly failures: AccountSyncFailure[];\n\n  /**\n   * Construct a new synchronization error.\n   *\n   * @param message - The error message, e.g. `'Account synchronization failures'`.\n   * @param failures - The per-account failures to append to the message.\n   * @param options - Additional error options.\n   * @param options.cause - The underlying error that caused the synchronization failure, if any.\n   */\n  constructor(\n    message: string,\n    failures: AccountSyncFailure[] = [],\n    options?: ErrorOptions,\n  ) {\n    const details =\n      failures.length > 0\n        ? ` (${failures.length} failed): ${formatAccountSyncFailures(failures)}`\n        : '';\n\n    super(`${message}${details}`, options);\n    this.name = 'SynchronizationError';\n    this.failures = failures;\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamask-previews/snap-networks-utils",
-  "version": "1.0.0-preview-0a84cd9",
+  "version": "1.0.0-preview-5f4fa3b",
   "description": "Shared utilities for MetaMask network snaps",
   "keywords": [
     "Ethereum",