{
"id": "community.gifthood.listing",
"defs": {
"main": {
"key": "tid",
"type": "record",
"record": {
"type": "object",
"required": [
"title",
"intent",
"description",
"geohash",
"createdAt"
],
"properties": {
"mode": {
"enum": [
"gift",
"lend"
],
"type": "string",
"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'."
},
"langs": {
"type": "array",
"items": {
"type": "string",
"format": "language"
},
"maxLength": 3,
"description": "Language(s) the content is written in, as BCP-47 language tags. Author-asserted; clients default from the composer's locale."
},
"title": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Required short title for the item being offered or requested.",
"maxGraphemes": 100,
"minGraphemes": 1
},
"facets": {
"type": "array",
"items": {
"ref": "app.bsky.richtext.facet",
"type": "ref"
},
"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."
},
"images": {
"type": "array",
"items": {
"type": "blob",
"accept": [
"image/jpeg",
"image/png",
"image/webp"
],
"maxSize": 1000000
},
"maxLength": 4,
"description": "Up to 4 images of the item, stored as blobs in the poster's repo."
},
"intent": {
"enum": [
"offer",
"request"
],
"type": "string",
"description": "Whether the poster is giving away an item or looking for one."
},
"labels": {
"refs": [
"com.atproto.label.defs#selfLabels"
],
"type": "union",
"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."
},
"paused": {
"type": "boolean",
"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."
},
"status": {
"enum": [
"available",
"pending",
"gone"
],
"type": "string",
"description": "Current availability. Clients should treat a missing value as 'available'."
},
"geohash": {
"type": "string",
"maxLength": 6,
"minLength": 1,
"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."
},
"category": {
"enum": [
"furniture",
"kitchen",
"clothing",
"baby",
"books",
"instruments",
"electronics",
"tools",
"garden",
"health",
"pets",
"hobbies",
"food",
"animals",
"service",
"office",
"other"
],
"type": "string",
"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."
},
"standing": {
"type": "boolean",
"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."
},
"createdAt": {
"type": "string",
"format": "datetime"
},
"imageAlts": {
"type": "array",
"items": {
"type": "string",
"maxGraphemes": 1000
},
"maxLength": 4,
"description": "Alt text for images, parallel to the images array by index."
},
"description": {
"type": "string",
"maxLength": 3000,
"minLength": 1,
"description": "Required free text describing the item being offered or requested.",
"maxGraphemes": 1500,
"minGraphemes": 1
},
"locationName": {
"type": "string",
"maxLength": 300,
"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.",
"maxGraphemes": 100
}
}
},
"description": "An offer or request for a free item, discoverable by approximate location."
}
},
"$type": "com.atproto.lexicon.schema",
"lexicon": 1
}