gazetta 0.6.0 → 0.8.0

package/dist/publish-renderers.js

@@ -0,0 +1,240 @@
+/**
+ * Pure-fn renderers — Cut 2 of publish pipeline extraction.
+ *
+ * Each renderer takes a resolved item + render context and returns
+ * a `RenderOutput` describing what should be written to storage:
+ * the index HTML body, plus zero-or-more hashed files (CSS/JS) that
+ * the spine emits as separate writes.
+ *
+ * Renderers are PURE — no I/O, no side effects. They produce data;
+ * the spine writes it. This separation lets us test each render
+ * mode in isolation (fast unit tests, no storage mocks) and lets
+ * future modes plug in without touching the spine.
+ *
+ * Per Q2 lock: 4 modes, each their own pure fn.
+ *   - `renderPageWithEsi` — page-rendered (ESI placeholders for `@fragment`
+ *     refs; fragments composed at request time by worker)
+ *   - `renderPageStatic` — page-static (full-bake; fragments inlined)
+ *   - `renderFragmentRendered` — fragment-rendered (standalone for ESI
+ *     composition)
+ *   - `renderArchiveMarker` — archive-marker (body-skip; emit ONLY the
+ *     HTML comment marker line)
+ *
+ * Cut 2 introduces these as standalone fns; the existing 5 publish-*
+ * exports in publish-rendered.ts stay and call into them inline.
+ * Cut 3 wires them through `publishItemCore`'s spine; Cut 8 deletes
+ * the publish-rendered.ts orchestration.
+ */
+import { createHash } from 'node:crypto';
+import { isArchived } from './archive-helpers.js';
+import { renderComponent, renderPage } from './renderer.js';
+import { resolveFragment, resolvePage } from './resolver.js';
+import { archiveMarker } from './runtime/archive-marker.js';
+import { escapeAttr, resolveSeoTags } from './seo.js';
+/** 8-char MD5 prefix per the existing `.{8hex}.hash` sidecar convention. */
+function contentHash(content) {
+    return createHash('md5').update(content).digest('hex').slice(0, 8);
+}
+// ─── Page (ESI mode) ────────────────────────────────────────────────────
+/**
+ * Render a page in ESI mode: `@fragment` refs become ESI placeholders
+ * for the worker to compose at request time; inline components are
+ * baked into the page HTML. Used for `esi` targets.
+ *
+ * Pure fn: returns descriptors; caller (spine) writes them.
+ *
+ * Throws if the page is archived — caller must check `isArchived`
+ * first and route to `renderArchiveMarker` instead. Same for
+ * not-found pages (caller resolves from `site.pages.get` and
+ * surfaces NOT_FOUND result).
+ */
+export async function renderPageWithEsi(pageName, ctx) {
+    const page = ctx.site.pages.get(pageName);
+    if (!page)
+        throw new Error(`Page "${pageName}" not found`);
+    if (isArchived(page)) {
+        throw new Error(`Page "${pageName}" is archived; use renderArchiveMarker instead`);
+    }
+    const resolved = await resolvePage(pageName, ctx.site, ctx.locale);
+    // Render each child — fragments become ESI placeholders, local components baked in
+    const bodyParts = [];
+    const localCssParts = [];
+    const localJsParts = [];
+    const localHeadParts = [];
+    const esiHeadTags = [];
+    for (let i = 0; i < resolved.children.length; i++) {
+        const childEntry = page.components[i];
+        const isFragment = typeof childEntry === 'string' && childEntry.startsWith('@');
+        if (isFragment) {
+            const fragName = childEntry.slice(1);
+            const fragFile = ctx.locale ? `index.${ctx.locale}.html` : 'index.html';
+            const fragPath = `fragments/${fragName}/${fragFile}`;
+            esiHeadTags.push(`<!--esi-head:/${fragPath}-->`);
+            bodyParts.push(`<!--esi:/${fragPath}-->`);
+        }
+        else {
+            const rendered = await renderComponent(resolved.children[i]);
+            bodyParts.push(rendered.html);
+            if (rendered.css)
+                localCssParts.push(rendered.css);
+            if (rendered.js)
+                localJsParts.push(rendered.js);
+            if (rendered.head)
+                localHeadParts.push(rendered.head);
+        }
+    }
+    // Render page-level template (layout CSS, head tags)
+    const lang = ctx.seo?.locale || ctx.locale || 'en';
+    const childOutputs = await Promise.all(resolved.children.map(c => renderComponent(c, undefined, lang)));
+    const pageOutput = await resolved.template({ content: resolved.content, children: childOutputs, locale: lang });
+    if (pageOutput.css)
+        localCssParts.unshift(pageOutput.css);
+    if (pageOutput.head)
+        localHeadParts.unshift(pageOutput.head);
+    const pageDir = `pages/${pageName}`;
+    const files = [];
+    // Hashed CSS file
+    const pageCss = localCssParts.join('\n');
+    let pageCssLink = '';
+    if (pageCss) {
+        const hash = contentHash(pageCss);
+        const cssPath = `${pageDir}/styles.${hash}.css`;
+        files.push({ path: cssPath, content: pageCss });
+        pageCssLink = `<link rel="stylesheet" href="/${cssPath}">`;
+    }
+    // Hashed JS file
+    const pageJs = localJsParts.join('\n');
+    let pageJsLink = '';
+    if (pageJs) {
+        const hash = contentHash(pageJs);
+        const jsPath = `${pageDir}/script.${hash}.js`;
+        files.push({ path: jsPath, content: pageJs });
+        pageJsLink = `<script type="module" src="/${jsPath}"></script>`;
+    }
+    // SEO tags (renderer dedupes against template head)
+    const templateHead = localHeadParts.join('\n');
+    const seoHead = resolveSeoTags({
+        metadata: page.metadata,
+        content: page.content,
+        route: page.route,
+        seo: ctx.seo ?? {},
+        templateHead,
+    });
+    const headContent = [
+        `<meta charset="UTF-8">`,
+        `<meta name="viewport" content="width=device-width, initial-scale=1.0">`,
+        seoHead,
+        ...localHeadParts,
+        pageCssLink,
+        ...esiHeadTags,
+        pageJsLink,
+    ]
+        .filter(Boolean)
+        .join('\n  ');
+    const bodyContent = bodyParts.join('\n');
+    // Cache config: page → target → defaults. Comment is read by the
+    // worker on serve to set Cache-Control headers.
+    const browser = page.cache?.browser ?? ctx.targetCache?.browser ?? 0;
+    const edge = page.cache?.edge ?? ctx.targetCache?.edge ?? 86400;
+    const cacheComment = `<!--cache:browser=${browser},edge=${edge}-->\n`;
+    const indexHtml = `${cacheComment}<!DOCTYPE html>
+<html lang="${escapeAttr(lang)}">
+<head>
+  ${headContent}
+</head>
+<body>
+${bodyContent}
+</body>
+</html>`;
+    const indexFile = ctx.locale ? `index.${ctx.locale}.html` : 'index.html';
+    return { indexFile, indexHtml, files, archived: false };
+}
+// ─── Page (static mode) ─────────────────────────────────────────────────
+/**
+ * Render a page in static mode: full-bake; fragments inlined; CSS/JS
+ * inline. Used for `static` targets (no worker).
+ *
+ * Different output layout than ESI mode: writes to URL-derived path
+ * (`/about` → `about/index.html`) rather than `pages/{name}/`. Caller
+ * computes the output path from `page.route` + locale prefix.
+ *
+ * Returns the rendered HTML; spine handles directory layout decision
+ * (caller knows the path conventions for the static-target layout).
+ */
+export async function renderPageStatic(pageName, ctx) {
+    const page = ctx.site.pages.get(pageName);
+    if (!page)
+        throw new Error(`Page "${pageName}" not found`);
+    if (isArchived(page)) {
+        throw new Error(`Page "${pageName}" is archived; use renderArchiveMarker instead`);
+    }
+    const resolved = await resolvePage(pageName, ctx.site, ctx.locale);
+    const indexHtml = await renderPage(resolved, {
+        metadata: page.metadata,
+        route: page.route,
+        seo: ctx.seo,
+    });
+    // Static mode bakes everything inline — no separate hashed CSS/JS files.
+    // The renderPage helper handles that internally.
+    const indexFile = ctx.locale ? `index.${ctx.locale}.html` : 'index.html';
+    return { indexFile, indexHtml, files: [], archived: false };
+}
+// ─── Fragment (rendered) ────────────────────────────────────────────────
+/**
+ * Render a fragment standalone for ESI composition. Output is the
+ * fragment's HTML wrapped in a `<head>` section if CSS/JS exist —
+ * the worker injects head content before `</head>` and body content
+ * at the ESI placeholder.
+ */
+export async function renderFragmentRendered(fragmentName, ctx) {
+    const fragment = ctx.site.fragments.get(fragmentName);
+    if (!fragment)
+        throw new Error(`Fragment "${fragmentName}" not found`);
+    const resolved = await resolveFragment(fragmentName, ctx.site, ctx.locale);
+    const rendered = await renderComponent(resolved);
+    const fragDir = `fragments/${fragmentName}`;
+    const files = [];
+    const headParts = [];
+    if (rendered.css) {
+        const hash = contentHash(rendered.css);
+        const cssPath = `${fragDir}/styles.${hash}.css`;
+        files.push({ path: cssPath, content: rendered.css });
+        headParts.push(`<link rel="stylesheet" href="/${cssPath}">`);
+    }
+    if (rendered.js) {
+        const hash = contentHash(rendered.js);
+        const jsPath = `${fragDir}/script.${hash}.js`;
+        files.push({ path: jsPath, content: rendered.js });
+        headParts.push(`<script type="module" src="/${jsPath}"></script>`);
+    }
+    if (rendered.head) {
+        headParts.push(rendered.head);
+    }
+    const headSection = headParts.length ? `<head>\n${headParts.join('\n')}\n</head>\n` : '';
+    const indexHtml = `${headSection}${rendered.html}`;
+    const indexFile = ctx.locale ? `index.${ctx.locale}.html` : 'index.html';
+    return { indexFile, indexHtml, files, archived: false };
+}
+// ─── Archive marker ─────────────────────────────────────────────────────
+/**
+ * Render the soft-delete archive marker — body-skip, single line.
+ * The worker reads the first 200 bytes, sees the marker, and emits
+ * 301 (alias) or 410 (gone) without composing. Per
+ * design-soft-delete.md Q10.
+ *
+ * Caller checks `isArchived(page)` first; this is the dispatch
+ * target for that branch.
+ */
+export function renderArchiveMarker(page, locale) {
+    // Caller has already checked isArchived (dispatched HERE because of it).
+    // Read aliasOf directly — `aliasTarget()` re-checks archived state and
+    // returns null for non-archived inputs, which would emit gone-form for
+    // every test fixture that doesn't bother synthesizing an archived flag.
+    const target = page.aliasOf ?? null;
+    const indexHtml = target ? archiveMarker({ kind: 'alias', target }) : archiveMarker({ kind: 'gone' });
+    const indexFile = locale ? `index.${locale}.html` : 'index.html';
+    // Archive emits no CSS/JS; spine's cleanup pass removes any stale
+    // hashed files from the prior live publish.
+    return { indexFile, indexHtml, files: [], archived: true };
+}
+//# sourceMappingURL=publish-renderers.js.map

