@metamask/social-controllers 0.1.0

package/dist/SocialController.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"SocialController.mjs","sourceRoot":"","sources":["../src/SocialController.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  ControllerGetStateAction,\n  ControllerStateChangeEvent,\n  StateMetadata,\n} from '@metamask/base-controller';\nimport { BaseController } from '@metamask/base-controller';\nimport type { Messenger } from '@metamask/messenger';\n\nimport { controllerName } from './social-constants';\nimport type {\n  FetchFollowingOptions,\n  FetchLeaderboardOptions,\n  FollowOptions,\n  FollowResponse,\n  FollowingResponse,\n  LeaderboardResponse,\n  SocialControllerState,\n  UnfollowOptions,\n  UnfollowResponse,\n} from './social-types';\nimport type { SocialControllerMethodActions } from './SocialController-method-action-types';\nimport type {\n  SocialServiceFetchFollowingAction,\n  SocialServiceFetchLeaderboardAction,\n  SocialServiceFollowAction,\n  SocialServiceUnfollowAction,\n} from './SocialService-method-action-types';\n\n// === MESSENGER ===\n\nconst MESSENGER_EXPOSED_METHODS = [\n  'updateLeaderboard',\n  'followTrader',\n  'unfollowTrader',\n  'updateFollowing',\n] as const;\n\n// === ACTION TYPES ===\n\nexport type SocialControllerGetStateAction = ControllerGetStateAction<\n  typeof controllerName,\n  SocialControllerState\n>;\n\nexport type SocialControllerActions =\n  | SocialControllerGetStateAction\n  | SocialControllerMethodActions;\n\n// === EVENT TYPES ===\n\nexport type SocialControllerStateChangeEvent = ControllerStateChangeEvent<\n  typeof controllerName,\n  SocialControllerState\n>;\n\nexport type SocialControllerEvents = SocialControllerStateChangeEvent;\n\n// === ALLOWED ACTIONS/EVENTS ===\n\ntype AllowedActions =\n  | SocialServiceFetchLeaderboardAction\n  | SocialServiceFollowAction\n  | SocialServiceUnfollowAction\n  | SocialServiceFetchFollowingAction;\n\ntype AllowedEvents = never;\n\n// === MESSENGER TYPE ===\n\nexport type SocialControllerMessenger = Messenger<\n  typeof controllerName,\n  SocialControllerActions | AllowedActions,\n  SocialControllerEvents | AllowedEvents\n>;\n\n// === OPTIONS ===\n\nexport type SocialControllerOptions = {\n  messenger: SocialControllerMessenger;\n  state?: Partial<SocialControllerState>;\n};\n\n// === DEFAULT STATE ===\n\n/**\n * Returns the default state for the SocialController.\n *\n * @returns A fresh default state object.\n */\nexport function getDefaultSocialControllerState(): SocialControllerState {\n  return {\n    leaderboardEntries: [],\n    followingAddresses: [],\n  };\n}\n\n// === STATE METADATA ===\n\nconst socialControllerMetadata: StateMetadata<SocialControllerState> = {\n  leaderboardEntries: {\n    persist: true,\n    includeInDebugSnapshot: false,\n    includeInStateLogs: false,\n    usedInUi: true,\n  },\n  followingAddresses: {\n    persist: true,\n    includeInDebugSnapshot: false,\n    includeInStateLogs: false,\n    usedInUi: true,\n  },\n};\n\n// === CONTROLLER ===\n\n/**\n * Controller that manages social trading state for the extension UI.\n *\n * Acts as a simple store with no TTL or eviction — the UI decides when\n * to re-fetch, and the social-api's own cache layer handles upstream\n * rate-limiting. State is persisted across sessions so the UI can render\n * immediately on startup while a fresh fetch is in flight.\n */\nexport class SocialController extends BaseController<\n  typeof controllerName,\n  SocialControllerState,\n  SocialControllerMessenger\n> {\n  constructor({ messenger, state }: SocialControllerOptions) {\n    super({\n      name: controllerName,\n      metadata: socialControllerMetadata,\n      state: {\n        ...getDefaultSocialControllerState(),\n        ...state,\n      },\n      messenger,\n    });\n\n    this.messenger.registerMethodActionHandlers(\n      this,\n      MESSENGER_EXPOSED_METHODS,\n    );\n  }\n\n  /**\n   * Fetches the leaderboard and persists the entries to state.\n   *\n   * @param options - Optional leaderboard query parameters.\n   * @returns The leaderboard response from the social-api.\n   */\n  async updateLeaderboard(\n    options?: FetchLeaderboardOptions,\n  ): Promise<LeaderboardResponse> {\n    const leaderboardResponse = await this.messenger.call(\n      'SocialService:fetchLeaderboard',\n      options,\n    );\n\n    this.update((state) => {\n      state.leaderboardEntries = leaderboardResponse.traders;\n    });\n\n    return leaderboardResponse;\n  }\n\n  /**\n   * Follows one or more traders and updates the following list in state.\n   *\n   * @param options - Options bag.\n   * @param options.addressOrUid - Wallet address or Clicker profile ID of the current user.\n   * @param options.targets - Addresses or profile IDs to follow.\n   * @returns The follow response with confirmed follows.\n   */\n  async followTrader(options: FollowOptions): Promise<FollowResponse> {\n    const followResponse = await this.messenger.call(\n      'SocialService:follow',\n      options,\n    );\n\n    const newAddresses = [\n      ...new Set(followResponse.followed.map((profile) => profile.address)),\n    ];\n\n    this.update((state) => {\n      const existing = new Set(state.followingAddresses);\n      const uniqueNewAddresses = newAddresses.filter(\n        (address) => !existing.has(address),\n      );\n      state.followingAddresses.push(...uniqueNewAddresses);\n    });\n\n    return followResponse;\n  }\n\n  /**\n   * Unfollows one or more traders and updates the following list in state.\n   *\n   * @param options - Options bag.\n   * @param options.addressOrUid - Wallet address or Clicker profile ID of the current user.\n   * @param options.targets - Addresses or profile IDs to unfollow.\n   * @returns The unfollow response with confirmed unfollows.\n   */\n  async unfollowTrader(options: UnfollowOptions): Promise<UnfollowResponse> {\n    const unfollowResponse = await this.messenger.call(\n      'SocialService:unfollow',\n      options,\n    );\n\n    const removedAddresses = new Set(\n      unfollowResponse.unfollowed.map((profile) => profile.address),\n    );\n\n    this.update((state) => {\n      state.followingAddresses = state.followingAddresses.filter(\n        (address) => !removedAddresses.has(address),\n      );\n    });\n\n    return unfollowResponse;\n  }\n\n  /**\n   * Fetches the list of traders the current user follows and replaces\n   * the following addresses in state.\n   *\n   * @param options - Options bag.\n   * @param options.addressOrUid - Wallet address or Clicker profile ID of the current user.\n   * @returns The following response.\n   */\n  async updateFollowing(\n    options: FetchFollowingOptions,\n  ): Promise<FollowingResponse> {\n    const followingResponse = await this.messenger.call(\n      'SocialService:fetchFollowing',\n      options,\n    );\n\n    this.update((state) => {\n      state.followingAddresses = followingResponse.following.map(\n        (profile) => profile.address,\n      );\n    });\n\n    return followingResponse;\n  }\n}\n"]}

