@metamask/social-controllers 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,9 @@
+export type { SocialControllerActions, SocialControllerEvents, SocialControllerGetStateAction, SocialControllerMessenger, SocialControllerOptions, SocialControllerStateChangeEvent, } from "./SocialController.mjs";
+export { SocialController, getDefaultSocialControllerState, } from "./SocialController.mjs";
+export type { SocialControllerFollowTraderAction, SocialControllerUnfollowTraderAction, SocialControllerUpdateFollowingAction, SocialControllerUpdateLeaderboardAction, } from "./SocialController-method-action-types.mjs";
+export type { SocialServiceActions, SocialServiceEvents, SocialServiceMessenger, } from "./SocialService.mjs";
+export { SocialService } from "./SocialService.mjs";
+export type { SocialServiceFetchClosedPositionsAction, SocialServiceFetchFollowersAction, SocialServiceFetchFollowingAction, SocialServiceFetchLeaderboardAction, SocialServiceFetchOpenPositionsAction, SocialServiceFetchTraderProfileAction, SocialServiceFollowAction, SocialServiceUnfollowAction, } from "./SocialService-method-action-types.mjs";
+export type { FetchFollowersOptions, FetchFollowingOptions, FetchLeaderboardOptions, FetchPositionsOptions, FetchTraderProfileOptions, FollowersResponse, FollowingResponse, FollowOptions, FollowResponse, LeaderboardEntry, LeaderboardResponse, Pagination, PerChainBreakdown, Position, PositionsResponse, ProfileSummary, SocialControllerState, SocialHandles, Trade, TraderProfile, TraderProfileResponse, TraderStats, UnfollowOptions, UnfollowResponse, } from "./social-types.mjs";
+export { serviceName as socialServiceName, SocialServiceErrorMessage, } from "./social-constants.mjs";
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,uBAAuB,EACvB,sBAAsB,EACtB,8BAA8B,EAC9B,yBAAyB,EACzB,uBAAuB,EACvB,gCAAgC,GACjC,+BAA2B;AAC5B,OAAO,EACL,gBAAgB,EAChB,+BAA+B,GAChC,+BAA2B;AAE5B,YAAY,EACV,kCAAkC,EAClC,oCAAoC,EACpC,qCAAqC,EACrC,uCAAuC,GACxC,mDAA+C;AAEhD,YAAY,EACV,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,GACvB,4BAAwB;AACzB,OAAO,EAAE,aAAa,EAAE,4BAAwB;AAEhD,YAAY,EACV,uCAAuC,EACvC,iCAAiC,EACjC,iCAAiC,EACjC,mCAAmC,EACnC,qCAAqC,EACrC,qCAAqC,EACrC,yBAAyB,EACzB,2BAA2B,GAC5B,gDAA4C;AAE7C,YAAY,EACV,qBAAqB,EACrB,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EACrB,yBAAyB,EACzB,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,UAAU,EACV,iBAAiB,EACjB,QAAQ,EACR,iBAAiB,EACjB,cAAc,EACd,qBAAqB,EACrB,aAAa,EACb,KAAK,EACL,aAAa,EACb,qBAAqB,EACrB,WAAW,EACX,eAAe,EACf,gBAAgB,GACjB,2BAAuB;AAExB,OAAO,EACL,WAAW,IAAI,iBAAiB,EAChC,yBAAyB,GAC1B,+BAA2B"}

package/dist/index.mjs

@@ -0,0 +1,4 @@
+export { SocialController, getDefaultSocialControllerState } from "./SocialController.mjs";
+export { SocialService } from "./SocialService.mjs";
+export { serviceName as socialServiceName, SocialServiceErrorMessage } from "./social-constants.mjs";
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,gBAAgB,EAChB,+BAA+B,EAChC,+BAA2B;AAc5B,OAAO,EAAE,aAAa,EAAE,4BAAwB;AAwChD,OAAO,EACL,WAAW,IAAI,iBAAiB,EAChC,yBAAyB,EAC1B,+BAA2B","sourcesContent":["export type {\n  SocialControllerActions,\n  SocialControllerEvents,\n  SocialControllerGetStateAction,\n  SocialControllerMessenger,\n  SocialControllerOptions,\n  SocialControllerStateChangeEvent,\n} from './SocialController';\nexport {\n  SocialController,\n  getDefaultSocialControllerState,\n} from './SocialController';\n\nexport type {\n  SocialControllerFollowTraderAction,\n  SocialControllerUnfollowTraderAction,\n  SocialControllerUpdateFollowingAction,\n  SocialControllerUpdateLeaderboardAction,\n} from './SocialController-method-action-types';\n\nexport type {\n  SocialServiceActions,\n  SocialServiceEvents,\n  SocialServiceMessenger,\n} from './SocialService';\nexport { SocialService } from './SocialService';\n\nexport type {\n  SocialServiceFetchClosedPositionsAction,\n  SocialServiceFetchFollowersAction,\n  SocialServiceFetchFollowingAction,\n  SocialServiceFetchLeaderboardAction,\n  SocialServiceFetchOpenPositionsAction,\n  SocialServiceFetchTraderProfileAction,\n  SocialServiceFollowAction,\n  SocialServiceUnfollowAction,\n} from './SocialService-method-action-types';\n\nexport type {\n  FetchFollowersOptions,\n  FetchFollowingOptions,\n  FetchLeaderboardOptions,\n  FetchPositionsOptions,\n  FetchTraderProfileOptions,\n  FollowersResponse,\n  FollowingResponse,\n  FollowOptions,\n  FollowResponse,\n  LeaderboardEntry,\n  LeaderboardResponse,\n  Pagination,\n  PerChainBreakdown,\n  Position,\n  PositionsResponse,\n  ProfileSummary,\n  SocialControllerState,\n  SocialHandles,\n  Trade,\n  TraderProfile,\n  TraderProfileResponse,\n  TraderStats,\n  UnfollowOptions,\n  UnfollowResponse,\n} from './social-types';\n\nexport {\n  serviceName as socialServiceName,\n  SocialServiceErrorMessage,\n} from './social-constants';\n"]}

