@openrails/contentkit-ui 0.69.0 → 0.70.0

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

@@ -1 +1 @@
-{"version":3,"file":"rules.js","names":[],"sources":["../../../src/client/media/rules.ts"],"sourcesContent":["import { ContentKitError } from \"../errors.js\";\nimport type { ErrorDetails, PresetRule, ReadResult, UploadRule } from \"../generated/wire.js\";\nimport { fill, publicURL, type PublicPreset } from \"../public.js\";\nimport { ratio } from \"../aspect.js\";\nimport { stem } from \"./client.js\";\n\n/** An editor read's upload rules (a viewer read has none). */\nexport const uploadRules = (read: ReadResult | null | undefined): UploadRule[] => read?.uploads ?? [];\n\nconst NAME = \"{name}\";\n\n/** A pattern path (\"originals/{name}\") holds many files; a literal (\"cover\") one. */\nexport const isPattern = (path: string) => path.endsWith(NAME);\n\n/** The directory of a pattern (\"originals/\"), or the literal itself. */\nexport const ruleDir = (path: string) => (isPattern(path) ? path.slice(0, -NAME.length) : path);\n\n/** The rule an upload path (with or without its extension) falls under: a literal wins over a pattern. */\nexport function ruleFor<R extends { path: string }>(rules: readonly R[], path: string): R | undefined {\n  const s = stem(path);\n  return (\n    rules.find((r) => !isPattern(r.path) && r.path === s) ??\n    rules.find((r) => {\n      if (!isPattern(r.path)) return false;\n      const dir = ruleDir(r.path);\n      return s.startsWith(dir) && s.length > dir.length && !s.slice(dir.length).includes(\"/\");\n    })\n  );\n}\n\n/** Uploads of the read under rule (attached, in manifest order). */\nexport function filesFor(read: ReadResult | null | undefined, rule: { path: string }, rules: readonly { path: string }[] = [rule]) {\n  return (read?.files ?? []).filter((f) => f.upload && !f.unattached && ruleFor(rules, f.path)?.path === rule.path);\n}\n\nconst BY_EXTENSION: Record<string, string> = {\n  jpg: \"image/jpeg\",\n  jpeg: \"image/jpeg\",\n  png: \"image/png\",\n  webp: \"image/webp\",\n  gif: \"image/gif\",\n  avif: \"image/avif\",\n  mp4: \"video/mp4\",\n  m4v: \"video/mp4\",\n  mov: \"video/quicktime\",\n  mkv: \"video/x-matroska\",\n  webm: \"video/webm\",\n  m4a: \"audio/mp4\",\n  mp3: \"audio/mpeg\",\n  vtt: \"text/vtt\",\n  srt: \"application/x-subrip\",\n  ass: \"text/x-ass\",\n  ssa: \"text/x-ssa\",\n  zip: \"application/zip\",\n};\n\n/** The file with a content type from its extension when the browser left it empty or nonstandard (.mkv, .mov, .srt). */\nexport function withMediaType(file: File, allowed?: readonly string[]): File {\n  if (file.type && (!allowed || allowed.includes(file.type))) return file;\n  const type = BY_EXTENSION[file.name.split(\".\").pop()?.toLowerCase() ?? \"\"];\n  return type && type !== file.type ? new File([file], file.name, { type, lastModified: file.lastModified }) : file;\n}\n\n/** `accept` for a file input from the rules' types (plus the extensions browsers leave untyped). */\nexport function acceptOf(rules: readonly UploadRule[]): string | undefined {\n  const types = [...new Set(rules.flatMap((r) => r.types))];\n  if (!types.length) return undefined;\n  const exts = Object.entries(BY_EXTENSION).filter(([, t]) => types.includes(t)).map(([e]) => `.${e}`);\n  return [...types, ...exts].join(\",\");\n}\n\nexport interface Screened {\n  /** Files to upload, each with its rule (typed by extension when needed). */\n  accepted: { file: File; rule: UploadRule }[];\n  /** Files the server would refuse, with the refusal it would answer. */\n  refused: { file: File; error: ContentKitError }[];\n}\n\n/**\n * Checks files against the rules before any upload: a type some rule takes\n * (the first that does), its size, and the rule's file cap counting\n * have(rule) files already there. A rule without types, size or cap lets\n * that check through; the server decides.\n */\nexport function screenFiles(files: Iterable<File>, rules: readonly UploadRule[], have: (rule: UploadRule) => number = () => 0): Screened {\n  const out: Screened = { accepted: [], refused: [] };\n  const counts = new Map<UploadRule, number>();\n  const allowed = [...new Set(rules.flatMap((r) => r.types))];\n  for (const picked of files) {\n    const file = withMediaType(picked, allowed);\n    const rule = rules.find((r) => !r.types.length || r.types.includes(file.type));\n    if (!rule) {\n      const details: ErrorDetails = { type: file.type || undefined, allowed };\n      out.refused.push({ file, error: new ContentKitError(\"type_not_allowed\", `${file.name}: type not allowed`, { status: 415, details }) });\n      continue;\n    }\n    if (rule.max_bytes > 0 && file.size > rule.max_bytes) {\n      const details: ErrorDetails = { type: file.type, size: file.size, max_bytes: rule.max_bytes };\n      out.refused.push({ file, error: new ContentKitError(\"too_large\", `${file.name}: too large`, { status: 413, details }) });\n      continue;\n    }\n    const n = counts.get(rule) ?? have(rule);\n    if (rule.max && n >= rule.max) {\n      const details: ErrorDetails = { max: rule.max };\n      out.refused.push({ file, error: new ContentKitError(\"too_many_files\", `${file.name}: at most ${rule.max} files`, { status: 409, details }) });\n      continue;\n    }\n    counts.set(rule, n + 1);\n    out.accepted.push({ file, rule });\n  }\n  return out;\n}\n\n/** name, or name-2, name-3… so its stem is not among taken (names or paths without the directory). */\nexport function uniqueName(name: string, taken: Iterable<string>): string {\n  const stems = new Set([...taken].map(stem));\n  if (!stems.has(stem(name))) return name;\n  const dot = name.lastIndexOf(\".\");\n  const base = dot > 0 ? name.slice(0, dot) : name;\n  const ext = dot > 0 ? name.slice(dot) : \"\";\n  for (let n = 2; ; n++) {\n    const candidate = `${base}-${n}${ext}`;\n    if (!stems.has(stem(candidate))) return candidate;\n  }\n}\n\n/** \"16:9\" style label of a width/height ratio: 2.4 → \"2.4:1\", 0.4167 → \"1:2.4\". */\nexport function ratioLabel(r: number): string {\n  const round = (v: number) => String(Math.round(v * 100) / 100);\n  return r >= 1 ? `${round(r)}:1` : `1:${round(1 / r)}`;\n}\n\n/** The kind's public preset for an upload path: the one named name, else the first with an aspect, else the first. */\nexport function presetFor(presets: readonly PresetRule[], kind: string, path: string, name?: string): PresetRule | undefined {\n  const at = presets.filter((p) => p.kind === kind && ruleFor([{ path: p.from }], path));\n  return (name ? at.find((p) => p.name === name) : undefined) ?? at.find((p) => p.aspect) ?? at[0];\n}\n\n/**\n * The kind's default image for a preset, at every width: what the gateway\n * serves for an item without its own (a URL from the template never names a\n * current file). Empty for a preview preset.\n */\nexport function defaultImage(rule: PresetRule, id: string): PublicPreset {\n  const r = ratio(rule.aspect);\n  if (rule.first || rule.to.includes(NAME)) return { preset: rule.name, aspect: rule.aspect, renditions: [] };\n  return {\n    preset: rule.name,\n    aspect: rule.aspect,\n    renditions: rule.widths.map((w) => ({ url: publicURL(rule.base, rule.namespace, rule.kind, id, fill(rule.to, { w })), w, ...(r ? { h: Math.round(w / r) } : {}) })),\n  };\n}\n"],"mappings":"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"}
+{"version":3,"file":"rules.js","names":[],"sources":["../../../src/client/media/rules.ts"],"sourcesContent":["import { ContentKitError } from \"../errors.js\";\nimport type { ErrorDetails, PresetRule, ReadResult, UploadRule } from \"../generated/wire.js\";\nimport { fill, publicURL, type PublicPreset } from \"../public.js\";\nimport { ratio } from \"../aspect.js\";\nimport { stem } from \"./client.js\";\n\n/** An editor read's upload rules (a viewer read has none). */\nexport const uploadRules = (read: ReadResult | null | undefined): UploadRule[] => read?.uploads ?? [];\n\nconst NAME = \"{name}\";\n\n/** A pattern path (\"originals/{name}\") holds many files; a literal (\"cover\") one. */\nexport const isPattern = (path: string) => path.endsWith(NAME);\n\n/** The directory of a pattern (\"originals/\"), or the literal itself. */\nexport const ruleDir = (path: string) => (isPattern(path) ? path.slice(0, -NAME.length) : path);\n\n/** The rule an upload path (with or without its extension) falls under: a literal wins over a pattern. */\nexport function ruleFor<R extends { path: string }>(rules: readonly R[], path: string): R | undefined {\n  const s = stem(path);\n  return (\n    rules.find((r) => !isPattern(r.path) && r.path === s) ??\n    rules.find((r) => {\n      if (!isPattern(r.path)) return false;\n      const dir = ruleDir(r.path);\n      return s.startsWith(dir) && s.length > dir.length && !s.slice(dir.length).includes(\"/\");\n    })\n  );\n}\n\n/** Uploads of the read under rule (attached, in manifest order). */\nexport function filesFor(read: ReadResult | null | undefined, rule: { path: string }, rules: readonly { path: string }[] = [rule]) {\n  return (read?.files ?? []).filter((f) => f.upload && !f.unattached && ruleFor(rules, f.path)?.path === rule.path);\n}\n\nconst BY_EXTENSION: Record<string, string> = {\n  jpg: \"image/jpeg\",\n  jpeg: \"image/jpeg\",\n  png: \"image/png\",\n  webp: \"image/webp\",\n  gif: \"image/gif\",\n  avif: \"image/avif\",\n  mp4: \"video/mp4\",\n  m4v: \"video/mp4\",\n  mov: \"video/quicktime\",\n  mkv: \"video/x-matroska\",\n  webm: \"video/webm\",\n  m4a: \"audio/mp4\",\n  mp3: \"audio/mpeg\",\n  vtt: \"text/vtt\",\n  srt: \"application/x-subrip\",\n  ass: \"text/x-ass\",\n  ssa: \"text/x-ssa\",\n  zip: \"application/zip\",\n};\n\n/** The file with a content type from its extension when the browser left it empty or nonstandard (.mkv, .mov, .srt). */\nexport function withMediaType(file: File, allowed?: readonly string[]): File {\n  if (file.type && (!allowed || allowed.includes(file.type))) return file;\n  const type = BY_EXTENSION[file.name.split(\".\").pop()?.toLowerCase() ?? \"\"];\n  return type && type !== file.type ? new File([file], file.name, { type, lastModified: file.lastModified }) : file;\n}\n\n/** `accept` for a file input from the rules' types (plus the extensions browsers leave untyped). */\nexport function acceptOf(rules: readonly UploadRule[]): string | undefined {\n  const types = [...new Set(rules.flatMap((r) => r.types))];\n  if (!types.length) return undefined;\n  const exts = Object.entries(BY_EXTENSION).filter(([, t]) => types.includes(t)).map(([e]) => `.${e}`);\n  return [...types, ...exts].join(\",\");\n}\n\nexport interface Screened {\n  /** Files to upload, each with its rule (typed by extension when needed). */\n  accepted: { file: File; rule: UploadRule }[];\n  /** Files the server would refuse, with the refusal it would answer. */\n  refused: { file: File; error: ContentKitError }[];\n}\n\n/**\n * Checks files against the rules before any upload: a type some rule takes\n * (the first that does), its size, and the rule's file cap counting\n * have(rule) files already there. A rule without types, size or cap lets\n * that check through; the server decides.\n */\nexport function screenFiles(files: Iterable<File>, rules: readonly UploadRule[], have: (rule: UploadRule) => number = () => 0): Screened {\n  const out: Screened = { accepted: [], refused: [] };\n  const counts = new Map<UploadRule, number>();\n  const allowed = [...new Set(rules.flatMap((r) => r.types))];\n  for (const picked of files) {\n    const file = withMediaType(picked, allowed);\n    const rule = rules.find((r) => !r.types.length || r.types.includes(file.type));\n    if (!rule) {\n      const details: ErrorDetails = { type: file.type || undefined, allowed };\n      out.refused.push({ file, error: new ContentKitError(\"type_not_allowed\", `${file.name}: type not allowed`, { status: 415, details }) });\n      continue;\n    }\n    if (rule.max_bytes > 0 && file.size > rule.max_bytes) {\n      const details: ErrorDetails = { type: file.type, size: file.size, max_bytes: rule.max_bytes };\n      out.refused.push({ file, error: new ContentKitError(\"too_large\", `${file.name}: too large`, { status: 413, details }) });\n      continue;\n    }\n    const n = counts.get(rule) ?? have(rule);\n    if (rule.max && n >= rule.max) {\n      const details: ErrorDetails = { max: rule.max };\n      out.refused.push({ file, error: new ContentKitError(\"too_many_files\", `${file.name}: at most ${rule.max} files`, { status: 409, details }) });\n      continue;\n    }\n    counts.set(rule, n + 1);\n    out.accepted.push({ file, rule });\n  }\n  return out;\n}\n\n/** name, or name-2, name-3… so its stem is not among taken (names or paths without the directory). */\nexport function uniqueName(name: string, taken: Iterable<string>): string {\n  const stems = new Set([...taken].map(stem));\n  if (!stems.has(stem(name))) return name;\n  const dot = name.lastIndexOf(\".\");\n  const base = dot > 0 ? name.slice(0, dot) : name;\n  const ext = dot > 0 ? name.slice(dot) : \"\";\n  for (let n = 2; ; n++) {\n    const candidate = `${base}-${n}${ext}`;\n    if (!stems.has(stem(candidate))) return candidate;\n  }\n}\n\n/** \"16:9\" style label of a width/height ratio: 2.4 → \"2.4:1\", 0.4167 → \"1:2.4\". */\nexport function ratioLabel(r: number): string {\n  const round = (v: number) => String(Math.round(v * 100) / 100);\n  return r >= 1 ? `${round(r)}:1` : `1:${round(1 / r)}`;\n}\n\n/** The kind's public preset for an upload path: the one named name, else the first with an aspect, else the first. */\nexport function presetFor(presets: readonly PresetRule[], kind: string, path: string, name?: string): PresetRule | undefined {\n  const at = presets.filter((p) => p.kind === kind && ruleFor([{ path: p.from }], path));\n  return (name ? at.find((p) => p.name === name) : undefined) ?? at.find((p) => p.aspect) ?? at[0];\n}\n\n/**\n * The kind's default image for a preset, at every width: what the gateway\n * serves for an item without its own (a URL from the template never names a\n * current file). null when the preset has no default (`rule.default`).\n */\nexport function defaultImage(rule: PresetRule, id: string): PublicPreset | null {\n  const r = ratio(rule.aspect);\n  if (!rule.default || rule.first || rule.to.includes(NAME)) return null;\n  return {\n    preset: rule.name,\n    aspect: rule.aspect,\n    renditions: rule.widths.map((w) => ({ url: publicURL(rule.base, rule.namespace, rule.kind, id, fill(rule.to, { w })), w, ...(r ? { h: Math.round(w / r) } : {}) })),\n  };\n}\n"],"mappings":"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"}

