@openrails/contentkit-ui 0.87.0-rc.1 → 0.88.0

package/README.md

@@ -93,14 +93,16 @@ operation. This does not change the operation's result or its authentication.
   `groups.uploadCover(group, file)` its cover; `client.kinds()` the content model.
 - **Images of content and polls** go to the item's server-named upload path:
   `media.uploadNamed(ref, file)` resolves the name content routes take
-  (`contents.setCover`); `media.uploadInline({kind, id}, file)` resolves a
-  body image's reference (`ref`, `contentkit:i-{uuid}`, what the body stores:
+  (`contents.setCover(id, version, name)`: every file of a content lives in a
+  version); `media.uploadInline({kind, id, version}, file)` puts a body image
+  in the version's private files, copied into the other versions, and
+  resolves its reference (`ref`, `contentkit:i-{uuid}`, what the body stores:
   `imageRef(name)`) and a URL that shows it now; `polls.uploadImage` and
   `polls.uploadOptionImage` do both steps. Reads resolve references: a
-  content's `body` shows the images' current public files and `images` maps
-  each name to its URL. `folders` renames the poll media kind. Public image
-  files exist only while the item is live; `useContent` shows an unpublished
-  item's images to its editors (below).
+  content's `body` shows its images' signed URLs (the opened version's
+  private files) and `images` maps each name to its URL. `folders` renames
+  the poll media kind. Public image files exist only while the item is live;
+  `useContent` shows an unpublished item's images to its editors (below).
 - **`client.config()`** says what the content module allows: which
   interactions signed-out visitors may make (`content.Options.Anonymous`,
   none by default) and the longest comment (`CommentMaxLength`, 2,200 by
@@ -587,11 +589,16 @@ const nav = useMemo(() => ({ pathname: location.pathname, search: location.searc
 ## Errors
 
 Every call rejects with `ContentKitError`: `code` (the server's, or `network`,
-`storage`, `aborted`, `resume_mismatch`, `decode`, `render_timeout`),
-`status`, `retryAfter`, `details` (image and video limits), `blobs`
-(`not_uploaded`), `ban` (`comment_banned`) and `action` (`rate_limited`),
-plus `refusal`, `isLimit`, `isCeiling`, `blocksQueue` and `transient`. Every
-code has a message in every bundle (`useMessages().error(e)`).
+`server_unavailable`, `storage`, `aborted`, `resume_mismatch`, `decode`,
+`render_timeout`), `status`, `retryAfter`, `details` (image and video limits),
+`blobs` (`not_uploaded`), `ban` (`comment_banned`), `action` (`rate_limited`)
+and `unknownCode` (a code this client doesn't know; the message is the
+server's), plus `refusal`, `isLimit`, `isCeiling`, `blocksQueue` and
+`transient`. Every code has a message in every bundle (`useMessages().error(e)`).
+
+Failures are classified like auth-ui's and billing-ui's (`transportFailure`):
+no server reached is `network`; a 502, 503, 504 or 520–524 without an API
+error body, or a timeout, is `server_unavailable`.
 
 ## Migrating from the two old packages
 

package/dist/client/beacons.js

@@ -62,7 +62,11 @@ var o = class {
 		let a = this.session(), o = [], { discovery: s } = this.client;
 		for (let e = 0; e < r.length; e += t) o.push(s.signals(r.slice(e, e + t), a, { keepalive: n }));
 		for (let e = 0; e < i.length; e += t) o.push(s.exposures(i.slice(e, e + t), a, { keepalive: n }));
-		(await Promise.allSettled(o)).some((t) => t.status === "rejected" && ["not_configured", "unavailable"].includes(e(t.reason).code)) && this.pause();
+		(await Promise.allSettled(o)).some((t) => t.status === "rejected" && [
+			"not_configured",
+			"unavailable",
+			"server_unavailable"
+		].includes(e(t.reason).code)) && this.pause();
 	}
 	signal(e) {
 		this.paused() || (e.type === "view" && (this.signals = this.signals.filter((t) => t.event_id !== e.event_id)), this.signals.push(e), this.schedule());

package/dist/client/beacons.js.map

@@ -1 +1 @@
-{"version":3,"file":"beacons.js","names":[],"sources":["../../src/client/beacons.ts"],"sourcesContent":["import type { ContentKitClient } from \"./client.js\";\nimport { toContentKitError } from \"./errors.js\";\nimport type { ExposureInput, SignalInput } from \"./generated/wire.js\";\n\nexport interface BeaconOptions {\n  /** A signed-out visitor's session; default one per browser tab. */\n  session?: () => string | undefined;\n  /** How long events gather before they are sent, ms. Default 2000. */\n  delay?: number;\n  /** How long beacons stay off after the site records no signals, ms, before the content model is read again. Default 60000. */\n  recheck?: number;\n}\n\n/** Where a click or a view came from: the list render it was shown in. */\nexport interface Attribution {\n  render_id?: string;\n  surface?: string;\n  /** 1-based position in that render. */\n  position?: number;\n}\n\nexport interface ViewSession {\n  /** Reports the view so far: pages read, seconds watched or percent scrolled; resume is where to pick up. */\n  update(o: { progress?: number; duration_s?: number; resume?: string }): void;\n}\n\nconst MAX = 100;\nconst SESSION_KEY = \"contentkit.session\";\nexport const eventId = () => (typeof crypto !== \"undefined\" && \"randomUUID\" in crypto ? crypto.randomUUID() : `${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`);\n\nlet unstored: string | undefined;\n\n/** A signed-out reader's session: one per browser tab, kept across reloads. */\nexport function readerSession(): string {\n  try {\n    const kept = sessionStorage.getItem(SESSION_KEY);\n    if (kept) return kept;\n    const made = eventId();\n    sessionStorage.setItem(SESSION_KEY, made);\n    return made;\n  } catch {\n    return (unstored ??= eventId());\n  }\n}\n\n/**\n * Batched, best-effort signals and exposures: gathered for `delay`, sent in\n * one request each, flushed with keepalive when the page hides. While the\n * content model says the site records no signals (or a send is refused as\n * not_configured or unavailable) events are dropped; after `recheck` the\n * next event reads the model again, so signals resume when the site's\n * signal plane is back.\n */\nexport class Beacons {\n  private signals: SignalInput[] = [];\n  private exposures: ExposureInput[] = [];\n  private timer: ReturnType<typeof setTimeout> | undefined;\n  private offUntil = 0;\n  private recorded: Promise<boolean> | undefined;\n  private readonly session: () => string | undefined;\n  private readonly delay: number;\n  private readonly recheck: number;\n\n  constructor(\n    private readonly client: Pick<ContentKitClient, \"discovery\" | \"kinds\">,\n    o: BeaconOptions = {},\n  ) {\n    this.session = o.session ?? readerSession;\n    this.delay = o.delay ?? 2000;\n    this.recheck = o.recheck ?? 60_000;\n    if (typeof addEventListener === \"function\") {\n      addEventListener(\"pagehide\", () => void this.flush(true));\n      addEventListener(\"visibilitychange\", () => {\n        if (typeof document !== \"undefined\" && document.visibilityState === \"hidden\") void this.flush(true);\n      });\n    }\n  }\n\n  /** A click on a listed card. */\n  click(content: string, a: Attribution & { version_id?: string } = {}): void {\n    this.signal({ content_id: content, type: \"click\", event_id: eventId(), occurred_at: new Date().toISOString(), ...a });\n  }\n\n  /** A consumption session of a content (or one version): each update a revision of one event. */\n  view(content: string, version?: string, a: Attribution = {}): ViewSession {\n    const event = eventId();\n    let revision = 0;\n    return {\n      update: (o) => this.signal({ content_id: content, version_id: version, type: \"view\", event_id: event, revision: ++revision, occurred_at: new Date().toISOString(), ...a, ...o }),\n    };\n  }\n\n  /** A result list served, rendered or shown. */\n  exposure(e: ExposureInput): void {\n    if (this.paused() || !e.shown.length) return;\n    this.exposures.push(e);\n    this.schedule();\n  }\n\n  /** Sends what has gathered now. */\n  async flush(keepalive = false): Promise<void> {\n    clearTimeout(this.timer);\n    this.timer = undefined;\n    const signals = this.signals.splice(0);\n    const exposures = this.exposures.splice(0);\n    if (this.paused() || (!signals.length && !exposures.length)) return;\n    if (!(await this.recording())) {\n      this.pause();\n      return;\n    }\n    const session = this.session();\n    const sends: Promise<void>[] = [];\n    const { discovery } = this.client;\n    for (let i = 0; i < signals.length; i += MAX) sends.push(discovery.signals(signals.slice(i, i + MAX), session, { keepalive }));\n    for (let i = 0; i < exposures.length; i += MAX) sends.push(discovery.exposures(exposures.slice(i, i + MAX), session, { keepalive }));\n    const done = await Promise.allSettled(sends);\n    if (done.some((r) => r.status === \"rejected\" && [\"not_configured\", \"unavailable\"].includes(toContentKitError(r.reason).code))) this.pause();\n  }\n\n  private signal(s: SignalInput): void {\n    if (this.paused()) return;\n    // A view's later revision replaces its earlier one still waiting.\n    if (s.type === \"view\") this.signals = this.signals.filter((x) => x.event_id !== s.event_id);\n    this.signals.push(s);\n    this.schedule();\n  }\n\n  /** Off until `recheck` passes; then the model is read again. */\n  private paused(): boolean {\n    if (this.offUntil > Date.now()) return true;\n    this.offUntil = 0;\n    return false;\n  }\n\n  private pause(): void {\n    this.offUntil = Date.now() + this.recheck;\n    this.recorded = undefined;\n  }\n\n  /** Whether the site records signals, asked at the first event and after a pause; an unreadable model sends anyway (a refusal still pauses them). */\n  private recording(): Promise<boolean> {\n    return (this.recorded ??= this.client.kinds().then(\n      (m) => m.signals,\n      () => true,\n    ));\n  }\n\n  private schedule(): void {\n    void this.recording();\n    if (this.signals.length + this.exposures.length >= MAX) return void this.flush();\n    this.timer ??= setTimeout(() => void this.flush(), this.delay);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"beacons.js","names":[],"sources":["../../src/client/beacons.ts"],"sourcesContent":["import type { ContentKitClient } from \"./client.js\";\nimport { toContentKitError } from \"./errors.js\";\nimport type { ExposureInput, SignalInput } from \"./generated/wire.js\";\n\nexport interface BeaconOptions {\n  /** A signed-out visitor's session; default one per browser tab. */\n  session?: () => string | undefined;\n  /** How long events gather before they are sent, ms. Default 2000. */\n  delay?: number;\n  /** How long beacons stay off after the site records no signals, ms, before the content model is read again. Default 60000. */\n  recheck?: number;\n}\n\n/** Where a click or a view came from: the list render it was shown in. */\nexport interface Attribution {\n  render_id?: string;\n  surface?: string;\n  /** 1-based position in that render. */\n  position?: number;\n}\n\nexport interface ViewSession {\n  /** Reports the view so far: pages read, seconds watched or percent scrolled; resume is where to pick up. */\n  update(o: { progress?: number; duration_s?: number; resume?: string }): void;\n}\n\nconst MAX = 100;\nconst SESSION_KEY = \"contentkit.session\";\nexport const eventId = () => (typeof crypto !== \"undefined\" && \"randomUUID\" in crypto ? crypto.randomUUID() : `${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`);\n\nlet unstored: string | undefined;\n\n/** A signed-out reader's session: one per browser tab, kept across reloads. */\nexport function readerSession(): string {\n  try {\n    const kept = sessionStorage.getItem(SESSION_KEY);\n    if (kept) return kept;\n    const made = eventId();\n    sessionStorage.setItem(SESSION_KEY, made);\n    return made;\n  } catch {\n    return (unstored ??= eventId());\n  }\n}\n\n/**\n * Batched, best-effort signals and exposures: gathered for `delay`, sent in\n * one request each, flushed with keepalive when the page hides. While the\n * content model says the site records no signals (or a send is refused as\n * not_configured or unavailable) events are dropped; after `recheck` the\n * next event reads the model again, so signals resume when the site's\n * signal plane is back.\n */\nexport class Beacons {\n  private signals: SignalInput[] = [];\n  private exposures: ExposureInput[] = [];\n  private timer: ReturnType<typeof setTimeout> | undefined;\n  private offUntil = 0;\n  private recorded: Promise<boolean> | undefined;\n  private readonly session: () => string | undefined;\n  private readonly delay: number;\n  private readonly recheck: number;\n\n  constructor(\n    private readonly client: Pick<ContentKitClient, \"discovery\" | \"kinds\">,\n    o: BeaconOptions = {},\n  ) {\n    this.session = o.session ?? readerSession;\n    this.delay = o.delay ?? 2000;\n    this.recheck = o.recheck ?? 60_000;\n    if (typeof addEventListener === \"function\") {\n      addEventListener(\"pagehide\", () => void this.flush(true));\n      addEventListener(\"visibilitychange\", () => {\n        if (typeof document !== \"undefined\" && document.visibilityState === \"hidden\") void this.flush(true);\n      });\n    }\n  }\n\n  /** A click on a listed card. */\n  click(content: string, a: Attribution & { version_id?: string } = {}): void {\n    this.signal({ content_id: content, type: \"click\", event_id: eventId(), occurred_at: new Date().toISOString(), ...a });\n  }\n\n  /** A consumption session of a content (or one version): each update a revision of one event. */\n  view(content: string, version?: string, a: Attribution = {}): ViewSession {\n    const event = eventId();\n    let revision = 0;\n    return {\n      update: (o) => this.signal({ content_id: content, version_id: version, type: \"view\", event_id: event, revision: ++revision, occurred_at: new Date().toISOString(), ...a, ...o }),\n    };\n  }\n\n  /** A result list served, rendered or shown. */\n  exposure(e: ExposureInput): void {\n    if (this.paused() || !e.shown.length) return;\n    this.exposures.push(e);\n    this.schedule();\n  }\n\n  /** Sends what has gathered now. */\n  async flush(keepalive = false): Promise<void> {\n    clearTimeout(this.timer);\n    this.timer = undefined;\n    const signals = this.signals.splice(0);\n    const exposures = this.exposures.splice(0);\n    if (this.paused() || (!signals.length && !exposures.length)) return;\n    if (!(await this.recording())) {\n      this.pause();\n      return;\n    }\n    const session = this.session();\n    const sends: Promise<void>[] = [];\n    const { discovery } = this.client;\n    for (let i = 0; i < signals.length; i += MAX) sends.push(discovery.signals(signals.slice(i, i + MAX), session, { keepalive }));\n    for (let i = 0; i < exposures.length; i += MAX) sends.push(discovery.exposures(exposures.slice(i, i + MAX), session, { keepalive }));\n    const done = await Promise.allSettled(sends);\n    if (done.some((r) => r.status === \"rejected\" && [\"not_configured\", \"unavailable\", \"server_unavailable\"].includes(toContentKitError(r.reason).code))) this.pause();\n  }\n\n  private signal(s: SignalInput): void {\n    if (this.paused()) return;\n    // A view's later revision replaces its earlier one still waiting.\n    if (s.type === \"view\") this.signals = this.signals.filter((x) => x.event_id !== s.event_id);\n    this.signals.push(s);\n    this.schedule();\n  }\n\n  /** Off until `recheck` passes; then the model is read again. */\n  private paused(): boolean {\n    if (this.offUntil > Date.now()) return true;\n    this.offUntil = 0;\n    return false;\n  }\n\n  private pause(): void {\n    this.offUntil = Date.now() + this.recheck;\n    this.recorded = undefined;\n  }\n\n  /** Whether the site records signals, asked at the first event and after a pause; an unreadable model sends anyway (a refusal still pauses them). */\n  private recording(): Promise<boolean> {\n    return (this.recorded ??= this.client.kinds().then(\n      (m) => m.signals,\n      () => true,\n    ));\n  }\n\n  private schedule(): void {\n    void this.recording();\n    if (this.signals.length + this.exposures.length >= MAX) return void this.flush();\n    this.timer ??= setTimeout(() => void this.flush(), this.delay);\n  }\n}\n"],"mappings":"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"}

package/dist/client/contents.d.ts

@@ -9,8 +9,6 @@ export declare const IMAGE_SCHEME = "contentkit:";
  * the image's current public file (`Content.images`).
  */
 export declare const imageRef: (name: string) => string;
-/** A content kind's body kind: the media folder of a content item's body images ({kind}.body, id), opened with the item. */
-export declare const BODY_SUFFIX = ".body";
 /** Matches every image reference; the name is group 1. */
 export declare const imageRefs: () => RegExp;
 /** GET /manage/contents filters, as the route names them. */
@@ -39,10 +37,14 @@ export declare class ContentsClient {
     unpublish(id: string): Promise<Content>;
     remove(id: string): Promise<void>;
     restore(id: string): Promise<Content>;
-    /** Sets the cover to an inline image name ("i-{uuid}") of the item's folder; null clears it. */
-    setCover(id: string, image: string | null): Promise<Content>;
-    /** An inline image of the item's folder: the reference to store in a body and a URL that shows it to the editor now (null while none exists). */
-    inlineImage(id: string, image: string, signal?: AbortSignal): Promise<InlineImage>;
+    /** Selects a version's cover by the name ("i-{uuid}") of one of its cover uploads; null returns to its first. */
+    setCover(id: string, vid: string, image: string | null): Promise<Version>;
+    /**
+     * A body image uploaded to version vid (its private files), copied into
+     * every other version: the reference to store in the body and a URL that shows
+     * it to the editor now (null while none exists).
+     */
+    inlineImage(id: string, vid: string, image: string, signal?: AbortSignal): Promise<InlineImage>;
     addVersion(id: string, input: VersionInput): Promise<Version>;
     updateVersion(id: string, vid: string, input: VersionInput): Promise<Version>;
     removeVersion(id: string, vid: string): Promise<void>;

package/dist/client/contents.js

@@ -1,6 +1,6 @@
 import { call as e } from "./route.js";
 //#region src/client/contents.ts
-var t = "contentkit:", n = (e) => t + e, r = ".body", i = () => /contentkit:(i-[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})/g, a = class {
+var t = "contentkit:", n = (e) => t + e, r = () => /contentkit:(i-[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})/g, i = class {
 	http;
 	constructor(e) {
 		this.http = e;
@@ -77,14 +77,17 @@ var t = "contentkit:", n = (e) => t + e, r = ".body", i = () => /contentkit:(i-[
 	restore(t) {
 		return this.write(e(this.http, "POST", "/contents/{id}/restore", { params: { id: t } }));
 	}
-	setCover(e, t) {
-		return this.update(e, { cover: t ?? "" });
+	setCover(e, t, n) {
+		return this.updateVersion(e, t, { cover: n ?? "" });
 	}
-	inlineImage(t, n, r) {
+	inlineImage(t, n, r, i) {
 		return e(this.http, "POST", "/contents/{id}/images", {
 			params: { id: t },
-			body: { image: n },
-			signal: r
+			body: {
+				image: r,
+				version: n
+			},
+			signal: i
 		});
 	}
 	addVersion(t, n) {
@@ -139,6 +142,6 @@ var t = "contentkit:", n = (e) => t + e, r = ".body", i = () => /contentkit:(i-[
 	}
 };
 //#endregion
-export { r as BODY_SUFFIX, a as ContentsClient, t as IMAGE_SCHEME, n as imageRef, i as imageRefs };
+export { i as ContentsClient, t as IMAGE_SCHEME, n as imageRef, r as imageRefs };
 
 //# sourceMappingURL=contents.js.map

package/dist/client/contents.js.map

@@ -1 +1 @@
-{"version":3,"file":"contents.js","names":[],"sources":["../../src/client/contents.ts"],"sourcesContent":["import type {\n  CatalogText,\n  Content,\n  ContentInput,\n  ContentPatch,\n  Creator,\n  InlineImage,\n  Segment,\n  Version,\n  VersionInput,\n} from \"./generated/wire.js\";\nimport type { Http } from \"./http.js\";\nimport { call, type RouteQuery } from \"./route.js\";\n\n/** The URL scheme of an image reference in a content body. */\nexport const IMAGE_SCHEME = \"contentkit:\";\n\n/**\n * The reference a body stores for one of its images, by name\n * (\"contentkit:i-{uuid}\"), where the image's URL would go: reads resolve it to\n * the image's current public file (`Content.images`).\n */\nexport const imageRef = (name: string) => IMAGE_SCHEME + name;\n/** A content kind's body kind: the media folder of a content item's body images ({kind}.body, id), opened with the item. */\nexport const BODY_SUFFIX = \".body\";\n\n/** Matches every image reference; the name is group 1. */\nexport const imageRefs = () => /contentkit:(i-[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})/g;\n\n/** GET /manage/contents filters, as the route names them. */\nexport type ManageQuery = RouteQuery<\"GET\", \"/manage/contents\">;\n\n/**\n * Content items: a viewer's reads, and the writes of their creators, their\n * owner group's editors and root:content:write holders.\n */\nexport class ContentsClient {\n  constructor(private readonly http: Http) {}\n\n  /** The item as the caller sees it; text in language, else the site's first, else any. */\n  get(id: string, language?: string, signal?: AbortSignal): Promise<Content> {\n    return call(this.http, \"GET\", \"/contents/{id}\", { params: { id }, query: { language }, signal });\n  }\n  version(id: string, vid: string, language?: string, signal?: AbortSignal): Promise<Version> {\n    return call(this.http, \"GET\", \"/contents/{id}/versions/{vid}\", { params: { id, vid }, query: { language }, signal });\n  }\n  /** Items the caller manages, newest first: all for root:content:write holders, else theirs or an owner group's. */\n  manage(q: ManageQuery = {}, signal?: AbortSignal): Promise<Content[]> {\n    return call(this.http, \"GET\", \"/manage/contents\", { query: q, signal });\n  }\n  /** Creates a draft. */\n  create(input: ContentInput): Promise<Content> {\n    return this.write(call(this.http, \"POST\", \"/contents\", { body: input }));\n  }\n  update(id: string, patch: ContentPatch): Promise<Content> {\n    return this.write(call(this.http, \"PATCH\", \"/contents/{id}\", { params: { id }, body: patch }));\n  }\n  /** Sets the text in one language; moderation \"held\" when the moderator holds the edit. */\n  putText(id: string, language: string, text: CatalogText): Promise<Content> {\n    return this.write(call(this.http, \"PUT\", \"/contents/{id}/text/{language}\", { params: { id, language }, body: text }));\n  }\n  deleteText(id: string, language: string): Promise<Content> {\n    return this.write(call(this.http, \"DELETE\", \"/contents/{id}/text/{language}\", { params: { id, language } }));\n  }\n  setCreators(id: string, creators: Creator[]): Promise<Content> {\n    return this.write(call(this.http, \"PUT\", \"/contents/{id}/creators\", { params: { id }, body: { creators } }));\n  }\n  /** Publishes now, or schedules for at; moderation \"held\" when the moderator holds it. */\n  publish(id: string, at?: string): Promise<Content> {\n    return this.write(call(this.http, \"POST\", \"/contents/{id}/publish\", { params: { id }, body: { publish_at: at } }));\n  }\n  unpublish(id: string): Promise<Content> {\n    return this.write(call(this.http, \"POST\", \"/contents/{id}/unpublish\", { params: { id } }));\n  }\n  async remove(id: string): Promise<void> {\n    const emit = this.http.captureChanges();\n    await call(this.http, \"DELETE\", \"/contents/{id}\", { params: { id } });\n    emit({ type: \"content.deleted\", id });\n  }\n  restore(id: string): Promise<Content> {\n    return this.write(call(this.http, \"POST\", \"/contents/{id}/restore\", { params: { id } }));\n  }\n  /** Sets the cover to an inline image name (\"i-{uuid}\") of the item's folder; null clears it. */\n  setCover(id: string, image: string | null): Promise<Content> {\n    return this.update(id, { cover: image ?? \"\" });\n  }\n  /** An inline image of the item's folder: the reference to store in a body and a URL that shows it to the editor now (null while none exists). */\n  inlineImage(id: string, image: string, signal?: AbortSignal): Promise<InlineImage> {\n    return call(this.http, \"POST\", \"/contents/{id}/images\", { params: { id }, body: { image }, signal });\n  }\n  addVersion(id: string, input: VersionInput): Promise<Version> {\n    return this.writeVersion(id, call(this.http, \"POST\", \"/contents/{id}/versions\", { params: { id }, body: input }));\n  }\n  updateVersion(id: string, vid: string, input: VersionInput): Promise<Version> {\n    return this.writeVersion(id, call(this.http, \"PATCH\", \"/contents/{id}/versions/{vid}\", { params: { id, vid }, body: input }));\n  }\n  async removeVersion(id: string, vid: string): Promise<void> {\n    await this.writeVersion(id, call(this.http, \"DELETE\", \"/contents/{id}/versions/{vid}\", { params: { id, vid } }));\n  }\n  /** Orders the versions: ids lists each version that is not deleted, first first. */\n  orderVersions(id: string, ids: string[]): Promise<Content> {\n    return this.write(call(this.http, \"PUT\", \"/contents/{id}/versions/order\", { params: { id }, body: { ids } }));\n  }\n  /** Replaces a version's segments (chapters). */\n  setSegments(id: string, vid: string, segments: Segment[]): Promise<Version> {\n    return this.writeVersion(id, call(this.http, \"PUT\", \"/contents/{id}/versions/{vid}/segments\", { params: { id, vid }, body: { segments } }));\n  }\n\n  private async write(p: Promise<Content>): Promise<Content> {\n    const emit = this.http.captureChanges();\n    const content = await p;\n    emit({ type: \"content.saved\", content });\n    return content;\n  }\n\n  private async writeVersion<T>(id: string, p: Promise<T>): Promise<T> {\n    const emit = this.http.captureChanges();\n    const out = await p;\n    emit({ type: \"content.changed\", id });\n    return out;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"contents.js","names":[],"sources":["../../src/client/contents.ts"],"sourcesContent":["import type {\n  CatalogText,\n  Content,\n  ContentInput,\n  ContentPatch,\n  Creator,\n  InlineImage,\n  Segment,\n  Version,\n  VersionInput,\n} from \"./generated/wire.js\";\nimport type { Http } from \"./http.js\";\nimport { call, type RouteQuery } from \"./route.js\";\n\n/** The URL scheme of an image reference in a content body. */\nexport const IMAGE_SCHEME = \"contentkit:\";\n\n/**\n * The reference a body stores for one of its images, by name\n * (\"contentkit:i-{uuid}\"), where the image's URL would go: reads resolve it to\n * the image's current public file (`Content.images`).\n */\nexport const imageRef = (name: string) => IMAGE_SCHEME + name;\n\n/** Matches every image reference; the name is group 1. */\nexport const imageRefs = () => /contentkit:(i-[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})/g;\n\n/** GET /manage/contents filters, as the route names them. */\nexport type ManageQuery = RouteQuery<\"GET\", \"/manage/contents\">;\n\n/**\n * Content items: a viewer's reads, and the writes of their creators, their\n * owner group's editors and root:content:write holders.\n */\nexport class ContentsClient {\n  constructor(private readonly http: Http) {}\n\n  /** The item as the caller sees it; text in language, else the site's first, else any. */\n  get(id: string, language?: string, signal?: AbortSignal): Promise<Content> {\n    return call(this.http, \"GET\", \"/contents/{id}\", { params: { id }, query: { language }, signal });\n  }\n  version(id: string, vid: string, language?: string, signal?: AbortSignal): Promise<Version> {\n    return call(this.http, \"GET\", \"/contents/{id}/versions/{vid}\", { params: { id, vid }, query: { language }, signal });\n  }\n  /** Items the caller manages, newest first: all for root:content:write holders, else theirs or an owner group's. */\n  manage(q: ManageQuery = {}, signal?: AbortSignal): Promise<Content[]> {\n    return call(this.http, \"GET\", \"/manage/contents\", { query: q, signal });\n  }\n  /** Creates a draft. */\n  create(input: ContentInput): Promise<Content> {\n    return this.write(call(this.http, \"POST\", \"/contents\", { body: input }));\n  }\n  update(id: string, patch: ContentPatch): Promise<Content> {\n    return this.write(call(this.http, \"PATCH\", \"/contents/{id}\", { params: { id }, body: patch }));\n  }\n  /** Sets the text in one language; moderation \"held\" when the moderator holds the edit. */\n  putText(id: string, language: string, text: CatalogText): Promise<Content> {\n    return this.write(call(this.http, \"PUT\", \"/contents/{id}/text/{language}\", { params: { id, language }, body: text }));\n  }\n  deleteText(id: string, language: string): Promise<Content> {\n    return this.write(call(this.http, \"DELETE\", \"/contents/{id}/text/{language}\", { params: { id, language } }));\n  }\n  setCreators(id: string, creators: Creator[]): Promise<Content> {\n    return this.write(call(this.http, \"PUT\", \"/contents/{id}/creators\", { params: { id }, body: { creators } }));\n  }\n  /** Publishes now, or schedules for at; moderation \"held\" when the moderator holds it. */\n  publish(id: string, at?: string): Promise<Content> {\n    return this.write(call(this.http, \"POST\", \"/contents/{id}/publish\", { params: { id }, body: { publish_at: at } }));\n  }\n  unpublish(id: string): Promise<Content> {\n    return this.write(call(this.http, \"POST\", \"/contents/{id}/unpublish\", { params: { id } }));\n  }\n  async remove(id: string): Promise<void> {\n    const emit = this.http.captureChanges();\n    await call(this.http, \"DELETE\", \"/contents/{id}\", { params: { id } });\n    emit({ type: \"content.deleted\", id });\n  }\n  restore(id: string): Promise<Content> {\n    return this.write(call(this.http, \"POST\", \"/contents/{id}/restore\", { params: { id } }));\n  }\n  /** Selects a version's cover by the name (\"i-{uuid}\") of one of its cover uploads; null returns to its first. */\n  setCover(id: string, vid: string, image: string | null): Promise<Version> {\n    return this.updateVersion(id, vid, { cover: image ?? \"\" });\n  }\n  /**\n   * A body image uploaded to version vid (its private files), copied into\n   * every other version: the reference to store in the body and a URL that shows\n   * it to the editor now (null while none exists).\n   */\n  inlineImage(id: string, vid: string, image: string, signal?: AbortSignal): Promise<InlineImage> {\n    return call(this.http, \"POST\", \"/contents/{id}/images\", { params: { id }, body: { image, version: vid }, signal });\n  }\n  addVersion(id: string, input: VersionInput): Promise<Version> {\n    return this.writeVersion(id, call(this.http, \"POST\", \"/contents/{id}/versions\", { params: { id }, body: input }));\n  }\n  updateVersion(id: string, vid: string, input: VersionInput): Promise<Version> {\n    return this.writeVersion(id, call(this.http, \"PATCH\", \"/contents/{id}/versions/{vid}\", { params: { id, vid }, body: input }));\n  }\n  async removeVersion(id: string, vid: string): Promise<void> {\n    await this.writeVersion(id, call(this.http, \"DELETE\", \"/contents/{id}/versions/{vid}\", { params: { id, vid } }));\n  }\n  /** Orders the versions: ids lists each version that is not deleted, first first. */\n  orderVersions(id: string, ids: string[]): Promise<Content> {\n    return this.write(call(this.http, \"PUT\", \"/contents/{id}/versions/order\", { params: { id }, body: { ids } }));\n  }\n  /** Replaces a version's segments (chapters). */\n  setSegments(id: string, vid: string, segments: Segment[]): Promise<Version> {\n    return this.writeVersion(id, call(this.http, \"PUT\", \"/contents/{id}/versions/{vid}/segments\", { params: { id, vid }, body: { segments } }));\n  }\n\n  private async write(p: Promise<Content>): Promise<Content> {\n    const emit = this.http.captureChanges();\n    const content = await p;\n    emit({ type: \"content.saved\", content });\n    return content;\n  }\n\n  private async writeVersion<T>(id: string, p: Promise<T>): Promise<T> {\n    const emit = this.http.captureChanges();\n    const out = await p;\n    emit({ type: \"content.changed\", id });\n    return out;\n  }\n}\n"],"mappings":"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"}

package/dist/client/errors.d.ts

@@ -1,12 +1,13 @@
 import { ErrorCode } from './generated/error-codes.js';
 import { BanNotice, ErrorDetails, Failure } from './generated/wire.js';
 /**
- * Codes raised in the browser: network (no response), storage (the bucket
+ * Codes raised in the browser: network (no server reached), server_unavailable
+ * (a gateway or timeout answered instead of ContentKit), storage (the bucket
  * refused a PUT), aborted (the caller's signal), resume_mismatch (saved state
  * is not for this file), decode (not readable as an image) and render_timeout
  * (still processing after the wait).
  */
-export declare const CLIENT_ERROR_CODES: readonly ["network", "storage", "aborted", "resume_mismatch", "decode", "render_timeout"];
+export declare const CLIENT_ERROR_CODES: readonly ["network", "server_unavailable", "storage", "aborted", "resume_mismatch", "decode", "render_timeout"];
 export type ContentKitErrorCode = ErrorCode | (typeof CLIENT_ERROR_CODES)[number];
 /** Every code a ContentKitError can carry: the server's registry, then the client's. */
 export declare const ERROR_CODES: readonly ContentKitErrorCode[];
@@ -19,6 +20,7 @@ export interface ContentKitErrorInit extends ErrorOptions {
     action?: string;
     reason?: string;
     availableAt?: string;
+    unknownCode?: string;
 }
 export declare class ContentKitError extends Error {
     readonly code: ContentKitErrorCode;
@@ -34,6 +36,8 @@ export declare class ContentKitError extends Error {
     readonly reason?: string;
     /** A download_unavailable's opening time (RFC 3339), when a matter of time. */
     readonly availableAt?: string;
+    /** A server code this client doesn't know (a newer server): `message` is the server's own and `code` its status's. */
+    readonly unknownCode?: string;
     constructor(code: ContentKitErrorCode, message: string, init?: ContentKitErrorInit);
     /**
      * The request broke a rule the message states (a 4xx or a typed refusal),
@@ -50,8 +54,16 @@ export declare class ContentKitError extends Error {
     get transient(): boolean;
 }
 export declare const isContentKitError: (e: unknown) => e is ContentKitError;
-/** Anything a call can throw, as a ContentKitError (network when it is not one). */
+/** Anything a call can throw, as a ContentKitError: a transport failure's code, else internal_error. */
 export declare function toContentKitError(e: unknown): ContentKitError;
+/** A fetch that got no response: the caller's abort, a timeout, else no server reached. */
+export declare function requestFailure(err: unknown, signal: AbortSignal | undefined, target: string): ContentKitError;
+/**
+ * The client code of a request no server answered (mirrors auth-ui's and
+ * billing-ui's): network when none was reached, server_unavailable when a
+ * gateway or timeout answered. Recognizes the sibling SDKs' codes too.
+ */
+export declare function transportFailure(error: unknown): "network" | "server_unavailable" | undefined;
 export declare function aborted(signal?: AbortSignal): ContentKitError;
 export declare function throwIfAborted(signal?: AbortSignal): void;
 /** Reads a response that is not 2xx. */

package/dist/client/errors.js

@@ -2,6 +2,7 @@ import { CONTENTKIT_ERROR_CODES as e } from "./generated/error-codes.js";
 //#region src/client/errors.ts
 var t = [
 	"network",
+	"server_unavailable",
 	"storage",
 	"aborted",
 	"resume_mismatch",
@@ -18,8 +19,9 @@ var t = [
 	action;
 	reason;
 	availableAt;
+	unknownCode;
 	constructor(e, t, n = {}) {
-		super(t, n.cause === void 0 ? void 0 : { cause: n.cause }), this.code = e, this.status = n.status ?? 0, this.retryAfter = n.retryAfter, this.details = n.details, this.blobs = n.blobs, this.ban = n.ban, this.action = n.action, this.reason = n.reason, this.availableAt = n.availableAt;
+		super(t, n.cause === void 0 ? void 0 : { cause: n.cause }), this.code = e, this.status = n.status ?? 0, this.retryAfter = n.retryAfter, this.details = n.details, this.blobs = n.blobs, this.ban = n.ban, this.action = n.action, this.reason = n.reason, this.availableAt = n.availableAt, this.unknownCode = n.unknownCode;
 	}
 	get refusal() {
 		return this.status >= 400 && this.status < 500 && this.code !== "storage" || this.code.startsWith("image_") || this.code === "decode";
@@ -34,19 +36,42 @@ var t = [
 		return this.isLimit || this.code === "unauthorized" || this.code === "forbidden";
 	}
 	get transient() {
-		return this.code === "network" || this.code === "internal_error" || this.code === "unavailable" || this.code === "storage" && (this.status >= 500 || this.status === 403 || this.status === 408 || this.status === 429);
+		return this.code === "network" || this.code === "server_unavailable" || this.code === "internal_error" || this.code === "unavailable" || this.code === "storage" && (this.status >= 500 || this.status === 403 || this.status === 408 || this.status === 429);
 	}
 }, i = (e) => e instanceof r;
 function a(e) {
-	return e instanceof r ? e : new r("network", e instanceof Error ? e.message : String(e), { cause: e });
+	return e instanceof r ? e : new r(l(e) ?? "internal_error", e instanceof Error ? e.message : String(e), { cause: e });
 }
-function o(e) {
+function o(e, t, n) {
+	let i = l(e);
+	return i !== "server_unavailable" && t?.aborted ? u(t) : i === "server_unavailable" ? new r(i, `${n} did not respond`, { cause: e }) : new r("network", `${n} unreachable`, { cause: e });
+}
+var s = /* @__PURE__ */ new Set([
+	502,
+	503,
+	504,
+	520,
+	521,
+	522,
+	523,
+	524
+]), c = /fetch|network|load failed|connection/i;
+function l(e) {
+	if (e instanceof TypeError) return globalThis.navigator?.onLine === !1 || c.test(e.message) ? "network" : void 0;
+	if (!e || typeof e != "object") return;
+	let { name: t, code: n, status: r } = e;
+	if (t === "TimeoutError") return "server_unavailable";
+	if (n === "network" || n === "network_error") return "network";
+	if (n === "server_unavailable") return n;
+	if (n === void 0 || n === "unknown_error" || n === "server_error") return typeof r == "number" && s.has(r) ? "server_unavailable" : void 0;
+}
+function u(e) {
 	return new r("aborted", "request canceled", { cause: e?.reason });
 }
-function s(e) {
-	if (e?.aborted) throw o(e);
+function d(e) {
+	if (e?.aborted) throw u(e);
 }
-var c = {
+var f = {
 	401: "unauthorized",
 	403: "forbidden",
 	404: "not_found",
@@ -57,14 +82,14 @@ var c = {
 	429: "rate_limited",
 	501: "not_configured",
 	503: "unavailable"
-}, l = new Set(n);
-async function u(e) {
+}, p = new Set(n);
+async function m(e) {
 	let t = {};
 	try {
 		t = await e.json();
 	} catch {}
 	let n = Number(e.headers.get("Retry-After")), i = t.retry_after ?? (Number.isFinite(n) && n > 0 ? n : void 0);
-	return new r(t.code && l.has(t.code) ? t.code : c[e.status] ?? (e.status >= 500 ? "internal_error" : "invalid_request"), t.error ?? `HTTP ${e.status}`, {
+	return new r(t.code && p.has(t.code) ? t.code : !t.code && s.has(e.status) ? "server_unavailable" : f[e.status] ?? (e.status >= 500 ? "internal_error" : "invalid_request"), t.error ?? `HTTP ${e.status}`, {
 		status: e.status,
 		retryAfter: i,
 		blobs: t.blobs,
@@ -72,13 +97,14 @@ async function u(e) {
 		ban: t.ban,
 		action: t.action,
 		reason: t.reason,
-		availableAt: t.available_at
+		availableAt: t.available_at,
+		unknownCode: t.code && !p.has(t.code) ? t.code : void 0
 	});
 }
-function d(e) {
-	return new r(e.code && l.has(e.code) ? e.code : "internal_error", e.message, { details: e.details });
+function h(e) {
+	return new r(e.code && p.has(e.code) ? e.code : "internal_error", e.message, { details: e.details });
 }
 //#endregion
-export { t as CLIENT_ERROR_CODES, r as ContentKitError, n as ERROR_CODES, o as aborted, d as failureError, i as isContentKitError, u as readContentKitError, s as throwIfAborted, a as toContentKitError };
+export { t as CLIENT_ERROR_CODES, r as ContentKitError, n as ERROR_CODES, u as aborted, h as failureError, i as isContentKitError, m as readContentKitError, o as requestFailure, d as throwIfAborted, a as toContentKitError, l as transportFailure };
 
 //# sourceMappingURL=errors.js.map

package/dist/client/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","names":[],"sources":["../../src/client/errors.ts"],"sourcesContent":["import { CONTENTKIT_ERROR_CODES, type ErrorCode } from \"./generated/error-codes.js\";\nimport type { BanNotice, ErrorDetails, ErrorReply, Failure } from \"./generated/wire.js\";\n\n/**\n * Codes raised in the browser: network (no response), storage (the bucket\n * refused a PUT), aborted (the caller's signal), resume_mismatch (saved state\n * is not for this file), decode (not readable as an image) and render_timeout\n * (still processing after the wait).\n */\nexport const CLIENT_ERROR_CODES = [\"network\", \"storage\", \"aborted\", \"resume_mismatch\", \"decode\", \"render_timeout\"] as const;\n\nexport type ContentKitErrorCode = ErrorCode | (typeof CLIENT_ERROR_CODES)[number];\n\n/** Every code a ContentKitError can carry: the server's registry, then the client's. */\nexport const ERROR_CODES: readonly ContentKitErrorCode[] = [...(Object.keys(CONTENTKIT_ERROR_CODES) as ErrorCode[]), ...CLIENT_ERROR_CODES];\n\nexport interface ContentKitErrorInit extends ErrorOptions {\n  status?: number;\n  retryAfter?: number;\n  details?: ErrorDetails;\n  blobs?: string[];\n  ban?: BanNotice;\n  action?: string;\n  reason?: string;\n  availableAt?: string;\n}\n\nexport class ContentKitError extends Error {\n  override readonly name = \"ContentKitError\";\n  /** HTTP status; 0 for client-side codes. */\n  readonly status: number;\n  readonly retryAfter?: number;\n  readonly details?: ErrorDetails;\n  readonly blobs?: string[];\n  readonly ban?: BanNotice;\n  readonly action?: string;\n  /** A download_unavailable's code of the host's policy (\"release_window\"). */\n  readonly reason?: string;\n  /** A download_unavailable's opening time (RFC 3339), when a matter of time. */\n  readonly availableAt?: string;\n\n  constructor(\n    readonly code: ContentKitErrorCode,\n    message: string,\n    init: ContentKitErrorInit = {},\n  ) {\n    super(message, init.cause === undefined ? undefined : { cause: init.cause });\n    this.status = init.status ?? 0;\n    this.retryAfter = init.retryAfter;\n    this.details = init.details;\n    this.blobs = init.blobs;\n    this.ban = init.ban;\n    this.action = init.action;\n    this.reason = init.reason;\n    this.availableAt = init.availableAt;\n  }\n\n  /**\n   * The request broke a rule the message states (a 4xx or a typed refusal),\n   * as opposed to a fault on the server or the network: show it as is.\n   */\n  get refusal(): boolean {\n    return (this.status >= 400 && this.status < 500 && this.code !== \"storage\") || this.code.startsWith(\"image_\") || this.code === \"decode\";\n  }\n\n  /** Rate or quota refusals: stop starting new requests until the limit frees. */\n  get isLimit(): boolean {\n    return this.code === \"rate_limited\" || this.code === \"quota_exceeded\";\n  }\n\n  /** The commit would exceed the kind's file caps (too_many_files, 409): remove files first. */\n  get isCeiling(): boolean {\n    return this.code === \"too_many_files\";\n  }\n\n  /** Refusals that apply to every upload of this caller, not just this file. */\n  get blocksQueue(): boolean {\n    return this.isLimit || this.code === \"unauthorized\" || this.code === \"forbidden\";\n  }\n\n  /** Worth retrying the same request. */\n  get transient(): boolean {\n    return (\n      this.code === \"network\" ||\n      this.code === \"internal_error\" ||\n      this.code === \"unavailable\" ||\n      (this.code === \"storage\" && (this.status >= 500 || this.status === 403 || this.status === 408 || this.status === 429))\n    );\n  }\n}\n\nexport const isContentKitError = (e: unknown): e is ContentKitError => e instanceof ContentKitError;\n\n/** Anything a call can throw, as a ContentKitError (network when it is not one). */\nexport function toContentKitError(e: unknown): ContentKitError {\n  if (e instanceof ContentKitError) return e;\n  return new ContentKitError(\"network\", e instanceof Error ? e.message : String(e), { cause: e });\n}\n\nexport function aborted(signal?: AbortSignal): ContentKitError {\n  return new ContentKitError(\"aborted\", \"request canceled\", { cause: signal?.reason });\n}\n\nexport function throwIfAborted(signal?: AbortSignal): void {\n  if (signal?.aborted) throw aborted(signal);\n}\n\nconst byStatus: Record<number, ContentKitErrorCode> = {\n  401: \"unauthorized\",\n  403: \"forbidden\",\n  404: \"not_found\",\n  409: \"conflict\",\n  410: \"gone\",\n  413: \"too_large\",\n  415: \"type_not_allowed\",\n  429: \"rate_limited\",\n  501: \"not_configured\",\n  503: \"unavailable\",\n};\n\nconst known = new Set<string>(ERROR_CODES);\n\n/** Reads a response that is not 2xx. */\nexport async function readContentKitError(res: Response): Promise<ContentKitError> {\n  let body: Partial<ErrorReply> = {};\n  try {\n    body = (await res.json()) as Partial<ErrorReply>;\n  } catch {\n    // not JSON (a proxy error page)\n  }\n  const header = Number(res.headers.get(\"Retry-After\"));\n  const retryAfter = body.retry_after ?? (Number.isFinite(header) && header > 0 ? header : undefined);\n  const code = body.code && known.has(body.code) ? (body.code as ContentKitErrorCode) : (byStatus[res.status] ?? (res.status >= 500 ? \"internal_error\" : \"invalid_request\"));\n  return new ContentKitError(code, body.error ?? `HTTP ${res.status}`, {\n    status: res.status,\n    retryAfter,\n    blobs: body.blobs,\n    details: body.details,\n    ban: body.ban,\n    action: body.action,\n    reason: body.reason,\n    availableAt: body.available_at,\n  });\n}\n\n/** An upload's recorded processing failure: its typed refusal, else a processing fault. */\nexport function failureError(f: Failure): ContentKitError {\n  const code = f.code && known.has(f.code) ? (f.code as ContentKitErrorCode) : \"internal_error\";\n  return new ContentKitError(code, f.message, { details: f.details });\n}\n"],"mappings":";;AASA,IAAa,IAAqB;CAAC;CAAW;CAAW;CAAW;CAAmB;CAAU;AAAgB,GAKpG,IAA8C,CAAC,GAAI,OAAO,KAAK,CAAsB,GAAmB,GAAG,CAAkB,GAa7H,IAAb,cAAqC,MAAM;CAe9B;CAdX,OAAyB;CAEzB;CACA;CACA;CACA;CACA;CACA;CAEA;CAEA;CAEA,YACE,GACA,GACA,IAA4B,CAAC,GAC7B;EASA,AARA,MAAM,GAAS,EAAK,UAAU,KAAA,IAAY,KAAA,IAAY,EAAE,OAAO,EAAK,MAAM,CAAC,GAJlE,KAAA,OAAA,GAKT,KAAK,SAAS,EAAK,UAAU,GAC7B,KAAK,aAAa,EAAK,YACvB,KAAK,UAAU,EAAK,SACpB,KAAK,QAAQ,EAAK,OAClB,KAAK,MAAM,EAAK,KAChB,KAAK,SAAS,EAAK,QACnB,KAAK,SAAS,EAAK,QACnB,KAAK,cAAc,EAAK;CAC1B;CAMA,IAAI,UAAmB;EACrB,OAAQ,KAAK,UAAU,OAAO,KAAK,SAAS,OAAO,KAAK,SAAS,aAAc,KAAK,KAAK,WAAW,QAAQ,KAAK,KAAK,SAAS;CACjI;CAGA,IAAI,UAAmB;EACrB,OAAO,KAAK,SAAS,kBAAkB,KAAK,SAAS;CACvD;CAGA,IAAI,YAAqB;EACvB,OAAO,KAAK,SAAS;CACvB;CAGA,IAAI,cAAuB;EACzB,OAAO,KAAK,WAAW,KAAK,SAAS,kBAAkB,KAAK,SAAS;CACvE;CAGA,IAAI,YAAqB;EACvB,OACE,KAAK,SAAS,aACd,KAAK,SAAS,oBACd,KAAK,SAAS,iBACb,KAAK,SAAS,cAAc,KAAK,UAAU,OAAO,KAAK,WAAW,OAAO,KAAK,WAAW,OAAO,KAAK,WAAW;CAErH;AACF,GAEa,KAAqB,MAAqC,aAAa;AAGpF,SAAgB,EAAkB,GAA6B;CAE7D,OADI,aAAa,IAAwB,IAClC,IAAI,EAAgB,WAAW,aAAa,QAAQ,EAAE,UAAU,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC;AAChG;AAEA,SAAgB,EAAQ,GAAuC;CAC7D,OAAO,IAAI,EAAgB,WAAW,oBAAoB,EAAE,OAAO,GAAQ,OAAO,CAAC;AACrF;AAEA,SAAgB,EAAe,GAA4B;CACzD,IAAI,GAAQ,SAAS,MAAM,EAAQ,CAAM;AAC3C;AAEA,IAAM,IAAgD;CACpD,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;CACL,KAAK;AACP,GAEM,IAAQ,IAAI,IAAY,CAAW;AAGzC,eAAsB,EAAoB,GAAyC;CACjF,IAAI,IAA4B,CAAC;CACjC,IAAI;EACF,IAAQ,MAAM,EAAI,KAAK;CACzB,QAAQ,CAER;CACA,IAAM,IAAS,OAAO,EAAI,QAAQ,IAAI,aAAa,CAAC,GAC9C,IAAa,EAAK,gBAAgB,OAAO,SAAS,CAAM,KAAK,IAAS,IAAI,IAAS,KAAA;CAEzF,OAAO,IAAI,EADE,EAAK,QAAQ,EAAM,IAAI,EAAK,IAAI,IAAK,EAAK,OAAgC,EAAS,EAAI,YAAY,EAAI,UAAU,MAAM,mBAAmB,oBACtH,EAAK,SAAS,QAAQ,EAAI,UAAU;EACnE,QAAQ,EAAI;EACZ;EACA,OAAO,EAAK;EACZ,SAAS,EAAK;EACd,KAAK,EAAK;EACV,QAAQ,EAAK;EACb,QAAQ,EAAK;EACb,aAAa,EAAK;CACpB,CAAC;AACH;AAGA,SAAgB,EAAa,GAA6B;CAExD,OAAO,IAAI,EADE,EAAE,QAAQ,EAAM,IAAI,EAAE,IAAI,IAAK,EAAE,OAA+B,kBAC5C,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,CAAC;AACpE"}
+{"version":3,"file":"errors.js","names":[],"sources":["../../src/client/errors.ts"],"sourcesContent":["import { CONTENTKIT_ERROR_CODES, type ErrorCode } from \"./generated/error-codes.js\";\nimport type { BanNotice, ErrorDetails, ErrorReply, Failure } from \"./generated/wire.js\";\n\n/**\n * Codes raised in the browser: network (no server reached), server_unavailable\n * (a gateway or timeout answered instead of ContentKit), storage (the bucket\n * refused a PUT), aborted (the caller's signal), resume_mismatch (saved state\n * is not for this file), decode (not readable as an image) and render_timeout\n * (still processing after the wait).\n */\nexport const CLIENT_ERROR_CODES = [\"network\", \"server_unavailable\", \"storage\", \"aborted\", \"resume_mismatch\", \"decode\", \"render_timeout\"] as const;\n\nexport type ContentKitErrorCode = ErrorCode | (typeof CLIENT_ERROR_CODES)[number];\n\n/** Every code a ContentKitError can carry: the server's registry, then the client's. */\nexport const ERROR_CODES: readonly ContentKitErrorCode[] = [...(Object.keys(CONTENTKIT_ERROR_CODES) as ErrorCode[]), ...CLIENT_ERROR_CODES];\n\nexport interface ContentKitErrorInit extends ErrorOptions {\n  status?: number;\n  retryAfter?: number;\n  details?: ErrorDetails;\n  blobs?: string[];\n  ban?: BanNotice;\n  action?: string;\n  reason?: string;\n  availableAt?: string;\n  unknownCode?: string;\n}\n\nexport class ContentKitError extends Error {\n  override readonly name = \"ContentKitError\";\n  /** HTTP status; 0 for client-side codes. */\n  readonly status: number;\n  readonly retryAfter?: number;\n  readonly details?: ErrorDetails;\n  readonly blobs?: string[];\n  readonly ban?: BanNotice;\n  readonly action?: string;\n  /** A download_unavailable's code of the host's policy (\"release_window\"). */\n  readonly reason?: string;\n  /** A download_unavailable's opening time (RFC 3339), when a matter of time. */\n  readonly availableAt?: string;\n  /** A server code this client doesn't know (a newer server): `message` is the server's own and `code` its status's. */\n  readonly unknownCode?: string;\n\n  constructor(\n    readonly code: ContentKitErrorCode,\n    message: string,\n    init: ContentKitErrorInit = {},\n  ) {\n    super(message, init.cause === undefined ? undefined : { cause: init.cause });\n    this.status = init.status ?? 0;\n    this.retryAfter = init.retryAfter;\n    this.details = init.details;\n    this.blobs = init.blobs;\n    this.ban = init.ban;\n    this.action = init.action;\n    this.reason = init.reason;\n    this.availableAt = init.availableAt;\n    this.unknownCode = init.unknownCode;\n  }\n\n  /**\n   * The request broke a rule the message states (a 4xx or a typed refusal),\n   * as opposed to a fault on the server or the network: show it as is.\n   */\n  get refusal(): boolean {\n    return (this.status >= 400 && this.status < 500 && this.code !== \"storage\") || this.code.startsWith(\"image_\") || this.code === \"decode\";\n  }\n\n  /** Rate or quota refusals: stop starting new requests until the limit frees. */\n  get isLimit(): boolean {\n    return this.code === \"rate_limited\" || this.code === \"quota_exceeded\";\n  }\n\n  /** The commit would exceed the kind's file caps (too_many_files, 409): remove files first. */\n  get isCeiling(): boolean {\n    return this.code === \"too_many_files\";\n  }\n\n  /** Refusals that apply to every upload of this caller, not just this file. */\n  get blocksQueue(): boolean {\n    return this.isLimit || this.code === \"unauthorized\" || this.code === \"forbidden\";\n  }\n\n  /** Worth retrying the same request. */\n  get transient(): boolean {\n    return (\n      this.code === \"network\" ||\n      this.code === \"server_unavailable\" ||\n      this.code === \"internal_error\" ||\n      this.code === \"unavailable\" ||\n      (this.code === \"storage\" && (this.status >= 500 || this.status === 403 || this.status === 408 || this.status === 429))\n    );\n  }\n}\n\nexport const isContentKitError = (e: unknown): e is ContentKitError => e instanceof ContentKitError;\n\n/** Anything a call can throw, as a ContentKitError: a transport failure's code, else internal_error. */\nexport function toContentKitError(e: unknown): ContentKitError {\n  if (e instanceof ContentKitError) return e;\n  return new ContentKitError(transportFailure(e) ?? \"internal_error\", e instanceof Error ? e.message : String(e), { cause: e });\n}\n\n/** A fetch that got no response: the caller's abort, a timeout, else no server reached. */\nexport function requestFailure(err: unknown, signal: AbortSignal | undefined, target: string): ContentKitError {\n  const code = transportFailure(err);\n  if (code !== \"server_unavailable\" && signal?.aborted) return aborted(signal);\n  return code === \"server_unavailable\"\n    ? new ContentKitError(code, `${target} did not respond`, { cause: err })\n    : new ContentKitError(\"network\", `${target} unreachable`, { cause: err });\n}\n\n// A gateway answered for ContentKit: down, restarting or timed out (52x: Cloudflare).\nconst GATEWAY_STATUS = new Set([502, 503, 504, 520, 521, 522, 523, 524]);\n\n// fetch rejects with a TypeError when no server answers (offline, DNS,\n// connection refused, CORS); engines word it differently.\nconst FETCH_FAILURE = /fetch|network|load failed|connection/i;\n\n/**\n * The client code of a request no server answered (mirrors auth-ui's and\n * billing-ui's): network when none was reached, server_unavailable when a\n * gateway or timeout answered. Recognizes the sibling SDKs' codes too.\n */\nexport function transportFailure(error: unknown): \"network\" | \"server_unavailable\" | undefined {\n  if (error instanceof TypeError) {\n    const offline = globalThis.navigator?.onLine === false;\n    return offline || FETCH_FAILURE.test(error.message) ? \"network\" : undefined;\n  }\n  if (!error || typeof error !== \"object\") return undefined;\n  const { name, code, status } = error as { name?: unknown; code?: unknown; status?: unknown };\n  if (name === \"TimeoutError\") return \"server_unavailable\";\n  if (code === \"network\" || code === \"network_error\") return \"network\";\n  if (code === \"server_unavailable\") return code;\n  if (code === undefined || code === \"unknown_error\" || code === \"server_error\")\n    return typeof status === \"number\" && GATEWAY_STATUS.has(status) ? \"server_unavailable\" : undefined;\n  return undefined;\n}\n\nexport function aborted(signal?: AbortSignal): ContentKitError {\n  return new ContentKitError(\"aborted\", \"request canceled\", { cause: signal?.reason });\n}\n\nexport function throwIfAborted(signal?: AbortSignal): void {\n  if (signal?.aborted) throw aborted(signal);\n}\n\nconst byStatus: Record<number, ContentKitErrorCode> = {\n  401: \"unauthorized\",\n  403: \"forbidden\",\n  404: \"not_found\",\n  409: \"conflict\",\n  410: \"gone\",\n  413: \"too_large\",\n  415: \"type_not_allowed\",\n  429: \"rate_limited\",\n  501: \"not_configured\",\n  503: \"unavailable\",\n};\n\nconst known = new Set<string>(ERROR_CODES);\n\n/** Reads a response that is not 2xx. */\nexport async function readContentKitError(res: Response): Promise<ContentKitError> {\n  let body: Partial<ErrorReply> = {};\n  try {\n    body = (await res.json()) as Partial<ErrorReply>;\n  } catch {\n    // not JSON (a proxy error page)\n  }\n  const header = Number(res.headers.get(\"Retry-After\"));\n  const retryAfter = body.retry_after ?? (Number.isFinite(header) && header > 0 ? header : undefined);\n  const code =\n    body.code && known.has(body.code)\n      ? (body.code as ContentKitErrorCode)\n      : !body.code && GATEWAY_STATUS.has(res.status)\n        ? \"server_unavailable\"\n        : (byStatus[res.status] ?? (res.status >= 500 ? \"internal_error\" : \"invalid_request\"));\n  return new ContentKitError(code, body.error ?? `HTTP ${res.status}`, {\n    status: res.status,\n    retryAfter,\n    blobs: body.blobs,\n    details: body.details,\n    ban: body.ban,\n    action: body.action,\n    reason: body.reason,\n    availableAt: body.available_at,\n    unknownCode: body.code && !known.has(body.code) ? body.code : undefined,\n  });\n}\n\n/** An upload's recorded processing failure: its typed refusal, else a processing fault. */\nexport function failureError(f: Failure): ContentKitError {\n  const code = f.code && known.has(f.code) ? (f.code as ContentKitErrorCode) : \"internal_error\";\n  return new ContentKitError(code, f.message, { details: f.details });\n}\n"],"mappings":"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"}

package/dist/client/generated/routes.d.ts

@@ -1038,7 +1038,7 @@ export declare const CONTENTKIT_ROUTES: readonly [{
     readonly auth: "public";
     readonly permission: null;
     readonly query: readonly [];
-    readonly request: "ImageInput";
+    readonly request: "BodyImageInput";
     readonly responses: {
         readonly 200: "InlineImage";
     };

package/dist/client/generated/routes.js

@@ -1451,7 +1451,7 @@ var e = {
 		auth: "public",
 		permission: null,
 		query: [],
-		request: "ImageInput",
+		request: "BodyImageInput",
 		responses: { 200: "InlineImage" },
 		errors: [
 			"forbidden",