community.gifthood.listing
Schema Diff
+27 -0
Compatibility Analysis
Breaking Changes Detected
2 breaking changes, 8 non-breaking changes.
Breaking Changes (2)
- 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") }
Non-Breaking Changes (8)
- 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.imageAspectRatios" }
- AddedVertex AddedVertex { vertex_id: "community.gifthood.listing:body.imageAspectRatios:items" }
- 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.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: "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.imageAspectRatios" }AddedVertex { vertex_id: "community.gifthood.listing:body.imageAspectRatios:items" }
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.imageAspectRatios", kind: "prop", name: Some("imageAspectRatios") }
- 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
"id": "community.gifthood.listing",
3
3
"defs": {
4
4
"main": {
5
5
"key": "tid",
6
6
"type": "record",
7
7
"record": {
8
8
"type": "object",
9
9
"required": [
10
10
"title",
11
11
"intent",
12
12
"description",
13
13
"geohash",
14
14
"createdAt"
15
15
],
16
16
"properties": {
17
17
"mode": {
18
18
"enum": [
19
19
"gift",
20
20
"lend"
21
21
],
22
22
"type": "string",
23
23
"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'."
24
24
},
25
25
"langs": {
26
26
"type": "array",
27
27
"items": {
28
28
"type": "string",
29
29
"format": "language"
30
30
},
31
31
"maxLength": 3,
32
32
"description": "Language(s) the content is written in, as BCP-47 language tags. Author-asserted; clients default from the composer's locale."
33
33
},
34
34
"title": {
35
35
"type": "string",
36
36
"maxLength": 200,
37
37
"minLength": 1,
38
38
"description": "Required short title for the item being offered or requested.",
39
39
"maxGraphemes": 100,
40
40
"minGraphemes": 1
41
41
},
42
42
"facets": {
43
43
"type": "array",
44
44
"items": {
45
45
"ref": "app.bsky.richtext.facet",
46
46
"type": "ref"
47
47
},
48
48
"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."
49
49
},
50
50
"images": {
51
51
"type": "array",
52
52
"items": {
53
53
"type": "blob",
54
54
"accept": [
55
55
"image/jpeg",
56
56
"image/png",
57
57
"image/webp"
58
58
],
59
59
"maxSize": 1000000
60
60
},
61
61
"maxLength": 4,
62
62
"description": "Up to 4 images of the item, stored as blobs in the poster's repo."
63
63
},
64
64
"intent": {
65
65
"enum": [
66
66
"offer",
67
67
"request"
68
68
],
69
69
"type": "string",
70
70
"description": "Whether the poster is giving away an item or looking for one."
71
71
},
72
72
"labels": {
73
73
"refs": [
74
74
"com.atproto.label.defs#selfLabels"
75
75
],
76
76
"type": "union",
77
77
"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."
78
78
},
79
79
"paused": {
80
80
"type": "boolean",
81
81
"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."
82
82
},
83
83
"status": {
84
84
"enum": [
85
85
"available",
86
86
"pending",
87
87
"gone"
88
88
],
89
89
"type": "string",
90
90
"description": "Current availability. Clients should treat a missing value as 'available'."
91
91
},
92
92
"geohash": {
93
93
"type": "string",
94
94
"maxLength": 6,
95
95
"minLength": 1,
96
96
"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."
97
97
},
98
98
"category": {
99
99
"enum": [
100
100
"furniture",
101
101
"kitchen",
102
102
"clothing",
103
103
"baby",
104
104
"books",
105
105
"instruments",
106
106
"electronics",
107
107
"tools",
108
108
"garden",
109
109
"health",
110
110
"pets",
111
111
"hobbies",
112
112
"food",
113
113
"animals",
114
114
"service",
115
115
"office",
116
116
"other"
117
117
],
118
118
"type": "string",
119
119
"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."
120
120
},
121
121
"standing": {
122
122
"type": "boolean",
123
123
"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."
124
124
},
125
125
"createdAt": {
126
126
"type": "string",
127
127
"format": "datetime"
128
128
},
129
129
"imageAlts": {
130
130
"type": "array",
131
131
"items": {
132
132
"type": "string",
133
133
"maxGraphemes": 1000
134
134
},
135
135
"maxLength": 4,
136
136
"description": "Alt text for images, parallel to the images array by index."
137
137
},
138
138
"description": {
139
139
"type": "string",
140
140
"maxLength": 3000,
141
141
"minLength": 1,
142
142
"description": "Required free text describing the item being offered or requested.",
143
143
"maxGraphemes": 1500,
144
144
"minGraphemes": 1
145
145
},
146
146
"locationName": {
147
147
"type": "string",
148
148
"maxLength": 300,
149
149
"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.",
150
150
"maxGraphemes": 100
151
+
},
152
+
"imageAspectRatios": {
153
+
"type": "array",
154
+
"items": {
155
+
"ref": "#aspectRatio",
156
+
"type": "ref"
157
+
},
158
+
"maxLength": 4,
159
+
"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."
151
160
}
152
161
}
153
162
},
154
163
"description": "An offer or request for a free item, discoverable by approximate location."
164
+
},
165
+
"aspectRatio": {
166
+
"type": "object",
167
+
"required": [
168
+
"width",
169
+
"height"
170
+
],
171
+
"properties": {
172
+
"width": {
173
+
"type": "integer",
174
+
"minimum": 1
175
+
},
176
+
"height": {
177
+
"type": "integer",
178
+
"minimum": 1
179
+
}
180
+
},
181
+
"description": "width:height represents an aspect ratio. It may be approximate, and may not correspond to absolute dimensions in any given unit."
155
182
}
156
183
},
157
184
"$type": "com.atproto.lexicon.schema",
158
185
"lexicon": 1
159
186
}