gazetta 0.7.0 → 0.8.0

package/dist/manifest.js

@@ -1,19 +1,3 @@
-import yaml from 'js-yaml';
-function parseYaml(content, filePath) {
-    try {
-        const parsed = yaml.load(content);
-        if (!parsed || typeof parsed !== 'object') {
-            throw new Error(`Expected a YAML object in ${filePath}, got ${typeof parsed}`);
-        }
-        return parsed;
-    }
-    catch (err) {
-        if (err instanceof yaml.YAMLException) {
-            throw new Error(`YAML parse error in ${filePath}: ${err.message}`);
-        }
-        throw err;
-    }
-}
 function parseJson(content, filePath) {
     try {
         const parsed = JSON.parse(content);
@@ -29,6 +13,38 @@ function parseJson(content, filePath) {
         throw err;
     }
 }
+/**
+ * Pick the archive fields off a parsed manifest, projecting only the
+ * locked four (per design-soft-delete.md Q1). Stale or unknown fields
+ * are dropped — the manifest projection layer is the boundary that
+ * defines which manifest properties Gazetta consumes.
+ */
+function parseArchiveFields(raw) {
+    const out = {};
+    if (typeof raw.archived === 'boolean')
+        out.archived = raw.archived;
+    if (typeof raw.archivedAt === 'string')
+        out.archivedAt = raw.archivedAt;
+    if (typeof raw.archivedBy === 'string')
+        out.archivedBy = raw.archivedBy;
+    if (typeof raw.aliasOf === 'string')
+        out.aliasOf = raw.aliasOf;
+    return out;
+}
+/**
+ * Forward-compat passthrough for review-workflow's `reviewState`
+ * field (per design-soft-delete.md Cut 14). The review-workflow
+ * foundation will lock the field's shape when it ships; until then,
+ * the parser passes through any string value so archive-time logic
+ * (auto-withdraw on pending-review, restore-to-draft on unarchive)
+ * has the field to read. Spread directly into the parsed object so
+ * it's `reviewState?: string | undefined`.
+ */
+function parseReviewFields(raw) {
+    if (typeof raw.reviewState === 'string')
+        return { reviewState: raw.reviewState };
+    return {};
+}
 function parseComponents(raw) {
     if (!Array.isArray(raw))
         return undefined;
@@ -37,43 +53,22 @@ function parseComponents(raw) {
             return entry;
         if (typeof entry === 'object' && entry !== null && typeof entry.template === 'string') {
             const comp = entry;
-            return {
+            const parsed = {
                 name: comp.name,
                 template: comp.template,
                 content: comp.content,
                 components: parseComponents(comp.components),
             };
+            // Preserve component IDs (per design-collaboration.md Cut 1).
+            // IDs are written by the save handlers and must round-trip
+            // through read so inline anchors stay valid.
+            if (typeof comp.id === 'string')
+                parsed.id = comp.id;
+            return parsed;
         }
         return entry;
     });
 }
-export async function parseSiteManifest(storage, filePath) {
-    const raw = parseYaml(await storage.readFile(filePath), filePath);
-    if (typeof raw.name !== 'string') {
-        throw new Error(`Invalid site.yaml at ${filePath}: missing required "name" field`);
-    }
-    return {
-        name: raw.name,
-        version: raw.version,
-        locale: raw.locale,
-        locales: parseLocalesConfig(raw.locales),
-        defaultOgImage: raw.defaultOgImage,
-        systemPages: Array.isArray(raw.systemPages) ? raw.systemPages : undefined,
-    };
-}
-function parseLocalesConfig(raw) {
-    if (!raw || typeof raw !== 'object')
-        return undefined;
-    const obj = raw;
-    if (!Array.isArray(obj.supported) || obj.supported.length === 0)
-        return undefined;
-    return {
-        supported: obj.supported,
-        fallbacks: obj.fallbacks,
-        defaultPrefix: typeof obj.defaultPrefix === 'boolean' ? obj.defaultPrefix : undefined,
-        detection: typeof obj.detection === 'boolean' ? obj.detection : undefined,
-    };
-}
 export async function parsePageManifest(storage, filePath) {
     const raw = parseJson(await storage.readFile(filePath), filePath);
     if (typeof raw.template !== 'string') {
@@ -86,6 +81,8 @@ export async function parsePageManifest(storage, filePath) {
         components: parseComponents(raw.components),
         metadata: raw.metadata,
         cache: raw.cache,
+        ...parseArchiveFields(raw),
+        ...parseReviewFields(raw),
     };
 }
 export async function parseFragmentManifest(storage, filePath) {
@@ -97,6 +94,8 @@ export async function parseFragmentManifest(storage, filePath) {
         template: raw.template,
         content: raw.content,
         components: parseComponents(raw.components),
+        ...parseArchiveFields(raw),
+        ...parseReviewFields(raw),
     };
 }
 //# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

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

package/dist/node-floor.d.ts

@@ -0,0 +1,3 @@
+/** Driven by `write-file-atomic@8`'s engines requirement. */
+export declare const REQUIRED_NODE_FLOOR = ">=22.22.2";
+//# sourceMappingURL=node-floor.d.ts.map

package/dist/node-floor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-floor.d.ts","sourceRoot":"","sources":["../src/node-floor.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,eAAO,MAAM,mBAAmB,cAAc,CAAA"}

package/dist/node-floor.js

@@ -0,0 +1,3 @@
+/** Driven by `write-file-atomic@8`'s engines requirement. */
+export const REQUIRED_NODE_FLOOR = '>=22.22.2';
+//# sourceMappingURL=node-floor.js.map

package/dist/node-floor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-floor.js","sourceRoot":"","sources":["../src/node-floor.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,MAAM,CAAC,MAAM,mBAAmB,GAAG,WAAW,CAAA"}

package/dist/pages/create.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Page Create — POST handler logic for `/api/pages`.
+ *
+ * Different from `savePage`:
+ *   - No etag precheck (nothing to compare against; new page)
+ *   - No locale variant lookup (creates the default Page Manifest)
+ *   - Name conflict resolution per `design-soft-delete.md` Q5 I3:
+ *     - Live name in use → typed `LIVE_CONFLICT` outcome
+ *     - Archived name in use, no `?onConflict` flag → typed
+ *       `ARCHIVED_CONFLICT` outcome with archive details
+ *     - Archived name in use, with mode → delegate to
+ *       `resolveArchivedNameConflict` (restore / replace / moveAside)
+ *   - Folder creation (`storage.mkdir(pageDir)`)
+ *   - Initial sidecar wiring (`rebuildAssetRefs` /
+ *     `rebuildFragmentDeps` against `null` → empty manifest)
+ *   - Cache invalidation (`pages:`)
+ *
+ * Same as `savePage` for the post-resolution-or-create write itself —
+ * eventually creates pass through `saveManifestCore` once the
+ * "before is null" path lands. v1 keeps the create-time path
+ * separate because it doesn't need validators / hooks / scanner /
+ * audit-on-failure (a new empty page has no validation surface to
+ * exercise yet).
+ *
+ * Per Q6 lock: separate `createPage` instead of folding into
+ * `savePage` — Create has its own pre-write phase (conflict prompt,
+ * mkdir, route derive) that update doesn't. Branchy A would merge
+ * two distinct intents.
+ */
+import { type ArchivedNameConflictResult } from '../admin-api/archived-name-conflict.js';
+import type { SourceContext } from '../admin-api/source-context.js';
+import type { SaveAuditRecorder, SavePrincipal } from '../manifest-save.js';
+/**
+ * Inputs to `createPage`. The body's already been Zod-validated by
+ * the route — caller passes the parsed shape.
+ */
+export interface CreatePageInput {
+    /** Page name (folder name under `pages/`). */
+    readonly name: string;
+    /** Template the new page uses. */
+    readonly template: string;
+    /** Optional initial content; defaults to `{ title: name }` when absent. */
+    readonly content?: Record<string, unknown>;
+    /**
+     * `?onConflict` query param: `'restore' | 'replace' | 'moveAside'`
+     * or undefined. When undefined and an archived name conflict is
+     * detected, returns `ARCHIVED_CONFLICT` so the route prompts the
+     * client. When set, delegates to `resolveArchivedNameConflict`.
+     */
+    readonly onConflict?: string;
+    /** Source wiring + admin-api SourceContext (for archived-conflict resolver). */
+    readonly source: SourceContext;
+    /** Authenticated principal driving this create. */
+    readonly principal: SavePrincipal;
+    /** Audit recorder bound to the request. */
+    readonly audit: SaveAuditRecorder;
+}
+/**
+ * Successful create — fresh page or restored-from-archive.
+ * `resolution` is set when the create resolved an archive conflict;
+ * absent for plain creates.
+ */
+export interface CreatePageOk {
+    readonly ok: true;
+    readonly name: string;
+    readonly resolution?: ArchivedNameConflictResult['kind'];
+}
+/** Live (non-archived) page already exists at `name`. */
+export interface CreatePageLiveConflict {
+    readonly ok: false;
+    readonly code: 'LIVE_CONFLICT';
+    readonly name: string;
+}
+/**
+ * Archived page exists at `name`. Caller hadn't sent `?onConflict`
+ * → return the archive details so the client can prompt
+ * Restore / Replace / Move-aside per Soft-Delete Q5 I3.
+ */
+export interface CreatePageArchivedConflict {
+    readonly ok: false;
+    readonly code: 'ARCHIVED_CONFLICT';
+    readonly archive: {
+        readonly kind: 'page';
+        readonly name: string;
+        readonly archivedAt?: string;
+        readonly archivedBy?: string;
+        readonly aliasOf?: string;
+    };
+}
+/** Caller sent `?onConflict=<unknown>`. Routes project to 400. */
+export interface CreatePageInvalidMode {
+    readonly ok: false;
+    readonly code: 'INVALID_CONFLICT_MODE';
+    readonly mode: string;
+}
+export type CreatePageResult = CreatePageOk | CreatePageLiveConflict | CreatePageArchivedConflict | CreatePageInvalidMode;
+/**
+ * Create a Page. Wraps the conflict-resolution decision tree + the
+ * fresh-create write path. Routes project the typed `CreatePageResult`
+ * to HTTP (200 / 400 / 409).
+ */
+export declare function createPage(input: CreatePageInput): Promise<CreatePageResult>;
+//# sourceMappingURL=create.d.ts.map

package/dist/pages/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/pages/create.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAGH,OAAO,EAGL,KAAK,0BAA0B,EAChC,MAAM,wCAAwC,CAAA;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAA;AAKnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAE3E;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,kCAAkC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,2EAA2E;IAC3E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC1C;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,gFAAgF;IAChF,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;IAC9B,mDAAmD;IACnD,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAA;IACjC,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAA;CAClC;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAA;IACjB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,UAAU,CAAC,EAAE,0BAA0B,CAAC,MAAM,CAAC,CAAA;CACzD;AAED,yDAAyD;AACzD,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAA;IAClB,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAA;IAClB,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAA;IAClC,QAAQ,CAAC,OAAO,EAAE;QAChB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;QACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;QACrB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;QAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;QAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAC1B,CAAA;CACF;AAED,kEAAkE;AAClE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAA;IAClB,QAAQ,CAAC,IAAI,EAAE,uBAAuB,CAAA;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,MAAM,gBAAgB,GACxB,YAAY,GACZ,sBAAsB,GACtB,0BAA0B,GAC1B,qBAAqB,CAAA;AAEzB;;;;GAIG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAmFlF"}

package/dist/pages/create.js

@@ -0,0 +1,117 @@
+/**
+ * Page Create — POST handler logic for `/api/pages`.
+ *
+ * Different from `savePage`:
+ *   - No etag precheck (nothing to compare against; new page)
+ *   - No locale variant lookup (creates the default Page Manifest)
+ *   - Name conflict resolution per `design-soft-delete.md` Q5 I3:
+ *     - Live name in use → typed `LIVE_CONFLICT` outcome
+ *     - Archived name in use, no `?onConflict` flag → typed
+ *       `ARCHIVED_CONFLICT` outcome with archive details
+ *     - Archived name in use, with mode → delegate to
+ *       `resolveArchivedNameConflict` (restore / replace / moveAside)
+ *   - Folder creation (`storage.mkdir(pageDir)`)
+ *   - Initial sidecar wiring (`rebuildAssetRefs` /
+ *     `rebuildFragmentDeps` against `null` → empty manifest)
+ *   - Cache invalidation (`pages:`)
+ *
+ * Same as `savePage` for the post-resolution-or-create write itself —
+ * eventually creates pass through `saveManifestCore` once the
+ * "before is null" path lands. v1 keeps the create-time path
+ * separate because it doesn't need validators / hooks / scanner /
+ * audit-on-failure (a new empty page has no validation surface to
+ * exercise yet).
+ *
+ * Per Q6 lock: separate `createPage` instead of folding into
+ * `savePage` — Create has its own pre-write phase (conflict prompt,
+ * mkdir, route derive) that update doesn't. Branchy A would merge
+ * two distinct intents.
+ */
+import { join } from 'node:path';
+import { resolveArchivedNameConflict, } from '../admin-api/archived-name-conflict.js';
+import { rebuildAssetRefs } from '../assets/asset-deps.js';
+import { rebuildFragmentDeps } from '../fragment-deps.js';
+import { loadSiteFromSource } from '../admin-api/source-context.js';
+/**
+ * Create a Page. Wraps the conflict-resolution decision tree + the
+ * fresh-create write path. Routes project the typed `CreatePageResult`
+ * to HTTP (200 / 400 / 409).
+ */
+export async function createPage(input) {
+    const { source, name, template, content, onConflict, principal, audit } = input;
+    const { storage } = source;
+    const pageDir = source.contentRoot.path('pages', name);
+    const manifestPath = join(pageDir, 'page.json');
+    // Conflict path — manifest already exists at the target name.
+    if (await storage.exists(manifestPath)) {
+        const site = await loadSiteFromSource(source);
+        const existing = site.pages.get(name);
+        const isArchived = existing?.archived === true;
+        if (!isArchived) {
+            return { ok: false, code: 'LIVE_CONFLICT', name };
+        }
+        // Archived conflict, no resolution flag → return structured
+        // body so the client can prompt the author per Q5 I3.
+        if (!onConflict) {
+            return {
+                ok: false,
+                code: 'ARCHIVED_CONFLICT',
+                archive: {
+                    kind: 'page',
+                    name,
+                    ...(existing?.archivedAt ? { archivedAt: existing.archivedAt } : {}),
+                    ...(existing?.archivedBy ? { archivedBy: existing.archivedBy } : {}),
+                    ...(existing?.aliasOf ? { aliasOf: existing.aliasOf } : {}),
+                },
+            };
+        }
+        // Archived conflict + mode → delegate to the resolver.
+        const result = await resolveArchivedNameConflict({
+            source,
+            kind: 'page',
+            name,
+            existing: existing,
+            mode: onConflict,
+            newTemplate: template,
+            newContent: content,
+            actorId: principal.id,
+        });
+        if (result.kind === 'invalid-mode') {
+            return { ok: false, code: 'INVALID_CONFLICT_MODE', mode: onConflict };
+        }
+        // Audit one event per logical mode — mirror existing route shape.
+        const action = result.kind === 'restored' ? 'unarchive' : result.kind === 'replaced' ? 'archive' : 'rename';
+        await audit.record({
+            // The audit recorder's typed shape limits action to save-flow values;
+            // the resolver's audit events use the soft-delete vocabulary. Cast
+            // through `unknown` keeps the recorder shape narrow without forcing a
+            // wider union into the save pipeline's contract.
+            action: action,
+            outcome: 'success',
+            scope: { kind: 'page', name },
+            metadata: { onConflict },
+        });
+        await source.cache.invalidatePrefix('pages:');
+        return { ok: true, name, resolution: result.kind };
+    }
+    // Fresh create path — no existing manifest at the target name.
+    await storage.mkdir(pageDir);
+    const manifest = {
+        template,
+        content: content ?? { title: name },
+        components: [],
+    };
+    await storage.writeFile(manifestPath, `${JSON.stringify(manifest, null, 2)}\n`);
+    // Sidecar wiring — fresh manifest has empty components[] so the
+    // diff against null is mostly a no-op today; wires the dep tracking
+    // for the moment templates ship initial content with `_asset` or
+    // `@fragment` refs.
+    const item = { source: 'page', name };
+    await Promise.all([
+        rebuildAssetRefs(source.contentRoot, item, null, manifest),
+        rebuildFragmentDeps(source.contentRoot, item, null, manifest),
+    ]);
+    await source.cache.invalidatePrefix('pages:');
+    return { ok: true, name };
+}
+//# sourceMappingURL=create.js.map

package/dist/pages/create.js.map

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

package/dist/pages/publish.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Page Publish — kind-specific wrapper around `publishItemCore`.
+ *
+ * Owns the bits unique to Page publishes:
+ *   - Render-mode resolution from target.type + archive state:
+ *     - archived → 'archive-marker' regardless of target type
+ *     - target.type === 'esi' → 'page-rendered' (ESI placeholders)
+ *     - target.type === 'static' → 'page-static' (full-bake)
+ *     - target.type === 'dynamic' → 'page-static' (static fallback;
+ *       dynamic origin handles per-request render)
+ *   - Page-cache config flow-through (target → page → spine renderer
+ *     reads it for the cache-control comment)
+ *
+ * Everything downstream — archive precheck, render dispatch, storage
+ * I/O, sidecar writes, cleanup — is `publishItemCore`'s spine.
+ *
+ * Per Q3 lock: two fns + shared core. The 5 page-vs-fragment diffs
+ * (mode resolution, page-cache, sidecar pub-state, etc.) live here in
+ * one file the reader can scan top-to-bottom.
+ */
+import { type PublishItemResult, type PublishRenderMode, type PublishTarget } from '../publish-item.js';
+import type { ContentRoot } from '../content-root.js';
+import type { Site } from '../site-loader.js';
+/**
+ * Inputs to `publishPage`. Routes / CLI / orchestrator destructure
+ * their context and pass the parts the pipeline needs.
+ */
+export interface PublishPageInput {
+    /** Page name (folder name under `pages/`). */
+    readonly name: string;
+    /** Locale variant being published; undefined = default locale. */
+    readonly locale?: string;
+    /** Loaded site (caller does `loadSite()` once for the publish run). */
+    readonly site: Site;
+    /** Source content root (typically not used by core today; reserved for hooks). */
+    readonly sourceRoot: ContentRoot;
+    /** Target context (storage, type, optional manifestHash, seo, cache). */
+    readonly target: PublishTarget;
+}
+/**
+ * Resolve the render mode for a page on a target. Pure dispatch
+ * function — exported for tests + per-kind reuse.
+ */
+export declare function resolvePageRenderMode(page: {
+    archived?: boolean;
+}, targetType: PublishTarget['type']): PublishRenderMode;
+/**
+ * Publish a page to a target. Wraps `publishItemCore` with the
+ * page-specific mode resolution. Returns one of `PublishItemResult`'s
+ * typed variants — caller projects to wire shape (HTTP / SSE / CLI
+ * stdout / aggregate result).
+ *
+ * Caller responsibilities (handled by per-run orchestrator in Cut 5):
+ *   - Capability check (`requireCapability('publish:...')`)
+ *   - Template scan + loadSite (shared across run)
+ *   - Per-target init + capability gates
+ */
+export declare function publishPage(input: PublishPageInput): Promise<PublishItemResult>;
+//# sourceMappingURL=publish.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"publish.d.ts","sourceRoot":"","sources":["../../src/pages/publish.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,EAAmB,KAAK,iBAAiB,EAAE,KAAK,iBAAiB,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAA;AACxH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AACrD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAA;AAE7C;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,kEAAkE;IAClE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,uEAAuE;IACvE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;IACnB,kFAAkF;IAClF,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAA;IAChC,yEAAyE;IACzE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;CAC/B;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,EAC5B,UAAU,EAAE,aAAa,CAAC,MAAM,CAAC,GAChC,iBAAiB,CAcnB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAsBrF"}

package/dist/pages/publish.js

@@ -0,0 +1,78 @@
+/**
+ * Page Publish — kind-specific wrapper around `publishItemCore`.
+ *
+ * Owns the bits unique to Page publishes:
+ *   - Render-mode resolution from target.type + archive state:
+ *     - archived → 'archive-marker' regardless of target type
+ *     - target.type === 'esi' → 'page-rendered' (ESI placeholders)
+ *     - target.type === 'static' → 'page-static' (full-bake)
+ *     - target.type === 'dynamic' → 'page-static' (static fallback;
+ *       dynamic origin handles per-request render)
+ *   - Page-cache config flow-through (target → page → spine renderer
+ *     reads it for the cache-control comment)
+ *
+ * Everything downstream — archive precheck, render dispatch, storage
+ * I/O, sidecar writes, cleanup — is `publishItemCore`'s spine.
+ *
+ * Per Q3 lock: two fns + shared core. The 5 page-vs-fragment diffs
+ * (mode resolution, page-cache, sidecar pub-state, etc.) live here in
+ * one file the reader can scan top-to-bottom.
+ */
+import { isArchived } from '../archive-helpers.js';
+import { publishItemCore } from '../publish-item.js';
+/**
+ * Resolve the render mode for a page on a target. Pure dispatch
+ * function — exported for tests + per-kind reuse.
+ */
+export function resolvePageRenderMode(page, targetType) {
+    // Archive precheck wins regardless of target type. The spine's
+    // archive-marker renderer body-skips and emits the marker line so
+    // the worker reads first 200 bytes and short-circuits to 301/410
+    // per design-soft-delete.md Q10.
+    if (isArchived(page))
+        return 'archive-marker';
+    // ESI mode: pages compose ESI placeholders for `@fragment` refs
+    // at request time on a worker-served target.
+    if (targetType === 'esi')
+        return 'page-rendered';
+    // Static + dynamic targets bake the full page. Dynamic targets'
+    // origin handles per-request rendering for dynamic FRAGMENTS only;
+    // pages themselves still get a static fallback (per
+    // design-rendering.md compatibility matrix).
+    return 'page-static';
+}
+/**
+ * Publish a page to a target. Wraps `publishItemCore` with the
+ * page-specific mode resolution. Returns one of `PublishItemResult`'s
+ * typed variants — caller projects to wire shape (HTTP / SSE / CLI
+ * stdout / aggregate result).
+ *
+ * Caller responsibilities (handled by per-run orchestrator in Cut 5):
+ *   - Capability check (`requireCapability('publish:...')`)
+ *   - Template scan + loadSite (shared across run)
+ *   - Per-target init + capability gates
+ */
+export async function publishPage(input) {
+    const page = input.site.pages.get(input.name);
+    if (!page) {
+        return {
+            kind: 'page',
+            name: input.name,
+            locale: input.locale,
+            ok: false,
+            code: 'NOT_FOUND',
+            reason: `Page "${input.name}" not found in source`,
+        };
+    }
+    const mode = resolvePageRenderMode(page, input.target.type);
+    return publishItemCore({
+        kind: 'page',
+        name: input.name,
+        locale: input.locale,
+        mode,
+        site: input.site,
+        sourceRoot: input.sourceRoot,
+        target: input.target,
+    });
+}
+//# sourceMappingURL=publish.js.map

package/dist/pages/publish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.js","sourceRoot":"","sources":["../../src/pages/publish.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAClD,OAAO,EAAE,eAAe,EAAsE,MAAM,oBAAoB,CAAA;AAqBxH;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAA4B,EAC5B,UAAiC;IAEjC,+DAA+D;IAC/D,kEAAkE;IAClE,iEAAiE;IACjE,iCAAiC;IACjC,IAAI,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,gBAAgB,CAAA;IAC7C,gEAAgE;IAChE,6CAA6C;IAC7C,IAAI,UAAU,KAAK,KAAK;QAAE,OAAO,eAAe,CAAA;IAChD,gEAAgE;IAChE,mEAAmE;IACnE,oDAAoD;IACpD,6CAA6C;IAC7C,OAAO,aAAa,CAAA;AACtB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAAuB;IACvD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC7C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,WAAW;YACjB,MAAM,EAAE,SAAS,KAAK,CAAC,IAAI,uBAAuB;SACnD,CAAA;IACH,CAAC;IACD,MAAM,IAAI,GAAG,qBAAqB,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAC3D,OAAO,eAAe,CAAC;QACrB,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,IAAI;QACJ,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,MAAM,EAAE,KAAK,CAAC,MAAM;KACrB,CAAC,CAAA;AACJ,CAAC"}

package/dist/pages/save.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Page Save — kind-specific wrapper around `saveManifestCore`.
+ *
+ * Owns the bits unique to Page Manifest writes:
+ *   - Locale resolution (default vs `page.{locale}.json` variant)
+ *     using `site.pages` + `site.pageLocales`
+ *   - Component-ID auto-assignment via `ensureComponentIds`
+ *   - Filename composition (`page.json` vs `page.{locale}.json`)
+ *   - Manifest assembly (template/content/components/metadata, plus
+ *     route preservation for locale variants)
+ *   - The `route` field in `etagExtras` (folder-derived; not stored
+ *     in the file but part of the etag projection chain per
+ *     `design-offline.md` Q3)
+ *   - Per-kind cache prefix `pages:`
+ *
+ * Everything downstream — etag check, validators, beforeSave hooks,
+ * history, write, sidecars, cache invalidate, audit, afterSave hooks,
+ * scanner — is `saveManifestCore`'s spine. This wrapper is the
+ * Page-flavored thin entry point routes (and the future CLI / plugin
+ * routes) call.
+ *
+ * Per Q3 lock: two fns + shared core. The 5 page-specific diffs
+ * (route field, locale lookup in `site.pages`, page-cache prefix,
+ * filename, route preservation in locale variants) live here in
+ * one file the reader can scan top-to-bottom.
+ */
+import { type SaveAuditRecorder, type SaveResult, type SavePrincipal, type SaveSourceWiring } from '../manifest-save.js';
+import type { PageManifest } from '../types.js';
+import type { Site } from '../site-loader.js';
+import type { ValidatorRegistry } from '../validation/registry.js';
+import type { ValidationScanner } from '../validation/scanner.js';
+import type { HookFiringEmitter, HookRegistry } from '../hooks/index.js';
+/**
+ * Inputs to `savePage`. Routes destructure their request and pass
+ * the parts the pipeline needs; CLI / plugin callers do the same
+ * without an HTTP shell. Returns one of `SaveResult`'s typed
+ * variants — caller projects to HTTP (200 / 409) or CLI exit code.
+ */
+export interface SavePageInput {
+    /** Page name (folder name under `pages/`). */
+    readonly name: string;
+    /** BCP-47 locale when saving a Locale Variant; undefined for default. */
+    readonly locale?: string;
+    /** Incoming manifest body (template/content/components/metadata). */
+    readonly body: Partial<PageManifest> & Record<string, unknown>;
+    /** Optional save-etag for concurrency check. */
+    readonly ifMatch?: string;
+    /** Loaded site (caller does `loadSiteFromSource(source)` once). */
+    readonly site: Site;
+    /** Source wiring (cache, history, storage, contentRoot, manifest, targetName). */
+    readonly source: SaveSourceWiring;
+    /** Authenticated principal driving this save. */
+    readonly principal: SavePrincipal;
+    /** Audit recorder bound to the request. */
+    readonly audit: SaveAuditRecorder;
+    /** Validator registry built once at admin boot. */
+    readonly validators: ValidatorRegistry;
+    /** Hook registry; absent when no hooks contributed. */
+    readonly hooks?: HookRegistry;
+    /** Audit-firing emitter for hook dispatch. */
+    readonly hookAuditEmit?: HookFiringEmitter;
+    /** Background scanner; absent when scanner not enabled. */
+    readonly scanner?: ValidationScanner;
+    /** Per-request correlation id; fresh UUID when absent. */
+    readonly requestId?: string;
+}
+/**
+ * Page-name-not-found error. The route projects this to a 404; the
+ * pipeline can't compose the full save without a `before` manifest
+ * (etag check, validators, sidecar diffs all need it). Distinct
+ * from the typed `SaveResult` variants because absence-of-target is
+ * a route-level precondition, not a save-pipeline outcome.
+ */
+export declare class PageNotFoundError extends Error {
+    readonly name: string;
+    constructor(name: string);
+}
+/**
+ * Invalid locale code per `isValidLocale`. Routes project to 400.
+ */
+export declare class InvalidLocaleError extends Error {
+    readonly raw: string;
+    constructor(raw: string);
+}
+/**
+ * Save a Page Manifest. Wraps `saveManifestCore` with the Page-specific
+ * resolution + assembly. Throws `PageNotFoundError` / `InvalidLocaleError`
+ * for route-level preconditions; returns `SaveResult` for save outcomes.
+ *
+ * Caller responsibilities:
+ *   - Capability check (`requireCapability('edit:pages')`) before calling
+ *   - HTTP projection of `SaveResult` (200 success, 409 STALE /
+ *     VALIDATION_FAILED / HOOK_CANCELLED with appropriate body shape)
+ *   - Setting the `ETag` response header on success from `result.etag`
+ */
+export declare function savePage(input: SavePageInput): Promise<SaveResult>;
+//# sourceMappingURL=save.d.ts.map

package/dist/pages/save.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"save.d.ts","sourceRoot":"","sources":["../../src/pages/save.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAKH,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACtB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC/C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAA;AAC7C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAClE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAA;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAExE;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,yEAAyE;IACzE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,qEAAqE;IACrE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC9D,gDAAgD;IAChD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,mEAAmE;IACnE,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAA;IACnB,kFAAkF;IAClF,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAA;IACjC,iDAAiD;IACjD,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAA;IACjC,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAA;IACjC,mDAAmD;IACnD,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAA;IACtC,uDAAuD;IACvD,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAA;IAC7B,8CAA8C;IAC9C,QAAQ,CAAC,aAAa,CAAC,EAAE,iBAAiB,CAAA;IAC1C,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,CAAC,EAAE,iBAAiB,CAAA;IACpC,0DAA0D;IAC1D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED;;;;;;GAMG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;aACd,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM;CAIzC;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;aACf,GAAG,EAAE,MAAM;gBAAX,GAAG,EAAE,MAAM;CAIxC;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,CAqExE"}