@openrails/contentkit-ui 0.0.0-stage → 0.68.1

package/dist/client/media/queue.js

@@ -0,0 +1,274 @@
+import { ContentKitError as e, toContentKitError as t } from "../errors.js";
+import { fill as n } from "../public.js";
+import { samePath as r, stem as i } from "./client.js";
+//#region src/client/media/queue.ts
+var a = 2 ** 31 - 1, o = class {
+	client;
+	o;
+	items = [];
+	blocked;
+	running = /* @__PURE__ */ new Map();
+	listeners = /* @__PURE__ */ new Set();
+	snap;
+	started;
+	staging = /* @__PURE__ */ new Map();
+	poll;
+	disposed = !1;
+	batch;
+	constructor(e, t) {
+		this.client = e, this.o = t, this.started = t.autoStart ?? !0, this.publish();
+	}
+	subscribe = (e) => (this.listeners.add(e), () => this.listeners.delete(e));
+	getSnapshot = () => this.snap;
+	add(e, t = {}) {
+		let r = [...e].map((e) => ({
+			id: crypto.randomUUID(),
+			file: e,
+			path: t.path?.(e) ?? n(this.o.path, { name: e.name }),
+			status: "queued",
+			state: t.state?.(e)
+		}));
+		return this.items.push(...r), this.changed(), r;
+	}
+	move(e, t) {
+		let n = this.items.findIndex((t) => t.id === e);
+		if (n < 0) return;
+		let [r] = this.items.splice(n, 1);
+		this.items.splice(Math.max(0, Math.min(t, this.items.length)), 0, r), this.changed();
+	}
+	update(e, t) {
+		let n = this.find(e);
+		n?.unattached && t.path && t.path !== n.path && this.client.commit(this.o.ref, [{
+			op: "rename",
+			path: n.path,
+			to: t.path
+		}]).then((n) => {
+			let a = n.find((e) => r(e.path, i(t.path)));
+			a && this.patch(e, { path: a.path });
+		}, () => {}), this.patch(e, t);
+	}
+	remove(e) {
+		let t = this.find(e);
+		if (!t) return;
+		this.running.get(e)?.abort(), t.state && this.client.discard(t.state).catch(() => {});
+		let n = this.staging.get(e);
+		(t.unattached || n) && (n ?? Promise.resolve()).then((e) => {
+			if (e || t.unattached) return this.client.commit(this.o.ref, [{
+				op: "remove",
+				path: e?.path ?? t.path
+			}]);
+		}).catch(() => {}), this.o.onState?.(t, null), this.items = this.items.filter((t) => t.id !== e), this.changed();
+	}
+	retry(e) {
+		this.patch(e, {
+			status: "queued",
+			error: void 0
+		});
+	}
+	start() {
+		this.started = !0, this.blocked = void 0, this.changed();
+	}
+	pause() {
+		this.started = !1;
+		for (let e of this.running.values()) e.abort();
+		this.changed();
+	}
+	async commit(e, t = {}) {
+		await Promise.all(this.staging.values());
+		let n = this.items;
+		if (t.head) {
+			let e = n.findIndex((e) => e.status !== "uploaded" && e.status !== "committed");
+			e >= 0 && (n = n.slice(0, e));
+		}
+		let r = n.filter((e) => e.status === "uploaded");
+		if (r.length === 0) return [];
+		let i = r.flatMap((e) => {
+			let t = {
+				op: "attach",
+				path: e.path,
+				index: a,
+				...e.meta ? { meta: e.meta } : {}
+			};
+			if (e.unattached) return [t];
+			let n = {
+				op: "put",
+				path: e.path,
+				blob: e.result.blob,
+				create_id: e.id,
+				index: a,
+				...e.meta ? { meta: e.meta } : {}
+			};
+			return e.result.processOnUpload ? [n, t] : [n];
+		}), o = Object.fromEntries(r.map((e) => [e.result.blob, {
+			file: e.file,
+			type: e.result.type
+		}])), s = JSON.stringify(i);
+		this.batch?.input !== s && (this.batch = {
+			input: s,
+			operationID: crypto.randomUUID()
+		});
+		let c = this.batch, l = await this.client.commit(this.o.ref, i, {
+			signal: e,
+			sources: o,
+			operationID: c.operationID,
+			onState: (e) => {
+				c.input = JSON.stringify(e.ops), c.operationID = e.operation_id;
+				let t = !1;
+				for (let n of e.ops) {
+					if (n.op !== "put" || !n.blob) continue;
+					let e = r.find((e) => e.id === n.create_id);
+					if (!e?.result) continue;
+					let i = this.find(e.id);
+					i?.result && i.result.blob === e.result.blob && i.result.blob !== n.blob && (t = this.set(i.id, { result: {
+						...i.result,
+						blob: n.blob
+					} }) || t);
+				}
+				t && this.changed();
+			}
+		});
+		for (let e of r) this.set(e.id, {
+			status: "committed",
+			unattached: !1
+		});
+		return this.changed(), l.filter((e) => !e.unattached);
+	}
+	dispose() {
+		this.started = !1, this.disposed = !0;
+		for (let e of this.running.values()) e.abort();
+		clearTimeout(this.poll), this.listeners.clear();
+	}
+	stage(t) {
+		let n = this.find(t);
+		if (!n?.result) return;
+		let { blob: a, type: o } = n.result, s = {
+			op: "put",
+			path: n.path,
+			blob: a,
+			create_id: n.id,
+			unattached: !0,
+			...n.meta ? { meta: n.meta } : {}
+		}, c = this.client.commit(this.o.ref, [s], { sources: { [a]: {
+			file: n.file,
+			type: o
+		} } }).then((e) => {
+			let a = e.find((e) => e.unattached && r(e.path, i(n.path)));
+			return a && this.find(t) && this.patch(t, {
+				unattached: !0,
+				path: a.path
+			}), this.schedulePoll(), a;
+		}, (n) => {
+			n instanceof e && n.code === "conflict" && this.patch(t, {
+				status: "failed",
+				error: n
+			});
+		}).finally(() => this.staging.delete(t));
+		this.staging.set(t, c);
+	}
+	schedulePoll() {
+		this.poll || this.disposed || (this.poll = setTimeout(() => {
+			this.poll = void 0, this.refresh().finally(() => {
+				this.items.some((e) => e.unattached && !e.processed) && this.schedulePoll();
+			});
+		}, this.o.pollInterval ?? 2e3));
+	}
+	async refresh() {
+		let e = this.items.filter((e) => e.unattached && !e.processed);
+		if (e.length === 0) return;
+		let t;
+		try {
+			t = (await this.client.read(this.o.ref, { editor: !0 })).files;
+		} catch {
+			return;
+		}
+		let n = new Map(t.filter((e) => e.upload).map((e) => [e.path, e])), r = !1;
+		for (let t of e) {
+			let e = n.get(t.path);
+			e && (r = this.set(t.id, {
+				processing: e,
+				processed: !!e.failed || !e.pending?.length && !e.staged
+			}) || r);
+		}
+		r && this.changed();
+	}
+	find(e) {
+		return this.items.find((t) => t.id === e);
+	}
+	patch(e, t) {
+		this.set(e, t) && this.changed();
+	}
+	set(e, t) {
+		let n = this.items.findIndex((t) => t.id === e);
+		return n >= 0 && (this.items[n] = {
+			...this.items[n],
+			...t
+		}), n >= 0;
+	}
+	changed() {
+		this.pump(), this.publish();
+		for (let e of this.listeners) e();
+	}
+	publish() {
+		this.snap = {
+			items: [...this.items],
+			blocked: this.blocked,
+			ready: this.running.size === 0 && this.items.length > 0 && this.items.every((e) => e.status === "uploaded" || e.status === "committed")
+		};
+	}
+	pump() {
+		if (!this.started || this.blocked) return;
+		let e = this.o.concurrency ?? 2;
+		for (let t of this.items) {
+			if (this.running.size >= e) return;
+			t.status === "queued" && !this.running.has(t.id) && this.run(t.id);
+		}
+	}
+	run(e) {
+		let n = this.find(e), r = new AbortController();
+		this.running.set(e, r), this.set(e, {
+			status: "uploading",
+			progress: void 0,
+			error: void 0
+		}), this.client.upload(n.file, {
+			ref: this.o.ref,
+			path: n.path,
+			signal: r.signal,
+			resume: n.state,
+			onProgress: (t) => this.patch(e, { progress: t }),
+			onState: (t) => {
+				this.patch(e, { state: t ?? void 0 });
+				let n = this.find(e);
+				n && this.o.onState?.(n, t);
+			}
+		}).then((t) => {
+			this.running.delete(e), this.patch(e, {
+				status: "uploaded",
+				result: t,
+				path: t.path,
+				state: void 0
+			}), t.processOnUpload && this.stage(e);
+		}, (n) => {
+			this.running.delete(e);
+			let r = t(n);
+			if (r.code === "aborted") {
+				this.patch(e, { status: "queued" });
+				return;
+			}
+			if (r.blocksQueue) {
+				this.blocked = r, this.patch(e, {
+					status: "queued",
+					error: r
+				});
+				return;
+			}
+			this.patch(e, {
+				status: "failed",
+				error: r
+			});
+		});
+	}
+};
+//#endregion
+export { o as UploadQueue };
+
+//# sourceMappingURL=queue.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"queue.js","names":[],"sources":["../../../src/client/media/queue.ts"],"sourcesContent":["import { ContentKitError, toContentKitError } from \"../errors.js\";\nimport type { FileInfo, Op, RefBody } from \"../generated/wire.js\";\nimport { fill } from \"../public.js\";\nimport { samePath, stem, type MediaClient, type Progress, type UploadedFile, type UploadState } from \"./client.js\";\n\nexport type ItemStatus = \"queued\" | \"uploading\" | \"uploaded\" | \"failed\" | \"committed\";\n\nexport interface QueueItem {\n  readonly id: string;\n  readonly file: File;\n  /** The upload path the commit puts; the server's canonical one once uploaded. */\n  path: string;\n  meta?: Record<string, unknown>;\n  status: ItemStatus;\n  progress?: Progress;\n  error?: ContentKitError;\n  result?: UploadedFile;\n  /** Resumable multipart state while uploading or after a failure. */\n  state?: UploadState;\n  /**\n   * Committed unattached for processing on upload (the host's\n   * ProcessOnUpload): commit() attaches it, remove() discards it.\n   */\n  unattached?: boolean;\n  /** The server's view of an unattached upload while it processes (editor read): dims, pending, failed, progress. */\n  processing?: FileInfo;\n  /** Processing finished (placed and outputs written, or failed). */\n  processed?: boolean;\n}\n\nexport interface QueueSnapshot {\n  readonly items: readonly QueueItem[];\n  /** A rate, quota or permission refusal: no new uploads start until start(). */\n  readonly blocked?: ContentKitError;\n  /** Every item is uploaded (or committed) and none is in flight. */\n  readonly ready: boolean;\n}\n\nexport interface QueueOptions {\n  ref: RefBody;\n  /** Each file's upload path: a template whose {name} is the file's name, e.g. \"originals/{name}\". */\n  path: string;\n  /** Files uploading at once. Default 2. */\n  concurrency?: number;\n  /** Start uploads as files are added. Default true. */\n  autoStart?: boolean;\n  /** Called with every item state change, to persist resumable state. */\n  onState?: (item: QueueItem, state: UploadState | null) => void;\n  /** Milliseconds between processing polls of unattached uploads. Default 2000. */\n  pollInterval?: number;\n}\n\n/** An op index past the end of the list: the upload is appended. */\nconst END = 2 ** 31 - 1;\n\n/**\n * An ordered file queue for one item: uploads in the background, keeps the\n * order the user arranges, and commits the uploads as puts appended in that\n * order. Framework-free; the React hooks wrap it.\n */\nexport class UploadQueue {\n  private items: QueueItem[] = [];\n  private blocked?: ContentKitError;\n  private running = new Map<string, AbortController>();\n  private listeners = new Set<() => void>();\n  private snap!: QueueSnapshot;\n  private started: boolean;\n  /** In-flight unattached commits, by item id. */\n  private staging = new Map<string, Promise<FileInfo | undefined>>();\n  private poll?: ReturnType<typeof setTimeout>;\n  private disposed = false;\n  private batch?: { input: string; operationID: string };\n\n  constructor(\n    private readonly client: MediaClient,\n    private readonly o: QueueOptions,\n  ) {\n    this.started = o.autoStart ?? true;\n    this.publish();\n  }\n\n  subscribe = (fn: () => void): (() => void) => {\n    this.listeners.add(fn);\n    return () => this.listeners.delete(fn);\n  };\n\n  getSnapshot = (): QueueSnapshot => this.snap;\n\n  /** Queues files; state restores a multipart upload saved through onState before a reload. */\n  add(\n    files: Iterable<File>,\n    opts: { path?: (f: File) => string; state?: (f: File) => UploadState | undefined } = {},\n  ): QueueItem[] {\n    const added = [...files].map(\n      (file): QueueItem => ({\n        id: crypto.randomUUID(),\n        file,\n        path: opts.path?.(file) ?? fill(this.o.path, { name: file.name }),\n        status: \"queued\",\n        state: opts.state?.(file),\n      }),\n    );\n    this.items.push(...added);\n    this.changed();\n    return added;\n  }\n\n  /** Moves an item to index (before commit). */\n  move(id: string, index: number): void {\n    const from = this.items.findIndex((i) => i.id === id);\n    if (from < 0) return;\n    const [item] = this.items.splice(from, 1);\n    this.items.splice(Math.max(0, Math.min(index, this.items.length)), 0, item!);\n    this.changed();\n  }\n\n  update(id: string, patch: Pick<Partial<QueueItem>, \"path\" | \"meta\">): void {\n    const item = this.find(id);\n    if (item?.unattached && patch.path && patch.path !== item.path) {\n      void this.client.commit(this.o.ref, [{ op: \"rename\", path: item.path, to: patch.path }]).then(\n        (files) => {\n          const f = files.find((x) => samePath(x.path, stem(patch.path!)));\n          if (f) this.patch(id, { path: f.path });\n        },\n        () => {},\n      );\n    }\n    this.patch(id, patch);\n  }\n\n  /**\n   * Removes an item, discarding its multipart upload if one is open, or its\n   * unattached upload (the commit removes it and its outputs).\n   */\n  remove(id: string): void {\n    const item = this.find(id);\n    if (!item) return;\n    this.running.get(id)?.abort();\n    if (item.state) void this.client.discard(item.state).catch(() => {});\n    const staged = this.staging.get(id);\n    if (item.unattached || staged) {\n      void (staged ?? Promise.resolve())\n        .then((file) => {\n          if (file || item.unattached) {\n            return this.client.commit(this.o.ref, [{ op: \"remove\", path: file?.path ?? item.path }]);\n          }\n        })\n        .catch(() => {});\n    }\n    this.o.onState?.(item, null);\n    this.items = this.items.filter((i) => i.id !== id);\n    this.changed();\n  }\n\n  /** Re-queues a failed item; a multipart upload resumes from its state. */\n  retry(id: string): void {\n    this.patch(id, { status: \"queued\", error: undefined });\n  }\n\n  /** Starts uploading (autoStart false) or lifts a block after a refusal. */\n  start(): void {\n    this.started = true;\n    this.blocked = undefined;\n    this.changed();\n  }\n\n  /** Stops starting uploads and pauses running ones (they stay resumable). */\n  pause(): void {\n    this.started = false;\n    for (const c of this.running.values()) c.abort();\n    this.changed();\n  }\n\n  /**\n   * Commits every uploaded item, in queue order, after the item's uploads:\n   * unattached ones are attached (no reprocessing), the rest put. With head,\n   * only the uploaded items before the first one still uploading or failed\n   * (a draft committing files as they finish). Returns the item's attached\n   * uploads in order.\n   */\n  async commit(signal?: AbortSignal, o: { head?: boolean } = {}): Promise<FileInfo[]> {\n    await Promise.all(this.staging.values());\n    let items = this.items;\n    if (o.head) {\n      // Only the uploaded head of the queue, so files land in the order added.\n      const end = items.findIndex((i) => i.status !== \"uploaded\" && i.status !== \"committed\");\n      if (end >= 0) items = items.slice(0, end);\n    }\n    const ready = items.filter((i) => i.status === \"uploaded\");\n    if (ready.length === 0) return [];\n    const ops = ready.flatMap((i): Op[] => {\n      const attach: Op = { op: \"attach\", path: i.path, index: END, ...(i.meta ? { meta: i.meta } : {}) };\n      if (i.unattached) return [attach];\n      const put: Op = { op: \"put\", path: i.path, blob: i.result!.blob, create_id: i.id, index: END, ...(i.meta ? { meta: i.meta } : {}) };\n      // A lost staging response may hide a successful unattached create.\n      return i.result!.processOnUpload ? [put, attach] : [put];\n    });\n    const sources = Object.fromEntries(ready.map((i) => [i.result!.blob, { file: i.file, type: i.result!.type }]));\n    const input = JSON.stringify(ops);\n    if (this.batch?.input !== input) this.batch = { input, operationID: crypto.randomUUID() };\n    const batch = this.batch;\n    const files = await this.client.commit(this.o.ref, ops, {\n      signal,\n      sources,\n      operationID: batch.operationID,\n      onState: (body) => {\n        batch.input = JSON.stringify(body.ops);\n        batch.operationID = body.operation_id;\n        let changed = false;\n        for (const op of body.ops) {\n          if (op.op !== \"put\" || !op.blob) continue;\n          const original = ready.find((i) => i.id === op.create_id);\n          if (!original?.result) continue;\n          const current = this.find(original.id);\n          if (current?.result && current.result.blob === original.result.blob && current.result.blob !== op.blob) {\n            changed = this.set(current.id, { result: { ...current.result, blob: op.blob } }) || changed;\n          }\n        }\n        if (changed) this.changed();\n      },\n    });\n    for (const i of ready) this.set(i.id, { status: \"committed\", unattached: false });\n    this.changed();\n    return files.filter((f) => !f.unattached);\n  }\n\n  /** Aborts running uploads and stops polling; call on unmount. */\n  dispose(): void {\n    this.started = false;\n    this.disposed = true;\n    for (const c of this.running.values()) c.abort();\n    clearTimeout(this.poll);\n    this.listeners.clear();\n  }\n\n  /** Commits an uploaded file unattached, so the host processes it now. */\n  private stage(id: string): void {\n    const item = this.find(id);\n    if (!item?.result) return;\n    const { blob, type } = item.result;\n    const op: Op = { op: \"put\", path: item.path, blob, create_id: item.id, unattached: true, ...(item.meta ? { meta: item.meta } : {}) };\n    const p = this.client\n      .commit(this.o.ref, [op], { sources: { [blob]: { file: item.file, type } } })\n      .then(\n        (files) => {\n          const f = files.find((x) => x.unattached && samePath(x.path, stem(item.path)));\n          if (f && this.find(id)) this.patch(id, { unattached: true, path: f.path });\n          this.schedulePoll();\n          return f;\n        },\n        (error: unknown) => {\n          if (error instanceof ContentKitError && error.code === \"conflict\") {\n            this.patch(id, { status: \"failed\", error });\n          }\n          // Other failures leave it uploaded; commit() retries the same create.\n          return undefined;\n        },\n      )\n      .finally(() => this.staging.delete(id));\n    this.staging.set(id, p);\n  }\n\n  private schedulePoll(): void {\n    if (this.poll || this.disposed) return;\n    this.poll = setTimeout(() => {\n      this.poll = undefined;\n      void this.refresh().finally(() => {\n        if (this.items.some((i) => i.unattached && !i.processed)) this.schedulePoll();\n      });\n    }, this.o.pollInterval ?? 2000);\n  }\n\n  /** Reads the processing state of unattached uploads still processing. */\n  private async refresh(): Promise<void> {\n    const pending = this.items.filter((i) => i.unattached && !i.processed);\n    if (pending.length === 0) return;\n    let files: FileInfo[];\n    try {\n      files = (await this.client.read(this.o.ref, { editor: true })).files;\n    } catch {\n      return;\n    }\n    const byPath = new Map(files.filter((f) => f.upload).map((f) => [f.path, f]));\n    let changed = false;\n    for (const i of pending) {\n      const f = byPath.get(i.path);\n      if (!f) continue;\n      changed = this.set(i.id, { processing: f, processed: !!f.failed || (!f.pending?.length && !f.staged) }) || changed;\n    }\n    if (changed) this.changed();\n  }\n\n  private find(id: string): QueueItem | undefined {\n    return this.items.find((i) => i.id === id);\n  }\n\n  private patch(id: string, patch: Partial<QueueItem>): void {\n    if (this.set(id, patch)) this.changed();\n  }\n\n  private set(id: string, patch: Partial<QueueItem>): boolean {\n    const i = this.items.findIndex((x) => x.id === id);\n    if (i >= 0) this.items[i] = { ...this.items[i]!, ...patch };\n    return i >= 0;\n  }\n\n  private changed(): void {\n    this.pump();\n    this.publish();\n    for (const fn of this.listeners) fn();\n  }\n\n  private publish(): void {\n    this.snap = {\n      items: [...this.items],\n      blocked: this.blocked,\n      ready:\n        this.running.size === 0 &&\n        this.items.length > 0 &&\n        this.items.every((i) => i.status === \"uploaded\" || i.status === \"committed\"),\n    };\n  }\n\n  private pump(): void {\n    if (!this.started || this.blocked) return;\n    const limit = this.o.concurrency ?? 2;\n    for (const item of this.items) {\n      if (this.running.size >= limit) return;\n      if (item.status === \"queued\" && !this.running.has(item.id)) this.run(item.id);\n    }\n  }\n\n  private run(id: string): void {\n    const item = this.find(id)!;\n    const ctl = new AbortController();\n    this.running.set(id, ctl);\n    this.set(id, { status: \"uploading\", progress: undefined, error: undefined });\n    this.client\n      .upload(item.file, {\n        ref: this.o.ref,\n        path: item.path,\n        signal: ctl.signal,\n        resume: item.state,\n        onProgress: (progress) => this.patch(id, { progress }),\n        onState: (state) => {\n          this.patch(id, { state: state ?? undefined });\n          const cur = this.find(id);\n          if (cur) this.o.onState?.(cur, state);\n        },\n      })\n      .then(\n        (result) => {\n          this.running.delete(id);\n          this.patch(id, { status: \"uploaded\", result, path: result.path, state: undefined });\n          if (result.processOnUpload) this.stage(id);\n        },\n        (e: unknown) => {\n          this.running.delete(id);\n          const error = toContentKitError(e);\n          if (error.code === \"aborted\") {\n            this.patch(id, { status: \"queued\" });\n            return;\n          }\n          if (error.blocksQueue) {\n            // Refused for every file: keep it queued behind the block.\n            this.blocked = error;\n            this.patch(id, { status: \"queued\", error });\n            return;\n          }\n          this.patch(id, { status: \"failed\", error });\n        },\n      );\n  }\n}\n"],"mappings":"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"}

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

