API Reference

interface UploadOptions {
  /** Unique identifier for this content (used for key derivation) */
  contentId: string

  /** Base URL of the BlindCast key server */
  keyServerUrl: string

  /** URL of the presign endpoint */
  presignUrl: string

  /** Returns a Bearer token for auth (called for key fetch and presign requests) */
  auth?: () => Promise<string>

  /** Called after each segment is uploaded */
  onProgress?: (progress: UploadProgress) => void

  /** AbortSignal to cancel the upload */
  signal?: AbortSignal

  /** Number of parallel uploads (default: 4) */
  concurrency?: number

  /** S3 key prefix (default: "content/<contentId>/") */
  prefix?: string
}

interface SegmentInput {
  /** Segment number (used for IV derivation) */
  index: number

  /** Raw .ts segment bytes (plaintext — will be encrypted) */
  data: Uint8Array

  /** Original filename (e.g., "seg-0.ts") */
  filename: string
}

interface UploadResult {
  /** URL of the uploaded (rewritten) manifest */
  manifestUrl: string

  /** URLs of uploaded encrypted segments, in order */
  segmentUrls: string[]

  /** Total number of segments uploaded */
  segmentCount: number
}

interface UploadProgress {
  /** Number of segments uploaded so far */
  completed: number

  /** Total number of segments */
  total: number

  /** Filename of the segment just uploaded */
  current: string
}