@glw907/cairn-cms 0.56.2 → 0.57.1

package/dist/sveltekit/content-routes.d.ts

@@ -1,6 +1,9 @@
 import { fail } from '@sveltejs/kit';
 import { type GithubKeyEnv } from '../github/credentials.js';
 import { type LinkTarget, type InboundLink } from '../content/manifest.js';
+import type { MediaEntry } from '../media/manifest.js';
+import type { MediaLibrary, MediaLibraryEntry } from '../media/library-entry.js';
+import type { UsageEntry } from '../media/usage.js';
 import type { CookieJar, EventBase } from './types.js';
 import type { CairnRuntime, FrontmatterField, ResolvedPreview } from '../content/types.js';
 import type { Role } from '../auth/types.js';
@@ -83,6 +86,18 @@ export interface EditData {
     slug: string;
     /** The site's link targets, for the preview resolver and the link picker; from the committed manifest. */
     linkTargets: LinkTarget[];
+    /** The minimal media-resolver input the edit page builds its preview `resolveMedia` from, keyed by
+     *  the 16-hex content hash and parallel to `linkTargets`. Empty when media is off or the read fails. */
+    mediaTargets: Record<string, {
+        slug: string;
+        ext: string;
+        contentType: string;
+    }>;
+    /** The picker's human layer for each stored asset, keyed by the 16-hex content hash and projected
+     *  from the same committed media manifest read that populates `mediaTargets`. The `hash` field
+     *  duplicates the key, so the picker can iterate `Object.values`. Empty when media is off or the
+     *  read fails (the same degradation path as `mediaTargets`). */
+    mediaLibrary: MediaLibrary;
     /** The entries that link to this one, for the delete guard. Empty when nothing links here. */
     inboundLinks: InboundLink[];
     /** True when the entry has a pending branch, so the body above came from that branch. */
@@ -98,6 +113,32 @@ export interface EditData {
      *  leaves the frame rendering unstyled markup behind a hint. */
     preview: ResolvedPreview | null;
 }
+/** One asset's where-used overlay, kept separate from MediaLibraryEntry so the picker's shared
+ *  projection stays decoupled from the Library-only usage facts. */
+export interface MediaUsageInfo {
+    /** Distinct content entries that reference the asset (count by distinct concept+id). */
+    count: number;
+    /** Every where-used row (published and edit-branch origins), for the detail's grouped list. */
+    entries: UsageEntry[];
+}
+/** The Media Library screen's data: the unioned assets, the per-hash usage overlay, and the
+ *  degraded-load error. The usage overlay is keyed by content hash; an asset with no references
+ *  simply has no key, which the screen renders as "no references found". */
+export interface MediaLibraryData {
+    assets: MediaLibraryEntry[];
+    /** Per-hash usage overlay, kept separate from MediaLibraryEntry so the popover stays decoupled. */
+    usage: Record<string, MediaUsageInfo>;
+    /** The degraded-load error: a failed token mint or media read. This slot is the failure of THIS
+     *  load, distinct from a prior action's conflict error (see `flashError`), so a read failure and a
+     *  redirected commit conflict never overwrite each other. */
+    error: string | null;
+    /** The success flash a redirected action carries: `deleted` from `?deleted=1`, `updated` from
+     *  `?updated=1`, null otherwise. The component renders a polite success strip for each. */
+    flash: 'deleted' | 'updated' | null;
+    /** A redirected action's conflict error read from `?error=` (a commit-conflict bounce). Kept in
+     *  its own slot rather than the degraded-load `error` above, so the two never collide. */
+    flashError: string | null;
+}
 /** The structural event the content routes read; a real SvelteKit RequestEvent satisfies it. */
 export interface ContentEvent extends EventBase<GithubKeyEnv> {
     params: Record<string, string>;
@@ -134,14 +175,45 @@ export interface RenameFailure {
     /** The one-line human summary every content action failure carries. */
     error: string;
 }
+/** A refused media delete: `fail(404)` for an asset not committed on the default branch, or
+ *  `fail(409)` when a fresh usage read finds the asset still in use and the typed-slug override
+ *  was not given. `fail(503)` covers media-off or a missing bucket binding. */
+export interface MediaDeleteRefusal {
+    /** The one-line human summary every action failure carries. */
+    error: string;
+    /** The refused asset's content hash, so the dialog marks the right asset. */
+    hash: string;
+    /** The where-used rows (published first, then by branch) the in-use face lists; empty otherwise. */
+    usage: UsageEntry[];
+    /** The distinct-entry count behind the refusal; zero when the asset is uncommitted. */
+    foundIn: number;
+}
+/** A refused media metadata edit: `fail(404)` for an asset not committed on the default branch, or
+ *  `fail(400)` for an invalid slug. */
+export interface MediaUpdateFailure {
+    /** The one-line human summary every action failure carries. */
+    error: string;
+}
 /** What a route's single `form` export presents to a view component: whichever content action
  *  last failed, merged with every field optional. `error` is always set on a failure; the richer
- *  keys identify which guard refused. */
-export type ContentFormFailure = Partial<SaveFailure & DeleteRefusal & RenameFailure>;
+ *  keys identify which guard refused. The media refusals ride here too, so the Media Library's one
+ *  `form` prop carries a `?/mediaDelete` or `?/mediaUpdate` refusal without a second type. */
+export type ContentFormFailure = Partial<SaveFailure & DeleteRefusal & RenameFailure & MediaDeleteRefusal & MediaUpdateFailure>;
+/** The successful upload's response (`uploadAction`). The server-owned `record` rides the editor's
+ *  optimistic client state and commits with the entry at Save (the upload itself commits nothing).
+ *  `reused` is true when identical bytes were already stored, so the second upload did no second put;
+ *  `mismatch` flags an existing object whose stored content type differs from this sniff. */
+export interface UploadResult {
+    reference: string;
+    record: MediaEntry;
+    reused: boolean;
+    mismatch: boolean;
+}
 export declare function createContentRoutes(runtime: CairnRuntime, deps?: ContentRoutesDeps): {
     layoutLoad: (event: ContentEvent) => Promise<LayoutData>;
     indexRedirect: () => never;
     listLoad: (event: ContentEvent) => Promise<ListData>;
+    mediaLibraryLoad: (event: ContentEvent) => Promise<MediaLibraryData>;
     createAction: (event: ContentEvent) => Promise<never>;
     editLoad: (event: ContentEvent) => Promise<EditData>;
     saveAction: (event: ContentEvent) => Promise<ReturnType<typeof fail> | never>;
@@ -151,5 +223,8 @@ export declare function createContentRoutes(runtime: CairnRuntime, deps?: Conten
     deleteAction: (event: ContentEvent) => Promise<ReturnType<typeof fail> | never>;
     listDeleteAction: (event: ContentEvent) => Promise<ReturnType<typeof fail> | never>;
     renameAction: (event: ContentEvent) => Promise<ReturnType<typeof fail> | never>;
+    uploadAction: (event: ContentEvent) => Promise<ReturnType<typeof fail> | UploadResult>;
+    mediaDeleteAction: (event: ContentEvent) => Promise<ReturnType<typeof fail> | never>;
+    mediaUpdateAction: (event: ContentEvent) => Promise<ReturnType<typeof fail> | never>;
     mintToken: (env: GithubKeyEnv) => string | Promise<string>;
 };