community.gifthood.listing
Schema Diff
+19 -2
Compatibility Analysis
Breaking Changes Detected
2 breaking changes, 6 non-breaking changes.
Breaking Changes (2)
- ConstraintAdded ConstraintAdded { vertex_id: "community.gifthood.listing:body.mode", sort: "enum", value: "gift,lend" }
- 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 (6)
- 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.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") }
Migration Guidance
Added Elements
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" }
- ConstraintAdded ConstraintAdded { vertex_id: "community.gifthood.listing:body.mode", sort: "enum", value: "gift,lend" }
Additional Notes
- 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") }
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
+
"mode": {
18
+
"enum": [
19
+
"gift",
20
+
"lend"
21
+
],
22
+
"type": "string",
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
+
},
17
25
"langs": {
18
26
"type": "array",
19
27
"items": {
20
28
"type": "string",
21
29
"format": "language"
22
30
},
23
31
"maxLength": 3,
24
32
"description": "Language(s) the content is written in, as BCP-47 language tags. Author-asserted; clients default from the composer's locale."
25
33
},
26
34
"title": {
27
35
"type": "string",
28
36
"maxLength": 200,
29
37
"minLength": 1,
30
38
"description": "Required short title for the item being offered or requested.",
31
39
"maxGraphemes": 100,
32
40
"minGraphemes": 1
33
41
},
34
42
"facets": {
35
43
"type": "array",
36
44
"items": {
37
45
"ref": "app.bsky.richtext.facet",
38
46
"type": "ref"
39
47
},
40
-
"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 direct-message-only."
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."
41
49
},
42
50
"images": {
43
51
"type": "array",
44
52
"items": {
45
53
"type": "blob",
46
54
"accept": [
47
55
"image/jpeg",
48
56
"image/png",
49
57
"image/webp"
50
58
],
51
59
"maxSize": 1000000
52
60
},
53
61
"maxLength": 4,
54
62
"description": "Up to 4 images of the item, stored as blobs in the poster's repo."
55
63
},
56
64
"intent": {
57
65
"enum": [
58
66
"offer",
59
67
"request"
60
68
],
61
69
"type": "string",
62
70
"description": "Whether the poster is giving away an item or looking for one."
63
71
},
64
72
"labels": {
65
73
"refs": [
66
74
"com.atproto.label.defs#selfLabels"
67
75
],
68
76
"type": "union",
69
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."
70
78
},
79
+
"paused": {
80
+
"type": "boolean",
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
+
},
71
83
"status": {
72
84
"enum": [
73
85
"available",
74
86
"pending",
75
87
"gone"
76
88
],
77
89
"type": "string",
78
90
"description": "Current availability. Clients should treat a missing value as 'available'."
79
91
},
80
92
"geohash": {
81
93
"type": "string",
82
94
"maxLength": 6,
83
95
"minLength": 1,
84
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."
85
97
},
86
98
"category": {
87
99
"enum": [
88
100
"furniture",
89
101
"kitchen",
90
102
"clothing",
91
103
"baby",
92
104
"books",
93
105
"instruments",
94
106
"electronics",
95
107
"tools",
96
108
"garden",
97
109
"health",
98
110
"pets",
99
111
"hobbies",
100
112
"food",
101
113
"animals",
102
114
"service",
115
+
"office",
103
116
"other"
104
117
],
105
118
"type": "string",
106
-
"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."
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
+
},
121
+
"standing": {
122
+
"type": "boolean",
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."
107
124
},
108
125
"createdAt": {
109
126
"type": "string",
110
127
"format": "datetime"
111
128
},
112
129
"imageAlts": {
113
130
"type": "array",
114
131
"items": {
115
132
"type": "string",
116
133
"maxGraphemes": 1000
117
134
},
118
135
"maxLength": 4,
119
136
"description": "Alt text for images, parallel to the images array by index."
120
137
},
121
138
"description": {
122
139
"type": "string",
123
140
"maxLength": 3000,
124
141
"minLength": 1,
125
142
"description": "Required free text describing the item being offered or requested.",
126
143
"maxGraphemes": 1500,
127
144
"minGraphemes": 1
128
145
},
129
146
"locationName": {
130
147
"type": "string",
131
148
"maxLength": 300,
132
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.",
133
150
"maxGraphemes": 100
134
151
}
135
152
}
136
153
},
137
154
"description": "An offer or request for a free item, discoverable by approximate location."
138
155
}
139
156
},
140
157
"$type": "com.atproto.lexicon.schema",
141
158
"lexicon": 1
142
159
}