package/dist/SocialService-method-action-types.cjs

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * This file is auto generated.
+ * Do not edit manually.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=SocialService-method-action-types.cjs.map

package/dist/SocialService-method-action-types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"SocialService-method-action-types.cjs","sourceRoot":"","sources":["../src/SocialService-method-action-types.ts"],"names":[],"mappings":";AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { SocialService } from './SocialService';\n\n/**\n * Fetches the leaderboard of top traders.\n *\n * Calls `GET ${baseUrl}/leaderboard`.\n *\n * @param options - Optional query parameters for sorting, chain filtering, and limit.\n * @returns The leaderboard response with ranked traders.\n */\nexport type SocialServiceFetchLeaderboardAction = {\n  type: `SocialService:fetchLeaderboard`;\n  handler: SocialService['fetchLeaderboard'];\n};\n\n/**\n * Fetches a trader's profile by address or profile ID.\n *\n * Calls `GET ${baseUrl}/traders/${addressOrId}/profile`.\n *\n * @param options - Options bag.\n * @param options.addressOrId - Wallet address or Clicker profile ID.\n * @returns The trader profile response.\n */\nexport type SocialServiceFetchTraderProfileAction = {\n  type: `SocialService:fetchTraderProfile`;\n  handler: SocialService['fetchTraderProfile'];\n};\n\n/**\n * Fetches a trader's open positions.\n *\n * Calls `GET ${baseUrl}/traders/${addressOrId}/positions/open`.\n *\n * @param options - Options bag.\n * @param options.addressOrId - Wallet address or Clicker profile ID.\n * @param options.chain - Filter by chain.\n * @param options.sort - Sort by 'value' or 'latest'.\n * @param options.limit - Number of results per page.\n * @param options.page - Page number (1-based).\n * @returns The positions response.\n */\nexport type SocialServiceFetchOpenPositionsAction = {\n  type: `SocialService:fetchOpenPositions`;\n  handler: SocialService['fetchOpenPositions'];\n};\n\n/**\n * Fetches a trader's closed positions.\n *\n * Calls `GET ${baseUrl}/traders/${addressOrId}/positions/closed`.\n *\n * @param options - Options bag.\n * @param options.addressOrId - Wallet address or Clicker profile ID.\n * @param options.chain - Filter by chain.\n * @param options.sort - Sort by 'value' or 'latest'.\n * @param options.limit - Number of results per page.\n * @param options.page - Page number (1-based).\n * @returns The positions response.\n */\nexport type SocialServiceFetchClosedPositionsAction = {\n  type: `SocialService:fetchClosedPositions`;\n  handler: SocialService['fetchClosedPositions'];\n};\n\n/**\n * Fetches a trader's MetaMask followers.\n *\n * Calls `GET ${baseUrl}/traders/${addressOrId}/followers`.\n *\n * @param options - Options bag.\n * @param options.addressOrId - Wallet address or Clicker profile ID.\n * @returns The followers response.\n */\nexport type SocialServiceFetchFollowersAction = {\n  type: `SocialService:fetchFollowers`;\n  handler: SocialService['fetchFollowers'];\n};\n\n/**\n * Fetches the list of traders a user is following.\n *\n * Calls `GET ${baseUrl}/users/${addressOrUid}/following`.\n *\n * @param options - Options bag.\n * @param options.addressOrUid - Wallet address or Clicker profile ID.\n * @returns The following response.\n */\nexport type SocialServiceFetchFollowingAction = {\n  type: `SocialService:fetchFollowing`;\n  handler: SocialService['fetchFollowing'];\n};\n\n/**\n * Follows one or more traders.\n *\n * Calls `PUT ${baseUrl}/users/${addressOrUid}/follows`.\n *\n * @param options - Options bag.\n * @param options.addressOrUid - Wallet address or Clicker profile ID of the user.\n * @param options.targets - Array of wallet addresses or profile IDs to follow.\n * @returns The follow response with confirmed follows.\n */\nexport type SocialServiceFollowAction = {\n  type: `SocialService:follow`;\n  handler: SocialService['follow'];\n};\n\n/**\n * Unfollows one or more traders.\n *\n * Calls `DELETE ${baseUrl}/users/${addressOrUid}/follows?targets=...`.\n * Targets are sent as query params because Fastify does not parse\n * request bodies on DELETE requests per RFC 9110.\n *\n * @param options - Options bag.\n * @param options.addressOrUid - Wallet address or Clicker profile ID of the user.\n * @param options.targets - Array of wallet addresses or profile IDs to unfollow.\n * @returns The unfollow response with confirmed unfollows.\n */\nexport type SocialServiceUnfollowAction = {\n  type: `SocialService:unfollow`;\n  handler: SocialService['unfollow'];\n};\n\n/**\n * Union of all SocialService action types.\n */\nexport type SocialServiceMethodActions =\n  | SocialServiceFetchLeaderboardAction\n  | SocialServiceFetchTraderProfileAction\n  | SocialServiceFetchOpenPositionsAction\n  | SocialServiceFetchClosedPositionsAction\n  | SocialServiceFetchFollowersAction\n  | SocialServiceFetchFollowingAction\n  | SocialServiceFollowAction\n  | SocialServiceUnfollowAction;\n"]}

