# social.dracome.catalog.submission.edition

> Published by [dracome.social](https://lexicon.garden/identity/did:plc:66dyrt2bmghwlmdteyizs5l3)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:66dyrt2bmghwlmdteyizs5l3/social.dracome.catalog.submission.edition)
- [Documentation](https://lexicon.garden/lexicon/did:plc:66dyrt2bmghwlmdteyizs5l3/social.dracome.catalog.submission.edition/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:66dyrt2bmghwlmdteyizs5l3/social.dracome.catalog.submission.edition/examples)

## Definitions

### `social.dracome.catalog.submission.edition`

**Type**: `record`

A submission record carrying candidate catalog data for an edition of a previously-submitted work, published by a trusted submitter to their own PDS. Repeatable; a submitter may create, update, or delete edition-submission records over time.

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `coverUri` | `string` (uri) | No | Optional URL to a cover image for this specific edition, hosted by the submitter. Runtime validation MUST restrict this to https:// URLs. |
| `createdAt` | `string` (datetime) | Yes | ISO 8601 UTC timestamp with trailing Z when this record was created. |
| `derivedFrom` | `ref` → `social.dracome.catalog.submission.work#derivedFromRef` | No | Optional reference to the record this submission's data was derived from. Carries no meaning to Dracome's ingestion; exists for downstream consumers to walk provenance. |
| `description` | `string` | No | Optional free-text description specific to this edition, if different from the work's. |
| `durationSeconds` | `integer` | No | Optional total duration in seconds for audiobook editions. Only populated when editionFormat is audiobook; pageCount and durationSeconds are never both set on the same edition. |
| `editionFormat` | `ref` → `social.dracome.work.defs#editionFormat` | No | Optional physical or media format (paperback, hardcover, ebook, audiobook, board_book, spiral_bound, library_binding, pamphlet). |
| `editionName` | `string` | No | Optional label for a specific print or release (e.g., 'First Edition', 'Hardcover'). |
| `identifiers` | `array` | No | Optional external identifiers (edition-specific ISBN, etc.), plus the submitter's proprietary identifier. |
| `language` | `string` (language) | No | Optional ISO 639-1 or BCP 47 language code for this edition. |
| `pageCount` | `integer` | No | Optional number of pages in this edition. Not populated when editionFormat is audiobook; see durationSeconds. |
| `publicationDate` | `string` | No | Optional this edition's publication date, at whatever precision is known. |
| `publisherName` | `string` | No | Optional name of this edition's publisher. |
| `seriesPosition` | `string` | No | Optional position within the series (e.g., '3' or '3.5'). |
| `seriesTitle` | `string` | No | Optional series this edition belongs to. |
| `sourceUri` | `string` (uri) | No | Optional URL to this edition's page on the submitter's own site. |
| `subtitle` | `string` | No | Optional this edition's own subtitle. |
| `title` | `string` | Yes | This edition's own title (usually matches the work's title, but may differ for a retitled or translated edition). |
| `updatedAt` | `string` (datetime) | No | Optional ISO 8601 UTC timestamp with trailing Z when this record was last updated by republishing. |
| `work` | `ref` → `#workSubmissionRef` | Yes | Reference to the parent work-submission record. |

### `social.dracome.catalog.submission.edition#workSubmissionRef`

**Type**: `object`

A reference to the parent work-submission record.

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `cid` | `string` (cid) | No | Optional content hash of the work record at time of reference; informational only. |
| `uri` | `string` (at-uri) | Yes | AT-URI of the owning social.dracome.catalog.submission.work record. |

## Raw Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "A submission record carrying candidate catalog data for an edition of a previously-submitted work, published by a trusted submitter to their own PDS. Repeatable; a submitter may create, update, or delete edition-submission records over time.",
      "key": "tid",
      "record": {
        "properties": {
          "coverUri": {
            "description": "Optional URL to a cover image for this specific edition, hosted by the submitter. Runtime validation MUST restrict this to https:// URLs.",
            "format": "uri",
            "type": "string"
          },
          "createdAt": {
            "description": "ISO 8601 UTC timestamp with trailing Z when this record was created.",
            "format": "datetime",
            "type": "string"
          },
          "derivedFrom": {
            "description": "Optional reference to the record this submission's data was derived from. Carries no meaning to Dracome's ingestion; exists for downstream consumers to walk provenance.",
            "ref": "social.dracome.catalog.submission.work#derivedFromRef",
            "type": "ref"
          },
          "description": {
            "description": "Optional free-text description specific to this edition, if different from the work's.",
            "maxLength": 8192,
            "type": "string"
          },
          "durationSeconds": {
            "description": "Optional total duration in seconds for audiobook editions. Only populated when editionFormat is audiobook; pageCount and durationSeconds are never both set on the same edition.",
            "minimum": 0,
            "type": "integer"
          },
          "editionFormat": {
            "description": "Optional physical or media format (paperback, hardcover, ebook, audiobook, board_book, spiral_bound, library_binding, pamphlet).",
            "ref": "social.dracome.work.defs#editionFormat",
            "type": "ref"
          },
          "editionName": {
            "description": "Optional label for a specific print or release (e.g., 'First Edition', 'Hardcover').",
            "maxLength": 256,
            "type": "string"
          },
          "identifiers": {
            "description": "Optional external identifiers (edition-specific ISBN, etc.), plus the submitter's proprietary identifier.",
            "items": {
              "ref": "social.dracome.work.defs#catalogIdentifier",
              "type": "ref"
            },
            "maxLength": 16,
            "type": "array"
          },
          "language": {
            "description": "Optional ISO 639-1 or BCP 47 language code for this edition.",
            "format": "language",
            "type": "string"
          },
          "pageCount": {
            "description": "Optional number of pages in this edition. Not populated when editionFormat is audiobook; see durationSeconds.",
            "minimum": 1,
            "type": "integer"
          },
          "publicationDate": {
            "description": "Optional this edition's publication date, at whatever precision is known.",
            "maxLength": 64,
            "type": "string"
          },
          "publisherName": {
            "description": "Optional name of this edition's publisher.",
            "maxLength": 512,
            "type": "string"
          },
          "seriesPosition": {
            "description": "Optional position within the series (e.g., '3' or '3.5').",
            "maxLength": 64,
            "type": "string"
          },
          "seriesTitle": {
            "description": "Optional series this edition belongs to.",
            "maxLength": 512,
            "type": "string"
          },
          "sourceUri": {
            "description": "Optional URL to this edition's page on the submitter's own site.",
            "format": "uri",
            "type": "string"
          },
          "subtitle": {
            "description": "Optional this edition's own subtitle.",
            "maxLength": 1024,
            "type": "string"
          },
          "title": {
            "description": "This edition's own title (usually matches the work's title, but may differ for a retitled or translated edition).",
            "maxLength": 1024,
            "type": "string"
          },
          "updatedAt": {
            "description": "Optional ISO 8601 UTC timestamp with trailing Z when this record was last updated by republishing.",
            "format": "datetime",
            "type": "string"
          },
          "work": {
            "description": "Reference to the parent work-submission record.",
            "ref": "#workSubmissionRef",
            "type": "ref"
          }
        },
        "required": [
          "work",
          "title",
          "createdAt"
        ],
        "type": "object"
      },
      "type": "record"
    },
    "workSubmissionRef": {
      "description": "A reference to the parent work-submission record.",
      "properties": {
        "cid": {
          "description": "Optional content hash of the work record at time of reference; informational only.",
          "format": "cid",
          "type": "string"
        },
        "uri": {
          "description": "AT-URI of the owning social.dracome.catalog.submission.work record.",
          "format": "at-uri",
          "type": "string"
        }
      },
      "required": [
        "uri"
      ],
      "type": "object"
    }
  },
  "id": "social.dracome.catalog.submission.edition",
  "lexicon": 1
}
```