# app.rocksky.event.defs

> Published by [rocksky.app](https://lexicon.garden/identity/did:plc:vegqomyce4ssoqs7zwqvgqty)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:vegqomyce4ssoqs7zwqvgqty/app.rocksky.event.defs)
- [Documentation](https://lexicon.garden/lexicon/did:plc:vegqomyce4ssoqs7zwqvgqty/app.rocksky.event.defs/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:vegqomyce4ssoqs7zwqvgqty/app.rocksky.event.defs/examples)

## Definitions

### `app.rocksky.event.defs#artistView`

**Type**: `object`

An artist on an event lineup, linked to the Rocksky artist when one was resolved.

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `id` | `string` | No | The unique identifier of the linked Rocksky artist. |
| `mbid` | `string` | No | MusicBrainz artist id. |
| `name` | `string` | Yes | The artist name as billed on the event. |
| `picture` | `string` | No | The picture of the linked artist. |
| `role` | `string` | No | The artist's billing on this event. |
| `sha256` | `string` | No | The SHA256 hash of the linked artist. |
| `stage` | `string` | No | The stage the artist plays on. |
| `startsAt` | `string` (datetime) | No | When this artist's set starts. |
| `uri` | `string` (at-uri) | No | AT-URI of the linked artist. |

### `app.rocksky.event.defs#eventView`

**Type**: `object`

A music event: the calendar event merged with its app.rocksky.event.music annotation.

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `artists` | `array` | Yes | The lineup, in billing order. |
| `cid` | `string` (cid) | No | CID of the calendar event record revision that was indexed. |
| `createdAt` | `string` (datetime) | Yes | When the event record was created. |
| `description` | `string` | No | The description of the event. |
| `endsAt` | `string` (datetime) | No | When the event ends. |
| `externalIds` | `ref` → `app.rocksky.event.music#externalIds` | No |  |
| `genre` | `string` | No | The main genre of the event. |
| `id` | `string` | Yes | The unique identifier of the event. |
| `imageUrl` | `string` (uri) | No | Poster or banner image of the event. |
| `kind` | `string` | No | What sort of music event this is (concert, festival...). |
| `locations` | `array` | Yes | Where the event takes place. |
| `mode` | `string` | No | The attendance mode, as a community.lexicon.calendar.event#mode token. |
| `musicCid` | `string` (cid) | No | CID of the music record revision that was indexed. |
| `musicUri` | `string` (at-uri) | Yes | AT-URI of the app.rocksky.event.music record. |
| `name` | `string` | Yes | The name of the event. |
| `organizerAvatarUrl` | `string` (uri) | No | The avatar of the publisher. |
| `organizerDid` | `string` (did) | Yes | The DID of the repo that published the event. |
| `organizerHandle` | `string` | No | The handle of the publisher. |
| `organizerName` | `string` | No | The display name of the publisher. |
| `rsvpCounts` | `ref` → `app.rocksky.event.defs#rsvpCounts` | Yes |  |
| `startsAt` | `string` (datetime) | No | When the event starts. |
| `status` | `string` | No | The event status, as a community.lexicon.calendar.event#status token. |
| `tags` | `array` | No |  |
| `ticketsUrl` | `string` (uri) | No | Where tickets can be bought. |
| `updatedAt` | `string` (datetime) | Yes | When the event was last indexed. |
| `uri` | `string` (at-uri) | Yes | AT-URI of the community.lexicon.calendar.event record. |
| `uris` | `array` | Yes | Links associated with the event. |
| `viewerRsvp` | `string` | No | The authenticated viewer's RSVP, as a community.lexicon.calendar.rsvp status token. Absent when not authenticated or when the viewer has not responded. |

### `app.rocksky.event.defs#locationView`

**Type**: `object`

One entry of the calendar event's locations, flattened: `type` says which community.lexicon.location shape it came from, and only the fields of that shape are set.

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `altitude` | `string` | No |  |
| `country` | `string` | No | ISO 3166 country code. |
| `fsqPlaceId` | `string` | No | Foursquare Open Source Places id. |
| `h3` | `string` | No | H3 encoded location. |
| `latitude` | `string` | No |  |
| `locality` | `string` | No | City or town. |
| `longitude` | `string` | No |  |
| `name` | `string` | No | The name of the location (venue name). |
| `postalCode` | `string` | No |  |
| `region` | `string` | No |  |
| `street` | `string` | No |  |
| `type` | `string` | Yes |  |
| `uri` | `string` (uri) | No | A URL standing in for the location (online events). |

### `app.rocksky.event.defs#rsvpCounts`

**Type**: `object`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `going` | `integer` | Yes |  |
| `interested` | `integer` | Yes |  |
| `notGoing` | `integer` | Yes |  |

### `app.rocksky.event.defs#rsvpView`

**Type**: `object`

A community.lexicon.calendar.rsvp on an event, with its author.

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `avatar` | `string` (uri) | No |  |
| `cid` | `string` (cid) | No |  |
| `createdAt` | `string` (datetime) | Yes |  |
| `did` | `string` (did) | Yes |  |
| `displayName` | `string` | Yes |  |
| `handle` | `string` | Yes |  |
| `status` | `string` | Yes |  |
| `uri` | `string` (at-uri) | Yes | AT-URI of the rsvp record. |

### `app.rocksky.event.defs#uriView`

**Type**: `object`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `name` | `string` | No | The display name of the URI. |
| `uri` | `string` (uri) | Yes |  |

## Raw Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "artistView": {
      "description": "An artist on an event lineup, linked to the Rocksky artist when one was resolved.",
      "properties": {
        "id": {
          "description": "The unique identifier of the linked Rocksky artist.",
          "type": "string"
        },
        "mbid": {
          "description": "MusicBrainz artist id.",
          "type": "string"
        },
        "name": {
          "description": "The artist name as billed on the event.",
          "type": "string"
        },
        "picture": {
          "description": "The picture of the linked artist.",
          "type": "string"
        },
        "role": {
          "description": "The artist's billing on this event.",
          "knownValues": [
            "headliner",
            "support",
            "opener",
            "dj",
            "special-guest",
            "performer"
          ],
          "type": "string"
        },
        "sha256": {
          "description": "The SHA256 hash of the linked artist.",
          "type": "string"
        },
        "stage": {
          "description": "The stage the artist plays on.",
          "type": "string"
        },
        "startsAt": {
          "description": "When this artist's set starts.",
          "format": "datetime",
          "type": "string"
        },
        "uri": {
          "description": "AT-URI of the linked artist.",
          "format": "at-uri",
          "type": "string"
        }
      },
      "required": [
        "name"
      ],
      "type": "object"
    },
    "eventView": {
      "description": "A music event: the calendar event merged with its app.rocksky.event.music annotation.",
      "properties": {
        "artists": {
          "description": "The lineup, in billing order.",
          "items": {
            "ref": "app.rocksky.event.defs#artistView",
            "type": "ref"
          },
          "type": "array"
        },
        "cid": {
          "description": "CID of the calendar event record revision that was indexed.",
          "format": "cid",
          "type": "string"
        },
        "createdAt": {
          "description": "When the event record was created.",
          "format": "datetime",
          "type": "string"
        },
        "description": {
          "description": "The description of the event.",
          "type": "string"
        },
        "endsAt": {
          "description": "When the event ends.",
          "format": "datetime",
          "type": "string"
        },
        "externalIds": {
          "ref": "app.rocksky.event.music#externalIds",
          "type": "ref"
        },
        "genre": {
          "description": "The main genre of the event.",
          "type": "string"
        },
        "id": {
          "description": "The unique identifier of the event.",
          "type": "string"
        },
        "imageUrl": {
          "description": "Poster or banner image of the event.",
          "format": "uri",
          "type": "string"
        },
        "kind": {
          "description": "What sort of music event this is (concert, festival...).",
          "knownValues": [
            "concert",
            "festival",
            "club-night",
            "dj-set",
            "livestream",
            "release-party",
            "listening-party"
          ],
          "type": "string"
        },
        "locations": {
          "description": "Where the event takes place.",
          "items": {
            "ref": "app.rocksky.event.defs#locationView",
            "type": "ref"
          },
          "type": "array"
        },
        "mode": {
          "description": "The attendance mode, as a community.lexicon.calendar.event#mode token.",
          "knownValues": [
            "community.lexicon.calendar.event#inperson",
            "community.lexicon.calendar.event#virtual",
            "community.lexicon.calendar.event#hybrid"
          ],
          "type": "string"
        },
        "musicCid": {
          "description": "CID of the music record revision that was indexed.",
          "format": "cid",
          "type": "string"
        },
        "musicUri": {
          "description": "AT-URI of the app.rocksky.event.music record.",
          "format": "at-uri",
          "type": "string"
        },
        "name": {
          "description": "The name of the event.",
          "type": "string"
        },
        "organizerAvatarUrl": {
          "description": "The avatar of the publisher.",
          "format": "uri",
          "type": "string"
        },
        "organizerDid": {
          "description": "The DID of the repo that published the event.",
          "format": "did",
          "type": "string"
        },
        "organizerHandle": {
          "description": "The handle of the publisher.",
          "type": "string"
        },
        "organizerName": {
          "description": "The display name of the publisher.",
          "type": "string"
        },
        "rsvpCounts": {
          "ref": "app.rocksky.event.defs#rsvpCounts",
          "type": "ref"
        },
        "startsAt": {
          "description": "When the event starts.",
          "format": "datetime",
          "type": "string"
        },
        "status": {
          "description": "The event status, as a community.lexicon.calendar.event#status token.",
          "knownValues": [
            "community.lexicon.calendar.event#planned",
            "community.lexicon.calendar.event#scheduled",
            "community.lexicon.calendar.event#rescheduled",
            "community.lexicon.calendar.event#cancelled",
            "community.lexicon.calendar.event#postponed"
          ],
          "type": "string"
        },
        "tags": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "ticketsUrl": {
          "description": "Where tickets can be bought.",
          "format": "uri",
          "type": "string"
        },
        "updatedAt": {
          "description": "When the event was last indexed.",
          "format": "datetime",
          "type": "string"
        },
        "uri": {
          "description": "AT-URI of the community.lexicon.calendar.event record.",
          "format": "at-uri",
          "type": "string"
        },
        "uris": {
          "description": "Links associated with the event.",
          "items": {
            "ref": "app.rocksky.event.defs#uriView",
            "type": "ref"
          },
          "type": "array"
        },
        "viewerRsvp": {
          "description": "The authenticated viewer's RSVP, as a community.lexicon.calendar.rsvp status token. Absent when not authenticated or when the viewer has not responded.",
          "knownValues": [
            "community.lexicon.calendar.rsvp#going",
            "community.lexicon.calendar.rsvp#interested",
            "community.lexicon.calendar.rsvp#notgoing"
          ],
          "type": "string"
        }
      },
      "required": [
        "id",
        "uri",
        "musicUri",
        "name",
        "artists",
        "locations",
        "uris",
        "rsvpCounts",
        "organizerDid",
        "createdAt",
        "updatedAt"
      ],
      "type": "object"
    },
    "locationView": {
      "description": "One entry of the calendar event's locations, flattened: `type` says which community.lexicon.location shape it came from, and only the fields of that shape are set.",
      "properties": {
        "altitude": {
          "type": "string"
        },
        "country": {
          "description": "ISO 3166 country code.",
          "type": "string"
        },
        "fsqPlaceId": {
          "description": "Foursquare Open Source Places id.",
          "type": "string"
        },
        "h3": {
          "description": "H3 encoded location.",
          "type": "string"
        },
        "latitude": {
          "type": "string"
        },
        "locality": {
          "description": "City or town.",
          "type": "string"
        },
        "longitude": {
          "type": "string"
        },
        "name": {
          "description": "The name of the location (venue name).",
          "type": "string"
        },
        "postalCode": {
          "type": "string"
        },
        "region": {
          "type": "string"
        },
        "street": {
          "type": "string"
        },
        "type": {
          "knownValues": [
            "community.lexicon.location.address",
            "community.lexicon.location.geo",
            "community.lexicon.location.fsq",
            "community.lexicon.location.hthree",
            "community.lexicon.calendar.event#uri"
          ],
          "type": "string"
        },
        "uri": {
          "description": "A URL standing in for the location (online events).",
          "format": "uri",
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    },
    "rsvpCounts": {
      "properties": {
        "going": {
          "minimum": 0,
          "type": "integer"
        },
        "interested": {
          "minimum": 0,
          "type": "integer"
        },
        "notGoing": {
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "going",
        "interested",
        "notGoing"
      ],
      "type": "object"
    },
    "rsvpView": {
      "description": "A community.lexicon.calendar.rsvp on an event, with its author.",
      "properties": {
        "avatar": {
          "format": "uri",
          "type": "string"
        },
        "cid": {
          "format": "cid",
          "type": "string"
        },
        "createdAt": {
          "format": "datetime",
          "type": "string"
        },
        "did": {
          "format": "did",
          "type": "string"
        },
        "displayName": {
          "type": "string"
        },
        "handle": {
          "type": "string"
        },
        "status": {
          "knownValues": [
            "community.lexicon.calendar.rsvp#going",
            "community.lexicon.calendar.rsvp#interested",
            "community.lexicon.calendar.rsvp#notgoing"
          ],
          "type": "string"
        },
        "uri": {
          "description": "AT-URI of the rsvp record.",
          "format": "at-uri",
          "type": "string"
        }
      },
      "required": [
        "uri",
        "status",
        "did",
        "handle",
        "displayName",
        "createdAt"
      ],
      "type": "object"
    },
    "uriView": {
      "properties": {
        "name": {
          "description": "The display name of the URI.",
          "type": "string"
        },
        "uri": {
          "format": "uri",
          "type": "string"
        }
      },
      "required": [
        "uri"
      ],
      "type": "object"
    }
  },
  "id": "app.rocksky.event.defs",
  "lexicon": 1
}
```