gazetta 0.6.0 → 0.7.0

package/dist/assets/publish-plan.js

@@ -0,0 +1,49 @@
+import { manifestPath } from './manifest.js';
+import { collectAssetRefs } from './scan-manifest-for-asset.js';
+/**
+ * Compute the set of assets to publish given the items being published,
+ * after running the source-existence pre-flight check.
+ *
+ * Empty refs short-circuit to `ok: true` with no assets — sites without
+ * media still publish fine.
+ */
+export async function planAssetCopy(input) {
+    const { refs, itemsWithRefs } = await collectRefsAcrossItems(input);
+    if (refs.size === 0)
+        return { ok: true, assets: [], itemsWithRefs: [] };
+    const missing = [];
+    for (const name of refs) {
+        const exists = await input.sourceRoot.storage.exists(input.sourceRoot.path('assets', manifestPath(name)));
+        if (!exists)
+            missing.push(name);
+    }
+    if (missing.length > 0) {
+        return { ok: false, reason: 'missing-on-source', missing };
+    }
+    return { ok: true, assets: [...refs], itemsWithRefs };
+}
+async function collectRefsAcrossItems(input) {
+    const refs = new Set();
+    const itemsWithRefs = [];
+    for (const item of input.itemNames) {
+        const path = input.sourceRoot.path(item, manifestFilenameFor(item));
+        const raw = await input.sourceRoot.storage.readFile(path).catch(() => null);
+        if (raw === null)
+            continue;
+        // Page/fragment manifests have the same `Walkable` shape that
+        // `collectAssetRefs` accepts; cast here rather than parse-and-validate
+        // since the planner's job is ref discovery, not manifest validation.
+        const manifest = JSON.parse(raw);
+        const itemRefs = collectAssetRefs(manifest);
+        if (itemRefs.size === 0)
+            continue;
+        itemsWithRefs.push(item);
+        for (const name of itemRefs)
+            refs.add(name);
+    }
+    return { refs, itemsWithRefs };
+}
+function manifestFilenameFor(itemName) {
+    return itemName.startsWith('fragments/') ? 'fragment.json' : 'page.json';
+}
+//# sourceMappingURL=publish-plan.js.map

package/dist/assets/publish-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish-plan.js","sourceRoot":"","sources":["../../src/assets/publish-plan.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAe/D;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,KAAgB;IAClD,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,MAAM,sBAAsB,CAAC,KAAK,CAAC,CAAA;IAEnE,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,CAAA;IAEvE,MAAM,OAAO,GAAa,EAAE,CAAA;IAC5B,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACzG,IAAI,CAAC,MAAM;YAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACjC,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,mBAAmB,EAAE,OAAO,EAAE,CAAA;IAC5D,CAAC;IAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,GAAG,IAAI,CAAC,EAAE,aAAa,EAAE,CAAA;AACvD,CAAC;AAOD,KAAK,UAAU,sBAAsB,CAAC,KAAgB;IACpD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAC9B,MAAM,aAAa,GAAa,EAAE,CAAA;IAClC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAA;QACnE,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAA;QAC3E,IAAI,GAAG,KAAK,IAAI;YAAE,SAAQ;QAC1B,8DAA8D;QAC9D,uEAAuE;QACvE,qEAAqE;QACrE,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA2C,CAAA;QAC1E,MAAM,QAAQ,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAA;QAC3C,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC;YAAE,SAAQ;QACjC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACxB,KAAK,MAAM,IAAI,IAAI,QAAQ;YAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAC7C,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,CAAA;AAChC,CAAC;AAED,SAAS,mBAAmB,CAAC,QAAgB;IAC3C,OAAO,QAAQ,CAAC,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,WAAW,CAAA;AAC1E,CAAC"}

package/dist/assets/publish.d.ts

