At this level
community.gifthood · 8- community.gifthood.authApp permission-set The everyday Gifthood member bundle: every community.gifthood.* record type the app writes on a member's behalf. Deliberately excludes anything outside this namespace — blob upload, app.bsky.* grants, and the Ozone RPC grants are requested individually (spec: blob/account/identity can never live in a set; foreign namespaces can't either).
- community.gifthood.exchange record The listing owner's attestation of an exchange: who was chosen to give/receive the listed gift, and when it was completed. The counterparty attests via community.gifthood.exchangeResponse; a mutually confirmed pair is follow-through evidence. Public, like the interest record.
- community.gifthood.exchangeResponse record The counterparty's half of an exchange attestation: confirm that the gift happened, or decline the selection. Public, like the interest record. Indexers honor only responses authored by the DID the referenced exchange names as counterparty; the first valid response wins; a decline created after the exchange's completedAt is not honored (disputes go through reporting, not attestation records).
- community.gifthood.follow record A public follow of another member, expressing interest in their gifting activity. The relationship is owned by the follower and world-readable.
- community.gifthood.interest record A public expression of interest in a listing. Coordination of pickup happens in private, listing-scoped in-app messaging.
- community.gifthood.listing record An offer or request for a free item, discoverable by approximate location.
- community.gifthood.reply record A public note on a listing — appreciation, a question, a joke; the front porch. Thread-native: root is ALWAYS the listing; parent is the listing for top-level notes or another reply once threaded rendering exists. Mirrors app.bsky.feed.post's reply-ref semantics. Public, like the interest record.
- community.gifthood.replygate record The listing owner's moderation of notes on their own listing, bsky-threadgate style: the record key MUST match the listing's record key. hiddenReplies drop from default views (view policy, not deletion — the note survives in its author's repo; reports remain the violation path). Future allow/close rules are additive fields here.
- community.gifthood.actor.defs defs The viewer's home browse area and search radius.
- community.gifthood.actor.getPreferences query Fetch the viewer's personalization settings as one bundle. Always viewer-private (requires a session); no params — the caller's own preferences are returned. AuthRequired when logged out.
- community.gifthood.actor.getProfile query Fetch the rich profile view for a single account.
- community.gifthood.actor.getProfiles query Batch-hydrate display identities (name + avatar) for a set of accounts. Mirrors app.bsky.actor.getProfiles; resolution is server-side and public.
- community.gifthood.actor.profile record A member's gifthood-native profile. The member owns it; the AppView indexes it and layers it over their Bluesky profile field-by-field (a set field overrides Bluesky; an absent field inherits). One record per member, keyed `self`. createdAt is the write-once gifthood join date.
- community.gifthood.feed.defs defs One row of the viewer's activity feed: an outgoing interest the viewer raised on someone's listing, an incoming raised hand on the viewer's own listing, or a neighbor who followed the viewer (carries 'followers' instead of 'listing').
- community.gifthood.feed.getActivity query The signed-in viewer's two-directional gifting activity — outgoing interests + incoming raised hands on their listings, merged newest-first by createdAt. Viewer-private: resolved from the session (no actor param); an unauthenticated caller gets an AuthRequired error.
- community.gifthood.feed.getAuthorListings query Fetch listings created by a specific author (DID), optionally including gone listings. Returns a page of listingView objects ordered newest-first.
- community.gifthood.feed.getListing query Fetch the full detail view of a single listing by DID and record key.
- community.gifthood.feed.getListingExchange query The active exchange for a listing, if any — AppView-derived from community.gifthood.exchange + exchangeResponse records. Unpublished method; served by the gifthood AppView.
- community.gifthood.feed.getListingExchanges query The exchange chains a listing surface should care about — AppView-derived. For a standing listing: the in-flight chains (state pending or completed), at most one per counterparty. For a non-standing listing: the single active exchange (including a confirmed one), as a 0-or-1 element array. Unpublished method; served by the gifthood AppView.
- community.gifthood.feed.getListingInterests query List the interests ('raised hands') on a listing, each with the interested person's resolved identity. Rows are viewer-block-filtered, newest first; totalCount reflects all interests (the public count).
- community.gifthood.feed.getListingReplies query Public notes on a listing, oldest-first, each with the author's resolved identity — AppView-derived from community.gifthood.reply + replygate records. Unpublished method; served by the gifthood AppView.
- community.gifthood.feed.getListings query Fetch listings near a geohash cell, optionally filtered by intent. Returns a page of listingView objects ordered newest-first.
- community.gifthood.geo.defs defs A resolved (named) geo cell — the reverse-geocoded label for a geohash. Distinct from actor.defs#areaView (the saved home area + search radius); this is naming only.
- community.gifthood.geo.resolveArea query Resolve a geohash cell to its reverse-geocoded area label. Public — no authentication (naming a cell is public data, no viewer). Used for the area picker's live name as you pan.
- community.gifthood.graph.getBlocks query Enumerate the accounts blocked by the authenticated viewer (their own block list). Viewer-private: requires a session (AuthRequired logged-out). No actor parameter — only the caller's own list is accessible. Each row is the medium profileView (identity-only; no viewer object, since the block relationship is trivially known). Unbounded and unordered this version; cursor is reserved for future pagination and is never emitted.
- community.gifthood.graph.getFollowers query Enumerate the accounts that follow the given account, newest-first. Each row is a medium profileView (identity + the viewer's per-row follow-state). Public; a block in either direction between the viewer and the subject returns Unavailable.
- community.gifthood.graph.getFollows query Enumerate the accounts that the given account follows, newest-first. Each row is a medium profileView (identity + the viewer's per-row follow-state). Public; a block in either direction between the viewer and the subject returns Unavailable.
- community.gifthood.graph.getKnownFollowers query Return the count and a sample of accounts the authenticated viewer follows who also follow the given subject. Viewer-relative: requires authentication (AuthRequired when logged out). A block in either direction between the viewer and the subject returns Unavailable. The count may exceed the returned sample (capped by limit).
- community.gifthood.graph.getMutes query Enumerate the accounts muted by the authenticated viewer (their own mute list). Viewer-private: requires a session (AuthRequired logged-out). No actor parameter — only the caller's own list is accessible. Each row is the medium profileView (identity-only; no viewer object, since the mute relationship is trivially known). Unbounded and unordered this version; cursor is reserved for future pagination and is never emitted.