@nadohq/mobile-client 0.65.0 → 0.66.0

package/src/dataMappers.test.ts

@@ -6,6 +6,7 @@ import {
   mapMobileSocialFeedDrawingResult,
   mapMobileSocialFeedItem,
   mapMobileSocialFeedItemPatch,
+  mapMobileSocialFeedItemResponse,
   mapMobileSocialFeedMentionToServer,
   mapMobileSocialFeedPage,
   mapMobileSocialFeedPositionAction,
@@ -52,6 +53,7 @@ const post: MobileServerSocialFeedPost = {
     can_comment: true,
     can_record_view: true,
   },
+  images: [],
   text: 'BTC 回踩后继续持有多仓。',
   mentions: [],
   position: {
@@ -136,6 +138,7 @@ const reply: MobileServerSocialFeedReply = {
     can_comment: true,
     can_record_view: false,
   },
+  images: [],
   text: '我会继续观察支撑位。',
   mentions: [],
   root_item_id: '11111111-1111-4111-8111-111111111111',
@@ -280,6 +283,7 @@ const history: MobileServerSocialFeedPositionHistoryResponse = {
           can_comment: true,
           can_record_view: true,
         },
+        images: [],
         text: '持有这一仓位，关注后续价格变化。',
         mentions: [],
         position: {
@@ -362,8 +366,7 @@ const history: MobileServerSocialFeedPositionHistoryResponse = {
     update_cursor: null,
     viewer_token: 'viewer_example_opaque',
     view_tracking: {
-      min_visible_ratio: 0.5,
-      min_duration_ms: 1000,
+      mode: 'detail_visit',
     },
   },
 };
@@ -499,6 +502,109 @@ describe('[mobile-client]: content mapping', () => {
     });
   });
 