package/dist/social-constants.cjs

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SocialServiceErrorMessage = exports.controllerName = exports.serviceName = void 0;
+exports.serviceName = 'SocialService';
+exports.controllerName = 'SocialController';
+exports.SocialServiceErrorMessage = {
+    FETCH_LEADERBOARD_FAILED: 'SocialService: Leaderboard request failed',
+    FETCH_LEADERBOARD_INVALID_RESPONSE: 'SocialService: Leaderboard returned invalid response',
+    FETCH_TRADER_PROFILE_FAILED: 'SocialService: Trader profile request failed',
+    FETCH_TRADER_PROFILE_INVALID_RESPONSE: 'SocialService: Trader profile returned invalid response',
+    FETCH_OPEN_POSITIONS_FAILED: 'SocialService: Open positions request failed',
+    FETCH_OPEN_POSITIONS_INVALID_RESPONSE: 'SocialService: Open positions returned invalid response',
+    FETCH_CLOSED_POSITIONS_FAILED: 'SocialService: Closed positions request failed',
+    FETCH_CLOSED_POSITIONS_INVALID_RESPONSE: 'SocialService: Closed positions returned invalid response',
+    FETCH_FOLLOWERS_FAILED: 'SocialService: Followers request failed',
+    FETCH_FOLLOWERS_INVALID_RESPONSE: 'SocialService: Followers returned invalid response',
+    FETCH_FOLLOWING_FAILED: 'SocialService: Following request failed',
+    FETCH_FOLLOWING_INVALID_RESPONSE: 'SocialService: Following returned invalid response',
+    FOLLOW_FAILED: 'SocialService: Follow request failed',
+    FOLLOW_INVALID_RESPONSE: 'SocialService: Follow returned invalid response',
+    UNFOLLOW_FAILED: 'SocialService: Unfollow request failed',
+    UNFOLLOW_INVALID_RESPONSE: 'SocialService: Unfollow returned invalid response',
+};
+//# sourceMappingURL=social-constants.cjs.map

package/dist/social-constants.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"social-constants.cjs","sourceRoot":"","sources":["../src/social-constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,WAAW,GAAG,eAAe,CAAC;AAE9B,QAAA,cAAc,GAAG,kBAAkB,CAAC;AAEpC,QAAA,yBAAyB,GAAG;IACvC,wBAAwB,EAAE,2CAA2C;IACrE,kCAAkC,EAChC,sDAAsD;IACxD,2BAA2B,EAAE,8CAA8C;IAC3E,qCAAqC,EACnC,yDAAyD;IAC3D,2BAA2B,EAAE,8CAA8C;IAC3E,qCAAqC,EACnC,yDAAyD;IAC3D,6BAA6B,EAC3B,gDAAgD;IAClD,uCAAuC,EACrC,2DAA2D;IAC7D,sBAAsB,EAAE,yCAAyC;IACjE,gCAAgC,EAC9B,oDAAoD;IACtD,sBAAsB,EAAE,yCAAyC;IACjE,gCAAgC,EAC9B,oDAAoD;IACtD,aAAa,EAAE,sCAAsC;IACrD,uBAAuB,EAAE,iDAAiD;IAC1E,eAAe,EAAE,wCAAwC;IACzD,yBAAyB,EACvB,mDAAmD;CAC7C,CAAC","sourcesContent":["export const serviceName = 'SocialService';\n\nexport const controllerName = 'SocialController';\n\nexport const SocialServiceErrorMessage = {\n  FETCH_LEADERBOARD_FAILED: 'SocialService: Leaderboard request failed',\n  FETCH_LEADERBOARD_INVALID_RESPONSE:\n    'SocialService: Leaderboard returned invalid response',\n  FETCH_TRADER_PROFILE_FAILED: 'SocialService: Trader profile request failed',\n  FETCH_TRADER_PROFILE_INVALID_RESPONSE:\n    'SocialService: Trader profile returned invalid response',\n  FETCH_OPEN_POSITIONS_FAILED: 'SocialService: Open positions request failed',\n  FETCH_OPEN_POSITIONS_INVALID_RESPONSE:\n    'SocialService: Open positions returned invalid response',\n  FETCH_CLOSED_POSITIONS_FAILED:\n    'SocialService: Closed positions request failed',\n  FETCH_CLOSED_POSITIONS_INVALID_RESPONSE:\n    'SocialService: Closed positions returned invalid response',\n  FETCH_FOLLOWERS_FAILED: 'SocialService: Followers request failed',\n  FETCH_FOLLOWERS_INVALID_RESPONSE:\n    'SocialService: Followers returned invalid response',\n  FETCH_FOLLOWING_FAILED: 'SocialService: Following request failed',\n  FETCH_FOLLOWING_INVALID_RESPONSE:\n    'SocialService: Following returned invalid response',\n  FOLLOW_FAILED: 'SocialService: Follow request failed',\n  FOLLOW_INVALID_RESPONSE: 'SocialService: Follow returned invalid response',\n  UNFOLLOW_FAILED: 'SocialService: Unfollow request failed',\n  UNFOLLOW_INVALID_RESPONSE:\n    'SocialService: Unfollow returned invalid response',\n} as const;\n"]}

package/dist/social-constants.d.cts

@@ -0,0 +1,21 @@
+export declare const serviceName = "SocialService";
+export declare const controllerName = "SocialController";
+export declare const SocialServiceErrorMessage: {
+    readonly FETCH_LEADERBOARD_FAILED: "SocialService: Leaderboard request failed";
+    readonly FETCH_LEADERBOARD_INVALID_RESPONSE: "SocialService: Leaderboard returned invalid response";
+    readonly FETCH_TRADER_PROFILE_FAILED: "SocialService: Trader profile request failed";
+    readonly FETCH_TRADER_PROFILE_INVALID_RESPONSE: "SocialService: Trader profile returned invalid response";
+    readonly FETCH_OPEN_POSITIONS_FAILED: "SocialService: Open positions request failed";
+    readonly FETCH_OPEN_POSITIONS_INVALID_RESPONSE: "SocialService: Open positions returned invalid response";
+    readonly FETCH_CLOSED_POSITIONS_FAILED: "SocialService: Closed positions request failed";
+    readonly FETCH_CLOSED_POSITIONS_INVALID_RESPONSE: "SocialService: Closed positions returned invalid response";
+    readonly FETCH_FOLLOWERS_FAILED: "SocialService: Followers request failed";
+    readonly FETCH_FOLLOWERS_INVALID_RESPONSE: "SocialService: Followers returned invalid response";
+    readonly FETCH_FOLLOWING_FAILED: "SocialService: Following request failed";
+    readonly FETCH_FOLLOWING_INVALID_RESPONSE: "SocialService: Following returned invalid response";
+    readonly FOLLOW_FAILED: "SocialService: Follow request failed";
+    readonly FOLLOW_INVALID_RESPONSE: "SocialService: Follow returned invalid response";
+    readonly UNFOLLOW_FAILED: "SocialService: Unfollow request failed";
+    readonly UNFOLLOW_INVALID_RESPONSE: "SocialService: Unfollow returned invalid response";
+};
+//# sourceMappingURL=social-constants.d.cts.map

