@metamask/snap-networks-utils 1.0.0 → 2.0.0

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/utils/buildUrl/buildUrl.cjs

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildUrl = buildUrl;
+const superstruct_1 = require("@metamask/superstruct");
+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.
+ *
+ * @param params - The parameters to build the URL from.
+ * @returns The validated, sanitized URL.
+ */
+function buildUrl(params) {
+    const { baseUrl, path, pathParams, queryParams, encodePathParams = true, } = params;
+    // Validate and sanitize base URL
+    const sanitizedBaseUrl = (0, sanitize_1.sanitizeUri)(baseUrl);
+    if (sanitizedBaseUrl === '') {
+        throw new Error('Invalid URL format');
+    }
+    (0, superstruct_1.assert)(sanitizedBaseUrl, urlStruct_1.UrlStruct);
+    const pathWithParams = path.replace(/\{(\w+)\}/gu, (_, key) => {
+        const value = pathParams?.[key];
+        if (value === undefined) {
+            throw new Error(`Path parameter ${key} is undefined`);
+        }
+        // Sanitize path parameter values to remove control characters
+        const sanitizedValue = (0, sanitize_1.sanitizeControlCharacters)(value);
+        return encodePathParams
+            ? encodeURIComponent(sanitizedValue)
+            : sanitizedValue;
+    });
+    const cleanPath = pathWithParams
+        .replace(/^\/+/u, '')
+        .replace(/\/+/gu, '/')
+        .replace(/\/+$/u, '');
+    const normalizedBaseUrl = sanitizedBaseUrl.endsWith('/')
+        ? sanitizedBaseUrl
+        : `${sanitizedBaseUrl}/`;
+    const url = new URL(cleanPath, normalizedBaseUrl);
+    Object.entries(queryParams ?? {})
+        .filter(([_, value]) => value !== undefined)
+        .filter(([_, value]) => value !== null)
+        .forEach(([key, value]) => {
+        if (value) {
+            // Sanitize query parameter values to remove control characters
+            const sanitizedValue = (0, sanitize_1.sanitizeControlCharacters)(value);
+            url.searchParams.append(key, sanitizedValue);
+        }
+    });
+    const builtUrl = url.toString();
+    (0, superstruct_1.assert)(builtUrl, urlStruct_1.UrlStruct);
+    return builtUrl;
+}
+//# sourceMappingURL=buildUrl.cjs.map

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

@@ -0,0 +1,15 @@
+export type BuildUrlParams = {
+    baseUrl: string;
+    path: string;
+    pathParams?: Record<string, string> | undefined;
+    queryParams?: Record<string, string> | undefined;
+    encodePathParams?: boolean;
+};
+/**
+ * Builds a safe URL from a base URL, path, and optional parameters.
+ *
+ * @param params - The parameters to build the URL from.
+ * @returns The validated, sanitized URL.
+ */
+export declare function buildUrl(params: BuildUrlParams): string;
+//# sourceMappingURL=buildUrl.d.cts.map

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

@@ -0,0 +1,15 @@
+export type BuildUrlParams = {
+    baseUrl: string;
+    path: string;
+    pathParams?: Record<string, string> | undefined;
+    queryParams?: Record<string, string> | undefined;
+    encodePathParams?: boolean;
+};
+/**
+ * Builds a safe URL from a base URL, path, and optional parameters.
+ *
+ * @param params - The parameters to build the URL from.
+ * @returns The validated, sanitized URL.
+ */
+export declare function buildUrl(params: BuildUrlParams): string;
+//# sourceMappingURL=buildUrl.d.mts.map

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/utils/buildUrl/buildUrl.mjs