@@ -0,0 +1,6 @@
+/** Content ids are canonical lowercase UUIDv7s (contentref.ValidateID). */
+export declare const isContentId: (id: string) => boolean;
+/** Refuses a ref whose id ContentKit would reject, before any request. */
+export declare function checkRef(ref: {
+    id: string;
+} | undefined): void;

package/dist/client/media/ref.js

@@ -0,0 +1,10 @@
+import { ContentKitError as e } from "../errors.js";
+//#region src/client/media/ref.ts
+var t = /^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/, n = (e) => t.test(e);
+function r(t) {
+	if (t && !n(t.id)) throw new e("invalid_request", `content id must be a canonical UUIDv7, got "${t.id}"`);
+}
+//#endregion
+export { r as checkRef, n as isContentId };
+
+//# sourceMappingURL=ref.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ref.js","names":[],"sources":["../../../src/client/media/ref.ts"],"sourcesContent":["import { ContentKitError } from \"../errors.js\";\n\nconst contentId = /^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;\n\n/** Content ids are canonical lowercase UUIDv7s (contentref.ValidateID). */\nexport const isContentId = (id: string) => contentId.test(id);\n\n/** Refuses a ref whose id ContentKit would reject, before any request. */\nexport function checkRef(ref: { id: string } | undefined) {\n  if (ref && !isContentId(ref.id)) throw new ContentKitError(\"invalid_request\", `content id must be a canonical UUIDv7, got \"${ref.id}\"`);\n}\n"],"mappings":";;AAEA,IAAM,IAAY,yEAGL,KAAe,MAAe,EAAU,KAAK,CAAE;AAG5D,SAAgB,EAAS,GAAiC;CACxD,IAAI,KAAO,CAAC,EAAY,EAAI,EAAE,GAAG,MAAM,IAAI,EAAgB,mBAAmB,+CAA+C,EAAI,GAAG,EAAE;AACxI"}

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