package/dist/social-constants.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"social-constants.d.cts","sourceRoot":"","sources":["../src/social-constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,kBAAkB,CAAC;AAE3C,eAAO,MAAM,cAAc,qBAAqB,CAAC;AAEjD,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;CAyB5B,CAAC"}

package/dist/social-constants.d.mts

@@ -0,0 +1,21 @@
+export declare const serviceName = "SocialService";
+export declare const controllerName = "SocialController";
+export declare const SocialServiceErrorMessage: {
+    readonly FETCH_LEADERBOARD_FAILED: "SocialService: Leaderboard request failed";
+    readonly FETCH_LEADERBOARD_INVALID_RESPONSE: "SocialService: Leaderboard returned invalid response";
+    readonly FETCH_TRADER_PROFILE_FAILED: "SocialService: Trader profile request failed";
+    readonly FETCH_TRADER_PROFILE_INVALID_RESPONSE: "SocialService: Trader profile returned invalid response";
+    readonly FETCH_OPEN_POSITIONS_FAILED: "SocialService: Open positions request failed";
+    readonly FETCH_OPEN_POSITIONS_INVALID_RESPONSE: "SocialService: Open positions returned invalid response";
+    readonly FETCH_CLOSED_POSITIONS_FAILED: "SocialService: Closed positions request failed";
+    readonly FETCH_CLOSED_POSITIONS_INVALID_RESPONSE: "SocialService: Closed positions returned invalid response";
+    readonly FETCH_FOLLOWERS_FAILED: "SocialService: Followers request failed";
+    readonly FETCH_FOLLOWERS_INVALID_RESPONSE: "SocialService: Followers returned invalid response";
+    readonly FETCH_FOLLOWING_FAILED: "SocialService: Following request failed";
+    readonly FETCH_FOLLOWING_INVALID_RESPONSE: "SocialService: Following returned invalid response";
+    readonly FOLLOW_FAILED: "SocialService: Follow request failed";
+    readonly FOLLOW_INVALID_RESPONSE: "SocialService: Follow returned invalid response";
+    readonly UNFOLLOW_FAILED: "SocialService: Unfollow request failed";
+    readonly UNFOLLOW_INVALID_RESPONSE: "SocialService: Unfollow returned invalid response";
+};
+//# sourceMappingURL=social-constants.d.mts.map

package/dist/social-constants.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"social-constants.d.mts","sourceRoot":"","sources":["../src/social-constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,kBAAkB,CAAC;AAE3C,eAAO,MAAM,cAAc,qBAAqB,CAAC;AAEjD,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;CAyB5B,CAAC"}

package/dist/social-constants.mjs

@@ -0,0 +1,21 @@
+export const serviceName = 'SocialService';
+export const controllerName = 'SocialController';
+export const SocialServiceErrorMessage = {
+    FETCH_LEADERBOARD_FAILED: 'SocialService: Leaderboard request failed',
+    FETCH_LEADERBOARD_INVALID_RESPONSE: 'SocialService: Leaderboard returned invalid response',
+    FETCH_TRADER_PROFILE_FAILED: 'SocialService: Trader profile request failed',
+    FETCH_TRADER_PROFILE_INVALID_RESPONSE: 'SocialService: Trader profile returned invalid response',
+    FETCH_OPEN_POSITIONS_FAILED: 'SocialService: Open positions request failed',
+    FETCH_OPEN_POSITIONS_INVALID_RESPONSE: 'SocialService: Open positions returned invalid response',
+    FETCH_CLOSED_POSITIONS_FAILED: 'SocialService: Closed positions request failed',
+    FETCH_CLOSED_POSITIONS_INVALID_RESPONSE: 'SocialService: Closed positions returned invalid response',
+    FETCH_FOLLOWERS_FAILED: 'SocialService: Followers request failed',
+    FETCH_FOLLOWERS_INVALID_RESPONSE: 'SocialService: Followers returned invalid response',
+    FETCH_FOLLOWING_FAILED: 'SocialService: Following request failed',
+    FETCH_FOLLOWING_INVALID_RESPONSE: 'SocialService: Following returned invalid response',
+    FOLLOW_FAILED: 'SocialService: Follow request failed',
+    FOLLOW_INVALID_RESPONSE: 'SocialService: Follow returned invalid response',
+    UNFOLLOW_FAILED: 'SocialService: Unfollow request failed',
+    UNFOLLOW_INVALID_RESPONSE: 'SocialService: Unfollow returned invalid response',
+};
+//# sourceMappingURL=social-constants.mjs.map

