gazetta 0.6.0 → 0.7.0

package/dist/admin-api/schemas/assets.js

@@ -0,0 +1,44 @@
+/**
+ * Zod schemas + typed errors for asset-domain HTTP contracts.
+ *
+ * Thin transport envelopes around the domain-owned shapes. The `AssetRef`
+ * schema lives in `../../assets/refs.ts` (domain); this module wraps it
+ * in HTTP-shaped responses and re-exports the domain error classes so
+ * both server and admin client can import them from a single place.
+ *
+ * Single source of truth. The server throws `AssetInUseError` from the
+ * asset domain; the route adapter serializes via `AssetInUseResponseSchema`;
+ * the admin client parses the 409 body into the same `AssetInUseError`
+ * class. No parallel client-only copy.
+ */
+import { z } from 'zod';
+import { AssetRefSchema } from '../../assets/refs.js';
+// Re-export the domain schema + type so admin-api consumers can get
+// everything they need from this barrel without reaching into the domain.
+export { AssetRefSchema } from '../../assets/refs.js';
+// Re-export the typed error hierarchy. The admin client imports
+// `AssetInUseError` from here and uses `instanceof` to branch; the server
+// throws the same class. One identity across the wire.
+export { AssetInUseError, AssetKindMismatchError, AssetManifestCorruptError, AssetManifestNotFoundError, AssetMimeMismatchError, AssetMimeUnsupportedError, AssetNameCollisionError, AssetNameInvalidError, AssetNameReservedError, AssetPathTraversalError, AssetPreprocessError, AssetSizeExceededError, AssetStorageError, AssetValidationError, AssetVariantGenerationError, } from '../../assets/errors.js';
+/**
+ * Body of a 409 response on DELETE /api/assets/:name — emitted when the
+ * asset is still referenced by at least one page or fragment. `refs` is
+ * the exact usage list the server found; the client renders it verbatim.
+ */
+export const AssetInUseResponseSchema = z.object({
+    code: z.literal('ASSET_IN_USE'),
+    message: z.string(),
+    assetName: z.string(),
+    refs: z.array(AssetRefSchema),
+});
+/**
+ * Body of a 409 response on POST /api/assets/:name/rename-to/:newName —
+ * emitted when `newName` already maps to an existing asset. The author
+ * either picks a different name or uses replace-and-delete to merge.
+ */
+export const AssetNameCollisionResponseSchema = z.object({
+    code: z.literal('ASSET_NAME_COLLISION'),
+    message: z.string(),
+    newName: z.string(),
+});
+//# sourceMappingURL=assets.js.map

package/dist/admin-api/schemas/assets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.js","sourceRoot":"","sources":["../../../src/admin-api/schemas/assets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAErD,oEAAoE;AACpE,0EAA0E;AAC1E,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAGrD,gEAAgE;AAChE,0EAA0E;AAC1E,uDAAuD;AACvD,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,yBAAyB,EACzB,0BAA0B,EAC1B,sBAAsB,EACtB,yBAAyB,EACzB,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,2BAA2B,GAE5B,MAAM,wBAAwB,CAAA;AAE/B;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC;IAC/B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC;CAC9B,CAAC,CAAA;AAGF;;;;GAIG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC,MAAM,CAAC;IACvD,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,sBAAsB,CAAC;IACvC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;CACpB,CAAC,CAAA"}

package/dist/admin-api/schemas/index.d.ts

@@ -15,6 +15,7 @@
  *   - POST /api/publish + /api/publish/stream (result + SSE progress union)
  *   - GET  /api/history + POST /api/history/{undo,restore} (revisions + restore)
  *   - POST /api/fetch (cross-target copy)
+ *   - DELETE /api/assets/:name (AssetRef + 409 AssetInUseResponse)
  *
  * Add new endpoint modules here as they move to schema-validated contracts.
  */
@@ -29,4 +30,5 @@ export * from './compare.js';
 export * from './publish.js';
 export * from './history.js';
 export * from './fetch.js';
+export * from './assets.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/admin-api/schemas/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/admin-api/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/admin-api/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA"}

package/dist/admin-api/schemas/index.js