@@ -0,0 +1,54 @@
+import { ContentKitError } from '../errors.js';
+import { PresetRule, ReadResult, UploadRule } from '../generated/wire.js';
+import { PublicPreset } from '../public.js';
+/** An editor read's upload rules (a viewer read has none). */
+export declare const uploadRules: (read: ReadResult | null | undefined) => UploadRule[];
+/** A pattern path ("originals/{name}") holds many files; a literal ("cover") one. */
+export declare const isPattern: (path: string) => boolean;
+/** The directory of a pattern ("originals/"), or the literal itself. */
+export declare const ruleDir: (path: string) => string;
+/** The rule an upload path (with or without its extension) falls under: a literal wins over a pattern. */
+export declare function ruleFor<R extends {
+    path: string;
+}>(rules: readonly R[], path: string): R | undefined;
+/** Uploads of the read under rule (attached, in manifest order). */
+export declare function filesFor(read: ReadResult | null | undefined, rule: {
+    path: string;
+}, rules?: readonly {
+    path: string;
+}[]): import('../index.js').FileInfo[];
+/** The file with a content type from its extension when the browser left it empty or nonstandard (.mkv, .mov, .srt). */
+export declare function withMediaType(file: File, allowed?: readonly string[]): File;
+/** `accept` for a file input from the rules' types (plus the extensions browsers leave untyped). */
+export declare function acceptOf(rules: readonly UploadRule[]): string | undefined;
+export interface Screened {
+    /** Files to upload, each with its rule (typed by extension when needed). */
+    accepted: {
+        file: File;
+        rule: UploadRule;
+    }[];
+    /** Files the server would refuse, with the refusal it would answer. */
+    refused: {
+        file: File;
+        error: ContentKitError;
+    }[];
+}
+/**
+ * Checks files against the rules before any upload: a type some rule takes
+ * (the first that does), its size, and the rule's file cap counting
+ * have(rule) files already there. A rule without types, size or cap lets
+ * that check through; the server decides.
+ */
+export declare function screenFiles(files: Iterable<File>, rules: readonly UploadRule[], have?: (rule: UploadRule) => number): Screened;
+/** name, or name-2, name-3… so its stem is not among taken (names or paths without the directory). */
+export declare function uniqueName(name: string, taken: Iterable<string>): string;
+/** "16:9" style label of a width/height ratio: 2.4 → "2.4:1", 0.4167 → "1:2.4". */
+export declare function ratioLabel(r: number): string;
+/** The kind's public preset for an upload path: the one named name, else the first with an aspect, else the first. */
+export declare function presetFor(presets: readonly PresetRule[], kind: string, path: string, name?: string): PresetRule | undefined;
+/**
+ * The kind's default image for a preset, at every width: what the gateway
+ * serves for an item without its own (a URL from the template never names a
+ * current file). Empty for a preview preset.
+ */
+export declare function defaultImage(rule: PresetRule, id: string): PublicPreset;