package/dist/SocialService-method-action-types.d.cts

@@ -0,0 +1,125 @@
+/**
+ * This file is auto generated.
+ * Do not edit manually.
+ */
+import type { SocialService } from "./SocialService.cjs";
+/**
+ * Fetches the leaderboard of top traders.
+ *
+ * Calls `GET ${baseUrl}/leaderboard`.
+ *
+ * @param options - Optional query parameters for sorting, chain filtering, and limit.
+ * @returns The leaderboard response with ranked traders.
+ */
+export type SocialServiceFetchLeaderboardAction = {
+    type: `SocialService:fetchLeaderboard`;
+    handler: SocialService['fetchLeaderboard'];
+};
+/**
+ * Fetches a trader's profile by address or profile ID.
+ *
+ * Calls `GET ${baseUrl}/traders/${addressOrId}/profile`.
+ *
+ * @param options - Options bag.
+ * @param options.addressOrId - Wallet address or Clicker profile ID.
+ * @returns The trader profile response.
+ */
+export type SocialServiceFetchTraderProfileAction = {
+    type: `SocialService:fetchTraderProfile`;
+    handler: SocialService['fetchTraderProfile'];
+};
+/**
+ * Fetches a trader's open positions.
+ *
+ * Calls `GET ${baseUrl}/traders/${addressOrId}/positions/open`.
+ *
+ * @param options - Options bag.
+ * @param options.addressOrId - Wallet address or Clicker profile ID.
+ * @param options.chain - Filter by chain.
+ * @param options.sort - Sort by 'value' or 'latest'.
+ * @param options.limit - Number of results per page.
+ * @param options.page - Page number (1-based).
+ * @returns The positions response.
+ */
+export type SocialServiceFetchOpenPositionsAction = {
+    type: `SocialService:fetchOpenPositions`;
+    handler: SocialService['fetchOpenPositions'];
+};
+/**
+ * Fetches a trader's closed positions.
+ *
+ * Calls `GET ${baseUrl}/traders/${addressOrId}/positions/closed`.
+ *
+ * @param options - Options bag.
+ * @param options.addressOrId - Wallet address or Clicker profile ID.
+ * @param options.chain - Filter by chain.
+ * @param options.sort - Sort by 'value' or 'latest'.
+ * @param options.limit - Number of results per page.
+ * @param options.page - Page number (1-based).
+ * @returns The positions response.
+ */
+export type SocialServiceFetchClosedPositionsAction = {
+    type: `SocialService:fetchClosedPositions`;
+    handler: SocialService['fetchClosedPositions'];
+};
+/**
+ * Fetches a trader's MetaMask followers.
+ *
+ * Calls `GET ${baseUrl}/traders/${addressOrId}/followers`.
+ *
+ * @param options - Options bag.
+ * @param options.addressOrId - Wallet address or Clicker profile ID.
+ * @returns The followers response.
+ */
+export type SocialServiceFetchFollowersAction = {
+    type: `SocialService:fetchFollowers`;
+    handler: SocialService['fetchFollowers'];
+};
+/**
+ * Fetches the list of traders a user is following.
+ *
+ * Calls `GET ${baseUrl}/users/${addressOrUid}/following`.
+ *
+ * @param options - Options bag.
+ * @param options.addressOrUid - Wallet address or Clicker profile ID.
+ * @returns The following response.
+ */
+export type SocialServiceFetchFollowingAction = {
+    type: `SocialService:fetchFollowing`;
+    handler: SocialService['fetchFollowing'];
+};
+/**
+ * Follows one or more traders.
+ *
+ * Calls `PUT ${baseUrl}/users/${addressOrUid}/follows`.
+ *
+ * @param options - Options bag.
+ * @param options.addressOrUid - Wallet address or Clicker profile ID of the user.
+ * @param options.targets - Array of wallet addresses or profile IDs to follow.
+ * @returns The follow response with confirmed follows.
+ */
+export type SocialServiceFollowAction = {
+    type: `SocialService:follow`;
+    handler: SocialService['follow'];
+};
+/**
+ * Unfollows one or more traders.
+ *
+ * Calls `DELETE ${baseUrl}/users/${addressOrUid}/follows?targets=...`.
+ * Targets are sent as query params because Fastify does not parse
+ * request bodies on DELETE requests per RFC 9110.
+ *
+ * @param options - Options bag.
+ * @param options.addressOrUid - Wallet address or Clicker profile ID of the user.
+ * @param options.targets - Array of wallet addresses or profile IDs to unfollow.
+ * @returns The unfollow response with confirmed unfollows.
+ */
+export type SocialServiceUnfollowAction = {
+    type: `SocialService:unfollow`;
+    handler: SocialService['unfollow'];
+};
+/**
+ * Union of all SocialService action types.
+ */
+export type SocialServiceMethodActions = SocialServiceFetchLeaderboardAction | SocialServiceFetchTraderProfileAction | SocialServiceFetchOpenPositionsAction | SocialServiceFetchClosedPositionsAction | SocialServiceFetchFollowersAction | SocialServiceFetchFollowingAction | SocialServiceFollowAction | SocialServiceUnfollowAction;
+//# sourceMappingURL=SocialService-method-action-types.d.cts.map

