@openrails/contentkit-ui 0.90.3 → 0.91.0

package/README.md

@@ -78,7 +78,9 @@ operation. This does not change the operation's result or its authentication.
   `/media/upload`, `/codes`. A mount is a module's full base URL.
 - **`client.media`**: `upload`, `put` (upload, commit, wait), `commit`, `read`,
   `waitFor`, `editorView`, `getFrame`, `hlsBase(ref, dir)`, `discard`, and
-  `xhrSetup` for players (`<MediaGallery xhrSetup={contentkit.media.xhrSetup} />`).
+  `hls` for players (`<VideoPlayer loader={contentkit.media.hls} />`): playlists
+  load through the client's fetch, so they carry what its calls carry (an
+  `authFetch` adds DPoP proofs); segments carry only cookies.
   Uploads hash in a Web Worker, send one checksum-bound PUT up to 64 MiB and
   resumable multipart above (`onState`/`resume`). The bucket must allow CORS
   `PUT` from the app's origin with `Content-Type` and `x-amz-checksum-sha256`.
@@ -341,7 +343,7 @@ the starting shape and edit.
 
 `<MediaGallery item={post} prefix="low-res/" renderLocked={unlock} />` reads
 through the client: the read (refreshed, reloaded after commits), HLS bases,
-playlist auth and the grant refresh. Passing `read`, `hlsBase`, `xhrSetup`
+playlist auth and the grant refresh. Passing `read`, `hlsBase`, `loader`
 and `refresh` yourself still works. A locked read lists no files, so the
 lock is uncounted; its public teaser carries `renderLocked`, so the unlock is
 on the first slide;
@@ -388,7 +390,7 @@ fullscreen and a mini player.
 ```tsx
 <VideoPlayer
   base={contentkit.media.hlsBase(ref, "hls/")}
-  xhrSetup={contentkit.media.xhrSetup}
+  loader={contentkit.media.hls}
   refresh={reload} expires={read.expires}       // re-grant before the token expires
   width={video.w} height={video.h} duration={video.dur} poster={posterPreset}
   autoPlay startAt={resumePoint}                 // resume; never a muted autoplay
@@ -401,7 +403,7 @@ fullscreen and a mini player.
   renderDownloads={({ className, container }) => <Downloads className={className} container={container} />}
   menuItems={[{ label: "Version", value, options, onChange }, { label: "Report a problem", onSelect }]}
 />
-{handoff && <VideoMiniPlayer handoff={handoff} xhrSetup={contentkit.media.xhrSetup} onExpand={openWatchPage} onClose={() => setHandoff(null)} />}
+{handoff && <VideoMiniPlayer handoff={handoff} loader={contentkit.media.hls} onExpand={openWatchPage} onClose={() => setHandoff(null)} />}
 ```
 
 - **Shortcuts:** Space/K play, ←/→ 5 s, J/L 10 s, ↑/↓ volume, M mute, C

package/dist/client/client.d.ts

