# com.t0ronto.commons.defs

> Published by [t0ronto.com](https://lexicon.garden/identity/did:plc:aux2optnbxmnea7ijbfca3ak)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:aux2optnbxmnea7ijbfca3ak/com.t0ronto.commons.defs)
- [Documentation](https://lexicon.garden/lexicon/did:plc:aux2optnbxmnea7ijbfca3ak/com.t0ronto.commons.defs/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:aux2optnbxmnea7ijbfca3ak/com.t0ronto.commons.defs/examples)

## Definitions

### `com.t0ronto.commons.defs#social`

**Type**: `object`

A social-platform presence, used as a com.t0ronto.commons.statement objectStruct (predicate `social`). 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.

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `value` | `string` | Yes | Value shape depends on `platform` (see the def-level description for the contract). |
| `platform` | `string` | Yes | Platform identifier. Open set — see knownValues for the curated list; new platforms can be added by clients. |

## Raw Schema

```json
{
  "id": "com.t0ronto.commons.defs",
  "defs": {
    "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, used as a com.t0ronto.commons.statement objectStruct (predicate `social`). 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."
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1
}
```