package/dist/social-constants.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"social-constants.mjs","sourceRoot":"","sources":["../src/social-constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,WAAW,GAAG,eAAe,CAAC;AAE3C,MAAM,CAAC,MAAM,cAAc,GAAG,kBAAkB,CAAC;AAEjD,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,wBAAwB,EAAE,2CAA2C;IACrE,kCAAkC,EAChC,sDAAsD;IACxD,2BAA2B,EAAE,8CAA8C;IAC3E,qCAAqC,EACnC,yDAAyD;IAC3D,2BAA2B,EAAE,8CAA8C;IAC3E,qCAAqC,EACnC,yDAAyD;IAC3D,6BAA6B,EAC3B,gDAAgD;IAClD,uCAAuC,EACrC,2DAA2D;IAC7D,sBAAsB,EAAE,yCAAyC;IACjE,gCAAgC,EAC9B,oDAAoD;IACtD,sBAAsB,EAAE,yCAAyC;IACjE,gCAAgC,EAC9B,oDAAoD;IACtD,aAAa,EAAE,sCAAsC;IACrD,uBAAuB,EAAE,iDAAiD;IAC1E,eAAe,EAAE,wCAAwC;IACzD,yBAAyB,EACvB,mDAAmD;CAC7C,CAAC","sourcesContent":["export const serviceName = 'SocialService';\n\nexport const controllerName = 'SocialController';\n\nexport const SocialServiceErrorMessage = {\n  FETCH_LEADERBOARD_FAILED: 'SocialService: Leaderboard request failed',\n  FETCH_LEADERBOARD_INVALID_RESPONSE:\n    'SocialService: Leaderboard returned invalid response',\n  FETCH_TRADER_PROFILE_FAILED: 'SocialService: Trader profile request failed',\n  FETCH_TRADER_PROFILE_INVALID_RESPONSE:\n    'SocialService: Trader profile returned invalid response',\n  FETCH_OPEN_POSITIONS_FAILED: 'SocialService: Open positions request failed',\n  FETCH_OPEN_POSITIONS_INVALID_RESPONSE:\n    'SocialService: Open positions returned invalid response',\n  FETCH_CLOSED_POSITIONS_FAILED:\n    'SocialService: Closed positions request failed',\n  FETCH_CLOSED_POSITIONS_INVALID_RESPONSE:\n    'SocialService: Closed positions returned invalid response',\n  FETCH_FOLLOWERS_FAILED: 'SocialService: Followers request failed',\n  FETCH_FOLLOWERS_INVALID_RESPONSE:\n    'SocialService: Followers returned invalid response',\n  FETCH_FOLLOWING_FAILED: 'SocialService: Following request failed',\n  FETCH_FOLLOWING_INVALID_RESPONSE:\n    'SocialService: Following returned invalid response',\n  FOLLOW_FAILED: 'SocialService: Follow request failed',\n  FOLLOW_INVALID_RESPONSE: 'SocialService: Follow returned invalid response',\n  UNFOLLOW_FAILED: 'SocialService: Unfollow request failed',\n  UNFOLLOW_INVALID_RESPONSE:\n    'SocialService: Unfollow returned invalid response',\n} as const;\n"]}

package/dist/social-types.cjs

@@ -0,0 +1,6 @@
+"use strict";
+// ---------------------------------------------------------------------------
+// Shared sub-types
+// ---------------------------------------------------------------------------
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=social-types.cjs.map

package/dist/social-types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"social-types.cjs","sourceRoot":"","sources":["../src/social-types.ts"],"names":[],"mappings":";AAAA,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E","sourcesContent":["// ---------------------------------------------------------------------------\n// Shared sub-types\n// ---------------------------------------------------------------------------\n\n/**\n * Minimal profile summary used across follow/follower responses.\n */\nexport type ProfileSummary = {\n  /** Clicker profile ID (UUID). */\n  profileId: string;\n  /** Primary wallet address. */\n  address: string;\n  /** Display name or truncated address. */\n  name: string;\n  /** Profile avatar URL. */\n  imageUrl?: string | null;\n};\n\n/**\n * Social media handles attached to a trader profile.\n */\nexport type SocialHandles = {\n  twitter?: string | null;\n  farcaster?: string | null;\n  ens?: string | null;\n  lens?: string | null;\n};\n\n/**\n * A single trade within a position.\n */\nexport type Trade = {\n  /** \"buy\" or \"sell\". */\n  direction: string;\n  /** Quantity traded. */\n  tokenAmount: number;\n  /** USD value of the trade. */\n  usdCost: number;\n  /** Unix timestamp. */\n  timestamp: number;\n  /** On-chain transaction hash. */\n  transactionHash: string;\n};\n\n// ---------------------------------------------------------------------------\n// Leaderboard\n// ---------------------------------------------------------------------------\n\n/**\n * A single entry in the leaderboard response.\n */\nexport type LeaderboardEntry = {\n  rank: number;\n  addresses: string[];\n  profileId: string;\n  name: string;\n  imageUrl?: string | null;\n  pnl30d: number;\n  winRate30d?: number | null;\n  /** Renamed from roi30d. */\n  roiPercent30d?: number | null;\n  /** Renamed from tradeCount. */\n  tradeCount30d?: number | null;\n  pnl7d?: number | null;\n  winRate7d?: number | null;\n  roiPercent7d?: number | null;\n  tradeCount7d?: number | null;\n  pnlPerChain: Record<string, number>;\n  followerCount: number;\n  socialHandles: SocialHandles;\n};\n\n/**\n * Response from `GET /v1/leaderboard`.\n */\nexport type LeaderboardResponse = {\n  traders: LeaderboardEntry[];\n};\n\n// ---------------------------------------------------------------------------\n// Trader profile\n// ---------------------------------------------------------------------------\n\nexport type TraderProfile = {\n  profileId: string;\n  address: string;\n  allAddresses: string[];\n  name: string;\n  imageUrl?: string | null;\n};\n\nexport type TraderStats = {\n  pnl30d?: number | null;\n  winRate30d?: number | null;\n  /** Renamed from roi30d. */\n  roiPercent30d?: number | null;\n  /** Renamed from tradeCount. */\n  tradeCount30d?: number | null;\n  pnl7d?: number | null;\n  winRate7d?: number | null;\n  roiPercent7d?: number | null;\n  tradeCount7d?: number | null;\n};\n\nexport type PerChainBreakdown = {\n  perChainPnl: Record<string, number>;\n  /** ROI can be null for chains with no trading activity (zero cost-basis). */\n  perChainRoi: Record<string, number | null>;\n  perChainVolume: Record<string, number>;\n};\n\n/**\n * Response from `GET /v1/traders/:addressOrId/profile`.\n */\nexport type TraderProfileResponse = {\n  profile: TraderProfile;\n  stats: TraderStats;\n  perChainBreakdown: PerChainBreakdown;\n  socialHandles: SocialHandles;\n  followerCount: number;\n  followingCount: number;\n};\n\n// ---------------------------------------------------------------------------\n// Positions\n// ---------------------------------------------------------------------------\n\nexport type Position = {\n  tokenSymbol: string;\n  tokenName: string;\n  tokenAddress: string;\n  chain: string;\n  positionAmount: number;\n  boughtUsd: number;\n  soldUsd: number;\n  realizedPnl: number;\n  costBasis: number;\n  trades: Trade[];\n  lastTradeAt: number;\n  /** Current USD value of the remaining position (open positions only). */\n  currentValueUSD?: number | null;\n  /** Unrealized + realized PnL in USD. */\n  pnlValueUsd?: number | null;\n  /** PnL as a percentage of cost basis. */\n  pnlPercent?: number | null;\n};\n\nexport type Pagination = {\n  hasMore: boolean;\n  nextPage?: number;\n};\n\n/**\n * Response from `GET /v1/traders/:addressOrId/positions/open`\n * and `GET /v1/traders/:addressOrId/positions/closed`.\n */\nexport type PositionsResponse = {\n  positions: Position[];\n  pagination: Pagination;\n  /** ISO 8601 timestamp indicating when the response was computed server-side. */\n  computedAt?: string | null;\n};\n\n// ---------------------------------------------------------------------------\n// Followers\n// ---------------------------------------------------------------------------\n\n/**\n * Response from `GET /v1/traders/:addressOrId/followers`.\n */\nexport type FollowersResponse = {\n  followers: ProfileSummary[];\n  count: number;\n};\n\n// ---------------------------------------------------------------------------\n// Following\n// ---------------------------------------------------------------------------\n\n/**\n * Response from `GET /v1/users/:addressOrUid/following`.\n */\nexport type FollowingResponse = {\n  following: ProfileSummary[];\n  count: number;\n};\n\n// ---------------------------------------------------------------------------\n// Follow / Unfollow\n// ---------------------------------------------------------------------------\n\n/**\n * Response from `PUT /v1/users/:addressOrUid/follows`.\n */\nexport type FollowResponse = {\n  followed: ProfileSummary[];\n};\n\n/**\n * Response from `DELETE /v1/users/:addressOrUid/follows`.\n */\nexport type UnfollowResponse = {\n  unfollowed: ProfileSummary[];\n};\n\n// ---------------------------------------------------------------------------\n// Fetch options\n// ---------------------------------------------------------------------------\n\nexport type FetchLeaderboardOptions = {\n  sort?: 'pnl' | 'winRate' | 'roi';\n  chains?: string[];\n  limit?: number;\n};\n\nexport type FetchTraderProfileOptions = {\n  /** Wallet address or Clicker profile ID. */\n  addressOrId: string;\n};\n\nexport type FetchPositionsOptions = {\n  /** Wallet address or Clicker profile ID. */\n  addressOrId: string;\n  chain?: string;\n  sort?: 'value' | 'latest';\n  limit?: number;\n  page?: number;\n};\n\nexport type FetchFollowersOptions = {\n  /** Wallet address or Clicker profile ID. */\n  addressOrId: string;\n};\n\nexport type FetchFollowingOptions = {\n  /** Wallet address or Clicker profile ID. */\n  addressOrUid: string;\n};\n\nexport type FollowOptions = {\n  /** Wallet address or Clicker profile ID of the user. */\n  addressOrUid: string;\n  /** Array of wallet addresses or profile IDs to follow. */\n  targets: string[];\n};\n\nexport type UnfollowOptions = {\n  /** Wallet address or Clicker profile ID of the user. */\n  addressOrUid: string;\n  /** Array of wallet addresses or profile IDs to unfollow. */\n  targets: string[];\n};\n\n// ---------------------------------------------------------------------------\n// Controller state\n// ---------------------------------------------------------------------------\n\n/**\n * State managed by the SocialController.\n *\n * The controller acts as a simple store — no TTL or eviction logic.\n * The UI decides when to re-fetch; the social-api's own cache layer\n * handles upstream rate-limiting.\n */\nexport type SocialControllerState = {\n  /** Cached ranked trader list from the last `updateLeaderboard` call. */\n  leaderboardEntries: LeaderboardEntry[];\n  /** Addresses the current user follows — drives Follow/Following button state. */\n  followingAddresses: string[];\n};\n"]}

