@openrails/contentkit-ui 0.0.0-placeholder → 0.68.0

package/dist/client/http.d.ts

@@ -0,0 +1,79 @@
+import { ContentChange } from './content/types.js';
+import { FileInfo, RefBody } from './generated/wire.js';
+/** A module's base URL, or one per item (a host that splits uploads by kind). */
+export type Mount = string | ((ref: RefBody) => string);
+/**
+ * Where each module lives when the host does not serve them all under
+ * baseUrl's fixed sub-paths.
+ */
+export interface ContentKitMounts {
+    /** Posts, comments, reactions, favorites, polls, bans, moderation. Default baseUrl. */
+    content?: string;
+    /** Media reads and HLS playlists. Default `{baseUrl}/media`. */
+    media?: Mount;
+    /** Uploads and commits. Default `{baseUrl}/media/upload`. */
+    upload?: Mount;
+    /** Content-code lookup. Default `{baseUrl}/codes`. */
+    codes?: string;
+    /** Taxonomy. Default `{baseUrl}/taxonomy`. */
+    taxonomy?: string;
+}
+export type ContentKitModule = keyof ContentKitMounts;
+/** A mutation made through the client: the host's cache-invalidation hook gets each one. */
+export type ContentKitChange = 
+/** A commit applied; files are the item's uploads as an editor reads them, without URLs. */
+{
+    type: "media.committed";
+    ref: RefBody;
+    files: FileInfo[];
+}
+/** An upload finished processing, as an editor read returns it. */
+ | {
+    type: "media.processed";
+    ref: RefBody;
+    file: FileInfo;
+} | ContentChange;
+export type TokenSource = () => string | null | undefined | Promise<string | null | undefined>;
+export interface HttpOptions {
+    /** Where the host mounts ContentKit, e.g. "/api/v1/contentkit". */
+    baseUrl: string;
+    mounts?: ContentKitMounts;
+    /** Transport for API calls; pass an authenticating fetch (auth-ui's authFetch). */
+    fetch?: typeof fetch;
+    /**
+     * Bearer for API calls and for HLS playlists on the API origin (hls.js
+     * loads them with XHR, not fetch). An authenticating fetch overrides it.
+     */
+    token?: TokenSource;
+    /** Sent as Accept-Language. */
+    language?: () => string | null | undefined;
+    /** Extra headers per call (CSRF). */
+    headers?: () => HeadersInit | Promise<HeadersInit>;
+    /** Default "same-origin"; "include" also sends cookies with HLS requests. */
+    credentials?: RequestCredentials;
+}
+export interface RequestOptions {
+    method?: string;
+    body?: unknown;
+    signal?: AbortSignal;
+    /** Read the body as a Blob instead of JSON. */
+    blob?: boolean;
+}
+/** The transport every module shares: mounts, auth, language, errors and change events. */
+export declare class Http {
+    private readonly o;
+    private readonly listeners;
+    private readonly base;
+    constructor(o: HttpOptions);
+    /** The module's base URL, without a trailing slash. */
+    mount(module: ContentKitModule, ref?: RefBody): string;
+    request<T>(url: string, { method, body, signal, blob }?: RequestOptions): Promise<T>;
+    /**
+     * hls.js `xhrSetup`: opens the request, sends cookies when credentials is
+     * "include", and adds the bearer only on the API's origin (never a media host).
+     */
+    readonly xhrSetup: (xhr: XMLHttpRequest, url: string) => Promise<void>;
+    subscribe(listener: (change: ContentKitChange) => void): () => void;
+    emit(change: ContentKitChange): void;
+    private onApiOrigin;
+}

package/dist/client/http.js

