@nadohq/mobile-client 0.65.0 → 0.67.0

package/src/types/serverExecuteTypes.ts

@@ -8,7 +8,9 @@ import {
   MobileServerSocialFeedDrawing,
   MobileServerSocialFeedItem,
   MobileServerSocialFeedReply,
+  MobileServerSocialFeedUploadedImage,
 } from './serverModelTypes';
+import { MobileServerNotificationSettingsV2Response } from './serverQueryTypes';
 import {
   MobileServerExecuteRequestType,
   MobileServerPublicExecuteRequestByType,
@@ -80,15 +82,31 @@ export interface MobileServerAvatarUploadResponse {
   expires_in_seconds: number;
 }
 
+/** Ready image returned by a direct multipart upload. */
+export interface MobileServerSocialFeedImageUploadResponse {
+  /** Ready image metadata, including original and thumbnail paths. */
+  image: MobileServerSocialFeedUploadedImage;
+}
+
 /**
  * Success payloads for each signed `execute`, keyed by request `type`. Mutations return either the success
  * envelope alone or authoritative post-commit state; avatar upload creation returns a temporary grant.
  */
 export interface MobileServerExecuteResponseByType {
+  /** Capability-aware device registration returns only status. */
+  register_expo_token_v2: MobileServerEmptyExecuteResponse;
+  /** Re-query subscriptions after success to obtain the new revision. */
+  update_notification_subscriptions: MobileServerEmptyExecuteResponse;
+  /** Atomic event recording returns only status. */
+  record_product_events: MobileServerEmptyExecuteResponse;
   /** Published or idempotently recovered item. */
   create_feed_post: MobileServerSocialFeedPostResponse;
   /** Atomically published reply and updated count. */
   create_feed_comment: MobileServerSocialFeedCommentResponse;
+  /** Direct post-image upload; the image is ready immediately. */
+  create_feed_post_image_uploads: MobileServerSocialFeedImageUploadResponse;
+  /** Direct comment-image upload; the image is ready immediately. */
+  create_feed_comment_image_uploads: MobileServerSocialFeedImageUploadResponse;
   /** First attached drawing. */
   create_feed_chart_drawing: MobileServerSocialFeedDrawingMutationResponse;
   /** Replaced or idempotently recovered drawing. */
@@ -159,14 +177,6 @@ export interface MobileServerSocialFeedLikeResponse {
   version: string;
 }
 
-/** Exposure counts deduplicated by browsing credential, item, and UTC day. */
-export interface MobileServerSocialFeedViewsResponse {
-  /** Newly counted items. */
-  accepted_item_ids: string[];
-  /** Already counted items. */
-  duplicate_item_ids: string[];
-}
-
 /** Page lease result; this response does not carry as_of_ms. */
 export interface MobileServerSocialFeedPresenceResponse {
   /** Active visitor count. */
@@ -181,12 +191,14 @@ export interface MobileServerSocialFeedPresenceResponse {
 
 /** Response payloads for unsigned writes. */
 export interface MobileServerPublicExecuteResponseByType {
+  /** Saved document, including the advanced settings revision. */
+  update_notification_settings_v2: MobileServerNotificationSettingsV2Response;
   /** Token removal returns only the success envelope. */
   unregister_expo_token: MobileServerEmptyExecuteResponse;
   /** Preference updates return only the success envelope. */
   update_preferences: MobileServerEmptyExecuteResponse;
-  /** Exposure deduplication result. */
-  record_feed_views: MobileServerSocialFeedViewsResponse;
+  /** Batch views return only status; no per-target result or count. */
+  record_feed_views: MobileServerEmptyExecuteResponse;
   /** Page lease result. */
   position_presence: MobileServerSocialFeedPresenceResponse;
 }

package/src/types/serverModelTypes.ts

@@ -33,6 +33,51 @@ export interface MobileServerAvatarPreset {
  */
 export type MobileNotificationPlatform = 'ios' | 'android';
 
+/**
+ * Notification types supported by the v2 payload protocol.
+ */
+export type MobileNotificationTypeId =
+  | 'new_follower'
+  | 'followed_you_back'
+  | 'order_fill'
+  | 'order_update'
+  | 'liquidation'
+  | 'trader_opened'
+  | 'trader_closed'
+  | 'position_milestone'
+  | 'market_movement'
+  | 'trader_streak'
+  | 'account_drama'
+  | 'weekly_digest';
+
+/**
+ * Named navigation destinations supported by notification payloads.
+ */
+export type MobileNotificationRouteName = MobileServerNotificationRoute['name'];
+
+/** Position milestone options supported by notification settings. */
+export const MOBILE_NOTIFICATION_POSITION_THRESHOLDS = [10, 25, 50] as const;
+
+/** Minimum trade-size options, in whole USD, supported by notification settings. */
+export const MOBILE_NOTIFICATION_MIN_TRADE_SIZES_USD = [
+  0, 100, 1000, 10000,
+] as const;
+
+/** Supported notification position milestone threshold. */
+export type MobileNotificationPositionThreshold =
+  (typeof MOBILE_NOTIFICATION_POSITION_THRESHOLDS)[number];
+
+/** Supported notification minimum trade size, in whole USD. */
+export type MobileNotificationMinTradeSizeUsd =
+  (typeof MOBILE_NOTIFICATION_MIN_TRADE_SIZES_USD)[number];
+
+/** Supported product analytics interaction. */
+export type MobileProductEventName =
+  | 'notif_opened'
+  | 'market_viewed'
+  | 'chart_opened'
+  | 'search';
+
 /**
  * Category of push notification.
  */
@@ -223,6 +268,127 @@ export interface MobileServerNotificationPreferences {
   categories: MobileServerNotificationCategoryPreference[];
 }
 
+/**
+ * Stored push-device metadata shared by registration requests and token ownership responses.
+ */
+export interface MobileServerNotificationDeviceMetadata {
+  /** Device operating system. */
+  platform: MobileNotificationPlatform;
+  /** Locale tag, or null when absent; at most 35 UTF-8 bytes. */
+  locale: string | null;
+  /** App version, or null when absent; at most 64 UTF-8 bytes. */
+  app_version: string | null;
+}
+
+/**
+ * Device capabilities shared by v2 registration and v1/v2 registration queries.
+ */
+export interface MobileServerNotificationCapabilities {
+  /** Exactly one supported payload version. */
+  payload_versions: [1] | [2];
+  /** Supported subset of the registered notification types. */
+  type_ids: MobileNotificationTypeId[];
+  /** Supported subset of the named destinations. */
+  routes: MobileNotificationRouteName[];
+}
+
+/**
+ * Server-side wallet settings; all fields are required on replacement.
+ */
+export interface MobileServerNotificationSettings {
+  /** Own position milestones and the initial weekly digest. */
+  my_positions: boolean;
+  /** One to three unique values; the minimum selects the starting milestone tier. */
+  position_thresholds: MobileNotificationPositionThreshold[];
+  /** Combined order fill/update switch; does not control liquidation notifications. */
+  my_orders: boolean;
+  /** Ordinary followed-trader notifications; enabled bells override this switch. */
+  following_trades: boolean;
+  /** Notifications about posts by followed traders. */
+  following_posts: boolean;
+  /** Minimum trade size for trade notifications, in whole USD. */
+  min_trade_size_usd: MobileNotificationMinTradeSizeUsd;
+  /** New followers and follow-backs. */
+  new_followers: boolean;
+  /** Maps to the legacy announcement preference. */
+  announcements: boolean;
+  /** Opt-in trader streak and account drama discovery notifications. */
+  discovery: boolean;
+}
+
+/**
+ * Server-side allowlisted destination; notification data must never be interpreted as an arbitrary URL.
+ */
+export type MobileServerNotificationRoute =
+  | {
+      /** Public profile destination. */
+      name: 'profile';
+      /** Profile subaccount as bytes32. */
+      subaccount: Hex;
+    }
+  | {
+      /** Market destination. */
+      name: 'market';
+      /** Positive product ID. */
+      product_id: number;
+    }
+  | {
+      /** Own portfolio destination. */
+      name: 'portfolio';
+    };
+
+/**
+ * Server-side v2 push/inbox navigation data, not a complete historical trade or notification body.
+ */
+export interface MobileServerNotificationPayloadV2 {
+  /** Payload protocol version. */
+  payload_version: 2;
+  /** Logical notification UUID, used for click deduplication. */
+  notification_id: string;
+  /** Intended wallet; private navigation must wait for this wallet to connect. */
+  recipient_wallet: Hex;
+  /** Registered notification type. */
+  type_id: MobileNotificationTypeId;
+  /** Supported template version. */
+  template_version: 1;
+  /** Named destination and its parameters. */
+  route: MobileServerNotificationRoute;
+}
+
+/**
+ * Server-side accepted logical notification; does not prove device delivery or read status.
+ */
+export interface MobileServerNotificationInboxItem {
+  /** Logical notification UUID. */
+  notification_id: string;
+  /** Registered notification type. */
+  type_id: MobileNotificationTypeId;
+  /** Navigation data, without title, body, or read state. */
+  data: MobileServerNotificationPayloadV2;
+  /** Intent acceptance time in milliseconds. */
+  created_at: number;
+  /** Backend-computed trade attribution. */
+  trade_within_24h: boolean;
+}
+
+/**
+ * Server-side product analytics event; unused nullable fields must be explicitly null.
+ */
+export interface MobileServerProductEvent {
+  /** Stable event UUID; reuse across retries. */
+  client_event_id: string;
+  /** Supported interaction; notif_opened is not a read-state mutation. */
+  event_name: MobileProductEventName;
+  /** Required for notif_opened and owned by the signing wallet; otherwise null. */
+  notification_id: string | null;
+  /** Actual event time in milliseconds, within the past 7 days or next 5 minutes. */
+  occurred_at: number;
+  /** Required for market_viewed/chart_opened; otherwise null. */
+  product_id: number | null;
+  /** Required for search, nonblank and at most 80 Unicode characters; otherwise null. */
+  query: string | null;
+}
+
 /** Content filters accepted by the six social feed lists. Empty or omitted means all. */
 export type MobileSocialFeedType =
   | 'open'
@@ -426,16 +592,47 @@ export interface MobileServerSocialFeedCommentPreview {
   items: MobileServerSocialFeedReply[];
   /** Comment count. */
   total_count: number;
-  /** Comment cursor, if available. */
+  /** Opens the first complete group page in the same snapshot; do not prepend preview items. */
   next_cursor: string | null;
 }
 
-/** Exposure requirements associated with a reading session. */
-export interface MobileServerSocialFeedViewTracking {
-  /** Required visible fraction. */
-  min_visible_ratio: number;
-  /** Required visible duration in milliseconds. */
-  min_duration_ms: number;
+/** Uploaded feed image metadata; bytes are fetched separately with the reading session. */
+export interface MobileServerSocialFeedUploadedImage {
+  /** Image UUID. */
+  image_id: string;
+  /** Backend path for the original image bytes. */
+  url: string;
+  /** Display-orientation width in pixels. */
+  width: number;
+  /** Display-orientation height in pixels. */
+  height: number;
+  /** Detected content type. */
+  content_type: 'image/jpeg' | 'image/png';
+  /** Original file size in bytes. */
+  byte_size: number;
+  /** Always-present thumbnail (longest edge ≤ 512, never upscaled). */
+  thumbnail: MobileServerSocialFeedImageThumbnail;
+}
+
+/** External image loaded directly from its URL without Mobile session headers. */
+export interface MobileServerSocialFeedExternalImage {
+  /** Original HTTP/HTTPS URL; no upload metadata or thumbnail is provided. */
+  url: string;
+}
+
+/** Uploaded image metadata or an external URL; uploaded images precede external images. */
+export type MobileServerSocialFeedImage =
+  | MobileServerSocialFeedUploadedImage
+  | MobileServerSocialFeedExternalImage;
+
+/** Thumbnail metadata for an uploaded feed image. */
+export interface MobileServerSocialFeedImageThumbnail {
+  /** Backend path for the thumbnail bytes. */
+  url: string;
+  /** Thumbnail width in pixels. */
+  width: number;
+  /** Thumbnail height in pixels. */
+  height: number;
 }
 
 /** Coverage of the candidate authors in a qualification snapshot. */
@@ -484,6 +681,8 @@ export interface MobileServerSocialFeedItemBase {
 
 /** Content shared by authored posts and trade cards. */
 export interface MobileServerSocialFeedContentBase extends MobileServerSocialFeedItemBase {
+  /** Bound images in display order; empty when none. */
+  images: MobileServerSocialFeedImage[];
   /** Card text, empty for automatic cards. */
   text: string;
   /** Mentions in the original, unmodified text. */
@@ -559,16 +758,14 @@ export type MobileServerSocialFeedItem =
   | MobileServerSocialFeedPost
   | MobileServerSocialFeedReply;
 
-/** Fixed-duration social feed reading session. Credentials and cursors must be returned unchanged. */
+/** Idle-renewed social feed reading session. Credentials and cursors must be returned unchanged. */
 export interface MobileServerSocialFeedReadSession {
   /** Session identifier. */
   session_id: string;
   /** Feed, item, or full position history session. */
   mode: MobileSocialFeedReadSessionMode;
-  /** Fixed expiration time in Unix milliseconds; pagination does not extend it. */
+  /** Current idle expiration in Unix milliseconds; legitimate session requests renew it. */
   expires_at_ms: number;
-  /** Visibility requirements for explicit exposure reporting. */
-  view_tracking: MobileServerSocialFeedViewTracking;
   /** Initial update baseline, distinct from the page cursor. */
   update_cursor: string | null;
   /** Credential for this reading session. Do not log or cache publicly. */
@@ -737,6 +934,8 @@ export interface MobileServerSocialFeedPost extends MobileServerSocialFeedConten
 export interface MobileServerSocialFeedReply extends MobileServerSocialFeedItemBase {
   /** Reply discriminant. */
   kind: 'reply';
+  /** Bound images in display order; empty when none. */
+  images: MobileServerSocialFeedImage[];
   /** Original text. */
   text: string;
   /** Mentions in the text. */
@@ -757,6 +956,12 @@ export interface MobileServerSocialFeedReply extends MobileServerSocialFeedItemB
   interaction: MobileServerSocialFeedInteraction;
 }
 
+/** Top-level comment and all readable descendants from the same thread snapshot. */
+export interface MobileServerSocialFeedCommentGroup extends MobileServerSocialFeedReply {
+  /** Flat descendants in creation-time, depth, then UUID order; empty when none. */
+  replies: MobileServerSocialFeedReply[];
+}
+
 /** Current eligibility hints; actual writes still recheck the signed author. */
 export interface MobileServerSocialFeedPublishablePosition {
   /** Candidate position. */

package/src/types/serverQueryTypes.ts

@@ -1,20 +1,25 @@
 import { Hex } from 'viem';
 import { MobileServerSuccessResponse } from './serverBaseTypes';
 import {
-  MobileNotificationPlatform,
   MobileServerAvatarPreset,
   MobileServerFeedTrade,
   MobileServerFollowListAccount,
+  MobileServerNotificationCapabilities,
+  MobileServerNotificationDeviceMetadata,
+  MobileServerNotificationInboxItem,
   MobileServerNotificationPreferences,
+  MobileServerNotificationSettings,
   MobileServerProfile,
   MobileServerSocialFeedActionCandidate,
   MobileServerSocialFeedActionMarker,
   MobileServerSocialFeedAuthor,
   MobileServerSocialFeedCandle,
   MobileServerSocialFeedCohort,
+  MobileServerSocialFeedCommentGroup,
   MobileServerSocialFeedDrawing,
   MobileServerSocialFeedEstimatedLiquidationLine,
   MobileServerSocialFeedHistorySummary,
+  MobileServerSocialFeedHistoryTake,
   MobileServerSocialFeedItem,
   MobileServerSocialFeedItemPatch,
   MobileServerSocialFeedMarket,
@@ -22,7 +27,6 @@ import {
   MobileServerSocialFeedPositionPatch,
   MobileServerSocialFeedPublishablePosition,
   MobileServerSocialFeedReadSession,
-  MobileServerSocialFeedReply,
   MobileServerSocialFeedTimelineEntry,
   MobileServerSocialFeedTradingContext,
   MobileSocialFeedActionResolution,
@@ -35,8 +39,27 @@ import {
 import {
   MobileServerPublicQueryRequestByType,
   MobileServerPublicQueryRequestType,
+  MobileServerSignedQueryRequestType,
 } from './serverRequestTypes';
 
+/**
+ * Success payloads for each signed `query`, keyed by request `type`.
+ */
+export interface MobileServerSignedQueryResponseByType {
+  /** Wallet subscriptions and the signing Identity's bells. */
+  notification_subscriptions: MobileServerNotificationSubscriptionsResponse;
+  /** Private notification page. */
+  notification_inbox_v2: MobileServerNotificationInboxV2Response;
+}
+
+/**
+ * Full success response for a signed `query`, with its payload inlined alongside `status`.
+ */
+export type MobileServerSignedQuerySuccessResponse<
+  T extends MobileServerSignedQueryRequestType =
+    MobileServerSignedQueryRequestType,
+> = MobileServerSuccessResponse & MobileServerSignedQueryResponseByType[T];
+
 /**
  * Unsigned `public_query` request body: a `type` discriminant flattened with its params.
  */
@@ -165,15 +188,58 @@ export interface MobileServerNotificationPreferencesResponse {
   preferences: MobileServerNotificationPreferences;
 }
 
+/**
+ * Payload of the `notification_registration_v2` public query, including legacy registrations.
+ */
+export interface MobileServerNotificationRegistrationV2Response {
+  /** Opaque decimal string; do not convert to a JavaScript number. */
+  registration_generation: string;
+  /** Persisted capabilities of the most recent registration; legacy type/route arrays are empty. */
+  capabilities: MobileServerNotificationCapabilities;
+}
+
+/**
+ * Full settings document returned by both `notification_settings_v2` and `update_notification_settings_v2`.
+ */
+export interface MobileServerNotificationSettingsV2Response {
+  /** Settings schema version. */
+  schema_version: 2;
+  /** Settings revision, independent of the subscription revision. */
+  revision: number;
+  /** Full saved settings. */
+  settings: MobileServerNotificationSettings;
+}
+
+/**
+ * Payload of the `notification_subscriptions` signed query.
+ */
+export interface MobileServerNotificationSubscriptionsResponse {
+  /** Wallet-level subscription revision; read again after every mutation. */
+  revision: number;
+  /** Whether the one-time local favorites import has completed. */
+  favorites_imported: boolean;
+  /** Subscribed market IDs in ascending order. */
+  market_ids: number[];
+  /** Followed subaccounts with bells enabled for the signing Identity. */
+  trader_bells: Hex[];
+}
+
+/**
+ * Payload of the `notification_inbox_v2` signed query, ordered newest first.
+ */
+export interface MobileServerNotificationInboxV2Response {
+  /** Accepted intents owned by the signing wallet. */
+  notifications: MobileServerNotificationInboxItem[];
+  /** Pass unchanged to the next request, or null when pagination is complete. */
+  next_cursor: string | null;
+}
+
 /**
  * Payload of the `registered_wallet` public query success response. Inlined into the envelope rather than
  * nested under a key, matching the backend's `RegisteredWalletResponse`.
  */
-export interface MobileServerRegisteredWalletResponse {
+export interface MobileServerRegisteredWalletResponse extends MobileServerNotificationDeviceMetadata {
   wallet: Hex;
-  platform: MobileNotificationPlatform;
-  locale: string | null;
-  app_version: string | null;
   token_fingerprint_prefix: string;
   last_seen_at: number;
 }
@@ -185,6 +251,10 @@ export interface MobileServerRegisteredWalletResponse {
  * by {@link MobileServerPublicQuerySuccessResponse}.
  */
 export interface MobileServerPublicQueryResponseByType {
+  /** Latest saved device generation and v1/v2 capabilities. */
+  notification_registration_v2: MobileServerNotificationRegistrationV2Response;
+  /** Full settings document with its revision. */
+  notification_settings_v2: MobileServerNotificationSettingsV2Response;
   /** Open position candidates. */
   self_feed_positions: MobileServerSocialFeedPositionsResponse;
   /** Position command resolution. */
@@ -197,6 +267,10 @@ export interface MobileServerPublicQueryResponseByType {
   feed_comments: MobileServerSocialFeedCommentsResponse;
   /** Full lifecycle history. */
   position_history: MobileServerSocialFeedPositionHistoryResponse;
+  /** Most recent 500 actions, without pagination or authored content. */
+  position_history_all: MobileServerSocialFeedPositionHistoryResponse;
+  /** Published nonblank text with complete drawings. */
+  position_thoughts: MobileServerSocialFeedPositionThoughtsResponse;
   /** Candle page and markers. */
   position_chart: MobileServerSocialFeedPositionChartResponse;
   /** Read-only watcher observation. */
@@ -285,10 +359,12 @@ export interface MobileServerSocialFeedDrawingResponse {
 
 /** Comment thread, including bidirectional pagination around an optional anchor. */
 export interface MobileServerSocialFeedCommentsResponse {
-  /** Readable comments. */
-  comments: MobileServerSocialFeedReply[];
-  /** Total readable count. */
+  /** Top-level comments, newest first, each with all readable descendants in the snapshot. */
+  comments: MobileServerSocialFeedCommentGroup[];
+  /** All readable replies across the thread snapshot, including descendants. */
   total_count: number;
+  /** All readable top-level comments across the thread snapshot. */
+  top_level_count: number;
   /** Forward cursor. */
   next_cursor: string | null;
   /** Backward cursor. */
@@ -301,6 +377,8 @@ export interface MobileServerSocialFeedCommentsResponse {
 
 /** Full position history with additional metrics and trusted trading hints. */
 export interface MobileServerSocialFeedPositionHistoryResponse {
+  /** Current position owner. */
+  owner: MobileServerSocialFeedAuthor;
   /** Current or frozen position and history metrics. */
   position: MobileServerSocialFeedPositionHistoryCard;
   /** Counts across the authorized history. */
@@ -342,3 +420,22 @@ export interface MobileServerSocialFeedWatchersResponse {
   /** Observation time. */
   as_of_ms: number;
 }
+
+/** Published position thought with nonblank text and a complete saved drawing. */
+export type MobileServerSocialFeedPositionThought =
+  MobileServerSocialFeedHistoryTake & {
+    /** Always true for this endpoint; uploaded or external images alone do not qualify. */
+    has_analysis: true;
+    /** Parsed current drawing; saved data does not necessarily contain visible strokes. */
+    drawing: MobileServerSocialFeedDrawing;
+  };
+
+/** Thoughts in descending drawing creation time and item UUID order; no 500-item total cap. */
+export interface MobileServerSocialFeedPositionThoughtsResponse {
+  /** Complete content in server order; never reorder by display time. */
+  items: MobileServerSocialFeedPositionThought[];
+  /** Null only at the directory end; an empty page can still have a cursor. */
+  next_cursor: string | null;
+  /** Independent position session; newly published content requires a refresh. */
+  read_session: MobileServerSocialFeedReadSession;
+}