@nadohq/mobile-client 0.53.0 → 0.54.0

package/src/dataMappers.ts

@@ -1,4 +1,4 @@
-import { subaccountToHex } from '@nadohq/shared';
+import { removeDecimals, subaccountToHex, toBigNumber } from '@nadohq/shared';
 import {
   GetMobileFollowListParams,
   MobileFeedPage,
@@ -12,6 +12,27 @@ import {
   MobileProfilesInclude,
   MobilePublicProfile,
   MobileRegisteredWallet,
+  MobileSocialFeedAuthor,
+  MobileSocialFeedInteraction,
+  MobileSocialFeedItem,
+  MobileSocialFeedItemBase,
+  MobileSocialFeedItemPatch,
+  MobileSocialFeedItemResponse,
+  MobileSocialFeedListParams,
+  MobileSocialFeedMarket,
+  MobileSocialFeedPage,
+  MobileSocialFeedPnl,
+  MobileSocialFeedPositionCard,
+  MobileSocialFeedPositionPatch,
+  MobileSocialFeedRankedPage,
+  MobileSocialFeedReadParams,
+  MobileSocialFeedReadSession,
+  MobileSocialFeedTopTradersPage,
+  MobileSocialFeedTradeCard,
+  MobileSocialFeedTradeRow,
+  MobileSocialFeedTradeRowBase,
+  MobileSocialFeedTraderBadge,
+  MobileSocialFeedUpdates,
 } from './types/clientTypes';
 import { MobileServerFollowMutationResponse } from './types/serverExecuteTypes';
 import {
@@ -21,15 +42,36 @@ import {
   MobileServerNotificationPreferenceScope,
   MobileServerNotificationPreferences,
   MobileServerProfile,
+  MobileServerSocialFeedAuthor,
+  MobileServerSocialFeedInteraction,
+  MobileServerSocialFeedItem,
+  MobileServerSocialFeedItemBase,
+  MobileServerSocialFeedItemPatch,
+  MobileServerSocialFeedMarket,
+  MobileServerSocialFeedPnl,
+  MobileServerSocialFeedPositionCard,
+  MobileServerSocialFeedPositionPatch,
+  MobileServerSocialFeedReadSession,
+  MobileServerSocialFeedTradeCard,
+  MobileServerSocialFeedTradeRow,
+  MobileServerSocialFeedTradeRowBase,
+  MobileServerSocialFeedTraderBadge,
 } from './types/serverModelTypes';
 import {
   MobileServerFeedResponse,
   MobileServerFollowListResponse,
   MobileServerRegisteredWalletResponse,
+  MobileServerSocialFeedItemResponse,
+  MobileServerSocialFeedRankedResponse,
+  MobileServerSocialFeedResponse,
+  MobileServerSocialFeedTopTradersResponse,
+  MobileServerSocialFeedUpdatesResponse,
 } from './types/serverQueryTypes';
 import {
   MobileServerFollowListRequest,
   MobileServerProfilesInclude,
+  MobileServerSocialFeedListParams,
+  MobileServerSocialFeedReadParams,
 } from './types/serverRequestTypes';
 
 /**
@@ -236,3 +278,463 @@ export function mapMobileRegisteredWallet(
     lastSeenAt: server.last_seen_at,
   };
 }
+
+/**
+ * Maps the official account PnL badge, retaining x18 amount units.
+ * @param server - The service response.
+ * @returns The mapped trader badge.
+ */
+export function mapMobileSocialFeedTraderBadge(
+  server: MobileServerSocialFeedTraderBadge,
+): MobileSocialFeedTraderBadge {
+  return {
+    code: server.code,
+    pnl: toBigNumber(server.pnl_x18),
+    metricKey: server.metric_key,
+    window: server.window,
+    sourceAsOfMs: server.source_as_of_ms,
+    fetchedAtMs: server.fetched_at_ms,
+    snapshotId: server.snapshot_id,
+  };
+}
+
+/**
+ * Maps author identity, relationship state, and optional qualification badge.
+ * @param server - The service response.
+ * @returns The mapped feed author.
+ */
+export function mapMobileSocialFeedAuthor(
+  server: MobileServerSocialFeedAuthor,
+): MobileSocialFeedAuthor {
+  return {
+    ...mapMobileIdentitySummary(server),
+    isFollowing: server.is_following,
+    traderBadge:
+      server.trader_badge === null
+        ? null
+        : mapMobileSocialFeedTraderBadge(server.trader_badge),
+    traderDataStatus: server.trader_data_status,
+  };
+}
+
+/**
+ * Maps social market metadata.
+ * @param server - The service response.
+ * @returns The mapped feed market.
+ */
+export function mapMobileSocialFeedMarket(
+  server: MobileServerSocialFeedMarket,
+): MobileSocialFeedMarket {
+  return {
+    productId: server.product_id,
+    symbol: server.symbol,
+    logoUrl: server.logo_url,
+    category: server.category,
+    sourceCategories: server.source_categories,
+  };
+}
+
+/**
+ * Maps position PnL while retaining x18 amount units and availability.
+ * @param server - The service response.
+ * @returns The mapped feed pnl.
+ */
+export function mapMobileSocialFeedPnl(
+  server: MobileServerSocialFeedPnl,
+): MobileSocialFeedPnl {
+  return {
+    amount: server.amount_x18 === null ? null : toBigNumber(server.amount_x18),
+    basis: server.basis,
+    mode: server.mode,
+    asOfMs: server.as_of_ms,
+    quality: server.quality,
+  };
+}
+
+/**
+ * Maps complete position facts, converting entry price to decimal units.
+ * @param server - The service response.
+ * @returns The mapped feed position patch.
+ */
+export function mapMobileSocialFeedPositionPatch(
+  server: MobileServerSocialFeedPositionPatch,
+): MobileSocialFeedPositionPatch {
+  return {
+    positionId: server.position_id,
+    positionVersion: server.position_version,
+    stateAsOfMs: server.state_as_of_ms,
+    entryPrice: removeDecimals(server.entry_price_x18),
+    displayBasis: server.display_basis,
+    snapshotAtMs: server.snapshot_at_ms,
+    quantity: toBigNumber(server.quantity_x18),
+    notional: toBigNumber(server.notional_x18),
+    state: server.state,
+    historyQuality: server.history_quality,
+    marginMode: server.margin_mode,
+    leverage: server.leverage,
+    leverageAtMs: server.leverage_at_ms,
+    pnl: mapMobileSocialFeedPnl(server.pnl),
+  };
+}
+
+/**
+ * Maps a position card with its current or frozen financial state.
+ * @param server - The service response.
+ * @returns The mapped feed position card.
+ */
+export function mapMobileSocialFeedPositionCard(
+  server: MobileServerSocialFeedPositionCard,
+): MobileSocialFeedPositionCard {
+  return {
+    ...mapMobileSocialFeedPositionPatch(server),
+    productId: server.product_id,
+    market: mapMobileSocialFeedMarket(server.market),
+    direction: server.direction,
+  };
+}
+
+/**
+ * Maps interaction counters without inventing unavailable relationship state.
+ * @param server - The service response.
+ * @returns The mapped feed interaction.
+ */
+export function mapMobileSocialFeedInteraction(
+  server: MobileServerSocialFeedInteraction,
+): MobileSocialFeedInteraction {
+  return {
+    likeCount: server.like_count,
+    commentCount: server.comment_count,
+    viewCount: server.view_count,
+    likedByMe: server.liked_by_me,
+  };
+}
+
+/**
+ * Maps common item metadata and server capabilities.
+ * @param server - The service response.
+ * @returns The mapped social feed item base.
+ */
+export function mapMobileSocialFeedItemBase(
+  server: MobileServerSocialFeedItemBase,
+): MobileSocialFeedItemBase {
+  return {
+    id: server.id,
+    hasAnalysis: server.has_analysis,
+    drawing: server.drawing,
+    author: mapMobileSocialFeedAuthor(server.author),
+    createdAtMs: server.created_at_ms,
+    displayAtMs: server.display_at_ms,
+    version: server.version,
+    market: mapMobileSocialFeedMarket(server.market),
+    capabilities: {
+      canLike: server.capabilities.can_like,
+      canComment: server.capabilities.can_comment,
+      canRecordView: server.capabilities.can_record_view,
+    },
+  };
+}
+
+/**
+ * Maps an automatic trade card and its position and interaction metadata.
+ * @param server - The service response.
+ * @returns The mapped social trade card.
+ */
+export function mapMobileSocialFeedTradeCard(
+  server: MobileServerSocialFeedTradeCard,
+): MobileSocialFeedTradeCard {
+  return {
+    ...mapMobileSocialFeedItemBase(server),
+    kind: server.kind,
+    action: server.action,
+    text: server.text,
+    mentions: server.mentions,
+    position: mapMobileSocialFeedPositionCard(server.position),
+    interaction: mapMobileSocialFeedInteraction(server.interaction),
+    commentPreview: {
+      items: server.comment_preview.items,
+      totalCount: server.comment_preview.total_count,
+      nextCursor: server.comment_preview.next_cursor,
+    },
+  };
+}
+
+/**
+ * Maps historical trade facts with decimal execution prices and x18 quantities.
+ * @param server - The service response.
+ * @returns The mapped social trade row base.
+ */
+export function mapMobileSocialFeedTradeRowBase(
+  server: MobileServerSocialFeedTradeRowBase,
+): MobileSocialFeedTradeRowBase {
+  return {
+    ...mapMobileSocialFeedItemBase(server),
+    kind: server.kind,
+    positionId: server.position_id,
+    direction: server.direction,
+    marginMode: server.margin_mode,
+    leverage: server.leverage,
+    leverageAtMs: server.leverage_at_ms,
+    tradeCount: server.trade_count,
+    quantity: toBigNumber(server.quantity_x18),
+    averagePrice: removeDecimals(server.average_price_x18),
+  };
+}
+
+/**
+ * Maps size changes and independently nullable liquidation facts.
+ * @param server - The service response.
+ * @returns The mapped social trade row.
+ */
+export function mapMobileSocialFeedTradeRow(
+  server: MobileServerSocialFeedTradeRow,
+): MobileSocialFeedTradeRow {
+  const base = mapMobileSocialFeedTradeRowBase(server);
+  if (server.action === 'liquidated') {
+    return {
+      ...base,
+      action: server.action,
+      notional:
+        server.notional_x18 === null ? null : toBigNumber(server.notional_x18),
+      entryPrice: removeDecimals(server.entry_price_x18),
+      liquidationOraclePrice: removeDecimals(
+        server.liquidation_oracle_price_x18,
+      ),
+      liquidationExecutionPrice: removeDecimals(
+        server.liquidation_execution_price_x18,
+      ),
+      realizedPnlDelta:
+        server.realized_pnl_delta_x18 === null
+          ? null
+          : toBigNumber(server.realized_pnl_delta_x18),
+    };
+  }
+  return {
+    ...base,
+    action: server.action,
+    notional: toBigNumber(server.notional_x18),
+  };
+}
+
+/**
+ * Maps the item variant without mixing card and row fields.
+ * @param server - The service response.
+ * @returns The mapped social feed item.
+ */
+export function mapMobileSocialFeedItem(
+  server: MobileServerSocialFeedItem,
+): MobileSocialFeedItem {
+  return server.kind === 'trade_card'
+    ? mapMobileSocialFeedTradeCard(server)
+    : mapMobileSocialFeedTradeRow(server);
+}
+
+/**
+ * Maps a fixed reading session, preserving opaque credentials and cursors.
+ * @param server - The service response.
+ * @returns The mapped feed read session.
+ */
+export function mapMobileSocialFeedReadSession(
+  server: MobileServerSocialFeedReadSession,
+): MobileSocialFeedReadSession {
+  return {
+    sessionId: server.session_id,
+    mode: server.mode,
+    expiresAtMs: server.expires_at_ms,
+    viewTracking: {
+      minVisibleRatio: server.view_tracking.min_visible_ratio,
+      minDurationMs: server.view_tracking.min_duration_ms,
+    },
+    updateCursor: server.update_cursor,
+    viewerToken: server.viewer_token,
+  };
+}
+
+/**
+ * Maps a fixed feed page without changing item order or pagination.
+ * @param server - The service response.
+ * @returns The mapped social feed page.
+ */
+export function mapMobileSocialFeedPage(
+  server: MobileServerSocialFeedResponse,
+): MobileSocialFeedPage {
+  return {
+    readSession: mapMobileSocialFeedReadSession(server.read_session),
+    items: server.items.map(mapMobileSocialFeedItem),
+    nextCursor: server.next_cursor,
+    watermark: server.watermark,
+  };
+}
+
+/**
+ * Maps a main feed page and its ranking version.
+ * @param server - The service response.
+ * @returns The mapped ranked feed page.
+ */
+export function mapMobileSocialFeedRankedPage(
+  server: MobileServerSocialFeedRankedResponse,
+): MobileSocialFeedRankedPage {
+  return {
+    ...mapMobileSocialFeedPage(server),
+    rankingVersion: server.ranking_version,
+  };
+}
+
+/**
+ * Maps qualified trader items and their shared eligibility snapshot.
+ * @param server - The service response.
+ * @returns The mapped top traders feed page.
+ */
+export function mapMobileSocialFeedTopTradersPage(
+  server: MobileServerSocialFeedTopTradersResponse,
+): MobileSocialFeedTopTradersPage {
+  return {
+    ...mapMobileSocialFeedRankedPage(server),
+    cohort: {
+      snapshotId: server.cohort.snapshot_id,
+      status: server.cohort.status,
+      coverage: {
+        scope: server.cohort.coverage.scope,
+        totalAuthors: server.cohort.coverage.total_authors,
+        queriedAuthors: server.cohort.coverage.queried_authors,
+        complete: server.cohort.coverage.complete,
+      },
+    },
+  };
+}
+
+/**
+ * Maps item details and the authorized reading session.
+ * @param server - The service response.
+ * @returns The mapped social feed item response.
+ */
+export function mapMobileSocialFeedItemResponse(
+  server: MobileServerSocialFeedItemResponse,
+): MobileSocialFeedItemResponse {
+  return {
+    item: mapMobileSocialFeedItem(server.item),
+    readSession: mapMobileSocialFeedReadSession(server.read_session),
+  };
+}
+
+/**
+ * Maps item deltas, preserving omitted fields and explicit null clears.
+ * @param server - The service response.
+ * @returns The mapped feed item patch.
+ */
+export function mapMobileSocialFeedItemPatch(
+  server: MobileServerSocialFeedItemPatch,
+): MobileSocialFeedItemPatch {
+  return {
+    itemId: server.item_id,
+    version: server.version,
+    author: mapMobileSocialFeedAuthor(server.author),
+    displayAtMs: server.display_at_ms,
+    ...(server.interaction === undefined
+      ? {}
+      : { interaction: mapMobileSocialFeedInteraction(server.interaction) }),
+    ...(server.trade_count === undefined
+      ? {}
+      : { tradeCount: server.trade_count }),
+    ...(server.quantity_x18 === undefined
+      ? {}
+      : { quantity: toBigNumber(server.quantity_x18) }),
+    ...(server.notional_x18 === undefined
+      ? {}
+      : {
+          notional:
+            server.notional_x18 === null
+              ? null
+              : toBigNumber(server.notional_x18),
+        }),
+    ...(server.average_price_x18 === undefined
+      ? {}
+      : {
+          averagePrice: removeDecimals(server.average_price_x18),
+        }),
+    ...(server.entry_price_x18 === undefined
+      ? {}
+      : {
+          entryPrice: removeDecimals(server.entry_price_x18),
+        }),
+    ...(server.liquidation_oracle_price_x18 === undefined
+      ? {}
+      : {
+          liquidationOraclePrice: removeDecimals(
+            server.liquidation_oracle_price_x18,
+          ),
+        }),
+    ...(server.liquidation_execution_price_x18 === undefined
+      ? {}
+      : {
+          liquidationExecutionPrice: removeDecimals(
+            server.liquidation_execution_price_x18,
+          ),
+        }),
+    ...(server.realized_pnl_delta_x18 === undefined
+      ? {}
+      : {
+          realizedPnlDelta:
+            server.realized_pnl_delta_x18 === null
+              ? null
+              : toBigNumber(server.realized_pnl_delta_x18),
+        }),
+    ...(server.leverage === undefined ? {} : { leverage: server.leverage }),
+    ...(server.leverage_at_ms === undefined
+      ? {}
+      : { leverageAtMs: server.leverage_at_ms }),
+  };
+}
+
+/**
+ * Maps viewport changes while preserving the sequence and update baseline.
+ * @param server - The service response.
+ * @returns The mapped feed updates.
+ */
+export function mapMobileSocialFeedUpdates(
+  server: MobileServerSocialFeedUpdatesResponse,
+): MobileSocialFeedUpdates {
+  return {
+    itemPatches: server.item_patches.map(mapMobileSocialFeedItemPatch),
+    positionPatches: server.position_patches.map(
+      mapMobileSocialFeedPositionPatch,
+    ),
+    unavailableTargets: server.unavailable_targets,
+    newItemsCount: server.new_items_count,
+    updateCursor: server.update_cursor,
+    reset: server.reset,
+    viewportRevision: server.viewport_revision,
+    requestSeq: server.request_seq,
+  };
+}
+
+/**
+ * Maps common list parameters to the public query wire format without inserting defaults.
+ * @param params - Client filters and session pagination.
+ * @returns Wire fields; undefined options are omitted when serialized to JSON.
+ */
+export function mapMobileSocialFeedListParamsToServer(
+  params: MobileSocialFeedListParams,
+): MobileServerSocialFeedListParams {
+  return {
+    feed_types: params.feedTypes,
+    minimum_notional: params.minimumNotional,
+    limit: params.limit,
+    session_id: params.sessionId,
+    cursor: params.cursor,
+  };
+}
+
+/**
+ * Maps the public viewing account and browser credential without inferring an identity.
+ * @param params - Public relationship perspective and optional session credential.
+ * @returns Wire fields for a public feed read.
+ */
+export function mapMobileSocialFeedReadParamsToServer(
+  params: MobileSocialFeedReadParams,
+): MobileServerSocialFeedReadParams {
+  return {
+    view_as:
+      params.viewAs === undefined ? undefined : subaccountToHex(params.viewAs),
+    viewer_token: params.viewerToken,
+  };
+}