@metamask/social-controllers 2.8.1 → 3.0.0

package/dist/social-types.cjs

@@ -1,27 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TradeStruct = void 0;
-const superstruct_1 = require("@metamask/superstruct");
-exports.TradeStruct = (0, superstruct_1.type)({
-    direction: (0, superstruct_1.enums)(['buy', 'sell']),
-    intent: (0, superstruct_1.enums)(['enter', 'exit']),
-    /**
-     * Lifecycle stage of this fill. Absent on responses from a social-api that
-     * predates the field, so treat it as a hint and keep a client-side fallback.
-     */
-    action: (0, superstruct_1.optional)((0, superstruct_1.enums)(['opened', 'added', 'reduced', 'closed'])),
-    category: (0, superstruct_1.optional)((0, superstruct_1.string)()),
-    /** High-level trade classification. `null` when Clicker does not classify. */
-    classification: (0, superstruct_1.optional)((0, superstruct_1.nullable)((0, superstruct_1.enums)(['spot', 'perp', 'send', 'receive']))),
-    /** Perp side for this fill. `null` for spot trades. */
-    perpPositionType: (0, superstruct_1.optional)((0, superstruct_1.nullable)((0, superstruct_1.enums)(['long', 'short']))),
-    /** Leverage multiplier for perp trades (e.g. `5` for 5x). `null` for spot. */
-    perpLeverage: (0, superstruct_1.optional)((0, superstruct_1.nullable)((0, superstruct_1.number)())),
-    tokenAmount: (0, superstruct_1.number)(),
-    usdCost: (0, superstruct_1.number)(),
-    /** Token market cap in USD at trade time. `null` when Clicker has no mark. */
-    marketCap: (0, superstruct_1.optional)((0, superstruct_1.nullable)((0, superstruct_1.number)())),
-    timestamp: (0, superstruct_1.number)(),
-    transactionHash: (0, superstruct_1.string)(),
-});
-//# sourceMappingURL=social-types.cjs.map