package/dist/SocialService-method-action-types.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SocialService-method-action-types.d.cts","sourceRoot":"","sources":["../src/SocialService-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,4BAAwB;AAErD;;;;;;;GAOG;AACH,MAAM,MAAM,mCAAmC,GAAG;IAChD,IAAI,EAAE,gCAAgC,CAAC;IACvC,OAAO,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAC;CAC5C,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,qCAAqC,GAAG;IAClD,IAAI,EAAE,kCAAkC,CAAC;IACzC,OAAO,EAAE,aAAa,CAAC,oBAAoB,CAAC,CAAC;CAC9C,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,qCAAqC,GAAG;IAClD,IAAI,EAAE,kCAAkC,CAAC;IACzC,OAAO,EAAE,aAAa,CAAC,oBAAoB,CAAC,CAAC;CAC9C,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,uCAAuC,GAAG;IACpD,IAAI,EAAE,oCAAoC,CAAC;IAC3C,OAAO,EAAE,aAAa,CAAC,sBAAsB,CAAC,CAAC;CAChD,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,iCAAiC,GAAG;IAC9C,IAAI,EAAE,8BAA8B,CAAC;IACrC,OAAO,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;CAC1C,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,iCAAiC,GAAG;IAC9C,IAAI,EAAE,8BAA8B,CAAC;IACrC,OAAO,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;CAC1C,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,OAAO,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;CAClC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC,IAAI,EAAE,wBAAwB,CAAC;IAC/B,OAAO,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;CACpC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAClC,mCAAmC,GACnC,qCAAqC,GACrC,qCAAqC,GACrC,uCAAuC,GACvC,iCAAiC,GACjC,iCAAiC,GACjC,yBAAyB,GACzB,2BAA2B,CAAC"}