@@ -27,7 +27,7 @@ export interface ContentKitClientOptions extends HttpOptions {
  * over one shared transport (mounts, auth, language, errors, change events).
  */
 export interface ContentKitClient {
-    /** Uploads, multipart, commits, reads, frames, HLS bases, hls.js `xhrSetup` and inline images. */
+    /** Uploads, multipart, commits, reads, frames, HLS bases, the HLS loader and inline images. */
     readonly media: MediaClient;
     /** Content items: reads, and writes for their creators, owner-group editors and staff. */
     readonly contents: ContentsClient;

package/dist/client/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","names":[],"sources":["../../src/client/client.ts"],"sourcesContent":["import { CatalogClient } from \"./catalog.js\";\nimport { CodesClient } from \"./codes.js\";\nimport { ContentsClient } from \"./contents.js\";\nimport { BansClient } from \"./content/bans.js\";\nimport { CommentsClient } from \"./content/comments.js\";\nimport { FavoritesClient } from \"./content/favorites.js\";\nimport { ModerationClient } from \"./content/moderation.js\";\nimport { PollsClient } from \"./content/polls.js\";\nimport { ReactionsClient } from \"./content/reactions.js\";\nimport type { Batch, Config, ContentModel, RefBody, Result } from \"./generated/wire.js\";\nimport { DiscoveryClient } from \"./discovery.js\";\nimport { GroupsClient } from \"./groups.js\";\nimport { OffersClient } from \"./offers.js\";\nimport { StatsClient } from \"./stats.js\";\nimport { VersionsClient } from \"./versions.js\";\nimport { Http, type ContentKitChange, type ContentKitModule, type HttpOptions } from \"./http.js\";\nimport { MediaClient, type ContentFolders, type MediaOptions } from \"./media/client.js\";\nimport { call } from \"./route.js\";\nimport { NotificationsClient } from \"./notifications.js\";\n\nexport interface ContentKitClientOptions extends HttpOptions {\n  /** Upload tuning (transport, part concurrency, retries). */\n  media?: MediaOptions;\n  /** The media kind of poll folders, when the host renamed it (content.Media). */\n  folders?: ContentFolders;\n}\n\n/**\n * One ContentKit deployment as the browser sees it. Each module is a property\n * over one shared transport (mounts, auth, language, errors, change events).\n */\nexport interface ContentKitClient {\n  /** Uploads, multipart, commits, reads, frames, HLS bases, hls.js `xhrSetup` and inline images. */\n  readonly media: MediaClient;\n  /** Content items: reads, and writes for their creators, owner-group editors and staff. */\n  readonly contents: ContentsClient;\n  /** The catalog's totals by kind, language and audience. */\n  readonly catalog: CatalogClient;\n  /** Threads, replies, edits, tombstones, reactions, standing, the latest feed, moderation. */\n  readonly comments: CommentsClient;\n  /** Likes and dislikes of an item. */\n  readonly reactions: ReactionsClient;\n  /** The signed-in caller's favorites. */\n  readonly favorites: FavoritesClient;\n  /** Polls: votes, free-text answers and the staff editor. */\n  readonly polls: PollsClient;\n  /** Comment bans, owner and global. */\n  readonly bans: BansClient;\n  /** The review queue of held comments and content. */\n  readonly moderation: ModerationClient;\n  /** Groups: listings, pages, staff writes and memberships. */\n  readonly groups: GroupsClient;\n  /** Lists, search, typeahead, rails, release dates, content filters, history, signals and exposures. */\n  readonly discovery: DiscoveryClient;\n  /** Content versions: reader plans, reader metadata, forks and downloads. */\n  readonly versions: VersionsClient;\n  /** Offers on contents, versions and groups; group joins; the reader's library. */\n  readonly offers: OffersClient;\n  /** Content-code lookup. */\n  readonly codes: CodesClient;\n  /** Staff activity and rankings; the signed-in reader's own statistics. */\n  readonly stats: StatsClient;\n  /** The signed-in person's native and imported notifications. */\n  readonly notifications: NotificationsClient;\n\n  /** What the content module allows: which interactions signed-out visitors may make. */\n  config(signal?: AbortSignal): Promise<Config>;\n  /** The site's content model: languages, tiers, kinds, group kinds and content filters. */\n  kinds(signal?: AbortSignal): Promise<ContentModel>;\n  /** Staff bulk import (root:import:write): groups, contents, memberships, offers and aliases, idempotent per source. */\n  import(batch: Batch): Promise<Result>;\n  /** A module's base URL as configured (no trailing slash). */\n  url(module: ContentKitModule, ref?: RefBody): string;\n  /** Cache context only, not authentication. The React provider keeps this in sync. */\n  setReadScope(scope: string): void;\n  /** Every successful mutation; a null scope means its data predates a context change. */\n  subscribe(listener: (change: ContentKitChange, scope: string | null) => void): () => void;\n}\n\nexport function createContentKitClient(options: ContentKitClientOptions): ContentKitClient {\n  const { media: mediaOptions, folders, ...http } = options;\n  const h = new Http(http);\n  const media = new MediaClient(h, mediaOptions, folders);\n  return {\n    media,\n    contents: new ContentsClient(h),\n    catalog: new CatalogClient(h),\n    comments: new CommentsClient(h),\n    reactions: new ReactionsClient(h),\n    favorites: new FavoritesClient(h),\n    polls: new PollsClient(h, media),\n    bans: new BansClient(h),\n    moderation: new ModerationClient(h),\n    groups: new GroupsClient(h, media),\n    discovery: new DiscoveryClient(h),\n    versions: new VersionsClient(h),\n    offers: new OffersClient(h),\n    codes: new CodesClient(h),\n    stats: new StatsClient(h),\n    notifications: new NotificationsClient(h),\n    config: (signal) => call(h, \"GET\", \"/config\", { signal }),\n    kinds: (signal) => call(h, \"GET\", \"/kinds\", { signal }),\n    import: (batch) => call(h, \"POST\", \"/import\", { body: batch }),\n    url: (module, ref) => h.mount(module, ref),\n    setReadScope: (scope) => h.setReadScope(scope),\n    subscribe: (listener) => h.subscribe(listener),\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AA+EA,SAAgB,EAAuB,GAAoD;CACzF,IAAM,EAAE,OAAO,GAAc,YAAS,GAAG,MAAS,GAC5C,IAAI,IAAI,EAAK,CAAI,GACjB,IAAQ,IAAI,EAAY,GAAG,GAAc,CAAO;CACtD,OAAO;EACL;EACA,UAAU,IAAI,EAAe,CAAC;EAC9B,SAAS,IAAI,EAAc,CAAC;EAC5B,UAAU,IAAI,EAAe,CAAC;EAC9B,WAAW,IAAI,EAAgB,CAAC;EAChC,WAAW,IAAI,EAAgB,CAAC;EAChC,OAAO,IAAI,EAAY,GAAG,CAAK;EAC/B,MAAM,IAAI,EAAW,CAAC;EACtB,YAAY,IAAI,EAAiB,CAAC;EAClC,QAAQ,IAAI,EAAa,GAAG,CAAK;EACjC,WAAW,IAAI,EAAgB,CAAC;EAChC,UAAU,IAAI,EAAe,CAAC;EAC9B,QAAQ,IAAI,EAAa,CAAC;EAC1B,OAAO,IAAI,EAAY,CAAC;EACxB,OAAO,IAAI,EAAY,CAAC;EACxB,eAAe,IAAI,EAAoB,CAAC;EACxC,SAAS,MAAW,EAAK,GAAG,OAAO,WAAW,EAAE,UAAO,CAAC;EACxD,QAAQ,MAAW,EAAK,GAAG,OAAO,UAAU,EAAE,UAAO,CAAC;EACtD,SAAS,MAAU,EAAK,GAAG,QAAQ,WAAW,EAAE,MAAM,EAAM,CAAC;EAC7D,MAAM,GAAQ,MAAQ,EAAE,MAAM,GAAQ,CAAG;EACzC,eAAe,MAAU,EAAE,aAAa,CAAK;EAC7C,YAAY,MAAa,EAAE,UAAU,CAAQ;CAC/C;AACF"}
+{"version":3,"file":"client.js","names":[],"sources":["../../src/client/client.ts"],"sourcesContent":["import { CatalogClient } from \"./catalog.js\";\nimport { CodesClient } from \"./codes.js\";\nimport { ContentsClient } from \"./contents.js\";\nimport { BansClient } from \"./content/bans.js\";\nimport { CommentsClient } from \"./content/comments.js\";\nimport { FavoritesClient } from \"./content/favorites.js\";\nimport { ModerationClient } from \"./content/moderation.js\";\nimport { PollsClient } from \"./content/polls.js\";\nimport { ReactionsClient } from \"./content/reactions.js\";\nimport type { Batch, Config, ContentModel, RefBody, Result } from \"./generated/wire.js\";\nimport { DiscoveryClient } from \"./discovery.js\";\nimport { GroupsClient } from \"./groups.js\";\nimport { OffersClient } from \"./offers.js\";\nimport { StatsClient } from \"./stats.js\";\nimport { VersionsClient } from \"./versions.js\";\nimport { Http, type ContentKitChange, type ContentKitModule, type HttpOptions } from \"./http.js\";\nimport { MediaClient, type ContentFolders, type MediaOptions } from \"./media/client.js\";\nimport { call } from \"./route.js\";\nimport { NotificationsClient } from \"./notifications.js\";\n\nexport interface ContentKitClientOptions extends HttpOptions {\n  /** Upload tuning (transport, part concurrency, retries). */\n  media?: MediaOptions;\n  /** The media kind of poll folders, when the host renamed it (content.Media). */\n  folders?: ContentFolders;\n}\n\n/**\n * One ContentKit deployment as the browser sees it. Each module is a property\n * over one shared transport (mounts, auth, language, errors, change events).\n */\nexport interface ContentKitClient {\n  /** Uploads, multipart, commits, reads, frames, HLS bases, the HLS loader and inline images. */\n  readonly media: MediaClient;\n  /** Content items: reads, and writes for their creators, owner-group editors and staff. */\n  readonly contents: ContentsClient;\n  /** The catalog's totals by kind, language and audience. */\n  readonly catalog: CatalogClient;\n  /** Threads, replies, edits, tombstones, reactions, standing, the latest feed, moderation. */\n  readonly comments: CommentsClient;\n  /** Likes and dislikes of an item. */\n  readonly reactions: ReactionsClient;\n  /** The signed-in caller's favorites. */\n  readonly favorites: FavoritesClient;\n  /** Polls: votes, free-text answers and the staff editor. */\n  readonly polls: PollsClient;\n  /** Comment bans, owner and global. */\n  readonly bans: BansClient;\n  /** The review queue of held comments and content. */\n  readonly moderation: ModerationClient;\n  /** Groups: listings, pages, staff writes and memberships. */\n  readonly groups: GroupsClient;\n  /** Lists, search, typeahead, rails, release dates, content filters, history, signals and exposures. */\n  readonly discovery: DiscoveryClient;\n  /** Content versions: reader plans, reader metadata, forks and downloads. */\n  readonly versions: VersionsClient;\n  /** Offers on contents, versions and groups; group joins; the reader's library. */\n  readonly offers: OffersClient;\n  /** Content-code lookup. */\n  readonly codes: CodesClient;\n  /** Staff activity and rankings; the signed-in reader's own statistics. */\n  readonly stats: StatsClient;\n  /** The signed-in person's native and imported notifications. */\n  readonly notifications: NotificationsClient;\n\n  /** What the content module allows: which interactions signed-out visitors may make. */\n  config(signal?: AbortSignal): Promise<Config>;\n  /** The site's content model: languages, tiers, kinds, group kinds and content filters. */\n  kinds(signal?: AbortSignal): Promise<ContentModel>;\n  /** Staff bulk import (root:import:write): groups, contents, memberships, offers and aliases, idempotent per source. */\n  import(batch: Batch): Promise<Result>;\n  /** A module's base URL as configured (no trailing slash). */\n  url(module: ContentKitModule, ref?: RefBody): string;\n  /** Cache context only, not authentication. The React provider keeps this in sync. */\n  setReadScope(scope: string): void;\n  /** Every successful mutation; a null scope means its data predates a context change. */\n  subscribe(listener: (change: ContentKitChange, scope: string | null) => void): () => void;\n}\n\nexport function createContentKitClient(options: ContentKitClientOptions): ContentKitClient {\n  const { media: mediaOptions, folders, ...http } = options;\n  const h = new Http(http);\n  const media = new MediaClient(h, mediaOptions, folders);\n  return {\n    media,\n    contents: new ContentsClient(h),\n    catalog: new CatalogClient(h),\n    comments: new CommentsClient(h),\n    reactions: new ReactionsClient(h),\n    favorites: new FavoritesClient(h),\n    polls: new PollsClient(h, media),\n    bans: new BansClient(h),\n    moderation: new ModerationClient(h),\n    groups: new GroupsClient(h, media),\n    discovery: new DiscoveryClient(h),\n    versions: new VersionsClient(h),\n    offers: new OffersClient(h),\n    codes: new CodesClient(h),\n    stats: new StatsClient(h),\n    notifications: new NotificationsClient(h),\n    config: (signal) => call(h, \"GET\", \"/config\", { signal }),\n    kinds: (signal) => call(h, \"GET\", \"/kinds\", { signal }),\n    import: (batch) => call(h, \"POST\", \"/import\", { body: batch }),\n    url: (module, ref) => h.mount(module, ref),\n    setReadScope: (scope) => h.setReadScope(scope),\n    subscribe: (listener) => h.subscribe(listener),\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AA+EA,SAAgB,EAAuB,GAAoD;CACzF,IAAM,EAAE,OAAO,GAAc,YAAS,GAAG,MAAS,GAC5C,IAAI,IAAI,EAAK,CAAI,GACjB,IAAQ,IAAI,EAAY,GAAG,GAAc,CAAO;CACtD,OAAO;EACL;EACA,UAAU,IAAI,EAAe,CAAC;EAC9B,SAAS,IAAI,EAAc,CAAC;EAC5B,UAAU,IAAI,EAAe,CAAC;EAC9B,WAAW,IAAI,EAAgB,CAAC;EAChC,WAAW,IAAI,EAAgB,CAAC;EAChC,OAAO,IAAI,EAAY,GAAG,CAAK;EAC/B,MAAM,IAAI,EAAW,CAAC;EACtB,YAAY,IAAI,EAAiB,CAAC;EAClC,QAAQ,IAAI,EAAa,GAAG,CAAK;EACjC,WAAW,IAAI,EAAgB,CAAC;EAChC,UAAU,IAAI,EAAe,CAAC;EAC9B,QAAQ,IAAI,EAAa,CAAC;EAC1B,OAAO,IAAI,EAAY,CAAC;EACxB,OAAO,IAAI,EAAY,CAAC;EACxB,eAAe,IAAI,EAAoB,CAAC;EACxC,SAAS,MAAW,EAAK,GAAG,OAAO,WAAW,EAAE,UAAO,CAAC;EACxD,QAAQ,MAAW,EAAK,GAAG,OAAO,UAAU,EAAE,UAAO,CAAC;EACtD,SAAS,MAAU,EAAK,GAAG,QAAQ,WAAW,EAAE,MAAM,EAAM,CAAC;EAC7D,MAAM,GAAQ,MAAQ,EAAE,MAAM,GAAQ,CAAG;EACzC,eAAe,MAAU,EAAE,aAAa,CAAK;EAC7C,YAAY,MAAa,EAAE,UAAU,CAAQ;CAC/C;AACF"}

package/dist/client/http.d.ts

@@ -60,16 +60,13 @@ export interface HttpOptions {
     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.
-     */
+    /** Bearer for API calls and HLS playlists. 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. */
+    /** Default "same-origin"; "include" also sends cookies with HLS segment requests. */
     credentials?: RequestCredentials;
 }
 export interface RequestOptions {
@@ -80,6 +77,13 @@ export interface RequestOptions {
     blob?: boolean;
     keepalive?: boolean;
 }
+/** How a player loads HLS: the media client's `hls`. */
+export interface HlsLoader {
+    /** Fetches a playlist or sprite VTT with the app's credentials. */
+    playlist(url: string, signal?: AbortSignal): Promise<Response>;
+    /** hls.js `xhrSetup` for segments: cookies, never the app's credentials. */
+    segment(xhr: XMLHttpRequest, url: string): void;
+}
 /** The transport every module shares: mounts, auth, language, errors and change events. */
 export declare class Http {
     private readonly o;
@@ -91,10 +95,11 @@ export declare class Http {
     mount(module: ContentKitModule, ref?: RefBody): string;
     request<T>(url: string, { method, body, signal, blob, keepalive }?: 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).
+     * How players load this API's HLS. Playlists and sprite VTTs go through
+     * the client's fetch, so they carry what its other calls carry (a DPoP
+     * proof when that fetch adds one); segments only carry cookies.
      */
-    readonly xhrSetup: (xhr: XMLHttpRequest, url: string) => Promise<void>;
+    readonly hls: HlsLoader;
     setReadScope(key: string): void;
     /** Capture before awaiting a write; null tells caches to refetch after a scope change. */
     captureChanges(): (change: ContentKitChange) => void;

package/dist/client/http.js

@@ -41,10 +41,22 @@ var r = (e) => e.replace(/\/+$/, ""), i = class {
 		if (!f.ok) throw await e(f);
 		return o ? 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}`);
+	hls = {
+		playlist: async (e, t) => {
+			let n = {
+				credentials: this.o.credentials ?? "same-origin",
+				signal: t ?? null
+			};
+			if (!this.onApiOrigin(e)) return fetch(e, n);
+			let r = await this.o.token?.();
+			return (this.o.fetch ?? fetch)(e, r ? {
+				...n,
+				headers: { Authorization: `Bearer ${r}` }
+			} : n);
+		},
+		segment: (e, t) => {
+			e.readyState || e.open("GET", t, !0), this.o.credentials === "include" && (e.withCredentials = !0);
+		}
 	};
 	setReadScope(e) {
 		e !== this.readScope.key && (this.readScope = { key: e });

package/dist/client/http.js.map

@@ -1 +1 @@
-{"version":3,"file":"http.js","names":[],"sources":["../../src/client/http.ts"],"sourcesContent":["import { readContentKitError, requestFailure } from \"./errors.js\";\nimport type { ContentChange } from \"./content/types.js\";\nimport { CONTENTKIT_MODULES } from \"./generated/routes.js\";\nimport type { FileInfo, Item, 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 (CONTENTKIT_MODULES: the API version, then the\n * module's path). A mount is the module's full base URL.\n */\nexport interface ContentKitMounts {\n  /** Comments, reactions, favorites, polls, bans, moderation. Default `{baseUrl}/v1`. */\n  content?: string;\n  /** Content items and catalog totals. Default `{baseUrl}/v1`. */\n  contents?: string;\n  /** Media reads and HLS playlists. Default `{baseUrl}/v1/media`. */\n  media?: Mount;\n  /** Uploads and commits. Default `{baseUrl}/v1/media/upload`. */\n  upload?: Mount;\n  /** Content-code lookup. Default `{baseUrl}/v1/codes`. */\n  codes?: string;\n  /** Groups. Default `{baseUrl}/v1`. */\n  groups?: string;\n  /** The site's content model. Default `{baseUrl}/v1`. */\n  kinds?: string;\n  /** User inbox. Default `{baseUrl}/v1/notifications`. */\n  notifications?: string;\n  /** Content versions: reader plans, reader metadata, forks, downloads. Default `{baseUrl}/v1`. */\n  versions?: string;\n  /** Offers, group joins and the library. Default `{baseUrl}/v1`. */\n  offers?: string;\n  /** Discovery: lists, search, typeahead, similar, recommendations, history, signals. Default `{baseUrl}/v1`. */\n  discovery?: string;\n  /** Bulk import (a service's). Default `{baseUrl}/v1`. */\n  import?: 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  | { type: \"notifications.changed\" }\n  | { type: \"notifications.updated\"; item: Item }\n  | ContentChange;\n\nexport type TokenSource = () => string | null | undefined | Promise<string | null | undefined>;\n\nexport interface HttpOptions {\n  /** Where the host mounts ContentKit's routes (contentkit.Routes.Prefix), e.g. \"/api/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  keepalive?: 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, scope: string | null) => void>();\n  private readScope = { key: \"{}\" };\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    return this.base + CONTENTKIT_MODULES[module];\n  }\n\n  async request<T>(url: string, { method, body, signal, blob, keepalive }: 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        ...(keepalive ? { keepalive } : {}),\n      });\n    } catch (err) {\n      throw requestFailure(err, signal, `ContentKit API ${new URL(url, \"http://x\").pathname}`);\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  setReadScope(key: string): void {\n    if (key !== this.readScope.key) this.readScope = { key };\n  }\n\n  /** Capture before awaiting a write; null tells caches to refetch after a scope change. */\n  captureChanges(): (change: ContentKitChange) => void {\n    const scope = this.readScope;\n    return (change) => this.emit(change, scope === this.readScope ? scope.key : null);\n  }\n\n  subscribe(listener: (change: ContentKitChange, scope: string | null) => void): () => void {\n    this.listeners.add(listener);\n    return () => void this.listeners.delete(listener);\n  }\n\n  private emit(change: ContentKitChange, scope: string | null): void {\n    for (const l of this.listeners) {\n      try {\n        l(change, scope);\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":";;;AAkFA,IAAM,KAAQ,MAAc,EAAE,QAAQ,QAAQ,EAAE,GAGnC,IAAb,MAAkB;CAKa;CAJ7B,4BAA6B,IAAI,IAA8D;CAC/F,YAAoB,EAAE,KAAK,KAAK;CAChC;CAEA,YAAY,GAAiC;EAC3C,IAD2B,KAAA,IAAA,GACvB,OAAO,EAAE,WAAY,UAAU,MAAU,MAAM,kDAAkD;EACrG,KAAK,OAAO,EAAK,EAAE,OAAO;CAC5B;CAGA,MAAM,GAA0B,GAAuB;EACrD,IAAM,IAAI,KAAK,EAAE,SAAS;EAC1B,IAAI,OAAO,KAAM,YAAY;GAC3B,IAAI,CAAC,GAAK,MAAU,MAAM,mBAAmB,EAAO,+BAA+B;GACnF,OAAO,EAAK,EAAE,CAAG,CAAC;EACpB;EAEA,OADI,MAAM,KAAA,IACH,KAAK,OAAO,EAAmB,KADV,EAAK,CAAC;CAEpC;CAEA,MAAM,QAAW,GAAa,EAAE,WAAQ,SAAM,WAAQ,SAAM,iBAA8B,CAAC,GAAe;EACxG,IAAM,IAAI,KAAK,EAAE,SAAS,OACpB,IAAU,IAAI,QAAQ,MAAM,KAAK,EAAE,UAAU,CAAC;EACpD,AAAI,MAAS,KAAA,KAAW,EAAQ,IAAI,gBAAgB,kBAAkB;EACtE,IAAM,IAAQ,MAAM,KAAK,EAAE,QAAQ;EACnC,AAAI,KAAS,CAAC,EAAQ,IAAI,eAAe,KAAG,EAAQ,IAAI,iBAAiB,UAAU,GAAO;EAC1F,IAAM,IAAO,KAAK,EAAE,WAAW;EAC/B,AAAI,KAAM,EAAQ,IAAI,mBAAmB,CAAI;EAC7C,IAAI;EACJ,IAAI;GACF,IAAM,MAAM,EAAE,GAAK;IACjB,QAAQ,MAAW,MAAS,KAAA,IAAY,QAAQ;IAChD;IACA,MAAM,MAAS,KAAA,IAAY,OAAO,KAAK,UAAU,CAAI;IACrD,aAAa,KAAK,EAAE,eAAe;IACnC,QAAQ,KAAU;IAClB,GAAI,IAAY,EAAE,aAAU,IAAI,CAAC;GACnC,CAAC;EACH,SAAS,GAAK;GACZ,MAAM,EAAe,GAAK,GAAQ,kBAAkB,IAAI,IAAI,GAAK,UAAU,CAAC,CAAC,UAAU;EACzF;EACA,IAAI,CAAC,EAAI,IAAI,MAAM,MAAM,EAAoB,CAAG;EAEhD,OADI,IAAc,MAAM,EAAI,KAAK,IACzB,EAAI,WAAW,MAAM,KAAA,IAAY,MAAM,EAAI,KAAK;CAC1D;CAMA,WAAoB,OAAO,GAAqB,MAA+B;EAG7E,IAFK,EAAI,cAAY,EAAI,KAAK,OAAO,GAAK,EAAI,GAC1C,KAAK,EAAE,gBAAgB,cAAW,EAAI,kBAAkB,KACxD,CAAC,KAAK,YAAY,CAAG,GAAG;EAC5B,IAAM,IAAQ,MAAM,KAAK,EAAE,QAAQ;EACnC,AAAI,KAAO,EAAI,iBAAiB,iBAAiB,UAAU,GAAO;CACpE;CAEA,aAAa,GAAmB;EAC9B,AAAI,MAAQ,KAAK,UAAU,QAAK,KAAK,YAAY,EAAE,OAAI;CACzD;CAGA,iBAAqD;EACnD,IAAM,IAAQ,KAAK;EACnB,QAAQ,MAAW,KAAK,KAAK,GAAQ,MAAU,KAAK,YAAY,EAAM,MAAM,IAAI;CAClF;CAEA,UAAU,GAAgF;EAExF,OADA,KAAK,UAAU,IAAI,CAAQ,SACd,KAAK,KAAK,UAAU,OAAO,CAAQ;CAClD;CAEA,KAAa,GAA0B,GAA4B;EACjE,KAAK,IAAM,KAAK,KAAK,WACnB,IAAI;GACF,EAAE,GAAQ,CAAK;EACjB,SAAS,GAAG;GAEV,QAAQ,MAAM,sCAAsC,CAAC;EACvD;CAEJ;CAEA,YAAoB,GAAsB;EACxC,IAAM,IAAO,OAAO,WAAa,MAAc,qBAAqB,SAAS;EAC7E,IAAI;GACF,OAAO,IAAI,IAAI,GAAK,CAAI,CAAC,CAAC,WAAW,IAAI,IAAI,KAAK,QAAQ,KAAK,CAAI,CAAC,CAAC;EACvE,QAAQ;GACN,OAAO;EACT;CACF;AACF"}
+{"version":3,"file":"http.js","names":[],"sources":["../../src/client/http.ts"],"sourcesContent":["import { readContentKitError, requestFailure } from \"./errors.js\";\nimport type { ContentChange } from \"./content/types.js\";\nimport { CONTENTKIT_MODULES } from \"./generated/routes.js\";\nimport type { FileInfo, Item, 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 (CONTENTKIT_MODULES: the API version, then the\n * module's path). A mount is the module's full base URL.\n */\nexport interface ContentKitMounts {\n  /** Comments, reactions, favorites, polls, bans, moderation. Default `{baseUrl}/v1`. */\n  content?: string;\n  /** Content items and catalog totals. Default `{baseUrl}/v1`. */\n  contents?: string;\n  /** Media reads and HLS playlists. Default `{baseUrl}/v1/media`. */\n  media?: Mount;\n  /** Uploads and commits. Default `{baseUrl}/v1/media/upload`. */\n  upload?: Mount;\n  /** Content-code lookup. Default `{baseUrl}/v1/codes`. */\n  codes?: string;\n  /** Groups. Default `{baseUrl}/v1`. */\n  groups?: string;\n  /** The site's content model. Default `{baseUrl}/v1`. */\n  kinds?: string;\n  /** User inbox. Default `{baseUrl}/v1/notifications`. */\n  notifications?: string;\n  /** Content versions: reader plans, reader metadata, forks, downloads. Default `{baseUrl}/v1`. */\n  versions?: string;\n  /** Offers, group joins and the library. Default `{baseUrl}/v1`. */\n  offers?: string;\n  /** Discovery: lists, search, typeahead, similar, recommendations, history, signals. Default `{baseUrl}/v1`. */\n  discovery?: string;\n  /** Bulk import (a service's). Default `{baseUrl}/v1`. */\n  import?: 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  | { type: \"notifications.changed\" }\n  | { type: \"notifications.updated\"; item: Item }\n  | ContentChange;\n\nexport type TokenSource = () => string | null | undefined | Promise<string | null | undefined>;\n\nexport interface HttpOptions {\n  /** Where the host mounts ContentKit's routes (contentkit.Routes.Prefix), e.g. \"/api/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  /** Bearer for API calls and HLS playlists. An authenticating fetch overrides it. */\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 segment 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  keepalive?: boolean;\n}\n\nconst trim = (u: string) => u.replace(/\\/+$/, \"\");\n\n/** How a player loads HLS: the media client's `hls`. */\nexport interface HlsLoader {\n  /** Fetches a playlist or sprite VTT with the app's credentials. */\n  playlist(url: string, signal?: AbortSignal): Promise<Response>;\n  /** hls.js `xhrSetup` for segments: cookies, never the app's credentials. */\n  segment(xhr: XMLHttpRequest, url: string): void;\n}\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, scope: string | null) => void>();\n  private readScope = { key: \"{}\" };\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    return this.base + CONTENTKIT_MODULES[module];\n  }\n\n  async request<T>(url: string, { method, body, signal, blob, keepalive }: 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        ...(keepalive ? { keepalive } : {}),\n      });\n    } catch (err) {\n      throw requestFailure(err, signal, `ContentKit API ${new URL(url, \"http://x\").pathname}`);\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   * How players load this API's HLS. Playlists and sprite VTTs go through\n   * the client's fetch, so they carry what its other calls carry (a DPoP\n   * proof when that fetch adds one); segments only carry cookies.\n   */\n  readonly hls: HlsLoader = {\n    playlist: async (url, signal) => {\n      const init: RequestInit = { credentials: this.o.credentials ?? \"same-origin\", signal: signal ?? null };\n      if (!this.onApiOrigin(url)) return fetch(url, init);\n      const token = await this.o.token?.();\n      return (this.o.fetch ?? fetch)(url, token ? { ...init, headers: { Authorization: `Bearer ${token}` } } : init);\n    },\n    segment: (xhr, url) => {\n      if (!xhr.readyState) xhr.open(\"GET\", url, true);\n      if (this.o.credentials === \"include\") xhr.withCredentials = true;\n    },\n  };\n\n  setReadScope(key: string): void {\n    if (key !== this.readScope.key) this.readScope = { key };\n  }\n\n  /** Capture before awaiting a write; null tells caches to refetch after a scope change. */\n  captureChanges(): (change: ContentKitChange) => void {\n    const scope = this.readScope;\n    return (change) => this.emit(change, scope === this.readScope ? scope.key : null);\n  }\n\n  subscribe(listener: (change: ContentKitChange, scope: string | null) => void): () => void {\n    this.listeners.add(listener);\n    return () => void this.listeners.delete(listener);\n  }\n\n  private emit(change: ContentKitChange, scope: string | null): void {\n    for (const l of this.listeners) {\n      try {\n        l(change, scope);\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/index.d.ts

@@ -1,5 +1,5 @@
 export { createContentKitClient, type ContentKitClient, type ContentKitClientOptions } from './client.js';
-export type { ContentKitChange, ContentKitModule, ContentKitMounts, Mount, TokenSource } from './http.js';
+export type { ContentKitChange, ContentKitModule, ContentKitMounts, HlsLoader, Mount, TokenSource } from './http.js';
 export { CLIENT_ERROR_CODES, ContentKitError, ERROR_CODES, failureError, isContentKitError, readContentKitError, toContentKitError, transportFailure, type ContentKitErrorCode, type ContentKitErrorInit, } from './errors.js';
 export { IMAGE_SCHEME, imageRef, imageRefs, ContentsClient, type ManageQuery } from './contents.js';
 export { CatalogClient, type CatalogTotalsQuery } from './catalog.js';

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

@@ -1,5 +1,5 @@
 import { CommitBody, Edit, FileInfo, InlineImage, Op, PresetRule, ReadResult, RefBody } from '../generated/wire.js';
-import { Http } from '../http.js';
+import { HlsLoader, Http } from '../http.js';
 import { MediaApi, ReadOptions } from './api.js';
 import { Transport } from './transport.js';
 /** Upload tuning for the media module. */
@@ -219,8 +219,8 @@ export declare class MediaClient {
     getFrame(ref: RefBody, path: string, t: number, w?: number, signal?: AbortSignal): Promise<Blob>;
     /** The folder of an HLS ladder from a read's `hls`: `{media}/{kind}/{id}/hls/{dir}`; master.m3u8 and sprite.vtt resolve under it. */
     hlsBase(ref: RefBody, dir: string): string;
-    /** hls.js `xhrSetup` for playlists on the API (the client's token and credentials); pass it to players as is. */
-    get xhrSetup(): (xhr: XMLHttpRequest, url: string) => Promise<void>;
+    /** How players load HLS from this API (playlists through the client's fetch); pass it to players as is. */
+    get hls(): HlsLoader;
     /**
      * Uploads an image to the item's server-named upload path and commits it
      * (by default waiting until it is processed); resolves with the name content

package/dist/client/media/client.js

@@ -203,8 +203,8 @@ var d = /^i-[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/, f =
 	hlsBase(e, t) {
 		return `${this.api.itemURL(e)}/hls/${t}`;
 	}
-	get xhrSetup() {
-		return this.http.xhrSetup;
+	get hls() {
+		return this.http.hls;
 	}
 	async uploadNamed(t, n, r = {}) {
 		let i = await this.put(n, {

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  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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"}
+{"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 { HlsLoader, 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  /** How players load HLS from this API (playlists through the client's fetch); pass it to players as is. */\n  get hls(): HlsLoader {\n    return this.http.hls;\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/components/hover-preview.js

@@ -7,7 +7,7 @@ import { jsx as a } from "react/jsx-runtime";
 function o({ item: o, dir: s = "hls/", duration: c, start: l, available: u = !0, target: d, enabled: f, abr: p, className: m, client: h }) {
 	let { media: g } = t(h), [_, v] = i(null), y = n({
 		src: `${g.hlsBase(o, s)}master.m3u8`,
-		xhrSetup: g.xhrSetup,
+		loader: g.hls,
 		abr: p,
 		qualityKey: null
 	}), b = c ?? 0, x = Math.max(0, l ?? (b > 1 ? Math.min(b * .1, b - 1) : 0));

package/dist/components/hover-preview.js.map

@@ -1 +1 @@
-{"version":3,"file":"hover-preview.js","names":[],"sources":["../../src/components/hover-preview.tsx"],"sourcesContent":["import { useCallback, useState } from \"react\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport type { RefBody } from \"../client/generated/wire.js\";\nimport { useContentKitClient } from \"../react/context.js\";\nimport { useHlsPlayer, type HlsPlayerOptions } from \"../react/gallery.js\";\nimport { useInlinePreview } from \"../react/inline-preview.js\";\n\nexport interface HoverPreviewProps extends Pick<HlsPlayerOptions, \"abr\"> {\n  /** The video item. */\n  item: RefBody;\n  /** Its HLS folder (a read's `hls` entry). Default \"hls/\". */\n  dir?: string;\n  /** Seconds; the preview starts 10% in. */\n  duration?: number;\n  /** Where the preview starts, seconds; overrides the 10% default. */\n  start?: number;\n  /** The viewer may play it (free, or entitled). Default true. */\n  available?: boolean;\n  /** What is hovered (fine pointers) or watched for visibility (touch); default the preview's parent, the card. */\n  target?: HTMLElement | null;\n  /** Previews on; default the provider's `inlinePreview`. */\n  enabled?: boolean;\n  className?: string;\n  client?: ContentKitClient;\n}\n\n/**\n * A card's muted inline preview: the item's real HLS stream through the\n * client (its base and playlist auth) at the lowest rendition, fading in over\n * the card's thumbnail on hover, or while it is the most visible card on\n * touch screens. One plays page-wide; none with reduced motion or Save-Data.\n * Place it inside the card, which must be positioned.\n */\nexport function HoverPreview({ item, dir = \"hls/\", duration, start, available = true, target, enabled, abr, className, client: own }: HoverPreviewProps) {\n  const { media } = useContentKitClient(own);\n  const [el, setEl] = useState<HTMLVideoElement | null>(null);\n  const player = useHlsPlayer({ src: `${media.hlsBase(item, dir)}master.m3u8`, xhrSetup: media.xhrSetup, abr, qualityKey: null });\n  const d = duration ?? 0;\n  const at = Math.max(0, start ?? (d > 1 ? Math.min(d * 0.1, d - 1) : 0));\n  useInlinePreview({ setting: enabled, available, target: target ?? el?.parentElement ?? null, start: () => player.preview(at), stop: player.unload });\n  const attach = player.ref;\n  const ref = useCallback(\n    (v: HTMLVideoElement | null) => {\n      attach(v);\n      setEl(v);\n    },\n    [attach],\n  );\n  return (\n    <video\n      ref={ref}\n      muted\n      playsInline\n      preload=\"none\"\n      aria-hidden\n      tabIndex={-1}\n      className={className}\n      style={{\n        position: \"absolute\",\n        inset: 0,\n        width: \"100%\",\n        height: \"100%\",\n        objectFit: \"cover\",\n        pointerEvents: \"none\",\n        opacity: player.previewing && player.status === \"playing\" ? 1 : 0,\n        transition: \"opacity 200ms\",\n      }}\n      data-ckui=\"hover-preview\"\n      data-playing={player.previewing && player.status === \"playing\" ? \"\" : undefined}\n    />\n  );\n}\n"],"mappings":";;;;;;AAiCA,SAAgB,EAAa,EAAE,SAAM,SAAM,QAAQ,aAAU,UAAO,eAAY,IAAM,WAAQ,YAAS,QAAK,cAAW,QAAQ,KAA0B;CACvJ,IAAM,EAAE,aAAU,EAAoB,CAAG,GACnC,CAAC,GAAI,KAAS,EAAkC,IAAI,GACpD,IAAS,EAAa;EAAE,KAAK,GAAG,EAAM,QAAQ,GAAM,CAAG,EAAE;EAAc,UAAU,EAAM;EAAU;EAAK,YAAY;CAAK,CAAC,GACxH,IAAI,KAAY,GAChB,IAAK,KAAK,IAAI,GAAG,MAAU,IAAI,IAAI,KAAK,IAAI,IAAI,IAAK,IAAI,CAAC,IAAI,EAAE;CACtE,EAAiB;EAAE,SAAS;EAAS;EAAW,QAAQ,KAAU,GAAI,iBAAiB;EAAM,aAAa,EAAO,QAAQ,CAAE;EAAG,MAAM,EAAO;CAAO,CAAC;CACnJ,IAAM,IAAS,EAAO,KAChB,IAAM,GACT,MAA+B;EAE9B,AADA,EAAO,CAAC,GACR,EAAM,CAAC;CACT,GACA,CAAC,CAAM,CACT;CACA,OACE,kBAAC,SAAD;EACO;EACL,OAAA;EACA,aAAA;EACA,SAAQ;EACR,eAAA;EACA,UAAU;EACC;EACX,OAAO;GACL,UAAU;GACV,OAAO;GACP,OAAO;GACP,QAAQ;GACR,WAAW;GACX,eAAe;GACf,SAAS,EAAO,cAAc,EAAO,WAAW,YAAY,IAAI;GAChE,YAAY;EACd;EACA,aAAU;EACV,gBAAc,EAAO,cAAc,EAAO,WAAW,YAAY,KAAK,KAAA;CACvE,CAAA;AAEL"}
+{"version":3,"file":"hover-preview.js","names":[],"sources":["../../src/components/hover-preview.tsx"],"sourcesContent":["import { useCallback, useState } from \"react\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport type { RefBody } from \"../client/generated/wire.js\";\nimport { useContentKitClient } from \"../react/context.js\";\nimport { useHlsPlayer, type HlsPlayerOptions } from \"../react/gallery.js\";\nimport { useInlinePreview } from \"../react/inline-preview.js\";\n\nexport interface HoverPreviewProps extends Pick<HlsPlayerOptions, \"abr\"> {\n  /** The video item. */\n  item: RefBody;\n  /** Its HLS folder (a read's `hls` entry). Default \"hls/\". */\n  dir?: string;\n  /** Seconds; the preview starts 10% in. */\n  duration?: number;\n  /** Where the preview starts, seconds; overrides the 10% default. */\n  start?: number;\n  /** The viewer may play it (free, or entitled). Default true. */\n  available?: boolean;\n  /** What is hovered (fine pointers) or watched for visibility (touch); default the preview's parent, the card. */\n  target?: HTMLElement | null;\n  /** Previews on; default the provider's `inlinePreview`. */\n  enabled?: boolean;\n  className?: string;\n  client?: ContentKitClient;\n}\n\n/**\n * A card's muted inline preview: the item's real HLS stream through the\n * client (its base and playlist auth) at the lowest rendition, fading in over\n * the card's thumbnail on hover, or while it is the most visible card on\n * touch screens. One plays page-wide; none with reduced motion or Save-Data.\n * Place it inside the card, which must be positioned.\n */\nexport function HoverPreview({ item, dir = \"hls/\", duration, start, available = true, target, enabled, abr, className, client: own }: HoverPreviewProps) {\n  const { media } = useContentKitClient(own);\n  const [el, setEl] = useState<HTMLVideoElement | null>(null);\n  const player = useHlsPlayer({ src: `${media.hlsBase(item, dir)}master.m3u8`, loader: media.hls, abr, qualityKey: null });\n  const d = duration ?? 0;\n  const at = Math.max(0, start ?? (d > 1 ? Math.min(d * 0.1, d - 1) : 0));\n  useInlinePreview({ setting: enabled, available, target: target ?? el?.parentElement ?? null, start: () => player.preview(at), stop: player.unload });\n  const attach = player.ref;\n  const ref = useCallback(\n    (v: HTMLVideoElement | null) => {\n      attach(v);\n      setEl(v);\n    },\n    [attach],\n  );\n  return (\n    <video\n      ref={ref}\n      muted\n      playsInline\n      preload=\"none\"\n      aria-hidden\n      tabIndex={-1}\n      className={className}\n      style={{\n        position: \"absolute\",\n        inset: 0,\n        width: \"100%\",\n        height: \"100%\",\n        objectFit: \"cover\",\n        pointerEvents: \"none\",\n        opacity: player.previewing && player.status === \"playing\" ? 1 : 0,\n        transition: \"opacity 200ms\",\n      }}\n      data-ckui=\"hover-preview\"\n      data-playing={player.previewing && player.status === \"playing\" ? \"\" : undefined}\n    />\n  );\n}\n"],"mappings":";;;;;;AAiCA,SAAgB,EAAa,EAAE,SAAM,SAAM,QAAQ,aAAU,UAAO,eAAY,IAAM,WAAQ,YAAS,QAAK,cAAW,QAAQ,KAA0B;CACvJ,IAAM,EAAE,aAAU,EAAoB,CAAG,GACnC,CAAC,GAAI,KAAS,EAAkC,IAAI,GACpD,IAAS,EAAa;EAAE,KAAK,GAAG,EAAM,QAAQ,GAAM,CAAG,EAAE;EAAc,QAAQ,EAAM;EAAK;EAAK,YAAY;CAAK,CAAC,GACjH,IAAI,KAAY,GAChB,IAAK,KAAK,IAAI,GAAG,MAAU,IAAI,IAAI,KAAK,IAAI,IAAI,IAAK,IAAI,CAAC,IAAI,EAAE;CACtE,EAAiB;EAAE,SAAS;EAAS;EAAW,QAAQ,KAAU,GAAI,iBAAiB;EAAM,aAAa,EAAO,QAAQ,CAAE;EAAG,MAAM,EAAO;CAAO,CAAC;CACnJ,IAAM,IAAS,EAAO,KAChB,IAAM,GACT,MAA+B;EAE9B,AADA,EAAO,CAAC,GACR,EAAM,CAAC;CACT,GACA,CAAC,CAAM,CACT;CACA,OACE,kBAAC,SAAD;EACO;EACL,OAAA;EACA,aAAA;EACA,SAAQ;EACR,eAAA;EACA,UAAU;EACC;EACX,OAAO;GACL,UAAU;GACV,OAAO;GACP,OAAO;GACP,QAAQ;GACR,WAAW;GACX,eAAe;GACf,SAAS,EAAO,cAAc,EAAO,WAAW,YAAY,IAAI;GAChE,YAAY;EACd;EACA,aAAU;EACV,gBAAc,EAAO,cAAc,EAAO,WAAW,YAAY,KAAK,KAAA;CACvE,CAAA;AAEL"}

package/dist/components/media-gallery.d.ts

@@ -5,11 +5,11 @@ import { GalleryViewOptions, HlsPlayerOptions } from '../react/gallery.js';
 import { PublicPreset } from '../client/public.js';
 import { ContentKitClient } from '../client/client.js';
 import { ReadResult, RefBody } from '../client/generated/wire.js';
-export interface MediaGalleryProps extends GalleryViewOptions, Pick<HlsPlayerOptions, "xhrSetup" | "refresh" | "abr"> {
+export interface MediaGalleryProps extends GalleryViewOptions, Pick<HlsPlayerOptions, "loader" | "refresh" | "abr"> {
     /**
      * The item to show, read through the client: its read (refreshed before
      * the URLs expire, after commits), HLS bases, playlist auth and grant
-     * refresh. Or pass `read` (and hlsBase, xhrSetup, refresh) yourself.
+     * refresh. Or pass `read` (and hlsBase, loader, refresh) yourself.
      */
     item?: RefBody;
     /** With item: only files under this path prefix. */

package/dist/components/media-gallery.js

@@ -114,7 +114,7 @@ function W(e) {
 		...e,
 		read: n.read,
 		hlsBase: e.hlsBase ?? i,
-		xhrSetup: e.xhrSetup ?? t.media.xhrSetup,
+		loader: e.loader ?? t.media.hls,
 		refresh: e.refresh ?? n.refresh
 	};
 }
@@ -253,7 +253,7 @@ function q({ ctx: e, item: t, position: n, active: i, lightbox: a }) {
 		height: s.h,
 		duration: s.dur,
 		active: i,
-		xhrSetup: e.xhrSetup,
+		loader: e.loader,
 		refresh: e.refresh,
 		expires: e.read?.expires,
 		abr: e.abr,
@@ -450,7 +450,7 @@ function ee({ ctx: e, item: r, label: i, onOpen: a }) {
 				className: "absolute inset-0 size-full object-cover"
 			}) : d ? /* @__PURE__ */ T(g, {
 				vtt: `${d}sprite.vtt`,
-				xhrSetup: e.xhrSetup,
+				loader: e.loader,
 				fit: "cover"
 			}) : null,
 			d && /* @__PURE__ */ T(te, {
@@ -493,7 +493,7 @@ function ee({ ctx: e, item: r, label: i, onOpen: a }) {
 function te({ ctx: t, base: n, start: r, target: i }) {
 	let a = m({
 		src: `${n}master.m3u8`,
-		xhrSetup: t.xhrSetup,
+		loader: t.loader,
 		refresh: t.refresh,
 		expires: t.read?.expires,
 		abr: t.abr,