package/dist/social-types.cjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"social-types.cjs","sourceRoot":"","sources":["../src/social-types.ts"],"names":[],"mappings":";;;AACA,uDAO+B;AA0ClB,QAAA,WAAW,GAAG,IAAA,kBAAU,EAAC;IACpC,SAAS,EAAE,IAAA,mBAAK,EAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,EAAE,IAAA,mBAAK,EAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAChC;;;OAGG;IACH,MAAM,EAAE,IAAA,sBAAQ,EAAC,IAAA,mBAAK,EAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;IACjE,QAAQ,EAAE,IAAA,sBAAQ,EAAC,IAAA,oBAAM,GAAE,CAAC;IAC5B,8EAA8E;IAC9E,cAAc,EAAE,IAAA,sBAAQ,EACtB,IAAA,sBAAQ,EAAC,IAAA,mBAAK,EAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CACrD;IACD,uDAAuD;IACvD,gBAAgB,EAAE,IAAA,sBAAQ,EAAC,IAAA,sBAAQ,EAAC,IAAA,mBAAK,EAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAC9D,8EAA8E;IAC9E,YAAY,EAAE,IAAA,sBAAQ,EAAC,IAAA,sBAAQ,EAAC,IAAA,oBAAM,GAAE,CAAC,CAAC;IAC1C,WAAW,EAAE,IAAA,oBAAM,GAAE;IACrB,OAAO,EAAE,IAAA,oBAAM,GAAE;IACjB,8EAA8E;IAC9E,SAAS,EAAE,IAAA,sBAAQ,EAAC,IAAA,sBAAQ,EAAC,IAAA,oBAAM,GAAE,CAAC,CAAC;IACvC,SAAS,EAAE,IAAA,oBAAM,GAAE;IACnB,eAAe,EAAE,IAAA,oBAAM,GAAE;CAC1B,CAAC,CAAC","sourcesContent":["import type { Infer } from '@metamask/superstruct';\nimport {\n  enums,\n  nullable,\n  number,\n  optional,\n  string,\n  type as structType,\n} from '@metamask/superstruct';\n\n// ---------------------------------------------------------------------------\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 * Where a fill sits in its position's lifecycle.\n *\n * Deliberately asset-agnostic so the classification is computed once, upstream:\n * clients render `opened / added / reduced / closed` for perps and\n * `bought / bought more / sold some / sold all` for spot from the same value.\n *\n * Distinct from `intent`, which only says whether the fill grew or shrank the\n * position — `intent: 'exit'` covers both a partial trim and a full close.\n */\nexport type TradeAction = 'opened' | 'added' | 'reduced' | 'closed';\n\nexport const TradeStruct = structType({\n  direction: enums(['buy', 'sell']),\n  intent: enums(['enter', 'exit']),\n  /**\n   * Lifecycle stage of this fill. Absent on responses from a social-api that\n   * predates the field, so treat it as a hint and keep a client-side fallback.\n   */\n  action: optional(enums(['opened', 'added', 'reduced', 'closed'])),\n  category: optional(string()),\n  /** High-level trade classification. `null` when Clicker does not classify. */\n  classification: optional(\n    nullable(enums(['spot', 'perp', 'send', 'receive'])),\n  ),\n  /** Perp side for this fill. `null` for spot trades. */\n  perpPositionType: optional(nullable(enums(['long', 'short']))),\n  /** Leverage multiplier for perp trades (e.g. `5` for 5x). `null` for spot. */\n  perpLeverage: optional(nullable(number())),\n  tokenAmount: number(),\n  usdCost: number(),\n  /** Token market cap in USD at trade time. `null` when Clicker has no mark. */\n  marketCap: optional(nullable(number())),\n  timestamp: number(),\n  transactionHash: string(),\n});\n\nexport type Trade = Infer<typeof TradeStruct>;\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  /** Median holding time in minutes. */\n  medianHoldMinutes?: 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   * 7-day per-chain PnL in USD. Optional: older social-api versions only\n   * return the 30-day breakdown (`perChainPnl`). The unsuffixed fields above\n   * remain the 30-day window for backward compatibility.\n   */\n  perChainPnl7d?: Record<string, number>;\n  /** 7-day per-chain ROI. Null for chains with no trading activity. */\n  perChainRoi7d?: Record<string, number | null>;\n  /** 7-day per-chain volume in USD. */\n  perChainVolume7d?: 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  positionId: string;\n  tokenSymbol: string;\n  tokenName: string;\n  tokenAddress: string;\n  chain: string;\n  positionAmount: number;\n  /**\n   * Whether the position still carries exposure. Clicker's own verdict, which\n   * beats a `positionAmount === 0` check: it survives precision dust and\n   * distinguishes \"no position\" from \"a position of size ~0\". Absent on\n   * responses from a social-api that predates the field.\n   */\n  isOpen?: boolean;\n  boughtUsd: number;\n  soldUsd: number;\n  realizedPnl: number;\n  costBasis: number;\n  trades: Trade[];\n  lastTradeAt: number;\n  /** Daylight-hosted token image URL. */\n  tokenImageUrl?: string | null;\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  /** Perp side of the position. `null`/absent for spot positions. */\n  perpPositionType?: 'long' | 'short' | null;\n  /** Leverage multiplier for perp positions. `null`/absent for spot. */\n  perpLeverage?: number | null;\n  /**\n   * Leveraged/notional position size as reported by Clicker. NOT necessarily\n   * `positionAmount` × `perpLeverage` — the ratio varies for positions built\n   * across fills at different leverage, so use this field directly rather than\n   * deriving it, and treat `perpLeverage` as the authoritative leverage. This is\n   * notional exposure, not capital at risk (the margin/capital at risk is\n   * `costBasis`). Hyperliquid/perp positions only; absent for spot.\n   */\n  positionAmountWithLeverage?: 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// Feed\n// ---------------------------------------------------------------------------\n\n/**\n * A single trader-activity feed item: a {@link Position} the trade belongs to,\n * plus the {@link ProfileSummary} of the trader who made it (`actor`) and the\n * item's creation `timestamp` (Unix seconds).\n */\nexport type FeedItem = Position & {\n  /** The trader who made this trade. */\n  actor: ProfileSummary;\n  /** Unix timestamp (seconds) when the feed item was created. */\n  timestamp: number;\n};\n\n/**\n * Cursor pagination for the feed. Pass `olderCursor` back as `olderThan` to\n * load older items (infinite scroll), and `newerCursor` as `newerThan` to\n * fetch newer items. `null` when there are no items in that direction.\n */\nexport type FeedPagination = {\n  olderCursor: string | null;\n  newerCursor: string | null;\n};\n\n/**\n * Response from `GET /v1/feed`.\n */\nexport type FeedResponse = {\n  items: FeedItem[];\n  pagination: FeedPagination;\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/me/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/me/follows`.\n */\nexport type FollowResponse = {\n  followed: ProfileSummary[];\n};\n\n/**\n * Response from `DELETE /v1/users/me/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 FetchFeedOptions = {\n  /**\n   * Which feed to fetch: `following` (personalized to the current user,\n   * identified server-side from the JWT) or `leaderboard` (generic, shared by\n   * all users). Defaults to `following` server-side when omitted.\n   */\n  scope?: 'following' | 'leaderboard';\n  /**\n   * Filter by one or more chains, given as CAIP-2 chain ids (e.g.\n   * `eip155:8453`). Omit for the server defaults.\n   */\n  chains?: string[];\n  /** Number of results to return. */\n  limit?: number;\n  /** Cursor for older items (infinite scroll). Use `pagination.olderCursor`. */\n  olderThan?: string;\n  /** Cursor for newer items (pull to refresh). Use `pagination.newerCursor`. */\n  newerThan?: string;\n};\n\nexport type FetchPositionByIdOptions = {\n  /** Unique position ID (UUID). */\n  positionId: string;\n};\n\nexport type FollowOptions = {\n  /** Array of wallet addresses or profile IDs to follow. */\n  targets: string[];\n};\n\nexport type UnfollowOptions = {\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  /** Wallet addresses the current user follows. */\n  followingAddresses: string[];\n  /** Clicker profile IDs the current user follows — used by mobile UI. */\n  followingProfileIds: string[];\n};\n"]}