package/dist/client/media/rules.js

@@ -0,0 +1,143 @@
+import { ContentKitError as e } from "../errors.js";
+import { fill as t, publicURL as n } from "../public.js";
+import { ratio as r } from "../aspect.js";
+import { stem as i } from "./client.js";
+//#region src/client/media/rules.ts
+var a = (e) => e?.uploads ?? [], o = "{name}", s = (e) => e.endsWith(o), c = (e) => s(e) ? e.slice(0, -6) : e;
+function l(e, t) {
+	let n = i(t);
+	return e.find((e) => !s(e.path) && e.path === n) ?? e.find((e) => {
+		if (!s(e.path)) return !1;
+		let t = c(e.path);
+		return n.startsWith(t) && n.length > t.length && !n.slice(t.length).includes("/");
+	});
+}
+function u(e, t, n = [t]) {
+	return (e?.files ?? []).filter((e) => e.upload && !e.unattached && l(n, e.path)?.path === t.path);
+}
+var d = {
+	jpg: "image/jpeg",
+	jpeg: "image/jpeg",
+	png: "image/png",
+	webp: "image/webp",
+	gif: "image/gif",
+	avif: "image/avif",
+	mp4: "video/mp4",
+	m4v: "video/mp4",
+	mov: "video/quicktime",
+	mkv: "video/x-matroska",
+	webm: "video/webm",
+	m4a: "audio/mp4",
+	mp3: "audio/mpeg",
+	vtt: "text/vtt",
+	srt: "application/x-subrip",
+	ass: "text/x-ass",
+	ssa: "text/x-ssa",
+	zip: "application/zip"
+};
+function f(e, t) {
+	if (e.type && (!t || t.includes(e.type))) return e;
+	let n = d[e.name.split(".").pop()?.toLowerCase() ?? ""];
+	return n && n !== e.type ? new File([e], e.name, {
+		type: n,
+		lastModified: e.lastModified
+	}) : e;
+}
+function p(e) {
+	let t = [...new Set(e.flatMap((e) => e.types))];
+	if (!t.length) return;
+	let n = Object.entries(d).filter(([, e]) => t.includes(e)).map(([e]) => `.${e}`);
+	return [...t, ...n].join(",");
+}
+function m(t, n, r = () => 0) {
+	let i = {
+		accepted: [],
+		refused: []
+	}, a = /* @__PURE__ */ new Map(), o = [...new Set(n.flatMap((e) => e.types))];
+	for (let s of t) {
+		let t = f(s, o), c = n.find((e) => !e.types.length || e.types.includes(t.type));
+		if (!c) {
+			let n = {
+				type: t.type || void 0,
+				allowed: o
+			};
+			i.refused.push({
+				file: t,
+				error: new e("type_not_allowed", `${t.name}: type not allowed`, {
+					status: 415,
+					details: n
+				})
+			});
+			continue;
+		}
+		if (c.max_bytes > 0 && t.size > c.max_bytes) {
+			let n = {
+				type: t.type,
+				size: t.size,
+				max_bytes: c.max_bytes
+			};
+			i.refused.push({
+				file: t,
+				error: new e("too_large", `${t.name}: too large`, {
+					status: 413,
+					details: n
+				})
+			});
+			continue;
+		}
+		let l = a.get(c) ?? r(c);
+		if (c.max && l >= c.max) {
+			let n = { max: c.max };
+			i.refused.push({
+				file: t,
+				error: new e("too_many_files", `${t.name}: at most ${c.max} files`, {
+					status: 409,
+					details: n
+				})
+			});
+			continue;
+		}
+		a.set(c, l + 1), i.accepted.push({
+			file: t,
+			rule: c
+		});
+	}
+	return i;
+}
+function h(e, t) {
+	let n = new Set([...t].map(i));
+	if (!n.has(i(e))) return e;
+	let r = e.lastIndexOf("."), a = r > 0 ? e.slice(0, r) : e, o = r > 0 ? e.slice(r) : "";
+	for (let e = 2;; e++) {
+		let t = `${a}-${e}${o}`;
+		if (!n.has(i(t))) return t;
+	}
+}
+function g(e) {
+	let t = (e) => String(Math.round(e * 100) / 100);
+	return e >= 1 ? `${t(e)}:1` : `1:${t(1 / e)}`;
+}
+function _(e, t, n, r) {
+	let i = e.filter((e) => e.kind === t && l([{ path: e.from }], n));
+	return (r ? i.find((e) => e.name === r) : void 0) ?? i.find((e) => e.aspect) ?? i[0];
+}
+function v(e, i) {
+	let a = r(e.aspect);
+	return e.first || e.to.includes(o) ? {
+		preset: e.name,
+		aspect: e.aspect,
+		renditions: []
+	} : {
+		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 })),
+			w: r,
+			...a ? { h: Math.round(r / a) } : {}
+		}))
+	};
+}
+//#endregion
+export { p as acceptOf, v as defaultImage, u as filesFor, s as isPattern, _ as presetFor, g as ratioLabel, c as ruleDir, l as ruleFor, m as screenFiles, h as uniqueName, a as uploadRules, f as withMediaType };
+
+//# sourceMappingURL=rules.js.map

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

