@oxy.so/contracts 1.0.0

package/dist/types/userResponse.d.ts

@@ -0,0 +1,1706 @@
+/**
+ * Canonical API user-response contracts.
+ *
+ * SINGLE SOURCE OF TRUTH for the wire shape of every user object the API emits
+ * and every consumer (the auth app, services, accounts) parses. The API
+ * validates its OUTPUT against these schemas; web/RN consumers validate their
+ * INPUT against the same schemas. Because there is exactly one definition, the
+ * producer and the consumers cannot drift — the class of bugs that motivated
+ * this module (the auth app's local Zod schema requiring `name` to be a plain
+ * string, dropping every account that had a structured name) is impossible.
+ *
+ * This package (`@oxy.so/contracts`) is the dedicated, zero-dependency home for
+ * these contracts so the backend (`@oxy.so/api`) and the client SDKs
+ * (`@oxy.so/core`, `@oxy.so/services`) can all depend on it without
+ * the backend having to depend on a client SDK to obtain its schemas.
+ *
+ * Faithful to the producers:
+ *  - `packages/api/src/utils/userTransform.ts` `formatUserResponse` — the
+ *    canonical serialization used by login/signup, device sessions, etc.
+ *    Emits `id` (NOT `_id`), forwards `username` verbatim (may be absent), and
+ *    emits `name` as the structured `{ first, last, full, displayName }`
+ *    subdocument.
+ *  - `packages/api/src/models/User.ts` — `NameSchema` (`first`/`last` default
+ *    `''`; `full` and `displayName` are Mongoose VIRTUALS. Formatted API
+ *    responses compose both fields, while raw-document responses may omit the
+ *    virtuals if the query did not materialise them.
+ *
+ * Platform-agnostic — zod only, no react/react-native/expo. ESM-safe (no
+ * `require()`).
+ */
+import { z } from 'zod';
+/**
+ * Structured human name subdocument. Mirrors `User.name` (`NameSchema`).
+ *
+ * - `first` / `last` default to `''` in Mongo, so they are optional on the wire.
+ * - `full` is a Mongoose virtual — absent unless the query materialised
+ *   virtuals or the serializer composed it.
+ * - `displayName` is the canonical app-facing display string when present.
+ *   It is OPTIONAL on the wire: the API still synthesizes a default today, but
+ *   the contract no longer guarantees it, so consumers fall back to a handle
+ *   (e.g. `getNormalizedUserHandle`) when it is absent.
+ *
+ * This is declared as an explicit `interface` rather than being inferred from
+ * the runtime schema via `z.infer<typeof userNameSchema>`. Inferring it produced
+ * a `z.objectOutputType<…, "passthrough">` in the emitted `.d.ts`, whose
+ * resolution to the named fields depends on zod's deep conditional-type
+ * machinery (`objectUtil.addQuestionMarks` / `flatten` / `PassthroughType`).
+ * Under a consumer's `moduleResolution: "node"` (node10), that chain does not
+ * always resolve, so `name.displayName` silently widened to `{}` and broke the
+ * "render `name.displayName` directly" contract at the type level. An explicit
+ * interface emits `displayName?: string` literally and survives BOTH `node` and
+ * `bundler` resolution. The index signature preserves the passthrough behaviour
+ * (additive name fields are tolerated without a coordinated contract bump).
+ */
+export interface UserNameResponse {
+    first?: string;
+    last?: string;
+    full?: string;
+    /** Canonical display string when present — render this directly. */
+    displayName?: string;
+    [key: string]: unknown;
+}
+export declare const userNameSchema: z.ZodType<UserNameResponse>;
+/**
+ * The authenticated viewer's relationship to a fetched profile.
+ *
+ * Rides the SINGLE-profile fetch (profile-by-username / profile-by-id) so
+ * consumers get follow state without a second round-trip. Present ONLY when the
+ * request is authenticated (the viewer id is known) — OMITTED entirely for
+ * anonymous requests, so a consumer can distinguish "unknown" (field absent)
+ * from "known, not following" (`isFollowing: false`).
+ */
+export interface UserRelationship {
+    /** The viewer follows this profile (viewer → target). */
+    isFollowing: boolean;
+    /** This profile follows the viewer (target → viewer). */
+    followsYou: boolean;
+}
+export declare const userRelationshipSchema: z.ZodType<UserRelationship>;
+/**
+ * Portable per-account theme preference, applied across every Oxy app.
+ *
+ * Persisted on the Oxy user document and projected onto the self/session
+ * payload the SDK already loads during cold boot, so Bloom can theme on first
+ * paint with ZERO extra network call. `colorPreset` is a Bloom preset KEY
+ * (e.g. `"blue"`) — never raw colors.
+ */
+export interface ThemePreference {
+    mode: 'light' | 'dark' | 'system';
+    colorPreset: string;
+}
+export declare const themePreferenceSchema: z.ZodType<ThemePreference>;
+/**
+ * The canonical user object emitted by `formatUserResponse`.
+ *
+ * `id` is present on formatted user DTOs. `name.displayName` is OPTIONAL on the
+ * contract — the API still synthesizes a default today, but consumers must not
+ * assume it is present and should fall back to a handle when it is absent. The
+ * rest is forwarded from the user document and may be absent depending on the query's
+ * `.select(...)`/`.lean()` projection. Both `id` and `_id` are accepted because
+ * some raw-document responses carry `_id` instead of `id`; resolve the
+ * identifier with {@link resolveUserId}.
+ *
+ * `.passthrough()` keeps the large tail of profile fields
+ * (`privacySettings`, `locations`, `links`, `linksMetadata`, `bio`,
+ * `description`, `languages`, `verified`, timestamps, …) available to callers
+ * that need them without enumerating every nested shape here — the load-bearing
+ * identity/display fields are the ones we pin precisely.
+ */
+export declare const userResponseSchema: z.ZodObject<{
+    /** MongoDB ObjectId as a string. Present on `formatUserResponse` output. */
+    id: z.ZodOptional<z.ZodString>;
+    /** Raw-document id (e.g. `GET /users/me`). Present when `id` is not. */
+    _id: z.ZodOptional<z.ZodString>;
+    publicKey: z.ZodOptional<z.ZodString>;
+    username: z.ZodOptional<z.ZodString>;
+    email: z.ZodOptional<z.ZodString>;
+    phone: z.ZodOptional<z.ZodString>;
+    address: z.ZodOptional<z.ZodString>;
+    birthday: z.ZodOptional<z.ZodString>;
+    /** Avatar file id (string) or null. */
+    avatar: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** Named Bloom color preset (e.g. `"blue"`) or null. */
+    color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    name: z.ZodType<UserNameResponse, z.ZodTypeDef, UserNameResponse>;
+    verified: z.ZodOptional<z.ZodBoolean>;
+    /**
+     * The account's languages as full BCP-47 locales (`language-REGION`,
+     * e.g. `es-ES`, `en-US`, `pt-BR`), ordered with the PRIMARY (UI) locale
+     * first. `languages[0]` is the primary locale — there is no singular
+     * `language` field.
+     */
+    languages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * The account's self-sovereign identifier
+     * (`did:web:<FEDERATION_DOMAIN>:u:<userId>`). Surfaced as a `User`
+     * virtual; present on formatted DTOs once the identity layer is live.
+     */
+    did: z.ZodOptional<z.ZodString>;
+    /**
+     * Proven domain-ownership badges. Each is a {@link verifiedDomainSchema}
+     * entry; present only when the account has verified at least one domain.
+     */
+    verifiedDomains: z.ZodOptional<z.ZodArray<z.ZodType<import("./identity").VerifiedDomain, z.ZodTypeDef, import("./identity").VerifiedDomain>, "many">>;
+    /**
+     * Account-graph classification — what KIND of account this is.
+     *
+     * ORTHOGONAL to `type` (`local` / `federated` / `agent` / `automated`),
+     * which says where the account lives and how it is driven; the two
+     * coexist and neither substitutes for the other. A `channel` is a
+     * publishing identity nobody can act as, so a consumer that renders
+     * authored content reads THIS to tell a channel's post from a person's.
+     *
+     * Optional because a DTO produced from a source that never carried the
+     * column omits it; absent should be read as `personal`, the column's
+     * default, not as unknown.
+     */
+    kind: z.ZodOptional<z.ZodEnum<["personal", "organization", "project", "bot", "channel"]>>;
+    /**
+     * What this account is about — the field a profile screen RENDERS.
+     *
+     * **Ordered, primary first.** `accountCategories[0]` is the primary
+     * category; there is deliberately no sibling `primaryCategory` field,
+     * because two representations of one fact can disagree (see rule 2 in
+     * `accountGraph.ts`). Nothing downstream may sort, de-duplicate or
+     * otherwise reorder this array.
+     *
+     * **Ids, never labels.** Each element is a stable slug; the visible text
+     * comes from the reader's own translation catalogue, keyed
+     * `accounts.accountCategory.<id>`. A label on the wire would paint every
+     * profile in the language of whoever picked it.
+     *
+     * Absent when the account has none — which is every `personal` account,
+     * and any non-personal one that has not chosen. A renderer reads
+     * `user.accountCategories ?? []`.
+     */
+    accountCategories: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodEnum<["news", "politics", "business", "startup", "finance", "crypto", "marketplace", "retail", "real_estate", "agency", "landlord", "cooperative", "architecture", "technology", "software", "ai", "security", "automation", "science", "education", "books", "health", "fitness", "sports", "gaming", "music", "film", "podcast", "art", "photography", "comedy", "food", "travel", "fashion", "home_garden", "diy", "automotive", "animals", "family", "nonprofit", "government", "community", "activism", "environment", "religion", "other"]>, "many">, ("news" | "politics" | "business" | "startup" | "finance" | "crypto" | "marketplace" | "retail" | "real_estate" | "agency" | "landlord" | "cooperative" | "architecture" | "technology" | "software" | "ai" | "security" | "automation" | "science" | "education" | "books" | "health" | "fitness" | "sports" | "gaming" | "music" | "film" | "podcast" | "art" | "photography" | "comedy" | "food" | "travel" | "fashion" | "home_garden" | "diy" | "automotive" | "animals" | "family" | "nonprofit" | "government" | "community" | "activism" | "environment" | "religion" | "other")[], ("news" | "politics" | "business" | "startup" | "finance" | "crypto" | "marketplace" | "retail" | "real_estate" | "agency" | "landlord" | "cooperative" | "architecture" | "technology" | "software" | "ai" | "security" | "automation" | "science" | "education" | "books" | "health" | "fitness" | "sports" | "gaming" | "music" | "film" | "podcast" | "art" | "photography" | "comedy" | "food" | "travel" | "fashion" | "home_garden" | "diy" | "automotive" | "animals" | "family" | "nonprofit" | "government" | "community" | "activism" | "environment" | "religion" | "other")[]>>;
+    /**
+     * The authenticated viewer's relationship to this profile. Present ONLY
+     * on single-profile fetches (`GET /profiles/username/:username`,
+     * `GET /users/:userId`) when the request is authenticated; OMITTED for
+     * anonymous requests and for the bulk `POST /users/by-ids` fan-out.
+     */
+    relationship: z.ZodOptional<z.ZodType<UserRelationship, z.ZodTypeDef, UserRelationship>>;
+    /**
+     * Portable theme preference. Rides the self/session payload (cold boot),
+     * so it is present on the current-user DTO (`GET /users/me`,
+     * `GET /session/user/:sessionId`) and absent until the user sets it.
+     */
+    themePreference: z.ZodOptional<z.ZodType<ThemePreference, z.ZodTypeDef, ThemePreference>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    /** MongoDB ObjectId as a string. Present on `formatUserResponse` output. */
+    id: z.ZodOptional<z.ZodString>;
+    /** Raw-document id (e.g. `GET /users/me`). Present when `id` is not. */
+    _id: z.ZodOptional<z.ZodString>;
+    publicKey: z.ZodOptional<z.ZodString>;
+    username: z.ZodOptional<z.ZodString>;
+    email: z.ZodOptional<z.ZodString>;
+    phone: z.ZodOptional<z.ZodString>;
+    address: z.ZodOptional<z.ZodString>;
+    birthday: z.ZodOptional<z.ZodString>;
+    /** Avatar file id (string) or null. */
+    avatar: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** Named Bloom color preset (e.g. `"blue"`) or null. */
+    color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    name: z.ZodType<UserNameResponse, z.ZodTypeDef, UserNameResponse>;
+    verified: z.ZodOptional<z.ZodBoolean>;
+    /**
+     * The account's languages as full BCP-47 locales (`language-REGION`,
+     * e.g. `es-ES`, `en-US`, `pt-BR`), ordered with the PRIMARY (UI) locale
+     * first. `languages[0]` is the primary locale — there is no singular
+     * `language` field.
+     */
+    languages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * The account's self-sovereign identifier
+     * (`did:web:<FEDERATION_DOMAIN>:u:<userId>`). Surfaced as a `User`
+     * virtual; present on formatted DTOs once the identity layer is live.
+     */
+    did: z.ZodOptional<z.ZodString>;
+    /**
+     * Proven domain-ownership badges. Each is a {@link verifiedDomainSchema}
+     * entry; present only when the account has verified at least one domain.
+     */
+    verifiedDomains: z.ZodOptional<z.ZodArray<z.ZodType<import("./identity").VerifiedDomain, z.ZodTypeDef, import("./identity").VerifiedDomain>, "many">>;
+    /**
+     * Account-graph classification — what KIND of account this is.
+     *
+     * ORTHOGONAL to `type` (`local` / `federated` / `agent` / `automated`),
+     * which says where the account lives and how it is driven; the two
+     * coexist and neither substitutes for the other. A `channel` is a
+     * publishing identity nobody can act as, so a consumer that renders
+     * authored content reads THIS to tell a channel's post from a person's.
+     *
+     * Optional because a DTO produced from a source that never carried the
+     * column omits it; absent should be read as `personal`, the column's
+     * default, not as unknown.
+     */
+    kind: z.ZodOptional<z.ZodEnum<["personal", "organization", "project", "bot", "channel"]>>;
+    /**
+     * What this account is about — the field a profile screen RENDERS.
+     *
+     * **Ordered, primary first.** `accountCategories[0]` is the primary
+     * category; there is deliberately no sibling `primaryCategory` field,
+     * because two representations of one fact can disagree (see rule 2 in
+     * `accountGraph.ts`). Nothing downstream may sort, de-duplicate or
+     * otherwise reorder this array.
+     *
+     * **Ids, never labels.** Each element is a stable slug; the visible text
+     * comes from the reader's own translation catalogue, keyed
+     * `accounts.accountCategory.<id>`. A label on the wire would paint every
+     * profile in the language of whoever picked it.
+     *
+     * Absent when the account has none — which is every `personal` account,
+     * and any non-personal one that has not chosen. A renderer reads
+     * `user.accountCategories ?? []`.
+     */
+    accountCategories: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodEnum<["news", "politics", "business", "startup", "finance", "crypto", "marketplace", "retail", "real_estate", "agency", "landlord", "cooperative", "architecture", "technology", "software", "ai", "security", "automation", "science", "education", "books", "health", "fitness", "sports", "gaming", "music", "film", "podcast", "art", "photography", "comedy", "food", "travel", "fashion", "home_garden", "diy", "automotive", "animals", "family", "nonprofit", "government", "community", "activism", "environment", "religion", "other"]>, "many">, ("news" | "politics" | "business" | "startup" | "finance" | "crypto" | "marketplace" | "retail" | "real_estate" | "agency" | "landlord" | "cooperative" | "architecture" | "technology" | "software" | "ai" | "security" | "automation" | "science" | "education" | "books" | "health" | "fitness" | "sports" | "gaming" | "music" | "film" | "podcast" | "art" | "photography" | "comedy" | "food" | "travel" | "fashion" | "home_garden" | "diy" | "automotive" | "animals" | "family" | "nonprofit" | "government" | "community" | "activism" | "environment" | "religion" | "other")[], ("news" | "politics" | "business" | "startup" | "finance" | "crypto" | "marketplace" | "retail" | "real_estate" | "agency" | "landlord" | "cooperative" | "architecture" | "technology" | "software" | "ai" | "security" | "automation" | "science" | "education" | "books" | "health" | "fitness" | "sports" | "gaming" | "music" | "film" | "podcast" | "art" | "photography" | "comedy" | "food" | "travel" | "fashion" | "home_garden" | "diy" | "automotive" | "animals" | "family" | "nonprofit" | "government" | "community" | "activism" | "environment" | "religion" | "other")[]>>;
+    /**
+     * The authenticated viewer's relationship to this profile. Present ONLY
+     * on single-profile fetches (`GET /profiles/username/:username`,
+     * `GET /users/:userId`) when the request is authenticated; OMITTED for
+     * anonymous requests and for the bulk `POST /users/by-ids` fan-out.
+     */
+    relationship: z.ZodOptional<z.ZodType<UserRelationship, z.ZodTypeDef, UserRelationship>>;
+    /**
+     * Portable theme preference. Rides the self/session payload (cold boot),
+     * so it is present on the current-user DTO (`GET /users/me`,
+     * `GET /session/user/:sessionId`) and absent until the user sets it.
+     */
+    themePreference: z.ZodOptional<z.ZodType<ThemePreference, z.ZodTypeDef, ThemePreference>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    /** MongoDB ObjectId as a string. Present on `formatUserResponse` output. */
+    id: z.ZodOptional<z.ZodString>;
+    /** Raw-document id (e.g. `GET /users/me`). Present when `id` is not. */
+    _id: z.ZodOptional<z.ZodString>;
+    publicKey: z.ZodOptional<z.ZodString>;
+    username: z.ZodOptional<z.ZodString>;
+    email: z.ZodOptional<z.ZodString>;
+    phone: z.ZodOptional<z.ZodString>;
+    address: z.ZodOptional<z.ZodString>;
+    birthday: z.ZodOptional<z.ZodString>;
+    /** Avatar file id (string) or null. */
+    avatar: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    /** Named Bloom color preset (e.g. `"blue"`) or null. */
+    color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    name: z.ZodType<UserNameResponse, z.ZodTypeDef, UserNameResponse>;
+    verified: z.ZodOptional<z.ZodBoolean>;
+    /**
+     * The account's languages as full BCP-47 locales (`language-REGION`,
+     * e.g. `es-ES`, `en-US`, `pt-BR`), ordered with the PRIMARY (UI) locale
+     * first. `languages[0]` is the primary locale — there is no singular
+     * `language` field.
+     */
+    languages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /**
+     * The account's self-sovereign identifier
+     * (`did:web:<FEDERATION_DOMAIN>:u:<userId>`). Surfaced as a `User`
+     * virtual; present on formatted DTOs once the identity layer is live.
+     */
+    did: z.ZodOptional<z.ZodString>;
+    /**
+     * Proven domain-ownership badges. Each is a {@link verifiedDomainSchema}
+     * entry; present only when the account has verified at least one domain.
+     */
+    verifiedDomains: z.ZodOptional<z.ZodArray<z.ZodType<import("./identity").VerifiedDomain, z.ZodTypeDef, import("./identity").VerifiedDomain>, "many">>;
+    /**
+     * Account-graph classification — what KIND of account this is.
+     *
+     * ORTHOGONAL to `type` (`local` / `federated` / `agent` / `automated`),
+     * which says where the account lives and how it is driven; the two
+     * coexist and neither substitutes for the other. A `channel` is a
+     * publishing identity nobody can act as, so a consumer that renders
+     * authored content reads THIS to tell a channel's post from a person's.
+     *
+     * Optional because a DTO produced from a source that never carried the
+     * column omits it; absent should be read as `personal`, the column's
+     * default, not as unknown.
+     */
+    kind: z.ZodOptional<z.ZodEnum<["personal", "organization", "project", "bot", "channel"]>>;
+    /**
+     * What this account is about — the field a profile screen RENDERS.
+     *
+     * **Ordered, primary first.** `accountCategories[0]` is the primary
+     * category; there is deliberately no sibling `primaryCategory` field,
+     * because two representations of one fact can disagree (see rule 2 in
+     * `accountGraph.ts`). Nothing downstream may sort, de-duplicate or
+     * otherwise reorder this array.
+     *
+     * **Ids, never labels.** Each element is a stable slug; the visible text
+     * comes from the reader's own translation catalogue, keyed
+     * `accounts.accountCategory.<id>`. A label on the wire would paint every
+     * profile in the language of whoever picked it.
+     *
+     * Absent when the account has none — which is every `personal` account,
+     * and any non-personal one that has not chosen. A renderer reads
+     * `user.accountCategories ?? []`.
+     */
+    accountCategories: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodEnum<["news", "politics", "business", "startup", "finance", "crypto", "marketplace", "retail", "real_estate", "agency", "landlord", "cooperative", "architecture", "technology", "software", "ai", "security", "automation", "science", "education", "books", "health", "fitness", "sports", "gaming", "music", "film", "podcast", "art", "photography", "comedy", "food", "travel", "fashion", "home_garden", "diy", "automotive", "animals", "family", "nonprofit", "government", "community", "activism", "environment", "religion", "other"]>, "many">, ("news" | "politics" | "business" | "startup" | "finance" | "crypto" | "marketplace" | "retail" | "real_estate" | "agency" | "landlord" | "cooperative" | "architecture" | "technology" | "software" | "ai" | "security" | "automation" | "science" | "education" | "books" | "health" | "fitness" | "sports" | "gaming" | "music" | "film" | "podcast" | "art" | "photography" | "comedy" | "food" | "travel" | "fashion" | "home_garden" | "diy" | "automotive" | "animals" | "family" | "nonprofit" | "government" | "community" | "activism" | "environment" | "religion" | "other")[], ("news" | "politics" | "business" | "startup" | "finance" | "crypto" | "marketplace" | "retail" | "real_estate" | "agency" | "landlord" | "cooperative" | "architecture" | "technology" | "software" | "ai" | "security" | "automation" | "science" | "education" | "books" | "health" | "fitness" | "sports" | "gaming" | "music" | "film" | "podcast" | "art" | "photography" | "comedy" | "food" | "travel" | "fashion" | "home_garden" | "diy" | "automotive" | "animals" | "family" | "nonprofit" | "government" | "community" | "activism" | "environment" | "religion" | "other")[]>>;
+    /**
+     * The authenticated viewer's relationship to this profile. Present ONLY
+     * on single-profile fetches (`GET /profiles/username/:username`,
+     * `GET /users/:userId`) when the request is authenticated; OMITTED for
+     * anonymous requests and for the bulk `POST /users/by-ids` fan-out.
+     */
+    relationship: z.ZodOptional<z.ZodType<UserRelationship, z.ZodTypeDef, UserRelationship>>;
+    /**
+     * Portable theme preference. Rides the self/session payload (cold boot),
+     * so it is present on the current-user DTO (`GET /users/me`,
+     * `GET /session/user/:sessionId`) and absent until the user sets it.
+     */
+    themePreference: z.ZodOptional<z.ZodType<ThemePreference, z.ZodTypeDef, ThemePreference>>;
+}, z.ZodTypeAny, "passthrough">>;
+export type UserResponse = z.infer<typeof userResponseSchema>;
+export declare const userProfileUpdateSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodObject<{
+        first: z.ZodOptional<z.ZodString>;
+        last: z.ZodOptional<z.ZodString>;
+        /**
+         * Explicit display name, stored rather than composed. Wins over
+         * `first`/`last` when set; send `''` to clear it and fall back
+         * to the composed pair.
+         */
+        displayName: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        first?: string | undefined;
+        last?: string | undefined;
+        displayName?: string | undefined;
+    }, {
+        first?: string | undefined;
+        last?: string | undefined;
+        displayName?: string | undefined;
+    }>>;
+    username: z.ZodOptional<z.ZodString>;
+    email: z.ZodOptional<z.ZodString>;
+    avatar: z.ZodOptional<z.ZodString>;
+    color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    bio: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    phone: z.ZodOptional<z.ZodString>;
+    address: z.ZodOptional<z.ZodString>;
+    birthday: z.ZodOptional<z.ZodString>;
+    locations: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
+    links: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    linksMetadata: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        image: z.ZodOptional<z.ZodString>;
+        id: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        description?: string | undefined;
+        id?: string | undefined;
+        title?: string | undefined;
+        image?: string | undefined;
+    }, {
+        url: string;
+        description?: string | undefined;
+        id?: string | undefined;
+        title?: string | undefined;
+        image?: string | undefined;
+    }>, "many">>;
+    /**
+     * Ordered account locales (`language-REGION`), primary first. Replaces
+     * the eliminated singular `language`; `languages[0]` is the primary UI
+     * locale.
+     */
+    languages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    accountExpiresAfterInactivityDays: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    notificationPreferences: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    userPreferences: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    privacySettings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    /**
+     * Portable theme preference. Written through the same `PUT /users/me`
+     * settings-update path as `languages`/`userPreferences`.
+     */
+    themePreference: z.ZodOptional<z.ZodType<ThemePreference, z.ZodTypeDef, ThemePreference>>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    name: z.ZodOptional<z.ZodObject<{
+        first: z.ZodOptional<z.ZodString>;
+        last: z.ZodOptional<z.ZodString>;
+        /**
+         * Explicit display name, stored rather than composed. Wins over
+         * `first`/`last` when set; send `''` to clear it and fall back
+         * to the composed pair.
+         */
+        displayName: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        first?: string | undefined;
+        last?: string | undefined;
+        displayName?: string | undefined;
+    }, {
+        first?: string | undefined;
+        last?: string | undefined;
+        displayName?: string | undefined;
+    }>>;
+    username: z.ZodOptional<z.ZodString>;
+    email: z.ZodOptional<z.ZodString>;
+    avatar: z.ZodOptional<z.ZodString>;
+    color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    bio: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    phone: z.ZodOptional<z.ZodString>;
+    address: z.ZodOptional<z.ZodString>;
+    birthday: z.ZodOptional<z.ZodString>;
+    locations: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
+    links: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    linksMetadata: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        image: z.ZodOptional<z.ZodString>;
+        id: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        description?: string | undefined;
+        id?: string | undefined;
+        title?: string | undefined;
+        image?: string | undefined;
+    }, {
+        url: string;
+        description?: string | undefined;
+        id?: string | undefined;
+        title?: string | undefined;
+        image?: string | undefined;
+    }>, "many">>;
+    /**
+     * Ordered account locales (`language-REGION`), primary first. Replaces
+     * the eliminated singular `language`; `languages[0]` is the primary UI
+     * locale.
+     */
+    languages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    accountExpiresAfterInactivityDays: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    notificationPreferences: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    userPreferences: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    privacySettings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    /**
+     * Portable theme preference. Written through the same `PUT /users/me`
+     * settings-update path as `languages`/`userPreferences`.
+     */
+    themePreference: z.ZodOptional<z.ZodType<ThemePreference, z.ZodTypeDef, ThemePreference>>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    name: z.ZodOptional<z.ZodObject<{
+        first: z.ZodOptional<z.ZodString>;
+        last: z.ZodOptional<z.ZodString>;
+        /**
+         * Explicit display name, stored rather than composed. Wins over
+         * `first`/`last` when set; send `''` to clear it and fall back
+         * to the composed pair.
+         */
+        displayName: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        first?: string | undefined;
+        last?: string | undefined;
+        displayName?: string | undefined;
+    }, {
+        first?: string | undefined;
+        last?: string | undefined;
+        displayName?: string | undefined;
+    }>>;
+    username: z.ZodOptional<z.ZodString>;
+    email: z.ZodOptional<z.ZodString>;
+    avatar: z.ZodOptional<z.ZodString>;
+    color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    bio: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    phone: z.ZodOptional<z.ZodString>;
+    address: z.ZodOptional<z.ZodString>;
+    birthday: z.ZodOptional<z.ZodString>;
+    locations: z.ZodOptional<z.ZodArray<z.ZodUnknown, "many">>;
+    links: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    linksMetadata: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        url: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        image: z.ZodOptional<z.ZodString>;
+        id: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+        description?: string | undefined;
+        id?: string | undefined;
+        title?: string | undefined;
+        image?: string | undefined;
+    }, {
+        url: string;
+        description?: string | undefined;
+        id?: string | undefined;
+        title?: string | undefined;
+        image?: string | undefined;
+    }>, "many">>;
+    /**
+     * Ordered account locales (`language-REGION`), primary first. Replaces
+     * the eliminated singular `language`; `languages[0]` is the primary UI
+     * locale.
+     */
+    languages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    accountExpiresAfterInactivityDays: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+    notificationPreferences: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    userPreferences: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    privacySettings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    /**
+     * Portable theme preference. Written through the same `PUT /users/me`
+     * settings-update path as `languages`/`userPreferences`.
+     */
+    themePreference: z.ZodOptional<z.ZodType<ThemePreference, z.ZodTypeDef, ThemePreference>>;
+}, z.ZodTypeAny, "passthrough">>;
+export type UserProfileUpdate = z.infer<typeof userProfileUpdateSchema>;
+/**
+ * Resolve the canonical user id from a {@link UserResponse}, accepting either
+ * the `formatUserResponse` `id` field or the raw-document `_id` field.
+ */
+export declare function resolveUserId(user: UserResponse): string | undefined;
+/**
+ * Wire shape of `GET /users/me` — the API success envelope (`{ data: <user> }`)
+ * wrapping the current-user DTO. Some older producers use `_id` instead of
+ * `id`; resolve via {@link resolveUserId}. The display name still lives under
+ * `name.displayName`.
+ */
+export declare const currentUserResponseSchema: z.ZodObject<{
+    data: z.ZodObject<{
+        /** MongoDB ObjectId as a string. Present on `formatUserResponse` output. */
+        id: z.ZodOptional<z.ZodString>;
+        /** Raw-document id (e.g. `GET /users/me`). Present when `id` is not. */
+        _id: z.ZodOptional<z.ZodString>;
+        publicKey: z.ZodOptional<z.ZodString>;
+        username: z.ZodOptional<z.ZodString>;
+        email: z.ZodOptional<z.ZodString>;
+        phone: z.ZodOptional<z.ZodString>;
+        address: z.ZodOptional<z.ZodString>;
+        birthday: z.ZodOptional<z.ZodString>;
+        /** Avatar file id (string) or null. */
+        avatar: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** Named Bloom color preset (e.g. `"blue"`) or null. */
+        color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        name: z.ZodType<UserNameResponse, z.ZodTypeDef, UserNameResponse>;
+        verified: z.ZodOptional<z.ZodBoolean>;
+        /**
+         * The account's languages as full BCP-47 locales (`language-REGION`,
+         * e.g. `es-ES`, `en-US`, `pt-BR`), ordered with the PRIMARY (UI) locale
+         * first. `languages[0]` is the primary locale — there is no singular
+         * `language` field.
+         */
+        languages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /**
+         * The account's self-sovereign identifier
+         * (`did:web:<FEDERATION_DOMAIN>:u:<userId>`). Surfaced as a `User`
+         * virtual; present on formatted DTOs once the identity layer is live.
+         */
+        did: z.ZodOptional<z.ZodString>;
+        /**
+         * Proven domain-ownership badges. Each is a {@link verifiedDomainSchema}
+         * entry; present only when the account has verified at least one domain.
+         */
+        verifiedDomains: z.ZodOptional<z.ZodArray<z.ZodType<import("./identity").VerifiedDomain, z.ZodTypeDef, import("./identity").VerifiedDomain>, "many">>;
+        /**
+         * Account-graph classification — what KIND of account this is.
+         *
+         * ORTHOGONAL to `type` (`local` / `federated` / `agent` / `automated`),
+         * which says where the account lives and how it is driven; the two
+         * coexist and neither substitutes for the other. A `channel` is a
+         * publishing identity nobody can act as, so a consumer that renders
+         * authored content reads THIS to tell a channel's post from a person's.
+         *
+         * Optional because a DTO produced from a source that never carried the
+         * column omits it; absent should be read as `personal`, the column's
+         * default, not as unknown.
+         */
+        kind: z.ZodOptional<z.ZodEnum<["personal", "organization", "project", "bot", "channel"]>>;
+        /**
+         * What this account is about — the field a profile screen RENDERS.
+         *
+         * **Ordered, primary first.** `accountCategories[0]` is the primary
+         * category; there is deliberately no sibling `primaryCategory` field,
+         * because two representations of one fact can disagree (see rule 2 in
+         * `accountGraph.ts`). Nothing downstream may sort, de-duplicate or
+         * otherwise reorder this array.
+         *
+         * **Ids, never labels.** Each element is a stable slug; the visible text
+         * comes from the reader's own translation catalogue, keyed
+         * `accounts.accountCategory.<id>`. A label on the wire would paint every
+         * profile in the language of whoever picked it.
+         *
+         * Absent when the account has none — which is every `personal` account,
+         * and any non-personal one that has not chosen. A renderer reads
+         * `user.accountCategories ?? []`.
+         */
+        accountCategories: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodEnum<["news", "politics", "business", "startup", "finance", "crypto", "marketplace", "retail", "real_estate", "agency", "landlord", "cooperative", "architecture", "technology", "software", "ai", "security", "automation", "science", "education", "books", "health", "fitness", "sports", "gaming", "music", "film", "podcast", "art", "photography", "comedy", "food", "travel", "fashion", "home_garden", "diy", "automotive", "animals", "family", "nonprofit", "government", "community", "activism", "environment", "religion", "other"]>, "many">, ("news" | "politics" | "business" | "startup" | "finance" | "crypto" | "marketplace" | "retail" | "real_estate" | "agency" | "landlord" | "cooperative" | "architecture" | "technology" | "software" | "ai" | "security" | "automation" | "science" | "education" | "books" | "health" | "fitness" | "sports" | "gaming" | "music" | "film" | "podcast" | "art" | "photography" | "comedy" | "food" | "travel" | "fashion" | "home_garden" | "diy" | "automotive" | "animals" | "family" | "nonprofit" | "government" | "community" | "activism" | "environment" | "religion" | "other")[], ("news" | "politics" | "business" | "startup" | "finance" | "crypto" | "marketplace" | "retail" | "real_estate" | "agency" | "landlord" | "cooperative" | "architecture" | "technology" | "software" | "ai" | "security" | "automation" | "science" | "education" | "books" | "health" | "fitness" | "sports" | "gaming" | "music" | "film" | "podcast" | "art" | "photography" | "comedy" | "food" | "travel" | "fashion" | "home_garden" | "diy" | "automotive" | "animals" | "family" | "nonprofit" | "government" | "community" | "activism" | "environment" | "religion" | "other")[]>>;
+        /**
+         * The authenticated viewer's relationship to this profile. Present ONLY
+         * on single-profile fetches (`GET /profiles/username/:username`,
+         * `GET /users/:userId`) when the request is authenticated; OMITTED for
+         * anonymous requests and for the bulk `POST /users/by-ids` fan-out.
+         */
+        relationship: z.ZodOptional<z.ZodType<UserRelationship, z.ZodTypeDef, UserRelationship>>;
+        /**
+         * Portable theme preference. Rides the self/session payload (cold boot),
+         * so it is present on the current-user DTO (`GET /users/me`,
+         * `GET /session/user/:sessionId`) and absent until the user sets it.
+         */
+        themePreference: z.ZodOptional<z.ZodType<ThemePreference, z.ZodTypeDef, ThemePreference>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        /** MongoDB ObjectId as a string. Present on `formatUserResponse` output. */
+        id: z.ZodOptional<z.ZodString>;
+        /** Raw-document id (e.g. `GET /users/me`). Present when `id` is not. */
+        _id: z.ZodOptional<z.ZodString>;
+        publicKey: z.ZodOptional<z.ZodString>;
+        username: z.ZodOptional<z.ZodString>;
+        email: z.ZodOptional<z.ZodString>;
+        phone: z.ZodOptional<z.ZodString>;
+        address: z.ZodOptional<z.ZodString>;
+        birthday: z.ZodOptional<z.ZodString>;
+        /** Avatar file id (string) or null. */
+        avatar: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** Named Bloom color preset (e.g. `"blue"`) or null. */
+        color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        name: z.ZodType<UserNameResponse, z.ZodTypeDef, UserNameResponse>;
+        verified: z.ZodOptional<z.ZodBoolean>;
+        /**
+         * The account's languages as full BCP-47 locales (`language-REGION`,
+         * e.g. `es-ES`, `en-US`, `pt-BR`), ordered with the PRIMARY (UI) locale
+         * first. `languages[0]` is the primary locale — there is no singular
+         * `language` field.
+         */
+        languages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /**
+         * The account's self-sovereign identifier
+         * (`did:web:<FEDERATION_DOMAIN>:u:<userId>`). Surfaced as a `User`
+         * virtual; present on formatted DTOs once the identity layer is live.
+         */
+        did: z.ZodOptional<z.ZodString>;
+        /**
+         * Proven domain-ownership badges. Each is a {@link verifiedDomainSchema}
+         * entry; present only when the account has verified at least one domain.
+         */
+        verifiedDomains: z.ZodOptional<z.ZodArray<z.ZodType<import("./identity").VerifiedDomain, z.ZodTypeDef, import("./identity").VerifiedDomain>, "many">>;
+        /**
+         * Account-graph classification — what KIND of account this is.
+         *
+         * ORTHOGONAL to `type` (`local` / `federated` / `agent` / `automated`),
+         * which says where the account lives and how it is driven; the two
+         * coexist and neither substitutes for the other. A `channel` is a
+         * publishing identity nobody can act as, so a consumer that renders
+         * authored content reads THIS to tell a channel's post from a person's.
+         *
+         * Optional because a DTO produced from a source that never carried the
+         * column omits it; absent should be read as `personal`, the column's
+         * default, not as unknown.
+         */
+        kind: z.ZodOptional<z.ZodEnum<["personal", "organization", "project", "bot", "channel"]>>;
+        /**
+         * What this account is about — the field a profile screen RENDERS.
+         *
+         * **Ordered, primary first.** `accountCategories[0]` is the primary
+         * category; there is deliberately no sibling `primaryCategory` field,
+         * because two representations of one fact can disagree (see rule 2 in
+         * `accountGraph.ts`). Nothing downstream may sort, de-duplicate or
+         * otherwise reorder this array.
+         *
+         * **Ids, never labels.** Each element is a stable slug; the visible text
+         * comes from the reader's own translation catalogue, keyed
+         * `accounts.accountCategory.<id>`. A label on the wire would paint every
+         * profile in the language of whoever picked it.
+         *
+         * Absent when the account has none — which is every `personal` account,
+         * and any non-personal one that has not chosen. A renderer reads
+         * `user.accountCategories ?? []`.
+         */
+        accountCategories: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodEnum<["news", "politics", "business", "startup", "finance", "crypto", "marketplace", "retail", "real_estate", "agency", "landlord", "cooperative", "architecture", "technology", "software", "ai", "security", "automation", "science", "education", "books", "health", "fitness", "sports", "gaming", "music", "film", "podcast", "art", "photography", "comedy", "food", "travel", "fashion", "home_garden", "diy", "automotive", "animals", "family", "nonprofit", "government", "community", "activism", "environment", "religion", "other"]>, "many">, ("news" | "politics" | "business" | "startup" | "finance" | "crypto" | "marketplace" | "retail" | "real_estate" | "agency" | "landlord" | "cooperative" | "architecture" | "technology" | "software" | "ai" | "security" | "automation" | "science" | "education" | "books" | "health" | "fitness" | "sports" | "gaming" | "music" | "film" | "podcast" | "art" | "photography" | "comedy" | "food" | "travel" | "fashion" | "home_garden" | "diy" | "automotive" | "animals" | "family" | "nonprofit" | "government" | "community" | "activism" | "environment" | "religion" | "other")[], ("news" | "politics" | "business" | "startup" | "finance" | "crypto" | "marketplace" | "retail" | "real_estate" | "agency" | "landlord" | "cooperative" | "architecture" | "technology" | "software" | "ai" | "security" | "automation" | "science" | "education" | "books" | "health" | "fitness" | "sports" | "gaming" | "music" | "film" | "podcast" | "art" | "photography" | "comedy" | "food" | "travel" | "fashion" | "home_garden" | "diy" | "automotive" | "animals" | "family" | "nonprofit" | "government" | "community" | "activism" | "environment" | "religion" | "other")[]>>;
+        /**
+         * The authenticated viewer's relationship to this profile. Present ONLY
+         * on single-profile fetches (`GET /profiles/username/:username`,
+         * `GET /users/:userId`) when the request is authenticated; OMITTED for
+         * anonymous requests and for the bulk `POST /users/by-ids` fan-out.
+         */
+        relationship: z.ZodOptional<z.ZodType<UserRelationship, z.ZodTypeDef, UserRelationship>>;
+        /**
+         * Portable theme preference. Rides the self/session payload (cold boot),
+         * so it is present on the current-user DTO (`GET /users/me`,
+         * `GET /session/user/:sessionId`) and absent until the user sets it.
+         */
+        themePreference: z.ZodOptional<z.ZodType<ThemePreference, z.ZodTypeDef, ThemePreference>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        /** MongoDB ObjectId as a string. Present on `formatUserResponse` output. */
+        id: z.ZodOptional<z.ZodString>;
+        /** Raw-document id (e.g. `GET /users/me`). Present when `id` is not. */
+        _id: z.ZodOptional<z.ZodString>;
+        publicKey: z.ZodOptional<z.ZodString>;
+        username: z.ZodOptional<z.ZodString>;
+        email: z.ZodOptional<z.ZodString>;
+        phone: z.ZodOptional<z.ZodString>;
+        address: z.ZodOptional<z.ZodString>;
+        birthday: z.ZodOptional<z.ZodString>;
+        /** Avatar file id (string) or null. */
+        avatar: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** Named Bloom color preset (e.g. `"blue"`) or null. */
+        color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        name: z.ZodType<UserNameResponse, z.ZodTypeDef, UserNameResponse>;
+        verified: z.ZodOptional<z.ZodBoolean>;
+        /**
+         * The account's languages as full BCP-47 locales (`language-REGION`,
+         * e.g. `es-ES`, `en-US`, `pt-BR`), ordered with the PRIMARY (UI) locale
+         * first. `languages[0]` is the primary locale — there is no singular
+         * `language` field.
+         */
+        languages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /**
+         * The account's self-sovereign identifier
+         * (`did:web:<FEDERATION_DOMAIN>:u:<userId>`). Surfaced as a `User`
+         * virtual; present on formatted DTOs once the identity layer is live.
+         */
+        did: z.ZodOptional<z.ZodString>;
+        /**
+         * Proven domain-ownership badges. Each is a {@link verifiedDomainSchema}
+         * entry; present only when the account has verified at least one domain.
+         */
+        verifiedDomains: z.ZodOptional<z.ZodArray<z.ZodType<import("./identity").VerifiedDomain, z.ZodTypeDef, import("./identity").VerifiedDomain>, "many">>;
+        /**
+         * Account-graph classification — what KIND of account this is.
+         *
+         * ORTHOGONAL to `type` (`local` / `federated` / `agent` / `automated`),
+         * which says where the account lives and how it is driven; the two
+         * coexist and neither substitutes for the other. A `channel` is a
+         * publishing identity nobody can act as, so a consumer that renders
+         * authored content reads THIS to tell a channel's post from a person's.
+         *
+         * Optional because a DTO produced from a source that never carried the
+         * column omits it; absent should be read as `personal`, the column's
+         * default, not as unknown.
+         */
+        kind: z.ZodOptional<z.ZodEnum<["personal", "organization", "project", "bot", "channel"]>>;
+        /**
+         * What this account is about — the field a profile screen RENDERS.
+         *
+         * **Ordered, primary first.** `accountCategories[0]` is the primary
+         * category; there is deliberately no sibling `primaryCategory` field,
+         * because two representations of one fact can disagree (see rule 2 in
+         * `accountGraph.ts`). Nothing downstream may sort, de-duplicate or
+         * otherwise reorder this array.
+         *
+         * **Ids, never labels.** Each element is a stable slug; the visible text
+         * comes from the reader's own translation catalogue, keyed
+         * `accounts.accountCategory.<id>`. A label on the wire would paint every
+         * profile in the language of whoever picked it.
+         *
+         * Absent when the account has none — which is every `personal` account,
+         * and any non-personal one that has not chosen. A renderer reads
+         * `user.accountCategories ?? []`.
+         */
+        accountCategories: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodEnum<["news", "politics", "business", "startup", "finance", "crypto", "marketplace", "retail", "real_estate", "agency", "landlord", "cooperative", "architecture", "technology", "software", "ai", "security", "automation", "science", "education", "books", "health", "fitness", "sports", "gaming", "music", "film", "podcast", "art", "photography", "comedy", "food", "travel", "fashion", "home_garden", "diy", "automotive", "animals", "family", "nonprofit", "government", "community", "activism", "environment", "religion", "other"]>, "many">, ("news" | "politics" | "business" | "startup" | "finance" | "crypto" | "marketplace" | "retail" | "real_estate" | "agency" | "landlord" | "cooperative" | "architecture" | "technology" | "software" | "ai" | "security" | "automation" | "science" | "education" | "books" | "health" | "fitness" | "sports" | "gaming" | "music" | "film" | "podcast" | "art" | "photography" | "comedy" | "food" | "travel" | "fashion" | "home_garden" | "diy" | "automotive" | "animals" | "family" | "nonprofit" | "government" | "community" | "activism" | "environment" | "religion" | "other")[], ("news" | "politics" | "business" | "startup" | "finance" | "crypto" | "marketplace" | "retail" | "real_estate" | "agency" | "landlord" | "cooperative" | "architecture" | "technology" | "software" | "ai" | "security" | "automation" | "science" | "education" | "books" | "health" | "fitness" | "sports" | "gaming" | "music" | "film" | "podcast" | "art" | "photography" | "comedy" | "food" | "travel" | "fashion" | "home_garden" | "diy" | "automotive" | "animals" | "family" | "nonprofit" | "government" | "community" | "activism" | "environment" | "religion" | "other")[]>>;
+        /**
+         * The authenticated viewer's relationship to this profile. Present ONLY
+         * on single-profile fetches (`GET /profiles/username/:username`,
+         * `GET /users/:userId`) when the request is authenticated; OMITTED for
+         * anonymous requests and for the bulk `POST /users/by-ids` fan-out.
+         */
+        relationship: z.ZodOptional<z.ZodType<UserRelationship, z.ZodTypeDef, UserRelationship>>;
+        /**
+         * Portable theme preference. Rides the self/session payload (cold boot),
+         * so it is present on the current-user DTO (`GET /users/me`,
+         * `GET /session/user/:sessionId`) and absent until the user sets it.
+         */
+        themePreference: z.ZodOptional<z.ZodType<ThemePreference, z.ZodTypeDef, ThemePreference>>;
+    }, z.ZodTypeAny, "passthrough">>;
+}, "strip", z.ZodTypeAny, {
+    data: {
+        name: UserNameResponse;
+        kind?: "bot" | "personal" | "organization" | "project" | "channel" | undefined;
+        username?: string | undefined;
+        avatar?: string | null | undefined;
+        color?: string | null | undefined;
+        accountCategories?: ("news" | "politics" | "business" | "startup" | "finance" | "crypto" | "marketplace" | "retail" | "real_estate" | "agency" | "landlord" | "cooperative" | "architecture" | "technology" | "software" | "ai" | "security" | "automation" | "science" | "education" | "books" | "health" | "fitness" | "sports" | "gaming" | "music" | "film" | "podcast" | "art" | "photography" | "comedy" | "food" | "travel" | "fashion" | "home_garden" | "diy" | "automotive" | "animals" | "family" | "nonprofit" | "government" | "community" | "activism" | "environment" | "religion" | "other")[] | undefined;
+        id?: string | undefined;
+        publicKey?: string | undefined;
+        did?: string | undefined;
+        verifiedDomains?: import("./identity").VerifiedDomain[] | undefined;
+        _id?: string | undefined;
+        email?: string | undefined;
+        phone?: string | undefined;
+        address?: string | undefined;
+        birthday?: string | undefined;
+        verified?: boolean | undefined;
+        languages?: string[] | undefined;
+        relationship?: UserRelationship | undefined;
+        themePreference?: ThemePreference | undefined;
+    } & {
+        [k: string]: unknown;
+    };
+}, {
+    data: {
+        name: UserNameResponse;
+        kind?: "bot" | "personal" | "organization" | "project" | "channel" | undefined;
+        username?: string | undefined;
+        avatar?: string | null | undefined;
+        color?: string | null | undefined;
+        accountCategories?: ("news" | "politics" | "business" | "startup" | "finance" | "crypto" | "marketplace" | "retail" | "real_estate" | "agency" | "landlord" | "cooperative" | "architecture" | "technology" | "software" | "ai" | "security" | "automation" | "science" | "education" | "books" | "health" | "fitness" | "sports" | "gaming" | "music" | "film" | "podcast" | "art" | "photography" | "comedy" | "food" | "travel" | "fashion" | "home_garden" | "diy" | "automotive" | "animals" | "family" | "nonprofit" | "government" | "community" | "activism" | "environment" | "religion" | "other")[] | undefined;
+        id?: string | undefined;
+        publicKey?: string | undefined;
+        did?: string | undefined;
+        verifiedDomains?: import("./identity").VerifiedDomain[] | undefined;
+        _id?: string | undefined;
+        email?: string | undefined;
+        phone?: string | undefined;
+        address?: string | undefined;
+        birthday?: string | undefined;
+        verified?: boolean | undefined;
+        languages?: string[] | undefined;
+        relationship?: UserRelationship | undefined;
+        themePreference?: ThemePreference | undefined;
+    } & {
+        [k: string]: unknown;
+    };
+}>;
+export type CurrentUserResponseContract = z.infer<typeof currentUserResponseSchema>;
+/**
+ * One entry of `GET /session/device/sessions/:sessionId` — the deduplicated
+ * accounts signed in on this physical device (one per user, most recent
+ * session). Backs the multi-account chooser. The embedded user mirrors
+ * `formatUserResponse`; it is nullable on slots that lost their user document.
+ */
+export declare const deviceLinkedSessionSchema: z.ZodObject<{
+    sessionId: z.ZodString;
+    isCurrent: z.ZodOptional<z.ZodBoolean>;
+    user: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        /** MongoDB ObjectId as a string. Present on `formatUserResponse` output. */
+        id: z.ZodOptional<z.ZodString>;
+        /** Raw-document id (e.g. `GET /users/me`). Present when `id` is not. */
+        _id: z.ZodOptional<z.ZodString>;
+        publicKey: z.ZodOptional<z.ZodString>;
+        username: z.ZodOptional<z.ZodString>;
+        email: z.ZodOptional<z.ZodString>;
+        phone: z.ZodOptional<z.ZodString>;
+        address: z.ZodOptional<z.ZodString>;
+        birthday: z.ZodOptional<z.ZodString>;
+        /** Avatar file id (string) or null. */
+        avatar: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** Named Bloom color preset (e.g. `"blue"`) or null. */
+        color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        name: z.ZodType<UserNameResponse, z.ZodTypeDef, UserNameResponse>;
+        verified: z.ZodOptional<z.ZodBoolean>;
+        /**
+         * The account's languages as full BCP-47 locales (`language-REGION`,
+         * e.g. `es-ES`, `en-US`, `pt-BR`), ordered with the PRIMARY (UI) locale
+         * first. `languages[0]` is the primary locale — there is no singular
+         * `language` field.
+         */
+        languages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /**
+         * The account's self-sovereign identifier
+         * (`did:web:<FEDERATION_DOMAIN>:u:<userId>`). Surfaced as a `User`
+         * virtual; present on formatted DTOs once the identity layer is live.
+         */
+        did: z.ZodOptional<z.ZodString>;
+        /**
+         * Proven domain-ownership badges. Each is a {@link verifiedDomainSchema}
+         * entry; present only when the account has verified at least one domain.
+         */
+        verifiedDomains: z.ZodOptional<z.ZodArray<z.ZodType<import("./identity").VerifiedDomain, z.ZodTypeDef, import("./identity").VerifiedDomain>, "many">>;
+        /**
+         * Account-graph classification — what KIND of account this is.
+         *
+         * ORTHOGONAL to `type` (`local` / `federated` / `agent` / `automated`),
+         * which says where the account lives and how it is driven; the two
+         * coexist and neither substitutes for the other. A `channel` is a
+         * publishing identity nobody can act as, so a consumer that renders
+         * authored content reads THIS to tell a channel's post from a person's.
+         *
+         * Optional because a DTO produced from a source that never carried the
+         * column omits it; absent should be read as `personal`, the column's
+         * default, not as unknown.
+         */
+        kind: z.ZodOptional<z.ZodEnum<["personal", "organization", "project", "bot", "channel"]>>;
+        /**
+         * What this account is about — the field a profile screen RENDERS.
+         *
+         * **Ordered, primary first.** `accountCategories[0]` is the primary
+         * category; there is deliberately no sibling `primaryCategory` field,
+         * because two representations of one fact can disagree (see rule 2 in
+         * `accountGraph.ts`). Nothing downstream may sort, de-duplicate or
+         * otherwise reorder this array.
+         *
+         * **Ids, never labels.** Each element is a stable slug; the visible text
+         * comes from the reader's own translation catalogue, keyed
+         * `accounts.accountCategory.<id>`. A label on the wire would paint every
+         * profile in the language of whoever picked it.
+         *
+         * Absent when the account has none — which is every `personal` account,
+         * and any non-personal one that has not chosen. A renderer reads
+         * `user.accountCategories ?? []`.
+         */
+        accountCategories: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodEnum<["news", "politics", "business", "startup", "finance", "crypto", "marketplace", "retail", "real_estate", "agency", "landlord", "cooperative", "architecture", "technology", "software", "ai", "security", "automation", "science", "education", "books", "health", "fitness", "sports", "gaming", "music", "film", "podcast", "art", "photography", "comedy", "food", "travel", "fashion", "home_garden", "diy", "automotive", "animals", "family", "nonprofit", "government", "community", "activism", "environment", "religion", "other"]>, "many">, ("news" | "politics" | "business" | "startup" | "finance" | "crypto" | "marketplace" | "retail" | "real_estate" | "agency" | "landlord" | "cooperative" | "architecture" | "technology" | "software" | "ai" | "security" | "automation" | "science" | "education" | "books" | "health" | "fitness" | "sports" | "gaming" | "music" | "film" | "podcast" | "art" | "photography" | "comedy" | "food" | "travel" | "fashion" | "home_garden" | "diy" | "automotive" | "animals" | "family" | "nonprofit" | "government" | "community" | "activism" | "environment" | "religion" | "other")[], ("news" | "politics" | "business" | "startup" | "finance" | "crypto" | "marketplace" | "retail" | "real_estate" | "agency" | "landlord" | "cooperative" | "architecture" | "technology" | "software" | "ai" | "security" | "automation" | "science" | "education" | "books" | "health" | "fitness" | "sports" | "gaming" | "music" | "film" | "podcast" | "art" | "photography" | "comedy" | "food" | "travel" | "fashion" | "home_garden" | "diy" | "automotive" | "animals" | "family" | "nonprofit" | "government" | "community" | "activism" | "environment" | "religion" | "other")[]>>;
+        /**
+         * The authenticated viewer's relationship to this profile. Present ONLY
+         * on single-profile fetches (`GET /profiles/username/:username`,
+         * `GET /users/:userId`) when the request is authenticated; OMITTED for
+         * anonymous requests and for the bulk `POST /users/by-ids` fan-out.
+         */
+        relationship: z.ZodOptional<z.ZodType<UserRelationship, z.ZodTypeDef, UserRelationship>>;
+        /**
+         * Portable theme preference. Rides the self/session payload (cold boot),
+         * so it is present on the current-user DTO (`GET /users/me`,
+         * `GET /session/user/:sessionId`) and absent until the user sets it.
+         */
+        themePreference: z.ZodOptional<z.ZodType<ThemePreference, z.ZodTypeDef, ThemePreference>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        /** MongoDB ObjectId as a string. Present on `formatUserResponse` output. */
+        id: z.ZodOptional<z.ZodString>;
+        /** Raw-document id (e.g. `GET /users/me`). Present when `id` is not. */
+        _id: z.ZodOptional<z.ZodString>;
+        publicKey: z.ZodOptional<z.ZodString>;
+        username: z.ZodOptional<z.ZodString>;
+        email: z.ZodOptional<z.ZodString>;
+        phone: z.ZodOptional<z.ZodString>;
+        address: z.ZodOptional<z.ZodString>;
+        birthday: z.ZodOptional<z.ZodString>;
+        /** Avatar file id (string) or null. */
+        avatar: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** Named Bloom color preset (e.g. `"blue"`) or null. */
+        color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        name: z.ZodType<UserNameResponse, z.ZodTypeDef, UserNameResponse>;
+        verified: z.ZodOptional<z.ZodBoolean>;
+        /**
+         * The account's languages as full BCP-47 locales (`language-REGION`,
+         * e.g. `es-ES`, `en-US`, `pt-BR`), ordered with the PRIMARY (UI) locale
+         * first. `languages[0]` is the primary locale — there is no singular
+         * `language` field.
+         */
+        languages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /**
+         * The account's self-sovereign identifier
+         * (`did:web:<FEDERATION_DOMAIN>:u:<userId>`). Surfaced as a `User`
+         * virtual; present on formatted DTOs once the identity layer is live.
+         */
+        did: z.ZodOptional<z.ZodString>;
+        /**
+         * Proven domain-ownership badges. Each is a {@link verifiedDomainSchema}
+         * entry; present only when the account has verified at least one domain.
+         */
+        verifiedDomains: z.ZodOptional<z.ZodArray<z.ZodType<import("./identity").VerifiedDomain, z.ZodTypeDef, import("./identity").VerifiedDomain>, "many">>;
+        /**
+         * Account-graph classification — what KIND of account this is.
+         *
+         * ORTHOGONAL to `type` (`local` / `federated` / `agent` / `automated`),
+         * which says where the account lives and how it is driven; the two
+         * coexist and neither substitutes for the other. A `channel` is a
+         * publishing identity nobody can act as, so a consumer that renders
+         * authored content reads THIS to tell a channel's post from a person's.
+         *
+         * Optional because a DTO produced from a source that never carried the
+         * column omits it; absent should be read as `personal`, the column's
+         * default, not as unknown.
+         */
+        kind: z.ZodOptional<z.ZodEnum<["personal", "organization", "project", "bot", "channel"]>>;
+        /**
+         * What this account is about — the field a profile screen RENDERS.
+         *
+         * **Ordered, primary first.** `accountCategories[0]` is the primary
+         * category; there is deliberately no sibling `primaryCategory` field,
+         * because two representations of one fact can disagree (see rule 2 in
+         * `accountGraph.ts`). Nothing downstream may sort, de-duplicate or
+         * otherwise reorder this array.
+         *
+         * **Ids, never labels.** Each element is a stable slug; the visible text
+         * comes from the reader's own translation catalogue, keyed
+         * `accounts.accountCategory.<id>`. A label on the wire would paint every
+         * profile in the language of whoever picked it.
+         *
+         * Absent when the account has none — which is every `personal` account,
+         * and any non-personal one that has not chosen. A renderer reads
+         * `user.accountCategories ?? []`.
+         */
+        accountCategories: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodEnum<["news", "politics", "business", "startup", "finance", "crypto", "marketplace", "retail", "real_estate", "agency", "landlord", "cooperative", "architecture", "technology", "software", "ai", "security", "automation", "science", "education", "books", "health", "fitness", "sports", "gaming", "music", "film", "podcast", "art", "photography", "comedy", "food", "travel", "fashion", "home_garden", "diy", "automotive", "animals", "family", "nonprofit", "government", "community", "activism", "environment", "religion", "other"]>, "many">, ("news" | "politics" | "business" | "startup" | "finance" | "crypto" | "marketplace" | "retail" | "real_estate" | "agency" | "landlord" | "cooperative" | "architecture" | "technology" | "software" | "ai" | "security" | "automation" | "science" | "education" | "books" | "health" | "fitness" | "sports" | "gaming" | "music" | "film" | "podcast" | "art" | "photography" | "comedy" | "food" | "travel" | "fashion" | "home_garden" | "diy" | "automotive" | "animals" | "family" | "nonprofit" | "government" | "community" | "activism" | "environment" | "religion" | "other")[], ("news" | "politics" | "business" | "startup" | "finance" | "crypto" | "marketplace" | "retail" | "real_estate" | "agency" | "landlord" | "cooperative" | "architecture" | "technology" | "software" | "ai" | "security" | "automation" | "science" | "education" | "books" | "health" | "fitness" | "sports" | "gaming" | "music" | "film" | "podcast" | "art" | "photography" | "comedy" | "food" | "travel" | "fashion" | "home_garden" | "diy" | "automotive" | "animals" | "family" | "nonprofit" | "government" | "community" | "activism" | "environment" | "religion" | "other")[]>>;
+        /**
+         * The authenticated viewer's relationship to this profile. Present ONLY
+         * on single-profile fetches (`GET /profiles/username/:username`,
+         * `GET /users/:userId`) when the request is authenticated; OMITTED for
+         * anonymous requests and for the bulk `POST /users/by-ids` fan-out.
+         */
+        relationship: z.ZodOptional<z.ZodType<UserRelationship, z.ZodTypeDef, UserRelationship>>;
+        /**
+         * Portable theme preference. Rides the self/session payload (cold boot),
+         * so it is present on the current-user DTO (`GET /users/me`,
+         * `GET /session/user/:sessionId`) and absent until the user sets it.
+         */
+        themePreference: z.ZodOptional<z.ZodType<ThemePreference, z.ZodTypeDef, ThemePreference>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        /** MongoDB ObjectId as a string. Present on `formatUserResponse` output. */
+        id: z.ZodOptional<z.ZodString>;
+        /** Raw-document id (e.g. `GET /users/me`). Present when `id` is not. */
+        _id: z.ZodOptional<z.ZodString>;
+        publicKey: z.ZodOptional<z.ZodString>;
+        username: z.ZodOptional<z.ZodString>;
+        email: z.ZodOptional<z.ZodString>;
+        phone: z.ZodOptional<z.ZodString>;
+        address: z.ZodOptional<z.ZodString>;
+        birthday: z.ZodOptional<z.ZodString>;
+        /** Avatar file id (string) or null. */
+        avatar: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** Named Bloom color preset (e.g. `"blue"`) or null. */
+        color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        name: z.ZodType<UserNameResponse, z.ZodTypeDef, UserNameResponse>;
+        verified: z.ZodOptional<z.ZodBoolean>;
+        /**
+         * The account's languages as full BCP-47 locales (`language-REGION`,
+         * e.g. `es-ES`, `en-US`, `pt-BR`), ordered with the PRIMARY (UI) locale
+         * first. `languages[0]` is the primary locale — there is no singular
+         * `language` field.
+         */
+        languages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /**
+         * The account's self-sovereign identifier
+         * (`did:web:<FEDERATION_DOMAIN>:u:<userId>`). Surfaced as a `User`
+         * virtual; present on formatted DTOs once the identity layer is live.
+         */
+        did: z.ZodOptional<z.ZodString>;
+        /**
+         * Proven domain-ownership badges. Each is a {@link verifiedDomainSchema}
+         * entry; present only when the account has verified at least one domain.
+         */
+        verifiedDomains: z.ZodOptional<z.ZodArray<z.ZodType<import("./identity").VerifiedDomain, z.ZodTypeDef, import("./identity").VerifiedDomain>, "many">>;
+        /**
+         * Account-graph classification — what KIND of account this is.
+         *
+         * ORTHOGONAL to `type` (`local` / `federated` / `agent` / `automated`),
+         * which says where the account lives and how it is driven; the two
+         * coexist and neither substitutes for the other. A `channel` is a
+         * publishing identity nobody can act as, so a consumer that renders
+         * authored content reads THIS to tell a channel's post from a person's.
+         *
+         * Optional because a DTO produced from a source that never carried the
+         * column omits it; absent should be read as `personal`, the column's
+         * default, not as unknown.
+         */
+        kind: z.ZodOptional<z.ZodEnum<["personal", "organization", "project", "bot", "channel"]>>;
+        /**
+         * What this account is about — the field a profile screen RENDERS.
+         *
+         * **Ordered, primary first.** `accountCategories[0]` is the primary
+         * category; there is deliberately no sibling `primaryCategory` field,
+         * because two representations of one fact can disagree (see rule 2 in
+         * `accountGraph.ts`). Nothing downstream may sort, de-duplicate or
+         * otherwise reorder this array.
+         *
+         * **Ids, never labels.** Each element is a stable slug; the visible text
+         * comes from the reader's own translation catalogue, keyed
+         * `accounts.accountCategory.<id>`. A label on the wire would paint every
+         * profile in the language of whoever picked it.
+         *
+         * Absent when the account has none — which is every `personal` account,
+         * and any non-personal one that has not chosen. A renderer reads
+         * `user.accountCategories ?? []`.
+         */
+        accountCategories: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodEnum<["news", "politics", "business", "startup", "finance", "crypto", "marketplace", "retail", "real_estate", "agency", "landlord", "cooperative", "architecture", "technology", "software", "ai", "security", "automation", "science", "education", "books", "health", "fitness", "sports", "gaming", "music", "film", "podcast", "art", "photography", "comedy", "food", "travel", "fashion", "home_garden", "diy", "automotive", "animals", "family", "nonprofit", "government", "community", "activism", "environment", "religion", "other"]>, "many">, ("news" | "politics" | "business" | "startup" | "finance" | "crypto" | "marketplace" | "retail" | "real_estate" | "agency" | "landlord" | "cooperative" | "architecture" | "technology" | "software" | "ai" | "security" | "automation" | "science" | "education" | "books" | "health" | "fitness" | "sports" | "gaming" | "music" | "film" | "podcast" | "art" | "photography" | "comedy" | "food" | "travel" | "fashion" | "home_garden" | "diy" | "automotive" | "animals" | "family" | "nonprofit" | "government" | "community" | "activism" | "environment" | "religion" | "other")[], ("news" | "politics" | "business" | "startup" | "finance" | "crypto" | "marketplace" | "retail" | "real_estate" | "agency" | "landlord" | "cooperative" | "architecture" | "technology" | "software" | "ai" | "security" | "automation" | "science" | "education" | "books" | "health" | "fitness" | "sports" | "gaming" | "music" | "film" | "podcast" | "art" | "photography" | "comedy" | "food" | "travel" | "fashion" | "home_garden" | "diy" | "automotive" | "animals" | "family" | "nonprofit" | "government" | "community" | "activism" | "environment" | "religion" | "other")[]>>;
+        /**
+         * The authenticated viewer's relationship to this profile. Present ONLY
+         * on single-profile fetches (`GET /profiles/username/:username`,
+         * `GET /users/:userId`) when the request is authenticated; OMITTED for
+         * anonymous requests and for the bulk `POST /users/by-ids` fan-out.
+         */
+        relationship: z.ZodOptional<z.ZodType<UserRelationship, z.ZodTypeDef, UserRelationship>>;
+        /**
+         * Portable theme preference. Rides the self/session payload (cold boot),
+         * so it is present on the current-user DTO (`GET /users/me`,
+         * `GET /session/user/:sessionId`) and absent until the user sets it.
+         */
+        themePreference: z.ZodOptional<z.ZodType<ThemePreference, z.ZodTypeDef, ThemePreference>>;
+    }, z.ZodTypeAny, "passthrough">>>>;
+}, "strip", z.ZodTypeAny, {
+    sessionId: string;
+    isCurrent?: boolean | undefined;
+    user?: z.objectOutputType<{
+        /** MongoDB ObjectId as a string. Present on `formatUserResponse` output. */
+        id: z.ZodOptional<z.ZodString>;
+        /** Raw-document id (e.g. `GET /users/me`). Present when `id` is not. */
+        _id: z.ZodOptional<z.ZodString>;
+        publicKey: z.ZodOptional<z.ZodString>;
+        username: z.ZodOptional<z.ZodString>;
+        email: z.ZodOptional<z.ZodString>;
+        phone: z.ZodOptional<z.ZodString>;
+        address: z.ZodOptional<z.ZodString>;
+        birthday: z.ZodOptional<z.ZodString>;
+        /** Avatar file id (string) or null. */
+        avatar: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** Named Bloom color preset (e.g. `"blue"`) or null. */
+        color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        name: z.ZodType<UserNameResponse, z.ZodTypeDef, UserNameResponse>;
+        verified: z.ZodOptional<z.ZodBoolean>;
+        /**
+         * The account's languages as full BCP-47 locales (`language-REGION`,
+         * e.g. `es-ES`, `en-US`, `pt-BR`), ordered with the PRIMARY (UI) locale
+         * first. `languages[0]` is the primary locale — there is no singular
+         * `language` field.
+         */
+        languages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /**
+         * The account's self-sovereign identifier
+         * (`did:web:<FEDERATION_DOMAIN>:u:<userId>`). Surfaced as a `User`
+         * virtual; present on formatted DTOs once the identity layer is live.
+         */
+        did: z.ZodOptional<z.ZodString>;
+        /**
+         * Proven domain-ownership badges. Each is a {@link verifiedDomainSchema}
+         * entry; present only when the account has verified at least one domain.
+         */
+        verifiedDomains: z.ZodOptional<z.ZodArray<z.ZodType<import("./identity").VerifiedDomain, z.ZodTypeDef, import("./identity").VerifiedDomain>, "many">>;
+        /**
+         * Account-graph classification — what KIND of account this is.
+         *
+         * ORTHOGONAL to `type` (`local` / `federated` / `agent` / `automated`),
+         * which says where the account lives and how it is driven; the two
+         * coexist and neither substitutes for the other. A `channel` is a
+         * publishing identity nobody can act as, so a consumer that renders
+         * authored content reads THIS to tell a channel's post from a person's.
+         *
+         * Optional because a DTO produced from a source that never carried the
+         * column omits it; absent should be read as `personal`, the column's
+         * default, not as unknown.
+         */
+        kind: z.ZodOptional<z.ZodEnum<["personal", "organization", "project", "bot", "channel"]>>;
+        /**
+         * What this account is about — the field a profile screen RENDERS.
+         *
+         * **Ordered, primary first.** `accountCategories[0]` is the primary
+         * category; there is deliberately no sibling `primaryCategory` field,
+         * because two representations of one fact can disagree (see rule 2 in
+         * `accountGraph.ts`). Nothing downstream may sort, de-duplicate or
+         * otherwise reorder this array.
+         *
+         * **Ids, never labels.** Each element is a stable slug; the visible text
+         * comes from the reader's own translation catalogue, keyed
+         * `accounts.accountCategory.<id>`. A label on the wire would paint every
+         * profile in the language of whoever picked it.
+         *
+         * Absent when the account has none — which is every `personal` account,
+         * and any non-personal one that has not chosen. A renderer reads
+         * `user.accountCategories ?? []`.
+         */
+        accountCategories: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodEnum<["news", "politics", "business", "startup", "finance", "crypto", "marketplace", "retail", "real_estate", "agency", "landlord", "cooperative", "architecture", "technology", "software", "ai", "security", "automation", "science", "education", "books", "health", "fitness", "sports", "gaming", "music", "film", "podcast", "art", "photography", "comedy", "food", "travel", "fashion", "home_garden", "diy", "automotive", "animals", "family", "nonprofit", "government", "community", "activism", "environment", "religion", "other"]>, "many">, ("news" | "politics" | "business" | "startup" | "finance" | "crypto" | "marketplace" | "retail" | "real_estate" | "agency" | "landlord" | "cooperative" | "architecture" | "technology" | "software" | "ai" | "security" | "automation" | "science" | "education" | "books" | "health" | "fitness" | "sports" | "gaming" | "music" | "film" | "podcast" | "art" | "photography" | "comedy" | "food" | "travel" | "fashion" | "home_garden" | "diy" | "automotive" | "animals" | "family" | "nonprofit" | "government" | "community" | "activism" | "environment" | "religion" | "other")[], ("news" | "politics" | "business" | "startup" | "finance" | "crypto" | "marketplace" | "retail" | "real_estate" | "agency" | "landlord" | "cooperative" | "architecture" | "technology" | "software" | "ai" | "security" | "automation" | "science" | "education" | "books" | "health" | "fitness" | "sports" | "gaming" | "music" | "film" | "podcast" | "art" | "photography" | "comedy" | "food" | "travel" | "fashion" | "home_garden" | "diy" | "automotive" | "animals" | "family" | "nonprofit" | "government" | "community" | "activism" | "environment" | "religion" | "other")[]>>;
+        /**
+         * The authenticated viewer's relationship to this profile. Present ONLY
+         * on single-profile fetches (`GET /profiles/username/:username`,
+         * `GET /users/:userId`) when the request is authenticated; OMITTED for
+         * anonymous requests and for the bulk `POST /users/by-ids` fan-out.
+         */
+        relationship: z.ZodOptional<z.ZodType<UserRelationship, z.ZodTypeDef, UserRelationship>>;
+        /**
+         * Portable theme preference. Rides the self/session payload (cold boot),
+         * so it is present on the current-user DTO (`GET /users/me`,
+         * `GET /session/user/:sessionId`) and absent until the user sets it.
+         */
+        themePreference: z.ZodOptional<z.ZodType<ThemePreference, z.ZodTypeDef, ThemePreference>>;
+    }, z.ZodTypeAny, "passthrough"> | null | undefined;
+}, {
+    sessionId: string;
+    isCurrent?: boolean | undefined;
+    user?: z.objectInputType<{
+        /** MongoDB ObjectId as a string. Present on `formatUserResponse` output. */
+        id: z.ZodOptional<z.ZodString>;
+        /** Raw-document id (e.g. `GET /users/me`). Present when `id` is not. */
+        _id: z.ZodOptional<z.ZodString>;
+        publicKey: z.ZodOptional<z.ZodString>;
+        username: z.ZodOptional<z.ZodString>;
+        email: z.ZodOptional<z.ZodString>;
+        phone: z.ZodOptional<z.ZodString>;
+        address: z.ZodOptional<z.ZodString>;
+        birthday: z.ZodOptional<z.ZodString>;
+        /** Avatar file id (string) or null. */
+        avatar: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** Named Bloom color preset (e.g. `"blue"`) or null. */
+        color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        name: z.ZodType<UserNameResponse, z.ZodTypeDef, UserNameResponse>;
+        verified: z.ZodOptional<z.ZodBoolean>;
+        /**
+         * The account's languages as full BCP-47 locales (`language-REGION`,
+         * e.g. `es-ES`, `en-US`, `pt-BR`), ordered with the PRIMARY (UI) locale
+         * first. `languages[0]` is the primary locale — there is no singular
+         * `language` field.
+         */
+        languages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /**
+         * The account's self-sovereign identifier
+         * (`did:web:<FEDERATION_DOMAIN>:u:<userId>`). Surfaced as a `User`
+         * virtual; present on formatted DTOs once the identity layer is live.
+         */
+        did: z.ZodOptional<z.ZodString>;
+        /**
+         * Proven domain-ownership badges. Each is a {@link verifiedDomainSchema}
+         * entry; present only when the account has verified at least one domain.
+         */
+        verifiedDomains: z.ZodOptional<z.ZodArray<z.ZodType<import("./identity").VerifiedDomain, z.ZodTypeDef, import("./identity").VerifiedDomain>, "many">>;
+        /**
+         * Account-graph classification — what KIND of account this is.
+         *
+         * ORTHOGONAL to `type` (`local` / `federated` / `agent` / `automated`),
+         * which says where the account lives and how it is driven; the two
+         * coexist and neither substitutes for the other. A `channel` is a
+         * publishing identity nobody can act as, so a consumer that renders
+         * authored content reads THIS to tell a channel's post from a person's.
+         *
+         * Optional because a DTO produced from a source that never carried the
+         * column omits it; absent should be read as `personal`, the column's
+         * default, not as unknown.
+         */
+        kind: z.ZodOptional<z.ZodEnum<["personal", "organization", "project", "bot", "channel"]>>;
+        /**
+         * What this account is about — the field a profile screen RENDERS.
+         *
+         * **Ordered, primary first.** `accountCategories[0]` is the primary
+         * category; there is deliberately no sibling `primaryCategory` field,
+         * because two representations of one fact can disagree (see rule 2 in
+         * `accountGraph.ts`). Nothing downstream may sort, de-duplicate or
+         * otherwise reorder this array.
+         *
+         * **Ids, never labels.** Each element is a stable slug; the visible text
+         * comes from the reader's own translation catalogue, keyed
+         * `accounts.accountCategory.<id>`. A label on the wire would paint every
+         * profile in the language of whoever picked it.
+         *
+         * Absent when the account has none — which is every `personal` account,
+         * and any non-personal one that has not chosen. A renderer reads
+         * `user.accountCategories ?? []`.
+         */
+        accountCategories: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodEnum<["news", "politics", "business", "startup", "finance", "crypto", "marketplace", "retail", "real_estate", "agency", "landlord", "cooperative", "architecture", "technology", "software", "ai", "security", "automation", "science", "education", "books", "health", "fitness", "sports", "gaming", "music", "film", "podcast", "art", "photography", "comedy", "food", "travel", "fashion", "home_garden", "diy", "automotive", "animals", "family", "nonprofit", "government", "community", "activism", "environment", "religion", "other"]>, "many">, ("news" | "politics" | "business" | "startup" | "finance" | "crypto" | "marketplace" | "retail" | "real_estate" | "agency" | "landlord" | "cooperative" | "architecture" | "technology" | "software" | "ai" | "security" | "automation" | "science" | "education" | "books" | "health" | "fitness" | "sports" | "gaming" | "music" | "film" | "podcast" | "art" | "photography" | "comedy" | "food" | "travel" | "fashion" | "home_garden" | "diy" | "automotive" | "animals" | "family" | "nonprofit" | "government" | "community" | "activism" | "environment" | "religion" | "other")[], ("news" | "politics" | "business" | "startup" | "finance" | "crypto" | "marketplace" | "retail" | "real_estate" | "agency" | "landlord" | "cooperative" | "architecture" | "technology" | "software" | "ai" | "security" | "automation" | "science" | "education" | "books" | "health" | "fitness" | "sports" | "gaming" | "music" | "film" | "podcast" | "art" | "photography" | "comedy" | "food" | "travel" | "fashion" | "home_garden" | "diy" | "automotive" | "animals" | "family" | "nonprofit" | "government" | "community" | "activism" | "environment" | "religion" | "other")[]>>;
+        /**
+         * The authenticated viewer's relationship to this profile. Present ONLY
+         * on single-profile fetches (`GET /profiles/username/:username`,
+         * `GET /users/:userId`) when the request is authenticated; OMITTED for
+         * anonymous requests and for the bulk `POST /users/by-ids` fan-out.
+         */
+        relationship: z.ZodOptional<z.ZodType<UserRelationship, z.ZodTypeDef, UserRelationship>>;
+        /**
+         * Portable theme preference. Rides the self/session payload (cold boot),
+         * so it is present on the current-user DTO (`GET /users/me`,
+         * `GET /session/user/:sessionId`) and absent until the user sets it.
+         */
+        themePreference: z.ZodOptional<z.ZodType<ThemePreference, z.ZodTypeDef, ThemePreference>>;
+    }, z.ZodTypeAny, "passthrough"> | null | undefined;
+}>;
+export type DeviceLinkedSessionResponse = z.infer<typeof deviceLinkedSessionSchema>;
+/** Wire shape of `GET /session/device/sessions/:sessionId` (an array). */
+export declare const deviceLinkedSessionsResponseSchema: z.ZodArray<z.ZodObject<{
+    sessionId: z.ZodString;
+    isCurrent: z.ZodOptional<z.ZodBoolean>;
+    user: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        /** MongoDB ObjectId as a string. Present on `formatUserResponse` output. */
+        id: z.ZodOptional<z.ZodString>;
+        /** Raw-document id (e.g. `GET /users/me`). Present when `id` is not. */
+        _id: z.ZodOptional<z.ZodString>;
+        publicKey: z.ZodOptional<z.ZodString>;
+        username: z.ZodOptional<z.ZodString>;
+        email: z.ZodOptional<z.ZodString>;
+        phone: z.ZodOptional<z.ZodString>;
+        address: z.ZodOptional<z.ZodString>;
+        birthday: z.ZodOptional<z.ZodString>;
+        /** Avatar file id (string) or null. */
+        avatar: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** Named Bloom color preset (e.g. `"blue"`) or null. */
+        color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        name: z.ZodType<UserNameResponse, z.ZodTypeDef, UserNameResponse>;
+        verified: z.ZodOptional<z.ZodBoolean>;
+        /**
+         * The account's languages as full BCP-47 locales (`language-REGION`,
+         * e.g. `es-ES`, `en-US`, `pt-BR`), ordered with the PRIMARY (UI) locale
+         * first. `languages[0]` is the primary locale — there is no singular
+         * `language` field.
+         */
+        languages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /**
+         * The account's self-sovereign identifier
+         * (`did:web:<FEDERATION_DOMAIN>:u:<userId>`). Surfaced as a `User`
+         * virtual; present on formatted DTOs once the identity layer is live.
+         */
+        did: z.ZodOptional<z.ZodString>;
+        /**
+         * Proven domain-ownership badges. Each is a {@link verifiedDomainSchema}
+         * entry; present only when the account has verified at least one domain.
+         */
+        verifiedDomains: z.ZodOptional<z.ZodArray<z.ZodType<import("./identity").VerifiedDomain, z.ZodTypeDef, import("./identity").VerifiedDomain>, "many">>;
+        /**
+         * Account-graph classification — what KIND of account this is.
+         *
+         * ORTHOGONAL to `type` (`local` / `federated` / `agent` / `automated`),
+         * which says where the account lives and how it is driven; the two
+         * coexist and neither substitutes for the other. A `channel` is a
+         * publishing identity nobody can act as, so a consumer that renders
+         * authored content reads THIS to tell a channel's post from a person's.
+         *
+         * Optional because a DTO produced from a source that never carried the
+         * column omits it; absent should be read as `personal`, the column's
+         * default, not as unknown.
+         */
+        kind: z.ZodOptional<z.ZodEnum<["personal", "organization", "project", "bot", "channel"]>>;
+        /**
+         * What this account is about — the field a profile screen RENDERS.
+         *
+         * **Ordered, primary first.** `accountCategories[0]` is the primary
+         * category; there is deliberately no sibling `primaryCategory` field,
+         * because two representations of one fact can disagree (see rule 2 in
+         * `accountGraph.ts`). Nothing downstream may sort, de-duplicate or
+         * otherwise reorder this array.
+         *
+         * **Ids, never labels.** Each element is a stable slug; the visible text
+         * comes from the reader's own translation catalogue, keyed
+         * `accounts.accountCategory.<id>`. A label on the wire would paint every
+         * profile in the language of whoever picked it.
+         *
+         * Absent when the account has none — which is every `personal` account,
+         * and any non-personal one that has not chosen. A renderer reads
+         * `user.accountCategories ?? []`.
+         */
+        accountCategories: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodEnum<["news", "politics", "business", "startup", "finance", "crypto", "marketplace", "retail", "real_estate", "agency", "landlord", "cooperative", "architecture", "technology", "software", "ai", "security", "automation", "science", "education", "books", "health", "fitness", "sports", "gaming", "music", "film", "podcast", "art", "photography", "comedy", "food", "travel", "fashion", "home_garden", "diy", "automotive", "animals", "family", "nonprofit", "government", "community", "activism", "environment", "religion", "other"]>, "many">, ("news" | "politics" | "business" | "startup" | "finance" | "crypto" | "marketplace" | "retail" | "real_estate" | "agency" | "landlord" | "cooperative" | "architecture" | "technology" | "software" | "ai" | "security" | "automation" | "science" | "education" | "books" | "health" | "fitness" | "sports" | "gaming" | "music" | "film" | "podcast" | "art" | "photography" | "comedy" | "food" | "travel" | "fashion" | "home_garden" | "diy" | "automotive" | "animals" | "family" | "nonprofit" | "government" | "community" | "activism" | "environment" | "religion" | "other")[], ("news" | "politics" | "business" | "startup" | "finance" | "crypto" | "marketplace" | "retail" | "real_estate" | "agency" | "landlord" | "cooperative" | "architecture" | "technology" | "software" | "ai" | "security" | "automation" | "science" | "education" | "books" | "health" | "fitness" | "sports" | "gaming" | "music" | "film" | "podcast" | "art" | "photography" | "comedy" | "food" | "travel" | "fashion" | "home_garden" | "diy" | "automotive" | "animals" | "family" | "nonprofit" | "government" | "community" | "activism" | "environment" | "religion" | "other")[]>>;
+        /**
+         * The authenticated viewer's relationship to this profile. Present ONLY
+         * on single-profile fetches (`GET /profiles/username/:username`,
+         * `GET /users/:userId`) when the request is authenticated; OMITTED for
+         * anonymous requests and for the bulk `POST /users/by-ids` fan-out.
+         */
+        relationship: z.ZodOptional<z.ZodType<UserRelationship, z.ZodTypeDef, UserRelationship>>;
+        /**
+         * Portable theme preference. Rides the self/session payload (cold boot),
+         * so it is present on the current-user DTO (`GET /users/me`,
+         * `GET /session/user/:sessionId`) and absent until the user sets it.
+         */
+        themePreference: z.ZodOptional<z.ZodType<ThemePreference, z.ZodTypeDef, ThemePreference>>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        /** MongoDB ObjectId as a string. Present on `formatUserResponse` output. */
+        id: z.ZodOptional<z.ZodString>;
+        /** Raw-document id (e.g. `GET /users/me`). Present when `id` is not. */
+        _id: z.ZodOptional<z.ZodString>;
+        publicKey: z.ZodOptional<z.ZodString>;
+        username: z.ZodOptional<z.ZodString>;
+        email: z.ZodOptional<z.ZodString>;
+        phone: z.ZodOptional<z.ZodString>;
+        address: z.ZodOptional<z.ZodString>;
+        birthday: z.ZodOptional<z.ZodString>;
+        /** Avatar file id (string) or null. */
+        avatar: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** Named Bloom color preset (e.g. `"blue"`) or null. */
+        color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        name: z.ZodType<UserNameResponse, z.ZodTypeDef, UserNameResponse>;
+        verified: z.ZodOptional<z.ZodBoolean>;
+        /**
+         * The account's languages as full BCP-47 locales (`language-REGION`,
+         * e.g. `es-ES`, `en-US`, `pt-BR`), ordered with the PRIMARY (UI) locale
+         * first. `languages[0]` is the primary locale — there is no singular
+         * `language` field.
+         */
+        languages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /**
+         * The account's self-sovereign identifier
+         * (`did:web:<FEDERATION_DOMAIN>:u:<userId>`). Surfaced as a `User`
+         * virtual; present on formatted DTOs once the identity layer is live.
+         */
+        did: z.ZodOptional<z.ZodString>;
+        /**
+         * Proven domain-ownership badges. Each is a {@link verifiedDomainSchema}
+         * entry; present only when the account has verified at least one domain.
+         */
+        verifiedDomains: z.ZodOptional<z.ZodArray<z.ZodType<import("./identity").VerifiedDomain, z.ZodTypeDef, import("./identity").VerifiedDomain>, "many">>;
+        /**
+         * Account-graph classification — what KIND of account this is.
+         *
+         * ORTHOGONAL to `type` (`local` / `federated` / `agent` / `automated`),
+         * which says where the account lives and how it is driven; the two
+         * coexist and neither substitutes for the other. A `channel` is a
+         * publishing identity nobody can act as, so a consumer that renders
+         * authored content reads THIS to tell a channel's post from a person's.
+         *
+         * Optional because a DTO produced from a source that never carried the
+         * column omits it; absent should be read as `personal`, the column's
+         * default, not as unknown.
+         */
+        kind: z.ZodOptional<z.ZodEnum<["personal", "organization", "project", "bot", "channel"]>>;
+        /**
+         * What this account is about — the field a profile screen RENDERS.
+         *
+         * **Ordered, primary first.** `accountCategories[0]` is the primary
+         * category; there is deliberately no sibling `primaryCategory` field,
+         * because two representations of one fact can disagree (see rule 2 in
+         * `accountGraph.ts`). Nothing downstream may sort, de-duplicate or
+         * otherwise reorder this array.
+         *
+         * **Ids, never labels.** Each element is a stable slug; the visible text
+         * comes from the reader's own translation catalogue, keyed
+         * `accounts.accountCategory.<id>`. A label on the wire would paint every
+         * profile in the language of whoever picked it.
+         *
+         * Absent when the account has none — which is every `personal` account,
+         * and any non-personal one that has not chosen. A renderer reads
+         * `user.accountCategories ?? []`.
+         */
+        accountCategories: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodEnum<["news", "politics", "business", "startup", "finance", "crypto", "marketplace", "retail", "real_estate", "agency", "landlord", "cooperative", "architecture", "technology", "software", "ai", "security", "automation", "science", "education", "books", "health", "fitness", "sports", "gaming", "music", "film", "podcast", "art", "photography", "comedy", "food", "travel", "fashion", "home_garden", "diy", "automotive", "animals", "family", "nonprofit", "government", "community", "activism", "environment", "religion", "other"]>, "many">, ("news" | "politics" | "business" | "startup" | "finance" | "crypto" | "marketplace" | "retail" | "real_estate" | "agency" | "landlord" | "cooperative" | "architecture" | "technology" | "software" | "ai" | "security" | "automation" | "science" | "education" | "books" | "health" | "fitness" | "sports" | "gaming" | "music" | "film" | "podcast" | "art" | "photography" | "comedy" | "food" | "travel" | "fashion" | "home_garden" | "diy" | "automotive" | "animals" | "family" | "nonprofit" | "government" | "community" | "activism" | "environment" | "religion" | "other")[], ("news" | "politics" | "business" | "startup" | "finance" | "crypto" | "marketplace" | "retail" | "real_estate" | "agency" | "landlord" | "cooperative" | "architecture" | "technology" | "software" | "ai" | "security" | "automation" | "science" | "education" | "books" | "health" | "fitness" | "sports" | "gaming" | "music" | "film" | "podcast" | "art" | "photography" | "comedy" | "food" | "travel" | "fashion" | "home_garden" | "diy" | "automotive" | "animals" | "family" | "nonprofit" | "government" | "community" | "activism" | "environment" | "religion" | "other")[]>>;
+        /**
+         * The authenticated viewer's relationship to this profile. Present ONLY
+         * on single-profile fetches (`GET /profiles/username/:username`,
+         * `GET /users/:userId`) when the request is authenticated; OMITTED for
+         * anonymous requests and for the bulk `POST /users/by-ids` fan-out.
+         */
+        relationship: z.ZodOptional<z.ZodType<UserRelationship, z.ZodTypeDef, UserRelationship>>;
+        /**
+         * Portable theme preference. Rides the self/session payload (cold boot),
+         * so it is present on the current-user DTO (`GET /users/me`,
+         * `GET /session/user/:sessionId`) and absent until the user sets it.
+         */
+        themePreference: z.ZodOptional<z.ZodType<ThemePreference, z.ZodTypeDef, ThemePreference>>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        /** MongoDB ObjectId as a string. Present on `formatUserResponse` output. */
+        id: z.ZodOptional<z.ZodString>;
+        /** Raw-document id (e.g. `GET /users/me`). Present when `id` is not. */
+        _id: z.ZodOptional<z.ZodString>;
+        publicKey: z.ZodOptional<z.ZodString>;
+        username: z.ZodOptional<z.ZodString>;
+        email: z.ZodOptional<z.ZodString>;
+        phone: z.ZodOptional<z.ZodString>;
+        address: z.ZodOptional<z.ZodString>;
+        birthday: z.ZodOptional<z.ZodString>;
+        /** Avatar file id (string) or null. */
+        avatar: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** Named Bloom color preset (e.g. `"blue"`) or null. */
+        color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        name: z.ZodType<UserNameResponse, z.ZodTypeDef, UserNameResponse>;
+        verified: z.ZodOptional<z.ZodBoolean>;
+        /**
+         * The account's languages as full BCP-47 locales (`language-REGION`,
+         * e.g. `es-ES`, `en-US`, `pt-BR`), ordered with the PRIMARY (UI) locale
+         * first. `languages[0]` is the primary locale — there is no singular
+         * `language` field.
+         */
+        languages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /**
+         * The account's self-sovereign identifier
+         * (`did:web:<FEDERATION_DOMAIN>:u:<userId>`). Surfaced as a `User`
+         * virtual; present on formatted DTOs once the identity layer is live.
+         */
+        did: z.ZodOptional<z.ZodString>;
+        /**
+         * Proven domain-ownership badges. Each is a {@link verifiedDomainSchema}
+         * entry; present only when the account has verified at least one domain.
+         */
+        verifiedDomains: z.ZodOptional<z.ZodArray<z.ZodType<import("./identity").VerifiedDomain, z.ZodTypeDef, import("./identity").VerifiedDomain>, "many">>;
+        /**
+         * Account-graph classification — what KIND of account this is.
+         *
+         * ORTHOGONAL to `type` (`local` / `federated` / `agent` / `automated`),
+         * which says where the account lives and how it is driven; the two
+         * coexist and neither substitutes for the other. A `channel` is a
+         * publishing identity nobody can act as, so a consumer that renders
+         * authored content reads THIS to tell a channel's post from a person's.
+         *
+         * Optional because a DTO produced from a source that never carried the
+         * column omits it; absent should be read as `personal`, the column's
+         * default, not as unknown.
+         */
+        kind: z.ZodOptional<z.ZodEnum<["personal", "organization", "project", "bot", "channel"]>>;
+        /**
+         * What this account is about — the field a profile screen RENDERS.
+         *
+         * **Ordered, primary first.** `accountCategories[0]` is the primary
+         * category; there is deliberately no sibling `primaryCategory` field,
+         * because two representations of one fact can disagree (see rule 2 in
+         * `accountGraph.ts`). Nothing downstream may sort, de-duplicate or
+         * otherwise reorder this array.
+         *
+         * **Ids, never labels.** Each element is a stable slug; the visible text
+         * comes from the reader's own translation catalogue, keyed
+         * `accounts.accountCategory.<id>`. A label on the wire would paint every
+         * profile in the language of whoever picked it.
+         *
+         * Absent when the account has none — which is every `personal` account,
+         * and any non-personal one that has not chosen. A renderer reads
+         * `user.accountCategories ?? []`.
+         */
+        accountCategories: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodEnum<["news", "politics", "business", "startup", "finance", "crypto", "marketplace", "retail", "real_estate", "agency", "landlord", "cooperative", "architecture", "technology", "software", "ai", "security", "automation", "science", "education", "books", "health", "fitness", "sports", "gaming", "music", "film", "podcast", "art", "photography", "comedy", "food", "travel", "fashion", "home_garden", "diy", "automotive", "animals", "family", "nonprofit", "government", "community", "activism", "environment", "religion", "other"]>, "many">, ("news" | "politics" | "business" | "startup" | "finance" | "crypto" | "marketplace" | "retail" | "real_estate" | "agency" | "landlord" | "cooperative" | "architecture" | "technology" | "software" | "ai" | "security" | "automation" | "science" | "education" | "books" | "health" | "fitness" | "sports" | "gaming" | "music" | "film" | "podcast" | "art" | "photography" | "comedy" | "food" | "travel" | "fashion" | "home_garden" | "diy" | "automotive" | "animals" | "family" | "nonprofit" | "government" | "community" | "activism" | "environment" | "religion" | "other")[], ("news" | "politics" | "business" | "startup" | "finance" | "crypto" | "marketplace" | "retail" | "real_estate" | "agency" | "landlord" | "cooperative" | "architecture" | "technology" | "software" | "ai" | "security" | "automation" | "science" | "education" | "books" | "health" | "fitness" | "sports" | "gaming" | "music" | "film" | "podcast" | "art" | "photography" | "comedy" | "food" | "travel" | "fashion" | "home_garden" | "diy" | "automotive" | "animals" | "family" | "nonprofit" | "government" | "community" | "activism" | "environment" | "religion" | "other")[]>>;
+        /**
+         * The authenticated viewer's relationship to this profile. Present ONLY
+         * on single-profile fetches (`GET /profiles/username/:username`,
+         * `GET /users/:userId`) when the request is authenticated; OMITTED for
+         * anonymous requests and for the bulk `POST /users/by-ids` fan-out.
+         */
+        relationship: z.ZodOptional<z.ZodType<UserRelationship, z.ZodTypeDef, UserRelationship>>;
+        /**
+         * Portable theme preference. Rides the self/session payload (cold boot),
+         * so it is present on the current-user DTO (`GET /users/me`,
+         * `GET /session/user/:sessionId`) and absent until the user sets it.
+         */
+        themePreference: z.ZodOptional<z.ZodType<ThemePreference, z.ZodTypeDef, ThemePreference>>;
+    }, z.ZodTypeAny, "passthrough">>>>;
+}, "strip", z.ZodTypeAny, {
+    sessionId: string;
+    isCurrent?: boolean | undefined;
+    user?: z.objectOutputType<{
+        /** MongoDB ObjectId as a string. Present on `formatUserResponse` output. */
+        id: z.ZodOptional<z.ZodString>;
+        /** Raw-document id (e.g. `GET /users/me`). Present when `id` is not. */
+        _id: z.ZodOptional<z.ZodString>;
+        publicKey: z.ZodOptional<z.ZodString>;
+        username: z.ZodOptional<z.ZodString>;
+        email: z.ZodOptional<z.ZodString>;
+        phone: z.ZodOptional<z.ZodString>;
+        address: z.ZodOptional<z.ZodString>;
+        birthday: z.ZodOptional<z.ZodString>;
+        /** Avatar file id (string) or null. */
+        avatar: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** Named Bloom color preset (e.g. `"blue"`) or null. */
+        color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        name: z.ZodType<UserNameResponse, z.ZodTypeDef, UserNameResponse>;
+        verified: z.ZodOptional<z.ZodBoolean>;
+        /**
+         * The account's languages as full BCP-47 locales (`language-REGION`,
+         * e.g. `es-ES`, `en-US`, `pt-BR`), ordered with the PRIMARY (UI) locale
+         * first. `languages[0]` is the primary locale — there is no singular
+         * `language` field.
+         */
+        languages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /**
+         * The account's self-sovereign identifier
+         * (`did:web:<FEDERATION_DOMAIN>:u:<userId>`). Surfaced as a `User`
+         * virtual; present on formatted DTOs once the identity layer is live.
+         */
+        did: z.ZodOptional<z.ZodString>;
+        /**
+         * Proven domain-ownership badges. Each is a {@link verifiedDomainSchema}
+         * entry; present only when the account has verified at least one domain.
+         */
+        verifiedDomains: z.ZodOptional<z.ZodArray<z.ZodType<import("./identity").VerifiedDomain, z.ZodTypeDef, import("./identity").VerifiedDomain>, "many">>;
+        /**
+         * Account-graph classification — what KIND of account this is.
+         *
+         * ORTHOGONAL to `type` (`local` / `federated` / `agent` / `automated`),
+         * which says where the account lives and how it is driven; the two
+         * coexist and neither substitutes for the other. A `channel` is a
+         * publishing identity nobody can act as, so a consumer that renders
+         * authored content reads THIS to tell a channel's post from a person's.
+         *
+         * Optional because a DTO produced from a source that never carried the
+         * column omits it; absent should be read as `personal`, the column's
+         * default, not as unknown.
+         */
+        kind: z.ZodOptional<z.ZodEnum<["personal", "organization", "project", "bot", "channel"]>>;
+        /**
+         * What this account is about — the field a profile screen RENDERS.
+         *
+         * **Ordered, primary first.** `accountCategories[0]` is the primary
+         * category; there is deliberately no sibling `primaryCategory` field,
+         * because two representations of one fact can disagree (see rule 2 in
+         * `accountGraph.ts`). Nothing downstream may sort, de-duplicate or
+         * otherwise reorder this array.
+         *
+         * **Ids, never labels.** Each element is a stable slug; the visible text
+         * comes from the reader's own translation catalogue, keyed
+         * `accounts.accountCategory.<id>`. A label on the wire would paint every
+         * profile in the language of whoever picked it.
+         *
+         * Absent when the account has none — which is every `personal` account,
+         * and any non-personal one that has not chosen. A renderer reads
+         * `user.accountCategories ?? []`.
+         */
+        accountCategories: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodEnum<["news", "politics", "business", "startup", "finance", "crypto", "marketplace", "retail", "real_estate", "agency", "landlord", "cooperative", "architecture", "technology", "software", "ai", "security", "automation", "science", "education", "books", "health", "fitness", "sports", "gaming", "music", "film", "podcast", "art", "photography", "comedy", "food", "travel", "fashion", "home_garden", "diy", "automotive", "animals", "family", "nonprofit", "government", "community", "activism", "environment", "religion", "other"]>, "many">, ("news" | "politics" | "business" | "startup" | "finance" | "crypto" | "marketplace" | "retail" | "real_estate" | "agency" | "landlord" | "cooperative" | "architecture" | "technology" | "software" | "ai" | "security" | "automation" | "science" | "education" | "books" | "health" | "fitness" | "sports" | "gaming" | "music" | "film" | "podcast" | "art" | "photography" | "comedy" | "food" | "travel" | "fashion" | "home_garden" | "diy" | "automotive" | "animals" | "family" | "nonprofit" | "government" | "community" | "activism" | "environment" | "religion" | "other")[], ("news" | "politics" | "business" | "startup" | "finance" | "crypto" | "marketplace" | "retail" | "real_estate" | "agency" | "landlord" | "cooperative" | "architecture" | "technology" | "software" | "ai" | "security" | "automation" | "science" | "education" | "books" | "health" | "fitness" | "sports" | "gaming" | "music" | "film" | "podcast" | "art" | "photography" | "comedy" | "food" | "travel" | "fashion" | "home_garden" | "diy" | "automotive" | "animals" | "family" | "nonprofit" | "government" | "community" | "activism" | "environment" | "religion" | "other")[]>>;
+        /**
+         * The authenticated viewer's relationship to this profile. Present ONLY
+         * on single-profile fetches (`GET /profiles/username/:username`,
+         * `GET /users/:userId`) when the request is authenticated; OMITTED for
+         * anonymous requests and for the bulk `POST /users/by-ids` fan-out.
+         */
+        relationship: z.ZodOptional<z.ZodType<UserRelationship, z.ZodTypeDef, UserRelationship>>;
+        /**
+         * Portable theme preference. Rides the self/session payload (cold boot),
+         * so it is present on the current-user DTO (`GET /users/me`,
+         * `GET /session/user/:sessionId`) and absent until the user sets it.
+         */
+        themePreference: z.ZodOptional<z.ZodType<ThemePreference, z.ZodTypeDef, ThemePreference>>;
+    }, z.ZodTypeAny, "passthrough"> | null | undefined;
+}, {
+    sessionId: string;
+    isCurrent?: boolean | undefined;
+    user?: z.objectInputType<{
+        /** MongoDB ObjectId as a string. Present on `formatUserResponse` output. */
+        id: z.ZodOptional<z.ZodString>;
+        /** Raw-document id (e.g. `GET /users/me`). Present when `id` is not. */
+        _id: z.ZodOptional<z.ZodString>;
+        publicKey: z.ZodOptional<z.ZodString>;
+        username: z.ZodOptional<z.ZodString>;
+        email: z.ZodOptional<z.ZodString>;
+        phone: z.ZodOptional<z.ZodString>;
+        address: z.ZodOptional<z.ZodString>;
+        birthday: z.ZodOptional<z.ZodString>;
+        /** Avatar file id (string) or null. */
+        avatar: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        /** Named Bloom color preset (e.g. `"blue"`) or null. */
+        color: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        name: z.ZodType<UserNameResponse, z.ZodTypeDef, UserNameResponse>;
+        verified: z.ZodOptional<z.ZodBoolean>;
+        /**
+         * The account's languages as full BCP-47 locales (`language-REGION`,
+         * e.g. `es-ES`, `en-US`, `pt-BR`), ordered with the PRIMARY (UI) locale
+         * first. `languages[0]` is the primary locale — there is no singular
+         * `language` field.
+         */
+        languages: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        /**
+         * The account's self-sovereign identifier
+         * (`did:web:<FEDERATION_DOMAIN>:u:<userId>`). Surfaced as a `User`
+         * virtual; present on formatted DTOs once the identity layer is live.
+         */
+        did: z.ZodOptional<z.ZodString>;
+        /**
+         * Proven domain-ownership badges. Each is a {@link verifiedDomainSchema}
+         * entry; present only when the account has verified at least one domain.
+         */
+        verifiedDomains: z.ZodOptional<z.ZodArray<z.ZodType<import("./identity").VerifiedDomain, z.ZodTypeDef, import("./identity").VerifiedDomain>, "many">>;
+        /**
+         * Account-graph classification — what KIND of account this is.
+         *
+         * ORTHOGONAL to `type` (`local` / `federated` / `agent` / `automated`),
+         * which says where the account lives and how it is driven; the two
+         * coexist and neither substitutes for the other. A `channel` is a
+         * publishing identity nobody can act as, so a consumer that renders
+         * authored content reads THIS to tell a channel's post from a person's.
+         *
+         * Optional because a DTO produced from a source that never carried the
+         * column omits it; absent should be read as `personal`, the column's
+         * default, not as unknown.
+         */
+        kind: z.ZodOptional<z.ZodEnum<["personal", "organization", "project", "bot", "channel"]>>;
+        /**
+         * What this account is about — the field a profile screen RENDERS.
+         *
+         * **Ordered, primary first.** `accountCategories[0]` is the primary
+         * category; there is deliberately no sibling `primaryCategory` field,
+         * because two representations of one fact can disagree (see rule 2 in
+         * `accountGraph.ts`). Nothing downstream may sort, de-duplicate or
+         * otherwise reorder this array.
+         *
+         * **Ids, never labels.** Each element is a stable slug; the visible text
+         * comes from the reader's own translation catalogue, keyed
+         * `accounts.accountCategory.<id>`. A label on the wire would paint every
+         * profile in the language of whoever picked it.
+         *
+         * Absent when the account has none — which is every `personal` account,
+         * and any non-personal one that has not chosen. A renderer reads
+         * `user.accountCategories ?? []`.
+         */
+        accountCategories: z.ZodOptional<z.ZodEffects<z.ZodArray<z.ZodEnum<["news", "politics", "business", "startup", "finance", "crypto", "marketplace", "retail", "real_estate", "agency", "landlord", "cooperative", "architecture", "technology", "software", "ai", "security", "automation", "science", "education", "books", "health", "fitness", "sports", "gaming", "music", "film", "podcast", "art", "photography", "comedy", "food", "travel", "fashion", "home_garden", "diy", "automotive", "animals", "family", "nonprofit", "government", "community", "activism", "environment", "religion", "other"]>, "many">, ("news" | "politics" | "business" | "startup" | "finance" | "crypto" | "marketplace" | "retail" | "real_estate" | "agency" | "landlord" | "cooperative" | "architecture" | "technology" | "software" | "ai" | "security" | "automation" | "science" | "education" | "books" | "health" | "fitness" | "sports" | "gaming" | "music" | "film" | "podcast" | "art" | "photography" | "comedy" | "food" | "travel" | "fashion" | "home_garden" | "diy" | "automotive" | "animals" | "family" | "nonprofit" | "government" | "community" | "activism" | "environment" | "religion" | "other")[], ("news" | "politics" | "business" | "startup" | "finance" | "crypto" | "marketplace" | "retail" | "real_estate" | "agency" | "landlord" | "cooperative" | "architecture" | "technology" | "software" | "ai" | "security" | "automation" | "science" | "education" | "books" | "health" | "fitness" | "sports" | "gaming" | "music" | "film" | "podcast" | "art" | "photography" | "comedy" | "food" | "travel" | "fashion" | "home_garden" | "diy" | "automotive" | "animals" | "family" | "nonprofit" | "government" | "community" | "activism" | "environment" | "religion" | "other")[]>>;
+        /**
+         * The authenticated viewer's relationship to this profile. Present ONLY
+         * on single-profile fetches (`GET /profiles/username/:username`,
+         * `GET /users/:userId`) when the request is authenticated; OMITTED for
+         * anonymous requests and for the bulk `POST /users/by-ids` fan-out.
+         */
+        relationship: z.ZodOptional<z.ZodType<UserRelationship, z.ZodTypeDef, UserRelationship>>;
+        /**
+         * Portable theme preference. Rides the self/session payload (cold boot),
+         * so it is present on the current-user DTO (`GET /users/me`,
+         * `GET /session/user/:sessionId`) and absent until the user sets it.
+         */
+        themePreference: z.ZodOptional<z.ZodType<ThemePreference, z.ZodTypeDef, ThemePreference>>;
+    }, z.ZodTypeAny, "passthrough"> | null | undefined;
+}>, "many">;
+export type DeviceLinkedSessionsResponseContract = z.infer<typeof deviceLinkedSessionsResponseSchema>;
+/**
+ * Safely parse a value against a contract schema. Returns the parsed (typed)
+ * value, or `null` when validation fails — the same ergonomics the auth app's
+ * local `safeParse` provided, now sourced from the contracts package so the
+ * parse helper and the schemas live together.
+ */
+export declare function safeParseContract<T>(schema: z.ZodType<T>, data: unknown): T | null;