@metamask/snap-networks-utils 1.0.0 → 2.0.0

package/dist/ui/EstimatedChanges/EstimatedChanges.mjs

@@ -0,0 +1,53 @@
+import { jsx as _jsx, jsxs as _jsxs } from "@metamask/snaps-sdk/jsx-runtime";
+import { Box, Icon, Image, Section, Skeleton, Text as SnapText, Tooltip } from "@metamask/snaps-sdk/jsx";
+const Header = ({ labels, }) => (_jsxs(Box, { direction: "horizontal", alignment: "start", children: [_jsx(SnapText, { fontWeight: "medium", children: labels.title }), _jsx(Tooltip, { content: labels.tooltip, children: _jsx(Icon, { name: "info" }) })] }));
+const MessageSection = ({ labels, message, }) => (_jsxs(Section, { direction: "vertical", children: [_jsx(Header, { labels: labels }), _jsx(SnapText, { color: "alternative", children: message })] }));
+const AssetRow = ({ asset, }) => {
+    const isOut = asset.type === 'out';
+    const isUnknownValue = asset.value === null;
+    let label;
+    if (isUnknownValue) {
+        label = `– ${asset.symbol}`;
+    }
+    else {
+        const sign = isOut ? '-' : '+';
+        label = `${sign}${asset.value} ${asset.symbol}`;
+    }
+    const successOrError = isOut ? 'error' : 'success';
+    return (_jsxs(Box, { direction: "vertical", crossAlignment: "end", children: [_jsxs(Box, { direction: "horizontal", alignment: "end", center: true, children: [asset.logo ? (_jsx(Image, { src: asset.logo, borderRadius: "full", height: 16, width: 16 })) : null, _jsx(SnapText, { color: isUnknownValue ? 'alternative' : successOrError, children: label })] }), asset.fiat ? _jsx(SnapText, { color: "muted", children: asset.fiat }) : null] }));
+};
+const AssetGroup = ({ title, assets, }) => assets.length > 0 ? (_jsxs(Box, { alignment: "space-between", direction: "horizontal", children: [_jsx(SnapText, { fontWeight: "medium", color: "alternative", children: title }), _jsx(Box, { direction: "vertical", alignment: "end", children: assets.map((asset, index) => (_jsx(Box, { children: _jsx(AssetRow, { asset: asset }) }, `${asset.type}-${asset.symbol}-${index}`))) })] })) : null;
+/**
+ * Renders the estimated balance changes of a transaction, grouped into
+ * "send" and "receive" rows, with loading, error and empty states.
+ *
+ * The header is always rendered. The body depends on the props:
+ *
+ * 1. No assets and `isFetching` → loading skeleton (takes precedence over
+ * `isUnavailable`).
+ * 2. No assets and `isUnavailable` → "not available" message.
+ * 3. No assets otherwise → "no changes" message (an empty result means the
+ * transaction does not change any balance).
+ * 4. Assets present → "send" and/or "receive" groups; a group with no assets
+ * is omitted. `isFetching` and `isUnavailable` are ignored in this case, as
+ * rows seeded locally by the caller are final.
+ *
+ * @param props - The component props.
+ * @param props.assets - The display-ready asset changes.
+ * @param props.labels - The translated labels.
+ * @param props.isFetching - Whether the estimate is still being fetched.
+ * @param props.isUnavailable - Whether the estimate could not be produced.
+ * @returns The estimated changes section.
+ */
+export const EstimatedChanges = ({ assets, labels, isFetching, isUnavailable, }) => {
+    // Rows seeded locally by the caller are final, so they are never replaced by
+    // the loading/unavailable states.
+    if (assets.length === 0) {
+        if (isFetching) {
+            return (_jsxs(Section, { direction: "vertical", children: [_jsx(Header, { labels: labels }), _jsxs(Box, { alignment: "space-between", direction: "horizontal", children: [_jsx(Skeleton, { width: 60 }), _jsx(Skeleton, { width: 100 })] })] }));
+        }
+        return (_jsx(MessageSection, { labels: labels, message: isUnavailable ? labels.notAvailable : labels.noChanges }));
+    }
+    return (_jsxs(Section, { children: [_jsx(Header, { labels: labels }), _jsx(AssetGroup, { title: labels.send, assets: assets.filter((asset) => asset.type === 'out') }), _jsx(AssetGroup, { title: labels.receive, assets: assets.filter((asset) => asset.type === 'in') })] }));
+};
+//# sourceMappingURL=EstimatedChanges.mjs.map

