town.laugh.calendar.series

laugh.town

Documentation

A named, recurring show series at a venue (e.g. "Roast Battle" at The Comedy Store). A label that community.lexicon.calendar.event records point at via town.laugh.calendar.defs#eventExtras.series; NOT a recurrence rule (authored recurring events use eventExtras.recurrence and may additionally point at a series). Derived facts (cadence, upcoming count, next date, active/dormant) are deliberately NOT stored in the record; they are computed from the events that reference it. Series records are never deleted when a series goes dormant.

main record

A named, recurring show series at a venue (e.g. "Roast Battle" at The Comedy Store). A label that community.lexicon.calendar.event records point at via town.laugh.calendar.defs#eventExtras.series; NOT a recurrence rule (authored recurring events use eventExtras.recurrence and may additionally point at a series). Derived facts (cadence, upcoming count, next date, active/dormant) are deliberately NOT stored in the record; they are computed from the events that reference it. Series records are never deleted when a series goes dormant.

Record Key tid Timestamp-based ID

Properties

createdAt string datetime Required

Timestamp of when the series record was created

description string Optional

Optional description of the series

maxLength: 2048 bytes
languages array of string language Optional

BCP-47 languages of the series

name string Required

Display name of the series (mutable)

maxLength: 256 bytes
origin string Optional

Where this record came from; central-repo records only

Known values: scraped, native
slug string Required

Lowercase alphanumeric with single-hyphen separators. Frozen at creation; unique per venue. Together with venue it is the identity of the series.

maxLength: 64 bytes
venue string at-uri Required

AT-URI reference to the town.laugh.db.venue record the series runs at

View raw schema 
{
  "description": "A named, recurring show series at a venue (e.g. \"Roast Battle\" at The Comedy Store). A label that community.lexicon.calendar.event records point at via town.laugh.calendar.defs#eventExtras.series; NOT a recurrence rule (authored recurring events use eventExtras.recurrence and may additionally point at a series). Derived facts (cadence, upcoming count, next date, active/dormant) are deliberately NOT stored in the record; they are computed from the events that reference it. Series records are never deleted when a series goes dormant.",
  "key": "tid",
  "record": {
    "properties": {
      "createdAt": {
        "description": "Timestamp of when the series record was created",
        "format": "datetime",
        "type": "string"
      },
      "description": {
        "description": "Optional description of the series",
        "maxLength": 2048,
        "type": "string"
      },
      "languages": {
        "description": "BCP-47 languages of the series",
        "items": {
          "format": "language",
          "type": "string"
        },
        "type": "array"
      },
      "name": {
        "description": "Display name of the series (mutable)",
        "maxLength": 256,
        "type": "string"
      },
      "nameLocalized": {
        "description": "Name in other languages/scripts; name is the canonical fallback",
        "items": {
          "ref": "town.laugh.db.defs#localizedText",
          "type": "ref"
        },
        "type": "array"
      },
      "origin": {
        "description": "Where this record came from; central-repo records only",
        "knownValues": [
          "scraped",
          "native"
        ],
        "type": "string"
      },
      "slug": {
        "description": "Lowercase alphanumeric with single-hyphen separators. Frozen at creation; unique per venue. Together with venue it is the identity of the series.",
        "maxLength": 64,
        "type": "string"
      },
      "venue": {
        "description": "AT-URI reference to the town.laugh.db.venue record the series runs at",
        "format": "at-uri",
        "type": "string"
      }
    },
    "required": [
      "name",
      "slug",
      "venue",
      "createdAt"
    ],
    "type": "object"
  },
  "type": "record"
}

Lexicon Garden

@