@nadohq/mobile-client 0.65.0 → 0.67.0

package/dist/MobileClient.d.ts

@@ -1,9 +1,6 @@
-import { $ as MobileSetFollowParams, At as MobileSocialFeedLikeResult, C as MobileAvatarPreset, D as MobileCreateFeedCommentParams, E as MobileCreateAvatarUploadParams, Et as MobileSocialFeedItem, F as MobileFollowListPage, G as MobilePublicProfile, Gt as MobileSocialFeedPresence, H as MobilePositionPresenceParams, Ht as MobileSocialFeedPositionResolutionResult, I as MobileFollowMutationResult, J as MobileRegisteredWallet, K as MobileRecordFeedViewsParams, N as MobileFollowBatchResultItem, O as MobileCreateFeedPostParams, Pt as MobileSocialFeedPage, Q as MobileSetFollowBatchParams, Qt as MobileSocialFeedTopTradersPage, Rt as MobileSocialFeedPositionChart, S as GetMobileUsernameAvailabilityParams, T as MobileAvatarUpload, U as MobileProfileSearchPage, Ut as MobileSocialFeedPositionsPage, V as MobileNotificationPreferences, X as MobileSetBioParams, Y as MobileSetAvatarParams, Z as MobileSetFeedLikeParams, _ as GetMobileProfileFeedParams, a as GetMobileFeedUpdatesParams, an as MobileSocialFeedUpdates, at as MobileSocialFeedActionResolutionResult, b as GetMobileSelfFeedPositionsParams, bt as MobileSocialFeedDrawingResult, c as GetMobileFollowingParams, cn as MobileSocialFeedWatchers, d as GetMobileMarketFeedParams, dn as MobileUsernameAvailability, et as MobileSetPrivateModeParams, f as GetMobileNotificationPreferencesParams, g as GetMobilePositionWatchersParams, h as GetMobilePositionHistoryParams, hn as SearchMobileProfilesParams, ht as MobileSocialFeedCommentsPage, i as GetMobileFeedParams, j as MobileFeedPage, k as MobileFeedChartDrawingParams, kt as MobileSocialFeedItemResponse, l as GetMobileForYouFeedParams, ln as MobileUnregisterExpoTokenParams, m as GetMobilePositionFeedParams, mn as ResolveMobileFeedPositionParams, mt as MobileSocialFeedCommentResult, n as GetMobileFeedCommentsParams, nt as MobileSignedRequestParams, p as GetMobilePositionChartParams, pn as ResolveMobileFeedActionParams, q as MobileRegisterExpoTokenParams, qt as MobileSocialFeedRankedPage, r as GetMobileFeedItemParams, s as GetMobileFollowersParams, sn as MobileSocialFeedViewsResult, t as GetMobileFeedChartDrawingParams, tt as MobileSetUsernameParams, u as GetMobileFriendsFeedParams, un as MobileUpdateNotificationPreferencesParams, v as GetMobileProfilesParams, x as GetMobileTopTradersFeedParams, y as GetMobileRegisteredWalletParams, yt as MobileSocialFeedDrawingMutationResult, zt as MobileSocialFeedPositionHistory } from "./clientTypes-C9dJufxk.js";
-import { a as MobileSignedRequest, i as MobileSignedInnerParams, n as MobileSignedInner, r as MobileSignedInnerByType } from "./types-DoJuq0Ij.js";
-import { a as MobileServerPublicExecuteRequestType, i as MobileServerPublicExecuteRequestByType, o as MobileServerPublicQueryRequestByType, s as MobileServerPublicQueryRequestType, t as MobileServerExecuteRequestType } from "./serverRequestTypes-DZoOhV2o.js";
-import { n as MobileServerSuccessResponse } from "./serverBaseTypes-DnLzsdm-.js";
-import { a as MobileServerExecuteSuccessResponse, d as MobileServerPublicExecuteSuccessResponse } from "./serverExecuteTypes-BwWGspOg.js";
-import { c as MobileServerPublicQuerySuccessResponse } from "./serverQueryTypes-CJcjLB7n.js";
+import { $t as MobileSocialFeedItem, A as GetMobileUsernameAvailabilityParams, Bn as MobileUpdateNotificationSubscriptionsParams, C as GetMobilePositionThoughtsParams, Ct as MobileSetPrivateModeParams, D as GetMobileRegisteredWalletParams, Dn as MobileSocialFeedTopTradersPage, E as GetMobileProfilesParams, F as MobileCreateFeedCommentParams, Fn as MobileSocialFeedUploadedImage, G as MobileFollowListPage, Gn as SearchMobileProfilesParams, I as MobileCreateFeedImageUploadParams, In as MobileSocialFeedWatchers, K as MobileFollowMutationResult, L as MobileCreateFeedPostParams, Ln as MobileUnregisterExpoTokenParams, N as MobileAvatarUpload, O as GetMobileSelfFeedPositionsParams, Ot as MobileSocialFeedActionResolutionResult, P as MobileCreateAvatarUploadParams, Pn as MobileSocialFeedUpdates, Q as MobileNotificationInboxV2, R as MobileFeedChartDrawingParams, Rn as MobileUpdateNotificationPreferencesParams, Rt as MobileSocialFeedCommentResult, S as GetMobilePositionHistoryParams, Sn as MobileSocialFeedRankedPage, St as MobileSetFollowParams, T as GetMobileProfileFeedParams, Tt as MobileSignedRequestParams, U as MobileFollowBatchResultItem, Un as ResolveMobileFeedActionParams, Ut as MobileSocialFeedDrawingMutationResult, V as MobileFeedPage, Vn as MobileUsernameAvailability, Wn as ResolveMobileFeedPositionParams, Wt as MobileSocialFeedDrawingResult, _ as GetMobileNotificationSettingsV2Params, _n as MobileSocialFeedPositionThoughtsPage, _t as MobileRegisteredWallet, a as GetMobileFeedItemParams, at as MobileNotificationSettingsV2, b as GetMobilePositionFeedParams, bn as MobileSocialFeedPresence, bt as MobileSetFeedLikeParams, ct as MobilePositionPresenceParams, d as GetMobileForYouFeedParams, dn as MobileSocialFeedPositionChart, f as GetMobileFriendsFeedParams, fn as MobileSocialFeedPositionHistory, ft as MobilePublicProfile, g as GetMobileNotificationRegistrationV2Params, gt as MobileRegisterExpoTokenV2Params, h as GetMobileNotificationPreferencesParams, hn as MobileSocialFeedPositionResolutionResult, ht as MobileRegisterExpoTokenParams, i as GetMobileFeedImageRequestParams, j as MobileAvatarPreset, k as GetMobileTopTradersFeedParams, l as GetMobileFollowersParams, m as GetMobileNotificationInboxV2Params, mt as MobileRecordProductEventsParams, n as GetMobileFeedCommentsParams, nn as MobileSocialFeedItemResponse, nt as MobileNotificationRegistrationV2, o as GetMobileFeedParams, ot as MobileNotificationSubscriptions, p as GetMobileMarketFeedParams, pt as MobileRecordFeedViewsParams, r as GetMobileFeedImageBytesParams, rn as MobileSocialFeedLikeResult, s as GetMobileFeedUpdatesParams, sn as MobileSocialFeedPage, t as GetMobileFeedChartDrawingParams, tt as MobileNotificationPreferences, u as GetMobileFollowingParams, ut as MobileProfileSearchPage, v as GetMobileNotificationSubscriptionsParams, vn as MobileSocialFeedPositionsPage, vt as MobileSetAvatarParams, w as GetMobilePositionWatchersParams, wt as MobileSetUsernameParams, x as GetMobilePositionHistoryAllParams, xt as MobileSetFollowBatchParams, y as GetMobilePositionChartParams, yt as MobileSetBioParams, z as MobileFeedImageRequest, zn as MobileUpdateNotificationSettingsV2Params, zt as MobileSocialFeedCommentsPage } from "./clientTypes-XRI41VdC.js";
+import { P as MobileServerPublicQuerySuccessResponse, R as MobileServerSignedQuerySuccessResponse, a as MobileSignedRequest, d as MobileServerPublicExecuteRequestType, f as MobileServerPublicQueryRequestByType, i as MobileSignedInnerParams, n as MobileSignedInner, nt as MobileServerSuccessResponse, o as MobileServerExecuteRequestType, p as MobileServerPublicQueryRequestType, r as MobileSignedInnerByType, u as MobileServerPublicExecuteRequestByType, v as MobileServerSignedQueryRequestType } from "./types-CByl_NyJ.js";
+import { a as MobileServerExecuteSuccessResponse, d as MobileServerPublicExecuteSuccessResponse } from "./serverExecuteTypes-usJ6HMJv.js";
 import { WalletClientWithAccount } from "@nadohq/shared";
 import { AxiosInstance } from "axios";
 