package/dist/social-types.d.cts

@@ -0,0 +1,212 @@
+/**
+ * Minimal profile summary used across follow/follower responses.
+ */
+export type ProfileSummary = {
+    /** Clicker profile ID (UUID). */
+    profileId: string;
+    /** Primary wallet address. */
+    address: string;
+    /** Display name or truncated address. */
+    name: string;
+    /** Profile avatar URL. */
+    imageUrl?: string | null;
+};
+/**
+ * Social media handles attached to a trader profile.
+ */
+export type SocialHandles = {
+    twitter?: string | null;
+    farcaster?: string | null;
+    ens?: string | null;
+    lens?: string | null;
+};
+/**
+ * A single trade within a position.
+ */
+export type Trade = {
+    /** "buy" or "sell". */
+    direction: string;
+    /** Quantity traded. */
+    tokenAmount: number;
+    /** USD value of the trade. */
+    usdCost: number;
+    /** Unix timestamp. */
+    timestamp: number;
+    /** On-chain transaction hash. */
+    transactionHash: string;
+};
+/**
+ * A single entry in the leaderboard response.
+ */
+export type LeaderboardEntry = {
+    rank: number;
+    addresses: string[];
+    profileId: string;
+    name: string;
+    imageUrl?: string | null;
+    pnl30d: number;
+    winRate30d?: number | null;
+    /** Renamed from roi30d. */
+    roiPercent30d?: number | null;
+    /** Renamed from tradeCount. */
+    tradeCount30d?: number | null;
+    pnl7d?: number | null;
+    winRate7d?: number | null;
+    roiPercent7d?: number | null;
+    tradeCount7d?: number | null;
+    pnlPerChain: Record<string, number>;
+    followerCount: number;
+    socialHandles: SocialHandles;
+};
+/**
+ * Response from `GET /v1/leaderboard`.
+ */
+export type LeaderboardResponse = {
+    traders: LeaderboardEntry[];
+};
+export type TraderProfile = {
+    profileId: string;
+    address: string;
+    allAddresses: string[];
+    name: string;
+    imageUrl?: string | null;
+};
+export type TraderStats = {
+    pnl30d?: number | null;
+    winRate30d?: number | null;
+    /** Renamed from roi30d. */
+    roiPercent30d?: number | null;
+    /** Renamed from tradeCount. */
+    tradeCount30d?: number | null;
+    pnl7d?: number | null;
+    winRate7d?: number | null;
+    roiPercent7d?: number | null;
+    tradeCount7d?: number | null;
+};
+export type PerChainBreakdown = {
+    perChainPnl: Record<string, number>;
+    /** ROI can be null for chains with no trading activity (zero cost-basis). */
+    perChainRoi: Record<string, number | null>;
+    perChainVolume: Record<string, number>;
+};
+/**
+ * Response from `GET /v1/traders/:addressOrId/profile`.
+ */
+export type TraderProfileResponse = {
+    profile: TraderProfile;
+    stats: TraderStats;
+    perChainBreakdown: PerChainBreakdown;
+    socialHandles: SocialHandles;
+    followerCount: number;
+    followingCount: number;
+};
+export type Position = {
+    tokenSymbol: string;
+    tokenName: string;
+    tokenAddress: string;
+    chain: string;
+    positionAmount: number;
+    boughtUsd: number;
+    soldUsd: number;
+    realizedPnl: number;
+    costBasis: number;
+    trades: Trade[];
+    lastTradeAt: number;
+    /** Current USD value of the remaining position (open positions only). */
+    currentValueUSD?: number | null;
+    /** Unrealized + realized PnL in USD. */
+    pnlValueUsd?: number | null;
+    /** PnL as a percentage of cost basis. */
+    pnlPercent?: number | null;
+};
+export type Pagination = {
+    hasMore: boolean;
+    nextPage?: number;
+};
+/**
+ * Response from `GET /v1/traders/:addressOrId/positions/open`
+ * and `GET /v1/traders/:addressOrId/positions/closed`.
+ */
+export type PositionsResponse = {
+    positions: Position[];
+    pagination: Pagination;
+    /** ISO 8601 timestamp indicating when the response was computed server-side. */
+    computedAt?: string | null;
+};
+/**
+ * Response from `GET /v1/traders/:addressOrId/followers`.
+ */
+export type FollowersResponse = {
+    followers: ProfileSummary[];
+    count: number;
+};
+/**
+ * Response from `GET /v1/users/:addressOrUid/following`.
+ */
+export type FollowingResponse = {
+    following: ProfileSummary[];
+    count: number;
+};
+/**
+ * Response from `PUT /v1/users/:addressOrUid/follows`.
+ */
+export type FollowResponse = {
+    followed: ProfileSummary[];
+};
+/**
+ * Response from `DELETE /v1/users/:addressOrUid/follows`.
+ */
+export type UnfollowResponse = {
+    unfollowed: ProfileSummary[];
+};
+export type FetchLeaderboardOptions = {
+    sort?: 'pnl' | 'winRate' | 'roi';
+    chains?: string[];
+    limit?: number;
+};
+export type FetchTraderProfileOptions = {
+    /** Wallet address or Clicker profile ID. */
+    addressOrId: string;
+};
+export type FetchPositionsOptions = {
+    /** Wallet address or Clicker profile ID. */
+    addressOrId: string;
+    chain?: string;
+    sort?: 'value' | 'latest';
+    limit?: number;
+    page?: number;
+};
+export type FetchFollowersOptions = {
+    /** Wallet address or Clicker profile ID. */
+    addressOrId: string;
+};
+export type FetchFollowingOptions = {
+    /** Wallet address or Clicker profile ID. */
+    addressOrUid: string;
+};
+export type FollowOptions = {
+    /** Wallet address or Clicker profile ID of the user. */
+    addressOrUid: string;
+    /** Array of wallet addresses or profile IDs to follow. */
+    targets: string[];
+};
+export type UnfollowOptions = {
+    /** Wallet address or Clicker profile ID of the user. */
+    addressOrUid: string;
+    /** Array of wallet addresses or profile IDs to unfollow. */
+    targets: string[];
+};
+/**
+ * State managed by the SocialController.
+ *
+ * The controller acts as a simple store — no TTL or eviction logic.
+ * The UI decides when to re-fetch; the social-api's own cache layer
+ * handles upstream rate-limiting.
+ */
+export type SocialControllerState = {
+    /** Cached ranked trader list from the last `updateLeaderboard` call. */
+    leaderboardEntries: LeaderboardEntry[];
+    /** Addresses the current user follows — drives Follow/Following button state. */
+    followingAddresses: string[];
+};
+//# sourceMappingURL=social-types.d.cts.map

