@metamask-previews/snap-networks-utils 1.0.0-preview-8ff90d2f → 1.0.0-preview-e00d5bb

package/CHANGELOG.md

@@ -9,7 +9,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### Added
 
+- Add helpers `serialize`, `deserialize`, and `Serializable` for round-tripping `BigNumber`, `bigint`, `Uint8Array`, and `undefined` through snap state ([#197](https://github.com/MetaMask/internal-snaps/pull/197))
 - Add `InFlightCoalescer`, exported from a new `./dedupe` entry point, which coalesces concurrent async operations by key so callers share one in-flight run ([#149](https://github.com/MetaMask/internal-snaps/pull/149))
+- Add shared async batching utilities. ([#211](https://github.com/MetaMask/internal-snaps/pull/211))
 - Add origin permission helpers ([#193](https://github.com/MetaMask/internal-snaps/pull/193))
   - `createOriginPermissions` for building origin-to-method maps
   - `validateOrigin` for checking an origin against a permission map

package/dist/index.cjs

@@ -1,29 +1,38 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.validateOrigin = exports.DEFAULT_METAMASK_ORIGIN = exports.DEFAULT_DEV_ORIGINS = exports.DEFAULT_PROD_ORIGINS = exports.createOriginPermissions = exports.LogLevel = exports.Logger = exports.UrlStruct = exports.sanitizeUri = exports.sanitizeControlCharacters = exports.buildUrl = exports.safeMerge = exports.RemoteFeatureFlagsProvider = exports.REMOTE_FEATURE_FLAGS_PROVIDER_NAME = exports.AssetsProvider = exports.ASSETS_PROVIDER_NAME = void 0;
+exports.validateOrigin = exports.DEFAULT_METAMASK_ORIGIN = exports.DEFAULT_DEV_ORIGINS = exports.DEFAULT_PROD_ORIGINS = exports.createOriginPermissions = exports.deserialize = exports.serialize = exports.LogLevel = exports.Logger = exports.chunks = exports.batchesAllWithChunks = exports.batchesAllSettledWithChunks = exports.batchesAllSettled = exports.batchesAll = exports.UrlStruct = exports.sanitizeUri = exports.sanitizeControlCharacters = exports.buildUrl = exports.safeMerge = exports.RemoteFeatureFlagsProvider = exports.REMOTE_FEATURE_FLAGS_PROVIDER_NAME = exports.AssetsProvider = exports.ASSETS_PROVIDER_NAME = 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; } });
 var RemoteFeatureFlagsProvider_1 = require("./providers/remote-feature-flags/RemoteFeatureFlagsProvider.cjs");
 Object.defineProperty(exports, "REMOTE_FEATURE_FLAGS_PROVIDER_NAME", { enumerable: true, get: function () { return RemoteFeatureFlagsProvider_1.REMOTE_FEATURE_FLAGS_PROVIDER_NAME; } });
 Object.defineProperty(exports, "RemoteFeatureFlagsProvider", { enumerable: true, get: function () { return RemoteFeatureFlagsProvider_1.RemoteFeatureFlagsProvider; } });
-var safeMerge_1 = require("./safeMerge/safeMerge.cjs");
+var safeMerge_1 = require("./utils/safeMerge/safeMerge.cjs");
 Object.defineProperty(exports, "safeMerge", { enumerable: true, get: function () { return safeMerge_1.safeMerge; } });
-var buildUrl_1 = require("./buildUrl/buildUrl.cjs");
+var buildUrl_1 = require("./utils/buildUrl/buildUrl.cjs");
 Object.defineProperty(exports, "buildUrl", { enumerable: true, get: function () { return buildUrl_1.buildUrl; } });
-var sanitize_1 = require("./sanitize.cjs");
+var sanitize_1 = require("./utils/sanitize/sanitize.cjs");
 Object.defineProperty(exports, "sanitizeControlCharacters", { enumerable: true, get: function () { return sanitize_1.sanitizeControlCharacters; } });
 Object.defineProperty(exports, "sanitizeUri", { enumerable: true, get: function () { return sanitize_1.sanitizeUri; } });
-var urlStruct_1 = require("./urlStruct/urlStruct.cjs");
+var urlStruct_1 = require("./utils/urlStruct/urlStruct.cjs");
 Object.defineProperty(exports, "UrlStruct", { enumerable: true, get: function () { return urlStruct_1.UrlStruct; } });
-var logger_1 = require("./logger/index.cjs");
-Object.defineProperty(exports, "Logger", { enumerable: true, get: function () { return logger_1.Logger; } });
-Object.defineProperty(exports, "LogLevel", { enumerable: true, get: function () { return logger_1.LogLevel; } });
-var createOriginPermissions_1 = require("./originPermissions/createOriginPermissions.cjs");
+var async_1 = require("./utils/async/async.cjs");
+Object.defineProperty(exports, "batchesAll", { enumerable: true, get: function () { return async_1.batchesAll; } });
+Object.defineProperty(exports, "batchesAllSettled", { enumerable: true, get: function () { return async_1.batchesAllSettled; } });
+Object.defineProperty(exports, "batchesAllSettledWithChunks", { enumerable: true, get: function () { return async_1.batchesAllSettledWithChunks; } });
+Object.defineProperty(exports, "batchesAllWithChunks", { enumerable: true, get: function () { return async_1.batchesAllWithChunks; } });
+Object.defineProperty(exports, "chunks", { enumerable: true, get: function () { return async_1.chunks; } });
+var Logger_1 = require("./utils/logger/Logger.cjs");
+Object.defineProperty(exports, "Logger", { enumerable: true, get: function () { return Logger_1.Logger; } });
+Object.defineProperty(exports, "LogLevel", { enumerable: true, get: function () { return Logger_1.LogLevel; } });
+var serialization_1 = require("./utils/serialization/serialization.cjs");
+Object.defineProperty(exports, "serialize", { enumerable: true, get: function () { return serialization_1.serialize; } });
+Object.defineProperty(exports, "deserialize", { enumerable: true, get: function () { return serialization_1.deserialize; } });
+var createOriginPermissions_1 = require("./utils/originPermissions/createOriginPermissions.cjs");
 Object.defineProperty(exports, "createOriginPermissions", { enumerable: true, get: function () { return createOriginPermissions_1.createOriginPermissions; } });
 Object.defineProperty(exports, "DEFAULT_PROD_ORIGINS", { enumerable: true, get: function () { return createOriginPermissions_1.DEFAULT_PROD_ORIGINS; } });
 Object.defineProperty(exports, "DEFAULT_DEV_ORIGINS", { enumerable: true, get: function () { return createOriginPermissions_1.DEFAULT_DEV_ORIGINS; } });
 Object.defineProperty(exports, "DEFAULT_METAMASK_ORIGIN", { enumerable: true, get: function () { return createOriginPermissions_1.DEFAULT_METAMASK_ORIGIN; } });
-var validateOrigin_1 = require("./originPermissions/validateOrigin.cjs");
+var validateOrigin_1 = require("./utils/originPermissions/validateOrigin.cjs");
 Object.defineProperty(exports, "validateOrigin", { enumerable: true, get: function () { return validateOrigin_1.validateOrigin; } });
 //# sourceMappingURL=index.cjs.map

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,uDAAkD;AAAzC,sGAAA,SAAS,OAAA;AAClB,oDAA+C;AAAtC,oGAAA,QAAQ,OAAA;AAEjB,2CAAoE;AAA3D,qHAAA,yBAAyB,OAAA;AAAE,uGAAA,WAAW,OAAA;AAC/C,uDAAkD;AAAzC,sGAAA,SAAS,OAAA;AAClB,6CAA4C;AAAnC,gGAAA,MAAM,OAAA;AAAE,kGAAA,QAAQ,OAAA;AAQzB,2FAKqD;AAJnD,kIAAA,uBAAuB,OAAA;AACvB,+HAAA,oBAAoB,OAAA;AACpB,8HAAA,mBAAmB,OAAA;AACnB,kIAAA,uBAAuB,OAAA;AAGzB,yEAAoE;AAA3D,gHAAA,cAAc,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 { safeMerge } from './safeMerge/safeMerge';\nexport { buildUrl } from './buildUrl/buildUrl';\nexport type { BuildUrlParams } from './buildUrl/buildUrl';\nexport { sanitizeControlCharacters, sanitizeUri } from './sanitize';\nexport { UrlStruct } from './urlStruct/urlStruct';\nexport { Logger, LogLevel } from './logger';\nexport type {\n  LoggerOptions,\n  LoggerMethod,\n  LogMethod,\n  LogMethodDecorator,\n  LoggerDecorators,\n} from './logger';\nexport {\n  createOriginPermissions,\n  DEFAULT_PROD_ORIGINS,\n  DEFAULT_DEV_ORIGINS,\n  DEFAULT_METAMASK_ORIGIN,\n} from './originPermissions/createOriginPermissions';\nexport type { CreateOriginPermissionsParams } from './originPermissions/createOriginPermissions';\nexport { validateOrigin } from './originPermissions/validateOrigin';\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,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,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,iGAK2D;AAJzD,kIAAA,uBAAuB,OAAA;AACvB,+HAAA,oBAAoB,OAAA;AACpB,8HAAA,mBAAmB,OAAA;AACnB,kIAAA,uBAAuB,OAAA;AAGzB,+EAA0E;AAAjE,gHAAA,cAAc,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 { 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 {\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  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';\n"]}

package/dist/index.d.cts

@@ -1,13 +1,16 @@
 export { ASSETS_PROVIDER_NAME, AssetsProvider, type AssetsProviderMessenger, } from "./providers/assets/AssetsProvider.cjs";
 export { REMOTE_FEATURE_FLAGS_PROVIDER_NAME, RemoteFeatureFlagsProvider, type RemoteFeatureFlagsProviderMessenger, } from "./providers/remote-feature-flags/RemoteFeatureFlagsProvider.cjs";
-export { safeMerge } from "./safeMerge/safeMerge.cjs";
-export { buildUrl } from "./buildUrl/buildUrl.cjs";
-export type { BuildUrlParams } from "./buildUrl/buildUrl.cjs";
-export { sanitizeControlCharacters, sanitizeUri } from "./sanitize.cjs";
-export { UrlStruct } from "./urlStruct/urlStruct.cjs";
-export { Logger, LogLevel } from "./logger/index.cjs";
-export type { LoggerOptions, LoggerMethod, LogMethod, LogMethodDecorator, LoggerDecorators, } from "./logger/index.cjs";
-export { createOriginPermissions, DEFAULT_PROD_ORIGINS, DEFAULT_DEV_ORIGINS, DEFAULT_METAMASK_ORIGIN, } from "./originPermissions/createOriginPermissions.cjs";
-export type { CreateOriginPermissionsParams } from "./originPermissions/createOriginPermissions.cjs";
-export { validateOrigin } from "./originPermissions/validateOrigin.cjs";
+export { safeMerge } from "./utils/safeMerge/safeMerge.cjs";
+export { buildUrl } from "./utils/buildUrl/buildUrl.cjs";
+export type { BuildUrlParams } from "./utils/buildUrl/buildUrl.cjs";
+export { sanitizeControlCharacters, sanitizeUri, } from "./utils/sanitize/sanitize.cjs";
+export { UrlStruct } from "./utils/urlStruct/urlStruct.cjs";
+export { batchesAll, batchesAllSettled, batchesAllSettledWithChunks, batchesAllWithChunks, chunks, } from "./utils/async/async.cjs";
+export { Logger, LogLevel } from "./utils/logger/Logger.cjs";
+export type { LoggerOptions, LoggerMethod, LogMethod, LogMethodDecorator, LoggerDecorators, } from "./utils/logger/Logger.cjs";
+export { serialize, deserialize } from "./utils/serialization/serialization.cjs";
+export type { Serializable } from "./utils/serialization/types.cjs";
+export { createOriginPermissions, DEFAULT_PROD_ORIGINS, DEFAULT_DEV_ORIGINS, DEFAULT_METAMASK_ORIGIN, } from "./utils/originPermissions/createOriginPermissions.cjs";
+export type { CreateOriginPermissionsParams } from "./utils/originPermissions/createOriginPermissions.cjs";
+export { validateOrigin } from "./utils/originPermissions/validateOrigin.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":"AAAA,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,KAAK,uBAAuB,GAC7B,8CAA0C;AAC3C,OAAO,EACL,kCAAkC,EAClC,0BAA0B,EAC1B,KAAK,mCAAmC,GACzC,wEAAoE;AACrE,OAAO,EAAE,SAAS,EAAE,kCAA8B;AAClD,OAAO,EAAE,QAAQ,EAAE,gCAA4B;AAC/C,YAAY,EAAE,cAAc,EAAE,gCAA4B;AAC1D,OAAO,EAAE,yBAAyB,EAAE,WAAW,EAAE,uBAAmB;AACpE,OAAO,EAAE,SAAS,EAAE,kCAA8B;AAClD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,2BAAiB;AAC5C,YAAY,EACV,aAAa,EACb,YAAY,EACZ,SAAS,EACT,kBAAkB,EAClB,gBAAgB,GACjB,2BAAiB;AAClB,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,uBAAuB,GACxB,wDAAoD;AACrD,YAAY,EAAE,6BAA6B,EAAE,wDAAoD;AACjG,OAAO,EAAE,cAAc,EAAE,+CAA2C"}
+{"version":3,"file":"index.d.cts","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,EAAE,SAAS,EAAE,wCAAoC;AACxD,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,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,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,uBAAuB,GACxB,8DAA0D;AAC3D,YAAY,EAAE,6BAA6B,EAAE,8DAA0D;AACvG,OAAO,EAAE,cAAc,EAAE,qDAAiD"}

package/dist/index.d.mts

@@ -1,13 +1,16 @@
 export { ASSETS_PROVIDER_NAME, AssetsProvider, type AssetsProviderMessenger, } from "./providers/assets/AssetsProvider.mjs";
 export { REMOTE_FEATURE_FLAGS_PROVIDER_NAME, RemoteFeatureFlagsProvider, type RemoteFeatureFlagsProviderMessenger, } from "./providers/remote-feature-flags/RemoteFeatureFlagsProvider.mjs";
-export { safeMerge } from "./safeMerge/safeMerge.mjs";
-export { buildUrl } from "./buildUrl/buildUrl.mjs";
-export type { BuildUrlParams } from "./buildUrl/buildUrl.mjs";
-export { sanitizeControlCharacters, sanitizeUri } from "./sanitize.mjs";
-export { UrlStruct } from "./urlStruct/urlStruct.mjs";
-export { Logger, LogLevel } from "./logger/index.mjs";
-export type { LoggerOptions, LoggerMethod, LogMethod, LogMethodDecorator, LoggerDecorators, } from "./logger/index.mjs";
-export { createOriginPermissions, DEFAULT_PROD_ORIGINS, DEFAULT_DEV_ORIGINS, DEFAULT_METAMASK_ORIGIN, } from "./originPermissions/createOriginPermissions.mjs";
-export type { CreateOriginPermissionsParams } from "./originPermissions/createOriginPermissions.mjs";
-export { validateOrigin } from "./originPermissions/validateOrigin.mjs";
+export { safeMerge } from "./utils/safeMerge/safeMerge.mjs";
+export { buildUrl } from "./utils/buildUrl/buildUrl.mjs";
+export type { BuildUrlParams } from "./utils/buildUrl/buildUrl.mjs";
+export { sanitizeControlCharacters, sanitizeUri, } from "./utils/sanitize/sanitize.mjs";
+export { UrlStruct } from "./utils/urlStruct/urlStruct.mjs";
+export { batchesAll, batchesAllSettled, batchesAllSettledWithChunks, batchesAllWithChunks, chunks, } from "./utils/async/async.mjs";
+export { Logger, LogLevel } from "./utils/logger/Logger.mjs";
+export type { LoggerOptions, LoggerMethod, LogMethod, LogMethodDecorator, LoggerDecorators, } from "./utils/logger/Logger.mjs";
+export { serialize, deserialize } from "./utils/serialization/serialization.mjs";
+export type { Serializable } from "./utils/serialization/types.mjs";
+export { createOriginPermissions, DEFAULT_PROD_ORIGINS, DEFAULT_DEV_ORIGINS, DEFAULT_METAMASK_ORIGIN, } from "./utils/originPermissions/createOriginPermissions.mjs";
+export type { CreateOriginPermissionsParams } from "./utils/originPermissions/createOriginPermissions.mjs";
+export { validateOrigin } from "./utils/originPermissions/validateOrigin.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":"AAAA,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,KAAK,uBAAuB,GAC7B,8CAA0C;AAC3C,OAAO,EACL,kCAAkC,EAClC,0BAA0B,EAC1B,KAAK,mCAAmC,GACzC,wEAAoE;AACrE,OAAO,EAAE,SAAS,EAAE,kCAA8B;AAClD,OAAO,EAAE,QAAQ,EAAE,gCAA4B;AAC/C,YAAY,EAAE,cAAc,EAAE,gCAA4B;AAC1D,OAAO,EAAE,yBAAyB,EAAE,WAAW,EAAE,uBAAmB;AACpE,OAAO,EAAE,SAAS,EAAE,kCAA8B;AAClD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,2BAAiB;AAC5C,YAAY,EACV,aAAa,EACb,YAAY,EACZ,SAAS,EACT,kBAAkB,EAClB,gBAAgB,GACjB,2BAAiB;AAClB,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,uBAAuB,GACxB,wDAAoD;AACrD,YAAY,EAAE,6BAA6B,EAAE,wDAAoD;AACjG,OAAO,EAAE,cAAc,EAAE,+CAA2C"}
+{"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,EAAE,SAAS,EAAE,wCAAoC;AACxD,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,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,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,uBAAuB,GACxB,8DAA0D;AAC3D,YAAY,EAAE,6BAA6B,EAAE,8DAA0D;AACvG,OAAO,EAAE,cAAc,EAAE,qDAAiD"}

package/dist/index.mjs

@@ -1,10 +1,12 @@
 export { ASSETS_PROVIDER_NAME, AssetsProvider } from "./providers/assets/AssetsProvider.mjs";
 export { REMOTE_FEATURE_FLAGS_PROVIDER_NAME, RemoteFeatureFlagsProvider } from "./providers/remote-feature-flags/RemoteFeatureFlagsProvider.mjs";
-export { safeMerge } from "./safeMerge/safeMerge.mjs";
-export { buildUrl } from "./buildUrl/buildUrl.mjs";
-export { sanitizeControlCharacters, sanitizeUri } from "./sanitize.mjs";
-export { UrlStruct } from "./urlStruct/urlStruct.mjs";
-export { Logger, LogLevel } from "./logger/index.mjs";
-export { createOriginPermissions, DEFAULT_PROD_ORIGINS, DEFAULT_DEV_ORIGINS, DEFAULT_METAMASK_ORIGIN } from "./originPermissions/createOriginPermissions.mjs";
-export { validateOrigin } from "./originPermissions/validateOrigin.mjs";
+export { safeMerge } from "./utils/safeMerge/safeMerge.mjs";
+export { buildUrl } from "./utils/buildUrl/buildUrl.mjs";
+export { sanitizeControlCharacters, sanitizeUri } from "./utils/sanitize/sanitize.mjs";
+export { UrlStruct } from "./utils/urlStruct/urlStruct.mjs";
+export { batchesAll, batchesAllSettled, batchesAllSettledWithChunks, batchesAllWithChunks, chunks } from "./utils/async/async.mjs";
+export { Logger, LogLevel } from "./utils/logger/Logger.mjs";
+export { serialize, deserialize } from "./utils/serialization/serialization.mjs";
+export { createOriginPermissions, DEFAULT_PROD_ORIGINS, DEFAULT_DEV_ORIGINS, DEFAULT_METAMASK_ORIGIN } from "./utils/originPermissions/createOriginPermissions.mjs";
+export { validateOrigin } from "./utils/originPermissions/validateOrigin.mjs";
 //# sourceMappingURL=index.mjs.map

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,EAAE,SAAS,EAAE,kCAA8B;AAClD,OAAO,EAAE,QAAQ,EAAE,gCAA4B;AAE/C,OAAO,EAAE,yBAAyB,EAAE,WAAW,EAAE,uBAAmB;AACpE,OAAO,EAAE,SAAS,EAAE,kCAA8B;AAClD,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,2BAAiB;AAQ5C,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,uBAAuB,EACxB,wDAAoD;AAErD,OAAO,EAAE,cAAc,EAAE,+CAA2C","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 { safeMerge } from './safeMerge/safeMerge';\nexport { buildUrl } from './buildUrl/buildUrl';\nexport type { BuildUrlParams } from './buildUrl/buildUrl';\nexport { sanitizeControlCharacters, sanitizeUri } from './sanitize';\nexport { UrlStruct } from './urlStruct/urlStruct';\nexport { Logger, LogLevel } from './logger';\nexport type {\n  LoggerOptions,\n  LoggerMethod,\n  LogMethod,\n  LogMethodDecorator,\n  LoggerDecorators,\n} from './logger';\nexport {\n  createOriginPermissions,\n  DEFAULT_PROD_ORIGINS,\n  DEFAULT_DEV_ORIGINS,\n  DEFAULT_METAMASK_ORIGIN,\n} from './originPermissions/createOriginPermissions';\nexport type { CreateOriginPermissionsParams } from './originPermissions/createOriginPermissions';\nexport { validateOrigin } from './originPermissions/validateOrigin';\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,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,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,uBAAuB,EACvB,oBAAoB,EACpB,mBAAmB,EACnB,uBAAuB,EACxB,8DAA0D;AAE3D,OAAO,EAAE,cAAc,EAAE,qDAAiD","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 { 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 {\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  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';\n"]}

package/dist/utils/async/async.cjs

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.chunks = chunks;
+exports.batchesAll = batchesAll;
+exports.batchesAllSettled = batchesAllSettled;
+exports.batchesAllSettledWithChunks = batchesAllSettledWithChunks;
+exports.batchesAllWithChunks = batchesAllWithChunks;
+/**
+ * Splits items into chunks of a given size.
+ *
+ * @param items - Input items; order is preserved in the returned chunks.
+ * @param chunkSize - Size of each chunk (must be ≥ 1).
+ * @returns An array of chunks, each containing `chunkSize` items.
+ */
+function chunks(items, chunkSize) {
+    if (chunkSize < 1) {
+        throw new RangeError('chunkSize must be at least 1');
+    }
+    const itemsChunks = [];
+    for (let index = 0; index < items.length; index += chunkSize) {
+        itemsChunks.push(items.slice(index, index + chunkSize));
+    }
+    return itemsChunks;
+}
+/**
+ * Runs async work on items in fixed-size waves, using {@link Promise.all} per wave.
+ * The next wave starts only after the current wave completes; any rejection fails the whole call.
+ *
+ * @param items - Input items; order is preserved in the returned results.
+ * @param batchSize - Maximum concurrent mapper invocations per wave (must be ≥ 1).
+ * @param mapper - Async function for each item; receives the global index in `items`.
+ * @returns One result per item, in the same order as `items`.
+ */
+async function batchesAll(items, batchSize, mapper) {
+    if (batchSize < 1) {
+        throw new RangeError('batchSize must be at least 1');
+    }
+    const results = [];
+    for (let index = 0; index < items.length; index += batchSize) {
+        const batch = items.slice(index, index + batchSize);
+        const batchResults = await Promise.all(batch.map(async (item, batchOffset) => mapper(item, index + batchOffset)));
+        results.push(...batchResults);
+    }
+    return results;
+}
+/**
+ * Runs async work on items in fixed-size waves, using {@link Promise.allSettled} per wave.
+ * The next wave starts only after the current one settles, limiting concurrency to `batchSize`.
+ *
+ * @param items - Input items; order is preserved in the returned results.
+ * @param batchSize - Maximum concurrent mapper invocations per wave (must be ≥ 1).
+ * @param mapper - Async function for each item; receives the global index in `items`.
+ * @returns One settled result per item, in the same order as `items`.
+ */
+async function batchesAllSettled(items, batchSize, mapper) {
+    if (batchSize < 1) {
+        throw new RangeError('batchSize must be at least 1');
+    }
+    const results = [];
+    for (let index = 0; index < items.length; index += batchSize) {
+        const batch = items.slice(index, index + batchSize);
+        const settled = await Promise.allSettled(batch.map(async (item, batchOffset) => mapper(item, index + batchOffset)));
+        results.push(...settled);
+    }
+    return results;
+}
+/**
+ * Splits `items` into consecutive chunks of `chunkSize`, then runs {@link batchesAllSettled} on those chunks.
+ * Each mapper call receives one chunk; settled results are in chunk order (same order as {@link chunks}).
+ *
+ * @param items - Flat input items.
+ * @param chunkSize - Items per chunk (must be ≥ 1).
+ * @param batchSize - Max concurrent chunk mappers per wave (must be ≥ 1).
+ * @param mapper - Async work for a single chunk; second argument is the chunk index (0-based).
+ * @returns One settled result per chunk.
+ */
+async function batchesAllSettledWithChunks(items, chunkSize, batchSize, mapper) {
+    const itemChunks = chunks(items, chunkSize);
+    return batchesAllSettled(itemChunks, batchSize, async (chunk, chunkIndex) => mapper(chunk, chunkIndex));
+}
+/**
+ * Splits `items` into consecutive chunks of `chunkSize`, then runs {@link batchesAll} on those chunks.
+ * Each mapper call receives one chunk; results are in chunk order (same order as {@link chunks}).
+ *
+ * @param items - Flat input items.
+ * @param chunkSize - Items per chunk (must be ≥ 1).
+ * @param batchSize - Max concurrent chunk mappers per wave (must be ≥ 1).
+ * @param mapper - Async work for a single chunk; second argument is the chunk index (0-based).
+ * @returns One result per chunk.
+ */
+async function batchesAllWithChunks(items, chunkSize, batchSize, mapper) {
+    const itemChunks = chunks(items, chunkSize);
+    return batchesAll(itemChunks, batchSize, async (chunk, chunkIndex) => mapper(chunk, chunkIndex));
+}
+//# sourceMappingURL=async.cjs.map

package/dist/utils/async/async.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"async.cjs","sourceRoot":"","sources":["../../../src/utils/async/async.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Splits items into chunks of a given size.\n *\n * @param items - Input items; order is preserved in the returned chunks.\n * @param chunkSize - Size of each chunk (must be ≥ 1).\n * @returns An array of chunks, each containing `chunkSize` items.\n */\nexport function chunks<TItem>(\n  items: readonly TItem[],\n  chunkSize: number,\n): TItem[][] {\n  if (chunkSize < 1) {\n    throw new RangeError('chunkSize must be at least 1');\n  }\n\n  const itemsChunks: TItem[][] = [];\n  for (let index = 0; index < items.length; index += chunkSize) {\n    itemsChunks.push(items.slice(index, index + chunkSize));\n  }\n  return itemsChunks;\n}\n\n/**\n * Runs async work on items in fixed-size waves, using {@link Promise.all} per wave.\n * The next wave starts only after the current wave completes; any rejection fails the whole call.\n *\n * @param items - Input items; order is preserved in the returned results.\n * @param batchSize - Maximum concurrent mapper invocations per wave (must be ≥ 1).\n * @param mapper - Async function for each item; receives the global index in `items`.\n * @returns One result per item, in the same order as `items`.\n */\nexport async function batchesAll<TItem, TResult>(\n  items: readonly TItem[],\n  batchSize: number,\n  mapper: (item: TItem, index: number) => Promise<TResult>,\n): Promise<TResult[]> {\n  if (batchSize < 1) {\n    throw new RangeError('batchSize must be at least 1');\n  }\n\n  const results: TResult[] = [];\n\n  for (let index = 0; index < items.length; index += batchSize) {\n    const batch = items.slice(index, index + batchSize);\n    const batchResults = await Promise.all(\n      batch.map(async (item, batchOffset) => mapper(item, index + batchOffset)),\n    );\n    results.push(...batchResults);\n  }\n\n  return results;\n}\n\n/**\n * Runs async work on items in fixed-size waves, using {@link Promise.allSettled} per wave.\n * The next wave starts only after the current one settles, limiting concurrency to `batchSize`.\n *\n * @param items - Input items; order is preserved in the returned results.\n * @param batchSize - Maximum concurrent mapper invocations per wave (must be ≥ 1).\n * @param mapper - Async function for each item; receives the global index in `items`.\n * @returns One settled result per item, in the same order as `items`.\n */\nexport async function batchesAllSettled<TItem, TResult>(\n  items: readonly TItem[],\n  batchSize: number,\n  mapper: (item: TItem, index: number) => Promise<TResult>,\n): Promise<PromiseSettledResult<TResult>[]> {\n  if (batchSize < 1) {\n    throw new RangeError('batchSize must be at least 1');\n  }\n\n  const results: PromiseSettledResult<TResult>[] = [];\n\n  for (let index = 0; index < items.length; index += batchSize) {\n    const batch = items.slice(index, index + batchSize);\n    const settled = await Promise.allSettled(\n      batch.map(async (item, batchOffset) => mapper(item, index + batchOffset)),\n    );\n    results.push(...settled);\n  }\n\n  return results;\n}\n\n/**\n * Splits `items` into consecutive chunks of `chunkSize`, then runs {@link batchesAllSettled} on those chunks.\n * Each mapper call receives one chunk; settled results are in chunk order (same order as {@link chunks}).\n *\n * @param items - Flat input items.\n * @param chunkSize - Items per chunk (must be ≥ 1).\n * @param batchSize - Max concurrent chunk mappers per wave (must be ≥ 1).\n * @param mapper - Async work for a single chunk; second argument is the chunk index (0-based).\n * @returns One settled result per chunk.\n */\nexport async function batchesAllSettledWithChunks<TItem, TResult>(\n  items: readonly TItem[],\n  chunkSize: number,\n  batchSize: number,\n  mapper: (chunk: TItem[], chunkIndex: number) => Promise<TResult>,\n): Promise<PromiseSettledResult<TResult>[]> {\n  const itemChunks = chunks(items, chunkSize);\n  return batchesAllSettled(itemChunks, batchSize, async (chunk, chunkIndex) =>\n    mapper(chunk, chunkIndex),\n  );\n}\n\n/**\n * Splits `items` into consecutive chunks of `chunkSize`, then runs {@link batchesAll} on those chunks.\n * Each mapper call receives one chunk; results are in chunk order (same order as {@link chunks}).\n *\n * @param items - Flat input items.\n * @param chunkSize - Items per chunk (must be ≥ 1).\n * @param batchSize - Max concurrent chunk mappers per wave (must be ≥ 1).\n * @param mapper - Async work for a single chunk; second argument is the chunk index (0-based).\n * @returns One result per chunk.\n */\nexport async function batchesAllWithChunks<TItem, TResult>(\n  items: readonly TItem[],\n  chunkSize: number,\n  batchSize: number,\n  mapper: (chunk: TItem[], chunkIndex: number) => Promise<TResult>,\n): Promise<TResult[]> {\n  const itemChunks = chunks(items, chunkSize);\n  return batchesAll(itemChunks, batchSize, async (chunk, chunkIndex) =>\n    mapper(chunk, chunkIndex),\n  );\n}\n"]}

package/dist/utils/async/async.d.cts

@@ -0,0 +1,51 @@
+/**
+ * Splits items into chunks of a given size.
+ *
+ * @param items - Input items; order is preserved in the returned chunks.
+ * @param chunkSize - Size of each chunk (must be ≥ 1).
+ * @returns An array of chunks, each containing `chunkSize` items.
+ */
+export declare function chunks<TItem>(items: readonly TItem[], chunkSize: number): TItem[][];
+/**
+ * Runs async work on items in fixed-size waves, using {@link Promise.all} per wave.
+ * The next wave starts only after the current wave completes; any rejection fails the whole call.
+ *
+ * @param items - Input items; order is preserved in the returned results.
+ * @param batchSize - Maximum concurrent mapper invocations per wave (must be ≥ 1).
+ * @param mapper - Async function for each item; receives the global index in `items`.
+ * @returns One result per item, in the same order as `items`.
+ */
+export declare function batchesAll<TItem, TResult>(items: readonly TItem[], batchSize: number, mapper: (item: TItem, index: number) => Promise<TResult>): Promise<TResult[]>;
+/**
+ * Runs async work on items in fixed-size waves, using {@link Promise.allSettled} per wave.
+ * The next wave starts only after the current one settles, limiting concurrency to `batchSize`.
+ *
+ * @param items - Input items; order is preserved in the returned results.
+ * @param batchSize - Maximum concurrent mapper invocations per wave (must be ≥ 1).
+ * @param mapper - Async function for each item; receives the global index in `items`.
+ * @returns One settled result per item, in the same order as `items`.
+ */
+export declare function batchesAllSettled<TItem, TResult>(items: readonly TItem[], batchSize: number, mapper: (item: TItem, index: number) => Promise<TResult>): Promise<PromiseSettledResult<TResult>[]>;
+/**
+ * Splits `items` into consecutive chunks of `chunkSize`, then runs {@link batchesAllSettled} on those chunks.
+ * Each mapper call receives one chunk; settled results are in chunk order (same order as {@link chunks}).
+ *
+ * @param items - Flat input items.
+ * @param chunkSize - Items per chunk (must be ≥ 1).
+ * @param batchSize - Max concurrent chunk mappers per wave (must be ≥ 1).
+ * @param mapper - Async work for a single chunk; second argument is the chunk index (0-based).
+ * @returns One settled result per chunk.
+ */
+export declare function batchesAllSettledWithChunks<TItem, TResult>(items: readonly TItem[], chunkSize: number, batchSize: number, mapper: (chunk: TItem[], chunkIndex: number) => Promise<TResult>): Promise<PromiseSettledResult<TResult>[]>;
+/**
+ * Splits `items` into consecutive chunks of `chunkSize`, then runs {@link batchesAll} on those chunks.
+ * Each mapper call receives one chunk; results are in chunk order (same order as {@link chunks}).
+ *
+ * @param items - Flat input items.
+ * @param chunkSize - Items per chunk (must be ≥ 1).
+ * @param batchSize - Max concurrent chunk mappers per wave (must be ≥ 1).
+ * @param mapper - Async work for a single chunk; second argument is the chunk index (0-based).
+ * @returns One result per chunk.
+ */
+export declare function batchesAllWithChunks<TItem, TResult>(items: readonly TItem[], chunkSize: number, batchSize: number, mapper: (chunk: TItem[], chunkIndex: number) => Promise<TResult>): Promise<TResult[]>;
+//# sourceMappingURL=async.d.cts.map

package/dist/utils/async/async.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async.d.cts","sourceRoot":"","sources":["../../../src/utils/async/async.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAC1B,KAAK,EAAE,SAAS,KAAK,EAAE,EACvB,SAAS,EAAE,MAAM,GAChB,KAAK,EAAE,EAAE,CAUX;AAED;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,OAAO,EAC7C,KAAK,EAAE,SAAS,KAAK,EAAE,EACvB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,GACvD,OAAO,CAAC,OAAO,EAAE,CAAC,CAgBpB;AAED;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EACpD,KAAK,EAAE,SAAS,KAAK,EAAE,EACvB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,GACvD,OAAO,CAAC,oBAAoB,CAAC,OAAO,CAAC,EAAE,CAAC,CAgB1C;AAED;;;;;;;;;GASG;AACH,wBAAsB,2BAA2B,CAAC,KAAK,EAAE,OAAO,EAC9D,KAAK,EAAE,SAAS,KAAK,EAAE,EACvB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,GAC/D,OAAO,CAAC,oBAAoB,CAAC,OAAO,CAAC,EAAE,CAAC,CAK1C;AAED;;;;;;;;;GASG;AACH,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EACvD,KAAK,EAAE,SAAS,KAAK,EAAE,EACvB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,GAC/D,OAAO,CAAC,OAAO,EAAE,CAAC,CAKpB"}

package/dist/utils/async/async.d.mts

@@ -0,0 +1,51 @@
+/**
+ * Splits items into chunks of a given size.
+ *
+ * @param items - Input items; order is preserved in the returned chunks.
+ * @param chunkSize - Size of each chunk (must be ≥ 1).
+ * @returns An array of chunks, each containing `chunkSize` items.
+ */
+export declare function chunks<TItem>(items: readonly TItem[], chunkSize: number): TItem[][];
+/**
+ * Runs async work on items in fixed-size waves, using {@link Promise.all} per wave.
+ * The next wave starts only after the current wave completes; any rejection fails the whole call.
+ *
+ * @param items - Input items; order is preserved in the returned results.
+ * @param batchSize - Maximum concurrent mapper invocations per wave (must be ≥ 1).
+ * @param mapper - Async function for each item; receives the global index in `items`.
+ * @returns One result per item, in the same order as `items`.
+ */
+export declare function batchesAll<TItem, TResult>(items: readonly TItem[], batchSize: number, mapper: (item: TItem, index: number) => Promise<TResult>): Promise<TResult[]>;
+/**
+ * Runs async work on items in fixed-size waves, using {@link Promise.allSettled} per wave.
+ * The next wave starts only after the current one settles, limiting concurrency to `batchSize`.
+ *
+ * @param items - Input items; order is preserved in the returned results.
+ * @param batchSize - Maximum concurrent mapper invocations per wave (must be ≥ 1).
+ * @param mapper - Async function for each item; receives the global index in `items`.
+ * @returns One settled result per item, in the same order as `items`.
+ */
+export declare function batchesAllSettled<TItem, TResult>(items: readonly TItem[], batchSize: number, mapper: (item: TItem, index: number) => Promise<TResult>): Promise<PromiseSettledResult<TResult>[]>;
+/**
+ * Splits `items` into consecutive chunks of `chunkSize`, then runs {@link batchesAllSettled} on those chunks.
+ * Each mapper call receives one chunk; settled results are in chunk order (same order as {@link chunks}).
+ *
+ * @param items - Flat input items.
+ * @param chunkSize - Items per chunk (must be ≥ 1).
+ * @param batchSize - Max concurrent chunk mappers per wave (must be ≥ 1).
+ * @param mapper - Async work for a single chunk; second argument is the chunk index (0-based).
+ * @returns One settled result per chunk.
+ */
+export declare function batchesAllSettledWithChunks<TItem, TResult>(items: readonly TItem[], chunkSize: number, batchSize: number, mapper: (chunk: TItem[], chunkIndex: number) => Promise<TResult>): Promise<PromiseSettledResult<TResult>[]>;
+/**
+ * Splits `items` into consecutive chunks of `chunkSize`, then runs {@link batchesAll} on those chunks.
+ * Each mapper call receives one chunk; results are in chunk order (same order as {@link chunks}).
+ *
+ * @param items - Flat input items.
+ * @param chunkSize - Items per chunk (must be ≥ 1).
+ * @param batchSize - Max concurrent chunk mappers per wave (must be ≥ 1).
+ * @param mapper - Async work for a single chunk; second argument is the chunk index (0-based).
+ * @returns One result per chunk.
+ */
+export declare function batchesAllWithChunks<TItem, TResult>(items: readonly TItem[], chunkSize: number, batchSize: number, mapper: (chunk: TItem[], chunkIndex: number) => Promise<TResult>): Promise<TResult[]>;
+//# sourceMappingURL=async.d.mts.map

package/dist/utils/async/async.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async.d.mts","sourceRoot":"","sources":["../../../src/utils/async/async.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAC1B,KAAK,EAAE,SAAS,KAAK,EAAE,EACvB,SAAS,EAAE,MAAM,GAChB,KAAK,EAAE,EAAE,CAUX;AAED;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,OAAO,EAC7C,KAAK,EAAE,SAAS,KAAK,EAAE,EACvB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,GACvD,OAAO,CAAC,OAAO,EAAE,CAAC,CAgBpB;AAED;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EACpD,KAAK,EAAE,SAAS,KAAK,EAAE,EACvB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,GACvD,OAAO,CAAC,oBAAoB,CAAC,OAAO,CAAC,EAAE,CAAC,CAgB1C;AAED;;;;;;;;;GASG;AACH,wBAAsB,2BAA2B,CAAC,KAAK,EAAE,OAAO,EAC9D,KAAK,EAAE,SAAS,KAAK,EAAE,EACvB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,GAC/D,OAAO,CAAC,oBAAoB,CAAC,OAAO,CAAC,EAAE,CAAC,CAK1C;AAED;;;;;;;;;GASG;AACH,wBAAsB,oBAAoB,CAAC,KAAK,EAAE,OAAO,EACvD,KAAK,EAAE,SAAS,KAAK,EAAE,EACvB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,GAC/D,OAAO,CAAC,OAAO,EAAE,CAAC,CAKpB"}

package/dist/utils/async/async.mjs

@@ -0,0 +1,88 @@
+/**
+ * Splits items into chunks of a given size.
+ *
+ * @param items - Input items; order is preserved in the returned chunks.
+ * @param chunkSize - Size of each chunk (must be ≥ 1).
+ * @returns An array of chunks, each containing `chunkSize` items.
+ */
+export function chunks(items, chunkSize) {
+    if (chunkSize < 1) {
+        throw new RangeError('chunkSize must be at least 1');
+    }
+    const itemsChunks = [];
+    for (let index = 0; index < items.length; index += chunkSize) {
+        itemsChunks.push(items.slice(index, index + chunkSize));
+    }
+    return itemsChunks;
+}
+/**
+ * Runs async work on items in fixed-size waves, using {@link Promise.all} per wave.
+ * The next wave starts only after the current wave completes; any rejection fails the whole call.
+ *
+ * @param items - Input items; order is preserved in the returned results.
+ * @param batchSize - Maximum concurrent mapper invocations per wave (must be ≥ 1).
+ * @param mapper - Async function for each item; receives the global index in `items`.
+ * @returns One result per item, in the same order as `items`.
+ */
+export async function batchesAll(items, batchSize, mapper) {
+    if (batchSize < 1) {
+        throw new RangeError('batchSize must be at least 1');
+    }
+    const results = [];
+    for (let index = 0; index < items.length; index += batchSize) {
+        const batch = items.slice(index, index + batchSize);
+        const batchResults = await Promise.all(batch.map(async (item, batchOffset) => mapper(item, index + batchOffset)));
+        results.push(...batchResults);
+    }
+    return results;
+}
+/**
+ * Runs async work on items in fixed-size waves, using {@link Promise.allSettled} per wave.
+ * The next wave starts only after the current one settles, limiting concurrency to `batchSize`.
+ *
+ * @param items - Input items; order is preserved in the returned results.
+ * @param batchSize - Maximum concurrent mapper invocations per wave (must be ≥ 1).
+ * @param mapper - Async function for each item; receives the global index in `items`.
+ * @returns One settled result per item, in the same order as `items`.
+ */
+export async function batchesAllSettled(items, batchSize, mapper) {
+    if (batchSize < 1) {
+        throw new RangeError('batchSize must be at least 1');
+    }
+    const results = [];
+    for (let index = 0; index < items.length; index += batchSize) {
+        const batch = items.slice(index, index + batchSize);
+        const settled = await Promise.allSettled(batch.map(async (item, batchOffset) => mapper(item, index + batchOffset)));
+        results.push(...settled);
+    }
+    return results;
+}
+/**
+ * Splits `items` into consecutive chunks of `chunkSize`, then runs {@link batchesAllSettled} on those chunks.
+ * Each mapper call receives one chunk; settled results are in chunk order (same order as {@link chunks}).
+ *
+ * @param items - Flat input items.
+ * @param chunkSize - Items per chunk (must be ≥ 1).
+ * @param batchSize - Max concurrent chunk mappers per wave (must be ≥ 1).
+ * @param mapper - Async work for a single chunk; second argument is the chunk index (0-based).
+ * @returns One settled result per chunk.
+ */
+export async function batchesAllSettledWithChunks(items, chunkSize, batchSize, mapper) {
+    const itemChunks = chunks(items, chunkSize);
+    return batchesAllSettled(itemChunks, batchSize, async (chunk, chunkIndex) => mapper(chunk, chunkIndex));
+}
+/**
+ * Splits `items` into consecutive chunks of `chunkSize`, then runs {@link batchesAll} on those chunks.
+ * Each mapper call receives one chunk; results are in chunk order (same order as {@link chunks}).
+ *
+ * @param items - Flat input items.
+ * @param chunkSize - Items per chunk (must be ≥ 1).
+ * @param batchSize - Max concurrent chunk mappers per wave (must be ≥ 1).
+ * @param mapper - Async work for a single chunk; second argument is the chunk index (0-based).
+ * @returns One result per chunk.
+ */
+export async function batchesAllWithChunks(items, chunkSize, batchSize, mapper) {
+    const itemChunks = chunks(items, chunkSize);
+    return batchesAll(itemChunks, batchSize, async (chunk, chunkIndex) => mapper(chunk, chunkIndex));
+}
+//# sourceMappingURL=async.mjs.map

package/dist/utils/async/async.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"async.mjs","sourceRoot":"","sources":["../../../src/utils/async/async.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Splits items into chunks of a given size.\n *\n * @param items - Input items; order is preserved in the returned chunks.\n * @param chunkSize - Size of each chunk (must be ≥ 1).\n * @returns An array of chunks, each containing `chunkSize` items.\n */\nexport function chunks<TItem>(\n  items: readonly TItem[],\n  chunkSize: number,\n): TItem[][] {\n  if (chunkSize < 1) {\n    throw new RangeError('chunkSize must be at least 1');\n  }\n\n  const itemsChunks: TItem[][] = [];\n  for (let index = 0; index < items.length; index += chunkSize) {\n    itemsChunks.push(items.slice(index, index + chunkSize));\n  }\n  return itemsChunks;\n}\n\n/**\n * Runs async work on items in fixed-size waves, using {@link Promise.all} per wave.\n * The next wave starts only after the current wave completes; any rejection fails the whole call.\n *\n * @param items - Input items; order is preserved in the returned results.\n * @param batchSize - Maximum concurrent mapper invocations per wave (must be ≥ 1).\n * @param mapper - Async function for each item; receives the global index in `items`.\n * @returns One result per item, in the same order as `items`.\n */\nexport async function batchesAll<TItem, TResult>(\n  items: readonly TItem[],\n  batchSize: number,\n  mapper: (item: TItem, index: number) => Promise<TResult>,\n): Promise<TResult[]> {\n  if (batchSize < 1) {\n    throw new RangeError('batchSize must be at least 1');\n  }\n\n  const results: TResult[] = [];\n\n  for (let index = 0; index < items.length; index += batchSize) {\n    const batch = items.slice(index, index + batchSize);\n    const batchResults = await Promise.all(\n      batch.map(async (item, batchOffset) => mapper(item, index + batchOffset)),\n    );\n    results.push(...batchResults);\n  }\n\n  return results;\n}\n\n/**\n * Runs async work on items in fixed-size waves, using {@link Promise.allSettled} per wave.\n * The next wave starts only after the current one settles, limiting concurrency to `batchSize`.\n *\n * @param items - Input items; order is preserved in the returned results.\n * @param batchSize - Maximum concurrent mapper invocations per wave (must be ≥ 1).\n * @param mapper - Async function for each item; receives the global index in `items`.\n * @returns One settled result per item, in the same order as `items`.\n */\nexport async function batchesAllSettled<TItem, TResult>(\n  items: readonly TItem[],\n  batchSize: number,\n  mapper: (item: TItem, index: number) => Promise<TResult>,\n): Promise<PromiseSettledResult<TResult>[]> {\n  if (batchSize < 1) {\n    throw new RangeError('batchSize must be at least 1');\n  }\n\n  const results: PromiseSettledResult<TResult>[] = [];\n\n  for (let index = 0; index < items.length; index += batchSize) {\n    const batch = items.slice(index, index + batchSize);\n    const settled = await Promise.allSettled(\n      batch.map(async (item, batchOffset) => mapper(item, index + batchOffset)),\n    );\n    results.push(...settled);\n  }\n\n  return results;\n}\n\n/**\n * Splits `items` into consecutive chunks of `chunkSize`, then runs {@link batchesAllSettled} on those chunks.\n * Each mapper call receives one chunk; settled results are in chunk order (same order as {@link chunks}).\n *\n * @param items - Flat input items.\n * @param chunkSize - Items per chunk (must be ≥ 1).\n * @param batchSize - Max concurrent chunk mappers per wave (must be ≥ 1).\n * @param mapper - Async work for a single chunk; second argument is the chunk index (0-based).\n * @returns One settled result per chunk.\n */\nexport async function batchesAllSettledWithChunks<TItem, TResult>(\n  items: readonly TItem[],\n  chunkSize: number,\n  batchSize: number,\n  mapper: (chunk: TItem[], chunkIndex: number) => Promise<TResult>,\n): Promise<PromiseSettledResult<TResult>[]> {\n  const itemChunks = chunks(items, chunkSize);\n  return batchesAllSettled(itemChunks, batchSize, async (chunk, chunkIndex) =>\n    mapper(chunk, chunkIndex),\n  );\n}\n\n/**\n * Splits `items` into consecutive chunks of `chunkSize`, then runs {@link batchesAll} on those chunks.\n * Each mapper call receives one chunk; results are in chunk order (same order as {@link chunks}).\n *\n * @param items - Flat input items.\n * @param chunkSize - Items per chunk (must be ≥ 1).\n * @param batchSize - Max concurrent chunk mappers per wave (must be ≥ 1).\n * @param mapper - Async work for a single chunk; second argument is the chunk index (0-based).\n * @returns One result per chunk.\n */\nexport async function batchesAllWithChunks<TItem, TResult>(\n  items: readonly TItem[],\n  chunkSize: number,\n  batchSize: number,\n  mapper: (chunk: TItem[], chunkIndex: number) => Promise<TResult>,\n): Promise<TResult[]> {\n  const itemChunks = chunks(items, chunkSize);\n  return batchesAll(itemChunks, batchSize, async (chunk, chunkIndex) =>\n    mapper(chunk, chunkIndex),\n  );\n}\n"]}

package/dist/{buildUrl → utils/buildUrl}/buildUrl.cjs

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.buildUrl = buildUrl;
 const superstruct_1 = require("@metamask/superstruct");
-const sanitize_1 = require("../sanitize.cjs");
+const sanitize_1 = require("../sanitize/sanitize.cjs");
 const urlStruct_1 = require("../urlStruct/urlStruct.cjs");
 /**
  * Builds a safe URL from a base URL, path, and optional parameters.

package/dist/utils/buildUrl/buildUrl.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildUrl.cjs","sourceRoot":"","sources":["../../../src/utils/buildUrl/buildUrl.ts"],"names":[],"mappings":";;AAmBA,4BAqDC;AAxED,uDAA+C;AAE/C,uDAA8E;AAC9E,0DAAmD;AAUnD;;;;;GAKG;AACH,SAAgB,QAAQ,CAAC,MAAsB;IAC7C,MAAM,EACJ,OAAO,EACP,IAAI,EACJ,UAAU,EACV,WAAW,EACX,gBAAgB,GAAG,IAAI,GACxB,GAAG,MAAM,CAAC;IAEX,iCAAiC;IACjC,MAAM,gBAAgB,GAAG,IAAA,sBAAW,EAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,gBAAgB,KAAK,EAAE,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;IACxC,CAAC;IACD,IAAA,oBAAM,EAAC,gBAAgB,EAAE,qBAAS,CAAC,CAAC;IAEpC,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,EAAE,GAAW,EAAE,EAAE;QACpE,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,kBAAkB,GAAG,eAAe,CAAC,CAAC;QACxD,CAAC;QACD,8DAA8D;QAC9D,MAAM,cAAc,GAAG,IAAA,oCAAyB,EAAC,KAAK,CAAC,CAAC;QACxD,OAAO,gBAAgB;YACrB,CAAC,CAAC,kBAAkB,CAAC,cAAc,CAAC;YACpC,CAAC,CAAC,cAAc,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,cAAc;SAC7B,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;SACpB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAExB,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,QAAQ,CAAC,GAAG,CAAC;QACtD,CAAC,CAAC,gBAAgB;QAClB,CAAC,CAAC,GAAG,gBAAgB,GAAG,CAAC;IAE3B,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;IAElD,MAAM,CAAC,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC;SAC9B,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC;SAC3C,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC;SACtC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QACxB,IAAI,KAAK,EAAE,CAAC;YACV,+DAA+D;YAC/D,MAAM,cAAc,GAAG,IAAA,oCAAyB,EAAC,KAAK,CAAC,CAAC;YACxD,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,EAAE,CAAC;IAChC,IAAA,oBAAM,EAAC,QAAQ,EAAE,qBAAS,CAAC,CAAC;IAC5B,OAAO,QAAQ,CAAC;AAClB,CAAC","sourcesContent":["import { assert } from '@metamask/superstruct';\n\nimport { sanitizeControlCharacters, sanitizeUri } from '../sanitize/sanitize';\nimport { UrlStruct } from '../urlStruct/urlStruct';\n\nexport type BuildUrlParams = {\n  baseUrl: string;\n  path: string;\n  pathParams?: Record<string, string> | undefined;\n  queryParams?: Record<string, string> | undefined;\n  encodePathParams?: boolean;\n};\n\n/**\n * Builds a safe URL from a base URL, path, and optional parameters.\n *\n * @param params - The parameters to build the URL from.\n * @returns The validated, sanitized URL.\n */\nexport function buildUrl(params: BuildUrlParams): string {\n  const {\n    baseUrl,\n    path,\n    pathParams,\n    queryParams,\n    encodePathParams = true,\n  } = params;\n\n  // Validate and sanitize base URL\n  const sanitizedBaseUrl = sanitizeUri(baseUrl);\n  if (sanitizedBaseUrl === '') {\n    throw new Error('Invalid URL format');\n  }\n  assert(sanitizedBaseUrl, UrlStruct);\n\n  const pathWithParams = path.replace(/\\{(\\w+)\\}/gu, (_, key: string) => {\n    const value = pathParams?.[key];\n    if (value === undefined) {\n      throw new Error(`Path parameter ${key} is undefined`);\n    }\n    // Sanitize path parameter values to remove control characters\n    const sanitizedValue = sanitizeControlCharacters(value);\n    return encodePathParams\n      ? encodeURIComponent(sanitizedValue)\n      : sanitizedValue;\n  });\n\n  const cleanPath = pathWithParams\n    .replace(/^\\/+/u, '')\n    .replace(/\\/+/gu, '/')\n    .replace(/\\/+$/u, '');\n\n  const normalizedBaseUrl = sanitizedBaseUrl.endsWith('/')\n    ? sanitizedBaseUrl\n    : `${sanitizedBaseUrl}/`;\n\n  const url = new URL(cleanPath, normalizedBaseUrl);\n\n  Object.entries(queryParams ?? {})\n    .filter(([_, value]) => value !== undefined)\n    .filter(([_, value]) => value !== null)\n    .forEach(([key, value]) => {\n      if (value) {\n        // Sanitize query parameter values to remove control characters\n        const sanitizedValue = sanitizeControlCharacters(value);\n        url.searchParams.append(key, sanitizedValue);\n      }\n    });\n\n  const builtUrl = url.toString();\n  assert(builtUrl, UrlStruct);\n  return builtUrl;\n}\n"]}

package/dist/utils/buildUrl/buildUrl.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildUrl.d.cts","sourceRoot":"","sources":["../../../src/utils/buildUrl/buildUrl.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IACjD,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAqDvD"}

package/dist/utils/buildUrl/buildUrl.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildUrl.d.mts","sourceRoot":"","sources":["../../../src/utils/buildUrl/buildUrl.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IACjD,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAqDvD"}

package/dist/{buildUrl → utils/buildUrl}/buildUrl.mjs

@@ -1,5 +1,5 @@
 import { assert } from "@metamask/superstruct";
-import { sanitizeControlCharacters, sanitizeUri } from "../sanitize.mjs";
+import { sanitizeControlCharacters, sanitizeUri } from "../sanitize/sanitize.mjs";
 import { UrlStruct } from "../urlStruct/urlStruct.mjs";
 /**
  * Builds a safe URL from a base URL, path, and optional parameters.

package/dist/utils/buildUrl/buildUrl.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildUrl.mjs","sourceRoot":"","sources":["../../../src/utils/buildUrl/buildUrl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,8BAA8B;AAE/C,OAAO,EAAE,yBAAyB,EAAE,WAAW,EAAE,iCAA6B;AAC9E,OAAO,EAAE,SAAS,EAAE,mCAA+B;AAUnD;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAsB;IAC7C,MAAM,EACJ,OAAO,EACP,IAAI,EACJ,UAAU,EACV,WAAW,EACX,gBAAgB,GAAG,IAAI,GACxB,GAAG,MAAM,CAAC;IAEX,iCAAiC;IACjC,MAAM,gBAAgB,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC;IAC9C,IAAI,gBAAgB,KAAK,EAAE,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;IACxC,CAAC;IACD,MAAM,CAAC,gBAAgB,EAAE,SAAS,CAAC,CAAC;IAEpC,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC,EAAE,GAAW,EAAE,EAAE;QACpE,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC;QAChC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,kBAAkB,GAAG,eAAe,CAAC,CAAC;QACxD,CAAC;QACD,8DAA8D;QAC9D,MAAM,cAAc,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC;QACxD,OAAO,gBAAgB;YACrB,CAAC,CAAC,kBAAkB,CAAC,cAAc,CAAC;YACpC,CAAC,CAAC,cAAc,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,cAAc;SAC7B,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;SACpB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAExB,MAAM,iBAAiB,GAAG,gBAAgB,CAAC,QAAQ,CAAC,GAAG,CAAC;QACtD,CAAC,CAAC,gBAAgB;QAClB,CAAC,CAAC,GAAG,gBAAgB,GAAG,CAAC;IAE3B,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;IAElD,MAAM,CAAC,OAAO,CAAC,WAAW,IAAI,EAAE,CAAC;SAC9B,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC;SAC3C,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC;SACtC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QACxB,IAAI,KAAK,EAAE,CAAC;YACV,+DAA+D;YAC/D,MAAM,cAAc,GAAG,yBAAyB,CAAC,KAAK,CAAC,CAAC;YACxD,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,EAAE,CAAC;IAChC,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAC5B,OAAO,QAAQ,CAAC;AAClB,CAAC","sourcesContent":["import { assert } from '@metamask/superstruct';\n\nimport { sanitizeControlCharacters, sanitizeUri } from '../sanitize/sanitize';\nimport { UrlStruct } from '../urlStruct/urlStruct';\n\nexport type BuildUrlParams = {\n  baseUrl: string;\n  path: string;\n  pathParams?: Record<string, string> | undefined;\n  queryParams?: Record<string, string> | undefined;\n  encodePathParams?: boolean;\n};\n\n/**\n * Builds a safe URL from a base URL, path, and optional parameters.\n *\n * @param params - The parameters to build the URL from.\n * @returns The validated, sanitized URL.\n */\nexport function buildUrl(params: BuildUrlParams): string {\n  const {\n    baseUrl,\n    path,\n    pathParams,\n    queryParams,\n    encodePathParams = true,\n  } = params;\n\n  // Validate and sanitize base URL\n  const sanitizedBaseUrl = sanitizeUri(baseUrl);\n  if (sanitizedBaseUrl === '') {\n    throw new Error('Invalid URL format');\n  }\n  assert(sanitizedBaseUrl, UrlStruct);\n\n  const pathWithParams = path.replace(/\\{(\\w+)\\}/gu, (_, key: string) => {\n    const value = pathParams?.[key];\n    if (value === undefined) {\n      throw new Error(`Path parameter ${key} is undefined`);\n    }\n    // Sanitize path parameter values to remove control characters\n    const sanitizedValue = sanitizeControlCharacters(value);\n    return encodePathParams\n      ? encodeURIComponent(sanitizedValue)\n      : sanitizedValue;\n  });\n\n  const cleanPath = pathWithParams\n    .replace(/^\\/+/u, '')\n    .replace(/\\/+/gu, '/')\n    .replace(/\\/+$/u, '');\n\n  const normalizedBaseUrl = sanitizedBaseUrl.endsWith('/')\n    ? sanitizedBaseUrl\n    : `${sanitizedBaseUrl}/`;\n\n  const url = new URL(cleanPath, normalizedBaseUrl);\n\n  Object.entries(queryParams ?? {})\n    .filter(([_, value]) => value !== undefined)\n    .filter(([_, value]) => value !== null)\n    .forEach(([key, value]) => {\n      if (value) {\n        // Sanitize query parameter values to remove control characters\n        const sanitizedValue = sanitizeControlCharacters(value);\n        url.searchParams.append(key, sanitizedValue);\n      }\n    });\n\n  const builtUrl = url.toString();\n  assert(builtUrl, UrlStruct);\n  return builtUrl;\n}\n"]}

package/dist/utils/dedupe/InFlightCoalescer.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"InFlightCoalescer.cjs","sourceRoot":"","sources":["../../../src/utils/dedupe/InFlightCoalescer.ts"],"names":[],"mappings":";;;;;;;;;AAAA;;;;;;GAMG;AACH,MAAa,iBAAiB;IAA9B;QACW,sCAAY,IAAI,GAAG,EAA4B,EAAC;IAiB3D,CAAC;IAfC,KAAK,CAAC,GAAG,CAAS,GAAW,EAAE,EAAyB;QACtD,MAAM,OAAO,GAAG,uBAAA,IAAI,mCAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,OAA0B,CAAC;QACpC,CAAC;QAED,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,EAAE;aAC3B,IAAI,CAAC,EAAE,CAAC;aACR,OAAO,CAAC,GAAG,EAAE;YACZ,uBAAA,IAAI,mCAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC;QACL,uBAAA,IAAI,mCAAU,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAE9B,OAAO,IAAI,CAAC;IACd,CAAC;CACF;AAlBD,8CAkBC","sourcesContent":["/**\n * Coalesces concurrent async operations by key: while a call for a key is in\n * flight, subsequent calls with the same key await the same promise instead of\n * starting duplicate work. Once a run settles, the next call starts a fresh one.\n *\n * Note that coalesced callers share the run's outcome, including rejections.\n */\nexport class InFlightCoalescer {\n  readonly #inFlight = new Map<string, Promise<unknown>>();\n\n  async run<Result>(key: string, fn: () => Promise<Result>): Promise<Result> {\n    const pending = this.#inFlight.get(key);\n    if (pending) {\n      return pending as Promise<Result>;\n    }\n\n    const task = Promise.resolve()\n      .then(fn)\n      .finally(() => {\n        this.#inFlight.delete(key);\n      });\n    this.#inFlight.set(key, task);\n\n    return task;\n  }\n}\n"]}

package/dist/utils/dedupe/InFlightCoalescer.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InFlightCoalescer.d.cts","sourceRoot":"","sources":["../../../src/utils/dedupe/InFlightCoalescer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,qBAAa,iBAAiB;;IAGtB,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;CAe3E"}

package/dist/utils/dedupe/InFlightCoalescer.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InFlightCoalescer.d.mts","sourceRoot":"","sources":["../../../src/utils/dedupe/InFlightCoalescer.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,qBAAa,iBAAiB;;IAGtB,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;CAe3E"}

package/dist/utils/dedupe/InFlightCoalescer.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"InFlightCoalescer.mjs","sourceRoot":"","sources":["../../../src/utils/dedupe/InFlightCoalescer.ts"],"names":[],"mappings":";;;;;;AAAA;;;;;;GAMG;AACH,MAAM,OAAO,iBAAiB;IAA9B;QACW,sCAAY,IAAI,GAAG,EAA4B,EAAC;IAiB3D,CAAC;IAfC,KAAK,CAAC,GAAG,CAAS,GAAW,EAAE,EAAyB;QACtD,MAAM,OAAO,GAAG,uBAAA,IAAI,mCAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,OAA0B,CAAC;QACpC,CAAC;QAED,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,EAAE;aAC3B,IAAI,CAAC,EAAE,CAAC;aACR,OAAO,CAAC,GAAG,EAAE;YACZ,uBAAA,IAAI,mCAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7B,CAAC,CAAC,CAAC;QACL,uBAAA,IAAI,mCAAU,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAE9B,OAAO,IAAI,CAAC;IACd,CAAC;CACF","sourcesContent":["/**\n * Coalesces concurrent async operations by key: while a call for a key is in\n * flight, subsequent calls with the same key await the same promise instead of\n * starting duplicate work. Once a run settles, the next call starts a fresh one.\n *\n * Note that coalesced callers share the run's outcome, including rejections.\n */\nexport class InFlightCoalescer {\n  readonly #inFlight = new Map<string, Promise<unknown>>();\n\n  async run<Result>(key: string, fn: () => Promise<Result>): Promise<Result> {\n    const pending = this.#inFlight.get(key);\n    if (pending) {\n      return pending as Promise<Result>;\n    }\n\n    const task = Promise.resolve()\n      .then(fn)\n      .finally(() => {\n        this.#inFlight.delete(key);\n      });\n    this.#inFlight.set(key, task);\n\n    return task;\n  }\n}\n"]}