@nadohq/mobile-client 0.27.0

package/dist/MobileClient.js

@@ -0,0 +1,185 @@
+import { mapMobileIdentity, mapMobileNotificationPreferences, mapMobileNotificationPreferencesToServer, mapMobilePublicProfile, mapMobileRegisteredDevice } from "./dataMappers.js";
+import { buildSignedMobileRequest } from "./signing/buildSignedMobileRequest.js";
+import "./signing/index.js";
+import { MobileServerFailureError } from "./types/MobileServerFailureError.js";
+import { isMobileServerFailureResponse, isMobileServerSuccessResponse } from "./utils/serverResponseGuards.js";
+import { WalletNotProvidedError } from "@nadohq/shared";
+import axios from "axios";
+//#region src/MobileClient.ts
+/**
+* Client for the Nado mobile service API: username claims, public profile lookups, privacy settings, and
+* push notification device/preference management.
+*/
+var MobileClient = class {
+	constructor(opts) {
+		this.opts = opts;
+		this.axiosInstance = axios.create({
+			withCredentials: true,
+			validateStatus: () => true
+		});
+	}
+	/**
+	* Sets the linked signer for requests
+	*
+	* @param linkedSignerWalletClient The linkedSigner to use for all signatures. Set to null to revert to the chain signer
+	*/
+	setLinkedSigner(linkedSignerWalletClient) {
+		this.opts.linkedSignerWalletClient = linkedSignerWalletClient ?? void 0;
+	}
+	/**
+	* Checks whether a username derived from the given display name is available to claim.
+	*/
+	async getUsernameAvailability(params) {
+		const body = {
+			type: "username_availability",
+			display_name: params.displayName
+		};
+		const data = await this.publicQuery(body);
+		return {
+			username: data.username,
+			available: data.available
+		};
+	}
+	/**
+	* Looks up a subaccount's public profile by username.
+	*
+	* @throws {MobileServerFailureError} With error code `PROFILE_NOT_FOUND` if no identity has claimed the
+	* username or it is invalid. Private Mode does not hide the profile itself, only the account's activity.
+	*/
+	async getPublicProfile(params) {
+		const body = {
+			type: "profile",
+			username: params.username
+		};
+		return mapMobilePublicProfile((await this.publicQuery(body)).profile);
+	}
+	/**
+	* Fetches the caller's own identity for a subaccount. Returns `null` if the subaccount has not claimed a
+	* username yet — this is normal data, not an error.
+	*/
+	async getSelfIdentity(params) {
+		const signedRequest = await this.getSignedRequest("self_identity", params, {});
+		const data = await this.query(signedRequest);
+		return data.identity ? mapMobileIdentity(data.identity) : null;
+	}
+	/**
+	* Fetches a wallet's push notification preferences. Falls back to the backend's defaults if the wallet has
+	* never updated its preferences.
+	*/
+	async getNotificationPreferences(params) {
+		const signedRequest = await this.getSignedRequest("notification_preferences", params, {});
+		return mapMobileNotificationPreferences((await this.query(signedRequest)).preferences);
+	}
+	/**
+	* Fetches the devices registered for push notifications for a wallet.
+	*/
+	async getRegisteredDevices(params) {
+		const signedRequest = await this.getSignedRequest("registered_devices", params, {});
+		return (await this.query(signedRequest)).devices.map(mapMobileRegisteredDevice);
+	}
+	/**
+	* Claims a username for a subaccount, derived from the given display name.
+	*/
+	async claimUsername(params) {
+		const signedRequest = await this.getSignedRequest("claim_username", params, { display_name: params.displayName });
+		return this.execute(signedRequest);
+	}
+	/**
+	* Updates the display name for a subaccount's already-claimed identity.
+	*/
+	async updateUsername(params) {
+		const signedRequest = await this.getSignedRequest("update_username", params, { display_name: params.displayName });
+		return this.execute(signedRequest);
+	}
+	/**
+	* Sets whether a subaccount's profile is private.
+	*/
+	async setPrivateMode(params) {
+		const signedRequest = await this.getSignedRequest("set_private_mode", params, { private_mode: params.privateMode });
+		return this.execute(signedRequest);
+	}
+	/**
+	* Registers an Expo push token for the wallet, transferring active ownership of the token if another
+	* wallet had registered it. Idempotent per `(wallet, token)`.
+	*
+	* @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.
+	*/
+	async registerExpoToken(params) {
+		const signedRequest = await this.getSignedRequest("register_expo_token", params, {
+			expo_token: params.expoToken,
+			platform: params.platform,
+			locale: params.locale ?? null,
+			app_version: params.appVersion ?? null
+		});
+		return this.execute(signedRequest);
+	}
+	/**
+	* Unregisters an Expo push token for the wallet. Idempotent — unregistering an unknown token succeeds.
+	*/
+	async unregisterExpoToken(params) {
+		const signedRequest = await this.getSignedRequest("unregister_expo_token", params, { expo_token: params.expoToken });
+		return this.execute(signedRequest);
+	}
+	/**
+	* Replaces the wallet's push notification preferences. The backend requires `schemaVersion` of 1, exactly
+	* one entry per known category, and empty `scopes` on every entry.
+	*
+	* @throws {MobileServerFailureError} With error code `INVALID_PREFERENCES` if those rules are violated.
+	*/
+	async updateNotificationPreferences(params) {
+		const signedRequest = await this.getSignedRequest("update_preferences", params, { preferences: mapMobileNotificationPreferencesToServer(params.preferences) });
+		return this.execute(signedRequest);
+	}
+	async getSignedRequest(type, params, innerParams) {
+		const walletClient = this.opts.linkedSignerWalletClient ?? this.opts.walletClient;
+		if (walletClient == null) throw new WalletNotProvidedError();
+		const inner = {
+			type,
+			...innerParams
+		};
+		return buildSignedMobileRequest({
+			...params,
+			walletClient,
+			inner
+		});
+	}
+	async publicQuery(body) {
+		const response = await this.axiosInstance.post(`${this.opts.url}/mobile/public_query`, body);
+		this.checkResponseStatus(response);
+		this.checkServerStatus(response);
+		return response.data;
+	}
+	async query(body) {
+		const response = await this.axiosInstance.post(`${this.opts.url}/mobile/query`, body);
+		this.checkResponseStatus(response);
+		this.checkServerStatus(response);
+		return response.data;
+	}
+	async execute(body) {
+		const response = await this.axiosInstance.post(`${this.opts.url}/mobile/execute`, body);
+		this.checkResponseStatus(response);
+		this.checkServerStatus(response);
+		return response.data;
+	}
+	/**
+	* 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
+	* failure envelope still throws the typed error; anything else is a transport-level error.
+	*/
+	checkResponseStatus(response) {
+		if (response.status >= 200 && response.status < 300) return;
+		if (isMobileServerFailureResponse(response.data)) throw new MobileServerFailureError(response.data, response.status);
+		throw new Error(`Unexpected response from mobile service: ${response.status} ${response.statusText}. Data: ${JSON.stringify(response.data)}`);
+	}
+	checkServerStatus(response) {
+		const { data } = response;
+		if (isMobileServerFailureResponse(data)) throw new MobileServerFailureError(data, response.status);
+		if (!isMobileServerSuccessResponse(data)) throw new Error(`Unexpected response from mobile service: missing success envelope. Data: ${JSON.stringify(data)}`);
+	}
+};
+//#endregion
+export { MobileClient };
+
+//# sourceMappingURL=MobileClient.js.map

