@openrails/contentkit-ui 0.86.0 → 0.87.0

package/dist/client/media/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","names":[],"sources":["../../../src/client/media/client.ts"],"sourcesContent":["import { ContentKitError, aborted, failureError, throwIfAborted, toContentKitError } from \"../errors.js\";\nimport type { CommitBody, Edit, FileInfo, InlineImage, Op, PresetRule, PresignReply, ReadResult, RefBody, RequestReply } from \"../generated/wire.js\";\nimport type { Http } from \"../http.js\";\nimport { call } from \"../route.js\";\nimport { MediaApi, type ReadOptions } from \"./api.js\";\nimport { sha256Hex } from \"./hash.js\";\nimport { Pacer } from \"./pacer.js\";\nimport { itemRef } from \"./ref.js\";\nimport { defaultTransport, type Transport } from \"./transport.js\";\n\n/** Upload tuning for the media module. */\nexport interface MediaOptions {\n  /** Sends presigned PUTs. Default XMLHttpRequest (upload progress), else fetch. */\n  transport?: Transport;\n  /** Parallel parts per multipart upload (the pacer may run fewer). Default 4. */\n  concurrency?: number;\n  /** Retries per part and per idempotent API call. Default 5. */\n  retries?: number;\n  /** Delay before retry attempt (0-based); retryAfter is the server's hint in seconds. */\n  retryDelay?: (attempt: number, retryAfter?: number) => number;\n  /** Seconds one part should take. Default 30. */\n  targetPartSeconds?: number;\n}\n\nexport interface Progress {\n  /** processing: committed, waiting for the worker (put). */\n  phase: \"hashing\" | \"uploading\" | \"completing\" | \"processing\";\n  loaded: number;\n  total: number;\n}\n\nexport interface UploadOptions {\n  ref: RefBody;\n  /** The upload path: a literal (\"cover\") or under a pattern (\"originals/001.png\"); the server cleans it and adds the extension. */\n  path: string;\n  /** Content type; default the file's. */\n  type?: string;\n  /** Aborting pauses: a multipart upload stays resumable from the last state. */\n  signal?: AbortSignal;\n  onProgress?: (p: Progress) => void;\n  /** State saved from onState, to resume a multipart upload of the same file. */\n  resume?: UploadState;\n  /** Resumable state after every change; null once the upload completed. Persist it to survive a reload. */\n  onState?: (s: UploadState | null) => void;\n}\n\n/** An upload, ready for a put op. */\nexport interface UploadedFile {\n  /** The path to commit: cleaned, with an extension, named by the server for a Named upload. */\n  path: string;\n  /**\n   * The name to commit: the folder's identical blob (\"sha256-{hex}-{uuid}\") when\n   * exists, else the staged upload (\"u-{uuid}\") the worker hashes and places\n   * after the commit.\n   */\n  blob: string;\n  type: string;\n  size: number;\n  /** The identical file was already in the item's folder; nothing was sent. */\n  exists: boolean;\n  /** The host processes files on upload: commit it unattached now (the queue does). */\n  processOnUpload?: boolean;\n}\n\n/** The put op's fields besides path and blob. */\nexport interface PutOptions {\n  /** Refuse to replace an existing upload. Default false. */\n  createOnly?: boolean;\n  edit?: Edit | null;\n  meta?: Record<string, unknown>;\n  index?: number;\n  /** Wait until the worker processed the upload (waitFor). Default true. */\n  wait?: boolean;\n  /** How long to wait, ms. */\n  timeout?: number;\n  /** The upload, before the commit. */\n  onUploaded?: (up: UploadedFile) => void;\n}\n\nexport interface WaitOptions {\n  signal?: AbortSignal;\n  /** Poll interval, ms. Default 1000. */\n  interval?: number;\n  /** ms; then render_timeout. Default 120000. */\n  timeout?: number;\n}\n\nexport interface PlannedPart {\n  number: number;\n  offset: number;\n  size: number;\n  sha256?: string;\n}\n\n/** A multipart upload in flight; JSON-serializable. */\nexport interface UploadState {\n  ticket: string;\n  path: string;\n  /** The staged upload (\"u-{uuid}\") the parts write. */\n  blob: string;\n  type: string;\n  size: number;\n  ref: RefBody;\n  file: { name?: string; lastModified?: number; size: number };\n  limits: { minPartSize: number; maxPartSize: number; maxParts: number };\n  parts: PlannedPart[];\n  processOnUpload?: boolean;\n}\n\n/** An upload to a server-named (Named) path: a post's or poll's image. */\nexport interface NamedOptions {\n  /** The requested path; the server names the file. Default the file's name. */\n  path?: string;\n  signal?: AbortSignal;\n  onProgress?: (p: Progress) => void;\n  /** Wait until the worker processed it. Default true. */\n  wait?: boolean;\n  /** How long to wait, ms. */\n  timeout?: number;\n  /** A crop or rotation the file is committed with. */\n  edit?: Edit;\n}\n\n/** An upload to a Named path, committed. */\nexport interface NamedUpload {\n  /** The server's name for it (\"i-{uuid}\"), which content routes take. */\n  name: string;\n  path: string;\n  file: FileInfo;\n}\n\n/** The media kind of poll folders (content.Media.PollKind). A content item's folder is its kind's. */\nexport interface ContentFolders {\n  /** Default \"poll\". */\n  poll?: string;\n}\n\nconst named = /^i-[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/;\n\n/** A file to upload again when its blob is gone at commit; type defaults to the file's. */\nexport type CommitSource = Blob | { file: Blob; type?: string };\n\nexport interface CommitOptions {\n  signal?: AbortSignal;\n  /** UUID for this complete batch. Keep it with unchanged ops for a later retry; default a new UUID. */\n  operationID?: string;\n  /** Persist the active batch before sending it, including any replacement after re-upload. Resume with its ops and operation_id. */\n  onState?: (batch: CommitBody) => void;\n  /** Blob (\"sha256-…\") → the file it was uploaded from. */\n  sources?: Record<string, CommitSource>;\n}\n\ntype Uploadable = Blob & { name?: string; lastModified?: number };\n\n/** A path names a file by its full path or, for an upload, its stem (\"cover\" for \"cover.png\"). */\nexport const samePath = (file: string, path: string) => file === path || stem(file) === path;\n\n/** The path without its extension. */\nexport const stem = (path: string) => {\n  const i = path.lastIndexOf(\".\");\n  return i > path.lastIndexOf(\"/\") + 1 ? path.slice(0, i) : path;\n};\n\n/** The media module: uploads, commits, reads, frames and HLS. */\nexport class MediaClient {\n  readonly api: MediaApi;\n  private readonly transport: Transport;\n  private readonly concurrency: number;\n  private readonly retries: number;\n  private readonly delay: (attempt: number, retryAfter?: number) => number;\n  private readonly targetSeconds: number;\n  private presetList?: Promise<PresetRule[]>;\n\n  private readonly folders: Required<ContentFolders>;\n\n  constructor(\n    private readonly http: Http,\n    o: MediaOptions = {},\n    folders: ContentFolders = {},\n  ) {\n    this.folders = { poll: folders.poll ?? \"poll\" };\n    this.api = new MediaApi(http);\n    this.transport = o.transport ?? defaultTransport;\n    this.concurrency = o.concurrency ?? 4;\n    this.retries = o.retries ?? 5;\n    this.delay = o.retryDelay ?? backoff;\n    this.targetSeconds = o.targetPartSeconds ?? 30;\n  }\n\n  /**\n   * Uploads file to the item's folder: it hashes the whole file (off the\n   * main thread) and presigns {path, type, size, sha256}, then sends nothing\n   * (the folder holds the identical blob), or stages it: one checksum-bound\n   * PUT up to 64 MiB, resumable multipart above. A refused presign throws\n   * before any bytes move. Commit the result with a put op (or use put());\n   * the worker then places a staged upload at the hash of its bytes.\n   */\n  async upload(file: Uploadable, o: UploadOptions): Promise<UploadedFile> {\n    const type = o.type || file.type;\n    if (!type) throw new ContentKitError(\"invalid_request\", \"the file has no content type\");\n    throwIfAborted(o.signal);\n    if (o.resume) return this.resumeMultipart(file, o.resume, o);\n    const total = file.size;\n    const sha256 = await sha256Hex(file, { signal: o.signal, onProgress: (loaded) => o.onProgress?.({ phase: \"hashing\", loaded, total }) });\n    const presign = () => this.api.presign({ ref: o.ref, path: o.path, type, size: total, sha256 }, o.signal);\n    let p = await presign();\n    const out = (p: PresignReply): UploadedFile => ({ path: p.path, blob: p.blob, type, size: total, exists: !!p.exists, processOnUpload: !!p.process_on_upload });\n    if (p.exists) return out(p);\n    if (p.multipart) {\n      const m = p.multipart;\n      const state: UploadState = {\n        ticket: m.ticket,\n        path: p.path,\n        blob: p.blob,\n        type,\n        size: total,\n        ref: o.ref,\n        file: fingerprint(file),\n        limits: { minPartSize: m.min_part_size, maxPartSize: m.max_part_size, maxParts: m.max_parts },\n        parts: [],\n        processOnUpload: !!p.process_on_upload,\n      };\n      return this.multipart(file, state, new Set(), o);\n    }\n    await this.retry(\n      async () => {\n        if (p.exists) return;\n        await this.transport(p.put!, file, { signal: o.signal, onProgress: (loaded) => o.onProgress?.({ phase: \"uploading\", loaded, total }) });\n      },\n      o.signal,\n      async (err) => {\n        // An expired URL: presign again (a Named upload gets a new name).\n        if (err.code === \"storage\" && err.status === 403) p = await presign();\n      },\n    );\n    return out(p);\n  }\n\n  /**\n   * Uploads file and commits it as a put to its path (with edit, meta and\n   * index), then by default waits until the worker processed it; resolves\n   * with the upload as an editor reads it.\n   */\n  async put(file: Uploadable, o: UploadOptions & PutOptions): Promise<FileInfo> {\n    const up = await this.upload(file, o);\n    o.onUploaded?.(up);\n    const op: Op = { op: \"put\", path: up.path, blob: up.blob };\n    if (o.createOnly) op.create_id = crypto.randomUUID();\n    if (o.edit) op.edit = o.edit;\n    if (o.meta) op.meta = o.meta;\n    if (o.index !== undefined) op.index = o.index;\n    const files = await this.commit(o.ref, [op], { signal: o.signal, sources: { [up.blob]: { file, type: up.type } } });\n    if (o.wait === false) return files.find((f) => f.path === up.path) ?? { path: up.path, type: up.type };\n    o.onProgress?.({ phase: \"processing\", loaded: up.size, total: up.size });\n    return this.waitFor(o.ref, up.path, { signal: o.signal, timeout: o.timeout });\n  }\n\n  /**\n   * Applies ops to the item in one conditional write; returns its uploads as\n   * an editor reads them. With sources (blob → the file uploaded as it), a\n   * not_uploaded refusal (the blob expired or is due for cleanup) uploads\n   * the affected files again and retries the commit once.\n   */\n  async commit(ref: RefBody, ops: Op[], o: CommitOptions = {}): Promise<FileInfo[]> {\n    const emit = this.http.captureChanges();\n    // Snapshot the batch once: retries must not pick up edits to the caller's\n    // ops while the first request or its response is still in flight.\n    const body: CommitBody = structuredClone({ ref, ops, operation_id: o.operationID ?? crypto.randomUUID() });\n    o.onState?.(structuredClone(body));\n    let files: FileInfo[];\n    try {\n      files = (await this.retry(() => this.api.commit(body, o.signal), o.signal)).files;\n    } catch (e) {\n      if (!(e instanceof ContentKitError) || e.code !== \"not_uploaded\") throw e;\n      const sources = o.sources ?? {};\n      const puts = body.ops.filter((op) => op.op === \"put\" && op.blob && op.blob in sources);\n      const stale = [...new Set(puts.map((op) => op.blob!))].filter((b) => !e.blobs || e.blobs.includes(b));\n      if (stale.length === 0) throw e;\n      const renamed = new Map<string, string>();\n      for (const blob of stale) {\n        const src = sources[blob]!;\n        const file = src instanceof Blob ? src : src.file;\n        const type = src instanceof Blob ? undefined : src.type;\n        const op = puts.find((p) => p.blob === blob)!;\n        renamed.set(blob, (await this.upload(file, { ref: body.ref, path: op.path!, type, signal: o.signal })).blob);\n      }\n      const retried = body.ops.map((op) => (op.blob && renamed.has(op.blob) ? { ...op, blob: renamed.get(op.blob) } : op));\n      // Re-uploading changes the inputs. This is a new batch, not a retry\n      // under the old ID; transport retries retain its new identity.\n      const replacement = { ref: body.ref, ops: retried, operation_id: crypto.randomUUID() };\n      o.onState?.(structuredClone(replacement));\n      files = (await this.retry(() => this.api.commit(replacement, o.signal), o.signal)).files;\n    }\n    emit({ type: \"media.committed\", ref: itemRef(ref), files });\n    return files;\n  }\n\n  /** The read API: the item's files under prefix in manifest order, with signed URLs for what this viewer may have. */\n  async read(ref: RefBody, o: ReadOptions & { signal?: AbortSignal } = {}): Promise<ReadResult> {\n    this.api.itemURL(ref); // a bad ref fails at once\n    return this.retry(() => this.api.read(ref, o, o.signal), o.signal);\n  }\n\n  /**\n   * Polls an editor read until the upload at path (or with that stem) is\n   * processed: placed (not staged), nothing pending and its blob present (a\n   * frame grabbed).\n   * Rejects with its failure, not_found once it is gone, too_large while the\n   * item is full (nothing is processed until uploads are removed),\n   * render_timeout after the timeout.\n   */\n  async waitFor(ref: RefBody, path: string, o: WaitOptions = {}): Promise<FileInfo> {\n    const emit = this.http.captureChanges();\n    const until = Date.now() + (o.timeout ?? 120_000);\n    for (;;) {\n      const r = await this.read(ref, { editor: true, prefix: stem(path), signal: o.signal });\n      const f = r.files.find((x) => x.upload && samePath(x.path, path));\n      if (!f) throw new ContentKitError(\"not_found\", `no upload ${path}`, { status: 404 });\n      if (f.failed) throw failureError(f.failed);\n      if (!f.pending?.length && !f.staged && (f.size ?? 0) > 0) {\n        emit({ type: \"media.processed\", ref: itemRef(ref), file: f });\n        return f;\n      }\n      if (r.full) throw new ContentKitError(\"too_large\", `${path} waits: the item is full; remove uploads to process more`, { status: 413 });\n      if (Date.now() >= until) throw new ContentKitError(\"render_timeout\", `${path} is still processing`);\n      await sleep(o.interval ?? 1000, o.signal);\n    }\n  }\n\n  /**\n   * The upload's editor view, for re-cropping: its URL and the upload's\n   * oriented size. Waits while it renders (an editor read asks for it);\n   * not_found when the path has no upload, render_timeout after the timeout\n   * (default 30 s).\n   */\n  async editorView(ref: RefBody, path: string, o: WaitOptions = {}): Promise<{ url: string; width: number; height: number; edit?: Edit }> {\n    const until = Date.now() + (o.timeout ?? 30_000);\n    for (;;) {\n      const r = await this.read(ref, { editor: true, prefix: stem(path), signal: o.signal });\n      const f = r.files.find((x) => x.upload && samePath(x.path, path));\n      if (!f) throw new ContentKitError(\"not_found\", `no upload ${path}`, { status: 404 });\n      if (f.editor_url && f.w && f.h) return { url: f.editor_url, width: f.w, height: f.h, ...(f.edit ? { edit: f.edit } : {}) };\n      if (f.failed) throw failureError(f.failed);\n      if (Date.now() >= until) throw new ContentKitError(\"render_timeout\", `the editor view of ${path} is still rendering`);\n      await sleep(o.interval ?? 1000, o.signal);\n    }\n  }\n\n  /**\n   * Every kind's public presets, fetched once per client: crop bounds,\n   * widths and default images. An item's current image is in its read's\n   * `public`, never built from a preset. Shared by every caller, so it takes\n   * no signal; a failed fetch is retried on the next call.\n   */\n  presets(): Promise<PresetRule[]> {\n    this.presetList ??= this.retry(() => this.api.presets()).catch((e: unknown) => {\n      this.presetList = undefined;\n      throw e;\n    });\n    return this.presetList;\n  }\n\n  /** A JPEG still of the video upload at path, t seconds in, w pixels wide (default the frame's). */\n  getFrame(ref: RefBody, path: string, t: number, w?: number, signal?: AbortSignal): Promise<Blob> {\n    return this.retry(() => this.api.frame(ref, path, t, w, signal), signal);\n  }\n\n  /** The folder of an HLS ladder from a read's `hls`: `{media}/{kind}/{id}/hls/{dir}`; master.m3u8 and sprite.vtt resolve under it. */\n  hlsBase(ref: RefBody, dir: string): string {\n    return `${this.api.itemURL(ref)}/hls/${dir}`;\n  }\n\n  /** hls.js `xhrSetup` for playlists on the API (the client's token and credentials); pass it to players as is. */\n  get xhrSetup(): (xhr: XMLHttpRequest, url: string) => Promise<void> {\n    return this.http.xhrSetup;\n  }\n\n  /**\n   * Uploads an image to the item's server-named upload path and commits it\n   * (by default waiting until it is processed); resolves with the name content\n   * routes take: a poll or option image, a post cover.\n   */\n  async uploadNamed(ref: RefBody, file: Uploadable, o: NamedOptions = {}): Promise<NamedUpload> {\n    const f = await this.put(file, { ref, path: o.path ?? (file.name || \"image\"), signal: o.signal, onProgress: o.onProgress, wait: o.wait, timeout: o.timeout, edit: o.edit });\n    const name = stem(f.path.slice(f.path.lastIndexOf(\"/\") + 1));\n    if (!named.test(name)) throw new ContentKitError(\"invalid_request\", `${f.path} is not a server-named upload path of ${ref.kind}`);\n    return { name, path: f.path, file: f };\n  }\n\n  /**\n   * An image for a content item's rich-text body, uploaded to the item's body\n   * folder ({kind}.body and its id, BODY_SUFFIX), which only viewers who open\n   * the item see; resolves with its reference to store in the body (`ref`) and\n   * a URL that shows it to the editor now (`url`, null while none exists).\n   */\n  async uploadInline(item: RefBody, file: Uploadable, o: NamedOptions = {}): Promise<NamedUpload & InlineImage> {\n    const up = await this.uploadNamed(item, file, o);\n    const r: InlineImage = await call(this.http, \"POST\", \"/contents/{id}/images\", { params: { id: item.id }, body: { image: up.name }, signal: o.signal });\n    return { ...up, ...r };\n  }\n\n  /** The media folder of a poll. */\n  pollRef(id: string): RefBody {\n    return { kind: this.folders.poll, id };\n  }\n\n  /** Discards a paused multipart upload. */\n  async discard(state: UploadState): Promise<void> {\n    await this.api.abort(state.ref, { ticket: state.ticket });\n  }\n\n  private async resumeMultipart(file: Uploadable, state: UploadState, o: UploadOptions): Promise<UploadedFile> {\n    const fp = fingerprint(file);\n    if (fp.size !== state.size || fp.name !== state.file.name || fp.lastModified !== state.file.lastModified) {\n      throw new ContentKitError(\"resume_mismatch\", \"the saved upload is for a different file\");\n    }\n    let listed;\n    try {\n      listed = await this.retry(() => this.api.listParts(state.ref, { ticket: state.ticket }, o.signal), o.signal);\n    } catch (err) {\n      // Gone: already completed (Complete is idempotent) or expired.\n      if (err instanceof ContentKitError && err.code === \"not_found\") return this.complete(state, o);\n      throw err;\n    }\n    const landed = new Set<number>();\n    for (const l of listed.parts) {\n      const plan = state.parts.find((p) => p.number === l.number);\n      if (!plan || plan.size !== l.size || (l.sha256 && plan.sha256 !== l.sha256)) {\n        // Parts this state does not describe: the upload cannot be finished consistently.\n        await this.discard(state).catch(() => {});\n        o.onState?.(null);\n        return this.upload(file, { ...o, resume: undefined });\n      }\n      landed.add(l.number);\n    }\n    return this.multipart(file, structuredClone(state), landed, o);\n  }\n\n  private async multipart(file: Uploadable, state: UploadState, landed: Set<number>, o: UploadOptions): Promise<UploadedFile> {\n    const pacer = new Pacer({ ...state.limits, maxConcurrency: this.concurrency, targetSeconds: this.targetSeconds });\n    const emitState = () => o.onState?.(structuredClone(state));\n    const sending = new Map<number, number>();\n    let sent = state.parts.filter((p) => landed.has(p.number)).reduce((n, p) => n + p.size, 0);\n    const emitProgress = () => {\n      let loaded = sent;\n      for (const n of sending.values()) loaded += n;\n      o.onProgress?.({ phase: \"uploading\", loaded, total: state.size });\n    };\n    const pending = state.parts.filter((p) => !landed.has(p.number));\n    let offset = state.parts.reduce((end, p) => Math.max(end, p.offset + p.size), 0);\n    const next = (): PlannedPart | undefined => {\n      const p = pending.shift();\n      if (p || offset >= state.size) return p;\n      const part: PlannedPart = {\n        number: state.parts.length + 1,\n        offset,\n        size: Math.min(pacer.partSize(), state.size - offset),\n      };\n      offset += part.size;\n      state.parts.push(part);\n      return part;\n    };\n\n    const stop = new AbortController();\n    const signal = o.signal ? AbortSignal.any([o.signal, stop.signal]) : stop.signal;\n    // Parts hash and presign ahead of the PUT slots, so a freed slot starts\n    // its next PUT at once; pacer.concurrency bounds only the PUTs.\n    let putting = 0;\n    const waiting: (() => void)[] = [];\n    const acquire = () =>\n      new Promise<void>((resolve, reject) => {\n        const take = () => {\n          signal.removeEventListener(\"abort\", drop);\n          putting++;\n          resolve();\n        };\n        const drop = () => {\n          waiting.splice(waiting.indexOf(take) >>> 0, 1);\n          reject(aborted(signal));\n        };\n        if (putting < pacer.concurrency) return take();\n        if (signal.aborted) return reject(aborted(signal));\n        signal.addEventListener(\"abort\", drop, { once: true });\n        waiting.push(take);\n      });\n    const release = () => {\n      putting--;\n      while (putting < pacer.concurrency && waiting.length) waiting.shift()!();\n    };\n    const run = async (part: PlannedPart) => {\n      const body = file.slice(part.offset, part.offset + part.size);\n      await this.retry(async () => {\n        if (!part.sha256) {\n          part.sha256 = await sha256Hex(body, { signal });\n          emitState();\n        }\n        const { parts } = await this.api.parts(\n          state.ref,\n          { ticket: state.ticket, parts: [{ number: part.number, size: part.size, sha256: part.sha256 }] },\n          signal,\n        );\n        const req = parts[0]?.request as RequestReply;\n        await acquire();\n        const began = performance.now();\n        const alongside = putting;\n        try {\n          await this.transport(req, body, {\n            signal,\n            onProgress: (n) => {\n              sending.set(part.number, n);\n              emitProgress();\n            },\n          });\n        } finally {\n          sending.delete(part.number);\n          release();\n        }\n        pacer.record(part.size, performance.now() - began, alongside);\n        sent += part.size;\n        emitProgress();\n      }, signal);\n    };\n\n    emitState();\n    emitProgress();\n    const inFlight = new Set<Promise<void>>();\n    let failure: unknown;\n    for (;;) {\n      let part: PlannedPart | undefined;\n      while (failure === undefined && inFlight.size < pacer.concurrency + 2 && (part = next())) {\n        emitState();\n        const job: Promise<void> = run(part).then(\n          () => void inFlight.delete(job),\n          (err) => {\n            inFlight.delete(job);\n            if (failure === undefined) {\n              failure = err;\n              stop.abort();\n            }\n          },\n        );\n        inFlight.add(job);\n      }\n      if (inFlight.size === 0) break;\n      await Promise.race(inFlight);\n    }\n    if (failure !== undefined) {\n      throw o.signal?.aborted ? aborted(o.signal) : failure;\n    }\n    return this.complete(state, o);\n  }\n\n  private async complete(state: UploadState, o: UploadOptions): Promise<UploadedFile> {\n    o.onProgress?.({ phase: \"completing\", loaded: state.size, total: state.size });\n    const c = await this.retry(() => this.api.complete(state.ref, { ticket: state.ticket }, o.signal), o.signal);\n    o.onState?.(null);\n    return { path: state.path, blob: c.blob, type: c.type, size: c.size, exists: false, processOnUpload: state.processOnUpload };\n  }\n\n  private async retry<T>(fn: () => Promise<T>, signal?: AbortSignal, before?: (err: ContentKitError) => Promise<void>): Promise<T> {\n    for (let attempt = 0; ; attempt++) {\n      try {\n        return await fn();\n      } catch (e) {\n        const err = toContentKitError(e);\n        if (signal?.aborted) throw aborted(signal);\n        if (!err.transient || attempt >= this.retries) throw err;\n        await sleep(this.delay(attempt, err.retryAfter), signal);\n        await before?.(err);\n      }\n    }\n  }\n}\n\nfunction fingerprint(f: Uploadable): UploadState[\"file\"] {\n  return { name: f.name, lastModified: f.lastModified, size: f.size };\n}\n\n/** Exponential backoff from 1 s to 30 s with jitter, or the server's Retry-After. */\nexport function backoff(attempt: number, retryAfter?: number): number {\n  if (retryAfter) return retryAfter * 1000;\n  const base = Math.min(30_000, 1000 * 2 ** attempt);\n  return base * (0.75 + Math.random() * 0.5);\n}\n\nexport function sleep(ms: number, signal?: AbortSignal): Promise<void> {\n  return new Promise((resolve, reject) => {\n    if (signal?.aborted) return reject(aborted(signal));\n    const t = setTimeout(() => {\n      signal?.removeEventListener(\"abort\", onAbort);\n      resolve();\n    }, ms);\n    const onAbort = () => {\n      clearTimeout(t);\n      reject(aborted(signal));\n    };\n    signal?.addEventListener(\"abort\", onAbort, { once: true });\n  });\n}\n"],"mappings":"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"}
+{"version":3,"file":"client.js","names":[],"sources":["../../../src/client/media/client.ts"],"sourcesContent":["import { ContentKitError, aborted, failureError, throwIfAborted, toContentKitError } from \"../errors.js\";\nimport type { CommitBody, Edit, FileInfo, InlineImage, Op, PresetRule, PresignReply, ReadResult, RefBody, RequestReply } from \"../generated/wire.js\";\nimport type { Http } from \"../http.js\";\nimport { call } from \"../route.js\";\nimport { MediaApi, type ReadOptions } from \"./api.js\";\nimport { sha256Hex } from \"./hash.js\";\nimport { Pacer } from \"./pacer.js\";\nimport { itemRef } from \"./ref.js\";\nimport { defaultTransport, type Transport } from \"./transport.js\";\n\n/** Upload tuning for the media module. */\nexport interface MediaOptions {\n  /** Sends presigned PUTs. Default XMLHttpRequest (upload progress), else fetch. */\n  transport?: Transport;\n  /** Parallel parts per multipart upload (the pacer may run fewer). Default 4. */\n  concurrency?: number;\n  /** Retries per part and per idempotent API call. Default 5. */\n  retries?: number;\n  /** Delay before retry attempt (0-based); retryAfter is the server's hint in seconds. */\n  retryDelay?: (attempt: number, retryAfter?: number) => number;\n  /** Seconds one part should take. Default 30. */\n  targetPartSeconds?: number;\n}\n\nexport interface Progress {\n  /** processing: committed, waiting for the worker (put). */\n  phase: \"hashing\" | \"uploading\" | \"completing\" | \"processing\";\n  loaded: number;\n  total: number;\n}\n\nexport interface UploadOptions {\n  ref: RefBody;\n  /** The upload path: a literal (\"cover\") or under a pattern (\"originals/001.png\"); the server cleans it and adds the extension. */\n  path: string;\n  /** Content type; default the file's. */\n  type?: string;\n  /** Aborting pauses: a multipart upload stays resumable from the last state. */\n  signal?: AbortSignal;\n  onProgress?: (p: Progress) => void;\n  /** State saved from onState, to resume a multipart upload of the same file. */\n  resume?: UploadState;\n  /** Resumable state after every change; null once the upload completed. Persist it to survive a reload. */\n  onState?: (s: UploadState | null) => void;\n}\n\n/** An upload, ready for a put op. */\nexport interface UploadedFile {\n  /** The path to commit: cleaned, with an extension, named by the server for a Named upload. */\n  path: string;\n  /**\n   * The name to commit: the folder's identical blob (\"sha256-{hex}-{uuid}\") when\n   * exists, else the staged upload (\"u-{uuid}\") the worker hashes and places\n   * after the commit.\n   */\n  blob: string;\n  type: string;\n  size: number;\n  /** The identical file was already in the item's folder; nothing was sent. */\n  exists: boolean;\n  /** The host processes files on upload: commit it unattached now (the queue does). */\n  processOnUpload?: boolean;\n}\n\n/** The put op's fields besides path and blob. */\nexport interface PutOptions {\n  /** Refuse to replace an existing upload. Default false. */\n  createOnly?: boolean;\n  edit?: Edit | null;\n  meta?: Record<string, unknown>;\n  index?: number;\n  /** Wait until the worker processed the upload (waitFor). Default true. */\n  wait?: boolean;\n  /** How long to wait, ms. */\n  timeout?: number;\n  /** The upload, before the commit. */\n  onUploaded?: (up: UploadedFile) => void;\n}\n\nexport interface WaitOptions {\n  signal?: AbortSignal;\n  /** Poll interval, ms. Default 1000. */\n  interval?: number;\n  /** ms; then render_timeout. Default 120000. */\n  timeout?: number;\n}\n\nexport interface PlannedPart {\n  number: number;\n  offset: number;\n  size: number;\n  sha256?: string;\n}\n\n/** A multipart upload in flight; JSON-serializable. */\nexport interface UploadState {\n  ticket: string;\n  path: string;\n  /** The staged upload (\"u-{uuid}\") the parts write. */\n  blob: string;\n  type: string;\n  size: number;\n  ref: RefBody;\n  file: { name?: string; lastModified?: number; size: number };\n  limits: { minPartSize: number; maxPartSize: number; maxParts: number };\n  parts: PlannedPart[];\n  processOnUpload?: boolean;\n}\n\n/** An upload to a server-named (Named) path: a post's or poll's image. */\nexport interface NamedOptions {\n  /** The requested path; the server names the file. Default the file's name. */\n  path?: string;\n  signal?: AbortSignal;\n  onProgress?: (p: Progress) => void;\n  /** Wait until the worker processed it. Default true. */\n  wait?: boolean;\n  /** How long to wait, ms. */\n  timeout?: number;\n  /** A crop or rotation the file is committed with. */\n  edit?: Edit;\n}\n\n/** An upload to a Named path, committed. */\nexport interface NamedUpload {\n  /** The server's name for it (\"i-{uuid}\"), which content routes take. */\n  name: string;\n  path: string;\n  file: FileInfo;\n}\n\n/** The media kind of poll folders (content.Media.PollKind). A content item's folder is its kind's. */\nexport interface ContentFolders {\n  /** Default \"poll\". */\n  poll?: string;\n}\n\nconst named = /^i-[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/;\n\n/** A file to upload again when its blob is gone at commit; type defaults to the file's. */\nexport type CommitSource = Blob | { file: Blob; type?: string };\n\nexport interface CommitOptions {\n  signal?: AbortSignal;\n  /** UUID for this complete batch. Keep it with unchanged ops for a later retry; default a new UUID. */\n  operationID?: string;\n  /** Persist the active batch before sending it, including any replacement after re-upload. Resume with its ops and operation_id. */\n  onState?: (batch: CommitBody) => void;\n  /** Blob (\"sha256-…\") → the file it was uploaded from. */\n  sources?: Record<string, CommitSource>;\n}\n\ntype Uploadable = Blob & { name?: string; lastModified?: number };\n\n/** A path names a file by its full path or, for an upload, its stem (\"cover\" for \"cover.png\"). */\nexport const samePath = (file: string, path: string) => file === path || stem(file) === path;\n\n/** The path without its extension. */\nexport const stem = (path: string) => {\n  const i = path.lastIndexOf(\".\");\n  return i > path.lastIndexOf(\"/\") + 1 ? path.slice(0, i) : path;\n};\n\n/** The media module: uploads, commits, reads, frames and HLS. */\nexport class MediaClient {\n  readonly api: MediaApi;\n  private readonly transport: Transport;\n  private readonly concurrency: number;\n  private readonly retries: number;\n  private readonly delay: (attempt: number, retryAfter?: number) => number;\n  private readonly targetSeconds: number;\n  private presetList?: Promise<PresetRule[]>;\n  private readonly bodyDirs = new Map<string, string>();\n\n  private readonly folders: Required<ContentFolders>;\n\n  constructor(\n    private readonly http: Http,\n    o: MediaOptions = {},\n    folders: ContentFolders = {},\n  ) {\n    this.folders = { poll: folders.poll ?? \"poll\" };\n    this.api = new MediaApi(http);\n    this.transport = o.transport ?? defaultTransport;\n    this.concurrency = o.concurrency ?? 4;\n    this.retries = o.retries ?? 5;\n    this.delay = o.retryDelay ?? backoff;\n    this.targetSeconds = o.targetPartSeconds ?? 30;\n  }\n\n  /**\n   * Uploads file to the item's folder: it hashes the whole file (off the\n   * main thread) and presigns {path, type, size, sha256}, then sends nothing\n   * (the folder holds the identical blob), or stages it: one checksum-bound\n   * PUT up to 64 MiB, resumable multipart above. A refused presign throws\n   * before any bytes move. Commit the result with a put op (or use put());\n   * the worker then places a staged upload at the hash of its bytes.\n   */\n  async upload(file: Uploadable, o: UploadOptions): Promise<UploadedFile> {\n    const type = o.type || file.type;\n    if (!type) throw new ContentKitError(\"invalid_request\", \"the file has no content type\");\n    throwIfAborted(o.signal);\n    if (o.resume) return this.resumeMultipart(file, o.resume, o);\n    const total = file.size;\n    const sha256 = await sha256Hex(file, { signal: o.signal, onProgress: (loaded) => o.onProgress?.({ phase: \"hashing\", loaded, total }) });\n    const presign = () => this.api.presign({ ref: o.ref, path: o.path, type, size: total, sha256 }, o.signal);\n    let p = await presign();\n    const out = (p: PresignReply): UploadedFile => ({ path: p.path, blob: p.blob, type, size: total, exists: !!p.exists, processOnUpload: !!p.process_on_upload });\n    if (p.exists) return out(p);\n    if (p.multipart) {\n      const m = p.multipart;\n      const state: UploadState = {\n        ticket: m.ticket,\n        path: p.path,\n        blob: p.blob,\n        type,\n        size: total,\n        ref: o.ref,\n        file: fingerprint(file),\n        limits: { minPartSize: m.min_part_size, maxPartSize: m.max_part_size, maxParts: m.max_parts },\n        parts: [],\n        processOnUpload: !!p.process_on_upload,\n      };\n      return this.multipart(file, state, new Set(), o);\n    }\n    await this.retry(\n      async () => {\n        if (p.exists) return;\n        await this.transport(p.put!, file, { signal: o.signal, onProgress: (loaded) => o.onProgress?.({ phase: \"uploading\", loaded, total }) });\n      },\n      o.signal,\n      async (err) => {\n        // An expired URL: presign again (a Named upload gets a new name).\n        if (err.code === \"storage\" && err.status === 403) p = await presign();\n      },\n    );\n    return out(p);\n  }\n\n  /**\n   * Uploads file and commits it as a put to its path (with edit, meta and\n   * index), then by default waits until the worker processed it; resolves\n   * with the upload as an editor reads it.\n   */\n  async put(file: Uploadable, o: UploadOptions & PutOptions): Promise<FileInfo> {\n    const up = await this.upload(file, o);\n    o.onUploaded?.(up);\n    const op: Op = { op: \"put\", path: up.path, blob: up.blob };\n    if (o.createOnly) op.create_id = crypto.randomUUID();\n    if (o.edit) op.edit = o.edit;\n    if (o.meta) op.meta = o.meta;\n    if (o.index !== undefined) op.index = o.index;\n    const files = await this.commit(o.ref, [op], { signal: o.signal, sources: { [up.blob]: { file, type: up.type } } });\n    if (o.wait === false) return files.find((f) => f.path === up.path) ?? { path: up.path, type: up.type };\n    o.onProgress?.({ phase: \"processing\", loaded: up.size, total: up.size });\n    return this.waitFor(o.ref, up.path, { signal: o.signal, timeout: o.timeout });\n  }\n\n  /**\n   * Applies ops to the item in one conditional write; returns its uploads as\n   * an editor reads them. With sources (blob → the file uploaded as it), a\n   * not_uploaded refusal (the blob expired or is due for cleanup) uploads\n   * the affected files again and retries the commit once.\n   */\n  async commit(ref: RefBody, ops: Op[], o: CommitOptions = {}): Promise<FileInfo[]> {\n    const emit = this.http.captureChanges();\n    // Snapshot the batch once: retries must not pick up edits to the caller's\n    // ops while the first request or its response is still in flight.\n    const body: CommitBody = structuredClone({ ref, ops, operation_id: o.operationID ?? crypto.randomUUID() });\n    o.onState?.(structuredClone(body));\n    let files: FileInfo[];\n    try {\n      files = (await this.retry(() => this.api.commit(body, o.signal), o.signal)).files;\n    } catch (e) {\n      if (!(e instanceof ContentKitError) || e.code !== \"not_uploaded\") throw e;\n      const sources = o.sources ?? {};\n      const puts = body.ops.filter((op) => op.op === \"put\" && op.blob && op.blob in sources);\n      const stale = [...new Set(puts.map((op) => op.blob!))].filter((b) => !e.blobs || e.blobs.includes(b));\n      if (stale.length === 0) throw e;\n      const renamed = new Map<string, string>();\n      for (const blob of stale) {\n        const src = sources[blob]!;\n        const file = src instanceof Blob ? src : src.file;\n        const type = src instanceof Blob ? undefined : src.type;\n        const op = puts.find((p) => p.blob === blob)!;\n        renamed.set(blob, (await this.upload(file, { ref: body.ref, path: op.path!, type, signal: o.signal })).blob);\n      }\n      const retried = body.ops.map((op) => (op.blob && renamed.has(op.blob) ? { ...op, blob: renamed.get(op.blob) } : op));\n      // Re-uploading changes the inputs. This is a new batch, not a retry\n      // under the old ID; transport retries retain its new identity.\n      const replacement = { ref: body.ref, ops: retried, operation_id: crypto.randomUUID() };\n      o.onState?.(structuredClone(replacement));\n      files = (await this.retry(() => this.api.commit(replacement, o.signal), o.signal)).files;\n    }\n    emit({ type: \"media.committed\", ref: itemRef(ref), files });\n    return files;\n  }\n\n  /** The read API: the item's files under prefix in manifest order, with signed URLs for what this viewer may have. */\n  async read(ref: RefBody, o: ReadOptions & { signal?: AbortSignal } = {}): Promise<ReadResult> {\n    this.api.itemURL(ref); // a bad ref fails at once\n    return this.retry(() => this.api.read(ref, o, o.signal), o.signal);\n  }\n\n  /**\n   * Polls an editor read until the upload at path (or with that stem) is\n   * processed: placed (not staged), nothing pending and its blob present (a\n   * frame grabbed).\n   * Rejects with its failure, not_found once it is gone, too_large while the\n   * item is full (nothing is processed until uploads are removed),\n   * render_timeout after the timeout.\n   */\n  async waitFor(ref: RefBody, path: string, o: WaitOptions = {}): Promise<FileInfo> {\n    const emit = this.http.captureChanges();\n    const until = Date.now() + (o.timeout ?? 120_000);\n    for (;;) {\n      const r = await this.read(ref, { editor: true, prefix: stem(path), signal: o.signal });\n      const f = r.files.find((x) => x.upload && samePath(x.path, path));\n      if (!f) throw new ContentKitError(\"not_found\", `no upload ${path}`, { status: 404 });\n      if (f.failed) throw failureError(f.failed);\n      if (!f.pending?.length && !f.staged && (f.size ?? 0) > 0) {\n        emit({ type: \"media.processed\", ref: itemRef(ref), file: f });\n        return f;\n      }\n      if (r.full) throw new ContentKitError(\"too_large\", `${path} waits: the item is full; remove uploads to process more`, { status: 413 });\n      if (Date.now() >= until) throw new ContentKitError(\"render_timeout\", `${path} is still processing`);\n      await sleep(o.interval ?? 1000, o.signal);\n    }\n  }\n\n  /**\n   * The upload's editor view, for re-cropping: its URL and the upload's\n   * oriented size. Waits while it renders (an editor read asks for it);\n   * not_found when the path has no upload, render_timeout after the timeout\n   * (default 30 s).\n   */\n  async editorView(ref: RefBody, path: string, o: WaitOptions = {}): Promise<{ url: string; width: number; height: number; edit?: Edit }> {\n    const until = Date.now() + (o.timeout ?? 30_000);\n    for (;;) {\n      const r = await this.read(ref, { editor: true, prefix: stem(path), signal: o.signal });\n      const f = r.files.find((x) => x.upload && samePath(x.path, path));\n      if (!f) throw new ContentKitError(\"not_found\", `no upload ${path}`, { status: 404 });\n      if (f.editor_url && f.w && f.h) return { url: f.editor_url, width: f.w, height: f.h, ...(f.edit ? { edit: f.edit } : {}) };\n      if (f.failed) throw failureError(f.failed);\n      if (Date.now() >= until) throw new ContentKitError(\"render_timeout\", `the editor view of ${path} is still rendering`);\n      await sleep(o.interval ?? 1000, o.signal);\n    }\n  }\n\n  /**\n   * Every kind's public presets, fetched once per client: crop bounds,\n   * widths and default images. An item's current image is in its read's\n   * `public`, never built from a preset. Shared by every caller, so it takes\n   * no signal; a failed fetch is retried on the next call.\n   */\n  presets(): Promise<PresetRule[]> {\n    this.presetList ??= this.retry(() => this.api.presets()).catch((e: unknown) => {\n      this.presetList = undefined;\n      throw e;\n    });\n    return this.presetList;\n  }\n\n  /** A JPEG still of the video upload at path, t seconds in, w pixels wide (default the frame's). */\n  getFrame(ref: RefBody, path: string, t: number, w?: number, signal?: AbortSignal): Promise<Blob> {\n    return this.retry(() => this.api.frame(ref, path, t, w, signal), signal);\n  }\n\n  /** The folder of an HLS ladder from a read's `hls`: `{media}/{kind}/{id}/hls/{dir}`; master.m3u8 and sprite.vtt resolve under it. */\n  hlsBase(ref: RefBody, dir: string): string {\n    return `${this.api.itemURL(ref)}/hls/${dir}`;\n  }\n\n  /** hls.js `xhrSetup` for playlists on the API (the client's token and credentials); pass it to players as is. */\n  get xhrSetup(): (xhr: XMLHttpRequest, url: string) => Promise<void> {\n    return this.http.xhrSetup;\n  }\n\n  /**\n   * Uploads an image to the item's server-named upload path and commits it\n   * (by default waiting until it is processed); resolves with the name content\n   * routes take: a poll or option image, a post cover.\n   */\n  async uploadNamed(ref: RefBody, file: Uploadable, o: NamedOptions = {}): Promise<NamedUpload> {\n    const f = await this.put(file, { ref, path: o.path ?? (file.name || \"image\"), signal: o.signal, onProgress: o.onProgress, wait: o.wait, timeout: o.timeout, edit: o.edit });\n    const name = stem(f.path.slice(f.path.lastIndexOf(\"/\") + 1));\n    if (!named.test(name)) throw new ContentKitError(\"invalid_request\", `${f.path} is not a server-named upload path of ${ref.kind}`);\n    return { name, path: f.path, file: f };\n  }\n\n  /**\n   * An image for a content item's rich-text body, uploaded to a version's\n   * body upload (the kind's `body` upload rule), a private file only viewers\n   * who open the version read, and copied into the other versions; resolves\n   * with its reference to store in the body (`ref`) and a URL that shows it\n   * to the editor now (`url`, null while none exists).\n   */\n  async uploadInline(item: RefBody, file: Uploadable, o: NamedOptions = {}): Promise<NamedUpload & InlineImage> {\n    if (!item.version) throw new ContentKitError(\"invalid_request\", \"body images live in a version\");\n    const up = await this.uploadNamed(item, file, { ...o, path: o.path ?? (await this.bodyPath(item, file)) });\n    const r: InlineImage = await call(this.http, \"POST\", \"/contents/{id}/images\", { params: { id: item.id }, body: { image: up.name, version: item.version }, signal: o.signal });\n    return { ...up, ...r };\n  }\n\n  /** The upload path of file as a body image of item's kind, from its editor read's body rule. */\n  private async bodyPath(item: RefBody, file: Uploadable): Promise<string> {\n    let dir = this.bodyDirs.get(item.kind);\n    if (dir === undefined) {\n      const { uploads } = await this.read(item, { editor: true, limit: 1 });\n      // Non-editors get the reader view, which carries no upload rules.\n      if (!uploads) throw new ContentKitError(\"forbidden\", `only editors of ${item.kind} ${item.id} upload to it`);\n      const rule = uploads.find((r) => r.body);\n      if (!rule) throw new ContentKitError(\"invalid_request\", `kind ${item.kind} takes no body images`);\n      dir = rule.path.endsWith(\"{name}\") ? rule.path.slice(0, -\"{name}\".length) : rule.path;\n      this.bodyDirs.set(item.kind, dir);\n    }\n    return dir + (file.name || \"image\");\n  }\n\n  /** The upload path of file for kind's public preset (its first without one): the preset's source, its {name} the file's. */\n  async presetPath(kind: string, preset: string | undefined, file: Uploadable): Promise<string> {\n    const name = file.name || \"image\";\n    const rule = (await this.presets()).find((p) => p.kind === kind && (!preset || p.name === preset));\n    if (!rule) return name;\n    return rule.from.endsWith(\"{name}\") ? rule.from.slice(0, -\"{name}\".length) + name : rule.from;\n  }\n\n  /** The media folder of a poll. */\n  pollRef(id: string): RefBody {\n    return { kind: this.folders.poll, id };\n  }\n\n  /** Discards a paused multipart upload. */\n  async discard(state: UploadState): Promise<void> {\n    await this.api.abort(state.ref, { ticket: state.ticket });\n  }\n\n  private async resumeMultipart(file: Uploadable, state: UploadState, o: UploadOptions): Promise<UploadedFile> {\n    const fp = fingerprint(file);\n    if (fp.size !== state.size || fp.name !== state.file.name || fp.lastModified !== state.file.lastModified) {\n      throw new ContentKitError(\"resume_mismatch\", \"the saved upload is for a different file\");\n    }\n    let listed;\n    try {\n      listed = await this.retry(() => this.api.listParts(state.ref, { ticket: state.ticket }, o.signal), o.signal);\n    } catch (err) {\n      // Gone: already completed (Complete is idempotent) or expired.\n      if (err instanceof ContentKitError && err.code === \"not_found\") return this.complete(state, o);\n      throw err;\n    }\n    const landed = new Set<number>();\n    for (const l of listed.parts) {\n      const plan = state.parts.find((p) => p.number === l.number);\n      if (!plan || plan.size !== l.size || (l.sha256 && plan.sha256 !== l.sha256)) {\n        // Parts this state does not describe: the upload cannot be finished consistently.\n        await this.discard(state).catch(() => {});\n        o.onState?.(null);\n        return this.upload(file, { ...o, resume: undefined });\n      }\n      landed.add(l.number);\n    }\n    return this.multipart(file, structuredClone(state), landed, o);\n  }\n\n  private async multipart(file: Uploadable, state: UploadState, landed: Set<number>, o: UploadOptions): Promise<UploadedFile> {\n    const pacer = new Pacer({ ...state.limits, maxConcurrency: this.concurrency, targetSeconds: this.targetSeconds });\n    const emitState = () => o.onState?.(structuredClone(state));\n    const sending = new Map<number, number>();\n    let sent = state.parts.filter((p) => landed.has(p.number)).reduce((n, p) => n + p.size, 0);\n    const emitProgress = () => {\n      let loaded = sent;\n      for (const n of sending.values()) loaded += n;\n      o.onProgress?.({ phase: \"uploading\", loaded, total: state.size });\n    };\n    const pending = state.parts.filter((p) => !landed.has(p.number));\n    let offset = state.parts.reduce((end, p) => Math.max(end, p.offset + p.size), 0);\n    const next = (): PlannedPart | undefined => {\n      const p = pending.shift();\n      if (p || offset >= state.size) return p;\n      const part: PlannedPart = {\n        number: state.parts.length + 1,\n        offset,\n        size: Math.min(pacer.partSize(), state.size - offset),\n      };\n      offset += part.size;\n      state.parts.push(part);\n      return part;\n    };\n\n    const stop = new AbortController();\n    const signal = o.signal ? AbortSignal.any([o.signal, stop.signal]) : stop.signal;\n    // Parts hash and presign ahead of the PUT slots, so a freed slot starts\n    // its next PUT at once; pacer.concurrency bounds only the PUTs.\n    let putting = 0;\n    const waiting: (() => void)[] = [];\n    const acquire = () =>\n      new Promise<void>((resolve, reject) => {\n        const take = () => {\n          signal.removeEventListener(\"abort\", drop);\n          putting++;\n          resolve();\n        };\n        const drop = () => {\n          waiting.splice(waiting.indexOf(take) >>> 0, 1);\n          reject(aborted(signal));\n        };\n        if (putting < pacer.concurrency) return take();\n        if (signal.aborted) return reject(aborted(signal));\n        signal.addEventListener(\"abort\", drop, { once: true });\n        waiting.push(take);\n      });\n    const release = () => {\n      putting--;\n      while (putting < pacer.concurrency && waiting.length) waiting.shift()!();\n    };\n    const run = async (part: PlannedPart) => {\n      const body = file.slice(part.offset, part.offset + part.size);\n      await this.retry(async () => {\n        if (!part.sha256) {\n          part.sha256 = await sha256Hex(body, { signal });\n          emitState();\n        }\n        const { parts } = await this.api.parts(\n          state.ref,\n          { ticket: state.ticket, parts: [{ number: part.number, size: part.size, sha256: part.sha256 }] },\n          signal,\n        );\n        const req = parts[0]?.request as RequestReply;\n        await acquire();\n        const began = performance.now();\n        const alongside = putting;\n        try {\n          await this.transport(req, body, {\n            signal,\n            onProgress: (n) => {\n              sending.set(part.number, n);\n              emitProgress();\n            },\n          });\n        } finally {\n          sending.delete(part.number);\n          release();\n        }\n        pacer.record(part.size, performance.now() - began, alongside);\n        sent += part.size;\n        emitProgress();\n      }, signal);\n    };\n\n    emitState();\n    emitProgress();\n    const inFlight = new Set<Promise<void>>();\n    let failure: unknown;\n    for (;;) {\n      let part: PlannedPart | undefined;\n      while (failure === undefined && inFlight.size < pacer.concurrency + 2 && (part = next())) {\n        emitState();\n        const job: Promise<void> = run(part).then(\n          () => void inFlight.delete(job),\n          (err) => {\n            inFlight.delete(job);\n            if (failure === undefined) {\n              failure = err;\n              stop.abort();\n            }\n          },\n        );\n        inFlight.add(job);\n      }\n      if (inFlight.size === 0) break;\n      await Promise.race(inFlight);\n    }\n    if (failure !== undefined) {\n      throw o.signal?.aborted ? aborted(o.signal) : failure;\n    }\n    return this.complete(state, o);\n  }\n\n  private async complete(state: UploadState, o: UploadOptions): Promise<UploadedFile> {\n    o.onProgress?.({ phase: \"completing\", loaded: state.size, total: state.size });\n    const c = await this.retry(() => this.api.complete(state.ref, { ticket: state.ticket }, o.signal), o.signal);\n    o.onState?.(null);\n    return { path: state.path, blob: c.blob, type: c.type, size: c.size, exists: false, processOnUpload: state.processOnUpload };\n  }\n\n  private async retry<T>(fn: () => Promise<T>, signal?: AbortSignal, before?: (err: ContentKitError) => Promise<void>): Promise<T> {\n    for (let attempt = 0; ; attempt++) {\n      try {\n        return await fn();\n      } catch (e) {\n        const err = toContentKitError(e);\n        if (signal?.aborted) throw aborted(signal);\n        if (!err.transient || attempt >= this.retries) throw err;\n        await sleep(this.delay(attempt, err.retryAfter), signal);\n        await before?.(err);\n      }\n    }\n  }\n}\n\nfunction fingerprint(f: Uploadable): UploadState[\"file\"] {\n  return { name: f.name, lastModified: f.lastModified, size: f.size };\n}\n\n/** Exponential backoff from 1 s to 30 s with jitter, or the server's Retry-After. */\nexport function backoff(attempt: number, retryAfter?: number): number {\n  if (retryAfter) return retryAfter * 1000;\n  const base = Math.min(30_000, 1000 * 2 ** attempt);\n  return base * (0.75 + Math.random() * 0.5);\n}\n\nexport function sleep(ms: number, signal?: AbortSignal): Promise<void> {\n  return new Promise((resolve, reject) => {\n    if (signal?.aborted) return reject(aborted(signal));\n    const t = setTimeout(() => {\n      signal?.removeEventListener(\"abort\", onAbort);\n      resolve();\n    }, ms);\n    const onAbort = () => {\n      clearTimeout(t);\n      reject(aborted(signal));\n    };\n    signal?.addEventListener(\"abort\", onAbort, { once: true });\n  });\n}\n"],"mappings":"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"}

