@nadohq/mobile-client 0.65.0 → 0.67.0

package/src/dataMappers.ts

@@ -11,8 +11,18 @@ import {
   MobileFollowMutationResult,
   MobileFollowSummary,
   MobileIdentitySummary,
+  MobileNotificationCapabilities,
+  MobileNotificationInboxV2,
+  MobileNotificationPayloadV2,
   MobileNotificationPreferenceScope,
   MobileNotificationPreferences,
+  MobileNotificationRegistrationV2,
+  MobileNotificationRoute,
+  MobileNotificationSettings,
+  MobileNotificationSettingsV2,
+  MobileNotificationSubscriptions,
+  MobileNotificationSubscriptionsUpdate,
+  MobileProductEvent,
   MobileProfileSearchPage,
   MobileProfilesInclude,
   MobilePublicProfile,
@@ -22,6 +32,7 @@ import {
   MobileSocialFeedActionResolutionResult,
   MobileSocialFeedAuthor,
   MobileSocialFeedCandle,
+  MobileSocialFeedCommentGroup,
   MobileSocialFeedCommentResult,
   MobileSocialFeedCommentsPage,
   MobileSocialFeedCompactCard,
@@ -31,6 +42,7 @@ import {
   MobileSocialFeedDrawingResult,
   MobileSocialFeedHistoryMetrics,
   MobileSocialFeedHistoryTake,
+  MobileSocialFeedImage,
   MobileSocialFeedInteraction,
   MobileSocialFeedItem,
   MobileSocialFeedItemBase,
@@ -48,6 +60,8 @@ import {
   MobileSocialFeedPositionHistory,
   MobileSocialFeedPositionPatch,
   MobileSocialFeedPositionResolutionResult,
+  MobileSocialFeedPositionThought,
+  MobileSocialFeedPositionThoughtsPage,
   MobileSocialFeedPositionsPage,
   MobileSocialFeedPost,
   MobileSocialFeedPresence,
@@ -65,11 +79,12 @@ import {
   MobileSocialFeedTradingContext,
   MobileSocialFeedTradingTarget,
   MobileSocialFeedUpdates,
-  MobileSocialFeedViewsResult,
+  MobileSocialFeedUploadedImage,
   MobileSocialFeedWatchers,
   SearchMobileProfilesParams,
 } from './types/clientTypes';
 import { MobileUnsupportedFeedItemError } from './types/MobileUnsupportedFeedItemError';
+import { MobileUnsupportedNotificationRouteError } from './types/MobileUnsupportedNotificationRouteError';
 import {
   MobileServerAvatarUploadResponse,
   MobileServerFollowBatchResponse,
@@ -78,7 +93,6 @@ import {
   MobileServerSocialFeedDrawingMutationResponse,
   MobileServerSocialFeedLikeResponse,
   MobileServerSocialFeedPresenceResponse,
-  MobileServerSocialFeedViewsResponse,
 } from './types/serverExecuteTypes';
 import {
   MobileServerAvatarPreset,
@@ -86,18 +100,24 @@ import {
   MobileServerFeedTrade,
   MobileServerFollowSummary,
   MobileServerIdentitySummary,
+  MobileServerNotificationPayloadV2,
   MobileServerNotificationPreferenceScope,
   MobileServerNotificationPreferences,
+  MobileServerNotificationRoute,
+  MobileServerNotificationSettings,
+  MobileServerProductEvent,
   MobileServerProfile,
   MobileServerSocialFeedActionCandidate,
   MobileServerSocialFeedActionMarker,
   MobileServerSocialFeedAuthor,
   MobileServerSocialFeedCandle,
+  MobileServerSocialFeedCommentGroup,
   MobileServerSocialFeedCompactCard,
   MobileServerSocialFeedContentBase,
   MobileServerSocialFeedDrawing,
   MobileServerSocialFeedHistoryMetrics,
   MobileServerSocialFeedHistoryTake,
+  MobileServerSocialFeedImage,
   MobileServerSocialFeedInteraction,
   MobileServerSocialFeedItem,
   MobileServerSocialFeedItemBase,
@@ -118,11 +138,16 @@ import {
   MobileServerSocialFeedTraderBadge,
   MobileServerSocialFeedTradingContext,
   MobileServerSocialFeedTradingTarget,
+  MobileServerSocialFeedUploadedImage,
   MobileSocialFeedMention,
 } from './types/serverModelTypes';
 import {
   MobileServerFeedResponse,
   MobileServerFollowListResponse,
+  MobileServerNotificationInboxV2Response,
+  MobileServerNotificationRegistrationV2Response,
+  MobileServerNotificationSettingsV2Response,
+  MobileServerNotificationSubscriptionsResponse,
   MobileServerRegisteredWalletResponse,
   MobileServerSearchProfilesResponse,
   MobileServerSocialFeedActionResolutionResponse,
@@ -132,6 +157,8 @@ import {
   MobileServerSocialFeedPositionChartResponse,
   MobileServerSocialFeedPositionHistoryResponse,
   MobileServerSocialFeedPositionResolutionResponse,
+  MobileServerSocialFeedPositionThought,
+  MobileServerSocialFeedPositionThoughtsResponse,
   MobileServerSocialFeedPositionsResponse,
   MobileServerSocialFeedRankedResponse,
   MobileServerSocialFeedResponse,
@@ -141,7 +168,9 @@ import {
 } from './types/serverQueryTypes';
 import {
   MobileServerFollowListRequest,
+  MobileServerNotificationSubscriptionsUpdate,
   MobileServerProfilesInclude,
+  MobileServerRegisterExpoTokenV2Params,
   MobileServerSearchProfilesRequest,
   MobileServerSocialFeedListParams,
   MobileServerSocialFeedReadParams,
@@ -170,6 +199,209 @@ export function mapMobileAvatarUpload(
   };
 }
 
+/** Maps a saved notification registration to the client model without the response envelope.
+ * @param server - Registration payload.
+ * @returns Saved generation and capabilities.
+ */
+export function mapMobileNotificationRegistrationV2(
+  server: MobileServerNotificationRegistrationV2Response,
+): MobileNotificationRegistrationV2 {
+  return {
+    registrationGeneration: server.registration_generation,
+    capabilities: {
+      payloadVersions: server.capabilities.payload_versions,
+      typeIds: server.capabilities.type_ids,
+      routes: server.capabilities.routes,
+    },
+  };
+}
+
+/** Maps a v2 capability declaration to the registration wire format.
+ * @param capabilities - Device-supported features.
+ * @returns V2-only registration capabilities.
+ */
+export function mapMobileNotificationCapabilitiesToServer(
+  capabilities: MobileNotificationCapabilities,
+): MobileServerRegisterExpoTokenV2Params['capabilities'] {
+  return {
+    payload_versions: capabilities.payloadVersions,
+    type_ids: capabilities.typeIds,
+    routes: capabilities.routes,
+  };
+}
+
+/** Maps complete notification settings to the client model.
+ * @param server - Saved settings.
+ * @returns CamelCase settings.
+ */
+export function mapMobileNotificationSettings(
+  server: MobileServerNotificationSettings,
+): MobileNotificationSettings {
+  return {
+    myPositions: server.my_positions,
+    positionThresholds: server.position_thresholds,
+    myOrders: server.my_orders,
+    followingTrades: server.following_trades,
+    followingPosts: server.following_posts,
+    minTradeSizeUsd: server.min_trade_size_usd,
+    newFollowers: server.new_followers,
+    announcements: server.announcements,
+    discovery: server.discovery,
+  };
+}
+
+/** Maps a complete replacement settings document to wire format.
+ * @param settings - Complete client settings.
+ * @returns Settings accepted by the service.
+ */
+export function mapMobileNotificationSettingsToServer(
+  settings: MobileNotificationSettings,
+): MobileServerNotificationSettings {
+  return {
+    my_positions: settings.myPositions,
+    position_thresholds: settings.positionThresholds,
+    my_orders: settings.myOrders,
+    following_trades: settings.followingTrades,
+    following_posts: settings.followingPosts,
+    min_trade_size_usd: settings.minTradeSizeUsd,
+    new_followers: settings.newFollowers,
+    announcements: settings.announcements,
+    discovery: settings.discovery,
+  };
+}
+
+/** Maps a revisioned settings response without the response envelope.
+ * @param server - Versioned settings payload.
+ * @returns Client settings and their revision.
+ */
+export function mapMobileNotificationSettingsV2(
+  server: MobileServerNotificationSettingsV2Response,
+): MobileNotificationSettingsV2 {
+  return {
+    schemaVersion: server.schema_version,
+    revision: server.revision,
+    settings: mapMobileNotificationSettings(server.settings),
+  };
+}
+
+/** Maps wallet market subscriptions and Identity bells.
+ * @param server - Subscription payload.
+ * @returns Client subscription state without the response envelope.
+ */
+export function mapMobileNotificationSubscriptions(
+  server: MobileServerNotificationSubscriptionsResponse,
+): MobileNotificationSubscriptions {
+  return {
+    revision: server.revision,
+    favoritesImported: server.favorites_imported,
+    marketIds: server.market_ids,
+    traderBells: server.trader_bells,
+  };
+}
+
+/** Maps one subscription operation, explicitly nulling unused wire operations.
+ * @param update - Exactly one revision-guarded operation.
+ * @returns The complete signed inner operation fields.
+ */
+export function mapMobileNotificationSubscriptionsUpdateToServer(
+  update: MobileNotificationSubscriptionsUpdate,
+): MobileServerNotificationSubscriptionsUpdate {
+  return {
+    expected_revision: update.expectedRevision,
+    trader_bell:
+      update.traderBell == null
+        ? null
+        : {
+            subaccount: subaccountToHex(update.traderBell.subaccount),
+            enabled: update.traderBell.enabled,
+          },
+    market:
+      update.market == null
+        ? null
+        : {
+            product_id: update.market.productId,
+            subscribed: update.market.subscribed,
+          },
+    import_markets: update.importMarkets ?? null,
+  };
+}
+
+/** Maps an allowlisted notification destination.
+ * @param server - Named backend destination.
+ * @returns Client navigation data, never an arbitrary URL.
+ * @throws {MobileUnsupportedNotificationRouteError} If the service returns an unsupported route name.
+ */
+export function mapMobileNotificationRoute(
+  server: MobileServerNotificationRoute,
+): MobileNotificationRoute {
+  const name = server.name;
+  switch (name) {
+    case 'market':
+      return { name: server.name, productId: server.product_id };
+    case 'profile':
+      return { name: server.name, subaccount: server.subaccount };
+    case 'portfolio':
+      return { name: server.name };
+    default:
+      throw new MobileUnsupportedNotificationRouteError(name satisfies never);
+  }
+}
+
+/** Maps v2 push or inbox navigation data.
+ * @param server - Wire-format notification payload.
+ * @returns Client notification data.
+ * @throws {MobileUnsupportedNotificationRouteError} If the service returns an unsupported route name.
+ */
+export function mapMobileNotificationPayloadV2(
+  server: MobileServerNotificationPayloadV2,
+): MobileNotificationPayloadV2 {
+  return {
+    payloadVersion: server.payload_version,
+    notificationId: server.notification_id,
+    recipientWallet: server.recipient_wallet,
+    typeId: server.type_id,
+    templateVersion: server.template_version,
+    route: mapMobileNotificationRoute(server.route),
+  };
+}
+
+/** Maps a private notification page without the response envelope.
+ * @param server - Newest-first inbox payload.
+ * @returns Client items, attribution flags, and the next cursor.
+ * @throws {MobileUnsupportedNotificationRouteError} If a notification has an unsupported route name.
+ */
+export function mapMobileNotificationInboxV2(
+  server: MobileServerNotificationInboxV2Response,
+): MobileNotificationInboxV2 {
+  return {
+    notifications: server.notifications.map((item) => ({
+      notificationId: item.notification_id,
+      typeId: item.type_id,
+      data: mapMobileNotificationPayloadV2(item.data),
+      createdAt: item.created_at,
+      tradeWithin24h: item.trade_within_24h,
+    })),
+    nextCursor: server.next_cursor,
+  };
+}
+
+/** Maps a typed analytics interaction, nulling unused wire fields.
+ * @param event - Event-specific client data.
+ * @returns Complete signed wire event.
+ */
+export function mapMobileProductEventToServer(
+  event: MobileProductEvent,
+): MobileServerProductEvent {
+  return {
+    client_event_id: event.clientEventId,
+    event_name: event.eventName,
+    notification_id: event.notificationId ?? null,
+    occurred_at: event.occurredAt,
+    product_id: event.productId ?? null,
+    query: event.query ?? null,
+  };
+}
+
 /**
  * Maps a client-side avatar selection to the signed wire payload; null clears the saved avatar.
  */
@@ -568,6 +800,43 @@ export function mapMobileSocialFeedInteraction(
   };
 }
 
+/**
+ * Maps uploaded image metadata; bytes remain behind a protected GET.
+ * @param server - The service response.
+ * @returns The mapped feed image.
+ */
+export function mapMobileSocialFeedUploadedImage(
+  server: MobileServerSocialFeedUploadedImage,
+): MobileSocialFeedUploadedImage {
+  return {
+    imageId: server.image_id,
+    url: server.url,
+    width: server.width,
+    height: server.height,
+    contentType: server.content_type,
+    byteSize: server.byte_size,
+    thumbnail: {
+      url: server.thumbnail.url,
+      width: server.thumbnail.width,
+      height: server.thumbnail.height,
+    },
+  };
+}
+
+/**
+ * Maps either protected upload metadata or an external URL without inventing metadata.
+ * @param server - The service response.
+ * @returns The mapped uploaded image or external URL.
+ */
+export function mapMobileSocialFeedImage(
+  server: MobileServerSocialFeedImage,
+): MobileSocialFeedImage {
+  if ('image_id' in server) {
+    return mapMobileSocialFeedUploadedImage(server);
+  }
+  return { url: server.url };
+}
+
 /**
  * Maps common item metadata and server capabilities.
  * @param server - The service response.
@@ -606,6 +875,7 @@ export function mapMobileSocialFeedContentBase(
 ): MobileSocialFeedContentBase {
   return {
     ...mapMobileSocialFeedItemBase(server),
+    images: server.images.map(mapMobileSocialFeedImage),
     text: server.text,
     mentions: server.mentions,
     position: mapMobileSocialFeedPositionCard(server.position),
@@ -715,7 +985,7 @@ export function mapMobileSocialFeedItem(
 }
 
 /**
- * Maps a fixed reading session, preserving opaque credentials and cursors.
+ * Maps a reading session and its current idle expiration, preserving opaque credentials and cursors.
  * @param server - The service response.
  * @returns The mapped feed read session.
  */
@@ -726,10 +996,6 @@ export function mapMobileSocialFeedReadSession(
     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,
   };
@@ -1023,6 +1289,7 @@ export function mapMobileSocialFeedReply(
   return {
     ...mapMobileSocialFeedItemBase(server),
     kind: server.kind,
+    images: server.images.map(mapMobileSocialFeedImage),
     text: server.text,
     mentions: server.mentions,
     rootItemId: server.root_item_id,
@@ -1298,16 +1565,31 @@ export function mapMobileSocialFeedDrawingMutationResult(
 }
 
 /**
- * Maps bidirectional comments and the actual returned session.
+ * Maps a top-level comment and its complete flat descendants without sorting or dropping content.
+ * @param server - A comment group from the service thread snapshot.
+ * @returns The mapped top-level comment with each descendant's original parent relationship.
+ */
+export function mapMobileSocialFeedCommentGroup(
+  server: MobileServerSocialFeedCommentGroup,
+): MobileSocialFeedCommentGroup {
+  return {
+    ...mapMobileSocialFeedReply(server),
+    replies: server.replies.map(mapMobileSocialFeedReply),
+  };
+}
+
+/**
+ * Maps complete comment groups in server order and the actual returned session.
  * @param server - Service payload with its original wire fields.
- * @returns Mapped replies, total count, bidirectional cursors, nullable anchor, and the actual reading session.
+ * @returns Mapped groups, whole-thread counts, bidirectional cursors, nullable anchor, and reading session.
  */
 export function mapMobileSocialFeedCommentsPage(
   server: MobileServerSocialFeedCommentsResponse,
 ): MobileSocialFeedCommentsPage {
   return {
-    comments: server.comments.map(mapMobileSocialFeedReply),
+    comments: server.comments.map(mapMobileSocialFeedCommentGroup),
     totalCount: server.total_count,
+    topLevelCount: server.top_level_count,
     nextCursor: server.next_cursor,
     previousCursor: server.previous_cursor,
     anchorReplyId: server.anchor_reply_id,
@@ -1345,20 +1627,6 @@ export function mapMobileSocialFeedLikeResult(
   };
 }
 
-/**
- * Maps exposure deduplication results without adding timestamps.
- * @param server - Service payload with its original wire fields.
- * @returns Newly accepted and duplicate item ID lists without inventing an observation timestamp.
- */
-export function mapMobileSocialFeedViewsResult(
-  server: MobileServerSocialFeedViewsResponse,
-): MobileSocialFeedViewsResult {
-  return {
-    acceptedItemIds: server.accepted_item_ids,
-    duplicateItemIds: server.duplicate_item_ids,
-  };
-}
-
 /**
  * Maps a published history take without treating unknown kinds as posts.
  * @param server - The published service item.
@@ -1420,6 +1688,7 @@ export function mapMobileSocialFeedPositionHistory(
   server: MobileServerSocialFeedPositionHistoryResponse,
 ): MobileSocialFeedPositionHistory {
   return {
+    owner: mapMobileSocialFeedAuthor(server.owner),
     position: {
       ...mapMobileSocialFeedPositionCard(server.position),
       ...mapMobileSocialFeedHistoryMetrics(server.position),
@@ -1490,3 +1759,35 @@ export function mapMobileSocialFeedPresence(
     expiresInSeconds: server.expires_in_seconds,
   };
 }
+
+/**
+ * Maps a published thought, keeping its guaranteed analysis flag and drawing.
+ * @param server - Service payload with its original wire fields.
+ * @returns The mapped post or trade card with a non-null drawing.
+ * @throws {MobileUnsupportedFeedItemError} If the service returns an unsupported take kind.
+ */
+export function mapMobileSocialFeedPositionThought(
+  server: MobileServerSocialFeedPositionThought,
+): MobileSocialFeedPositionThought {
+  return {
+    ...mapMobileSocialFeedHistoryTake(server),
+    hasAnalysis: server.has_analysis,
+    drawing: mapMobileSocialFeedDrawing(server.drawing),
+  };
+}
+
+/**
+ * Maps a thoughts page in server order, preserving empty pages with continuation cursors.
+ * @param server - Service payload with its original wire fields.
+ * @returns Thoughts, the next cursor, and the position reading session.
+ * @throws {MobileUnsupportedFeedItemError} If an item is not a post or trade card.
+ */
+export function mapMobileSocialFeedPositionThoughts(
+  server: MobileServerSocialFeedPositionThoughtsResponse,
+): MobileSocialFeedPositionThoughtsPage {
+  return {
+    items: server.items.map(mapMobileSocialFeedPositionThought),
+    nextCursor: server.next_cursor,
+    readSession: mapMobileSocialFeedReadSession(server.read_session),
+  };
+}