package/dist/ui/EstimatedChanges/EstimatedChanges.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"EstimatedChanges.mjs","sourceRoot":"","sources":["../../../src/ui/EstimatedChanges/EstimatedChanges.tsx"],"names":[],"mappings":"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","sourcesContent":["import type { ComponentOrElement } from '@metamask/snaps-sdk';\nimport {\n  Box,\n  Icon,\n  Image,\n  Section,\n  Skeleton,\n  Text as SnapText,\n  Tooltip,\n} from '@metamask/snaps-sdk/jsx';\n\nexport type EstimatedChangesAsset = {\n  type: 'in' | 'out';\n  /** Display-ready amount, or `null` when the amount is unknown. */\n  value: string | null;\n  symbol: string;\n  logo: string | null;\n  /** Display-ready fiat value shown under the amount. */\n  fiat?: string | null;\n};\n\nexport type EstimatedChangesLabels = {\n  title: string;\n  tooltip: string;\n  send: string;\n  receive: string;\n  notAvailable: string;\n  noChanges: string;\n};\n\nexport type EstimatedChangesProps = {\n  assets: EstimatedChangesAsset[];\n  labels: EstimatedChangesLabels;\n  /** Whether the estimate is still being fetched. */\n  isFetching: boolean;\n  /** Whether the estimate could not be produced (e.g. fetch or simulation failure). */\n  isUnavailable: boolean;\n};\n\nconst Header = ({\n  labels,\n}: {\n  labels: EstimatedChangesLabels;\n}): ComponentOrElement => (\n  <Box direction=\"horizontal\" alignment=\"start\">\n    <SnapText fontWeight=\"medium\">{labels.title}</SnapText>\n    <Tooltip content={labels.tooltip}>\n      <Icon name=\"info\" />\n    </Tooltip>\n  </Box>\n);\n\nconst MessageSection = ({\n  labels,\n  message,\n}: {\n  labels: EstimatedChangesLabels;\n  message: string;\n}): ComponentOrElement => (\n  <Section direction=\"vertical\">\n    <Header labels={labels} />\n    <SnapText color=\"alternative\">{message}</SnapText>\n  </Section>\n);\n\nconst AssetRow = ({\n  asset,\n}: {\n  asset: EstimatedChangesAsset;\n}): ComponentOrElement => {\n  const isOut = asset.type === 'out';\n  const isUnknownValue = asset.value === null;\n  let label: string;\n  if (isUnknownValue) {\n    label = `– ${asset.symbol}`;\n  } else {\n    const sign = isOut ? '-' : '+';\n    label = `${sign}${asset.value} ${asset.symbol}`;\n  }\n  const successOrError = isOut ? 'error' : 'success';\n\n  return (\n    <Box direction=\"vertical\" crossAlignment=\"end\">\n      <Box direction=\"horizontal\" alignment=\"end\" center>\n        {asset.logo ? (\n          <Image src={asset.logo} borderRadius=\"full\" height={16} width={16} />\n        ) : null}\n        <SnapText color={isUnknownValue ? 'alternative' : successOrError}>\n          {label}\n        </SnapText>\n      </Box>\n      {asset.fiat ? <SnapText color=\"muted\">{asset.fiat}</SnapText> : null}\n    </Box>\n  );\n};\n\nconst AssetGroup = ({\n  title,\n  assets,\n}: {\n  title: string;\n  assets: EstimatedChangesAsset[];\n}): ComponentOrElement | null =>\n  assets.length > 0 ? (\n    <Box alignment=\"space-between\" direction=\"horizontal\">\n      <SnapText fontWeight=\"medium\" color=\"alternative\">\n        {title}\n      </SnapText>\n      <Box direction=\"vertical\" alignment=\"end\">\n        {assets.map((asset, index) => (\n          <Box key={`${asset.type}-${asset.symbol}-${index}`}>\n            <AssetRow asset={asset} />\n          </Box>\n        ))}\n      </Box>\n    </Box>\n  ) : null;\n\n/**\n * Renders the estimated balance changes of a transaction, grouped into\n * \"send\" and \"receive\" rows, with loading, error and empty states.\n *\n * The header is always rendered. The body depends on the props:\n *\n * 1. No assets and `isFetching` → loading skeleton (takes precedence over\n * `isUnavailable`).\n * 2. No assets and `isUnavailable` → \"not available\" message.\n * 3. No assets otherwise → \"no changes\" message (an empty result means the\n * transaction does not change any balance).\n * 4. Assets present → \"send\" and/or \"receive\" groups; a group with no assets\n * is omitted. `isFetching` and `isUnavailable` are ignored in this case, as\n * rows seeded locally by the caller are final.\n *\n * @param props - The component props.\n * @param props.assets - The display-ready asset changes.\n * @param props.labels - The translated labels.\n * @param props.isFetching - Whether the estimate is still being fetched.\n * @param props.isUnavailable - Whether the estimate could not be produced.\n * @returns The estimated changes section.\n */\nexport const EstimatedChanges = ({\n  assets,\n  labels,\n  isFetching,\n  isUnavailable,\n}: EstimatedChangesProps): ComponentOrElement => {\n  // Rows seeded locally by the caller are final, so they are never replaced by\n  // the loading/unavailable states.\n  if (assets.length === 0) {\n    if (isFetching) {\n      return (\n        <Section direction=\"vertical\">\n          <Header labels={labels} />\n          <Box alignment=\"space-between\" direction=\"horizontal\">\n            <Skeleton width={60} />\n            <Skeleton width={100} />\n          </Box>\n        </Section>\n      );\n    }\n\n    return (\n      <MessageSection\n        labels={labels}\n        message={isUnavailable ? labels.notAvailable : labels.noChanges}\n      />\n    );\n  }\n\n  return (\n    <Section>\n      <Header labels={labels} />\n      <AssetGroup\n        title={labels.send}\n        assets={assets.filter((asset) => asset.type === 'out')}\n      />\n      <AssetGroup\n        title={labels.receive}\n        assets={assets.filter((asset) => asset.type === 'in')}\n      />\n    </Section>\n  );\n};\n"]}