@@ -0,0 +1,74 @@
+import { ContentKitError as e, aborted as t, readContentKitError as n } from "./errors.js";
+//#region src/client/http.ts
+var r = (e) => e.replace(/\/+$/, ""), i = class {
+	o;
+	listeners = /* @__PURE__ */ new Set();
+	base;
+	constructor(e) {
+		if (this.o = e, typeof e.baseUrl != "string") throw Error("contentkit: createContentKitClient needs baseUrl");
+		this.base = r(e.baseUrl);
+	}
+	mount(e, t) {
+		let n = this.o.mounts?.[e];
+		if (typeof n == "function") {
+			if (!t) throw Error(`contentkit: the ${e} mount is per item; pass a ref`);
+			return r(n(t));
+		}
+		if (n !== void 0) return r(n);
+		switch (e) {
+			case "content": return this.base;
+			case "media": return `${this.base}/media`;
+			case "upload": return `${this.base}/media/upload`;
+			default: return `${this.base}/${e}`;
+		}
+	}
+	async request(r, { method: i, body: a, signal: o, blob: s } = {}) {
+		let c = this.o.fetch ?? fetch, l = new Headers(await this.o.headers?.());
+		a !== void 0 && l.set("Content-Type", "application/json");
+		let u = await this.o.token?.();
+		u && !l.has("Authorization") && l.set("Authorization", `Bearer ${u}`);
+		let d = this.o.language?.();
+		d && l.set("Accept-Language", d);
+		let f;
+		try {
+			f = await c(r, {
+				method: i ?? (a === void 0 ? "GET" : "POST"),
+				headers: l,
+				body: a === void 0 ? null : JSON.stringify(a),
+				credentials: this.o.credentials ?? "same-origin",
+				signal: o ?? null
+			});
+		} catch (n) {
+			throw o?.aborted ? t(o) : new e("network", `ContentKit API ${new URL(r, "http://x").pathname} unreachable`, { cause: n });
+		}
+		if (!f.ok) throw await n(f);
+		return s ? await f.blob() : f.status === 204 ? void 0 : await f.json();
+	}
+	xhrSetup = async (e, t) => {
+		if (e.readyState || e.open("GET", t, !0), this.o.credentials === "include" && (e.withCredentials = !0), !this.onApiOrigin(t)) return;
+		let n = await this.o.token?.();
+		n && e.setRequestHeader("Authorization", `Bearer ${n}`);
+	};
+	subscribe(e) {
+		return this.listeners.add(e), () => void this.listeners.delete(e);
+	}
+	emit(e) {
+		for (let t of this.listeners) try {
+			t(e);
+		} catch (e) {
+			console.error("contentkit: change listener failed", e);
+		}
+	}
+	onApiOrigin(e) {
+		let t = typeof location > "u" ? "http://localhost" : location.href;
+		try {
+			return new URL(e, t).origin === new URL(this.base || "/", t).origin;
+		} catch {
+			return !1;
+		}
+	}
+};
+//#endregion
+export { i as Http };
+
+//# sourceMappingURL=http.js.map