package/dist/social-types.d.cts.map

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

package/dist/social-types.d.mts

@@ -0,0 +1,212 @@
+/**
+ * Minimal profile summary used across follow/follower responses.
+ */
+export type ProfileSummary = {
+    /** Clicker profile ID (UUID). */
+    profileId: string;
+    /** Primary wallet address. */
+    address: string;
+    /** Display name or truncated address. */
+    name: string;
+    /** Profile avatar URL. */
+    imageUrl?: string | null;
+};
+/**
+ * Social media handles attached to a trader profile.
+ */
+export type SocialHandles = {
+    twitter?: string | null;
+    farcaster?: string | null;
+    ens?: string | null;
+    lens?: string | null;
+};
+/**
+ * A single trade within a position.
+ */
+export type Trade = {
+    /** "buy" or "sell". */
+    direction: string;
+    /** Quantity traded. */
+    tokenAmount: number;
+    /** USD value of the trade. */
+    usdCost: number;
+    /** Unix timestamp. */
+    timestamp: number;
+    /** On-chain transaction hash. */
+    transactionHash: string;
+};
+/**
+ * A single entry in the leaderboard response.
+ */
+export type LeaderboardEntry = {
+    rank: number;
+    addresses: string[];
+    profileId: string;
+    name: string;
+    imageUrl?: string | null;
+    pnl30d: number;
+    winRate30d?: number | null;
+    /** Renamed from roi30d. */
+    roiPercent30d?: number | null;
+    /** Renamed from tradeCount. */
+    tradeCount30d?: number | null;
+    pnl7d?: number | null;
+    winRate7d?: number | null;
+    roiPercent7d?: number | null;
+    tradeCount7d?: number | null;
+    pnlPerChain: Record<string, number>;
+    followerCount: number;
+    socialHandles: SocialHandles;
+};
+/**
+ * Response from `GET /v1/leaderboard`.
+ */
+export type LeaderboardResponse = {
+    traders: LeaderboardEntry[];
+};
+export type TraderProfile = {
+    profileId: string;
+    address: string;
+    allAddresses: string[];
+    name: string;
+    imageUrl?: string | null;
+};
+export type TraderStats = {
+    pnl30d?: number | null;
+    winRate30d?: number | null;
+    /** Renamed from roi30d. */
+    roiPercent30d?: number | null;
+    /** Renamed from tradeCount. */
+    tradeCount30d?: number | null;
+    pnl7d?: number | null;
+    winRate7d?: number | null;
+    roiPercent7d?: number | null;
+    tradeCount7d?: number | null;
+};
+export type PerChainBreakdown = {
+    perChainPnl: Record<string, number>;
+    /** ROI can be null for chains with no trading activity (zero cost-basis). */
+    perChainRoi: Record<string, number | null>;
+    perChainVolume: Record<string, number>;
+};
+/**
+ * Response from `GET /v1/traders/:addressOrId/profile`.
+ */
+export type TraderProfileResponse = {
+    profile: TraderProfile;
+    stats: TraderStats;
+    perChainBreakdown: PerChainBreakdown;
+    socialHandles: SocialHandles;
+    followerCount: number;
+    followingCount: number;
+};
+export type Position = {
+    tokenSymbol: string;
+    tokenName: string;
+    tokenAddress: string;
+    chain: string;
+    positionAmount: number;
+    boughtUsd: number;
+    soldUsd: number;
+    realizedPnl: number;
+    costBasis: number;
+    trades: Trade[];
+    lastTradeAt: number;
+    /** Current USD value of the remaining position (open positions only). */
+    currentValueUSD?: number | null;
+    /** Unrealized + realized PnL in USD. */
+    pnlValueUsd?: number | null;
+    /** PnL as a percentage of cost basis. */
+    pnlPercent?: number | null;
+};
+export type Pagination = {
+    hasMore: boolean;
+    nextPage?: number;
+};
+/**
+ * Response from `GET /v1/traders/:addressOrId/positions/open`
+ * and `GET /v1/traders/:addressOrId/positions/closed`.
+ */
+export type PositionsResponse = {
+    positions: Position[];
+    pagination: Pagination;
+    /** ISO 8601 timestamp indicating when the response was computed server-side. */
+    computedAt?: string | null;
+};
+/**
+ * Response from `GET /v1/traders/:addressOrId/followers`.
+ */
+export type FollowersResponse = {
+    followers: ProfileSummary[];
+    count: number;
+};
+/**
+ * Response from `GET /v1/users/:addressOrUid/following`.
+ */
+export type FollowingResponse = {
+    following: ProfileSummary[];
+    count: number;
+};
+/**
+ * Response from `PUT /v1/users/:addressOrUid/follows`.
+ */
+export type FollowResponse = {
+    followed: ProfileSummary[];
+};
+/**
+ * Response from `DELETE /v1/users/:addressOrUid/follows`.
+ */
+export type UnfollowResponse = {
+    unfollowed: ProfileSummary[];
+};
+export type FetchLeaderboardOptions = {
+    sort?: 'pnl' | 'winRate' | 'roi';
+    chains?: string[];
+    limit?: number;
+};
+export type FetchTraderProfileOptions = {
+    /** Wallet address or Clicker profile ID. */
+    addressOrId: string;
+};
+export type FetchPositionsOptions = {
+    /** Wallet address or Clicker profile ID. */
+    addressOrId: string;
+    chain?: string;
+    sort?: 'value' | 'latest';
+    limit?: number;
+    page?: number;
+};
+export type FetchFollowersOptions = {
+    /** Wallet address or Clicker profile ID. */
+    addressOrId: string;
+};
+export type FetchFollowingOptions = {
+    /** Wallet address or Clicker profile ID. */
+    addressOrUid: string;
+};
+export type FollowOptions = {
+    /** Wallet address or Clicker profile ID of the user. */
+    addressOrUid: string;
+    /** Array of wallet addresses or profile IDs to follow. */
+    targets: string[];
+};
+export type UnfollowOptions = {
+    /** Wallet address or Clicker profile ID of the user. */
+    addressOrUid: string;
+    /** Array of wallet addresses or profile IDs to unfollow. */
+    targets: string[];
+};
+/**
+ * State managed by the SocialController.
+ *
+ * The controller acts as a simple store — no TTL or eviction logic.
+ * The UI decides when to re-fetch; the social-api's own cache layer
+ * handles upstream rate-limiting.
+ */
+export type SocialControllerState = {
+    /** Cached ranked trader list from the last `updateLeaderboard` call. */
+    leaderboardEntries: LeaderboardEntry[];
+    /** Addresses the current user follows — drives Follow/Following button state. */
+    followingAddresses: string[];
+};
+//# sourceMappingURL=social-types.d.mts.map