package/dist/ui/TransactionAlert/TransactionAlert.cjs

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TransactionAlert = void 0;
+const jsx_runtime_1 = require("@metamask/snaps-sdk/jsx-runtime");
+const jsx_1 = require("@metamask/snaps-sdk/jsx");
+const SECURITY_ALERTS_URL = 'https://support.metamask.io/configure/wallet/how-to-turn-on-security-alerts/';
+const BLOCKAID_URL = 'https://www.blockaid.io';
+/**
+ * Resolves the security banner for a validation result.
+ *
+ * @param validation - The security validation result.
+ * @param labels - The translated labels.
+ * @returns The banner severity, title and message, or `null` when the
+ * validation does not warrant a banner.
+ */
+function getValidationAlert(validation, labels) {
+    const trimmedDescription = validation.description?.trim();
+    const description = trimmedDescription === '' ? undefined : trimmedDescription;
+    if (validation.type === 'Malicious') {
+        return {
+            severity: 'danger',
+            title: labels.maliciousTitle,
+            message: description ?? labels.maliciousMessage,
+        };
+    }
+    if (validation.type === 'Warning') {
+        return {
+            severity: 'warning',
+            title: labels.warningTitle,
+            message: description ?? labels.warningMessage,
+        };
+    }
+    return null;
+}
+/**
+ * Renders the single top-of-screen transaction scan banner.
+ *
+ * Exactly one banner is rendered, picked in this order:
+ *
+ * 1. `isFetching` → "scan in progress" info banner.
+ * 2. `isFetchError` → "scan failed" danger banner.
+ * 3. `error` → warning banner with the error title and message.
+ * 4. `Malicious` or `Warning` validation → security banner with a link to the
+ * security alerts documentation and the Blockaid attribution.
+ * 5. Otherwise nothing.
+ *
+ * @param props - The component props.
+ * @param props.labels - The translated labels.
+ * @param props.isFetching - Whether the transaction scan is in flight.
+ * @param props.isFetchError - Whether the transaction scan request failed.
+ * @param props.error - The scan error to show.
+ * @param props.validation - The security validation to show.
+ * @returns The banner, or `null` when no alert applies.
+ */
+const TransactionAlert = ({ labels, isFetching, isFetchError, error, validation, }) => {
+    if (isFetching) {
+        return ((0, jsx_runtime_1.jsx)(jsx_1.Banner, { title: labels.scanInProgressTitle, severity: "info", children: (0, jsx_runtime_1.jsx)(jsx_1.Text, { children: labels.scanInProgressMessage }) }));
+    }
+    if (isFetchError) {
+        return ((0, jsx_runtime_1.jsx)(jsx_1.Banner, { title: labels.scanFailedTitle, severity: "danger", children: (0, jsx_runtime_1.jsx)(jsx_1.Text, { children: labels.scanFailedMessage }) }));
+    }
+    if (error) {
+        return ((0, jsx_runtime_1.jsx)(jsx_1.Banner, { title: error.title, severity: "warning", children: (0, jsx_runtime_1.jsx)(jsx_1.Text, { children: error.message }) }));
+    }
+    const alert = validation ? getValidationAlert(validation, labels) : null;
+    if (!alert) {
+        return null;
+    }
+    return ((0, jsx_runtime_1.jsxs)(jsx_1.Banner, { title: alert.title, severity: alert.severity, children: [(0, jsx_runtime_1.jsx)(jsx_1.Text, { children: alert.message }), (0, jsx_runtime_1.jsx)(jsx_1.Text, { size: "sm", children: (0, jsx_runtime_1.jsx)(jsx_1.Link, { href: SECURITY_ALERTS_URL, children: labels.learnMore }) }), (0, jsx_runtime_1.jsxs)(jsx_1.Text, { size: "sm", children: [(0, jsx_runtime_1.jsx)(jsx_1.Icon, { color: "primary", name: "security-tick" }), " ", labels.securityAdvisedBy, ' ', (0, jsx_runtime_1.jsx)(jsx_1.Link, { href: BLOCKAID_URL, children: "Blockaid" })] })] }));
+};
+exports.TransactionAlert = TransactionAlert;
+//# sourceMappingURL=TransactionAlert.cjs.map