package/dist/client/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","names":[],"sources":["../../src/client/http.ts"],"sourcesContent":["import { ContentKitError, aborted, readContentKitError } from \"./errors.js\";\nimport type { ContentChange } from \"./content/types.js\";\nimport type { FileInfo, RefBody } from \"./generated/wire.js\";\n\n/** A module's base URL, or one per item (a host that splits uploads by kind). */\nexport type Mount = string | ((ref: RefBody) => string);\n\n/**\n * Where each module lives when the host does not serve them all under\n * baseUrl's fixed sub-paths.\n */\nexport interface ContentKitMounts {\n  /** Posts, comments, reactions, favorites, polls, bans, moderation. Default baseUrl. */\n  content?: string;\n  /** Media reads and HLS playlists. Default `{baseUrl}/media`. */\n  media?: Mount;\n  /** Uploads and commits. Default `{baseUrl}/media/upload`. */\n  upload?: Mount;\n  /** Content-code lookup. Default `{baseUrl}/codes`. */\n  codes?: string;\n  /** Taxonomy. Default `{baseUrl}/taxonomy`. */\n  taxonomy?: string;\n}\n\nexport type ContentKitModule = keyof ContentKitMounts;\n\n/** A mutation made through the client: the host's cache-invalidation hook gets each one. */\nexport type ContentKitChange =\n  /** A commit applied; files are the item's uploads as an editor reads them, without URLs. */\n  | { type: \"media.committed\"; ref: RefBody; files: FileInfo[] }\n  /** An upload finished processing, as an editor read returns it. */\n  | { type: \"media.processed\"; ref: RefBody; file: FileInfo }\n  | ContentChange;\n\nexport type TokenSource = () => string | null | undefined | Promise<string | null | undefined>;\n\nexport interface HttpOptions {\n  /** Where the host mounts ContentKit, e.g. \"/api/v1/contentkit\". */\n  baseUrl: string;\n  mounts?: ContentKitMounts;\n  /** Transport for API calls; pass an authenticating fetch (auth-ui's authFetch). */\n  fetch?: typeof fetch;\n  /**\n   * Bearer for API calls and for HLS playlists on the API origin (hls.js\n   * loads them with XHR, not fetch). An authenticating fetch overrides it.\n   */\n  token?: TokenSource;\n  /** Sent as Accept-Language. */\n  language?: () => string | null | undefined;\n  /** Extra headers per call (CSRF). */\n  headers?: () => HeadersInit | Promise<HeadersInit>;\n  /** Default \"same-origin\"; \"include\" also sends cookies with HLS requests. */\n  credentials?: RequestCredentials;\n}\n\nexport interface RequestOptions {\n  method?: string;\n  body?: unknown;\n  signal?: AbortSignal;\n  /** Read the body as a Blob instead of JSON. */\n  blob?: boolean;\n}\n\nconst trim = (u: string) => u.replace(/\\/+$/, \"\");\n\n/** The transport every module shares: mounts, auth, language, errors and change events. */\nexport class Http {\n  private readonly listeners = new Set<(change: ContentKitChange) => void>();\n  private readonly base: string;\n\n  constructor(private readonly o: HttpOptions) {\n    if (typeof o.baseUrl !== \"string\") throw new Error(\"contentkit: createContentKitClient needs baseUrl\");\n    this.base = trim(o.baseUrl);\n  }\n\n  /** The module's base URL, without a trailing slash. */\n  mount(module: ContentKitModule, ref?: RefBody): string {\n    const m = this.o.mounts?.[module];\n    if (typeof m === \"function\") {\n      if (!ref) throw new Error(`contentkit: the ${module} mount is per item; pass a ref`);\n      return trim(m(ref));\n    }\n    if (m !== undefined) return trim(m);\n    switch (module) {\n      case \"content\":\n        return this.base;\n      case \"media\":\n        return `${this.base}/media`;\n      case \"upload\":\n        return `${this.base}/media/upload`;\n      default:\n        return `${this.base}/${module}`;\n    }\n  }\n\n  async request<T>(url: string, { method, body, signal, blob }: RequestOptions = {}): Promise<T> {\n    const f = this.o.fetch ?? fetch;\n    const headers = new Headers(await this.o.headers?.());\n    if (body !== undefined) headers.set(\"Content-Type\", \"application/json\");\n    const token = await this.o.token?.();\n    if (token && !headers.has(\"Authorization\")) headers.set(\"Authorization\", `Bearer ${token}`);\n    const lang = this.o.language?.();\n    if (lang) headers.set(\"Accept-Language\", lang);\n    let res: Response;\n    try {\n      res = await f(url, {\n        method: method ?? (body === undefined ? \"GET\" : \"POST\"),\n        headers,\n        body: body === undefined ? null : JSON.stringify(body),\n        credentials: this.o.credentials ?? \"same-origin\",\n        signal: signal ?? null,\n      });\n    } catch (err) {\n      if (signal?.aborted) throw aborted(signal);\n      throw new ContentKitError(\"network\", `ContentKit API ${new URL(url, \"http://x\").pathname} unreachable`, { cause: err });\n    }\n    if (!res.ok) throw await readContentKitError(res);\n    if (blob) return (await res.blob()) as T;\n    return (res.status === 204 ? undefined : await res.json()) as T;\n  }\n\n  /**\n   * hls.js `xhrSetup`: opens the request, sends cookies when credentials is\n   * \"include\", and adds the bearer only on the API's origin (never a media host).\n   */\n  readonly xhrSetup = async (xhr: XMLHttpRequest, url: string): Promise<void> => {\n    if (!xhr.readyState) xhr.open(\"GET\", url, true);\n    if (this.o.credentials === \"include\") xhr.withCredentials = true;\n    if (!this.onApiOrigin(url)) return;\n    const token = await this.o.token?.();\n    if (token) xhr.setRequestHeader(\"Authorization\", `Bearer ${token}`);\n  };\n\n  subscribe(listener: (change: ContentKitChange) => void): () => void {\n    this.listeners.add(listener);\n    return () => void this.listeners.delete(listener);\n  }\n\n  emit(change: ContentKitChange): void {\n    for (const l of this.listeners) {\n      try {\n        l(change);\n      } catch (e) {\n        // A host listener's fault must not fail the mutation that succeeded.\n        console.error(\"contentkit: change listener failed\", e);\n      }\n    }\n  }\n\n  private onApiOrigin(url: string): boolean {\n    const here = typeof location === \"undefined\" ? \"http://localhost\" : location.href;\n    try {\n      return new URL(url, here).origin === new URL(this.base || \"/\", here).origin;\n    } catch {\n      return false;\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/client/image.d.ts

@@ -0,0 +1,24 @@
+import { Size } from './crop.js';
+/** An image to crop: a displayable URL and the size of the EXIF-oriented original. */
+export interface CropSource extends Size {
+    url: string;
+    /** Set when the source was picked locally; revoke() frees its preview. */
+    file?: File;
+    revoke?: () => void;
+}
+export interface DecodeOptions {
+    /** Longest side of the preview; the crop stays normalized to the original. Default 2048. */
+    maxPreview?: number;
+}
+/**
+ * Decodes a picked file with its EXIF orientation applied and returns a
+ * downscaled preview URL plus the oriented original size. Throws
+ * ContentKitError("decode") for files the browser cannot read as an image.
+ */
+export declare function decodeImage(file: File, o?: DecodeOptions): Promise<CropSource>;
+/**
+ * Whether an image file is animated (GIF with several frames, animated WebP,
+ * AVIF/HEIF sequence): a cheap pre-check for slots whose `animation` is
+ * "reject". The server decides.
+ */
+export declare function isAnimatedImage(file: Blob): Promise<boolean>;

package/dist/client/image.js

