@nadohq/mobile-client 0.64.0 → 0.66.0

package/src/MobileClient.ts

@@ -5,6 +5,7 @@ import {
   WalletNotProvidedError,
 } from '@nadohq/shared';
 import axios, { AxiosInstance, AxiosResponse } from 'axios';
+import { bytesToString, keccak256, zeroHash } from 'viem';
 import {
   mapMobileAvatarPreset,
   mapMobileAvatarSelectionToServer,
@@ -14,29 +15,58 @@ import {
   mapMobileFollowListPage,
   mapMobileFollowListParamsToServer,
   mapMobileFollowMutationResult,
+  mapMobileNotificationCapabilitiesToServer,
+  mapMobileNotificationInboxV2,
   mapMobileNotificationPreferences,
   mapMobileNotificationPreferencesToServer,
+  mapMobileNotificationRegistrationV2,
+  mapMobileNotificationSettingsToServer,
+  mapMobileNotificationSettingsV2,
+  mapMobileNotificationSubscriptions,
+  mapMobileNotificationSubscriptionsUpdateToServer,
+  mapMobileProductEventToServer,
   mapMobileProfileSearchPage,
   mapMobileProfileSearchParamsToServer,
   mapMobileProfilesIncludeToServer,
   mapMobilePublicProfile,
   mapMobileRegisteredWallet,
+  mapMobileSocialFeedActionResolutionResult,
+  mapMobileSocialFeedCommentResult,
+  mapMobileSocialFeedCommentsPage,
+  mapMobileSocialFeedDrawingMutationResult,
+  mapMobileSocialFeedDrawingResult,
+  mapMobileSocialFeedImage,
+  mapMobileSocialFeedItem,
   mapMobileSocialFeedItemResponse,
+  mapMobileSocialFeedLikeResult,
   mapMobileSocialFeedListParamsToServer,
+  mapMobileSocialFeedMentionToServer,
   mapMobileSocialFeedPage,
+  mapMobileSocialFeedPositionChart,
+  mapMobileSocialFeedPositionHistory,
+  mapMobileSocialFeedPositionResolutionResult,
+  mapMobileSocialFeedPositionsPage,
+  mapMobileSocialFeedPresence,
   mapMobileSocialFeedRankedPage,
   mapMobileSocialFeedReadParamsToServer,
   mapMobileSocialFeedTopTradersPage,
   mapMobileSocialFeedUpdates,
+  mapMobileSocialFeedViewsResult,
+  mapMobileSocialFeedWatchers,
 } from './dataMappers';
 import {
   buildSignedMobileRequest,
+  getMobileNonce,
   MobileSignedInner,
   MobileSignedInnerByType,
   MobileSignedInnerParams,
   MobileSignedRequest,
 } from './signing';
 import {
+  GetMobileFeedChartDrawingParams,
+  GetMobileFeedCommentsParams,
+  GetMobileFeedImageBytesParams,
+  GetMobileFeedImageRequestParams,
   GetMobileFeedItemParams,
   GetMobileFeedParams,
   GetMobileFeedUpdatesParams,
@@ -45,40 +75,81 @@ import {
   GetMobileForYouFeedParams,
   GetMobileFriendsFeedParams,
   GetMobileMarketFeedParams,
+  GetMobileNotificationInboxV2Params,
   GetMobileNotificationPreferencesParams,
+  GetMobileNotificationRegistrationV2Params,
+  GetMobileNotificationSettingsV2Params,
+  GetMobileNotificationSubscriptionsParams,
+  GetMobilePositionChartParams,
   GetMobilePositionFeedParams,
+  GetMobilePositionHistoryParams,
+  GetMobilePositionWatchersParams,
   GetMobileProfileFeedParams,
   GetMobileProfilesParams,
   GetMobileRegisteredWalletParams,
+  GetMobileSelfFeedPositionsParams,
   GetMobileTopTradersFeedParams,
   GetMobileUsernameAvailabilityParams,
   MobileAvatarPreset,
   MobileAvatarUpload,
   MobileCreateAvatarUploadParams,
+  MobileCreateFeedCommentParams,
+  MobileCreateFeedImageUploadParams,
+  MobileCreateFeedPostParams,
+  MobileFeedChartDrawingParams,
+  MobileFeedImageRequest,
   MobileFeedPage,
   MobileFollowBatchResultItem,
   MobileFollowListPage,
   MobileFollowMutationResult,
+  MobileNotificationInboxV2,
   MobileNotificationPreferences,
+  MobileNotificationRegistrationV2,
+  MobileNotificationSettingsV2,
+  MobileNotificationSubscriptions,
+  MobilePositionPresenceParams,
   MobileProfileSearchPage,
   MobilePublicProfile,
+  MobileRecordFeedViewsParams,
+  MobileRecordProductEventsParams,
   MobileRegisteredWallet,
   MobileRegisterExpoTokenParams,
+  MobileRegisterExpoTokenV2Params,
   MobileSetAvatarParams,
   MobileSetBioParams,
+  MobileSetFeedLikeParams,
   MobileSetFollowBatchParams,
   MobileSetFollowParams,
   MobileSetPrivateModeParams,
   MobileSetUsernameParams,
   MobileSignedRequestParams,
+  MobileSocialFeedActionResolutionResult,
+  MobileSocialFeedCommentResult,
+  MobileSocialFeedCommentsPage,
+  MobileSocialFeedDrawingMutationResult,
+  MobileSocialFeedDrawingResult,
+  MobileSocialFeedImage,
+  MobileSocialFeedItem,
   MobileSocialFeedItemResponse,
+  MobileSocialFeedLikeResult,
   MobileSocialFeedPage,
+  MobileSocialFeedPositionChart,
+  MobileSocialFeedPositionHistory,
+  MobileSocialFeedPositionResolutionResult,
+  MobileSocialFeedPositionsPage,
+  MobileSocialFeedPresence,
   MobileSocialFeedRankedPage,
   MobileSocialFeedTopTradersPage,
   MobileSocialFeedUpdates,
+  MobileSocialFeedViewsResult,
+  MobileSocialFeedWatchers,
   MobileUnregisterExpoTokenParams,
   MobileUpdateNotificationPreferencesParams,
+  MobileUpdateNotificationSettingsV2Params,
+  MobileUpdateNotificationSubscriptionsParams,
   MobileUsernameAvailability,
+  ResolveMobileFeedActionParams,
+  ResolveMobileFeedPositionParams,
   SearchMobileProfilesParams,
 } from './types/clientTypes';
 import { MobileServerFailureError } from './types/MobileServerFailureError';
@@ -87,16 +158,23 @@ import {
   MobileServerExecuteResult,
   MobileServerExecuteSuccessResponse,
   MobileServerPublicExecuteRequest,
+  MobileServerPublicExecuteSuccessResponse,
 } from './types/serverExecuteTypes';
 import {
   MobileServerPublicQueryRequest,
   MobileServerPublicQuerySuccessResponse,
+  MobileServerSignedQuerySuccessResponse,
 } from './types/serverQueryTypes';
 import {
   MobileServerExecuteRequestType,
+  MobileServerPublicExecuteRequestByType,
+  MobileServerPublicExecuteRequestType,
   MobileServerPublicQueryRequestByType,
   MobileServerPublicQueryRequestType,
+  MobileServerSignedQueryRequestType,
 } from './types/serverRequestTypes';
+import { buildMobileFeedImageMultipart } from './utils/buildMobileFeedImageMultipart';
+import { MOBILE_FEED_IMAGE_MAX_REQUEST_BYTES } from './utils/feed';
 import {
   isMobileServerFailureResponse,
   isMobileServerSuccessResponse,
@@ -312,6 +390,7 @@ export class MobileClient {
    * @param params - Filters, pagination, optional viewing account, and browser credential; no signing identity.
    * @returns A fixed-session page with its ranking version and new-content watermark.
    * @throws {MobileServerFailureError} On invalid parameters, session mismatch/expiry, or unavailable data.
+   * @throws {MobileUnsupportedFeedItemError} If the service returns an unsupported item kind.
    */
   async getForYouFeed(
     params: GetMobileForYouFeedParams = {},
@@ -332,6 +411,7 @@ export class MobileClient {
    * @param params - Filters, pagination, optional viewing account, and browser credential.
    * @returns A page with its qualification cohort; an unavailable cohort fails instead of returning an empty ranking.
    * @throws {MobileServerFailureError} On request/session errors or unavailable cohort data.
+   * @throws {MobileUnsupportedFeedItemError} If the service returns an unsupported item kind.
    */
   async getTopTradersFeed(
     params: GetMobileTopTradersFeedParams = {},
@@ -351,6 +431,7 @@ export class MobileClient {
    * @param params - Required viewing account on every request, filters, pagination, and browser credential.
    * @returns A chronological Friends page and reading session.
    * @throws {MobileServerFailureError} On invalid viewing account, session errors, or feed query failure.
+   * @throws {MobileUnsupportedFeedItemError} If the service returns an unsupported item kind.
    */
   async getFriendsFeed(
     params: GetMobileFriendsFeedParams,
@@ -371,6 +452,7 @@ export class MobileClient {
    * @param params - Target identity, filters, pagination, and optional public viewing account.
    * @returns An author page without main-feed ranking or cohort fields.
    * @throws {MobileServerFailureError} On invalid parameters, session errors, or inaccessible content.
+   * @throws {MobileUnsupportedFeedItemError} If the service returns an unsupported item kind.
    */
   async getProfileFeed(
     params: GetMobileProfileFeedParams,
@@ -391,6 +473,7 @@ export class MobileClient {
    * @param params - Product ID, content/size filters, pagination, and public viewing account.
    * @returns A market page without main-feed ranking fields.
    * @throws {MobileServerFailureError} On an unknown market, session errors, or unavailable data.
+   * @throws {MobileUnsupportedFeedItemError} If the service returns an unsupported item kind.
    */
   async getMarketFeed(
     params: GetMobileMarketFeedParams,
@@ -411,6 +494,7 @@ export class MobileClient {
    * @param params - Position UUID, filters, pagination, and public viewing account.
    * @returns A fixed-session position feed page.
    * @throws {MobileServerFailureError} On inaccessible content, session errors, or unavailable data.
+   * @throws {MobileUnsupportedFeedItemError} If the service returns an unsupported item kind.
    */
   async getPositionFeed(
     params: GetMobilePositionFeedParams,
@@ -428,9 +512,12 @@ export class MobileClient {
   /**
    * Reads one item visible to viewAs, including that account's own hidden content.
    * Creates an item session directly when sessionId is omitted.
-   * @param params - Item UUID, preview limit, and optional existing session/read identity.
+   * Pass {@link GetMobileFeedItemParams.viewEventId} when the user navigates into the detail so the
+   * subsequent {@link recordFeedViews} call can count that visit; omit it for prefetch.
+   * @param params - Item UUID, optional detail-visit event, preview limit, and optional existing session/read identity.
    * @returns The complete item and authorized reading session.
    * @throws {MobileServerFailureError} On inaccessible content or session mismatch/expiry.
+   * @throws {MobileUnsupportedFeedItemError} If the service returns an unsupported item kind.
    */
   async getFeedItem(
     params: GetMobileFeedItemParams,
@@ -438,6 +525,7 @@ export class MobileClient {
     const body: MobileServerPublicQueryRequest<'feed_item'> = {
       type: 'feed_item',
       item_id: params.itemId,
+      view_event_id: params.viewEventId,
       comment_preview_limit: params.commentPreviewLimit,
       session_id: params.sessionId,
       ...mapMobileSocialFeedReadParamsToServer(params),
@@ -481,6 +569,7 @@ export class MobileClient {
    *
    * @throws {MobileServerFailureError} With error code `INVALID_EXPO_TOKEN` if the token is malformed, or is
    * not currently registered to a wallet.
+   * @deprecated Use {@link getNotificationSettingsV2} instead.
    */
   async getNotificationPreferences(
     params: GetMobileNotificationPreferencesParams,
@@ -514,6 +603,302 @@ export class MobileClient {
     return mapMobileRegisteredWallet(data);
   }
 
+  /**
+   * Lists a selected account's current positions without signing or authenticating ownership.
+   * Publication and attachment eligibility are hints that the service rechecks on writes.
+   * @param params - Viewing subaccount, optional market filter, page size, and opaque cursor.
+   * @returns Current position candidates, their eligibility hints, the next cursor, and observation time.
+   * @throws {MobileServerFailureError} On invalid parameters, an unsupported viewing account, or unavailable
+   * position data. An account with no open positions returns an empty page instead of an error.
+   */
+  async getSelfFeedPositions(
+    params: GetMobileSelfFeedPositionsParams,
+  ): Promise<MobileSocialFeedPositionsPage> {
+    const body: MobileServerPublicQueryRequest<'self_feed_positions'> = {
+      type: 'self_feed_positions',
+      view_as: subaccountToHex(params.viewAs),
+      product_id: params.productId,
+      cursor: params.cursor,
+      limit: params.limit,
+    };
+    return mapMobileSocialFeedPositionsPage(await this.publicQuery(body));
+  }
+
+  /**
+   * Resolves a slash command against a selected account without changing the caller's input.
+   * @param params - Viewing subaccount, original command text, and optional market disambiguation.
+   * @returns The resolution, nullable market, candidate positions, and reason for an empty result.
+   * @throws {MobileServerFailureError} On invalid parameters, an unsupported viewing account, or unavailable
+   * source data. Unknown markets and accounts without open positions are normal resolution results.
+   */
+  async resolveFeedPosition(
+    params: ResolveMobileFeedPositionParams,
+  ): Promise<MobileSocialFeedPositionResolutionResult> {
+    const body: MobileServerPublicQueryRequest<'resolve_feed_position'> = {
+      type: 'resolve_feed_position',
+      view_as: subaccountToHex(params.viewAs),
+      input: params.input,
+      product_id: params.productId,
+    };
+    return mapMobileSocialFeedPositionResolutionResult(
+      await this.publicQuery(body),
+    );
+  }
+
+  /**
+   * Resolves every trusted lifecycle segment of an order without requiring a signature.
+   * @param params - Order-owning subaccount and order digest; selecting the account is not authentication.
+   * @returns Trusted action candidates and their observation time, or a pending result with no actions.
+   * @throws {MobileServerFailureError} On invalid parameters, an inaccessible order, or unavailable source
+   * data. Pending projection is a successful result, not a source failure.
+   */
+  async resolveFeedAction(
+    params: ResolveMobileFeedActionParams,
+  ): Promise<MobileSocialFeedActionResolutionResult> {
+    const body: MobileServerPublicQueryRequest<'resolve_feed_action'> = {
+      type: 'resolve_feed_action',
+      view_as: subaccountToHex(params.viewAs),
+      order_digest: params.orderDigest,
+    };
+    return mapMobileSocialFeedActionResolutionResult(
+      await this.publicQuery(body),
+    );
+  }
+
+  /**
+   * Reads a drawing publicly without issuing a reading session. Supplied sessions retain their scope.
+   * @param params - Parent item, optional viewing account, and optional original session and viewer token.
+   * @returns The parent ID and version, with a nullable drawing whose data may legitimately be false or zero.
+   * @throws {MobileServerFailureError} On invalid parameters, session mismatch or expiry, unavailable data,
+   * or `SOCIAL_FEED_DRAWING_UNAVAILABLE` when the parent is inaccessible. A readable parent without a drawing
+   * returns null. Acquire a new reading session when the original has expired.
+   */
+  async getFeedChartDrawing(
+    params: GetMobileFeedChartDrawingParams,
+  ): Promise<MobileSocialFeedDrawingResult> {
+    const body: MobileServerPublicQueryRequest<'feed_chart_drawing'> = {
+      type: 'feed_chart_drawing',
+      item_id: params.itemId,
+      session_id: params.sessionId,
+      ...mapMobileSocialFeedReadParamsToServer(params),
+    };
+    return mapMobileSocialFeedDrawingResult(await this.publicQuery(body));
+  }
+
+  /**
+   * Resolves a backend feed image path against this client's mobile gateway URL.
+   * @param path - Backend path from image metadata, rooted at /v1/mobile or the mobile service root.
+   * @returns An absolute URL suitable for authenticated fetches.
+   */
+  resolveFeedImageUrl(path: string): string {
+    return `${this.opts.url}${path.replace(/^\/v1\/mobile(?=\/)/, '')}`;
+  }
+
+  /**
+   * Prepares a protected image request for native image components without downloading or encoding bytes.
+   * Does not count as a detail visit or recorded view.
+   * @param params - Image path from metadata plus the original session credentials.
+   * @returns Absolute URL and headers; pass them as the image source's URI and headers.
+   */
+  getFeedImageRequest(
+    params: GetMobileFeedImageRequestParams,
+  ): MobileFeedImageRequest {
+    return {
+      url: this.resolveFeedImageUrl(params.path),
+      headers: {
+        'x-feed-session-id': params.sessionId,
+        'x-feed-viewer-token': params.viewerToken,
+      },
+    };
+  }
+
+  /**
+   * Fetches protected feed image bytes using the reading session that fully delivered the parent item.
+   * Does not count as a detail visit or recorded view.
+   * @param params - Image path from metadata plus the original session credentials.
+   * @returns Raw image bytes.
+   * @throws {MobileServerFailureError} On session, permission, or availability errors.
+   */
+  async getFeedImageBytes(
+    params: GetMobileFeedImageBytesParams,
+  ): Promise<Uint8Array> {
+    const { url, headers } = this.getFeedImageRequest(params);
+    return this.publicGetBytes(url, headers);
+  }
+
+  /**
+   * Reads a comment thread with an optional anchor and bidirectional pagination.
+   * Independent reads create a public-only session; reused sessions retain their original scope.
+   * @param params - Root item, optional anchor or cursor (mutually exclusive), page size, and read perspective.
+   * Paging requires the original session and viewer token.
+   * @returns Replies, total count, forward and backward cursors, the anchor, and the actual reading session.
+   * @throws {MobileServerFailureError} On invalid parameters, session mismatch or expiry, inaccessible content,
+   * or unavailable data. Restart pagination with a new session after expiry; do not reuse the old cursor.
+   */
+  async getFeedComments(
+    params: GetMobileFeedCommentsParams,
+  ): Promise<MobileSocialFeedCommentsPage> {
+    const body: MobileServerPublicQueryRequest<'feed_comments'> = {
+      type: 'feed_comments',
+      root_item_id: params.rootItemId,
+      cursor: params.cursor,
+      limit: params.limit,
+      anchor_reply_id: params.anchorReplyId,
+      session_id: params.sessionId,
+      ...mapMobileSocialFeedReadParamsToServer(params),
+    };
+    return mapMobileSocialFeedCommentsPage(await this.publicQuery(body));
+  }
+
+  /**
+   * Reads the full position lifecycle and creates or reuses a position session.
+   * Unlike getPositionFeed, this includes lifecycle actions as well as published takes.
+   * @param params - Position, optional takes-only filter, pagination, and read perspective. Paging requires
+   * the original position session and viewer token, not a feed session.
+   * @returns Position metrics, ordered action/take history, summary, trading hints, cursor, and reading session.
+   * @throws {MobileServerFailureError} On invalid parameters, session mismatch or expiry, inaccessible content,
+   * or unavailable source data. Restart with a new position session after expiry.
+   * @throws {MobileUnsupportedFeedItemError} If a timeline entry or take has an unsupported kind.
+   */
+  async getPositionHistory(
+    params: GetMobilePositionHistoryParams,
+  ): Promise<MobileSocialFeedPositionHistory> {
+    const body: MobileServerPublicQueryRequest<'position_history'> = {
+      type: 'position_history',
+      position_id: params.positionId,
+      takes_only: params.takesOnly,
+      cursor: params.cursor,
+      limit: params.limit,
+      session_id: params.sessionId,
+      ...mapMobileSocialFeedReadParamsToServer(params),
+    };
+    return mapMobileSocialFeedPositionHistory(await this.publicQuery(body));
+  }
+
+  /**
+   * Reads candles and action markers without creating a reading session.
+   * Preserve the original range, interval, and read perspective when paging with nextBeforeMs.
+   * @param params - Position, candle interval, half-open time range, pagination, and optional original session
+   * and viewer token. An independent read omits both session credentials.
+   * @returns Candles with decimal prices and x18 volume, action markers, a nullable liquidation line, and paging metadata.
+   * @throws {MobileServerFailureError} On invalid parameters, session mismatch or expiry, inaccessible content,
+   * or wholly unavailable chart sources. Partially available data is returned with its quality indicator.
+   */
+  async getPositionChart(
+    params: GetMobilePositionChartParams,
+  ): Promise<MobileSocialFeedPositionChart> {
+    const body: MobileServerPublicQueryRequest<'position_chart'> = {
+      type: 'position_chart',
+      position_id: params.positionId,
+      session_id: params.sessionId,
+      interval: params.interval,
+      range: { from_ms: params.range.fromMs, to_ms: params.range.toMs },
+      before_ms: params.beforeMs,
+      limit: params.limit,
+      ...mapMobileSocialFeedReadParamsToServer(params),
+    };
+    return mapMobileSocialFeedPositionChart(await this.publicQuery(body));
+  }
+
+  /**
+   * Reads active visitor counts and self-reported account previews without registering presence.
+   * @param params - Position and optional viewing account, used only for preview relationship information.
+   * @returns The visitor count, public account previews, and observation time; previews need not match the count.
+   * @throws {MobileServerFailureError} On invalid parameters, an unavailable position, or unavailable source data.
+   */
+  async getPositionWatchers(
+    params: GetMobilePositionWatchersParams,
+  ): Promise<MobileSocialFeedWatchers> {
+    const body: MobileServerPublicQueryRequest<'position_watchers'> = {
+      type: 'position_watchers',
+      position_id: params.positionId,
+      view_as:
+        params.viewAs === undefined
+          ? undefined
+          : subaccountToHex(params.viewAs),
+    };
+    return mapMobileSocialFeedWatchers(await this.publicQuery(body));
+  }
+
+  /**
+   * Reads the token's latest registration generation and saved capabilities, including legacy v1 registrations.
+   * @param params - Active Expo token credential; no wallet signature is needed.
+   * @returns Saved generation as an opaque string and the complete capability declaration.
+   * @throws {MobileServerFailureError} If the token is invalid or inactive (`INVALID_EXPO_TOKEN`).
+   */
+  async getNotificationRegistrationV2(
+    params: GetMobileNotificationRegistrationV2Params,
+  ): Promise<MobileNotificationRegistrationV2> {
+    return mapMobileNotificationRegistrationV2(
+      await this.publicQuery({
+        type: 'notification_registration_v2',
+        expo_token: params.expoToken,
+      }),
+    );
+  }
+
+  /**
+   * Reads the wallet's full v2 settings document, including legacy preference mappings.
+   * @param params - Active Expo token credential. Before displaying settings, compare the wallet returned by
+   *   {@link MobileClient.getRegisteredWallet} with the connected wallet (case-insensitively).
+   * @returns CamelCase settings with the current settings revision.
+   * @throws {MobileServerFailureError} If the token is invalid or inactive (`INVALID_EXPO_TOKEN`).
+   */
+  async getNotificationSettingsV2(
+    params: GetMobileNotificationSettingsV2Params,
+  ): Promise<MobileNotificationSettingsV2> {
+    return mapMobileNotificationSettingsV2(
+      await this.publicQuery({
+        type: 'notification_settings_v2',
+        expo_token: params.expoToken,
+      }),
+    );
+  }
+
+  /*
+  Signed queries
+   */
+
+  /**
+   * Reads wallet market subscriptions and the signing Identity's enabled trader bells.
+   * @param params - Wallet authentication context; no Expo token is needed.
+   * @returns Subscriptions, import state, and the independent subscription revision.
+   * @throws {WalletNotProvidedError} If neither a linked signer nor a default wallet is configured.
+   * @throws {MobileServerFailureError} If authentication or the query fails.
+   */
+  async getNotificationSubscriptions(
+    params: GetMobileNotificationSubscriptionsParams,
+  ): Promise<MobileNotificationSubscriptions> {
+    const request = await this.getSignedRequest(
+      'notification_subscriptions',
+      params,
+      {},
+    );
+    return mapMobileNotificationSubscriptions(await this.query(request));
+  }
+
+  /**
+   * Reads private accepted notification intents, not delivery receipts or read states.
+   * @param params - Wallet authentication and optional cursor/page size (1-50, default 20).
+   * @returns A camelCase page; discard cached pages and cursors when switching wallets.
+   * @throws {WalletNotProvidedError} If neither a linked signer nor a default wallet is configured.
+   * @throws {MobileServerFailureError} If authentication or pagination validation fails.
+   * @throws {MobileUnsupportedNotificationRouteError} If a notification has an unsupported route name.
+   */
+  async getNotificationInboxV2(
+    params: GetMobileNotificationInboxV2Params,
+  ): Promise<MobileNotificationInboxV2> {
+    const request = await this.getSignedRequest(
+      'notification_inbox_v2',
+      params,
+      {
+        cursor: params.cursor ?? null,
+        limit: params.limit ?? null,
+      },
+    );
+    return mapMobileNotificationInboxV2(await this.query(request));
+  }
+
   /*
   Public executes
    */
@@ -549,6 +934,7 @@ export class MobileClient {
    *
    * @throws {MobileServerFailureError} With error code `INVALID_PREFERENCES` if those rules are violated, or
    * `INVALID_EXPO_TOKEN` if the token is malformed or is not currently registered to a wallet.
+   * @deprecated Use {@link updateNotificationSettingsV2} instead.
    */
   async updateNotificationPreferences(
     params: MobileUpdateNotificationPreferencesParams,
@@ -561,6 +947,82 @@ export class MobileClient {
     return this.publicExecute(body);
   }
 
+  /**
+   * Replaces all v2 settings fields using optimistic concurrency; legacy overlapping preferences are synced.
+   * @param params - Active Expo token, latest settings revision, and complete replacement settings.
+   * @returns The saved settings document with its incremented revision.
+   * @throws {MobileServerFailureError} On invalid token/settings or revision conflict (`NOTIFICATION_REVISION_CONFLICT`). Re-read and
+   * merge only the user's current change before retrying; never blindly replay a stale document.
+   */
+  async updateNotificationSettingsV2(
+    params: MobileUpdateNotificationSettingsV2Params,
+  ): Promise<MobileNotificationSettingsV2> {
+    return mapMobileNotificationSettingsV2(
+      await this.publicExecute({
+        type: 'update_notification_settings_v2',
+        expo_token: params.expoToken,
+        expected_revision: params.expectedRevision,
+        settings: mapMobileNotificationSettingsToServer(params.settings),
+      }),
+    );
+  }
+
+  /**
+   * Reports a detail visit without signing. Feed-list card impressions and previews do not count.
+   * After the primary detail target is shown in the foreground, send the same viewEventId previously
+   * registered through {@link getFeedItem}, together with that response's sessionId and viewerToken.
+   * Reuse the event ID on retries for the same visit; generate a new one only after leaving and re-entering.
+   * @param params - Original reading session and viewer token, the registered detail-visit event, and exactly
+   * one fully delivered, readable detail-target item ID.
+   * @returns Separate lists of newly accepted and already-counted item IDs for that event.
+   * @throws {MobileServerFailureError} On invalid parameters, an unregistered or rebound event
+   * (`SOCIAL_FEED_VIEW_EVENT_REBOUND`), session mismatch or expiry, or an ineligible item.
+   * Acquire a new session after expiry, re-register the same event via getFeedItem, then retry.
+   */
+  async recordFeedViews(
+    params: MobileRecordFeedViewsParams,
+  ): Promise<MobileSocialFeedViewsResult> {
+    const body: MobileServerPublicExecuteRequest<'record_feed_views'> = {
+      type: 'record_feed_views',
+      session_id: params.sessionId,
+      viewer_token: params.viewerToken,
+      view_event_id: params.viewEventId,
+      item_ids: [params.itemId],
+    };
+    return mapMobileSocialFeedViewsResult(await this.publicExecute(body));
+  }
+
+  /**
+   * Registers, renews, or leaves a page lease without signing or authenticating the displayed account.
+   * Omitting watcherSubaccount preserves its value; null clears it. This operation does not record item views.
+   * @param params - Authorized position, original session and viewer token, page-scoped viewSessionId,
+   * lease state, and optional self-reported display account. Retain viewSessionId for the lifetime of the page.
+   * @returns Visitor count, public previews, recommended heartbeat interval, and remaining lease lifetime.
+   * @throws {MobileServerFailureError} On invalid parameters, session mismatch or expiry, or an inaccessible
+   * position. Rejected requests leave leases unchanged; acquire a new reading session after expiry.
+   */
+  async setPositionPresence(
+    params: MobilePositionPresenceParams,
+  ): Promise<MobileSocialFeedPresence> {
+    const body: MobileServerPublicExecuteRequest<'position_presence'> = {
+      type: 'position_presence',
+      position_id: params.positionId,
+      session_id: params.sessionId,
+      view_session_id: params.viewSessionId,
+      state: params.state,
+      viewer_token: params.viewerToken,
+      ...(params.watcherSubaccount === undefined
+        ? {}
+        : {
+            watcher_subaccount:
+              params.watcherSubaccount === null
+                ? null
+                : subaccountToHex(params.watcherSubaccount),
+          }),
+    };
+    return mapMobileSocialFeedPresence(await this.publicExecute(body));
+  }
+
   /*
   Signed executes
    */
@@ -661,11 +1123,13 @@ export class MobileClient {
 
   /**
    * Registers an Expo push token for the wallet, transferring active ownership of the token if another
-   * wallet had registered it. Idempotent per `(wallet, token)`.
+   * wallet had registered it. Each registration advances its generation and cancels old pending deliveries.
+   * This legacy method replaces capabilities with v1; use registerExpoTokenV2 consistently after upgrading.
    *
    * @throws {MobileServerFailureError} With error code `INVALID_EXPO_TOKEN` if the token is not a valid Expo
    * push token, or `INVALID_DEVICE_METADATA` if `locale` (max 35 chars) or `appVersion` (max 64 chars) is
    * too long.
+   * @deprecated Use {@link registerExpoTokenV2} instead.
    */
   async registerExpoToken(
     params: MobileRegisterExpoTokenParams,
@@ -683,6 +1147,70 @@ export class MobileClient {
     return this.execute(signedRequest);
   }
 
+  /**
+   * Registers a device with its actual v2 capabilities; do not use repeated registration as a heartbeat.
+   * @param params - Wallet authentication, Expo token, metadata, and supported notification types/routes.
+   * @returns Success only; query registration separately for its new generation.
+   * @throws {WalletNotProvidedError} If neither a linked signer nor a default wallet is configured.
+   * @throws {MobileServerFailureError} On `INVALID_EXPO_TOKEN`, `INVALID_DEVICE_METADATA`,
+   * `NOTIFICATION_DEVICE_LIMIT` when the wallet already has 32 active devices, or authentication errors.
+   */
+  async registerExpoTokenV2(
+    params: MobileRegisterExpoTokenV2Params,
+  ): Promise<MobileServerSuccessResponse> {
+    const request = await this.getSignedRequest(
+      'register_expo_token_v2',
+      params,
+      {
+        expo_token: params.expoToken,
+        platform: params.platform,
+        locale: params.locale ?? null,
+        app_version: params.appVersion ?? null,
+        capabilities: mapMobileNotificationCapabilitiesToServer(
+          params.capabilities,
+        ),
+      },
+    );
+    return this.execute(request);
+  }
+
+  /**
+   * Applies exactly one bell, market, or one-time favorites-import operation.
+   * @param params - Wallet authentication and subscription update with the latest subscription revision.
+   * @returns Success only; re-query subscriptions for the new revision even after a repeated ON/OFF.
+   * @throws {WalletNotProvidedError} If neither a linked signer nor a default wallet is configured.
+   * @throws {MobileServerFailureError} On `NOTIFICATION_REVISION_CONFLICT`, `INVALID_NOTIFICATION_REQUEST`, or
+   * `INVALID_IDENTITY_TARGET`.
+   */
+  async updateNotificationSubscriptions(
+    params: MobileUpdateNotificationSubscriptionsParams,
+  ): Promise<MobileServerSuccessResponse> {
+    const request = await this.getSignedRequest(
+      'update_notification_subscriptions',
+      params,
+      mapMobileNotificationSubscriptionsUpdateToServer(params.update),
+    );
+    return this.execute(request);
+  }
+
+  /**
+   * Atomically records 1-50 analytics events after the user has consented to analytics.
+   * @param params - Wallet authentication and events with stable UUIDs and actual millisecond timestamps.
+   * @returns Success only; reuse event IDs on retries. Notification clicks do not mark an inbox item as read.
+   * @throws {WalletNotProvidedError} If neither a linked signer nor a default wallet is configured.
+   * @throws {MobileServerFailureError} If any event, timestamp, batch size, or notification ownership is invalid.
+   */
+  async recordProductEvents(
+    params: MobileRecordProductEventsParams,
+  ): Promise<MobileServerSuccessResponse> {
+    const request = await this.getSignedRequest(
+      'record_product_events',
+      params,
+      { events: params.events.map(mapMobileProductEventToServer) },
+    );
+    return this.execute(request);
+  }
+
   /**
    * Sets whether the signing subaccount follows a Profile. Both directions are idempotent: following again
    * keeps the original relationship creation time, so it does not move the account in recency order, and
@@ -740,6 +1268,170 @@ export class MobileClient {
     return mapMobileFollowBatchResult(data);
   }
 
+  /**
+   * Publishes text, a drawing, or both atomically using the signed author identity.
+   * For an idempotent retry, reuse clientRequestId and the exact original content with a valid signature.
+   * The SDK does not trim text or reformat the signed drawing JSON.
+   * @param params - Author subaccount and signing options, request UUID, owned position, original text and
+   * mentions, plus an optional trusted action and original drawing JSON.
+   * @returns The published item, including authoritative interaction state and any drawing or comment preview.
+   * @throws {WalletNotProvidedError} If neither a linked signer nor a default wallet is configured.
+   * @throws {MobileServerFailureError} On authentication, ownership, eligibility, content, mention, or drawing
+   * errors, or `SOCIAL_FEED_REQUEST_CONFLICT` when a request UUID is reused with different content. Do not
+   * change an earlier request to retry it; use a new UUID for a genuinely new publication.
+   * @throws {MobileUnsupportedFeedItemError} If the service returns an unsupported item kind.
+   */
+  async createFeedPost(
+    params: MobileCreateFeedPostParams,
+  ): Promise<MobileSocialFeedItem> {
+    const request = await this.getSignedRequest('create_feed_post', params, {
+      client_request_id: params.clientRequestId,
+      position_id: params.positionId,
+      action_id: params.actionId,
+      text: params.text,
+      mentions: params.mentions.map(mapMobileSocialFeedMentionToServer),
+      drawing_data_json: params.drawingDataJson,
+      image_ids: params.imageIds,
+    });
+    return mapMobileSocialFeedItem((await this.execute(request)).item);
+  }
+
+  /**
+   * Uploads one static JPEG/PNG for a later {@link createFeedPost} via multipart execute.
+   * The whole HTTP request must stay within 2 MiB including signature overhead; upload one file per call
+   * and bind up to nine ready IDs at publication. There is no complete/PUT step — success means ready.
+   * @param params - Author subaccount and signing options, plus the original file bytes.
+   * @returns Ready image metadata, including original and thumbnail paths.
+   * @throws {WalletNotProvidedError} If neither a linked signer nor a default wallet is configured.
+   * @throws {RangeError} If the complete multipart request exceeds {@link MOBILE_FEED_IMAGE_MAX_REQUEST_BYTES}.
+   * @throws {MobileServerFailureError} On authentication, format/size/hash errors (`INVALID_SOCIAL_FEED_IMAGE`),
+   * or when publishing is disabled (`SERVICE_UNAVAILABLE`), or image storage is unavailable
+   * (`SOCIAL_FEED_DATA_UNAVAILABLE`, 6320, HTTP 503).
+   */
+  async createFeedPostImageUpload(
+    params: MobileCreateFeedImageUploadParams,
+  ): Promise<MobileSocialFeedImage> {
+    return this.createFeedImageUpload('create_feed_post_image_uploads', params);
+  }
+
+  /**
+   * Uploads one static JPEG/PNG for a later {@link createFeedComment} via multipart execute.
+   * Same size and readiness rules as {@link createFeedPostImageUpload}; comment text remains required.
+   * @param params - Author subaccount and signing options, plus the original file bytes.
+   * @returns Ready image metadata, including original and thumbnail paths.
+   * @throws {WalletNotProvidedError} If neither a linked signer nor a default wallet is configured.
+   * @throws {RangeError} If the complete multipart request exceeds {@link MOBILE_FEED_IMAGE_MAX_REQUEST_BYTES}.
+   * @throws {MobileServerFailureError} On authentication, format/size/hash errors (`INVALID_SOCIAL_FEED_IMAGE`),
+   * or when comments are disabled (`SERVICE_UNAVAILABLE`), or image storage is unavailable
+   * (`SOCIAL_FEED_DATA_UNAVAILABLE`, 6320, HTTP 503).
+   */
+  async createFeedCommentImageUpload(
+    params: MobileCreateFeedImageUploadParams,
+  ): Promise<MobileSocialFeedImage> {
+    return this.createFeedImageUpload(
+      'create_feed_comment_image_uploads',
+      params,
+    );
+  }
+
+  /**
+   * First attaches a drawing to an owned post or trade card while the author still holds its position.
+   * The original JSON is signed unchanged; false and zero are valid drawing documents.
+   * For an exact retry after a timeout, generate a nonce up front with {@link getMobileNonce} and reuse
+   * that nonce and the original JSON before its receive deadline. A fresh nonce is not an exact replay.
+   * If a retry returns `SOCIAL_FEED_DRAWING_EXISTS`, use {@link getFeedChartDrawing} to confirm that the
+   * stored data matches the intended drawing before treating the original create as successful.
+   * @param params - Author subaccount and signing options, parent item, and complete original drawing JSON.
+   * @returns The parent ID and updated version together with the stored drawing.
+   * @throws {WalletNotProvidedError} If neither a linked signer nor a default wallet is configured.
+   * @throws {MobileServerFailureError} On authentication, ownership, eligibility, or invalid/oversized drawing
+   * errors, an unavailable parent, or `SOCIAL_FEED_DRAWING_EXISTS` for a conflicting existing drawing.
+   * Read the existing drawing and use updateFeedChartDrawing when replacement is intended.
+   */
+  async createFeedChartDrawing(
+    params: MobileFeedChartDrawingParams,
+  ): Promise<MobileSocialFeedDrawingMutationResult> {
+    const request = await this.getSignedRequest(
+      'create_feed_chart_drawing',
+      params,
+      { item_id: params.itemId, data_json: params.dataJson },
+    );
+    return mapMobileSocialFeedDrawingMutationResult(
+      await this.execute(request),
+    );
+  }
+
+  /**
+   * Replaces an existing drawing, including after the associated position has closed.
+   * Serialize writes per item and preserve the original JSON text when retrying.
+   * @param params - Author subaccount and signing options, parent item, and complete replacement JSON.
+   * @returns The parent ID and updated version together with the stored replacement drawing.
+   * @throws {WalletNotProvidedError} If neither a linked signer nor a default wallet is configured.
+   * @throws {MobileServerFailureError} On authentication, ownership, or invalid/oversized drawing errors, an
+   * unavailable parent or drawing, or `STALE_SOCIAL_FEED_DRAWING_UPDATE`. Re-read the drawing before retrying
+   * a stale or conflicting update instead of blindly replacing newer content.
+   */
+  async updateFeedChartDrawing(
+    params: MobileFeedChartDrawingParams,
+  ): Promise<MobileSocialFeedDrawingMutationResult> {
+    const request = await this.getSignedRequest(
+      'update_feed_chart_drawing',
+      params,
+      { item_id: params.itemId, data_json: params.dataJson },
+    );
+    return mapMobileSocialFeedDrawingMutationResult(
+      await this.execute(request),
+    );
+  }
+
+  /**
+   * Publishes a comment or reply atomically; an invalid position attachment rejects the entire request.
+   * For an idempotent retry, reuse clientRequestId and the unmodified text, mentions, and attachment.
+   * @param params - Author subaccount and signing options, request UUID, root item, original nonblank text
+   * and mentions, plus an optional reply target in the same thread and currently owned position attachment.
+   * @returns The created reply and authoritative root comment count; this write does not create a reading session.
+   * @throws {WalletNotProvidedError} If neither a linked signer nor a default wallet is configured.
+   * @throws {MobileServerFailureError} On authentication, inaccessible content, invalid text/mentions/reply
+   * relationships, an ineligible attachment, or `SOCIAL_FEED_REQUEST_CONFLICT`. Correct invalid input before
+   * a new submission, and never reuse an existing request UUID with different content.
+   */
+  async createFeedComment(
+    params: MobileCreateFeedCommentParams,
+  ): Promise<MobileSocialFeedCommentResult> {
+    const request = await this.getSignedRequest('create_feed_comment', params, {
+      client_request_id: params.clientRequestId,
+      root_item_id: params.rootItemId,
+      reply_to_item_id: params.replyToItemId,
+      text: params.text,
+      mentions: params.mentions.map(mapMobileSocialFeedMentionToServer),
+      attached_position_id: params.attachedPositionId,
+      image_ids: params.imageIds,
+    });
+    return mapMobileSocialFeedCommentResult(await this.execute(request));
+  }
+
+  /**
+   * Sets or clears a signed user's like without requiring an open position.
+   * Serialize mutations per item and author. Retrying the same isLiked state with a fresh nonce is safe
+   * when no newer change intervenes; an unchanged state does not increment the count or version again.
+   * Pass the original nonce on a retry before its deadline to avoid overwriting a newer change from
+   * another device. Re-read the current state if that retry conflicts.
+   * @param params - Acting subaccount and signing options, interactive item, and desired like state.
+   * @returns The applied like state, authoritative count, and item version after the mutation.
+   * @throws {WalletNotProvidedError} If neither a linked signer nor a default wallet is configured.
+   * @throws {MobileServerFailureError} On authentication errors, inaccessible or non-interactive content,
+   * or `STALE_SOCIAL_FEED_LIKE_UPDATE`. Re-read the current state before submitting a new mutation after a conflict.
+   */
+  async setFeedLike(
+    params: MobileSetFeedLikeParams,
+  ): Promise<MobileSocialFeedLikeResult> {
+    const request = await this.getSignedRequest('set_feed_like', params, {
+      item_id: params.itemId,
+      is_liked: params.isLiked,
+    });
+    return mapMobileSocialFeedLikeResult(await this.execute(request));
+  }
+
   /*
   Base Fns
    */
@@ -783,9 +1475,30 @@ export class MobileClient {
     return response.data as MobileServerPublicQuerySuccessResponse<T>;
   }
 
-  protected async publicExecute(
-    body: MobileServerPublicExecuteRequest,
-  ): Promise<MobileServerSuccessResponse> {
+  protected async publicGetBytes(
+    url: string,
+    headers: Record<string, string>,
+  ): Promise<Uint8Array> {
+    const response = await this.axiosInstance.get<ArrayBuffer>(url, {
+      responseType: 'arraybuffer',
+      headers,
+    });
+    if (response.status < 200 || response.status >= 300) {
+      const responseText = bytesToString(new Uint8Array(response.data));
+      let errorData: unknown;
+      try {
+        errorData = JSON.parse(responseText);
+      } catch {
+        errorData = responseText;
+      }
+      this.checkResponseStatus({ ...response, data: errorData });
+    }
+    return new Uint8Array(response.data);
+  }
+
+  protected async publicExecute<T extends MobileServerPublicExecuteRequestType>(
+    body: { type: T } & MobileServerPublicExecuteRequestByType[T],
+  ): Promise<MobileServerPublicExecuteSuccessResponse<T>> {
     const response = await this.axiosInstance.post<MobileServerExecuteResult>(
       `${this.opts.url}/public_execute`,
       body,
@@ -795,17 +1508,46 @@ export class MobileClient {
     this.checkServerStatus(response);
 
     // checkServerStatus catches the failure result and throws the error, so the cast to the success response is acceptable here
-    return response.data as MobileServerSuccessResponse;
+    return response.data as MobileServerPublicExecuteSuccessResponse<T>;
+  }
+
+  /**
+   * Sends an authenticated read through the signed query route.
+   * @param body - Canonical inner payload with its signature, sender, and nonce.
+   * @returns The successful query envelope and its type-specific payload.
+   * @throws {MobileServerFailureError} For a structured service failure, including non-2xx responses.
+   */
+  protected async query<T extends MobileServerSignedQueryRequestType>(
+    body: MobileSignedRequest & { type: T },
+  ): Promise<MobileServerSignedQuerySuccessResponse<T>> {
+    const response = await this.axiosInstance.post<unknown>(
+      `${this.opts.url}/query`,
+      body,
+    );
+    this.checkResponseStatus(response);
+    this.checkServerStatus(response);
+    return response.data as MobileServerSignedQuerySuccessResponse<T>;
   }
 
   // `T` is inferred from the body's `type` rather than declared by the caller, for the same reason
   // `publicQuery` spells its body out as an intersection: an indexed access is not an inference site.
   protected async execute<T extends MobileServerExecuteRequestType>(
     body: MobileSignedRequest & { type: T },
+    fileBytes?: Uint8Array,
   ): Promise<MobileServerExecuteSuccessResponse<T>> {
+    const multipart =
+      fileBytes == null
+        ? undefined
+        : buildMobileFeedImageMultipart(JSON.stringify(body), fileBytes);
+    if (multipart) {
+      this.checkFeedImageRequestSize(multipart.body.byteLength);
+    }
     const response = await this.axiosInstance.post<MobileServerExecuteResult>(
       `${this.opts.url}/execute`,
-      body,
+      multipart?.body ?? body,
+      multipart
+        ? { headers: { 'Content-Type': multipart.contentType } }
+        : undefined,
     );
 
     this.checkResponseStatus(response);
@@ -815,6 +1557,46 @@ export class MobileClient {
     return response.data as MobileServerExecuteSuccessResponse<T>;
   }
 
+  private async createFeedImageUpload(
+    type:
+      | 'create_feed_post_image_uploads'
+      | 'create_feed_comment_image_uploads',
+    params: MobileCreateFeedImageUploadParams,
+  ): Promise<MobileSocialFeedImage> {
+    const nonce = params.nonce ?? getMobileNonce();
+    // Match the signed body's field lengths so oversized requests fail before prompting the wallet.
+    const sizePayload = {
+      type,
+      content_hash: zeroHash,
+      signature: `0x${'00'.repeat(65)}`,
+      sender: subaccountToHex(params),
+      nonce: nonce.toString(),
+    };
+    const overhead = buildMobileFeedImageMultipart(
+      JSON.stringify(sizePayload),
+      new Uint8Array(),
+    ).body.byteLength;
+    this.checkFeedImageRequestSize(overhead + params.fileBytes.byteLength);
+    const contentHash = keccak256(params.fileBytes);
+    const request = await this.getSignedRequest(
+      type,
+      { ...params, nonce },
+      {
+        content_hash: contentHash,
+      },
+    );
+    const data = await this.execute(request, params.fileBytes);
+    return mapMobileSocialFeedImage(data.image);
+  }
+
+  private checkFeedImageRequestSize(byteLength: number): void {
+    if (byteLength > MOBILE_FEED_IMAGE_MAX_REQUEST_BYTES) {
+      throw new RangeError(
+        `Feed image upload request exceeds ${MOBILE_FEED_IMAGE_MAX_REQUEST_BYTES} bytes (2 MiB).`,
+      );
+    }
+  }
+
   /**
    * Validates the HTTP status before interpreting the body. Unlike the engine, the mobile backend returns
    * failure envelopes with non-2xx statuses (e.g. 404 for `PROFILE_NOT_FOUND`), so a non-2xx response with a