package/dist/SocialService-method-action-types.d.mts

@@ -0,0 +1,125 @@
+/**
+ * This file is auto generated.
+ * Do not edit manually.
+ */
+import type { SocialService } from "./SocialService.mjs";
+/**
+ * Fetches the leaderboard of top traders.
+ *
+ * Calls `GET ${baseUrl}/leaderboard`.
+ *
+ * @param options - Optional query parameters for sorting, chain filtering, and limit.
+ * @returns The leaderboard response with ranked traders.
+ */
+export type SocialServiceFetchLeaderboardAction = {
+    type: `SocialService:fetchLeaderboard`;
+    handler: SocialService['fetchLeaderboard'];
+};
+/**
+ * Fetches a trader's profile by address or profile ID.
+ *
+ * Calls `GET ${baseUrl}/traders/${addressOrId}/profile`.
+ *
+ * @param options - Options bag.
+ * @param options.addressOrId - Wallet address or Clicker profile ID.
+ * @returns The trader profile response.
+ */
+export type SocialServiceFetchTraderProfileAction = {
+    type: `SocialService:fetchTraderProfile`;
+    handler: SocialService['fetchTraderProfile'];
+};
+/**
+ * Fetches a trader's open positions.
+ *
+ * Calls `GET ${baseUrl}/traders/${addressOrId}/positions/open`.
+ *
+ * @param options - Options bag.
+ * @param options.addressOrId - Wallet address or Clicker profile ID.
+ * @param options.chain - Filter by chain.
+ * @param options.sort - Sort by 'value' or 'latest'.
+ * @param options.limit - Number of results per page.
+ * @param options.page - Page number (1-based).
+ * @returns The positions response.
+ */
+export type SocialServiceFetchOpenPositionsAction = {
+    type: `SocialService:fetchOpenPositions`;
+    handler: SocialService['fetchOpenPositions'];
+};
+/**
+ * Fetches a trader's closed positions.
+ *
+ * Calls `GET ${baseUrl}/traders/${addressOrId}/positions/closed`.
+ *
+ * @param options - Options bag.
+ * @param options.addressOrId - Wallet address or Clicker profile ID.
+ * @param options.chain - Filter by chain.
+ * @param options.sort - Sort by 'value' or 'latest'.
+ * @param options.limit - Number of results per page.
+ * @param options.page - Page number (1-based).
+ * @returns The positions response.
+ */
+export type SocialServiceFetchClosedPositionsAction = {
+    type: `SocialService:fetchClosedPositions`;
+    handler: SocialService['fetchClosedPositions'];
+};
+/**
+ * Fetches a trader's MetaMask followers.
+ *
+ * Calls `GET ${baseUrl}/traders/${addressOrId}/followers`.
+ *
+ * @param options - Options bag.
+ * @param options.addressOrId - Wallet address or Clicker profile ID.
+ * @returns The followers response.
+ */
+export type SocialServiceFetchFollowersAction = {
+    type: `SocialService:fetchFollowers`;
+    handler: SocialService['fetchFollowers'];
+};
+/**
+ * Fetches the list of traders a user is following.
+ *
+ * Calls `GET ${baseUrl}/users/${addressOrUid}/following`.
+ *
+ * @param options - Options bag.
+ * @param options.addressOrUid - Wallet address or Clicker profile ID.
+ * @returns The following response.
+ */
+export type SocialServiceFetchFollowingAction = {
+    type: `SocialService:fetchFollowing`;
+    handler: SocialService['fetchFollowing'];
+};
+/**
+ * Follows one or more traders.
+ *
+ * Calls `PUT ${baseUrl}/users/${addressOrUid}/follows`.
+ *
+ * @param options - Options bag.
+ * @param options.addressOrUid - Wallet address or Clicker profile ID of the user.
+ * @param options.targets - Array of wallet addresses or profile IDs to follow.
+ * @returns The follow response with confirmed follows.
+ */
+export type SocialServiceFollowAction = {
+    type: `SocialService:follow`;
+    handler: SocialService['follow'];
+};
+/**
+ * Unfollows one or more traders.
+ *
+ * Calls `DELETE ${baseUrl}/users/${addressOrUid}/follows?targets=...`.
+ * Targets are sent as query params because Fastify does not parse
+ * request bodies on DELETE requests per RFC 9110.
+ *
+ * @param options - Options bag.
+ * @param options.addressOrUid - Wallet address or Clicker profile ID of the user.
+ * @param options.targets - Array of wallet addresses or profile IDs to unfollow.
+ * @returns The unfollow response with confirmed unfollows.
+ */
+export type SocialServiceUnfollowAction = {
+    type: `SocialService:unfollow`;
+    handler: SocialService['unfollow'];
+};
+/**
+ * Union of all SocialService action types.
+ */
+export type SocialServiceMethodActions = SocialServiceFetchLeaderboardAction | SocialServiceFetchTraderProfileAction | SocialServiceFetchOpenPositionsAction | SocialServiceFetchClosedPositionsAction | SocialServiceFetchFollowersAction | SocialServiceFetchFollowingAction | SocialServiceFollowAction | SocialServiceUnfollowAction;
+//# sourceMappingURL=SocialService-method-action-types.d.mts.map