package/dist/publish-renderers.js.map

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

package/dist/publish-run.d.ts

@@ -0,0 +1,223 @@
+/**
+ * Publish pipeline (per-run) — orchestrator for one publish operation
+ * (N items × M targets × locale variants).
+ *
+ * Today admin's POST `/api/publish` and CLI's `runPublish` each inline
+ * the same fan-out: validate → scan templates → loadSite → expand
+ * dependencies → init targets → loop (target × item) → write dep
+ * indices → write site manifest → cache purge → record history →
+ * audit. Two callers, ~1500 lines of duplicated orchestration.
+ *
+ * `publishRun` is the seam both callers route through. Per-item core
+ * (`publishItemCore` in publish-item.ts) handles single-item rendering;
+ * this orchestrator owns cross-item concerns: dependency expansion via
+ * `findDependentsFromSidecars`, shared template-scan, shared loadSite,
+ * per-target init, fan-out fail-soft, progress emission, aggregate
+ * result.
+ *
+ * Pipeline order is locked semantics, not configuration. Per-run:
+ *
+ *   1. validate input (items + targets non-empty, names known)
+ *   2. capability gate per target (publish:non-production /
+ *      publish:production via Principal)
+ *   3. boot: scan + hash templates ONCE
+ *   4. boot: loadSite ONCE per source
+ *   5. expand items via findDependentsFromSidecars (transitive —
+ *      publishing @header pulls dependent pages)
+ *   6. boot: init target storage (registry connect, per-target type
+ *      resolution per design-rendering.md)
+ *   7. (RESERVED) per-target review-publish-approval gate — Review
+ *      Cut 9: targets w/ requiresPublishApproval create request,
+ *      don't deploy
+ *   8. (RESERVED) dispatchBeforePublishRun hooks
+ *   9. for each target: { for each item: per-item pipeline }
+ *  10. for each target: publishDepIndices (asset-refs, fragment-deps,
+ *      archive-aliases sidecars)
+ *  11. for each target: publishSiteManifest (site.json snapshot)
+ *  12. for each target: cache-purge dispatch (cloudflare/configured
+ *      strategy, fire-and-forget)
+ *  13. record history revision per target
+ *  14. (RESERVED) dispatchAfterPublishRun hooks
+ *  15. audit success per (item, target, outcome)
+ *  16. (RESERVED) cascades — Soft-Delete Q6 auto-cancel scheduled
+ *      actions on publish-of-archived
+ *  17. aggregate PublishRunResult, return
+ *
+ * Boot fail-fast (steps 1-6), per-item/per-target fail-soft (Q4 lock).
+ */
+import type { Principal } from './auth/types.js';
+import { type ContentRoot } from './content-root.js';
+import type { HistoryProvider } from './history.js';
+import type { PublishItemKind, PublishItemResult, PublishRenderMode } from './publish-item.js';
+import type { Site } from './site-loader.js';
+import { type TemplateInfo } from './templates-scan.js';
+import type { PurgeStrategy, SiteManifest, StorageProvider } from './types.js';
+/**
+ * Reference to one item being published. Locale undefined =
+ * default locale variant only; locale set = explicit variant
+ * (caller can split a single page name into multiple ItemRefs
+ * for per-locale fan-out).
+ */
+export interface PublishItemRef {
+    readonly kind: PublishItemKind;
+    readonly name: string;
+    readonly locale?: string;
+}
+/**
+ * Per-target outcome. Fan-out fail-soft (Q4): one target's failure
+ * doesn't block others. `failed: true` when target init failed OR
+ * when ALL items for this target failed; otherwise `false` even
+ * when some items failed (per-item failures live in items[]).
+ */
+export interface PublishTargetResult {
+    readonly name: string;
+    readonly failed: boolean;
+    readonly failureReason?: string;
+    /** Files written across this target (sum of item.files). */
+    readonly filesWritten: number;
+    /** Files removed across this target (sum of item.removed). */
+    readonly filesRemoved: number;
+}
+/**
+ * Aggregate result of one publish run. `ok` derived: every item
+ * succeeded AND every target succeeded. Caller (CLI exit code,
+ * admin response status) reads this directly.
+ */
+export interface PublishRunResult {
+    readonly ok: boolean;
+    readonly items: readonly PublishItemResult[];
+    readonly targets: readonly PublishTargetResult[];
+}
+/**
+ * Streaming progress event. Emitted via `onProgress` callback in
+ * input. Admin route forwards to SSE; CLI writes to stdout.
+ */
+export type PublishProgressEvent = {
+    readonly kind: 'run-start';
+    readonly totalItems: number;
+    readonly totalTargets: number;
+} | {
+    readonly kind: 'target-start';
+    readonly target: string;
+} | {
+    readonly kind: 'item-start';
+    readonly item: PublishItemRef;
+    readonly target: string;
+    readonly mode: PublishRenderMode;
+} | {
+    readonly kind: 'item-done';
+    readonly result: PublishItemResult;
+    readonly target: string;
+} | {
+    readonly kind: 'target-done';
+    readonly result: PublishTargetResult;
+} | {
+    readonly kind: 'run-done';
+    readonly result: PublishRunResult;
+};
+/**
+ * Inputs to `publishRun`. Caller assembles items + targets + source
+ * wiring; orchestrator does the rest.
+ */
+export interface PublishRunInput {
+    /**
+     * Items to publish. v1 spine treats this list verbatim — caller
+     * (CLI / admin route) does dependency expansion via
+     * `findDependentsFromSidecars` BEFORE calling. Reserved future:
+     * orchestrator owns expansion when CLI + admin both migrate.
+     */
+    readonly items: readonly PublishItemRef[];
+    /** Target names to publish to (must exist in `targetStorages` + `targetConfigs`). */
+    readonly targets: readonly string[];
+    /**
+     * Loaded site. Caller does `loadSite()` ONCE for the publish run
+     * (loadSite is heavy; orchestrator reuses across all items × targets).
+     */
+    readonly site: Site;
+    /** Source content tree — used by per-item core for sidecar refs. */
+    readonly sourceRoot: ContentRoot;
+    /** Project-level site manifest (drives target type resolution etc.). */
+    readonly siteManifest: SiteManifest;
+    /**
+     * Per-target storage providers (registry-resolved). Caller calls
+     * `createTargetRegistry` and unwraps before passing.
+     */
+    readonly targetStorages: ReadonlyMap<string, StorageProvider>;
+    /**
+     * Per-target manifest hashes for incremental publish. Caller computes
+     * via `hashManifest(item, { templateHashes, fragmentHashes? })`.
+     * Optional — when absent and `templateInfos` is supplied, orchestrator
+     * computes per-item hashes inline (using the canonical hashManifest
+     * with templateHashes from scan + fragmentHashes for static-mode pages).
+     */
+    readonly itemHashes?: ReadonlyMap<string, string>;
+    /**
+     * Pre-scanned templates. When supplied, orchestrator uses the
+     * derived hashes for sidecar emission AND short-circuits with
+     * `TEMPLATE_INVALID` when invalid templates are detected. Caller
+     * (CLI / admin route) does the scan once before the run.
+     *
+     * When absent, orchestrator skips template-hash computation and
+     * trusts caller-supplied `itemHashes`.
+     */
+    readonly templateInfos?: readonly TemplateInfo[];
+    /**
+     * Per-target asset publish. When true (default), orchestrator runs
+     * `publishAssets` per target before per-item renders so static-mode
+     * pages don't bake in URLs to bytes that aren't on the target yet.
+     */
+    readonly publishAssetsBeforeItems?: boolean;
+    /**
+     * Per-target dep-index emit. When true (default), orchestrator runs
+     * `publishDepIndices` after all items publish (asset-refs +
+     * fragment-deps + archive-aliases sidecars on target).
+     */
+    readonly publishDepIndicesAfter?: boolean;
+    /**
+     * Per-target site manifest emit. When true (default), orchestrator
+     * runs `publishSiteManifest` after items publish so target's
+     * `site.json` reflects the source's site name + version.
+     */
+    readonly publishSiteManifestAfter?: boolean;
+    /** Authenticated principal driving this publish (reserved for capability gates + audit). */
+    readonly principal?: Principal;
+    /** History provider per source (reserved for revision recording — Cut 5+ extension). */
+    readonly history?: HistoryProvider;
+    /** Cache purge strategy (reserved — fire-and-forget post-publish). */
+    readonly purgeStrategy?: PurgeStrategy;
+    /**
+     * `--force`: reserved for future incremental skip logic. Today's
+     * orchestrator publishes every item in the list verbatim — caller
+     * pre-filters via compareTargets if it wants to skip unchanged.
+     */
+    readonly force?: boolean;
+    /** Streaming callback emitted at run / target / item boundaries. */
+    readonly onProgress?: (event: PublishProgressEvent) => void;
+}
+/**
+ * Publish pipeline orchestrator (per-run) — Cut 5.
+ *
+ * Ports the load-bearing fan-out from `cli/index.ts:runPublish` +
+ * admin-api/routes/publish.ts: validate inputs → loop targets ×
+ * items via `publishPage` / `publishFragment` → aggregate per-target
+ * + per-item results → emit progress events.
+ *
+ * v1 scope (intentional): pure fan-out. Caller-supplied responsibilities
+ * (kept in CLI / admin until Cuts 6-7 migrate them):
+ *   - Template scan + hash (`scanTemplates` / `templateHashesFrom`)
+ *   - loadSite (passed in via `input.site`)
+ *   - Asset publish (publishAssets — runs before publishRun)
+ *   - Dependency expansion (findDependentsFromSidecars — caller pre-expands items)
+ *   - Compare/incremental skip (compareTargets — caller pre-filters items)
+ *   - Per-target dep indices (publishDepIndices — runs after publishRun)
+ *   - Site manifest emit (publishSiteManifest — runs after publishRun)
+ *   - Cache purge (purgeStrategy — runs after publishRun, reserved input)
+ *   - History recording (recordWrite — runs after publishRun, reserved input)
+ *   - Audit events (per-item + per-run — reserved Cut 5+)
+ *
+ * Per Q4 fail-soft: per-target init failures fail just that target;
+ * per-item failures continue with next item. Boot fail-fast (steps
+ * 1-2) only when input is structurally invalid.
+ */
+export declare function publishRun(input: PublishRunInput): Promise<PublishRunResult>;
+//# sourceMappingURL=publish-run.d.ts.map

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

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