@metamask-previews/profile-metrics-controller 4.0.4-preview-6eff555ee → 5.0.0-preview-0a30e47

package/CHANGELOG.md

@@ -7,6 +7,28 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Changed
+
+- Bump `uuid` from `^8.3.2` to `^9.0.1` ([#10117](https://github.com/MetaMask/core/pull/10117))
+
+## [5.0.0]
+
+### Changed
+
+- **BREAKING:** Drop CommonJS support ([#9536](https://github.com/MetaMask/core/pull/9536))
+  - This package is now ESM-only, but can still be used in CommonJS projects via `require(esm)` in modern Node.js versions (22+), or dynamic imports in older Node.js versions.
+- **BREAKING:** Bump minimum Node.js version to 22 ([#9976](https://github.com/MetaMask/core/pull/9976))
+- **BREAKING:** Bump TypeScript target to ES2022 ([#10019](https://github.com/MetaMask/core/pull/10019))
+  - This package now ships ES2022 code, requiring a compatible modern environment or bundler configuration to consume.
+- Bump `@metamask/accounts-controller` from `^39.1.1` to `^40.0.0` ([#10160](https://github.com/MetaMask/core/pull/10160))
+- Bump `@metamask/base-controller` from `^9.1.0` to `^10.0.0` ([#10160](https://github.com/MetaMask/core/pull/10160))
+- Bump `@metamask/controller-utils` from `^12.3.0` to `^13.0.0` ([#10160](https://github.com/MetaMask/core/pull/10160))
+- Bump `@metamask/keyring-controller` from `^27.1.1` to `^28.0.0` ([#10160](https://github.com/MetaMask/core/pull/10160))
+- Bump `@metamask/messenger` from `^2.0.0` to `^3.0.0` ([#10160](https://github.com/MetaMask/core/pull/10160))
+- Bump `@metamask/polling-controller` from `^16.0.9` to `^17.0.0` ([#10160](https://github.com/MetaMask/core/pull/10160))
+- Bump `@metamask/profile-sync-controller` from `^30.0.0` to `^31.0.0` ([#10160](https://github.com/MetaMask/core/pull/10160))
+- Bump `@metamask/transaction-controller` from `^69.8.1` to `^70.0.0` ([#10160](https://github.com/MetaMask/core/pull/10160))
+
 ## [4.0.4]
 
 ### Changed
@@ -228,7 +250,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - Initial release ([#7194](https://github.com/MetaMask/core/pull/7194), [#7196](https://github.com/MetaMask/core/pull/7196), [#7263](https://github.com/MetaMask/core/pull/7263))
 
-[Unreleased]: https://github.com/MetaMask/core/compare/@metamask/profile-metrics-controller@4.0.4...HEAD
+[Unreleased]: https://github.com/MetaMask/core/compare/@metamask/profile-metrics-controller@5.0.0...HEAD
+[5.0.0]: https://github.com/MetaMask/core/compare/@metamask/profile-metrics-controller@4.0.4...@metamask/profile-metrics-controller@5.0.0
 [4.0.4]: https://github.com/MetaMask/core/compare/@metamask/profile-metrics-controller@4.0.3...@metamask/profile-metrics-controller@4.0.4
 [4.0.3]: https://github.com/MetaMask/core/compare/@metamask/profile-metrics-controller@4.0.2...@metamask/profile-metrics-controller@4.0.3
 [4.0.2]: https://github.com/MetaMask/core/compare/@metamask/profile-metrics-controller@4.0.1...@metamask/profile-metrics-controller@4.0.2

package/dist/{ProfileMetricsController-method-action-types.d.mts → ProfileMetricsController-method-action-types.d.ts}

@@ -2,7 +2,7 @@
  * This file is auto generated.
  * Do not edit manually.
  */
-import type { ProfileMetricsController } from "./ProfileMetricsController.mjs";
+import type { ProfileMetricsController } from './ProfileMetricsController.js';
 /**
  * Skip the initial delay period by setting the end timestamp to the current time.
  * Metrics will be sent on the next poll.
@@ -15,4 +15,4 @@ export type ProfileMetricsControllerSkipInitialDelayAction = {
  * Union of all ProfileMetricsController action types.
  */
 export type ProfileMetricsControllerMethodActions = ProfileMetricsControllerSkipInitialDelayAction;
-//# sourceMappingURL=ProfileMetricsController-method-action-types.d.mts.map
+//# sourceMappingURL=ProfileMetricsController-method-action-types.d.ts.map

package/dist/ProfileMetricsController-method-action-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProfileMetricsController-method-action-types.d.ts","sourceRoot":"","sources":["../src/ProfileMetricsController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAE9E;;;GAGG;AACH,MAAM,MAAM,8CAA8C,GAAG;IAC3D,IAAI,EAAE,2CAA2C,CAAC;IAClD,OAAO,EAAE,wBAAwB,CAAC,kBAAkB,CAAC,CAAC;CACvD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qCAAqC,GAC/C,8CAA8C,CAAC"}

package/dist/{ProfileMetricsController-method-action-types.mjs → ProfileMetricsController-method-action-types.js}

@@ -3,4 +3,4 @@
  * Do not edit manually.
  */
 export {};
-//# sourceMappingURL=ProfileMetricsController-method-action-types.mjs.map
+//# sourceMappingURL=ProfileMetricsController-method-action-types.js.map

package/dist/ProfileMetricsController-method-action-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProfileMetricsController-method-action-types.js","sourceRoot":"","sources":["../src/ProfileMetricsController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { ProfileMetricsController } from './ProfileMetricsController.js';\n\n/**\n * Skip the initial delay period by setting the end timestamp to the current time.\n * Metrics will be sent on the next poll.\n */\nexport type ProfileMetricsControllerSkipInitialDelayAction = {\n  type: `ProfileMetricsController:skipInitialDelay`;\n  handler: ProfileMetricsController['skipInitialDelay'];\n};\n\n/**\n * Union of all ProfileMetricsController action types.\n */\nexport type ProfileMetricsControllerMethodActions =\n  ProfileMetricsControllerSkipInitialDelayAction;\n"]}

package/dist/{ProfileMetricsController.d.cts → ProfileMetricsController.d.ts}

@@ -1,12 +1,12 @@
-import type { AccountsControllerAccountAddedEvent, AccountsControllerAccountRemovedEvent, AccountsControllerGetStateAction } from "@metamask/accounts-controller";
-import type { ControllerGetStateAction, ControllerStateChangeEvent } from "@metamask/base-controller";
-import type { KeyringControllerLockEvent, KeyringControllerUnlockEvent } from "@metamask/keyring-controller";
-import type { Messenger } from "@metamask/messenger";
-import { TransactionControllerTransactionSubmittedEvent } from "@metamask/transaction-controller";
-import type { ProfileMetricsControllerMethodActions } from "./ProfileMetricsController-method-action-types.cjs";
-import type { ProfileMetricsServiceMethodActions } from "./ProfileMetricsService-method-action-types.cjs";
-import type { AccountWithScopes } from "./ProfileMetricsService.cjs";
-import type { ProofOfOwnershipServiceMethodActions } from "./ProofOfOwnershipService-method-action-types.cjs";
+import type { AccountsControllerAccountAddedEvent, AccountsControllerAccountRemovedEvent, AccountsControllerGetStateAction } from '@metamask/accounts-controller';
+import type { ControllerGetStateAction, ControllerStateChangeEvent } from '@metamask/base-controller';
+import type { KeyringControllerLockEvent, KeyringControllerUnlockEvent } from '@metamask/keyring-controller';
+import type { Messenger } from '@metamask/messenger';
+import { TransactionControllerTransactionSubmittedEvent } from '@metamask/transaction-controller';
+import type { ProfileMetricsControllerMethodActions } from './ProfileMetricsController-method-action-types.js';
+import type { ProfileMetricsServiceMethodActions } from './ProfileMetricsService-method-action-types.js';
+import type { AccountWithScopes } from './ProfileMetricsService.js';
+import type { ProofOfOwnershipServiceMethodActions } from './ProofOfOwnershipService-method-action-types.js';
 /**
  * The name of the {@link ProfileMetricsController}, used to namespace the
  * controller's actions and events and to namespace the controller's state data
@@ -86,18 +86,18 @@ type AllowedEvents = KeyringControllerUnlockEvent | KeyringControllerLockEvent |
  */
 export type ProfileMetricsControllerMessenger = Messenger<typeof controllerName, ProfileMetricsControllerActions | AllowedActions, ProfileMetricsControllerEvents | AllowedEvents>;
 declare const ProfileMetricsController_base: (abstract new (...args: any[]) => {
-    readonly "__#6@#intervalIds": Record<string, NodeJS.Timeout>;
-    "__#6@#intervalLength": number | undefined;
-    setIntervalLength(intervalLength: number): void;
-    getIntervalLength(): number | undefined;
-    _startPolling(input: import("@metamask/utils").Json): void;
-    _stopPollingByPollingTokenSetId(key: string): void;
-    readonly "__#3@#pollingTokenSets": Map<string, Set<string>>;
-    readonly "__#3@#callbacks": Map<string, Set<(input: import("@metamask/utils").Json) => void>>;
+    readonly _callbacks: Map<string, Set<(input: import("@metamask/utils").Json) => void>>;
     _executePoll(input: import("@metamask/utils").Json): Promise<void>;
     startPolling(input: import("@metamask/utils").Json): string;
     stopAllPolling(): void;
     stopPollingByPollingToken(pollingToken: string): void;
+    readonly _intervalIds: Record<import("@metamask/polling-controller").PollingTokenSetId, NodeJS.Timeout>;
+    _intervalLength: number | undefined;
+    setIntervalLength(intervalLength: number): void;
+    getIntervalLength(): number | undefined;
+    _startPolling(input: import("@metamask/utils").Json): void;
+    _stopPollingByPollingTokenSetId(key: import("@metamask/polling-controller").PollingTokenSetId): void;
+    readonly _pollingTokenSets: Map<import("@metamask/polling-controller").PollingTokenSetId, Set<string>>;
     onPollingComplete(input: import("@metamask/utils").Json, callback: (input: import("@metamask/utils").Json) => void): void;
 }) & typeof import("@metamask/base-controller").BaseController;
 /**
@@ -151,4 +151,4 @@ export declare class ProfileMetricsController extends ProfileMetricsController_b
     _executePoll(): Promise<void>;
 }
 export {};
-//# sourceMappingURL=ProfileMetricsController.d.cts.map
+//# sourceMappingURL=ProfileMetricsController.d.ts.map

package/dist/ProfileMetricsController.d.ts.map

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

package/dist/ProfileMetricsController.js

@@ -0,0 +1,398 @@
+import { StaticIntervalPollingController } from '@metamask/polling-controller';
+import { Duration, inMilliseconds, parseCaipChainId } from '@metamask/utils';
+import { Mutex } from 'async-mutex';
+import { canonicalizeAddress, ProofUnsupportedNamespaceError, } from './utils/canonicalize.js';
+/**
+ * The name of the {@link ProfileMetricsController}, used to namespace the
+ * controller's actions and events and to namespace the controller's state data
+ * when composed with other controllers.
+ */
+export const controllerName = 'ProfileMetricsController';
+/**
+ * The default delay duration before data is sent for the first time.
+ */
+export const DEFAULT_INITIAL_DELAY_DURATION = inMilliseconds(1, Duration.Minute);
+/**
+ * The metadata for each property in {@link ProfileMetricsControllerState}.
+ */
+const profileMetricsControllerMetadata = {
+    initialEnqueueCompleted: {
+        persist: true,
+        includeInDebugSnapshot: true,
+        includeInStateLogs: true,
+        usedInUi: false,
+    },
+    syncQueue: {
+        persist: true,
+        includeInDebugSnapshot: false,
+        includeInStateLogs: true,
+        usedInUi: false,
+    },
+    initialDelayEndTimestamp: {
+        persist: true,
+        includeInDebugSnapshot: true,
+        includeInStateLogs: true,
+        usedInUi: false,
+    },
+    proofBackfillEnqueued: {
+        persist: true,
+        includeInDebugSnapshot: true,
+        includeInStateLogs: true,
+        usedInUi: false,
+    },
+};
+/**
+ * Constructs the default {@link ProfileMetricsController} state. This allows
+ * consumers to provide a partial state object when initializing the controller
+ * and also helps in constructing complete state objects for this controller in
+ * tests.
+ *
+ * @returns The default {@link ProfileMetricsController} state.
+ */
+export function getDefaultProfileMetricsControllerState() {
+    return {
+        initialEnqueueCompleted: false,
+        syncQueue: {},
+        proofBackfillEnqueued: false,
+    };
+}
+const MESSENGER_EXPOSED_METHODS = ['skipInitialDelay'];
+/**
+ * Manages user profile metrics.
+ *
+ * For users who opt-in to metrics, this controller ensures we have metrics about their user
+ * profile (metrics ID and accounts).
+ */
+export class ProfileMetricsController extends StaticIntervalPollingController() {
+    #mutex = new Mutex();
+    #assertUserOptedIn;
+    #getMetaMetricsId;
+    #initialDelayDuration;
+    /**
+     * Constructs a new {@link ProfileMetricsController}.
+     *
+     * @param args - The constructor arguments.
+     * @param args.messenger - The messenger suited for this controller.
+     * @param args.state - The desired state with which to initialize this
+     * controller. Missing properties will be filled in with defaults.
+     * @param args.assertUserOptedIn - A function that asserts whether the user has
+     * opted in to user profile features. If the user has not opted in, sync
+     * operations will be no-ops.
+     * @param args.getMetaMetricsId - A function that returns the MetaMetrics ID
+     * of the user.
+     * @param args.interval - The interval, in milliseconds, at which the controller will
+     * attempt to send user profile data. Defaults to 10 seconds.
+     * @param args.initialDelayDuration - The delay duration before data is sent
+     * for the first time, in milliseconds. Defaults to 10 minutes.
+     */
+    constructor({ messenger, state, assertUserOptedIn, getMetaMetricsId, interval = 10 * 1000, initialDelayDuration = DEFAULT_INITIAL_DELAY_DURATION, }) {
+        super({
+            messenger,
+            metadata: profileMetricsControllerMetadata,
+            name: controllerName,
+            state: {
+                ...getDefaultProfileMetricsControllerState(),
+                ...state,
+            },
+        });
+        this.#assertUserOptedIn = assertUserOptedIn;
+        this.#getMetaMetricsId = getMetaMetricsId;
+        this.#initialDelayDuration = initialDelayDuration;
+        this.messenger.registerMethodActionHandlers(this, MESSENGER_EXPOSED_METHODS);
+        this.messenger.subscribe('KeyringController:unlock', () => {
+            if (this.#assertUserOptedIn()) {
+                // If the user has already opted in at the start of the session,
+                // it must have opted in during onboarding, or during a previous session.
+                this.skipInitialDelay();
+            }
+            this.#enqueueAccountsIfNeeded().catch(this.messenger.captureException ?? console.error);
+            this.startPolling(null);
+        });
+        this.messenger.subscribe('KeyringController:lock', () => this.stopAllPolling());
+        this.messenger.subscribe('TransactionController:transactionSubmitted', () => this.skipInitialDelay());
+        this.messenger.subscribe('AccountsController:accountAdded', (account) => {
+            this.#addAccountToQueue(account).catch(console.error);
+        });
+        this.messenger.subscribe('AccountsController:accountRemoved', (account) => {
+            this.#removeAccountFromQueue(account).catch(console.error);
+        });
+        this.setIntervalLength(interval);
+    }
+    /**
+     * Skip the initial delay period by setting the end timestamp to the current time.
+     * Metrics will be sent on the next poll.
+     */
+    skipInitialDelay() {
+        this.update((state) => {
+            state.initialDelayEndTimestamp = Date.now();
+        });
+    }
+    /**
+     * Execute a single poll to sync user profile data.
+     *
+     * The queued accounts are sent to the ProfileMetricsService, each with
+     * a proof of ownership when one can be produced (see {@link #attachProofs}),
+     * and the sync queue is cleared. This operation is mutexed to prevent
+     * concurrent executions.
+     *
+     * @returns A promise that resolves when the poll is complete.
+     */
+    async _executePoll() {
+        await this.#mutex.runExclusive(async () => {
+            if (!this.#assertUserOptedIn()) {
+                return;
+            }
+            this.#setInitialDelayEndTimestampIfNull();
+            if (!this.#isInitialDelayComplete()) {
+                return;
+            }
+            const fullAccountsByAddress = this.#getFullAccountsByAddress();
+            for (const [entropySourceId, accounts] of Object.entries(this.state.syncQueue)) {
+                const normalizedEntropySourceId = entropySourceId === 'null' ? null : entropySourceId;
+                // Skip proof-of-ownership for accounts without an entropy source
+                const accountsWithProofs = normalizedEntropySourceId === null
+                    ? accounts
+                    : await this.#attachProofs(accounts, fullAccountsByAddress, normalizedEntropySourceId);
+                try {
+                    await this.messenger.call('ProfileMetricsService:submitMetrics', {
+                        metametricsId: this.#getMetaMetricsId(),
+                        entropySourceId: normalizedEntropySourceId,
+                        accounts: accountsWithProofs,
+                    });
+                    this.update((state) => {
+                        delete state.syncQueue[entropySourceId];
+                    });
+                }
+                catch (error) {
+                    // We want to log the error but continue processing other batches.
+                    console.error(`Failed to submit profile metrics for entropy source ID ${entropySourceId}:`, error);
+                }
+            }
+        });
+    }
+    /**
+     * Attach a proof of ownership to each account in a single entropy-source
+     * batch when possible, canonicalizing the address along the way.
+     *
+     * Per-account failures (unknown namespace, snap missing the
+     * `signProofOfOwnership` method, snap rejection) and whole-batch nonce
+     * failures are caught and downgraded to "submit without a proof" so the
+     * batch still goes through and the proof is retried on the next poll.
+     *
+     * @param accounts - The queued accounts for a single batch.
+     * @param fullAccountsByAddress - Live `InternalAccount` lookup keyed by address.
+     * @param entropySourceId - The entropy source ID for this batch. Callers
+     * are expected to short-circuit before invoking this method when the
+     * batch has no entropy source; see `_executePoll` for why.
+     * @returns The accounts with `proof` populated where signing succeeded.
+     */
+    async #attachProofs(accounts, fullAccountsByAddress, entropySourceId) {
+        const candidates = new Map();
+        const identifiers = new Set();
+        for (const queued of accounts) {
+            const fullAccount = fullAccountsByAddress.get(queued.address);
+            if (!fullAccount) {
+                continue;
+            }
+            try {
+                const [scope] = fullAccount.scopes;
+                if (!scope) {
+                    throw new Error(`Scope not found for account ${fullAccount.id}`);
+                }
+                const { namespace } = parseCaipChainId(scope);
+                const canonicalAddress = canonicalizeAddress(fullAccount.address, namespace);
+                candidates.set(queued.address, {
+                    account: fullAccount,
+                    canonicalAddress,
+                });
+                identifiers.add(canonicalAddress);
+            }
+            catch (error) {
+                // Unsupported namespaces are an expected pass-through; anything
+                // else is logged so a new namespace doesn't go unnoticed.
+                if (!(error instanceof ProofUnsupportedNamespaceError)) {
+                    console.error(`Skipping proof for account ${fullAccount.id}:`, error);
+                }
+            }
+        }
+        if (candidates.size === 0) {
+            return accounts;
+        }
+        let nonces = {};
+        try {
+            nonces = await this.messenger.call('ProfileMetricsService:fetchNonces', {
+                identifiers: [...identifiers],
+                entropySourceId,
+            });
+        }
+        catch (error) {
+            console.error(`Failed to fetch proof-of-ownership nonces for entropy source ID ${entropySourceId}:`, error);
+        }
+        return await Promise.all(accounts.map(async (queued) => {
+            const candidate = candidates.get(queued.address);
+            if (!candidate) {
+                return queued;
+            }
+            const nonce = nonces[candidate.canonicalAddress];
+            if (!nonce) {
+                return { ...queued, address: candidate.canonicalAddress };
+            }
+            let proof;
+            try {
+                proof = await this.messenger.call('ProofOfOwnershipService:sign', {
+                    account: candidate.account,
+                    nonce,
+                });
+            }
+            catch (error) {
+                console.error(`Failed to sign proof of ownership for account ${candidate.account.id}:`, error);
+                return { ...queued, address: candidate.canonicalAddress };
+            }
+            return {
+                address: candidate.canonicalAddress,
+                scopes: queued.scopes,
+                proof,
+            };
+        }));
+    }
+    /**
+     * Snapshot the live `InternalAccount` map keyed by address for the
+     * current poll.
+     *
+     * @returns A map of address → `InternalAccount`.
+     */
+    #getFullAccountsByAddress() {
+        const byAddress = new Map();
+        const accountsState = this.messenger.call('AccountsController:getState');
+        for (const account of Object.values(accountsState.internalAccounts.accounts)) {
+            byAddress.set(account.address, account);
+        }
+        return byAddress;
+    }
+    /**
+     * Enqueue all currently-known accounts onto the sync queue if needed.
+     * Single entry point covering both the fresh-install first sync and
+     * the one-time proof-of-ownership backfill for users upgrading.
+     *
+     * Bails for opted-out users (the poll wouldn't drain the queue
+     * anyway), and bails once both bootstrap steps have already run.
+     * Otherwise enqueues all known accounts and flips both flags so this
+     * becomes a permanent no-op for the lifetime of the install.
+     */
+    async #enqueueAccountsIfNeeded() {
+        await this.#mutex.runExclusive(async () => {
+            if (!this.#assertUserOptedIn()) {
+                return;
+            }
+            if (this.state.initialEnqueueCompleted &&
+                this.state.proofBackfillEnqueued) {
+                return;
+            }
+            const groupedAccounts = groupAccountsByEntropySourceId(Object.values(this.messenger.call('AccountsController:getState').internalAccounts
+                .accounts));
+            this.update((state) => {
+                // Replace the queue rather than append. `AccountsController` is
+                // the source of truth and the queue is otherwise kept in sync
+                // with it via the `accountAdded` / `accountRemoved` subscriptions,
+                // so assigning here avoids duplicating entries that survived from
+                // a prior session or were pushed earlier in this same unlock
+                // cycle. Duplicates would matter because nonces are single-use:
+                // letting one through causes `#attachProofs` to sign and submit
+                // twice with the same nonce.
+                state.syncQueue = groupedAccounts;
+                state.initialEnqueueCompleted = true;
+                state.proofBackfillEnqueued = true;
+            });
+        });
+    }
+    /**
+     * Set the initial delay end timestamp if it is not already set.
+     */
+    #setInitialDelayEndTimestampIfNull() {
+        this.update((state) => {
+            state.initialDelayEndTimestamp ??=
+                Date.now() + this.#initialDelayDuration;
+        });
+    }
+    /**
+     * Check if the initial delay end timestamp is in the past.
+     *
+     * @returns True if the initial delay period has completed, false otherwise.
+     */
+    #isInitialDelayComplete() {
+        return (this.state.initialDelayEndTimestamp !== undefined &&
+            Date.now() >= this.state.initialDelayEndTimestamp);
+    }
+    /**
+     * Queue the given account to be synced at the next poll.
+     *
+     * @param account - The account to sync.
+     */
+    async #addAccountToQueue(account) {
+        await this.#mutex.runExclusive(async () => {
+            this.update((state) => {
+                const entropySourceId = getAccountEntropySourceId(account) ?? 'null';
+                if (!state.syncQueue[entropySourceId]) {
+                    state.syncQueue[entropySourceId] = [];
+                }
+                state.syncQueue[entropySourceId].push({
+                    address: account.address,
+                    scopes: account.scopes,
+                });
+            });
+        });
+    }
+    /**
+     * Remove the given account from the sync queue.
+     *
+     * @param account - The account address to remove.
+     */
+    async #removeAccountFromQueue(account) {
+        await this.#mutex.runExclusive(async () => {
+            this.update((state) => {
+                for (const [entropySourceId, groupedAddresses] of Object.entries(state.syncQueue)) {
+                    const index = groupedAddresses.findIndex(({ address }) => address === account);
+                    if (index === -1) {
+                        continue;
+                    }
+                    groupedAddresses.splice(index, 1);
+                    if (groupedAddresses.length === 0) {
+                        delete state.syncQueue[entropySourceId];
+                    }
+                    break;
+                }
+            });
+        });
+    }
+}
+/**
+ * Retrieves the entropy source ID from the given account, if it exists.
+ *
+ * @param account - The account from which to retrieve the entropy source ID.
+ * @returns The entropy source ID, or null if it does not exist.
+ */
+function getAccountEntropySourceId(account) {
+    if (account.options.entropy?.type === 'mnemonic') {
+        return account.options.entropy.id;
+    }
+    return null;
+}
+/**
+ * Groups accounts by their entropy source ID.
+ *
+ * @param accounts - The accounts to group.
+ * @returns An object where each key is an entropy source ID and each value is
+ * an array of account addresses associated with that entropy source ID.
+ */
+function groupAccountsByEntropySourceId(accounts) {
+    return accounts.reduce((result, account) => {
+        const entropySourceId = getAccountEntropySourceId(account);
+        const key = entropySourceId ?? 'null';
+        if (!result[key]) {
+            result[key] = [];
+        }
+        result[key].push({ address: account.address, scopes: account.scopes });
+        return result;
+    }, {});
+}
+//# sourceMappingURL=ProfileMetricsController.js.map

package/dist/ProfileMetricsController.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProfileMetricsController.js","sourceRoot":"","sources":["../src/ProfileMetricsController.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  AccountsControllerAccountAddedEvent,\n  AccountsControllerAccountRemovedEvent,\n  AccountsControllerGetStateAction,\n} from '@metamask/accounts-controller';\nimport type {\n  ControllerGetStateAction,\n  ControllerStateChangeEvent,\n  StateMetadata,\n} from '@metamask/base-controller';\nimport type {\n  KeyringControllerLockEvent,\n  KeyringControllerUnlockEvent,\n} from '@metamask/keyring-controller';\nimport type { InternalAccount } from '@metamask/keyring-internal-api';\nimport type { Messenger } from '@metamask/messenger';\nimport { StaticIntervalPollingController } from '@metamask/polling-controller';\nimport { TransactionControllerTransactionSubmittedEvent } from '@metamask/transaction-controller';\nimport { Duration, inMilliseconds, parseCaipChainId } from '@metamask/utils';\nimport { Mutex } from 'async-mutex';\n\nimport type { ProfileMetricsControllerMethodActions } from './ProfileMetricsController-method-action-types.js';\nimport type { ProfileMetricsServiceMethodActions } from './ProfileMetricsService-method-action-types.js';\nimport type {\n  AccountOwnershipProof,\n  AccountWithScopes,\n} from './ProfileMetricsService.js';\nimport type { ProofOfOwnershipServiceMethodActions } from './ProofOfOwnershipService-method-action-types.js';\nimport {\n  canonicalizeAddress,\n  ProofUnsupportedNamespaceError,\n} from './utils/canonicalize.js';\n\n/**\n * The name of the {@link ProfileMetricsController}, used to namespace the\n * controller's actions and events and to namespace the controller's state data\n * when composed with other controllers.\n */\nexport const controllerName = 'ProfileMetricsController';\n\n/**\n * The default delay duration before data is sent for the first time.\n */\nexport const DEFAULT_INITIAL_DELAY_DURATION = inMilliseconds(\n  1,\n  Duration.Minute,\n);\n\n/**\n * Describes the shape of the state object for {@link ProfileMetricsController}.\n */\nexport type ProfileMetricsControllerState = {\n  /**\n   * Whether existing accounts have been added\n   * to the queue.\n   */\n  initialEnqueueCompleted: boolean;\n  /**\n   * The queue of accounts to be synced.\n   * Each key is an entropy source ID, and each value is an array of account\n   * addresses associated with that entropy source. Accounts with no entropy\n   * source ID are grouped under the key \"null\".\n   */\n  syncQueue: Record<string, AccountWithScopes[]>;\n  /**\n   * The timestamp when the first data sending can be attempted.\n   */\n  initialDelayEndTimestamp?: number;\n  /**\n   * Whether previously-synced accounts have been re-enqueued so their\n   * proofs of ownership are submitted alongside everything else. Set on\n   * the first unlock after upgrading to a version that signs proofs of\n   * ownership; fresh installs flip this on their initial sync since the\n   * first poll already attaches proofs.\n   */\n  proofBackfillEnqueued: boolean;\n};\n\n/**\n * The metadata for each property in {@link ProfileMetricsControllerState}.\n */\nconst profileMetricsControllerMetadata = {\n  initialEnqueueCompleted: {\n    persist: true,\n    includeInDebugSnapshot: true,\n    includeInStateLogs: true,\n    usedInUi: false,\n  },\n  syncQueue: {\n    persist: true,\n    includeInDebugSnapshot: false,\n    includeInStateLogs: true,\n    usedInUi: false,\n  },\n  initialDelayEndTimestamp: {\n    persist: true,\n    includeInDebugSnapshot: true,\n    includeInStateLogs: true,\n    usedInUi: false,\n  },\n  proofBackfillEnqueued: {\n    persist: true,\n    includeInDebugSnapshot: true,\n    includeInStateLogs: true,\n    usedInUi: false,\n  },\n} satisfies StateMetadata<ProfileMetricsControllerState>;\n\n/**\n * Constructs the default {@link ProfileMetricsController} state. This allows\n * consumers to provide a partial state object when initializing the controller\n * and also helps in constructing complete state objects for this controller in\n * tests.\n *\n * @returns The default {@link ProfileMetricsController} state.\n */\nexport function getDefaultProfileMetricsControllerState(): ProfileMetricsControllerState {\n  return {\n    initialEnqueueCompleted: false,\n    syncQueue: {},\n    proofBackfillEnqueued: false,\n  };\n}\n\nconst MESSENGER_EXPOSED_METHODS = ['skipInitialDelay'] as const;\n\n/**\n * Retrieves the state of the {@link ProfileMetricsController}.\n */\nexport type ProfileMetricsControllerGetStateAction = ControllerGetStateAction<\n  typeof controllerName,\n  ProfileMetricsControllerState\n>;\n\n/**\n * Actions that {@link ProfileMetricsControllerMessenger} exposes to other consumers.\n */\nexport type ProfileMetricsControllerActions =\n  | ProfileMetricsControllerGetStateAction\n  | ProfileMetricsControllerMethodActions;\n\n/**\n * Actions from other messengers that {@link ProfileMetricsControllerMessenger} calls.\n */\ntype AllowedActions =\n  | ProfileMetricsServiceMethodActions\n  | ProofOfOwnershipServiceMethodActions\n  | AccountsControllerGetStateAction;\n\n/**\n * Published when the state of {@link ProfileMetricsController} changes.\n */\nexport type ProfileMetricsControllerStateChangeEvent =\n  ControllerStateChangeEvent<\n    typeof controllerName,\n    ProfileMetricsControllerState\n  >;\n\n/**\n * Events that {@link ProfileMetricsControllerMessenger} exposes to other consumers.\n */\nexport type ProfileMetricsControllerEvents =\n  ProfileMetricsControllerStateChangeEvent;\n\n/**\n * Events from other messengers that {@link ProfileMetricsControllerMessenger} subscribes\n * to.\n */\ntype AllowedEvents =\n  | KeyringControllerUnlockEvent\n  | KeyringControllerLockEvent\n  | AccountsControllerAccountAddedEvent\n  | AccountsControllerAccountRemovedEvent\n  | TransactionControllerTransactionSubmittedEvent;\n\n/**\n * The messenger restricted to actions and events accessed by\n * {@link ProfileMetricsController}.\n */\nexport type ProfileMetricsControllerMessenger = Messenger<\n  typeof controllerName,\n  ProfileMetricsControllerActions | AllowedActions,\n  ProfileMetricsControllerEvents | AllowedEvents\n>;\n\n/**\n * Manages user profile metrics.\n *\n * For users who opt-in to metrics, this controller ensures we have metrics about their user\n * profile (metrics ID and accounts).\n */\nexport class ProfileMetricsController extends StaticIntervalPollingController()<\n  typeof controllerName,\n  ProfileMetricsControllerState,\n  ProfileMetricsControllerMessenger\n> {\n  readonly #mutex = new Mutex();\n\n  readonly #assertUserOptedIn: () => boolean;\n\n  readonly #getMetaMetricsId: () => string;\n\n  readonly #initialDelayDuration: number;\n\n  /**\n   * Constructs a new {@link ProfileMetricsController}.\n   *\n   * @param args - The constructor arguments.\n   * @param args.messenger - The messenger suited for this controller.\n   * @param args.state - The desired state with which to initialize this\n   * controller. Missing properties will be filled in with defaults.\n   * @param args.assertUserOptedIn - A function that asserts whether the user has\n   * opted in to user profile features. If the user has not opted in, sync\n   * operations will be no-ops.\n   * @param args.getMetaMetricsId - A function that returns the MetaMetrics ID\n   * of the user.\n   * @param args.interval - The interval, in milliseconds, at which the controller will\n   * attempt to send user profile data. Defaults to 10 seconds.\n   * @param args.initialDelayDuration - The delay duration before data is sent\n   * for the first time, in milliseconds. Defaults to 10 minutes.\n   */\n  constructor({\n    messenger,\n    state,\n    assertUserOptedIn,\n    getMetaMetricsId,\n    interval = 10 * 1000,\n    initialDelayDuration = DEFAULT_INITIAL_DELAY_DURATION,\n  }: {\n    messenger: ProfileMetricsControllerMessenger;\n    state?: Partial<ProfileMetricsControllerState>;\n    interval?: number;\n    assertUserOptedIn: () => boolean;\n    getMetaMetricsId: () => string;\n    initialDelayDuration?: number;\n  }) {\n    super({\n      messenger,\n      metadata: profileMetricsControllerMetadata,\n      name: controllerName,\n      state: {\n        ...getDefaultProfileMetricsControllerState(),\n        ...state,\n      },\n    });\n\n    this.#assertUserOptedIn = assertUserOptedIn;\n    this.#getMetaMetricsId = getMetaMetricsId;\n    this.#initialDelayDuration = initialDelayDuration;\n\n    this.messenger.registerMethodActionHandlers(\n      this,\n      MESSENGER_EXPOSED_METHODS,\n    );\n\n    this.messenger.subscribe('KeyringController:unlock', () => {\n      if (this.#assertUserOptedIn()) {\n        // If the user has already opted in at the start of the session,\n        // it must have opted in during onboarding, or during a previous session.\n        this.skipInitialDelay();\n      }\n      this.#enqueueAccountsIfNeeded().catch(\n        this.messenger.captureException ?? console.error,\n      );\n      this.startPolling(null);\n    });\n\n    this.messenger.subscribe('KeyringController:lock', () =>\n      this.stopAllPolling(),\n    );\n\n    this.messenger.subscribe('TransactionController:transactionSubmitted', () =>\n      this.skipInitialDelay(),\n    );\n\n    this.messenger.subscribe('AccountsController:accountAdded', (account) => {\n      this.#addAccountToQueue(account).catch(console.error);\n    });\n\n    this.messenger.subscribe('AccountsController:accountRemoved', (account) => {\n      this.#removeAccountFromQueue(account).catch(console.error);\n    });\n\n    this.setIntervalLength(interval);\n  }\n\n  /**\n   * Skip the initial delay period by setting the end timestamp to the current time.\n   * Metrics will be sent on the next poll.\n   */\n  skipInitialDelay(): void {\n    this.update((state) => {\n      state.initialDelayEndTimestamp = Date.now();\n    });\n  }\n\n  /**\n   * Execute a single poll to sync user profile data.\n   *\n   * The queued accounts are sent to the ProfileMetricsService, each with\n   * a proof of ownership when one can be produced (see {@link #attachProofs}),\n   * and the sync queue is cleared. This operation is mutexed to prevent\n   * concurrent executions.\n   *\n   * @returns A promise that resolves when the poll is complete.\n   */\n  async _executePoll(): Promise<void> {\n    await this.#mutex.runExclusive(async () => {\n      if (!this.#assertUserOptedIn()) {\n        return;\n      }\n      this.#setInitialDelayEndTimestampIfNull();\n      if (!this.#isInitialDelayComplete()) {\n        return;\n      }\n      const fullAccountsByAddress = this.#getFullAccountsByAddress();\n      for (const [entropySourceId, accounts] of Object.entries(\n        this.state.syncQueue,\n      )) {\n        const normalizedEntropySourceId =\n          entropySourceId === 'null' ? null : entropySourceId;\n        // Skip proof-of-ownership for accounts without an entropy source\n        const accountsWithProofs =\n          normalizedEntropySourceId === null\n            ? accounts\n            : await this.#attachProofs(\n                accounts,\n                fullAccountsByAddress,\n                normalizedEntropySourceId,\n              );\n        try {\n          await this.messenger.call('ProfileMetricsService:submitMetrics', {\n            metametricsId: this.#getMetaMetricsId(),\n            entropySourceId: normalizedEntropySourceId,\n            accounts: accountsWithProofs,\n          });\n          this.update((state) => {\n            delete state.syncQueue[entropySourceId];\n          });\n        } catch (error) {\n          // We want to log the error but continue processing other batches.\n          console.error(\n            `Failed to submit profile metrics for entropy source ID ${entropySourceId}:`,\n            error,\n          );\n        }\n      }\n    });\n  }\n\n  /**\n   * Attach a proof of ownership to each account in a single entropy-source\n   * batch when possible, canonicalizing the address along the way.\n   *\n   * Per-account failures (unknown namespace, snap missing the\n   * `signProofOfOwnership` method, snap rejection) and whole-batch nonce\n   * failures are caught and downgraded to \"submit without a proof\" so the\n   * batch still goes through and the proof is retried on the next poll.\n   *\n   * @param accounts - The queued accounts for a single batch.\n   * @param fullAccountsByAddress - Live `InternalAccount` lookup keyed by address.\n   * @param entropySourceId - The entropy source ID for this batch. Callers\n   * are expected to short-circuit before invoking this method when the\n   * batch has no entropy source; see `_executePoll` for why.\n   * @returns The accounts with `proof` populated where signing succeeded.\n   */\n  async #attachProofs(\n    accounts: AccountWithScopes[],\n    fullAccountsByAddress: Map<string, InternalAccount>,\n    entropySourceId: string,\n  ): Promise<AccountWithScopes[]> {\n    const candidates = new Map<\n      string,\n      { account: InternalAccount; canonicalAddress: string }\n    >();\n    const identifiers = new Set<string>();\n    for (const queued of accounts) {\n      const fullAccount = fullAccountsByAddress.get(queued.address);\n      if (!fullAccount) {\n        continue;\n      }\n      try {\n        const [scope] = fullAccount.scopes;\n        if (!scope) {\n          throw new Error(`Scope not found for account ${fullAccount.id}`);\n        }\n        const { namespace } = parseCaipChainId(scope);\n        const canonicalAddress = canonicalizeAddress(\n          fullAccount.address,\n          namespace,\n        );\n        candidates.set(queued.address, {\n          account: fullAccount,\n          canonicalAddress,\n        });\n        identifiers.add(canonicalAddress);\n      } catch (error) {\n        // Unsupported namespaces are an expected pass-through; anything\n        // else is logged so a new namespace doesn't go unnoticed.\n        if (!(error instanceof ProofUnsupportedNamespaceError)) {\n          console.error(`Skipping proof for account ${fullAccount.id}:`, error);\n        }\n      }\n    }\n\n    if (candidates.size === 0) {\n      return accounts;\n    }\n\n    let nonces: Record<string, string> = {};\n    try {\n      nonces = await this.messenger.call('ProfileMetricsService:fetchNonces', {\n        identifiers: [...identifiers],\n        entropySourceId,\n      });\n    } catch (error) {\n      console.error(\n        `Failed to fetch proof-of-ownership nonces for entropy source ID ${entropySourceId}:`,\n        error,\n      );\n    }\n\n    return await Promise.all(\n      accounts.map(async (queued): Promise<AccountWithScopes> => {\n        const candidate = candidates.get(queued.address);\n        if (!candidate) {\n          return queued;\n        }\n        const nonce = nonces[candidate.canonicalAddress];\n        if (!nonce) {\n          return { ...queued, address: candidate.canonicalAddress };\n        }\n        let proof: AccountOwnershipProof;\n        try {\n          proof = await this.messenger.call('ProofOfOwnershipService:sign', {\n            account: candidate.account,\n            nonce,\n          });\n        } catch (error) {\n          console.error(\n            `Failed to sign proof of ownership for account ${candidate.account.id}:`,\n            error,\n          );\n          return { ...queued, address: candidate.canonicalAddress };\n        }\n        return {\n          address: candidate.canonicalAddress,\n          scopes: queued.scopes,\n          proof,\n        };\n      }),\n    );\n  }\n\n  /**\n   * Snapshot the live `InternalAccount` map keyed by address for the\n   * current poll.\n   *\n   * @returns A map of address → `InternalAccount`.\n   */\n  #getFullAccountsByAddress(): Map<string, InternalAccount> {\n    const byAddress = new Map<string, InternalAccount>();\n    const accountsState = this.messenger.call('AccountsController:getState');\n    for (const account of Object.values(\n      accountsState.internalAccounts.accounts,\n    )) {\n      byAddress.set(account.address, account);\n    }\n    return byAddress;\n  }\n\n  /**\n   * Enqueue all currently-known accounts onto the sync queue if needed.\n   * Single entry point covering both the fresh-install first sync and\n   * the one-time proof-of-ownership backfill for users upgrading.\n   *\n   * Bails for opted-out users (the poll wouldn't drain the queue\n   * anyway), and bails once both bootstrap steps have already run.\n   * Otherwise enqueues all known accounts and flips both flags so this\n   * becomes a permanent no-op for the lifetime of the install.\n   */\n  async #enqueueAccountsIfNeeded(): Promise<void> {\n    await this.#mutex.runExclusive(async () => {\n      if (!this.#assertUserOptedIn()) {\n        return;\n      }\n      if (\n        this.state.initialEnqueueCompleted &&\n        this.state.proofBackfillEnqueued\n      ) {\n        return;\n      }\n      const groupedAccounts = groupAccountsByEntropySourceId(\n        Object.values(\n          this.messenger.call('AccountsController:getState').internalAccounts\n            .accounts,\n        ),\n      );\n      this.update((state) => {\n        // Replace the queue rather than append. `AccountsController` is\n        // the source of truth and the queue is otherwise kept in sync\n        // with it via the `accountAdded` / `accountRemoved` subscriptions,\n        // so assigning here avoids duplicating entries that survived from\n        // a prior session or were pushed earlier in this same unlock\n        // cycle. Duplicates would matter because nonces are single-use:\n        // letting one through causes `#attachProofs` to sign and submit\n        // twice with the same nonce.\n        state.syncQueue = groupedAccounts;\n        state.initialEnqueueCompleted = true;\n        state.proofBackfillEnqueued = true;\n      });\n    });\n  }\n\n  /**\n   * Set the initial delay end timestamp if it is not already set.\n   */\n  #setInitialDelayEndTimestampIfNull(): void {\n    this.update((state) => {\n      state.initialDelayEndTimestamp ??=\n        Date.now() + this.#initialDelayDuration;\n    });\n  }\n\n  /**\n   * Check if the initial delay end timestamp is in the past.\n   *\n   * @returns True if the initial delay period has completed, false otherwise.\n   */\n  #isInitialDelayComplete(): boolean {\n    return (\n      this.state.initialDelayEndTimestamp !== undefined &&\n      Date.now() >= this.state.initialDelayEndTimestamp\n    );\n  }\n\n  /**\n   * Queue the given account to be synced at the next poll.\n   *\n   * @param account - The account to sync.\n   */\n  async #addAccountToQueue(account: InternalAccount): Promise<void> {\n    await this.#mutex.runExclusive(async () => {\n      this.update((state) => {\n        const entropySourceId = getAccountEntropySourceId(account) ?? 'null';\n        if (!state.syncQueue[entropySourceId]) {\n          state.syncQueue[entropySourceId] = [];\n        }\n        state.syncQueue[entropySourceId].push({\n          address: account.address,\n          scopes: account.scopes,\n        });\n      });\n    });\n  }\n\n  /**\n   * Remove the given account from the sync queue.\n   *\n   * @param account - The account address to remove.\n   */\n  async #removeAccountFromQueue(account: string): Promise<void> {\n    await this.#mutex.runExclusive(async () => {\n      this.update((state) => {\n        for (const [entropySourceId, groupedAddresses] of Object.entries(\n          state.syncQueue,\n        )) {\n          const index = groupedAddresses.findIndex(\n            ({ address }) => address === account,\n          );\n          if (index === -1) {\n            continue;\n          }\n          groupedAddresses.splice(index, 1);\n          if (groupedAddresses.length === 0) {\n            delete state.syncQueue[entropySourceId];\n          }\n          break;\n        }\n      });\n    });\n  }\n}\n\n/**\n * Retrieves the entropy source ID from the given account, if it exists.\n *\n * @param account - The account from which to retrieve the entropy source ID.\n * @returns The entropy source ID, or null if it does not exist.\n */\nfunction getAccountEntropySourceId(account: InternalAccount): string | null {\n  if (account.options.entropy?.type === 'mnemonic') {\n    return account.options.entropy.id;\n  }\n  return null;\n}\n\n/**\n * Groups accounts by their entropy source ID.\n *\n * @param accounts - The accounts to group.\n * @returns An object where each key is an entropy source ID and each value is\n * an array of account addresses associated with that entropy source ID.\n */\nfunction groupAccountsByEntropySourceId(\n  accounts: InternalAccount[],\n): Record<string, AccountWithScopes[]> {\n  return accounts.reduce(\n    (result: Record<string, AccountWithScopes[]>, account) => {\n      const entropySourceId = getAccountEntropySourceId(account);\n      const key = entropySourceId ?? 'null';\n      if (!result[key]) {\n        result[key] = [];\n      }\n      result[key].push({ address: account.address, scopes: account.scopes });\n      return result;\n    },\n    {},\n  );\n}\n"]}

package/dist/{ProfileMetricsService-method-action-types.d.cts → ProfileMetricsService-method-action-types.d.ts}

@@ -2,7 +2,7 @@
  * This file is auto generated.
  * Do not edit manually.
  */
-import type { ProfileMetricsService } from "./ProfileMetricsService.cjs";
+import type { ProfileMetricsService } from './ProfileMetricsService.js';
 /**
  * Fetch single-use nonces from the auth API, one per identifier.
  *
@@ -42,4 +42,4 @@ export type ProfileMetricsServiceSubmitMetricsAction = {
  * Union of all ProfileMetricsService action types.
  */
 export type ProfileMetricsServiceMethodActions = ProfileMetricsServiceFetchNoncesAction | ProfileMetricsServiceSubmitMetricsAction;
-//# sourceMappingURL=ProfileMetricsService-method-action-types.d.cts.map
+//# sourceMappingURL=ProfileMetricsService-method-action-types.d.ts.map

package/dist/ProfileMetricsService-method-action-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProfileMetricsService-method-action-types.d.ts","sourceRoot":"","sources":["../src/ProfileMetricsService-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAExE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,sCAAsC,GAAG;IACnD,IAAI,EAAE,mCAAmC,CAAC;IAC1C,OAAO,EAAE,qBAAqB,CAAC,aAAa,CAAC,CAAC;CAC/C,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,wCAAwC,GAAG;IACrD,IAAI,EAAE,qCAAqC,CAAC;IAC5C,OAAO,EAAE,qBAAqB,CAAC,eAAe,CAAC,CAAC;CACjD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,kCAAkC,GAC1C,sCAAsC,GACtC,wCAAwC,CAAC"}

package/dist/{ProfileMetricsService-method-action-types.mjs → ProfileMetricsService-method-action-types.js}

@@ -3,4 +3,4 @@
  * Do not edit manually.
  */
 export {};
-//# sourceMappingURL=ProfileMetricsService-method-action-types.mjs.map
+//# sourceMappingURL=ProfileMetricsService-method-action-types.js.map

package/dist/ProfileMetricsService-method-action-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProfileMetricsService-method-action-types.js","sourceRoot":"","sources":["../src/ProfileMetricsService-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { ProfileMetricsService } from './ProfileMetricsService.js';\n\n/**\n * Fetch single-use nonces from the auth API, one per identifier.\n *\n * Requests larger than {@link MAX_NONCE_BATCH_SIZE} are split into multiple\n * `POST /api/v2/nonce/batch` calls fired in parallel; the resulting maps are\n * merged into a single record. Each chunk independently goes through the\n * service policy (retry, circuit-breaker, degraded). If any chunk ultimately\n * fails, the whole call rejects so the caller can soft-degrade the entire\n * entropy-source batch consistently.\n *\n * The returned record is keyed by the auth API's echoed `identifier` field\n * (`response[i].identifier -> response[i].nonce`). The call asserts that\n * the response identifier set is exactly the requested set; any mismatch\n * (missing, extra, or duplicated identifier) causes the chunk to throw so\n * the caller never silently proceeds with partial nonces.\n *\n * @param data - The identifiers to mint nonces for, plus the optional\n * entropy source ID used to scope the bearer token.\n * @returns A map of identifier -> nonce.\n * @throws {RangeError} if no identifiers are provided.\n */\nexport type ProfileMetricsServiceFetchNoncesAction = {\n  type: `ProfileMetricsService:fetchNonces`;\n  handler: ProfileMetricsService['fetchNonces'];\n};\n\n/**\n * Submit metrics to the API.\n *\n * @param data - The data to send in the metrics update request.\n * @returns The response from the API.\n */\nexport type ProfileMetricsServiceSubmitMetricsAction = {\n  type: `ProfileMetricsService:submitMetrics`;\n  handler: ProfileMetricsService['submitMetrics'];\n};\n\n/**\n * Union of all ProfileMetricsService action types.\n */\nexport type ProfileMetricsServiceMethodActions =\n  | ProfileMetricsServiceFetchNoncesAction\n  | ProfileMetricsServiceSubmitMetricsAction;\n"]}