@openrails/contentkit-ui 0.104.0-rc.2 → 0.104.0

package/dist/client/contents.d.ts

@@ -42,6 +42,8 @@ export declare class ContentsClient {
     setCreators(id: string, creators: Creator[]): Promise<Content>;
     /** Publishes now, or schedules for at; moderation "held" when the moderator holds it. */
     publish(id: string, at?: string): Promise<Content>;
+    /** publish, retrying while the server answers not_ready (files finishing their publication) for up to waitMs. */
+    publishWhenReady(id: string, at?: string, waitMs?: number): Promise<Content>;
     unpublish(id: string): Promise<Content>;
     remove(id: string): Promise<void>;
     restore(id: string): Promise<Content>;

package/dist/client/contents.js

@@ -1,101 +1,111 @@
-import { call as e } from "./route.js";
+import { toContentKitError as e } from "./errors.js";
+import { call as t } from "./route.js";
 //#region src/client/contents.ts
-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 {
+var n = "contentkit:", r = (e) => n + e, 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 {
 	http;
 	constructor(e) {
 		this.http = e;
 	}
-	get(t, n, r) {
-		return e(this.http, "GET", "/contents/{id}", {
-			params: { id: t },
+	get(e, n, r) {
+		return t(this.http, "GET", "/contents/{id}", {
+			params: { id: e },
 			query: { language: n },
 			signal: r
 		});
 	}
-	version(t, n, r, i) {
-		return e(this.http, "GET", "/contents/{id}/versions/{vid}", {
+	version(e, n, r, i) {
+		return t(this.http, "GET", "/contents/{id}/versions/{vid}", {
 			params: {
-				id: t,
+				id: e,
 				vid: n
 			},
 			query: { language: r },
 			signal: i
 		});
 	}
-	manage(t = {}, n) {
-		let { kind: r, ...i } = t;
-		return r ? e(this.http, "GET", "/manage/{kind}", {
+	manage(e = {}, n) {
+		let { kind: r, ...i } = e;
+		return r ? t(this.http, "GET", "/manage/{kind}", {
 			params: { kind: r },
 			query: i,
 			signal: n
-		}) : e(this.http, "GET", "/manage", {
+		}) : t(this.http, "GET", "/manage", {
 			query: i,
 			signal: n
 		});
 	}
-	manageCount(t, n) {
-		let { kind: r, ...i } = t;
-		return e(this.http, "GET", "/manage/{kind}/count", {
+	manageCount(e, n) {
+		let { kind: r, ...i } = e;
+		return t(this.http, "GET", "/manage/{kind}/count", {
 			params: { kind: r },
 			query: i,
 			signal: n
 		});
 	}
-	create(t) {
-		return this.write(e(this.http, "POST", "/contents", { body: t }));
+	create(e) {
+		return this.write(t(this.http, "POST", "/contents", { body: e }));
 	}
-	update(t, n) {
-		return this.write(e(this.http, "PATCH", "/contents/{id}", {
-			params: { id: t },
+	update(e, n) {
+		return this.write(t(this.http, "PATCH", "/contents/{id}", {
+			params: { id: e },
 			body: n
 		}));
 	}
-	putText(t, n, r) {
-		return this.write(e(this.http, "PUT", "/contents/{id}/text/{language}", {
+	putText(e, n, r) {
+		return this.write(t(this.http, "PUT", "/contents/{id}/text/{language}", {
 			params: {
-				id: t,
+				id: e,
 				language: n
 			},
 			body: r
 		}));
 	}
-	deleteText(t, n) {
-		return this.write(e(this.http, "DELETE", "/contents/{id}/text/{language}", { params: {
-			id: t,
+	deleteText(e, n) {
+		return this.write(t(this.http, "DELETE", "/contents/{id}/text/{language}", { params: {
+			id: e,
 			language: n
 		} }));
 	}
-	setCreators(t, n) {
-		return this.write(e(this.http, "PUT", "/contents/{id}/creators", {
-			params: { id: t },
+	setCreators(e, n) {
+		return this.write(t(this.http, "PUT", "/contents/{id}/creators", {
+			params: { id: e },
 			body: { creators: n }
 		}));
 	}
-	publish(t, n) {
-		return this.write(e(this.http, "POST", "/contents/{id}/publish", {
-			params: { id: t },
+	publish(e, n) {
+		return this.write(t(this.http, "POST", "/contents/{id}/publish", {
+			params: { id: e },
 			body: { publish_at: n }
 		}));
 	}
-	unpublish(t) {
-		return this.write(e(this.http, "POST", "/contents/{id}/unpublish", { params: { id: t } }));
+	async publishWhenReady(t, n, r = 3e4) {
+		let i = Date.now() + r;
+		for (let r = 1e3;; r = Math.min(r * 2, 5e3)) try {
+			return await this.publish(t, n);
+		} catch (t) {
+			if (e(t).code !== "not_ready" || Date.now() + r > i) throw t;
+			await new Promise((e) => setTimeout(e, r));
+		}
 	}
-	async remove(t) {
+	unpublish(e) {
+		return this.write(t(this.http, "POST", "/contents/{id}/unpublish", { params: { id: e } }));
+	}
+	async remove(e) {
 		let n = this.http.captureChanges();
-		await e(this.http, "DELETE", "/contents/{id}", { params: { id: t } }), n({
+		await t(this.http, "DELETE", "/contents/{id}", { params: { id: e } }), n({
 			type: "content.deleted",
-			id: t
+			id: e
 		});
 	}
-	restore(t) {
-		return this.write(e(this.http, "POST", "/contents/{id}/restore", { params: { id: t } }));
+	restore(e) {
+		return this.write(t(this.http, "POST", "/contents/{id}/restore", { params: { id: e } }));
 	}
 	setCover(e, t, n) {
 		return this.updateVersion(e, t, { cover: n ?? "" });
 	}
-	inlineImage(t, n, r, i) {
-		return e(this.http, "POST", "/contents/{id}/images", {
-			params: { id: t },
+	inlineImage(e, n, r, i) {
+		return t(this.http, "POST", "/contents/{id}/images", {
+			params: { id: e },
 			body: {
 				image: r,
 				version: n
@@ -103,37 +113,37 @@ var t = "contentkit:", n = (e) => t + e, r = () => /contentkit:(i-[0-9a-f]{8}-[0
 			signal: i
 		});
 	}
-	addVersion(t, n) {
-		return this.writeVersion(t, e(this.http, "POST", "/contents/{id}/versions", {
-			params: { id: t },
+	addVersion(e, n) {
+		return this.writeVersion(e, t(this.http, "POST", "/contents/{id}/versions", {
+			params: { id: e },
 			body: n
 		}));
 	}
-	updateVersion(t, n, r) {
-		return this.writeVersion(t, e(this.http, "PATCH", "/contents/{id}/versions/{vid}", {
+	updateVersion(e, n, r) {
+		return this.writeVersion(e, t(this.http, "PATCH", "/contents/{id}/versions/{vid}", {
 			params: {
-				id: t,
+				id: e,
 				vid: n
 			},
 			body: r
 		}));
 	}
-	async removeVersion(t, n) {
-		await this.writeVersion(t, e(this.http, "DELETE", "/contents/{id}/versions/{vid}", { params: {
-			id: t,
+	async removeVersion(e, n) {
+		await this.writeVersion(e, t(this.http, "DELETE", "/contents/{id}/versions/{vid}", { params: {
+			id: e,
 			vid: n
 		} }));
 	}
-	orderVersions(t, n) {
-		return this.write(e(this.http, "PUT", "/contents/{id}/versions/order", {
-			params: { id: t },
+	orderVersions(e, n) {
+		return this.write(t(this.http, "PUT", "/contents/{id}/versions/order", {
+			params: { id: e },
 			body: { ids: n }
 		}));
 	}
-	setSegments(t, n, r) {
-		return this.writeVersion(t, e(this.http, "PUT", "/contents/{id}/versions/{vid}/segments", {
+	setSegments(e, n, r) {
+		return this.writeVersion(e, t(this.http, "PUT", "/contents/{id}/versions/{vid}/segments", {
 			params: {
-				id: t,
+				id: e,
 				vid: n
 			},
 			body: { segments: r }
@@ -155,6 +165,6 @@ var t = "contentkit:", n = (e) => t + e, r = () => /contentkit:(i-[0-9a-f]{8}-[0
 	}
 };
 //#endregion
-export { i as ContentsClient, t as IMAGE_SCHEME, n as imageRef, r as imageRefs };
+export { a as ContentsClient, n as IMAGE_SCHEME, r as imageRef, i 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  ManageCount,\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/** Management filters; kind selects /manage/{kind}, otherwise /manage. */\nexport type ManageQuery = RouteQuery<\"GET\", \"/manage\"> & { kind?: string };\n\n/** The /manage/{kind} filters a count takes. */\nexport type ManageCountQuery = RouteQuery<\"GET\", \"/manage/{kind}/count\"> & { kind: string };\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    const { kind, ...query } = q;\n    return kind\n      ? call(this.http, \"GET\", \"/manage/{kind}\", { params: { kind }, query, signal })\n      : call(this.http, \"GET\", \"/manage\", { query, signal });\n  }\n  /** How many items of a kind the caller manages under these filters: exact up to 10,000, then truncated. */\n  manageCount(q: ManageCountQuery, signal?: AbortSignal): Promise<ManageCount> {\n    const { kind, ...query } = q;\n    return call(this.http, \"GET\", \"/manage/{kind}/count\", { params: { kind }, query, 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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"}
+{"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  ManageCount,\n  Segment,\n  Version,\n  VersionInput,\n} from \"./generated/wire.js\";\nimport { toContentKitError } from \"./errors.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/** Management filters; kind selects /manage/{kind}, otherwise /manage. */\nexport type ManageQuery = RouteQuery<\"GET\", \"/manage\"> & { kind?: string };\n\n/** The /manage/{kind} filters a count takes. */\nexport type ManageCountQuery = RouteQuery<\"GET\", \"/manage/{kind}/count\"> & { kind: string };\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    const { kind, ...query } = q;\n    return kind\n      ? call(this.http, \"GET\", \"/manage/{kind}\", { params: { kind }, query, signal })\n      : call(this.http, \"GET\", \"/manage\", { query, signal });\n  }\n  /** How many items of a kind the caller manages under these filters: exact up to 10,000, then truncated. */\n  manageCount(q: ManageCountQuery, signal?: AbortSignal): Promise<ManageCount> {\n    const { kind, ...query } = q;\n    return call(this.http, \"GET\", \"/manage/{kind}/count\", { params: { kind }, query, 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  /** publish, retrying while the server answers not_ready (files finishing their publication) for up to waitMs. */\n  async publishWhenReady(id: string, at?: string, waitMs = 30_000): Promise<Content> {\n    const deadline = Date.now() + waitMs;\n    for (let delay = 1000; ; delay = Math.min(delay * 2, 5000)) {\n      try {\n        return await this.publish(id, at);\n      } catch (e) {\n        if (toContentKitError(e).code !== \"not_ready\" || Date.now() + delay > deadline) throw e;\n        await new Promise((resolve) => setTimeout(resolve, delay));\n      }\n    }\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/generated/error-codes.d.ts

@@ -1,4 +1,4 @@
-export type ErrorCode = "ambiguous_entity" | "animation_not_allowed" | "animation_too_long" | "animation_unsupported" | "checksum_mismatch" | "comment_banned" | "comment_too_long" | "comments_closed" | "comments_locked" | "conflict" | "content_changed" | "download_unavailable" | "forbidden" | "gone" | "image_too_large" | "image_too_small" | "image_unreadable" | "incomplete" | "internal_error" | "invalid_archive" | "invalid_request" | "limit_reached" | "moderation_rejected" | "no_download" | "not_configured" | "not_found" | "not_joinable" | "not_uploaded" | "operation_busy" | "operation_conflict" | "quota_exceeded" | "rate_limited" | "source_conflict" | "tenant_mismatch" | "too_large" | "too_many_files" | "type_not_allowed" | "unauthorized" | "unavailable" | "unknown_entity" | "upgrade_required" | "video_aspect_unsupported" | "video_over_budget" | "video_too_large" | "video_too_long";
+export type ErrorCode = "ambiguous_entity" | "animation_not_allowed" | "animation_too_long" | "animation_unsupported" | "checksum_mismatch" | "comment_banned" | "comment_too_long" | "comments_closed" | "comments_locked" | "conflict" | "content_changed" | "download_unavailable" | "forbidden" | "gone" | "image_too_large" | "image_too_small" | "image_unreadable" | "incomplete" | "internal_error" | "invalid_archive" | "invalid_request" | "limit_reached" | "moderation_rejected" | "no_download" | "not_configured" | "not_found" | "not_joinable" | "not_ready" | "not_uploaded" | "operation_busy" | "operation_conflict" | "quota_exceeded" | "rate_limited" | "source_conflict" | "tenant_mismatch" | "too_large" | "too_many_files" | "type_not_allowed" | "unauthorized" | "unavailable" | "unknown_entity" | "upgrade_required" | "video_aspect_unsupported" | "video_over_budget" | "video_too_large" | "video_too_long";
 export declare const CONTENTKIT_ERROR_CODES: Readonly<Record<ErrorCode, {
     status: number;
     meaning: string;

package/dist/client/generated/error-codes.js

@@ -108,6 +108,10 @@ var e = {
 		status: 409,
 		meaning: "The group has no free offer to join: it sells its membership, or nothing."
 	},
+	not_ready: {
+		status: 409,
+		meaning: "A version that would go live still has files processing or a publication not yet current; `error` says what. Retry once processing finishes."
+	},
 	not_uploaded: {
 		status: 409,
 		meaning: "A commit names an upload that has not landed; `blobs` lists the ones to upload again."

package/dist/client/generated/error-codes.js.map

@@ -1 +1 @@
-{"version":3,"file":"error-codes.js","names":[],"sources":["../../../src/client/generated/error-codes.ts"],"sourcesContent":["// Generated by `go generate ./internal/contract` from ContentKit's error-code registry. Do not edit.\n\nexport type ErrorCode =\n  | \"ambiguous_entity\"\n  | \"animation_not_allowed\"\n  | \"animation_too_long\"\n  | \"animation_unsupported\"\n  | \"checksum_mismatch\"\n  | \"comment_banned\"\n  | \"comment_too_long\"\n  | \"comments_closed\"\n  | \"comments_locked\"\n  | \"conflict\"\n  | \"content_changed\"\n  | \"download_unavailable\"\n  | \"forbidden\"\n  | \"gone\"\n  | \"image_too_large\"\n  | \"image_too_small\"\n  | \"image_unreadable\"\n  | \"incomplete\"\n  | \"internal_error\"\n  | \"invalid_archive\"\n  | \"invalid_request\"\n  | \"limit_reached\"\n  | \"moderation_rejected\"\n  | \"no_download\"\n  | \"not_configured\"\n  | \"not_found\"\n  | \"not_joinable\"\n  | \"not_uploaded\"\n  | \"operation_busy\"\n  | \"operation_conflict\"\n  | \"quota_exceeded\"\n  | \"rate_limited\"\n  | \"source_conflict\"\n  | \"tenant_mismatch\"\n  | \"too_large\"\n  | \"too_many_files\"\n  | \"type_not_allowed\"\n  | \"unauthorized\"\n  | \"unavailable\"\n  | \"unknown_entity\"\n  | \"upgrade_required\"\n  | \"video_aspect_unsupported\"\n  | \"video_over_budget\"\n  | \"video_too_large\"\n  | \"video_too_long\"\n;\n\n// Each code's HTTP status and meaning. A message on the wire is for people;\n// classify by code.\nexport const CONTENTKIT_ERROR_CODES: Readonly<Record<ErrorCode, { status: number; meaning: string }>> = {\n  ambiguous_entity: { status: 409, meaning: \"More than one entity matches the localized name or alias and scope; supply its ID.\" },\n  animation_not_allowed: { status: 422, meaning: \"An animated image where the upload path refuses animation.\" },\n  animation_too_long: { status: 422, meaning: \"The animation has more frames or seconds than the processor allows.\" },\n  animation_unsupported: { status: 415, meaning: \"An AVIF or HEIF image sequence, which is decoded as one frame.\" },\n  checksum_mismatch: { status: 422, meaning: \"The stored bytes differ from the declared SHA-256.\" },\n  comment_banned: { status: 403, meaning: \"The actor is banned from commenting on this target; `ban` says the scope, the reason and when it ends.\" },\n  comment_too_long: { status: 422, meaning: \"The comment is longer than the site allows; `details.max` is the limit in characters.\" },\n  comments_closed: { status: 403, meaning: \"The target's comments are closed or hidden: existing ones may show, new ones and edits are refused.\" },\n  comments_locked: { status: 403, meaning: \"The actor can't open the content (or the comment's version), so its comments take no writes from them; reads withhold them.\" },\n  conflict: { status: 409, meaning: \"A concurrent change, a path or slug already taken, or an operation id already used for another commit.\" },\n  content_changed: { status: 409, meaning: \"A publishing operation's content or version was edited after submission.\" },\n  download_unavailable: { status: 403, meaning: \"The host's download policy refuses this download now: `reason` is its code, `available_at` when it opens if a matter of time. Nothing was charged.\" },\n  forbidden: { status: 403, meaning: \"The actor may not do this.\" },\n  gone: { status: 410, meaning: \"The content was removed.\" },\n  image_too_large: { status: 413, meaning: \"The image has more pixels or frames than the processor decodes.\" },\n  image_too_small: { status: 422, meaning: \"The edited image is narrower than its public preset's minimum width.\" },\n  image_unreadable: { status: 422, meaning: \"The file is not a decodable image of its declared type.\" },\n  incomplete: { status: 409, meaning: \"A multipart upload is missing parts.\" },\n  internal_error: { status: 500, meaning: \"A server fault; the cause is in the server log.\" },\n  invalid_archive: { status: 422, meaning: \"The publishing archive cannot produce the required supported pages.\" },\n  invalid_request: { status: 400, meaning: \"The request is malformed: its body, a query parameter or a path value.\" },\n  limit_reached: { status: 409, meaning: \"The owner already has as many groups of the kind as the site allows (max_per_owner).\" },\n  moderation_rejected: { status: 422, meaning: \"The moderator refused the text; `error` says why.\" },\n  no_download: { status: 409, meaning: \"The version has no file its kind's download serves: nothing uploaded, or its upload failed or was dropped.\" },\n  not_configured: { status: 501, meaning: \"The capability needs a port the host did not configure; retrying does not help.\" },\n  not_found: { status: 404, meaning: \"Nothing by that name, or nothing the actor may see.\" },\n  not_joinable: { status: 409, meaning: \"The group has no free offer to join: it sells its membership, or nothing.\" },\n  not_uploaded: { status: 409, meaning: \"A commit names an upload that has not landed; `blobs` lists the ones to upload again.\" },\n  operation_busy: { status: 409, meaning: \"The publishing operation is preparing an upload or completing another request; retry.\" },\n  operation_conflict: { status: 409, meaning: \"A publishing operation ID already names different immutable input.\" },\n  quota_exceeded: { status: 413, meaning: \"The uploader's storage quota is used up.\" },\n  rate_limited: { status: 429, meaning: \"Too many requests; retry after `retry_after` seconds (also the Retry-After header).\" },\n  source_conflict: { status: 409, meaning: \"The external source already belongs to another publishing operation in this app.\" },\n  tenant_mismatch: { status: 500, meaning: \"A host port answered with another tenant's data: a configuration fault.\" },\n  too_large: { status: 413, meaning: \"The file is larger than its upload path allows; `details` has `size` and `max_bytes`.\" },\n  too_many_files: { status: 409, meaning: \"The commit would put more files in an upload path, or the item, than allowed; `details.max` is the limit.\" },\n  type_not_allowed: { status: 415, meaning: \"The file type is not allowed in the upload path; `details.allowed` lists the types.\" },\n  unauthorized: { status: 401, meaning: \"The request needs a valid credential: it has none where the route needs one, or one that is expired, revoked or invalid. WWW-Authenticate says which.\" },\n  unavailable: { status: 503, meaning: \"The host's auth, media storage or signal plane cannot be reached, or a commit's recovery is pending; retry.\" },\n  unknown_entity: { status: 400, meaning: \"A publishing entity reference does not resolve in this app and entity creation is disabled.\" },\n  upgrade_required: { status: 503, meaning: \"The media item was stored before v0.68 and is served once the host's media upgrade (contentkit_media_upgrade) has converted it.\" },\n  video_aspect_unsupported: { status: 422, meaning: \"The video's display aspect is outside what its upload path accepts; `details` has `min_aspect` and `max_aspect` (width/height).\" },\n  video_over_budget: { status: 422, meaning: \"The planned encode costs more than its upload path allows, or the source averages under a frame a second.\" },\n  video_too_large: { status: 422, meaning: \"The video's frames are larger than its upload path allows.\" },\n  video_too_long: { status: 422, meaning: \"The video or audio runs longer than its upload path allows.\" },\n};\n"],"mappings":";AAoDA,IAAa,IAA2F;CACtG,kBAAkB;EAAE,QAAQ;EAAK,SAAS;CAAqF;CAC/H,uBAAuB;EAAE,QAAQ;EAAK,SAAS;CAA6D;CAC5G,oBAAoB;EAAE,QAAQ;EAAK,SAAS;CAAsE;CAClH,uBAAuB;EAAE,QAAQ;EAAK,SAAS;CAAiE;CAChH,mBAAmB;EAAE,QAAQ;EAAK,SAAS;CAAqD;CAChG,gBAAgB;EAAE,QAAQ;EAAK,SAAS;CAAyG;CACjJ,kBAAkB;EAAE,QAAQ;EAAK,SAAS;CAAwF;CAClI,iBAAiB;EAAE,QAAQ;EAAK,SAAS;CAAsG;CAC/I,iBAAiB;EAAE,QAAQ;EAAK,SAAS;CAA8H;CACvK,UAAU;EAAE,QAAQ;EAAK,SAAS;CAAyG;CAC3I,iBAAiB;EAAE,QAAQ;EAAK,SAAS;CAA2E;CACpH,sBAAsB;EAAE,QAAQ;EAAK,SAAS;CAAqJ;CACnM,WAAW;EAAE,QAAQ;EAAK,SAAS;CAA6B;CAChE,MAAM;EAAE,QAAQ;EAAK,SAAS;CAA2B;CACzD,iBAAiB;EAAE,QAAQ;EAAK,SAAS;CAAkE;CAC3G,iBAAiB;EAAE,QAAQ;EAAK,SAAS;CAAuE;CAChH,kBAAkB;EAAE,QAAQ;EAAK,SAAS;CAA0D;CACpG,YAAY;EAAE,QAAQ;EAAK,SAAS;CAAuC;CAC3E,gBAAgB;EAAE,QAAQ;EAAK,SAAS;CAAkD;CAC1F,iBAAiB;EAAE,QAAQ;EAAK,SAAS;CAAsE;CAC/G,iBAAiB;EAAE,QAAQ;EAAK,SAAS;CAAyE;CAClH,eAAe;EAAE,QAAQ;EAAK,SAAS;CAAuF;CAC9H,qBAAqB;EAAE,QAAQ;EAAK,SAAS;CAAoD;CACjG,aAAa;EAAE,QAAQ;EAAK,SAAS;CAA6G;CAClJ,gBAAgB;EAAE,QAAQ;EAAK,SAAS;CAAkF;CAC1H,WAAW;EAAE,QAAQ;EAAK,SAAS;CAAsD;CACzF,cAAc;EAAE,QAAQ;EAAK,SAAS;CAA4E;CAClH,cAAc;EAAE,QAAQ;EAAK,SAAS;CAAwF;CAC9H,gBAAgB;EAAE,QAAQ;EAAK,SAAS;CAAwF;CAChI,oBAAoB;EAAE,QAAQ;EAAK,SAAS;CAAqE;CACjH,gBAAgB;EAAE,QAAQ;EAAK,SAAS;CAA2C;CACnF,cAAc;EAAE,QAAQ;EAAK,SAAS;CAAsF;CAC5H,iBAAiB;EAAE,QAAQ;EAAK,SAAS;CAAmF;CAC5H,iBAAiB;EAAE,QAAQ;EAAK,SAAS;CAA0E;CACnH,WAAW;EAAE,QAAQ;EAAK,SAAS;CAAwF;CAC3H,gBAAgB;EAAE,QAAQ;EAAK,SAAS;CAA4G;CACpJ,kBAAkB;EAAE,QAAQ;EAAK,SAAS;CAAsF;CAChI,cAAc;EAAE,QAAQ;EAAK,SAAS;CAAwJ;CAC9L,aAAa;EAAE,QAAQ;EAAK,SAAS;CAA8G;CACnJ,gBAAgB;EAAE,QAAQ;EAAK,SAAS;CAA8F;CACtI,kBAAkB;EAAE,QAAQ;EAAK,SAAS;CAAkI;CAC5K,0BAA0B;EAAE,QAAQ;EAAK,SAAS;CAAkI;CACpL,mBAAmB;EAAE,QAAQ;EAAK,SAAS;CAA4G;CACvJ,iBAAiB;EAAE,QAAQ;EAAK,SAAS;CAA6D;CACtG,gBAAgB;EAAE,QAAQ;EAAK,SAAS;CAA8D;AACxG"}
+{"version":3,"file":"error-codes.js","names":[],"sources":["../../../src/client/generated/error-codes.ts"],"sourcesContent":["// Generated by `go generate ./internal/contract` from ContentKit's error-code registry. Do not edit.\n\nexport type ErrorCode =\n  | \"ambiguous_entity\"\n  | \"animation_not_allowed\"\n  | \"animation_too_long\"\n  | \"animation_unsupported\"\n  | \"checksum_mismatch\"\n  | \"comment_banned\"\n  | \"comment_too_long\"\n  | \"comments_closed\"\n  | \"comments_locked\"\n  | \"conflict\"\n  | \"content_changed\"\n  | \"download_unavailable\"\n  | \"forbidden\"\n  | \"gone\"\n  | \"image_too_large\"\n  | \"image_too_small\"\n  | \"image_unreadable\"\n  | \"incomplete\"\n  | \"internal_error\"\n  | \"invalid_archive\"\n  | \"invalid_request\"\n  | \"limit_reached\"\n  | \"moderation_rejected\"\n  | \"no_download\"\n  | \"not_configured\"\n  | \"not_found\"\n  | \"not_joinable\"\n  | \"not_ready\"\n  | \"not_uploaded\"\n  | \"operation_busy\"\n  | \"operation_conflict\"\n  | \"quota_exceeded\"\n  | \"rate_limited\"\n  | \"source_conflict\"\n  | \"tenant_mismatch\"\n  | \"too_large\"\n  | \"too_many_files\"\n  | \"type_not_allowed\"\n  | \"unauthorized\"\n  | \"unavailable\"\n  | \"unknown_entity\"\n  | \"upgrade_required\"\n  | \"video_aspect_unsupported\"\n  | \"video_over_budget\"\n  | \"video_too_large\"\n  | \"video_too_long\"\n;\n\n// Each code's HTTP status and meaning. A message on the wire is for people;\n// classify by code.\nexport const CONTENTKIT_ERROR_CODES: Readonly<Record<ErrorCode, { status: number; meaning: string }>> = {\n  ambiguous_entity: { status: 409, meaning: \"More than one entity matches the localized name or alias and scope; supply its ID.\" },\n  animation_not_allowed: { status: 422, meaning: \"An animated image where the upload path refuses animation.\" },\n  animation_too_long: { status: 422, meaning: \"The animation has more frames or seconds than the processor allows.\" },\n  animation_unsupported: { status: 415, meaning: \"An AVIF or HEIF image sequence, which is decoded as one frame.\" },\n  checksum_mismatch: { status: 422, meaning: \"The stored bytes differ from the declared SHA-256.\" },\n  comment_banned: { status: 403, meaning: \"The actor is banned from commenting on this target; `ban` says the scope, the reason and when it ends.\" },\n  comment_too_long: { status: 422, meaning: \"The comment is longer than the site allows; `details.max` is the limit in characters.\" },\n  comments_closed: { status: 403, meaning: \"The target's comments are closed or hidden: existing ones may show, new ones and edits are refused.\" },\n  comments_locked: { status: 403, meaning: \"The actor can't open the content (or the comment's version), so its comments take no writes from them; reads withhold them.\" },\n  conflict: { status: 409, meaning: \"A concurrent change, a path or slug already taken, or an operation id already used for another commit.\" },\n  content_changed: { status: 409, meaning: \"A publishing operation's content or version was edited after submission.\" },\n  download_unavailable: { status: 403, meaning: \"The host's download policy refuses this download now: `reason` is its code, `available_at` when it opens if a matter of time. Nothing was charged.\" },\n  forbidden: { status: 403, meaning: \"The actor may not do this.\" },\n  gone: { status: 410, meaning: \"The content was removed.\" },\n  image_too_large: { status: 413, meaning: \"The image has more pixels or frames than the processor decodes.\" },\n  image_too_small: { status: 422, meaning: \"The edited image is narrower than its public preset's minimum width.\" },\n  image_unreadable: { status: 422, meaning: \"The file is not a decodable image of its declared type.\" },\n  incomplete: { status: 409, meaning: \"A multipart upload is missing parts.\" },\n  internal_error: { status: 500, meaning: \"A server fault; the cause is in the server log.\" },\n  invalid_archive: { status: 422, meaning: \"The publishing archive cannot produce the required supported pages.\" },\n  invalid_request: { status: 400, meaning: \"The request is malformed: its body, a query parameter or a path value.\" },\n  limit_reached: { status: 409, meaning: \"The owner already has as many groups of the kind as the site allows (max_per_owner).\" },\n  moderation_rejected: { status: 422, meaning: \"The moderator refused the text; `error` says why.\" },\n  no_download: { status: 409, meaning: \"The version has no file its kind's download serves: nothing uploaded, or its upload failed or was dropped.\" },\n  not_configured: { status: 501, meaning: \"The capability needs a port the host did not configure; retrying does not help.\" },\n  not_found: { status: 404, meaning: \"Nothing by that name, or nothing the actor may see.\" },\n  not_joinable: { status: 409, meaning: \"The group has no free offer to join: it sells its membership, or nothing.\" },\n  not_ready: { status: 409, meaning: \"A version that would go live still has files processing or a publication not yet current; `error` says what. Retry once processing finishes.\" },\n  not_uploaded: { status: 409, meaning: \"A commit names an upload that has not landed; `blobs` lists the ones to upload again.\" },\n  operation_busy: { status: 409, meaning: \"The publishing operation is preparing an upload or completing another request; retry.\" },\n  operation_conflict: { status: 409, meaning: \"A publishing operation ID already names different immutable input.\" },\n  quota_exceeded: { status: 413, meaning: \"The uploader's storage quota is used up.\" },\n  rate_limited: { status: 429, meaning: \"Too many requests; retry after `retry_after` seconds (also the Retry-After header).\" },\n  source_conflict: { status: 409, meaning: \"The external source already belongs to another publishing operation in this app.\" },\n  tenant_mismatch: { status: 500, meaning: \"A host port answered with another tenant's data: a configuration fault.\" },\n  too_large: { status: 413, meaning: \"The file is larger than its upload path allows; `details` has `size` and `max_bytes`.\" },\n  too_many_files: { status: 409, meaning: \"The commit would put more files in an upload path, or the item, than allowed; `details.max` is the limit.\" },\n  type_not_allowed: { status: 415, meaning: \"The file type is not allowed in the upload path; `details.allowed` lists the types.\" },\n  unauthorized: { status: 401, meaning: \"The request needs a valid credential: it has none where the route needs one, or one that is expired, revoked or invalid. WWW-Authenticate says which.\" },\n  unavailable: { status: 503, meaning: \"The host's auth, media storage or signal plane cannot be reached, or a commit's recovery is pending; retry.\" },\n  unknown_entity: { status: 400, meaning: \"A publishing entity reference does not resolve in this app and entity creation is disabled.\" },\n  upgrade_required: { status: 503, meaning: \"The media item was stored before v0.68 and is served once the host's media upgrade (contentkit_media_upgrade) has converted it.\" },\n  video_aspect_unsupported: { status: 422, meaning: \"The video's display aspect is outside what its upload path accepts; `details` has `min_aspect` and `max_aspect` (width/height).\" },\n  video_over_budget: { status: 422, meaning: \"The planned encode costs more than its upload path allows, or the source averages under a frame a second.\" },\n  video_too_large: { status: 422, meaning: \"The video's frames are larger than its upload path allows.\" },\n  video_too_long: { status: 422, meaning: \"The video or audio runs longer than its upload path allows.\" },\n};\n"],"mappings":";AAqDA,IAAa,IAA2F;CACtG,kBAAkB;EAAE,QAAQ;EAAK,SAAS;CAAqF;CAC/H,uBAAuB;EAAE,QAAQ;EAAK,SAAS;CAA6D;CAC5G,oBAAoB;EAAE,QAAQ;EAAK,SAAS;CAAsE;CAClH,uBAAuB;EAAE,QAAQ;EAAK,SAAS;CAAiE;CAChH,mBAAmB;EAAE,QAAQ;EAAK,SAAS;CAAqD;CAChG,gBAAgB;EAAE,QAAQ;EAAK,SAAS;CAAyG;CACjJ,kBAAkB;EAAE,QAAQ;EAAK,SAAS;CAAwF;CAClI,iBAAiB;EAAE,QAAQ;EAAK,SAAS;CAAsG;CAC/I,iBAAiB;EAAE,QAAQ;EAAK,SAAS;CAA8H;CACvK,UAAU;EAAE,QAAQ;EAAK,SAAS;CAAyG;CAC3I,iBAAiB;EAAE,QAAQ;EAAK,SAAS;CAA2E;CACpH,sBAAsB;EAAE,QAAQ;EAAK,SAAS;CAAqJ;CACnM,WAAW;EAAE,QAAQ;EAAK,SAAS;CAA6B;CAChE,MAAM;EAAE,QAAQ;EAAK,SAAS;CAA2B;CACzD,iBAAiB;EAAE,QAAQ;EAAK,SAAS;CAAkE;CAC3G,iBAAiB;EAAE,QAAQ;EAAK,SAAS;CAAuE;CAChH,kBAAkB;EAAE,QAAQ;EAAK,SAAS;CAA0D;CACpG,YAAY;EAAE,QAAQ;EAAK,SAAS;CAAuC;CAC3E,gBAAgB;EAAE,QAAQ;EAAK,SAAS;CAAkD;CAC1F,iBAAiB;EAAE,QAAQ;EAAK,SAAS;CAAsE;CAC/G,iBAAiB;EAAE,QAAQ;EAAK,SAAS;CAAyE;CAClH,eAAe;EAAE,QAAQ;EAAK,SAAS;CAAuF;CAC9H,qBAAqB;EAAE,QAAQ;EAAK,SAAS;CAAoD;CACjG,aAAa;EAAE,QAAQ;EAAK,SAAS;CAA6G;CAClJ,gBAAgB;EAAE,QAAQ;EAAK,SAAS;CAAkF;CAC1H,WAAW;EAAE,QAAQ;EAAK,SAAS;CAAsD;CACzF,cAAc;EAAE,QAAQ;EAAK,SAAS;CAA4E;CAClH,WAAW;EAAE,QAAQ;EAAK,SAAS;CAA+I;CAClL,cAAc;EAAE,QAAQ;EAAK,SAAS;CAAwF;CAC9H,gBAAgB;EAAE,QAAQ;EAAK,SAAS;CAAwF;CAChI,oBAAoB;EAAE,QAAQ;EAAK,SAAS;CAAqE;CACjH,gBAAgB;EAAE,QAAQ;EAAK,SAAS;CAA2C;CACnF,cAAc;EAAE,QAAQ;EAAK,SAAS;CAAsF;CAC5H,iBAAiB;EAAE,QAAQ;EAAK,SAAS;CAAmF;CAC5H,iBAAiB;EAAE,QAAQ;EAAK,SAAS;CAA0E;CACnH,WAAW;EAAE,QAAQ;EAAK,SAAS;CAAwF;CAC3H,gBAAgB;EAAE,QAAQ;EAAK,SAAS;CAA4G;CACpJ,kBAAkB;EAAE,QAAQ;EAAK,SAAS;CAAsF;CAChI,cAAc;EAAE,QAAQ;EAAK,SAAS;CAAwJ;CAC9L,aAAa;EAAE,QAAQ;EAAK,SAAS;CAA8G;CACnJ,gBAAgB;EAAE,QAAQ;EAAK,SAAS;CAA8F;CACtI,kBAAkB;EAAE,QAAQ;EAAK,SAAS;CAAkI;CAC5K,0BAA0B;EAAE,QAAQ;EAAK,SAAS;CAAkI;CACpL,mBAAmB;EAAE,QAAQ;EAAK,SAAS;CAA4G;CACvJ,iBAAiB;EAAE,QAAQ;EAAK,SAAS;CAA6D;CACtG,gBAAgB;EAAE,QAAQ;EAAK,SAAS;CAA8D;AACxG"}

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

@@ -1002,7 +1002,7 @@ export declare const CONTENTKIT_ROUTES: readonly [{
         readonly 200: "Content";
         readonly 202: "Content";
     };
-    readonly errors: readonly ["conflict", "forbidden", "not_found", "moderation_rejected"];
+    readonly errors: readonly ["conflict", "forbidden", "not_found", "moderation_rejected", "not_ready"];
     readonly errorSets: readonly ["module:contents", "auth", "request"];
 }, {
     readonly method: "POST";
@@ -1107,7 +1107,7 @@ export declare const CONTENTKIT_ROUTES: readonly [{
     readonly responses: {
         readonly 200: "Version";
     };
-    readonly errors: readonly ["forbidden", "not_found"];
+    readonly errors: readonly ["forbidden", "not_found", "not_ready"];
     readonly errorSets: readonly ["module:contents", "auth", "request"];
 }, {
     readonly method: "DELETE";

package/dist/client/generated/routes.js

@@ -1409,7 +1409,8 @@ var e = {
 			"conflict",
 			"forbidden",
 			"not_found",
-			"moderation_rejected"
+			"moderation_rejected",
+			"not_ready"
 		],
 		errorSets: [
 			"module:contents",
@@ -1558,7 +1559,11 @@ var e = {
 		query: [],
 		request: "VersionInput",
 		responses: { 200: "Version" },
-		errors: ["forbidden", "not_found"],
+		errors: [
+			"forbidden",
+			"not_found",
+			"not_ready"
+		],
 		errorSets: [
 			"module:contents",
 			"auth",