package/dist/social-types.d.cts

@@ -1,343 +0,0 @@
-import type { Infer } from "@metamask/superstruct";
-/**
- * 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;
-};
-/**
- * Where a fill sits in its position's lifecycle.
- *
- * Deliberately asset-agnostic so the classification is computed once, upstream:
- * clients render `opened / added / reduced / closed` for perps and
- * `bought / bought more / sold some / sold all` for spot from the same value.
- *
- * Distinct from `intent`, which only says whether the fill grew or shrank the
- * position — `intent: 'exit'` covers both a partial trim and a full close.
- */
-export type TradeAction = 'opened' | 'added' | 'reduced' | 'closed';
-export declare const TradeStruct: import("@metamask/superstruct").Struct<{
-    direction: "buy" | "sell";
-    intent: "enter" | "exit";
-    tokenAmount: number;
-    usdCost: number;
-    timestamp: number;
-    transactionHash: string;
-    action?: "opened" | "added" | "reduced" | "closed" | undefined;
-    category?: string | undefined;
-    classification?: "spot" | "perp" | "send" | "receive" | null | undefined;
-    perpPositionType?: "long" | "short" | null | undefined;
-    perpLeverage?: number | null | undefined;
-    marketCap?: number | null | undefined;
-}, {
-    direction: import("@metamask/superstruct").Struct<"buy" | "sell", {
-        buy: "buy";
-        sell: "sell";
-    }>;
-    intent: import("@metamask/superstruct").Struct<"enter" | "exit", {
-        enter: "enter";
-        exit: "exit";
-    }>;
-    /**
-     * Lifecycle stage of this fill. Absent on responses from a social-api that
-     * predates the field, so treat it as a hint and keep a client-side fallback.
-     */
-    action: import("@metamask/superstruct").Struct<"opened" | "added" | "reduced" | "closed" | undefined, {
-        opened: "opened";
-        added: "added";
-        reduced: "reduced";
-        closed: "closed";
-    }>;
-    category: import("@metamask/superstruct").Struct<string | undefined, null>;
-    /** High-level trade classification. `null` when Clicker does not classify. */
-    classification: import("@metamask/superstruct").Struct<"spot" | "perp" | "send" | "receive" | null | undefined, {
-        spot: "spot";
-        perp: "perp";
-        send: "send";
-        receive: "receive";
-    }>;
-    /** Perp side for this fill. `null` for spot trades. */
-    perpPositionType: import("@metamask/superstruct").Struct<"long" | "short" | null | undefined, {
-        long: "long";
-        short: "short";
-    }>;
-    /** Leverage multiplier for perp trades (e.g. `5` for 5x). `null` for spot. */
-    perpLeverage: import("@metamask/superstruct").Struct<number | null | undefined, null>;
-    tokenAmount: import("@metamask/superstruct").Struct<number, null>;
-    usdCost: import("@metamask/superstruct").Struct<number, null>;
-    /** Token market cap in USD at trade time. `null` when Clicker has no mark. */
-    marketCap: import("@metamask/superstruct").Struct<number | null | undefined, null>;
-    timestamp: import("@metamask/superstruct").Struct<number, null>;
-    transactionHash: import("@metamask/superstruct").Struct<string, null>;
-}>;
-export type Trade = Infer<typeof TradeStruct>;
-/**
- * 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;
-    /** Median holding time in minutes. */
-    medianHoldMinutes?: 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>;
-    /**
-     * 7-day per-chain PnL in USD. Optional: older social-api versions only
-     * return the 30-day breakdown (`perChainPnl`). The unsuffixed fields above
-     * remain the 30-day window for backward compatibility.
-     */
-    perChainPnl7d?: Record<string, number>;
-    /** 7-day per-chain ROI. Null for chains with no trading activity. */
-    perChainRoi7d?: Record<string, number | null>;
-    /** 7-day per-chain volume in USD. */
-    perChainVolume7d?: 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 = {
-    positionId: string;
-    tokenSymbol: string;
-    tokenName: string;
-    tokenAddress: string;
-    chain: string;
-    positionAmount: number;
-    /**
-     * Whether the position still carries exposure. Clicker's own verdict, which
-     * beats a `positionAmount === 0` check: it survives precision dust and
-     * distinguishes "no position" from "a position of size ~0". Absent on
-     * responses from a social-api that predates the field.
-     */
-    isOpen?: boolean;
-    boughtUsd: number;
-    soldUsd: number;
-    realizedPnl: number;
-    costBasis: number;
-    trades: Trade[];
-    lastTradeAt: number;
-    /** Daylight-hosted token image URL. */
-    tokenImageUrl?: string | null;
-    /** 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;
-    /** Perp side of the position. `null`/absent for spot positions. */
-    perpPositionType?: 'long' | 'short' | null;
-    /** Leverage multiplier for perp positions. `null`/absent for spot. */
-    perpLeverage?: number | null;
-    /**
-     * Leveraged/notional position size as reported by Clicker. NOT necessarily
-     * `positionAmount` × `perpLeverage` — the ratio varies for positions built
-     * across fills at different leverage, so use this field directly rather than
-     * deriving it, and treat `perpLeverage` as the authoritative leverage. This is
-     * notional exposure, not capital at risk (the margin/capital at risk is
-     * `costBasis`). Hyperliquid/perp positions only; absent for spot.
-     */
-    positionAmountWithLeverage?: 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;
-};
-/**
- * A single trader-activity feed item: a {@link Position} the trade belongs to,
- * plus the {@link ProfileSummary} of the trader who made it (`actor`) and the
- * item's creation `timestamp` (Unix seconds).
- */
-export type FeedItem = Position & {
-    /** The trader who made this trade. */
-    actor: ProfileSummary;
-    /** Unix timestamp (seconds) when the feed item was created. */
-    timestamp: number;
-};
-/**
- * Cursor pagination for the feed. Pass `olderCursor` back as `olderThan` to
- * load older items (infinite scroll), and `newerCursor` as `newerThan` to
- * fetch newer items. `null` when there are no items in that direction.
- */
-export type FeedPagination = {
-    olderCursor: string | null;
-    newerCursor: string | null;
-};
-/**
- * Response from `GET /v1/feed`.
- */
-export type FeedResponse = {
-    items: FeedItem[];
-    pagination: FeedPagination;
-};
-/**
- * Response from `GET /v1/traders/:addressOrId/followers`.
- */
-export type FollowersResponse = {
-    followers: ProfileSummary[];
-    count: number;
-};
-/**
- * Response from `GET /v1/users/me/following`.
- */
-export type FollowingResponse = {
-    following: ProfileSummary[];
-    count: number;
-};
-/**
- * Response from `PUT /v1/users/me/follows`.
- */
-export type FollowResponse = {
-    followed: ProfileSummary[];
-};
-/**
- * Response from `DELETE /v1/users/me/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 FetchFeedOptions = {
-    /**
-     * Which feed to fetch: `following` (personalized to the current user,
-     * identified server-side from the JWT) or `leaderboard` (generic, shared by
-     * all users). Defaults to `following` server-side when omitted.
-     */
-    scope?: 'following' | 'leaderboard';
-    /**
-     * Filter by one or more chains, given as CAIP-2 chain ids (e.g.
-     * `eip155:8453`). Omit for the server defaults.
-     */
-    chains?: string[];
-    /** Number of results to return. */
-    limit?: number;
-    /** Cursor for older items (infinite scroll). Use `pagination.olderCursor`. */
-    olderThan?: string;
-    /** Cursor for newer items (pull to refresh). Use `pagination.newerCursor`. */
-    newerThan?: string;
-};
-export type FetchPositionByIdOptions = {
-    /** Unique position ID (UUID). */
-    positionId: string;
-};
-export type FollowOptions = {
-    /** Array of wallet addresses or profile IDs to follow. */
-    targets: string[];
-};
-export type UnfollowOptions = {
-    /** 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[];
-    /** Wallet addresses the current user follows. */
-    followingAddresses: string[];
-    /** Clicker profile IDs the current user follows — used by mobile UI. */
-    followingProfileIds: string[];
-};
-//# sourceMappingURL=social-types.d.cts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"social-types.d.cts","sourceRoot":"","sources":["../src/social-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,8BAA8B;AAcnD;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,iCAAiC;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,8BAA8B;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEpE,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;IAGtB;;;OAGG;;;;;;;;IAGH,8EAA8E;;;;;;;IAI9E,uDAAuD;;;;;IAEvD,8EAA8E;;;;IAI9E,8EAA8E;;;;EAI9E,CAAC;AAEH,MAAM,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAM9C;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,2BAA2B;IAC3B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,+BAA+B;IAC/B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,aAAa,CAAC;CAC9B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B,CAAC;AAMF,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,2BAA2B;IAC3B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,+BAA+B;IAC/B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,sCAAsC;IACtC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC9B,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,6EAA6E;IAC7E,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;IAC3C,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACvC,qEAAqE;IACrE,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;IAC9C,qCAAqC;IACrC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,aAAa,CAAC;IACvB,KAAK,EAAE,WAAW,CAAC;IACnB,iBAAiB,EAAE,iBAAiB,CAAC;IACrC,aAAa,EAAE,aAAa,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAMF,MAAM,MAAM,QAAQ,GAAG;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,EAAE,MAAM,CAAC;IACvB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,yEAAyE;IACzE,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,wCAAwC;IACxC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,mEAAmE;IACnE,gBAAgB,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IAC3C,sEAAsE;IACtE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B;;;;;;;OAOG;IACH,0BAA0B,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5C,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,UAAU,EAAE,UAAU,CAAC;IACvB,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAAC;AAMF;;;;GAIG;AACH,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG;IAChC,sCAAsC;IACtC,KAAK,EAAE,cAAc,CAAC;IACtB,+DAA+D;IAC/D,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,UAAU,EAAE,cAAc,CAAC;CAC5B,CAAC;AAMF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAMF;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,SAAS,EAAE,cAAc,EAAE,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAMF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,cAAc,EAAE,CAAC;CAC5B,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,EAAE,cAAc,EAAE,CAAC;CAC9B,CAAC;AAMF,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,KAAK,CAAC;IACjC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B;;;;OAIG;IACH,KAAK,CAAC,EAAE,WAAW,GAAG,aAAa,CAAC;IACpC;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,iCAAiC;IACjC,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,0DAA0D;IAC1D,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,4DAA4D;IAC5D,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAMF;;;;;;GAMG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,wEAAwE;IACxE,kBAAkB,EAAE,gBAAgB,EAAE,CAAC;IACvC,iDAAiD;IACjD,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,wEAAwE;IACxE,mBAAmB,EAAE,MAAM,EAAE,CAAC;CAC/B,CAAC"}

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

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