@@ -0,0 +1,65 @@
+import { ContentKitError as e } from "./errors.js";
+//#region src/client/image.ts
+async function t(t, r = {}) {
+	let i = r.maxPreview ?? 2048, a;
+	try {
+		a = await createImageBitmap(t, { imageOrientation: "from-image" });
+	} catch (t) {
+		throw new e("decode", "the file is not a readable image", { cause: t });
+	}
+	let { width: o, height: s } = a;
+	try {
+		let e = Math.min(1, i / Math.max(o, s)), r = Math.max(1, Math.round(o * e)), c = Math.max(1, Math.round(s * e)), l = await n(a, r, c, /png|webp|gif|avif/.test(t.type) ? "image/png" : "image/jpeg"), u = URL.createObjectURL(l);
+		return {
+			url: u,
+			width: o,
+			height: s,
+			file: t,
+			revoke: () => URL.revokeObjectURL(u)
+		};
+	} finally {
+		a.close();
+	}
+}
+async function n(t, n, r, i) {
+	if (typeof OffscreenCanvas < "u") {
+		let e = new OffscreenCanvas(n, r);
+		return e.getContext("2d").drawImage(t, 0, 0, n, r), e.convertToBlob({
+			type: i,
+			quality: .9
+		});
+	}
+	let a = document.createElement("canvas");
+	return a.width = n, a.height = r, a.getContext("2d").drawImage(t, 0, 0, n, r), new Promise((t, n) => a.toBlob((r) => r ? t(r) : n(new e("decode", "could not render a preview")), i, .9));
+}
+async function r(e) {
+	let t = new Uint8Array(await e.slice(0, 64).arrayBuffer()), n = (e, n) => String.fromCharCode(...t.subarray(e, n));
+	if (n(0, 4) === "RIFF" && n(8, 12) === "WEBP") return n(12, 16) === "VP8X" && !!(t[20] & 2);
+	if (n(4, 8) === "ftyp") {
+		let e = n(8, Math.min(t.length, t[0] << 24 | t[1] << 16 | t[2] << 8 | t[3]));
+		return /avis|msf1|hevs/.test(e);
+	}
+	return n(0, 3) === "GIF" && i(new Uint8Array(await e.arrayBuffer())) > 1;
+}
+function i(e) {
+	let t = 13;
+	e[10] & 128 && (t += 3 * (1 << (e[10] & 7) + 1));
+	let n = () => {
+		for (; t < e.length && e[t] !== 0;) t += e[t] + 1;
+		t++;
+	}, r = 0;
+	for (; t < e.length;) {
+		let i = e[t++];
+		if (i === 33) t++, n();
+		else if (i === 44) {
+			if (++r > 1) return r;
+			let i = e[t + 8];
+			t += 9, i & 128 && (t += 3 * (1 << (i & 7) + 1)), t++, n();
+		} else break;
+	}
+	return r;
+}
+//#endregion
+export { t as decodeImage, r as isAnimatedImage };
+
+//# sourceMappingURL=image.js.map