@@ -15,6 +15,7 @@
  *   - POST /api/publish + /api/publish/stream (result + SSE progress union)
  *   - GET  /api/history + POST /api/history/{undo,restore} (revisions + restore)
  *   - POST /api/fetch (cross-target copy)
+ *   - DELETE /api/assets/:name (AssetRef + 409 AssetInUseResponse)
  *
  * Add new endpoint modules here as they move to schema-validated contracts.
  */
@@ -29,4 +30,5 @@ export * from './compare.js';
 export * from './publish.js';
 export * from './history.js';
 export * from './fetch.js';
+export * from './assets.js';
 //# sourceMappingURL=index.js.map

package/dist/admin-api/schemas/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/admin-api/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/admin-api/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA"}

package/dist/admin-api/source-context.d.ts

@@ -11,7 +11,6 @@
 import type { StorageProvider, SiteManifest } from '../types.js';
 import { type ContentRoot } from '../content-root.js';
 import { type Site, type LoadSiteOptions } from '../site-loader.js';
-import type { SourceSidecarWriter } from '../source-sidecars.js';
 import type { TargetRegistry } from '../targets.js';
 import type { HistoryProvider } from '../history.js';
 export interface SourceContext {
@@ -34,8 +33,6 @@ export interface SourceContext {
     readonly projectSiteDir: string;
     /** Content root (storage + rooting prefix paired for path construction). */
     readonly contentRoot: ContentRoot;
-    /** Optional sidecar writer for write-through hash/dependency tracking. */
-    readonly sidecarWriter?: SourceSidecarWriter;
     /**
      * Name of the target this source resolves to, when known. Set by the
      * registry resolver; undefined for the legacy static resolver (which has
@@ -70,7 +67,6 @@ export interface CreateSourceContextOptions {
     siteDir: string;
     /** Absolute project site directory. Defaults to `siteDir` for backward compat. */
     projectSiteDir?: string;
-    sidecarWriter?: SourceSidecarWriter;
     history?: HistoryProvider;
     /** Project-level site manifest — passed to loadSite so targets don't need site.yaml. */
     manifest?: SiteManifest;
@@ -99,7 +95,6 @@ export interface SourceContextFromRegistryOptions {
      * This is independent of the target's storage rooting.
      */
     projectSiteDir: string;
-    sidecarWriter?: SourceSidecarWriter;
     /** See BuildHistory — callable decides per-target history provider. */
     buildHistory?: BuildHistory;
     /** Project-level site manifest. */
@@ -133,8 +128,6 @@ export interface RegistrySourceResolverOptions {
     registry: TargetRegistry;
     /** Required — absolute project site directory for the returned context. */
     projectSiteDir: string;
-    /** Optional sidecar writer attached to every resolved context. */
-    sidecarWriter?: SourceSidecarWriter;
     /**
      * Siteprefix to apply to the target's storage. Typically `''` since
      * registry-sourced storage is already target-rooted.

package/dist/admin-api/source-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"source-context.d.ts","sourceRoot":"","sources":["../../src/admin-api/source-context.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"source-context.d.ts","sourceRoot":"","sources":["../../src/admin-api/source-context.ts"],"names":[],"mappings":"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"}

package/dist/admin-api/source-context.js

@@ -23,7 +23,6 @@ export function createSourceContext(opts) {
         siteDir: opts.siteDir,
         projectSiteDir: opts.projectSiteDir ?? opts.siteDir,
         contentRoot: createContentRoot(opts.storage, opts.siteDir),
-        sidecarWriter: opts.sidecarWriter,
         history: opts.history,
         manifest: opts.manifest,
     };
@@ -41,7 +40,6 @@ export function createSourceContextFromRegistry(opts) {
             storage,
             siteDir: opts.siteDir ?? '',
             projectSiteDir: opts.projectSiteDir,
-            sidecarWriter: opts.sidecarWriter,
             history: opts.buildHistory?.(name, storage),
             manifest: opts.manifest,
         }),
@@ -85,7 +83,6 @@ export function registrySourceResolver(opts) {
             projectSiteDir: opts.projectSiteDir,
             buildHistory: opts.buildHistory,
             siteDir: opts.siteDir,
-            sidecarWriter: opts.sidecarWriter,
             manifest: opts.manifest,
         });
         cache.set(name, ctx);

package/dist/admin-api/source-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"source-context.js","sourceRoot":"","sources":["../../src/admin-api/source-context.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"source-context.js","sourceRoot":"","sources":["../../src/admin-api/source-context.ts"],"names":[],"mappings":"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"}

package/dist/assets/analyze-audio.d.ts

@@ -0,0 +1,3 @@
+import type { UploadAnalyzer } from './analyze.js';
+export declare const audioAnalyzer: UploadAnalyzer;
+//# sourceMappingURL=analyze-audio.d.ts.map

package/dist/assets/analyze-audio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-audio.d.ts","sourceRoot":"","sources":["../../src/assets/analyze-audio.ts"],"names":[],"mappings":"AA2BA,OAAO,KAAK,EAAiC,cAAc,EAAE,MAAM,cAAc,CAAA;AAoBjF,eAAO,MAAM,aAAa,EAAE,cAuC3B,CAAA"}

package/dist/assets/analyze-audio.js

@@ -0,0 +1,80 @@
+/**
+ * Audio analyzer — extracts duration via the `music-metadata` library.
+ *
+ * Single responsibility: read audio bytes, return manifest enrichment
+ * (`duration` in milliseconds; null when the format technically
+ * supports duration but the value couldn't be derived from headers).
+ *
+ * Design notes (per design-media.md):
+ *   - Personal-metadata stripping is documented as the default for
+ *     audio, with opt-in preservation. The analyzer reads metadata
+ *     non-destructively here; stripping is a *byte-transform* concern
+ *     (preprocessor surface, not analyzer). Wiring an
+ *     `audioMetadataPreprocessor` is a v1.5 follow-up — the analyzer
+ *     reading duration doesn't preclude future stripping.
+ *   - No supplementary files in v1. Future waveform-image extraction
+ *     would slot in here (`supplementaryFiles: [{ path: ...waveform.svg }]`).
+ *   - Format-specific MIME match: MP3, WAV, FLAC, Opus, AAC, M4A, OGG.
+ *     `music-metadata` v11+ handles all of these natively.
+ *
+ * SOLID lenses:
+ *   - SRP: this module owns "audio bytes → duration"
+ *   - OCP: adding waveform extraction = same module gains a
+ *     supplementary-file output; no other module changes
+ *   - LSP: honors the `UploadAnalyzer` contract — match + analyze
+ *   - ISP / DIP: ingest depends on `runAnalyzers`, not on this module
+ */
+import { parseBuffer } from 'music-metadata';
+/**
+ * MIMEs the audio analyzer matches. Mirrors the v1 audio allowlist
+ * documented in design-media.md. Adding a new audio MIME here +
+ * `ALLOWED_MIMES` admits it; no other code changes.
+ */
+const AUDIO_MIMES = new Set([
+    'audio/mpeg', // MP3
+    'audio/wav',
+    'audio/x-wav',
+    'audio/flac',
+    'audio/x-flac',
+    'audio/ogg',
+    'audio/opus',
+    'audio/aac',
+    'audio/mp4', // M4A
+    'audio/x-m4a',
+]);
+export const audioAnalyzer = {
+    name: 'audio',
+    matches(mime) {
+        return !!mime && AUDIO_MIMES.has(mime);
+    },
+    async analyze(input) {
+        let durationSec;
+        try {
+            // music-metadata accepts a Buffer or Uint8Array; we already have
+            // the bytes from the preprocess pass.
+            const meta = await parseBuffer(input.bytes, { mimeType: input.mime, size: input.bytes.byteLength }, {
+                skipPostHeaders: true,
+            });
+            durationSec = typeof meta.format.duration === 'number' ? meta.format.duration : undefined;
+        }
+        catch {
+            // Malformed audio header — bail out with no enrichment. The
+            // upload still succeeds (the user's bytes are valid as far as
+            // MIME sniffing was concerned); we just couldn't extract a
+            // duration. A future stricter mode could throw here.
+            return {};
+        }
+        if (durationSec === undefined) {
+            // Format supports duration in principle but we couldn't extract.
+            // null distinguishes "not applicable" (static image, document)
+            // from "applicable but unknown" (corrupt header, streaming OGG
+            // without a length).
+            return { manifestPatch: { duration: null } };
+        }
+        // music-metadata returns seconds; manifest stores milliseconds
+        // (matching animated-image duration units, where sharp returns ms).
+        const durationMs = Math.round(durationSec * 1000);
+        return { manifestPatch: { duration: durationMs } };
+    },
+};
+//# sourceMappingURL=analyze-audio.js.map

package/dist/assets/analyze-audio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-audio.js","sourceRoot":"","sources":["../../src/assets/analyze-audio.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAG5C;;;;GAIG;AACH,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC;IAC1B,YAAY,EAAE,MAAM;IACpB,WAAW;IACX,aAAa;IACb,YAAY;IACZ,cAAc;IACd,WAAW;IACX,YAAY;IACZ,WAAW;IACX,WAAW,EAAE,MAAM;IACnB,aAAa;CACd,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,aAAa,GAAmB;IAC3C,IAAI,EAAE,OAAO;IACb,OAAO,CAAC,IAAI;QACV,OAAO,CAAC,CAAC,IAAI,IAAI,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IACxC,CAAC;IACD,KAAK,CAAC,OAAO,CAAC,KAAoB;QAChC,IAAI,WAA+B,CAAA;QACnC,IAAI,CAAC;YACH,iEAAiE;YACjE,sCAAsC;YACtC,MAAM,IAAI,GAAG,MAAM,WAAW,CAC5B,KAAK,CAAC,KAAK,EACX,EAAE,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,EACtD;gBACE,eAAe,EAAE,IAAI;aACtB,CACF,CAAA;YACD,WAAW,GAAG,OAAO,IAAI,CAAC,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAA;QAC3F,CAAC;QAAC,MAAM,CAAC;YACP,4DAA4D;YAC5D,8DAA8D;YAC9D,2DAA2D;YAC3D,qDAAqD;YACrD,OAAO,EAAE,CAAA;QACX,CAAC;QAED,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,iEAAiE;YACjE,+DAA+D;YAC/D,+DAA+D;YAC/D,qBAAqB;YACrB,OAAO,EAAE,aAAa,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,CAAA;QAC9C,CAAC;QAED,+DAA+D;QAC/D,oEAAoE;QACpE,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,CAAA;QACjD,OAAO,EAAE,aAAa,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,CAAA;IACpD,CAAC;CACF,CAAA"}

package/dist/assets/analyze-image.d.ts

@@ -0,0 +1,19 @@
+import type { UploadAnalyzer } from './analyze.js';
+/**
+ * Static-image analyzer — width + height. Runs for any `image/*`
+ * MIME except SVG (which has its own dimension path; libvips
+ * sometimes mis-reports vector content).
+ */
+export declare const staticImageAnalyzer: UploadAnalyzer;
+/**
+ * Animated-image analyzer — `pages > 1` detection, frame count,
+ * duration sum, and first-frame poster extraction.
+ *
+ * Per design-media.md: animated images render as `<img>` in v1
+ * (no `<video>` transcoding — that requires ffmpeg). The poster
+ * is provided so future UI layers (lazy-load, video-style poster
+ * fallback) can use it; v1 templates can also render the poster
+ * for reduced-motion preferences.
+ */
+export declare const animatedImageAnalyzer: UploadAnalyzer;
+//# sourceMappingURL=analyze-image.d.ts.map

package/dist/assets/analyze-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-image.d.ts","sourceRoot":"","sources":["../../src/assets/analyze-image.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAiC,cAAc,EAAE,MAAM,cAAc,CAAA;AASjF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,cAkBjC,CAAA;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,qBAAqB,EAAE,cA4DnC,CAAA"}

package/dist/assets/analyze-image.js

@@ -0,0 +1,123 @@
+/**
+ * Image analyzers — read final bytes, contribute manifest fields
+ * (and a poster file for animated content). Two analyzers behind
+ * the abstraction:
+ *
+ *   - `staticImageAnalyzer` — extracts width + height for any image
+ *     MIME. Always runs. Animated images also produce dimensions
+ *     (the canvas size); they get the same width/height treatment.
+ *   - `animatedImageAnalyzer` — runs for formats that can carry
+ *     animation (GIF, APNG, animated WebP, animated AVIF). Reads
+ *     `pages` + `delay[]` from sharp's metadata, sets
+ *     `animated/frames/duration`, extracts the first frame as a
+ *     poster PNG.
+ *
+ * Both analyzers are sharp-backed. SVG bypasses (no analyzer matches
+ * `image/svg+xml`) — sharp can metadata SVG via libvips, but the
+ * sanitizer-modified bytes are what we want characterized, and the
+ * existing inline `extractImageDimensions` already handles SVG dims
+ * correctly inside ingest. Kept separate for now; SVG could move into
+ * an analyzer when the dimension-extraction call site changes.
+ */
+import sharp from 'sharp';
+const ANIMATED_MIMES = new Set([
+    'image/gif',
+    'image/png', // APNG; sharp surfaces pages > 1 when animated
+    'image/webp', // animated WebP
+    'image/avif', // animated AVIF
+]);
+/**
+ * Static-image analyzer — width + height. Runs for any `image/*`
+ * MIME except SVG (which has its own dimension path; libvips
+ * sometimes mis-reports vector content).
+ */
+export const staticImageAnalyzer = {
+    name: 'static-image',
+    matches(mime) {
+        return !!mime && mime.startsWith('image/') && mime !== 'image/svg+xml';
+    },
+    async analyze(input) {
+        try {
+            const meta = await sharp(input.bytes).metadata();
+            const width = typeof meta.width === 'number' ? meta.width : null;
+            const height = typeof meta.height === 'number' ? meta.height : null;
+            return { manifestPatch: { width, height } };
+        }
+        catch {
+            // sharp couldn't decode — return null dims so downstream code
+            // doesn't break. This isn't a hard error: a bad image will fail
+            // variant generation later with a more specific message.
+            return { manifestPatch: { width: null, height: null } };
+        }
+    },
+};
+/**
+ * Animated-image analyzer — `pages > 1` detection, frame count,
+ * duration sum, and first-frame poster extraction.
+ *
+ * Per design-media.md: animated images render as `<img>` in v1
+ * (no `<video>` transcoding — that requires ffmpeg). The poster
+ * is provided so future UI layers (lazy-load, video-style poster
+ * fallback) can use it; v1 templates can also render the poster
+ * for reduced-motion preferences.
+ */
+export const animatedImageAnalyzer = {
+    name: 'animated-image',
+    matches(mime) {
+        return !!mime && ANIMATED_MIMES.has(mime);
+    },
+    async analyze(input) {
+        let pages;
+        let delays;
+        try {
+            const meta = await sharp(input.bytes).metadata();
+            pages = typeof meta.pages === 'number' ? meta.pages : undefined;
+            // sharp returns delay as `number[]` per frame in milliseconds when
+            // animated (some encoders use 0 for "use default" — tolerate).
+            delays = Array.isArray(meta.delay) ? meta.delay : undefined;
+        }
+        catch {
+            // sharp couldn't decode — bail out. Static-image analyzer will
+            // also fail and we'll fall through with no manifest patch.
+            return {};
+        }
+        // Static (single-frame) — nothing to contribute. The static
+        // analyzer already sets width/height; this analyzer skips when
+        // there's no animation to describe.
+        if (!pages || pages <= 1)
+            return {};
+        // Animated. Compute total duration (sum of frame delays).
+        const duration = delays ? delays.reduce((sum, d) => sum + d, 0) : null;
+        const frames = pages;
+        // Extract first frame as a PNG poster. PNG keeps alpha lossless;
+        // for solid-frame GIFs the size penalty over JPEG is worth the
+        // simplicity (no quality knob to tune at this layer).
+        let posterBytes;
+        try {
+            const buf = await sharp(input.bytes, { page: 0 }).png().toBuffer();
+            posterBytes = new Uint8Array(buf);
+        }
+        catch {
+            // Poster extraction failed — return manifest fields without
+            // poster. Better partial enrichment than zero enrichment.
+            return {
+                manifestPatch: { animated: true, frames, duration, poster: null },
+            };
+        }
+        // Path is content-addressed alongside the source asset:
+        // {name}-{hash}-poster.png. Same-pattern as the variant ladder so
+        // delete/rename/path-enumeration logic finds them via filename
+        // glob without special-casing.
+        const posterPath = `${input.assetName}-${input.hash}-poster.png`;
+        return {
+            manifestPatch: {
+                animated: true,
+                frames,
+                duration,
+                poster: posterPath,
+            },
+            supplementaryFiles: [{ path: posterPath, bytes: posterBytes }],
+        };
+    },
+};
+//# sourceMappingURL=analyze-image.js.map

package/dist/assets/analyze-image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-image.js","sourceRoot":"","sources":["../../src/assets/analyze-image.ts"],"names":[],"mappings":"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"}

package/dist/assets/analyze.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Manifest fields an analyzer is allowed to set. Subset of
+ * `AssetManifest` — analyzers can't change identity (`name`, `kind`,
+ * `source`, `mime`, `hash`, `size`) or audit (`uploadedAt`,
+ * `uploadedBy`). They contribute *characterization* fields:
+ * dimensions, animation flags, duration, poster URL, focal point if
+ * extractable from EXIF, etc.
+ *
+ * Listed explicitly (rather than `Partial<AssetManifest>`) so the
+ * type system catches an analyzer that tries to override identity
+ * fields by accident.
+ */
+export interface ManifestEnrichment {
+    /** Width in pixels — null for non-image formats. */
+    width?: number | null;
+    /** Height in pixels — null for non-image formats. */
+    height?: number | null;
+    /** Multi-frame indicator (GIF, APNG, animated WebP/AVIF). */
+    animated?: boolean;
+    /** Frame count for animated content (≥ 1). */
+    frames?: number;
+    /** Duration in milliseconds — animated images, video, audio. */
+    duration?: number | null;
+    /** Relative path to the poster bytes (under assetsRoot). */
+    poster?: string | null;
+}
+/**
+ * A supplementary file the analyzer wants written alongside the
+ * primary asset bytes (and in the manifest's enrichment, where
+ * relevant via `poster`/etc. paths). The runner adds these to the
+ * write plan so they participate in atomic-rollback.
+ */
+export interface SupplementaryFile {
+    /** Path relative to `assetsRoot` — e.g. `hero-{hash}-poster.png`. */
+    path: string;
+    /** Bytes to write. */
+    bytes: Uint8Array;
+}
+export interface AnalysisResult {
+    /**
+     * Fields to merge into the manifest. The runner validates that no
+     * forbidden field is set; analyzers that try to set identity
+     * fields are rejected at the type level (the interface excludes
+     * them).
+     */
+    manifestPatch?: ManifestEnrichment;
+    /** Supplementary byte files to write. */
+    supplementaryFiles?: readonly SupplementaryFile[];
+}
+/**
+ * One format's analysis contract. Implementations are async (sharp
+ * I/O is async) but otherwise pure — no storage access, no manifest
+ * writing, no logging. The runner orchestrates side effects.
+ *
+ * `assetName` and `hash` are passed in so analyzers that produce
+ * supplementary files can name them deterministically (e.g.
+ * `{name}-{hash}-poster.png`).
+ */
+export interface UploadAnalyzer {
+    /** Stable identifier for diagnostics (`'animated-image'`, `'audio'`). */
+    readonly name: string;
+    /** Whether this analyzer applies to the given MIME. */
+    matches(mime: string | null): boolean;
+    /**
+     * Read the bytes; return manifest enrichment + supplementary files.
+     * Throw on malformed input — runner wraps in a typed error.
+     */
+    analyze(input: AnalyzerInput): Promise<AnalysisResult>;
+}
+export interface AnalyzerInput {
+    /** Final, post-preprocess bytes. */
+    bytes: Uint8Array;
+    /** Asset name (canonical, no extension). For supplementary file paths. */
+    assetName: string;
+    /** Asset hash. For supplementary file paths. */
+    hash: string;
+    /** Source extension (`jpg`, `png`, `gif`, ...). For format-specific decisions. */
+    ext: string;
+    /** Sniffed MIME — analyzers don't need to re-sniff. */
+    mime: string;
+}
+export declare const defaultAnalyzers: readonly UploadAnalyzer[];
+/**
+ * Run the matching analyzer(s) for the given MIME. Returns the
+ * merged enrichment + flattened supplementary files. Pass-through
+ * (no enrichment, no extras) when no analyzer matches.
+ *
+ * Multiple analyzers matching the same MIME is allowed — results
+ * are merged (later wins on field conflicts; supplementary files
+ * concatenate). v1 exercises this for animated images: both static
+ * and animated analyzers run.
+ */
+export declare function runAnalyzers(input: AnalyzerInput, analyzers?: readonly UploadAnalyzer[]): Promise<AnalysisResult>;
+//# sourceMappingURL=analyze.d.ts.map

package/dist/assets/analyze.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.d.ts","sourceRoot":"","sources":["../../src/assets/analyze.ts"],"names":[],"mappings":"AA0CA;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,kBAAkB;IACjC,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACtB,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACvB;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,qEAAqE;IACrE,IAAI,EAAE,MAAM,CAAA;IACZ,sBAAsB;IACtB,KAAK,EAAE,UAAU,CAAA;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,aAAa,CAAC,EAAE,kBAAkB,CAAA;IAClC,yCAAyC;IACzC,kBAAkB,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAA;CAClD;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,cAAc;IAC7B,yEAAyE;IACzE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,uDAAuD;IACvD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAA;IACrC;;;OAGG;IACH,OAAO,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;CACvD;AAED,MAAM,WAAW,aAAa;IAC5B,oCAAoC;IACpC,KAAK,EAAE,UAAU,CAAA;IACjB,0EAA0E;IAC1E,SAAS,EAAE,MAAM,CAAA;IACjB,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAA;IACZ,kFAAkF;IAClF,GAAG,EAAE,MAAM,CAAA;IACX,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAA;CACb;AAiBD,eAAO,MAAM,gBAAgB,EAAE,SAAS,cAAc,EAAgE,CAAA;AAEtH;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAChC,KAAK,EAAE,aAAa,EACpB,SAAS,GAAE,SAAS,cAAc,EAAqB,GACtD,OAAO,CAAC,cAAc,CAAC,CAmBzB"}

package/dist/assets/analyze.js

@@ -0,0 +1,45 @@
+/**
+ * Default analyzer registry — what ingest uses out of the box.
+ * Order matters when more than one matches; analyzer results
+ * later in the list win on field conflicts. Today's order:
+ *   1. `staticImageAnalyzer` — width/height for all images except SVG
+ *   2. `animatedImageAnalyzer` — multi-frame detection + poster
+ *   3. `audioAnalyzer` — duration via music-metadata
+ *
+ * Both image analyzers run for animated images (static contributes
+ * canvas dimensions, animated contributes animation flags + poster).
+ * Audio MIMEs trigger only the audio analyzer.
+ */
+import { animatedImageAnalyzer, staticImageAnalyzer } from './analyze-image.js';
+import { audioAnalyzer } from './analyze-audio.js';
+export const defaultAnalyzers = [staticImageAnalyzer, animatedImageAnalyzer, audioAnalyzer];
+/**
+ * Run the matching analyzer(s) for the given MIME. Returns the
+ * merged enrichment + flattened supplementary files. Pass-through
+ * (no enrichment, no extras) when no analyzer matches.
+ *
+ * Multiple analyzers matching the same MIME is allowed — results
+ * are merged (later wins on field conflicts; supplementary files
+ * concatenate). v1 exercises this for animated images: both static
+ * and animated analyzers run.
+ */
+export async function runAnalyzers(input, analyzers = defaultAnalyzers) {
+    let manifestPatch;
+    const supplementaryFiles = [];
+    for (const analyzer of analyzers) {
+        if (!analyzer.matches(input.mime))
+            continue;
+        const result = await analyzer.analyze(input);
+        if (result.manifestPatch) {
+            manifestPatch = { ...manifestPatch, ...result.manifestPatch };
+        }
+        if (result.supplementaryFiles) {
+            supplementaryFiles.push(...result.supplementaryFiles);
+        }
+    }
+    return {
+        manifestPatch,
+        supplementaryFiles: supplementaryFiles.length > 0 ? supplementaryFiles : undefined,
+    };
+}
+//# sourceMappingURL=analyze.js.map

package/dist/assets/analyze.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze.js","sourceRoot":"","sources":["../../src/assets/analyze.ts"],"names":[],"mappings":"AAgIA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAC/E,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAElD,MAAM,CAAC,MAAM,gBAAgB,GAA8B,CAAC,mBAAmB,EAAE,qBAAqB,EAAE,aAAa,CAAC,CAAA;AAEtH;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAAoB,EACpB,YAAuC,gBAAgB;IAEvD,IAAI,aAA6C,CAAA;IACjD,MAAM,kBAAkB,GAAwB,EAAE,CAAA;IAElD,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,SAAQ;QAC3C,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;QAC5C,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;YACzB,aAAa,GAAG,EAAE,GAAG,aAAa,EAAE,GAAG,MAAM,CAAC,aAAa,EAAE,CAAA;QAC/D,CAAC;QACD,IAAI,MAAM,CAAC,kBAAkB,EAAE,CAAC;YAC9B,kBAAkB,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAA;QACvD,CAAC;IACH,CAAC;IAED,OAAO;QACL,aAAa;QACb,kBAAkB,EAAE,kBAAkB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,SAAS;KACnF,CAAA;AACH,CAAC"}

package/dist/assets/asset-deps.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Asset-refs binding for the generic dep-sidecars module.
+ *
+ * Asset-side conveniences over the generic API:
+ *   - `ASSET_REFS` constant fixes the dep-sidecar relation kind for
+ *     callers (so they don't need to know "the asset-refs root is named
+ *     `asset-refs`").
+ *   - `itemRefToAssetRef` reconstructs an `AssetRef` (the schema/types
+ *     shape used in 409 delete-blocking responses) from the sidecar's
+ *     `ItemRef`. Sidecars don't carry `componentPath`; we synthesize
+ *     null and let callers re-read manifests for breadcrumb display.
+ */
+import type { ContentRoot } from '../content-root.js';
+import { type DepRelation, type ItemRef, type ManifestLike } from '../dep-sidecars.js';
+import type { AssetRef } from './refs.js';
+/** The asset-refs relation: extract `_asset` references from a manifest. */
+export declare const ASSET_REFS: DepRelation;
+/** Convert an `ItemRef` to the `AssetRef` shape used by delete.ts and 409 responses. */
+export declare function itemRefToAssetRef(item: ItemRef): AssetRef;
+/** Read every item that references this asset. Thin wrapper around `readDepsFor`. */
+export declare function readRefsForAsset(contentRoot: ContentRoot, assetName: string): Promise<ItemRef[]>;
+/**
+ * Apply asset-refs diff for one item's manifest change. Thin wrapper
+ * around `rebuildItemDeps` with the asset-refs relation pre-bound.
+ */
+export declare function rebuildAssetRefs(contentRoot: ContentRoot, item: ItemRef, oldManifest: ManifestLike | null, newManifest: ManifestLike | null): Promise<void>;
+/** Apply a pre-computed diff (used in tests + cases where caller has the sets already). */
+export declare function applyAssetRefsDiff(contentRoot: ContentRoot, item: ItemRef, oldAssets: ReadonlySet<string>, newAssets: ReadonlySet<string>): Promise<void>;
+export { applyDepDiff, filenameToItemRef, itemRefToFilename, type DepRelation, type ItemRef, } from '../dep-sidecars.js';
+//# sourceMappingURL=asset-deps.d.ts.map

package/dist/assets/asset-deps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-deps.d.ts","sourceRoot":"","sources":["../../src/assets/asset-deps.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,EACL,KAAK,WAAW,EAChB,KAAK,OAAO,EACZ,KAAK,YAAY,EAIlB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAGzC,4EAA4E;AAC5E,eAAO,MAAM,UAAU,EAAE,WAKxB,CAAA;AAED,wFAAwF;AACxF,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,CAYzD;AAED,qFAAqF;AACrF,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAEhG;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,WAAW,EACxB,IAAI,EAAE,OAAO,EACb,WAAW,EAAE,YAAY,GAAG,IAAI,EAChC,WAAW,EAAE,YAAY,GAAG,IAAI,GAC/B,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,2FAA2F;AAC3F,wBAAgB,kBAAkB,CAChC,WAAW,EAAE,WAAW,EACxB,IAAI,EAAE,OAAO,EACb,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,EAC9B,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC,GAC7B,OAAO,CAAC,IAAI,CAAC,CAEf;AAID,OAAO,EACL,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,OAAO,GACb,MAAM,oBAAoB,CAAA"}