@@ -0,0 +1,51 @@
+import { assert } from "@metamask/superstruct";
+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.
+ *
+ * @param params - The parameters to build the URL from.
+ * @returns The validated, sanitized URL.
+ */
+export function buildUrl(params) {
+    const { baseUrl, path, pathParams, queryParams, encodePathParams = true, } = params;
+    // Validate and sanitize base URL
+    const sanitizedBaseUrl = sanitizeUri(baseUrl);
+    if (sanitizedBaseUrl === '') {
+        throw new Error('Invalid URL format');
+    }
+    assert(sanitizedBaseUrl, UrlStruct);
+    const pathWithParams = path.replace(/\{(\w+)\}/gu, (_, key) => {
+        const value = pathParams?.[key];
+        if (value === undefined) {
+            throw new Error(`Path parameter ${key} is undefined`);
+        }
+        // Sanitize path parameter values to remove control characters
+        const sanitizedValue = sanitizeControlCharacters(value);
+        return encodePathParams
+            ? encodeURIComponent(sanitizedValue)
+            : sanitizedValue;
+    });
+    const cleanPath = pathWithParams
+        .replace(/^\/+/u, '')
+        .replace(/\/+/gu, '/')
+        .replace(/\/+$/u, '');
+    const normalizedBaseUrl = sanitizedBaseUrl.endsWith('/')
+        ? sanitizedBaseUrl
+        : `${sanitizedBaseUrl}/`;
+    const url = new URL(cleanPath, normalizedBaseUrl);
+    Object.entries(queryParams ?? {})
+        .filter(([_, value]) => value !== undefined)
+        .filter(([_, value]) => value !== null)
+        .forEach(([key, value]) => {
+        if (value) {
+            // Sanitize query parameter values to remove control characters
+            const sanitizedValue = sanitizeControlCharacters(value);
+            url.searchParams.append(key, sanitizedValue);
+        }
+    });
+    const builtUrl = url.toString();
+    assert(builtUrl, UrlStruct);
+    return builtUrl;
+}
+//# sourceMappingURL=buildUrl.mjs.map

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/cache/InMemoryCache.cjs

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InMemoryCache = void 0;
+const utils_1 = require("@metamask/utils");
+/**
+ * A simple in-memory cache implementation supporting TTL (Time To Live) functionality.
+ *
+ * WARNINGS:
+ * - This cache is not persistent and will be lost when the process is restarted.
+ */
+class InMemoryCache {
+    #cache = new Map();
+    #logger;
+    constructor(logger) {
+        this.#logger = logger;
+    }
+    #validateTtlOrThrow(ttlMilliseconds) {
+        if (ttlMilliseconds === undefined) {
+            return;
+        }
+        if (typeof ttlMilliseconds !== 'number') {
+            throw new Error('TTL must be a number');
+        }
+        if (ttlMilliseconds < 0) {
+            throw new Error('TTL must be positive');
+        }
+        if (ttlMilliseconds > Number.MAX_SAFE_INTEGER) {
+            throw new Error('TTL must be less than 2^53 - 1');
+        }
+    }
+    #isExpired(cacheEntry) {
+        return cacheEntry.expiresAt < Date.now();
+    }
+    async #cleanupExpiredEntries() {
+        const expiredKeys = [];
+        for (const [key, entry] of this.#cache.entries()) {
+            if (this.#isExpired(entry)) {
+                expiredKeys.push(key);
+            }
+        }
+        await this.mdelete(expiredKeys);
+    }
+    async get(key) {
+        const result = await this.mget([key]);
+        return result[key];
+    }
+    async set(key, value, ttlMilliseconds = Number.MAX_SAFE_INTEGER) {
+        this.#validateTtlOrThrow(ttlMilliseconds);
+        this.#cache.set(key, {
+            value,
+            expiresAt: Math.min(Date.now() + ttlMilliseconds, Number.MAX_SAFE_INTEGER),
+        });
+    }
+    async delete(key) {
+        const result = await this.mdelete([key]);
+        return result[key] ?? false;
+    }
+    async clear() {
+        this.#cache.clear();
+    }
+    async has(key) {
+        const cacheEntry = this.#cache.get(key);
+        if (!cacheEntry) {
+            return false;
+        }
+        if (this.#isExpired(cacheEntry)) {
+            this.#cache.delete(key);
+            return false;
+        }
+        return true;
+    }
+    async keys() {
+        await this.#cleanupExpiredEntries();
+        return Array.from(this.#cache.keys());
+    }
+    async size() {
+        await this.#cleanupExpiredEntries();
+        return this.#cache.size;
+    }
+    async peek(key) {
+        const cacheEntry = this.#cache.get(key);
+        if (!cacheEntry) {
+            return undefined;
+        }
+        if (this.#isExpired(cacheEntry)) {
+            this.#cache.delete(key);
+            return undefined;
+        }
+        return cacheEntry.value;
+    }
+    async mget(keys) {
+        await this.#cleanupExpiredEntries();
+        const result = {};
+        for (const key of keys) {
+            const cacheEntry = this.#cache.get(key);
+            if (!cacheEntry) {
+                this.#logger.info(`[InMemoryCache] ❌ Cache miss for key "${key}"`);
+                result[key] = undefined;
+                continue;
+            }
+            this.#logger.info(`[InMemoryCache] 🎉 Cache hit for key "${key}"`);
+            result[key] = cacheEntry.value;
+        }
+        return result;
+    }
+    async mset(entries) {
+        if (entries.length === 0) {
+            return;
+        }
+        if (entries.length === 1) {
+            (0, utils_1.assert)(entries[0]); // Enforce type narrowing as TS cannot infer that entries[0] is defined
+            const { key, value, ttlMilliseconds } = entries[0];
+            await this.set(key, value, ttlMilliseconds);
+            return;
+        }
+        entries.forEach(({ ttlMilliseconds }) => {
+            this.#validateTtlOrThrow(ttlMilliseconds);
+        });
+        entries.forEach(({ key, value, ttlMilliseconds }) => {
+            if (value === undefined) {
+                return;
+            }
+            this.#cache.set(key, {
+                value,
+                expiresAt: Math.min(Date.now() + (ttlMilliseconds ?? Number.MAX_SAFE_INTEGER), Number.MAX_SAFE_INTEGER),
+            });
+        });
+    }
+    async mdelete(keys) {
+        return Object.fromEntries(keys.map((key) => [key, this.#cache.delete(key)]));
+    }
+}
+exports.InMemoryCache = InMemoryCache;
+//# sourceMappingURL=InMemoryCache.cjs.map

package/dist/utils/cache/InMemoryCache.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryCache.cjs","sourceRoot":"","sources":["../../../src/utils/cache/InMemoryCache.ts"],"names":[],"mappings":"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","sourcesContent":["import { assert } from '@metamask/utils';\n\nimport type { Logger } from '../logger/Logger';\nimport type { Serializable } from '../serialization/types';\nimport type { CacheEntry, ICache } from './types';\n\n/**\n * A simple in-memory cache implementation supporting TTL (Time To Live) functionality.\n *\n * WARNINGS:\n * - This cache is not persistent and will be lost when the process is restarted.\n */\nexport class InMemoryCache implements ICache<Serializable> {\n  readonly #cache: Map<string, CacheEntry> = new Map();\n\n  readonly #logger: Logger;\n\n  constructor(logger: Logger) {\n    this.#logger = logger;\n  }\n\n  #validateTtlOrThrow(ttlMilliseconds?: number): void {\n    if (ttlMilliseconds === undefined) {\n      return;\n    }\n\n    if (typeof ttlMilliseconds !== 'number') {\n      throw new Error('TTL must be a number');\n    }\n\n    if (ttlMilliseconds < 0) {\n      throw new Error('TTL must be positive');\n    }\n\n    if (ttlMilliseconds > Number.MAX_SAFE_INTEGER) {\n      throw new Error('TTL must be less than 2^53 - 1');\n    }\n  }\n\n  #isExpired(cacheEntry: CacheEntry): boolean {\n    return cacheEntry.expiresAt < Date.now();\n  }\n\n  async #cleanupExpiredEntries(): Promise<void> {\n    const expiredKeys: string[] = [];\n    for (const [key, entry] of this.#cache.entries()) {\n      if (this.#isExpired(entry)) {\n        expiredKeys.push(key);\n      }\n    }\n    await this.mdelete(expiredKeys);\n  }\n\n  async get(key: string): Promise<Serializable | undefined> {\n    const result = await this.mget([key]);\n    return result[key];\n  }\n\n  async set(\n    key: string,\n    value: Serializable,\n    ttlMilliseconds = Number.MAX_SAFE_INTEGER,\n  ): Promise<void> {\n    this.#validateTtlOrThrow(ttlMilliseconds);\n\n    this.#cache.set(key, {\n      value,\n      expiresAt: Math.min(\n        Date.now() + ttlMilliseconds,\n        Number.MAX_SAFE_INTEGER,\n      ),\n    });\n  }\n\n  async delete(key: string): Promise<boolean> {\n    const result = await this.mdelete([key]);\n    return result[key] ?? false;\n  }\n\n  async clear(): Promise<void> {\n    this.#cache.clear();\n  }\n\n  async has(key: string): Promise<boolean> {\n    const cacheEntry = this.#cache.get(key);\n    if (!cacheEntry) {\n      return false;\n    }\n\n    if (this.#isExpired(cacheEntry)) {\n      this.#cache.delete(key);\n      return false;\n    }\n\n    return true;\n  }\n\n  async keys(): Promise<string[]> {\n    await this.#cleanupExpiredEntries();\n    return Array.from(this.#cache.keys());\n  }\n\n  async size(): Promise<number> {\n    await this.#cleanupExpiredEntries();\n    return this.#cache.size;\n  }\n\n  async peek(key: string): Promise<Serializable | undefined> {\n    const cacheEntry = this.#cache.get(key);\n    if (!cacheEntry) {\n      return undefined;\n    }\n\n    if (this.#isExpired(cacheEntry)) {\n      this.#cache.delete(key);\n      return undefined;\n    }\n\n    return cacheEntry.value;\n  }\n\n  async mget(\n    keys: string[],\n  ): Promise<Record<string, Serializable | undefined>> {\n    await this.#cleanupExpiredEntries();\n\n    const result: Record<string, Serializable | undefined> = {};\n\n    for (const key of keys) {\n      const cacheEntry = this.#cache.get(key);\n      if (!cacheEntry) {\n        this.#logger.info(`[InMemoryCache] ❌ Cache miss for key \"${key}\"`);\n        result[key] = undefined;\n        continue;\n      }\n\n      this.#logger.info(`[InMemoryCache] 🎉 Cache hit for key \"${key}\"`);\n      result[key] = cacheEntry.value;\n    }\n\n    return result;\n  }\n\n  async mset(\n    entries: { key: string; value: Serializable; ttlMilliseconds?: number }[],\n  ): Promise<void> {\n    if (entries.length === 0) {\n      return;\n    }\n\n    if (entries.length === 1) {\n      assert(entries[0]); // Enforce type narrowing as TS cannot infer that entries[0] is defined\n      const { key, value, ttlMilliseconds } = entries[0];\n      await this.set(key, value, ttlMilliseconds);\n      return;\n    }\n\n    entries.forEach(({ ttlMilliseconds }) => {\n      this.#validateTtlOrThrow(ttlMilliseconds);\n    });\n\n    entries.forEach(({ key, value, ttlMilliseconds }) => {\n      if (value === undefined) {\n        return;\n      }\n      this.#cache.set(key, {\n        value,\n        expiresAt: Math.min(\n          Date.now() + (ttlMilliseconds ?? Number.MAX_SAFE_INTEGER),\n          Number.MAX_SAFE_INTEGER,\n        ),\n      });\n    });\n  }\n\n  async mdelete(keys: string[]): Promise<Record<string, boolean>> {\n    return Object.fromEntries(\n      keys.map((key) => [key, this.#cache.delete(key)]),\n    );\n  }\n}\n"]}

package/dist/utils/cache/InMemoryCache.d.cts

@@ -0,0 +1,29 @@
+import type { Logger } from "../logger/Logger.cjs";
+import type { Serializable } from "../serialization/types.cjs";
+import type { ICache } from "./types.cjs";
+/**
+ * A simple in-memory cache implementation supporting TTL (Time To Live) functionality.
+ *
+ * WARNINGS:
+ * - This cache is not persistent and will be lost when the process is restarted.
+ */
+export declare class InMemoryCache implements ICache<Serializable> {
+    #private;
+    constructor(logger: Logger);
+    get(key: string): Promise<Serializable | undefined>;
+    set(key: string, value: Serializable, ttlMilliseconds?: number): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    clear(): Promise<void>;
+    has(key: string): Promise<boolean>;
+    keys(): Promise<string[]>;
+    size(): Promise<number>;
+    peek(key: string): Promise<Serializable | undefined>;
+    mget(keys: string[]): Promise<Record<string, Serializable | undefined>>;
+    mset(entries: {
+        key: string;
+        value: Serializable;
+        ttlMilliseconds?: number;
+    }[]): Promise<void>;
+    mdelete(keys: string[]): Promise<Record<string, boolean>>;
+}
+//# sourceMappingURL=InMemoryCache.d.cts.map

package/dist/utils/cache/InMemoryCache.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryCache.d.cts","sourceRoot":"","sources":["../../../src/utils/cache/InMemoryCache.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,6BAAyB;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,mCAA+B;AAC3D,OAAO,KAAK,EAAc,MAAM,EAAE,oBAAgB;AAElD;;;;;GAKG;AACH,qBAAa,aAAc,YAAW,MAAM,CAAC,YAAY,CAAC;;gBAK5C,MAAM,EAAE,MAAM;IAoCpB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAKnD,GAAG,CACP,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,YAAY,EACnB,eAAe,SAA0B,GACxC,OAAO,CAAC,IAAI,CAAC;IAYV,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKrC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAclC,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKzB,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAKvB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAcpD,IAAI,CACR,IAAI,EAAE,MAAM,EAAE,GACb,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,CAAC,CAAC;IAoB9C,IAAI,CACR,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,YAAY,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,GACxE,OAAO,CAAC,IAAI,CAAC;IA8BV,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAKhE"}

package/dist/utils/cache/InMemoryCache.d.mts

@@ -0,0 +1,29 @@
+import type { Logger } from "../logger/Logger.mjs";
+import type { Serializable } from "../serialization/types.mjs";
+import type { ICache } from "./types.mjs";
+/**
+ * A simple in-memory cache implementation supporting TTL (Time To Live) functionality.
+ *
+ * WARNINGS:
+ * - This cache is not persistent and will be lost when the process is restarted.
+ */
+export declare class InMemoryCache implements ICache<Serializable> {
+    #private;
+    constructor(logger: Logger);
+    get(key: string): Promise<Serializable | undefined>;
+    set(key: string, value: Serializable, ttlMilliseconds?: number): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    clear(): Promise<void>;
+    has(key: string): Promise<boolean>;
+    keys(): Promise<string[]>;
+    size(): Promise<number>;
+    peek(key: string): Promise<Serializable | undefined>;
+    mget(keys: string[]): Promise<Record<string, Serializable | undefined>>;
+    mset(entries: {
+        key: string;
+        value: Serializable;
+        ttlMilliseconds?: number;
+    }[]): Promise<void>;
+    mdelete(keys: string[]): Promise<Record<string, boolean>>;
+}
+//# sourceMappingURL=InMemoryCache.d.mts.map

package/dist/utils/cache/InMemoryCache.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryCache.d.mts","sourceRoot":"","sources":["../../../src/utils/cache/InMemoryCache.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,6BAAyB;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,mCAA+B;AAC3D,OAAO,KAAK,EAAc,MAAM,EAAE,oBAAgB;AAElD;;;;;GAKG;AACH,qBAAa,aAAc,YAAW,MAAM,CAAC,YAAY,CAAC;;gBAK5C,MAAM,EAAE,MAAM;IAoCpB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAKnD,GAAG,CACP,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,YAAY,EACnB,eAAe,SAA0B,GACxC,OAAO,CAAC,IAAI,CAAC;IAYV,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKrC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAclC,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAKzB,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC;IAKvB,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAcpD,IAAI,CACR,IAAI,EAAE,MAAM,EAAE,GACb,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,CAAC,CAAC;IAoB9C,IAAI,CACR,OAAO,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,YAAY,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,GACxE,OAAO,CAAC,IAAI,CAAC;IA8BV,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAKhE"}

package/dist/utils/cache/InMemoryCache.mjs

@@ -0,0 +1,130 @@
+import { assert } from "@metamask/utils";
+/**
+ * A simple in-memory cache implementation supporting TTL (Time To Live) functionality.
+ *
+ * WARNINGS:
+ * - This cache is not persistent and will be lost when the process is restarted.
+ */
+export class InMemoryCache {
+    #cache = new Map();
+    #logger;
+    constructor(logger) {
+        this.#logger = logger;
+    }
+    #validateTtlOrThrow(ttlMilliseconds) {
+        if (ttlMilliseconds === undefined) {
+            return;
+        }
+        if (typeof ttlMilliseconds !== 'number') {
+            throw new Error('TTL must be a number');
+        }
+        if (ttlMilliseconds < 0) {
+            throw new Error('TTL must be positive');
+        }
+        if (ttlMilliseconds > Number.MAX_SAFE_INTEGER) {
+            throw new Error('TTL must be less than 2^53 - 1');
+        }
+    }
+    #isExpired(cacheEntry) {
+        return cacheEntry.expiresAt < Date.now();
+    }
+    async #cleanupExpiredEntries() {
+        const expiredKeys = [];
+        for (const [key, entry] of this.#cache.entries()) {
+            if (this.#isExpired(entry)) {
+                expiredKeys.push(key);
+            }
+        }
+        await this.mdelete(expiredKeys);
+    }
+    async get(key) {
+        const result = await this.mget([key]);
+        return result[key];
+    }
+    async set(key, value, ttlMilliseconds = Number.MAX_SAFE_INTEGER) {
+        this.#validateTtlOrThrow(ttlMilliseconds);
+        this.#cache.set(key, {
+            value,
+            expiresAt: Math.min(Date.now() + ttlMilliseconds, Number.MAX_SAFE_INTEGER),
+        });
+    }
+    async delete(key) {
+        const result = await this.mdelete([key]);
+        return result[key] ?? false;
+    }
+    async clear() {
+        this.#cache.clear();
+    }
+    async has(key) {
+        const cacheEntry = this.#cache.get(key);
+        if (!cacheEntry) {
+            return false;
+        }
+        if (this.#isExpired(cacheEntry)) {
+            this.#cache.delete(key);
+            return false;
+        }
+        return true;
+    }
+    async keys() {
+        await this.#cleanupExpiredEntries();
+        return Array.from(this.#cache.keys());
+    }
+    async size() {
+        await this.#cleanupExpiredEntries();
+        return this.#cache.size;
+    }
+    async peek(key) {
+        const cacheEntry = this.#cache.get(key);
+        if (!cacheEntry) {
+            return undefined;
+        }
+        if (this.#isExpired(cacheEntry)) {
+            this.#cache.delete(key);
+            return undefined;
+        }
+        return cacheEntry.value;
+    }
+    async mget(keys) {
+        await this.#cleanupExpiredEntries();
+        const result = {};
+        for (const key of keys) {
+            const cacheEntry = this.#cache.get(key);
+            if (!cacheEntry) {
+                this.#logger.info(`[InMemoryCache] ❌ Cache miss for key "${key}"`);
+                result[key] = undefined;
+                continue;
+            }
+            this.#logger.info(`[InMemoryCache] 🎉 Cache hit for key "${key}"`);
+            result[key] = cacheEntry.value;
+        }
+        return result;
+    }
+    async mset(entries) {
+        if (entries.length === 0) {
+            return;
+        }
+        if (entries.length === 1) {
+            assert(entries[0]); // Enforce type narrowing as TS cannot infer that entries[0] is defined
+            const { key, value, ttlMilliseconds } = entries[0];
+            await this.set(key, value, ttlMilliseconds);
+            return;
+        }
+        entries.forEach(({ ttlMilliseconds }) => {
+            this.#validateTtlOrThrow(ttlMilliseconds);
+        });
+        entries.forEach(({ key, value, ttlMilliseconds }) => {
+            if (value === undefined) {
+                return;
+            }
+            this.#cache.set(key, {
+                value,
+                expiresAt: Math.min(Date.now() + (ttlMilliseconds ?? Number.MAX_SAFE_INTEGER), Number.MAX_SAFE_INTEGER),
+            });
+        });
+    }
+    async mdelete(keys) {
+        return Object.fromEntries(keys.map((key) => [key, this.#cache.delete(key)]));
+    }
+}
+//# sourceMappingURL=InMemoryCache.mjs.map

package/dist/utils/cache/InMemoryCache.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"InMemoryCache.mjs","sourceRoot":"","sources":["../../../src/utils/cache/InMemoryCache.ts"],"names":[],"mappings":"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","sourcesContent":["import { assert } from '@metamask/utils';\n\nimport type { Logger } from '../logger/Logger';\nimport type { Serializable } from '../serialization/types';\nimport type { CacheEntry, ICache } from './types';\n\n/**\n * A simple in-memory cache implementation supporting TTL (Time To Live) functionality.\n *\n * WARNINGS:\n * - This cache is not persistent and will be lost when the process is restarted.\n */\nexport class InMemoryCache implements ICache<Serializable> {\n  readonly #cache: Map<string, CacheEntry> = new Map();\n\n  readonly #logger: Logger;\n\n  constructor(logger: Logger) {\n    this.#logger = logger;\n  }\n\n  #validateTtlOrThrow(ttlMilliseconds?: number): void {\n    if (ttlMilliseconds === undefined) {\n      return;\n    }\n\n    if (typeof ttlMilliseconds !== 'number') {\n      throw new Error('TTL must be a number');\n    }\n\n    if (ttlMilliseconds < 0) {\n      throw new Error('TTL must be positive');\n    }\n\n    if (ttlMilliseconds > Number.MAX_SAFE_INTEGER) {\n      throw new Error('TTL must be less than 2^53 - 1');\n    }\n  }\n\n  #isExpired(cacheEntry: CacheEntry): boolean {\n    return cacheEntry.expiresAt < Date.now();\n  }\n\n  async #cleanupExpiredEntries(): Promise<void> {\n    const expiredKeys: string[] = [];\n    for (const [key, entry] of this.#cache.entries()) {\n      if (this.#isExpired(entry)) {\n        expiredKeys.push(key);\n      }\n    }\n    await this.mdelete(expiredKeys);\n  }\n\n  async get(key: string): Promise<Serializable | undefined> {\n    const result = await this.mget([key]);\n    return result[key];\n  }\n\n  async set(\n    key: string,\n    value: Serializable,\n    ttlMilliseconds = Number.MAX_SAFE_INTEGER,\n  ): Promise<void> {\n    this.#validateTtlOrThrow(ttlMilliseconds);\n\n    this.#cache.set(key, {\n      value,\n      expiresAt: Math.min(\n        Date.now() + ttlMilliseconds,\n        Number.MAX_SAFE_INTEGER,\n      ),\n    });\n  }\n\n  async delete(key: string): Promise<boolean> {\n    const result = await this.mdelete([key]);\n    return result[key] ?? false;\n  }\n\n  async clear(): Promise<void> {\n    this.#cache.clear();\n  }\n\n  async has(key: string): Promise<boolean> {\n    const cacheEntry = this.#cache.get(key);\n    if (!cacheEntry) {\n      return false;\n    }\n\n    if (this.#isExpired(cacheEntry)) {\n      this.#cache.delete(key);\n      return false;\n    }\n\n    return true;\n  }\n\n  async keys(): Promise<string[]> {\n    await this.#cleanupExpiredEntries();\n    return Array.from(this.#cache.keys());\n  }\n\n  async size(): Promise<number> {\n    await this.#cleanupExpiredEntries();\n    return this.#cache.size;\n  }\n\n  async peek(key: string): Promise<Serializable | undefined> {\n    const cacheEntry = this.#cache.get(key);\n    if (!cacheEntry) {\n      return undefined;\n    }\n\n    if (this.#isExpired(cacheEntry)) {\n      this.#cache.delete(key);\n      return undefined;\n    }\n\n    return cacheEntry.value;\n  }\n\n  async mget(\n    keys: string[],\n  ): Promise<Record<string, Serializable | undefined>> {\n    await this.#cleanupExpiredEntries();\n\n    const result: Record<string, Serializable | undefined> = {};\n\n    for (const key of keys) {\n      const cacheEntry = this.#cache.get(key);\n      if (!cacheEntry) {\n        this.#logger.info(`[InMemoryCache] ❌ Cache miss for key \"${key}\"`);\n        result[key] = undefined;\n        continue;\n      }\n\n      this.#logger.info(`[InMemoryCache] 🎉 Cache hit for key \"${key}\"`);\n      result[key] = cacheEntry.value;\n    }\n\n    return result;\n  }\n\n  async mset(\n    entries: { key: string; value: Serializable; ttlMilliseconds?: number }[],\n  ): Promise<void> {\n    if (entries.length === 0) {\n      return;\n    }\n\n    if (entries.length === 1) {\n      assert(entries[0]); // Enforce type narrowing as TS cannot infer that entries[0] is defined\n      const { key, value, ttlMilliseconds } = entries[0];\n      await this.set(key, value, ttlMilliseconds);\n      return;\n    }\n\n    entries.forEach(({ ttlMilliseconds }) => {\n      this.#validateTtlOrThrow(ttlMilliseconds);\n    });\n\n    entries.forEach(({ key, value, ttlMilliseconds }) => {\n      if (value === undefined) {\n        return;\n      }\n      this.#cache.set(key, {\n        value,\n        expiresAt: Math.min(\n          Date.now() + (ttlMilliseconds ?? Number.MAX_SAFE_INTEGER),\n          Number.MAX_SAFE_INTEGER,\n        ),\n      });\n    });\n  }\n\n  async mdelete(keys: string[]): Promise<Record<string, boolean>> {\n    return Object.fromEntries(\n      keys.map((key) => [key, this.#cache.delete(key)]),\n    );\n  }\n}\n"]}