com.t0ronto.commons.defs

{
  "id": "com.t0ronto.commons.defs",
  "defs": {
    "sameAs": {
      "type": "token",
      "description": "owl:sameAs — strong identity claim that this record and the target URI denote the same thing."
    },
    "social": {
      "type": "object",
      "required": [
        "platform",
        "value"
      ],
      "properties": {
        "value": {
          "type": "string",
          "description": "Value shape depends on `platform` (see the def-level description for the contract)."
        },
        "platform": {
          "type": "string",
          "description": "Platform identifier. Open set — see knownValues for the curated list; new platforms can be added by clients.",
          "knownValues": [
            "bluesky",
            "instagram",
            "facebook",
            "twitter",
            "x",
            "linkedin",
            "youtube",
            "tiktok",
            "mastodon",
            "github",
            "meetup",
            "telegram",
            "luma",
            "discord",
            "eventbrite",
            "email",
            "website"
          ]
        }
      },
      "description": "A social-platform presence for an entity. The platform list is open — clients should fall back gracefully on unknown values. Per-platform value semantics differ: `bluesky` carries a DID (did:plc:* or did:web:*) so resolution flows through the AT Proto directory; `email` carries an email address; `website` carries a URL; other platforms carry either a URL or a platform-native handle."
    },
    "alignment": {
      "type": "object",
      "required": [
        "predicate",
        "target"
      ],
      "properties": {
        "note": {
          "type": "string",
          "description": "Optional editorial note about why this alignment was chosen.",
          "maxGraphemes": 280
        },
        "target": {
          "type": "string",
          "format": "uri",
          "description": "External URI being aligned to (e.g. an LCSH subject heading, a Wikidata QID, a Getty AAT term)."
        },
        "predicate": {
          "type": "string",
          "description": "Which alignment kind. One of the tokens defined in this file.",
          "knownValues": [
            "com.t0ronto.commons.defs#exactMatch",
            "com.t0ronto.commons.defs#closeMatch",
            "com.t0ronto.commons.defs#broadMatch",
            "com.t0ronto.commons.defs#narrowMatch",
            "com.t0ronto.commons.defs#sameAs"
          ]
        }
      },
      "description": "A cross-vocabulary mapping from this record to an external URI. Uses SKOS match predicates for concept-to-concept links and owl:sameAs for strong identity claims (e.g. an entity's Wikidata QID)."
    },
    "broadMatch": {
      "type": "token",
      "description": "skos:broadMatch — this concept is *narrower* than the target."
    },
    "closeMatch": {
      "type": "token",
      "description": "skos:closeMatch — the two concepts are similar enough to be used interchangeably for most purposes."
    },
    "exactMatch": {
      "type": "token",
      "description": "skos:exactMatch — the two concepts are interchangeable in any context."
    },
    "narrowMatch": {
      "type": "token",
      "description": "skos:narrowMatch — this concept is *broader* than the target."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1
}