package/dist/client.js

@@ -26,8 +26,8 @@ import { CommentsClient as Re } from "./client/content/comments.js";
 import { FavoritesClient as ze } from "./client/content/favorites.js";
 import { ModerationClient as Be } from "./client/content/moderation.js";
 import { PollsClient as Ve } from "./client/content/polls.js";
-import { PostsClient as He } from "./client/content/posts.js";
-import { ReactionsClient as Ue } from "./client/content/reactions.js";
-import { TaxonomyClient as We } from "./client/taxonomy.js";
-import { createContentKitClient as Ge } from "./client/client.js";
-export { le as ABR_DEFAULTS, Ie as BansClient, i as CLIENT_ERROR_CODES, Fe as CodesClient, Re as CommentsClient, a as ContentKitError, e as DEFAULT_DENSITY, o as ERROR_CODES, ze as FavoritesClient, S as MAX_PART_SIZE, C as MAX_SINGLE_PUT, w as MIN_PART_SIZE, x as MediaApi, A as MediaClient, Be as ModerationClient, ue as NETWORK_FAILURES_BEFORE_ERROR, ke as PLAYBACK_SPEEDS, Ae as PLAYER_TRACKS_KEY, je as PLAYER_VOLUME_KEY, E as Pacer, Ve as PollsClient, He as PostsClient, ie as READ_CHUNK, de as REFRESH_BEFORE_EXPIRY, Ue as ReactionsClient, We as TaxonomyClient, te as UploadQueue, 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, Ge 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, 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, Le 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 { IMAGE_SCHEME as He, PostsClient as Ue, imageRef as We, imageRefs as Ge } from "./client/content/posts.js";
+import { ReactionsClient as Ke } from "./client/content/reactions.js";
+import { TaxonomyClient as qe } from "./client/taxonomy.js";
+import { createContentKitClient as Je } from "./client/client.js";
+export { le as ABR_DEFAULTS, Ie as BansClient, i as CLIENT_ERROR_CODES, Fe as CodesClient, Re as CommentsClient, a as ContentKitError, e as DEFAULT_DENSITY, o as ERROR_CODES, ze as FavoritesClient, He as IMAGE_SCHEME, S as MAX_PART_SIZE, C as MAX_SINGLE_PUT, w as MIN_PART_SIZE, x as MediaApi, A as MediaClient, Be as ModerationClient, ue as NETWORK_FAILURES_BEFORE_ERROR, ke as PLAYBACK_SPEEDS, Ae as PLAYER_TRACKS_KEY, je as PLAYER_VOLUME_KEY, E as Pacer, Ve as PollsClient, Ue as PostsClient, ie as READ_CHUNK, de as REFRESH_BEFORE_EXPIRY, Ke as ReactionsClient, qe as TaxonomyClient, te as UploadQueue, 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, Je 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, We as imageRef, Ge 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, Le 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 };

package/dist/react/posts.d.ts

@@ -29,7 +29,7 @@ export interface UsePost {
     saving: boolean;
     /** Creates the post; the hook then edits it. */
     create: (input: PostInput) => Promise<Post>;
-    /** Updates the given fields; a body from the editor is stored with its images' public URLs (storedBody). */
+    /** Updates the given fields; a body from the editor is stored with image references (storedBody). */
     update: (patch: PostInput) => Promise<Post>;
     remove: () => Promise<void>;
     /** Restores the deleted post (PostWrite). */
@@ -39,15 +39,17 @@ export interface UsePost {
     /** Uploads an image for the body; resolves with a URL that shows it now, to place in the editor. */
     uploadImage: (file: Blob) => Promise<string>;
     /**
-     * A URL that shows one of the post's images now (the cover, a body image):
-     * an unpublished post's images are not public yet, so its editors see them
-     * through signed URLs of an editor read; a fresh upload shows from the
-     * file itself. Any other URL is returned as is.
+     * A URL that shows one of the post's images now, by name ("i-{uuid}") or
+     * reference: a fresh upload from its file, else its public file
+     * (`post.images`), else, while it has none (an unpublished post's), its
+     * signed editor view from an editor read. Anything else is returned as is.
      */
-    imageSrc: (url: string | null | undefined) => string | undefined;
+    imageSrc: (image: string | null | undefined) => string | undefined;
+    /** The cover through imageSrc. */
+    coverSrc: string | undefined;
     /** post.body with its images through imageSrc: what a rich-text editor shows. */
     editorBody: string | undefined;
-    /** HTML from the editor with the URLs imageSrc gave back to the images' public URLs. */
+    /** HTML from the editor with every image URL this hook showed turned back into the image's reference. */
     storedBody: (html: string) => string;
 }
 /** Whether readers see the post, and so its images' public files exist. */

package/dist/react/posts.js

@@ -1,8 +1,9 @@
 import { useMediaRead as e } from "./read.js";
 import { keyOf as t, offsetPages as n, useContentScope as r, useList as i, useResource as a } from "./use-resource.js";
-import { useCallback as o, useEffect as s, useMemo as c, useRef as l, useState as u } from "react";
+import { IMAGE_SCHEME as o, imageRef as s, imageRefs as c } from "../client/content/posts.js";
+import { useCallback as l, useEffect as u, useMemo as d, useRef as f, useState as p } from "react";
 //#region src/react/posts.ts
-function d(e = {}, a = {}) {
+function m(e = {}, a = {}) {
 	let { client: o, store: s, scope: c } = r(a.client), l = e.pageSize ?? 20;
 	return i(s, t("posts", c, !!e.admin, e.language, e.sort, e.draft, e.deleted, e.q, l), {
 		type: "posts",
@@ -19,131 +20,163 @@ function d(e = {}, a = {}) {
 		sort: e.sort
 	}, n)));
 }
-var f = "i-[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}", p = (e) => e.match(new RegExp(f))?.[0], m = RegExp(`[^\\s"'()<>]*${f}[^\\s"'()<>]*`, "g");
-function h(e, t = Date.now()) {
+var h = (e) => [...new Set([...(e ?? "").matchAll(c())].map((e) => e[1]))], g = (e) => {
+	let t = e.slice(e.lastIndexOf("/") + 1), n = t.lastIndexOf(".");
+	return n > 0 ? t.slice(0, n) : t;
+};
+function _(e, t = Date.now()) {
 	return !e.is_draft && !e.moderation && (!e.live_at || Date.parse(e.live_at) <= t);
 }
-function g(n, i = {}) {
-	let { client: d, store: f, scope: g } = r(i.client), [_, v] = u(null), y = n ?? _, b = y ? t("post", g, y) : null, x = a(f, b, {
+function v(n, i = {}) {
+	let { client: m, store: _, scope: v } = r(i.client), [y, b] = p(null), x = n ?? y, S = x ? t("post", v, x) : null, C = a(_, S, {
 		type: "post",
-		id: y ?? void 0
-	}, (e) => d.posts.get(y, e), { initial: i.initial }), S = x.data ?? null, [C, w] = u(0), T = o(async (e) => {
-		w((e) => e + 1);
+		id: x ?? void 0
+	}, (e) => m.posts.get(x, e), { initial: i.initial }), w = C.data ?? null, [T, E] = p(0), D = l(async (e) => {
+		E((e) => e + 1);
 		try {
 			return await e();
 		} finally {
-			w((e) => e - 1);
+			E((e) => e - 1);
 		}
-	}, []), E = o(() => {
-		if (!y) throw Error("contentkit-ui: create the post first");
-		return y;
-	}, [y]), [D, O] = u(/* @__PURE__ */ new Map()), k = l(/* @__PURE__ */ new Map());
-	s(() => {
-		let e = k.current;
+	}, []), O = l(() => {
+		if (!x) throw Error("contentkit-ui: create the post first");
+		return x;
+	}, [x]), [k, A] = p(/* @__PURE__ */ new Map()), j = f([]);
+	u(() => {
+		let e = j.current;
 		return () => {
-			for (let t of e.keys()) t.startsWith("blob:") && URL.revokeObjectURL(t);
+			for (let t of e) URL.revokeObjectURL(t);
 		};
 	}, []);
-	let A = c(() => {
-		let e = /* @__PURE__ */ new Map();
-		for (let t of [...S?.body.match(m) ?? [], S?.cover_url ?? ""]) {
-			let n = p(t);
-			n && !e.has(n) && e.set(n, t);
-		}
-		return e;
-	}, [S?.body, S?.cover_url]), j = !!S && !h(S) && [...A.keys()].some((e) => !D.has(e)), M = c(() => d.media.postRef(y ?? "none"), [d, y]), N = e(M, {
+	let M = d(() => new Map(Object.entries(w?.images ?? {})), [w?.images]), N = d(() => {
+		let e = h(w?.body);
+		return w?.cover && !w.cover_url && !e.includes(w.cover) && e.push(w.cover), e.filter((e) => !k.has(e));
+	}, [
+		w?.body,
+		w?.cover,
+		w?.cover_url,
+		k
+	]), P = d(() => m.media.postRef(x ?? "none"), [m, x]), F = e(P, {
 		editor: !0,
-		read: j ? void 0 : null,
-		client: d
-	}), P = c(() => {
+		read: N.length ? void 0 : null,
+		client: m
+	}), I = d(() => {
 		let e = /* @__PURE__ */ new Map();
-		for (let t of N.read?.files ?? []) {
-			let n = t.upload && t.editor_url ? p(t.path) : void 0;
-			n && e.set(n, t.editor_url);
-		}
+		for (let t of F.read?.files ?? []) t.upload && t.editor_url && e.set(g(t.path), t.editor_url);
 		return e;
-	}, [N.read]), F = j && !!N.read && [...A.keys()].some((e) => !D.has(e) && !P.has(e) && !N.read.files.some((t) => t.failed && p(t.path) === e)), I = l(0), { reload: L } = N;
-	s(() => {
-		if (!F) {
-			I.current = 0;
+	}, [F.read]), L = (e) => !!F.read?.files.some((t) => t.failed && g(t.path) === e), R = !!F.read && N.some((e) => !I.has(e) && !L(e)), z = f(0), { reload: B } = F;
+	u(() => {
+		if (!R) {
+			z.current = 0;
 			return;
 		}
-		if (I.current >= 6) return;
+		if (z.current >= 6) return;
 		let e = setTimeout(() => {
-			I.current++, L();
-		}, 1e3 * 2 ** I.current);
+			z.current++, B();
+		}, 1e3 * 2 ** z.current);
 		return () => clearTimeout(e);
 	}, [
-		F,
-		N.read,
-		L
+		R,
+		F.read,
+		B
 	]);
-	let R = o((e) => {
+	let V = f(/* @__PURE__ */ new Map());
+	u(() => {
+		for (let e of [
+			k,
+			M,
+			I
+		]) for (let [t, n] of e) V.current.set(n, t);
+	}, [
+		k,
+		M,
+		I
+	]);
+	let H = l((e) => {
 		if (!e) return;
-		let t = p(e), n = t ? D.get(t) ?? P.get(t) : void 0;
-		return n ? (k.current.set(n, e), n) : e;
-	}, [D, P]), z = c(() => S?.body.replace(m, (e) => R(e) ?? e), [S?.body, R]), B = o((e) => {
-		let t = e;
-		for (let [e, n] of k.current) t = t.split(e).join(n).split(e.replaceAll("&", "&amp;")).join(n);
-		return t;
-	}, []), V = o((e, t, n) => {
-		if (typeof URL.createObjectURL != "function") return t;
-		let r = URL.createObjectURL(n);
-		return k.current.set(r, t), O((t) => new Map(t).set(e, r)), r;
-	}, []), H = o((e) => T(async () => {
-		let t = await d.posts.create(e);
-		return v(t.id), t;
-	}), [d, T]), U = o((e) => T(() => d.posts.update(E(), e.body === void 0 ? e : {
+		let t = e.startsWith("contentkit:") ? e.slice(o.length) : e;
+		return k.get(t) ?? M.get(t) ?? I.get(t) ?? e;
+	}, [
+		k,
+		M,
+		I
+	]), U = d(() => w?.body.replace(c(), (e, t) => k.get(t) ?? I.get(t) ?? e), [
+		w?.body,
+		k,
+		I
+	]), W = l((e) => {
+		let t = new Map(V.current);
+		for (let e of [
+			k,
+			M,
+			I
+		]) for (let [n, r] of e) t.set(r, n);
+		let n = e;
+		for (let [e, r] of t) n = n.split(e).join(s(r)).split(e.replaceAll("&", "&amp;")).join(s(r));
+		return n;
+	}, [
+		k,
+		M,
+		I
+	]), G = l((e, t) => {
+		if (typeof URL.createObjectURL != "function") return;
+		let n = URL.createObjectURL(t);
+		return j.current.push(n), A((t) => new Map(t).set(e, n)), n;
+	}, []), K = l((e) => D(async () => {
+		let t = await m.posts.create(e);
+		return b(t.id), t;
+	}), [m, D]), q = l((e) => D(() => m.posts.update(O(), e.body === void 0 ? e : {
 		...e,
-		body: B(e.body)
+		body: W(e.body)
 	})), [
-		d,
-		T,
-		E,
-		B
-	]), W = o(() => T(() => d.posts.delete(E())), [
-		d,
-		T,
-		E
-	]), G = o(() => T(() => d.posts.restore(E())), [
-		d,
-		T,
-		E
-	]), K = o((e) => T(async () => {
-		if (!e) return d.posts.setCover(E(), null);
-		let t = await d.media.uploadNamed(d.media.postRef(E()), e), n = await d.posts.setCover(E(), t.name);
-		return n && V(t.name, n, e);
+		m,
+		D,
+		O,
+		W
+	]), J = l(() => D(() => m.posts.delete(O())), [
+		m,
+		D,
+		O
+	]), Y = l(() => D(() => m.posts.restore(O())), [
+		m,
+		D,
+		O
+	]), X = l((e) => D(async () => {
+		if (!e) return m.posts.setCover(O(), null);
+		let t = await m.media.uploadNamed(m.media.postRef(O()), e), n = await m.posts.setCover(O(), t.name), r = G(t.name, e) ?? n;
+		return r && V.current.set(r, t.name), r;
 	}), [
-		d,
-		T,
-		E,
-		V
-	]), q = o((e) => T(async () => {
-		let t = await d.media.uploadInline(E(), e);
-		return V(t.name, t.url, e);
+		m,
+		D,
+		O,
+		G
+	]), Z = l((e) => D(async () => {
+		let t = await m.media.uploadInline(O(), e), n = G(t.name, e) ?? t.url ?? t.ref;
+		return V.current.set(n, t.name), n;
 	}), [
-		d,
-		T,
-		E,
-		V
+		m,
+		D,
+		O,
+		G
 	]);
 	return {
-		post: S,
-		loading: !!b && (x.loading || !x.loaded && i.initial === void 0),
-		error: x.error,
-		saving: C > 0,
-		create: H,
-		update: U,
-		remove: W,
-		restore: G,
-		setCover: K,
-		uploadImage: q,
-		imageSrc: R,
-		editorBody: z,
-		storedBody: B
+		post: w,
+		loading: !!S && (C.loading || !C.loaded && i.initial === void 0),
+		error: C.error,
+		saving: T > 0,
+		create: K,
+		update: q,
+		remove: J,
+		restore: Y,
+		setCover: X,
+		uploadImage: Z,
+		imageSrc: H,
+		coverSrc: H(w?.cover),
+		editorBody: U,
+		storedBody: W
 	};
 }
 //#endregion
-export { h as isPublished, g as usePost, d as usePosts };
+export { _ as isPublished, v as usePost, m as usePosts };
 
 //# sourceMappingURL=posts.js.map

package/dist/react/posts.js.map

@@ -1 +1 @@
-{"version":3,"file":"posts.js","names":[],"sources":["../../src/react/posts.ts"],"sourcesContent":["import { useCallback, useEffect, useMemo, useRef, useState } from \"react\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport type { ContentKitError } from \"../client/errors.js\";\nimport type { Sort } from \"../client/content/types.js\";\nimport type { Post, PostInput } from \"../client/generated/wire.js\";\nimport { useMediaRead } from \"./read.js\";\nimport { keyOf, offsetPages, useContentScope, useList, useResource, type UseList } from \"./use-resource.js\";\n\nexport interface PostFilter {\n  language?: string;\n  sort?: Sort;\n  /** Staff: every post, drafts and scheduled ones included (PostWrite). */\n  admin?: boolean;\n  /** With admin: true only drafts, false no drafts. */\n  draft?: boolean;\n  /** With admin: the deleted posts instead of the live ones. */\n  deleted?: boolean;\n  /** With admin: only posts whose title, excerpt or body contains this text. */\n  q?: string;\n  pageSize?: number;\n}\n\n/** Posts, a page at a time: the published ones, or every one for staff. */\nexport function usePosts(f: PostFilter = {}, o: { client?: ContentKitClient } = {}): UseList<Post> {\n  const { client, store, scope } = useContentScope(o.client);\n  const size = f.pageSize ?? 20;\n  return useList(\n    store,\n    keyOf(\"posts\", scope, !!f.admin, f.language, f.sort, f.draft, f.deleted, f.q, size),\n    { type: \"posts\", scope: f.admin && f.deleted ? \"deleted\" : undefined },\n    offsetPages(size, (q, signal) =>\n      f.admin\n        ? client.posts.adminList({ ...q, language: f.language, draft: f.draft, deleted: f.deleted, q: f.q }, signal)\n        : client.posts.list({ ...q, language: f.language, sort: f.sort }, signal),\n    ),\n  );\n}\n\nexport interface UsePost {\n  /** null before create (or while loading). */\n  post: Post | null;\n  loading: boolean;\n  error?: ContentKitError;\n  /** Writes in flight. */\n  saving: boolean;\n  /** Creates the post; the hook then edits it. */\n  create: (input: PostInput) => Promise<Post>;\n  /** Updates the given fields; a body from the editor is stored with its images' public URLs (storedBody). */\n  update: (patch: PostInput) => Promise<Post>;\n  remove: () => Promise<void>;\n  /** Restores the deleted post (PostWrite). */\n  restore: () => Promise<Post>;\n  /** Uploads the cover (null clears it); resolves with a URL that shows it now. */\n  setCover: (file: Blob | null) => Promise<string | null>;\n  /** Uploads an image for the body; resolves with a URL that shows it now, to place in the editor. */\n  uploadImage: (file: Blob) => Promise<string>;\n  /**\n   * A URL that shows one of the post's images now (the cover, a body image):\n   * an unpublished post's images are not public yet, so its editors see them\n   * through signed URLs of an editor read; a fresh upload shows from the\n   * file itself. Any other URL is returned as is.\n   */\n  imageSrc: (url: string | null | undefined) => string | undefined;\n  /** post.body with its images through imageSrc: what a rich-text editor shows. */\n  editorBody: string | undefined;\n  /** HTML from the editor with the URLs imageSrc gave back to the images' public URLs. */\n  storedBody: (html: string) => string;\n}\n\nconst NAME = \"i-[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}\";\nconst nameIn = (url: string) => url.match(new RegExp(NAME))?.[0];\n// An image URL in HTML: everything around a name up to a quote, a space or a bracket.\nconst imageURLs = new RegExp(`[^\\\\s\"'()<>]*${NAME}[^\\\\s\"'()<>]*`, \"g\");\n\n/** Whether readers see the post, and so its images' public files exist. */\nexport function isPublished(post: Post, now = Date.now()): boolean {\n  return !post.is_draft && !post.moderation && (!post.live_at || Date.parse(post.live_at) <= now);\n}\n\n/** One post: read, and for staff (PostWrite) create, update, delete, restore, cover and body images. null creates a new post. */\nexport function usePost(id: string | null | undefined, o: { initial?: Post; client?: ContentKitClient } = {}): UsePost {\n  const { client, store, scope } = useContentScope(o.client);\n  const [created, setCreated] = useState<string | null>(null);\n  const pid = id ?? created;\n  const key = pid ? keyOf(\"post\", scope, pid) : null;\n  const r = useResource<Post | null>(store, key, { type: \"post\", id: pid ?? undefined }, (s) => client.posts.get(pid!, s), { initial: o.initial });\n  const post = r.data ?? null;\n  const [inflight, setInflight] = useState(0);\n  const run = useCallback(async <T>(fn: () => Promise<T>): Promise<T> => {\n    setInflight((n) => n + 1);\n    try {\n      return await fn();\n    } finally {\n      setInflight((n) => n - 1);\n    }\n  }, []);\n  const need = useCallback(() => {\n    if (!pid) throw new Error(\"contentkit-ui: create the post first\");\n    return pid;\n  }, [pid]);\n\n  // Images: fresh uploads show from their file; an unpublished post's from an editor read.\n  const [previews, setPreviews] = useState<ReadonlyMap<string, string>>(new Map());\n  const given = useRef(new Map<string, string>()); // each URL imageSrc gave -> the image's public URL\n  useEffect(() => {\n    const urls = given.current;\n    return () => {\n      for (const u of urls.keys()) if (u.startsWith(\"blob:\")) URL.revokeObjectURL(u);\n    };\n  }, []);\n  const names = useMemo(() => {\n    const out = new Map<string, string>();\n    for (const u of [...(post?.body.match(imageURLs) ?? []), post?.cover_url ?? \"\"]) {\n      const n = nameIn(u);\n      if (n && !out.has(n)) out.set(n, u);\n    }\n    return out;\n  }, [post?.body, post?.cover_url]);\n  const unread = !!post && !isPublished(post) && [...names.keys()].some((n) => !previews.has(n));\n  const folder = useMemo(() => client.media.postRef(pid ?? \"none\"), [client, pid]);\n  const read = useMediaRead(folder, { editor: true, read: unread ? undefined : null, client });\n  const views = useMemo(() => {\n    const out = new Map<string, string>();\n    for (const f of read.read?.files ?? []) {\n      const n = f.upload && f.editor_url ? nameIn(f.path) : undefined;\n      if (n) out.set(n, f.editor_url!);\n    }\n    return out;\n  }, [read.read]);\n  // Editor views render on the first editor read that misses them: read again, backing off.\n  const missing = unread && !!read.read && [...names.keys()].some((n) => !previews.has(n) && !views.has(n) && !read.read!.files.some((f) => f.failed && nameIn(f.path) === n));\n  const tries = useRef(0);\n  const { reload } = read;\n  useEffect(() => {\n    if (!missing) {\n      tries.current = 0;\n      return;\n    }\n    if (tries.current >= 6) return;\n    const t = setTimeout(() => {\n      tries.current++;\n      reload();\n    }, 1000 * 2 ** tries.current);\n    return () => clearTimeout(t);\n  }, [missing, read.read, reload]);\n\n  const imageSrc = useCallback(\n    (url: string | null | undefined) => {\n      if (!url) return undefined;\n      const n = nameIn(url);\n      const shown = n ? (previews.get(n) ?? views.get(n)) : undefined;\n      if (!shown) return url;\n      given.current.set(shown, url);\n      return shown;\n    },\n    [previews, views],\n  );\n  const editorBody = useMemo(() => post?.body.replace(imageURLs, (u) => imageSrc(u) ?? u), [post?.body, imageSrc]);\n  const storedBody = useCallback((html: string) => {\n    let out = html;\n    for (const [shown, url] of given.current) out = out.split(shown).join(url).split(shown.replaceAll(\"&\", \"&amp;\")).join(url);\n    return out;\n  }, []);\n  const preview = useCallback((name: string, url: string, file: Blob) => {\n    if (typeof URL.createObjectURL !== \"function\") return url;\n    const shown = URL.createObjectURL(file);\n    given.current.set(shown, url);\n    setPreviews((m) => new Map(m).set(name, shown));\n    return shown;\n  }, []);\n\n  const create = useCallback(\n    (input: PostInput) =>\n      run(async () => {\n        const post = await client.posts.create(input);\n        setCreated(post.id);\n        return post;\n      }),\n    [client, run],\n  );\n  const update = useCallback(\n    (patch: PostInput) => run(() => client.posts.update(need(), patch.body === undefined ? patch : { ...patch, body: storedBody(patch.body) })),\n    [client, run, need, storedBody],\n  );\n  const remove = useCallback(() => run(() => client.posts.delete(need())), [client, run, need]);\n  const restore = useCallback(() => run(() => client.posts.restore(need())), [client, run, need]);\n  const setCover = useCallback(\n    (file: Blob | null) =>\n      run(async () => {\n        if (!file) return client.posts.setCover(need(), null);\n        const up = await client.media.uploadNamed(client.media.postRef(need()), file);\n        const url = await client.posts.setCover(need(), up.name);\n        return url && preview(up.name, url, file);\n      }),\n    [client, run, need, preview],\n  );\n  const uploadImage = useCallback(\n    (file: Blob) =>\n      run(async () => {\n        const up = await client.media.uploadInline(need(), file);\n        return preview(up.name, up.url, file);\n      }),\n    [client, run, need, preview],\n  );\n  return {\n    post,\n    loading: !!key && (r.loading || (!r.loaded && o.initial === undefined)),\n    error: r.error,\n    saving: inflight > 0,\n    create,\n    update,\n    remove,\n    restore,\n    setCover,\n    uploadImage,\n    imageSrc,\n    editorBody,\n    storedBody,\n  };\n}\n"],"mappings":";;;;AAuBA,SAAgB,EAAS,IAAgB,CAAC,GAAG,IAAmC,CAAC,GAAkB;CACjG,IAAM,EAAE,WAAQ,UAAO,aAAU,EAAgB,EAAE,MAAM,GACnD,IAAO,EAAE,YAAY;CAC3B,OAAO,EACL,GACA,EAAM,SAAS,GAAO,CAAC,CAAC,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,CAAI,GAClF;EAAE,MAAM;EAAS,OAAO,EAAE,SAAS,EAAE,UAAU,YAAY,KAAA;CAAU,GACrE,EAAY,IAAO,GAAG,MACpB,EAAE,QACE,EAAO,MAAM,UAAU;EAAE,GAAG;EAAG,UAAU,EAAE;EAAU,OAAO,EAAE;EAAO,SAAS,EAAE;EAAS,GAAG,EAAE;CAAE,GAAG,CAAM,IACzG,EAAO,MAAM,KAAK;EAAE,GAAG;EAAG,UAAU,EAAE;EAAU,MAAM,EAAE;CAAK,GAAG,CAAM,CAC5E,CACF;AACF;AAiCA,IAAM,IAAO,kEACP,KAAU,MAAgB,EAAI,MAAM,IAAI,OAAO,CAAI,CAAC,CAAC,GAAG,IAExD,IAAgB,OAAO,gBAAgB,EAAK,gBAAgB,GAAG;AAGrE,SAAgB,EAAY,GAAY,IAAM,KAAK,IAAI,GAAY;CACjE,OAAO,CAAC,EAAK,YAAY,CAAC,EAAK,eAAe,CAAC,EAAK,WAAW,KAAK,MAAM,EAAK,OAAO,KAAK;AAC7F;AAGA,SAAgB,EAAQ,GAA+B,IAAmD,CAAC,GAAY;CACrH,IAAM,EAAE,WAAQ,UAAO,aAAU,EAAgB,EAAE,MAAM,GACnD,CAAC,GAAS,KAAc,EAAwB,IAAI,GACpD,IAAM,KAAM,GACZ,IAAM,IAAM,EAAM,QAAQ,GAAO,CAAG,IAAI,MACxC,IAAI,EAAyB,GAAO,GAAK;EAAE,MAAM;EAAQ,IAAI,KAAO,KAAA;CAAU,IAAI,MAAM,EAAO,MAAM,IAAI,GAAM,CAAC,GAAG,EAAE,SAAS,EAAE,QAAQ,CAAC,GACzI,IAAO,EAAE,QAAQ,MACjB,CAAC,GAAU,KAAe,EAAS,CAAC,GACpC,IAAM,EAAY,OAAU,MAAqC;EACrE,GAAa,MAAM,IAAI,CAAC;EACxB,IAAI;GACF,OAAO,MAAM,EAAG;EAClB,UAAU;GACR,GAAa,MAAM,IAAI,CAAC;EAC1B;CACF,GAAG,CAAC,CAAC,GACC,IAAO,QAAkB;EAC7B,IAAI,CAAC,GAAK,MAAU,MAAM,sCAAsC;EAChE,OAAO;CACT,GAAG,CAAC,CAAG,CAAC,GAGF,CAAC,GAAU,KAAe,kBAAsC,IAAI,IAAI,CAAC,GACzE,IAAQ,kBAAO,IAAI,IAAoB,CAAC;CAC9C,QAAgB;EACd,IAAM,IAAO,EAAM;EACnB,aAAa;GACX,KAAK,IAAM,KAAK,EAAK,KAAK,GAAG,AAAI,EAAE,WAAW,OAAO,KAAG,IAAI,gBAAgB,CAAC;EAC/E;CACF,GAAG,CAAC,CAAC;CACL,IAAM,IAAQ,QAAc;EAC1B,IAAM,oBAAM,IAAI,IAAoB;EACpC,KAAK,IAAM,KAAK,CAAC,GAAI,GAAM,KAAK,MAAM,CAAS,KAAK,CAAC,GAAI,GAAM,aAAa,EAAE,GAAG;GAC/E,IAAM,IAAI,EAAO,CAAC;GAClB,AAAI,KAAK,CAAC,EAAI,IAAI,CAAC,KAAG,EAAI,IAAI,GAAG,CAAC;EACpC;EACA,OAAO;CACT,GAAG,CAAC,GAAM,MAAM,GAAM,SAAS,CAAC,GAC1B,IAAS,CAAC,CAAC,KAAQ,CAAC,EAAY,CAAI,KAAK,CAAC,GAAG,EAAM,KAAK,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,EAAS,IAAI,CAAC,CAAC,GACvF,IAAS,QAAc,EAAO,MAAM,QAAQ,KAAO,MAAM,GAAG,CAAC,GAAQ,CAAG,CAAC,GACzE,IAAO,EAAa,GAAQ;EAAE,QAAQ;EAAM,MAAM,IAAS,KAAA,IAAY;EAAM;CAAO,CAAC,GACrF,IAAQ,QAAc;EAC1B,IAAM,oBAAM,IAAI,IAAoB;EACpC,KAAK,IAAM,KAAK,EAAK,MAAM,SAAS,CAAC,GAAG;GACtC,IAAM,IAAI,EAAE,UAAU,EAAE,aAAa,EAAO,EAAE,IAAI,IAAI,KAAA;GACtD,AAAI,KAAG,EAAI,IAAI,GAAG,EAAE,UAAW;EACjC;EACA,OAAO;CACT,GAAG,CAAC,EAAK,IAAI,CAAC,GAER,IAAU,KAAU,CAAC,CAAC,EAAK,QAAQ,CAAC,GAAG,EAAM,KAAK,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,EAAS,IAAI,CAAC,KAAK,CAAC,EAAM,IAAI,CAAC,KAAK,CAAC,EAAK,KAAM,MAAM,MAAM,MAAM,EAAE,UAAU,EAAO,EAAE,IAAI,MAAM,CAAC,CAAC,GACrK,IAAQ,EAAO,CAAC,GAChB,EAAE,cAAW;CACnB,QAAgB;EACd,IAAI,CAAC,GAAS;GACZ,EAAM,UAAU;GAChB;EACF;EACA,IAAI,EAAM,WAAW,GAAG;EACxB,IAAM,IAAI,iBAAiB;GAEzB,AADA,EAAM,WACN,EAAO;EACT,GAAG,MAAO,KAAK,EAAM,OAAO;EAC5B,aAAa,aAAa,CAAC;CAC7B,GAAG;EAAC;EAAS,EAAK;EAAM;CAAM,CAAC;CAE/B,IAAM,IAAW,GACd,MAAmC;EAClC,IAAI,CAAC,GAAK;EACV,IAAM,IAAI,EAAO,CAAG,GACd,IAAQ,IAAK,EAAS,IAAI,CAAC,KAAK,EAAM,IAAI,CAAC,IAAK,KAAA;EAGtD,OAFK,KACL,EAAM,QAAQ,IAAI,GAAO,CAAG,GACrB,KAFY;CAGrB,GACA,CAAC,GAAU,CAAK,CAClB,GACM,IAAa,QAAc,GAAM,KAAK,QAAQ,IAAY,MAAM,EAAS,CAAC,KAAK,CAAC,GAAG,CAAC,GAAM,MAAM,CAAQ,CAAC,GACzG,IAAa,GAAa,MAAiB;EAC/C,IAAI,IAAM;EACV,KAAK,IAAM,CAAC,GAAO,MAAQ,EAAM,SAAS,IAAM,EAAI,MAAM,CAAK,CAAC,CAAC,KAAK,CAAG,CAAC,CAAC,MAAM,EAAM,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,KAAK,CAAG;EACzH,OAAO;CACT,GAAG,CAAC,CAAC,GACC,IAAU,GAAa,GAAc,GAAa,MAAe;EACrE,IAAI,OAAO,IAAI,mBAAoB,YAAY,OAAO;EACtD,IAAM,IAAQ,IAAI,gBAAgB,CAAI;EAGtC,OAFA,EAAM,QAAQ,IAAI,GAAO,CAAG,GAC5B,GAAa,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,GAAM,CAAK,CAAC,GACvC;CACT,GAAG,CAAC,CAAC,GAEC,IAAS,GACZ,MACC,EAAI,YAAY;EACd,IAAM,IAAO,MAAM,EAAO,MAAM,OAAO,CAAK;EAE5C,OADA,EAAW,EAAK,EAAE,GACX;CACT,CAAC,GACH,CAAC,GAAQ,CAAG,CACd,GACM,IAAS,GACZ,MAAqB,QAAU,EAAO,MAAM,OAAO,EAAK,GAAG,EAAM,SAAS,KAAA,IAAY,IAAQ;EAAE,GAAG;EAAO,MAAM,EAAW,EAAM,IAAI;CAAE,CAAC,CAAC,GAC1I;EAAC;EAAQ;EAAK;EAAM;CAAU,CAChC,GACM,IAAS,QAAkB,QAAU,EAAO,MAAM,OAAO,EAAK,CAAC,CAAC,GAAG;EAAC;EAAQ;EAAK;CAAI,CAAC,GACtF,IAAU,QAAkB,QAAU,EAAO,MAAM,QAAQ,EAAK,CAAC,CAAC,GAAG;EAAC;EAAQ;EAAK;CAAI,CAAC,GACxF,IAAW,GACd,MACC,EAAI,YAAY;EACd,IAAI,CAAC,GAAM,OAAO,EAAO,MAAM,SAAS,EAAK,GAAG,IAAI;EACpD,IAAM,IAAK,MAAM,EAAO,MAAM,YAAY,EAAO,MAAM,QAAQ,EAAK,CAAC,GAAG,CAAI,GACtE,IAAM,MAAM,EAAO,MAAM,SAAS,EAAK,GAAG,EAAG,IAAI;EACvD,OAAO,KAAO,EAAQ,EAAG,MAAM,GAAK,CAAI;CAC1C,CAAC,GACH;EAAC;EAAQ;EAAK;EAAM;CAAO,CAC7B,GACM,IAAc,GACjB,MACC,EAAI,YAAY;EACd,IAAM,IAAK,MAAM,EAAO,MAAM,aAAa,EAAK,GAAG,CAAI;EACvD,OAAO,EAAQ,EAAG,MAAM,EAAG,KAAK,CAAI;CACtC,CAAC,GACH;EAAC;EAAQ;EAAK;EAAM;CAAO,CAC7B;CACA,OAAO;EACL;EACA,SAAS,CAAC,CAAC,MAAQ,EAAE,WAAY,CAAC,EAAE,UAAU,EAAE,YAAY,KAAA;EAC5D,OAAO,EAAE;EACT,QAAQ,IAAW;EACnB;EACA;EACA;EACA;EACA;EACA;EACA;EACA;EACA;CACF;AACF"}
+{"version":3,"file":"posts.js","names":[],"sources":["../../src/react/posts.ts"],"sourcesContent":["import { useCallback, useEffect, useMemo, useRef, useState } from \"react\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport type { ContentKitError } from \"../client/errors.js\";\nimport type { Sort } from \"../client/content/types.js\";\nimport type { Post, PostInput } from \"../client/generated/wire.js\";\nimport { IMAGE_SCHEME, imageRef, imageRefs } from \"../client/content/posts.js\";\nimport { useMediaRead } from \"./read.js\";\nimport { keyOf, offsetPages, useContentScope, useList, useResource, type UseList } from \"./use-resource.js\";\n\nexport interface PostFilter {\n  language?: string;\n  sort?: Sort;\n  /** Staff: every post, drafts and scheduled ones included (PostWrite). */\n  admin?: boolean;\n  /** With admin: true only drafts, false no drafts. */\n  draft?: boolean;\n  /** With admin: the deleted posts instead of the live ones. */\n  deleted?: boolean;\n  /** With admin: only posts whose title, excerpt or body contains this text. */\n  q?: string;\n  pageSize?: number;\n}\n\n/** Posts, a page at a time: the published ones, or every one for staff. */\nexport function usePosts(f: PostFilter = {}, o: { client?: ContentKitClient } = {}): UseList<Post> {\n  const { client, store, scope } = useContentScope(o.client);\n  const size = f.pageSize ?? 20;\n  return useList(\n    store,\n    keyOf(\"posts\", scope, !!f.admin, f.language, f.sort, f.draft, f.deleted, f.q, size),\n    { type: \"posts\", scope: f.admin && f.deleted ? \"deleted\" : undefined },\n    offsetPages(size, (q, signal) =>\n      f.admin\n        ? client.posts.adminList({ ...q, language: f.language, draft: f.draft, deleted: f.deleted, q: f.q }, signal)\n        : client.posts.list({ ...q, language: f.language, sort: f.sort }, signal),\n    ),\n  );\n}\n\nexport interface UsePost {\n  /** null before create (or while loading). */\n  post: Post | null;\n  loading: boolean;\n  error?: ContentKitError;\n  /** Writes in flight. */\n  saving: boolean;\n  /** Creates the post; the hook then edits it. */\n  create: (input: PostInput) => Promise<Post>;\n  /** Updates the given fields; a body from the editor is stored with image references (storedBody). */\n  update: (patch: PostInput) => Promise<Post>;\n  remove: () => Promise<void>;\n  /** Restores the deleted post (PostWrite). */\n  restore: () => Promise<Post>;\n  /** Uploads the cover (null clears it); resolves with a URL that shows it now. */\n  setCover: (file: Blob | null) => Promise<string | null>;\n  /** Uploads an image for the body; resolves with a URL that shows it now, to place in the editor. */\n  uploadImage: (file: Blob) => Promise<string>;\n  /**\n   * A URL that shows one of the post's images now, by name (\"i-{uuid}\") or\n   * reference: a fresh upload from its file, else its public file\n   * (`post.images`), else, while it has none (an unpublished post's), its\n   * signed editor view from an editor read. Anything else is returned as is.\n   */\n  imageSrc: (image: string | null | undefined) => string | undefined;\n  /** The cover through imageSrc. */\n  coverSrc: string | undefined;\n  /** post.body with its images through imageSrc: what a rich-text editor shows. */\n  editorBody: string | undefined;\n  /** HTML from the editor with every image URL this hook showed turned back into the image's reference. */\n  storedBody: (html: string) => string;\n}\n\n/** The names of the images a body still references, once each. */\nconst refNames = (body: string | undefined) => [...new Set([...(body ?? \"\").matchAll(imageRefs())].map((m) => m[1]!))];\nconst uploadName = (path: string) => {\n  const base = path.slice(path.lastIndexOf(\"/\") + 1);\n  const dot = base.lastIndexOf(\".\");\n  return dot > 0 ? base.slice(0, dot) : base;\n};\n\n/** Whether readers see the post, and so its images' public files exist. */\nexport function isPublished(post: Post, now = Date.now()): boolean {\n  return !post.is_draft && !post.moderation && (!post.live_at || Date.parse(post.live_at) <= now);\n}\n\n/** One post: read, and for staff (PostWrite) create, update, delete, restore, cover and body images. null creates a new post. */\nexport function usePost(id: string | null | undefined, o: { initial?: Post; client?: ContentKitClient } = {}): UsePost {\n  const { client, store, scope } = useContentScope(o.client);\n  const [created, setCreated] = useState<string | null>(null);\n  const pid = id ?? created;\n  const key = pid ? keyOf(\"post\", scope, pid) : null;\n  const r = useResource<Post | null>(store, key, { type: \"post\", id: pid ?? undefined }, (s) => client.posts.get(pid!, s), { initial: o.initial });\n  const post = r.data ?? null;\n  const [inflight, setInflight] = useState(0);\n  const run = useCallback(async <T>(fn: () => Promise<T>): Promise<T> => {\n    setInflight((n) => n + 1);\n    try {\n      return await fn();\n    } finally {\n      setInflight((n) => n - 1);\n    }\n  }, []);\n  const need = useCallback(() => {\n    if (!pid) throw new Error(\"contentkit-ui: create the post first\");\n    return pid;\n  }, [pid]);\n\n  // Images: fresh uploads show from their file, published ones from post.images,\n  // the rest (an unpublished post's) from an editor read.\n  const [previews, setPreviews] = useState<ReadonlyMap<string, string>>(new Map());\n  const blobs = useRef<string[]>([]);\n  useEffect(() => {\n    const urls = blobs.current;\n    return () => {\n      for (const u of urls) URL.revokeObjectURL(u);\n    };\n  }, []);\n  const published = useMemo(() => new Map(Object.entries(post?.images ?? {})), [post?.images]);\n  const pending = useMemo(() => {\n    const names = refNames(post?.body);\n    if (post?.cover && !post.cover_url && !names.includes(post.cover)) names.push(post.cover);\n    return names.filter((n) => !previews.has(n));\n  }, [post?.body, post?.cover, post?.cover_url, previews]);\n  const folder = useMemo(() => client.media.postRef(pid ?? \"none\"), [client, pid]);\n  const read = useMediaRead(folder, { editor: true, read: pending.length ? undefined : null, client });\n  const views = useMemo(() => {\n    const out = new Map<string, string>();\n    for (const f of read.read?.files ?? []) if (f.upload && f.editor_url) out.set(uploadName(f.path), f.editor_url);\n    return out;\n  }, [read.read]);\n  // Editor views render on the first editor read that misses them: read again, backing off.\n  const failed = (n: string) => !!read.read?.files.some((f) => f.failed && uploadName(f.path) === n);\n  const missing = !!read.read && pending.some((n) => !views.has(n) && !failed(n));\n  const tries = useRef(0);\n  const { reload } = read;\n  useEffect(() => {\n    if (!missing) {\n      tries.current = 0;\n      return;\n    }\n    if (tries.current >= 6) return;\n    const t = setTimeout(() => {\n      tries.current++;\n      reload();\n    }, 1000 * 2 ** tries.current);\n    return () => clearTimeout(t);\n  }, [missing, read.read, reload]);\n\n  // Every URL shown for an image, of this and earlier reads, back to its name.\n  const shown = useRef(new Map<string, string>());\n  useEffect(() => {\n    for (const m of [previews, published, views]) for (const [n, u] of m) shown.current.set(u, n);\n  }, [previews, published, views]);\n\n  const imageSrc = useCallback(\n    (image: string | null | undefined) => {\n      if (!image) return undefined;\n      const n = image.startsWith(IMAGE_SCHEME) ? image.slice(IMAGE_SCHEME.length) : image;\n      return previews.get(n) ?? published.get(n) ?? views.get(n) ?? image;\n    },\n    [previews, published, views],\n  );\n  const editorBody = useMemo(() => post?.body.replace(imageRefs(), (ref, n: string) => previews.get(n) ?? views.get(n) ?? ref), [post?.body, previews, views]);\n  const storedBody = useCallback(\n    (html: string) => {\n      const back = new Map(shown.current);\n      for (const m of [previews, published, views]) for (const [n, u] of m) back.set(u, n);\n      let out = html;\n      for (const [u, n] of back) out = out.split(u).join(imageRef(n)).split(u.replaceAll(\"&\", \"&amp;\")).join(imageRef(n));\n      return out;\n    },\n    [previews, published, views],\n  );\n  const preview = useCallback((name: string, file: Blob): string | undefined => {\n    if (typeof URL.createObjectURL !== \"function\") return undefined;\n    const url = URL.createObjectURL(file);\n    blobs.current.push(url);\n    setPreviews((m) => new Map(m).set(name, url));\n    return url;\n  }, []);\n\n  const create = useCallback(\n    (input: PostInput) =>\n      run(async () => {\n        const post = await client.posts.create(input);\n        setCreated(post.id);\n        return post;\n      }),\n    [client, run],\n  );\n  const update = useCallback(\n    (patch: PostInput) => run(() => client.posts.update(need(), patch.body === undefined ? patch : { ...patch, body: storedBody(patch.body) })),\n    [client, run, need, storedBody],\n  );\n  const remove = useCallback(() => run(() => client.posts.delete(need())), [client, run, need]);\n  const restore = useCallback(() => run(() => client.posts.restore(need())), [client, run, need]);\n  const setCover = useCallback(\n    (file: Blob | null) =>\n      run(async () => {\n        if (!file) return client.posts.setCover(need(), null);\n        const up = await client.media.uploadNamed(client.media.postRef(need()), file);\n        const cover = await client.posts.setCover(need(), up.name);\n        const url = preview(up.name, file) ?? cover;\n        if (url) shown.current.set(url, up.name);\n        return url;\n      }),\n    [client, run, need, preview],\n  );\n  const uploadImage = useCallback(\n    (file: Blob) =>\n      run(async () => {\n        const up = await client.media.uploadInline(need(), file);\n        const url = preview(up.name, file) ?? up.url ?? up.ref;\n        shown.current.set(url, up.name);\n        return url;\n      }),\n    [client, run, need, preview],\n  );\n  return {\n    post,\n    loading: !!key && (r.loading || (!r.loaded && o.initial === undefined)),\n    error: r.error,\n    saving: inflight > 0,\n    create,\n    update,\n    remove,\n    restore,\n    setCover,\n    uploadImage,\n    imageSrc,\n    coverSrc: imageSrc(post?.cover),\n    editorBody,\n    storedBody,\n  };\n}\n"],"mappings":"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"}

package/dist/react/public.d.ts

@@ -21,7 +21,7 @@ export interface PublicImageOptions {
     client?: ContentKitClient | null;
 }
 export interface UsePublicImage {
-    /** The item's current renditions; the kind's default image when it has none; null while unknown. */
+    /** The item's current renditions; else the kind's default image (when the preset has one); null while unknown or when there is neither. */
     image: PublicPreset | null;
     /** The preset's rules (aspect, widths, min_width) once the presets load. */
     rule?: PresetRule;
@@ -34,6 +34,6 @@ export interface UsePublicImage {
 /**
  * An item's public image for a preset ("avatar", "cover"): the exact
  * renditions from a read's `public` (or the host's listing), else the kind's
- * default image. Reads refresh after commits through the same client.
+ * default image, else none. Reads refresh after commits through the same client.
  */
 export declare function usePublicImage(kind: string, id: string, preset: string, o?: PublicImageOptions): UsePublicImage;

package/dist/react/public.js

@@ -33,18 +33,21 @@ function d(a, s, c, l = {}) {
 	return {
 		...o(() => {
 			let t = h ? l.image : _.read?.public?.find((e) => e.preset === c);
-			return t && t.renditions.length ? {
+			if (t && t.renditions.length) return {
 				image: {
 					preset: c,
 					renditions: t.renditions,
 					aspect: "aspect" in t && t.aspect || m?.aspect
 				},
 				isDefault: !1
-			} : !h && !_.read ? {
+			};
+			if (!h && !_.read) return {
 				image: null,
 				isDefault: !1
-			} : m ? {
-				image: e(m, s),
+			};
+			let n = m && e(m, s);
+			return n ? {
+				image: n,
 				isDefault: !0
 			} : {
 				image: null,

package/dist/react/public.js.map

@@ -1 +1 @@
-{"version":3,"file":"public.js","names":[],"sources":["../../src/react/public.ts"],"sourcesContent":["import { useEffect, useMemo, useState } from \"react\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport type { ContentKitError } from \"../client/errors.js\";\nimport type { ReadResult } from \"../client/generated/wire.js\";\nimport type { PresetRule } from \"../client/generated/wire.js\";\nimport { defaultImage, isPattern, ruleDir } from \"../client/media/rules.js\";\nimport type { PublicPreset } from \"../client/public.js\";\nimport { useOptionalContentKitClient } from \"./context.js\";\nimport { useMediaRead } from \"./read.js\";\n\nexport interface UsePresets {\n  /** Every kind's public presets; empty until they load (or when the server has none). */\n  presets: PresetRule[];\n  loaded: boolean;\n  error?: ContentKitError;\n}\n\nconst settled = new WeakMap<ContentKitClient, { presets: PresetRule[]; error?: ContentKitError }>();\nconst inflight = new WeakMap<ContentKitClient, Promise<void>>();\n\n/** The public presets (`GET /media/presets`), fetched once per client. */\nexport function usePresets(o: { client?: ContentKitClient | null } = {}): UsePresets {\n  const client = useOptionalContentKitClient(o.client);\n  const [, rerender] = useState(0);\n  const done = client ? settled.get(client) : undefined;\n  useEffect(() => {\n    if (!client || settled.has(client)) return;\n    let live = true;\n    let load = inflight.get(client);\n    if (!load) {\n      load = client.media.presets().then(\n        (presets) => void settled.set(client, { presets }),\n        (error: ContentKitError) => void settled.set(client, { presets: [], error }),\n      ).finally(() => inflight.delete(client));\n      inflight.set(client, load);\n    }\n    void load.then(() => live && rerender((n) => n + 1));\n    return () => {\n      live = false;\n    };\n  }, [client]);\n  return { presets: done?.presets ?? [], loaded: !!done || !client, error: done?.error };\n}\n\nexport interface PublicImageOptions {\n  /** The host's listing of the item's image (its API's): shown without a read. */\n  image?: PublicPreset | null;\n  /** A read of the item the host already has. */\n  read?: ReadResult | null;\n  /** Overrides the provider's client. */\n  client?: ContentKitClient | null;\n}\n\nexport interface UsePublicImage {\n  /** The item's current renditions; the kind's default image when it has none; null while unknown. */\n  image: PublicPreset | null;\n  /** The preset's rules (aspect, widths, min_width) once the presets load. */\n  rule?: PresetRule;\n  /** image is the kind's default, not the item's own. */\n  isDefault: boolean;\n  loading: boolean;\n  error?: ContentKitError;\n  reload: () => void;\n}\n\n/**\n * An item's public image for a preset (\"avatar\", \"cover\"): the exact\n * renditions from a read's `public` (or the host's listing), else the kind's\n * default image. Reads refresh after commits through the same client.\n */\nexport function usePublicImage(kind: string, id: string, preset: string, o: PublicImageOptions = {}): UsePublicImage {\n  const client = useOptionalContentKitClient(o.client);\n  const { presets, loaded } = usePresets({ client });\n  const rule = presets.find((p) => p.kind === kind && p.name === preset);\n  const listed = o.image !== undefined;\n  // The read waits for the presets, so it lists only the preset's upload.\n  const prefix = rule ? (isPattern(rule.from) ? ruleDir(rule.from) : rule.from) : undefined;\n  const r = useMediaRead({ kind, id }, { prefix, read: listed || !loaded ? null : o.read, client });\n  const image = useMemo((): { image: PublicPreset | null; isDefault: boolean } => {\n    const own = listed ? o.image : r.read?.public?.find((p) => p.preset === preset);\n    if (own && own.renditions.length) return { image: { preset, renditions: own.renditions, aspect: (\"aspect\" in own && own.aspect) || rule?.aspect }, isDefault: false };\n    if (!listed && !r.read) return { image: null, isDefault: false };\n    return rule ? { image: defaultImage(rule, id), isDefault: true } : { image: null, isDefault: false };\n  }, [listed, o.image, r.read, preset, rule, id]);\n  return { ...image, rule, loading: !loaded || r.loading, error: r.error, reload: r.reload };\n}\n"],"mappings":";;;;;AAiBA,IAAM,oBAAU,IAAI,QAA8E,GAC5F,oBAAW,IAAI,QAAyC;AAG9D,SAAgB,EAAW,IAA0C,CAAC,GAAe;CACnF,IAAM,IAAS,EAA4B,EAAE,MAAM,GAC7C,GAAG,KAAY,EAAS,CAAC,GACzB,IAAO,IAAS,EAAQ,IAAI,CAAM,IAAI,KAAA;CAiB5C,OAhBA,QAAgB;EACd,IAAI,CAAC,KAAU,EAAQ,IAAI,CAAM,GAAG;EACpC,IAAI,IAAO,IACP,IAAO,EAAS,IAAI,CAAM;EAS9B,OARK,MACH,IAAO,EAAO,MAAM,QAAQ,CAAC,CAAC,MAC3B,MAAY,KAAK,EAAQ,IAAI,GAAQ,EAAE,WAAQ,CAAC,IAChD,MAA2B,KAAK,EAAQ,IAAI,GAAQ;GAAE,SAAS,CAAC;GAAG;EAAM,CAAC,CAC7E,CAAC,CAAC,cAAc,EAAS,OAAO,CAAM,CAAC,GACvC,EAAS,IAAI,GAAQ,CAAI,IAE3B,EAAU,WAAW,KAAQ,GAAU,MAAM,IAAI,CAAC,CAAC,SACtC;GACX,IAAO;EACT;CACF,GAAG,CAAC,CAAM,CAAC,GACJ;EAAE,SAAS,GAAM,WAAW,CAAC;EAAG,QAAQ,CAAC,CAAC,KAAQ,CAAC;EAAQ,OAAO,GAAM;CAAM;AACvF;AA4BA,SAAgB,EAAe,GAAc,GAAY,GAAgB,IAAwB,CAAC,GAAmB;CACnH,IAAM,IAAS,EAA4B,EAAE,MAAM,GAC7C,EAAE,YAAS,cAAW,EAAW,EAAE,UAAO,CAAC,GAC3C,IAAO,EAAQ,MAAM,MAAM,EAAE,SAAS,KAAQ,EAAE,SAAS,CAAM,GAC/D,IAAS,EAAE,UAAU,KAAA,GAErB,IAAS,IAAQ,EAAU,EAAK,IAAI,IAAI,EAAQ,EAAK,IAAI,IAAI,EAAK,OAAQ,KAAA,GAC1E,IAAI,EAAa;EAAE;EAAM;CAAG,GAAG;EAAE;EAAQ,MAAM,KAAU,CAAC,IAAS,OAAO,EAAE;EAAM;CAAO,CAAC;CAOhG,OAAO;EAAE,GANK,QAAkE;GAC9E,IAAM,IAAM,IAAS,EAAE,QAAQ,EAAE,MAAM,QAAQ,MAAM,MAAM,EAAE,WAAW,CAAM;GAG9E,OAFI,KAAO,EAAI,WAAW,SAAe;IAAE,OAAO;KAAE;KAAQ,YAAY,EAAI;KAAY,QAAS,YAAY,KAAO,EAAI,UAAW,GAAM;IAAO;IAAG,WAAW;GAAM,IAChK,CAAC,KAAU,CAAC,EAAE,OAAa;IAAE,OAAO;IAAM,WAAW;GAAM,IACxD,IAAO;IAAE,OAAO,EAAa,GAAM,CAAE;IAAG,WAAW;GAAK,IAAI;IAAE,OAAO;IAAM,WAAW;GAAM;EACrG,GAAG;GAAC;GAAQ,EAAE;GAAO,EAAE;GAAM;GAAQ;GAAM;EAAE,CACjC;EAAO;EAAM,SAAS,CAAC,KAAU,EAAE;EAAS,OAAO,EAAE;EAAO,QAAQ,EAAE;CAAO;AAC3F"}
+{"version":3,"file":"public.js","names":[],"sources":["../../src/react/public.ts"],"sourcesContent":["import { useEffect, useMemo, useState } from \"react\";\nimport type { ContentKitClient } from \"../client/client.js\";\nimport type { ContentKitError } from \"../client/errors.js\";\nimport type { ReadResult } from \"../client/generated/wire.js\";\nimport type { PresetRule } from \"../client/generated/wire.js\";\nimport { defaultImage, isPattern, ruleDir } from \"../client/media/rules.js\";\nimport type { PublicPreset } from \"../client/public.js\";\nimport { useOptionalContentKitClient } from \"./context.js\";\nimport { useMediaRead } from \"./read.js\";\n\nexport interface UsePresets {\n  /** Every kind's public presets; empty until they load (or when the server has none). */\n  presets: PresetRule[];\n  loaded: boolean;\n  error?: ContentKitError;\n}\n\nconst settled = new WeakMap<ContentKitClient, { presets: PresetRule[]; error?: ContentKitError }>();\nconst inflight = new WeakMap<ContentKitClient, Promise<void>>();\n\n/** The public presets (`GET /media/presets`), fetched once per client. */\nexport function usePresets(o: { client?: ContentKitClient | null } = {}): UsePresets {\n  const client = useOptionalContentKitClient(o.client);\n  const [, rerender] = useState(0);\n  const done = client ? settled.get(client) : undefined;\n  useEffect(() => {\n    if (!client || settled.has(client)) return;\n    let live = true;\n    let load = inflight.get(client);\n    if (!load) {\n      load = client.media.presets().then(\n        (presets) => void settled.set(client, { presets }),\n        (error: ContentKitError) => void settled.set(client, { presets: [], error }),\n      ).finally(() => inflight.delete(client));\n      inflight.set(client, load);\n    }\n    void load.then(() => live && rerender((n) => n + 1));\n    return () => {\n      live = false;\n    };\n  }, [client]);\n  return { presets: done?.presets ?? [], loaded: !!done || !client, error: done?.error };\n}\n\nexport interface PublicImageOptions {\n  /** The host's listing of the item's image (its API's): shown without a read. */\n  image?: PublicPreset | null;\n  /** A read of the item the host already has. */\n  read?: ReadResult | null;\n  /** Overrides the provider's client. */\n  client?: ContentKitClient | null;\n}\n\nexport interface UsePublicImage {\n  /** The item's current renditions; else the kind's default image (when the preset has one); null while unknown or when there is neither. */\n  image: PublicPreset | null;\n  /** The preset's rules (aspect, widths, min_width) once the presets load. */\n  rule?: PresetRule;\n  /** image is the kind's default, not the item's own. */\n  isDefault: boolean;\n  loading: boolean;\n  error?: ContentKitError;\n  reload: () => void;\n}\n\n/**\n * An item's public image for a preset (\"avatar\", \"cover\"): the exact\n * renditions from a read's `public` (or the host's listing), else the kind's\n * default image, else none. Reads refresh after commits through the same client.\n */\nexport function usePublicImage(kind: string, id: string, preset: string, o: PublicImageOptions = {}): UsePublicImage {\n  const client = useOptionalContentKitClient(o.client);\n  const { presets, loaded } = usePresets({ client });\n  const rule = presets.find((p) => p.kind === kind && p.name === preset);\n  const listed = o.image !== undefined;\n  // The read waits for the presets, so it lists only the preset's upload.\n  const prefix = rule ? (isPattern(rule.from) ? ruleDir(rule.from) : rule.from) : undefined;\n  const r = useMediaRead({ kind, id }, { prefix, read: listed || !loaded ? null : o.read, client });\n  const image = useMemo((): { image: PublicPreset | null; isDefault: boolean } => {\n    const own = listed ? o.image : r.read?.public?.find((p) => p.preset === preset);\n    if (own && own.renditions.length) return { image: { preset, renditions: own.renditions, aspect: (\"aspect\" in own && own.aspect) || rule?.aspect }, isDefault: false };\n    if (!listed && !r.read) return { image: null, isDefault: false };\n    const def = rule && defaultImage(rule, id);\n    return def ? { image: def, isDefault: true } : { image: null, isDefault: false };\n  }, [listed, o.image, r.read, preset, rule, id]);\n  return { ...image, rule, loading: !loaded || r.loading, error: r.error, reload: r.reload };\n}\n"],"mappings":";;;;;AAiBA,IAAM,oBAAU,IAAI,QAA8E,GAC5F,oBAAW,IAAI,QAAyC;AAG9D,SAAgB,EAAW,IAA0C,CAAC,GAAe;CACnF,IAAM,IAAS,EAA4B,EAAE,MAAM,GAC7C,GAAG,KAAY,EAAS,CAAC,GACzB,IAAO,IAAS,EAAQ,IAAI,CAAM,IAAI,KAAA;CAiB5C,OAhBA,QAAgB;EACd,IAAI,CAAC,KAAU,EAAQ,IAAI,CAAM,GAAG;EACpC,IAAI,IAAO,IACP,IAAO,EAAS,IAAI,CAAM;EAS9B,OARK,MACH,IAAO,EAAO,MAAM,QAAQ,CAAC,CAAC,MAC3B,MAAY,KAAK,EAAQ,IAAI,GAAQ,EAAE,WAAQ,CAAC,IAChD,MAA2B,KAAK,EAAQ,IAAI,GAAQ;GAAE,SAAS,CAAC;GAAG;EAAM,CAAC,CAC7E,CAAC,CAAC,cAAc,EAAS,OAAO,CAAM,CAAC,GACvC,EAAS,IAAI,GAAQ,CAAI,IAE3B,EAAU,WAAW,KAAQ,GAAU,MAAM,IAAI,CAAC,CAAC,SACtC;GACX,IAAO;EACT;CACF,GAAG,CAAC,CAAM,CAAC,GACJ;EAAE,SAAS,GAAM,WAAW,CAAC;EAAG,QAAQ,CAAC,CAAC,KAAQ,CAAC;EAAQ,OAAO,GAAM;CAAM;AACvF;AA4BA,SAAgB,EAAe,GAAc,GAAY,GAAgB,IAAwB,CAAC,GAAmB;CACnH,IAAM,IAAS,EAA4B,EAAE,MAAM,GAC7C,EAAE,YAAS,cAAW,EAAW,EAAE,UAAO,CAAC,GAC3C,IAAO,EAAQ,MAAM,MAAM,EAAE,SAAS,KAAQ,EAAE,SAAS,CAAM,GAC/D,IAAS,EAAE,UAAU,KAAA,GAErB,IAAS,IAAQ,EAAU,EAAK,IAAI,IAAI,EAAQ,EAAK,IAAI,IAAI,EAAK,OAAQ,KAAA,GAC1E,IAAI,EAAa;EAAE;EAAM;CAAG,GAAG;EAAE;EAAQ,MAAM,KAAU,CAAC,IAAS,OAAO,EAAE;EAAM;CAAO,CAAC;CAQhG,OAAO;EAAE,GAPK,QAAkE;GAC9E,IAAM,IAAM,IAAS,EAAE,QAAQ,EAAE,MAAM,QAAQ,MAAM,MAAM,EAAE,WAAW,CAAM;GAC9E,IAAI,KAAO,EAAI,WAAW,QAAQ,OAAO;IAAE,OAAO;KAAE;KAAQ,YAAY,EAAI;KAAY,QAAS,YAAY,KAAO,EAAI,UAAW,GAAM;IAAO;IAAG,WAAW;GAAM;GACpK,IAAI,CAAC,KAAU,CAAC,EAAE,MAAM,OAAO;IAAE,OAAO;IAAM,WAAW;GAAM;GAC/D,IAAM,IAAM,KAAQ,EAAa,GAAM,CAAE;GACzC,OAAO,IAAM;IAAE,OAAO;IAAK,WAAW;GAAK,IAAI;IAAE,OAAO;IAAM,WAAW;GAAM;EACjF,GAAG;GAAC;GAAQ,EAAE;GAAO,EAAE;GAAM;GAAQ;GAAM;EAAE,CACjC;EAAO;EAAM,SAAS,CAAC,KAAU,EAAE;EAAS,OAAO,EAAE;EAAO,QAAQ,EAAE;CAAO;AAC3F"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openrails/contentkit-ui",
-  "version": "0.69.0",
+  "version": "0.70.0",
   "description": "ContentKit in the browser: client, React hooks and styled components for media, uploads and content URLs.",
   "type": "module",
   "license": "MIT",