package/dist/social-types.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"social-types.mjs","sourceRoot":"","sources":["../src/social-types.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,EACL,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,MAAM,EACN,IAAI,IAAI,UAAU,EACnB,8BAA8B;AA0C/B,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,CAAC;IACpC,SAAS,EAAE,KAAK,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,EAAE,KAAK,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAChC;;;OAGG;IACH,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC;IACjE,QAAQ,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;IAC5B,8EAA8E;IAC9E,cAAc,EAAE,QAAQ,CACtB,QAAQ,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,CACrD;IACD,uDAAuD;IACvD,gBAAgB,EAAE,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAC9D,8EAA8E;IAC9E,YAAY,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1C,WAAW,EAAE,MAAM,EAAE;IACrB,OAAO,EAAE,MAAM,EAAE;IACjB,8EAA8E;IAC9E,SAAS,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACvC,SAAS,EAAE,MAAM,EAAE;IACnB,eAAe,EAAE,MAAM,EAAE;CAC1B,CAAC,CAAC","sourcesContent":["import type { Infer } from '@metamask/superstruct';\nimport {\n  enums,\n  nullable,\n  number,\n  optional,\n  string,\n  type as structType,\n} from '@metamask/superstruct';\n\n// ---------------------------------------------------------------------------\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 * Where a fill sits in its position's lifecycle.\n *\n * Deliberately asset-agnostic so the classification is computed once, upstream:\n * clients render `opened / added / reduced / closed` for perps and\n * `bought / bought more / sold some / sold all` for spot from the same value.\n *\n * Distinct from `intent`, which only says whether the fill grew or shrank the\n * position — `intent: 'exit'` covers both a partial trim and a full close.\n */\nexport type TradeAction = 'opened' | 'added' | 'reduced' | 'closed';\n\nexport const TradeStruct = structType({\n  direction: enums(['buy', 'sell']),\n  intent: enums(['enter', 'exit']),\n  /**\n   * Lifecycle stage of this fill. Absent on responses from a social-api that\n   * predates the field, so treat it as a hint and keep a client-side fallback.\n   */\n  action: optional(enums(['opened', 'added', 'reduced', 'closed'])),\n  category: optional(string()),\n  /** High-level trade classification. `null` when Clicker does not classify. */\n  classification: optional(\n    nullable(enums(['spot', 'perp', 'send', 'receive'])),\n  ),\n  /** Perp side for this fill. `null` for spot trades. */\n  perpPositionType: optional(nullable(enums(['long', 'short']))),\n  /** Leverage multiplier for perp trades (e.g. `5` for 5x). `null` for spot. */\n  perpLeverage: optional(nullable(number())),\n  tokenAmount: number(),\n  usdCost: number(),\n  /** Token market cap in USD at trade time. `null` when Clicker has no mark. */\n  marketCap: optional(nullable(number())),\n  timestamp: number(),\n  transactionHash: string(),\n});\n\nexport type Trade = Infer<typeof TradeStruct>;\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  /** Median holding time in minutes. */\n  medianHoldMinutes?: 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   * 7-day per-chain PnL in USD. Optional: older social-api versions only\n   * return the 30-day breakdown (`perChainPnl`). The unsuffixed fields above\n   * remain the 30-day window for backward compatibility.\n   */\n  perChainPnl7d?: Record<string, number>;\n  /** 7-day per-chain ROI. Null for chains with no trading activity. */\n  perChainRoi7d?: Record<string, number | null>;\n  /** 7-day per-chain volume in USD. */\n  perChainVolume7d?: 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  positionId: string;\n  tokenSymbol: string;\n  tokenName: string;\n  tokenAddress: string;\n  chain: string;\n  positionAmount: number;\n  /**\n   * Whether the position still carries exposure. Clicker's own verdict, which\n   * beats a `positionAmount === 0` check: it survives precision dust and\n   * distinguishes \"no position\" from \"a position of size ~0\". Absent on\n   * responses from a social-api that predates the field.\n   */\n  isOpen?: boolean;\n  boughtUsd: number;\n  soldUsd: number;\n  realizedPnl: number;\n  costBasis: number;\n  trades: Trade[];\n  lastTradeAt: number;\n  /** Daylight-hosted token image URL. */\n  tokenImageUrl?: string | null;\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  /** Perp side of the position. `null`/absent for spot positions. */\n  perpPositionType?: 'long' | 'short' | null;\n  /** Leverage multiplier for perp positions. `null`/absent for spot. */\n  perpLeverage?: number | null;\n  /**\n   * Leveraged/notional position size as reported by Clicker. NOT necessarily\n   * `positionAmount` × `perpLeverage` — the ratio varies for positions built\n   * across fills at different leverage, so use this field directly rather than\n   * deriving it, and treat `perpLeverage` as the authoritative leverage. This is\n   * notional exposure, not capital at risk (the margin/capital at risk is\n   * `costBasis`). Hyperliquid/perp positions only; absent for spot.\n   */\n  positionAmountWithLeverage?: 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// Feed\n// ---------------------------------------------------------------------------\n\n/**\n * A single trader-activity feed item: a {@link Position} the trade belongs to,\n * plus the {@link ProfileSummary} of the trader who made it (`actor`) and the\n * item's creation `timestamp` (Unix seconds).\n */\nexport type FeedItem = Position & {\n  /** The trader who made this trade. */\n  actor: ProfileSummary;\n  /** Unix timestamp (seconds) when the feed item was created. */\n  timestamp: number;\n};\n\n/**\n * Cursor pagination for the feed. Pass `olderCursor` back as `olderThan` to\n * load older items (infinite scroll), and `newerCursor` as `newerThan` to\n * fetch newer items. `null` when there are no items in that direction.\n */\nexport type FeedPagination = {\n  olderCursor: string | null;\n  newerCursor: string | null;\n};\n\n/**\n * Response from `GET /v1/feed`.\n */\nexport type FeedResponse = {\n  items: FeedItem[];\n  pagination: FeedPagination;\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/me/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/me/follows`.\n */\nexport type FollowResponse = {\n  followed: ProfileSummary[];\n};\n\n/**\n * Response from `DELETE /v1/users/me/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 FetchFeedOptions = {\n  /**\n   * Which feed to fetch: `following` (personalized to the current user,\n   * identified server-side from the JWT) or `leaderboard` (generic, shared by\n   * all users). Defaults to `following` server-side when omitted.\n   */\n  scope?: 'following' | 'leaderboard';\n  /**\n   * Filter by one or more chains, given as CAIP-2 chain ids (e.g.\n   * `eip155:8453`). Omit for the server defaults.\n   */\n  chains?: string[];\n  /** Number of results to return. */\n  limit?: number;\n  /** Cursor for older items (infinite scroll). Use `pagination.olderCursor`. */\n  olderThan?: string;\n  /** Cursor for newer items (pull to refresh). Use `pagination.newerCursor`. */\n  newerThan?: string;\n};\n\nexport type FetchPositionByIdOptions = {\n  /** Unique position ID (UUID). */\n  positionId: string;\n};\n\nexport type FollowOptions = {\n  /** Array of wallet addresses or profile IDs to follow. */\n  targets: string[];\n};\n\nexport type UnfollowOptions = {\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  /** Wallet addresses the current user follows. */\n  followingAddresses: string[];\n  /** Clicker profile IDs the current user follows — used by mobile UI. */\n  followingProfileIds: string[];\n};\n"]}