BusComandos (cmd)

cmd.media.pollIngestEvents

Confirma todo evento con `seq <= ackSeq` y devuelve los más antiguos sin confirmar (como mucho `MAX_INGEST_EVENTS_PER_POLL`).

ImplementadoSin versión del tren todavía· generada desde packages/api-contracts/src/bus/media-daemon.ts

Página generada desde packages/api-contracts/src/bus/media-daemon.ts + packages/api-contracts/src/bus/routes.ts. No se edita a mano: bun run docs:gen la regenera y bun run docs:check falla si difiere.

cmd.media.pollIngestEvents · v2

Confirma todo evento con seq <= ackSeq y devuelve los más antiguos sin confirmar (como mucho MAX_INGEST_EVENTS_PER_POLL).

CampoValor
Familiacmd
Versión2
Tope del payload32768 bytes
ContratoMediaPollIngestEvents en packages/api-contracts/src/bus/media-daemon.ts

Rutas (BUS_ROUTES)

Deny-by-default: un emisor fuera de la allowlist se deniega y se audita (dec-0119 §4).

AtiendeTransporteEmisores admitidosRate (por emisor)
media-daemonunixplayback-svc, styx-ops100/s, ráfaga 100

Petición

{
  "type": "object",
  "required": [
    "ackSeq"
  ],
  "properties": {
    "ackSeq": {
      "type": "integer",
      "minimum": 0
    }
  },
  "additionalProperties": false
}

Respuesta

{
  "type": "object",
  "properties": {
    "events": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "seq",
          "sessionId",
          "actorDigest",
          "uploadId",
          "sizeBytes",
          "blake3",
          "rootId",
          "key",
          "filename"
        ],
        "properties": {
          "seq": {
            "type": "integer",
            "minimum": 1
          },
          "sessionId": {
            "type": "string",
            "pattern": "^[a-z0-9_]{36}$"
          },
          "actorDigest": {
            "type": "string",
            "pattern": "^[0-9a-f]{32}$"
          },
          "uploadId": {
            "type": "string",
            "pattern": "^[0-9a-f]{32}$"
          },
          "sizeBytes": {
            "type": "integer",
            "minimum": 0
          },
          "blake3": {
            "type": "string",
            "pattern": "^[0-9a-f]{64}$"
          },
          "rootId": {
            "type": "string",
            "pattern": "^[A-Za-z0-9._-]{1,64}$"
          },
          "key": {
            "type": "string",
            "pattern": "^[0-9a-f]{64}$"
          },
          "filename": {
            "type": "string",
            "minLength": 1,
            "maxLength": 255
          }
        },
        "additionalProperties": false
      },
      "maxItems": 32
    },
    "error": {
      "type": "object",
      "required": [
        "code",
        "message",
        "recoverable"
      ],
      "properties": {
        "code": {
          "type": "string",
          "pattern": "^[A-Z0-9_]{1,48}$"
        },
        "message": {
          "type": "string",
          "maxLength": 256
        },
        "recoverable": {
          "type": "boolean"
        }
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}