package/dist/SocialService-method-action-types.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SocialService-method-action-types.d.mts","sourceRoot":"","sources":["../src/SocialService-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,4BAAwB;AAErD;;;;;;;GAOG;AACH,MAAM,MAAM,mCAAmC,GAAG;IAChD,IAAI,EAAE,gCAAgC,CAAC;IACvC,OAAO,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAC;CAC5C,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,qCAAqC,GAAG;IAClD,IAAI,EAAE,kCAAkC,CAAC;IACzC,OAAO,EAAE,aAAa,CAAC,oBAAoB,CAAC,CAAC;CAC9C,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,qCAAqC,GAAG;IAClD,IAAI,EAAE,kCAAkC,CAAC;IACzC,OAAO,EAAE,aAAa,CAAC,oBAAoB,CAAC,CAAC;CAC9C,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,uCAAuC,GAAG;IACpD,IAAI,EAAE,oCAAoC,CAAC;IAC3C,OAAO,EAAE,aAAa,CAAC,sBAAsB,CAAC,CAAC;CAChD,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,iCAAiC,GAAG;IAC9C,IAAI,EAAE,8BAA8B,CAAC;IACrC,OAAO,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;CAC1C,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,MAAM,iCAAiC,GAAG;IAC9C,IAAI,EAAE,8BAA8B,CAAC;IACrC,OAAO,EAAE,aAAa,CAAC,gBAAgB,CAAC,CAAC;CAC1C,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,OAAO,EAAE,aAAa,CAAC,QAAQ,CAAC,CAAC;CAClC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,2BAA2B,GAAG;IACxC,IAAI,EAAE,wBAAwB,CAAC;IAC/B,OAAO,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;CACpC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAClC,mCAAmC,GACnC,qCAAqC,GACrC,qCAAqC,GACrC,uCAAuC,GACvC,iCAAiC,GACjC,iCAAiC,GACjC,yBAAyB,GACzB,2BAA2B,CAAC"}

