@nadohq/mobile-client 0.64.0 → 0.65.0

package/src/types/index.ts

@@ -1,6 +1,7 @@
 export * from './clientTypes';
 export * from './mobileErrorCodes';
 export * from './MobileServerFailureError';
+export * from './MobileUnsupportedFeedItemError';
 export * from './serverBaseTypes';
 export * from './serverExecuteTypes';
 export * from './serverModelTypes';

package/src/types/mobileErrorCodes.ts

@@ -48,6 +48,16 @@ export const MOBILE_ERROR_CODES = {
   INVALID_FEED_FILTER: 6300,
   /** Feed cursor is malformed or bound to a different filter. Discard it and restart from the first page. */
   INVALID_FEED_CURSOR: 6301,
+  /** Drawing JSON, outer value, storage representation, or nonce is invalid. */
+  INVALID_SOCIAL_FEED_DRAWING: 6302,
+  /** Original drawing JSON exceeds 256 KiB UTF-8. */
+  SOCIAL_FEED_DRAWING_TOO_LARGE: 6303,
+  /** Drawing parent is unavailable, or an update targets a missing drawing. */
+  SOCIAL_FEED_DRAWING_UNAVAILABLE: 6304,
+  /** A different drawing already exists when first attaching one. */
+  SOCIAL_FEED_DRAWING_EXISTS: 6305,
+  /** Drawing nonce is stale or reused for different content. Re-read before retrying. */
+  STALE_SOCIAL_FEED_DRAWING_UPDATE: 6306,
   /** Invalid social feed parameters, including missing fields, invalid types/formats, filters, or Content-Type. */
   INVALID_SOCIAL_FEED_PARAMS: 6310,
   /** Session, credential, viewing account, cursor, source, or viewport mismatch; also a request sequence or viewport revision rollback. */
@@ -56,8 +66,26 @@ export const MOBILE_ERROR_CODES = {
   SOCIAL_FEED_SESSION_EXPIRED: 6312,
   /** Content does not exist or is not currently accessible. */
   SOCIAL_FEED_CONTENT_UNAVAILABLE: 6313,
+  /** Position no longer qualifies for publication or a new attachment. */
+  SOCIAL_FEED_POSITION_CLOSED: 6314,
+  /** Selected position does not belong to the signed author. */
+  SOCIAL_FEED_POSITION_NOT_OWNED: 6315,
+  /** Item or action does not support the requested operation. */
+  INVALID_SOCIAL_FEED_OPERATION: 6316,
+  /** Published body cannot be edited; existing drawings may still be updated. */
+  SOCIAL_FEED_CONTENT_ALREADY_PUBLISHED: 6317,
+  /** Mention offsets, mentioned identity, or reply relationship is invalid. */
+  INVALID_SOCIAL_FEED_MENTION: 6318,
+  /** Author-scoped request ID was already used with different content. */
+  SOCIAL_FEED_REQUEST_CONFLICT: 6319,
   /** Required authoritative position, action, cohort, or market data is unavailable. */
   SOCIAL_FEED_DATA_UNAVAILABLE: 6320,
+  /** Text or mention count exceeds the operation's limit. */
+  SOCIAL_FEED_CONTENT_TOO_LARGE: 6321,
+  /** Like nonce is stale or reused with a different state. */
+  STALE_SOCIAL_FEED_LIKE_UPDATE: 6322,
+  /** A post has neither nonblank text nor a drawing, or a comment is blank. */
+  EMPTY_SOCIAL_FEED_CONTENT: 6323,
   /** Feed reads are only available through public_query. */
   SOCIAL_FEED_QUERY_REMOVED: 6325,
 } as const;

package/src/types/serverExecuteTypes.ts

@@ -3,6 +3,12 @@ import {
   MobileServerFailureResponse,
   MobileServerSuccessResponse,
 } from './serverBaseTypes';
+import {
+  MobileServerSocialFeedAuthor,
+  MobileServerSocialFeedDrawing,
+  MobileServerSocialFeedItem,
+  MobileServerSocialFeedReply,
+} from './serverModelTypes';
 import {
   MobileServerExecuteRequestType,
   MobileServerPublicExecuteRequestByType,
@@ -75,11 +81,20 @@ export interface MobileServerAvatarUploadResponse {
 }
 
 /**
- * Success payloads for each signed `execute`, keyed by request `type`. Most execute routes carry no payload
- * beyond the success discriminant and so map to an empty object; `set_follow` and `set_follow_batch` return
- * their post-commit relationship state, and `create_avatar_upload` returns a temporary upload grant.
+ * 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 {
+  /** Published or idempotently recovered item. */
+  create_feed_post: MobileServerSocialFeedPostResponse;
+  /** Atomically published reply and updated count. */
+  create_feed_comment: MobileServerSocialFeedCommentResponse;
+  /** First attached drawing. */
+  create_feed_chart_drawing: MobileServerSocialFeedDrawingMutationResponse;
+  /** Replaced or idempotently recovered drawing. */
+  update_feed_chart_drawing: MobileServerSocialFeedDrawingMutationResponse;
+  /** Post-mutation like state. */
+  set_feed_like: MobileServerSocialFeedLikeResponse;
   /** Bio writes return only the success envelope. */
   set_bio: MobileServerEmptyExecuteResponse;
   /** Avatar writes return only the success envelope. */
@@ -107,3 +122,77 @@ export type MobileServerExecuteSuccessResponse<
 export type MobileServerExecuteResult =
   | MobileServerSuccessResponse
   | MobileServerFailureResponse;
+
+/** Atomic publication success; unlike feed_item, this does not issue a read session. */
+export interface MobileServerSocialFeedPostResponse {
+  /** Published item. */
+  item: MobileServerSocialFeedItem;
+}
+
+/** Atomic reply publication and authoritative root count. */
+export interface MobileServerSocialFeedCommentResponse {
+  /** Published reply. */
+  comment: MobileServerSocialFeedReply;
+  /** Post-commit root count. */
+  root_comment_count: number;
+}
+
+/** Successful drawing mutation always returns a saved drawing. */
+export interface MobileServerSocialFeedDrawingMutationResponse {
+  /** Parent UUID. */
+  item_id: string;
+  /** Display version. */
+  item_version: string;
+  /** Saved parsed drawing. */
+  drawing: MobileServerSocialFeedDrawing;
+}
+
+/** Authoritative like state after the mutation. */
+export interface MobileServerSocialFeedLikeResponse {
+  /** Item UUID. */
+  item_id: string;
+  /** Applied relationship state. */
+  is_liked: boolean;
+  /** Post-mutation count. */
+  like_count: number;
+  /** Display version. */
+  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. */
+  watcher_count: number;
+  /** Self-reported public account previews. */
+  watcher_preview: MobileServerSocialFeedAuthor[];
+  /** Recommended heartbeat interval. */
+  heartbeat_interval_seconds: number;
+  /** Lease lifetime, bounded by the reading session. */
+  expires_in_seconds: number;
+}
+
+/** Response payloads for unsigned writes. */
+export interface MobileServerPublicExecuteResponseByType {
+  /** 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;
+  /** Page lease result. */
+  position_presence: MobileServerSocialFeedPresenceResponse;
+}
+
+/** Full success response for an unsigned write. */
+export type MobileServerPublicExecuteSuccessResponse<
+  T extends MobileServerPublicExecuteRequestType =
+    MobileServerPublicExecuteRequestType,
+> = MobileServerSuccessResponse & MobileServerPublicExecuteResponseByType[T];

package/src/types/serverModelTypes.ts

@@ -285,7 +285,7 @@ export type MobileSocialFeedTradeCardAction =
   | MobileSocialFeedTradeSizeChangeAction;
 
 /** Whether a reading session was created for a list or a direct item. */
-export type MobileSocialFeedReadSessionMode = 'feed' | 'item';
+export type MobileSocialFeedReadSessionMode = 'feed' | 'item' | 'position';
 
 /** Kind of feed update target. */
 export type MobileSocialFeedTargetType = 'item' | 'position';
@@ -356,6 +356,8 @@ export interface MobileServerSocialFeedPnl {
 
 /** Complete mutable position fields delivered together at one version. */
 export interface MobileServerSocialFeedPositionPatch {
+  /** Additional metrics for a position history session, when supplied. */
+  current_position?: MobileServerSocialFeedHistoryMetrics;
   /** Position lifecycle UUID. */
   position_id: string;
   /** Positive integer string; compare as integers without Number conversion. */
@@ -396,7 +398,7 @@ export interface MobileServerSocialFeedPositionCard extends MobileServerSocialFe
   direction: MobileFeedTradePositionDirection;
 }
 
-/** Interaction counters; interaction writes are not currently available. */
+/** Interaction counters and the viewing account's relationship state. */
 export interface MobileServerSocialFeedInteraction {
   /** Number of likes. */
   like_count: number;
@@ -404,7 +406,7 @@ export interface MobileServerSocialFeedInteraction {
   comment_count: number;
   /** Number of recorded views. */
   view_count: number;
-  /** Null while likes are unavailable, including with a viewing account. */
+  /** Null when no viewing account is selected. */
   liked_by_me: boolean | null;
 }
 
@@ -420,8 +422,8 @@ export interface MobileServerSocialFeedCapabilities {
 
 /** Comment preview metadata for a social trade card. */
 export interface MobileServerSocialFeedCommentPreview {
-  /** Currently empty. */
-  items: never[];
+  /** Most recent readable replies. */
+  items: MobileServerSocialFeedReply[];
   /** Comment count. */
   total_count: number;
   /** Comment cursor, if available. */
@@ -458,14 +460,14 @@ export interface MobileServerSocialFeedCohort {
   coverage: MobileServerSocialFeedCohortCoverage;
 }
 
-/** Metadata shared by the automatic trade cards and rows available from the social feed. */
+/** Metadata shared by social feed content. */
 export interface MobileServerSocialFeedItemBase {
   /** Item UUID. */
   id: string;
   /** Whether authored analysis exists. */
   has_analysis: boolean;
-  /** Drawings are not currently available. */
-  drawing: null;
+  /** Parsed drawing document, or null when no drawing is readable. */
+  drawing: MobileServerSocialFeedDrawing | null;
   /** Author identity, badge, and follow perspective. */
   author: MobileServerSocialFeedAuthor;
   /** Creation time in Unix milliseconds. */
@@ -476,28 +478,32 @@ export interface MobileServerSocialFeedItemBase {
   version: string;
   /** Market metadata. */
   market: MobileServerSocialFeedMarket;
-  /** Server capability flags; currently all false. */
+  /** Server capability flags, subject to the corresponding write switches. */
   capabilities: MobileServerSocialFeedCapabilities;
 }
 
-/** Automatic trade card returned by the social feed. */
-export interface MobileServerSocialFeedTradeCard extends MobileServerSocialFeedItemBase {
-  /** Card discriminant. */
-  kind: 'trade_card';
-  /** Trading action. */
-  action: MobileSocialFeedTradeCardAction;
+/** Content shared by authored posts and trade cards. */
+export interface MobileServerSocialFeedContentBase extends MobileServerSocialFeedItemBase {
   /** Card text, empty for automatic cards. */
   text: string;
-  /** Automatic cards have no mentions. */
-  mentions: never[];
+  /** Mentions in the original, unmodified text. */
+  mentions: MobileSocialFeedMention[];
   /** Current or frozen position display. */
   position: MobileServerSocialFeedPositionCard;
   /** Interaction counters. */
   interaction: MobileServerSocialFeedInteraction;
-  /** Comment content is not currently available. */
+  /** Readable comment preview. */
   comment_preview: MobileServerSocialFeedCommentPreview;
 }
 
+/** Trade card with optional authored text and analysis. */
+export interface MobileServerSocialFeedTradeCard extends MobileServerSocialFeedContentBase {
+  /** Card discriminant. */
+  kind: 'trade_card';
+  /** Trading action. */
+  action: MobileSocialFeedTradeCardAction;
+}
+
 /** Fields shared by size-change and liquidation trade rows. */
 export interface MobileServerSocialFeedTradeRowBase extends MobileServerSocialFeedItemBase {
   /** Row discriminant. */
@@ -546,20 +552,22 @@ export type MobileServerSocialFeedTradeRow =
         }
     );
 
-/** Automatic feed content; excludes posts, replies, drawings, and interaction writes. */
+/** Discriminated social feed content. */
 export type MobileServerSocialFeedItem =
   | MobileServerSocialFeedTradeCard
-  | MobileServerSocialFeedTradeRow;
+  | MobileServerSocialFeedTradeRow
+  | MobileServerSocialFeedPost
+  | MobileServerSocialFeedReply;
 
 /** Fixed-duration social feed reading session. Credentials and cursors must be returned unchanged. */
 export interface MobileServerSocialFeedReadSession {
   /** Session identifier. */
   session_id: string;
-  /** Feed or direct item session. */
+  /** Feed, item, or full position history session. */
   mode: MobileSocialFeedReadSessionMode;
   /** Fixed expiration time in Unix milliseconds; pagination does not extend it. */
   expires_at_ms: number;
-  /** Exposure metadata only; recording is not available from the social feed. */
+  /** Visibility requirements for explicit exposure reporting. */
   view_tracking: MobileServerSocialFeedViewTracking;
   /** Initial update baseline, distinct from the page cursor. */
   update_cursor: string | null;
@@ -569,6 +577,10 @@ export interface MobileServerSocialFeedReadSession {
 
 /** Item delta: omitted means unchanged; explicit null clears a prior value. */
 export interface MobileServerSocialFeedItemPatch {
+  /** Updated reply attachment; null clears it, omission leaves it unchanged. */
+  attached_position?: MobileServerSocialFeedPositionCard | null;
+  /** Updated reply attachment visibility. */
+  attachment_status?: MobileSocialFeedAttachmentStatus;
   /** Current author identity, follow state, and qualification badge. */
   author: MobileServerSocialFeedAuthor;
   /** Target item UUID. */
@@ -610,3 +622,345 @@ export interface MobileSocialFeedUnavailableTarget {
   /** Uniform reason prevents leaking inaccessible content. */
   reason: 'unavailable';
 }
+
+/** Readable state of a reply's position attachment. */
+export type MobileSocialFeedAttachmentStatus =
+  | 'none'
+  | 'visible'
+  | 'unavailable';
+
+/** Supported chart candle intervals. */
+export type MobileSocialFeedChartInterval =
+  | '1m'
+  | '5m'
+  | '15m'
+  | '1h'
+  | '4h'
+  | '1d';
+
+/** Position lifecycle action. */
+export type MobileSocialFeedAction =
+  | MobileSocialFeedTradeCardAction
+  | 'liquidated';
+
+/** Result of resolving a position command. */
+export type MobileSocialFeedPositionResolution =
+  | 'resolved'
+  | 'choose_position'
+  | 'no_open_position'
+  | 'unknown_market';
+
+/** Resolution of a viewing account's trading targets. */
+export type MobileSocialFeedTradingResolution =
+  | 'no_viewing_account'
+  | 'none'
+  | 'unique'
+  | 'choose_position'
+  | 'unavailable';
+
+/** Price source for a historical action marker. */
+export type MobileSocialFeedActionPriceBasis =
+  | 'execution'
+  | 'liquidation_oracle';
+
+/** Chart source completeness; wholly unavailable sources fail the request. */
+export type MobileSocialFeedChartDataQuality = 'ready' | 'partial';
+
+/** Projection state of an order's authoritative action segments. */
+export type MobileSocialFeedActionResolution = 'ready' | 'pending';
+
+/** Explanation for an empty position command result. */
+export type MobileSocialFeedPositionResolutionReason =
+  | 'no_open_position'
+  | 'unknown_market';
+
+/** Reason an action cannot be published. */
+export type MobileSocialFeedActionUnavailableReason =
+  | 'position_closed'
+  | 'already_published'
+  | 'unavailable';
+
+/** Availability of an estimated liquidation price. */
+export type MobileSocialFeedLiquidationPriceQuality =
+  | MobileSocialFeedPnlQuality
+  | 'not_applicable';
+
+/** Presence lifecycle reported by an individual page. */
+export type MobileSocialFeedPresenceState = 'watching' | 'heartbeat' | 'left';
+
+/** Mention offsets refer to Unicode code points in the original text, not UTF-16 indices. */
+export interface MobileSocialFeedMention {
+  /** Mentioned identity. */
+  subaccount: Hex;
+  /** Inclusive code point offset. */
+  start: number;
+  /** Exclusive code point offset. */
+  end: number;
+  /** Label matching the original text. */
+  label: string;
+}
+
+/** Parsed drawing; data is opaque to the SDK and may legitimately be false or zero. */
+export interface MobileServerSocialFeedDrawing {
+  /** Already parsed drawing document; do not JSON.parse again. */
+  data: unknown;
+  /** Original creation time in milliseconds. */
+  created_at_ms: number;
+  /** Last update time in milliseconds. */
+  updated_at_ms: number;
+}
+
+/** Nonrecursive root-post preview carried by replies. */
+export interface MobileServerSocialFeedCompactCard {
+  /** Root item UUID. */
+  id: string;
+  /** Root author. */
+  author: MobileServerSocialFeedAuthor;
+  /** Original text excerpt. */
+  text_excerpt: string;
+  /** Visible position summary, or null. */
+  position: Pick<
+    MobileServerSocialFeedPositionCard,
+    'position_id' | 'market' | 'direction' | 'state' | 'notional_x18'
+  > | null;
+  /** Whether the root has published analysis. */
+  has_analysis: boolean;
+}
+
+/** Authored position post, including text-only, drawing-only, and combined content. */
+export interface MobileServerSocialFeedPost extends MobileServerSocialFeedContentBase {
+  /** Post discriminant. */
+  kind: 'post';
+}
+
+/** Reply with independently permissioned position attachment and nonrecursive root preview. */
+export interface MobileServerSocialFeedReply extends MobileServerSocialFeedItemBase {
+  /** Reply discriminant. */
+  kind: 'reply';
+  /** Original text. */
+  text: string;
+  /** Mentions in the text. */
+  mentions: MobileSocialFeedMention[];
+  /** Actual root item UUID. */
+  root_item_id: string;
+  /** Omitted for a direct reply to the root. */
+  reply_to_item_id?: string;
+  /** Author being replied to, or null. */
+  reply_to_author: MobileServerSocialFeedAuthor | null;
+  /** Readable attachment; null when absent or unavailable. */
+  attached_position: MobileServerSocialFeedPositionCard | null;
+  /** Distinguishes an absent attachment from an unreadable one. */
+  attachment_status: MobileSocialFeedAttachmentStatus;
+  /** Root preview; does not register root exposure. */
+  original: MobileServerSocialFeedCompactCard;
+  /** Reply interaction state. */
+  interaction: MobileServerSocialFeedInteraction;
+}
+
+/** Current eligibility hints; actual writes still recheck the signed author. */
+export interface MobileServerSocialFeedPublishablePosition {
+  /** Candidate position. */
+  position: MobileServerSocialFeedPositionCard;
+  /** Whether this account can publish. */
+  can_publish: boolean;
+  /** Whether this account can attach the position to a comment. */
+  can_attach_to_comment: boolean;
+  /** Whether this account can first add analysis. */
+  can_draw_analysis: boolean;
+  /** Unavailability explanation, or null. */
+  unavailable_reason: string | null;
+}
+
+/** An authoritative lifecycle segment of an order. */
+export interface MobileServerSocialFeedActionCandidate {
+  /** Action UUID. */
+  action_id: string;
+  /** Lifecycle UUID. */
+  position_id: string;
+  /** Lifecycle action. */
+  action: MobileSocialFeedAction;
+  /** Current publishing eligibility, not proof of caller ownership. */
+  can_publish: boolean;
+  /** Publication restriction, or null when eligible. */
+  unavailable_reason: MobileSocialFeedActionUnavailableReason | null;
+}
+
+/** Additional history metrics; unavailable values are not zero. */
+export interface MobileServerSocialFeedHistoryMetrics {
+  /** Estimated liquidation price in x18, independent of event Oracle and execution prices. */
+  estimated_liquidation_price_x18: string | null;
+  /** Availability of the estimated price. */
+  liquidation_price_quality: MobileSocialFeedLiquidationPriceQuality;
+  /** Source time in milliseconds. */
+  liquidation_price_as_of_ms: number | null;
+  /** Signed funding amount in x18. */
+  funding_pnl_x18: string | null;
+  /** Funding availability. */
+  funding_quality: MobileSocialFeedPnlQuality;
+  /** Funding source time in milliseconds. */
+  funding_as_of_ms: number | null;
+}
+
+/** Full position card displayed above its historical timeline. */
+export interface MobileServerSocialFeedPositionHistoryCard
+  extends
+    MobileServerSocialFeedPositionCard,
+    MobileServerSocialFeedHistoryMetrics {}
+
+/** Persisted action facts, independent of whether a feed item was published. */
+export interface MobileServerSocialFeedPositionAction {
+  /** Action UUID. */
+  id: string;
+  /** Lifecycle UUID. */
+  position_id: string;
+  /** Lifecycle action. */
+  action: MobileSocialFeedAction;
+  /** Position direction. */
+  direction: MobileFeedTradePositionDirection;
+  /** Historical margin mode. */
+  margin_mode: MobileFeedMarginMode;
+  /** Quantity before the action, in x18. */
+  quantity_before_x18: string;
+  /** Quantity after the action, in x18. */
+  quantity_after_x18: string;
+  /** Executed quantity, in x18. */
+  executed_quantity_x18: string;
+  /** Actual executed notional in x18; may be unknown for liquidation. */
+  executed_notional_x18: string | null;
+  /** Actual execution price in x18. */
+  average_price_x18: string | null;
+  /** Entry price before the action, in x18. */
+  entry_price_before_x18: string | null;
+  /** Liquidation event Oracle price in x18. */
+  liquidation_oracle_price_x18: string | null;
+  /** Liquidation Oracle-based notional in x18. */
+  liquidation_notional_x18: string | null;
+  /** Signed realized trading PnL in x18, excluding ordinary fees and funding. */
+  realized_pnl_delta_x18: string | null;
+  /** Historical effective leverage. */
+  leverage: MobileSocialFeedLeverage;
+  /** Leverage source time in milliseconds. */
+  leverage_at_ms: number | null;
+  /** First event time in milliseconds. */
+  first_event_at_ms: number;
+  /** Last event time in milliseconds. */
+  last_event_at_ms: number;
+  /** Decimal-string version. */
+  version: string;
+}
+
+/** Full published content appearing in a position timeline. */
+export type MobileServerSocialFeedHistoryTake =
+  | MobileServerSocialFeedTradeCard
+  | MobileServerSocialFeedPost;
+
+/** A historical action or authored take; preserve service ordering. */
+export type MobileServerSocialFeedTimelineEntry =
+  | {
+      /** Action entry. */
+      kind: 'action';
+      /** Full action facts. */
+      action: MobileServerSocialFeedPositionAction;
+      /** Actually associated feed item, or null. */
+      related_item_id: string | null;
+      /** Full published trade card, or null. */
+      related_take: MobileServerSocialFeedTradeCard | null;
+    }
+  | {
+      /** Published take entry. */
+      kind: 'take';
+      /** Full published content. */
+      item: MobileServerSocialFeedHistoryTake;
+    };
+
+/** Trusted trading target; this hint does not authorize trading. */
+export interface MobileServerSocialFeedTradingTarget {
+  /** Lifecycle UUID. */
+  position_id: string;
+  /** Parent identity. */
+  identity_subaccount: Hex;
+  /** Actual trading subaccount, possibly isolated. */
+  trading_subaccount: Hex;
+  /** Market product ID. */
+  product_id: number;
+  /** Margin mode. */
+  margin_mode: MobileFeedMarginMode;
+  /** Isolated name, or null for cross margin. */
+  iso_subaccount_name: string | null;
+  /** Position direction. */
+  direction: MobileFeedTradePositionDirection;
+  /** Source time in milliseconds. */
+  state_as_of_ms: number;
+}
+
+/** Viewing-account trading hints, not authenticated permissions. */
+export interface MobileServerSocialFeedTradingContext {
+  /** Market product ID. */
+  product_id: number;
+  /** Suggested trade direction. */
+  suggested_direction: MobileFeedTradePositionDirection;
+  /** Resolution of the viewing account's positions. */
+  resolution: MobileSocialFeedTradingResolution;
+  /** Trusted candidates. */
+  candidates: MobileServerSocialFeedTradingTarget[];
+  /** Unique candidate, or null. */
+  viewer_position_id: string | null;
+  /** Whether the selected account has a unique reducible position. */
+  can_reduce: boolean;
+}
+
+/** Historical candle; volume is a quantity, not a price. */
+export interface MobileServerSocialFeedCandle {
+  /** Candle start time in milliseconds. */
+  timestamp_ms: number;
+  /** Open price in x18. */
+  open_x18: string;
+  /** High price in x18. */
+  high_x18: string;
+  /** Low price in x18. */
+  low_x18: string;
+  /** Close price in x18. */
+  close_x18: string;
+  /** Base asset volume in x18. */
+  volume_x18: string;
+}
+
+/** Chart action marker with explicitly identified price basis. */
+export interface MobileServerSocialFeedActionMarker {
+  /** Action UUID. */
+  action_id: string;
+  /** Event time in milliseconds. */
+  timestamp_ms: number;
+  /** Price in x18; null does not remove the action. */
+  price_x18: string | null;
+  /** Lifecycle action. */
+  action: MobileSocialFeedAction;
+  /** Direction. */
+  direction: MobileFeedTradePositionDirection;
+  /** Never substitute actual execution for a liquidation Oracle. */
+  price_basis: MobileSocialFeedActionPriceBasis;
+}
+
+/** Counts across the authorized position history. */
+export interface MobileServerSocialFeedHistorySummary {
+  /** Action count. */
+  action_count: number;
+  /** Published take count. */
+  take_count: number;
+}
+
+/** Estimated liquidation price and its source time. */
+export interface MobileServerSocialFeedEstimatedLiquidationLine {
+  /** Estimated price in x18. */
+  price_x18: string;
+  /** Source time in milliseconds. */
+  as_of_ms: number;
+}
+
+/** Half-open chart range, preserved across pages. */
+export interface MobileServerSocialFeedChartRange {
+  /** Inclusive start in milliseconds. */
+  from_ms: number;
+  /** Exclusive end in milliseconds. */
+  to_ms: number;
+}