recordDocumentLinkDownload

Record a document link download

Public/unauthenticated — called from the public download route the moment a valid link is redeemed (a token/file is served). Atomically increments the download counter (awaited; failures surface as GraphQL errors) and returns the link so the caller can serve the file in one round trip. A read of tokennever counts.

mutation {
  recordDocumentLinkDownload(documentLinkId: String!): DocumentLink!
}