Skip to main content

ReleaseLedgerEntryDto

A single release announcement. Sources write these; the inbox reads them.

chapters object[]

Full chapter coverage as a normalized span list. Decimals supported (c12.5 → [{start: 12.5, end: 12.5}]). null when the upstream title carried no chapter info.

  • Array [
    • endnumber<double>required
    Example: 9
    startnumber<double>required
    Example: 1
  • ]
    • confidencenumber<double>required
    createdAtstring<date-time>required
    externalReleaseIdstringrequired

    Plugin-stable identity for the release (used for dedup).

    Example: nyaa:1234567
    formatHints

    Sparse { "jxl": true, "container": "cbz", ... }.

    groupOrUploaderstring | nullnullable

    Group/scanlator/uploader attribution.

    idstring<uuid>required
    Example: 550e8400-e29b-41d4-a716-446655440a00
    infoHashstring | nullnullable

    Torrent info_hash, if applicable.

    languagestring | nullnullable
    mediaUrlstring | nullnullable

    Optional second URL for direct fetch (.torrent, magnet:, DDL link). Travels paired with [Self::media_url_kind].

    mediaUrlKindstring | nullnullable

    Classifies what media_url points at: torrent | magnet | direct | other. The frontend uses this to pick a kind-specific icon next to the standard external-link icon.

    metadata

    Source-specific extras (free-form).

    observedAtstring<date-time>required
    payloadUrlstringrequired

    Where to acquire the release. Conventionally a human-readable landing page (Nyaa view page, MangaUpdates release page).

    seriesIdstring<uuid>required
    Example: 550e8400-e29b-41d4-a716-446655440002
    seriesTitlestringrequired

    Series title at the time of the response. Joined from the series table so the inbox UI can render a human-readable label without a follow-up fetch. Falls back to the empty string only if the series row was hard-deleted between the join and the read.

    Example: Chainsaw Man
    sourceIdstring<uuid>required
    Example: 550e8400-e29b-41d4-a716-446655440b00
    statestringrequired

    announced | dismissed | marked_acquired | hidden.

    volumes object[]

    Full volume coverage as a normalized span list. null semantics mirror [Self::chapters].

  • Array [
    • endnumber<double>required
    Example: 9
    startnumber<double>required
    Example: 1
  • ]
    • ReleaseLedgerEntryDto
    {
      "chapters": "Unknown Type: array,null",
      "confidence": 0,
      "createdAt": "2024-07-29T15:51:28.071Z",
      "externalReleaseId": "nyaa:1234567",
      "groupOrUploader": "string",
      "id": "550e8400-e29b-41d4-a716-446655440a00",
      "infoHash": "string",
      "language": "string",
      "mediaUrl": "string",
      "mediaUrlKind": "string",
      "observedAt": "2024-07-29T15:51:28.071Z",
      "payloadUrl": "string",
      "seriesId": "550e8400-e29b-41d4-a716-446655440002",
      "seriesTitle": "Chainsaw Man",
      "sourceId": "550e8400-e29b-41d4-a716-446655440b00",
      "state": "string",
      "volumes": "Unknown Type: array,null"
    }