@@ -0,0 +1,33 @@
+import type { ContentRoot } from '../content-root.js';
+export interface PublishAssetsInput {
+    /** Source content root (assets live at `sourceRoot.path('assets')`). */
+    readonly sourceRoot: ContentRoot;
+    /** Target content root (assets land at `targetRoot.path('assets')`). */
+    readonly targetRoot: ContentRoot;
+    /** Items being published — e.g., `['pages/home', 'fragments/header']`. */
+    readonly itemNames: readonly string[];
+}
+export type PublishAssetsResult = {
+    readonly ok: true;
+    readonly copiedAssets: number;
+    readonly copiedFiles: number;
+} | {
+    readonly ok: false;
+    readonly reason: 'missing-on-source';
+    readonly missing: readonly string[];
+};
+/**
+ * Copy every asset referenced by `itemNames` from source to target.
+ *
+ * Returns a discriminated-union result. On the failure variant, no
+ * writes have happened — validation is complete before any copy starts.
+ *
+ * Asset copies run in bounded parallel — assets are independent (no
+ * cross-asset shared state) and each one's stream-bridge spends most of
+ * its time waiting on cloud I/O. Sequential copy serializes those waits;
+ * parallel copy lets them overlap. Concurrency is bounded by `mapLimit`'s
+ * default to avoid running out of file handles or saturating the SDK's
+ * connection pool.
+ */
+export declare function publishAssets(input: PublishAssetsInput): Promise<PublishAssetsResult>;
+//# sourceMappingURL=publish.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"publish.d.ts","sourceRoot":"","sources":["../../src/assets/publish.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAMrD,MAAM,WAAW,kBAAkB;IACjC,wEAAwE;IACxE,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAA;IAChC,wEAAwE;IACxE,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAA;IAChC,0EAA0E;IAC1E,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAA;CACtC;AAED,MAAM,MAAM,mBAAmB,GAC3B;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAClF;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAA;AAErG;;;;;;;;;;;;GAYG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAoB3F"}

package/dist/assets/publish.js

@@ -0,0 +1,81 @@
+/**
+ * Publish assets — copy referenced assets from a source target's storage
+ * to a destination target's storage during publish.
+ *
+ * This module is the orchestrator: it asks `publish-plan.ts` what to copy
+ * (and stops on a structured failure), then performs the actual byte
+ * moves. The two concerns split because validation must complete before
+ * any bytes are written — so a missing-on-source asset never produces a
+ * half-copied target — and the executor wants nothing to do with the
+ * walk that produced the asset list.
+ *
+ * Dedupe is a runtime check on the destination, not a planner output:
+ * the planner can't know whether an asset is *already on target* without
+ * the same `exists()` call we'd make at copy time, so checking once at
+ * the copy site is cheaper.
+ */
+import { mapLimit } from '../concurrency.js';
+import { assetBytePaths, assetStoragePaths } from './asset-paths.js';
+import { readManifest, writeManifest } from './manifest.js';
+import { planAssetCopy } from './publish-plan.js';
+/**
+ * Copy every asset referenced by `itemNames` from source to target.
+ *
+ * Returns a discriminated-union result. On the failure variant, no
+ * writes have happened — validation is complete before any copy starts.
+ *
+ * Asset copies run in bounded parallel — assets are independent (no
+ * cross-asset shared state) and each one's stream-bridge spends most of
+ * its time waiting on cloud I/O. Sequential copy serializes those waits;
+ * parallel copy lets them overlap. Concurrency is bounded by `mapLimit`'s
+ * default to avoid running out of file handles or saturating the SDK's
+ * connection pool.
+ */
+export async function publishAssets(input) {
+    const plan = await planAssetCopy(input);
+    if (!plan.ok)
+        return plan;
+    if (plan.assets.length === 0)
+        return { ok: true, copiedAssets: 0, copiedFiles: 0 };
+    const ctx = {
+        source: input.sourceRoot.storage,
+        target: input.targetRoot.storage,
+        sourceAssets: input.sourceRoot.path('assets'),
+        targetAssets: input.targetRoot.path('assets'),
+    };
+    const perAsset = await mapLimit(plan.assets, name => copyOneAsset(ctx, name));
+    let copiedAssets = 0;
+    let copiedFiles = 0;
+    for (const r of perAsset) {
+        if (r.copied)
+            copiedAssets++;
+        copiedFiles += r.files;
+    }
+    return { ok: true, copiedAssets, copiedFiles };
+}
+async function copyOneAsset(ctx, name) {
+    const sourceManifest = await readManifest(ctx.source, ctx.sourceAssets, name);
+    const sourcePaths = assetStoragePaths(ctx.sourceAssets, sourceManifest);
+    const targetPaths = assetStoragePaths(ctx.targetAssets, sourceManifest);
+    // Content-addressed dedupe: the hash is in the bytes path, so its
+    // presence on the target proves byte-equivalence. Skip the whole
+    // asset (manifest + bytes + variants).
+    if (await ctx.target.exists(targetPaths.defaultBytes))
+        return { copied: false, files: 0 };
+    await writeManifest(ctx.target, ctx.targetAssets, sourceManifest);
+    let files = 1;
+    // Copy every byte path (default + per-override) preserving structure.
+    // `assetBytePaths` returns default bytes/variants first, then each
+    // override's bytes/variants — both source and target produce the same
+    // ordered list because they're built from the same manifest, so we
+    // can iterate in lockstep.
+    const sourceBytePaths = assetBytePaths(sourcePaths);
+    const targetBytePaths = assetBytePaths(targetPaths);
+    for (let i = 0; i < sourceBytePaths.length; i++) {
+        const stream = await ctx.source.readStream(sourceBytePaths[i]);
+        await ctx.target.writeStream(targetBytePaths[i], stream);
+        files++;
+    }
+    return { copied: true, files };
+}
+//# sourceMappingURL=publish.js.map

