dev.knotless.getPreferences

lexicons.knotless.dev

Schema Diff

+5 -2

From

CID
bafyreidk4ud6oxo...
Indexed At
2026-10-28 23:51 UTC
View this version

To

CID
bafyreidudiumi7o...
Indexed At
2026-10-29 06:15 UTC
View this version

Compatibility Analysis

Breaking Changes Detected

2 breaking changes, 0 non-breaking changes.

Breaking Changes (2)
  • ConstraintTightened ConstraintTightened { vertex_id: "dev.knotless.getPreferences#notificationReason.reason", sort: "knownValues", old_value: "[\"star\",\"follow\",\"pull\",\"issue\",\"comment\"]", new_value: "[\"star\",\"follow\",\"pull\",\"issue\",\"comment\",\"mention\",\"review-requested\"]" }
  • ConstraintTightened ConstraintTightened { vertex_id: "dev.knotless.getPreferences#appearancePref.theme", sort: "knownValues", old_value: "[\"light\",\"dark\",\"latte\",\"mocha\",\"dracula\",\"pckt\",\"plyr\"]", new_value: "[\"light\",\"dark\",\"latte\",\"mocha\",\"dracula\",\"pckt\",\"plyr\",\"blacksky\"]" }

Migration Guidance

Constraint Changes

  • ConstraintTightened ConstraintTightened { vertex_id: "dev.knotless.getPreferences#appearancePref.theme", sort: "knownValues", old_value: "[\"light\",\"dark\",\"latte\",\"mocha\",\"dracula\",\"pckt\",\"plyr\"]", new_value: "[\"light\",\"dark\",\"latte\",\"mocha\",\"dracula\",\"pckt\",\"plyr\",\"blacksky\"]" }
  • ConstraintTightened ConstraintTightened { vertex_id: "dev.knotless.getPreferences#notificationReason.reason", sort: "knownValues", old_value: "[\"star\",\"follow\",\"pull\",\"issue\",\"comment\"]", new_value: "[\"star\",\"follow\",\"pull\",\"issue\",\"comment\",\"mention\",\"review-requested\"]" }
1 1
{
2 2
  "$type": "com.atproto.lexicon.schema",
3 3
  "defs": {
4 4
    "appearancePref": {
5 5
      "description": "How the pages are drawn for the account.",
6 6
      "properties": {
7 7
        "theme": {
8 8
          "description": "The colours the pages are drawn in, as their Appearance settings name them. Absent, or one the pages do not know, they follow the system's light or dark.",
9 9
          "knownValues": [
10 10
            "light",
11 11
            "dark",
12 12
            "latte",
13 13
            "mocha",
14 14
            "dracula",
15 15
            "pckt",
16 -
            "plyr"
16 +
            "plyr",
17 +
            "blacksky"
17 18
          ],
18 19
          "maxLength": 64,
19 20
          "type": "string"
20 21
        }
21 22
      },
22 23
      "type": "object"
23 24
    },
24 25
    "main": {
25 26
      "description": "The asking account's preferences, as the appview keeps them, apart from any record: one of each kind, of those it has set, and always its notifications, which dev.knotless.listNotifications and getUnreadCount follow. A kind it has not set a reader takes as its default. The pages' login copies what they act on into the browser. Requires authentication: a service token, or the session cookie the pages' login sets.",
26 27
      "errors": [
27 28
        {
28 29
          "description": "No account asks.",
29 30
          "name": "AuthenticationRequired"
30 31
        },
31 32
        {
32 33
          "description": "This appview keeps no index, so it keeps no preferences.",
33 34
          "name": "NotFound"
34 35
        }
35 36
      ],
36 37
      "output": {
37 38
        "encoding": "application/json",
38 39
        "schema": {
39 40
          "ref": "#preferences",
40 41
          "type": "ref"
41 42
        }
42 43
      },
43 44
      "type": "query"
44 45
    },
45 46
    "notificationPref": {
46 47
      "description": "Which notifications the account hears of. Until it says, every reason, from anyone.",
47 48
      "properties": {
48 49
        "followedOnly": {
49 50
          "description": "Whether it hears only of what accounts it follows on knotless did. Not, when absent.",
50 51
          "type": "boolean"
51 52
        },
52 53
        "reasons": {
53 54
          "description": "Reasons a notification is given for, each on or off. Given back, every one dev.knotless.listNotifications gives; set, one not named is on.",
54 55
          "items": {
55 56
            "ref": "#notificationReason",
56 57
            "type": "ref"
57 58
          },
58 59
          "maxLength": 64,
59 60
          "type": "array"
60 61
        }
61 62
      },
62 63
      "type": "object"
63 64
    },
64 65
    "notificationReason": {
65 66
      "description": "Whether an account hears of one reason's notifications.",
66 67
      "properties": {
67 68
        "enabled": {
68 69
          "description": "Whether it hears of them.",
69 70
          "type": "boolean"
70 71
        },
71 72
        "reason": {
72 73
          "description": "A reason, as dev.knotless.listNotifications#notification gives it.",
73 74
          "knownValues": [
74 75
            "star",
75 76
            "follow",
76 77
            "pull",
77 78
            "issue",
78 -
            "comment"
79 +
            "comment",
80 +
            "mention",
81 +
            "review-requested"
79 82
          ],
80 83
          "maxLength": 64,
81 84
          "type": "string"
82 85
        }
83 86
      },
84 87
      "required": [
85 88
        "reason",
86 89
        "enabled"
87 90
      ],
88 91
      "type": "object"
89 92
    },
90 93
    "preferences": {
91 94
      "description": "An account's preferences, each of a kind.",
92 95
      "properties": {
93 96
        "preferences": {
94 97
          "description": "At most one of each kind. Kinds unknown to a reader are passed over.",
95 98
          "items": {
96 99
            "refs": [
97 100
              "#appearancePref",
98 101
              "#notificationPref"
99 102
            ],
100 103
            "type": "union"
101 104
          },
102 105
          "maxLength": 32,
103 106
          "type": "array"
104 107
        }
105 108
      },
106 109
      "required": [
107 110
        "preferences"
108 111
      ],
109 112
      "type": "object"
110 113
    }
111 114
  },
112 115
  "description": "The asking account's preferences, of how knotless is shown to it.",
113 116
  "id": "dev.knotless.getPreferences",
114 117
  "lexicon": 1
115 118
}

Compare Other Versions

Lexicon Garden

@