@metamask-previews/profile-controller 1.0.0-preview-c2be02bd4 → 1.0.1-preview-3b264bf6d

package/CHANGELOG.md

@@ -7,6 +7,25 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+### Added
+
+- Add `startXConnect` method to `ProfileController` for initiating the X OAuth flow. It fetches the authorization URL via `ProfileService:getXAuthUrl`, forwarding an optional CAIP-10 `linkedAddress` (the profile is resolved server-side from the verified bearer token), and returns the authorization URL and state parameter as ephemeral session data, without storing them in controller state ([#10668](https://github.com/MetaMask/core/pull/10668))
+- Add `disconnectX` method to `ProfileController` for unlinking the X account from a profile. It delegates to `ProfileService:disconnectX`, clears `xProfile` from controller state, and sets `connectedToX` to `false` when the disconnected profile matches the profile in state ([#10668](https://github.com/MetaMask/core/pull/10668))
+- Add `disconnectX` method to `ProfileService` for sending an authenticated `DELETE` request to the `profiles/{profileId}/x` endpoint; a `404` response is treated as success (the X account is already disconnected) ([#10668](https://github.com/MetaMask/core/pull/10668))
+
+### Changed
+
+- **BREAKING**: `ProfileController.connectX` now takes `{ code, state, profileId }`, always fetches the profile from the backend after the connect (the backend auto-creates the profile during X connect when missing), persists both `profile` and `xProfile` in state, and returns `{ profile, xProfile, profileCreated }` instead of just the X profile ([#10668](https://github.com/MetaMask/core/pull/10668))
+- `ProfileService.connectX` response now includes the optional `profile_created` boolean reported by the backend (optional so older backends without the field still validate) ([#10668](https://github.com/MetaMask/core/pull/10668))
+- `ProfileService.getXAuthUrl` now accepts an optional CAIP-10 `linkedAddress` parameter, sent as the `linked_address` query parameter (required by the backend when the profile does not exist yet) ([#10668](https://github.com/MetaMask/core/pull/10668))
+- `ProfileController.connectX` persists `xProfile` in state immediately after a successful connect; if the follow-up profile fetch fails, the X link stays persisted and a clear error is thrown ([#10668](https://github.com/MetaMask/core/pull/10668))
+
+## [1.0.1]
+
+### Changed
+
+- Bump `@metamask/profile-sync-controller` from `^33.0.0` to `^34.0.0` ([#10662](https://github.com/MetaMask/core/pull/10662))
+
 ## [1.0.0]
 
 ### Added
@@ -14,5 +33,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Add `ProfileController` for managing user profile state, exposing `getMetaMaskProfile`, `getXprofile`, `createProfile`, `replaceProfile`, `updateProfile`, `deleteProfile`, `checkUsernameAvailability`, `getXAuthUrl`, `connectX`, and `getXAccount` via the messenger ([#10558](https://github.com/MetaMask/core/pull/10558))
 - Add `ProfileService` for communicating with the MetaMask Profile API, exposing `getProfile`, `createProfile`, `replaceProfile`, `updateProfile`, `deleteProfile`, `checkUsernameAvailability`, `getXAuthUrl`, `connectX`, and `getXAccount` via the messenger, with superstruct validation on all inputs and responses ([#10558](https://github.com/MetaMask/core/pull/10558))
 
-[Unreleased]: https://github.com/MetaMask/core/compare/@metamask/profile-controller@1.0.0...HEAD
+[Unreleased]: https://github.com/MetaMask/core/compare/@metamask/profile-controller@1.0.1...HEAD
+[1.0.1]: https://github.com/MetaMask/core/compare/@metamask/profile-controller@1.0.0...@metamask/profile-controller@1.0.1
 [1.0.0]: https://github.com/MetaMask/core/releases/tag/@metamask/profile-controller@1.0.0

package/dist/ProfileController-method-action-types.d.ts

@@ -72,19 +72,32 @@ export type ProfileControllerCheckUsernameAvailabilityAction = {
     handler: ProfileController['checkUsernameAvailability'];
 };
 /**
- * Completes the X OAuth PKCE flow, updates xProfile in state, and returns the X profile.
+ * Completes the X OAuth flow, updates xProfile and profile in state, and
+ * returns the connect result. The backend creates the profile if it does
+ * not exist yet (username derived from the X handle), so the profile is
+ * always fetched from the backend after a successful connect.
  *
- * @param params - The parameters for the X OAuth PKCE flow.
+ * The linked X profile is persisted in state immediately after the connect
+ * succeeds. If the follow-up profile fetch fails, the X link remains
+ * persisted and a clear error is thrown — the profile in state may then be
+ * stale until the next successful fetch.
+ *
+ * @param params - The parameters for the X OAuth flow.
  * @param params.code - The OAuth authorization code from the X redirect.
  * @param params.state - The state parameter returned by the X redirect.
- * @returns The linked X profile.
+ * @param params.profileId - The canonical profile ID the X account is
+ * linked to (sourced from the auth session).
+ * @returns The refreshed profile, the linked X profile, and whether the
+ * backend created the profile during the connect.
  */
 export type ProfileControllerConnectXAction = {
     type: `ProfileController:connectX`;
     handler: ProfileController['connectX'];
 };
 /**
- * Fetches the X account linked to the current profile, updates state, and returns the X profile.
+ * Fetches the X account linked to the authenticated profile, updates state,
+ * and returns the X profile. The profile is resolved server-side from the
+ * verified bearer token.
  *
  * @returns The linked X profile.
  */
@@ -92,8 +105,33 @@ export type ProfileControllerFetchAndUpdateXAccountAction = {
     type: `ProfileController:fetchAndUpdateXAccount`;
     handler: ProfileController['fetchAndUpdateXAccount'];
 };
+/**
+ * Initiates the X OAuth flow by fetching the authorization URL from the backend.
+ * The profile is resolved server-side from the verified bearer token.
+ * Returns session data for the caller to use; nothing is stored in controller state.
+ *
+ * @param params - Optional parameters for initiating the X OAuth flow.
+ * @param params.linkedAddress - Optional CAIP-10 account ID to link to the
+ * profile when it does not exist yet.
+ * @returns The X authorization URL and state parameter.
+ */
+export type ProfileControllerStartXConnectAction = {
+    type: `ProfileController:startXConnect`;
+    handler: ProfileController['startXConnect'];
+};
+/**
+ * Disconnects the X account linked to the given profile, clears xProfile from
+ * state, and marks the profile in state as no longer connected to X.
+ *
+ * @param profileId - The ID of the profile to disconnect the linked X account
+ * from (sourced from {@link getProfile}).
+ */
+export type ProfileControllerDisconnectXAction = {
+    type: `ProfileController:disconnectX`;
+    handler: ProfileController['disconnectX'];
+};
 /**
  * Union of all ProfileController action types.
  */
-export type ProfileControllerMethodActions = ProfileControllerGetProfileAction | ProfileControllerGetXProfileAction | ProfileControllerCreateProfileAction | ProfileControllerReplaceProfileAction | ProfileControllerUpdateProfileAction | ProfileControllerDeleteProfileAction | ProfileControllerCheckUsernameAvailabilityAction | ProfileControllerConnectXAction | ProfileControllerFetchAndUpdateXAccountAction;
+export type ProfileControllerMethodActions = ProfileControllerGetProfileAction | ProfileControllerGetXProfileAction | ProfileControllerCreateProfileAction | ProfileControllerReplaceProfileAction | ProfileControllerUpdateProfileAction | ProfileControllerDeleteProfileAction | ProfileControllerCheckUsernameAvailabilityAction | ProfileControllerConnectXAction | ProfileControllerFetchAndUpdateXAccountAction | ProfileControllerStartXConnectAction | ProfileControllerDisconnectXAction;
 //# sourceMappingURL=ProfileController-method-action-types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ProfileController-method-action-types.d.ts","sourceRoot":"","sources":["../src/ProfileController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE;;;;GAIG;AACH,MAAM,MAAM,iCAAiC,GAAG;IAC9C,IAAI,EAAE,8BAA8B,CAAC;IACrC,OAAO,EAAE,iBAAiB,CAAC,YAAY,CAAC,CAAC;CAC1C,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,kCAAkC,GAAG;IAC/C,IAAI,EAAE,+BAA+B,CAAC;IACtC,OAAO,EAAE,iBAAiB,CAAC,aAAa,CAAC,CAAC;CAC3C,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,oCAAoC,GAAG;IACjD,IAAI,EAAE,iCAAiC,CAAC;IACxC,OAAO,EAAE,iBAAiB,CAAC,eAAe,CAAC,CAAC;CAC7C,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,qCAAqC,GAAG;IAClD,IAAI,EAAE,kCAAkC,CAAC;IACzC,OAAO,EAAE,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;CAC9C,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,oCAAoC,GAAG;IACjD,IAAI,EAAE,iCAAiC,CAAC;IACxC,OAAO,EAAE,iBAAiB,CAAC,eAAe,CAAC,CAAC;CAC7C,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,oCAAoC,GAAG;IACjD,IAAI,EAAE,iCAAiC,CAAC;IACxC,OAAO,EAAE,iBAAiB,CAAC,eAAe,CAAC,CAAC;CAC7C,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,gDAAgD,GAAG;IAC7D,IAAI,EAAE,6CAA6C,CAAC;IACpD,OAAO,EAAE,iBAAiB,CAAC,2BAA2B,CAAC,CAAC;CACzD,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,+BAA+B,GAAG;IAC5C,IAAI,EAAE,4BAA4B,CAAC;IACnC,OAAO,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAC;CACxC,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,6CAA6C,GAAG;IAC1D,IAAI,EAAE,0CAA0C,CAAC;IACjD,OAAO,EAAE,iBAAiB,CAAC,wBAAwB,CAAC,CAAC;CACtD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,8BAA8B,GACtC,iCAAiC,GACjC,kCAAkC,GAClC,oCAAoC,GACpC,qCAAqC,GACrC,oCAAoC,GACpC,oCAAoC,GACpC,gDAAgD,GAChD,+BAA+B,GAC/B,6CAA6C,CAAC"}
+{"version":3,"file":"ProfileController-method-action-types.d.ts","sourceRoot":"","sources":["../src/ProfileController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE;;;;GAIG;AACH,MAAM,MAAM,iCAAiC,GAAG;IAC9C,IAAI,EAAE,8BAA8B,CAAC;IACrC,OAAO,EAAE,iBAAiB,CAAC,YAAY,CAAC,CAAC;CAC1C,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,kCAAkC,GAAG;IAC/C,IAAI,EAAE,+BAA+B,CAAC;IACtC,OAAO,EAAE,iBAAiB,CAAC,aAAa,CAAC,CAAC;CAC3C,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,oCAAoC,GAAG;IACjD,IAAI,EAAE,iCAAiC,CAAC;IACxC,OAAO,EAAE,iBAAiB,CAAC,eAAe,CAAC,CAAC;CAC7C,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,qCAAqC,GAAG;IAClD,IAAI,EAAE,kCAAkC,CAAC;IACzC,OAAO,EAAE,iBAAiB,CAAC,gBAAgB,CAAC,CAAC;CAC9C,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,oCAAoC,GAAG;IACjD,IAAI,EAAE,iCAAiC,CAAC;IACxC,OAAO,EAAE,iBAAiB,CAAC,eAAe,CAAC,CAAC;CAC7C,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,oCAAoC,GAAG;IACjD,IAAI,EAAE,iCAAiC,CAAC;IACxC,OAAO,EAAE,iBAAiB,CAAC,eAAe,CAAC,CAAC;CAC7C,CAAC;AAEF;;;;;GAKG;AACH,MAAM,MAAM,gDAAgD,GAAG;IAC7D,IAAI,EAAE,6CAA6C,CAAC;IACpD,OAAO,EAAE,iBAAiB,CAAC,2BAA2B,CAAC,CAAC;CACzD,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,+BAA+B,GAAG;IAC5C,IAAI,EAAE,4BAA4B,CAAC;IACnC,OAAO,EAAE,iBAAiB,CAAC,UAAU,CAAC,CAAC;CACxC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,6CAA6C,GAAG;IAC1D,IAAI,EAAE,0CAA0C,CAAC;IACjD,OAAO,EAAE,iBAAiB,CAAC,wBAAwB,CAAC,CAAC;CACtD,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,oCAAoC,GAAG;IACjD,IAAI,EAAE,iCAAiC,CAAC;IACxC,OAAO,EAAE,iBAAiB,CAAC,eAAe,CAAC,CAAC;CAC7C,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,kCAAkC,GAAG;IAC/C,IAAI,EAAE,+BAA+B,CAAC;IACtC,OAAO,EAAE,iBAAiB,CAAC,aAAa,CAAC,CAAC;CAC3C,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,8BAA8B,GACtC,iCAAiC,GACjC,kCAAkC,GAClC,oCAAoC,GACpC,qCAAqC,GACrC,oCAAoC,GACpC,oCAAoC,GACpC,gDAAgD,GAChD,+BAA+B,GAC/B,6CAA6C,GAC7C,oCAAoC,GACpC,kCAAkC,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"ProfileController-method-action-types.js","sourceRoot":"","sources":["../src/ProfileController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { ProfileController } from './ProfileController.js';\n\n/**\n * Returns the current MetaMask profile from state, or undefined if none has been created.\n *\n * @returns The MetaMask profile, or undefined.\n */\nexport type ProfileControllerGetProfileAction = {\n  type: `ProfileController:getProfile`;\n  handler: ProfileController['getProfile'];\n};\n\n/**\n * Returns the currently linked X profile from state, or undefined if none has been connected.\n *\n * @returns The X profile, or undefined.\n */\nexport type ProfileControllerGetXProfileAction = {\n  type: `ProfileController:getXProfile`;\n  handler: ProfileController['getXProfile'];\n};\n\n/**\n * Creates a new MetaMask profile, updates state, and returns the created profile.\n * If the user had previously connected X, also updates xProfile in state.\n *\n * @param params - The profile creation parameters.\n * @returns The created MetaMask profile.\n */\nexport type ProfileControllerCreateProfileAction = {\n  type: `ProfileController:createProfile`;\n  handler: ProfileController['createProfile'];\n};\n\n/**\n * Fully replaces the current profile and updates state.\n *\n * @param input - The replacement profile data.\n * @throws If no profile has been created yet.\n */\nexport type ProfileControllerReplaceProfileAction = {\n  type: `ProfileController:replaceProfile`;\n  handler: ProfileController['replaceProfile'];\n};\n\n/**\n * Partially updates the current profile and updates state.\n *\n * @param input - The fields to update.\n * @throws If no profile has been created yet.\n */\nexport type ProfileControllerUpdateProfileAction = {\n  type: `ProfileController:updateProfile`;\n  handler: ProfileController['updateProfile'];\n};\n\n/**\n * Deletes the current profile and resets state, including clearing any linked X profile.\n *\n * @throws If no profile has been created yet.\n */\nexport type ProfileControllerDeleteProfileAction = {\n  type: `ProfileController:deleteProfile`;\n  handler: ProfileController['deleteProfile'];\n};\n\n/**\n * Checks whether a username is available.\n *\n * @param username - The username to check.\n * @returns Availability details including validity and normalized form.\n */\nexport type ProfileControllerCheckUsernameAvailabilityAction = {\n  type: `ProfileController:checkUsernameAvailability`;\n  handler: ProfileController['checkUsernameAvailability'];\n};\n\n/**\n * Completes the X OAuth PKCE flow, updates xProfile in state, and returns the X profile.\n *\n * @param params - The parameters for the X OAuth PKCE flow.\n * @param params.code - The OAuth authorization code from the X redirect.\n * @param params.state - The state parameter returned by the X redirect.\n * @returns The linked X profile.\n */\nexport type ProfileControllerConnectXAction = {\n  type: `ProfileController:connectX`;\n  handler: ProfileController['connectX'];\n};\n\n/**\n * Fetches the X account linked to the current profile, updates state, and returns the X profile.\n *\n * @returns The linked X profile.\n */\nexport type ProfileControllerFetchAndUpdateXAccountAction = {\n  type: `ProfileController:fetchAndUpdateXAccount`;\n  handler: ProfileController['fetchAndUpdateXAccount'];\n};\n\n/**\n * Union of all ProfileController action types.\n */\nexport type ProfileControllerMethodActions =\n  | ProfileControllerGetProfileAction\n  | ProfileControllerGetXProfileAction\n  | ProfileControllerCreateProfileAction\n  | ProfileControllerReplaceProfileAction\n  | ProfileControllerUpdateProfileAction\n  | ProfileControllerDeleteProfileAction\n  | ProfileControllerCheckUsernameAvailabilityAction\n  | ProfileControllerConnectXAction\n  | ProfileControllerFetchAndUpdateXAccountAction;\n"]}
+{"version":3,"file":"ProfileController-method-action-types.js","sourceRoot":"","sources":["../src/ProfileController-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { ProfileController } from './ProfileController.js';\n\n/**\n * Returns the current MetaMask profile from state, or undefined if none has been created.\n *\n * @returns The MetaMask profile, or undefined.\n */\nexport type ProfileControllerGetProfileAction = {\n  type: `ProfileController:getProfile`;\n  handler: ProfileController['getProfile'];\n};\n\n/**\n * Returns the currently linked X profile from state, or undefined if none has been connected.\n *\n * @returns The X profile, or undefined.\n */\nexport type ProfileControllerGetXProfileAction = {\n  type: `ProfileController:getXProfile`;\n  handler: ProfileController['getXProfile'];\n};\n\n/**\n * Creates a new MetaMask profile, updates state, and returns the created profile.\n * If the user had previously connected X, also updates xProfile in state.\n *\n * @param params - The profile creation parameters.\n * @returns The created MetaMask profile.\n */\nexport type ProfileControllerCreateProfileAction = {\n  type: `ProfileController:createProfile`;\n  handler: ProfileController['createProfile'];\n};\n\n/**\n * Fully replaces the current profile and updates state.\n *\n * @param input - The replacement profile data.\n * @throws If no profile has been created yet.\n */\nexport type ProfileControllerReplaceProfileAction = {\n  type: `ProfileController:replaceProfile`;\n  handler: ProfileController['replaceProfile'];\n};\n\n/**\n * Partially updates the current profile and updates state.\n *\n * @param input - The fields to update.\n * @throws If no profile has been created yet.\n */\nexport type ProfileControllerUpdateProfileAction = {\n  type: `ProfileController:updateProfile`;\n  handler: ProfileController['updateProfile'];\n};\n\n/**\n * Deletes the current profile and resets state, including clearing any linked X profile.\n *\n * @throws If no profile has been created yet.\n */\nexport type ProfileControllerDeleteProfileAction = {\n  type: `ProfileController:deleteProfile`;\n  handler: ProfileController['deleteProfile'];\n};\n\n/**\n * Checks whether a username is available.\n *\n * @param username - The username to check.\n * @returns Availability details including validity and normalized form.\n */\nexport type ProfileControllerCheckUsernameAvailabilityAction = {\n  type: `ProfileController:checkUsernameAvailability`;\n  handler: ProfileController['checkUsernameAvailability'];\n};\n\n/**\n * Completes the X OAuth flow, updates xProfile and profile in state, and\n * returns the connect result. The backend creates the profile if it does\n * not exist yet (username derived from the X handle), so the profile is\n * always fetched from the backend after a successful connect.\n *\n * The linked X profile is persisted in state immediately after the connect\n * succeeds. If the follow-up profile fetch fails, the X link remains\n * persisted and a clear error is thrown — the profile in state may then be\n * stale until the next successful fetch.\n *\n * @param params - The parameters for the X OAuth flow.\n * @param params.code - The OAuth authorization code from the X redirect.\n * @param params.state - The state parameter returned by the X redirect.\n * @param params.profileId - The canonical profile ID the X account is\n * linked to (sourced from the auth session).\n * @returns The refreshed profile, the linked X profile, and whether the\n * backend created the profile during the connect.\n */\nexport type ProfileControllerConnectXAction = {\n  type: `ProfileController:connectX`;\n  handler: ProfileController['connectX'];\n};\n\n/**\n * Fetches the X account linked to the authenticated profile, updates state,\n * and returns the X profile. The profile is resolved server-side from the\n * verified bearer token.\n *\n * @returns The linked X profile.\n */\nexport type ProfileControllerFetchAndUpdateXAccountAction = {\n  type: `ProfileController:fetchAndUpdateXAccount`;\n  handler: ProfileController['fetchAndUpdateXAccount'];\n};\n\n/**\n * Initiates the X OAuth flow by fetching the authorization URL from the backend.\n * The profile is resolved server-side from the verified bearer token.\n * Returns session data for the caller to use; nothing is stored in controller state.\n *\n * @param params - Optional parameters for initiating the X OAuth flow.\n * @param params.linkedAddress - Optional CAIP-10 account ID to link to the\n * profile when it does not exist yet.\n * @returns The X authorization URL and state parameter.\n */\nexport type ProfileControllerStartXConnectAction = {\n  type: `ProfileController:startXConnect`;\n  handler: ProfileController['startXConnect'];\n};\n\n/**\n * Disconnects the X account linked to the given profile, clears xProfile from\n * state, and marks the profile in state as no longer connected to X.\n *\n * @param profileId - The ID of the profile to disconnect the linked X account\n * from (sourced from {@link getProfile}).\n */\nexport type ProfileControllerDisconnectXAction = {\n  type: `ProfileController:disconnectX`;\n  handler: ProfileController['disconnectX'];\n};\n\n/**\n * Union of all ProfileController action types.\n */\nexport type ProfileControllerMethodActions =\n  | ProfileControllerGetProfileAction\n  | ProfileControllerGetXProfileAction\n  | ProfileControllerCreateProfileAction\n  | ProfileControllerReplaceProfileAction\n  | ProfileControllerUpdateProfileAction\n  | ProfileControllerDeleteProfileAction\n  | ProfileControllerCheckUsernameAvailabilityAction\n  | ProfileControllerConnectXAction\n  | ProfileControllerFetchAndUpdateXAccountAction\n  | ProfileControllerStartXConnectAction\n  | ProfileControllerDisconnectXAction;\n"]}

package/dist/ProfileController.d.ts

@@ -3,7 +3,7 @@ import type { ControllerGetStateAction, ControllerStateChangeEvent } from '@meta
 import type { Messenger } from '@metamask/messenger';
 import type { CaipAccountId } from '@metamask/utils';
 import type { ProfileControllerMethodActions } from './ProfileController-method-action-types.js';
-import type { ProfileServiceCheckUsernameAvailabilityAction, ProfileServiceConnectXAction, ProfileServiceCreateProfileAction, ProfileServiceDeleteProfileAction, ProfileServiceGetXAccountAction, ProfileServiceReplaceProfileAction, ProfileServiceUpdateProfileAction } from './ProfileService-method-action-types.js';
+import type { ProfileServiceCheckUsernameAvailabilityAction, ProfileServiceConnectXAction, ProfileServiceCreateProfileAction, ProfileServiceDeleteProfileAction, ProfileServiceDisconnectXAction, ProfileServiceGetProfileAction, ProfileServiceGetXAccountAction, ProfileServiceGetXAuthUrlAction, ProfileServiceReplaceProfileAction, ProfileServiceUpdateProfileAction } from './ProfileService-method-action-types.js';
 import type { CreateProfileParams, ReplaceProfileParams, UpdateProfileParams, UsernameAvailabilityResponse } from './ProfileService.js';
 declare const controllerName = "ProfileController";
 /** Representation of a profile stored in controller state. */
@@ -46,6 +46,22 @@ export type XProfile = {
     /** The date and time the X profile was updated. */
     updatedAt: string;
 };
+/** Ephemeral session data for initiating the X OAuth flow. Not stored in controller state. */
+export type XConnectSession = {
+    /** The X authorization URL to open in a system browser. */
+    authorizationUrl: string;
+    /** The OAuth state parameter to compare against the X redirect callback. */
+    state: string;
+};
+/** Result of completing the X connect flow. */
+export type XConnectResult = {
+    /** The MetaMask profile, refreshed from the backend after the connect. */
+    profile: Profile;
+    /** The linked X profile. */
+    xProfile: XProfile;
+    /** Whether the backend created the MetaMask profile during the connect. */
+    profileCreated: boolean;
+};
 /** State managed by ProfileController. */
 export type ProfileControllerState = {
     profile: Profile;
@@ -59,7 +75,7 @@ export type ProfileControllerActions = ProfileControllerGetStateAction | Profile
 export type ProfileControllerChangeEvent = ControllerStateChangeEvent<typeof controllerName, ProfileControllerState>;
 /** Union of all events emitted by ProfileController. */
 export type ProfileControllerEvents = ProfileControllerChangeEvent;
-type AllowedActions = ProfileServiceCreateProfileAction | ProfileServiceReplaceProfileAction | ProfileServiceUpdateProfileAction | ProfileServiceDeleteProfileAction | ProfileServiceCheckUsernameAvailabilityAction | ProfileServiceConnectXAction | ProfileServiceGetXAccountAction;
+type AllowedActions = ProfileServiceCreateProfileAction | ProfileServiceReplaceProfileAction | ProfileServiceUpdateProfileAction | ProfileServiceDeleteProfileAction | ProfileServiceCheckUsernameAvailabilityAction | ProfileServiceConnectXAction | ProfileServiceGetProfileAction | ProfileServiceGetXAccountAction | ProfileServiceGetXAuthUrlAction | ProfileServiceDisconnectXAction;
 export type AllowedEvents = never;
 /** Messenger type for ProfileController, scoped to its actions, events, and allowed service calls. */
 export type ProfileControllerMessenger = Messenger<typeof controllerName, ProfileControllerActions | AllowedActions, ProfileControllerEvents | AllowedEvents>;
@@ -131,23 +147,58 @@ export declare class ProfileController extends BaseController<typeof controllerN
      */
     checkUsernameAvailability(username: string): Promise<UsernameAvailabilityResponse>;
     /**
-     * Completes the X OAuth PKCE flow, updates xProfile in state, and returns the X profile.
+     * Completes the X OAuth flow, updates xProfile and profile in state, and
+     * returns the connect result. The backend creates the profile if it does
+     * not exist yet (username derived from the X handle), so the profile is
+     * always fetched from the backend after a successful connect.
      *
-     * @param params - The parameters for the X OAuth PKCE flow.
+     * The linked X profile is persisted in state immediately after the connect
+     * succeeds. If the follow-up profile fetch fails, the X link remains
+     * persisted and a clear error is thrown — the profile in state may then be
+     * stale until the next successful fetch.
+     *
+     * @param params - The parameters for the X OAuth flow.
      * @param params.code - The OAuth authorization code from the X redirect.
      * @param params.state - The state parameter returned by the X redirect.
-     * @returns The linked X profile.
+     * @param params.profileId - The canonical profile ID the X account is
+     * linked to (sourced from the auth session).
+     * @returns The refreshed profile, the linked X profile, and whether the
+     * backend created the profile during the connect.
      */
     connectX(params: {
         code: string;
         state: string;
-    }): Promise<XProfile>;
+        profileId: string;
+    }): Promise<XConnectResult>;
     /**
-     * Fetches the X account linked to the current profile, updates state, and returns the X profile.
+     * Fetches the X account linked to the authenticated profile, updates state,
+     * and returns the X profile. The profile is resolved server-side from the
+     * verified bearer token.
      *
      * @returns The linked X profile.
      */
     fetchAndUpdateXAccount(): Promise<XProfile>;
+    /**
+     * Initiates the X OAuth flow by fetching the authorization URL from the backend.
+     * The profile is resolved server-side from the verified bearer token.
+     * Returns session data for the caller to use; nothing is stored in controller state.
+     *
+     * @param params - Optional parameters for initiating the X OAuth flow.
+     * @param params.linkedAddress - Optional CAIP-10 account ID to link to the
+     * profile when it does not exist yet.
+     * @returns The X authorization URL and state parameter.
+     */
+    startXConnect(params?: {
+        linkedAddress?: CaipAccountId;
+    }): Promise<XConnectSession>;
+    /**
+     * Disconnects the X account linked to the given profile, clears xProfile from
+     * state, and marks the profile in state as no longer connected to X.
+     *
+     * @param profileId - The ID of the profile to disconnect the linked X account
+     * from (sourced from {@link getProfile}).
+     */
+    disconnectX(profileId: string): Promise<void>;
 }
 export {};
 //# sourceMappingURL=ProfileController.d.ts.map

package/dist/ProfileController.d.ts.map

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

package/dist/ProfileController.js

@@ -46,6 +46,8 @@ const MESSENGER_EXPOSED_METHODS = [
     'checkUsernameAvailability',
     'connectX',
     'fetchAndUpdateXAccount',
+    'startXConnect',
+    'disconnectX',
 ];
 // === CONTROLLER ===
 /** Manages MetaMask profile state and delegates API operations to ProfileService. */
@@ -213,19 +215,51 @@ export class ProfileController extends BaseController {
         return await this.messenger.call('ProfileService:checkUsernameAvailability', username);
     }
     /**
-     * Completes the X OAuth PKCE flow, updates xProfile in state, and returns the X profile.
+     * Completes the X OAuth flow, updates xProfile and profile in state, and
+     * returns the connect result. The backend creates the profile if it does
+     * not exist yet (username derived from the X handle), so the profile is
+     * always fetched from the backend after a successful connect.
      *
-     * @param params - The parameters for the X OAuth PKCE flow.
+     * The linked X profile is persisted in state immediately after the connect
+     * succeeds. If the follow-up profile fetch fails, the X link remains
+     * persisted and a clear error is thrown — the profile in state may then be
+     * stale until the next successful fetch.
+     *
+     * @param params - The parameters for the X OAuth flow.
      * @param params.code - The OAuth authorization code from the X redirect.
      * @param params.state - The state parameter returned by the X redirect.
-     * @returns The linked X profile.
+     * @param params.profileId - The canonical profile ID the X account is
+     * linked to (sourced from the auth session).
+     * @returns The refreshed profile, the linked X profile, and whether the
+     * backend created the profile during the connect.
      */
     async connectX(params) {
-        const response = await this.messenger.call('ProfileService:connectX', params);
-        return this.#mapXResponseToXProfile(response);
+        const response = await this.messenger.call('ProfileService:connectX', {
+            code: params.code,
+            state: params.state,
+        });
+        const profileCreated = response.profile_created ?? false;
+        const xProfile = this.#mapXResponseToXProfile(response);
+        this.update((state) => {
+            state.xProfile = xProfile;
+        });
+        let profile;
+        try {
+            const profileResponse = await this.messenger.call('ProfileService:getProfile', params.profileId);
+            profile = this.#mapApiResponseToProfile(profileResponse);
+        }
+        catch (error) {
+            throw new Error('ProfileController: connected the X account, but failed to fetch the profile afterwards; the X link is persisted and the profile fetch can be retried', { cause: error });
+        }
+        this.update((state) => {
+            state.profile = profile;
+        });
+        return { profile, xProfile, profileCreated };
     }
     /**
-     * Fetches the X account linked to the current profile, updates state, and returns the X profile.
+     * Fetches the X account linked to the authenticated profile, updates state,
+     * and returns the X profile. The profile is resolved server-side from the
+     * verified bearer token.
      *
      * @returns The linked X profile.
      */
@@ -237,5 +271,38 @@ export class ProfileController extends BaseController {
         });
         return mapped;
     }
+    /**
+     * Initiates the X OAuth flow by fetching the authorization URL from the backend.
+     * The profile is resolved server-side from the verified bearer token.
+     * Returns session data for the caller to use; nothing is stored in controller state.
+     *
+     * @param params - Optional parameters for initiating the X OAuth flow.
+     * @param params.linkedAddress - Optional CAIP-10 account ID to link to the
+     * profile when it does not exist yet.
+     * @returns The X authorization URL and state parameter.
+     */
+    async startXConnect(params) {
+        const { linkedAddress } = params ?? {};
+        const response = linkedAddress === undefined
+            ? await this.messenger.call('ProfileService:getXAuthUrl')
+            : await this.messenger.call('ProfileService:getXAuthUrl', linkedAddress);
+        return { authorizationUrl: response.url, state: response.state };
+    }
+    /**
+     * Disconnects the X account linked to the given profile, clears xProfile from
+     * state, and marks the profile in state as no longer connected to X.
+     *
+     * @param profileId - The ID of the profile to disconnect the linked X account
+     * from (sourced from {@link getProfile}).
+     */
+    async disconnectX(profileId) {
+        await this.messenger.call('ProfileService:disconnectX', profileId);
+        this.update((state) => {
+            state.xProfile = undefined;
+            if (state.profile.profileId === profileId) {
+                state.profile.connectedToX = false;
+            }
+        });
+    }
 }
 //# sourceMappingURL=ProfileController.js.map

package/dist/ProfileController.js.map

@@ -1 +1 @@
-{"version":3,"file":"ProfileController.js","sourceRoot":"","sources":["../src/ProfileController.ts"],"names":[],"mappings":"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","sourcesContent":["import { BaseController } from '@metamask/base-controller';\nimport type {\n  ControllerGetStateAction,\n  ControllerStateChangeEvent,\n  StateMetadata,\n} from '@metamask/base-controller';\nimport type { Messenger } from '@metamask/messenger';\nimport type { CaipAccountId } from '@metamask/utils';\n\nimport type { ProfileControllerMethodActions } from './ProfileController-method-action-types.js';\nimport type {\n  ProfileServiceCheckUsernameAvailabilityAction,\n  ProfileServiceConnectXAction,\n  ProfileServiceCreateProfileAction,\n  ProfileServiceDeleteProfileAction,\n  ProfileServiceGetXAccountAction,\n  ProfileServiceReplaceProfileAction,\n  ProfileServiceUpdateProfileAction,\n} from './ProfileService-method-action-types.js';\nimport type {\n  CreateProfileParams,\n  CreateProfileResponse,\n  ProfileApiResponse,\n  ReplaceProfileParams,\n  UpdateProfileParams,\n  UsernameAvailabilityResponse,\n  XConnectResponse,\n} from './ProfileService.js';\n\nconst controllerName = 'ProfileController';\n\n// === TYPES ===\n\n/** Representation of a profile stored in controller state. */\nexport type Profile = {\n  /** The canonical profile ID connected to the profile. */\n  profileId: string;\n  /** The username for the profile. */\n  username: string;\n  /** The display name for the profile. */\n  displayName: string;\n  /** The bio for the profile. */\n  bio: string;\n  /** The linked addresses for the profile. */\n  linkedAddresses: CaipAccountId[];\n  /** The avatar URL for the profile. */\n  avatarUrl: string;\n  /** Whether the profile's trading activity is visible to the public. */\n  tradingPrivacy: 'public' | 'private';\n  /** Whether the profile is connected to X. */\n  connectedToX: boolean;\n  /** The date and time the profile was created. */\n  createdAt: string;\n  /** The date and time the profile was updated. */\n  updatedAt: string;\n};\n\n/** Representation of a linked X (Twitter) profile stored in controller state. */\nexport type XProfile = {\n  /** The unique identifier for the X profile. This is the user ID of the X profile. */\n  xUserId: string;\n  /** The URL for the X profile. */\n  xProfileUrl: string;\n  /** The username for the X profile. */\n  username: string;\n  /** The display name for the X profile. */\n  displayName: string;\n  /** The avatar URL for the X profile. */\n  avatarUrl: string;\n  /** The date and time the X profile was created. */\n  createdAt: string;\n  /** The date and time the X profile was updated. */\n  updatedAt: string;\n};\n\n/** State managed by ProfileController. */\nexport type ProfileControllerState = {\n  profile: Profile;\n  xProfile?: XProfile;\n};\n\n// === MESSENGER ===\n\n/** The `ProfileController:getState` action type. */\nexport type ProfileControllerGetStateAction = ControllerGetStateAction<\n  typeof controllerName,\n  ProfileControllerState\n>;\n\n/** Union of all actions exposed by ProfileController. */\nexport type ProfileControllerActions =\n  | ProfileControllerGetStateAction\n  | ProfileControllerMethodActions;\n\n/** The `ProfileController:stateChanged` event type. */\nexport type ProfileControllerChangeEvent = ControllerStateChangeEvent<\n  typeof controllerName,\n  ProfileControllerState\n>;\n\n/** Union of all events emitted by ProfileController. */\nexport type ProfileControllerEvents = ProfileControllerChangeEvent;\n\ntype AllowedActions =\n  | ProfileServiceCreateProfileAction\n  | ProfileServiceReplaceProfileAction\n  | ProfileServiceUpdateProfileAction\n  | ProfileServiceDeleteProfileAction\n  | ProfileServiceCheckUsernameAvailabilityAction\n  | ProfileServiceConnectXAction\n  | ProfileServiceGetXAccountAction;\n\nexport type AllowedEvents = never;\n\n/** Messenger type for ProfileController, scoped to its actions, events, and allowed service calls. */\nexport type ProfileControllerMessenger = Messenger<\n  typeof controllerName,\n  ProfileControllerActions | AllowedActions,\n  ProfileControllerEvents | AllowedEvents\n>;\n\n// === STATE ===\n\nconst profileControllerMetadata = {\n  profile: {\n    includeInStateLogs: true,\n    persist: true,\n    includeInDebugSnapshot: false,\n    usedInUi: true,\n  },\n  xProfile: {\n    includeInStateLogs: false,\n    persist: true,\n    includeInDebugSnapshot: false,\n    usedInUi: true,\n  },\n} satisfies StateMetadata<ProfileControllerState>;\n\n/**\n * Returns the default initial state for ProfileController.\n *\n * @returns A ProfileControllerState with empty profile fields and no X profile.\n */\nexport function getDefaultProfileControllerState(): ProfileControllerState {\n  return {\n    profile: {\n      profileId: '',\n      username: '',\n      displayName: '',\n      bio: '',\n      linkedAddresses: [],\n      avatarUrl: '',\n      tradingPrivacy: 'public',\n      connectedToX: false,\n      createdAt: '',\n      updatedAt: '',\n    },\n  };\n}\n\nconst MESSENGER_EXPOSED_METHODS = [\n  'getProfile',\n  'getXProfile',\n  'createProfile',\n  'replaceProfile',\n  'updateProfile',\n  'deleteProfile',\n  'checkUsernameAvailability',\n  'connectX',\n  'fetchAndUpdateXAccount',\n] as const;\n\n// === CONTROLLER ===\n\n/** Manages MetaMask profile state and delegates API operations to ProfileService. */\nexport class ProfileController extends BaseController<\n  typeof controllerName,\n  ProfileControllerState,\n  ProfileControllerMessenger\n> {\n  /**\n   * Creates a new ProfileController instance.\n   *\n   * @param options - Constructor options.\n   * @param options.messenger - The messenger scoped to ProfileController.\n   * @param options.state - Optional partial initial state to merge with defaults.\n   */\n  constructor({\n    messenger,\n    state,\n  }: {\n    messenger: ProfileControllerMessenger;\n    state?: Partial<ProfileControllerState>;\n  }) {\n    super({\n      messenger,\n      name: controllerName,\n      metadata: profileControllerMetadata,\n      state: {\n        ...getDefaultProfileControllerState(),\n        ...state,\n      },\n    });\n\n    this.messenger.registerMethodActionHandlers(\n      this,\n      MESSENGER_EXPOSED_METHODS,\n    );\n  }\n\n  /**\n   * Returns true if a profile has been created and exists in state.\n   *\n   * @returns True if a profile exists, false otherwise.\n   */\n  #hasProfile(): boolean {\n    return this.state.profile.profileId !== '';\n  }\n\n  /**\n   * Returns the profile ID from state, throwing if no profile exists yet.\n   *\n   * @returns The current profile ID.\n   * @throws If no profile has been created.\n   */\n  #getProfileIdOrThrow(): string {\n    const { profileId } = this.state.profile;\n    if (!profileId) {\n      throw new Error('ProfileController: no profile found in state');\n    }\n    return profileId;\n  }\n\n  /**\n   * Maps an API response to a MetaMask profile.\n   *\n   * @param response - The API response to map.\n   * @returns The mapped MetaMask profile.\n   */\n  #mapApiResponseToProfile(response: ProfileApiResponse): Profile {\n    return {\n      profileId: response.profile_id,\n      username: response.username,\n      displayName: response.display_name,\n      bio: response.bio ?? '',\n      linkedAddresses: response.linked_addresses,\n      avatarUrl: response.avatar_url ?? '',\n      tradingPrivacy: response.trading_privacy,\n      connectedToX: response.connected_to_x,\n      createdAt: response.created_at,\n      updatedAt: response.updated_at,\n    };\n  }\n\n  /**\n   * Maps an API response to an X profile.\n   *\n   * @param response - The API response to map.\n   * @returns The mapped X profile.\n   */\n  #mapXResponseToXProfile(response: XConnectResponse): XProfile {\n    return {\n      xUserId: response.x_user_id,\n      xProfileUrl: response.x_profile_url,\n      username: response.username,\n      displayName: response.display_name,\n      avatarUrl: response.avatar_url,\n      createdAt: response.created_at,\n      updatedAt: response.updated_at,\n    };\n  }\n\n  /**\n   * Returns the current MetaMask profile from state, or undefined if none has been created.\n   *\n   * @returns The MetaMask profile, or undefined.\n   */\n  getProfile(): Profile | undefined {\n    if (!this.#hasProfile()) {\n      return undefined;\n    }\n    return this.state.profile;\n  }\n\n  /**\n   * Returns the currently linked X profile from state, or undefined if none has been connected.\n   *\n   * @returns The X profile, or undefined.\n   */\n  getXProfile(): XProfile | undefined {\n    return this.state.xProfile;\n  }\n\n  /**\n   * Creates a new MetaMask profile, updates state, and returns the created profile.\n   * If the user had previously connected X, also updates xProfile in state.\n   *\n   * @param params - The profile creation parameters.\n   * @returns The created MetaMask profile.\n   */\n  async createProfile(params: CreateProfileParams): Promise<Profile> {\n    const response: CreateProfileResponse = await this.messenger.call(\n      'ProfileService:createProfile',\n      params,\n    );\n    const mapped = this.#mapApiResponseToProfile(response);\n    this.update((state) => {\n      state.profile = mapped;\n      if (response.x_profile) {\n        state.xProfile = this.#mapXResponseToXProfile(response.x_profile);\n      }\n    });\n    return mapped;\n  }\n\n  /**\n   * Fully replaces the current profile and updates state.\n   *\n   * @param input - The replacement profile data.\n   * @throws If no profile has been created yet.\n   */\n  async replaceProfile(input: ReplaceProfileParams): Promise<void> {\n    const profileId = this.#getProfileIdOrThrow();\n    const response = await this.messenger.call(\n      'ProfileService:replaceProfile',\n      profileId,\n      input,\n    );\n    this.update((state) => {\n      state.profile = this.#mapApiResponseToProfile(response);\n    });\n  }\n\n  /**\n   * Partially updates the current profile and updates state.\n   *\n   * @param input - The fields to update.\n   * @throws If no profile has been created yet.\n   */\n  async updateProfile(input: UpdateProfileParams): Promise<void> {\n    const profileId = this.#getProfileIdOrThrow();\n    const response = await this.messenger.call(\n      'ProfileService:updateProfile',\n      profileId,\n      input,\n    );\n    this.update((state) => {\n      state.profile = this.#mapApiResponseToProfile(response);\n    });\n  }\n\n  /**\n   * Deletes the current profile and resets state, including clearing any linked X profile.\n   *\n   * @throws If no profile has been created yet.\n   */\n  async deleteProfile(): Promise<void> {\n    const profileId = this.#getProfileIdOrThrow();\n    await this.messenger.call('ProfileService:deleteProfile', profileId);\n    this.update((state) => {\n      state.profile = getDefaultProfileControllerState().profile;\n      state.xProfile = undefined;\n    });\n  }\n\n  /**\n   * Checks whether a username is available.\n   *\n   * @param username - The username to check.\n   * @returns Availability details including validity and normalized form.\n   */\n  async checkUsernameAvailability(\n    username: string,\n  ): Promise<UsernameAvailabilityResponse> {\n    return await this.messenger.call(\n      'ProfileService:checkUsernameAvailability',\n      username,\n    );\n  }\n\n  /**\n   * Completes the X OAuth PKCE flow, updates xProfile in state, and returns the X profile.\n   *\n   * @param params - The parameters for the X OAuth PKCE flow.\n   * @param params.code - The OAuth authorization code from the X redirect.\n   * @param params.state - The state parameter returned by the X redirect.\n   * @returns The linked X profile.\n   */\n  async connectX(params: { code: string; state: string }): Promise<XProfile> {\n    const response = await this.messenger.call(\n      'ProfileService:connectX',\n      params,\n    );\n    return this.#mapXResponseToXProfile(response);\n  }\n\n  /**\n   * Fetches the X account linked to the current profile, updates state, and returns the X profile.\n   *\n   * @returns The linked X profile.\n   */\n  async fetchAndUpdateXAccount(): Promise<XProfile> {\n    const response = await this.messenger.call('ProfileService:getXAccount');\n    const mapped = this.#mapXResponseToXProfile(response);\n    this.update((state) => {\n      state.xProfile = mapped;\n    });\n    return mapped;\n  }\n}\n"]}
+{"version":3,"file":"ProfileController.js","sourceRoot":"","sources":["../src/ProfileController.ts"],"names":[],"mappings":"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","sourcesContent":["import { BaseController } from '@metamask/base-controller';\nimport type {\n  ControllerGetStateAction,\n  ControllerStateChangeEvent,\n  StateMetadata,\n} from '@metamask/base-controller';\nimport type { Messenger } from '@metamask/messenger';\nimport type { CaipAccountId } from '@metamask/utils';\n\nimport type { ProfileControllerMethodActions } from './ProfileController-method-action-types.js';\nimport type {\n  ProfileServiceCheckUsernameAvailabilityAction,\n  ProfileServiceConnectXAction,\n  ProfileServiceCreateProfileAction,\n  ProfileServiceDeleteProfileAction,\n  ProfileServiceDisconnectXAction,\n  ProfileServiceGetProfileAction,\n  ProfileServiceGetXAccountAction,\n  ProfileServiceGetXAuthUrlAction,\n  ProfileServiceReplaceProfileAction,\n  ProfileServiceUpdateProfileAction,\n} from './ProfileService-method-action-types.js';\nimport type {\n  CreateProfileParams,\n  CreateProfileResponse,\n  ProfileApiResponse,\n  ReplaceProfileParams,\n  UpdateProfileParams,\n  UsernameAvailabilityResponse,\n  XConnectResponse,\n} from './ProfileService.js';\n\nconst controllerName = 'ProfileController';\n\n// === TYPES ===\n\n/** Representation of a profile stored in controller state. */\nexport type Profile = {\n  /** The canonical profile ID connected to the profile. */\n  profileId: string;\n  /** The username for the profile. */\n  username: string;\n  /** The display name for the profile. */\n  displayName: string;\n  /** The bio for the profile. */\n  bio: string;\n  /** The linked addresses for the profile. */\n  linkedAddresses: CaipAccountId[];\n  /** The avatar URL for the profile. */\n  avatarUrl: string;\n  /** Whether the profile's trading activity is visible to the public. */\n  tradingPrivacy: 'public' | 'private';\n  /** Whether the profile is connected to X. */\n  connectedToX: boolean;\n  /** The date and time the profile was created. */\n  createdAt: string;\n  /** The date and time the profile was updated. */\n  updatedAt: string;\n};\n\n/** Representation of a linked X (Twitter) profile stored in controller state. */\nexport type XProfile = {\n  /** The unique identifier for the X profile. This is the user ID of the X profile. */\n  xUserId: string;\n  /** The URL for the X profile. */\n  xProfileUrl: string;\n  /** The username for the X profile. */\n  username: string;\n  /** The display name for the X profile. */\n  displayName: string;\n  /** The avatar URL for the X profile. */\n  avatarUrl: string;\n  /** The date and time the X profile was created. */\n  createdAt: string;\n  /** The date and time the X profile was updated. */\n  updatedAt: string;\n};\n\n/** Ephemeral session data for initiating the X OAuth flow. Not stored in controller state. */\nexport type XConnectSession = {\n  /** The X authorization URL to open in a system browser. */\n  authorizationUrl: string;\n  /** The OAuth state parameter to compare against the X redirect callback. */\n  state: string;\n};\n\n/** Result of completing the X connect flow. */\nexport type XConnectResult = {\n  /** The MetaMask profile, refreshed from the backend after the connect. */\n  profile: Profile;\n  /** The linked X profile. */\n  xProfile: XProfile;\n  /** Whether the backend created the MetaMask profile during the connect. */\n  profileCreated: boolean;\n};\n\n/** State managed by ProfileController. */\nexport type ProfileControllerState = {\n  profile: Profile;\n  xProfile?: XProfile;\n};\n\n// === MESSENGER ===\n\n/** The `ProfileController:getState` action type. */\nexport type ProfileControllerGetStateAction = ControllerGetStateAction<\n  typeof controllerName,\n  ProfileControllerState\n>;\n\n/** Union of all actions exposed by ProfileController. */\nexport type ProfileControllerActions =\n  | ProfileControllerGetStateAction\n  | ProfileControllerMethodActions;\n\n/** The `ProfileController:stateChanged` event type. */\nexport type ProfileControllerChangeEvent = ControllerStateChangeEvent<\n  typeof controllerName,\n  ProfileControllerState\n>;\n\n/** Union of all events emitted by ProfileController. */\nexport type ProfileControllerEvents = ProfileControllerChangeEvent;\n\ntype AllowedActions =\n  | ProfileServiceCreateProfileAction\n  | ProfileServiceReplaceProfileAction\n  | ProfileServiceUpdateProfileAction\n  | ProfileServiceDeleteProfileAction\n  | ProfileServiceCheckUsernameAvailabilityAction\n  | ProfileServiceConnectXAction\n  | ProfileServiceGetProfileAction\n  | ProfileServiceGetXAccountAction\n  | ProfileServiceGetXAuthUrlAction\n  | ProfileServiceDisconnectXAction;\n\nexport type AllowedEvents = never;\n\n/** Messenger type for ProfileController, scoped to its actions, events, and allowed service calls. */\nexport type ProfileControllerMessenger = Messenger<\n  typeof controllerName,\n  ProfileControllerActions | AllowedActions,\n  ProfileControllerEvents | AllowedEvents\n>;\n\n// === STATE ===\n\nconst profileControllerMetadata = {\n  profile: {\n    includeInStateLogs: true,\n    persist: true,\n    includeInDebugSnapshot: false,\n    usedInUi: true,\n  },\n  xProfile: {\n    includeInStateLogs: false,\n    persist: true,\n    includeInDebugSnapshot: false,\n    usedInUi: true,\n  },\n} satisfies StateMetadata<ProfileControllerState>;\n\n/**\n * Returns the default initial state for ProfileController.\n *\n * @returns A ProfileControllerState with empty profile fields and no X profile.\n */\nexport function getDefaultProfileControllerState(): ProfileControllerState {\n  return {\n    profile: {\n      profileId: '',\n      username: '',\n      displayName: '',\n      bio: '',\n      linkedAddresses: [],\n      avatarUrl: '',\n      tradingPrivacy: 'public',\n      connectedToX: false,\n      createdAt: '',\n      updatedAt: '',\n    },\n  };\n}\n\nconst MESSENGER_EXPOSED_METHODS = [\n  'getProfile',\n  'getXProfile',\n  'createProfile',\n  'replaceProfile',\n  'updateProfile',\n  'deleteProfile',\n  'checkUsernameAvailability',\n  'connectX',\n  'fetchAndUpdateXAccount',\n  'startXConnect',\n  'disconnectX',\n] as const;\n\n// === CONTROLLER ===\n\n/** Manages MetaMask profile state and delegates API operations to ProfileService. */\nexport class ProfileController extends BaseController<\n  typeof controllerName,\n  ProfileControllerState,\n  ProfileControllerMessenger\n> {\n  /**\n   * Creates a new ProfileController instance.\n   *\n   * @param options - Constructor options.\n   * @param options.messenger - The messenger scoped to ProfileController.\n   * @param options.state - Optional partial initial state to merge with defaults.\n   */\n  constructor({\n    messenger,\n    state,\n  }: {\n    messenger: ProfileControllerMessenger;\n    state?: Partial<ProfileControllerState>;\n  }) {\n    super({\n      messenger,\n      name: controllerName,\n      metadata: profileControllerMetadata,\n      state: {\n        ...getDefaultProfileControllerState(),\n        ...state,\n      },\n    });\n\n    this.messenger.registerMethodActionHandlers(\n      this,\n      MESSENGER_EXPOSED_METHODS,\n    );\n  }\n\n  /**\n   * Returns true if a profile has been created and exists in state.\n   *\n   * @returns True if a profile exists, false otherwise.\n   */\n  #hasProfile(): boolean {\n    return this.state.profile.profileId !== '';\n  }\n\n  /**\n   * Returns the profile ID from state, throwing if no profile exists yet.\n   *\n   * @returns The current profile ID.\n   * @throws If no profile has been created.\n   */\n  #getProfileIdOrThrow(): string {\n    const { profileId } = this.state.profile;\n    if (!profileId) {\n      throw new Error('ProfileController: no profile found in state');\n    }\n    return profileId;\n  }\n\n  /**\n   * Maps an API response to a MetaMask profile.\n   *\n   * @param response - The API response to map.\n   * @returns The mapped MetaMask profile.\n   */\n  #mapApiResponseToProfile(response: ProfileApiResponse): Profile {\n    return {\n      profileId: response.profile_id,\n      username: response.username,\n      displayName: response.display_name,\n      bio: response.bio ?? '',\n      linkedAddresses: response.linked_addresses,\n      avatarUrl: response.avatar_url ?? '',\n      tradingPrivacy: response.trading_privacy,\n      connectedToX: response.connected_to_x,\n      createdAt: response.created_at,\n      updatedAt: response.updated_at,\n    };\n  }\n\n  /**\n   * Maps an API response to an X profile.\n   *\n   * @param response - The API response to map.\n   * @returns The mapped X profile.\n   */\n  #mapXResponseToXProfile(response: XConnectResponse): XProfile {\n    return {\n      xUserId: response.x_user_id,\n      xProfileUrl: response.x_profile_url,\n      username: response.username,\n      displayName: response.display_name,\n      avatarUrl: response.avatar_url,\n      createdAt: response.created_at,\n      updatedAt: response.updated_at,\n    };\n  }\n\n  /**\n   * Returns the current MetaMask profile from state, or undefined if none has been created.\n   *\n   * @returns The MetaMask profile, or undefined.\n   */\n  getProfile(): Profile | undefined {\n    if (!this.#hasProfile()) {\n      return undefined;\n    }\n    return this.state.profile;\n  }\n\n  /**\n   * Returns the currently linked X profile from state, or undefined if none has been connected.\n   *\n   * @returns The X profile, or undefined.\n   */\n  getXProfile(): XProfile | undefined {\n    return this.state.xProfile;\n  }\n\n  /**\n   * Creates a new MetaMask profile, updates state, and returns the created profile.\n   * If the user had previously connected X, also updates xProfile in state.\n   *\n   * @param params - The profile creation parameters.\n   * @returns The created MetaMask profile.\n   */\n  async createProfile(params: CreateProfileParams): Promise<Profile> {\n    const response: CreateProfileResponse = await this.messenger.call(\n      'ProfileService:createProfile',\n      params,\n    );\n    const mapped = this.#mapApiResponseToProfile(response);\n    this.update((state) => {\n      state.profile = mapped;\n      if (response.x_profile) {\n        state.xProfile = this.#mapXResponseToXProfile(response.x_profile);\n      }\n    });\n    return mapped;\n  }\n\n  /**\n   * Fully replaces the current profile and updates state.\n   *\n   * @param input - The replacement profile data.\n   * @throws If no profile has been created yet.\n   */\n  async replaceProfile(input: ReplaceProfileParams): Promise<void> {\n    const profileId = this.#getProfileIdOrThrow();\n    const response = await this.messenger.call(\n      'ProfileService:replaceProfile',\n      profileId,\n      input,\n    );\n    this.update((state) => {\n      state.profile = this.#mapApiResponseToProfile(response);\n    });\n  }\n\n  /**\n   * Partially updates the current profile and updates state.\n   *\n   * @param input - The fields to update.\n   * @throws If no profile has been created yet.\n   */\n  async updateProfile(input: UpdateProfileParams): Promise<void> {\n    const profileId = this.#getProfileIdOrThrow();\n    const response = await this.messenger.call(\n      'ProfileService:updateProfile',\n      profileId,\n      input,\n    );\n    this.update((state) => {\n      state.profile = this.#mapApiResponseToProfile(response);\n    });\n  }\n\n  /**\n   * Deletes the current profile and resets state, including clearing any linked X profile.\n   *\n   * @throws If no profile has been created yet.\n   */\n  async deleteProfile(): Promise<void> {\n    const profileId = this.#getProfileIdOrThrow();\n    await this.messenger.call('ProfileService:deleteProfile', profileId);\n    this.update((state) => {\n      state.profile = getDefaultProfileControllerState().profile;\n      state.xProfile = undefined;\n    });\n  }\n\n  /**\n   * Checks whether a username is available.\n   *\n   * @param username - The username to check.\n   * @returns Availability details including validity and normalized form.\n   */\n  async checkUsernameAvailability(\n    username: string,\n  ): Promise<UsernameAvailabilityResponse> {\n    return await this.messenger.call(\n      'ProfileService:checkUsernameAvailability',\n      username,\n    );\n  }\n\n  /**\n   * Completes the X OAuth flow, updates xProfile and profile in state, and\n   * returns the connect result. The backend creates the profile if it does\n   * not exist yet (username derived from the X handle), so the profile is\n   * always fetched from the backend after a successful connect.\n   *\n   * The linked X profile is persisted in state immediately after the connect\n   * succeeds. If the follow-up profile fetch fails, the X link remains\n   * persisted and a clear error is thrown — the profile in state may then be\n   * stale until the next successful fetch.\n   *\n   * @param params - The parameters for the X OAuth flow.\n   * @param params.code - The OAuth authorization code from the X redirect.\n   * @param params.state - The state parameter returned by the X redirect.\n   * @param params.profileId - The canonical profile ID the X account is\n   * linked to (sourced from the auth session).\n   * @returns The refreshed profile, the linked X profile, and whether the\n   * backend created the profile during the connect.\n   */\n  async connectX(params: {\n    code: string;\n    state: string;\n    profileId: string;\n  }): Promise<XConnectResult> {\n    const response = await this.messenger.call('ProfileService:connectX', {\n      code: params.code,\n      state: params.state,\n    });\n    const profileCreated = response.profile_created ?? false;\n    const xProfile = this.#mapXResponseToXProfile(response);\n    this.update((state) => {\n      state.xProfile = xProfile;\n    });\n\n    let profile: Profile;\n    try {\n      const profileResponse = await this.messenger.call(\n        'ProfileService:getProfile',\n        params.profileId,\n      );\n      profile = this.#mapApiResponseToProfile(profileResponse);\n    } catch (error) {\n      throw new Error(\n        'ProfileController: connected the X account, but failed to fetch the profile afterwards; the X link is persisted and the profile fetch can be retried',\n        { cause: error },\n      );\n    }\n    this.update((state) => {\n      state.profile = profile;\n    });\n\n    return { profile, xProfile, profileCreated };\n  }\n\n  /**\n   * Fetches the X account linked to the authenticated profile, updates state,\n   * and returns the X profile. The profile is resolved server-side from the\n   * verified bearer token.\n   *\n   * @returns The linked X profile.\n   */\n  async fetchAndUpdateXAccount(): Promise<XProfile> {\n    const response = await this.messenger.call('ProfileService:getXAccount');\n    const mapped = this.#mapXResponseToXProfile(response);\n    this.update((state) => {\n      state.xProfile = mapped;\n    });\n    return mapped;\n  }\n\n  /**\n   * Initiates the X OAuth flow by fetching the authorization URL from the backend.\n   * The profile is resolved server-side from the verified bearer token.\n   * Returns session data for the caller to use; nothing is stored in controller state.\n   *\n   * @param params - Optional parameters for initiating the X OAuth flow.\n   * @param params.linkedAddress - Optional CAIP-10 account ID to link to the\n   * profile when it does not exist yet.\n   * @returns The X authorization URL and state parameter.\n   */\n  async startXConnect(params?: {\n    linkedAddress?: CaipAccountId;\n  }): Promise<XConnectSession> {\n    const { linkedAddress } = params ?? {};\n    const response =\n      linkedAddress === undefined\n        ? await this.messenger.call('ProfileService:getXAuthUrl')\n        : await this.messenger.call(\n            'ProfileService:getXAuthUrl',\n            linkedAddress,\n          );\n    return { authorizationUrl: response.url, state: response.state };\n  }\n\n  /**\n   * Disconnects the X account linked to the given profile, clears xProfile from\n   * state, and marks the profile in state as no longer connected to X.\n   *\n   * @param profileId - The ID of the profile to disconnect the linked X account\n   * from (sourced from {@link getProfile}).\n   */\n  async disconnectX(profileId: string): Promise<void> {\n    await this.messenger.call('ProfileService:disconnectX', profileId);\n    this.update((state) => {\n      state.xProfile = undefined;\n      if (state.profile.profileId === profileId) {\n        state.profile.connectedToX = false;\n      }\n    });\n  }\n}\n"]}

package/dist/ProfileService-method-action-types.d.ts

@@ -78,7 +78,10 @@ export type ProfileServiceCheckUsernameAvailabilityAction = {
 };
 /**
  * Fetches the X OAuth PKCE authorization URL and its associated state parameter.
+ * The profile is resolved server-side from the verified bearer token.
  *
+ * @param linkedAddress - Optional CAIP-10 account ID to link to the profile
+ * when it does not exist yet; sent as the `linked_address` query parameter.
  * @returns An object containing the authorization URL and the state token.
  * @throws {HttpError} If the API returns a non-2xx response.
  * @throws {StructError} If the response does not match the expected shape.
@@ -89,9 +92,12 @@ export type ProfileServiceGetXAuthUrlAction = {
 };
 /**
  * Completes the X OAuth PKCE flow and links the X account to the profile.
+ * The backend creates the profile if it does not exist yet (username derived
+ * from the X handle) and reports that via `profile_created`.
  *
  * @param params - The OAuth callback code and state from the X redirect.
- * @returns The linked X account data.
+ * @returns The linked X account data, plus `profile_created` when the
+ * backend created the profile during the connect.
  * @throws {HttpError} If the API returns a non-2xx response.
  * @throws {StructError} If the response does not match the expected shape.
  */
@@ -101,6 +107,7 @@ export type ProfileServiceConnectXAction = {
 };
 /**
  * Fetches the X account currently linked to the authenticated profile.
+ * The profile is resolved server-side from the verified bearer token.
  *
  * @returns The linked X account data.
  * @throws {HttpError} If the API returns a non-2xx response.
@@ -110,8 +117,21 @@ export type ProfileServiceGetXAccountAction = {
     type: `ProfileService:getXAccount`;
     handler: ProfileService['getXAccount'];
 };
+/**
+ * Disconnects the X account linked to the given profile.
+ * A `404` response is treated as success (the X account is already
+ * disconnected, or the profile is unknown), making the operation idempotent.
+ *
+ * @param profileId - The ID of the profile to disconnect the linked X account from.
+ * @returns The result of the mutation.
+ * @throws {HttpError} If the API returns a non-2xx response other than `404`.
+ */
+export type ProfileServiceDisconnectXAction = {
+    type: `ProfileService:disconnectX`;
+    handler: ProfileService['disconnectX'];
+};
 /**
  * Union of all ProfileService action types.
  */
-export type ProfileServiceMethodActions = ProfileServiceGetProfileAction | ProfileServiceCreateProfileAction | ProfileServiceReplaceProfileAction | ProfileServiceUpdateProfileAction | ProfileServiceDeleteProfileAction | ProfileServiceCheckUsernameAvailabilityAction | ProfileServiceGetXAuthUrlAction | ProfileServiceConnectXAction | ProfileServiceGetXAccountAction;
+export type ProfileServiceMethodActions = ProfileServiceGetProfileAction | ProfileServiceCreateProfileAction | ProfileServiceReplaceProfileAction | ProfileServiceUpdateProfileAction | ProfileServiceDeleteProfileAction | ProfileServiceCheckUsernameAvailabilityAction | ProfileServiceGetXAuthUrlAction | ProfileServiceConnectXAction | ProfileServiceGetXAccountAction | ProfileServiceDisconnectXAction;
 //# sourceMappingURL=ProfileService-method-action-types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"ProfileService-method-action-types.d.ts","sourceRoot":"","sources":["../src/ProfileService-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;;;;;;GAOG;AACH,MAAM,MAAM,8BAA8B,GAAG;IAC3C,IAAI,EAAE,2BAA2B,CAAC;IAClC,OAAO,EAAE,cAAc,CAAC,YAAY,CAAC,CAAC;CACvC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,iCAAiC,GAAG;IAC9C,IAAI,EAAE,8BAA8B,CAAC;IACrC,OAAO,EAAE,cAAc,CAAC,eAAe,CAAC,CAAC;CAC1C,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,kCAAkC,GAAG;IAC/C,IAAI,EAAE,+BAA+B,CAAC;IACtC,OAAO,EAAE,cAAc,CAAC,gBAAgB,CAAC,CAAC;CAC3C,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,iCAAiC,GAAG;IAC9C,IAAI,EAAE,8BAA8B,CAAC;IACrC,OAAO,EAAE,cAAc,CAAC,eAAe,CAAC,CAAC;CAC1C,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,iCAAiC,GAAG;IAC9C,IAAI,EAAE,8BAA8B,CAAC;IACrC,OAAO,EAAE,cAAc,CAAC,eAAe,CAAC,CAAC;CAC1C,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,6CAA6C,GAAG;IAC1D,IAAI,EAAE,0CAA0C,CAAC;IACjD,OAAO,EAAE,cAAc,CAAC,2BAA2B,CAAC,CAAC;CACtD,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,+BAA+B,GAAG;IAC5C,IAAI,EAAE,4BAA4B,CAAC;IACnC,OAAO,EAAE,cAAc,CAAC,aAAa,CAAC,CAAC;CACxC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,4BAA4B,GAAG;IACzC,IAAI,EAAE,yBAAyB,CAAC;IAChC,OAAO,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;CACrC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,+BAA+B,GAAG;IAC5C,IAAI,EAAE,4BAA4B,CAAC;IACnC,OAAO,EAAE,cAAc,CAAC,aAAa,CAAC,CAAC;CACxC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,2BAA2B,GACnC,8BAA8B,GAC9B,iCAAiC,GACjC,kCAAkC,GAClC,iCAAiC,GACjC,iCAAiC,GACjC,6CAA6C,GAC7C,+BAA+B,GAC/B,4BAA4B,GAC5B,+BAA+B,CAAC"}
+{"version":3,"file":"ProfileService-method-action-types.d.ts","sourceRoot":"","sources":["../src/ProfileService-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D;;;;;;;GAOG;AACH,MAAM,MAAM,8BAA8B,GAAG;IAC3C,IAAI,EAAE,2BAA2B,CAAC;IAClC,OAAO,EAAE,cAAc,CAAC,YAAY,CAAC,CAAC;CACvC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,iCAAiC,GAAG;IAC9C,IAAI,EAAE,8BAA8B,CAAC;IACrC,OAAO,EAAE,cAAc,CAAC,eAAe,CAAC,CAAC;CAC1C,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,kCAAkC,GAAG;IAC/C,IAAI,EAAE,+BAA+B,CAAC;IACtC,OAAO,EAAE,cAAc,CAAC,gBAAgB,CAAC,CAAC;CAC3C,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,iCAAiC,GAAG;IAC9C,IAAI,EAAE,8BAA8B,CAAC;IACrC,OAAO,EAAE,cAAc,CAAC,eAAe,CAAC,CAAC;CAC1C,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,MAAM,iCAAiC,GAAG;IAC9C,IAAI,EAAE,8BAA8B,CAAC;IACrC,OAAO,EAAE,cAAc,CAAC,eAAe,CAAC,CAAC;CAC1C,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,6CAA6C,GAAG;IAC1D,IAAI,EAAE,0CAA0C,CAAC;IACjD,OAAO,EAAE,cAAc,CAAC,2BAA2B,CAAC,CAAC;CACtD,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,+BAA+B,GAAG;IAC5C,IAAI,EAAE,4BAA4B,CAAC;IACnC,OAAO,EAAE,cAAc,CAAC,aAAa,CAAC,CAAC;CACxC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,MAAM,4BAA4B,GAAG;IACzC,IAAI,EAAE,yBAAyB,CAAC;IAChC,OAAO,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;CACrC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,MAAM,+BAA+B,GAAG;IAC5C,IAAI,EAAE,4BAA4B,CAAC;IACnC,OAAO,EAAE,cAAc,CAAC,aAAa,CAAC,CAAC;CACxC,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,+BAA+B,GAAG;IAC5C,IAAI,EAAE,4BAA4B,CAAC;IACnC,OAAO,EAAE,cAAc,CAAC,aAAa,CAAC,CAAC;CACxC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,2BAA2B,GACnC,8BAA8B,GAC9B,iCAAiC,GACjC,kCAAkC,GAClC,iCAAiC,GACjC,iCAAiC,GACjC,6CAA6C,GAC7C,+BAA+B,GAC/B,4BAA4B,GAC5B,+BAA+B,GAC/B,+BAA+B,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"ProfileService-method-action-types.js","sourceRoot":"","sources":["../src/ProfileService-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { ProfileService } from './ProfileService.js';\n\n/**\n * Fetches a profile by its identifier.\n *\n * @param profileId - The profile identifier to fetch.\n * @returns The profile data from the API.\n * @throws {HttpError} If the API returns a non-2xx response.\n * @throws {StructError} If the response does not match the expected shape.\n */\nexport type ProfileServiceGetProfileAction = {\n  type: `ProfileService:getProfile`;\n  handler: ProfileService['getProfile'];\n};\n\n/**\n * Creates a new MetaMask profile.\n *\n * @param params - The profile creation parameters.\n * @returns The created profile data.\n * @throws {HttpError} If the API returns a non-2xx response.\n * @throws {StructError} If the response do not match the expected shape.\n */\nexport type ProfileServiceCreateProfileAction = {\n  type: `ProfileService:createProfile`;\n  handler: ProfileService['createProfile'];\n};\n\n/**\n * Fully replaces an existing profile (PUT).\n *\n * @param profileId - The identifier of the profile to replace.\n * @param params - The replacement profile data.\n * @returns The updated profile data.\n * @throws {HttpError} If the API returns a non-2xx response.\n * @throws {StructError} If the response do not match the expected shape.\n */\nexport type ProfileServiceReplaceProfileAction = {\n  type: `ProfileService:replaceProfile`;\n  handler: ProfileService['replaceProfile'];\n};\n\n/**\n * Partially updates an existing profile (PATCH).\n *\n * @param profileId - The identifier of the profile to update.\n * @param params - The fields to update.\n * @returns The updated profile data.\n * @throws {HttpError} If the API returns a non-2xx response.\n * @throws {StructError} If the response do not match the expected shape.\n */\nexport type ProfileServiceUpdateProfileAction = {\n  type: `ProfileService:updateProfile`;\n  handler: ProfileService['updateProfile'];\n};\n\n/**\n * Deletes a profile by its identifier.\n *\n * @param profileId - The identifier of the profile to delete.\n * @returns The result of the mutation.\n * @throws {HttpError} If the API returns a non-2xx response.\n */\nexport type ProfileServiceDeleteProfileAction = {\n  type: `ProfileService:deleteProfile`;\n  handler: ProfileService['deleteProfile'];\n};\n\n/**\n * Checks whether a username is available.\n *\n * @param username - The username to check.\n * @returns Availability details including validity and normalized form.\n * @throws {HttpError} If the API returns a non-2xx response.\n * @throws {StructError} If the response does not match the expected shape.\n */\nexport type ProfileServiceCheckUsernameAvailabilityAction = {\n  type: `ProfileService:checkUsernameAvailability`;\n  handler: ProfileService['checkUsernameAvailability'];\n};\n\n/**\n * Fetches the X OAuth PKCE authorization URL and its associated state parameter.\n *\n * @returns An object containing the authorization URL and the state token.\n * @throws {HttpError} If the API returns a non-2xx response.\n * @throws {StructError} If the response does not match the expected shape.\n */\nexport type ProfileServiceGetXAuthUrlAction = {\n  type: `ProfileService:getXAuthUrl`;\n  handler: ProfileService['getXAuthUrl'];\n};\n\n/**\n * Completes the X OAuth PKCE flow and links the X account to the profile.\n *\n * @param params - The OAuth callback code and state from the X redirect.\n * @returns The linked X account data.\n * @throws {HttpError} If the API returns a non-2xx response.\n * @throws {StructError} If the response does not match the expected shape.\n */\nexport type ProfileServiceConnectXAction = {\n  type: `ProfileService:connectX`;\n  handler: ProfileService['connectX'];\n};\n\n/**\n * Fetches the X account currently linked to the authenticated profile.\n *\n * @returns The linked X account data.\n * @throws {HttpError} If the API returns a non-2xx response.\n * @throws {StructError} If the response does not match the expected shape.\n */\nexport type ProfileServiceGetXAccountAction = {\n  type: `ProfileService:getXAccount`;\n  handler: ProfileService['getXAccount'];\n};\n\n/**\n * Union of all ProfileService action types.\n */\nexport type ProfileServiceMethodActions =\n  | ProfileServiceGetProfileAction\n  | ProfileServiceCreateProfileAction\n  | ProfileServiceReplaceProfileAction\n  | ProfileServiceUpdateProfileAction\n  | ProfileServiceDeleteProfileAction\n  | ProfileServiceCheckUsernameAvailabilityAction\n  | ProfileServiceGetXAuthUrlAction\n  | ProfileServiceConnectXAction\n  | ProfileServiceGetXAccountAction;\n"]}
+{"version":3,"file":"ProfileService-method-action-types.js","sourceRoot":"","sources":["../src/ProfileService-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { ProfileService } from './ProfileService.js';\n\n/**\n * Fetches a profile by its identifier.\n *\n * @param profileId - The profile identifier to fetch.\n * @returns The profile data from the API.\n * @throws {HttpError} If the API returns a non-2xx response.\n * @throws {StructError} If the response does not match the expected shape.\n */\nexport type ProfileServiceGetProfileAction = {\n  type: `ProfileService:getProfile`;\n  handler: ProfileService['getProfile'];\n};\n\n/**\n * Creates a new MetaMask profile.\n *\n * @param params - The profile creation parameters.\n * @returns The created profile data.\n * @throws {HttpError} If the API returns a non-2xx response.\n * @throws {StructError} If the response do not match the expected shape.\n */\nexport type ProfileServiceCreateProfileAction = {\n  type: `ProfileService:createProfile`;\n  handler: ProfileService['createProfile'];\n};\n\n/**\n * Fully replaces an existing profile (PUT).\n *\n * @param profileId - The identifier of the profile to replace.\n * @param params - The replacement profile data.\n * @returns The updated profile data.\n * @throws {HttpError} If the API returns a non-2xx response.\n * @throws {StructError} If the response do not match the expected shape.\n */\nexport type ProfileServiceReplaceProfileAction = {\n  type: `ProfileService:replaceProfile`;\n  handler: ProfileService['replaceProfile'];\n};\n\n/**\n * Partially updates an existing profile (PATCH).\n *\n * @param profileId - The identifier of the profile to update.\n * @param params - The fields to update.\n * @returns The updated profile data.\n * @throws {HttpError} If the API returns a non-2xx response.\n * @throws {StructError} If the response do not match the expected shape.\n */\nexport type ProfileServiceUpdateProfileAction = {\n  type: `ProfileService:updateProfile`;\n  handler: ProfileService['updateProfile'];\n};\n\n/**\n * Deletes a profile by its identifier.\n *\n * @param profileId - The identifier of the profile to delete.\n * @returns The result of the mutation.\n * @throws {HttpError} If the API returns a non-2xx response.\n */\nexport type ProfileServiceDeleteProfileAction = {\n  type: `ProfileService:deleteProfile`;\n  handler: ProfileService['deleteProfile'];\n};\n\n/**\n * Checks whether a username is available.\n *\n * @param username - The username to check.\n * @returns Availability details including validity and normalized form.\n * @throws {HttpError} If the API returns a non-2xx response.\n * @throws {StructError} If the response does not match the expected shape.\n */\nexport type ProfileServiceCheckUsernameAvailabilityAction = {\n  type: `ProfileService:checkUsernameAvailability`;\n  handler: ProfileService['checkUsernameAvailability'];\n};\n\n/**\n * Fetches the X OAuth PKCE authorization URL and its associated state parameter.\n * The profile is resolved server-side from the verified bearer token.\n *\n * @param linkedAddress - Optional CAIP-10 account ID to link to the profile\n * when it does not exist yet; sent as the `linked_address` query parameter.\n * @returns An object containing the authorization URL and the state token.\n * @throws {HttpError} If the API returns a non-2xx response.\n * @throws {StructError} If the response does not match the expected shape.\n */\nexport type ProfileServiceGetXAuthUrlAction = {\n  type: `ProfileService:getXAuthUrl`;\n  handler: ProfileService['getXAuthUrl'];\n};\n\n/**\n * Completes the X OAuth PKCE flow and links the X account to the profile.\n * The backend creates the profile if it does not exist yet (username derived\n * from the X handle) and reports that via `profile_created`.\n *\n * @param params - The OAuth callback code and state from the X redirect.\n * @returns The linked X account data, plus `profile_created` when the\n * backend created the profile during the connect.\n * @throws {HttpError} If the API returns a non-2xx response.\n * @throws {StructError} If the response does not match the expected shape.\n */\nexport type ProfileServiceConnectXAction = {\n  type: `ProfileService:connectX`;\n  handler: ProfileService['connectX'];\n};\n\n/**\n * Fetches the X account currently linked to the authenticated profile.\n * The profile is resolved server-side from the verified bearer token.\n *\n * @returns The linked X account data.\n * @throws {HttpError} If the API returns a non-2xx response.\n * @throws {StructError} If the response does not match the expected shape.\n */\nexport type ProfileServiceGetXAccountAction = {\n  type: `ProfileService:getXAccount`;\n  handler: ProfileService['getXAccount'];\n};\n\n/**\n * Disconnects the X account linked to the given profile.\n * A `404` response is treated as success (the X account is already\n * disconnected, or the profile is unknown), making the operation idempotent.\n *\n * @param profileId - The ID of the profile to disconnect the linked X account from.\n * @returns The result of the mutation.\n * @throws {HttpError} If the API returns a non-2xx response other than `404`.\n */\nexport type ProfileServiceDisconnectXAction = {\n  type: `ProfileService:disconnectX`;\n  handler: ProfileService['disconnectX'];\n};\n\n/**\n * Union of all ProfileService action types.\n */\nexport type ProfileServiceMethodActions =\n  | ProfileServiceGetProfileAction\n  | ProfileServiceCreateProfileAction\n  | ProfileServiceReplaceProfileAction\n  | ProfileServiceUpdateProfileAction\n  | ProfileServiceDeleteProfileAction\n  | ProfileServiceCheckUsernameAvailabilityAction\n  | ProfileServiceGetXAuthUrlAction\n  | ProfileServiceConnectXAction\n  | ProfileServiceGetXAccountAction\n  | ProfileServiceDisconnectXAction;\n"]}

package/dist/ProfileService.d.ts

@@ -3,6 +3,7 @@ import type { CreateServicePolicyOptions, DataServiceCacheUpdatedEvent, DataServ
 import type { Messenger } from '@metamask/messenger';
 import type { AuthenticationController } from '@metamask/profile-sync-controller';
 import type { Infer } from '@metamask/superstruct';
+import type { CaipAccountId } from '@metamask/utils';
 import type { ProfileServiceMethodActions } from './ProfileService-method-action-types.js';
 export declare const serviceName = "ProfileService";
 /** Human-readable error messages for each ProfileService operation. */
@@ -16,6 +17,7 @@ export declare const ProfileServiceErrorMessage: {
     readonly GET_X_AUTH_URL_FAILED: 'ProfileService: failed to get X authentication URL';
     readonly CONNECT_X_FAILED: 'ProfileService: failed to connect X account';
     readonly GET_X_ACCOUNT_FAILED: 'ProfileService: failed to get X account';
+    readonly DISCONNECT_X_FAILED: 'ProfileService: failed to disconnect X account';
 };
 declare const ProfileApiResponseStruct: import("@metamask/superstruct").Struct<{
     profile_id: string;
@@ -92,6 +94,23 @@ declare const XConnectResponseStruct: import("@metamask/superstruct").Struct<{
     created_at: import("@metamask/superstruct").Struct<string, null>;
     updated_at: import("@metamask/superstruct").Struct<string, null>;
 }>;
+/**
+ * Response shape for POST /v1/profiles/x/connect: the linked X account plus
+ * `profile_created`, indicating whether the backend created the MetaMask
+ * profile during the connect. Optional so older backends that do not send
+ * the field still validate.
+ */
+declare const ConnectXResponseStruct: import("@metamask/superstruct").Struct<{
+    x_user_id: string;
+    x_profile_url: string;
+    username: string;
+    display_name: string;
+    avatar_url: string;
+    created_at: string;
+    updated_at: string;
+} & {
+    profile_created?: boolean | undefined;
+}, null>;
 declare const CreateProfileResponseStruct: import("@metamask/superstruct").Struct<{
     profile_id: string;
     username: string;
@@ -185,6 +204,8 @@ export type CreateProfileResponse = Infer<typeof CreateProfileResponseStruct>;
 export type UsernameAvailabilityResponse = Infer<typeof UsernameAvailabilityResponseStruct>;
 /** The response shape returned when connecting or fetching an X account. */
 export type XConnectResponse = Infer<typeof XConnectResponseStruct>;
+/** The response shape returned when completing the X connect flow. */
+export type ConnectXResponse = Infer<typeof ConnectXResponseStruct>;
 /** The response shape returned when requesting the X OAuth authentication URL. */
 export type XAuthUrlResponse = Infer<typeof XAuthUrlResponseStruct>;
 /** Alias for {@link XConnectResponse} returned when fetching the linked X account. */
@@ -282,29 +303,46 @@ export declare class ProfileService extends BaseDataService<typeof serviceName,
     checkUsernameAvailability(username: string): Promise<UsernameAvailabilityResponse>;
     /**
      * Fetches the X OAuth PKCE authorization URL and its associated state parameter.
+     * The profile is resolved server-side from the verified bearer token.
      *
+     * @param linkedAddress - Optional CAIP-10 account ID to link to the profile
+     * when it does not exist yet; sent as the `linked_address` query parameter.
      * @returns An object containing the authorization URL and the state token.
      * @throws {HttpError} If the API returns a non-2xx response.
      * @throws {StructError} If the response does not match the expected shape.
      */
-    getXAuthUrl(): Promise<XAuthUrlResponse>;
+    getXAuthUrl(linkedAddress?: CaipAccountId): Promise<XAuthUrlResponse>;
     /**
      * Completes the X OAuth PKCE flow and links the X account to the profile.
+     * The backend creates the profile if it does not exist yet (username derived
+     * from the X handle) and reports that via `profile_created`.
      *
      * @param params - The OAuth callback code and state from the X redirect.
-     * @returns The linked X account data.
+     * @returns The linked X account data, plus `profile_created` when the
+     * backend created the profile during the connect.
      * @throws {HttpError} If the API returns a non-2xx response.
      * @throws {StructError} If the response does not match the expected shape.
      */
-    connectX(params: ConnectXParams): Promise<XConnectResponse>;
+    connectX(params: ConnectXParams): Promise<ConnectXResponse>;
     /**
      * Fetches the X account currently linked to the authenticated profile.
+     * The profile is resolved server-side from the verified bearer token.
      *
      * @returns The linked X account data.
      * @throws {HttpError} If the API returns a non-2xx response.
      * @throws {StructError} If the response does not match the expected shape.
      */
     getXAccount(): Promise<XAccountResponse>;
+    /**
+     * Disconnects the X account linked to the given profile.
+     * A `404` response is treated as success (the X account is already
+     * disconnected, or the profile is unknown), making the operation idempotent.
+     *
+     * @param profileId - The ID of the profile to disconnect the linked X account from.
+     * @returns The result of the mutation.
+     * @throws {HttpError} If the API returns a non-2xx response other than `404`.
+     */
+    disconnectX(profileId: string): Promise<void>;
 }
 export {};
 //# sourceMappingURL=ProfileService.d.ts.map

package/dist/ProfileService.d.ts.map

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

package/dist/ProfileService.js

@@ -17,6 +17,7 @@ export const ProfileServiceErrorMessage = {
     GET_X_AUTH_URL_FAILED: 'ProfileService: failed to get X authentication URL',
     CONNECT_X_FAILED: 'ProfileService: failed to connect X account',
     GET_X_ACCOUNT_FAILED: 'ProfileService: failed to get X account',
+    DISCONNECT_X_FAILED: 'ProfileService: failed to disconnect X account',
 };
 // ---------------------------------------------------------------------------
 // Superstruct schemas
@@ -58,6 +59,16 @@ const XConnectResponseStruct = structType({
     created_at: string(),
     updated_at: string(),
 });
+/**
+ * Response shape for POST /v1/profiles/x/connect: the linked X account plus
+ * `profile_created`, indicating whether the backend created the MetaMask
+ * profile during the connect. Optional so older backends that do not send
+ * the field still validate.
+ */
+const ConnectXResponseStruct = intersection([
+    XConnectResponseStruct,
+    structType({ profile_created: optional(boolean()) }),
+]);
 const CreateProfileResponseStruct = intersection([
     ProfileApiResponseStruct,
     structType({ x_profile: optional(XConnectResponseStruct) }),
@@ -104,6 +115,7 @@ const MESSENGER_EXPOSED_METHODS = [
     'getXAuthUrl',
     'connectX',
     'getXAccount',
+    'disconnectX',
 ];
 // ---------------------------------------------------------------------------
 // Service
@@ -273,32 +285,41 @@ export class ProfileService extends BaseDataService {
     }
     /**
      * Fetches the X OAuth PKCE authorization URL and its associated state parameter.
+     * The profile is resolved server-side from the verified bearer token.
      *
+     * @param linkedAddress - Optional CAIP-10 account ID to link to the profile
+     * when it does not exist yet; sent as the `linked_address` query parameter.
      * @returns An object containing the authorization URL and the state token.
      * @throws {HttpError} If the API returns a non-2xx response.
      * @throws {StructError} If the response does not match the expected shape.
      */
-    async getXAuthUrl() {
+    async getXAuthUrl(linkedAddress) {
         return this.executeMutation({
             mutationKey: [`${this.name}:getXAuthUrl`],
             responseStruct: XAuthUrlResponseStruct,
             mutationFn: async () => this.#fetch('profiles/x/authentication-url', {
                 error: ProfileServiceErrorMessage.GET_X_AUTH_URL_FAILED,
+                ...(linkedAddress === undefined
+                    ? {}
+                    : { searchParams: { linked_address: linkedAddress } }),
             }),
         });
     }
     /**
      * Completes the X OAuth PKCE flow and links the X account to the profile.
+     * The backend creates the profile if it does not exist yet (username derived
+     * from the X handle) and reports that via `profile_created`.
      *
      * @param params - The OAuth callback code and state from the X redirect.
-     * @returns The linked X account data.
+     * @returns The linked X account data, plus `profile_created` when the
+     * backend created the profile during the connect.
      * @throws {HttpError} If the API returns a non-2xx response.
      * @throws {StructError} If the response does not match the expected shape.
      */
     async connectX(params) {
         return this.executeMutation({
             mutationKey: [`${this.name}:connectX`],
-            responseStruct: XConnectResponseStruct,
+            responseStruct: ConnectXResponseStruct,
             mutationFn: async () => this.#fetch('profiles/x/connect', {
                 method: 'POST',
                 error: ProfileServiceErrorMessage.CONNECT_X_FAILED,
@@ -308,6 +329,7 @@ export class ProfileService extends BaseDataService {
     }
     /**
      * Fetches the X account currently linked to the authenticated profile.
+     * The profile is resolved server-side from the verified bearer token.
      *
      * @returns The linked X account data.
      * @throws {HttpError} If the API returns a non-2xx response.
@@ -323,5 +345,33 @@ export class ProfileService extends BaseDataService {
             }),
         });
     }
+    /**
+     * Disconnects the X account linked to the given profile.
+     * A `404` response is treated as success (the X account is already
+     * disconnected, or the profile is unknown), making the operation idempotent.
+     *
+     * @param profileId - The ID of the profile to disconnect the linked X account from.
+     * @returns The result of the mutation.
+     * @throws {HttpError} If the API returns a non-2xx response other than `404`.
+     */
+    async disconnectX(profileId) {
+        return this.executeMutation({
+            mutationKey: [`${this.name}:disconnectX`, profileId],
+            mutationFn: async () => {
+                try {
+                    return await this.#fetch(`profiles/${encodeURIComponent(profileId)}/x`, {
+                        method: 'DELETE',
+                        error: ProfileServiceErrorMessage.DISCONNECT_X_FAILED,
+                    });
+                }
+                catch (error) {
+                    if (error instanceof HttpError && error.httpStatus === 404) {
+                        return null;
+                    }
+                    throw error;
+                }
+            },
+        });
+    }
 }
 //# sourceMappingURL=ProfileService.js.map

package/dist/ProfileService.js.map

@@ -1 +1 @@
-{"version":3,"file":"ProfileService.js","sourceRoot":"","sources":["../src/ProfileService.ts"],"names":[],"mappings":"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","sourcesContent":["import { BaseDataService } from '@metamask/base-data-service';\nimport type {\n  CreateServicePolicyOptions,\n  DataServiceCacheUpdatedEvent,\n  DataServiceGranularCacheUpdatedEvent,\n  DataServiceInvalidateQueriesAction,\n} from '@metamask/base-data-service';\nimport { HttpError } from '@metamask/controller-utils';\nimport type { Messenger } from '@metamask/messenger';\nimport type { AuthenticationController } from '@metamask/profile-sync-controller';\nimport {\n  array,\n  boolean,\n  enums,\n  intersection,\n  nullable,\n  optional,\n  sensitive,\n  string,\n  type as structType,\n} from '@metamask/superstruct';\nimport type { Infer } from '@metamask/superstruct';\nimport type { Json } from '@metamask/utils';\nimport { CaipAccountIdStruct } from '@metamask/utils';\n\nimport type { ProfileServiceMethodActions } from './ProfileService-method-action-types.js';\n\nexport const serviceName = 'ProfileService';\n\n// ---------------------------------------------------------------------------\n// Error messages\n// ---------------------------------------------------------------------------\n\n/** Human-readable error messages for each ProfileService operation. */\nexport const ProfileServiceErrorMessage = {\n  GET_PROFILE_FAILED: 'ProfileService: failed to fetch profile',\n  CREATE_PROFILE_FAILED: 'ProfileService: failed to create profile',\n  REPLACE_PROFILE_FAILED: 'ProfileService: failed to replace profile',\n  UPDATE_PROFILE_FAILED: 'ProfileService: failed to update profile',\n  DELETE_PROFILE_FAILED: 'ProfileService: failed to delete profile',\n  CHECK_USERNAME_AVAILABILITY_FAILED:\n    'ProfileService: failed to check username availability',\n  GET_X_AUTH_URL_FAILED: 'ProfileService: failed to get X authentication URL',\n  CONNECT_X_FAILED: 'ProfileService: failed to connect X account',\n  GET_X_ACCOUNT_FAILED: 'ProfileService: failed to get X account',\n} as const;\n\n// ---------------------------------------------------------------------------\n// Superstruct schemas\n// ---------------------------------------------------------------------------\n\nconst TradingPrivacyStruct = enums(['public', 'private'] as const);\n\nconst ProfileApiResponseStruct = structType({\n  profile_id: string(),\n  username: string(),\n  display_name: string(),\n  bio: nullable(string()),\n  linked_addresses: array(CaipAccountIdStruct),\n  avatar_url: nullable(string()),\n  trading_privacy: TradingPrivacyStruct,\n  connected_to_x: boolean(),\n  created_at: string(),\n  updated_at: string(),\n});\n\nconst UsernameAvailabilityErrorStruct = structType({\n  code: string(),\n  message: string(),\n});\n\nconst UsernameAvailabilityResponseStruct = structType({\n  username: string(),\n  available: boolean(),\n  valid: boolean(),\n  normalized: string(),\n  errors: array(UsernameAvailabilityErrorStruct),\n});\n\nconst XAuthUrlResponseStruct = structType({\n  url: sensitive(string()),\n  state: sensitive(string()),\n});\n\nconst XConnectResponseStruct = structType({\n  x_user_id: string(),\n  x_profile_url: string(),\n  username: string(),\n  display_name: string(),\n  avatar_url: string(),\n  created_at: string(),\n  updated_at: string(),\n});\n\nconst CreateProfileResponseStruct = intersection([\n  ProfileApiResponseStruct,\n  structType({ x_profile: optional(XConnectResponseStruct) }),\n]);\n\nconst ConnectXParamsStruct = structType({\n  code: sensitive(string()),\n  state: sensitive(string()),\n});\n\nconst CreateProfileParamsStruct = structType({\n  profile_id: string(),\n  username: string(),\n  display_name: string(),\n  bio: optional(nullable(string())),\n  linked_addresses: array(CaipAccountIdStruct),\n  avatar_url: optional(string()),\n  trading_privacy: TradingPrivacyStruct,\n});\n\nconst ReplaceProfileParamsStruct = structType({\n  username: string(),\n  display_name: string(),\n  bio: optional(nullable(string())),\n  linked_addresses: array(CaipAccountIdStruct),\n  avatar_url: optional(string()),\n  trading_privacy: TradingPrivacyStruct,\n});\n\nconst UpdateProfileParamsStruct = structType({\n  username: optional(string()),\n  display_name: optional(string()),\n  bio: optional(nullable(string())),\n  linked_addresses: optional(array(CaipAccountIdStruct)),\n  avatar_url: optional(string()),\n  trading_privacy: optional(TradingPrivacyStruct),\n});\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nconst MESSENGER_EXPOSED_METHODS = [\n  'getProfile',\n  'createProfile',\n  'replaceProfile',\n  'updateProfile',\n  'deleteProfile',\n  'checkUsernameAvailability',\n  'getXAuthUrl',\n  'connectX',\n  'getXAccount',\n] as const;\n\n/** The shape of a profile returned by the MetaMask Profile API. */\nexport type ProfileApiResponse = Infer<typeof ProfileApiResponseStruct>;\n\n/** The response shape for createProfile — includes an optional linked X profile if the user had already connected X. */\nexport type CreateProfileResponse = Infer<typeof CreateProfileResponseStruct>;\n\n/** The response shape for a username availability check. */\nexport type UsernameAvailabilityResponse = Infer<\n  typeof UsernameAvailabilityResponseStruct\n>;\n\n/** The response shape returned when connecting or fetching an X account. */\nexport type XConnectResponse = Infer<typeof XConnectResponseStruct>;\n\n/** The response shape returned when requesting the X OAuth authentication URL. */\nexport type XAuthUrlResponse = Infer<typeof XAuthUrlResponseStruct>;\n\n/** Alias for {@link XConnectResponse} returned when fetching the linked X account. */\nexport type XAccountResponse = XConnectResponse;\n\n/** Parameters for creating a new MetaMask profile. */\nexport type CreateProfileParams = Infer<typeof CreateProfileParamsStruct>;\n\n/** Parameters for fully replacing an existing MetaMask profile (PUT). */\nexport type ReplaceProfileParams = Infer<typeof ReplaceProfileParamsStruct>;\n\n/** Parameters for partially updating an existing MetaMask profile (PATCH). */\nexport type UpdateProfileParams = Infer<typeof UpdateProfileParamsStruct>;\n\n/** Parameters for completing the X OAuth PKCE flow. */\nexport type ConnectXParams = Infer<typeof ConnectXParamsStruct>;\n\n// ---------------------------------------------------------------------------\n// Messenger types\n// ---------------------------------------------------------------------------\n\n/** Union of all actions exposed by ProfileService, including cache invalidation. */\nexport type ProfileServiceActions =\n  | ProfileServiceMethodActions\n  | DataServiceInvalidateQueriesAction<typeof serviceName>;\n\n/** Event emitted when the ProfileService query cache is updated. */\nexport type ProfileServiceCacheUpdatedEvent = DataServiceCacheUpdatedEvent<\n  typeof serviceName\n>;\n\n/** Event emitted with per-query granularity when the ProfileService cache is updated. */\nexport type ProfileServiceGranularCacheUpdatedEvent =\n  DataServiceGranularCacheUpdatedEvent<typeof serviceName>;\n\n/** Union of all events emitted by ProfileService. */\nexport type ProfileServiceEvents =\n  | ProfileServiceCacheUpdatedEvent\n  | ProfileServiceGranularCacheUpdatedEvent;\n\ntype AllowedActions =\n  AuthenticationController.AuthenticationControllerGetBearerTokenAction;\n\ntype AllowedEvents = never;\n\n/** Messenger type for ProfileService, scoped to its actions and events. */\nexport type ProfileServiceMessenger = Messenger<\n  typeof serviceName,\n  ProfileServiceActions | AllowedActions,\n  ProfileServiceEvents | AllowedEvents\n>;\n\n// ---------------------------------------------------------------------------\n// Service\n// ---------------------------------------------------------------------------\n\n/** Communicates with the MetaMask Profile API and exposes all operations via the messenger. */\nexport class ProfileService extends BaseDataService<\n  typeof serviceName,\n  ProfileServiceMessenger\n> {\n  readonly #baseUrl: string;\n\n  get #v1Url(): string {\n    return `${this.#baseUrl}/v1`;\n  }\n\n  /**\n   * Creates a new ProfileService instance.\n   *\n   * @param options - Constructor options.\n   * @param options.messenger - The messenger scoped to ProfileService.\n   * @param options.baseUrl - Base URL for the MetaMask Profile API.\n   * @param options.policyOptions - Optional service policy configuration.\n   */\n  constructor({\n    messenger,\n    baseUrl,\n    policyOptions,\n  }: {\n    messenger: ProfileServiceMessenger;\n    baseUrl: string;\n    policyOptions?: CreateServicePolicyOptions;\n  }) {\n    super({ name: serviceName, messenger, policyOptions });\n    this.#baseUrl = baseUrl;\n\n    this.messenger.registerMethodActionHandlers(\n      this,\n      MESSENGER_EXPOSED_METHODS,\n    );\n  }\n\n  /**\n   * Gets the authentication headers for the request.\n   *\n   * @returns The authentication headers.\n   */\n  async #getAuthHeaders(): Promise<Record<string, string>> {\n    const token = await this.messenger.call(\n      'AuthenticationController:getBearerToken',\n    );\n    return { Authorization: `Bearer ${token}` };\n  }\n\n  /**\n   * Executes an authenticated HTTP request and returns the parsed JSON response.\n   *\n   * @param endpoint - The path relative to the v1 base URL.\n   * @param options - Request options.\n   * @param options.method - The HTTP method. Defaults to 'GET'.\n   * @param options.error - The error message to use if the response is not OK.\n   * @param options.json - Optional JSON body. If provided, sets Content-Type and serializes as body.\n   * @returns The parsed JSON response.\n   * @throws {HttpError} If the response is not a 2xx status code.\n   */\n  async #fetch(\n    endpoint: string,\n    options: { method: 'DELETE'; error: string },\n  ): Promise<null>;\n\n  async #fetch<ResponseType extends Json>(\n    endpoint: string,\n    options: {\n      method?: string;\n      error: string;\n      json?: unknown;\n      searchParams?: Record<string, string>;\n    },\n  ): Promise<ResponseType>;\n\n  async #fetch<ResponseType extends Json>(\n    endpoint: string,\n    {\n      method = 'GET',\n      error,\n      json,\n      searchParams,\n    }: {\n      method?: string;\n      error: string;\n      json?: unknown;\n      searchParams?: Record<string, string>;\n    },\n  ): Promise<ResponseType | null> {\n    const authHeaders = await this.#getAuthHeaders();\n    const url = new URL(`${this.#v1Url}/${endpoint}`);\n    if (searchParams) {\n      for (const [key, value] of Object.entries(searchParams)) {\n        url.searchParams.append(key, value);\n      }\n    }\n    const response = await fetch(url.toString(), {\n      ...(method === 'GET' ? {} : { method }),\n      headers: {\n        ...authHeaders,\n        ...(json === undefined ? {} : { 'Content-Type': 'application/json' }),\n      },\n      ...(json === undefined ? {} : { body: JSON.stringify(json) }),\n    });\n    if (!response.ok) {\n      throw new HttpError(response.status, `${error}: ${response.status}`);\n    }\n    if (method === 'DELETE') {\n      return null;\n    }\n    return (await response.json()) as ResponseType;\n  }\n\n  /**\n   * Fetches a profile by its identifier.\n   *\n   * @param profileId - The profile identifier to fetch.\n   * @returns The profile data from the API.\n   * @throws {HttpError} If the API returns a non-2xx response.\n   * @throws {StructError} If the response does not match the expected shape.\n   */\n  async getProfile(profileId: string): Promise<ProfileApiResponse> {\n    return this.fetchQuery({\n      queryKey: [`${this.name}:getProfile`, profileId],\n      responseStruct: ProfileApiResponseStruct,\n      queryFn: async () =>\n        this.#fetch<ProfileApiResponse>(\n          `profiles/${encodeURIComponent(profileId)}`,\n          {\n            error: ProfileServiceErrorMessage.GET_PROFILE_FAILED,\n          },\n        ),\n    });\n  }\n\n  /**\n   * Creates a new MetaMask profile.\n   *\n   * @param params - The profile creation parameters.\n   * @returns The created profile data.\n   * @throws {HttpError} If the API returns a non-2xx response.\n   * @throws {StructError} If the response do not match the expected shape.\n   */\n  async createProfile(\n    params: CreateProfileParams,\n  ): Promise<CreateProfileResponse> {\n    return this.executeMutation({\n      mutationKey: [`${this.name}:createProfile`],\n      responseStruct: CreateProfileResponseStruct,\n      mutationFn: async () =>\n        this.#fetch<CreateProfileResponse>('profiles', {\n          method: 'POST',\n          error: ProfileServiceErrorMessage.CREATE_PROFILE_FAILED,\n          json: params,\n        }),\n    });\n  }\n\n  /**\n   * Fully replaces an existing profile (PUT).\n   *\n   * @param profileId - The identifier of the profile to replace.\n   * @param params - The replacement profile data.\n   * @returns The updated profile data.\n   * @throws {HttpError} If the API returns a non-2xx response.\n   * @throws {StructError} If the response do not match the expected shape.\n   */\n  async replaceProfile(\n    profileId: string,\n    params: ReplaceProfileParams,\n  ): Promise<ProfileApiResponse> {\n    return this.executeMutation({\n      mutationKey: [`${this.name}:replaceProfile`, profileId],\n      responseStruct: ProfileApiResponseStruct,\n      mutationFn: async () =>\n        this.#fetch<ProfileApiResponse>(\n          `profiles/${encodeURIComponent(profileId)}`,\n          {\n            method: 'PUT',\n            error: ProfileServiceErrorMessage.REPLACE_PROFILE_FAILED,\n            json: params,\n          },\n        ),\n    });\n  }\n\n  /**\n   * Partially updates an existing profile (PATCH).\n   *\n   * @param profileId - The identifier of the profile to update.\n   * @param params - The fields to update.\n   * @returns The updated profile data.\n   * @throws {HttpError} If the API returns a non-2xx response.\n   * @throws {StructError} If the response do not match the expected shape.\n   */\n  async updateProfile(\n    profileId: string,\n    params: UpdateProfileParams,\n  ): Promise<ProfileApiResponse> {\n    return this.executeMutation({\n      mutationKey: [`${this.name}:updateProfile`, profileId],\n      responseStruct: ProfileApiResponseStruct,\n      mutationFn: async () =>\n        this.#fetch<ProfileApiResponse>(\n          `profiles/${encodeURIComponent(profileId)}`,\n          {\n            method: 'PATCH',\n            error: ProfileServiceErrorMessage.UPDATE_PROFILE_FAILED,\n            json: params,\n          },\n        ),\n    });\n  }\n\n  /**\n   * Deletes a profile by its identifier.\n   *\n   * @param profileId - The identifier of the profile to delete.\n   * @returns The result of the mutation.\n   * @throws {HttpError} If the API returns a non-2xx response.\n   */\n  async deleteProfile(profileId: string): Promise<void> {\n    return this.executeMutation({\n      mutationKey: [`${this.name}:deleteProfile`, profileId],\n      mutationFn: async () =>\n        this.#fetch(`profiles/${encodeURIComponent(profileId)}`, {\n          method: 'DELETE',\n          error: ProfileServiceErrorMessage.DELETE_PROFILE_FAILED,\n        }),\n    });\n  }\n\n  /**\n   * Checks whether a username is available.\n   *\n   * @param username - The username to check.\n   * @returns Availability details including validity and normalized form.\n   * @throws {HttpError} If the API returns a non-2xx response.\n   * @throws {StructError} If the response does not match the expected shape.\n   */\n  async checkUsernameAvailability(\n    username: string,\n  ): Promise<UsernameAvailabilityResponse> {\n    return this.fetchQuery({\n      queryKey: [`${this.name}:checkUsernameAvailability`, username],\n      staleTime: 0,\n      responseStruct: UsernameAvailabilityResponseStruct,\n      queryFn: async () =>\n        this.#fetch<UsernameAvailabilityResponse>(\n          'profiles/username/availability',\n          {\n            error:\n              ProfileServiceErrorMessage.CHECK_USERNAME_AVAILABILITY_FAILED,\n            searchParams: { username },\n          },\n        ),\n    });\n  }\n\n  /**\n   * Fetches the X OAuth PKCE authorization URL and its associated state parameter.\n   *\n   * @returns An object containing the authorization URL and the state token.\n   * @throws {HttpError} If the API returns a non-2xx response.\n   * @throws {StructError} If the response does not match the expected shape.\n   */\n  async getXAuthUrl(): Promise<XAuthUrlResponse> {\n    return this.executeMutation({\n      mutationKey: [`${this.name}:getXAuthUrl`],\n      responseStruct: XAuthUrlResponseStruct,\n      mutationFn: async () =>\n        this.#fetch<XAuthUrlResponse>('profiles/x/authentication-url', {\n          error: ProfileServiceErrorMessage.GET_X_AUTH_URL_FAILED,\n        }),\n    });\n  }\n\n  /**\n   * Completes the X OAuth PKCE flow and links the X account to the profile.\n   *\n   * @param params - The OAuth callback code and state from the X redirect.\n   * @returns The linked X account data.\n   * @throws {HttpError} If the API returns a non-2xx response.\n   * @throws {StructError} If the response does not match the expected shape.\n   */\n  async connectX(params: ConnectXParams): Promise<XConnectResponse> {\n    return this.executeMutation({\n      mutationKey: [`${this.name}:connectX`],\n      responseStruct: XConnectResponseStruct,\n      mutationFn: async () =>\n        this.#fetch<XConnectResponse>('profiles/x/connect', {\n          method: 'POST',\n          error: ProfileServiceErrorMessage.CONNECT_X_FAILED,\n          json: params,\n        }),\n    });\n  }\n\n  /**\n   * Fetches the X account currently linked to the authenticated profile.\n   *\n   * @returns The linked X account data.\n   * @throws {HttpError} If the API returns a non-2xx response.\n   * @throws {StructError} If the response does not match the expected shape.\n   */\n  async getXAccount(): Promise<XAccountResponse> {\n    return this.fetchQuery({\n      queryKey: [`${this.name}:getXAccount`],\n      staleTime: 0,\n      responseStruct: XConnectResponseStruct,\n      queryFn: async () =>\n        this.#fetch<XConnectResponse>('profiles/x/account', {\n          error: ProfileServiceErrorMessage.GET_X_ACCOUNT_FAILED,\n        }),\n    });\n  }\n}\n"]}
+{"version":3,"file":"ProfileService.js","sourceRoot":"","sources":["../src/ProfileService.ts"],"names":[],"mappings":"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","sourcesContent":["import { BaseDataService } from '@metamask/base-data-service';\nimport type {\n  CreateServicePolicyOptions,\n  DataServiceCacheUpdatedEvent,\n  DataServiceGranularCacheUpdatedEvent,\n  DataServiceInvalidateQueriesAction,\n} from '@metamask/base-data-service';\nimport { HttpError } from '@metamask/controller-utils';\nimport type { Messenger } from '@metamask/messenger';\nimport type { AuthenticationController } from '@metamask/profile-sync-controller';\nimport {\n  array,\n  boolean,\n  enums,\n  intersection,\n  nullable,\n  optional,\n  sensitive,\n  string,\n  type as structType,\n} from '@metamask/superstruct';\nimport type { Infer } from '@metamask/superstruct';\nimport type { Json } from '@metamask/utils';\nimport { CaipAccountIdStruct } from '@metamask/utils';\nimport type { CaipAccountId } from '@metamask/utils';\n\nimport type { ProfileServiceMethodActions } from './ProfileService-method-action-types.js';\n\nexport const serviceName = 'ProfileService';\n\n// ---------------------------------------------------------------------------\n// Error messages\n// ---------------------------------------------------------------------------\n\n/** Human-readable error messages for each ProfileService operation. */\nexport const ProfileServiceErrorMessage = {\n  GET_PROFILE_FAILED: 'ProfileService: failed to fetch profile',\n  CREATE_PROFILE_FAILED: 'ProfileService: failed to create profile',\n  REPLACE_PROFILE_FAILED: 'ProfileService: failed to replace profile',\n  UPDATE_PROFILE_FAILED: 'ProfileService: failed to update profile',\n  DELETE_PROFILE_FAILED: 'ProfileService: failed to delete profile',\n  CHECK_USERNAME_AVAILABILITY_FAILED:\n    'ProfileService: failed to check username availability',\n  GET_X_AUTH_URL_FAILED: 'ProfileService: failed to get X authentication URL',\n  CONNECT_X_FAILED: 'ProfileService: failed to connect X account',\n  GET_X_ACCOUNT_FAILED: 'ProfileService: failed to get X account',\n  DISCONNECT_X_FAILED: 'ProfileService: failed to disconnect X account',\n} as const;\n\n// ---------------------------------------------------------------------------\n// Superstruct schemas\n// ---------------------------------------------------------------------------\n\nconst TradingPrivacyStruct = enums(['public', 'private'] as const);\n\nconst ProfileApiResponseStruct = structType({\n  profile_id: string(),\n  username: string(),\n  display_name: string(),\n  bio: nullable(string()),\n  linked_addresses: array(CaipAccountIdStruct),\n  avatar_url: nullable(string()),\n  trading_privacy: TradingPrivacyStruct,\n  connected_to_x: boolean(),\n  created_at: string(),\n  updated_at: string(),\n});\n\nconst UsernameAvailabilityErrorStruct = structType({\n  code: string(),\n  message: string(),\n});\n\nconst UsernameAvailabilityResponseStruct = structType({\n  username: string(),\n  available: boolean(),\n  valid: boolean(),\n  normalized: string(),\n  errors: array(UsernameAvailabilityErrorStruct),\n});\n\nconst XAuthUrlResponseStruct = structType({\n  url: sensitive(string()),\n  state: sensitive(string()),\n});\n\nconst XConnectResponseStruct = structType({\n  x_user_id: string(),\n  x_profile_url: string(),\n  username: string(),\n  display_name: string(),\n  avatar_url: string(),\n  created_at: string(),\n  updated_at: string(),\n});\n\n/**\n * Response shape for POST /v1/profiles/x/connect: the linked X account plus\n * `profile_created`, indicating whether the backend created the MetaMask\n * profile during the connect. Optional so older backends that do not send\n * the field still validate.\n */\nconst ConnectXResponseStruct = intersection([\n  XConnectResponseStruct,\n  structType({ profile_created: optional(boolean()) }),\n]);\n\nconst CreateProfileResponseStruct = intersection([\n  ProfileApiResponseStruct,\n  structType({ x_profile: optional(XConnectResponseStruct) }),\n]);\n\nconst ConnectXParamsStruct = structType({\n  code: sensitive(string()),\n  state: sensitive(string()),\n});\n\nconst CreateProfileParamsStruct = structType({\n  profile_id: string(),\n  username: string(),\n  display_name: string(),\n  bio: optional(nullable(string())),\n  linked_addresses: array(CaipAccountIdStruct),\n  avatar_url: optional(string()),\n  trading_privacy: TradingPrivacyStruct,\n});\n\nconst ReplaceProfileParamsStruct = structType({\n  username: string(),\n  display_name: string(),\n  bio: optional(nullable(string())),\n  linked_addresses: array(CaipAccountIdStruct),\n  avatar_url: optional(string()),\n  trading_privacy: TradingPrivacyStruct,\n});\n\nconst UpdateProfileParamsStruct = structType({\n  username: optional(string()),\n  display_name: optional(string()),\n  bio: optional(nullable(string())),\n  linked_addresses: optional(array(CaipAccountIdStruct)),\n  avatar_url: optional(string()),\n  trading_privacy: optional(TradingPrivacyStruct),\n});\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nconst MESSENGER_EXPOSED_METHODS = [\n  'getProfile',\n  'createProfile',\n  'replaceProfile',\n  'updateProfile',\n  'deleteProfile',\n  'checkUsernameAvailability',\n  'getXAuthUrl',\n  'connectX',\n  'getXAccount',\n  'disconnectX',\n] as const;\n\n/** The shape of a profile returned by the MetaMask Profile API. */\nexport type ProfileApiResponse = Infer<typeof ProfileApiResponseStruct>;\n\n/** The response shape for createProfile — includes an optional linked X profile if the user had already connected X. */\nexport type CreateProfileResponse = Infer<typeof CreateProfileResponseStruct>;\n\n/** The response shape for a username availability check. */\nexport type UsernameAvailabilityResponse = Infer<\n  typeof UsernameAvailabilityResponseStruct\n>;\n\n/** The response shape returned when connecting or fetching an X account. */\nexport type XConnectResponse = Infer<typeof XConnectResponseStruct>;\n\n/** The response shape returned when completing the X connect flow. */\nexport type ConnectXResponse = Infer<typeof ConnectXResponseStruct>;\n\n/** The response shape returned when requesting the X OAuth authentication URL. */\nexport type XAuthUrlResponse = Infer<typeof XAuthUrlResponseStruct>;\n\n/** Alias for {@link XConnectResponse} returned when fetching the linked X account. */\nexport type XAccountResponse = XConnectResponse;\n\n/** Parameters for creating a new MetaMask profile. */\nexport type CreateProfileParams = Infer<typeof CreateProfileParamsStruct>;\n\n/** Parameters for fully replacing an existing MetaMask profile (PUT). */\nexport type ReplaceProfileParams = Infer<typeof ReplaceProfileParamsStruct>;\n\n/** Parameters for partially updating an existing MetaMask profile (PATCH). */\nexport type UpdateProfileParams = Infer<typeof UpdateProfileParamsStruct>;\n\n/** Parameters for completing the X OAuth PKCE flow. */\nexport type ConnectXParams = Infer<typeof ConnectXParamsStruct>;\n\n// ---------------------------------------------------------------------------\n// Messenger types\n// ---------------------------------------------------------------------------\n\n/** Union of all actions exposed by ProfileService, including cache invalidation. */\nexport type ProfileServiceActions =\n  | ProfileServiceMethodActions\n  | DataServiceInvalidateQueriesAction<typeof serviceName>;\n\n/** Event emitted when the ProfileService query cache is updated. */\nexport type ProfileServiceCacheUpdatedEvent = DataServiceCacheUpdatedEvent<\n  typeof serviceName\n>;\n\n/** Event emitted with per-query granularity when the ProfileService cache is updated. */\nexport type ProfileServiceGranularCacheUpdatedEvent =\n  DataServiceGranularCacheUpdatedEvent<typeof serviceName>;\n\n/** Union of all events emitted by ProfileService. */\nexport type ProfileServiceEvents =\n  | ProfileServiceCacheUpdatedEvent\n  | ProfileServiceGranularCacheUpdatedEvent;\n\ntype AllowedActions =\n  AuthenticationController.AuthenticationControllerGetBearerTokenAction;\n\ntype AllowedEvents = never;\n\n/** Messenger type for ProfileService, scoped to its actions and events. */\nexport type ProfileServiceMessenger = Messenger<\n  typeof serviceName,\n  ProfileServiceActions | AllowedActions,\n  ProfileServiceEvents | AllowedEvents\n>;\n\n// ---------------------------------------------------------------------------\n// Service\n// ---------------------------------------------------------------------------\n\n/** Communicates with the MetaMask Profile API and exposes all operations via the messenger. */\nexport class ProfileService extends BaseDataService<\n  typeof serviceName,\n  ProfileServiceMessenger\n> {\n  readonly #baseUrl: string;\n\n  get #v1Url(): string {\n    return `${this.#baseUrl}/v1`;\n  }\n\n  /**\n   * Creates a new ProfileService instance.\n   *\n   * @param options - Constructor options.\n   * @param options.messenger - The messenger scoped to ProfileService.\n   * @param options.baseUrl - Base URL for the MetaMask Profile API.\n   * @param options.policyOptions - Optional service policy configuration.\n   */\n  constructor({\n    messenger,\n    baseUrl,\n    policyOptions,\n  }: {\n    messenger: ProfileServiceMessenger;\n    baseUrl: string;\n    policyOptions?: CreateServicePolicyOptions;\n  }) {\n    super({ name: serviceName, messenger, policyOptions });\n    this.#baseUrl = baseUrl;\n\n    this.messenger.registerMethodActionHandlers(\n      this,\n      MESSENGER_EXPOSED_METHODS,\n    );\n  }\n\n  /**\n   * Gets the authentication headers for the request.\n   *\n   * @returns The authentication headers.\n   */\n  async #getAuthHeaders(): Promise<Record<string, string>> {\n    const token = await this.messenger.call(\n      'AuthenticationController:getBearerToken',\n    );\n    return { Authorization: `Bearer ${token}` };\n  }\n\n  /**\n   * Executes an authenticated HTTP request and returns the parsed JSON response.\n   *\n   * @param endpoint - The path relative to the v1 base URL.\n   * @param options - Request options.\n   * @param options.method - The HTTP method. Defaults to 'GET'.\n   * @param options.error - The error message to use if the response is not OK.\n   * @param options.json - Optional JSON body. If provided, sets Content-Type and serializes as body.\n   * @returns The parsed JSON response.\n   * @throws {HttpError} If the response is not a 2xx status code.\n   */\n  async #fetch(\n    endpoint: string,\n    options: { method: 'DELETE'; error: string },\n  ): Promise<null>;\n\n  async #fetch<ResponseType extends Json>(\n    endpoint: string,\n    options: {\n      method?: string;\n      error: string;\n      json?: unknown;\n      searchParams?: Record<string, string>;\n    },\n  ): Promise<ResponseType>;\n\n  async #fetch<ResponseType extends Json>(\n    endpoint: string,\n    {\n      method = 'GET',\n      error,\n      json,\n      searchParams,\n    }: {\n      method?: string;\n      error: string;\n      json?: unknown;\n      searchParams?: Record<string, string>;\n    },\n  ): Promise<ResponseType | null> {\n    const authHeaders = await this.#getAuthHeaders();\n    const url = new URL(`${this.#v1Url}/${endpoint}`);\n    if (searchParams) {\n      for (const [key, value] of Object.entries(searchParams)) {\n        url.searchParams.append(key, value);\n      }\n    }\n    const response = await fetch(url.toString(), {\n      ...(method === 'GET' ? {} : { method }),\n      headers: {\n        ...authHeaders,\n        ...(json === undefined ? {} : { 'Content-Type': 'application/json' }),\n      },\n      ...(json === undefined ? {} : { body: JSON.stringify(json) }),\n    });\n    if (!response.ok) {\n      throw new HttpError(response.status, `${error}: ${response.status}`);\n    }\n    if (method === 'DELETE') {\n      return null;\n    }\n    return (await response.json()) as ResponseType;\n  }\n\n  /**\n   * Fetches a profile by its identifier.\n   *\n   * @param profileId - The profile identifier to fetch.\n   * @returns The profile data from the API.\n   * @throws {HttpError} If the API returns a non-2xx response.\n   * @throws {StructError} If the response does not match the expected shape.\n   */\n  async getProfile(profileId: string): Promise<ProfileApiResponse> {\n    return this.fetchQuery({\n      queryKey: [`${this.name}:getProfile`, profileId],\n      responseStruct: ProfileApiResponseStruct,\n      queryFn: async () =>\n        this.#fetch<ProfileApiResponse>(\n          `profiles/${encodeURIComponent(profileId)}`,\n          {\n            error: ProfileServiceErrorMessage.GET_PROFILE_FAILED,\n          },\n        ),\n    });\n  }\n\n  /**\n   * Creates a new MetaMask profile.\n   *\n   * @param params - The profile creation parameters.\n   * @returns The created profile data.\n   * @throws {HttpError} If the API returns a non-2xx response.\n   * @throws {StructError} If the response do not match the expected shape.\n   */\n  async createProfile(\n    params: CreateProfileParams,\n  ): Promise<CreateProfileResponse> {\n    return this.executeMutation({\n      mutationKey: [`${this.name}:createProfile`],\n      responseStruct: CreateProfileResponseStruct,\n      mutationFn: async () =>\n        this.#fetch<CreateProfileResponse>('profiles', {\n          method: 'POST',\n          error: ProfileServiceErrorMessage.CREATE_PROFILE_FAILED,\n          json: params,\n        }),\n    });\n  }\n\n  /**\n   * Fully replaces an existing profile (PUT).\n   *\n   * @param profileId - The identifier of the profile to replace.\n   * @param params - The replacement profile data.\n   * @returns The updated profile data.\n   * @throws {HttpError} If the API returns a non-2xx response.\n   * @throws {StructError} If the response do not match the expected shape.\n   */\n  async replaceProfile(\n    profileId: string,\n    params: ReplaceProfileParams,\n  ): Promise<ProfileApiResponse> {\n    return this.executeMutation({\n      mutationKey: [`${this.name}:replaceProfile`, profileId],\n      responseStruct: ProfileApiResponseStruct,\n      mutationFn: async () =>\n        this.#fetch<ProfileApiResponse>(\n          `profiles/${encodeURIComponent(profileId)}`,\n          {\n            method: 'PUT',\n            error: ProfileServiceErrorMessage.REPLACE_PROFILE_FAILED,\n            json: params,\n          },\n        ),\n    });\n  }\n\n  /**\n   * Partially updates an existing profile (PATCH).\n   *\n   * @param profileId - The identifier of the profile to update.\n   * @param params - The fields to update.\n   * @returns The updated profile data.\n   * @throws {HttpError} If the API returns a non-2xx response.\n   * @throws {StructError} If the response do not match the expected shape.\n   */\n  async updateProfile(\n    profileId: string,\n    params: UpdateProfileParams,\n  ): Promise<ProfileApiResponse> {\n    return this.executeMutation({\n      mutationKey: [`${this.name}:updateProfile`, profileId],\n      responseStruct: ProfileApiResponseStruct,\n      mutationFn: async () =>\n        this.#fetch<ProfileApiResponse>(\n          `profiles/${encodeURIComponent(profileId)}`,\n          {\n            method: 'PATCH',\n            error: ProfileServiceErrorMessage.UPDATE_PROFILE_FAILED,\n            json: params,\n          },\n        ),\n    });\n  }\n\n  /**\n   * Deletes a profile by its identifier.\n   *\n   * @param profileId - The identifier of the profile to delete.\n   * @returns The result of the mutation.\n   * @throws {HttpError} If the API returns a non-2xx response.\n   */\n  async deleteProfile(profileId: string): Promise<void> {\n    return this.executeMutation({\n      mutationKey: [`${this.name}:deleteProfile`, profileId],\n      mutationFn: async () =>\n        this.#fetch(`profiles/${encodeURIComponent(profileId)}`, {\n          method: 'DELETE',\n          error: ProfileServiceErrorMessage.DELETE_PROFILE_FAILED,\n        }),\n    });\n  }\n\n  /**\n   * Checks whether a username is available.\n   *\n   * @param username - The username to check.\n   * @returns Availability details including validity and normalized form.\n   * @throws {HttpError} If the API returns a non-2xx response.\n   * @throws {StructError} If the response does not match the expected shape.\n   */\n  async checkUsernameAvailability(\n    username: string,\n  ): Promise<UsernameAvailabilityResponse> {\n    return this.fetchQuery({\n      queryKey: [`${this.name}:checkUsernameAvailability`, username],\n      staleTime: 0,\n      responseStruct: UsernameAvailabilityResponseStruct,\n      queryFn: async () =>\n        this.#fetch<UsernameAvailabilityResponse>(\n          'profiles/username/availability',\n          {\n            error:\n              ProfileServiceErrorMessage.CHECK_USERNAME_AVAILABILITY_FAILED,\n            searchParams: { username },\n          },\n        ),\n    });\n  }\n\n  /**\n   * Fetches the X OAuth PKCE authorization URL and its associated state parameter.\n   * The profile is resolved server-side from the verified bearer token.\n   *\n   * @param linkedAddress - Optional CAIP-10 account ID to link to the profile\n   * when it does not exist yet; sent as the `linked_address` query parameter.\n   * @returns An object containing the authorization URL and the state token.\n   * @throws {HttpError} If the API returns a non-2xx response.\n   * @throws {StructError} If the response does not match the expected shape.\n   */\n  async getXAuthUrl(linkedAddress?: CaipAccountId): Promise<XAuthUrlResponse> {\n    return this.executeMutation({\n      mutationKey: [`${this.name}:getXAuthUrl`],\n      responseStruct: XAuthUrlResponseStruct,\n      mutationFn: async () =>\n        this.#fetch<XAuthUrlResponse>('profiles/x/authentication-url', {\n          error: ProfileServiceErrorMessage.GET_X_AUTH_URL_FAILED,\n          ...(linkedAddress === undefined\n            ? {}\n            : { searchParams: { linked_address: linkedAddress } }),\n        }),\n    });\n  }\n\n  /**\n   * Completes the X OAuth PKCE flow and links the X account to the profile.\n   * The backend creates the profile if it does not exist yet (username derived\n   * from the X handle) and reports that via `profile_created`.\n   *\n   * @param params - The OAuth callback code and state from the X redirect.\n   * @returns The linked X account data, plus `profile_created` when the\n   * backend created the profile during the connect.\n   * @throws {HttpError} If the API returns a non-2xx response.\n   * @throws {StructError} If the response does not match the expected shape.\n   */\n  async connectX(params: ConnectXParams): Promise<ConnectXResponse> {\n    return this.executeMutation({\n      mutationKey: [`${this.name}:connectX`],\n      responseStruct: ConnectXResponseStruct,\n      mutationFn: async () =>\n        this.#fetch<ConnectXResponse>('profiles/x/connect', {\n          method: 'POST',\n          error: ProfileServiceErrorMessage.CONNECT_X_FAILED,\n          json: params,\n        }),\n    });\n  }\n\n  /**\n   * Fetches the X account currently linked to the authenticated profile.\n   * The profile is resolved server-side from the verified bearer token.\n   *\n   * @returns The linked X account data.\n   * @throws {HttpError} If the API returns a non-2xx response.\n   * @throws {StructError} If the response does not match the expected shape.\n   */\n  async getXAccount(): Promise<XAccountResponse> {\n    return this.fetchQuery({\n      queryKey: [`${this.name}:getXAccount`],\n      staleTime: 0,\n      responseStruct: XConnectResponseStruct,\n      queryFn: async () =>\n        this.#fetch<XConnectResponse>('profiles/x/account', {\n          error: ProfileServiceErrorMessage.GET_X_ACCOUNT_FAILED,\n        }),\n    });\n  }\n\n  /**\n   * Disconnects the X account linked to the given profile.\n   * A `404` response is treated as success (the X account is already\n   * disconnected, or the profile is unknown), making the operation idempotent.\n   *\n   * @param profileId - The ID of the profile to disconnect the linked X account from.\n   * @returns The result of the mutation.\n   * @throws {HttpError} If the API returns a non-2xx response other than `404`.\n   */\n  async disconnectX(profileId: string): Promise<void> {\n    return this.executeMutation({\n      mutationKey: [`${this.name}:disconnectX`, profileId],\n      mutationFn: async () => {\n        try {\n          return await this.#fetch(\n            `profiles/${encodeURIComponent(profileId)}/x`,\n            {\n              method: 'DELETE',\n              error: ProfileServiceErrorMessage.DISCONNECT_X_FAILED,\n            },\n          );\n        } catch (error) {\n          if (error instanceof HttpError && error.httpStatus === 404) {\n            return null;\n          }\n          throw error;\n        }\n      },\n    });\n  }\n}\n"]}

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-export type { Profile, XProfile, ProfileControllerState, ProfileControllerGetStateAction, ProfileControllerActions, ProfileControllerChangeEvent, ProfileControllerEvents, ProfileControllerMessenger, } from './ProfileController.js';
+export type { Profile, XProfile, XConnectSession, XConnectResult, ProfileControllerState, ProfileControllerGetStateAction, ProfileControllerActions, ProfileControllerChangeEvent, ProfileControllerEvents, ProfileControllerMessenger, } from './ProfileController.js';
 export { ProfileController, getDefaultProfileControllerState, } from './ProfileController.js';
-export type { ProfileControllerCheckUsernameAvailabilityAction, ProfileControllerConnectXAction, ProfileControllerCreateProfileAction, ProfileControllerDeleteProfileAction, ProfileControllerGetProfileAction, ProfileControllerFetchAndUpdateXAccountAction, ProfileControllerGetXProfileAction, ProfileControllerReplaceProfileAction, ProfileControllerUpdateProfileAction, } from './ProfileController-method-action-types.js';
-export type { ProfileApiResponse, CreateProfileResponse, CreateProfileParams, ReplaceProfileParams, UpdateProfileParams, ConnectXParams, UsernameAvailabilityResponse, XAuthUrlResponse, XConnectResponse, XAccountResponse, ProfileServiceActions, ProfileServiceEvents, ProfileServiceMessenger, } from './ProfileService.js';
+export type { ProfileControllerCheckUsernameAvailabilityAction, ProfileControllerConnectXAction, ProfileControllerCreateProfileAction, ProfileControllerDeleteProfileAction, ProfileControllerDisconnectXAction, ProfileControllerGetProfileAction, ProfileControllerFetchAndUpdateXAccountAction, ProfileControllerGetXProfileAction, ProfileControllerReplaceProfileAction, ProfileControllerStartXConnectAction, ProfileControllerUpdateProfileAction, } from './ProfileController-method-action-types.js';
+export type { ProfileApiResponse, CreateProfileResponse, CreateProfileParams, ReplaceProfileParams, UpdateProfileParams, ConnectXParams, UsernameAvailabilityResponse, XAuthUrlResponse, XConnectResponse, ConnectXResponse, XAccountResponse, ProfileServiceActions, ProfileServiceEvents, ProfileServiceMessenger, } from './ProfileService.js';
 export { ProfileService, ProfileServiceErrorMessage, } from './ProfileService.js';
-export type { ProfileServiceCheckUsernameAvailabilityAction, ProfileServiceConnectXAction, ProfileServiceCreateProfileAction, ProfileServiceDeleteProfileAction, ProfileServiceGetProfileAction, ProfileServiceGetXAccountAction, ProfileServiceGetXAuthUrlAction, ProfileServiceReplaceProfileAction, ProfileServiceUpdateProfileAction, } from './ProfileService-method-action-types.js';
+export type { ProfileServiceCheckUsernameAvailabilityAction, ProfileServiceConnectXAction, ProfileServiceCreateProfileAction, ProfileServiceDeleteProfileAction, ProfileServiceDisconnectXAction, ProfileServiceGetProfileAction, ProfileServiceGetXAccountAction, ProfileServiceGetXAuthUrlAction, ProfileServiceReplaceProfileAction, ProfileServiceUpdateProfileAction, } from './ProfileService-method-action-types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,OAAO,EACP,QAAQ,EACR,sBAAsB,EACtB,+BAA+B,EAC/B,wBAAwB,EACxB,4BAA4B,EAC5B,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,iBAAiB,EACjB,gCAAgC,GACjC,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,gDAAgD,EAChD,+BAA+B,EAC/B,oCAAoC,EACpC,oCAAoC,EACpC,iCAAiC,EACjC,6CAA6C,EAC7C,kCAAkC,EAClC,qCAAqC,EACrC,oCAAoC,GACrC,MAAM,4CAA4C,CAAC;AACpD,YAAY,EACV,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,4BAA4B,EAC5B,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,cAAc,EACd,0BAA0B,GAC3B,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,6CAA6C,EAC7C,4BAA4B,EAC5B,iCAAiC,EACjC,iCAAiC,EACjC,8BAA8B,EAC9B,+BAA+B,EAC/B,+BAA+B,EAC/B,kCAAkC,EAClC,iCAAiC,GAClC,MAAM,yCAAyC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,OAAO,EACP,QAAQ,EACR,eAAe,EACf,cAAc,EACd,sBAAsB,EACtB,+BAA+B,EAC/B,wBAAwB,EACxB,4BAA4B,EAC5B,uBAAuB,EACvB,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,iBAAiB,EACjB,gCAAgC,GACjC,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,gDAAgD,EAChD,+BAA+B,EAC/B,oCAAoC,EACpC,oCAAoC,EACpC,kCAAkC,EAClC,iCAAiC,EACjC,6CAA6C,EAC7C,kCAAkC,EAClC,qCAAqC,EACrC,oCAAoC,EACpC,oCAAoC,GACrC,MAAM,4CAA4C,CAAC;AACpD,YAAY,EACV,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,cAAc,EACd,4BAA4B,EAC5B,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,cAAc,EACd,0BAA0B,GAC3B,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,6CAA6C,EAC7C,4BAA4B,EAC5B,iCAAiC,EACjC,iCAAiC,EACjC,+BAA+B,EAC/B,8BAA8B,EAC9B,+BAA+B,EAC/B,+BAA+B,EAC/B,kCAAkC,EAClC,iCAAiC,GAClC,MAAM,yCAAyC,CAAC"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,iBAAiB,EACjB,gCAAgC,GACjC,MAAM,wBAAwB,CAAC;AA2BhC,OAAO,EACL,cAAc,EACd,0BAA0B,GAC3B,MAAM,qBAAqB,CAAC","sourcesContent":["export type {\n  Profile,\n  XProfile,\n  ProfileControllerState,\n  ProfileControllerGetStateAction,\n  ProfileControllerActions,\n  ProfileControllerChangeEvent,\n  ProfileControllerEvents,\n  ProfileControllerMessenger,\n} from './ProfileController.js';\nexport {\n  ProfileController,\n  getDefaultProfileControllerState,\n} from './ProfileController.js';\nexport type {\n  ProfileControllerCheckUsernameAvailabilityAction,\n  ProfileControllerConnectXAction,\n  ProfileControllerCreateProfileAction,\n  ProfileControllerDeleteProfileAction,\n  ProfileControllerGetProfileAction,\n  ProfileControllerFetchAndUpdateXAccountAction,\n  ProfileControllerGetXProfileAction,\n  ProfileControllerReplaceProfileAction,\n  ProfileControllerUpdateProfileAction,\n} from './ProfileController-method-action-types.js';\nexport type {\n  ProfileApiResponse,\n  CreateProfileResponse,\n  CreateProfileParams,\n  ReplaceProfileParams,\n  UpdateProfileParams,\n  ConnectXParams,\n  UsernameAvailabilityResponse,\n  XAuthUrlResponse,\n  XConnectResponse,\n  XAccountResponse,\n  ProfileServiceActions,\n  ProfileServiceEvents,\n  ProfileServiceMessenger,\n} from './ProfileService.js';\nexport {\n  ProfileService,\n  ProfileServiceErrorMessage,\n} from './ProfileService.js';\nexport type {\n  ProfileServiceCheckUsernameAvailabilityAction,\n  ProfileServiceConnectXAction,\n  ProfileServiceCreateProfileAction,\n  ProfileServiceDeleteProfileAction,\n  ProfileServiceGetProfileAction,\n  ProfileServiceGetXAccountAction,\n  ProfileServiceGetXAuthUrlAction,\n  ProfileServiceReplaceProfileAction,\n  ProfileServiceUpdateProfileAction,\n} from './ProfileService-method-action-types.js';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAYA,OAAO,EACL,iBAAiB,EACjB,gCAAgC,GACjC,MAAM,wBAAwB,CAAC;AA8BhC,OAAO,EACL,cAAc,EACd,0BAA0B,GAC3B,MAAM,qBAAqB,CAAC","sourcesContent":["export type {\n  Profile,\n  XProfile,\n  XConnectSession,\n  XConnectResult,\n  ProfileControllerState,\n  ProfileControllerGetStateAction,\n  ProfileControllerActions,\n  ProfileControllerChangeEvent,\n  ProfileControllerEvents,\n  ProfileControllerMessenger,\n} from './ProfileController.js';\nexport {\n  ProfileController,\n  getDefaultProfileControllerState,\n} from './ProfileController.js';\nexport type {\n  ProfileControllerCheckUsernameAvailabilityAction,\n  ProfileControllerConnectXAction,\n  ProfileControllerCreateProfileAction,\n  ProfileControllerDeleteProfileAction,\n  ProfileControllerDisconnectXAction,\n  ProfileControllerGetProfileAction,\n  ProfileControllerFetchAndUpdateXAccountAction,\n  ProfileControllerGetXProfileAction,\n  ProfileControllerReplaceProfileAction,\n  ProfileControllerStartXConnectAction,\n  ProfileControllerUpdateProfileAction,\n} from './ProfileController-method-action-types.js';\nexport type {\n  ProfileApiResponse,\n  CreateProfileResponse,\n  CreateProfileParams,\n  ReplaceProfileParams,\n  UpdateProfileParams,\n  ConnectXParams,\n  UsernameAvailabilityResponse,\n  XAuthUrlResponse,\n  XConnectResponse,\n  ConnectXResponse,\n  XAccountResponse,\n  ProfileServiceActions,\n  ProfileServiceEvents,\n  ProfileServiceMessenger,\n} from './ProfileService.js';\nexport {\n  ProfileService,\n  ProfileServiceErrorMessage,\n} from './ProfileService.js';\nexport type {\n  ProfileServiceCheckUsernameAvailabilityAction,\n  ProfileServiceConnectXAction,\n  ProfileServiceCreateProfileAction,\n  ProfileServiceDeleteProfileAction,\n  ProfileServiceDisconnectXAction,\n  ProfileServiceGetProfileAction,\n  ProfileServiceGetXAccountAction,\n  ProfileServiceGetXAuthUrlAction,\n  ProfileServiceReplaceProfileAction,\n  ProfileServiceUpdateProfileAction,\n} from './ProfileService-method-action-types.js';\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@metamask-previews/profile-controller",
-  "version": "1.0.0-preview-c2be02bd4",
+  "version": "1.0.1-preview-3b264bf6d",
   "description": "Controller for managing user profile data including username, bio, avatar, and linked accounts via the MetaMask Profile API",
   "keywords": [
     "Ethereum",
@@ -54,7 +54,7 @@
     "@metamask/base-data-service": "^2.1.0",
     "@metamask/controller-utils": "^13.0.0",
     "@metamask/messenger": "^3.0.0",
-    "@metamask/profile-sync-controller": "^33.0.0",
+    "@metamask/profile-sync-controller": "^34.0.0",
     "@metamask/superstruct": "^3.4.1",
     "@metamask/utils": "^12.0.0"
   },