package/dist/ui/TransactionAlert/TransactionAlert.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransactionAlert.cjs","sourceRoot":"","sources":["../../../src/ui/TransactionAlert/TransactionAlert.tsx"],"names":[],"mappings":";;;;AACA,iDAA+E;AA0C/E,MAAM,mBAAmB,GACvB,8EAA8E,CAAC;AAEjF,MAAM,YAAY,GAAG,yBAAyB,CAAC;AAE/C;;;;;;;GAOG;AACH,SAAS,kBAAkB,CACzB,UAAsC,EACtC,MAA8B;IAM9B,MAAM,kBAAkB,GAAG,UAAU,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC;IAC1D,MAAM,WAAW,GACf,kBAAkB,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,kBAAkB,CAAC;IAE7D,IAAI,UAAU,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QACpC,OAAO;YACL,QAAQ,EAAE,QAAQ;YAClB,KAAK,EAAE,MAAM,CAAC,cAAc;YAC5B,OAAO,EAAE,WAAW,IAAI,MAAM,CAAC,gBAAgB;SAChD,CAAC;IACJ,CAAC;IAED,IAAI,UAAU,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAClC,OAAO;YACL,QAAQ,EAAE,SAAS;YACnB,KAAK,EAAE,MAAM,CAAC,YAAY;YAC1B,OAAO,EAAE,WAAW,IAAI,MAAM,CAAC,cAAc;SAC9C,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACI,MAAM,gBAAgB,GAAG,CAAC,EAC/B,MAAM,EACN,UAAU,EACV,YAAY,EACZ,KAAK,EACL,UAAU,GACY,EAA6B,EAAE;IACrD,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,CACL,uBAAC,YAAM,IAAC,KAAK,EAAE,MAAM,CAAC,mBAAmB,EAAE,QAAQ,EAAC,MAAM,YACxD,uBAAC,UAAQ,cAAE,MAAM,CAAC,qBAAqB,GAAY,GAC5C,CACV,CAAC;IACJ,CAAC;IAED,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,CACL,uBAAC,YAAM,IAAC,KAAK,EAAE,MAAM,CAAC,eAAe,EAAE,QAAQ,EAAC,QAAQ,YACtD,uBAAC,UAAQ,cAAE,MAAM,CAAC,iBAAiB,GAAY,GACxC,CACV,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,CACL,uBAAC,YAAM,IAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAC,SAAS,YAC5C,uBAAC,UAAQ,cAAE,KAAK,CAAC,OAAO,GAAY,GAC7B,CACV,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,kBAAkB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAEzE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CACL,wBAAC,YAAM,IAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,aAClD,uBAAC,UAAQ,cAAE,KAAK,CAAC,OAAO,GAAY,EACpC,uBAAC,UAAQ,IAAC,IAAI,EAAC,IAAI,YACjB,uBAAC,UAAI,IAAC,IAAI,EAAE,mBAAmB,YAAG,MAAM,CAAC,SAAS,GAAQ,GACjD,EACX,wBAAC,UAAQ,IAAC,IAAI,EAAC,IAAI,aACjB,uBAAC,UAAI,IAAC,KAAK,EAAC,SAAS,EAAC,IAAI,EAAC,eAAe,GAAG,OAAE,MAAM,CAAC,iBAAiB,EAAE,GAAG,EAC5E,uBAAC,UAAI,IAAC,IAAI,EAAE,YAAY,yBAAiB,IAChC,IACJ,CACV,CAAC;AACJ,CAAC,CAAC;AAjDW,QAAA,gBAAgB,oBAiD3B","sourcesContent":["import type { ComponentOrElement } from '@metamask/snaps-sdk';\nimport { Banner, Icon, Link, Text as SnapText } from '@metamask/snaps-sdk/jsx';\nimport type { BannerProps } from '@metamask/snaps-sdk/jsx';\n\nexport type TransactionAlertLabels = {\n  scanInProgressTitle: string;\n  scanInProgressMessage: string;\n  scanFailedTitle: string;\n  scanFailedMessage: string;\n  maliciousTitle: string;\n  maliciousMessage: string;\n  warningTitle: string;\n  warningMessage: string;\n  learnMore: string;\n  securityAdvisedBy: string;\n};\n\nexport type TransactionAlertError = {\n  /** Translated banner title. */\n  title: string;\n  /** Translated, user-facing reason of the scan error. */\n  message: string;\n};\n\nexport type TransactionAlertValidation = {\n  /** Security validation result type, e.g. `Malicious`, `Warning` or `Benign`. */\n  type: string | null;\n  /** Provider description of the finding, used instead of the default message. */\n  description?: string | null;\n};\n\nexport type TransactionAlertProps = {\n  labels: TransactionAlertLabels;\n  /** Whether the transaction scan is in flight. */\n  isFetching: boolean;\n  /** Whether the transaction scan request itself failed. */\n  isFetchError: boolean;\n  /** The scan error to show, or `null` when there is none (or it is disabled). */\n  error: TransactionAlertError | null;\n  /** The security validation to show, or `null` when there is none (or it is disabled). */\n  validation: TransactionAlertValidation | null;\n};\n\nconst SECURITY_ALERTS_URL =\n  'https://support.metamask.io/configure/wallet/how-to-turn-on-security-alerts/';\n\nconst BLOCKAID_URL = 'https://www.blockaid.io';\n\n/**\n * Resolves the security banner for a validation result.\n *\n * @param validation - The security validation result.\n * @param labels - The translated labels.\n * @returns The banner severity, title and message, or `null` when the\n * validation does not warrant a banner.\n */\nfunction getValidationAlert(\n  validation: TransactionAlertValidation,\n  labels: TransactionAlertLabels,\n): {\n  severity: BannerProps['severity'];\n  title: string;\n  message: string;\n} | null {\n  const trimmedDescription = validation.description?.trim();\n  const description =\n    trimmedDescription === '' ? undefined : trimmedDescription;\n\n  if (validation.type === 'Malicious') {\n    return {\n      severity: 'danger',\n      title: labels.maliciousTitle,\n      message: description ?? labels.maliciousMessage,\n    };\n  }\n\n  if (validation.type === 'Warning') {\n    return {\n      severity: 'warning',\n      title: labels.warningTitle,\n      message: description ?? labels.warningMessage,\n    };\n  }\n\n  return null;\n}\n\n/**\n * Renders the single top-of-screen transaction scan banner.\n *\n * Exactly one banner is rendered, picked in this order:\n *\n * 1. `isFetching` → \"scan in progress\" info banner.\n * 2. `isFetchError` → \"scan failed\" danger banner.\n * 3. `error` → warning banner with the error title and message.\n * 4. `Malicious` or `Warning` validation → security banner with a link to the\n * security alerts documentation and the Blockaid attribution.\n * 5. Otherwise nothing.\n *\n * @param props - The component props.\n * @param props.labels - The translated labels.\n * @param props.isFetching - Whether the transaction scan is in flight.\n * @param props.isFetchError - Whether the transaction scan request failed.\n * @param props.error - The scan error to show.\n * @param props.validation - The security validation to show.\n * @returns The banner, or `null` when no alert applies.\n */\nexport const TransactionAlert = ({\n  labels,\n  isFetching,\n  isFetchError,\n  error,\n  validation,\n}: TransactionAlertProps): ComponentOrElement | null => {\n  if (isFetching) {\n    return (\n      <Banner title={labels.scanInProgressTitle} severity=\"info\">\n        <SnapText>{labels.scanInProgressMessage}</SnapText>\n      </Banner>\n    );\n  }\n\n  if (isFetchError) {\n    return (\n      <Banner title={labels.scanFailedTitle} severity=\"danger\">\n        <SnapText>{labels.scanFailedMessage}</SnapText>\n      </Banner>\n    );\n  }\n\n  if (error) {\n    return (\n      <Banner title={error.title} severity=\"warning\">\n        <SnapText>{error.message}</SnapText>\n      </Banner>\n    );\n  }\n\n  const alert = validation ? getValidationAlert(validation, labels) : null;\n\n  if (!alert) {\n    return null;\n  }\n\n  return (\n    <Banner title={alert.title} severity={alert.severity}>\n      <SnapText>{alert.message}</SnapText>\n      <SnapText size=\"sm\">\n        <Link href={SECURITY_ALERTS_URL}>{labels.learnMore}</Link>\n      </SnapText>\n      <SnapText size=\"sm\">\n        <Icon color=\"primary\" name=\"security-tick\" /> {labels.securityAdvisedBy}{' '}\n        <Link href={BLOCKAID_URL}>Blockaid</Link>\n      </SnapText>\n    </Banner>\n  );\n};\n"]}

package/dist/ui/TransactionAlert/TransactionAlert.d.cts

@@ -0,0 +1,58 @@
+import type { ComponentOrElement } from "@metamask/snaps-sdk";
+export type TransactionAlertLabels = {
+    scanInProgressTitle: string;
+    scanInProgressMessage: string;
+    scanFailedTitle: string;
+    scanFailedMessage: string;
+    maliciousTitle: string;
+    maliciousMessage: string;
+    warningTitle: string;
+    warningMessage: string;
+    learnMore: string;
+    securityAdvisedBy: string;
+};
+export type TransactionAlertError = {
+    /** Translated banner title. */
+    title: string;
+    /** Translated, user-facing reason of the scan error. */
+    message: string;
+};
+export type TransactionAlertValidation = {
+    /** Security validation result type, e.g. `Malicious`, `Warning` or `Benign`. */
+    type: string | null;
+    /** Provider description of the finding, used instead of the default message. */
+    description?: string | null;
+};
+export type TransactionAlertProps = {
+    labels: TransactionAlertLabels;
+    /** Whether the transaction scan is in flight. */
+    isFetching: boolean;
+    /** Whether the transaction scan request itself failed. */
+    isFetchError: boolean;
+    /** The scan error to show, or `null` when there is none (or it is disabled). */
+    error: TransactionAlertError | null;
+    /** The security validation to show, or `null` when there is none (or it is disabled). */
+    validation: TransactionAlertValidation | null;
+};
+/**
+ * Renders the single top-of-screen transaction scan banner.
+ *
+ * Exactly one banner is rendered, picked in this order:
+ *
+ * 1. `isFetching` → "scan in progress" info banner.
+ * 2. `isFetchError` → "scan failed" danger banner.
+ * 3. `error` → warning banner with the error title and message.
+ * 4. `Malicious` or `Warning` validation → security banner with a link to the
+ * security alerts documentation and the Blockaid attribution.
+ * 5. Otherwise nothing.
+ *
+ * @param props - The component props.
+ * @param props.labels - The translated labels.
+ * @param props.isFetching - Whether the transaction scan is in flight.
+ * @param props.isFetchError - Whether the transaction scan request failed.
+ * @param props.error - The scan error to show.
+ * @param props.validation - The security validation to show.
+ * @returns The banner, or `null` when no alert applies.
+ */
+export declare const TransactionAlert: ({ labels, isFetching, isFetchError, error, validation, }: TransactionAlertProps) => ComponentOrElement | null;
+//# sourceMappingURL=TransactionAlert.d.cts.map

package/dist/ui/TransactionAlert/TransactionAlert.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransactionAlert.d.cts","sourceRoot":"","sources":["../../../src/ui/TransactionAlert/TransactionAlert.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,4BAA4B;AAI9D,MAAM,MAAM,sBAAsB,GAAG;IACnC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,gFAAgF;IAChF,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,gFAAgF;IAChF,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,EAAE,sBAAsB,CAAC;IAC/B,iDAAiD;IACjD,UAAU,EAAE,OAAO,CAAC;IACpB,0DAA0D;IAC1D,YAAY,EAAE,OAAO,CAAC;IACtB,gFAAgF;IAChF,KAAK,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACpC,yFAAyF;IACzF,UAAU,EAAE,0BAA0B,GAAG,IAAI,CAAC;CAC/C,CAAC;AA8CF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,gBAAgB,GAAI,0DAM9B,qBAAqB,KAAG,kBAAkB,GAAG,IA2C/C,CAAC"}

package/dist/ui/TransactionAlert/TransactionAlert.d.mts

@@ -0,0 +1,58 @@
+import type { ComponentOrElement } from "@metamask/snaps-sdk";
+export type TransactionAlertLabels = {
+    scanInProgressTitle: string;
+    scanInProgressMessage: string;
+    scanFailedTitle: string;
+    scanFailedMessage: string;
+    maliciousTitle: string;
+    maliciousMessage: string;
+    warningTitle: string;
+    warningMessage: string;
+    learnMore: string;
+    securityAdvisedBy: string;
+};
+export type TransactionAlertError = {
+    /** Translated banner title. */
+    title: string;
+    /** Translated, user-facing reason of the scan error. */
+    message: string;
+};
+export type TransactionAlertValidation = {
+    /** Security validation result type, e.g. `Malicious`, `Warning` or `Benign`. */
+    type: string | null;
+    /** Provider description of the finding, used instead of the default message. */
+    description?: string | null;
+};
+export type TransactionAlertProps = {
+    labels: TransactionAlertLabels;
+    /** Whether the transaction scan is in flight. */
+    isFetching: boolean;
+    /** Whether the transaction scan request itself failed. */
+    isFetchError: boolean;
+    /** The scan error to show, or `null` when there is none (or it is disabled). */
+    error: TransactionAlertError | null;
+    /** The security validation to show, or `null` when there is none (or it is disabled). */
+    validation: TransactionAlertValidation | null;
+};
+/**
+ * Renders the single top-of-screen transaction scan banner.
+ *
+ * Exactly one banner is rendered, picked in this order:
+ *
+ * 1. `isFetching` → "scan in progress" info banner.
+ * 2. `isFetchError` → "scan failed" danger banner.
+ * 3. `error` → warning banner with the error title and message.
+ * 4. `Malicious` or `Warning` validation → security banner with a link to the
+ * security alerts documentation and the Blockaid attribution.
+ * 5. Otherwise nothing.
+ *
+ * @param props - The component props.
+ * @param props.labels - The translated labels.
+ * @param props.isFetching - Whether the transaction scan is in flight.
+ * @param props.isFetchError - Whether the transaction scan request failed.
+ * @param props.error - The scan error to show.
+ * @param props.validation - The security validation to show.
+ * @returns The banner, or `null` when no alert applies.
+ */
+export declare const TransactionAlert: ({ labels, isFetching, isFetchError, error, validation, }: TransactionAlertProps) => ComponentOrElement | null;
+//# sourceMappingURL=TransactionAlert.d.mts.map

package/dist/ui/TransactionAlert/TransactionAlert.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransactionAlert.d.mts","sourceRoot":"","sources":["../../../src/ui/TransactionAlert/TransactionAlert.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,4BAA4B;AAI9D,MAAM,MAAM,sBAAsB,GAAG;IACnC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,+BAA+B;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,gFAAgF;IAChF,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,gFAAgF;IAChF,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,EAAE,sBAAsB,CAAC;IAC/B,iDAAiD;IACjD,UAAU,EAAE,OAAO,CAAC;IACpB,0DAA0D;IAC1D,YAAY,EAAE,OAAO,CAAC;IACtB,gFAAgF;IAChF,KAAK,EAAE,qBAAqB,GAAG,IAAI,CAAC;IACpC,yFAAyF;IACzF,UAAU,EAAE,0BAA0B,GAAG,IAAI,CAAC;CAC/C,CAAC;AA8CF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,gBAAgB,GAAI,0DAM9B,qBAAqB,KAAG,kBAAkB,GAAG,IA2C/C,CAAC"}

package/dist/ui/TransactionAlert/TransactionAlert.mjs

@@ -0,0 +1,68 @@
+import { jsx as _jsx, jsxs as _jsxs } from "@metamask/snaps-sdk/jsx-runtime";
+import { Banner, Icon, Link, Text as SnapText } from "@metamask/snaps-sdk/jsx";
+const SECURITY_ALERTS_URL = 'https://support.metamask.io/configure/wallet/how-to-turn-on-security-alerts/';
+const BLOCKAID_URL = 'https://www.blockaid.io';
+/**
+ * Resolves the security banner for a validation result.
+ *
+ * @param validation - The security validation result.
+ * @param labels - The translated labels.
+ * @returns The banner severity, title and message, or `null` when the
+ * validation does not warrant a banner.
+ */
+function getValidationAlert(validation, labels) {
+    const trimmedDescription = validation.description?.trim();
+    const description = trimmedDescription === '' ? undefined : trimmedDescription;
+    if (validation.type === 'Malicious') {
+        return {
+            severity: 'danger',
+            title: labels.maliciousTitle,
+            message: description ?? labels.maliciousMessage,
+        };
+    }
+    if (validation.type === 'Warning') {
+        return {
+            severity: 'warning',
+            title: labels.warningTitle,
+            message: description ?? labels.warningMessage,
+        };
+    }
+    return null;
+}
+/**
+ * Renders the single top-of-screen transaction scan banner.
+ *
+ * Exactly one banner is rendered, picked in this order:
+ *
+ * 1. `isFetching` → "scan in progress" info banner.
+ * 2. `isFetchError` → "scan failed" danger banner.
+ * 3. `error` → warning banner with the error title and message.
+ * 4. `Malicious` or `Warning` validation → security banner with a link to the
+ * security alerts documentation and the Blockaid attribution.
+ * 5. Otherwise nothing.
+ *
+ * @param props - The component props.
+ * @param props.labels - The translated labels.
+ * @param props.isFetching - Whether the transaction scan is in flight.
+ * @param props.isFetchError - Whether the transaction scan request failed.
+ * @param props.error - The scan error to show.
+ * @param props.validation - The security validation to show.
+ * @returns The banner, or `null` when no alert applies.
+ */
+export const TransactionAlert = ({ labels, isFetching, isFetchError, error, validation, }) => {
+    if (isFetching) {
+        return (_jsx(Banner, { title: labels.scanInProgressTitle, severity: "info", children: _jsx(SnapText, { children: labels.scanInProgressMessage }) }));
+    }
+    if (isFetchError) {
+        return (_jsx(Banner, { title: labels.scanFailedTitle, severity: "danger", children: _jsx(SnapText, { children: labels.scanFailedMessage }) }));
+    }
+    if (error) {
+        return (_jsx(Banner, { title: error.title, severity: "warning", children: _jsx(SnapText, { children: error.message }) }));
+    }
+    const alert = validation ? getValidationAlert(validation, labels) : null;
+    if (!alert) {
+        return null;
+    }
+    return (_jsxs(Banner, { title: alert.title, severity: alert.severity, children: [_jsx(SnapText, { children: alert.message }), _jsx(SnapText, { size: "sm", children: _jsx(Link, { href: SECURITY_ALERTS_URL, children: labels.learnMore }) }), _jsxs(SnapText, { size: "sm", children: [_jsx(Icon, { color: "primary", name: "security-tick" }), " ", labels.securityAdvisedBy, ' ', _jsx(Link, { href: BLOCKAID_URL, children: "Blockaid" })] })] }));
+};
+//# sourceMappingURL=TransactionAlert.mjs.map

package/dist/ui/TransactionAlert/TransactionAlert.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"TransactionAlert.mjs","sourceRoot":"","sources":["../../../src/ui/TransactionAlert/TransactionAlert.tsx"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,IAAI,QAAQ,EAAE,gCAAgC;AA0C/E,MAAM,mBAAmB,GACvB,8EAA8E,CAAC;AAEjF,MAAM,YAAY,GAAG,yBAAyB,CAAC;AAE/C;;;;;;;GAOG;AACH,SAAS,kBAAkB,CACzB,UAAsC,EACtC,MAA8B;IAM9B,MAAM,kBAAkB,GAAG,UAAU,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC;IAC1D,MAAM,WAAW,GACf,kBAAkB,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,kBAAkB,CAAC;IAE7D,IAAI,UAAU,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QACpC,OAAO;YACL,QAAQ,EAAE,QAAQ;YAClB,KAAK,EAAE,MAAM,CAAC,cAAc;YAC5B,OAAO,EAAE,WAAW,IAAI,MAAM,CAAC,gBAAgB;SAChD,CAAC;IACJ,CAAC;IAED,IAAI,UAAU,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAClC,OAAO;YACL,QAAQ,EAAE,SAAS;YACnB,KAAK,EAAE,MAAM,CAAC,YAAY;YAC1B,OAAO,EAAE,WAAW,IAAI,MAAM,CAAC,cAAc;SAC9C,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,EAC/B,MAAM,EACN,UAAU,EACV,YAAY,EACZ,KAAK,EACL,UAAU,GACY,EAA6B,EAAE;IACrD,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,CACL,KAAC,MAAM,IAAC,KAAK,EAAE,MAAM,CAAC,mBAAmB,EAAE,QAAQ,EAAC,MAAM,YACxD,KAAC,QAAQ,cAAE,MAAM,CAAC,qBAAqB,GAAY,GAC5C,CACV,CAAC;IACJ,CAAC;IAED,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,CACL,KAAC,MAAM,IAAC,KAAK,EAAE,MAAM,CAAC,eAAe,EAAE,QAAQ,EAAC,QAAQ,YACtD,KAAC,QAAQ,cAAE,MAAM,CAAC,iBAAiB,GAAY,GACxC,CACV,CAAC;IACJ,CAAC;IAED,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,CACL,KAAC,MAAM,IAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAC,SAAS,YAC5C,KAAC,QAAQ,cAAE,KAAK,CAAC,OAAO,GAAY,GAC7B,CACV,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,UAAU,CAAC,CAAC,CAAC,kBAAkB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAEzE,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CACL,MAAC,MAAM,IAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,aAClD,KAAC,QAAQ,cAAE,KAAK,CAAC,OAAO,GAAY,EACpC,KAAC,QAAQ,IAAC,IAAI,EAAC,IAAI,YACjB,KAAC,IAAI,IAAC,IAAI,EAAE,mBAAmB,YAAG,MAAM,CAAC,SAAS,GAAQ,GACjD,EACX,MAAC,QAAQ,IAAC,IAAI,EAAC,IAAI,aACjB,KAAC,IAAI,IAAC,KAAK,EAAC,SAAS,EAAC,IAAI,EAAC,eAAe,GAAG,OAAE,MAAM,CAAC,iBAAiB,EAAE,GAAG,EAC5E,KAAC,IAAI,IAAC,IAAI,EAAE,YAAY,yBAAiB,IAChC,IACJ,CACV,CAAC;AACJ,CAAC,CAAC","sourcesContent":["import type { ComponentOrElement } from '@metamask/snaps-sdk';\nimport { Banner, Icon, Link, Text as SnapText } from '@metamask/snaps-sdk/jsx';\nimport type { BannerProps } from '@metamask/snaps-sdk/jsx';\n\nexport type TransactionAlertLabels = {\n  scanInProgressTitle: string;\n  scanInProgressMessage: string;\n  scanFailedTitle: string;\n  scanFailedMessage: string;\n  maliciousTitle: string;\n  maliciousMessage: string;\n  warningTitle: string;\n  warningMessage: string;\n  learnMore: string;\n  securityAdvisedBy: string;\n};\n\nexport type TransactionAlertError = {\n  /** Translated banner title. */\n  title: string;\n  /** Translated, user-facing reason of the scan error. */\n  message: string;\n};\n\nexport type TransactionAlertValidation = {\n  /** Security validation result type, e.g. `Malicious`, `Warning` or `Benign`. */\n  type: string | null;\n  /** Provider description of the finding, used instead of the default message. */\n  description?: string | null;\n};\n\nexport type TransactionAlertProps = {\n  labels: TransactionAlertLabels;\n  /** Whether the transaction scan is in flight. */\n  isFetching: boolean;\n  /** Whether the transaction scan request itself failed. */\n  isFetchError: boolean;\n  /** The scan error to show, or `null` when there is none (or it is disabled). */\n  error: TransactionAlertError | null;\n  /** The security validation to show, or `null` when there is none (or it is disabled). */\n  validation: TransactionAlertValidation | null;\n};\n\nconst SECURITY_ALERTS_URL =\n  'https://support.metamask.io/configure/wallet/how-to-turn-on-security-alerts/';\n\nconst BLOCKAID_URL = 'https://www.blockaid.io';\n\n/**\n * Resolves the security banner for a validation result.\n *\n * @param validation - The security validation result.\n * @param labels - The translated labels.\n * @returns The banner severity, title and message, or `null` when the\n * validation does not warrant a banner.\n */\nfunction getValidationAlert(\n  validation: TransactionAlertValidation,\n  labels: TransactionAlertLabels,\n): {\n  severity: BannerProps['severity'];\n  title: string;\n  message: string;\n} | null {\n  const trimmedDescription = validation.description?.trim();\n  const description =\n    trimmedDescription === '' ? undefined : trimmedDescription;\n\n  if (validation.type === 'Malicious') {\n    return {\n      severity: 'danger',\n      title: labels.maliciousTitle,\n      message: description ?? labels.maliciousMessage,\n    };\n  }\n\n  if (validation.type === 'Warning') {\n    return {\n      severity: 'warning',\n      title: labels.warningTitle,\n      message: description ?? labels.warningMessage,\n    };\n  }\n\n  return null;\n}\n\n/**\n * Renders the single top-of-screen transaction scan banner.\n *\n * Exactly one banner is rendered, picked in this order:\n *\n * 1. `isFetching` → \"scan in progress\" info banner.\n * 2. `isFetchError` → \"scan failed\" danger banner.\n * 3. `error` → warning banner with the error title and message.\n * 4. `Malicious` or `Warning` validation → security banner with a link to the\n * security alerts documentation and the Blockaid attribution.\n * 5. Otherwise nothing.\n *\n * @param props - The component props.\n * @param props.labels - The translated labels.\n * @param props.isFetching - Whether the transaction scan is in flight.\n * @param props.isFetchError - Whether the transaction scan request failed.\n * @param props.error - The scan error to show.\n * @param props.validation - The security validation to show.\n * @returns The banner, or `null` when no alert applies.\n */\nexport const TransactionAlert = ({\n  labels,\n  isFetching,\n  isFetchError,\n  error,\n  validation,\n}: TransactionAlertProps): ComponentOrElement | null => {\n  if (isFetching) {\n    return (\n      <Banner title={labels.scanInProgressTitle} severity=\"info\">\n        <SnapText>{labels.scanInProgressMessage}</SnapText>\n      </Banner>\n    );\n  }\n\n  if (isFetchError) {\n    return (\n      <Banner title={labels.scanFailedTitle} severity=\"danger\">\n        <SnapText>{labels.scanFailedMessage}</SnapText>\n      </Banner>\n    );\n  }\n\n  if (error) {\n    return (\n      <Banner title={error.title} severity=\"warning\">\n        <SnapText>{error.message}</SnapText>\n      </Banner>\n    );\n  }\n\n  const alert = validation ? getValidationAlert(validation, labels) : null;\n\n  if (!alert) {\n    return null;\n  }\n\n  return (\n    <Banner title={alert.title} severity={alert.severity}>\n      <SnapText>{alert.message}</SnapText>\n      <SnapText size=\"sm\">\n        <Link href={SECURITY_ALERTS_URL}>{labels.learnMore}</Link>\n      </SnapText>\n      <SnapText size=\"sm\">\n        <Icon color=\"primary\" name=\"security-tick\" /> {labels.securityAdvisedBy}{' '}\n        <Link href={BLOCKAID_URL}>Blockaid</Link>\n      </SnapText>\n    </Banner>\n  );\n};\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"}