@@ -176,6 +173,7 @@ declare class MobileClient {
   /**
    * Reads one item visible to viewAs, including that account's own hidden content.
    * Creates an item session directly when sessionId is omitted.
+   * Reading does not increment views; use {@link recordFeedViews} independently when reporting views.
    * @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.
@@ -201,6 +199,7 @@ declare class MobileClient {
    *
    * @throws {MobileServerFailureError} With error code `INVALID_EXPO_TOKEN` if the token is malformed, or is
    * not currently registered to a wallet.
+   * @deprecated Use {@link getNotificationSettingsV2} instead.
    */
   getNotificationPreferences(params: GetMobileNotificationPreferencesParams): Promise<MobileNotificationPreferences>;
   /**
@@ -249,11 +248,35 @@ declare class MobileClient {
    */
   getFeedChartDrawing(params: GetMobileFeedChartDrawingParams): Promise<MobileSocialFeedDrawingResult>;
   /**
-   * Reads a comment thread with an optional anchor and bidirectional pagination.
+   * Resolves a backend feed image path against this client's mobile gateway URL.
+   * @param path - Backend path from image metadata, rooted at /v1/mobile or the mobile service root.
+   * @returns An absolute URL suitable for authenticated fetches.
+   */
+  resolveFeedImageUrl(path: string): string;
+  /**
+   * Prepares a protected image request for native image components without downloading or encoding bytes.
+   * Does not increment view counts.
+   * @param params - Image path from metadata plus the original session credentials.
+   * @returns Absolute URL and headers; pass them as the image source's URI and headers.
+   */
+  getFeedImageRequest(params: GetMobileFeedImageRequestParams): MobileFeedImageRequest;
+  /**
+   * Fetches protected feed image bytes using the reading session that fully delivered the parent item.
+   * Does not increment view counts.
+   * @param params - Image path from metadata plus the original session credentials.
+   * @returns Raw image bytes.
+   * @throws {MobileServerFailureError} On session, permission, or availability errors.
+   */
+  getFeedImageBytes(params: GetMobileFeedImageBytesParams): Promise<Uint8Array>;
+  /**
+   * Reads top-level comment groups with all readable descendants and bidirectional pagination.
+   * The limit counts groups, not descendants. Groups are newest first; their flat replies are oldest first,
+   * with depth then UUID breaking timestamp ties. An anchor at any depth selects its top-level group.
+   * Preview cursors open the first complete group page in the same snapshot; do not prepend preview items.
    * Independent reads create a public-only session; reused sessions retain their original scope.
-   * @param params - Root item, optional anchor or cursor (mutually exclusive), page size, and read perspective.
+   * @param params - Root item, optional anchor or cursor (mutually exclusive), group limit, and read perspective.
    * Paging requires the original session and viewer token.
-   * @returns Replies, total count, forward and backward cursors, the anchor, and the actual reading session.
+   * @returns Complete comment groups, whole-thread reply and top-level counts, cursors, anchor, and session.
    * @throws {MobileServerFailureError} On invalid parameters, session mismatch or expiry, inaccessible content,
    * or unavailable data. Restart pagination with a new session after expiry; do not reuse the old cursor.
    */
@@ -265,10 +288,35 @@ declare class MobileClient {
    * the original position session and viewer token, not a feed session.
    * @returns Position metrics, ordered action/take history, summary, trading hints, cursor, and reading session.
    * @throws {MobileServerFailureError} On invalid parameters, session mismatch or expiry, inaccessible content,
-   * or unavailable source data. Restart with a new position session after expiry.
+   * unavailable source data, or SOCIAL_FEED_HISTORY_TOO_LARGE when the initial directory exceeds capacity.
+   * Restart with a new position session after expiry.
    * @throws {MobileUnsupportedFeedItemError} If a timeline entry or take has an unsupported kind.
    */
   getPositionHistory(params: GetMobilePositionHistoryParams): Promise<MobileSocialFeedPositionHistory>;
+  /**
+   * Reads the most recent 500 lifecycle actions, without authored text, drawings, or images.
+   * Creates a new position session on every call. A null nextCursor means no pagination, not complete
+   * history; use getPositionHistory with a fresh session for the full lifecycle. takeCount is always zero.
+   * @param params - Position and read perspective; an existing viewer token may be reused.
+   * @returns Position metrics, owner, recent actions, response-scope counts, trading hints, and a new session.
+   * @throws {MobileServerFailureError} On invalid parameters, inaccessible content, unavailable data,
+   * or SOCIAL_FEED_HISTORY_TOO_LARGE when the initial directory exceeds capacity.
+   * @throws {MobileUnsupportedFeedItemError} If a timeline entry or take has an unsupported kind.
+   */
+  getPositionHistoryAll(params: GetMobilePositionHistoryAllParams): Promise<MobileSocialFeedPositionHistory>;
+  /**
+   * Reads published position thoughts with both nonblank text and a saved drawing, without signing.
+   * Keeps descending drawing creation time / item UUID order; editing a drawing does not move the item.
+   * Continue until nextCursor is null, even after an empty page. There is no 500-item total cap.
+   * Keep positionId, limit, sessionId, and viewerToken unchanged when paging; omitted viewAs inherits
+   * the session. History/feed sessions cannot be substituted. Refresh to include newly eligible content.
+   * @param params - Position, page size, read perspective, and original thoughts-session credentials for paging.
+   * @returns Complete thoughts and drawings in server order, a continuation cursor, and the reading session.
+   * @throws {MobileServerFailureError} On invalid parameters, session mismatch/expiry, inaccessible content,
+   * unavailable source data, or SOCIAL_FEED_HISTORY_TOO_LARGE when the initial directory exceeds capacity.
+   * @throws {MobileUnsupportedFeedItemError} If an item is not a post or trade card.
+   */
+  getPositionThoughts(params: GetMobilePositionThoughtsParams): Promise<MobileSocialFeedPositionThoughtsPage>;
   /**
    * Reads candles and action markers without creating a reading session.
    * Preserve the original range, interval, and read perspective when paging with nextBeforeMs.
@@ -286,6 +334,38 @@ declare class MobileClient {
    * @throws {MobileServerFailureError} On invalid parameters, an unavailable position, or unavailable source data.
    */
   getPositionWatchers(params: GetMobilePositionWatchersParams): Promise<MobileSocialFeedWatchers>;
+  /**
+   * Reads the token's latest registration generation and saved capabilities, including legacy v1 registrations.
+   * @param params - Active Expo token credential; no wallet signature is needed.
+   * @returns Saved generation as an opaque string and the complete capability declaration.
+   * @throws {MobileServerFailureError} If the token is invalid or inactive (`INVALID_EXPO_TOKEN`).
+   */
+  getNotificationRegistrationV2(params: GetMobileNotificationRegistrationV2Params): Promise<MobileNotificationRegistrationV2>;
+  /**
+   * Reads the wallet's full v2 settings document, including legacy preference mappings.
+   * @param params - Active Expo token credential. Before displaying settings, compare the wallet returned by
+   *   {@link MobileClient.getRegisteredWallet} with the connected wallet (case-insensitively).
+   * @returns CamelCase settings with the current settings revision.
+   * @throws {MobileServerFailureError} If the token is invalid or inactive (`INVALID_EXPO_TOKEN`).
+   */
+  getNotificationSettingsV2(params: GetMobileNotificationSettingsV2Params): Promise<MobileNotificationSettingsV2>;
+  /**
+   * Reads wallet market subscriptions and the signing Identity's enabled trader bells.
+   * @param params - Wallet authentication context; no Expo token is needed.
+   * @returns Subscriptions, import state, and the independent subscription revision.
+   * @throws {WalletNotProvidedError} If neither a linked signer nor a default wallet is configured.
+   * @throws {MobileServerFailureError} If authentication or the query fails.
+   */
+  getNotificationSubscriptions(params: GetMobileNotificationSubscriptionsParams): Promise<MobileNotificationSubscriptions>;
+  /**
+   * Reads private accepted notification intents, not delivery receipts or read states.
+   * @param params - Wallet authentication and optional cursor/page size (1-50, default 20).
+   * @returns A camelCase page; discard cached pages and cursors when switching wallets.
+   * @throws {WalletNotProvidedError} If neither a linked signer nor a default wallet is configured.
+   * @throws {MobileServerFailureError} If authentication or pagination validation fails.
+   * @throws {MobileUnsupportedNotificationRouteError} If a notification has an unsupported route name.
+   */
+  getNotificationInboxV2(params: GetMobileNotificationInboxV2Params): Promise<MobileNotificationInboxV2>;
   /**
    * Unregisters an Expo push token, stopping delivery to that device. Unsigned, so it still works at logout
    * when a wallet signature may no longer be obtainable. Idempotent: unregistering an inactive or unknown
@@ -308,18 +388,28 @@ declare class MobileClient {
    *
    * @throws {MobileServerFailureError} With error code `INVALID_PREFERENCES` if those rules are violated, or
    * `INVALID_EXPO_TOKEN` if the token is malformed or is not currently registered to a wallet.
+   * @deprecated Use {@link updateNotificationSettingsV2} instead.
    */
   updateNotificationPreferences(params: MobileUpdateNotificationPreferencesParams): Promise<MobileServerSuccessResponse>;
   /**
-   * Reports qualified exposures without signing. Ordinary reads and root previews do not count as exposures.
-   * The caller must satisfy the session's viewTracking requirements before reporting an item.
-   * @param params - Original reading session and viewer token, plus one to fifty fully delivered, readable,
-   * interactive item IDs. The service deduplicates repeated exposures.
-   * @returns Separate lists of newly accepted and already-counted item IDs.
-   * @throws {MobileServerFailureError} On invalid parameters, session mismatch or expiry, or any ineligible item.
-   * A rejected batch is not partially counted. Acquire a new session after expiry and re-evaluate exposure eligibility.
+   * Replaces all v2 settings fields using optimistic concurrency; legacy overlapping preferences are synced.
+   * @param params - Active Expo token, latest settings revision, and complete replacement settings.
+   * @returns The saved settings document with its incremented revision.
+   * @throws {MobileServerFailureError} On invalid token/settings or revision conflict (`NOTIFICATION_REVISION_CONFLICT`). Re-read and
+   * merge only the user's current change before retrying; never blindly replay a stale document.
    */
-  recordFeedViews(params: MobileRecordFeedViewsParams): Promise<MobileSocialFeedViewsResult>;
+  updateNotificationSettingsV2(params: MobileUpdateNotificationSettingsV2Params): Promise<MobileNotificationSettingsV2>;
+  /**
+   * Reports views for posts, trade cards, comments, and replies without signing or a reading session.
+   * Duplicate IDs count once within a request; another request increments them again. Only supplied IDs
+   * count, not their parents. Missing, deleted, unpublished, excluded, or unsupported targets are skipped.
+   * A successful response does not identify skipped items. Read interaction.viewCount for current counts.
+   * This operation is not idempotent: retrying an uncertain result may count twice. No automatic retry is made.
+   * @param params - itemIds: 1–50 canonical lowercase item UUIDs, including any same-request duplicates.
+   * @returns Only the success status, even when every target was skipped.
+   * @throws {MobileServerFailureError} On invalid parameters, disabled writes, rate limiting, or unavailable data.
+   */
+  recordFeedViews(params: MobileRecordFeedViewsParams): Promise<MobileServerSuccessResponse>;
   /**
    * Registers, renews, or leaves a page lease without signing or authenticating the displayed account.
    * Omitting watcherSubaccount preserves its value; null clears it. This operation does not record item views.
@@ -381,13 +471,41 @@ declare class MobileClient {
   setPrivateMode(params: MobileSetPrivateModeParams): Promise<MobileServerSuccessResponse>;
   /**
    * Registers an Expo push token for the wallet, transferring active ownership of the token if another
-   * wallet had registered it. Idempotent per `(wallet, token)`.
+   * wallet had registered it. Each registration advances its generation and cancels old pending deliveries.
+   * This legacy method replaces capabilities with v1; use registerExpoTokenV2 consistently after upgrading.
    *
    * @throws {MobileServerFailureError} With error code `INVALID_EXPO_TOKEN` if the token is not a valid Expo
    * push token, or `INVALID_DEVICE_METADATA` if `locale` (max 35 chars) or `appVersion` (max 64 chars) is
    * too long.
+   * @deprecated Use {@link registerExpoTokenV2} instead.
    */
   registerExpoToken(params: MobileRegisterExpoTokenParams): Promise<MobileServerSuccessResponse>;
+  /**
+   * Registers a device with its actual v2 capabilities; do not use repeated registration as a heartbeat.
+   * @param params - Wallet authentication, Expo token, metadata, and supported notification types/routes.
+   * @returns Success only; query registration separately for its new generation.
+   * @throws {WalletNotProvidedError} If neither a linked signer nor a default wallet is configured.
+   * @throws {MobileServerFailureError} On `INVALID_EXPO_TOKEN`, `INVALID_DEVICE_METADATA`,
+   * `NOTIFICATION_DEVICE_LIMIT` when the wallet already has 32 active devices, or authentication errors.
+   */
+  registerExpoTokenV2(params: MobileRegisterExpoTokenV2Params): Promise<MobileServerSuccessResponse>;
+  /**
+   * Applies exactly one bell, market, or one-time favorites-import operation.
+   * @param params - Wallet authentication and subscription update with the latest subscription revision.
+   * @returns Success only; re-query subscriptions for the new revision even after a repeated ON/OFF.
+   * @throws {WalletNotProvidedError} If neither a linked signer nor a default wallet is configured.
+   * @throws {MobileServerFailureError} On `NOTIFICATION_REVISION_CONFLICT`, `INVALID_NOTIFICATION_REQUEST`, or
+   * `INVALID_IDENTITY_TARGET`.
+   */
+  updateNotificationSubscriptions(params: MobileUpdateNotificationSubscriptionsParams): Promise<MobileServerSuccessResponse>;
+  /**
+   * Atomically records 1-50 analytics events after the user has consented to analytics.
+   * @param params - Wallet authentication and events with stable UUIDs and actual millisecond timestamps.
+   * @returns Success only; reuse event IDs on retries. Notification clicks do not mark an inbox item as read.
+   * @throws {WalletNotProvidedError} If neither a linked signer nor a default wallet is configured.
+   * @throws {MobileServerFailureError} If any event, timestamp, batch size, or notification ownership is invalid.
+   */
+  recordProductEvents(params: MobileRecordProductEventsParams): Promise<MobileServerSuccessResponse>;
   /**
    * Sets whether the signing subaccount follows a Profile. Both directions are idempotent: following again
    * keeps the original relationship creation time, so it does not move the account in recency order, and
@@ -435,6 +553,31 @@ declare class MobileClient {
    * @throws {MobileUnsupportedFeedItemError} If the service returns an unsupported item kind.
    */
   createFeedPost(params: MobileCreateFeedPostParams): Promise<MobileSocialFeedItem>;
+  /**
+   * Uploads one static JPEG/PNG for a later {@link createFeedPost} via multipart execute.
+   * The whole HTTP request must stay within 2 MiB including signature overhead; upload one file per call
+   * and bind up to nine ready IDs at publication. There is no complete/PUT step — success means ready.
+   * @param params - Author subaccount and signing options, plus the original file bytes.
+   * @returns Ready image metadata, including original and thumbnail paths.
+   * @throws {WalletNotProvidedError} If neither a linked signer nor a default wallet is configured.
+   * @throws {RangeError} If the complete multipart request exceeds {@link MOBILE_FEED_IMAGE_MAX_REQUEST_BYTES}.
+   * @throws {MobileServerFailureError} On authentication, format/size/hash errors (`INVALID_SOCIAL_FEED_IMAGE`),
+   * or when publishing is disabled (`SERVICE_UNAVAILABLE`), or image storage is unavailable
+   * (`SOCIAL_FEED_DATA_UNAVAILABLE`, 6320, HTTP 503).
+   */
+  createFeedPostImageUpload(params: MobileCreateFeedImageUploadParams): Promise<MobileSocialFeedUploadedImage>;
+  /**
+   * Uploads one static JPEG/PNG for a later {@link createFeedComment} via multipart execute.
+   * Same size and readiness rules as {@link createFeedPostImageUpload}; comment text remains required.
+   * @param params - Author subaccount and signing options, plus the original file bytes.
+   * @returns Ready image metadata, including original and thumbnail paths.
+   * @throws {WalletNotProvidedError} If neither a linked signer nor a default wallet is configured.
+   * @throws {RangeError} If the complete multipart request exceeds {@link MOBILE_FEED_IMAGE_MAX_REQUEST_BYTES}.
+   * @throws {MobileServerFailureError} On authentication, format/size/hash errors (`INVALID_SOCIAL_FEED_IMAGE`),
+   * or when comments are disabled (`SERVICE_UNAVAILABLE`), or image storage is unavailable
+   * (`SOCIAL_FEED_DATA_UNAVAILABLE`, 6320, HTTP 503).
+   */
+  createFeedCommentImageUpload(params: MobileCreateFeedImageUploadParams): Promise<MobileSocialFeedUploadedImage>;
   /**
    * First attaches a drawing to an owned post or trade card while the author still holds its position.
    * The original JSON is signed unchanged; false and zero are valid drawing documents.
@@ -490,12 +633,24 @@ declare class MobileClient {
   protected publicQuery<T extends MobileServerPublicQueryRequestType>(body: {
     type: T;
   } & MobileServerPublicQueryRequestByType[T]): Promise<MobileServerPublicQuerySuccessResponse<T>>;
+  protected publicGetBytes(url: string, headers: Record<string, string>): Promise<Uint8Array>;
   protected publicExecute<T extends MobileServerPublicExecuteRequestType>(body: {
     type: T;
   } & MobileServerPublicExecuteRequestByType[T]): Promise<MobileServerPublicExecuteSuccessResponse<T>>;
+  /**
+   * Sends an authenticated read through the signed query route.
+   * @param body - Canonical inner payload with its signature, sender, and nonce.
+   * @returns The successful query envelope and its type-specific payload.
+   * @throws {MobileServerFailureError} For a structured service failure, including non-2xx responses.
+   */
+  protected query<T extends MobileServerSignedQueryRequestType>(body: MobileSignedRequest & {
+    type: T;
+  }): Promise<MobileServerSignedQuerySuccessResponse<T>>;
   protected execute<T extends MobileServerExecuteRequestType>(body: MobileSignedRequest & {
     type: T;
-  }): Promise<MobileServerExecuteSuccessResponse<T>>;
+  }, fileBytes?: Uint8Array): Promise<MobileServerExecuteSuccessResponse<T>>;
+  private createFeedImageUpload;
+  private checkFeedImageRequestSize;
   /**
    * Validates the HTTP status before interpreting the body. Unlike the engine, the mobile backend returns
    * failure envelopes with non-2xx statuses (e.g. 404 for `PROFILE_NOT_FOUND`), so a non-2xx response with a

package/dist/MobileClient.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MobileClient.d.ts","names":[],"sources":["../src/src/MobileClient.ts"],"mappings":"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"}
+{"version":3,"file":"MobileClient.d.ts","names":[],"sources":["../src/src/MobileClient.ts"],"mappings":";;;;;;;AA2LA;;;AAAA,UAAiB,gBAAA;EAIf;;;EAAA,GAAA;EAQ2B;;;EAJ3B,YAAA,GAAe,uBAAA;EAgBJ;;;EAZX,wBAAA,GAA2B,uBAAuB;EAc1B;;;EAVxB,UAAA;AAAA;;;;;;cAQW,YAAA;EAAA,SACF,IAAA,EAAM,gBAAA;EAAA,SACN,aAAA,EAAe,aAAA;cAEZ,IAAA,EAAM,gBAAA;EA2HR;;;;;EA5GH,eAAA,CACL,wBAAA,EAA0B,uBAAA;EAiJN;;;;;EAnIhB,gBAAA,CAAA,GAAoB,OAAA,CAAQ,kBAAA;EA6KxB;;;EAlKJ,uBAAA,CACJ,MAAA,EAAQ,mCAAA,GACP,OAAA,CAAQ,0BAAA;EAqLA;;;;;;;;;;;;;;EA9JL,WAAA,CACJ,MAAA,EAAQ,uBAAA,GACP,OAAA,CAAQ,mBAAA;EA0QA;;;;;;;;;;;;;;;;EA9OL,cAAA,CACJ,MAAA,EAAQ,0BAAA,GACP,OAAA,CAAQ,uBAAA;EA2WD;;;;;;;;;;;;;;;EAnVJ,YAAA,CACJ,MAAA,EAAQ,wBAAA,GACP,OAAA,CAAQ,oBAAA;EAscR;;;;;EAxbG,YAAA,CACJ,MAAA,EAAQ,wBAAA,GACP,OAAA,CAAQ,oBAAA;EAoeR;;;;;;;;;;;;EA/cG,OAAA,CAAQ,MAAA,GAAQ,mBAAA,GAA2B,OAAA,CAAQ,cAAA;EAmjB/C;;;;;;;;;EA/hBJ,aAAA,CACJ,MAAA,GAAQ,yBAAA,GACP,OAAA,CAAQ,0BAAA;EAmmBA;;;;;;;;EAhlBL,iBAAA,CACJ,MAAA,GAAQ,6BAAA,GACP,OAAA,CAAQ,8BAAA;EA4pBA;;;;;;;EA1oBL,cAAA,CACJ,MAAA,EAAQ,0BAAA,GACP,OAAA,CAAQ,0BAAA;EAmsBD;;;;;;;EAhrBJ,cAAA,CACJ,MAAA,EAAQ,0BAAA,GACP,OAAA,CAAQ,oBAAA;EAitBR;;;;;;;EA9rBG,aAAA,CACJ,MAAA,EAAQ,yBAAA,GACP,OAAA,CAAQ,oBAAA;EAiwBA;;;;;;;;EA9uBL,eAAA,CACJ,MAAA,EAAQ,2BAAA,GACP,OAAA,CAAQ,oBAAA;EA6zBA;;;;;;;;;EAzyBL,WAAA,CACJ,MAAA,EAAQ,uBAAA,GACP,OAAA,CAAQ,4BAAA;EA22BR;;;;;;;;;;;EAp1BG,cAAA,CACJ,MAAA,EAAQ,0BAAA,GACP,OAAA,CAAQ,uBAAA;EA66BD;;;;;;;;;EAr5BJ,0BAAA,CACJ,MAAA,EAAQ,sCAAA,GACP,OAAA,CAAQ,6BAAA;EAw6BgD;;;;;;;;;;EAr5BrD,mBAAA,CACJ,MAAA,EAAQ,+BAAA,GACP,OAAA,CAAQ,sBAAA;EAw7ByC;;;;;;;;EAv6B9C,oBAAA,CACJ,MAAA,EAAQ,gCAAA,GACP,OAAA,CAAQ,6BAAA;EAs8BuB;;;;;;;EAp7B5B,mBAAA,CACJ,MAAA,EAAQ,+BAAA,GACP,OAAA,CAAQ,wCAAA;EAq7BD;;;;;;;EAl6BJ,iBAAA,CACJ,MAAA,EAAQ,6BAAA,GACP,OAAA,CAAQ,sCAAA;EA1aJ;;;;;;;;EA6bD,mBAAA,CACJ,MAAA,EAAQ,+BAAA,GACP,OAAA,CAAQ,6BAAA;EAnaR;;;;;EAkbH,mBAAA,CAAoB,IAAA;EAzZT;;;;;;EAmaX,mBAAA,CACE,MAAA,EAAQ,+BAAA,GACP,sBAAA;EA9WO;;;;;;;EA+XJ,iBAAA,CACJ,MAAA,EAAQ,6BAAA,GACP,OAAA,CAAQ,UAAA;EAhXA;;;;;;;;;;;;EAiYL,eAAA,CACJ,MAAA,EAAQ,2BAAA,GACP,OAAA,CAAQ,4BAAA;EApUT;;;;;;;;;;;EA4VI,kBAAA,CACJ,MAAA,EAAQ,8BAAA,GACP,OAAA,CAAQ,+BAAA;EApTA;;;;;;;;;;EA2UL,qBAAA,CACJ,MAAA,EAAQ,iCAAA,GACP,OAAA,CAAQ,+BAAA;EA/QL;;;;;;;;;;;;EAoSA,mBAAA,CACJ,MAAA,EAAQ,+BAAA,GACP,OAAA,CAAQ,oCAAA;EAjPR;;;;;;;;;EAsQG,gBAAA,CACJ,MAAA,EAAQ,4BAAA,GACP,OAAA,CAAQ,6BAAA;EAhOR;;;;;;EAoPG,mBAAA,CACJ,MAAA,EAAQ,+BAAA,GACP,OAAA,CAAQ,wBAAA;EA/ML;;;;;;EAiOA,6BAAA,CACJ,MAAA,EAAQ,yCAAA,GACP,OAAA,CAAQ,gCAAA;EA7MT;;;;;;;EA6NI,yBAAA,CACJ,MAAA,EAAQ,qCAAA,GACP,OAAA,CAAQ,4BAAA;EAnMR;;;;;;;EAuNG,4BAAA,CACJ,MAAA,EAAQ,wCAAA,GACP,OAAA,CAAQ,+BAAA;EApLT;;;;;;;;EAqMI,sBAAA,CACJ,MAAA,EAAQ,kCAAA,GACP,OAAA,CAAQ,yBAAA;EApJD;;;;;;;;;;EA8KJ,mBAAA,CACJ,MAAA,EAAQ,+BAAA,GACP,OAAA,CAAQ,2BAAA;EAlIT;;;;;;;;;;;;;EAuJI,6BAAA,CACJ,MAAA,EAAQ,yCAAA,GACP,OAAA,CAAQ,2BAAA;EA7FD;;;;;;;EA6GJ,4BAAA,CACJ,MAAA,EAAQ,wCAAA,GACP,OAAA,CAAQ,4BAAA;EAxFA;;;;;;;;;;EA6GL,eAAA,CACJ,MAAA,EAAQ,2BAAA,GACP,OAAA,CAAQ,2BAAA;EA3CL;;;;;;;;;EA4DA,mBAAA,CACJ,MAAA,EAAQ,4BAAA,GACP,OAAA,CAAQ,wBAAA;EArBL;;;;;;;;;;EAuDA,MAAA,CACJ,MAAA,EAAQ,kBAAA,GACP,OAAA,CAAQ,2BAAA;EADD;;;;;;;EAeJ,kBAAA,CACJ,MAAA,EAAQ,8BAAA,GACP,OAAA,CAAQ,kBAAA;EAAA;;;;;;;;;;;EAqBL,SAAA,CACJ,MAAA,EAAQ,qBAAA,GACP,OAAA,CAAQ,2BAAA;EAiCD;;;;;;;;;;;;EAdJ,WAAA,CACJ,MAAA,EAAQ,uBAAA,GACP,OAAA,CAAQ,2BAAA;EA0DA;;;;EA/CL,cAAA,CACJ,MAAA,EAAQ,0BAAA,GACP,OAAA,CAAQ,2BAAA;EAwEA;;;;;;;;;;EArDL,iBAAA,CACJ,MAAA,EAAQ,6BAAA,GACP,OAAA,CAAQ,2BAAA;EAwHL;;;;;;;;EAlGA,mBAAA,CACJ,MAAA,EAAQ,+BAAA,GACP,OAAA,CAAQ,2BAAA;EA8HA;;;;;;;;EArGL,+BAAA,CACJ,MAAA,EAAQ,2CAAA,GACP,OAAA,CAAQ,2BAAA;EAgJR;;;;;;;EAhIG,mBAAA,CACJ,MAAA,EAAQ,+BAAA,GACP,OAAA,CAAQ,2BAAA;EA2KD;;;;;;;;;;;;;;;EAnJJ,SAAA,CACJ,MAAA,EAAQ,qBAAA,GACP,OAAA,CAAQ,0BAAA;EAoNgC;;;;;;;;;;;;;;;;EA3LrC,cAAA,CACJ,MAAA,EAAQ,0BAAA,GACP,OAAA,CAAQ,2BAAA;EAgNW;;;;;;;;;;;;;EAtLhB,cAAA,CACJ,MAAA,EAAQ,0BAAA,GACP,OAAA,CAAQ,oBAAA;EAuN6B;;;;;;;;;;;;EA7LlC,yBAAA,CACJ,MAAA,EAAQ,iCAAA,GACP,OAAA,CAAQ,6BAAA;EAiNqB;;;;;;;;;;;EAlM1B,4BAAA,CACJ,MAAA,EAAQ,iCAAA,GACP,OAAA,CAAQ,6BAAA;EA8MT;;;;;;;;;;;AAkFuB;;;EA3QnB,sBAAA,CACJ,MAAA,EAAQ,4BAAA,GACP,OAAA,CAAQ,qCAAA;;;;;;;;;;;EAqBL,sBAAA,CACJ,MAAA,EAAQ,4BAAA,GACP,OAAA,CAAQ,qCAAA;;;;;;;;;;;;EAsBL,iBAAA,CACJ,MAAA,EAAQ,6BAAA,GACP,OAAA,CAAQ,6BAAA;;;;;;;;;;;;;EA0BL,WAAA,CACJ,MAAA,EAAQ,uBAAA,GACP,OAAA,CAAQ,0BAAA;EAAA,UAcK,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,cAAA,CACd,GAAA,UACA,OAAA,EAAS,MAAA,mBACR,OAAA,CAAQ,UAAA;EAAA,UAkBK,aAAA,WAAwB,oCAAA,CAAA,CACtC,IAAA;IAAQ,IAAA,EAAM,CAAA;EAAA,IAAM,sCAAA,CAAuC,CAAA,IAC1D,OAAA,CAAQ,wCAAA,CAAyC,CAAA;;;;;;;YAmBpC,KAAA,WAAgB,kCAAA,CAAA,CAC9B,IAAA,EAAM,mBAAA;IAAwB,IAAA,EAAM,CAAA;EAAA,IACnC,OAAA,CAAQ,sCAAA,CAAuC,CAAA;EAAA,UAYlC,OAAA,WAAkB,8BAAA,CAAA,CAChC,IAAA,EAAM,mBAAA;IAAwB,IAAA,EAAM,CAAA;EAAA,GACpC,SAAA,GAAY,UAAA,GACX,OAAA,CAAQ,kCAAA,CAAmC,CAAA;EAAA,QAuBhC,qBAAA;EAAA,QAgCN,yBAAA;;;;;;UAaA,mBAAA;EAAA,QAYA,iBAAA;AAAA"}