package/dist/client/image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"image.js","names":[],"sources":["../../src/client/image.ts"],"sourcesContent":["import type { Size } from \"./crop.js\";\nimport { ContentKitError } from \"./errors.js\";\n\n/** An image to crop: a displayable URL and the size of the EXIF-oriented original. */\nexport interface CropSource extends Size {\n  url: string;\n  /** Set when the source was picked locally; revoke() frees its preview. */\n  file?: File;\n  revoke?: () => void;\n}\n\nexport interface DecodeOptions {\n  /** Longest side of the preview; the crop stays normalized to the original. Default 2048. */\n  maxPreview?: number;\n}\n\n/**\n * Decodes a picked file with its EXIF orientation applied and returns a\n * downscaled preview URL plus the oriented original size. Throws\n * ContentKitError(\"decode\") for files the browser cannot read as an image.\n */\nexport async function decodeImage(file: File, o: DecodeOptions = {}): Promise<CropSource> {\n  const max = o.maxPreview ?? 2048;\n  let bitmap: ImageBitmap;\n  try {\n    bitmap = await createImageBitmap(file, { imageOrientation: \"from-image\" });\n  } catch (err) {\n    throw new ContentKitError(\"decode\", \"the file is not a readable image\", { cause: err });\n  }\n  const { width, height } = bitmap;\n  try {\n    const scale = Math.min(1, max / Math.max(width, height));\n    const w = Math.max(1, Math.round(width * scale));\n    const h = Math.max(1, Math.round(height * scale));\n    const blob = await render(bitmap, w, h, /png|webp|gif|avif/.test(file.type) ? \"image/png\" : \"image/jpeg\");\n    const url = URL.createObjectURL(blob);\n    return { url, width, height, file, revoke: () => URL.revokeObjectURL(url) };\n  } finally {\n    bitmap.close();\n  }\n}\n\nasync function render(bitmap: ImageBitmap, w: number, h: number, type: string): Promise<Blob> {\n  if (typeof OffscreenCanvas !== \"undefined\") {\n    const c = new OffscreenCanvas(w, h);\n    c.getContext(\"2d\")!.drawImage(bitmap, 0, 0, w, h);\n    return c.convertToBlob({ type, quality: 0.9 });\n  }\n  const c = document.createElement(\"canvas\");\n  c.width = w;\n  c.height = h;\n  c.getContext(\"2d\")!.drawImage(bitmap, 0, 0, w, h);\n  return new Promise((resolve, reject) =>\n    c.toBlob((b) => (b ? resolve(b) : reject(new ContentKitError(\"decode\", \"could not render a preview\"))), type, 0.9),\n  );\n}\n\n/**\n * Whether an image file is animated (GIF with several frames, animated WebP,\n * AVIF/HEIF sequence): a cheap pre-check for slots whose `animation` is\n * \"reject\". The server decides.\n */\nexport async function isAnimatedImage(file: Blob): Promise<boolean> {\n  const head = new Uint8Array(await file.slice(0, 64).arrayBuffer());\n  const ascii = (a: number, b: number) => String.fromCharCode(...head.subarray(a, b));\n  if (ascii(0, 4) === \"RIFF\" && ascii(8, 12) === \"WEBP\") return ascii(12, 16) === \"VP8X\" && (head[20]! & 0x02) !== 0;\n  if (ascii(4, 8) === \"ftyp\") {\n    const brands = ascii(8, Math.min(head.length, (head[0]! << 24) | (head[1]! << 16) | (head[2]! << 8) | head[3]!));\n    return /avis|msf1|hevs/.test(brands);\n  }\n  if (ascii(0, 3) === \"GIF\") return gifFrames(new Uint8Array(await file.arrayBuffer())) > 1;\n  return false;\n}\n\nfunction gifFrames(b: Uint8Array): number {\n  let i = 13;\n  if (b[10]! & 0x80) i += 3 * (1 << ((b[10]! & 7) + 1));\n  const skipBlocks = () => {\n    while (i < b.length && b[i]! !== 0) i += b[i]! + 1;\n    i++;\n  };\n  let frames = 0;\n  while (i < b.length) {\n    const t = b[i++];\n    if (t === 0x21) {\n      i++;\n      skipBlocks();\n    } else if (t === 0x2c) {\n      if (++frames > 1) return frames;\n      const packed = b[i + 8]!;\n      i += 9;\n      if (packed & 0x80) i += 3 * (1 << ((packed & 7) + 1));\n      i++; // LZW minimum code size\n      skipBlocks();\n    } else break;\n  }\n  return frames;\n}\n"],"mappings":"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"}

package/dist/client/index.d.ts

