# computer.localnetwork.defs

> Shared definitions for Local Network, where promoters find local DJ projects.

- Kind: defs
- Authority: localnetwork.computer
- Lexicon: 1
- Published by [localnetwork.computer](https://lexicon.garden/identity/did:plc:d42l64gsczg6qh2vo243xv5l), not the NSID's authority

## Links

- [Documentation](https://lexicon.garden/lexicon/did:plc:d42l64gsczg6qh2vo243xv5l/computer.localnetwork.defs)
- [Schema JSON](https://lexicon.garden/lexicon/did:plc:d42l64gsczg6qh2vo243xv5l/computer.localnetwork.defs/schema.json)
- [Analytics](https://lexicon.garden/lexicon/did:plc:d42l64gsczg6qh2vo243xv5l/computer.localnetwork.defs/analytics)

## #capacity (`computer.localnetwork.defs#capacity`)

Type: object

Typical audience sizes the project plays to.

### Properties

- `max` (integer)
  - Constraints: minimum: 0, maximum: 1000000
- `min` (integer)
  - Constraints: minimum: 0, maximum: 1000000

## #fee (`computer.localnetwork.defs#fee`)

Type: object

One fee level: a tier, and optionally what it covers and an amount range.

### Properties

- `currency` (string)
  - Constraints: minLength: 3, maxLength: 3
- `label` (string): What this level covers, like club nights, festivals, or private events.
  - Constraints: maxLength: 640, maxGraphemes: 64
- `maxAmount` (integer): Whole currency units.
  - Constraints: minimum: 0
- `minAmount` (integer): Whole currency units.
  - Constraints: minimum: 0
- `tier` (string, required)
  - Constraints: maxLength: 32, knownValues: community | emerging | established | headliner

## #link (`computer.localnetwork.defs#link`)

Type: object

### Properties

- `kind` (string, required)
  - Constraints: maxLength: 32, knownValues: website | soundcloud | mixcloud | bandcamp | instagram | bluesky | residentAdvisor | youtube | spotify | twitch | other
- `label` (string)
  - Constraints: maxLength: 640, maxGraphemes: 64
- `url` (string · uri, required)
  - Constraints: maxLength: 2048

## #location (`computer.localnetwork.defs#location`)

Type: object

### Properties

- `city` (string, required)
  - Constraints: minLength: 1, maxLength: 1000, maxGraphemes: 100
- `country` (string, required): ISO 3166-1 alpha-2 country code.
  - Constraints: minLength: 2, maxLength: 2
- `latE6` (integer): Latitude in millionths of a degree (the atproto data model has no floats).
  - Constraints: minimum: -90000000, maximum: 90000000
- `lngE6` (integer): Longitude in millionths of a degree.
  - Constraints: minimum: -180000000, maximum: 180000000
- `region` (string)
  - Constraints: maxLength: 1000, maxGraphemes: 100

## #mix (`computer.localnetwork.defs#mix`)

Type: object

### Properties

- `durationMinutes` (integer)
  - Constraints: minimum: 1, maximum: 1440
- `recording` (ref): The record where the mix can be played: an fm.plyr.track in a manager's own repo, for a mix whose url is that track on plyr.fm. Players play it where they can, and url stays the mix's link.
  - Reference: `com.atproto.repo.strongRef`
- `set` (ref): The set this mix is a recording of: a computer.localnetwork.dj.set record in a manager's own repo (locallibrary publishes them). The CID pins the version that was linked; the set can change after.
  - Reference: `com.atproto.repo.strongRef`
- `title` (string, required)
  - Constraints: minLength: 1, maxLength: 1200, maxGraphemes: 120
- `tracklist` (blob): A mix report exported by locallibrary (format locallibrary.mix-report, version 1 or 2): which tracks the mix plays, when, at what tempo and key, and how they were mixed. Validated before it is published or shown.
  - Constraints: maxSize: 1000000, accept: application/json
- `url` (string · uri, required)
  - Constraints: maxLength: 2048
- `year` (integer)
  - Constraints: minimum: 1950, maximum: 2100

## #money (`computer.localnetwork.defs#money`)

Type: object

### Properties

- `amount` (integer, required): Whole currency units.
  - Constraints: minimum: 0
- `currency` (string, required)
  - Constraints: minLength: 3, maxLength: 3

## #projectDetails (`computer.localnetwork.defs#projectDetails`)

Type: object

Private booking details, kept in the industry space. The app shows them to the project's managers and to people granted one of its press kits.

### Properties

- `bookingEmail` (string)
  - Constraints: maxLength: 320
- `bookingPhone` (string)
  - Constraints: maxLength: 64
- `hospitality` (string)
  - Constraints: maxLength: 10000, maxGraphemes: 1000
- `rateNotes` (string)
  - Constraints: maxLength: 10000, maxGraphemes: 1000
- `techRider` (string)
  - Constraints: maxLength: 20000, maxGraphemes: 2000

## #projectProfile (`computer.localnetwork.defs#projectProfile`)

Type: object

The public, promoter-facing profile of a DJ project (a solo DJ, duo, group, or collective).

### Properties

- `activeSince` (integer): Year the project started playing out.
  - Constraints: minimum: 1950, maximum: 2100
- `avatar` (blob)
  - Constraints: maxSize: 1000000, accept: image/png, image/jpeg, image/webp
- `bio` (string)
  - Constraints: maxLength: 30000, maxGraphemes: 3000
- `capacity` (ref)
  - Reference: `#capacity`
- `fee` (ref): Deprecated: use fees. Records written before fees existed carry their one fee level here.
  - Reference: `#fee`
- `fees` (array): The project's fee levels, like one per kind of booking. Each tier counts for budget matching.
  - `items` (ref)
    - Reference: `#fee`
- `formats` (array)
  - Constraints: maxLength: 8
  - `items` (string)
    - Constraints: maxLength: 32, knownValues: vinyl | cdj | controller | hybrid | live | modular
- `genres` (array, required)
  - Constraints: minLength: 1, maxLength: 12
  - `items` (string)
    - Constraints: minLength: 1, maxLength: 48
- `highlights` (array): Notable venues, events, residencies, or releases.
  - Constraints: maxLength: 12
  - `items` (string)
    - Constraints: maxLength: 1200, maxGraphemes: 120
- `kind` (string, required)
  - Constraints: maxLength: 32, knownValues: solo | duo | group | collective | live
- `links` (array)
  - Constraints: maxLength: 12
  - `items` (ref)
    - Reference: `#link`
- `location` (ref, required)
  - Reference: `#location`
- `lookingFor` (string): The kinds of bookings the project wants.
  - Constraints: maxLength: 5000, maxGraphemes: 500
- `mixes` (array)
  - Constraints: maxLength: 12
  - `items` (ref)
    - Reference: `#mix`
- `name` (string, required)
  - Constraints: minLength: 1, maxLength: 640, maxGraphemes: 64
- `pronouns` (string)
  - Constraints: maxLength: 200, maxGraphemes: 24
- `setLength` (ref)
  - Reference: `#setLength`
- `setTypes` (array)
  - Constraints: maxLength: 10
  - `items` (string)
    - Constraints: maxLength: 32, knownValues: opener | warmup | peak | closing | allNight | b2b | daytime | afterhours | liveSet
- `tagline` (string)
  - Constraints: maxLength: 1400, maxGraphemes: 140
- `travel` (ref)
  - Reference: `#travel`

## #setLength (`computer.localnetwork.defs#setLength`)

Type: object

### Properties

- `maxMinutes` (integer)
  - Constraints: minimum: 15, maximum: 720
- `minMinutes` (integer)
  - Constraints: minimum: 15, maximum: 720

## #showDetails (`computer.localnetwork.defs#showDetails`)

Type: object

A show a promoter is planning or booking for.

### Properties

- `budget` (ref)
  - Reference: `#money`
- `budgetTier` (string)
  - Constraints: maxLength: 32, knownValues: community | emerging | established | headliner
- `capacity` (integer)
  - Constraints: minimum: 0, maximum: 1000000
- `date` (string · datetime)
- `genres` (array)
  - Constraints: maxLength: 12
  - `items` (string)
    - Constraints: maxLength: 48
- `location` (ref)
  - Reference: `#location`
- `notes` (string)
  - Constraints: maxLength: 20000, maxGraphemes: 2000
- `setMinutes` (integer)
  - Constraints: minimum: 15, maximum: 720
- `setType` (string)
  - Constraints: maxLength: 32
- `title` (string, required)
  - Constraints: minLength: 1, maxLength: 1200, maxGraphemes: 120
- `venue` (string)
  - Constraints: maxLength: 1200, maxGraphemes: 120

## #travel (`computer.localnetwork.defs#travel`)

Type: object

### Properties

- `international` (boolean)
- `notes` (string)
  - Constraints: maxLength: 3000, maxGraphemes: 300
- `radiusKm` (integer)
  - Constraints: minimum: 0, maximum: 20000

## Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "capacity": {
      "description": "Typical audience sizes the project plays to.",
      "properties": {
        "max": {
          "maximum": 1000000,
          "minimum": 0,
          "type": "integer"
        },
        "min": {
          "maximum": 1000000,
          "minimum": 0,
          "type": "integer"
        }
      },
      "type": "object"
    },
    "fee": {
      "description": "One fee level: a tier, and optionally what it covers and an amount range.",
      "properties": {
        "currency": {
          "maxLength": 3,
          "minLength": 3,
          "type": "string"
        },
        "label": {
          "description": "What this level covers, like club nights, festivals, or private events.",
          "maxGraphemes": 64,
          "maxLength": 640,
          "type": "string"
        },
        "maxAmount": {
          "description": "Whole currency units.",
          "minimum": 0,
          "type": "integer"
        },
        "minAmount": {
          "description": "Whole currency units.",
          "minimum": 0,
          "type": "integer"
        },
        "tier": {
          "knownValues": [
            "community",
            "emerging",
            "established",
            "headliner"
          ],
          "maxLength": 32,
          "type": "string"
        }
      },
      "required": [
        "tier"
      ],
      "type": "object"
    },
    "link": {
      "properties": {
        "kind": {
          "knownValues": [
            "website",
            "soundcloud",
            "mixcloud",
            "bandcamp",
            "instagram",
            "bluesky",
            "residentAdvisor",
            "youtube",
            "spotify",
            "twitch",
            "other"
          ],
          "maxLength": 32,
          "type": "string"
        },
        "label": {
          "maxGraphemes": 64,
          "maxLength": 640,
          "type": "string"
        },
        "url": {
          "format": "uri",
          "maxLength": 2048,
          "type": "string"
        }
      },
      "required": [
        "kind",
        "url"
      ],
      "type": "object"
    },
    "location": {
      "properties": {
        "city": {
          "maxGraphemes": 100,
          "maxLength": 1000,
          "minLength": 1,
          "type": "string"
        },
        "country": {
          "description": "ISO 3166-1 alpha-2 country code.",
          "maxLength": 2,
          "minLength": 2,
          "type": "string"
        },
        "latE6": {
          "description": "Latitude in millionths of a degree (the atproto data model has no floats).",
          "maximum": 90000000,
          "minimum": -90000000,
          "type": "integer"
        },
        "lngE6": {
          "description": "Longitude in millionths of a degree.",
          "maximum": 180000000,
          "minimum": -180000000,
          "type": "integer"
        },
        "region": {
          "maxGraphemes": 100,
          "maxLength": 1000,
          "type": "string"
        }
      },
      "required": [
        "city",
        "country"
      ],
      "type": "object"
    },
    "mix": {
      "properties": {
        "durationMinutes": {
          "maximum": 1440,
          "minimum": 1,
          "type": "integer"
        },
        "recording": {
          "description": "The record where the mix can be played: an fm.plyr.track in a manager's own repo, for a mix whose url is that track on plyr.fm. Players play it where they can, and url stays the mix's link.",
          "ref": "com.atproto.repo.strongRef",
          "type": "ref"
        },
        "set": {
          "description": "The set this mix is a recording of: a computer.localnetwork.dj.set record in a manager's own repo (locallibrary publishes them). The CID pins the version that was linked; the set can change after.",
          "ref": "com.atproto.repo.strongRef",
          "type": "ref"
        },
        "title": {
          "maxGraphemes": 120,
          "maxLength": 1200,
          "minLength": 1,
          "type": "string"
        },
        "tracklist": {
          "accept": [
            "application/json"
          ],
          "description": "A mix report exported by locallibrary (format locallibrary.mix-report, version 1 or 2): which tracks the mix plays, when, at what tempo and key, and how they were mixed. Validated before it is published or shown.",
          "maxSize": 1000000,
          "type": "blob"
        },
        "url": {
          "format": "uri",
          "maxLength": 2048,
          "type": "string"
        },
        "year": {
          "maximum": 2100,
          "minimum": 1950,
          "type": "integer"
        }
      },
      "required": [
        "title",
        "url"
      ],
      "type": "object"
    },
    "money": {
      "properties": {
        "amount": {
          "description": "Whole currency units.",
          "minimum": 0,
          "type": "integer"
        },
        "currency": {
          "maxLength": 3,
          "minLength": 3,
          "type": "string"
        }
      },
      "required": [
        "amount",
        "currency"
      ],
      "type": "object"
    },
    "projectDetails": {
      "description": "Private booking details, kept in the industry space. The app shows them to the project's managers and to people granted one of its press kits.",
      "properties": {
        "bookingEmail": {
          "maxLength": 320,
          "type": "string"
        },
        "bookingPhone": {
          "maxLength": 64,
          "type": "string"
        },
        "hospitality": {
          "maxGraphemes": 1000,
          "maxLength": 10000,
          "type": "string"
        },
        "rateNotes": {
          "maxGraphemes": 1000,
          "maxLength": 10000,
          "type": "string"
        },
        "techRider": {
          "maxGraphemes": 2000,
          "maxLength": 20000,
          "type": "string"
        }
      },
      "type": "object"
    },
    "projectProfile": {
      "description": "The public, promoter-facing profile of a DJ project (a solo DJ, duo, group, or collective).",
      "properties": {
        "activeSince": {
          "description": "Year the project started playing out.",
          "maximum": 2100,
          "minimum": 1950,
          "type": "integer"
        },
        "avatar": {
          "accept": [
            "image/png",
            "image/jpeg",
            "image/webp"
          ],
          "maxSize": 1000000,
          "type": "blob"
        },
        "bio": {
          "maxGraphemes": 3000,
          "maxLength": 30000,
          "type": "string"
        },
        "capacity": {
          "ref": "#capacity",
          "type": "ref"
        },
        "fee": {
          "description": "Deprecated: use fees. Records written before fees existed carry their one fee level here.",
          "ref": "#fee",
          "type": "ref"
        },
        "fees": {
          "description": "The project's fee levels, like one per kind of booking. Each tier counts for budget matching.",
          "items": {
            "ref": "#fee",
            "type": "ref"
          },
          "type": "array"
        },
        "formats": {
          "items": {
            "knownValues": [
              "vinyl",
              "cdj",
              "controller",
              "hybrid",
              "live",
              "modular"
            ],
            "maxLength": 32,
            "type": "string"
          },
          "maxLength": 8,
          "type": "array"
        },
        "genres": {
          "items": {
            "maxLength": 48,
            "minLength": 1,
            "type": "string"
          },
          "maxLength": 12,
          "minLength": 1,
          "type": "array"
        },
        "highlights": {
          "description": "Notable venues, events, residencies, or releases.",
          "items": {
            "maxGraphemes": 120,
            "maxLength": 1200,
            "type": "string"
          },
          "maxLength": 12,
          "type": "array"
        },
        "kind": {
          "knownValues": [
            "solo",
            "duo",
            "group",
            "collective",
            "live"
          ],
          "maxLength": 32,
          "type": "string"
        },
        "links": {
          "items": {
            "ref": "#link",
            "type": "ref"
          },
          "maxLength": 12,
          "type": "array"
        },
        "location": {
          "ref": "#location",
          "type": "ref"
        },
        "lookingFor": {
          "description": "The kinds of bookings the project wants.",
          "maxGraphemes": 500,
          "maxLength": 5000,
          "type": "string"
        },
        "mixes": {
          "items": {
            "ref": "#mix",
            "type": "ref"
          },
          "maxLength": 12,
          "type": "array"
        },
        "name": {
          "maxGraphemes": 64,
          "maxLength": 640,
          "minLength": 1,
          "type": "string"
        },
        "pronouns": {
          "maxGraphemes": 24,
          "maxLength": 200,
          "type": "string"
        },
        "setLength": {
          "ref": "#setLength",
          "type": "ref"
        },
        "setTypes": {
          "items": {
            "knownValues": [
              "opener",
              "warmup",
              "peak",
              "closing",
              "allNight",
              "b2b",
              "daytime",
              "afterhours",
              "liveSet"
            ],
            "maxLength": 32,
            "type": "string"
          },
          "maxLength": 10,
          "type": "array"
        },
        "tagline": {
          "maxGraphemes": 140,
          "maxLength": 1400,
          "type": "string"
        },
        "travel": {
          "ref": "#travel",
          "type": "ref"
        }
      },
      "required": [
        "name",
        "kind",
        "genres",
        "location"
      ],
      "type": "object"
    },
    "setLength": {
      "properties": {
        "maxMinutes": {
          "maximum": 720,
          "minimum": 15,
          "type": "integer"
        },
        "minMinutes": {
          "maximum": 720,
          "minimum": 15,
          "type": "integer"
        }
      },
      "type": "object"
    },
    "showDetails": {
      "description": "A show a promoter is planning or booking for.",
      "properties": {
        "budget": {
          "ref": "#money",
          "type": "ref"
        },
        "budgetTier": {
          "knownValues": [
            "community",
            "emerging",
            "established",
            "headliner"
          ],
          "maxLength": 32,
          "type": "string"
        },
        "capacity": {
          "maximum": 1000000,
          "minimum": 0,
          "type": "integer"
        },
        "date": {
          "format": "datetime",
          "type": "string"
        },
        "genres": {
          "items": {
            "maxLength": 48,
            "type": "string"
          },
          "maxLength": 12,
          "type": "array"
        },
        "location": {
          "ref": "#location",
          "type": "ref"
        },
        "notes": {
          "maxGraphemes": 2000,
          "maxLength": 20000,
          "type": "string"
        },
        "setMinutes": {
          "maximum": 720,
          "minimum": 15,
          "type": "integer"
        },
        "setType": {
          "maxLength": 32,
          "type": "string"
        },
        "title": {
          "maxGraphemes": 120,
          "maxLength": 1200,
          "minLength": 1,
          "type": "string"
        },
        "venue": {
          "maxGraphemes": 120,
          "maxLength": 1200,
          "type": "string"
        }
      },
      "required": [
        "title"
      ],
      "type": "object"
    },
    "travel": {
      "properties": {
        "international": {
          "type": "boolean"
        },
        "notes": {
          "maxGraphemes": 300,
          "maxLength": 3000,
          "type": "string"
        },
        "radiusKm": {
          "maximum": 20000,
          "minimum": 0,
          "type": "integer"
        }
      },
      "type": "object"
    }
  },
  "description": "Shared definitions for Local Network, where promoters find local DJ projects.",
  "id": "computer.localnetwork.defs",
  "lexicon": 1
}
```