+  it('maps empty image arrays in feeds, item details, and comments', () => {
+    const serverReply = { ...reply };
+    const serverPost = {
+      ...post,
+      comment_preview: {
+        ...post.comment_preview,
+        items: [serverReply],
+      },
+    };
+    const serverCard = {
+      ...serverPost,
+      kind: 'trade_card',
+      action: 'opened',
+    } as const;
+    const items: MobileServerSocialFeedItem[] = [
+      serverPost,
+      serverCard,
+      serverReply,
+    ];
+    const page = mapMobileSocialFeedPage({
+      items,
+      next_cursor: null,
+      watermark: 'Watermark',
+      read_session: history.read_session,
+    });
+    expect(page.items).toMatchObject([
+      {
+        kind: 'post',
+        images: [],
+        commentPreview: { items: [{ images: [] }] },
+      },
+      {
+        kind: 'trade_card',
+        images: [],
+        commentPreview: { items: [{ images: [] }] },
+      },
+      { kind: 'reply', images: [] },
+    ]);
+    for (const item of items) {
+      expect(
+        mapMobileSocialFeedItemResponse({
+          item,
+          read_session: history.read_session,
+        }).item,
+      ).toMatchObject({ kind: item.kind, images: [] });
+    }
+    const comments = mapMobileSocialFeedCommentsPage({
+      comments: [serverReply],
+      total_count: 1,
+      next_cursor: null,
+      previous_cursor: null,
+      anchor_reply_id: null,
+      read_session: history.read_session,
+    });
+    expect(comments.comments).toMatchObject([{ kind: 'reply', images: [] }]);
+  });
+
+  it('maps feed images and detail-visit read sessions', () => {
+    const mapped = mapMobileSocialFeedItem({
+      ...post,
+      images: [
+        {
+          image_id: '88888888-8888-4888-8888-888888888888',
+          url: '/v1/mobile/feed/images/88888888-8888-4888-8888-888888888888/standard',
+          width: 1024,
+          height: 256,
+          content_type: 'image/png',
+          byte_size: 123456,
+          thumbnail: {
+            url: '/v1/mobile/feed/images/88888888-8888-4888-8888-888888888888/thumbnail',
+            width: 512,
+            height: 128,
+          },
+        },
+      ],
+    });
+    expect(mapped.kind).toBe('post');
+    if (mapped.kind !== 'post') throw new Error('Expected post');
+    expect(mapped.images).toEqual([
+      {
+        imageId: '88888888-8888-4888-8888-888888888888',
+        url: '/v1/mobile/feed/images/88888888-8888-4888-8888-888888888888/standard',
+        width: 1024,
+        height: 256,
+        contentType: 'image/png',
+        byteSize: 123456,
+        thumbnail: {
+          url: '/v1/mobile/feed/images/88888888-8888-4888-8888-888888888888/thumbnail',
+          width: 512,
+          height: 128,
+        },
+      },
+    ]);
+    expect(
+      mapMobileSocialFeedPage({
+        items: [],
+        next_cursor: null,
+        watermark: 'w',
+        read_session: history.read_session,
+      }).readSession.viewTracking,
+    ).toEqual({ mode: 'detail_visit' });
+  });
+
   it('maps posts, drawings, reply previews, and nullable badges from the documented response', () => {
     const mapped = mapMobileSocialFeedItem({
       ...post,

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,
@@ -31,6 +41,7 @@ import {
   MobileSocialFeedDrawingResult,
   MobileSocialFeedHistoryMetrics,
   MobileSocialFeedHistoryTake,
+  MobileSocialFeedImage,
   MobileSocialFeedInteraction,
   MobileSocialFeedItem,
   MobileSocialFeedItemBase,
@@ -70,6 +81,7 @@ import {
   SearchMobileProfilesParams,
 } from './types/clientTypes';
 import { MobileUnsupportedFeedItemError } from './types/MobileUnsupportedFeedItemError';
+import { MobileUnsupportedNotificationRouteError } from './types/MobileUnsupportedNotificationRouteError';
 import {
   MobileServerAvatarUploadResponse,
   MobileServerFollowBatchResponse,
@@ -86,8 +98,12 @@ import {
   MobileServerFeedTrade,
   MobileServerFollowSummary,
   MobileServerIdentitySummary,
+  MobileServerNotificationPayloadV2,
   MobileServerNotificationPreferenceScope,
   MobileServerNotificationPreferences,
+  MobileServerNotificationRoute,
+  MobileServerNotificationSettings,
+  MobileServerProductEvent,
   MobileServerProfile,
   MobileServerSocialFeedActionCandidate,
   MobileServerSocialFeedActionMarker,
@@ -98,6 +114,7 @@ import {
   MobileServerSocialFeedDrawing,
   MobileServerSocialFeedHistoryMetrics,
   MobileServerSocialFeedHistoryTake,
+  MobileServerSocialFeedImage,
   MobileServerSocialFeedInteraction,
   MobileServerSocialFeedItem,
   MobileServerSocialFeedItemBase,
@@ -123,6 +140,10 @@ import {
 import {
   MobileServerFeedResponse,
   MobileServerFollowListResponse,
+  MobileServerNotificationInboxV2Response,
+  MobileServerNotificationRegistrationV2Response,
+  MobileServerNotificationSettingsV2Response,
+  MobileServerNotificationSubscriptionsResponse,
   MobileServerRegisteredWalletResponse,
   MobileServerSearchProfilesResponse,
   MobileServerSocialFeedActionResolutionResponse,
@@ -141,7 +162,9 @@ import {
 } from './types/serverQueryTypes';
 import {
   MobileServerFollowListRequest,
+  MobileServerNotificationSubscriptionsUpdate,
   MobileServerProfilesInclude,
+  MobileServerRegisterExpoTokenV2Params,
   MobileServerSearchProfilesRequest,
   MobileServerSocialFeedListParams,
   MobileServerSocialFeedReadParams,
@@ -170,6 +193,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 +794,29 @@ 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 mapMobileSocialFeedImage(
+  server: MobileServerSocialFeedImage,
+): MobileSocialFeedImage {
+  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 common item metadata and server capabilities.
  * @param server - The service response.
@@ -606,6 +855,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 +965,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 +976,7 @@ 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,
-    },
+    viewTracking: { mode: server.view_tracking.mode },
     updateCursor: server.update_cursor,
     viewerToken: server.viewer_token,
   };
@@ -1023,6 +1270,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,