@@ -0,0 +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\n/** An editor read's upload rules (a viewer read has none). */\nexport const uploadRules = (read: ReadResult | null | undefined): UploadRule[] => read?.uploads ?? [];\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). Empty for a preview preset.\n */\nexport function defaultImage(rule: PresetRule, id: string): PublicPreset {\n  const r = ratio(rule.aspect);\n  if (rule.first || rule.to.includes(NAME)) return { preset: rule.name, aspect: rule.aspect, renditions: [] };\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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"}

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

@@ -0,0 +1,13 @@
+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.
+ */
+export type Transport = (req: RequestReply, body: Blob, opts: {
+    signal?: AbortSignal;
+    onProgress?: (sent: number) => void;
+}) => Promise<void>;
+/** XMLHttpRequest when available (upload progress), otherwise fetch. */
+export declare const defaultTransport: Transport;
+export declare const xhrTransport: Transport;
+export declare const fetchTransport: Transport;

package/dist/client/media/transport.js

@@ -0,0 +1,33 @@
+import { ContentKitError as e, aborted as t } 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) => {
+	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;
+	try {
+		s = await fetch(n.url, {
+			method: n.method,
+			headers: n.headers,
+			body: r,
+			signal: i ?? null
+		});
+	} catch (n) {
+		throw i?.aborted ? t(i) : new e("network", "connection to storage failed", { cause: n });
+	}
+	if (!s.ok) throw a(s.status, await s.text().catch(() => ""));
+	await s.body?.cancel(), o?.(r.size);
+};
+function a(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 };
+
+//# sourceMappingURL=transport.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,15 @@
+import { FileInfo, ReadResult } from '../generated/wire.js';
+/** Files per window when a read is split into windows. */
+export declare const READ_CHUNK = 50;
+/** Offsets of chunk-sized windows covering files [start, end), clipped to total when known. */
+export declare function chunkOffsets(start: number, end: number, total?: number, chunk?: number): number[];
+/**
+ * One item's window reads as one read: the newest window's listing and
+ * metadata, each file's URL from the newest window that signed it, and the
+ * earliest expiry. Every window lists every file; only its range has URLs.
+ */
+export declare function mergeReads(reads: readonly (ReadResult | null | undefined)[]): ReadResult | null;
+/** An upload the worker has not finished: staged, or with work pending, and not failed. */
+export declare const isProcessing: (f: FileInfo) => boolean;
+/** An editor read with uploads still processing (not stalled because the item is full). */
+export declare function processing(read: ReadResult | null | undefined): boolean;