@openrails/contentkit-ui 0.79.0 → 0.81.0

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

@@ -1,5 +1,35 @@
 /** Content ids are canonical lowercase UUIDv7s (contentref.ValidateID). */
 export declare const isContentId: (id: string) => boolean;
+/** An item's identity: kind, id and, for a content's version, the version. */
+export declare const itemKey: (ref: {
+    kind: string;
+    id: string;
+    version?: string;
+}) => string;
+/** An item's ref and nothing else: kind, id and its version when it names one. */
+export declare const itemRef: (ref: {
+    kind: string;
+    id: string;
+    version?: string;
+}) => {
+    kind: string;
+    id: string;
+    version: string;
+} | {
+    kind: string;
+    id: string;
+    version?: undefined;
+};
+/** Both refs name the same item (a version is its own item). */
+export declare const sameItem: (a: {
+    kind: string;
+    id: string;
+    version?: string;
+}, b: {
+    kind: string;
+    id: string;
+    version?: string;
+}) => boolean;
 /** Refuses a ref whose id ContentKit would reject, before any request. */
 export declare function checkRef(ref: {
     id: string;

package/dist/client/media/ref.js

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

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

@@ -1 +1 @@
-{"version":3,"file":"ref.js","names":[],"sources":["../../../src/client/media/ref.ts"],"sourcesContent":["import { ContentKitError } from \"../errors.js\";\n\nconst contentId = /^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;\n\n/** Content ids are canonical lowercase UUIDv7s (contentref.ValidateID). */\nexport const isContentId = (id: string) => contentId.test(id);\n\n/** Refuses a ref whose id ContentKit would reject, before any request. */\nexport function checkRef(ref: { id: string } | undefined) {\n  if (ref && !isContentId(ref.id)) throw new ContentKitError(\"invalid_request\", `content id must be a canonical UUIDv7, got \"${ref.id}\"`);\n}\n"],"mappings":";;AAEA,IAAM,IAAY,yEAGL,KAAe,MAAe,EAAU,KAAK,CAAE;AAG5D,SAAgB,EAAS,GAAiC;CACxD,IAAI,KAAO,CAAC,EAAY,EAAI,EAAE,GAAG,MAAM,IAAI,EAAgB,mBAAmB,+CAA+C,EAAI,GAAG,EAAE;AACxI"}
+{"version":3,"file":"ref.js","names":[],"sources":["../../../src/client/media/ref.ts"],"sourcesContent":["import { ContentKitError } from \"../errors.js\";\n\nconst contentId = /^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/;\n\n/** Content ids are canonical lowercase UUIDv7s (contentref.ValidateID). */\nexport const isContentId = (id: string) => contentId.test(id);\n\n/** An item's identity: kind, id and, for a content's version, the version. */\nexport const itemKey = (ref: { kind: string; id: string; version?: string }) => (ref.version ? `${ref.kind}/${ref.id}/${ref.version}` : `${ref.kind}/${ref.id}`);\n\n/** An item's ref and nothing else: kind, id and its version when it names one. */\nexport const itemRef = (ref: { kind: string; id: string; version?: string }) =>\n  ref.version ? { kind: ref.kind, id: ref.id, version: ref.version } : { kind: ref.kind, id: ref.id };\n\n/** Both refs name the same item (a version is its own item). */\nexport const sameItem = (a: { kind: string; id: string; version?: string }, b: { kind: string; id: string; version?: string }) =>\n  a.kind === b.kind && a.id === b.id && (a.version ?? \"\") === (b.version ?? \"\");\n\n/** Refuses a ref whose id ContentKit would reject, before any request. */\nexport function checkRef(ref: { id: string } | undefined) {\n  if (ref && !isContentId(ref.id)) throw new ContentKitError(\"invalid_request\", `content id must be a canonical UUIDv7, got \"${ref.id}\"`);\n}\n"],"mappings":";;AAEA,IAAM,IAAY,yEAGL,KAAe,MAAe,EAAU,KAAK,CAAE,GAG/C,KAAW,MAAyD,EAAI,UAAU,GAAG,EAAI,KAAK,GAAG,EAAI,GAAG,GAAG,EAAI,YAAY,GAAG,EAAI,KAAK,GAAG,EAAI,MAG9I,KAAW,MACtB,EAAI,UAAU;CAAE,MAAM,EAAI;CAAM,IAAI,EAAI;CAAI,SAAS,EAAI;AAAQ,IAAI;CAAE,MAAM,EAAI;CAAM,IAAI,EAAI;AAAG,GAGvF,KAAY,GAAmD,MAC1E,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,SAAS,EAAE,WAAW;AAG5E,SAAgB,EAAS,GAAiC;CACxD,IAAI,KAAO,CAAC,EAAY,EAAI,EAAE,GAAG,MAAM,IAAI,EAAgB,mBAAmB,+CAA+C,EAAI,GAAG,EAAE;AACxI"}

package/dist/client/offers.d.ts

@@ -0,0 +1,41 @@
+import { GroupJoin, LibraryPage, Offer, OfferPage, Terms } from './generated/wire.js';
+import { Http } from './http.js';
+/**
+ * Offers: content, versions and groups put on sale (their creators, owner
+ * group editors and root:offers:write holders), free group joins and the
+ * reader's library.
+ */
+export declare class OffersClient {
+    private readonly http;
+    constructor(http: Http);
+    /** Puts a content (or one version) on sale, or reprices it: a new price, the old one archived. */
+    sell(target: {
+        content: string;
+        version?: string;
+    }, terms: Terms): Promise<Offer>;
+    /** Takes it off sale; buyers keep what they bought. */
+    withdraw(target: {
+        content: string;
+        version?: string;
+    }): Promise<Offer>;
+    /** Sells a group: its key opens every member. */
+    sellGroup(id: string, terms: Terms): Promise<Offer>;
+    withdrawGroup(id: string): Promise<Offer>;
+    /** Joins a free group (or leaves it): its key granted to the caller. */
+    join(id: string, member?: boolean): Promise<GroupJoin>;
+    /** What the reader bought, a cursor page at a time. */
+    library(q?: {
+        language?: string;
+        cursor?: string;
+        limit?: number;
+    }, signal?: AbortSignal): Promise<LibraryPage>;
+    /** Staff: every offer, by state or not yet synced to billing. */
+    list(q?: {
+        state?: "active" | "withdrawn";
+        unsynced?: boolean;
+        cursor?: string;
+        limit?: number;
+    }, signal?: AbortSignal): Promise<OfferPage>;
+    private write;
+    private writeGroup;
+}

package/dist/client/offers.js

@@ -0,0 +1,66 @@
+import { call as e } from "./route.js";
+//#region src/client/offers.ts
+var t = class {
+	http;
+	constructor(e) {
+		this.http = e;
+	}
+	sell(t, n) {
+		return this.write(t.content, t.version ? e(this.http, "PUT", "/contents/{id}/versions/{vid}/offer", {
+			params: {
+				id: t.content,
+				vid: t.version
+			},
+			body: n
+		}) : e(this.http, "PUT", "/contents/{id}/offer", {
+			params: { id: t.content },
+			body: n
+		}));
+	}
+	withdraw(t) {
+		return this.write(t.content, t.version ? e(this.http, "DELETE", "/contents/{id}/versions/{vid}/offer", { params: {
+			id: t.content,
+			vid: t.version
+		} }) : e(this.http, "DELETE", "/contents/{id}/offer", { params: { id: t.content } }));
+	}
+	sellGroup(t, n) {
+		return this.writeGroup(e(this.http, "PUT", "/groups/{id}/offer", {
+			params: { id: t },
+			body: n
+		}));
+	}
+	withdrawGroup(t) {
+		return this.writeGroup(e(this.http, "DELETE", "/groups/{id}/offer", { params: { id: t } }));
+	}
+	async join(t, n = !0) {
+		let r = this.http.captureChanges(), i = await e(this.http, n ? "POST" : "DELETE", "/groups/{id}/join", { params: { id: t } });
+		return r({ type: "access.changed" }), i;
+	}
+	library(t = {}, n) {
+		return e(this.http, "GET", "/me/library", {
+			query: t,
+			signal: n
+		});
+	}
+	list(t = {}, n) {
+		return e(this.http, "GET", "/offers", {
+			query: t,
+			signal: n
+		});
+	}
+	async write(e, t) {
+		let n = this.http.captureChanges(), r = await t;
+		return n({
+			type: "content.changed",
+			id: e
+		}), r;
+	}
+	async writeGroup(e) {
+		let t = this.http.captureChanges(), n = await e;
+		return t({ type: "groups.changed" }), n;
+	}
+};
+//#endregion
+export { t as OffersClient };
+
+//# sourceMappingURL=offers.js.map

package/dist/client/offers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"offers.js","names":[],"sources":["../../src/client/offers.ts"],"sourcesContent":["import type { GroupJoin, LibraryPage, Offer, OfferPage, Terms } from \"./generated/wire.js\";\nimport type { Http } from \"./http.js\";\nimport { call } from \"./route.js\";\n\n/**\n * Offers: content, versions and groups put on sale (their creators, owner\n * group editors and root:offers:write holders), free group joins and the\n * reader's library.\n */\nexport class OffersClient {\n  constructor(private readonly http: Http) {}\n\n  /** Puts a content (or one version) on sale, or reprices it: a new price, the old one archived. */\n  sell(target: { content: string; version?: string }, terms: Terms): Promise<Offer> {\n    return this.write(\n      target.content,\n      target.version\n        ? call(this.http, \"PUT\", \"/contents/{id}/versions/{vid}/offer\", { params: { id: target.content, vid: target.version }, body: terms })\n        : call(this.http, \"PUT\", \"/contents/{id}/offer\", { params: { id: target.content }, body: terms }),\n    );\n  }\n  /** Takes it off sale; buyers keep what they bought. */\n  withdraw(target: { content: string; version?: string }): Promise<Offer> {\n    return this.write(\n      target.content,\n      target.version\n        ? call(this.http, \"DELETE\", \"/contents/{id}/versions/{vid}/offer\", { params: { id: target.content, vid: target.version } })\n        : call(this.http, \"DELETE\", \"/contents/{id}/offer\", { params: { id: target.content } }),\n    );\n  }\n  /** Sells a group: its key opens every member. */\n  sellGroup(id: string, terms: Terms): Promise<Offer> {\n    return this.writeGroup(call(this.http, \"PUT\", \"/groups/{id}/offer\", { params: { id }, body: terms }));\n  }\n  withdrawGroup(id: string): Promise<Offer> {\n    return this.writeGroup(call(this.http, \"DELETE\", \"/groups/{id}/offer\", { params: { id } }));\n  }\n  /** Joins a free group (or leaves it): its key granted to the caller. */\n  async join(id: string, member = true): Promise<GroupJoin> {\n    const emit = this.http.captureChanges();\n    const out: GroupJoin = await call(this.http, member ? \"POST\" : \"DELETE\", \"/groups/{id}/join\", { params: { id } });\n    emit({ type: \"access.changed\" });\n    return out;\n  }\n  /** What the reader bought, a cursor page at a time. */\n  library(q: { language?: string; cursor?: string; limit?: number } = {}, signal?: AbortSignal): Promise<LibraryPage> {\n    return call(this.http, \"GET\", \"/me/library\", { query: q, signal });\n  }\n  /** Staff: every offer, by state or not yet synced to billing. */\n  list(q: { state?: \"active\" | \"withdrawn\"; unsynced?: boolean; cursor?: string; limit?: number } = {}, signal?: AbortSignal): Promise<OfferPage> {\n    return call(this.http, \"GET\", \"/offers\", { query: q, signal });\n  }\n\n  private async write(content: string, p: Promise<Offer>): Promise<Offer> {\n    const emit = this.http.captureChanges();\n    const out = await p;\n    emit({ type: \"content.changed\", id: content });\n    return out;\n  }\n\n  private async writeGroup(p: Promise<Offer>): Promise<Offer> {\n    const emit = this.http.captureChanges();\n    const out = await p;\n    emit({ type: \"groups.changed\" });\n    return out;\n  }\n}\n"],"mappings":";;AASA,IAAa,IAAb,MAA0B;CACK;CAA7B,YAAY,GAA6B;EAAZ,KAAA,OAAA;CAAa;CAG1C,KAAK,GAA+C,GAA8B;EAChF,OAAO,KAAK,MACV,EAAO,SACP,EAAO,UACH,EAAK,KAAK,MAAM,OAAO,uCAAuC;GAAE,QAAQ;IAAE,IAAI,EAAO;IAAS,KAAK,EAAO;GAAQ;GAAG,MAAM;EAAM,CAAC,IAClI,EAAK,KAAK,MAAM,OAAO,wBAAwB;GAAE,QAAQ,EAAE,IAAI,EAAO,QAAQ;GAAG,MAAM;EAAM,CAAC,CACpG;CACF;CAEA,SAAS,GAA+D;EACtE,OAAO,KAAK,MACV,EAAO,SACP,EAAO,UACH,EAAK,KAAK,MAAM,UAAU,uCAAuC,EAAE,QAAQ;GAAE,IAAI,EAAO;GAAS,KAAK,EAAO;EAAQ,EAAE,CAAC,IACxH,EAAK,KAAK,MAAM,UAAU,wBAAwB,EAAE,QAAQ,EAAE,IAAI,EAAO,QAAQ,EAAE,CAAC,CAC1F;CACF;CAEA,UAAU,GAAY,GAA8B;EAClD,OAAO,KAAK,WAAW,EAAK,KAAK,MAAM,OAAO,sBAAsB;GAAE,QAAQ,EAAE,MAAG;GAAG,MAAM;EAAM,CAAC,CAAC;CACtG;CACA,cAAc,GAA4B;EACxC,OAAO,KAAK,WAAW,EAAK,KAAK,MAAM,UAAU,sBAAsB,EAAE,QAAQ,EAAE,MAAG,EAAE,CAAC,CAAC;CAC5F;CAEA,MAAM,KAAK,GAAY,IAAS,IAA0B;EACxD,IAAM,IAAO,KAAK,KAAK,eAAe,GAChC,IAAiB,MAAM,EAAK,KAAK,MAAM,IAAS,SAAS,UAAU,qBAAqB,EAAE,QAAQ,EAAE,MAAG,EAAE,CAAC;EAEhH,OADA,EAAK,EAAE,MAAM,iBAAiB,CAAC,GACxB;CACT;CAEA,QAAQ,IAA4D,CAAC,GAAG,GAA4C;EAClH,OAAO,EAAK,KAAK,MAAM,OAAO,eAAe;GAAE,OAAO;GAAG;EAAO,CAAC;CACnE;CAEA,KAAK,IAA6F,CAAC,GAAG,GAA0C;EAC9I,OAAO,EAAK,KAAK,MAAM,OAAO,WAAW;GAAE,OAAO;GAAG;EAAO,CAAC;CAC/D;CAEA,MAAc,MAAM,GAAiB,GAAmC;EACtE,IAAM,IAAO,KAAK,KAAK,eAAe,GAChC,IAAM,MAAM;EAElB,OADA,EAAK;GAAE,MAAM;GAAmB,IAAI;EAAQ,CAAC,GACtC;CACT;CAEA,MAAc,WAAW,GAAmC;EAC1D,IAAM,IAAO,KAAK,KAAK,eAAe,GAChC,IAAM,MAAM;EAElB,OADA,EAAK,EAAE,MAAM,iBAAiB,CAAC,GACxB;CACT;AACF"}

package/dist/client/route.d.ts

@@ -23,6 +23,8 @@ export interface CallOptions<M extends Method, P extends string> {
     query?: RouteQuery<M, P>;
     body?: unknown;
     signal?: AbortSignal;
+    /** Outlives the page (a beacon sent as it closes). */
+    keepalive?: boolean;
 }
 /** The URL of a catalog route: its module's mount, the path with params filled, then the query. */
 export declare function routeURL<M extends Method, P extends RoutePath<M>>(http: Http, method: M, path: P, o?: Pick<CallOptions<M, P>, "params" | "query">): string;

package/dist/client/route.js

@@ -9,7 +9,8 @@ function r(e, t, n, r = {}) {
 	return e.request(a, {
 		method: t,
 		body: r.body,
-		signal: r.signal
+		signal: r.signal,
+		keepalive: r.keepalive
 	});
 }
 function i(e, n, r, i = {}, a = {}) {

package/dist/client/route.js.map

@@ -1 +1 @@
-{"version":3,"file":"route.js","names":[],"sources":["../../src/client/route.ts"],"sourcesContent":["import { CONTENTKIT_ROUTES } from \"./generated/routes.js\";\nimport type { Http } from \"./http.js\";\n\ntype AnyRoute = (typeof CONTENTKIT_ROUTES)[number];\nexport type Method = AnyRoute[\"method\"];\n/** A route path the catalog declares for the method. */\nexport type RoutePath<M extends Method> = Extract<AnyRoute, { method: M }>[\"path\"];\ntype RouteOf<M extends Method, P extends string> = Extract<AnyRoute, { method: M; path: P }>;\n\ntype ParamNames<P extends string> = P extends `${string}{${infer K}}${infer R}` ? (K extends `${infer N}...` ? N : K) | ParamNames<R> : never;\n/** The path's {wildcards}, each a string value. */\nexport type PathParams<P extends string> = { [K in ParamNames<P>]: string };\n/** The query parameters the route declares. */\nexport type RouteQuery<M extends Method, P extends string> = Partial<Record<RouteOf<M, P>[\"query\"][number], QueryValue>>;\ntype QueryValue = string | number | boolean | null | undefined | readonly string[];\n\nexport interface CallOptions<M extends Method, P extends string> {\n  params?: PathParams<P>;\n  query?: RouteQuery<M, P>;\n  body?: unknown;\n  signal?: AbortSignal;\n}\n\nconst index = new Map<string, AnyRoute>(CONTENTKIT_ROUTES.map((r) => [`${r.method} ${r.path}`, r]));\n\n/** The URL of a catalog route: its module's mount, the path with params filled, then the query. */\nexport function routeURL<M extends Method, P extends RoutePath<M>>(http: Http, method: M, path: P, o: Pick<CallOptions<M, P>, \"params\" | \"query\"> = {}): string {\n  return build(http, method, path, o.params as Record<string, string> | undefined, o.query as Record<string, QueryValue> | undefined);\n}\n\n/**\n * Calls a catalog route and resolves with its JSON body (undefined for 204);\n * the caller's declared type names it.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function call<M extends Method, P extends RoutePath<M>, T = any>(http: Http, method: M, path: P, o: CallOptions<M, P> = {}): Promise<T> {\n  const url = build(http, method, path, o.params as Record<string, string> | undefined, o.query as Record<string, QueryValue> | undefined);\n  return http.request<T>(url, { method, body: o.body, signal: o.signal });\n}\n\nfunction build(http: Http, method: string, path: string, params: Record<string, string> = {}, query: Record<string, QueryValue> = {}): string {\n  const r = index.get(`${method} ${path}`);\n  if (!r) throw new Error(`contentkit: no route ${method} ${path}`);\n  const filled = path.replace(/\\{(\\w+)(\\.\\.\\.)?\\}/g, (_, name: string, rest?: string) => {\n    const v = params[name];\n    if (v === undefined || v === \"\") throw new Error(`contentkit: ${method} ${path} needs ${name}`);\n    return rest ? v.split(\"/\").map(encodeURIComponent).join(\"/\") : encodeURIComponent(v);\n  });\n  const q = new URLSearchParams();\n  for (const [k, v] of Object.entries(query)) {\n    if (Array.isArray(v)) for (const x of v) q.append(k, x);\n    else if (v !== undefined && v !== null && v !== \"\") q.set(k, String(v));\n  }\n  const s = q.toString();\n  return http.mount(r.module) + filled + (s ? `?${s}` : \"\");\n}\n\n/** A page of a limit/offset list. */\nexport interface PageQuery {\n  limit?: number;\n  offset?: number;\n}\n"],"mappings":";;AAuBA,IAAM,IAAQ,IAAI,IAAsB,EAAkB,KAAK,MAAM,CAAC,GAAG,EAAE,OAAO,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC;AAGlG,SAAgB,EAAmD,GAAY,GAAW,GAAS,IAAiD,CAAC,GAAW;CAC9J,OAAO,EAAM,GAAM,GAAQ,GAAM,EAAE,QAA8C,EAAE,KAA+C;AACpI;AAOA,SAAgB,EAAwD,GAAY,GAAW,GAAS,IAAuB,CAAC,GAAe;CAC7I,IAAM,IAAM,EAAM,GAAM,GAAQ,GAAM,EAAE,QAA8C,EAAE,KAA+C;CACvI,OAAO,EAAK,QAAW,GAAK;EAAE;EAAQ,MAAM,EAAE;EAAM,QAAQ,EAAE;CAAO,CAAC;AACxE;AAEA,SAAS,EAAM,GAAY,GAAgB,GAAc,IAAiC,CAAC,GAAG,IAAoC,CAAC,GAAW;CAC5I,IAAM,IAAI,EAAM,IAAI,GAAG,EAAO,GAAG,GAAM;CACvC,IAAI,CAAC,GAAG,MAAU,MAAM,wBAAwB,EAAO,GAAG,GAAM;CAChE,IAAM,IAAS,EAAK,QAAQ,wBAAwB,GAAG,GAAc,MAAkB;EACrF,IAAM,IAAI,EAAO;EACjB,IAAI,MAAM,KAAA,KAAa,MAAM,IAAI,MAAU,MAAM,eAAe,EAAO,GAAG,EAAK,SAAS,GAAM;EAC9F,OAAO,IAAO,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,kBAAkB,CAAC,CAAC,KAAK,GAAG,IAAI,mBAAmB,CAAC;CACrF,CAAC,GACK,IAAI,IAAI,gBAAgB;CAC9B,KAAK,IAAM,CAAC,GAAG,MAAM,OAAO,QAAQ,CAAK,GACvC,IAAI,MAAM,QAAQ,CAAC,GAAG,KAAK,IAAM,KAAK,GAAG,EAAE,OAAO,GAAG,CAAC;MACjD,AAAI,KAAyB,QAAQ,MAAM,MAAI,EAAE,IAAI,GAAG,OAAO,CAAC,CAAC;CAExE,IAAM,IAAI,EAAE,SAAS;CACrB,OAAO,EAAK,MAAM,EAAE,MAAM,IAAI,KAAU,IAAI,IAAI,MAAM;AACxD"}
+{"version":3,"file":"route.js","names":[],"sources":["../../src/client/route.ts"],"sourcesContent":["import { CONTENTKIT_ROUTES } from \"./generated/routes.js\";\nimport type { Http } from \"./http.js\";\n\ntype AnyRoute = (typeof CONTENTKIT_ROUTES)[number];\nexport type Method = AnyRoute[\"method\"];\n/** A route path the catalog declares for the method. */\nexport type RoutePath<M extends Method> = Extract<AnyRoute, { method: M }>[\"path\"];\ntype RouteOf<M extends Method, P extends string> = Extract<AnyRoute, { method: M; path: P }>;\n\ntype ParamNames<P extends string> = P extends `${string}{${infer K}}${infer R}` ? (K extends `${infer N}...` ? N : K) | ParamNames<R> : never;\n/** The path's {wildcards}, each a string value. */\nexport type PathParams<P extends string> = { [K in ParamNames<P>]: string };\n/** The query parameters the route declares. */\nexport type RouteQuery<M extends Method, P extends string> = Partial<Record<RouteOf<M, P>[\"query\"][number], QueryValue>>;\ntype QueryValue = string | number | boolean | null | undefined | readonly string[];\n\nexport interface CallOptions<M extends Method, P extends string> {\n  params?: PathParams<P>;\n  query?: RouteQuery<M, P>;\n  body?: unknown;\n  signal?: AbortSignal;\n  /** Outlives the page (a beacon sent as it closes). */\n  keepalive?: boolean;\n}\n\nconst index = new Map<string, AnyRoute>(CONTENTKIT_ROUTES.map((r) => [`${r.method} ${r.path}`, r]));\n\n/** The URL of a catalog route: its module's mount, the path with params filled, then the query. */\nexport function routeURL<M extends Method, P extends RoutePath<M>>(http: Http, method: M, path: P, o: Pick<CallOptions<M, P>, \"params\" | \"query\"> = {}): string {\n  return build(http, method, path, o.params as Record<string, string> | undefined, o.query as Record<string, QueryValue> | undefined);\n}\n\n/**\n * Calls a catalog route and resolves with its JSON body (undefined for 204);\n * the caller's declared type names it.\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function call<M extends Method, P extends RoutePath<M>, T = any>(http: Http, method: M, path: P, o: CallOptions<M, P> = {}): Promise<T> {\n  const url = build(http, method, path, o.params as Record<string, string> | undefined, o.query as Record<string, QueryValue> | undefined);\n  return http.request<T>(url, { method, body: o.body, signal: o.signal, keepalive: o.keepalive });\n}\n\nfunction build(http: Http, method: string, path: string, params: Record<string, string> = {}, query: Record<string, QueryValue> = {}): string {\n  const r = index.get(`${method} ${path}`);\n  if (!r) throw new Error(`contentkit: no route ${method} ${path}`);\n  const filled = path.replace(/\\{(\\w+)(\\.\\.\\.)?\\}/g, (_, name: string, rest?: string) => {\n    const v = params[name];\n    if (v === undefined || v === \"\") throw new Error(`contentkit: ${method} ${path} needs ${name}`);\n    return rest ? v.split(\"/\").map(encodeURIComponent).join(\"/\") : encodeURIComponent(v);\n  });\n  const q = new URLSearchParams();\n  for (const [k, v] of Object.entries(query)) {\n    if (Array.isArray(v)) for (const x of v) q.append(k, x);\n    else if (v !== undefined && v !== null && v !== \"\") q.set(k, String(v));\n  }\n  const s = q.toString();\n  return http.mount(r.module) + filled + (s ? `?${s}` : \"\");\n}\n\n/** A page of a limit/offset list. */\nexport interface PageQuery {\n  limit?: number;\n  offset?: number;\n}\n"],"mappings":";;AAyBA,IAAM,IAAQ,IAAI,IAAsB,EAAkB,KAAK,MAAM,CAAC,GAAG,EAAE,OAAO,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC;AAGlG,SAAgB,EAAmD,GAAY,GAAW,GAAS,IAAiD,CAAC,GAAW;CAC9J,OAAO,EAAM,GAAM,GAAQ,GAAM,EAAE,QAA8C,EAAE,KAA+C;AACpI;AAOA,SAAgB,EAAwD,GAAY,GAAW,GAAS,IAAuB,CAAC,GAAe;CAC7I,IAAM,IAAM,EAAM,GAAM,GAAQ,GAAM,EAAE,QAA8C,EAAE,KAA+C;CACvI,OAAO,EAAK,QAAW,GAAK;EAAE;EAAQ,MAAM,EAAE;EAAM,QAAQ,EAAE;EAAQ,WAAW,EAAE;CAAU,CAAC;AAChG;AAEA,SAAS,EAAM,GAAY,GAAgB,GAAc,IAAiC,CAAC,GAAG,IAAoC,CAAC,GAAW;CAC5I,IAAM,IAAI,EAAM,IAAI,GAAG,EAAO,GAAG,GAAM;CACvC,IAAI,CAAC,GAAG,MAAU,MAAM,wBAAwB,EAAO,GAAG,GAAM;CAChE,IAAM,IAAS,EAAK,QAAQ,wBAAwB,GAAG,GAAc,MAAkB;EACrF,IAAM,IAAI,EAAO;EACjB,IAAI,MAAM,KAAA,KAAa,MAAM,IAAI,MAAU,MAAM,eAAe,EAAO,GAAG,EAAK,SAAS,GAAM;EAC9F,OAAO,IAAO,EAAE,MAAM,GAAG,CAAC,CAAC,IAAI,kBAAkB,CAAC,CAAC,KAAK,GAAG,IAAI,mBAAmB,CAAC;CACrF,CAAC,GACK,IAAI,IAAI,gBAAgB;CAC9B,KAAK,IAAM,CAAC,GAAG,MAAM,OAAO,QAAQ,CAAK,GACvC,IAAI,MAAM,QAAQ,CAAC,GAAG,KAAK,IAAM,KAAK,GAAG,EAAE,OAAO,GAAG,CAAC;MACjD,AAAI,KAAyB,QAAQ,MAAM,MAAI,EAAE,IAAI,GAAG,OAAO,CAAC,CAAC;CAExE,IAAM,IAAI,EAAE,SAAS;CACrB,OAAO,EAAK,MAAM,EAAE,MAAM,IAAI,KAAU,IAAI,IAAI,MAAM;AACxD"}

package/dist/client/versions.d.ts

@@ -0,0 +1,20 @@
+import { ForkBody, Pending, ReaderMeta, ReaderPlan } from './generated/wire.js';
+import { Http } from './http.js';
+/** A version's answer while it is prepared (202). */
+export declare const isPending: (x: unknown) => x is Pending;
+/** Content versions: reader plans, reader metadata, forks and downloads. */
+export declare class VersionsClient {
+    private readonly http;
+    constructor(http: Http);
+    /** The version's reader plan for this viewer; Pending while it has no current publication. */
+    reader(content: string, version: string, signal?: AbortSignal): Promise<ReaderPlan | Pending>;
+    /** Editors: the version's anchors and audio cues. */
+    setReader(content: string, version: string, meta: ReaderMeta): Promise<void>;
+    /** Editors: fills a version without media from a sibling, in a durable job. */
+    fork(content: string, version: string, body: ForkBody): Promise<Pending>;
+    /**
+     * The version's pages as a zip, charged to the viewer's download quota;
+     * Pending while it is prepared (ask again).
+     */
+    download(content: string, version: string, signal?: AbortSignal): Promise<Blob | Pending>;
+}

package/dist/client/versions.js

@@ -0,0 +1,53 @@
+import { ContentKitError as e } from "./errors.js";
+import { call as t, routeURL as n } from "./route.js";
+//#region src/client/versions.ts
+var r = (e) => !!e && typeof e == "object" && "status" in e && !("pages" in e), i = class {
+	http;
+	constructor(e) {
+		this.http = e;
+	}
+	reader(e, n, r) {
+		return t(this.http, "GET", "/contents/{id}/versions/{version}/reader", {
+			params: {
+				id: e,
+				version: n
+			},
+			signal: r
+		});
+	}
+	setReader(e, n, r) {
+		return t(this.http, "PUT", "/contents/{id}/versions/{version}/reader", {
+			params: {
+				id: e,
+				version: n
+			},
+			body: r
+		});
+	}
+	fork(e, n, r) {
+		return t(this.http, "POST", "/contents/{id}/versions/{version}/fork", {
+			params: {
+				id: e,
+				version: n
+			},
+			body: r
+		});
+	}
+	async download(t, i, a) {
+		let o = n(this.http, "GET", "/contents/{id}/versions/{version}/download", { params: {
+			id: t,
+			version: i
+		} }), s = await this.http.request(o, {
+			signal: a,
+			blob: !0
+		});
+		if (!s.type.startsWith("application/json")) return s;
+		let c = JSON.parse(await s.text());
+		if (r(c)) return c;
+		throw new e("internal_error", "unexpected download answer");
+	}
+};
+//#endregion
+export { i as VersionsClient, r as isPending };
+
+//# sourceMappingURL=versions.js.map

package/dist/client/versions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"versions.js","names":[],"sources":["../../src/client/versions.ts"],"sourcesContent":["import { ContentKitError } from \"./errors.js\";\nimport type { ForkBody, Pending, ReaderMeta, ReaderPlan } from \"./generated/wire.js\";\nimport type { Http } from \"./http.js\";\nimport { call, routeURL } from \"./route.js\";\n\n/** A version's answer while it is prepared (202). */\nexport const isPending = (x: unknown): x is Pending => !!x && typeof x === \"object\" && \"status\" in x && !(\"pages\" in x);\n\n/** Content versions: reader plans, reader metadata, forks and downloads. */\nexport class VersionsClient {\n  constructor(private readonly http: Http) {}\n\n  /** The version's reader plan for this viewer; Pending while it has no current publication. */\n  reader(content: string, version: string, signal?: AbortSignal): Promise<ReaderPlan | Pending> {\n    return call(this.http, \"GET\", \"/contents/{id}/versions/{version}/reader\", { params: { id: content, version }, signal });\n  }\n  /** Editors: the version's anchors and audio cues. */\n  setReader(content: string, version: string, meta: ReaderMeta): Promise<void> {\n    return call(this.http, \"PUT\", \"/contents/{id}/versions/{version}/reader\", { params: { id: content, version }, body: meta });\n  }\n  /** Editors: fills a version without media from a sibling, in a durable job. */\n  fork(content: string, version: string, body: ForkBody): Promise<Pending> {\n    return call(this.http, \"POST\", \"/contents/{id}/versions/{version}/fork\", { params: { id: content, version }, body });\n  }\n  /**\n   * The version's pages as a zip, charged to the viewer's download quota;\n   * Pending while it is prepared (ask again).\n   */\n  async download(content: string, version: string, signal?: AbortSignal): Promise<Blob | Pending> {\n    const url = routeURL(this.http, \"GET\", \"/contents/{id}/versions/{version}/download\", { params: { id: content, version } });\n    const out = await this.http.request<Blob>(url, { signal, blob: true });\n    if (!out.type.startsWith(\"application/json\")) return out;\n    const body: unknown = JSON.parse(await out.text());\n    if (isPending(body)) return body;\n    throw new ContentKitError(\"internal_error\", \"unexpected download answer\");\n  }\n}\n"],"mappings":";;;AAMA,IAAa,KAAa,MAA6B,CAAC,CAAC,KAAK,OAAO,KAAM,YAAY,YAAY,KAAK,EAAE,WAAW,IAGxG,IAAb,MAA4B;CACG;CAA7B,YAAY,GAA6B;EAAZ,KAAA,OAAA;CAAa;CAG1C,OAAO,GAAiB,GAAiB,GAAqD;EAC5F,OAAO,EAAK,KAAK,MAAM,OAAO,4CAA4C;GAAE,QAAQ;IAAE,IAAI;IAAS;GAAQ;GAAG;EAAO,CAAC;CACxH;CAEA,UAAU,GAAiB,GAAiB,GAAiC;EAC3E,OAAO,EAAK,KAAK,MAAM,OAAO,4CAA4C;GAAE,QAAQ;IAAE,IAAI;IAAS;GAAQ;GAAG,MAAM;EAAK,CAAC;CAC5H;CAEA,KAAK,GAAiB,GAAiB,GAAkC;EACvE,OAAO,EAAK,KAAK,MAAM,QAAQ,0CAA0C;GAAE,QAAQ;IAAE,IAAI;IAAS;GAAQ;GAAG;EAAK,CAAC;CACrH;CAKA,MAAM,SAAS,GAAiB,GAAiB,GAA+C;EAC9F,IAAM,IAAM,EAAS,KAAK,MAAM,OAAO,8CAA8C,EAAE,QAAQ;GAAE,IAAI;GAAS;EAAQ,EAAE,CAAC,GACnH,IAAM,MAAM,KAAK,KAAK,QAAc,GAAK;GAAE;GAAQ,MAAM;EAAK,CAAC;EACrE,IAAI,CAAC,EAAI,KAAK,WAAW,kBAAkB,GAAG,OAAO;EACrD,IAAM,IAAgB,KAAK,MAAM,MAAM,EAAI,KAAK,CAAC;EACjD,IAAI,EAAU,CAAI,GAAG,OAAO;EAC5B,MAAM,IAAI,EAAgB,kBAAkB,4BAA4B;CAC1E;AACF"}

package/dist/client.js

@@ -3,33 +3,38 @@ import { CLIENT_ERROR_CODES as i, ContentKitError as a, ERROR_CODES as o, failur
 import { fill as d, publicRenditions as f, publicURL as p, srcSet as m } from "./client/public.js";
 import { aspectOf as h, ratio as g } from "./client/aspect.js";
 import { call as _, routeURL as v } from "./client/route.js";
-import { checkRef as y, isContentId as b } from "./client/media/ref.js";
-import { MediaApi as x } from "./client/media/api.js";
-import { MAX_PART_SIZE as S, MAX_SINGLE_PUT as C, MIN_PART_SIZE as w } from "./client/generated/wire.js";
-import { sha256Hex as T } from "./client/media/hash.js";
-import { Pacer as E } from "./client/media/pacer.js";
-import { defaultTransport as D, fetchTransport as O, xhrTransport as k } from "./client/media/transport.js";
-import { MediaClient as A, backoff as j, samePath as M, stem as N } from "./client/media/client.js";
-import { acceptOf as P, defaultImage as F, filesFor as I, isPattern as L, ratioLabel as R, ruleDir as z, ruleFor as B, screenFiles as V, uniqueName as H, uploadRules as U, withMediaType as W } from "./client/media/rules.js";
-import { centeredCrop as G, constrainCrop as K, editOf as q, editedSize as J, fromRotated as Y, rotation as X, sameEdit as Z, toOriginal as Q, toRotated as $ } from "./client/crop.js";
-import { encodeRemaining as ee } from "./client/media/encode.js";
-import { ItemUploadQueue as te } from "./client/media/queue.js";
-import { decodeImage as ne, isAnimatedImage as re } from "./client/image.js";
-import { READ_CHUNK as ie, chunkOffsets as ae, isProcessing as oe, mergeReads as se, processing as ce } from "./client/media/windows.js";
-import { ABR_DEFAULTS as le, NETWORK_FAILURES_BEFORE_ERROR as ue, REFRESH_BEFORE_EXPIRY as de, abrHlsConfig as fe, capRung as pe, classifyHlsError as me, classifyMediaError as he, expiryDelay as ge, hlsConfig as _e, initialEstimate as ve, refreshable as ye, startRung as be, statusKind as xe } from "./client/playback.js";
-import { formatDuration as Se, galleryItems as Ce, isAudioType as we, isImageType as Te, isSubtitleType as Ee, isVideoType as De, stageAspect as Oe } from "./client/gallery.js";
-import { PLAYBACK_SPEEDS as ke, PLAYER_TRACKS_KEY as Ae, PLAYER_VOLUME_KEY as je, parseSpriteVtt as Me, playerKeyAction as Ne, resumeAt as Pe } from "./client/player.js";
-import { CatalogClient as Fe } from "./client/catalog.js";
-import { CodesClient as Ie } from "./client/codes.js";
-import { BansClient as Le } from "./client/content/bans.js";
-import { reactionVerb as Re } from "./client/content/types.js";
-import { CommentsClient as ze } from "./client/content/comments.js";
-import { FavoritesClient as Be } from "./client/content/favorites.js";
-import { ModerationClient as Ve } from "./client/content/moderation.js";
-import { PollsClient as He } from "./client/content/polls.js";
-import { IMAGE_SCHEME as Ue, PostsClient as We, imageRef as Ge, imageRefs as Ke } from "./client/content/posts.js";
-import { ReactionsClient as qe } from "./client/content/reactions.js";
-import { NotificationsClient as Je } from "./client/notifications.js";
-import { TaxonomyClient as Ye } from "./client/taxonomy.js";
-import { createContentKitClient as Xe } from "./client/client.js";
-export { le as ABR_DEFAULTS, Le as BansClient, i as CLIENT_ERROR_CODES, Fe as CatalogClient, Ie as CodesClient, ze as CommentsClient, a as ContentKitError, e as DEFAULT_DENSITY, o as ERROR_CODES, Be as FavoritesClient, Ue as IMAGE_SCHEME, te as ItemUploadQueue, S as MAX_PART_SIZE, C as MAX_SINGLE_PUT, w as MIN_PART_SIZE, x as MediaApi, A as MediaClient, Ve as ModerationClient, ue as NETWORK_FAILURES_BEFORE_ERROR, Je as NotificationsClient, ke as PLAYBACK_SPEEDS, Ae as PLAYER_TRACKS_KEY, je as PLAYER_VOLUME_KEY, E as Pacer, He as PollsClient, We as PostsClient, ie as READ_CHUNK, de as REFRESH_BEFORE_EXPIRY, qe as ReactionsClient, Ye as TaxonomyClient, fe as abrHlsConfig, P as acceptOf, h as aspectOf, j as backoff, _ as call, pe as capRung, G as centeredCrop, y as checkRef, ae as chunkOffsets, me as classifyHlsError, he as classifyMediaError, K as constrainCrop, Xe as createContentKitClient, ne as decodeImage, F as defaultImage, D as defaultTransport, t as densityFor, q as editOf, J as editedSize, ee as encodeRemaining, ge as expiryDelay, s as failureError, O as fetchTransport, I as filesFor, d as fill, Se as formatDuration, Y as fromRotated, Ce as galleryItems, _e as hlsConfig, Ge as imageRef, Ke as imageRefs, ve as initialEstimate, re as isAnimatedImage, we as isAudioType, b as isContentId, c as isContentKitError, Te as isImageType, L as isPattern, oe as isProcessing, Ee as isSubtitleType, De as isVideoType, se as mergeReads, Me as parseSpriteVtt, n as pickRendition, Ne as playerKeyAction, ce as processing, f as publicRenditions, p as publicURL, g as ratio, R as ratioLabel, Re as reactionVerb, l as readContentKitError, ye as refreshable, Pe as resumeAt, X as rotation, v as routeURL, z as ruleDir, B as ruleFor, Z as sameEdit, M as samePath, V as screenFiles, T as sha256Hex, r as sortRenditions, m as srcSet, Oe as stageAspect, be as startRung, xe as statusKind, N as stem, u as toContentKitError, Q as toOriginal, $ as toRotated, H as uniqueName, U as uploadRules, W as withMediaType, k as xhrTransport };
+import { checkRef as y, isContentId as b, itemKey as x, sameItem as S } from "./client/media/ref.js";
+import { MediaApi as C } from "./client/media/api.js";
+import { MAX_PART_SIZE as w, MAX_SINGLE_PUT as T, MIN_PART_SIZE as E } from "./client/generated/wire.js";
+import { sha256Hex as D } from "./client/media/hash.js";
+import { Pacer as O } from "./client/media/pacer.js";
+import { defaultTransport as k, fetchTransport as A, xhrTransport as j } from "./client/media/transport.js";
+import { MediaClient as M, backoff as N, samePath as P, stem as F } from "./client/media/client.js";
+import { acceptOf as I, defaultImage as L, filesFor as R, isPattern as z, ratioLabel as B, ruleDir as V, ruleFor as H, screenFiles as U, uniqueName as W, uploadRules as G, withMediaType as K } from "./client/media/rules.js";
+import { centeredCrop as q, constrainCrop as J, editOf as Y, editedSize as X, fromRotated as Z, rotation as Q, sameEdit as $, toOriginal as ee, toRotated as te } from "./client/crop.js";
+import { encodeRemaining as ne } from "./client/media/encode.js";
+import { ItemUploadQueue as re } from "./client/media/queue.js";
+import { decodeImage as ie, isAnimatedImage as ae } from "./client/image.js";
+import { READ_CHUNK as oe, chunkOffsets as se, isProcessing as ce, mergeReads as le, processing as ue } from "./client/media/windows.js";
+import { ABR_DEFAULTS as de, NETWORK_FAILURES_BEFORE_ERROR as fe, REFRESH_BEFORE_EXPIRY as pe, abrHlsConfig as me, capRung as he, classifyHlsError as ge, classifyMediaError as _e, expiryDelay as ve, hlsConfig as ye, initialEstimate as be, refreshable as xe, startRung as Se, statusKind as Ce } from "./client/playback.js";
+import { formatDuration as we, galleryItems as Te, isAudioType as Ee, isImageType as De, isSubtitleType as Oe, isVideoType as ke, stageAspect as Ae } from "./client/gallery.js";
+import { PLAYBACK_SPEEDS as je, PLAYER_TRACKS_KEY as Me, PLAYER_VOLUME_KEY as Ne, parseSpriteVtt as Pe, playerKeyAction as Fe, resumeAt as Ie } from "./client/player.js";
+import { reactionVerb as Le, sameTarget as Re } from "./client/content/types.js";
+import { CatalogClient as ze } from "./client/catalog.js";
+import { CodesClient as Be } from "./client/codes.js";
+import { BODY_SUFFIX as Ve, ContentsClient as He, IMAGE_SCHEME as Ue, imageRef as We, imageRefs as Ge } from "./client/contents.js";
+import { BansClient as Ke } from "./client/content/bans.js";
+import { CommentsClient as qe } from "./client/content/comments.js";
+import { Beacons as Je, eventId as Ye, readerSession as Xe } from "./client/beacons.js";
+import { DiscoveryClient as Ze } from "./client/discovery.js";
+import { FavoritesClient as Qe } from "./client/content/favorites.js";
+import { ModerationClient as $e } from "./client/content/moderation.js";
+import { PollsClient as et } from "./client/content/polls.js";
+import { ReactionsClient as tt } from "./client/content/reactions.js";
+import { GroupsClient as nt } from "./client/groups.js";
+import { OffersClient as rt } from "./client/offers.js";
+import { VersionsClient as it, isPending as at } from "./client/versions.js";
+import { NotificationsClient as ot } from "./client/notifications.js";
+import { createContentKitClient as st } from "./client/client.js";
+import { LETTERS as ct, attributeInput as lt, fold as ut, fromLocalInput as dt, humanize as ft, letterOf as pt, parseAttribute as mt, parseAttributes as ht, slugify as gt, toLocalInput as _t } from "./client/group-fields.js";
+export { de as ABR_DEFAULTS, Ve as BODY_SUFFIX, Ke as BansClient, Je as Beacons, i as CLIENT_ERROR_CODES, ze as CatalogClient, Be as CodesClient, qe as CommentsClient, a as ContentKitError, He as ContentsClient, e as DEFAULT_DENSITY, Ze as DiscoveryClient, o as ERROR_CODES, Qe as FavoritesClient, nt as GroupsClient, Ue as IMAGE_SCHEME, re as ItemUploadQueue, ct as LETTERS, w as MAX_PART_SIZE, T as MAX_SINGLE_PUT, E as MIN_PART_SIZE, C as MediaApi, M as MediaClient, $e as ModerationClient, fe as NETWORK_FAILURES_BEFORE_ERROR, ot as NotificationsClient, rt as OffersClient, je as PLAYBACK_SPEEDS, Me as PLAYER_TRACKS_KEY, Ne as PLAYER_VOLUME_KEY, O as Pacer, et as PollsClient, oe as READ_CHUNK, pe as REFRESH_BEFORE_EXPIRY, tt as ReactionsClient, it as VersionsClient, me as abrHlsConfig, I as acceptOf, h as aspectOf, lt as attributeInput, N as backoff, _ as call, he as capRung, q as centeredCrop, y as checkRef, se as chunkOffsets, ge as classifyHlsError, _e as classifyMediaError, J as constrainCrop, st as createContentKitClient, ie as decodeImage, L as defaultImage, k as defaultTransport, t as densityFor, Y as editOf, X as editedSize, ne as encodeRemaining, Ye as eventId, ve as expiryDelay, s as failureError, A as fetchTransport, R as filesFor, d as fill, ut as fold, we as formatDuration, dt as fromLocalInput, Z as fromRotated, Te as galleryItems, ye as hlsConfig, ft as humanize, We as imageRef, Ge as imageRefs, be as initialEstimate, ae as isAnimatedImage, Ee as isAudioType, b as isContentId, c as isContentKitError, De as isImageType, z as isPattern, at as isPending, ce as isProcessing, Oe as isSubtitleType, ke as isVideoType, x as itemKey, pt as letterOf, le as mergeReads, mt as parseAttribute, ht as parseAttributes, Pe as parseSpriteVtt, n as pickRendition, Fe as playerKeyAction, ue as processing, f as publicRenditions, p as publicURL, g as ratio, B as ratioLabel, Le as reactionVerb, l as readContentKitError, Xe as readerSession, xe as refreshable, Ie as resumeAt, Q as rotation, v as routeURL, V as ruleDir, H as ruleFor, $ as sameEdit, S as sameItem, P as samePath, Re as sameTarget, U as screenFiles, D as sha256Hex, gt as slugify, r as sortRenditions, m as srcSet, Ae as stageAspect, Se as startRung, Ce as statusKind, F as stem, u as toContentKitError, _t as toLocalInput, ee as toOriginal, te as toRotated, W as uniqueName, G as uploadRules, K as withMediaType, j as xhrTransport };

package/dist/components/admin/content-manager.d.ts

@@ -0,0 +1,80 @@
+import { ReactNode } from 'react';
+import { ContentKitClient } from '../../client/client.js';
+import { Content } from '../../client/generated/wire.js';
+import { FlowClientOptions, StaffAccess } from '../../react/admin.js';
+import { ContentKitErrorHandler } from '../../react/context.js';
+import { Labels } from '../groups/parts.js';
+import { AdminFlowProps, AdminRouteProps } from './shell.js';
+type Choice = string | {
+    value: string;
+    label: string;
+};
+/** What ContentManager hands its body editor. */
+export interface BodyEditorProps {
+    /** The body as HTML, its images at URLs that show them now. */
+    value: string;
+    onChange: (html: string) => void;
+    /** Uploads an image to the item and resolves with a URL that shows it; absent until the item exists. */
+    uploadImage?: (file: File) => Promise<string>;
+    disabled?: boolean;
+    placeholder?: string;
+    "aria-label"?: string;
+}
+export interface ContentManagerProps extends AdminFlowProps, AdminRouteProps {
+    /** The content kind managed. */
+    kind: string;
+    /** Languages to write in: codes, or codes with labels; the first is a new item's. */
+    languages?: readonly Choice[];
+    /**
+     * The body editor: `richTextEditor` from `@openrails/contentkit-ui/editor`,
+     * or the host's own. Without it, the body is a plain HTML field.
+     */
+    renderEditor?: (props: BodyEditorProps) => ReactNode;
+    /** A link to a live item's page. */
+    contentHref?: (content: Content) => string | undefined;
+    /** Display names of kinds, traits, tiers, attributes and values by identifier. */
+    labels?: Labels;
+    pageSize?: number;
+}
+/** Whether the caller manages content: root:content:write holders, creators and owner-group editors. */
+export declare function useContentManagerAccess(o?: FlowClientOptions): StaffAccess<"contents">;
+export type ContentStatus = "draft" | "scheduled" | "published" | "held" | "rejected";
+/** An item's status as the manager names it. */
+export declare function contentStatus(c: Content): ContentStatus;
+/**
+ * Content items of one kind for their creators and staff: every one the
+ * caller manages, by state and text, deleted ones on their own to restore;
+ * create and edit title, slug, description, schedule, cover and body with
+ * inline images per language, publish or keep a draft, and delete; then its
+ * listing and attributes, access rule and price, versions (order, languages,
+ * traits, schedule, access override, price, segments, media) and groups. The
+ * list is at basePath, a new item at basePath/new and each item at
+ * basePath/{id}, filters in the query.
+ */
+export declare function ContentManager({ client: own, baseUrl, auth, guard, appearance, className, language, messages, ...p }: ContentManagerProps): import('react').JSX.Element;
+export interface ContentEditorProps {
+    /** The item edited; null creates one of kind. */
+    id: string | null;
+    kind: string;
+    /** Languages to write in: codes, or codes with labels; the first is a new item's. */
+    languages?: readonly Choice[];
+    /** The body editor; without it, a plain HTML field. */
+    renderEditor?: (props: BodyEditorProps) => ReactNode;
+    /** A link to a live item's page. */
+    contentHref?: (content: Content) => string | undefined;
+    labels?: Labels;
+    /** A new item's owner group: a channel its editors write for. */
+    ownerGroup?: string;
+    /** After create: show the new item (the editor goes on editing it). */
+    onCreated?: (content: Content) => void;
+    onDeleted?: (content: Content) => void;
+    client?: ContentKitClient;
+    onError?: ContentKitErrorHandler;
+}
+/**
+ * One content item for its creators and staff: title, slug, description,
+ * schedule, cover and body per language, publish, unpublish and delete;
+ * then listing and attributes, access rule and price, versions and groups.
+ */
+export declare function ContentEditor({ id, client: own, kind, languages: offered, renderEditor, contentHref, labels, ownerGroup, onCreated, onDeleted, onError }: ContentEditorProps): import('react').JSX.Element;
+export {};