@@ -0,0 +1,33 @@
+export { createContentKitClient, type ContentKitClient, type ContentKitClientOptions } from './client.js';
+export type { ContentKitChange, ContentKitModule, ContentKitMounts, Mount, TokenSource } from './http.js';
+export { CLIENT_ERROR_CODES, ContentKitError, ERROR_CODES, failureError, isContentKitError, readContentKitError, toContentKitError, type ContentKitErrorCode, type ContentKitErrorInit, } from './errors.js';
+export { PostsClient, type PostAdminQuery, type PostQuery } from './content/posts.js';
+export { CommentsClient, type AdminCommentQuery, type CommentQuery } from './content/comments.js';
+export { ReactionsClient } from './content/reactions.js';
+export { FavoritesClient } from './content/favorites.js';
+export { PollsClient, type PollQuery } from './content/polls.js';
+export { BansClient } from './content/bans.js';
+export { ModerationClient, type HeldQuery } from './content/moderation.js';
+export { reactionVerb, type BanScope, type ContentChange, type Decision, type HeldKind, type Reaction, type Sort } from './content/types.js';
+export { TaxonomyClient, type NodeQuery } from './taxonomy.js';
+export { CodesClient } from './codes.js';
+export { call, routeURL, type CallOptions, type Method, type PageQuery, type PathParams, type RouteQuery, type RoutePath } from './route.js';
+export { MediaApi, type ReadOptions } from './media/api.js';
+export { MediaClient, backoff, samePath, stem, type CommitOptions, type CommitSource, type ContentFolders, type MediaOptions, type NamedOptions, type NamedUpload, type PlannedPart, type Progress, type PutOptions, type UploadOptions, type UploadState, type UploadedFile, type WaitOptions, } from './media/client.js';
+export { UploadQueue, type ItemStatus, type QueueItem, type QueueOptions, type QueueSnapshot } from './media/queue.js';
+export { acceptOf, defaultImage, filesFor, isPattern, ratioLabel, ruleDir, ruleFor, screenFiles, uniqueName, uploadRules, withMediaType, type Screened, } from './media/rules.js';
+export { READ_CHUNK, chunkOffsets, isProcessing, mergeReads, processing } from './media/windows.js';
+export { defaultTransport, fetchTransport, xhrTransport, type Transport } from './media/transport.js';
+export { checkRef, isContentId } from './media/ref.js';
+export { encodeRemaining } from './media/encode.js';
+export { sha256Hex } from './media/hash.js';
+export { Pacer, type PacerOptions } from './media/pacer.js';
+export { centeredCrop, constrainCrop, editOf, editedSize, fromRotated, rotation, sameEdit, toOriginal, toRotated, type Rotation, type Size } from './crop.js';
+export { decodeImage, isAnimatedImage, type CropSource, type DecodeOptions } from './image.js';
+export { aspectOf, ratio, type AspectRatio } from './aspect.js';
+export { fill, publicRenditions, publicURL, srcSet, type PublicPreset } from './public.js';
+export { DEFAULT_DENSITY, densityFor, pickRendition, sortRenditions, type DensityRange, type Rendition } from './rendition.js';
+export { formatDuration, galleryItems, isAudioType, isImageType, isVideoType, isSubtitleType, stageAspect, type GalleryItem, type GalleryLockedItem, type GalleryMediaItem, type GalleryView, } from './gallery.js';
+export { ABR_DEFAULTS, NETWORK_FAILURES_BEFORE_ERROR, abrHlsConfig, capRung, classifyHlsError, classifyMediaError, hlsConfig, initialEstimate, expiryDelay, REFRESH_BEFORE_EXPIRY, refreshable, startRung, statusKind, type AbrPolicy, type ConnectionHint, type HlsErrorLike, type Rung, type PlaybackError, type PlaybackErrorKind, } from './playback.js';
+export { PLAYBACK_SPEEDS, PLAYER_TRACKS_KEY, PLAYER_VOLUME_KEY, parseSpriteVtt, playerKeyAction, resumeAt, type PlayerAction, type PlayerTrack, type SpriteCue, type TrackPrefs, type VolumePrefs, } from './player.js';
+export * from './generated/wire.js';

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

@@ -0,0 +1,36 @@
+import { Http } from '../http.js';
+import { CommitBody, CommitReply, CompleteReply, PartsBody, PartsReply, PresetRule, PresignBody, PresignReply, ReadResult, RefBody, TicketBody } from '../generated/wire.js';
+/** What a read returns (Reader.Read's ReadOptions). */
+export interface ReadOptions {
+    /** Only files under this path prefix, e.g. "low-res/". */
+    prefix?: string;
+    /** The range of files that get URLs. */
+    offset?: number;
+    limit?: number;
+    /** Sign each file's download name into its URL. */
+    download?: boolean;
+    /** Editors also get the uploads: edit, frame, pending, failure and editor view. */
+    editor?: boolean;
+}
+/**
+ * The upload API (media.UploadHandler) and read API (Reader.Handler), one
+ * method per route. Each takes the item, whose mount the call goes to.
+ */
+export declare class MediaApi {
+    private readonly http;
+    constructor(http: Http);
+    presign(b: PresignBody, signal?: AbortSignal): Promise<PresignReply>;
+    parts(ref: RefBody, b: PartsBody, signal?: AbortSignal): Promise<PartsReply>;
+    listParts(ref: RefBody, b: TicketBody, signal?: AbortSignal): Promise<PartsReply>;
+    complete(ref: RefBody, b: TicketBody, signal?: AbortSignal): Promise<CompleteReply>;
+    abort(ref: RefBody, b: TicketBody, signal?: AbortSignal): Promise<void>;
+    commit(b: CommitBody, signal?: AbortSignal): Promise<CommitReply>;
+    /** A JPEG still of the video upload at path, t seconds in, w pixels wide (0: the frame's). */
+    frame(ref: RefBody, path: string, t: number, w?: number, signal?: AbortSignal): Promise<Blob>;
+    read(ref: RefBody, o?: ReadOptions, signal?: AbortSignal): Promise<ReadResult>;
+    /** Every kind's public presets (the same for every viewer). */
+    presets(signal?: AbortSignal): Promise<PresetRule[]>;
+    /** The item under the read API: `{media}/{kind}/{id}`. */
+    itemURL(ref: RefBody): string;
+    private post;
+}

package/dist/client/media/api.js

