# social.respawn.feed.log

> Record of a play session for a game, optionally including a review. Interaction settings are controlled by a social.respawn.feed.gate record with the same rkey.

- Kind: record
- Record key: tid
- Authority: feed.respawn.social
- Lexicon: 1
- Published by [respawn.social](https://lexicon.garden/identity/did:plc:hiabolqnnpdnrb5grmdaaepg), the NSID's authority

## Links

- [Documentation](https://lexicon.garden/lexicon/did:plc:hiabolqnnpdnrb5grmdaaepg/social.respawn.feed.log)
- [Schema JSON](https://lexicon.garden/lexicon/did:plc:hiabolqnnpdnrb5grmdaaepg/social.respawn.feed.log/schema.json)
- [Analytics](https://lexicon.garden/lexicon/did:plc:hiabolqnnpdnrb5grmdaaepg/social.respawn.feed.log/analytics)

## Record (`social.respawn.feed.log`)

Type: record · key tid

### Properties

- `cover` (ref)
  - Reference: `social.respawn.defs#cover`
- `createdAt` (string · datetime, required)
- `datePlayed` (string · datetime)
- `dlc` (array): Expansions or DLC included in this session.
  - Constraints: maxLength: 20
  - `items` (string)
    - Constraints: maxLength: 1000, maxGraphemes: 100
- `edition` (string): Edition of the game this session was played on.
  - Constraints: maxLength: 1000, maxGraphemes: 100
- `finishedPlaying` (ref)
  - Reference: `social.respawn.defs#playState`
- `game` (ref, required)
  - Reference: `social.respawn.defs#gameRef`
- `liked` (boolean)
- `platform` (string)
  - Constraints: maxLength: 1000, maxGraphemes: 100
- `rating` (integer): Actor's rating, 1-10.
  - Constraints: minimum: 1, maximum: 10
- `review` (ref)
  - Reference: `#review`
- `startedPlaying` (boolean)

## #external (`social.respawn.feed.log#external`)

Type: object

Reference to an external document (e.g. standard.site) holding the full review.

### Properties

- `cid` (string · cid)
- `uri` (string · uri, required)

## #review (`social.respawn.feed.log#review`)

Type: object

A review attached to a log.

### Properties

- `containsSpoilers` (boolean): Whole-review spoiler flag. Clients hide the review text until revealed, unless the viewer has the game in their collection with a completed play state.
- `external` (ref)
  - Reference: `#external`
- `facets` (array)
  - `items` (ref)
    - Reference: `social.respawn.richtext.facet`
- `media` (array): References to Grain gallery records to display with the review.
  - Constraints: maxLength: 10
  - `items` (ref)
    - Reference: `com.atproto.repo.strongRef`
- `text` (string, required): Display text. Spans marked with a spoiler facet are scrambled here; naive clients can render this field safely.
  - Constraints: maxLength: 100000, maxGraphemes: 10000
- `textWithSpoilers` (string): Original text with spoiler spans unscrambled. Only present when the review contains spoiler facets.
  - Constraints: maxLength: 100000, maxGraphemes: 10000

## Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "external": {
      "description": "Reference to an external document (e.g. standard.site) holding the full review.",
      "properties": {
        "cid": {
          "format": "cid",
          "type": "string"
        },
        "uri": {
          "format": "uri",
          "type": "string"
        }
      },
      "required": [
        "uri"
      ],
      "type": "object"
    },
    "main": {
      "description": "Record of a play session for a game, optionally including a review. Interaction settings are controlled by a social.respawn.feed.gate record with the same rkey.",
      "key": "tid",
      "record": {
        "properties": {
          "cover": {
            "ref": "social.respawn.defs#cover",
            "type": "ref"
          },
          "createdAt": {
            "format": "datetime",
            "type": "string"
          },
          "datePlayed": {
            "format": "datetime",
            "type": "string"
          },
          "dlc": {
            "description": "Expansions or DLC included in this session.",
            "items": {
              "maxGraphemes": 100,
              "maxLength": 1000,
              "type": "string"
            },
            "maxLength": 20,
            "type": "array"
          },
          "edition": {
            "description": "Edition of the game this session was played on.",
            "maxGraphemes": 100,
            "maxLength": 1000,
            "type": "string"
          },
          "finishedPlaying": {
            "ref": "social.respawn.defs#playState",
            "type": "ref"
          },
          "game": {
            "ref": "social.respawn.defs#gameRef",
            "type": "ref"
          },
          "liked": {
            "type": "boolean"
          },
          "platform": {
            "maxGraphemes": 100,
            "maxLength": 1000,
            "type": "string"
          },
          "rating": {
            "description": "Actor's rating, 1-10.",
            "maximum": 10,
            "minimum": 1,
            "type": "integer"
          },
          "review": {
            "ref": "#review",
            "type": "ref"
          },
          "startedPlaying": {
            "type": "boolean"
          }
        },
        "required": [
          "game",
          "createdAt"
        ],
        "type": "object"
      },
      "type": "record"
    },
    "review": {
      "description": "A review attached to a log.",
      "properties": {
        "containsSpoilers": {
          "description": "Whole-review spoiler flag. Clients hide the review text until revealed, unless the viewer has the game in their collection with a completed play state.",
          "type": "boolean"
        },
        "external": {
          "ref": "#external",
          "type": "ref"
        },
        "facets": {
          "items": {
            "ref": "social.respawn.richtext.facet",
            "type": "ref"
          },
          "type": "array"
        },
        "media": {
          "description": "References to Grain gallery records to display with the review.",
          "items": {
            "ref": "com.atproto.repo.strongRef",
            "type": "ref"
          },
          "maxLength": 10,
          "type": "array"
        },
        "text": {
          "description": "Display text. Spans marked with a spoiler facet are scrambled here; naive clients can render this field safely.",
          "maxGraphemes": 10000,
          "maxLength": 100000,
          "type": "string"
        },
        "textWithSpoilers": {
          "description": "Original text with spoiler spans unscrambled. Only present when the review contains spoiler facets.",
          "maxGraphemes": 10000,
          "maxLength": 100000,
          "type": "string"
        }
      },
      "required": [
        "text"
      ],
      "type": "object"
    }
  },
  "id": "social.respawn.feed.log",
  "lexicon": 1
}
```