package/dist/client/media/rules.d.ts

@@ -51,7 +51,7 @@ export declare function presetFor(presets: readonly PresetRule[], kind: string,
  * serves for an item without its own (a URL from the template never names a
  * current file). null when the preset has no default (`rule.default`).
  */
-export declare function defaultImage(rule: PresetRule, id: string): PublicPreset | null;
+export declare function defaultImage(rule: PresetRule, id: string, version?: string): PublicPreset | null;
 /**
  * A Stable preset's image of an item (`rule.stable`, e.g. the content
  * model's `avatars`): URLs built from the id that show its current image,

package/dist/client/media/rules.js

@@ -121,21 +121,21 @@ function v(e, t, n, r) {
 	let i = e.filter((e) => e.kind === t && u([{ path: e.from }], n));
 	return (r ? i.find((e) => e.name === r) : void 0) ?? i.find((e) => e.aspect) ?? i[0];
 }
-function y(e, t) {
-	return !e.default || e.first || e.to.includes(s) ? null : x(e, t);
+function y(e, t, n) {
+	return !e.default || e.first || e.to.includes(s) ? null : x(e, t, n);
 }
 function b(e, t) {
 	return e.stable ? x(e, t) : null;
 }
-function x(e, i) {
-	let a = r(e.aspect);
+function x(e, i, a) {
+	let o = r(e.aspect);
 	return {
 		preset: e.name,
 		aspect: e.aspect,
 		renditions: e.widths.map((r) => ({
-			url: n(e.base, e.namespace, e.kind, i, t(e.to, { w: r })),
+			url: n(e.base, e.namespace, e.kind, i, t(e.to, { w: r }), a),
 			w: r,
-			...a ? { h: Math.round(r / a) } : {}
+			...o ? { h: Math.round(r / o) } : {}
 		}))
 	};
 }

package/dist/client/media/rules.js.map

@@ -1 +1 @@
-{"version":3,"file":"rules.js","names":[],"sources":["../../../src/client/media/rules.ts"],"sourcesContent":["import { ContentKitError } from \"../errors.js\";\nimport type { ErrorDetails, PresetRule, ReadResult, UploadRule } from \"../generated/wire.js\";\nimport { fill, publicURL, type PublicPreset } from \"../public.js\";\nimport { ratio } from \"../aspect.js\";\nimport { stem } from \"./client.js\";\n\nconst NO_RULES: UploadRule[] = [];\n\n/** An editor read's upload rules (a viewer read has none): one empty list, so memos keyed on them hold. */\nexport const uploadRules = (read: ReadResult | null | undefined): UploadRule[] => read?.uploads ?? NO_RULES;\n\nconst NAME = \"{name}\";\n\n/** A pattern path (\"originals/{name}\") holds many files; a literal (\"cover\") one. */\nexport const isPattern = (path: string) => path.endsWith(NAME);\n\n/** The directory of a pattern (\"originals/\"), or the literal itself. */\nexport const ruleDir = (path: string) => (isPattern(path) ? path.slice(0, -NAME.length) : path);\n\n/** The rule an upload path (with or without its extension) falls under: a literal wins over a pattern. */\nexport function ruleFor<R extends { path: string }>(rules: readonly R[], path: string): R | undefined {\n  const s = stem(path);\n  return (\n    rules.find((r) => !isPattern(r.path) && r.path === s) ??\n    rules.find((r) => {\n      if (!isPattern(r.path)) return false;\n      const dir = ruleDir(r.path);\n      return s.startsWith(dir) && s.length > dir.length && !s.slice(dir.length).includes(\"/\");\n    })\n  );\n}\n\n/** Uploads of the read under rule (attached, in manifest order). */\nexport function filesFor(read: ReadResult | null | undefined, rule: { path: string }, rules: readonly { path: string }[] = [rule]) {\n  return (read?.files ?? []).filter((f) => f.upload && !f.unattached && ruleFor(rules, f.path)?.path === rule.path);\n}\n\nconst BY_EXTENSION: Record<string, string> = {\n  jpg: \"image/jpeg\",\n  jpeg: \"image/jpeg\",\n  png: \"image/png\",\n  webp: \"image/webp\",\n  gif: \"image/gif\",\n  avif: \"image/avif\",\n  mp4: \"video/mp4\",\n  m4v: \"video/mp4\",\n  mov: \"video/quicktime\",\n  mkv: \"video/x-matroska\",\n  webm: \"video/webm\",\n  m4a: \"audio/mp4\",\n  mp3: \"audio/mpeg\",\n  vtt: \"text/vtt\",\n  srt: \"application/x-subrip\",\n  ass: \"text/x-ass\",\n  ssa: \"text/x-ssa\",\n  zip: \"application/zip\",\n};\n\n/** The file with a content type from its extension when the browser left it empty or nonstandard (.mkv, .mov, .srt). */\nexport function withMediaType(file: File, allowed?: readonly string[]): File {\n  if (file.type && (!allowed || allowed.includes(file.type))) return file;\n  const type = BY_EXTENSION[file.name.split(\".\").pop()?.toLowerCase() ?? \"\"];\n  return type && type !== file.type ? new File([file], file.name, { type, lastModified: file.lastModified }) : file;\n}\n\n/** `accept` for a file input from the rules' types (plus the extensions browsers leave untyped). */\nexport function acceptOf(rules: readonly UploadRule[]): string | undefined {\n  const types = [...new Set(rules.flatMap((r) => r.types))];\n  if (!types.length) return undefined;\n  const exts = Object.entries(BY_EXTENSION).filter(([, t]) => types.includes(t)).map(([e]) => `.${e}`);\n  return [...types, ...exts].join(\",\");\n}\n\nexport interface Screened {\n  /** Files to upload, each with its rule (typed by extension when needed). */\n  accepted: { file: File; rule: UploadRule }[];\n  /** Files the server would refuse, with the refusal it would answer. */\n  refused: { file: File; error: ContentKitError }[];\n}\n\n/**\n * Checks files against the rules before any upload: a type some rule takes\n * (the first that does), its size, and the rule's file cap counting\n * have(rule) files already there. A rule without types, size or cap lets\n * that check through; the server decides.\n */\nexport function screenFiles(files: Iterable<File>, rules: readonly UploadRule[], have: (rule: UploadRule) => number = () => 0): Screened {\n  const out: Screened = { accepted: [], refused: [] };\n  const counts = new Map<UploadRule, number>();\n  const allowed = [...new Set(rules.flatMap((r) => r.types))];\n  for (const picked of files) {\n    const file = withMediaType(picked, allowed);\n    const rule = rules.find((r) => !r.types.length || r.types.includes(file.type));\n    if (!rule) {\n      const details: ErrorDetails = { type: file.type || undefined, allowed };\n      out.refused.push({ file, error: new ContentKitError(\"type_not_allowed\", `${file.name}: type not allowed`, { status: 415, details }) });\n      continue;\n    }\n    if (rule.max_bytes > 0 && file.size > rule.max_bytes) {\n      const details: ErrorDetails = { type: file.type, size: file.size, max_bytes: rule.max_bytes };\n      out.refused.push({ file, error: new ContentKitError(\"too_large\", `${file.name}: too large`, { status: 413, details }) });\n      continue;\n    }\n    const n = counts.get(rule) ?? have(rule);\n    if (rule.max && n >= rule.max) {\n      const details: ErrorDetails = { max: rule.max };\n      out.refused.push({ file, error: new ContentKitError(\"too_many_files\", `${file.name}: at most ${rule.max} files`, { status: 409, details }) });\n      continue;\n    }\n    counts.set(rule, n + 1);\n    out.accepted.push({ file, rule });\n  }\n  return out;\n}\n\n/** name, or name-2, name-3… so its stem is not among taken (names or paths without the directory). */\nexport function uniqueName(name: string, taken: Iterable<string>): string {\n  const stems = new Set([...taken].map(stem));\n  if (!stems.has(stem(name))) return name;\n  const dot = name.lastIndexOf(\".\");\n  const base = dot > 0 ? name.slice(0, dot) : name;\n  const ext = dot > 0 ? name.slice(dot) : \"\";\n  for (let n = 2; ; n++) {\n    const candidate = `${base}-${n}${ext}`;\n    if (!stems.has(stem(candidate))) return candidate;\n  }\n}\n\n/** \"16:9\" style label of a width/height ratio: 2.4 → \"2.4:1\", 0.4167 → \"1:2.4\". */\nexport function ratioLabel(r: number): string {\n  const round = (v: number) => String(Math.round(v * 100) / 100);\n  return r >= 1 ? `${round(r)}:1` : `1:${round(1 / r)}`;\n}\n\n/** The kind's public preset for an upload path: the one named name, else the first with an aspect, else the first. */\nexport function presetFor(presets: readonly PresetRule[], kind: string, path: string, name?: string): PresetRule | undefined {\n  const at = presets.filter((p) => p.kind === kind && ruleFor([{ path: p.from }], path));\n  return (name ? at.find((p) => p.name === name) : undefined) ?? at.find((p) => p.aspect) ?? at[0];\n}\n\n/**\n * The kind's default image for a preset, at every width: what the gateway\n * serves for an item without its own (a URL from the template never names a\n * current file). null when the preset has no default (`rule.default`).\n */\nexport function defaultImage(rule: PresetRule, id: string): PublicPreset | null {\n  if (!rule.default || rule.first || rule.to.includes(NAME)) return null;\n  return logicalImage(rule, id);\n}\n\n/**\n * A Stable preset's image of an item (`rule.stable`, e.g. the content\n * model's `avatars`): URLs built from the id that show its current image,\n * else the default. null for any other preset.\n */\nexport function stableImage(rule: PresetRule, id: string): PublicPreset | null {\n  return rule.stable ? logicalImage(rule, id) : null;\n}\n\nfunction logicalImage(rule: PresetRule, id: string): PublicPreset {\n  const r = ratio(rule.aspect);\n  return {\n    preset: rule.name,\n    aspect: rule.aspect,\n    renditions: rule.widths.map((w) => ({ url: publicURL(rule.base, rule.namespace, rule.kind, id, fill(rule.to, { w })), w, ...(r ? { h: Math.round(w / r) } : {}) })),\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"rules.js","names":[],"sources":["../../../src/client/media/rules.ts"],"sourcesContent":["import { ContentKitError } from \"../errors.js\";\nimport type { ErrorDetails, PresetRule, ReadResult, UploadRule } from \"../generated/wire.js\";\nimport { fill, publicURL, type PublicPreset } from \"../public.js\";\nimport { ratio } from \"../aspect.js\";\nimport { stem } from \"./client.js\";\n\nconst NO_RULES: UploadRule[] = [];\n\n/** An editor read's upload rules (a viewer read has none): one empty list, so memos keyed on them hold. */\nexport const uploadRules = (read: ReadResult | null | undefined): UploadRule[] => read?.uploads ?? NO_RULES;\n\nconst NAME = \"{name}\";\n\n/** A pattern path (\"originals/{name}\") holds many files; a literal (\"cover\") one. */\nexport const isPattern = (path: string) => path.endsWith(NAME);\n\n/** The directory of a pattern (\"originals/\"), or the literal itself. */\nexport const ruleDir = (path: string) => (isPattern(path) ? path.slice(0, -NAME.length) : path);\n\n/** The rule an upload path (with or without its extension) falls under: a literal wins over a pattern. */\nexport function ruleFor<R extends { path: string }>(rules: readonly R[], path: string): R | undefined {\n  const s = stem(path);\n  return (\n    rules.find((r) => !isPattern(r.path) && r.path === s) ??\n    rules.find((r) => {\n      if (!isPattern(r.path)) return false;\n      const dir = ruleDir(r.path);\n      return s.startsWith(dir) && s.length > dir.length && !s.slice(dir.length).includes(\"/\");\n    })\n  );\n}\n\n/** Uploads of the read under rule (attached, in manifest order). */\nexport function filesFor(read: ReadResult | null | undefined, rule: { path: string }, rules: readonly { path: string }[] = [rule]) {\n  return (read?.files ?? []).filter((f) => f.upload && !f.unattached && ruleFor(rules, f.path)?.path === rule.path);\n}\n\nconst BY_EXTENSION: Record<string, string> = {\n  jpg: \"image/jpeg\",\n  jpeg: \"image/jpeg\",\n  png: \"image/png\",\n  webp: \"image/webp\",\n  gif: \"image/gif\",\n  avif: \"image/avif\",\n  mp4: \"video/mp4\",\n  m4v: \"video/mp4\",\n  mov: \"video/quicktime\",\n  mkv: \"video/x-matroska\",\n  webm: \"video/webm\",\n  m4a: \"audio/mp4\",\n  mp3: \"audio/mpeg\",\n  vtt: \"text/vtt\",\n  srt: \"application/x-subrip\",\n  ass: \"text/x-ass\",\n  ssa: \"text/x-ssa\",\n  zip: \"application/zip\",\n};\n\n/** The file with a content type from its extension when the browser left it empty or nonstandard (.mkv, .mov, .srt). */\nexport function withMediaType(file: File, allowed?: readonly string[]): File {\n  if (file.type && (!allowed || allowed.includes(file.type))) return file;\n  const type = BY_EXTENSION[file.name.split(\".\").pop()?.toLowerCase() ?? \"\"];\n  return type && type !== file.type ? new File([file], file.name, { type, lastModified: file.lastModified }) : file;\n}\n\n/** `accept` for a file input from the rules' types (plus the extensions browsers leave untyped). */\nexport function acceptOf(rules: readonly UploadRule[]): string | undefined {\n  const types = [...new Set(rules.flatMap((r) => r.types))];\n  if (!types.length) return undefined;\n  const exts = Object.entries(BY_EXTENSION).filter(([, t]) => types.includes(t)).map(([e]) => `.${e}`);\n  return [...types, ...exts].join(\",\");\n}\n\nexport interface Screened {\n  /** Files to upload, each with its rule (typed by extension when needed). */\n  accepted: { file: File; rule: UploadRule }[];\n  /** Files the server would refuse, with the refusal it would answer. */\n  refused: { file: File; error: ContentKitError }[];\n}\n\n/**\n * Checks files against the rules before any upload: a type some rule takes\n * (the first that does), its size, and the rule's file cap counting\n * have(rule) files already there. A rule without types, size or cap lets\n * that check through; the server decides.\n */\nexport function screenFiles(files: Iterable<File>, rules: readonly UploadRule[], have: (rule: UploadRule) => number = () => 0): Screened {\n  const out: Screened = { accepted: [], refused: [] };\n  const counts = new Map<UploadRule, number>();\n  const allowed = [...new Set(rules.flatMap((r) => r.types))];\n  for (const picked of files) {\n    const file = withMediaType(picked, allowed);\n    const rule = rules.find((r) => !r.types.length || r.types.includes(file.type));\n    if (!rule) {\n      const details: ErrorDetails = { type: file.type || undefined, allowed };\n      out.refused.push({ file, error: new ContentKitError(\"type_not_allowed\", `${file.name}: type not allowed`, { status: 415, details }) });\n      continue;\n    }\n    if (rule.max_bytes > 0 && file.size > rule.max_bytes) {\n      const details: ErrorDetails = { type: file.type, size: file.size, max_bytes: rule.max_bytes };\n      out.refused.push({ file, error: new ContentKitError(\"too_large\", `${file.name}: too large`, { status: 413, details }) });\n      continue;\n    }\n    const n = counts.get(rule) ?? have(rule);\n    if (rule.max && n >= rule.max) {\n      const details: ErrorDetails = { max: rule.max };\n      out.refused.push({ file, error: new ContentKitError(\"too_many_files\", `${file.name}: at most ${rule.max} files`, { status: 409, details }) });\n      continue;\n    }\n    counts.set(rule, n + 1);\n    out.accepted.push({ file, rule });\n  }\n  return out;\n}\n\n/** name, or name-2, name-3… so its stem is not among taken (names or paths without the directory). */\nexport function uniqueName(name: string, taken: Iterable<string>): string {\n  const stems = new Set([...taken].map(stem));\n  if (!stems.has(stem(name))) return name;\n  const dot = name.lastIndexOf(\".\");\n  const base = dot > 0 ? name.slice(0, dot) : name;\n  const ext = dot > 0 ? name.slice(dot) : \"\";\n  for (let n = 2; ; n++) {\n    const candidate = `${base}-${n}${ext}`;\n    if (!stems.has(stem(candidate))) return candidate;\n  }\n}\n\n/** \"16:9\" style label of a width/height ratio: 2.4 → \"2.4:1\", 0.4167 → \"1:2.4\". */\nexport function ratioLabel(r: number): string {\n  const round = (v: number) => String(Math.round(v * 100) / 100);\n  return r >= 1 ? `${round(r)}:1` : `1:${round(1 / r)}`;\n}\n\n/** The kind's public preset for an upload path: the one named name, else the first with an aspect, else the first. */\nexport function presetFor(presets: readonly PresetRule[], kind: string, path: string, name?: string): PresetRule | undefined {\n  const at = presets.filter((p) => p.kind === kind && ruleFor([{ path: p.from }], path));\n  return (name ? at.find((p) => p.name === name) : undefined) ?? at.find((p) => p.aspect) ?? at[0];\n}\n\n/**\n * The kind's default image for a preset, at every width: what the gateway\n * serves for an item without its own (a URL from the template never names a\n * current file). null when the preset has no default (`rule.default`).\n */\nexport function defaultImage(rule: PresetRule, id: string, version?: string): PublicPreset | null {\n  if (!rule.default || rule.first || rule.to.includes(NAME)) return null;\n  return logicalImage(rule, id, version);\n}\n\n/**\n * A Stable preset's image of an item (`rule.stable`, e.g. the content\n * model's `avatars`): URLs built from the id that show its current image,\n * else the default. null for any other preset.\n */\nexport function stableImage(rule: PresetRule, id: string): PublicPreset | null {\n  return rule.stable ? logicalImage(rule, id) : null;\n}\n\nfunction logicalImage(rule: PresetRule, id: string, version?: string): PublicPreset {\n  const r = ratio(rule.aspect);\n  return {\n    preset: rule.name,\n    aspect: rule.aspect,\n    renditions: rule.widths.map((w) => ({ url: publicURL(rule.base, rule.namespace, rule.kind, id, fill(rule.to, { w }), version), w, ...(r ? { h: Math.round(w / r) } : {}) })),\n  };\n}\n"],"mappings":"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"}

