gazetta 0.6.0 → 0.8.0

package/dist/manifest-save.js

@@ -0,0 +1,260 @@
+/**
+ * Save pipeline — orchestrator for Page and Fragment Manifest writes.
+ *
+ * Today's `admin-api/routes/pages.ts` PUT handler and the matching
+ * fragments.ts handler each inline the same 13-step orchestration:
+ * etag check → validate → beforeSave hooks → history → write → sidecars
+ * → cache → audit → afterSave hooks → scanner. Two route files, one deep
+ * concept duplicated.
+ *
+ * `saveManifestCore` is the seam that hides the orchestration. Routes
+ * become protocol translators (parse Hono request → call → project
+ * SaveResult to HTTP). The CLI, plugin-contributed routes, and any
+ * future Save-shaped consumer call the same function.
+ *
+ * Per-kind entry points (`savePage`, `saveFragment` in pages/save.ts +
+ * fragments/save.ts — Cuts 3+4) wrap this with kind-specific concerns:
+ * locale resolution from `site.pages` vs `site.fragments`, the `route`
+ * field preservation Page Manifests need, and per-kind cache prefixes
+ * (Fragment Saves invalidate `pages:` too because Fragment References
+ * compose into Page summaries).
+ *
+ * Pipeline order is locked semantics, not configuration. Per
+ * `design-hooks.md` "Save flow with hooks": validators run first
+ * (validators are pure functions over a manifest), then beforeSave
+ * hooks see validated payload, then storage write, then afterSave
+ * hooks observe the result. Reordering breaks invariants — audit
+ * before write would lie about success.
+ *
+ * Reserved slots in the sequence (no-ops today; wired by future cuts):
+ *   - Review-state precheck (Review-Workflow Cut 5: pending-review
+ *     state → 409 EDIT_LOCKED)
+ *   - Cascades (Soft-Delete Q6: auto-cancel scheduled actions on
+ *     archive transition; Review Cut 5: invalidateOnSave policy
+ *     transitions approved → draft)
+ *
+ * Throws are reserved for infrastructure failures (storage write
+ * fail, audit infra fail per locked fail-open). Expected outcomes
+ * — STALE / VALIDATION_FAILED / HOOK_CANCELLED — are typed
+ * `SaveResult` variants. Callers `switch` exhaustively; TS narrows.
+ */
+import { recordWrite } from './history-recorder.js';
+import { buildHookContext, dispatchAfterSave, dispatchBeforeSave, HookCancellation, HookTimeout, } from './hooks/index.js';
+import { rebuildAssetRefs } from './assets/asset-deps.js';
+import { rebuildFragmentDeps } from './fragment-deps.js';
+import { rebuildArchiveAliases } from './archive-aliases.js';
+import { computeSaveEtag } from './save-etag.js';
+import { hasBlockingIssues, runSaveDelta } from './validation/save-delta.js';
+/**
+ * Save pipeline orchestrator — Cut 2.
+ *
+ * Ports the 13-step spine from `admin-api/routes/pages.ts:290-510`.
+ * Pipeline sequence (locked per Q5):
+ *
+ *   1. etag precheck                 → STALE
+ *   2. review-state precheck         (reserved slot — no-op today)
+ *   3. validators                    → VALIDATION_FAILED
+ *   4. beforeSave hooks              → HOOK_CANCELLED
+ *   5. history record (pre-write)
+ *   6. storage write
+ *   7. sidecars (asset/fragment/alias) in parallel
+ *   8. cache invalidate (per per-kind prefixes)
+ *   9. compute new etag
+ *  10. audit success
+ *  11. afterSave hooks               (fail-open observers)
+ *  12. cascades                      (reserved slot — no-op today)
+ *  13. scanner.rescan                (fire-and-forget)
+ */
+export async function saveManifestCore(input) {
+    // Step 1 — etag precheck. Mirrors pages.ts:312-339. The current
+    // on-disk etag is computed from the in-memory `before` manifest
+    // plus the per-kind extras (Page passes route; Fragment passes
+    // empty). Absent ifMatch = no concurrency check (last-write-wins).
+    if (input.ifMatch && input.before) {
+        const currentEtag = await computeSaveEtag({
+            ...input.before,
+            ...input.etagExtras,
+        });
+        if (currentEtag !== input.ifMatch) {
+            return {
+                ok: false,
+                code: 'STALE',
+                current: { ...input.before, ...input.etagExtras },
+                currentEtag,
+            };
+        }
+    }
+    // Step 2 — review-state precheck. Reserved slot for Review-Workflow
+    // Cut 5 (pending-review state → 409 EDIT_LOCKED). No-op today.
+    // Step 3 — save-delta validation. Same shape as pages.ts:370-394.
+    // Validators are pure functions; orchestrator catches infra errors
+    // and surfaces them as synthetic issues so the save flow stays
+    // predictable. Audit failure with `outcome: 'validation-failed'`
+    // before returning the typed result.
+    const issues = await runSaveDelta({
+        item: {
+            kind: input.kind,
+            name: input.name,
+            itemPath: input.source.contentRoot.relative(input.manifestPath),
+        },
+        // Cast preserves the validator's structural expectation; the
+        // pipeline treats manifests as opaque bags of fields here.
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        before: input.before,
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        after: { ...input.manifest, ...input.etagExtras },
+        site: input.site,
+        contentRoot: input.source.contentRoot,
+        storage: input.source.storage,
+    }, input.validators);
+    if (hasBlockingIssues(issues)) {
+        await input.audit.record({
+            action: 'save',
+            outcome: 'validation-failed',
+            scope: { kind: input.kind, name: input.name },
+            metadata: input.locale ? { locale: input.locale } : undefined,
+        });
+        return { ok: false, code: 'VALIDATION_FAILED', issues };
+    }
+    // Step 4 — beforeSave hooks. Build the HookContext ONCE per
+    // request — design-hooks.md "HookContext shape" locks `now` +
+    // `requestId` as deterministic across all hooks in a request.
+    // Reused for the afterSave dispatch in step 11.
+    const hooks = input.hooks;
+    const hookCtx = hooks
+        ? buildHookContext({
+            principal: input.principal,
+            storage: input.source.storage,
+            target: input.source.targetName,
+            requestId: input.requestId ?? crypto.randomUUID(),
+            site: { name: input.source.manifest?.name },
+            auditEmit: input.hookAuditEmit,
+        })
+        : null;
+    const hookScope = {
+        kind: input.kind,
+        name: input.name,
+        locale: input.locale ?? undefined,
+    };
+    let finalManifest = input.manifest;
+    if (hooks && hookCtx) {
+        try {
+            finalManifest = (await dispatchBeforeSave(hooks, hookScope, input.manifest, hookCtx));
+        }
+        catch (err) {
+            if (err instanceof HookCancellation || err instanceof HookTimeout) {
+                // Per design-hooks.md Q3 audit lock: cancelled saves record
+                // outcome 'hook-cancelled' (closed-enum extension to
+                // AuditOutcome already in audit/types.ts). Earlier behavior
+                // emitted 'validation-failed' which conflated hook policy
+                // with validator semantics — forensic queries filtering on
+                // outcome would mistakenly include hook cancellations.
+                // metadata.hookCancelled vs metadata.hookTimeout still
+                // distinguishes the two cancellation paths for forensics.
+                await input.audit.record({
+                    action: 'save',
+                    outcome: 'hook-cancelled',
+                    scope: { kind: input.kind, name: input.name },
+                    metadata: {
+                        ...(input.locale ? { locale: input.locale } : {}),
+                        hookCancelled: err instanceof HookCancellation ? err.hookName : undefined,
+                        hookTimeout: err instanceof HookTimeout ? err.hookName : undefined,
+                    },
+                });
+                return {
+                    ok: false,
+                    code: 'HOOK_CANCELLED',
+                    hook: err.hookName,
+                    reason: err.message,
+                };
+            }
+            throw err;
+        }
+    }
+    // Re-serialize the (potentially mutated) manifest. When no hooks
+    // ran, finalManifest === input.manifest so the same serialization
+    // is recomputed once — cost is negligible vs the conditional.
+    const serialized = JSON.stringify(finalManifest, null, 2) + '\n';
+    // Step 5 — history. Record BEFORE the disk write per the
+    // recordWrite first-call invariant (pages.ts:442-456). Baseline
+    // scan reads current disk state (pre-save); recordWrite overlays
+    // the incoming delta to build the snapshot.
+    if (input.source.history) {
+        await recordWrite({
+            history: input.source.history,
+            contentRoot: input.source.contentRoot,
+            operation: 'save',
+            items: [
+                {
+                    path: input.source.contentRoot.relative(input.manifestPath),
+                    content: serialized,
+                },
+            ],
+        });
+    }
+    // Step 6 — storage write.
+    await input.source.storage.writeFile(input.manifestPath, serialized);
+    // Step 7 — sidecars in parallel. Three Usage Sidecar relations
+    // (per `sidecars.md`): asset-refs, fragment-deps, archive-aliases.
+    // Future asset-soft-delete adds a fourth here in one place.
+    const item = input.locale
+        ? {
+            source: input.kind === 'page' ? 'page' : 'fragment',
+            name: input.name,
+            locale: input.locale,
+        }
+        : { source: input.kind === 'page' ? 'page' : 'fragment', name: input.name };
+    await Promise.all([
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        rebuildAssetRefs(input.source.contentRoot, item, input.before, finalManifest),
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        rebuildFragmentDeps(input.source.contentRoot, item, input.before, finalManifest),
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        rebuildArchiveAliases(input.source.contentRoot, item, input.before, finalManifest),
+    ]);
+    // Step 8 — cache invalidate. Per-kind prefixes from caller. Page
+    // Saves pass ['pages:']; Fragment Saves pass ['fragments:',
+    // 'pages:'] because Fragment References compose into Page
+    // summaries.
+    await Promise.all(input.cacheInvalidatePrefixes.map(p => input.source.cache.invalidatePrefix(p)));
+    // Step 9 — recompute save-etag for the new on-disk content. Echo
+    // shape MUST match what the next GET produces — extras (route)
+    // are folded in here so offline replay projection chains work
+    // (design-offline.md Q3).
+    const echoShape = { ...finalManifest, ...input.etagExtras };
+    const newEtag = await computeSaveEtag(echoShape);
+    // Step 10 — audit success. Records actor + scope + locale (when
+    // locale variant). Strict-mode operators check the result.failed
+    // count; fail-open default ignores. Recorder never throws.
+    await input.audit.record({
+        action: 'save',
+        outcome: 'success',
+        scope: { kind: input.kind, name: input.name },
+        metadata: input.locale ? { locale: input.locale } : undefined,
+    });
+    // Step 11 — afterSave hooks. Observational; failures logged but
+    // never propagated. Runs AFTER the audit record so the forensic
+    // record is durably committed before observational hooks fire.
+    // Per-hook timeout applies; one slow hook bounded by its
+    // timeout, not the total.
+    if (hooks && hookCtx) {
+        await dispatchAfterSave(hooks, hookScope, { payload: finalManifest, etag: newEtag }, hookCtx);
+    }
+    // Step 12 — cascades. Reserved slot for Soft-Delete Q6
+    // (auto-cancel scheduled actions on archive transition) and
+    // Review Cut 5 (invalidateOnSave policy → approved → draft).
+    // No-op today.
+    // Step 13 — background validation scanner. Fire-and-forget — the
+    // save response shouldn't block on scanner work; the scanner
+    // emits its own SSE event when the pass completes and the admin
+    // UI store re-fetches `/api/validation/issues` on the event.
+    if (input.scanner) {
+        const cause = input.scannerCause ?? {
+            kind: 'manifest',
+            item: { kind: input.kind, name: input.name, itemPath: input.manifestPath },
+        };
+        void input.scanner.rescan(cause);
+    }
+    return { ok: true, etag: newEtag };
+}
+//# sourceMappingURL=manifest-save.js.map

package/dist/manifest-save.js.map

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

package/dist/manifest.d.ts

@@ -1,5 +1,4 @@
-import type { FragmentManifest, PageManifest, SiteManifest, StorageProvider } from './types.js';
-export declare function parseSiteManifest(storage: StorageProvider, filePath: string): Promise<SiteManifest>;
+import type { FragmentManifest, PageManifest, StorageProvider } from './types.js';
 export declare function parsePageManifest(storage: StorageProvider, filePath: string): Promise<PageManifest>;
 export declare function parseFragmentManifest(storage: StorageProvider, filePath: string): Promise<FragmentManifest>;
 //# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAEV,gBAAgB,EAEhB,YAAY,EACZ,YAAY,EACZ,eAAe,EAChB,MAAM,YAAY,CAAA;AAiDnB,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAazG;AAcD,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAazG;AAED,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAUjH"}
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiC,gBAAgB,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAoEhH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAezG;AAED,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAYjH"}

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"}