package/dist/social-types.d.mts.map

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

package/dist/social-types.mjs

@@ -0,0 +1,5 @@
+// ---------------------------------------------------------------------------
+// Shared sub-types
+// ---------------------------------------------------------------------------
+export {};
+//# sourceMappingURL=social-types.mjs.map

package/dist/social-types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"social-types.mjs","sourceRoot":"","sources":["../src/social-types.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,mBAAmB;AACnB,8EAA8E","sourcesContent":["// ---------------------------------------------------------------------------\n// Shared sub-types\n// ---------------------------------------------------------------------------\n\n/**\n * Minimal profile summary used across follow/follower responses.\n */\nexport type ProfileSummary = {\n  /** Clicker profile ID (UUID). */\n  profileId: string;\n  /** Primary wallet address. */\n  address: string;\n  /** Display name or truncated address. */\n  name: string;\n  /** Profile avatar URL. */\n  imageUrl?: string | null;\n};\n\n/**\n * Social media handles attached to a trader profile.\n */\nexport type SocialHandles = {\n  twitter?: string | null;\n  farcaster?: string | null;\n  ens?: string | null;\n  lens?: string | null;\n};\n\n/**\n * A single trade within a position.\n */\nexport type Trade = {\n  /** \"buy\" or \"sell\". */\n  direction: string;\n  /** Quantity traded. */\n  tokenAmount: number;\n  /** USD value of the trade. */\n  usdCost: number;\n  /** Unix timestamp. */\n  timestamp: number;\n  /** On-chain transaction hash. */\n  transactionHash: string;\n};\n\n// ---------------------------------------------------------------------------\n// Leaderboard\n// ---------------------------------------------------------------------------\n\n/**\n * A single entry in the leaderboard response.\n */\nexport type LeaderboardEntry = {\n  rank: number;\n  addresses: string[];\n  profileId: string;\n  name: string;\n  imageUrl?: string | null;\n  pnl30d: number;\n  winRate30d?: number | null;\n  /** Renamed from roi30d. */\n  roiPercent30d?: number | null;\n  /** Renamed from tradeCount. */\n  tradeCount30d?: number | null;\n  pnl7d?: number | null;\n  winRate7d?: number | null;\n  roiPercent7d?: number | null;\n  tradeCount7d?: number | null;\n  pnlPerChain: Record<string, number>;\n  followerCount: number;\n  socialHandles: SocialHandles;\n};\n\n/**\n * Response from `GET /v1/leaderboard`.\n */\nexport type LeaderboardResponse = {\n  traders: LeaderboardEntry[];\n};\n\n// ---------------------------------------------------------------------------\n// Trader profile\n// ---------------------------------------------------------------------------\n\nexport type TraderProfile = {\n  profileId: string;\n  address: string;\n  allAddresses: string[];\n  name: string;\n  imageUrl?: string | null;\n};\n\nexport type TraderStats = {\n  pnl30d?: number | null;\n  winRate30d?: number | null;\n  /** Renamed from roi30d. */\n  roiPercent30d?: number | null;\n  /** Renamed from tradeCount. */\n  tradeCount30d?: number | null;\n  pnl7d?: number | null;\n  winRate7d?: number | null;\n  roiPercent7d?: number | null;\n  tradeCount7d?: number | null;\n};\n\nexport type PerChainBreakdown = {\n  perChainPnl: Record<string, number>;\n  /** ROI can be null for chains with no trading activity (zero cost-basis). */\n  perChainRoi: Record<string, number | null>;\n  perChainVolume: Record<string, number>;\n};\n\n/**\n * Response from `GET /v1/traders/:addressOrId/profile`.\n */\nexport type TraderProfileResponse = {\n  profile: TraderProfile;\n  stats: TraderStats;\n  perChainBreakdown: PerChainBreakdown;\n  socialHandles: SocialHandles;\n  followerCount: number;\n  followingCount: number;\n};\n\n// ---------------------------------------------------------------------------\n// Positions\n// ---------------------------------------------------------------------------\n\nexport type Position = {\n  tokenSymbol: string;\n  tokenName: string;\n  tokenAddress: string;\n  chain: string;\n  positionAmount: number;\n  boughtUsd: number;\n  soldUsd: number;\n  realizedPnl: number;\n  costBasis: number;\n  trades: Trade[];\n  lastTradeAt: number;\n  /** Current USD value of the remaining position (open positions only). */\n  currentValueUSD?: number | null;\n  /** Unrealized + realized PnL in USD. */\n  pnlValueUsd?: number | null;\n  /** PnL as a percentage of cost basis. */\n  pnlPercent?: number | null;\n};\n\nexport type Pagination = {\n  hasMore: boolean;\n  nextPage?: number;\n};\n\n/**\n * Response from `GET /v1/traders/:addressOrId/positions/open`\n * and `GET /v1/traders/:addressOrId/positions/closed`.\n */\nexport type PositionsResponse = {\n  positions: Position[];\n  pagination: Pagination;\n  /** ISO 8601 timestamp indicating when the response was computed server-side. */\n  computedAt?: string | null;\n};\n\n// ---------------------------------------------------------------------------\n// Followers\n// ---------------------------------------------------------------------------\n\n/**\n * Response from `GET /v1/traders/:addressOrId/followers`.\n */\nexport type FollowersResponse = {\n  followers: ProfileSummary[];\n  count: number;\n};\n\n// ---------------------------------------------------------------------------\n// Following\n// ---------------------------------------------------------------------------\n\n/**\n * Response from `GET /v1/users/:addressOrUid/following`.\n */\nexport type FollowingResponse = {\n  following: ProfileSummary[];\n  count: number;\n};\n\n// ---------------------------------------------------------------------------\n// Follow / Unfollow\n// ---------------------------------------------------------------------------\n\n/**\n * Response from `PUT /v1/users/:addressOrUid/follows`.\n */\nexport type FollowResponse = {\n  followed: ProfileSummary[];\n};\n\n/**\n * Response from `DELETE /v1/users/:addressOrUid/follows`.\n */\nexport type UnfollowResponse = {\n  unfollowed: ProfileSummary[];\n};\n\n// ---------------------------------------------------------------------------\n// Fetch options\n// ---------------------------------------------------------------------------\n\nexport type FetchLeaderboardOptions = {\n  sort?: 'pnl' | 'winRate' | 'roi';\n  chains?: string[];\n  limit?: number;\n};\n\nexport type FetchTraderProfileOptions = {\n  /** Wallet address or Clicker profile ID. */\n  addressOrId: string;\n};\n\nexport type FetchPositionsOptions = {\n  /** Wallet address or Clicker profile ID. */\n  addressOrId: string;\n  chain?: string;\n  sort?: 'value' | 'latest';\n  limit?: number;\n  page?: number;\n};\n\nexport type FetchFollowersOptions = {\n  /** Wallet address or Clicker profile ID. */\n  addressOrId: string;\n};\n\nexport type FetchFollowingOptions = {\n  /** Wallet address or Clicker profile ID. */\n  addressOrUid: string;\n};\n\nexport type FollowOptions = {\n  /** Wallet address or Clicker profile ID of the user. */\n  addressOrUid: string;\n  /** Array of wallet addresses or profile IDs to follow. */\n  targets: string[];\n};\n\nexport type UnfollowOptions = {\n  /** Wallet address or Clicker profile ID of the user. */\n  addressOrUid: string;\n  /** Array of wallet addresses or profile IDs to unfollow. */\n  targets: string[];\n};\n\n// ---------------------------------------------------------------------------\n// Controller state\n// ---------------------------------------------------------------------------\n\n/**\n * State managed by the SocialController.\n *\n * The controller acts as a simple store — no TTL or eviction logic.\n * The UI decides when to re-fetch; the social-api's own cache layer\n * handles upstream rate-limiting.\n */\nexport type SocialControllerState = {\n  /** Cached ranked trader list from the last `updateLeaderboard` call. */\n  leaderboardEntries: LeaderboardEntry[];\n  /** Addresses the current user follows — drives Follow/Following button state. */\n  followingAddresses: string[];\n};\n"]}