@@ -0,0 +1,61 @@
+import { checkRef as e } from "./ref.js";
+//#region src/client/media/api.ts
+var t = class {
+	http;
+	constructor(e) {
+		this.http = e;
+	}
+	presign(e, t) {
+		return this.post(e.ref, "/presign", e, t);
+	}
+	parts(e, t, n) {
+		return this.post(e, "/parts", t, n);
+	}
+	listParts(e, t, n) {
+		return this.post(e, "/parts/list", t, n);
+	}
+	complete(e, t, n) {
+		return this.post(e, "/complete", t, n);
+	}
+	abort(e, t, n) {
+		return this.post(e, "/abort", t, n);
+	}
+	commit(e, t) {
+		return this.post(e.ref, "/commit", e, t);
+	}
+	async frame(t, n, r, i, a) {
+		e(t);
+		let o = new URLSearchParams({
+			kind: t.kind,
+			id: t.id,
+			path: n,
+			t: String(r)
+		});
+		return i && o.set("w", String(i)), this.http.request(`${this.http.mount("upload", t)}/frame?${o}`, {
+			signal: a,
+			blob: !0
+		});
+	}
+	async read(e, t = {}, n) {
+		let r = new URLSearchParams();
+		t.prefix && r.set("prefix", t.prefix), t.offset && r.set("offset", String(t.offset)), t.limit && r.set("limit", String(t.limit)), t.download && r.set("download", "1"), t.editor && r.set("editor", "1");
+		let i = r.toString();
+		return this.http.request(this.itemURL(e) + (i ? "?" + i : ""), { signal: n });
+	}
+	presets(e) {
+		return this.http.request(`${this.http.mount("media")}/presets`, { signal: e });
+	}
+	itemURL(t) {
+		return e(t), `${this.http.mount("media", t)}/${encodeURIComponent(t.kind)}/${encodeURIComponent(t.id)}`;
+	}
+	async post(t, n, r, i) {
+		return e(t), this.http.request(this.http.mount("upload", t) + n, {
+			body: r,
+			signal: i
+		});
+	}
+};
+//#endregion
+export { t as MediaApi };
+
+//# sourceMappingURL=api.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","names":[],"sources":["../../../src/client/media/api.ts"],"sourcesContent":["import type { Http } from \"../http.js\";\nimport type {\n  CommitBody,\n  CommitReply,\n  CompleteReply,\n  PartsBody,\n  PartsReply,\n  PresetRule,\n  PresignBody,\n  PresignReply,\n  ReadResult,\n  RefBody,\n  TicketBody,\n} from \"../generated/wire.js\";\nimport { checkRef } from \"./ref.js\";\n\n/** What a read returns (Reader.Read's ReadOptions). */\nexport interface ReadOptions {\n  /** Only files under this path prefix, e.g. \"low-res/\". */\n  prefix?: string;\n  /** The range of files that get URLs. */\n  offset?: number;\n  limit?: number;\n  /** Sign each file's download name into its URL. */\n  download?: boolean;\n  /** Editors also get the uploads: edit, frame, pending, failure and editor view. */\n  editor?: boolean;\n}\n\n/**\n * The upload API (media.UploadHandler) and read API (Reader.Handler), one\n * method per route. Each takes the item, whose mount the call goes to.\n */\nexport class MediaApi {\n  constructor(private readonly http: Http) {}\n\n  presign(b: PresignBody, signal?: AbortSignal) {\n    return this.post<PresignReply>(b.ref, \"/presign\", b, signal);\n  }\n  parts(ref: RefBody, b: PartsBody, signal?: AbortSignal) {\n    return this.post<PartsReply>(ref, \"/parts\", b, signal);\n  }\n  listParts(ref: RefBody, b: TicketBody, signal?: AbortSignal) {\n    return this.post<PartsReply>(ref, \"/parts/list\", b, signal);\n  }\n  complete(ref: RefBody, b: TicketBody, signal?: AbortSignal) {\n    return this.post<CompleteReply>(ref, \"/complete\", b, signal);\n  }\n  abort(ref: RefBody, b: TicketBody, signal?: AbortSignal) {\n    return this.post<void>(ref, \"/abort\", b, signal);\n  }\n  commit(b: CommitBody, signal?: AbortSignal) {\n    return this.post<CommitReply>(b.ref, \"/commit\", b, signal);\n  }\n  /** A JPEG still of the video upload at path, t seconds in, w pixels wide (0: the frame's). */\n  async frame(ref: RefBody, path: string, t: number, w?: number, signal?: AbortSignal) {\n    checkRef(ref);\n    const q = new URLSearchParams({ kind: ref.kind, id: ref.id, path, t: String(t) });\n    if (w) q.set(\"w\", String(w));\n    return this.http.request<Blob>(`${this.http.mount(\"upload\", ref)}/frame?${q}`, { signal, blob: true });\n  }\n\n  async read(ref: RefBody, o: ReadOptions = {}, signal?: AbortSignal) {\n    const q = new URLSearchParams();\n    if (o.prefix) q.set(\"prefix\", o.prefix);\n    if (o.offset) q.set(\"offset\", String(o.offset));\n    if (o.limit) q.set(\"limit\", String(o.limit));\n    if (o.download) q.set(\"download\", \"1\");\n    if (o.editor) q.set(\"editor\", \"1\");\n    const s = q.toString();\n    return this.http.request<ReadResult>(this.itemURL(ref) + (s ? \"?\" + s : \"\"), { signal });\n  }\n\n  /** Every kind's public presets (the same for every viewer). */\n  presets(signal?: AbortSignal) {\n    return this.http.request<PresetRule[]>(`${this.http.mount(\"media\")}/presets`, { signal });\n  }\n\n  /** The item under the read API: `{media}/{kind}/{id}`. */\n  itemURL(ref: RefBody): string {\n    checkRef(ref);\n    return `${this.http.mount(\"media\", ref)}/${encodeURIComponent(ref.kind)}/${encodeURIComponent(ref.id)}`;\n  }\n\n  private async post<T>(ref: RefBody, path: string, body: object, signal?: AbortSignal) {\n    checkRef(ref);\n    return this.http.request<T>(this.http.mount(\"upload\", ref) + path, { body, signal });\n  }\n}\n"],"mappings":";;AAiCA,IAAa,IAAb,MAAsB;CACS;CAA7B,YAAY,GAA6B;EAAZ,KAAA,OAAA;CAAa;CAE1C,QAAQ,GAAgB,GAAsB;EAC5C,OAAO,KAAK,KAAmB,EAAE,KAAK,YAAY,GAAG,CAAM;CAC7D;CACA,MAAM,GAAc,GAAc,GAAsB;EACtD,OAAO,KAAK,KAAiB,GAAK,UAAU,GAAG,CAAM;CACvD;CACA,UAAU,GAAc,GAAe,GAAsB;EAC3D,OAAO,KAAK,KAAiB,GAAK,eAAe,GAAG,CAAM;CAC5D;CACA,SAAS,GAAc,GAAe,GAAsB;EAC1D,OAAO,KAAK,KAAoB,GAAK,aAAa,GAAG,CAAM;CAC7D;CACA,MAAM,GAAc,GAAe,GAAsB;EACvD,OAAO,KAAK,KAAW,GAAK,UAAU,GAAG,CAAM;CACjD;CACA,OAAO,GAAe,GAAsB;EAC1C,OAAO,KAAK,KAAkB,EAAE,KAAK,WAAW,GAAG,CAAM;CAC3D;CAEA,MAAM,MAAM,GAAc,GAAc,GAAW,GAAY,GAAsB;EACnF,EAAS,CAAG;EACZ,IAAM,IAAI,IAAI,gBAAgB;GAAE,MAAM,EAAI;GAAM,IAAI,EAAI;GAAI;GAAM,GAAG,OAAO,CAAC;EAAE,CAAC;EAEhF,OADI,KAAG,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,GACpB,KAAK,KAAK,QAAc,GAAG,KAAK,KAAK,MAAM,UAAU,CAAG,EAAE,SAAS,KAAK;GAAE;GAAQ,MAAM;EAAK,CAAC;CACvG;CAEA,MAAM,KAAK,GAAc,IAAiB,CAAC,GAAG,GAAsB;EAClE,IAAM,IAAI,IAAI,gBAAgB;EAK9B,AAJI,EAAE,UAAQ,EAAE,IAAI,UAAU,EAAE,MAAM,GAClC,EAAE,UAAQ,EAAE,IAAI,UAAU,OAAO,EAAE,MAAM,CAAC,GAC1C,EAAE,SAAO,EAAE,IAAI,SAAS,OAAO,EAAE,KAAK,CAAC,GACvC,EAAE,YAAU,EAAE,IAAI,YAAY,GAAG,GACjC,EAAE,UAAQ,EAAE,IAAI,UAAU,GAAG;EACjC,IAAM,IAAI,EAAE,SAAS;EACrB,OAAO,KAAK,KAAK,QAAoB,KAAK,QAAQ,CAAG,KAAK,IAAI,MAAM,IAAI,KAAK,EAAE,UAAO,CAAC;CACzF;CAGA,QAAQ,GAAsB;EAC5B,OAAO,KAAK,KAAK,QAAsB,GAAG,KAAK,KAAK,MAAM,OAAO,EAAE,WAAW,EAAE,UAAO,CAAC;CAC1F;CAGA,QAAQ,GAAsB;EAE5B,OADA,EAAS,CAAG,GACL,GAAG,KAAK,KAAK,MAAM,SAAS,CAAG,EAAE,GAAG,mBAAmB,EAAI,IAAI,EAAE,GAAG,mBAAmB,EAAI,EAAE;CACtG;CAEA,MAAc,KAAQ,GAAc,GAAc,GAAc,GAAsB;EAEpF,OADA,EAAS,CAAG,GACL,KAAK,KAAK,QAAW,KAAK,KAAK,MAAM,UAAU,CAAG,IAAI,GAAM;GAAE;GAAM;EAAO,CAAC;CACrF;AACF"}