package/dist/assets/publish.js.map

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

package/dist/assets/refs.d.ts

@@ -0,0 +1,37 @@
+/**
+ * `AssetRef` — a single reference record emitted by the ref scanner.
+ *
+ * Domain concept (where content references an asset), not transport
+ * concept (how it moves over HTTP). Lives in the asset domain because:
+ *
+ * - The ref scanner produces these
+ * - The delete orchestrator consumes them (to decide refuse vs remove)
+ * - A future usage panel will consume them (same shape, different UI)
+ *
+ * Zod schema + inferred type in one place — single source of truth. The
+ * admin-api's transport schemas import this and wrap it in HTTP-shaped
+ * envelopes (e.g. `AssetInUseResponse`); the admin client's types derive
+ * from those envelopes. No hand-written parallel interface anywhere.
+ */
+import { z } from 'zod';
+/**
+ * Where a ref was found. Stable across pages and fragments so any
+ * consumer (usage panel, delete dialog, CLI report) renders uniformly.
+ *
+ * - `path` is the content-root-relative manifest path
+ *   (e.g. `"pages/home/page.json"`).
+ * - `componentPath` is a dotted breadcrumb into the manifest's content
+ *   tree (`"hero"`, `"banner.image"`, `"gallery[0].photo"`), or `null`
+ *   when the ref sits at the manifest's top-level content. `null` means
+ *   "the manifest root" — no sentinel string to compare against.
+ */
+export declare const AssetRefSchema: z.ZodObject<{
+    source: z.ZodEnum<{
+        page: "page";
+        fragment: "fragment";
+    }>;
+    path: z.ZodString;
+    componentPath: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type AssetRef = z.infer<typeof AssetRefSchema>;
+//# sourceMappingURL=refs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"refs.d.ts","sourceRoot":"","sources":["../../src/assets/refs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;;;;;;GAUG;AACH,eAAO,MAAM,cAAc;;;;;;;iBAIzB,CAAA;AAEF,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA"}

package/dist/assets/refs.js

@@ -0,0 +1,33 @@
+/**
+ * `AssetRef` — a single reference record emitted by the ref scanner.
+ *
+ * Domain concept (where content references an asset), not transport
+ * concept (how it moves over HTTP). Lives in the asset domain because:
+ *
+ * - The ref scanner produces these
+ * - The delete orchestrator consumes them (to decide refuse vs remove)
+ * - A future usage panel will consume them (same shape, different UI)
+ *
+ * Zod schema + inferred type in one place — single source of truth. The
+ * admin-api's transport schemas import this and wrap it in HTTP-shaped
+ * envelopes (e.g. `AssetInUseResponse`); the admin client's types derive
+ * from those envelopes. No hand-written parallel interface anywhere.
+ */
+import { z } from 'zod';
+/**
+ * Where a ref was found. Stable across pages and fragments so any
+ * consumer (usage panel, delete dialog, CLI report) renders uniformly.
+ *
+ * - `path` is the content-root-relative manifest path
+ *   (e.g. `"pages/home/page.json"`).
+ * - `componentPath` is a dotted breadcrumb into the manifest's content
+ *   tree (`"hero"`, `"banner.image"`, `"gallery[0].photo"`), or `null`
+ *   when the ref sits at the manifest's top-level content. `null` means
+ *   "the manifest root" — no sentinel string to compare against.
+ */
+export const AssetRefSchema = z.object({
+    source: z.enum(['page', 'fragment']),
+    path: z.string(),
+    componentPath: z.string().nullable(),
+});
+//# sourceMappingURL=refs.js.map

package/dist/assets/refs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refs.js","sourceRoot":"","sources":["../../src/assets/refs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACpC,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACrC,CAAC,CAAA"}

package/dist/assets/remove-override.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Remove a single locale/theme override from an asset.
+ *
+ * Author-facing semantics (design-media.md → "Remove French bytes
+ * override"):
+ *   "Always allowed; locale bytes overrides don't own refs independently.
+ *    Effect: deletes locale bytes + variants + manifest. The locale
+ *    falls back to default bytes — no broken refs, no code changes in
+ *    referring pages."
+ *
+ * Single responsibility: delete the override slice cleanly. Owns:
+ *   - resolve the override slice from `enumerateAssetStoragePaths`
+ *   - rm the slice's manifest + bytes + variants in safe order
+ *   - record one history revision
+ *
+ * Does NOT own: HTTP, default-asset operations, ref scanning (overrides
+ * carry no refs of their own).
+ */
+import type { ContentRoot } from '../content-root.js';
+import type { HistoryProvider } from '../history.js';
+import { type Selector } from '../schema/dimensions.js';
+import type { StorageProvider } from '../types.js';
+export interface RemoveOverrideInput {
+    storage: StorageProvider;
+    assetsRoot: string;
+    /** Path prefix for site content (used for content-root construction). */
+    siteDir: string;
+    assetName: string;
+    /** Selector identifying which override to remove. Must be non-null. */
+    selector: Selector;
+    history?: HistoryProvider;
+    author?: string;
+    contentRoot?: ContentRoot;
+}
+/**
+ * Remove the override slice identified by `selector`. Throws:
+ *   - `AssetManifestNotFoundError` — the asset doesn't exist OR the
+ *     specific override doesn't exist on this asset
+ *   - `AssetStorageError` — underlying rm failed
+ */
+export declare function removeOverride(input: RemoveOverrideInput): Promise<void>;
+//# sourceMappingURL=remove-override.d.ts.map

package/dist/assets/remove-override.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-override.d.ts","sourceRoot":"","sources":["../../src/assets/remove-override.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAEpD,OAAO,EAAkC,KAAK,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AACvF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAOlD,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,eAAe,CAAA;IACxB,UAAU,EAAE,MAAM,CAAA;IAClB,yEAAyE;IACzE,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,uEAAuE;IACvE,QAAQ,EAAE,QAAQ,CAAA;IAClB,OAAO,CAAC,EAAE,eAAe,CAAA;IACzB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,WAAW,CAAC,EAAE,WAAW,CAAA;CAC1B;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyC9E"}

package/dist/assets/remove-override.js

@@ -0,0 +1,53 @@
+import { recordWrite } from '../history-recorder.js';
+import { selectorsEqual, selectorSuffix } from '../schema/dimensions.js';
+import { createContentRoot } from '../content-root.js';
+import { rmIgnoreMissing } from '../providers/_rm-ignore-missing.js';
+import { enumerateAssetStoragePaths } from './asset-paths.js';
+import { AssetManifestNotFoundError, AssetStorageError } from './errors.js';
+import { readManifest } from './manifest.js';
+/**
+ * Remove the override slice identified by `selector`. Throws:
+ *   - `AssetManifestNotFoundError` — the asset doesn't exist OR the
+ *     specific override doesn't exist on this asset
+ *   - `AssetStorageError` — underlying rm failed
+ */
+export async function removeOverride(input) {
+    const defaultManifest = await readManifest(input.storage, input.assetsRoot, input.assetName);
+    const paths = await enumerateAssetStoragePaths(input.storage, input.assetsRoot, defaultManifest);
+    const slice = paths.overrides.find(s => selectorsEqual(s.selector, input.selector));
+    if (!slice) {
+        // Reuse the existing 404 — the override is, from the API's view,
+        // a separate addressable resource that doesn't exist.
+        throw new AssetManifestNotFoundError(`${input.assetName}${selectorSuffix(input.selector)}`);
+    }
+    // Removal-safe order for ONE slice: bytes + variants first, manifest
+    // last. If interrupted mid-rm, an orphan manifest pointing at missing
+    // bytes is the resolver-degrades-gracefully case; the reverse leaves
+    // bytes the resolver can never reach (future GC reclaims).
+    const orderedPaths = [];
+    if (slice.bytes !== null)
+        orderedPaths.push(slice.bytes);
+    orderedPaths.push(...slice.variants);
+    orderedPaths.push(slice.manifest);
+    const contentRoot = input.contentRoot ?? createContentRoot(input.storage, input.siteDir);
+    if (input.history) {
+        const items = orderedPaths.map(path => ({ path, content: null }));
+        await recordWrite({
+            history: input.history,
+            contentRoot,
+            operation: 'save',
+            author: input.author,
+            items,
+            message: `Remove ${input.assetName} override (${selectorSuffix(input.selector).slice(1)})`,
+        });
+    }
+    for (const path of orderedPaths) {
+        try {
+            await rmIgnoreMissing(input.storage, path);
+        }
+        catch (err) {
+            throw new AssetStorageError('delete', path, err);
+        }
+    }
+}
+//# sourceMappingURL=remove-override.js.map

package/dist/assets/remove-override.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-override.js","sourceRoot":"","sources":["../../src/assets/remove-override.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,WAAW,EAAoB,MAAM,wBAAwB,CAAA;AACtE,OAAO,EAAE,cAAc,EAAE,cAAc,EAAiB,MAAM,yBAAyB,CAAA;AAEvF,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAA;AACpE,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAA;AAC7D,OAAO,EAAE,0BAA0B,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAe5C;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,KAA0B;IAC7D,MAAM,eAAe,GAAG,MAAM,YAAY,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,SAAS,CAAC,CAAA;IAE5F,MAAM,KAAK,GAAG,MAAM,0BAA0B,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,UAAU,EAAE,eAAe,CAAC,CAAA;IAChG,MAAM,KAAK,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,QAAQ,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAA;IACnF,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,iEAAiE;QACjE,sDAAsD;QACtD,MAAM,IAAI,0BAA0B,CAAC,GAAG,KAAK,CAAC,SAAS,GAAG,cAAc,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;IAC7F,CAAC;IAED,qEAAqE;IACrE,sEAAsE;IACtE,qEAAqE;IACrE,2DAA2D;IAC3D,MAAM,YAAY,GAAa,EAAE,CAAA;IACjC,IAAI,KAAK,CAAC,KAAK,KAAK,IAAI;QAAE,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IACxD,YAAY,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAA;IACpC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;IAEjC,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,IAAI,iBAAiB,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAA;IAExF,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAClB,MAAM,KAAK,GAAkB,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;QAChF,MAAM,WAAW,CAAC;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,WAAW;YACX,SAAS,EAAE,MAAM;YACjB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,KAAK;YACL,OAAO,EAAE,UAAU,KAAK,CAAC,SAAS,cAAc,cAAc,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG;SAC3F,CAAC,CAAA;IACJ,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,YAAY,EAAE,CAAC;QAChC,IAAI,CAAC;YACH,MAAM,eAAe,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;QAC5C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,IAAI,iBAAiB,CAAC,QAAQ,EAAE,IAAI,EAAE,GAAG,CAAC,CAAA;QAClD,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/assets/rename.d.ts

@@ -0,0 +1,43 @@
+import type { SiteManifest, StorageProvider } from '../types.js';
+import type { ContentRoot } from '../content-root.js';
+import type { HistoryProvider } from '../history.js';
+export interface RenameAssetInput {
+    /** Storage holding both the asset and the content tree. */
+    storage: StorageProvider;
+    /** Path prefix for assets (typically `"assets"`). */
+    assetsRoot: string;
+    /** Path prefix for site content (where `pages/` and `fragments/` live). */
+    siteDir: string;
+    /** Existing asset name. */
+    oldName: string;
+    /** Target name. Must not already exist. */
+    newName: string;
+    /** Project-level manifest passed to `loadSite`. */
+    manifest?: SiteManifest;
+    /** Optional — record one revision covering the whole operation. */
+    history?: HistoryProvider;
+    /** Author identifier passed through to the history revision. */
+    author?: string;
+    /**
+     * Optional content root. When omitted, one is built from `storage`
+     * + `siteDir`. Tests pass an explicit one to share a single root
+     * with other operations.
+     */
+    contentRoot?: ContentRoot;
+}
+export interface RenameAssetResult {
+    /** How many references were rewritten across all manifests. */
+    readonly refsRewritten: number;
+    /** How many distinct manifests were touched. */
+    readonly manifestsRewritten: number;
+}
+/**
+ * Rename `oldName` → `newName`. Throws:
+ *   - `AssetManifestNotFoundError` — old asset missing
+ *   - `AssetNameCollisionError` — new name already taken
+ *   - `AssetMimeUnsupportedError` — old asset's MIME has no extension
+ *     mapping (misconfiguration; thrown during path enumeration)
+ *   - `AssetStorageError` — any underlying read/write/rm failure
+ */
+export declare function renameAsset(input: RenameAssetInput): Promise<RenameAssetResult>;
+//# sourceMappingURL=rename.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rename.d.ts","sourceRoot":"","sources":["../../src/assets/rename.ts"],"names":[],"mappings":"AAkCA,OAAO,KAAK,EAAqB,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AACnF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAapD,MAAM,WAAW,gBAAgB;IAC/B,2DAA2D;IAC3D,OAAO,EAAE,eAAe,CAAA;IACxB,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAA;IAClB,2EAA2E;IAC3E,OAAO,EAAE,MAAM,CAAA;IACf,2BAA2B;IAC3B,OAAO,EAAE,MAAM,CAAA;IACf,2CAA2C;IAC3C,OAAO,EAAE,MAAM,CAAA;IACf,mDAAmD;IACnD,QAAQ,CAAC,EAAE,YAAY,CAAA;IACvB,mEAAmE;IACnE,OAAO,CAAC,EAAE,eAAe,CAAA;IACzB,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf;;;;OAIG;IACH,WAAW,CAAC,EAAE,WAAW,CAAA;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,+DAA+D;IAC/D,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAA;IAC9B,gDAAgD;IAChD,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;CACpC;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAmOrF"}