package/dist/client/media/transport.d.ts

@@ -1,7 +1,7 @@
 import { RequestReply } from '../generated/wire.js';
 /**
  * Sends a presigned request with its body. Resolves on 2xx; rejects with an
- * ContentKitError (storage, network or aborted). onProgress reports bytes sent.
+ * ContentKitError (storage, network, server_unavailable or aborted). onProgress reports bytes sent.
  */
 export type Transport = (req: RequestReply, body: Blob, opts: {
     signal?: AbortSignal;

package/dist/client/media/transport.js

@@ -1,33 +1,33 @@
-import { ContentKitError as e, aborted as t } from "../errors.js";
+import { ContentKitError as e, aborted as t, requestFailure as n } from "../errors.js";
 //#region src/client/media/transport.ts
-var n = (e, t, n) => typeof XMLHttpRequest > "u" ? i(e, t, n) : r(e, t, n), r = (n, r, { signal: i, onProgress: o }) => new Promise((s, c) => {
+var r = (e, t, n) => typeof XMLHttpRequest > "u" ? a(e, t, n) : i(e, t, n), i = (n, r, { signal: i, onProgress: a }) => new Promise((s, c) => {
 	if (i?.aborted) return c(t(i));
 	let l = new XMLHttpRequest(), u = () => l.abort(), d = (e) => {
 		i?.removeEventListener("abort", u), e ? c(e) : s();
 	};
 	l.open(n.method, n.url);
 	for (let [e, t] of Object.entries(n.headers)) l.setRequestHeader(e, t);
-	l.upload.onprogress = (e) => o?.(e.loaded), l.onload = () => d(l.status >= 200 && l.status < 300 ? void 0 : a(l.status, l.responseText)), l.onerror = () => d(new e("network", "connection to storage failed")), l.ontimeout = l.onerror, l.onabort = () => d(t(i)), i?.addEventListener("abort", u, { once: !0 }), l.send(r);
-}), i = async (n, r, { signal: i, onProgress: o }) => {
-	let s;
+	l.upload.onprogress = (e) => a?.(e.loaded), l.onload = () => d(l.status >= 200 && l.status < 300 ? void 0 : o(l.status, l.responseText)), l.onerror = () => d(new e("network", "connection to storage failed")), l.ontimeout = () => d(new e("server_unavailable", "storage did not respond")), l.onabort = () => d(t(i)), i?.addEventListener("abort", u, { once: !0 }), l.send(r);
+}), a = async (e, t, { signal: r, onProgress: i }) => {
+	let a;
 	try {
-		s = await fetch(n.url, {
-			method: n.method,
-			headers: n.headers,
-			body: r,
-			signal: i ?? null
+		a = await fetch(e.url, {
+			method: e.method,
+			headers: e.headers,
+			body: t,
+			signal: r ?? null
 		});
-	} catch (n) {
-		throw i?.aborted ? t(i) : new e("network", "connection to storage failed", { cause: n });
+	} catch (e) {
+		throw n(e, r, "storage");
 	}
-	if (!s.ok) throw a(s.status, await s.text().catch(() => ""));
-	await s.body?.cancel(), o?.(r.size);
+	if (!a.ok) throw o(a.status, await a.text().catch(() => ""));
+	await a.body?.cancel(), i?.(t.size);
 };
-function a(t, n) {
+function o(t, n) {
 	let r = /<Code>([^<]+)<\/Code>/.exec(n)?.[1];
 	return new e("storage", `storage refused the upload (${t}${r ? " " + r : ""})`, { status: t });
 }
 //#endregion
-export { n as defaultTransport, i as fetchTransport, r as xhrTransport };
+export { r as defaultTransport, a as fetchTransport, i as xhrTransport };
 
 //# sourceMappingURL=transport.js.map

package/dist/client/media/transport.js.map

@@ -1 +1 @@
-{"version":3,"file":"transport.js","names":[],"sources":["../../../src/client/media/transport.ts"],"sourcesContent":["import { ContentKitError, aborted } from \"../errors.js\";\nimport type { RequestReply } from \"../generated/wire.js\";\n\n/**\n * Sends a presigned request with its body. Resolves on 2xx; rejects with an\n * ContentKitError (storage, network or aborted). onProgress reports bytes sent.\n */\nexport type Transport = (\n  req: RequestReply,\n  body: Blob,\n  opts: { signal?: AbortSignal; onProgress?: (sent: number) => void },\n) => Promise<void>;\n\n/** XMLHttpRequest when available (upload progress), otherwise fetch. */\nexport const defaultTransport: Transport = (req, body, opts) =>\n  typeof XMLHttpRequest === \"undefined\" ? fetchTransport(req, body, opts) : xhrTransport(req, body, opts);\n\nexport const xhrTransport: Transport = (req, body, { signal, onProgress }) =>\n  new Promise((resolve, reject) => {\n    if (signal?.aborted) return reject(aborted(signal));\n    const xhr = new XMLHttpRequest();\n    const onAbort = () => xhr.abort();\n    const done = (err?: ContentKitError) => {\n      signal?.removeEventListener(\"abort\", onAbort);\n      if (err) reject(err);\n      else resolve();\n    };\n    xhr.open(req.method, req.url);\n    for (const [k, v] of Object.entries(req.headers)) xhr.setRequestHeader(k, v);\n    xhr.upload.onprogress = (e) => onProgress?.(e.loaded);\n    xhr.onload = () =>\n      done(xhr.status >= 200 && xhr.status < 300 ? undefined : storageError(xhr.status, xhr.responseText));\n    xhr.onerror = () => done(new ContentKitError(\"network\", \"connection to storage failed\"));\n    xhr.ontimeout = xhr.onerror;\n    xhr.onabort = () => done(aborted(signal));\n    signal?.addEventListener(\"abort\", onAbort, { once: true });\n    xhr.send(body);\n  });\n\nexport const fetchTransport: Transport = async (req, body, { signal, onProgress }) => {\n  let res: Response;\n  try {\n    res = await fetch(req.url, { method: req.method, headers: req.headers, body, signal: signal ?? null });\n  } catch (err) {\n    if (signal?.aborted) throw aborted(signal);\n    throw new ContentKitError(\"network\", \"connection to storage failed\", { cause: err });\n  }\n  if (!res.ok) throw storageError(res.status, await res.text().catch(() => \"\"));\n  await res.body?.cancel();\n  onProgress?.(body.size);\n};\n\nfunction storageError(status: number, body: string): ContentKitError {\n  const code = /<Code>([^<]+)<\\/Code>/.exec(body)?.[1];\n  return new ContentKitError(\"storage\", `storage refused the upload (${status}${code ? \" \" + code : \"\"})`, { status });\n}\n"],"mappings":";;AAcA,IAAa,KAA+B,GAAK,GAAM,MACrD,OAAO,iBAAmB,MAAc,EAAe,GAAK,GAAM,CAAI,IAAI,EAAa,GAAK,GAAM,CAAI,GAE3F,KAA2B,GAAK,GAAM,EAAE,WAAQ,oBAC3D,IAAI,SAAS,GAAS,MAAW;CAC/B,IAAI,GAAQ,SAAS,OAAO,EAAO,EAAQ,CAAM,CAAC;CAClD,IAAM,IAAM,IAAI,eAAe,GACzB,UAAgB,EAAI,MAAM,GAC1B,KAAQ,MAA0B;EAEtC,AADA,GAAQ,oBAAoB,SAAS,CAAO,GACxC,IAAK,EAAO,CAAG,IACd,EAAQ;CACf;CACA,EAAI,KAAK,EAAI,QAAQ,EAAI,GAAG;CAC5B,KAAK,IAAM,CAAC,GAAG,MAAM,OAAO,QAAQ,EAAI,OAAO,GAAG,EAAI,iBAAiB,GAAG,CAAC;CAQ3E,AAPA,EAAI,OAAO,cAAc,MAAM,IAAa,EAAE,MAAM,GACpD,EAAI,eACF,EAAK,EAAI,UAAU,OAAO,EAAI,SAAS,MAAM,KAAA,IAAY,EAAa,EAAI,QAAQ,EAAI,YAAY,CAAC,GACrG,EAAI,gBAAgB,EAAK,IAAI,EAAgB,WAAW,8BAA8B,CAAC,GACvF,EAAI,YAAY,EAAI,SACpB,EAAI,gBAAgB,EAAK,EAAQ,CAAM,CAAC,GACxC,GAAQ,iBAAiB,SAAS,GAAS,EAAE,MAAM,GAAK,CAAC,GACzD,EAAI,KAAK,CAAI;AACf,CAAC,GAEU,IAA4B,OAAO,GAAK,GAAM,EAAE,WAAQ,oBAAiB;CACpF,IAAI;CACJ,IAAI;EACF,IAAM,MAAM,MAAM,EAAI,KAAK;GAAE,QAAQ,EAAI;GAAQ,SAAS,EAAI;GAAS;GAAM,QAAQ,KAAU;EAAK,CAAC;CACvG,SAAS,GAAK;EAEZ,MADI,GAAQ,UAAe,EAAQ,CAAM,IACnC,IAAI,EAAgB,WAAW,gCAAgC,EAAE,OAAO,EAAI,CAAC;CACrF;CACA,IAAI,CAAC,EAAI,IAAI,MAAM,EAAa,EAAI,QAAQ,MAAM,EAAI,KAAK,CAAC,CAAC,YAAY,EAAE,CAAC;CAE5E,AADA,MAAM,EAAI,MAAM,OAAO,GACvB,IAAa,EAAK,IAAI;AACxB;AAEA,SAAS,EAAa,GAAgB,GAA+B;CACnE,IAAM,IAAO,wBAAwB,KAAK,CAAI,CAAC,GAAG;CAClD,OAAO,IAAI,EAAgB,WAAW,+BAA+B,IAAS,IAAO,MAAM,IAAO,GAAG,IAAI,EAAE,UAAO,CAAC;AACrH"}
+{"version":3,"file":"transport.js","names":[],"sources":["../../../src/client/media/transport.ts"],"sourcesContent":["import { ContentKitError, aborted, requestFailure } from \"../errors.js\";\nimport type { RequestReply } from \"../generated/wire.js\";\n\n/**\n * Sends a presigned request with its body. Resolves on 2xx; rejects with an\n * ContentKitError (storage, network, server_unavailable or aborted). onProgress reports bytes sent.\n */\nexport type Transport = (\n  req: RequestReply,\n  body: Blob,\n  opts: { signal?: AbortSignal; onProgress?: (sent: number) => void },\n) => Promise<void>;\n\n/** XMLHttpRequest when available (upload progress), otherwise fetch. */\nexport const defaultTransport: Transport = (req, body, opts) =>\n  typeof XMLHttpRequest === \"undefined\" ? fetchTransport(req, body, opts) : xhrTransport(req, body, opts);\n\nexport const xhrTransport: Transport = (req, body, { signal, onProgress }) =>\n  new Promise((resolve, reject) => {\n    if (signal?.aborted) return reject(aborted(signal));\n    const xhr = new XMLHttpRequest();\n    const onAbort = () => xhr.abort();\n    const done = (err?: ContentKitError) => {\n      signal?.removeEventListener(\"abort\", onAbort);\n      if (err) reject(err);\n      else resolve();\n    };\n    xhr.open(req.method, req.url);\n    for (const [k, v] of Object.entries(req.headers)) xhr.setRequestHeader(k, v);\n    xhr.upload.onprogress = (e) => onProgress?.(e.loaded);\n    xhr.onload = () =>\n      done(xhr.status >= 200 && xhr.status < 300 ? undefined : storageError(xhr.status, xhr.responseText));\n    xhr.onerror = () => done(new ContentKitError(\"network\", \"connection to storage failed\"));\n    xhr.ontimeout = () => done(new ContentKitError(\"server_unavailable\", \"storage did not respond\"));\n    xhr.onabort = () => done(aborted(signal));\n    signal?.addEventListener(\"abort\", onAbort, { once: true });\n    xhr.send(body);\n  });\n\nexport const fetchTransport: Transport = async (req, body, { signal, onProgress }) => {\n  let res: Response;\n  try {\n    res = await fetch(req.url, { method: req.method, headers: req.headers, body, signal: signal ?? null });\n  } catch (err) {\n    throw requestFailure(err, signal, \"storage\");\n  }\n  if (!res.ok) throw storageError(res.status, await res.text().catch(() => \"\"));\n  await res.body?.cancel();\n  onProgress?.(body.size);\n};\n\nfunction storageError(status: number, body: string): ContentKitError {\n  const code = /<Code>([^<]+)<\\/Code>/.exec(body)?.[1];\n  return new ContentKitError(\"storage\", `storage refused the upload (${status}${code ? \" \" + code : \"\"})`, { status });\n}\n"],"mappings":";;AAcA,IAAa,KAA+B,GAAK,GAAM,MACrD,OAAO,iBAAmB,MAAc,EAAe,GAAK,GAAM,CAAI,IAAI,EAAa,GAAK,GAAM,CAAI,GAE3F,KAA2B,GAAK,GAAM,EAAE,WAAQ,oBAC3D,IAAI,SAAS,GAAS,MAAW;CAC/B,IAAI,GAAQ,SAAS,OAAO,EAAO,EAAQ,CAAM,CAAC;CAClD,IAAM,IAAM,IAAI,eAAe,GACzB,UAAgB,EAAI,MAAM,GAC1B,KAAQ,MAA0B;EAEtC,AADA,GAAQ,oBAAoB,SAAS,CAAO,GACxC,IAAK,EAAO,CAAG,IACd,EAAQ;CACf;CACA,EAAI,KAAK,EAAI,QAAQ,EAAI,GAAG;CAC5B,KAAK,IAAM,CAAC,GAAG,MAAM,OAAO,QAAQ,EAAI,OAAO,GAAG,EAAI,iBAAiB,GAAG,CAAC;CAQ3E,AAPA,EAAI,OAAO,cAAc,MAAM,IAAa,EAAE,MAAM,GACpD,EAAI,eACF,EAAK,EAAI,UAAU,OAAO,EAAI,SAAS,MAAM,KAAA,IAAY,EAAa,EAAI,QAAQ,EAAI,YAAY,CAAC,GACrG,EAAI,gBAAgB,EAAK,IAAI,EAAgB,WAAW,8BAA8B,CAAC,GACvF,EAAI,kBAAkB,EAAK,IAAI,EAAgB,sBAAsB,yBAAyB,CAAC,GAC/F,EAAI,gBAAgB,EAAK,EAAQ,CAAM,CAAC,GACxC,GAAQ,iBAAiB,SAAS,GAAS,EAAE,MAAM,GAAK,CAAC,GACzD,EAAI,KAAK,CAAI;AACf,CAAC,GAEU,IAA4B,OAAO,GAAK,GAAM,EAAE,WAAQ,oBAAiB;CACpF,IAAI;CACJ,IAAI;EACF,IAAM,MAAM,MAAM,EAAI,KAAK;GAAE,QAAQ,EAAI;GAAQ,SAAS,EAAI;GAAS;GAAM,QAAQ,KAAU;EAAK,CAAC;CACvG,SAAS,GAAK;EACZ,MAAM,EAAe,GAAK,GAAQ,SAAS;CAC7C;CACA,IAAI,CAAC,EAAI,IAAI,MAAM,EAAa,EAAI,QAAQ,MAAM,EAAI,KAAK,CAAC,CAAC,YAAY,EAAE,CAAC;CAE5E,AADA,MAAM,EAAI,MAAM,OAAO,GACvB,IAAa,EAAK,IAAI;AACxB;AAEA,SAAS,EAAa,GAAgB,GAA+B;CACnE,IAAM,IAAO,wBAAwB,KAAK,CAAI,CAAC,GAAG;CAClD,OAAO,IAAI,EAAgB,WAAW,+BAA+B,IAAS,IAAO,MAAM,IAAO,GAAG,IAAI,EAAE,UAAO,CAAC;AACrH"}

package/dist/client/media/windows.js

@@ -13,7 +13,7 @@ function n(e) {
 	let n = t.reduce((e, t) => t.expires >= e.expires ? t : e), r = /* @__PURE__ */ new Map();
 	for (let e of [...t].sort((e, t) => e.expires - t.expires)) for (let t of e.files) t.url && r.set(t.path, t);
 	let i = n.files.map((e) => {
-		if (e.url || e.locked) return e;
+		if (e.url) return e;
 		let t = r.get(e.path);
 		return t ? {
 			...e,

package/dist/client/media/windows.js.map

@@ -1 +1 @@
-{"version":3,"file":"windows.js","names":[],"sources":["../../../src/client/media/windows.ts"],"sourcesContent":["import type { FileInfo, ReadResult } from \"../generated/wire.js\";\n\n/** Files per window when a read is split into windows. */\nexport const READ_CHUNK = 50;\n\n/** Offsets of chunk-sized windows covering files [start, end), clipped to total when known. */\nexport function chunkOffsets(start: number, end: number, total?: number, chunk = READ_CHUNK): number[] {\n  const out: number[] = [];\n  const stop = total === undefined ? end : Math.min(end, total);\n  if (start >= stop) return out;\n  for (let o = Math.floor(Math.max(start, 0) / chunk) * chunk; o < stop; o += chunk) out.push(o);\n  return out;\n}\n\n/**\n * One item's window reads as one read: the newest window's listing and\n * metadata, each file's URL from the newest window that signed it, and the\n * earliest expiry. Every window lists every file; only its range has URLs.\n */\nexport function mergeReads(reads: readonly (ReadResult | null | undefined)[]): ReadResult | null {\n  const present = reads.filter((r): r is ReadResult => !!r);\n  if (present.length === 0) return null;\n  if (present.length === 1) return present[0]!;\n  const newest = present.reduce((a, b) => (b.expires >= a.expires ? b : a));\n  const urls = new Map<string, FileInfo>();\n  for (const r of [...present].sort((a, b) => a.expires - b.expires)) for (const f of r.files) if (f.url) urls.set(f.path, f);\n  const files = newest.files.map((f) => {\n    if (f.url || f.locked) return f;\n    const signed = urls.get(f.path);\n    return signed ? { ...f, url: signed.url, ...(signed.download ? { download: signed.download } : {}) } : f;\n  });\n  const start = Math.min(...present.map((r) => r.offset));\n  const end = Math.max(...present.map((r) => r.offset + r.limit));\n  return { ...newest, files, offset: start, limit: end - start, expires: Math.min(...present.map((r) => r.expires)) };\n}\n\n/** An upload the worker has not finished: staged, or with work pending, and not failed. */\nexport const isProcessing = (f: FileInfo) => !!f.upload && !f.failed && (!!f.staged || (f.pending?.length ?? 0) > 0);\n\n/** An editor read with uploads still processing (not stalled because the item is full). */\nexport function processing(read: ReadResult | null | undefined): boolean {\n  if (!read || read.full) return false;\n  return read.state === \"processing\" || read.files.some(isProcessing);\n}\n"],"mappings":";AAGA,IAAa,IAAa;AAG1B,SAAgB,EAAa,GAAe,GAAa,GAAgB,IAAA,IAA8B;CACrG,IAAM,IAAgB,CAAC,GACjB,IAAO,MAAU,KAAA,IAAY,IAAM,KAAK,IAAI,GAAK,CAAK;CAC5D,IAAI,KAAS,GAAM,OAAO;CAC1B,KAAK,IAAI,IAAI,KAAK,MAAM,KAAK,IAAI,GAAO,CAAC,IAAI,CAAK,IAAI,GAAO,IAAI,GAAM,KAAK,GAAO,EAAI,KAAK,CAAC;CAC7F,OAAO;AACT;AAOA,SAAgB,EAAW,GAAsE;CAC/F,IAAM,IAAU,EAAM,QAAQ,MAAuB,CAAC,CAAC,CAAC;CACxD,IAAI,EAAQ,WAAW,GAAG,OAAO;CACjC,IAAI,EAAQ,WAAW,GAAG,OAAO,EAAQ;CACzC,IAAM,IAAS,EAAQ,QAAQ,GAAG,MAAO,EAAE,WAAW,EAAE,UAAU,IAAI,CAAE,GAClE,oBAAO,IAAI,IAAsB;CACvC,KAAK,IAAM,KAAK,CAAC,GAAG,CAAO,CAAC,CAAC,MAAM,GAAG,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,KAAK,IAAM,KAAK,EAAE,OAAO,AAAI,EAAE,OAAK,EAAK,IAAI,EAAE,MAAM,CAAC;CAC1H,IAAM,IAAQ,EAAO,MAAM,KAAK,MAAM;EACpC,IAAI,EAAE,OAAO,EAAE,QAAQ,OAAO;EAC9B,IAAM,IAAS,EAAK,IAAI,EAAE,IAAI;EAC9B,OAAO,IAAS;GAAE,GAAG;GAAG,KAAK,EAAO;GAAK,GAAI,EAAO,WAAW,EAAE,UAAU,EAAO,SAAS,IAAI,CAAC;EAAG,IAAI;CACzG,CAAC,GACK,IAAQ,KAAK,IAAI,GAAG,EAAQ,KAAK,MAAM,EAAE,MAAM,CAAC,GAChD,IAAM,KAAK,IAAI,GAAG,EAAQ,KAAK,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC;CAC9D,OAAO;EAAE,GAAG;EAAQ;EAAO,QAAQ;EAAO,OAAO,IAAM;EAAO,SAAS,KAAK,IAAI,GAAG,EAAQ,KAAK,MAAM,EAAE,OAAO,CAAC;CAAE;AACpH;AAGA,IAAa,KAAgB,MAAgB,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,WAAW,CAAC,CAAC,EAAE,WAAW,EAAE,SAAS,UAAU,KAAK;AAGlH,SAAgB,EAAW,GAA8C;CAEvE,OADI,CAAC,KAAQ,EAAK,OAAa,KACxB,EAAK,UAAU,gBAAgB,EAAK,MAAM,KAAK,CAAY;AACpE"}
+{"version":3,"file":"windows.js","names":[],"sources":["../../../src/client/media/windows.ts"],"sourcesContent":["import type { FileInfo, ReadResult } from \"../generated/wire.js\";\n\n/** Files per window when a read is split into windows. */\nexport const READ_CHUNK = 50;\n\n/** Offsets of chunk-sized windows covering files [start, end), clipped to total when known. */\nexport function chunkOffsets(start: number, end: number, total?: number, chunk = READ_CHUNK): number[] {\n  const out: number[] = [];\n  const stop = total === undefined ? end : Math.min(end, total);\n  if (start >= stop) return out;\n  for (let o = Math.floor(Math.max(start, 0) / chunk) * chunk; o < stop; o += chunk) out.push(o);\n  return out;\n}\n\n/**\n * One item's window reads as one read: the newest window's listing and\n * metadata, each file's URL from the newest window that signed it, and the\n * earliest expiry. Every window lists every file; only its range has URLs.\n */\nexport function mergeReads(reads: readonly (ReadResult | null | undefined)[]): ReadResult | null {\n  const present = reads.filter((r): r is ReadResult => !!r);\n  if (present.length === 0) return null;\n  if (present.length === 1) return present[0]!;\n  const newest = present.reduce((a, b) => (b.expires >= a.expires ? b : a));\n  const urls = new Map<string, FileInfo>();\n  for (const r of [...present].sort((a, b) => a.expires - b.expires)) for (const f of r.files) if (f.url) urls.set(f.path, f);\n  const files = newest.files.map((f) => {\n    if (f.url) return f;\n    const signed = urls.get(f.path);\n    return signed ? { ...f, url: signed.url, ...(signed.download ? { download: signed.download } : {}) } : f;\n  });\n  const start = Math.min(...present.map((r) => r.offset));\n  const end = Math.max(...present.map((r) => r.offset + r.limit));\n  return { ...newest, files, offset: start, limit: end - start, expires: Math.min(...present.map((r) => r.expires)) };\n}\n\n/** An upload the worker has not finished: staged, or with work pending, and not failed. */\nexport const isProcessing = (f: FileInfo) => !!f.upload && !f.failed && (!!f.staged || (f.pending?.length ?? 0) > 0);\n\n/** An editor read with uploads still processing (not stalled because the item is full). */\nexport function processing(read: ReadResult | null | undefined): boolean {\n  if (!read || read.full) return false;\n  return read.state === \"processing\" || read.files.some(isProcessing);\n}\n"],"mappings":";AAGA,IAAa,IAAa;AAG1B,SAAgB,EAAa,GAAe,GAAa,GAAgB,IAAA,IAA8B;CACrG,IAAM,IAAgB,CAAC,GACjB,IAAO,MAAU,KAAA,IAAY,IAAM,KAAK,IAAI,GAAK,CAAK;CAC5D,IAAI,KAAS,GAAM,OAAO;CAC1B,KAAK,IAAI,IAAI,KAAK,MAAM,KAAK,IAAI,GAAO,CAAC,IAAI,CAAK,IAAI,GAAO,IAAI,GAAM,KAAK,GAAO,EAAI,KAAK,CAAC;CAC7F,OAAO;AACT;AAOA,SAAgB,EAAW,GAAsE;CAC/F,IAAM,IAAU,EAAM,QAAQ,MAAuB,CAAC,CAAC,CAAC;CACxD,IAAI,EAAQ,WAAW,GAAG,OAAO;CACjC,IAAI,EAAQ,WAAW,GAAG,OAAO,EAAQ;CACzC,IAAM,IAAS,EAAQ,QAAQ,GAAG,MAAO,EAAE,WAAW,EAAE,UAAU,IAAI,CAAE,GAClE,oBAAO,IAAI,IAAsB;CACvC,KAAK,IAAM,KAAK,CAAC,GAAG,CAAO,CAAC,CAAC,MAAM,GAAG,MAAM,EAAE,UAAU,EAAE,OAAO,GAAG,KAAK,IAAM,KAAK,EAAE,OAAO,AAAI,EAAE,OAAK,EAAK,IAAI,EAAE,MAAM,CAAC;CAC1H,IAAM,IAAQ,EAAO,MAAM,KAAK,MAAM;EACpC,IAAI,EAAE,KAAK,OAAO;EAClB,IAAM,IAAS,EAAK,IAAI,EAAE,IAAI;EAC9B,OAAO,IAAS;GAAE,GAAG;GAAG,KAAK,EAAO;GAAK,GAAI,EAAO,WAAW,EAAE,UAAU,EAAO,SAAS,IAAI,CAAC;EAAG,IAAI;CACzG,CAAC,GACK,IAAQ,KAAK,IAAI,GAAG,EAAQ,KAAK,MAAM,EAAE,MAAM,CAAC,GAChD,IAAM,KAAK,IAAI,GAAG,EAAQ,KAAK,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC;CAC9D,OAAO;EAAE,GAAG;EAAQ;EAAO,QAAQ;EAAO,OAAO,IAAM;EAAO,SAAS,KAAK,IAAI,GAAG,EAAQ,KAAK,MAAM,EAAE,OAAO,CAAC;CAAE;AACpH;AAGA,IAAa,KAAgB,MAAgB,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,WAAW,CAAC,CAAC,EAAE,WAAW,EAAE,SAAS,UAAU,KAAK;AAGlH,SAAgB,EAAW,GAA8C;CAEvE,OADI,CAAC,KAAQ,EAAK,OAAa,KACxB,EAAK,UAAU,gBAAgB,EAAK,MAAM,KAAK,CAAY;AACpE"}

package/dist/client/public.d.ts

@@ -1,10 +1,10 @@
 import { AspectRatio } from './aspect.js';
 import { Rendition } from './rendition.js';
 /**
- * A public file's URL, as media.PublicURL: `{base}/v1/{namespace}/{kind}/{id}/public/{name}`.
+ * A public file's URL, as media.PublicURL: `{base}/v1/{namespace}/{kind}/{id}[/{version}]/public/{name}`.
  * Pass an actual published name, not a preset template for a current image.
  */
-export declare function publicURL(base: string, namespace: string, kind: string, id: string, name: string): string;
+export declare function publicURL(base: string, namespace: string, kind: string, id: string, name: string, version?: string): string;
 /** Each `{key}` of template replaced by vars[key] ("" when missing), as the registry's templates fill. */
 export declare function fill(template: string, vars: Record<string, string | number>): string;
 /** A srcset from published URLs and their actual encoded widths. */

package/dist/client/public.js

@@ -1,7 +1,7 @@
 import { sortRenditions as e } from "./rendition.js";
 //#region src/client/public.ts
-function t(e, t, n, r, i) {
-	return `${e.replace(/\/+$/, "")}/v1/${t}/${n}/${r}/public/${i}`;
+function t(e, t, n, r, i, a) {
+	return `${e.replace(/\/+$/, "")}/v1/${t}/${n}/${r}${a ? `/${a}` : ""}/public/${i}`;
 }
 function n(e, t) {
 	return e.replace(/\{([^}]*)\}/g, (e, n) => n in t ? String(t[n]) : "");

package/dist/client/public.js.map

@@ -1 +1 @@
-{"version":3,"file":"public.js","names":[],"sources":["../../src/client/public.ts"],"sourcesContent":["import type { AspectRatio } from \"./aspect.js\";\nimport { sortRenditions, type Rendition } from \"./rendition.js\";\n\n/**\n * A public file's URL, as media.PublicURL: `{base}/v1/{namespace}/{kind}/{id}/public/{name}`.\n * Pass an actual published name, not a preset template for a current image.\n */\nexport function publicURL(base: string, namespace: string, kind: string, id: string, name: string): string {\n  return `${base.replace(/\\/+$/, \"\")}/v1/${namespace}/${kind}/${id}/public/${name}`;\n}\n\n/** Each `{key}` of template replaced by vars[key] (\"\" when missing), as the registry's templates fill. */\nexport function fill(template: string, vars: Record<string, string | number>): string {\n  return template.replace(/\\{([^}]*)\\}/g, (_, k: string) => (k in vars ? String(vars[k]) : \"\"));\n}\n\n/** A srcset from published URLs and their actual encoded widths. */\nexport function srcSet(renditions: readonly Rendition[]): string {\n  return sortRenditions(renditions)\n    .filter((r, i, all) => i === 0 || r.w !== all[i - 1]!.w)\n    .map((r) => `${r.url} ${r.w}w`).join(\", \");\n}\n\n/**\n * A public preset at an item: what a slot or poster shows, with its current\n * renditions (from a read's `public`, or a host's authorized listing).\n */\nexport interface PublicPreset {\n  preset: string;\n  renditions: readonly Rendition[];\n  /** The preset's \"W:H\"; \"\" or omitted is the source's own. */\n  aspect?: AspectRatio;\n}\n\n/** Published files, narrowest first; sizes and filenames are never inferred. */\nexport function publicRenditions(p: PublicPreset | { renditions: readonly Rendition[] } | null | undefined): Rendition[] {\n  if (!p) return [];\n  return sortRenditions(p.renditions);\n}\n"],"mappings":";;AAOA,SAAgB,EAAU,GAAc,GAAmB,GAAc,GAAY,GAAsB;CACzG,OAAO,GAAG,EAAK,QAAQ,QAAQ,EAAE,EAAE,MAAM,EAAU,GAAG,EAAK,GAAG,EAAG,UAAU;AAC7E;AAGA,SAAgB,EAAK,GAAkB,GAA+C;CACpF,OAAO,EAAS,QAAQ,iBAAiB,GAAG,MAAe,KAAK,IAAO,OAAO,EAAK,EAAE,IAAI,EAAG;AAC9F;AAGA,SAAgB,EAAO,GAA0C;CAC/D,OAAO,EAAe,CAAU,CAAC,CAC9B,QAAQ,GAAG,GAAG,MAAQ,MAAM,KAAK,EAAE,MAAM,EAAI,IAAI,EAAE,CAAE,CAAC,CAAC,CACvD,KAAK,MAAM,GAAG,EAAE,IAAI,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI;AAC7C;AAcA,SAAgB,EAAiB,GAAwF;CAEvH,OADK,IACE,EAAe,EAAE,UAAU,IADnB,CAAC;AAElB"}
+{"version":3,"file":"public.js","names":[],"sources":["../../src/client/public.ts"],"sourcesContent":["import type { AspectRatio } from \"./aspect.js\";\nimport { sortRenditions, type Rendition } from \"./rendition.js\";\n\n/**\n * A public file's URL, as media.PublicURL: `{base}/v1/{namespace}/{kind}/{id}[/{version}]/public/{name}`.\n * Pass an actual published name, not a preset template for a current image.\n */\nexport function publicURL(base: string, namespace: string, kind: string, id: string, name: string, version?: string): string {\n  return `${base.replace(/\\/+$/, \"\")}/v1/${namespace}/${kind}/${id}${version ? `/${version}` : \"\"}/public/${name}`;\n}\n\n/** Each `{key}` of template replaced by vars[key] (\"\" when missing), as the registry's templates fill. */\nexport function fill(template: string, vars: Record<string, string | number>): string {\n  return template.replace(/\\{([^}]*)\\}/g, (_, k: string) => (k in vars ? String(vars[k]) : \"\"));\n}\n\n/** A srcset from published URLs and their actual encoded widths. */\nexport function srcSet(renditions: readonly Rendition[]): string {\n  return sortRenditions(renditions)\n    .filter((r, i, all) => i === 0 || r.w !== all[i - 1]!.w)\n    .map((r) => `${r.url} ${r.w}w`).join(\", \");\n}\n\n/**\n * A public preset at an item: what a slot or poster shows, with its current\n * renditions (from a read's `public`, or a host's authorized listing).\n */\nexport interface PublicPreset {\n  preset: string;\n  renditions: readonly Rendition[];\n  /** The preset's \"W:H\"; \"\" or omitted is the source's own. */\n  aspect?: AspectRatio;\n}\n\n/** Published files, narrowest first; sizes and filenames are never inferred. */\nexport function publicRenditions(p: PublicPreset | { renditions: readonly Rendition[] } | null | undefined): Rendition[] {\n  if (!p) return [];\n  return sortRenditions(p.renditions);\n}\n"],"mappings":";;AAOA,SAAgB,EAAU,GAAc,GAAmB,GAAc,GAAY,GAAc,GAA0B;CAC3H,OAAO,GAAG,EAAK,QAAQ,QAAQ,EAAE,EAAE,MAAM,EAAU,GAAG,EAAK,GAAG,IAAK,IAAU,IAAI,MAAY,GAAG,UAAU;AAC5G;AAGA,SAAgB,EAAK,GAAkB,GAA+C;CACpF,OAAO,EAAS,QAAQ,iBAAiB,GAAG,MAAe,KAAK,IAAO,OAAO,EAAK,EAAE,IAAI,EAAG;AAC9F;AAGA,SAAgB,EAAO,GAA0C;CAC/D,OAAO,EAAe,CAAU,CAAC,CAC9B,QAAQ,GAAG,GAAG,MAAQ,MAAM,KAAK,EAAE,MAAM,EAAI,IAAI,EAAE,CAAE,CAAC,CAAC,CACvD,KAAK,MAAM,GAAG,EAAE,IAAI,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,IAAI;AAC7C;AAcA,SAAgB,EAAiB,GAAwF;CAEvH,OADK,IACE,EAAe,EAAE,UAAU,IADnB,CAAC;AAElB"}

package/dist/client/versions.d.ts

@@ -1,4 +1,4 @@
-import { ForkBody, Pending, ReaderMeta, ReaderPlan } from './generated/wire.js';
+import { FileDownload, ForkBody, Pending, ReaderMeta, ReaderPlan } from './generated/wire.js';
 import { Http } from './http.js';
 /** A version's answer while it is prepared (202). */
 export declare const isPending: (x: unknown) => x is Pending;
@@ -13,8 +13,10 @@ export declare class VersionsClient {
     /** Editors: fills a version without media from a sibling, in a durable job. */
     fork(content: string, version: string, body: ForkBody): Promise<Pending>;
     /**
-     * The version's pages as a zip, charged to the viewer's download quota;
-     * Pending while it is prepared (ask again).
+     * Grants the version's download, what its kind serves (the original, a
+     * rendition, its pages as a zip), charged to the viewer's download quota:
+     * `url` (absolute) serves it as an attachment until `expires_at`. Pending
+     * while it is prepared (ask again).
      */
-    download(content: string, version: string, signal?: AbortSignal): Promise<Blob | Pending>;
+    download(content: string, version: string, signal?: AbortSignal): Promise<FileDownload | Pending>;
 }

package/dist/client/versions.js

@@ -1,58 +1,56 @@
-import { ContentKitError as e } from "./errors.js";
-import { call as t, routeURL as n } from "./route.js";
+import { call as e, routeURL as t } from "./route.js";
 //#region src/client/versions.ts
-var r = (e) => !!e && typeof e == "object" && "status" in e && !("pages" in e), i = class {
+var n = (e) => !!e && typeof e == "object" && "status" in e && !("pages" in e) && !("url" in e), r = class {
 	http;
 	constructor(e) {
 		this.http = e;
 	}
-	reader(e, n, r) {
-		return t(this.http, "GET", "/contents/{id}/versions/{version}/reader", {
+	reader(t, n, r) {
+		return e(this.http, "GET", "/contents/{id}/versions/{version}/reader", {
 			params: {
-				id: e,
+				id: t,
 				version: n
 			},
 			signal: r
 		});
 	}
-	async setReader(e, n, r) {
+	async setReader(t, n, r) {
 		let i = this.http.captureChanges();
-		await t(this.http, "PUT", "/contents/{id}/versions/{version}/reader", {
+		await e(this.http, "PUT", "/contents/{id}/versions/{version}/reader", {
 			params: {
-				id: e,
+				id: t,
 				version: n
 			},
 			body: r
 		}), i({
 			type: "reader.changed",
-			content: e,
+			content: t,
 			version: n
 		});
 	}
-	fork(e, n, r) {
-		return t(this.http, "POST", "/contents/{id}/versions/{version}/fork", {
+	fork(t, n, r) {
+		return e(this.http, "POST", "/contents/{id}/versions/{version}/fork", {
 			params: {
-				id: e,
+				id: t,
 				version: n
 			},
 			body: r
 		});
 	}
-	async download(t, i, a) {
-		let o = n(this.http, "GET", "/contents/{id}/versions/{version}/download", { params: {
-			id: t,
-			version: i
-		} }), s = await this.http.request(o, {
-			signal: a,
-			blob: !0
-		});
-		if (!s.type.startsWith("application/json")) return s;
-		let c = JSON.parse(await s.text());
-		if (r(c)) return c;
-		throw new e("internal_error", "unexpected download answer");
+	async download(e, r, i) {
+		let a = t(this.http, "GET", "/contents/{id}/versions/{version}/download", { params: {
+			id: e,
+			version: r
+		} }), o = await this.http.request(a, { signal: i });
+		if (n(o)) return o;
+		let s = new URL(a, globalThis.location?.href ?? "http://localhost/");
+		return {
+			...o,
+			url: new URL(o.url, s).toString()
+		};
 	}
 };
 //#endregion
-export { i as VersionsClient, r as isPending };
+export { r as VersionsClient, n as isPending };
 
 //# sourceMappingURL=versions.js.map

package/dist/client/versions.js.map

@@ -1 +1 @@
-{"version":3,"file":"versions.js","names":[],"sources":["../../src/client/versions.ts"],"sourcesContent":["import { ContentKitError } from \"./errors.js\";\nimport type { ForkBody, Pending, ReaderMeta, ReaderPlan } from \"./generated/wire.js\";\nimport type { Http } from \"./http.js\";\nimport { call, routeURL } from \"./route.js\";\n\n/** A version's answer while it is prepared (202). */\nexport const isPending = (x: unknown): x is Pending => !!x && typeof x === \"object\" && \"status\" in x && !(\"pages\" in x);\n\n/** Content versions: reader plans, reader metadata, forks and downloads. */\nexport class VersionsClient {\n  constructor(private readonly http: Http) {}\n\n  /** The version's reader plan for this viewer; Pending while it has no current publication. */\n  reader(content: string, version: string, signal?: AbortSignal): Promise<ReaderPlan | Pending> {\n    return call(this.http, \"GET\", \"/contents/{id}/versions/{version}/reader\", { params: { id: content, version }, signal });\n  }\n  /** Editors: replaces the version's reader metadata (anchors, audio cues, defaults). */\n  async setReader(content: string, version: string, meta: ReaderMeta): Promise<void> {\n    const emit = this.http.captureChanges();\n    await call(this.http, \"PUT\", \"/contents/{id}/versions/{version}/reader\", { params: { id: content, version }, body: meta });\n    emit({ type: \"reader.changed\", content, version });\n  }\n  /** Editors: fills a version without media from a sibling, in a durable job. */\n  fork(content: string, version: string, body: ForkBody): Promise<Pending> {\n    return call(this.http, \"POST\", \"/contents/{id}/versions/{version}/fork\", { params: { id: content, version }, body });\n  }\n  /**\n   * The version's pages as a zip, charged to the viewer's download quota;\n   * Pending while it is prepared (ask again).\n   */\n  async download(content: string, version: string, signal?: AbortSignal): Promise<Blob | Pending> {\n    const url = routeURL(this.http, \"GET\", \"/contents/{id}/versions/{version}/download\", { params: { id: content, version } });\n    const out = await this.http.request<Blob>(url, { signal, blob: true });\n    if (!out.type.startsWith(\"application/json\")) return out;\n    const body: unknown = JSON.parse(await out.text());\n    if (isPending(body)) return body;\n    throw new ContentKitError(\"internal_error\", \"unexpected download answer\");\n  }\n}\n"],"mappings":";;;AAMA,IAAa,KAAa,MAA6B,CAAC,CAAC,KAAK,OAAO,KAAM,YAAY,YAAY,KAAK,EAAE,WAAW,IAGxG,IAAb,MAA4B;CACG;CAA7B,YAAY,GAA6B;EAAZ,KAAA,OAAA;CAAa;CAG1C,OAAO,GAAiB,GAAiB,GAAqD;EAC5F,OAAO,EAAK,KAAK,MAAM,OAAO,4CAA4C;GAAE,QAAQ;IAAE,IAAI;IAAS;GAAQ;GAAG;EAAO,CAAC;CACxH;CAEA,MAAM,UAAU,GAAiB,GAAiB,GAAiC;EACjF,IAAM,IAAO,KAAK,KAAK,eAAe;EAEtC,AADA,MAAM,EAAK,KAAK,MAAM,OAAO,4CAA4C;GAAE,QAAQ;IAAE,IAAI;IAAS;GAAQ;GAAG,MAAM;EAAK,CAAC,GACzH,EAAK;GAAE,MAAM;GAAkB;GAAS;EAAQ,CAAC;CACnD;CAEA,KAAK,GAAiB,GAAiB,GAAkC;EACvE,OAAO,EAAK,KAAK,MAAM,QAAQ,0CAA0C;GAAE,QAAQ;IAAE,IAAI;IAAS;GAAQ;GAAG;EAAK,CAAC;CACrH;CAKA,MAAM,SAAS,GAAiB,GAAiB,GAA+C;EAC9F,IAAM,IAAM,EAAS,KAAK,MAAM,OAAO,8CAA8C,EAAE,QAAQ;GAAE,IAAI;GAAS;EAAQ,EAAE,CAAC,GACnH,IAAM,MAAM,KAAK,KAAK,QAAc,GAAK;GAAE;GAAQ,MAAM;EAAK,CAAC;EACrE,IAAI,CAAC,EAAI,KAAK,WAAW,kBAAkB,GAAG,OAAO;EACrD,IAAM,IAAgB,KAAK,MAAM,MAAM,EAAI,KAAK,CAAC;EACjD,IAAI,EAAU,CAAI,GAAG,OAAO;EAC5B,MAAM,IAAI,EAAgB,kBAAkB,4BAA4B;CAC1E;AACF"}
+{"version":3,"file":"versions.js","names":[],"sources":["../../src/client/versions.ts"],"sourcesContent":["import type { FileDownload, ForkBody, Pending, ReaderMeta, ReaderPlan } from \"./generated/wire.js\";\nimport type { Http } from \"./http.js\";\nimport { call, routeURL } from \"./route.js\";\n\n/** A version's answer while it is prepared (202). */\nexport const isPending = (x: unknown): x is Pending => !!x && typeof x === \"object\" && \"status\" in x && !(\"pages\" in x) && !(\"url\" in x);\n\n/** Content versions: reader plans, reader metadata, forks and downloads. */\nexport class VersionsClient {\n  constructor(private readonly http: Http) {}\n\n  /** The version's reader plan for this viewer; Pending while it has no current publication. */\n  reader(content: string, version: string, signal?: AbortSignal): Promise<ReaderPlan | Pending> {\n    return call(this.http, \"GET\", \"/contents/{id}/versions/{version}/reader\", { params: { id: content, version }, signal });\n  }\n  /** Editors: replaces the version's reader metadata (anchors, audio cues, defaults). */\n  async setReader(content: string, version: string, meta: ReaderMeta): Promise<void> {\n    const emit = this.http.captureChanges();\n    await call(this.http, \"PUT\", \"/contents/{id}/versions/{version}/reader\", { params: { id: content, version }, body: meta });\n    emit({ type: \"reader.changed\", content, version });\n  }\n  /** Editors: fills a version without media from a sibling, in a durable job. */\n  fork(content: string, version: string, body: ForkBody): Promise<Pending> {\n    return call(this.http, \"POST\", \"/contents/{id}/versions/{version}/fork\", { params: { id: content, version }, body });\n  }\n  /**\n   * Grants the version's download, what its kind serves (the original, a\n   * rendition, its pages as a zip), charged to the viewer's download quota:\n   * `url` (absolute) serves it as an attachment until `expires_at`. Pending\n   * while it is prepared (ask again).\n   */\n  async download(content: string, version: string, signal?: AbortSignal): Promise<FileDownload | Pending> {\n    const url = routeURL(this.http, \"GET\", \"/contents/{id}/versions/{version}/download\", { params: { id: content, version } });\n    const out = await this.http.request<FileDownload | Pending>(url, { signal });\n    if (isPending(out)) return out;\n    // A marked zip's URL is the archive route's, relative to this one.\n    const base = new URL(url, globalThis.location?.href ?? \"http://localhost/\");\n    return { ...out, url: new URL(out.url, base).toString() };\n  }\n}\n"],"mappings":";;AAKA,IAAa,KAAa,MAA6B,CAAC,CAAC,KAAK,OAAO,KAAM,YAAY,YAAY,KAAK,EAAE,WAAW,MAAM,EAAE,SAAS,IAGzH,IAAb,MAA4B;CACG;CAA7B,YAAY,GAA6B;EAAZ,KAAA,OAAA;CAAa;CAG1C,OAAO,GAAiB,GAAiB,GAAqD;EAC5F,OAAO,EAAK,KAAK,MAAM,OAAO,4CAA4C;GAAE,QAAQ;IAAE,IAAI;IAAS;GAAQ;GAAG;EAAO,CAAC;CACxH;CAEA,MAAM,UAAU,GAAiB,GAAiB,GAAiC;EACjF,IAAM,IAAO,KAAK,KAAK,eAAe;EAEtC,AADA,MAAM,EAAK,KAAK,MAAM,OAAO,4CAA4C;GAAE,QAAQ;IAAE,IAAI;IAAS;GAAQ;GAAG,MAAM;EAAK,CAAC,GACzH,EAAK;GAAE,MAAM;GAAkB;GAAS;EAAQ,CAAC;CACnD;CAEA,KAAK,GAAiB,GAAiB,GAAkC;EACvE,OAAO,EAAK,KAAK,MAAM,QAAQ,0CAA0C;GAAE,QAAQ;IAAE,IAAI;IAAS;GAAQ;GAAG;EAAK,CAAC;CACrH;CAOA,MAAM,SAAS,GAAiB,GAAiB,GAAuD;EACtG,IAAM,IAAM,EAAS,KAAK,MAAM,OAAO,8CAA8C,EAAE,QAAQ;GAAE,IAAI;GAAS;EAAQ,EAAE,CAAC,GACnH,IAAM,MAAM,KAAK,KAAK,QAAgC,GAAK,EAAE,UAAO,CAAC;EAC3E,IAAI,EAAU,CAAG,GAAG,OAAO;EAE3B,IAAM,IAAO,IAAI,IAAI,GAAK,WAAW,UAAU,QAAQ,mBAAmB;EAC1E,OAAO;GAAE,GAAG;GAAK,KAAK,IAAI,IAAI,EAAI,KAAK,CAAI,CAAC,CAAC,SAAS;EAAE;CAC1D;AACF"}