package/dist/SocialService-method-action-types.mjs

@@ -0,0 +1,6 @@
+/**
+ * This file is auto generated.
+ * Do not edit manually.
+ */
+export {};
+//# sourceMappingURL=SocialService-method-action-types.mjs.map

package/dist/SocialService-method-action-types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"SocialService-method-action-types.mjs","sourceRoot":"","sources":["../src/SocialService-method-action-types.ts"],"names":[],"mappings":"AAAA;;;GAGG","sourcesContent":["/**\n * This file is auto generated.\n * Do not edit manually.\n */\n\nimport type { SocialService } from './SocialService';\n\n/**\n * Fetches the leaderboard of top traders.\n *\n * Calls `GET ${baseUrl}/leaderboard`.\n *\n * @param options - Optional query parameters for sorting, chain filtering, and limit.\n * @returns The leaderboard response with ranked traders.\n */\nexport type SocialServiceFetchLeaderboardAction = {\n  type: `SocialService:fetchLeaderboard`;\n  handler: SocialService['fetchLeaderboard'];\n};\n\n/**\n * Fetches a trader's profile by address or profile ID.\n *\n * Calls `GET ${baseUrl}/traders/${addressOrId}/profile`.\n *\n * @param options - Options bag.\n * @param options.addressOrId - Wallet address or Clicker profile ID.\n * @returns The trader profile response.\n */\nexport type SocialServiceFetchTraderProfileAction = {\n  type: `SocialService:fetchTraderProfile`;\n  handler: SocialService['fetchTraderProfile'];\n};\n\n/**\n * Fetches a trader's open positions.\n *\n * Calls `GET ${baseUrl}/traders/${addressOrId}/positions/open`.\n *\n * @param options - Options bag.\n * @param options.addressOrId - Wallet address or Clicker profile ID.\n * @param options.chain - Filter by chain.\n * @param options.sort - Sort by 'value' or 'latest'.\n * @param options.limit - Number of results per page.\n * @param options.page - Page number (1-based).\n * @returns The positions response.\n */\nexport type SocialServiceFetchOpenPositionsAction = {\n  type: `SocialService:fetchOpenPositions`;\n  handler: SocialService['fetchOpenPositions'];\n};\n\n/**\n * Fetches a trader's closed positions.\n *\n * Calls `GET ${baseUrl}/traders/${addressOrId}/positions/closed`.\n *\n * @param options - Options bag.\n * @param options.addressOrId - Wallet address or Clicker profile ID.\n * @param options.chain - Filter by chain.\n * @param options.sort - Sort by 'value' or 'latest'.\n * @param options.limit - Number of results per page.\n * @param options.page - Page number (1-based).\n * @returns The positions response.\n */\nexport type SocialServiceFetchClosedPositionsAction = {\n  type: `SocialService:fetchClosedPositions`;\n  handler: SocialService['fetchClosedPositions'];\n};\n\n/**\n * Fetches a trader's MetaMask followers.\n *\n * Calls `GET ${baseUrl}/traders/${addressOrId}/followers`.\n *\n * @param options - Options bag.\n * @param options.addressOrId - Wallet address or Clicker profile ID.\n * @returns The followers response.\n */\nexport type SocialServiceFetchFollowersAction = {\n  type: `SocialService:fetchFollowers`;\n  handler: SocialService['fetchFollowers'];\n};\n\n/**\n * Fetches the list of traders a user is following.\n *\n * Calls `GET ${baseUrl}/users/${addressOrUid}/following`.\n *\n * @param options - Options bag.\n * @param options.addressOrUid - Wallet address or Clicker profile ID.\n * @returns The following response.\n */\nexport type SocialServiceFetchFollowingAction = {\n  type: `SocialService:fetchFollowing`;\n  handler: SocialService['fetchFollowing'];\n};\n\n/**\n * Follows one or more traders.\n *\n * Calls `PUT ${baseUrl}/users/${addressOrUid}/follows`.\n *\n * @param options - Options bag.\n * @param options.addressOrUid - Wallet address or Clicker profile ID of the user.\n * @param options.targets - Array of wallet addresses or profile IDs to follow.\n * @returns The follow response with confirmed follows.\n */\nexport type SocialServiceFollowAction = {\n  type: `SocialService:follow`;\n  handler: SocialService['follow'];\n};\n\n/**\n * Unfollows one or more traders.\n *\n * Calls `DELETE ${baseUrl}/users/${addressOrUid}/follows?targets=...`.\n * Targets are sent as query params because Fastify does not parse\n * request bodies on DELETE requests per RFC 9110.\n *\n * @param options - Options bag.\n * @param options.addressOrUid - Wallet address or Clicker profile ID of the user.\n * @param options.targets - Array of wallet addresses or profile IDs to unfollow.\n * @returns The unfollow response with confirmed unfollows.\n */\nexport type SocialServiceUnfollowAction = {\n  type: `SocialService:unfollow`;\n  handler: SocialService['unfollow'];\n};\n\n/**\n * Union of all SocialService action types.\n */\nexport type SocialServiceMethodActions =\n  | SocialServiceFetchLeaderboardAction\n  | SocialServiceFetchTraderProfileAction\n  | SocialServiceFetchOpenPositionsAction\n  | SocialServiceFetchClosedPositionsAction\n  | SocialServiceFetchFollowersAction\n  | SocialServiceFetchFollowingAction\n  | SocialServiceFollowAction\n  | SocialServiceUnfollowAction;\n"]}