@nadohq/mobile-client 0.53.0 → 0.55.0

package/README.md

@@ -1,8 +1,8 @@
 # `@nadohq/mobile-client`
 
-HTTP client for the Nado mobile service API. Manages usernames, public profile lookups, the global trade feed,
-the follower/following graph, privacy settings, and push notification devices/preferences, using EIP-712 +
-msgpack signed authentication.
+HTTP client for the Nado mobile service API. Manages usernames, public profile lookups, global and
+session-based trade feeds, the follower/following graph, privacy settings, and push notification
+devices/preferences. Public queries require no wallet; authenticated operations use EIP-712 + msgpack signing.
 
 [Full SDK Documentation](https://nadohq.github.io/nado-typescript-sdk/index.html)
 
@@ -47,7 +47,8 @@ await mobile.setUsername({
 ### Public Queries
 
 `getUsernameAvailability`, `getProfiles`, `getFollowers`, `getFollowing`, `getFeed`,
-`getNotificationPreferences`, `getRegisteredWallet`.
+`getNotificationPreferences`, `getRegisteredWallet`, `getForYouFeed`, `getTopTradersFeed`,
+`getFriendsFeed`, `getProfileFeed`, `getMarketFeed`, `getPositionFeed`, `getFeedItem`, `getFeedUpdates`.
 
 `getProfiles` is the only profile route: it batches up to 25 subaccounts, returns them in the requested order,
 and carries follower totals (`include.followCounts`) and a follow summary (`include.followSummary.viewAs`) as
@@ -60,6 +61,13 @@ proving one: with it the page is ordered familiar-first and every row carries an
 page is ordered by the listed relationship alone and `isFollowing` is absent rather than `false`. As with
 `include.followSummary.viewAs`, an unsigned route means the claimed viewer is not verified.
 
+`getFeed` returns the global trade feed. Session-based feeds include `getForYouFeed`, `getTopTradersFeed`,
+and `getFriendsFeed` (requires `viewAs`), plus `getProfileFeed`, `getMarketFeed`, and `getPositionFeed`.
+`getFeedItem` reads one item; `getFeedUpdates` polls session patches using the returned `viewerToken`.
+All are unsigned. Profile, position, and item reads include the `viewAs` account's own hidden content under
+`account_view`; the viewing account is not proof of wallet ownership. Prices are decimal `BigNumber` values;
+quantities, notionals, and PnL retain x18 units. See method and parameter JSDoc for session and polling rules.
+
 ### Public Executes
 
 `unregisterExpoToken`, `updateNotificationPreferences`. These are authenticated by possession of an active Expo

package/dist/{MobileClient-CEVEYnV1.cjs → MobileClient-BbTaqTzi.cjs}

@@ -29,8 +29,9 @@ let axios = require("axios");
 axios = __toESM(axios, 1);
 //#region src/MobileClient.ts
 /**
-* Client for the Nado mobile service API: usernames, public profile lookups, the global trade feed, the
-* follower/following graph, privacy settings, and push notification device/preference management.
+* Client for the Nado mobile service API: usernames, public profile lookups, the global trade feed,
+* session-based social feeds, the follower/following graph, privacy settings, and push notification
+* device/preference management.
 */
 var MobileClient = class {
 	constructor(opts) {
@@ -141,6 +142,143 @@ var MobileClient = class {
 		return require_dataMappers.mapMobileFeedPage(await this.publicQuery(body));
 	}
 	/**
+	* Fetches chronological For You recommendations with server-side author/thread constraints.
+	* Always public, with optional viewAs for relationship state. Preserve the session, viewAs, filters, and limit
+	* when paging, including through empty pages with a nextCursor. A 6312 error requires a refresh.
+	* @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.
+	*/
+	async getForYouFeed(params = {}) {
+		const body = {
+			type: "for_you_feed",
+			market_category: params.marketCategory,
+			...require_dataMappers.mapMobileSocialFeedListParamsToServer(params),
+			...require_dataMappers.mapMobileSocialFeedReadParamsToServer(params)
+		};
+		return require_dataMappers.mapMobileSocialFeedRankedPage(await this.publicQuery(body));
+	}
+	/**
+	* Fetches chronological content by qualified Top Traders, with official account PnL badges.
+	* Always public; neither a wallet nor one-click trading setup is required.
+	* @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.
+	*/
+	async getTopTradersFeed(params = {}) {
+		const body = {
+			type: "top_traders_feed",
+			market_category: params.marketCategory,
+			...require_dataMappers.mapMobileSocialFeedListParamsToServer(params),
+			...require_dataMappers.mapMobileSocialFeedReadParamsToServer(params)
+		};
+		return require_dataMappers.mapMobileSocialFeedTopTradersPage(await this.publicQuery(body));
+	}
+	/**
+	* Fetches public content by authors followed by viewAs, without a signature. One-way following is sufficient.
+	* @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.
+	*/
+	async getFriendsFeed(params) {
+		const body = {
+			type: "friends_feed",
+			market_category: params.marketCategory,
+			...require_dataMappers.mapMobileSocialFeedListParamsToServer(params),
+			view_as: (0, _nadohq_shared.subaccountToHex)(params.viewAs),
+			viewer_token: params.viewerToken
+		};
+		return require_dataMappers.mapMobileSocialFeedRankedPage(await this.publicQuery(body));
+	}
+	/**
+	* Fetches an author's content visible to viewAs, including that account's own hidden content.
+	* @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.
+	*/
+	async getProfileFeed(params) {
+		const body = {
+			type: "profile_feed",
+			subaccount: (0, _nadohq_shared.subaccountToHex)(params.subaccount),
+			market_category: params.marketCategory,
+			...require_dataMappers.mapMobileSocialFeedListParamsToServer(params),
+			...require_dataMappers.mapMobileSocialFeedReadParamsToServer(params)
+		};
+		return require_dataMappers.mapMobileSocialFeedPage(await this.publicQuery(body));
+	}
+	/**
+	* Fetches published content for one market.
+	* @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.
+	*/
+	async getMarketFeed(params) {
+		const body = {
+			type: "market_feed",
+			product_id: params.productId,
+			...require_dataMappers.mapMobileSocialFeedListParamsToServer(params),
+			...require_dataMappers.mapMobileSocialFeedReadParamsToServer(params)
+		};
+		return require_dataMappers.mapMobileSocialFeedPage(await this.publicQuery(body));
+	}
+	/**
+	* Fetches already published content for a position lifecycle. This is not full position history
+	* and includes hidden content owned by viewAs under account_view. It does not recreate suppressed activity.
+	* @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.
+	*/
+	async getPositionFeed(params) {
+		const body = {
+			type: "position_feed",
+			position_id: params.positionId,
+			...require_dataMappers.mapMobileSocialFeedListParamsToServer(params),
+			...require_dataMappers.mapMobileSocialFeedReadParamsToServer(params)
+		};
+		return require_dataMappers.mapMobileSocialFeedPage(await this.publicQuery(body));
+	}
+	/**
+	* 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.
+	* @returns The complete item and authorized reading session.
+	* @throws {MobileServerFailureError} On inaccessible content or session mismatch/expiry.
+	*/
+	async getFeedItem(params) {
+		const body = {
+			type: "feed_item",
+			item_id: params.itemId,
+			comment_preview_limit: params.commentPreviewLimit,
+			session_id: params.sessionId,
+			...require_dataMappers.mapMobileSocialFeedReadParamsToServer(params)
+		};
+		return require_dataMappers.mapMobileSocialFeedItemResponse(await this.publicQuery(body));
+	}
+	/**
+	* Polls authorized visible items and positions without inserting or reordering list members.
+	* Increment requestSeq across the entire session, including viewport changes; never reset it for a new viewport.
+	* Accept only the current session and viewportRevision's latest requestSeq; discard stale patches and cursors together.
+	* Updates currently always return reset=true. Apply current author details, follow state, and badges even if the item version is unchanged.
+	* Null patches clear values;
+	* omitted fields leave them unchanged. Stop polling off-screen and refresh on error 6312.
+	* @param params - Session, visible IDs, update baseline, sequence, and matching read identity.
+	* @returns Item/position patches, revoked targets, and a new-content hint.
+	* @throws {MobileServerFailureError} On invalid or unauthorized targets, session expiry, or unavailable data.
+	*/
+	async getFeedUpdates(params) {
+		const body = {
+			type: "feed_updates",
+			session_id: params.sessionId,
+			visible_item_ids: params.visibleItemIds,
+			visible_position_ids: params.visiblePositionIds,
+			update_cursor: params.updateCursor,
+			viewport_revision: params.viewportRevision,
+			request_seq: params.requestSeq,
+			viewer_token: params.viewerToken
+		};
+		return require_dataMappers.mapMobileSocialFeedUpdates(await this.publicQuery(body));
+	}
+	/**
 	* Fetches the push notification preferences of the wallet that owns the given Expo push token. Unsigned —
 	* the token identifies the wallet on its own. Falls back to the backend's defaults if the wallet has never
 	* updated its preferences.
@@ -324,4 +462,4 @@ Object.defineProperty(exports, "MobileClient", {
 	}
 });
 
-//# sourceMappingURL=MobileClient-CEVEYnV1.cjs.map
+//# sourceMappingURL=MobileClient-BbTaqTzi.cjs.map

package/dist/MobileClient-BbTaqTzi.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"MobileClient-BbTaqTzi.cjs","names":["subaccountToHex","mapMobileProfilesIncludeToServer","mapMobilePublicProfile","mapMobileFollowListParamsToServer","mapMobileFollowListPage","mapMobileFeedPage","mapMobileSocialFeedListParamsToServer","mapMobileSocialFeedReadParamsToServer","mapMobileSocialFeedRankedPage","mapMobileSocialFeedTopTradersPage","mapMobileSocialFeedPage","mapMobileSocialFeedItemResponse","mapMobileSocialFeedUpdates","mapMobileNotificationPreferences","mapMobileRegisteredWallet","mapMobileNotificationPreferencesToServer","mapMobileFollowMutationResult","WalletNotProvidedError","buildSignedMobileRequest","isMobileServerFailureResponse","MobileServerFailureError","isMobileServerSuccessResponse"],"sources":["../src/MobileClient.ts"],"sourcesContent":["import {\n  getNadoClientTypeHeaders,\n  subaccountToHex,\n  WalletClientWithAccount,\n  WalletNotProvidedError,\n} from '@nadohq/shared';\nimport axios, { AxiosInstance, AxiosResponse } from 'axios';\nimport {\n  mapMobileFeedPage,\n  mapMobileFollowListPage,\n  mapMobileFollowListParamsToServer,\n  mapMobileFollowMutationResult,\n  mapMobileNotificationPreferences,\n  mapMobileNotificationPreferencesToServer,\n  mapMobileProfilesIncludeToServer,\n  mapMobilePublicProfile,\n  mapMobileRegisteredWallet,\n  mapMobileSocialFeedItemResponse,\n  mapMobileSocialFeedListParamsToServer,\n  mapMobileSocialFeedPage,\n  mapMobileSocialFeedRankedPage,\n  mapMobileSocialFeedReadParamsToServer,\n  mapMobileSocialFeedTopTradersPage,\n  mapMobileSocialFeedUpdates,\n} from './dataMappers';\nimport {\n  buildSignedMobileRequest,\n  MobileSignedInner,\n  MobileSignedInnerByType,\n  MobileSignedInnerParams,\n  MobileSignedRequest,\n} from './signing';\nimport {\n  GetMobileFeedItemParams,\n  GetMobileFeedParams,\n  GetMobileFeedUpdatesParams,\n  GetMobileFollowersParams,\n  GetMobileFollowingParams,\n  GetMobileForYouFeedParams,\n  GetMobileFriendsFeedParams,\n  GetMobileMarketFeedParams,\n  GetMobileNotificationPreferencesParams,\n  GetMobilePositionFeedParams,\n  GetMobileProfileFeedParams,\n  GetMobileProfilesParams,\n  GetMobileRegisteredWalletParams,\n  GetMobileTopTradersFeedParams,\n  GetMobileUsernameAvailabilityParams,\n  MobileFeedPage,\n  MobileFollowListPage,\n  MobileFollowMutationResult,\n  MobileNotificationPreferences,\n  MobilePublicProfile,\n  MobileRegisteredWallet,\n  MobileRegisterExpoTokenParams,\n  MobileSetFollowParams,\n  MobileSetPrivateModeParams,\n  MobileSetUsernameParams,\n  MobileSignedRequestParams,\n  MobileSocialFeedItemResponse,\n  MobileSocialFeedPage,\n  MobileSocialFeedRankedPage,\n  MobileSocialFeedTopTradersPage,\n  MobileSocialFeedUpdates,\n  MobileUnregisterExpoTokenParams,\n  MobileUpdateNotificationPreferencesParams,\n  MobileUsernameAvailability,\n} from './types/clientTypes';\nimport { MobileServerFailureError } from './types/MobileServerFailureError';\nimport { MobileServerSuccessResponse } from './types/serverBaseTypes';\nimport {\n  MobileServerExecuteResult,\n  MobileServerExecuteSuccessResponse,\n  MobileServerPublicExecuteRequest,\n} from './types/serverExecuteTypes';\nimport {\n  MobileServerPublicQueryRequest,\n  MobileServerPublicQuerySuccessResponse,\n} from './types/serverQueryTypes';\nimport {\n  MobileServerExecuteRequestType,\n  MobileServerPublicQueryRequestByType,\n  MobileServerPublicQueryRequestType,\n} from './types/serverRequestTypes';\nimport {\n  isMobileServerFailureResponse,\n  isMobileServerSuccessResponse,\n} from './utils/serverResponseGuards';\n\n/**\n * Options for constructing a {@link MobileClient}.\n */\nexport interface MobileClientOpts {\n  /**\n   * Base URL of the mobile service API, e.g. {@link MOBILE_CLIENT_ENDPOINTS}.\n   */\n  url: string;\n  /**\n   * Wallet client used to sign requests.\n   */\n  walletClient?: WalletClientWithAccount;\n  /**\n   * If provided, this signer is used instead of `walletClient` for all signed requests.\n   */\n  linkedSignerWalletClient?: WalletClientWithAccount;\n  /**\n   * If provided, identifies the calling client, sent as a header with every request.\n   */\n  clientType?: string;\n}\n\n/**\n * Client for the Nado mobile service API: usernames, public profile lookups, the global trade feed,\n * session-based social feeds, the follower/following graph, privacy settings, and push notification\n * device/preference management.\n */\nexport class MobileClient {\n  readonly opts: MobileClientOpts;\n  readonly axiosInstance: AxiosInstance;\n\n  constructor(opts: MobileClientOpts) {\n    this.opts = opts;\n    this.axiosInstance = axios.create({\n      withCredentials: true,\n      // We have custom logic to validate response status and create an appropriate error\n      validateStatus: () => true,\n      headers: getNadoClientTypeHeaders(opts.clientType),\n    });\n  }\n\n  /**\n   * Sets the linked signer for requests\n   *\n   * @param linkedSignerWalletClient The linkedSigner to use for all signatures. Set to null to revert to the chain signer\n   */\n  public setLinkedSigner(\n    linkedSignerWalletClient: WalletClientWithAccount | null,\n  ) {\n    this.opts.linkedSignerWalletClient = linkedSignerWalletClient ?? undefined;\n  }\n\n  /*\n  Public queries\n   */\n\n  /**\n   * Checks whether a username derived from the given display name is available to claim.\n   */\n  async getUsernameAvailability(\n    params: GetMobileUsernameAvailabilityParams,\n  ): Promise<MobileUsernameAvailability> {\n    const body: MobileServerPublicQueryRequest<'username_availability'> = {\n      type: 'username_availability',\n      display_name: params.displayName,\n    };\n    const data = await this.publicQuery(body);\n    return { username: data.username, available: data.available };\n  }\n\n  /**\n   * Looks up public profiles, optionally with follower totals and a follow summary. Returns one profile per\n   * requested subaccount, in the requested order, so callers can correlate positionally. Every non-isolated\n   * subaccount resolves, with `username` and `displayName` `null` until a username is claimed. Private Mode\n   * does not hide the profile itself, only the account's activity.\n   *\n   * This is the only profile route, so use it for a single subaccount too. It is unsigned, which means\n   * `include.followSummary.viewAs` is an unauthenticated claim.\n   *\n   * @throws {MobileServerFailureError} With error code `INVALID_PROFILES_REQUEST` if `subaccounts` is empty,\n   * holds duplicates, or exceeds `MOBILE_PROFILES_MAX_BATCH_SIZE` (25), or `PROFILE_NOT_FOUND` if any\n   * requested subaccount — or the follow summary's `viewAs` — is in the engine-created isolated namespace.\n   * One isolated member fails the whole batch rather than being omitted.\n   */\n  async getProfiles(\n    params: GetMobileProfilesParams,\n  ): Promise<MobilePublicProfile[]> {\n    const body: MobileServerPublicQueryRequest<'profiles'> = {\n      type: 'profiles',\n      subaccounts: params.subaccounts.map(subaccountToHex),\n      include: params.include\n        ? mapMobileProfilesIncludeToServer(params.include)\n        : undefined,\n    };\n    const data = await this.publicQuery(body);\n    return data.profiles.map(mapMobilePublicProfile);\n  }\n\n  /**\n   * Fetches a page of the accounts that follow the given Profile.\n   *\n   * Ordering depends on `viewAs`. With it, accounts the Viewer already follows come first, unfamiliar\n   * accounts second, and every row carries an `isFollowing`. Without it, the page is ordered by the listed\n   * relationship alone and no row carries an `isFollowing`. In both cases the newest listed relationship\n   * comes first within a group, with a bytes32 tie-break. The grouping is evaluated per request against the\n   * live graph, so following an account from inside the list moves it between groups on the next page —\n   * deduplicate by subaccount and do not re-sort locally.\n   *\n   * @throws {MobileServerFailureError} With error code `PROFILE_NOT_FOUND` if the viewed Profile or `viewAs`\n   * is isolated, `INVALID_FOLLOW_CURSOR` if the cursor is malformed or was issued for a different `viewAs`,\n   * Profile, or list direction (discard it and restart from the first page), or `INVALID_FOLLOW_LIMIT` if\n   * `limit` is outside 1–50.\n   */\n  async getFollowers(\n    params: GetMobileFollowersParams,\n  ): Promise<MobileFollowListPage> {\n    const body: MobileServerPublicQueryRequest<'followers'> = {\n      type: 'followers',\n      ...mapMobileFollowListParamsToServer(params),\n    };\n    const data = await this.publicQuery(body);\n    return mapMobileFollowListPage(data);\n  }\n\n  /**\n   * Fetches a page of the accounts the given Profile follows. Ordering, cursor rules, and errors match\n   * {@link MobileClient.getFollowers}. When `viewAs` reads its own Following list every row is familiar, so\n   * every `isFollowing` is `true`.\n   */\n  async getFollowing(\n    params: GetMobileFollowingParams,\n  ): Promise<MobileFollowListPage> {\n    const body: MobileServerPublicQueryRequest<'following'> = {\n      type: 'following',\n      ...mapMobileFollowListParamsToServer(params),\n    };\n    const data = await this.publicQuery(body);\n    return mapMobileFollowListPage(data);\n  }\n\n  /**\n   * Fetches a page of the global trade feed: public perpetual trades, newest first, optionally filtered by a\n   * whole-dollar minimum notional (omitted means unfiltered). Trades by subaccounts that have not claimed a\n   * username are included with `null` name fields; only private accounts are filtered out. The feed is\n   * best-effort rather than authoritative history, and pagination is live (not snapshot), so deduplicate pages\n   * by {@link MobileFeedTrade.orderDigest}.\n   *\n   * @throws {MobileServerFailureError} With error code `INVALID_FEED_FILTER` if `minimumNotional` or\n   * `limit` is outside its allowed domain (fix the request; do not retry unchanged), or\n   * `INVALID_FEED_CURSOR` if the cursor is malformed or was issued for a different `minimumNotional`\n   * (discard the cursor and restart from the first page).\n   */\n  async getFeed(params: GetMobileFeedParams = {}): Promise<MobileFeedPage> {\n    const body: MobileServerPublicQueryRequest<'feed'> = {\n      type: 'feed',\n      minimum_notional: params.minimumNotional,\n      limit: params.limit,\n      cursor: params.cursor,\n    };\n    const data = await this.publicQuery(body);\n    return mapMobileFeedPage(data);\n  }\n\n  /**\n   * Fetches chronological For You recommendations with server-side author/thread constraints.\n   * Always public, with optional viewAs for relationship state. Preserve the session, viewAs, filters, and limit\n   * when paging, including through empty pages with a nextCursor. A 6312 error requires a refresh.\n   * @param params - Filters, pagination, optional viewing account, and browser credential; no signing identity.\n   * @returns A fixed-session page with its ranking version and new-content watermark.\n   * @throws {MobileServerFailureError} On invalid parameters, session mismatch/expiry, or unavailable data.\n   */\n  async getForYouFeed(\n    params: GetMobileForYouFeedParams = {},\n  ): Promise<MobileSocialFeedRankedPage> {\n    const body: MobileServerPublicQueryRequest<'for_you_feed'> = {\n      type: 'for_you_feed',\n      market_category: params.marketCategory,\n      ...mapMobileSocialFeedListParamsToServer(params),\n      ...mapMobileSocialFeedReadParamsToServer(params),\n    };\n    const data = await this.publicQuery(body);\n    return mapMobileSocialFeedRankedPage(data);\n  }\n\n  /**\n   * Fetches chronological content by qualified Top Traders, with official account PnL badges.\n   * Always public; neither a wallet nor one-click trading setup is required.\n   * @param params - Filters, pagination, optional viewing account, and browser credential.\n   * @returns A page with its qualification cohort; an unavailable cohort fails instead of returning an empty ranking.\n   * @throws {MobileServerFailureError} On request/session errors or unavailable cohort data.\n   */\n  async getTopTradersFeed(\n    params: GetMobileTopTradersFeedParams = {},\n  ): Promise<MobileSocialFeedTopTradersPage> {\n    const body: MobileServerPublicQueryRequest<'top_traders_feed'> = {\n      type: 'top_traders_feed',\n      market_category: params.marketCategory,\n      ...mapMobileSocialFeedListParamsToServer(params),\n      ...mapMobileSocialFeedReadParamsToServer(params),\n    };\n    const data = await this.publicQuery(body);\n    return mapMobileSocialFeedTopTradersPage(data);\n  }\n\n  /**\n   * Fetches public content by authors followed by viewAs, without a signature. One-way following is sufficient.\n   * @param params - Required viewing account on every request, filters, pagination, and browser credential.\n   * @returns A chronological Friends page and reading session.\n   * @throws {MobileServerFailureError} On invalid viewing account, session errors, or feed query failure.\n   */\n  async getFriendsFeed(\n    params: GetMobileFriendsFeedParams,\n  ): Promise<MobileSocialFeedRankedPage> {\n    const body: MobileServerPublicQueryRequest<'friends_feed'> = {\n      type: 'friends_feed',\n      market_category: params.marketCategory,\n      ...mapMobileSocialFeedListParamsToServer(params),\n      view_as: subaccountToHex(params.viewAs),\n      viewer_token: params.viewerToken,\n    };\n    const data = await this.publicQuery(body);\n    return mapMobileSocialFeedRankedPage(data);\n  }\n\n  /**\n   * Fetches an author's content visible to viewAs, including that account's own hidden content.\n   * @param params - Target identity, filters, pagination, and optional public viewing account.\n   * @returns An author page without main-feed ranking or cohort fields.\n   * @throws {MobileServerFailureError} On invalid parameters, session errors, or inaccessible content.\n   */\n  async getProfileFeed(\n    params: GetMobileProfileFeedParams,\n  ): Promise<MobileSocialFeedPage> {\n    const body: MobileServerPublicQueryRequest<'profile_feed'> = {\n      type: 'profile_feed',\n      subaccount: subaccountToHex(params.subaccount),\n      market_category: params.marketCategory,\n      ...mapMobileSocialFeedListParamsToServer(params),\n      ...mapMobileSocialFeedReadParamsToServer(params),\n    };\n    const data = await this.publicQuery(body);\n    return mapMobileSocialFeedPage(data);\n  }\n\n  /**\n   * Fetches published content for one market.\n   * @param params - Product ID, content/size filters, pagination, and public viewing account.\n   * @returns A market page without main-feed ranking fields.\n   * @throws {MobileServerFailureError} On an unknown market, session errors, or unavailable data.\n   */\n  async getMarketFeed(\n    params: GetMobileMarketFeedParams,\n  ): Promise<MobileSocialFeedPage> {\n    const body: MobileServerPublicQueryRequest<'market_feed'> = {\n      type: 'market_feed',\n      product_id: params.productId,\n      ...mapMobileSocialFeedListParamsToServer(params),\n      ...mapMobileSocialFeedReadParamsToServer(params),\n    };\n    const data = await this.publicQuery(body);\n    return mapMobileSocialFeedPage(data);\n  }\n\n  /**\n   * Fetches already published content for a position lifecycle. This is not full position history\n   * and includes hidden content owned by viewAs under account_view. It does not recreate suppressed activity.\n   * @param params - Position UUID, filters, pagination, and public viewing account.\n   * @returns A fixed-session position feed page.\n   * @throws {MobileServerFailureError} On inaccessible content, session errors, or unavailable data.\n   */\n  async getPositionFeed(\n    params: GetMobilePositionFeedParams,\n  ): Promise<MobileSocialFeedPage> {\n    const body: MobileServerPublicQueryRequest<'position_feed'> = {\n      type: 'position_feed',\n      position_id: params.positionId,\n      ...mapMobileSocialFeedListParamsToServer(params),\n      ...mapMobileSocialFeedReadParamsToServer(params),\n    };\n    const data = await this.publicQuery(body);\n    return mapMobileSocialFeedPage(data);\n  }\n\n  /**\n   * Reads one item visible to viewAs, including that account's own hidden content.\n   * Creates an item session directly when sessionId is omitted.\n   * @param params - Item UUID, preview limit, and optional existing session/read identity.\n   * @returns The complete item and authorized reading session.\n   * @throws {MobileServerFailureError} On inaccessible content or session mismatch/expiry.\n   */\n  async getFeedItem(\n    params: GetMobileFeedItemParams,\n  ): Promise<MobileSocialFeedItemResponse> {\n    const body: MobileServerPublicQueryRequest<'feed_item'> = {\n      type: 'feed_item',\n      item_id: params.itemId,\n      comment_preview_limit: params.commentPreviewLimit,\n      session_id: params.sessionId,\n      ...mapMobileSocialFeedReadParamsToServer(params),\n    };\n    const data = await this.publicQuery(body);\n    return mapMobileSocialFeedItemResponse(data);\n  }\n\n  /**\n   * Polls authorized visible items and positions without inserting or reordering list members.\n   * Increment requestSeq across the entire session, including viewport changes; never reset it for a new viewport.\n   * Accept only the current session and viewportRevision's latest requestSeq; discard stale patches and cursors together.\n   * Updates currently always return reset=true. Apply current author details, follow state, and badges even if the item version is unchanged.\n   * Null patches clear values;\n   * omitted fields leave them unchanged. Stop polling off-screen and refresh on error 6312.\n   * @param params - Session, visible IDs, update baseline, sequence, and matching read identity.\n   * @returns Item/position patches, revoked targets, and a new-content hint.\n   * @throws {MobileServerFailureError} On invalid or unauthorized targets, session expiry, or unavailable data.\n   */\n  async getFeedUpdates(\n    params: GetMobileFeedUpdatesParams,\n  ): Promise<MobileSocialFeedUpdates> {\n    const body: MobileServerPublicQueryRequest<'feed_updates'> = {\n      type: 'feed_updates',\n      session_id: params.sessionId,\n      visible_item_ids: params.visibleItemIds,\n      visible_position_ids: params.visiblePositionIds,\n      update_cursor: params.updateCursor,\n      viewport_revision: params.viewportRevision,\n      request_seq: params.requestSeq,\n      viewer_token: params.viewerToken,\n    };\n    const data = await this.publicQuery(body);\n    return mapMobileSocialFeedUpdates(data);\n  }\n\n  /**\n   * Fetches the push notification preferences of the wallet that owns the given Expo push token. Unsigned —\n   * the token identifies the wallet on its own. Falls back to the backend's defaults if the wallet has never\n   * updated its preferences.\n   *\n   * @throws {MobileServerFailureError} With error code `INVALID_EXPO_TOKEN` if the token is malformed, or is\n   * not currently registered to a wallet.\n   */\n  async getNotificationPreferences(\n    params: GetMobileNotificationPreferencesParams,\n  ): Promise<MobileNotificationPreferences> {\n    const body: MobileServerPublicQueryRequest<'notification_preferences'> = {\n      type: 'notification_preferences',\n      expo_token: params.expoToken,\n    };\n    const data = await this.publicQuery(body);\n    return mapMobileNotificationPreferences(data.preferences);\n  }\n\n  /**\n   * Resolves the wallet that an Expo push token is currently registered to, along with the redacted metadata\n   * of the device that registered it. Unsigned — the token identifies the wallet on its own. Use it to check\n   * whether a locally held token is still active and which wallet currently owns it, since registering the\n   * same token under another wallet transfers ownership.\n   *\n   * @throws {MobileServerFailureError} With error code `INVALID_EXPO_TOKEN` if the token is malformed, or is\n   * not currently registered to a wallet — including a token that was unregistered. The backend does not\n   * distinguish those cases.\n   */\n  async getRegisteredWallet(\n    params: GetMobileRegisteredWalletParams,\n  ): Promise<MobileRegisteredWallet> {\n    const body: MobileServerPublicQueryRequest<'registered_wallet'> = {\n      type: 'registered_wallet',\n      expo_token: params.expoToken,\n    };\n    const data = await this.publicQuery(body);\n    return mapMobileRegisteredWallet(data);\n  }\n\n  /*\n  Public executes\n   */\n\n  /**\n   * Unregisters an Expo push token, stopping delivery to that device. Unsigned, so it still works at logout\n   * when a wallet signature may no longer be obtainable. Idempotent: unregistering an inactive or unknown\n   * well-formed token succeeds.\n   *\n   * A registration that commits after this call re-activates the token, so stop or await any in-flight\n   * {@link MobileClient.registerExpoToken} before unregistering.\n   *\n   * @throws {MobileServerFailureError} With error code `INVALID_EXPO_TOKEN` if the token is malformed.\n   */\n  async unregisterExpoToken(\n    params: MobileUnregisterExpoTokenParams,\n  ): Promise<MobileServerSuccessResponse> {\n    const body: MobileServerPublicExecuteRequest<'unregister_expo_token'> = {\n      type: 'unregister_expo_token',\n      expo_token: params.expoToken,\n    };\n    return this.publicExecute(body);\n  }\n\n  /**\n   * Replaces the push notification preferences of the wallet that owns the given Expo push token. Possession\n   * of an active token is the credential rather than a signature, so anyone holding the token can overwrite\n   * that wallet's preferences. The backend requires `schemaVersion` of 1, exactly one entry per known\n   * category, and empty `scopes` on every entry.\n   *\n   * Writes are last-write-wins on commit order rather than ordered by a client nonce, so callers must\n   * serialize their own preference writes.\n   *\n   * @throws {MobileServerFailureError} With error code `INVALID_PREFERENCES` if those rules are violated, or\n   * `INVALID_EXPO_TOKEN` if the token is malformed or is not currently registered to a wallet.\n   */\n  async updateNotificationPreferences(\n    params: MobileUpdateNotificationPreferencesParams,\n  ): Promise<MobileServerSuccessResponse> {\n    const body: MobileServerPublicExecuteRequest<'update_preferences'> = {\n      type: 'update_preferences',\n      expo_token: params.expoToken,\n      preferences: mapMobileNotificationPreferencesToServer(params.preferences),\n    };\n    return this.publicExecute(body);\n  }\n\n  /*\n  Signed executes\n   */\n\n  /**\n   * Sets a subaccount's username, derived from the given display name. Upserts: the same call claims a first\n   * username and renames an existing one, so callers never need to read the current identity first.\n   *\n   * @throws {MobileServerFailureError} With error code `INVALID_DISPLAY_NAME` if the display name violates\n   * `MOBILE_DISPLAY_NAME_PATTERN`, `USERNAME_UNAVAILABLE` if the derived username is reserved or already\n   * taken by another subaccount, `INVALID_IDENTITY_TARGET` if the sender is in the engine-created isolated\n   * namespace, or `STALE_IDENTITY_UPDATE` if another identity write for this subaccount committed with a\n   * later nonce (re-read the identity before retrying).\n   */\n  async setUsername(\n    params: MobileSetUsernameParams,\n  ): Promise<MobileServerSuccessResponse> {\n    const signedRequest = await this.getSignedRequest('set_username', params, {\n      display_name: params.displayName,\n    });\n    return this.execute(signedRequest);\n  }\n\n  /**\n   * Sets whether a subaccount's profile is private.\n   */\n  async setPrivateMode(\n    params: MobileSetPrivateModeParams,\n  ): Promise<MobileServerSuccessResponse> {\n    const signedRequest = await this.getSignedRequest(\n      'set_private_mode',\n      params,\n      { private_mode: params.privateMode },\n    );\n    return this.execute(signedRequest);\n  }\n\n  /**\n   * Registers an Expo push token for the wallet, transferring active ownership of the token if another\n   * wallet had registered it. Idempotent per `(wallet, token)`.\n   *\n   * @throws {MobileServerFailureError} With error code `INVALID_EXPO_TOKEN` if the token is not a valid Expo\n   * push token, or `INVALID_DEVICE_METADATA` if `locale` (max 35 chars) or `appVersion` (max 64 chars) is\n   * too long.\n   */\n  async registerExpoToken(\n    params: MobileRegisterExpoTokenParams,\n  ): Promise<MobileServerSuccessResponse> {\n    const signedRequest = await this.getSignedRequest(\n      'register_expo_token',\n      params,\n      {\n        expo_token: params.expoToken,\n        platform: params.platform,\n        locale: params.locale ?? null,\n        app_version: params.appVersion ?? null,\n      },\n    );\n    return this.execute(signedRequest);\n  }\n\n  /**\n   * Sets whether the signing subaccount follows a Profile. Both directions are idempotent: following again\n   * keeps the original relationship creation time, so it does not move the account in recency order, and\n   * unfollowing a relationship that does not exist succeeds with `isFollowing: false`. Unfollowing deletes\n   * the relationship rather than deactivating it, so a later follow gets a new creation time and moves the\n   * account to the front of recency order.\n   *\n   * Only `isFollowing: true` is checked against the canonical Query DB subaccount index, so unfollowing still\n   * works while that index lags.\n   *\n   * @throws {MobileServerFailureError} With error code `INVALID_FOLLOW_TARGET` if the target is the sender or\n   * either party is isolated, `FOLLOWER_NOT_ELIGIBLE` if the sender is not yet in the canonical Query DB\n   * subaccount index, or `FOLLOWING_NOT_FOUND` if the target is not. Both index errors are transient for an\n   * account that is being recorded, so they are retryable after catch-up — unlike `INVALID_FOLLOW_TARGET`.\n   */\n  async setFollow(\n    params: MobileSetFollowParams,\n  ): Promise<MobileFollowMutationResult> {\n    const signedRequest = await this.getSignedRequest('set_follow', params, {\n      subaccount: subaccountToHex(params.target),\n      is_following: params.isFollowing,\n    });\n    const data = await this.execute(signedRequest);\n    return mapMobileFollowMutationResult(data);\n  }\n\n  /*\n  Base Fns\n   */\n\n  // Returns the request narrowed to `type` so `execute` can infer its response from the request it is given,\n  // instead of being told the type a second time at the call site.\n  protected async getSignedRequest<T extends MobileSignedInner['type']>(\n    type: T,\n    params: MobileSignedRequestParams,\n    innerParams: MobileSignedInnerParams<T>,\n  ): Promise<MobileSignedRequest<MobileSignedInnerByType<T>>> {\n    // Use the linked signer if provided, otherwise use the default signer provided to the client\n    const walletClient =\n      this.opts.linkedSignerWalletClient ?? this.opts.walletClient;\n\n    if (walletClient == null) {\n      throw new WalletNotProvidedError();\n    }\n\n    const inner = {\n      type,\n      ...innerParams,\n    } as unknown as MobileSignedInnerByType<T>;\n    return buildSignedMobileRequest({ ...params, walletClient, inner });\n  }\n\n  // Spelled out as an intersection rather than `MobileServerPublicQueryRequest<T>`: the latter is an indexed\n  // access on a mapped type, which is not an inference site, so `T` would always widen to the full union.\n  protected async publicQuery<T extends MobileServerPublicQueryRequestType>(\n    body: { type: T } & MobileServerPublicQueryRequestByType[T],\n  ): Promise<MobileServerPublicQuerySuccessResponse<T>> {\n    const response = await this.axiosInstance.post<unknown>(\n      `${this.opts.url}/public_query`,\n      body,\n    );\n\n    this.checkResponseStatus(response);\n    this.checkServerStatus(response);\n\n    // checkServerStatus throws on failure responses so the cast to the success response is acceptable here\n    return response.data as MobileServerPublicQuerySuccessResponse<T>;\n  }\n\n  protected async publicExecute(\n    body: MobileServerPublicExecuteRequest,\n  ): Promise<MobileServerSuccessResponse> {\n    const response = await this.axiosInstance.post<MobileServerExecuteResult>(\n      `${this.opts.url}/public_execute`,\n      body,\n    );\n\n    this.checkResponseStatus(response);\n    this.checkServerStatus(response);\n\n    // checkServerStatus catches the failure result and throws the error, so the cast to the success response is acceptable here\n    return response.data as MobileServerSuccessResponse;\n  }\n\n  // `T` is inferred from the body's `type` rather than declared by the caller, for the same reason\n  // `publicQuery` spells its body out as an intersection: an indexed access is not an inference site.\n  protected async execute<T extends MobileServerExecuteRequestType>(\n    body: MobileSignedRequest & { type: T },\n  ): Promise<MobileServerExecuteSuccessResponse<T>> {\n    const response = await this.axiosInstance.post<MobileServerExecuteResult>(\n      `${this.opts.url}/execute`,\n      body,\n    );\n\n    this.checkResponseStatus(response);\n    this.checkServerStatus(response);\n\n    // checkServerStatus catches the failure result and throws the error, so the cast to the success response is acceptable here\n    return response.data as MobileServerExecuteSuccessResponse<T>;\n  }\n\n  /**\n   * Validates the HTTP status before interpreting the body. Unlike the engine, the mobile backend returns\n   * failure envelopes with non-2xx statuses (e.g. 404 for `PROFILE_NOT_FOUND`), so a non-2xx response with a\n   * failure envelope still throws the typed error; anything else is a transport-level error.\n   */\n  private checkResponseStatus(response: AxiosResponse<unknown>) {\n    if (response.status >= 200 && response.status < 300) {\n      return;\n    }\n    if (isMobileServerFailureResponse(response.data)) {\n      throw new MobileServerFailureError(response.data, response.status);\n    }\n    throw new Error(\n      `Unexpected response from mobile service: ${response.status} ${response.statusText}. Data: ${JSON.stringify(response.data)}`,\n    );\n  }\n\n  private checkServerStatus(response: AxiosResponse<unknown>) {\n    const { data } = response;\n\n    if (isMobileServerFailureResponse(data)) {\n      throw new MobileServerFailureError(data, response.status);\n    }\n    if (!isMobileServerSuccessResponse(data)) {\n      throw new Error(\n        `Unexpected response from mobile service: missing success envelope. Data: ${JSON.stringify(data)}`,\n      );\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoHA,IAAa,eAAb,MAA0B;CAIxB,YAAY,MAAwB;EAClC,KAAK,OAAO;EACZ,KAAK,gBAAgB,MAAA,QAAM,OAAO;GAChC,iBAAiB;GAEjB,sBAAsB;GACtB,UAAA,GAAA,eAAA,0BAAkC,KAAK,UAAU;EACnD,CAAC;CACH;;;;;;CAOA,gBACE,0BACA;EACA,KAAK,KAAK,2BAA2B,4BAA4B,KAAA;CACnE;;;;CASA,MAAM,wBACJ,QACqC;EACrC,MAAM,OAAgE;GACpE,MAAM;GACN,cAAc,OAAO;EACvB;EACA,MAAM,OAAO,MAAM,KAAK,YAAY,IAAI;EACxC,OAAO;GAAE,UAAU,KAAK;GAAU,WAAW,KAAK;EAAU;CAC9D;;;;;;;;;;;;;;;CAgBA,MAAM,YACJ,QACgC;EAChC,MAAM,OAAmD;GACvD,MAAM;GACN,aAAa,OAAO,YAAY,IAAIA,eAAAA,eAAe;GACnD,SAAS,OAAO,UACZC,oBAAAA,iCAAiC,OAAO,OAAO,IAC/C,KAAA;EACN;EAEA,QAAO,MADY,KAAK,YAAY,IAAI,GAC5B,SAAS,IAAIC,oBAAAA,sBAAsB;CACjD;;;;;;;;;;;;;;;;CAiBA,MAAM,aACJ,QAC+B;EAC/B,MAAM,OAAoD;GACxD,MAAM;GACN,GAAGC,oBAAAA,kCAAkC,MAAM;EAC7C;EAEA,OAAOC,oBAAAA,wBAAwB,MADZ,KAAK,YAAY,IAAI,CACL;CACrC;;;;;;CAOA,MAAM,aACJ,QAC+B;EAC/B,MAAM,OAAoD;GACxD,MAAM;GACN,GAAGD,oBAAAA,kCAAkC,MAAM;EAC7C;EAEA,OAAOC,oBAAAA,wBAAwB,MADZ,KAAK,YAAY,IAAI,CACL;CACrC;;;;;;;;;;;;;CAcA,MAAM,QAAQ,SAA8B,CAAC,GAA4B;EACvE,MAAM,OAA+C;GACnD,MAAM;GACN,kBAAkB,OAAO;GACzB,OAAO,OAAO;GACd,QAAQ,OAAO;EACjB;EAEA,OAAOC,oBAAAA,kBAAkB,MADN,KAAK,YAAY,IAAI,CACX;CAC/B;;;;;;;;;CAUA,MAAM,cACJ,SAAoC,CAAC,GACA;EACrC,MAAM,OAAuD;GAC3D,MAAM;GACN,iBAAiB,OAAO;GACxB,GAAGC,oBAAAA,sCAAsC,MAAM;GAC/C,GAAGC,oBAAAA,sCAAsC,MAAM;EACjD;EAEA,OAAOC,oBAAAA,8BAA8B,MADlB,KAAK,YAAY,IAAI,CACC;CAC3C;;;;;;;;CASA,MAAM,kBACJ,SAAwC,CAAC,GACA;EACzC,MAAM,OAA2D;GAC/D,MAAM;GACN,iBAAiB,OAAO;GACxB,GAAGF,oBAAAA,sCAAsC,MAAM;GAC/C,GAAGC,oBAAAA,sCAAsC,MAAM;EACjD;EAEA,OAAOE,oBAAAA,kCAAkC,MADtB,KAAK,YAAY,IAAI,CACK;CAC/C;;;;;;;CAQA,MAAM,eACJ,QACqC;EACrC,MAAM,OAAuD;GAC3D,MAAM;GACN,iBAAiB,OAAO;GACxB,GAAGH,oBAAAA,sCAAsC,MAAM;GAC/C,UAAA,GAAA,eAAA,iBAAyB,OAAO,MAAM;GACtC,cAAc,OAAO;EACvB;EAEA,OAAOE,oBAAAA,8BAA8B,MADlB,KAAK,YAAY,IAAI,CACC;CAC3C;;;;;;;CAQA,MAAM,eACJ,QAC+B;EAC/B,MAAM,OAAuD;GAC3D,MAAM;GACN,aAAA,GAAA,eAAA,iBAA4B,OAAO,UAAU;GAC7C,iBAAiB,OAAO;GACxB,GAAGF,oBAAAA,sCAAsC,MAAM;GAC/C,GAAGC,oBAAAA,sCAAsC,MAAM;EACjD;EAEA,OAAOG,oBAAAA,wBAAwB,MADZ,KAAK,YAAY,IAAI,CACL;CACrC;;;;;;;CAQA,MAAM,cACJ,QAC+B;EAC/B,MAAM,OAAsD;GAC1D,MAAM;GACN,YAAY,OAAO;GACnB,GAAGJ,oBAAAA,sCAAsC,MAAM;GAC/C,GAAGC,oBAAAA,sCAAsC,MAAM;EACjD;EAEA,OAAOG,oBAAAA,wBAAwB,MADZ,KAAK,YAAY,IAAI,CACL;CACrC;;;;;;;;CASA,MAAM,gBACJ,QAC+B;EAC/B,MAAM,OAAwD;GAC5D,MAAM;GACN,aAAa,OAAO;GACpB,GAAGJ,oBAAAA,sCAAsC,MAAM;GAC/C,GAAGC,oBAAAA,sCAAsC,MAAM;EACjD;EAEA,OAAOG,oBAAAA,wBAAwB,MADZ,KAAK,YAAY,IAAI,CACL;CACrC;;;;;;;;CASA,MAAM,YACJ,QACuC;EACvC,MAAM,OAAoD;GACxD,MAAM;GACN,SAAS,OAAO;GAChB,uBAAuB,OAAO;GAC9B,YAAY,OAAO;GACnB,GAAGH,oBAAAA,sCAAsC,MAAM;EACjD;EAEA,OAAOI,oBAAAA,gCAAgC,MADpB,KAAK,YAAY,IAAI,CACG;CAC7C;;;;;;;;;;;;CAaA,MAAM,eACJ,QACkC;EAClC,MAAM,OAAuD;GAC3D,MAAM;GACN,YAAY,OAAO;GACnB,kBAAkB,OAAO;GACzB,sBAAsB,OAAO;GAC7B,eAAe,OAAO;GACtB,mBAAmB,OAAO;GAC1B,aAAa,OAAO;GACpB,cAAc,OAAO;EACvB;EAEA,OAAOC,oBAAAA,2BAA2B,MADf,KAAK,YAAY,IAAI,CACF;CACxC;;;;;;;;;CAUA,MAAM,2BACJ,QACwC;EACxC,MAAM,OAAmE;GACvE,MAAM;GACN,YAAY,OAAO;EACrB;EAEA,OAAOC,oBAAAA,kCAAiC,MADrB,KAAK,YAAY,IAAI,GACK,WAAW;CAC1D;;;;;;;;;;;CAYA,MAAM,oBACJ,QACiC;EACjC,MAAM,OAA4D;GAChE,MAAM;GACN,YAAY,OAAO;EACrB;EAEA,OAAOC,oBAAAA,0BAA0B,MADd,KAAK,YAAY,IAAI,CACH;CACvC;;;;;;;;;;;CAgBA,MAAM,oBACJ,QACsC;EACtC,MAAM,OAAkE;GACtE,MAAM;GACN,YAAY,OAAO;EACrB;EACA,OAAO,KAAK,cAAc,IAAI;CAChC;;;;;;;;;;;;;CAcA,MAAM,8BACJ,QACsC;EACtC,MAAM,OAA+D;GACnE,MAAM;GACN,YAAY,OAAO;GACnB,aAAaC,oBAAAA,yCAAyC,OAAO,WAAW;EAC1E;EACA,OAAO,KAAK,cAAc,IAAI;CAChC;;;;;;;;;;;CAgBA,MAAM,YACJ,QACsC;EACtC,MAAM,gBAAgB,MAAM,KAAK,iBAAiB,gBAAgB,QAAQ,EACxE,cAAc,OAAO,YACvB,CAAC;EACD,OAAO,KAAK,QAAQ,aAAa;CACnC;;;;CAKA,MAAM,eACJ,QACsC;EACtC,MAAM,gBAAgB,MAAM,KAAK,iBAC/B,oBACA,QACA,EAAE,cAAc,OAAO,YAAY,CACrC;EACA,OAAO,KAAK,QAAQ,aAAa;CACnC;;;;;;;;;CAUA,MAAM,kBACJ,QACsC;EACtC,MAAM,gBAAgB,MAAM,KAAK,iBAC/B,uBACA,QACA;GACE,YAAY,OAAO;GACnB,UAAU,OAAO;GACjB,QAAQ,OAAO,UAAU;GACzB,aAAa,OAAO,cAAc;EACpC,CACF;EACA,OAAO,KAAK,QAAQ,aAAa;CACnC;;;;;;;;;;;;;;;;CAiBA,MAAM,UACJ,QACqC;EACrC,MAAM,gBAAgB,MAAM,KAAK,iBAAiB,cAAc,QAAQ;GACtE,aAAA,GAAA,eAAA,iBAA4B,OAAO,MAAM;GACzC,cAAc,OAAO;EACvB,CAAC;EAED,OAAOC,oBAAAA,8BAA8B,MADlB,KAAK,QAAQ,aAAa,CACJ;CAC3C;CAQA,MAAgB,iBACd,MACA,QACA,aAC0D;EAE1D,MAAM,eACJ,KAAK,KAAK,4BAA4B,KAAK,KAAK;EAElD,IAAI,gBAAgB,MAClB,MAAM,IAAIC,eAAAA,uBAAuB;EAGnC,MAAM,QAAQ;GACZ;GACA,GAAG;EACL;EACA,OAAOC,yCAAAA,yBAAyB;GAAE,GAAG;GAAQ;GAAc;EAAM,CAAC;CACpE;CAIA,MAAgB,YACd,MACoD;EACpD,MAAM,WAAW,MAAM,KAAK,cAAc,KACxC,GAAG,KAAK,KAAK,IAAI,gBACjB,IACF;EAEA,KAAK,oBAAoB,QAAQ;EACjC,KAAK,kBAAkB,QAAQ;EAG/B,OAAO,SAAS;CAClB;CAEA,MAAgB,cACd,MACsC;EACtC,MAAM,WAAW,MAAM,KAAK,cAAc,KACxC,GAAG,KAAK,KAAK,IAAI,kBACjB,IACF;EAEA,KAAK,oBAAoB,QAAQ;EACjC,KAAK,kBAAkB,QAAQ;EAG/B,OAAO,SAAS;CAClB;CAIA,MAAgB,QACd,MACgD;EAChD,MAAM,WAAW,MAAM,KAAK,cAAc,KACxC,GAAG,KAAK,KAAK,IAAI,WACjB,IACF;EAEA,KAAK,oBAAoB,QAAQ;EACjC,KAAK,kBAAkB,QAAQ;EAG/B,OAAO,SAAS;CAClB;;;;;;CAOA,oBAA4B,UAAkC;EAC5D,IAAI,SAAS,UAAU,OAAO,SAAS,SAAS,KAC9C;EAEF,IAAIC,mCAAAA,8BAA8B,SAAS,IAAI,GAC7C,MAAM,IAAIC,uCAAAA,yBAAyB,SAAS,MAAM,SAAS,MAAM;EAEnE,MAAM,IAAI,MACR,4CAA4C,SAAS,OAAO,GAAG,SAAS,WAAW,UAAU,KAAK,UAAU,SAAS,IAAI,GAC3H;CACF;CAEA,kBAA0B,UAAkC;EAC1D,MAAM,EAAE,SAAS;EAEjB,IAAID,mCAAAA,8BAA8B,IAAI,GACpC,MAAM,IAAIC,uCAAAA,yBAAyB,MAAM,SAAS,MAAM;EAE1D,IAAI,CAACC,mCAAAA,8BAA8B,IAAI,GACrC,MAAM,IAAI,MACR,4EAA4E,KAAK,UAAU,IAAI,GACjG;CAEJ;AACF"}

package/dist/MobileClient.cjs

@@ -1,4 +1,4 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-const require_MobileClient = require("./MobileClient-CEVEYnV1.cjs");
+const require_MobileClient = require("./MobileClient-BbTaqTzi.cjs");
 require("./signing/index.cjs");
 exports.MobileClient = require_MobileClient.MobileClient;

package/dist/MobileClient.d.cts

@@ -1,9 +1,9 @@
-import { A as MobileUsernameAvailability, C as MobileRegisteredWallet, D as MobileSignedRequestParams, E as MobileSetUsernameParams, O as MobileUnregisterExpoTokenParams, S as MobileRegisterExpoTokenParams, T as MobileSetPrivateModeParams, a as GetMobileNotificationPreferencesParams, c as GetMobileUsernameAvailabilityParams, i as GetMobileFollowingParams, k as MobileUpdateNotificationPreferencesParams, m as MobileFollowMutationResult, o as GetMobileProfilesParams, p as MobileFollowListPage, r as GetMobileFollowersParams, s as GetMobileRegisteredWalletParams, t as GetMobileFeedParams, u as MobileFeedPage, w as MobileSetFollowParams, x as MobilePublicProfile, y as MobileNotificationPreferences } from "./clientTypes-FQTkDfq3.cjs";
-import { a as MobileSignedRequest, i as MobileSignedInnerParams, n as MobileSignedInner, r as MobileSignedInnerByType } from "./types-D30luCKT.cjs";
-import { o as MobileServerPublicQueryRequestByType, s as MobileServerPublicQueryRequestType, t as MobileServerExecuteRequestType } from "./serverRequestTypes-BylecTUn.cjs";
-import { n as MobileServerSuccessResponse } from "./serverBaseTypes-BOuAdmuQ.cjs";
-import { i as MobileServerExecuteSuccessResponse, o as MobileServerPublicExecuteRequest } from "./serverExecuteTypes-DamHfu25.cjs";
-import { s as MobileServerPublicQuerySuccessResponse } from "./serverQueryTypes-CuVsrzGV.cjs";
+import { $ as MobileSocialFeedRankedPage, A as MobileRegisterExpoTokenParams, D as MobileNotificationPreferences, F as MobileSignedRequestParams, K as MobileSocialFeedItemResponse, M as MobileSetFollowParams, N as MobileSetPrivateModeParams, P as MobileSetUsernameParams, S as MobileFollowMutationResult, Y as MobileSocialFeedPage, a as GetMobileFollowersParams, c as GetMobileFriendsFeedParams, d as GetMobilePositionFeedParams, dt as MobileUsernameAvailability, f as GetMobileProfileFeedParams, g as GetMobileUsernameAvailabilityParams, h as GetMobileTopTradersFeedParams, j as MobileRegisteredWallet, k as MobilePublicProfile, l as GetMobileMarketFeedParams, lt as MobileUnregisterExpoTokenParams, m as GetMobileRegisteredWalletParams, n as GetMobileFeedParams, nt as MobileSocialFeedTopTradersPage, o as GetMobileFollowingParams, p as GetMobileProfilesParams, r as GetMobileFeedUpdatesParams, s as GetMobileForYouFeedParams, st as MobileSocialFeedUpdates, t as GetMobileFeedItemParams, u as GetMobileNotificationPreferencesParams, ut as MobileUpdateNotificationPreferencesParams, v as MobileFeedPage, x as MobileFollowListPage } from "./clientTypes-YF5d8bvg.cjs";
+import { a as MobileSignedRequest, i as MobileSignedInnerParams, n as MobileSignedInner, r as MobileSignedInnerByType } from "./types-CwpXP7xM.cjs";
+import { o as MobileServerPublicQueryRequestByType, s as MobileServerPublicQueryRequestType, t as MobileServerExecuteRequestType } from "./serverRequestTypes-XbnLUsXT.cjs";
+import { n as MobileServerSuccessResponse } from "./serverBaseTypes-CuMsGXgc.cjs";
+import { i as MobileServerExecuteSuccessResponse, o as MobileServerPublicExecuteRequest } from "./serverExecuteTypes-TPX0GCgv.cjs";
+import { s as MobileServerPublicQuerySuccessResponse } from "./serverQueryTypes-BZOoJBpb.cjs";
 import { WalletClientWithAccount } from "@nadohq/shared";
 import { AxiosInstance } from "axios";
 
@@ -30,8 +30,9 @@ interface MobileClientOpts {
   clientType?: string;
 }
 /**
- * Client for the Nado mobile service API: usernames, public profile lookups, the global trade feed, the
- * follower/following graph, privacy settings, and push notification device/preference management.
+ * Client for the Nado mobile service API: usernames, public profile lookups, the global trade feed,
+ * session-based social feeds, the follower/following graph, privacy settings, and push notification
+ * device/preference management.
  */
 declare class MobileClient {
   readonly opts: MobileClientOpts;
@@ -97,6 +98,72 @@ declare class MobileClient {
    * (discard the cursor and restart from the first page).
    */
   getFeed(params?: GetMobileFeedParams): Promise<MobileFeedPage>;
+  /**
+   * Fetches chronological For You recommendations with server-side author/thread constraints.
+   * Always public, with optional viewAs for relationship state. Preserve the session, viewAs, filters, and limit
+   * when paging, including through empty pages with a nextCursor. A 6312 error requires a refresh.
+   * @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.
+   */
+  getForYouFeed(params?: GetMobileForYouFeedParams): Promise<MobileSocialFeedRankedPage>;
+  /**
+   * Fetches chronological content by qualified Top Traders, with official account PnL badges.
+   * Always public; neither a wallet nor one-click trading setup is required.
+   * @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.
+   */
+  getTopTradersFeed(params?: GetMobileTopTradersFeedParams): Promise<MobileSocialFeedTopTradersPage>;
+  /**
+   * Fetches public content by authors followed by viewAs, without a signature. One-way following is sufficient.
+   * @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.
+   */
+  getFriendsFeed(params: GetMobileFriendsFeedParams): Promise<MobileSocialFeedRankedPage>;
+  /**
+   * Fetches an author's content visible to viewAs, including that account's own hidden content.
+   * @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.
+   */
+  getProfileFeed(params: GetMobileProfileFeedParams): Promise<MobileSocialFeedPage>;
+  /**
+   * Fetches published content for one market.
+   * @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.
+   */
+  getMarketFeed(params: GetMobileMarketFeedParams): Promise<MobileSocialFeedPage>;
+  /**
+   * Fetches already published content for a position lifecycle. This is not full position history
+   * and includes hidden content owned by viewAs under account_view. It does not recreate suppressed activity.
+   * @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.
+   */
+  getPositionFeed(params: GetMobilePositionFeedParams): Promise<MobileSocialFeedPage>;
+  /**
+   * 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.
+   * @returns The complete item and authorized reading session.
+   * @throws {MobileServerFailureError} On inaccessible content or session mismatch/expiry.
+   */
+  getFeedItem(params: GetMobileFeedItemParams): Promise<MobileSocialFeedItemResponse>;
+  /**
+   * Polls authorized visible items and positions without inserting or reordering list members.
+   * Increment requestSeq across the entire session, including viewport changes; never reset it for a new viewport.
+   * Accept only the current session and viewportRevision's latest requestSeq; discard stale patches and cursors together.
+   * Updates currently always return reset=true. Apply current author details, follow state, and badges even if the item version is unchanged.
+   * Null patches clear values;
+   * omitted fields leave them unchanged. Stop polling off-screen and refresh on error 6312.
+   * @param params - Session, visible IDs, update baseline, sequence, and matching read identity.
+   * @returns Item/position patches, revoked targets, and a new-content hint.
+   * @throws {MobileServerFailureError} On invalid or unauthorized targets, session expiry, or unavailable data.
+   */
+  getFeedUpdates(params: GetMobileFeedUpdatesParams): Promise<MobileSocialFeedUpdates>;
   /**
    * Fetches the push notification preferences of the wallet that owns the given Expo push token. Unsigned —
    * the token identifies the wallet on its own. Falls back to the backend's defaults if the wallet has never

package/dist/MobileClient.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"MobileClient.d.cts","names":[],"sources":["../src/src/MobileClient.ts"],"mappings":";;;;;;;;;;;;;UAwEiB,gBAAA;EAAgB;;;EAI/B,GAAA;EAIA;;;EAAA,YAAA,GAAe,uBAAA;EAQf;;AAAU;EAJV,wBAAA,GAA2B,uBAAuB;EAW3B;;;EAPvB,UAAA;AAAA;;;;;cAOW,YAAA;EAAA,SACF,IAAA,EAAM,gBAAA;EAAA,SACN,aAAA,EAAe,aAAA;cAEZ,IAAA,EAAM,gBAAA;EAoFP;;;;;EArEJ,eAAA,CACL,wBAAA,EAA0B,uBAAA;EAyG6B;;;EA7FnD,uBAAA,CACJ,MAAA,EAAQ,mCAAA,GACP,OAAA,CAAQ,0BAAA;EAgHR;;;;;;;;;;;;;;EAzFG,WAAA,CACJ,MAAA,EAAQ,uBAAA,GACP,OAAA,CAAQ,mBAAA;EAgMR;;;;;;;;;;;;;;;EArKG,YAAA,CACJ,MAAA,EAAQ,wBAAA,GACP,OAAA,CAAQ,oBAAA;EA0P2B;;;;;EA5OhC,YAAA,CACJ,MAAA,EAAQ,wBAAA,GACP,OAAA,CAAQ,oBAAA;EA4OR;;;;;;;;;;;;EAvNG,OAAA,CAAQ,MAAA,GAAQ,mBAAA,GAA2B,OAAA,CAAQ,cAAA;EA5H1C;;;;;;;;EA+IT,0BAAA,CACJ,MAAA,EAAQ,sCAAA,GACP,OAAA,CAAQ,6BAAA;EAlHL;;;;;;;;;;EAqIA,mBAAA,CACJ,MAAA,EAAQ,+BAAA,GACP,OAAA,CAAQ,sBAAA;EAhFD;;;;;;;;;;EAuGJ,mBAAA,CACJ,MAAA,EAAQ,+BAAA,GACP,OAAA,CAAQ,2BAAA;EAnEG;;;;;;;;;;;;EAuFR,6BAAA,CACJ,MAAA,EAAQ,yCAAA,GACP,OAAA,CAAQ,2BAAA;EAxBL;;;;;;;;;;EA+CA,WAAA,CACJ,MAAA,EAAQ,uBAAA,GACP,OAAA,CAAQ,2BAAA;EADD;;;EAWJ,cAAA,CACJ,MAAA,EAAQ,0BAAA,GACP,OAAA,CAAQ,2BAAA;EAFL;;;;;;;;EAmBA,iBAAA,CACJ,MAAA,EAAQ,6BAAA,GACP,OAAA,CAAQ,2BAAA;EAAA;;;;;;;;;;;;;;;EA6BL,SAAA,CACJ,MAAA,EAAQ,qBAAA,GACP,OAAA,CAAQ,0BAAA;EAAA,UAeK,gBAAA,WAA2B,iBAAA,SAAA,CACzC,IAAA,EAAM,CAAA,EACN,MAAA,EAAQ,yBAAA,EACR,WAAA,EAAa,uBAAA,CAAwB,CAAA,IACpC,OAAA,CAAQ,mBAAA,CAAoB,uBAAA,CAAwB,CAAA;EAAA,UAkBvC,WAAA,WAAsB,kCAAA,CAAA,CACpC,IAAA;IAAQ,IAAA,EAAM,CAAA;EAAA,IAAM,oCAAA,CAAqC,CAAA,IACxD,OAAA,CAAQ,sCAAA,CAAuC,CAAA;EAAA,UAalC,aAAA,CACd,IAAA,EAAM,gCAAA,GACL,OAAA,CAAQ,2BAAA;EAAA,UAeK,OAAA,WAAkB,8BAAA,CAAA,CAChC,IAAA,EAAM,mBAAA;IAAwB,IAAA,EAAM,CAAA;EAAA,IACnC,OAAA,CAAQ,kCAAA,CAAmC,CAAA;EAjC9B;;;;;EAAA,QAmDR,mBAAA;EAAA,QAYA,iBAAA;AAAA"}
+{"version":3,"file":"MobileClient.d.cts","names":[],"sources":["../src/src/MobileClient.ts"],"mappings":"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"}

package/dist/MobileClient.d.ts

@@ -1,9 +1,9 @@
-import { A as MobileUsernameAvailability, C as MobileRegisteredWallet, D as MobileSignedRequestParams, E as MobileSetUsernameParams, O as MobileUnregisterExpoTokenParams, S as MobileRegisterExpoTokenParams, T as MobileSetPrivateModeParams, a as GetMobileNotificationPreferencesParams, c as GetMobileUsernameAvailabilityParams, i as GetMobileFollowingParams, k as MobileUpdateNotificationPreferencesParams, m as MobileFollowMutationResult, o as GetMobileProfilesParams, p as MobileFollowListPage, r as GetMobileFollowersParams, s as GetMobileRegisteredWalletParams, t as GetMobileFeedParams, u as MobileFeedPage, w as MobileSetFollowParams, x as MobilePublicProfile, y as MobileNotificationPreferences } from "./clientTypes-FaHdWkNu.js";
-import { a as MobileSignedRequest, i as MobileSignedInnerParams, n as MobileSignedInner, r as MobileSignedInnerByType } from "./types-BG321aOe.js";
-import { o as MobileServerPublicQueryRequestByType, s as MobileServerPublicQueryRequestType, t as MobileServerExecuteRequestType } from "./serverRequestTypes-DcdmGfTu.js";
-import { n as MobileServerSuccessResponse } from "./serverBaseTypes-DDzfBA1a.js";
-import { i as MobileServerExecuteSuccessResponse, o as MobileServerPublicExecuteRequest } from "./serverExecuteTypes-DrxK2r7m.js";
-import { s as MobileServerPublicQuerySuccessResponse } from "./serverQueryTypes-C-_h9awN.js";
+import { $ as MobileSocialFeedRankedPage, A as MobileRegisterExpoTokenParams, D as MobileNotificationPreferences, F as MobileSignedRequestParams, K as MobileSocialFeedItemResponse, M as MobileSetFollowParams, N as MobileSetPrivateModeParams, P as MobileSetUsernameParams, S as MobileFollowMutationResult, Y as MobileSocialFeedPage, a as GetMobileFollowersParams, c as GetMobileFriendsFeedParams, d as GetMobilePositionFeedParams, dt as MobileUsernameAvailability, f as GetMobileProfileFeedParams, g as GetMobileUsernameAvailabilityParams, h as GetMobileTopTradersFeedParams, j as MobileRegisteredWallet, k as MobilePublicProfile, l as GetMobileMarketFeedParams, lt as MobileUnregisterExpoTokenParams, m as GetMobileRegisteredWalletParams, n as GetMobileFeedParams, nt as MobileSocialFeedTopTradersPage, o as GetMobileFollowingParams, p as GetMobileProfilesParams, r as GetMobileFeedUpdatesParams, s as GetMobileForYouFeedParams, st as MobileSocialFeedUpdates, t as GetMobileFeedItemParams, u as GetMobileNotificationPreferencesParams, ut as MobileUpdateNotificationPreferencesParams, v as MobileFeedPage, x as MobileFollowListPage } from "./clientTypes-P4LAjreY.js";
+import { a as MobileSignedRequest, i as MobileSignedInnerParams, n as MobileSignedInner, r as MobileSignedInnerByType } from "./types-B_4veFLc.js";
+import { o as MobileServerPublicQueryRequestByType, s as MobileServerPublicQueryRequestType, t as MobileServerExecuteRequestType } from "./serverRequestTypes-BULjZnnz.js";
+import { n as MobileServerSuccessResponse } from "./serverBaseTypes-DKCLDn3x.js";
+import { i as MobileServerExecuteSuccessResponse, o as MobileServerPublicExecuteRequest } from "./serverExecuteTypes-DKG1mqy1.js";
+import { s as MobileServerPublicQuerySuccessResponse } from "./serverQueryTypes-BLUe10AI.js";
 import { WalletClientWithAccount } from "@nadohq/shared";
 import { AxiosInstance } from "axios";
 
@@ -30,8 +30,9 @@ interface MobileClientOpts {
   clientType?: string;
 }
 /**
- * Client for the Nado mobile service API: usernames, public profile lookups, the global trade feed, the
- * follower/following graph, privacy settings, and push notification device/preference management.
+ * Client for the Nado mobile service API: usernames, public profile lookups, the global trade feed,
+ * session-based social feeds, the follower/following graph, privacy settings, and push notification
+ * device/preference management.
  */
 declare class MobileClient {
   readonly opts: MobileClientOpts;
@@ -97,6 +98,72 @@ declare class MobileClient {
    * (discard the cursor and restart from the first page).
    */
   getFeed(params?: GetMobileFeedParams): Promise<MobileFeedPage>;
+  /**
+   * Fetches chronological For You recommendations with server-side author/thread constraints.
+   * Always public, with optional viewAs for relationship state. Preserve the session, viewAs, filters, and limit
+   * when paging, including through empty pages with a nextCursor. A 6312 error requires a refresh.
+   * @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.
+   */
+  getForYouFeed(params?: GetMobileForYouFeedParams): Promise<MobileSocialFeedRankedPage>;
+  /**
+   * Fetches chronological content by qualified Top Traders, with official account PnL badges.
+   * Always public; neither a wallet nor one-click trading setup is required.
+   * @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.
+   */
+  getTopTradersFeed(params?: GetMobileTopTradersFeedParams): Promise<MobileSocialFeedTopTradersPage>;
+  /**
+   * Fetches public content by authors followed by viewAs, without a signature. One-way following is sufficient.
+   * @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.
+   */
+  getFriendsFeed(params: GetMobileFriendsFeedParams): Promise<MobileSocialFeedRankedPage>;
+  /**
+   * Fetches an author's content visible to viewAs, including that account's own hidden content.
+   * @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.
+   */
+  getProfileFeed(params: GetMobileProfileFeedParams): Promise<MobileSocialFeedPage>;
+  /**
+   * Fetches published content for one market.
+   * @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.
+   */
+  getMarketFeed(params: GetMobileMarketFeedParams): Promise<MobileSocialFeedPage>;
+  /**
+   * Fetches already published content for a position lifecycle. This is not full position history
+   * and includes hidden content owned by viewAs under account_view. It does not recreate suppressed activity.
+   * @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.
+   */
+  getPositionFeed(params: GetMobilePositionFeedParams): Promise<MobileSocialFeedPage>;
+  /**
+   * 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.
+   * @returns The complete item and authorized reading session.
+   * @throws {MobileServerFailureError} On inaccessible content or session mismatch/expiry.
+   */
+  getFeedItem(params: GetMobileFeedItemParams): Promise<MobileSocialFeedItemResponse>;
+  /**
+   * Polls authorized visible items and positions without inserting or reordering list members.
+   * Increment requestSeq across the entire session, including viewport changes; never reset it for a new viewport.
+   * Accept only the current session and viewportRevision's latest requestSeq; discard stale patches and cursors together.
+   * Updates currently always return reset=true. Apply current author details, follow state, and badges even if the item version is unchanged.
+   * Null patches clear values;
+   * omitted fields leave them unchanged. Stop polling off-screen and refresh on error 6312.
+   * @param params - Session, visible IDs, update baseline, sequence, and matching read identity.
+   * @returns Item/position patches, revoked targets, and a new-content hint.
+   * @throws {MobileServerFailureError} On invalid or unauthorized targets, session expiry, or unavailable data.
+   */
+  getFeedUpdates(params: GetMobileFeedUpdatesParams): Promise<MobileSocialFeedUpdates>;
   /**
    * Fetches the push notification preferences of the wallet that owns the given Expo push token. Unsigned —
    * the token identifies the wallet on its own. Falls back to the backend's defaults if the wallet has never

package/dist/MobileClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MobileClient.d.ts","names":[],"sources":["../src/src/MobileClient.ts"],"mappings":";;;;;;;;;;;;;UAwEiB,gBAAA;EAAgB;;;EAI/B,GAAA;EAIA;;;EAAA,YAAA,GAAe,uBAAA;EAQf;;AAAU;EAJV,wBAAA,GAA2B,uBAAuB;EAW3B;;;EAPvB,UAAA;AAAA;;;;;cAOW,YAAA;EAAA,SACF,IAAA,EAAM,gBAAA;EAAA,SACN,aAAA,EAAe,aAAA;cAEZ,IAAA,EAAM,gBAAA;EAoFP;;;;;EArEJ,eAAA,CACL,wBAAA,EAA0B,uBAAA;EAyG6B;;;EA7FnD,uBAAA,CACJ,MAAA,EAAQ,mCAAA,GACP,OAAA,CAAQ,0BAAA;EAgHR;;;;;;;;;;;;;;EAzFG,WAAA,CACJ,MAAA,EAAQ,uBAAA,GACP,OAAA,CAAQ,mBAAA;EAgMR;;;;;;;;;;;;;;;EArKG,YAAA,CACJ,MAAA,EAAQ,wBAAA,GACP,OAAA,CAAQ,oBAAA;EA0P2B;;;;;EA5OhC,YAAA,CACJ,MAAA,EAAQ,wBAAA,GACP,OAAA,CAAQ,oBAAA;EA4OR;;;;;;;;;;;;EAvNG,OAAA,CAAQ,MAAA,GAAQ,mBAAA,GAA2B,OAAA,CAAQ,cAAA;EA5H1C;;;;;;;;EA+IT,0BAAA,CACJ,MAAA,EAAQ,sCAAA,GACP,OAAA,CAAQ,6BAAA;EAlHL;;;;;;;;;;EAqIA,mBAAA,CACJ,MAAA,EAAQ,+BAAA,GACP,OAAA,CAAQ,sBAAA;EAhFD;;;;;;;;;;EAuGJ,mBAAA,CACJ,MAAA,EAAQ,+BAAA,GACP,OAAA,CAAQ,2BAAA;EAnEG;;;;;;;;;;;;EAuFR,6BAAA,CACJ,MAAA,EAAQ,yCAAA,GACP,OAAA,CAAQ,2BAAA;EAxBL;;;;;;;;;;EA+CA,WAAA,CACJ,MAAA,EAAQ,uBAAA,GACP,OAAA,CAAQ,2BAAA;EADD;;;EAWJ,cAAA,CACJ,MAAA,EAAQ,0BAAA,GACP,OAAA,CAAQ,2BAAA;EAFL;;;;;;;;EAmBA,iBAAA,CACJ,MAAA,EAAQ,6BAAA,GACP,OAAA,CAAQ,2BAAA;EAAA;;;;;;;;;;;;;;;EA6BL,SAAA,CACJ,MAAA,EAAQ,qBAAA,GACP,OAAA,CAAQ,0BAAA;EAAA,UAeK,gBAAA,WAA2B,iBAAA,SAAA,CACzC,IAAA,EAAM,CAAA,EACN,MAAA,EAAQ,yBAAA,EACR,WAAA,EAAa,uBAAA,CAAwB,CAAA,IACpC,OAAA,CAAQ,mBAAA,CAAoB,uBAAA,CAAwB,CAAA;EAAA,UAkBvC,WAAA,WAAsB,kCAAA,CAAA,CACpC,IAAA;IAAQ,IAAA,EAAM,CAAA;EAAA,IAAM,oCAAA,CAAqC,CAAA,IACxD,OAAA,CAAQ,sCAAA,CAAuC,CAAA;EAAA,UAalC,aAAA,CACd,IAAA,EAAM,gCAAA,GACL,OAAA,CAAQ,2BAAA;EAAA,UAeK,OAAA,WAAkB,8BAAA,CAAA,CAChC,IAAA,EAAM,mBAAA;IAAwB,IAAA,EAAM,CAAA;EAAA,IACnC,OAAA,CAAQ,kCAAA,CAAmC,CAAA;EAjC9B;;;;;EAAA,QAmDR,mBAAA;EAAA,QAYA,iBAAA;AAAA"}
+{"version":3,"file":"MobileClient.d.ts","names":[],"sources":["../src/src/MobileClient.ts"],"mappings":"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"}