social.dracome.catalog.submission.edition

{
  "$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
}