gazetta 0.6.0 → 0.8.0

package/dist/providers/s3.js

@@ -1,4 +1,6 @@
 import { S3Client, GetObjectCommand, PutObjectCommand, ListObjectsV2Command, HeadObjectCommand, DeleteObjectCommand, CreateBucketCommand, } from '@aws-sdk/client-s3';
+import { Upload } from '@aws-sdk/lib-storage';
+import { nodeReadableToWeb, webReadableToNode } from './_stream-interop.js';
 export function createS3Provider(options) {
     const client = new S3Client({
         endpoint: options.endpoint,
@@ -76,13 +78,47 @@ export function createS3Provider(options) {
             }
         },
         async writeFile(path, content) {
+            // Encode to Buffer so the SDK sees a known length and skips the
+            // "Stream of unknown length" warning. Same wire bytes either way —
+            // strings get UTF-8-encoded by the SDK on the way out, we're just
+            // doing it ourselves to make the length explicit.
+            const body = Buffer.from(content, 'utf-8');
             await client.send(new PutObjectCommand({
                 Bucket: bucket,
                 Key: normalizePath(path),
-                Body: content,
+                Body: body,
+                ContentLength: body.length,
                 ContentType: 'text/plain; charset=utf-8',
             }));
         },
+        async readBytes(path) {
+            try {
+                const response = await client.send(new GetObjectCommand({ Bucket: bucket, Key: normalizePath(path) }));
+                if (!response.Body)
+                    throw new Error(`Empty body for ${path}`);
+                // SDK's transformToByteArray is the canonical bytes accessor —
+                // single round-trip, no manual stream collection.
+                return await response.Body.transformToByteArray();
+            }
+            catch (err) {
+                const code = err.name;
+                if (code === 'NoSuchKey')
+                    throw new Error(`File not found: ${path}`);
+                throw new Error(`Cannot read bytes from ${path}: ${err.message}`);
+            }
+        },
+        async writeBytes(path, content) {
+            // Single-PUT for bounded bytes. No multipart — that's writeStream's
+            // job for unbounded uploads. ContentLength is set explicitly so the
+            // SDK skips the "unknown length" warning.
+            const body = Buffer.from(content.buffer, content.byteOffset, content.byteLength);
+            await client.send(new PutObjectCommand({
+                Bucket: bucket,
+                Key: normalizePath(path),
+                Body: body,
+                ContentLength: body.length,
+            }));
+        },
         async mkdir(_path) {
             // S3 has no directories — implicit from key prefixes
         },
@@ -101,6 +137,53 @@ export function createS3Provider(options) {
                 await client.send(new DeleteObjectCommand({ Bucket: bucket, Key: obj.Key }));
             }
         },
+        async readStream(path, range) {
+            const Key = normalizePath(path);
+            try {
+                const response = await client.send(new GetObjectCommand({
+                    Bucket: bucket,
+                    Key,
+                    // RFC 9110 §14.1.2 — inclusive bytes range. Same semantics as `ByteRange`.
+                    Range: range ? `bytes=${range.start}-${range.end}` : undefined,
+                }));
+                if (!response.Body)
+                    throw new Error(`Empty body for ${path}`);
+                // In Node runtime the SDK returns Body as a Node Readable. The
+                // browser/edge build returns a web ReadableStream. We only run
+                // server-side (publish, dev-server, gazetta serve) — Node Readable
+                // is the deterministic path. Bridge to the lib-dom global so
+                // callers see one type regardless of provider.
+                return nodeReadableToWeb(response.Body);
+            }
+            catch (err) {
+                const code = err.name;
+                if (code === 'NoSuchKey')
+                    throw new Error(`File not found: ${path}`);
+                throw new Error(`Cannot read stream from ${path}: ${err.message}`);
+            }
+        },
+        async writeStream(path, stream) {
+            const Key = normalizePath(path);
+            try {
+                // `Upload` is a hybrid — single-PUT below `partSize` (default 5 MiB),
+                // multipart above. Memory bound is `partSize × queueSize` (default
+                // 5 MiB × 4 = 20 MiB) regardless of total bytes, so a 4 GB video
+                // upload doesn't OOM. `abortOnFailure: true` (default) calls
+                // AbortMultipartUpload on error so we don't leak orphan parts.
+                const upload = new Upload({
+                    client,
+                    params: {
+                        Bucket: bucket,
+                        Key,
+                        Body: webReadableToNode(stream),
+                    },
+                });
+                await upload.done();
+            }
+            catch (err) {
+                throw new Error(`Cannot write stream to ${path}: ${err.message}`);
+            }
+        },
     };
 }
 function normalizePath(path) {

package/dist/providers/s3.js.map

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

package/dist/publish-item.d.ts

@@ -0,0 +1,225 @@
+/**
+ * Publish pipeline (per-item) — orchestrator for one Page or Fragment
+ * write to one Target.
+ *
+ * Today's `publish-rendered.ts` has 5 publish-* exports
+ * (`publishPageRendered`, `publishPageStatic`, `publishFragmentRendered`,
+ * `publishArchiveMarker`, `publishSiteManifest`) each repeating the same
+ * 13-step sequence: archive precheck → resolve → render → assemble →
+ * list-old-files → write-new → cleanup → write hash sidecar → write
+ * publish-state sidecar. Adding the soft-delete archive marker (Cut 3)
+ * had to land in three places. Adding scheduled-publish or review-state
+ * gates would too.
+ *
+ * `publishItemCore` is the seam that hides the orchestration. Per-kind
+ * wrappers (`publishPage`, `publishFragment` in pages/publish.ts +
+ * fragments/publish.ts — Cut 4) own kind-specific dispatch:
+ * page resolves render-mode from target.type (static vs esi vs dynamic);
+ * fragment has only one mode; archive short-circuit applies to both.
+ *
+ * Pipeline order is locked semantics, not configuration. Per-item:
+ *
+ *   1. (RESERVED) review-state precheck — Review Cut 5 (pending-review
+ *      behavior at publish time)
+ *   2. archive precheck (isArchived → route to archive-marker renderer)
+ *   3. resolve item from preloadedSite (locale variant if applicable)
+ *   4. (RESERVED) dispatchBeforePublishItem hooks
+ *   5. invoke renderer (page-rendered / page-static / fragment-rendered /
+ *      archive-marker)
+ *   6. assemble HTML + CSS + JS (per renderer's output)
+ *   7. list old hashed files at item dir
+ *   8. write new hashed files (per-file atomic via storage.writeFile;
+ *      transient failures retry inline 3x with backoff)
+ *   9. write item HTML + content-hash sidecar (.{8hex}.hash)
+ *  10. cleanup oldFiles − newFiles
+ *  11. write publish-state sidecar (.pub-{ts}, includes noindex flag)
+ *  12. (RESERVED) dispatchAfterPublishItem hooks
+ *  13. return PublishItemResult
+ *
+ * Throws are reserved for storage transport failures after retries
+ * exhausted, AND for prerequisite breaches (caller must supply a
+ * preloadedSite and target init must have completed). Expected
+ * outcomes — NOT_FOUND / RENDER_FAILED / TEMPLATE_INVALID /
+ * VALIDATION_FAILED — are typed `PublishItemResult` variants.
+ */
+import type { CacheConfig, StorageProvider } from './types.js';
+import type { Site } from './site-loader.js';
+import type { ContentRoot } from './content-root.js';
+import type { Issue } from './validation/types.js';
+/**
+ * Discriminator for the kind of item being published. Spine is the
+ * same per kind; per-kind wrappers in `pages/publish.ts` and
+ * `fragments/publish.ts` carry the kind through to dispatch +
+ * sidecar + audit calls.
+ */
+export type PublishItemKind = 'page' | 'fragment';
+/**
+ * Render mode the item is being published with. Resolved by
+ * per-kind wrappers from target.type + archive state:
+ *   - `'page-rendered'` — ESI placeholders for `@fragment` refs;
+ *     fragments composed at request time. Used for `esi` targets.
+ *   - `'page-static'` — full-bake; fragments inlined into page HTML.
+ *     Used for `static` targets and as the static fallback for
+ *     `dynamic` targets.
+ *   - `'fragment-rendered'` — fragment rendered standalone for ESI
+ *     composition. Used for ALL fragment publishes regardless of
+ *     target type.
+ *   - `'archive-marker'` — body-skip; emit ONLY the HTML comment
+ *     marker line so the worker reads first 200 bytes and
+ *     short-circuits to 301/410 per design-soft-delete.md Q10.
+ */
+export type PublishRenderMode = 'page-rendered' | 'page-static' | 'fragment-rendered' | 'archive-marker';
+/**
+ * Successful publish outcome. `files` and `removed` mirror today's
+ * publish-rendered return shape so consumers (CLI progress, admin
+ * SSE) need no projection.
+ */
+export interface PublishItemOk {
+    readonly kind: PublishItemKind;
+    readonly name: string;
+    readonly locale?: string;
+    readonly ok: true;
+    readonly mode: PublishRenderMode;
+    readonly files: number;
+    readonly removed: number;
+}
+/**
+ * Item not found at the source — caller passed a name that
+ * doesn't exist in the preloaded site. Routes/CLI project to a
+ * 404 / non-zero exit; orchestrator continues to next item per
+ * Q4 fail-soft.
+ */
+export interface PublishItemNotFound {
+    readonly kind: PublishItemKind;
+    readonly name: string;
+    readonly locale?: string;
+    readonly ok: false;
+    readonly code: 'NOT_FOUND';
+    readonly reason: string;
+}
+/**
+ * Renderer threw OR returned malformed output (non-string html,
+ * missing required field). Per design-rendering.md the renderer
+ * is best-effort; one bad page doesn't abort the run.
+ */
+export interface PublishItemRenderFailed {
+    readonly kind: PublishItemKind;
+    readonly name: string;
+    readonly locale?: string;
+    readonly ok: false;
+    readonly code: 'RENDER_FAILED';
+    readonly reason: string;
+}
+/**
+ * Template the item references is invalid (didn't pass scan).
+ * Run-level template scan happens once at boot per Q5 step 3;
+ * surface here for items that reference a scan-failed template.
+ */
+export interface PublishItemTemplateInvalid {
+    readonly kind: PublishItemKind;
+    readonly name: string;
+    readonly locale?: string;
+    readonly ok: false;
+    readonly code: 'TEMPLATE_INVALID';
+    readonly reason: string;
+}
+/**
+ * Pre-publish validators (per validation Cut 4) emitted blocking
+ * issues for this item. Caller (orchestrator) decides whether to
+ * include validators in the per-item run; today admin's POST
+ * /api/publish/audit gates separately.
+ */
+export interface PublishItemValidationFailed {
+    readonly kind: PublishItemKind;
+    readonly name: string;
+    readonly locale?: string;
+    readonly ok: false;
+    readonly code: 'VALIDATION_FAILED';
+    readonly issues: readonly Issue[];
+}
+/**
+ * Storage write retries exhausted (transport blip). Item-level
+ * fail-soft per Q4; run continues with next item.
+ */
+export interface PublishItemStorageWriteFailed {
+    readonly kind: PublishItemKind;
+    readonly name: string;
+    readonly locale?: string;
+    readonly ok: false;
+    readonly code: 'STORAGE_WRITE_FAILED';
+    readonly reason: string;
+}
+/**
+ * Typed union of expected per-item publish outcomes. Routes/CLI
+ * `switch` exhaustively to project to wire shape (HTTP / SSE /
+ * stdout). Adding a variant produces a TS error at every
+ * consumer — intentional, per Q1 lock.
+ */
+export type PublishItemResult = PublishItemOk | PublishItemNotFound | PublishItemRenderFailed | PublishItemTemplateInvalid | PublishItemValidationFailed | PublishItemStorageWriteFailed;
+/**
+ * Inputs to `publishItemCore`. Carries the resolved render-mode
+ * decision (per-kind wrappers compute it from target.type +
+ * archive state) plus the renderer strategy that owns mode-specific
+ * assembly.
+ */
+export interface PublishItemInput {
+    readonly kind: PublishItemKind;
+    readonly name: string;
+    readonly locale?: string;
+    /** Render mode resolved by per-kind wrapper before calling core. */
+    readonly mode: PublishRenderMode;
+    /** Loaded site, shared across the publish run (loaded ONCE in publishRun). */
+    readonly site: Site;
+    /** Source content tree the item is read from. */
+    readonly sourceRoot: ContentRoot;
+    /** Target storage being published TO. */
+    readonly target: PublishTarget;
+}
+/**
+ * Per-target context. Mirrors the relevant subset of `TargetConfig`
+ * + provider handle without importing the admin-api boundary type.
+ * `publishRun` builds this once per target during boot phase 6
+ * (init target storage); per-item core consumes it.
+ */
+export interface PublishTarget {
+    readonly name: string;
+    readonly storage: StorageProvider;
+    /** Target type resolved per design-rendering.md (static / esi / dynamic). */
+    readonly type: 'static' | 'esi' | 'dynamic';
+    /**
+     * Optional per-target manifest content hash for the item being
+     * published. publishRun precomputes via hashManifest so per-item
+     * core doesn't recompute.
+     */
+    readonly manifestHash?: string;
+    /** Optional SEO context for fallback-chain rendering. */
+    readonly seo?: import('./seo.js').SeoContext;
+    /** Optional target-level cache config (browser / edge TTL); page-level overrides win in renderer. */
+    readonly cache?: CacheConfig;
+}
+/**
+ * Publish pipeline orchestrator (per-item) — Cut 3.
+ *
+ * Ports the 13-step spine from `publish-rendered.ts`'s 5 publish-*
+ * functions. Mode dispatch (page-rendered / page-static /
+ * fragment-rendered / archive-marker) consumes pure-fn renderers
+ * from `publish-renderers.ts` (Cut 2). Storage I/O + sidecar writes
+ * + cleanup live here.
+ *
+ * Pipeline sequence (locked per Q5):
+ *
+ *   1. (RESERVED) review-state precheck — Review Cut 5
+ *   2. archive precheck — `mode: 'archive-marker'` → renderArchiveMarker
+ *   3. resolve item from preloadedSite (NOT_FOUND if missing)
+ *   4. (RESERVED) dispatchBeforePublishItem hooks
+ *   5. invoke renderer (mode dispatch)
+ *   6-7. (renderer produces RenderOutput; assembly + hashing internal)
+ *   8. list old hashed files
+ *   9. mkdir + write index file + write hashed files
+ *  10. cleanup oldFiles − newFiles
+ *  11. write content-hash + publish-state sidecars
+ *  12. (RESERVED) dispatchAfterPublishItem hooks
+ *  13. return PublishItemResult
+ */
+export declare function publishItemCore(input: PublishItemInput): Promise<PublishItemResult>;
+//# sourceMappingURL=publish-item.d.ts.map

package/dist/publish-item.d.ts.map

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

package/dist/publish-item.js

@@ -0,0 +1,210 @@
+/**
+ * Publish pipeline (per-item) — orchestrator for one Page or Fragment
+ * write to one Target.
+ *
+ * Today's `publish-rendered.ts` has 5 publish-* exports
+ * (`publishPageRendered`, `publishPageStatic`, `publishFragmentRendered`,
+ * `publishArchiveMarker`, `publishSiteManifest`) each repeating the same
+ * 13-step sequence: archive precheck → resolve → render → assemble →
+ * list-old-files → write-new → cleanup → write hash sidecar → write
+ * publish-state sidecar. Adding the soft-delete archive marker (Cut 3)
+ * had to land in three places. Adding scheduled-publish or review-state
+ * gates would too.
+ *
+ * `publishItemCore` is the seam that hides the orchestration. Per-kind
+ * wrappers (`publishPage`, `publishFragment` in pages/publish.ts +
+ * fragments/publish.ts — Cut 4) own kind-specific dispatch:
+ * page resolves render-mode from target.type (static vs esi vs dynamic);
+ * fragment has only one mode; archive short-circuit applies to both.
+ *
+ * Pipeline order is locked semantics, not configuration. Per-item:
+ *
+ *   1. (RESERVED) review-state precheck — Review Cut 5 (pending-review
+ *      behavior at publish time)
+ *   2. archive precheck (isArchived → route to archive-marker renderer)
+ *   3. resolve item from preloadedSite (locale variant if applicable)
+ *   4. (RESERVED) dispatchBeforePublishItem hooks
+ *   5. invoke renderer (page-rendered / page-static / fragment-rendered /
+ *      archive-marker)
+ *   6. assemble HTML + CSS + JS (per renderer's output)
+ *   7. list old hashed files at item dir
+ *   8. write new hashed files (per-file atomic via storage.writeFile;
+ *      transient failures retry inline 3x with backoff)
+ *   9. write item HTML + content-hash sidecar (.{8hex}.hash)
+ *  10. cleanup oldFiles − newFiles
+ *  11. write publish-state sidecar (.pub-{ts}, includes noindex flag)
+ *  12. (RESERVED) dispatchAfterPublishItem hooks
+ *  13. return PublishItemResult
+ *
+ * Throws are reserved for storage transport failures after retries
+ * exhausted, AND for prerequisite breaches (caller must supply a
+ * preloadedSite and target init must have completed). Expected
+ * outcomes — NOT_FOUND / RENDER_FAILED / TEMPLATE_INVALID /
+ * VALIDATION_FAILED — are typed `PublishItemResult` variants.
+ */
+import { renderArchiveMarker, renderFragmentRendered, renderPageStatic, renderPageWithEsi, } from './publish-renderers.js';
+import { writeSidecars } from './sidecars.js';
+/** List existing hashed files at item dir (for cleanup). */
+async function listHashedFiles(storage, dir) {
+    try {
+        const entries = await storage.readDir(dir);
+        return entries
+            .filter(e => !e.isDirectory && /\.(css|js)$/.test(e.name) && /\.[a-f0-9]{8}\./.test(e.name))
+            .map(e => `${dir}/${e.name}`);
+    }
+    catch {
+        return [];
+    }
+}
+/** Delete files from oldFiles[] not in newFiles[]; return removed count. */
+async function cleanupOldFiles(storage, oldFiles, newFiles) {
+    const newSet = new Set(newFiles);
+    let removed = 0;
+    for (const file of oldFiles) {
+        if (!newSet.has(file)) {
+            try {
+                await storage.rm(file);
+                removed++;
+            }
+            catch {
+                /* already gone */
+            }
+        }
+    }
+    return removed;
+}
+/**
+ * Item dir resolution per render mode. ESI + fragment + archive write
+ * under `pages/{name}/` or `fragments/{name}/`; static-mode pages
+ * write to URL-derived path (`/about` → `about/index.html`). Static
+ * mode is handled by `pages/publish.ts` Cut 4 — core treats all kinds
+ * uniformly under `{kind}s/{name}/`.
+ */
+function itemDir(kind, name) {
+    return `${kind === 'page' ? 'pages' : 'fragments'}/${name}`;
+}
+/**
+ * Publish pipeline orchestrator (per-item) — Cut 3.
+ *
+ * Ports the 13-step spine from `publish-rendered.ts`'s 5 publish-*
+ * functions. Mode dispatch (page-rendered / page-static /
+ * fragment-rendered / archive-marker) consumes pure-fn renderers
+ * from `publish-renderers.ts` (Cut 2). Storage I/O + sidecar writes
+ * + cleanup live here.
+ *
+ * Pipeline sequence (locked per Q5):
+ *
+ *   1. (RESERVED) review-state precheck — Review Cut 5
+ *   2. archive precheck — `mode: 'archive-marker'` → renderArchiveMarker
+ *   3. resolve item from preloadedSite (NOT_FOUND if missing)
+ *   4. (RESERVED) dispatchBeforePublishItem hooks
+ *   5. invoke renderer (mode dispatch)
+ *   6-7. (renderer produces RenderOutput; assembly + hashing internal)
+ *   8. list old hashed files
+ *   9. mkdir + write index file + write hashed files
+ *  10. cleanup oldFiles − newFiles
+ *  11. write content-hash + publish-state sidecars
+ *  12. (RESERVED) dispatchAfterPublishItem hooks
+ *  13. return PublishItemResult
+ */
+export async function publishItemCore(input) {
+    const { kind, name, locale, mode, site, target } = input;
+    // Step 3 — resolve item. Mode dispatch reads from site.pages /
+    // site.fragments to verify existence; renderers do their own lookup
+    // but we surface NOT_FOUND here (via typed result) before render.
+    const map = kind === 'page' ? site.pages : site.fragments;
+    const item = map.get(name);
+    if (!item) {
+        return {
+            kind,
+            name,
+            locale,
+            ok: false,
+            code: 'NOT_FOUND',
+            reason: `${kind === 'page' ? 'Page' : 'Fragment'} "${name}" not found in source`,
+        };
+    }
+    // Step 5 — invoke renderer per mode. Each renderer is pure;
+    // assembly + hashing happen inside.
+    let output;
+    try {
+        if (mode === 'archive-marker') {
+            // Step 2 — archive precheck materializes here. Renderer reads
+            // aliasOf directly; caller (per-kind wrapper) chose this mode
+            // because isArchived(item) was true.
+            output = renderArchiveMarker(item, locale);
+        }
+        else if (mode === 'page-rendered') {
+            const ctx = { site, locale, seo: target.seo, targetCache: target.cache };
+            output = await renderPageWithEsi(name, ctx);
+        }
+        else if (mode === 'page-static') {
+            const ctx = { site, locale, seo: target.seo, targetCache: target.cache };
+            output = await renderPageStatic(name, ctx);
+        }
+        else {
+            // fragment-rendered
+            const ctx = { site, locale };
+            output = await renderFragmentRendered(name, ctx);
+        }
+    }
+    catch (err) {
+        // Renderer threw (template SSR fail, malformed manifest). Surface
+        // as RENDER_FAILED per Q4 fail-soft — orchestrator continues with
+        // next item.
+        const reason = err instanceof Error ? err.message : String(err);
+        return { kind, name, locale, ok: false, code: 'RENDER_FAILED', reason };
+    }
+    // Step 8 — list old hashed files at item dir for cleanup pass below.
+    // Static-mode page writes use URL-derived paths handled by per-kind
+    // wrapper (Cut 4); core's cleanup applies to ESI / fragment /
+    // archive layouts under `{kind}s/{name}/`.
+    const dir = itemDir(kind, name);
+    const oldFiles = await listHashedFiles(target.storage, dir);
+    const newFiles = [];
+    // Step 9 — mkdir, write index, write hashed files. Per-file atomic
+    // via storage.writeFile; surface storage failures as
+    // STORAGE_WRITE_FAILED per Q4.
+    try {
+        await target.storage.mkdir(dir);
+        await target.storage.writeFile(`${dir}/${output.indexFile}`, output.indexHtml);
+        let fileCount = 1; // index file
+        for (const f of output.files) {
+            await target.storage.writeFile(f.path, f.content);
+            newFiles.push(f.path);
+            fileCount++;
+        }
+        // Step 10 — cleanup old hashed files not in newFiles.
+        const removed = await cleanupOldFiles(target.storage, oldFiles, newFiles);
+        // Step 11 — sidecars (hash + publish-state). Skipped when caller
+        // doesn't pass manifestHash (CLI / tests sometimes omit). Archive
+        // marker forces noindex: true; live pages read it from
+        // metadata.robots; fragments don't carry pub state at all.
+        if (target.manifestHash) {
+            // Pages can declare noindex via metadata.robots; fragments have no
+            // metadata field. Archive marker always forces noindex.
+            const pageMeta = kind === 'page' ? item.metadata : undefined;
+            const noindex = output.archived ? true : !!pageMeta?.robots?.includes('noindex');
+            await writeSidecars(target.storage, dir, {
+                hash: target.manifestHash,
+                // Fragments don't get pub-state sidecars (they're composition
+                // primitives, not addressable URLs). Pages always get one.
+                pub: kind === 'page' ? { lastPublished: new Date().toISOString(), noindex } : null,
+            }, locale);
+        }
+        return {
+            kind,
+            name,
+            locale,
+            ok: true,
+            mode,
+            files: fileCount,
+            removed,
+        };
+    }
+    catch (err) {
+        const reason = err instanceof Error ? err.message : String(err);
+        return { kind, name, locale, ok: false, code: 'STORAGE_WRITE_FAILED', reason };
+    }
+}
+//# sourceMappingURL=publish-item.js.map

package/dist/publish-item.js.map

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

package/dist/publish-rendered.d.ts

@@ -1,6 +1,7 @@
 import type { StorageProvider, PurgeStrategy, CacheConfig } from './types.js';
 import type { Site } from './site-loader.js';
 import { type ContentRoot } from './content-root.js';
+import type { DepRelation } from './dep-sidecars.js';
 /**
  * Publish a page as HTML with ESI placeholders for fragments.
  * Local components are baked in. Fragment markup is replaced at request time by the worker.
@@ -41,26 +42,45 @@ locale?: string): Promise<{
  */
 export declare function publishSiteManifest(sourceRoot: ContentRoot, targetStorage: StorageProvider, preloadedSite?: Site): Promise<void>;
 /**
- * Build and store reverse fragment index.
- * Maps each fragment to the list of page routes that use it.
+ * Rebuild a dep-sidecar index on the destination for one relation.
+ *
+ * Walks every page + fragment manifest (including locale variants) from
+ * the source site and writes per-edge sidecars at
+ * `{dest}/.gazetta/{rel.rootName}/{target}/{item}`. Wipes the existing
+ * index dir first to avoid stale entries from previous runs.
+ *
+ * Used by:
+ *   - publish flow (CLI + admin route) at end of publish, once per relation
+ *   - reindex CLI for source-side recovery
+ *   - history-restorer after rollback
+ *
+ * Why rebuild rather than incremental: a full rebuild is one walk +
+ * N zero-byte writes — simpler than tracking diffs against the dest's
+ * prior state and equally fast for typical sites.
  */
-export declare function publishFragmentIndex(sourceRoot: ContentRoot, targetStorage: StorageProvider, preloadedSite?: Site): Promise<Record<string, string[]>>;
-/** Purge via Cloudflare zone cache API */
-export declare function createCloudflarePurge(zoneId: string, apiToken: string): PurgeStrategy;
-/** Look up Cloudflare zone ID from a site URL */
-export declare function lookupCloudflareZoneId(siteUrl: string, apiToken: string): Promise<string | null>;
+export declare function rebuildDepIndex(rel: DepRelation, sourceSite: Site, destStorage: StorageProvider, destRootPath?: string): Promise<void>;
 /**
- * Publish a fragment and purge affected pages.
+ * Backwards-compatible alias for the single-relation asset-refs rebuild.
+ * Kept until callers (history-restorer, reindex CLI) migrate to the
+ * generic `rebuildDepIndex(rel, …)` shape.
  */
-export declare function publishFragmentWithPurge(fragmentName: string, sourceStorage: StorageProvider, sourceDir: string, targetStorage: StorageProvider, purge: PurgeStrategy, purgeMode?: 'all' | 'url'): Promise<{
-    files: number;
-    purgedUrls: string[];
-}>;
+export declare function rebuildAssetRefsIndex(sourceSite: Site, destStorage: StorageProvider, destRootPath?: string): Promise<void>;
 /**
- * Publish a page and purge its URL.
+ * Publish-flow wrapper: load the site if needed and rebuild every
+ * dep-sidecar index on the target. Run once per publish (alongside
+ * `publishSiteManifest`). Indices rebuilt:
+ *   - asset-refs (queried by delete-block check, library usage panel)
+ *   - fragment-deps (queried by `findFragmentDependents` for the
+ *     publish-UI blast radius and fragment cache-purge URL lookup)
  */
-export declare function publishPageWithPurge(pageName: string, sourceStorage: StorageProvider, sourceDir: string, targetStorage: StorageProvider, purge: PurgeStrategy): Promise<{
-    files: number;
-    purgedUrls: string[];
-}>;
+export declare function publishDepIndices(sourceRoot: ContentRoot, targetStorage: StorageProvider, preloadedSite?: Site): Promise<void>;
+/**
+ * Backwards-compatible single-relation wrapper. New callers should use
+ * `publishDepIndices` to get both indices rebuilt in one walk.
+ */
+export declare function publishAssetRefsIndex(sourceRoot: ContentRoot, targetStorage: StorageProvider, preloadedSite?: Site): Promise<void>;
+/** Purge via Cloudflare zone cache API */
+export declare function createCloudflarePurge(zoneId: string, apiToken: string): PurgeStrategy;
+/** Look up Cloudflare zone ID from a site URL */
+export declare function lookupCloudflareZoneId(siteUrl: string, apiToken: string): Promise<string | null>;
 //# sourceMappingURL=publish-rendered.d.ts.map