[Feature Request]: Add `app.bsky.actor.contentVisibilityDeclaration` record support

Open
#350 4 comments 0 reactions 0 assignees View on GitHub

@KC-2001MS is already working on this.

Since Nov 17, 2026.

  • #351 by @KC-2001MS — open

Assessment

Difficulty
3/5
Estimated time
1-2 days
Newbie friendliness
68/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Active
Tech stack
swift
Domain
api

Research direction

Read the existing ATRecordProtocol models and ATProtoBluesky record wrappers for comparable actor records, then check the linked lexicon for the record shape and literal self key. Add the typed record and matching read and write wrappers; done when callers can read and write this record through the typed APIs, consistent with existing wrappers.

Written by the indexing model from the issue text.

Description

new feature
Summary

The app.bsky.actor.contentVisibilityDeclaration record (rkey self) is not available in ATProtoKit.

Pain points

This record cannot be read or written through ATProtoKit's typed APIs.

Considered Alternatives

Defining the record type on the app side and using getRepositoryRecord / putRecord directly.

Is this a breaking change?

No

Library Examples

No — this is an additive model and method set.

Additional Context

Lexicon: https://github.com/bluesky-social/bsky/blob/main/lexicons/app/bsky/actor/contentVisibilityDeclaration.json

{
  "lexicon": 1,
  "id": "app.bsky.actor.contentVisibilityDeclaration",
  "defs": {
    "main": {
      "type": "record",
      "description": "A declaration of an account's preferences for appearing in content discovery surfaces.",
      "key": "literal:self",
      "record": {
        "type": "object",
        "required": ["hideFromAlgorithmicRecommendations"],
        "properties": {
          "hideFromAlgorithmicRecommendations": {
            "type": "boolean",
            "description": "Whether the account requests that its posts be hidden from algorithmic recommendations. Consumers must treat a missing record as false."
          }
        }
      }
    }
  }
}

Proposed additions:

  • AppBskyLexicon.Actor.ContentVisibilityDeclarationRecord (ATRecordProtocol)
  • ATProtoBluesky wrappers for reading and writing the self record, following the existing record wrappers
Dominant language
Swift
Stars
226
Forks
40
Avg merge
2h 56m
Merged PRs (30d)
3

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from MasterJ93/ATProtoKit

All issues in MasterJ93/ATProtoKit

Similar issues

More Swift issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.