package/dist/MobileClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MobileClient.js","names":[],"sources":["../src/MobileClient.ts"],"sourcesContent":["import {\n  WalletClientWithAccount,\n  WalletNotProvidedError,\n} from '@nadohq/shared';\nimport axios, { AxiosInstance, AxiosResponse } from 'axios';\nimport {\n  mapMobileIdentity,\n  mapMobileNotificationPreferences,\n  mapMobileNotificationPreferencesToServer,\n  mapMobilePublicProfile,\n  mapMobileRegisteredDevice,\n} from './dataMappers';\nimport {\n  buildSignedMobileRequest,\n  MobileSignedInner,\n  MobileSignedInnerParams,\n  MobileSignedRequest,\n} from './signing';\nimport {\n  GetMobileNotificationPreferencesParams,\n  GetMobilePublicProfileParams,\n  GetMobileRegisteredDevicesParams,\n  GetMobileSelfIdentityParams,\n  GetMobileUsernameAvailabilityParams,\n  MobileClaimUsernameParams,\n  MobileIdentity,\n  MobileNotificationPreferences,\n  MobilePublicProfile,\n  MobileRegisteredDevice,\n  MobileRegisterExpoTokenParams,\n  MobileSetPrivateModeParams,\n  MobileSignedRequestParams,\n  MobileUnregisterExpoTokenParams,\n  MobileUpdateNotificationPreferencesParams,\n  MobileUpdateUsernameParams,\n  MobileUsernameAvailability,\n} from './types/clientTypes';\nimport { MobileServerFailureError } from './types/MobileServerFailureError';\nimport { MobileServerSuccessResponse } from './types/serverBaseTypes';\nimport { MobileServerExecuteResult } from './types/serverExecuteTypes';\nimport {\n  MobileServerNotificationPreferencesResponse,\n  MobileServerProfileRequest,\n  MobileServerProfileResponse,\n  MobileServerRegisteredDevicesResponse,\n  MobileServerSelfIdentityResponse,\n  MobileServerUsernameAvailabilityRequest,\n  MobileServerUsernameAvailabilityResponse,\n} from './types/serverQueryTypes';\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\n/**\n * Client for the Nado mobile service API: username claims, public profile lookups, privacy settings, and\n * push notification 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    });\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: MobileServerUsernameAvailabilityRequest = {\n      type: 'username_availability',\n      display_name: params.displayName,\n    };\n    const data =\n      await this.publicQuery<MobileServerUsernameAvailabilityResponse>(body);\n    return { username: data.username, available: data.available };\n  }\n\n  /**\n   * Looks up a subaccount's public profile by username.\n   *\n   * @throws {MobileServerFailureError} With error code `PROFILE_NOT_FOUND` if no identity has claimed the\n   * username or it is invalid. Private Mode does not hide the profile itself, only the account's activity.\n   */\n  async getPublicProfile(\n    params: GetMobilePublicProfileParams,\n  ): Promise<MobilePublicProfile> {\n    const body: MobileServerProfileRequest = {\n      type: 'profile',\n      username: params.username,\n    };\n    const data = await this.publicQuery<MobileServerProfileResponse>(body);\n    return mapMobilePublicProfile(data.profile);\n  }\n\n  /*\n  Signed queries\n   */\n\n  /**\n   * Fetches the caller's own identity for a subaccount. Returns `null` if the subaccount has not claimed a\n   * username yet — this is normal data, not an error.\n   */\n  async getSelfIdentity(\n    params: GetMobileSelfIdentityParams,\n  ): Promise<MobileIdentity | null> {\n    const signedRequest = await this.getSignedRequest(\n      'self_identity',\n      params,\n      {},\n    );\n    const data =\n      await this.query<MobileServerSelfIdentityResponse>(signedRequest);\n    return data.identity ? mapMobileIdentity(data.identity) : null;\n  }\n\n  /**\n   * Fetches a wallet's push notification preferences. Falls back to the backend's defaults if the wallet has\n   * never updated its preferences.\n   */\n  async getNotificationPreferences(\n    params: GetMobileNotificationPreferencesParams,\n  ): Promise<MobileNotificationPreferences> {\n    const signedRequest = await this.getSignedRequest(\n      'notification_preferences',\n      params,\n      {},\n    );\n    const data =\n      await this.query<MobileServerNotificationPreferencesResponse>(\n        signedRequest,\n      );\n    return mapMobileNotificationPreferences(data.preferences);\n  }\n\n  /**\n   * Fetches the devices registered for push notifications for a wallet.\n   */\n  async getRegisteredDevices(\n    params: GetMobileRegisteredDevicesParams,\n  ): Promise<MobileRegisteredDevice[]> {\n    const signedRequest = await this.getSignedRequest(\n      'registered_devices',\n      params,\n      {},\n    );\n    const data =\n      await this.query<MobileServerRegisteredDevicesResponse>(signedRequest);\n    return data.devices.map(mapMobileRegisteredDevice);\n  }\n\n  /*\n  Signed executes\n   */\n\n  /**\n   * Claims a username for a subaccount, derived from the given display name.\n   */\n  async claimUsername(\n    params: MobileClaimUsernameParams,\n  ): Promise<MobileServerSuccessResponse> {\n    const signedRequest = await this.getSignedRequest(\n      'claim_username',\n      params,\n      {\n        display_name: params.displayName,\n      },\n    );\n    return this.execute(signedRequest);\n  }\n\n  /**\n   * Updates the display name for a subaccount's already-claimed identity.\n   */\n  async updateUsername(\n    params: MobileUpdateUsernameParams,\n  ): Promise<MobileServerSuccessResponse> {\n    const signedRequest = await this.getSignedRequest(\n      'update_username',\n      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   * Unregisters an Expo push token for the wallet. Idempotent — unregistering an unknown token succeeds.\n   */\n  async unregisterExpoToken(\n    params: MobileUnregisterExpoTokenParams,\n  ): Promise<MobileServerSuccessResponse> {\n    const signedRequest = await this.getSignedRequest(\n      'unregister_expo_token',\n      params,\n      { expo_token: params.expoToken },\n    );\n    return this.execute(signedRequest);\n  }\n\n  /**\n   * Replaces the wallet's push notification preferences. The backend requires `schemaVersion` of 1, exactly\n   * one entry per known category, and empty `scopes` on every entry.\n   *\n   * @throws {MobileServerFailureError} With error code `INVALID_PREFERENCES` if those rules are violated.\n   */\n  async updateNotificationPreferences(\n    params: MobileUpdateNotificationPreferencesParams,\n  ): Promise<MobileServerSuccessResponse> {\n    const signedRequest = await this.getSignedRequest(\n      'update_preferences',\n      params,\n      {\n        preferences: mapMobileNotificationPreferencesToServer(\n          params.preferences,\n        ),\n      },\n    );\n    return this.execute(signedRequest);\n  }\n\n  /*\n  Base Fns\n   */\n\n  protected async getSignedRequest<T extends MobileSignedInner['type']>(\n    type: T,\n    params: MobileSignedRequestParams,\n    innerParams: MobileSignedInnerParams<T>,\n  ): Promise<MobileSignedRequest> {\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 = { type, ...innerParams } as MobileSignedInner;\n    return buildSignedMobileRequest({ ...params, walletClient, inner });\n  }\n\n  protected async publicQuery<TResponse extends { status: 'success' }>(\n    body: object,\n  ): Promise<TResponse> {\n    const response = await this.axiosInstance.post<unknown>(\n      `${this.opts.url}/mobile/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 TResponse;\n  }\n\n  protected async query<TResponse extends { status: 'success' }>(\n    body: MobileSignedRequest,\n  ): Promise<TResponse> {\n    const response = await this.axiosInstance.post<unknown>(\n      `${this.opts.url}/mobile/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 TResponse;\n  }\n\n  protected async execute(\n    body: MobileSignedRequest,\n  ): Promise<MobileServerSuccessResponse> {\n    const response = await this.axiosInstance.post<MobileServerExecuteResult>(\n      `${this.opts.url}/mobile/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  /**\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":"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"}

package/dist/MobileServerFailureError-Belp_yef.d.cts

@@ -0,0 +1,25 @@
+import { t as MobileServerFailureResponse } from "./serverBaseTypes-BicXMrZV.cjs";
+
+//#region src/types/MobileServerFailureError.d.ts
+/**
+ * Error thrown when the mobile service API returns a failure envelope, either as a non-2xx HTTP response
+ * or a 2xx response with `status: 'failure'`.
+ */
+declare class MobileServerFailureError extends Error {
+  readonly responseData: MobileServerFailureResponse;
+  /**
+   * HTTP status code of the response, e.g. `404` for `PROFILE_NOT_FOUND`. Unlike the engine, the mobile
+   * backend maps domain failures onto HTTP statuses.
+   */
+  readonly httpStatus: number;
+  constructor(responseData: MobileServerFailureResponse,
+  /**
+   * HTTP status code of the response, e.g. `404` for `PROFILE_NOT_FOUND`. Unlike the engine, the mobile
+   * backend maps domain failures onto HTTP statuses.
+   */
+
+  httpStatus: number);
+}
+//#endregion
+export { MobileServerFailureError as t };
+//# sourceMappingURL=MobileServerFailureError-Belp_yef.d.cts.map

package/dist/MobileServerFailureError-Belp_yef.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MobileServerFailureError-Belp_yef.d.cts","names":[],"sources":["../src/types/src/types/MobileServerFailureError.ts"],"mappings":";;;;;AAMA;;cAAa,wBAAA,SAAiC,KAAA;EAAA,SAEjC,YAAA,EAAc,2BAAA;EAAA;;;;EAAA,SAKd,UAAA;cALA,YAAA,EAAc,2BAAA;EAAA;;;;;EAKd,UAAA;AAAA"}

package/dist/MobileServerFailureError-DqM0T6CB.d.ts

@@ -0,0 +1,25 @@
+import { t as MobileServerFailureResponse } from "./serverBaseTypes-ewbo8l4R.js";
+
+//#region src/types/MobileServerFailureError.d.ts
+/**
+ * Error thrown when the mobile service API returns a failure envelope, either as a non-2xx HTTP response
+ * or a 2xx response with `status: 'failure'`.
+ */
+declare class MobileServerFailureError extends Error {
+  readonly responseData: MobileServerFailureResponse;
+  /**
+   * HTTP status code of the response, e.g. `404` for `PROFILE_NOT_FOUND`. Unlike the engine, the mobile
+   * backend maps domain failures onto HTTP statuses.
+   */
+  readonly httpStatus: number;
+  constructor(responseData: MobileServerFailureResponse,
+  /**
+   * HTTP status code of the response, e.g. `404` for `PROFILE_NOT_FOUND`. Unlike the engine, the mobile
+   * backend maps domain failures onto HTTP statuses.
+   */
+
+  httpStatus: number);
+}
+//#endregion
+export { MobileServerFailureError as t };
+//# sourceMappingURL=MobileServerFailureError-DqM0T6CB.d.ts.map

package/dist/MobileServerFailureError-DqM0T6CB.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MobileServerFailureError-DqM0T6CB.d.ts","names":[],"sources":["../src/types/src/types/MobileServerFailureError.ts"],"mappings":";;;;;AAMA;;cAAa,wBAAA,SAAiC,KAAA;EAAA,SAEjC,YAAA,EAAc,2BAAA;EAAA;;;;EAAA,SAKd,UAAA;cALA,YAAA,EAAc,2BAAA;EAAA;;;;;EAKd,UAAA;AAAA"}

package/dist/buildSignedMobileRequest-BsbBkU0K.d.cts

@@ -0,0 +1,14 @@
+import { i as MobileSignedRequest, n as MobileSignedInner, t as BuildSignedMobileRequestParams } from "./types-uCD4BNZR.cjs";
+
+//#region src/signing/buildSignedMobileRequest.d.ts
+/**
+ * Builds and signs a mobile service API request: canonicalizes the inner payload, derives `sender` from the
+ * subaccount owner (never the signer), computes the EIP-712 `payloadHash`, signs the `NadoAuthentication`
+ * typed data, and returns the flattened signed body ready to POST.
+ */
+declare function buildSignedMobileRequest<T extends MobileSignedInner>(params: BuildSignedMobileRequestParams & {
+  inner: T;
+}): Promise<MobileSignedRequest<T>>;
+//#endregion
+export { buildSignedMobileRequest as t };
+//# sourceMappingURL=buildSignedMobileRequest-BsbBkU0K.d.cts.map

package/dist/buildSignedMobileRequest-BsbBkU0K.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildSignedMobileRequest-BsbBkU0K.d.cts","names":[],"sources":["../src/signing/src/signing/buildSignedMobileRequest.ts"],"mappings":";;;;;AAgBA;;;iBAAsB,wBAAA,WAAmC,iBAAA,CAAA,CACvD,MAAA,EAAQ,8BAAA;EAAmC,KAAA,EAAO,CAAA;AAAA,IACjD,OAAA,CAAQ,mBAAA,CAAoB,CAAA"}

package/dist/buildSignedMobileRequest-CDRsRNHm.d.ts

@@ -0,0 +1,14 @@
+import { i as MobileSignedRequest, n as MobileSignedInner, t as BuildSignedMobileRequestParams } from "./types-B76Pn7Sy.js";
+
+//#region src/signing/buildSignedMobileRequest.d.ts
+/**
+ * Builds and signs a mobile service API request: canonicalizes the inner payload, derives `sender` from the
+ * subaccount owner (never the signer), computes the EIP-712 `payloadHash`, signs the `NadoAuthentication`
+ * typed data, and returns the flattened signed body ready to POST.
+ */
+declare function buildSignedMobileRequest<T extends MobileSignedInner>(params: BuildSignedMobileRequestParams & {
+  inner: T;
+}): Promise<MobileSignedRequest<T>>;
+//#endregion
+export { buildSignedMobileRequest as t };
+//# sourceMappingURL=buildSignedMobileRequest-CDRsRNHm.d.ts.map

package/dist/buildSignedMobileRequest-CDRsRNHm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildSignedMobileRequest-CDRsRNHm.d.ts","names":[],"sources":["../src/signing/src/signing/buildSignedMobileRequest.ts"],"mappings":";;;;;AAgBA;;;iBAAsB,wBAAA,WAAmC,iBAAA,CAAA,CACvD,MAAA,EAAQ,8BAAA;EAAmC,KAAA,EAAO,CAAA;AAAA,IACjD,OAAA,CAAQ,mBAAA,CAAoB,CAAA"}

package/dist/canonicalize-Dm7sXwPg.d.cts

@@ -0,0 +1,14 @@
+import { n as MobileSignedInner } from "./types-uCD4BNZR.cjs";
+
+//#region src/signing/canonicalize.d.ts
+/**
+ * Rebuilds an inner payload with its keys in the backend's struct declaration order (`type` first, then the
+ * remaining fields in the exact order the backend serializes them). msgpack encodes object keys in insertion
+ * order and the payload hash must be reproducible regardless of how the caller constructed the object, so
+ * every inner payload — and each of its sub-types — is canonicalized here before hashing. This function (with
+ * {@link canonicalizeNotificationPreferences} for nested preferences) is the source of truth for that order.
+ */
+declare function canonicalizeMobileInner(inner: MobileSignedInner): MobileSignedInner;
+//#endregion
+export { canonicalizeMobileInner as t };
+//# sourceMappingURL=canonicalize-Dm7sXwPg.d.cts.map

package/dist/canonicalize-Dm7sXwPg.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonicalize-Dm7sXwPg.d.cts","names":[],"sources":["../src/signing/src/signing/canonicalize.ts"],"mappings":";;;;;AAUA;;;;;iBAAgB,uBAAA,CACd,KAAA,EAAO,iBAAA,GACN,iBAAiB"}

package/dist/canonicalize-PX6dTIdF.d.ts

@@ -0,0 +1,14 @@
+import { n as MobileSignedInner } from "./types-B76Pn7Sy.js";
+
+//#region src/signing/canonicalize.d.ts
+/**
+ * Rebuilds an inner payload with its keys in the backend's struct declaration order (`type` first, then the
+ * remaining fields in the exact order the backend serializes them). msgpack encodes object keys in insertion
+ * order and the payload hash must be reproducible regardless of how the caller constructed the object, so
+ * every inner payload — and each of its sub-types — is canonicalized here before hashing. This function (with
+ * {@link canonicalizeNotificationPreferences} for nested preferences) is the source of truth for that order.
+ */
+declare function canonicalizeMobileInner(inner: MobileSignedInner): MobileSignedInner;
+//#endregion
+export { canonicalizeMobileInner as t };
+//# sourceMappingURL=canonicalize-PX6dTIdF.d.ts.map

package/dist/canonicalize-PX6dTIdF.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canonicalize-PX6dTIdF.d.ts","names":[],"sources":["../src/signing/src/signing/canonicalize.ts"],"mappings":";;;;;AAUA;;;;;iBAAgB,uBAAA,CACd,KAAA,EAAO,iBAAA,GACN,iBAAiB"}

package/dist/clientTypes-DWW2N66c.d.ts

@@ -0,0 +1,168 @@
+import { n as MobileNotificationPlatform, t as MobileNotificationCategory } from "./serverModelTypes-vEPhHIit.js";
+import { SignatureParams, Subaccount } from "@nadohq/shared";
+import { Hex } from "viem";
+
+//#region src/types/clientTypes.d.ts
+/**
+ * A subaccount's claimed identity on the mobile service API.
+ *
+ * `username` and `displayName` are two representations of the same claimed name: `displayName` is what the
+ * user entered (preserving casing, e.g. `Alice.One`), while `username` is the canonical, lowercased handle
+ * derived from it (e.g. `alice.one`). `username` is the unique key used for profile lookups
+ * ({@link MobilePublicProfile}); `displayName` is only for presentation.
+ */
+interface MobileIdentity {
+  subaccount: Hex;
+  /**
+   * Canonical, lowercased handle derived from {@link MobileIdentity.displayName}, unique per identity and
+   * used for profile lookups.
+   */
+  username: string;
+  /**
+   * User-facing name as claimed, preserving original casing. Validated against `MOBILE_DISPLAY_NAME_PATTERN`.
+   */
+  displayName: string;
+  privateMode: boolean;
+}
+/**
+ * A subaccount's public profile, as returned by an unsigned profile lookup.
+ */
+interface MobilePublicProfile {
+  subaccount: Hex;
+  username: string;
+  displayName: string;
+}
+/**
+ * Result of a username availability check.
+ */
+interface MobileUsernameAvailability {
+  username: string;
+  available: boolean;
+}
+/**
+ * Scope limiting a notification category preference. Scopes are part of the wire format but rejected by the
+ * backend for the MVP — `scopes` must be empty.
+ */
+type MobileNotificationPreferenceScope = {
+  type: 'subaccount';
+  subaccount: Hex;
+} | {
+  type: 'product';
+  productId: number;
+};
+/**
+ * A per-category push notification preference.
+ */
+interface MobileNotificationCategoryPreference {
+  category: MobileNotificationCategory;
+  enabled: boolean;
+  scopes: MobileNotificationPreferenceScope[];
+}
+/**
+ * A wallet's push notification preferences. The backend requires exactly one entry per known category and
+ * `schemaVersion` of 1.
+ */
+interface MobileNotificationPreferences {
+  /** Only `1` is accepted by the backend for the MVP. */
+  schemaVersion: 1;
+  categories: MobileNotificationCategoryPreference[];
+}
+/**
+ * A device registered for push notifications.
+ */
+interface MobileRegisteredDevice {
+  /** Push platform the device registered under. */
+  platform: MobileNotificationPlatform;
+  /** BCP-47 locale tag reported at registration, or `null` if none was provided. */
+  locale: string | null;
+  /** App version string reported at registration, or `null` if none was provided. */
+  appVersion: string | null;
+  /**
+   * First 8 hex chars of `keccak256` over the bracket-stripped Expo token — a stable, non-reversible
+   * identifier for the device's push token. The raw token is never returned by the backend.
+   */
+  tokenFingerprintPrefix: string;
+  /**
+   * Unix timestamp (milliseconds) of the device's last registration refresh.
+   */
+  lastSeenAt: number;
+}
+/**
+ * Common params for signed requests that authenticate as a given subaccount.
+ */
+interface MobileSignedRequestParams extends Subaccount, SignatureParams {}
+/**
+ * Params for {@link MobileClient.getUsernameAvailability}.
+ */
+interface GetMobileUsernameAvailabilityParams {
+  displayName: string;
+}
+/**
+ * Params for {@link MobileClient.getPublicProfile}.
+ */
+interface GetMobilePublicProfileParams {
+  username: string;
+}
+/**
+ * Params for {@link MobileClient.getSelfIdentity}.
+ */
+type GetMobileSelfIdentityParams = MobileSignedRequestParams;
+/**
+ * Params for {@link MobileClient.claimUsername}.
+ */
+interface MobileClaimUsernameParams extends MobileSignedRequestParams {
+  displayName: string;
+}
+/**
+ * Params for {@link MobileClient.updateUsername}.
+ */
+interface MobileUpdateUsernameParams extends MobileSignedRequestParams {
+  displayName: string;
+}
+/**
+ * Params for {@link MobileClient.setPrivateMode}.
+ */
+interface MobileSetPrivateModeParams extends MobileSignedRequestParams {
+  privateMode: boolean;
+}
+/**
+ * Params for {@link MobileClient.registerExpoToken}.
+ */
+interface MobileRegisterExpoTokenParams extends MobileSignedRequestParams {
+  /**
+   * Expo push token, e.g. `ExponentPushToken[...]`.
+   */
+  expoToken: string;
+  platform: MobileNotificationPlatform;
+  /**
+   * BCP-47 locale tag, max 35 chars.
+   */
+  locale?: string;
+  /**
+   * App version string, max 64 chars.
+   */
+  appVersion?: string;
+}
+/**
+ * Params for {@link MobileClient.unregisterExpoToken}.
+ */
+interface MobileUnregisterExpoTokenParams extends MobileSignedRequestParams {
+  expoToken: string;
+}
+/**
+ * Params for {@link MobileClient.updateNotificationPreferences}.
+ */
+interface MobileUpdateNotificationPreferencesParams extends MobileSignedRequestParams {
+  preferences: MobileNotificationPreferences;
+}
+/**
+ * Params for {@link MobileClient.getNotificationPreferences}.
+ */
+type GetMobileNotificationPreferencesParams = MobileSignedRequestParams;
+/**
+ * Params for {@link MobileClient.getRegisteredDevices}.
+ */
+type GetMobileRegisteredDevicesParams = MobileSignedRequestParams;
+//#endregion
+export { MobileUpdateNotificationPreferencesParams as _, GetMobileUsernameAvailabilityParams as a, MobileNotificationCategoryPreference as c, MobilePublicProfile as d, MobileRegisterExpoTokenParams as f, MobileUnregisterExpoTokenParams as g, MobileSignedRequestParams as h, GetMobileSelfIdentityParams as i, MobileNotificationPreferenceScope as l, MobileSetPrivateModeParams as m, GetMobilePublicProfileParams as n, MobileClaimUsernameParams as o, MobileRegisteredDevice as p, GetMobileRegisteredDevicesParams as r, MobileIdentity as s, GetMobileNotificationPreferencesParams as t, MobileNotificationPreferences as u, MobileUpdateUsernameParams as v, MobileUsernameAvailability as y };
+//# sourceMappingURL=clientTypes-DWW2N66c.d.ts.map

package/dist/clientTypes-DWW2N66c.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clientTypes-DWW2N66c.d.ts","names":[],"sources":["../src/types/src/types/clientTypes.ts"],"mappings":";;;;;;;AAeA;;;;;;UAAiB,cAAA;EACf,UAAA,EAAY,GAAG;EAUf;;AAAW;AAMb;EAXE,QAAA;;;;EAIA,WAAA;EACA,WAAA;AAAA;;AASW;AAMb;UATiB,mBAAA;EACf,UAAA,EAAY,GAAG;EACf,QAAA;EACA,WAAA;AAAA;;;;UAMe,0BAAA;EACf,QAAA;EACA,SAAS;AAAA;;;AASqB;AAKhC;KAPY,iCAAA;EACN,IAAA;EAAoB,UAAA,EAAY,GAAG;AAAA;EACnC,IAAA;EAAiB,SAAA;AAAA;;;AAQoB;UAH1B,oCAAA;EACf,QAAA,EAAU,0BAAA;EACV,OAAA;EACA,MAAA,EAAQ,iCAAiC;AAAA;;;;AAUO;UAHjC,6BAAA;EASsB;EAPrC,aAAA;EACA,UAAA,EAAY,oCAAoC;AAAA;;;;UAMjC,sBAAA;EAef;EAbA,QAAA,EAAU,0BAA0B;EAa1B;EAXV,MAAA;EAkBA;EAhBA,UAAA;EAgBQ;AAA2B;AAKrC;;EAhBE,sBAAA;EAiBW;AAAA;AAMb;EAnBE,UAAA;AAAA;;AAoBQ;AAMV;UApBiB,yBAAA,SACP,UAAA,EAAY,eAAe;;AAmB8B;AAKnE;UAnBiB,mCAAA;EACf,WAAW;AAAA;AAmBA;AAMb;;AANa,UAbI,4BAAA;EACf,QAAQ;AAAA;AAyBV;;;AAAA,KAnBY,2BAAA,GAA8B,yBAAyB;AAoBtD;AAMb;;AANa,UAfI,yBAAA,SAAkC,yBAAyB;EAC1E,WAAW;AAAA;;;;UAMI,0BAAA,SAAmC,yBAAyB;EAC3E,WAAW;AAAA;AA0BD;AAMZ;;AANY,UApBK,0BAAA,SAAmC,yBAAyB;EAC3E,WAAW;AAAA;AAgCb;;;AAAA,UA1BiB,6BAAA,SAAsC,yBAAyB;EA0Bb;;;EAtBjE,SAAA;EACA,QAAA,EAAU,0BAAA;EA4BA;;;EAxBV,MAAA;EAwB4E;AAK9E;;EAzBE,UAAA;AAAA;AAyBsE;;;AAAA,UAnBvD,+BAAA,SAAwC,yBAAyB;EAChF,SAAS;AAAA;;;;UAMM,yCAAA,SAAkD,yBAAyB;EAC1F,WAAA,EAAa,6BAAA;AAAA;;;;KAMH,sCAAA,GAAyC,yBAAyB;;;;KAKlE,gCAAA,GAAmC,yBAAyB"}