Especificación de Servicios gRPC (Protobuf)

message CreateResourceRequest {
  // Plantilla (define TTL, idempotencia y estrategia de conflicto)
  string template_name = 1;
  // Identificador único del recurso (ej: "seat_J4", "curso_react_2026")
  string key = 2;
  // Cantidad inicial (1 para Unitarios, N para Pooled)
  int32 available_amount = 3;
  // Clave de agrupación opcional (ej: "fila_J", "sala_1")
  optional string group_key = 4;
  // Metadata arbitraria en formato JSON string
  optional string metadata = 5;
}

message UpdateResourceRequest {
  // Clave del recurso a modificar
  string resource_key = 1;
  // Incremento (+) o decremento (-) de inventario
  int32 delta_amount = 2;
  // Actualiza el grupo si se proporciona
  optional string group_key = 3;
  // Actualiza o fusiona la metadata JSON
  optional string metadata = 4;
  // Clave para evitar ajustes duplicados en reintentos
  optional string idempotency_key = 5;
}

message TakeRequest {
  // Clave del recurso
  string resource_key = 1;
  // Unidades a reservar (1 para Unitarios)
  int32 amount = 2;
  TakeOptionalSettings settings = 3;
}
 
message TakeOptionalSettings {
  // Garantiza que peticiones repetidas devuelvan el mismo holder
  optional string idempotency_key = 1;
  // Sobrescribe el TTL de la plantilla (ej: 180 segundos)
  optional int32 custom_ttl_seconds = 2;
  // JSON string con datos de la sesión o comprador
  optional string metadata = 3;
}

message ConfirmRequest {
  // ID del holder emitido por Take
  string resource_holder_id = 1;
  // Opcional: datos finales a adjuntar (ej: {"paymentId": "ch_3M..."})
  optional string metadata_patch = 2;
}