community.gifthood.listing
Schema Diff
+53 -1
Compatibility Analysis
Breaking Changes Detected
3 breaking changes, 20 non-breaking changes.
Breaking Changes (3)
- RequiredEdgeAdded RequiredEdgeAdded { vertex_id: "community.gifthood.listing#aspectRatio", src: "community.gifthood.listing#aspectRatio", tgt: "community.gifthood.listing#aspectRatio.height", kind: "prop", name: Some("height") }
- RequiredEdgeAdded RequiredEdgeAdded { vertex_id: "community.gifthood.listing#aspectRatio", src: "community.gifthood.listing#aspectRatio", tgt: "community.gifthood.listing#aspectRatio.width", kind: "prop", name: Some("width") }
- ConstraintTightened ConstraintTightened { vertex_id: "community.gifthood.listing:body.category", sort: "enum", old_value: "furniture,kitchen,clothing,baby,books,instruments,electronics,tools,garden,health,pets,hobbies,food,animals,service,other", new_value: "furniture,kitchen,clothing,baby,books,instruments,electronics,tools,garden,health,pets,hobbies,food,animals,service,office,other" }
Non-Breaking Changes (20)
- AddedVertex AddedVertex { vertex_id: "app.bsky.richtext.facet" }
- AddedVertex AddedVertex { vertex_id: "community.gifthood.listing#aspectRatio" }
- AddedVertex AddedVertex { vertex_id: "community.gifthood.listing#aspectRatio.height" }
- AddedVertex AddedVertex { vertex_id: "community.gifthood.listing#aspectRatio.width" }
- AddedVertex AddedVertex { vertex_id: "community.gifthood.listing:body.facets" }
- AddedVertex AddedVertex { vertex_id: "community.gifthood.listing:body.facets:items" }
- AddedVertex AddedVertex { vertex_id: "community.gifthood.listing:body.imageAspectRatios" }
- AddedVertex AddedVertex { vertex_id: "community.gifthood.listing:body.imageAspectRatios:items" }
- AddedVertex AddedVertex { vertex_id: "community.gifthood.listing:body.mode" }
- AddedVertex AddedVertex { vertex_id: "community.gifthood.listing:body.paused" }
- AddedVertex AddedVertex { vertex_id: "community.gifthood.listing:body.standing" }
- AddedEdge AddedEdge { src: "community.gifthood.listing:body", tgt: "community.gifthood.listing:body.facets", kind: "prop", name: Some("facets") }
- AddedEdge AddedEdge { src: "community.gifthood.listing:body", tgt: "community.gifthood.listing:body.imageAspectRatios", kind: "prop", name: Some("imageAspectRatios") }
- AddedEdge AddedEdge { src: "community.gifthood.listing:body", tgt: "community.gifthood.listing:body.mode", kind: "prop", name: Some("mode") }
- AddedEdge AddedEdge { src: "community.gifthood.listing:body", tgt: "community.gifthood.listing:body.paused", kind: "prop", name: Some("paused") }
- AddedEdge AddedEdge { src: "community.gifthood.listing:body", tgt: "community.gifthood.listing:body.standing", kind: "prop", name: Some("standing") }
- AddedEdge AddedEdge { src: "community.gifthood.listing:body.facets", tgt: "community.gifthood.listing:body.facets:items", kind: "items", name: None }
- AddedEdge AddedEdge { src: "community.gifthood.listing:body.facets:items", tgt: "app.bsky.richtext.facet", kind: "ref", name: None }
- AddedEdge AddedEdge { src: "community.gifthood.listing:body.imageAspectRatios", tgt: "community.gifthood.listing:body.imageAspectRatios:items", kind: "items", name: None }
- AddedEdge AddedEdge { src: "community.gifthood.listing:body.imageAspectRatios:items", tgt: "community.gifthood.listing#aspectRatio", kind: "ref", name: None }
Migration Guidance
Added Elements
AddedVertex { vertex_id: "app.bsky.richtext.facet" }AddedVertex { vertex_id: "community.gifthood.listing#aspectRatio" }AddedVertex { vertex_id: "community.gifthood.listing#aspectRatio.height" }AddedVertex { vertex_id: "community.gifthood.listing#aspectRatio.width" }AddedVertex { vertex_id: "community.gifthood.listing:body.facets" }AddedVertex { vertex_id: "community.gifthood.listing:body.facets:items" }AddedVertex { vertex_id: "community.gifthood.listing:body.imageAspectRatios" }AddedVertex { vertex_id: "community.gifthood.listing:body.imageAspectRatios:items" }AddedVertex { vertex_id: "community.gifthood.listing:body.mode" }AddedVertex { vertex_id: "community.gifthood.listing:body.paused" }AddedVertex { vertex_id: "community.gifthood.listing:body.standing" }
Constraint Changes
- ConstraintTightened ConstraintTightened { vertex_id: "community.gifthood.listing:body.category", sort: "enum", old_value: "furniture,kitchen,clothing,baby,books,instruments,electronics,tools,garden,health,pets,hobbies,food,animals,service,other", new_value: "furniture,kitchen,clothing,baby,books,instruments,electronics,tools,garden,health,pets,hobbies,food,animals,service,office,other" }
Additional Notes
- Breaking: RequiredEdgeAdded { vertex_id: "community.gifthood.listing#aspectRatio", src: "community.gifthood.listing#aspectRatio", tgt: "community.gifthood.listing#aspectRatio.height", kind: "prop", name: Some("height") }
- Breaking: RequiredEdgeAdded { vertex_id: "community.gifthood.listing#aspectRatio", src: "community.gifthood.listing#aspectRatio", tgt: "community.gifthood.listing#aspectRatio.width", kind: "prop", name: Some("width") }
- Non-breaking: AddedEdge { src: "community.gifthood.listing:body", tgt: "community.gifthood.listing:body.facets", kind: "prop", name: Some("facets") }
- Non-breaking: AddedEdge { src: "community.gifthood.listing:body", tgt: "community.gifthood.listing:body.imageAspectRatios", kind: "prop", name: Some("imageAspectRatios") }
- Non-breaking: AddedEdge { src: "community.gifthood.listing:body", tgt: "community.gifthood.listing:body.mode", kind: "prop", name: Some("mode") }
- Non-breaking: AddedEdge { src: "community.gifthood.listing:body", tgt: "community.gifthood.listing:body.paused", kind: "prop", name: Some("paused") }
- Non-breaking: AddedEdge { src: "community.gifthood.listing:body", tgt: "community.gifthood.listing:body.standing", kind: "prop", name: Some("standing") }
- Non-breaking: AddedEdge { src: "community.gifthood.listing:body.facets", tgt: "community.gifthood.listing:body.facets:items", kind: "items", name: None }
- Non-breaking: AddedEdge { src: "community.gifthood.listing:body.facets:items", tgt: "app.bsky.richtext.facet", kind: "ref", name: None }
- Non-breaking: AddedEdge { src: "community.gifthood.listing:body.imageAspectRatios", tgt: "community.gifthood.listing:body.imageAspectRatios:items", kind: "items", name: None }
- Non-breaking: AddedEdge { src: "community.gifthood.listing:body.imageAspectRatios:items", tgt: "community.gifthood.listing#aspectRatio", kind: "ref", name: None }
1
1
{
2
2
"$type": "com.atproto.lexicon.schema",
3
3
"defs": {
4
+
"aspectRatio": {
5
+
"description": "width:height represents an aspect ratio. It may be approximate, and may not correspond to absolute dimensions in any given unit.",
6
+
"properties": {
7
+
"height": {
8
+
"minimum": 1,
9
+
"type": "integer"
10
+
},
11
+
"width": {
12
+
"minimum": 1,
13
+
"type": "integer"
14
+
}
15
+
},
16
+
"required": [
17
+
"width",
18
+
"height"
19
+
],
20
+
"type": "object"
21
+
},
4
22
"main": {
5
23
"description": "An offer or request for a free item, discoverable by approximate location.",
6
24
"key": "tid",
7
25
"record": {
8
26
"properties": {
9
27
"category": {
10
-
"description": "Optional single-level category for opt-out feed filtering. Append-only enum; unknown or missing values index as 'other'. Never used for proximity or safety logic.",
28
+
"description": "Optional single-level category for opt-out feed filtering. Additive-only enum (values may be inserted, never removed or renamed); unknown or missing values index as 'other'. Never used for proximity or safety logic.",
11
29
"enum": [
12
30
"furniture",
13
31
"kitchen",
14
32
"clothing",
15
33
"baby",
16
34
"books",
17
35
"instruments",
18
36
"electronics",
19
37
"tools",
20
38
"garden",
21
39
"health",
22
40
"pets",
23
41
"hobbies",
24
42
"food",
25
43
"animals",
26
44
"service",
45
+
"office",
27
46
"other"
28
47
],
29
48
"type": "string"
30
49
},
31
50
"createdAt": {
32
51
"format": "datetime",
33
52
"type": "string"
34
53
},
35
54
"description": {
36
55
"description": "Required free text describing the item being offered or requested.",
37
56
"maxGraphemes": 1500,
38
57
"maxLength": 3000,
39
58
"minGraphemes": 1,
40
59
"minLength": 1,
41
60
"type": "string"
42
61
},
62
+
"facets": {
63
+
"description": "Annotations over `description` (mentions, links) keyed by UTF-8 byte range. Reuses app.bsky.richtext.facet for atmosphere-wide interop. Author-asserted at compose time; clients MUST treat them as display hints, re-validate ranges, and never trust a facet URI over the visible text. Addresses and phone numbers are deliberately NOT faceted here — those affordances are private-message-only.",
64
+
"items": {
65
+
"ref": "app.bsky.richtext.facet",
66
+
"type": "ref"
67
+
},
68
+
"type": "array"
69
+
},
43
70
"geohash": {
44
71
"description": "Approximate location as a geohash, precision 6 (~1.2km cell). This is a privacy floor: indexers MUST truncate any finer-precision value to 6 characters before indexing or display.",
45
72
"maxLength": 6,
46
73
"minLength": 1,
47
74
"type": "string"
48
75
},
49
76
"imageAlts": {
50
77
"description": "Alt text for images, parallel to the images array by index.",
51
78
"items": {
52
79
"maxGraphemes": 1000,
53
80
"type": "string"
54
81
},
55
82
"maxLength": 4,
56
83
"type": "array"
57
84
},
85
+
"imageAspectRatios": {
86
+
"description": "Aspect ratio of each image, parallel to the images array by index. Written by the composer from the encoded upload so viewers can size the image box before the bytes arrive. Absent on listings posted before the field existed.",
87
+
"items": {
88
+
"ref": "#aspectRatio",
89
+
"type": "ref"
90
+
},
91
+
"maxLength": 4,
92
+
"type": "array"
93
+
},
58
94
"images": {
59
95
"description": "Up to 4 images of the item, stored as blobs in the poster's repo.",
60
96
"items": {
61
97
"accept": [
62
98
"image/jpeg",
63
99
"image/png",
64
100
"image/webp"
65
101
],
66
102
"maxSize": 1000000,
67
103
"type": "blob"
68
104
},
69
105
"maxLength": 4,
70
106
"type": "array"
71
107
},
72
108
"intent": {
73
109
"description": "Whether the poster is giving away an item or looking for one.",
74
110
"enum": [
75
111
"offer",
76
112
"request"
77
113
],
78
114
"type": "string"
79
115
},
80
116
"labels": {
81
117
"description": "Self-labels set by the author. Used to flag mature/adult content (e.g. the global 'sexual' value), which the AppView gates behind an opt-in.",
82
118
"refs": [
83
119
"com.atproto.label.defs#selfLabels"
84
120
],
85
121
"type": "union"
86
122
},
87
123
"langs": {
88
124
"description": "Language(s) the content is written in, as BCP-47 language tags. Author-asserted; clients default from the composer's locale.",
89
125
"items": {
90
126
"format": "language",
91
127
"type": "string"
92
128
},
93
129
"maxLength": 3,
94
130
"type": "array"
95
131
},
96
132
"locationName": {
97
133
"description": "Optional human-readable area name. App-populated via reverse geocoding of the geohash cell. Display only; MUST NOT be used for proximity matching or filtering.",
98
134
"maxGraphemes": 100,
99
135
"maxLength": 300,
100
136
"type": "string"
101
137
},
138
+
"mode": {
139
+
"description": "How the item changes hands. 'gift' (the default when absent) transfers ownership; 'lend' expects the item back — the listing behaves as a standing offer and each exchange gains a return leg (see exchange.returnedAt). Readers MUST treat unknown or missing values as 'gift'.",
140
+
"enum": [
141
+
"gift",
142
+
"lend"
143
+
],
144
+
"type": "string"
145
+
},
146
+
"paused": {
147
+
"description": "Owner-set temporary unavailability (using the item themselves, away for a while). AppViews hide paused listings from feeds but keep the detail view reachable with interest disabled. Absent means active. Orthogonal to status; 'gone' still wins.",
148
+
"type": "boolean"
149
+
},
150
+
"standing": {
151
+
"description": "Standing (renewing) offer: the owner can run exchange chains with multiple neighbors over time. Absent or false means the listing is exhausted by a single exchange. AppViews keep a standing listing available while chains run; only the owner's manual 'gone' ends it.",
152
+
"type": "boolean"
153
+
},
102
154
"status": {
103
155
"description": "Current availability. Clients should treat a missing value as 'available'.",
104
156
"enum": [
105
157
"available",
106
158
"pending",
107
159
"gone"
108
160
],
109
161
"type": "string"
110
162
},
111
163
"title": {
112
164
"description": "Required short title for the item being offered or requested.",
113
165
"maxGraphemes": 100,
114
166
"maxLength": 200,
115
167
"minGraphemes": 1,
116
168
"minLength": 1,
117
169
"type": "string"
118
170
}
119
171
},
120
172
"required": [
121
173
"title",
122
174
"intent",
123
175
"description",
124
176
"geohash",
125
177
"createdAt"
126
178
],
127
179
"type": "object"
128
180
},
129
181
"type": "record"
130
182
}
131
183
},
132
184
"id": "community.gifthood.listing",
133
185
"lexicon": 1
134
186
}