social.dracome.catalog.submission.edition

dracome.social

Documentation

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.

main 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.

Record Key tid Timestamp-based ID

Properties

coverUri string uri Optional

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 Required

ISO 8601 UTC timestamp with trailing Z when this record was created.

description string Optional

Optional free-text description specific to this edition, if different from the work's.

maxLength: 8192 bytes
durationSeconds integer Optional

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
editionFormat ref social.dracome.work.defs#editionFormat Optional

Optional physical or media format (paperback, hardcover, ebook, audiobook, board_book, spiral_bound, library_binding, pamphlet).

editionName string Optional

Optional label for a specific print or release (e.g., 'First Edition', 'Hardcover').

maxLength: 256 bytes
language string language Optional

Optional ISO 639-1 or BCP 47 language code for this edition.

pageCount integer Optional

Optional number of pages in this edition. Not populated when editionFormat is audiobook; see durationSeconds.

minimum: 1
publicationDate string Optional

Optional this edition's publication date, at whatever precision is known.

maxLength: 64 bytes
publisherName string Optional

Optional name of this edition's publisher.

maxLength: 512 bytes
seriesPosition string Optional

Optional position within the series (e.g., '3' or '3.5').

maxLength: 64 bytes
seriesTitle string Optional

Optional series this edition belongs to.

maxLength: 512 bytes
sourceUri string uri Optional

Optional URL to this edition's page on the submitter's own site.

subtitle string Optional

Optional this edition's own subtitle.

maxLength: 1024 bytes
title string Required

This edition's own title (usually matches the work's title, but may differ for a retitled or translated edition).

maxLength: 1024 bytes
updatedAt string datetime Optional

Optional ISO 8601 UTC timestamp with trailing Z when this record was last updated by republishing.

View raw schema 
{
  "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 object

A reference to the parent work-submission record.

Properties

cid string cid Optional

Optional content hash of the work record at time of reference; informational only.

uri string at-uri Required

AT-URI of the owning social.dracome.catalog.submission.work record.

View raw schema 
{
  "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"
}

Lexicon Garden

@