gazetta 0.5.0 → 0.7.0

package/dist/history-recorder.js

@@ -0,0 +1,168 @@
+/**
+ * Higher-level helper for recording revisions on a target.
+ *
+ * The bare `HistoryProvider.recordRevision` takes a full
+ * `items: Map<path, content>` snapshot. That's fine for testing but
+ * wasteful at runtime: every save of one page would re-hash and
+ * re-list every page + fragment on the target. This helper does the
+ * right thing:
+ *
+ *   - First revision on a target: walks the content tree once to
+ *     snapshot every manifest (page.json, fragment.json, site.yaml).
+ *   - Subsequent revisions: reads the previous snapshot and overlays
+ *     the delta (changed items the caller passes in). `readBlob` for
+ *     each carried-over path gives us the content for the new
+ *     revision's items map — at which point `recordRevision` dedupes
+ *     the unchanged blobs via content-addressing, so no new storage.
+ *
+ * SRP: this module owns the "what goes in a revision snapshot"
+ * decision. `HistoryProvider` owns layout. Callers (admin-api save /
+ * admin-api publish / CLI publish) just describe *what they wrote*
+ * and we construct the revision.
+ */
+import { join } from 'node:path';
+/**
+ * Built-in content locations Gazetta knows about today. Callers can
+ * pass a superset (e.g. for future data/*, templates/*) — the list is
+ * part of `RecordWriteOptions` so this module stays open for extension
+ * without changes when new content kinds land.
+ */
+export const DEFAULT_SCAN_LOCATIONS = [
+    { dir: 'pages', manifest: 'page.json' },
+    { dir: 'fragments', manifest: 'fragment.json' },
+];
+/**
+ * Flat files at the content root to capture in the baseline snapshot
+ * (no per-subdirectory recursion). `site.yaml` is the only one today.
+ */
+export const DEFAULT_SCAN_ROOT_FILES = ['site.yaml'];
+/**
+ * Build + record a revision for the given write. Reads the previous
+ * snapshot (if any), overlays the delta, and calls
+ * `history.recordRevision`. Returns the recorded Revision.
+ *
+ * Callers are expected to have already written the items to the
+ * target's storage before invoking this; the recorder reads back via
+ * the HistoryProvider's dedup path (blobs it has already seen just
+ * `exists()` and skip) so the happy path is cheap on repeated saves
+ * of the same item.
+ */
+export async function recordWrite(opts) {
+    const scanLocations = opts.scanLocations ?? DEFAULT_SCAN_LOCATIONS;
+    const scanRootFiles = opts.scanRootFiles ?? DEFAULT_SCAN_ROOT_FILES;
+    // On the very first write, record a baseline revision capturing the
+    // pre-write state — so "undo my first save" has something to revert
+    // to (the tree as it was before the CMS touched it). Subsequent
+    // writes overlay deltas onto the previous revision. Without this,
+    // rev-0001 would be post-save state and undo would have no earlier
+    // revision to restore.
+    const existing = await opts.history.listRevisions(1);
+    if (existing.length === 0) {
+        const baseline = await scanContentTree(opts.contentRoot, scanLocations, scanRootFiles);
+        await opts.history.recordRevision({
+            operation: 'save',
+            message: 'Initial baseline',
+            items: baseline,
+        });
+    }
+    const prevItems = await loadPreviousSnapshot(opts.history, opts.contentRoot, scanLocations, scanRootFiles);
+    const nextItems = new Map(prevItems);
+    for (const it of opts.items) {
+        if (it.content === null)
+            nextItems.delete(it.path);
+        else
+            nextItems.set(it.path, it.content);
+    }
+    const input = {
+        operation: opts.operation,
+        author: opts.author,
+        source: opts.source,
+        message: opts.message,
+        restoredFrom: opts.restoredFrom,
+        items: nextItems,
+    };
+    return opts.history.recordRevision(input);
+}
+/**
+ * Materialize the previous revision's full content snapshot as
+ * `path → content`. If there is no previous revision, fall back to a
+ * one-time scan of the target's content tree (pages, fragments,
+ * site.yaml). That makes the first revision a proper baseline even
+ * when history was turned on after content already existed.
+ */
+async function loadPreviousSnapshot(history, contentRoot, scanLocations, scanRootFiles) {
+    const [head] = await history.listRevisions(1);
+    if (head) {
+        const manifest = await history.readRevision(head.id);
+        const items = new Map();
+        // Read blobs in parallel to avoid a big serial chain on large
+        // snapshots. `readBlob` returns Uint8Array — passing through as-is
+        // means binary blobs round-trip without decode/encode, and text
+        // blobs round-trip as their UTF-8 byte form (still hashes the same
+        // way they would as strings, so dedup holds).
+        const entries = Object.entries(manifest.snapshot);
+        const contents = await Promise.all(entries.map(([, hash]) => history.readBlob(hash)));
+        entries.forEach(([path], i) => items.set(path, contents[i]));
+        return items;
+    }
+    return scanContentTree(contentRoot, scanLocations, scanRootFiles);
+}
+/**
+ * One-time walk of a content root, capturing every content-defining
+ * manifest. Used only for the first revision on a target; subsequent
+ * revisions overlay deltas onto the previous snapshot.
+ *
+ * Locations walked come from `scanLocations` and `scanRootFiles` (see
+ * RecordWriteOptions) so this module stays open for extension: adding
+ * a new content kind is a caller-side change, not an edit here.
+ */
+async function scanContentTree(root, scanLocations, scanRootFiles) {
+    // Snapshot type is `BlobContent` (string | Uint8Array). v1 only scans
+    // text content (manifests, YAML); binary asset paths are populated
+    // by callers via `WrittenItem`s on subsequent saves. The map's type
+    // accommodates both so callers can pass either through.
+    const items = new Map();
+    const { storage } = root;
+    for (const rel of scanRootFiles) {
+        const abs = root.path(rel);
+        if (await storage.exists(abs)) {
+            items.set(rel, await storage.readFile(abs));
+        }
+    }
+    for (const loc of scanLocations) {
+        await scanManifestsInto(storage, root.path(loc.dir), loc.dir, loc.manifest, items);
+    }
+    return items;
+}
+/**
+ * Walk a `pages/` or `fragments/` tree, reading every matching manifest
+ * into `items` with relative-path keys. Recurses so nested dynamic
+ * routes (e.g. `blog/[slug]/page.json`) are captured.
+ *
+ * Cloud object stores (R2/S3/Azure Blob) have no "directory" concept —
+ * `exists()` on a prefix-only path returns false. Rely on `readDir`
+ * returning an empty array for missing paths instead of probing via
+ * `exists` first.
+ */
+async function scanManifestsInto(storage, absDir, relPrefix, manifestName, items) {
+    let entries;
+    try {
+        entries = await storage.readDir(absDir);
+    }
+    catch {
+        return; // Directory doesn't exist (or provider threw) — nothing to scan.
+    }
+    for (const e of entries) {
+        if (!e.isDirectory)
+            continue;
+        const sub = join(absDir, e.name);
+        const relSub = `${relPrefix}/${e.name}`;
+        const manifestPath = join(sub, manifestName);
+        if (await storage.exists(manifestPath)) {
+            items.set(`${relSub}/${manifestName}`, await storage.readFile(manifestPath));
+        }
+        // Recurse for nested routes (pages/blog/[slug]/page.json).
+        await scanManifestsInto(storage, sub, relSub, manifestName, items);
+    }
+}
+//# sourceMappingURL=history-recorder.js.map

package/dist/history-recorder.js.map

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

package/dist/history-restorer.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Apply a past revision's snapshot to a target's content tree.
+ *
+ * This is the write side of undo / rollback. Design-publishing.md:
+ *   "Undo and rollback restore a prior revision — both are soft
+ *    (forward-only; create a new revision reverting to the past state,
+ *    never destroy history)."
+ *
+ * Algorithm:
+ *   1. Load the target revision's snapshot (itemPath → blob hash).
+ *   2. Diff against the current on-disk content (via the HistoryProvider's
+ *      most-recent revision). Anything present now but absent from the
+ *      target snapshot is deleted; everything in the snapshot is written
+ *      from its blob.
+ *   3. Record a new revision with operation='rollback' and
+ *      restoredFrom=<targetRevId>, so the audit trail shows where the
+ *      state came from and history stays forward-only.
+ *
+ * The caller (admin-api / CLI) owns orchestration — picking which
+ * revision to restore (head-1 for undo, arbitrary for rollback) and
+ * any side effects beyond the content tree (e.g., sidecar writer
+ * invalidation).
+ */
+import type { ContentRoot } from './content-root.js';
+import type { HistoryProvider, Revision } from './history.js';
+export interface RestoreRevisionOptions {
+    /** HistoryProvider for the target being restored. */
+    history: HistoryProvider;
+    /** Content root of the target — destination for the restore writes. */
+    contentRoot: ContentRoot;
+    /** Id of the revision to restore to (rev-NNNN). */
+    revisionId: string;
+    /** Free-form author identifier passed to the forward revision. */
+    author?: string;
+    /** Human-readable note ("Undo publish from local"). */
+    message?: string;
+}
+/**
+ * Restore `revisionId`'s content onto the target. Writes any items
+ * present in the snapshot (content fetched via `readBlob`); deletes
+ * items that exist today but aren't in the restored snapshot. Returns
+ * the new forward revision — always operation='rollback' so audit
+ * consumers can distinguish restores from normal saves/publishes.
+ */
+export declare function restoreRevision(opts: RestoreRevisionOptions): Promise<Revision>;
+//# sourceMappingURL=history-restorer.d.ts.map

package/dist/history-restorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-restorer.d.ts","sourceRoot":"","sources":["../src/history-restorer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AACpD,OAAO,KAAK,EAAE,eAAe,EAAE,QAAQ,EAAuC,MAAM,cAAc,CAAA;AAElG,MAAM,WAAW,sBAAsB;IACrC,qDAAqD;IACrD,OAAO,EAAE,eAAe,CAAA;IACxB,uEAAuE;IACvE,WAAW,EAAE,WAAW,CAAA;IACxB,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAA;IAClB,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,sBAAsB,GAAG,OAAO,CAAC,QAAQ,CAAC,CAyErF"}

package/dist/history-restorer.js

@@ -0,0 +1,137 @@
+/**
+ * Apply a past revision's snapshot to a target's content tree.
+ *
+ * This is the write side of undo / rollback. Design-publishing.md:
+ *   "Undo and rollback restore a prior revision — both are soft
+ *    (forward-only; create a new revision reverting to the past state,
+ *    never destroy history)."
+ *
+ * Algorithm:
+ *   1. Load the target revision's snapshot (itemPath → blob hash).
+ *   2. Diff against the current on-disk content (via the HistoryProvider's
+ *      most-recent revision). Anything present now but absent from the
+ *      target snapshot is deleted; everything in the snapshot is written
+ *      from its blob.
+ *   3. Record a new revision with operation='rollback' and
+ *      restoredFrom=<targetRevId>, so the audit trail shows where the
+ *      state came from and history stays forward-only.
+ *
+ * The caller (admin-api / CLI) owns orchestration — picking which
+ * revision to restore (head-1 for undo, arbitrary for rollback) and
+ * any side effects beyond the content tree (e.g., sidecar writer
+ * invalidation).
+ */
+/**
+ * Restore `revisionId`'s content onto the target. Writes any items
+ * present in the snapshot (content fetched via `readBlob`); deletes
+ * items that exist today but aren't in the restored snapshot. Returns
+ * the new forward revision — always operation='rollback' so audit
+ * consumers can distinguish restores from normal saves/publishes.
+ */
+export async function restoreRevision(opts) {
+    const { history, contentRoot, revisionId } = opts;
+    const target = await history.readRevision(revisionId);
+    // Current state = the most recent revision's snapshot. If none
+    // exists yet we're restoring onto an empty tree — nothing to delete
+    // and no "unchanged" entries to skip.
+    const currentSnapshot = await loadHeadSnapshot(history);
+    const toDelete = Object.keys(currentSnapshot).filter(p => !(p in target.snapshot));
+    // Only write items whose blob hash differs from what's currently on
+    // disk (per head snapshot). Without this, restoring typically rewrites
+    // every item in the snapshot — an undo of a single-page edit would
+    // touch every page + fragment manifest, triggering a storm of file-
+    // watch events and SSE reloads in the dev server. Equal hashes →
+    // same content → skip the write.
+    const toWrite = Object.entries(target.snapshot).filter(([path, hash]) => currentSnapshot[path] !== hash);
+    // Delete first: rolling back a "delete" in the old revision means the
+    // item came back; rolling back an "add" means the item goes away.
+    // Delete-before-write keeps storage from briefly holding both.
+    for (const path of toDelete) {
+        const abs = contentRoot.path(path);
+        try {
+            await contentRoot.storage.rm(abs);
+        }
+        catch {
+            // Best-effort: a missing path at rm time is fine (already gone).
+        }
+    }
+    for (const [path, hash] of toWrite) {
+        const bytes = await history.readBlob(hash);
+        const abs = contentRoot.path(path);
+        const parent = abs.substring(0, abs.lastIndexOf('/'));
+        if (parent)
+            await contentRoot.storage.mkdir(parent);
+        // Restore via writeBytes — uniform bytes-in for both text and
+        // binary content. Text blobs are UTF-8-encoded bytes
+        // (indistinguishable from what writeFile would have stored);
+        // binary blobs (asset bytes, variants) round-trip raw.
+        await contentRoot.storage.writeBytes(abs, bytes);
+    }
+    // After restoring manifests, rebuild the asset-refs sidecar index.
+    // Manifests are the source of truth; a restore can change which
+    // assets and fragments each item references, which would leave the
+    // per-edge dep sidecars stale. Easier to rebuild than diff per-item —
+    // we have the full set of post-restore manifests on disk.
+    if (toWrite.length > 0 || toDelete.length > 0) {
+        try {
+            const { loadSite } = await import('./site-loader.js');
+            const { rebuildDepIndex } = await import('./publish-rendered.js');
+            const { ASSET_REFS } = await import('./assets/asset-deps.js');
+            const { FRAGMENT_DEPS } = await import('./fragment-deps.js');
+            const site = await loadSite({ contentRoot });
+            await Promise.all([
+                rebuildDepIndex(ASSET_REFS, site, contentRoot.storage, contentRoot.rootPath),
+                rebuildDepIndex(FRAGMENT_DEPS, site, contentRoot.storage, contentRoot.rootPath),
+            ]);
+        }
+        catch (err) {
+            // Non-fatal: if site.yaml is missing or load fails, dep indices
+            // might drift. Reindex CLI recovers.
+            // eslint-disable-next-line no-console
+            console.warn(`dep-sidecar rebuild after restore failed: ${err.message}`);
+        }
+    }
+    // Record a new forward revision capturing the restored state. Uses
+    // the same snapshot we just wrote — no need to re-read from disk.
+    return recordFromSnapshot(history, target, {
+        operation: 'rollback',
+        restoredFrom: revisionId,
+        author: opts.author,
+        message: opts.message,
+    });
+}
+/**
+ * Re-record an existing snapshot as a forward revision. Blobs already
+ * exist (they're the same content), so the HistoryProvider's exists()
+ * check skips the writes — cheap.
+ *
+ * Items map carries `Uint8Array` because that's what `readBlob`
+ * returns. Text and binary blobs round-trip identically — the
+ * provider hashes raw bytes either way, so dedup holds.
+ */
+async function recordFromSnapshot(history, target, meta) {
+    const items = new Map();
+    for (const [path, hash] of Object.entries(target.snapshot)) {
+        items.set(path, await history.readBlob(hash));
+    }
+    return history.recordRevision({
+        operation: meta.operation,
+        author: meta.author,
+        message: meta.message,
+        restoredFrom: meta.restoredFrom,
+        items,
+    });
+}
+/**
+ * Head revision's snapshot, or `{}` if there are no revisions yet.
+ * Used by restore to figure out what's currently on-disk and needs
+ * deleting when the restored revision doesn't include it.
+ */
+async function loadHeadSnapshot(history) {
+    const [head] = await history.listRevisions(1);
+    if (!head)
+        return {};
+    const m = await history.readRevision(head.id);
+    return m.snapshot;
+}
+//# sourceMappingURL=history-restorer.js.map

package/dist/history-restorer.js.map

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

package/dist/history.d.ts

@@ -0,0 +1,129 @@
+/**
+ * History / revisions for a target.
+ *
+ * Every write to a target (save or publish) records a revision. Undo and
+ * rollback restore a prior revision — both are soft (forward-only; create
+ * a new revision reverting to the past state, never destroy history).
+ *
+ * Storage layout per target (all inside the target's storage, in the
+ * reserved `.gazetta/` namespace that the runtime never reads):
+ *
+ *   .gazetta/
+ *     history/
+ *       index.json              ordered revision list
+ *       objects/<hh>/<rest>     content-addressed blobs, sharded by first 2 hex chars
+ *       revisions/rev-NNNN.json revision manifest: metadata + item→hash map
+ *
+ * One uniform approach across all storage providers — the provider
+ * interface remains read/write bytes at paths; no provider-native
+ * versioning (S3 object versions, git commits) is used.
+ *
+ * This module declares the types and provider interface. Implementation
+ * lands in a later phase.
+ */
+/** Operation that produced a revision. */
+export type RevisionOperation = 'save' | 'publish' | 'rollback';
+/** Metadata + item→hash snapshot for one write to a target. */
+export interface Revision {
+    /** Unique id, typically `rev-{NNNN}` with a zero-padded counter. */
+    id: string;
+    /** ISO 8601 timestamp when the revision was recorded. */
+    timestamp: string;
+    /** What kind of write this was. */
+    operation: RevisionOperation;
+    /** Author identifier. Free-form for v1; upgrades to auth identity later. */
+    author?: string;
+    /** Source target name, if this revision was produced by a publish from another target. */
+    source?: string;
+    /** Paths of items affected by this write (e.g. `pages/home`, `fragments/header`). */
+    items: string[];
+    /** Optional human-readable note. */
+    message?: string;
+    /** For rollback/restore: the revision id this one restored from. */
+    restoredFrom?: string;
+}
+/** Full revision manifest as stored in `revisions/rev-NNNN.json`. */
+export interface RevisionManifest extends Revision {
+    /**
+     * Snapshot of the full content tree at this revision, as `path → content hash`.
+     * The hash references a blob under `.gazetta/history/objects/`.
+     * Unchanged items across revisions share blobs (content-addressed dedupe).
+     */
+    snapshot: Record<string, string>;
+}
+/** Retention policy for a target's history. */
+export interface HistoryRetention {
+    /** Keep at most N most-recent revisions. Default: 50. Oldest evicted. */
+    maxRevisions?: number;
+}
+/**
+ * Content carried in a revision snapshot — either UTF-8 text (for JSON
+ * manifests, YAML, HTML, CSS, JS) or raw bytes (asset bytes, variants,
+ * fonts). The provider hashes either via SHA-256 over the raw bytes
+ * (text encoded as UTF-8 first), so dedup works uniformly: identical
+ * text and identical bytes share a blob.
+ *
+ * Per Q9 lock, one blob store, mixed content. The public `readBlob`
+ * always returns bytes; callers that expect text decode on read.
+ */
+export type BlobContent = string | Uint8Array;
+/** Input to `recordRevision` — metadata plus the current content tree. */
+export interface RevisionInput {
+    operation: RevisionOperation;
+    /** Author identifier (free-form for v1). */
+    author?: string;
+    /** Source target, when this revision was produced by a publish. */
+    source?: string;
+    /** Optional human-readable note. */
+    message?: string;
+    /** For rollback/restore: the revision id this one restored from. */
+    restoredFrom?: string;
+    /**
+     * Full content tree snapshot at this revision: `itemPath → content`.
+     * Content is `string | Uint8Array` — text and binary first-class
+     * (asset bytes, variants, fonts; per Q9 lock).
+     *
+     * Unchanged items should carry identical content across calls so the
+     * provider can dedupe via content-addressing.
+     */
+    items: Map<string, BlobContent>;
+}
+/**
+ * Uniform history API. Implemented on top of any StorageProvider — reads
+ * and writes bytes under `.gazetta/history/`. No provider-native
+ * versioning (S3 object versions, git commits) is used.
+ */
+export interface HistoryProvider {
+    /**
+     * Record a new revision on the target.
+     *
+     * Writes any new item blobs to `objects/<hash[:2]>/<hash[2:]>`, writes
+     * the revision manifest to `revisions/rev-NNNN.json`, updates
+     * `index.json`, and applies retention (evicts oldest if over limit).
+     *
+     * `items` parameter carries the full content tree; only blobs that
+     * don't already exist are written. Returns the recorded Revision.
+     */
+    recordRevision(input: RevisionInput): Promise<Revision>;
+    /** List revisions, newest first. `limit` caps the list size. */
+    listRevisions(limit?: number): Promise<Revision[]>;
+    /** Read a revision's full manifest (metadata + snapshot). */
+    readRevision(id: string): Promise<RevisionManifest>;
+    /**
+     * Read a content blob by hash. Returns raw bytes — callers that
+     * expect text (page/fragment manifests, site.yaml) decode UTF-8 on
+     * receipt. Callers that expect binary (asset bytes, variants) use
+     * the bytes as-is.
+     *
+     * The pre-step-20 signature returned `string`. The widening to
+     * `Uint8Array` is a foundation contract change; existing string
+     * consumers must wrap with `new TextDecoder().decode(bytes)`.
+     */
+    readBlob(hash: string): Promise<Uint8Array>;
+    /**
+     * Delete a revision and its manifest. Orphaned blobs are garbage-
+     * collected by the implementation (lazy or immediate, adapter's choice).
+     */
+    deleteRevision(id: string): Promise<void>;
+}
+//# sourceMappingURL=history.d.ts.map

package/dist/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../src/history.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,0CAA0C;AAC1C,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,CAAA;AAE/D,+DAA+D;AAC/D,MAAM,WAAW,QAAQ;IACvB,oEAAoE;IACpE,EAAE,EAAE,MAAM,CAAA;IACV,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAA;IACjB,mCAAmC;IACnC,SAAS,EAAE,iBAAiB,CAAA;IAC5B,4EAA4E;IAC5E,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,0FAA0F;IAC1F,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,qFAAqF;IACrF,KAAK,EAAE,MAAM,EAAE,CAAA;IACf,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,qEAAqE;AACrE,MAAM,WAAW,gBAAiB,SAAQ,QAAQ;IAChD;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC;AAED,+CAA+C;AAC/C,MAAM,WAAW,gBAAgB;IAC/B,yEAAyE;IACzE,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,UAAU,CAAA;AAE7C,0EAA0E;AAC1E,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,iBAAiB,CAAA;IAC5B,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,oCAAoC;IACpC,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;;;;;;OAOG;IACH,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;CAChC;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;;;;OASG;IACH,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAEvD,gEAAgE;IAChE,aAAa,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAA;IAElD,6DAA6D;IAC7D,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;IAEnD;;;;;;;;;OASG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAA;IAE3C;;;OAGG;IACH,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1C"}

package/dist/history.js

@@ -0,0 +1,25 @@
+/**
+ * History / revisions for a target.
+ *
+ * Every write to a target (save or publish) records a revision. Undo and
+ * rollback restore a prior revision — both are soft (forward-only; create
+ * a new revision reverting to the past state, never destroy history).
+ *
+ * Storage layout per target (all inside the target's storage, in the
+ * reserved `.gazetta/` namespace that the runtime never reads):
+ *
+ *   .gazetta/
+ *     history/
+ *       index.json              ordered revision list
+ *       objects/<hh>/<rest>     content-addressed blobs, sharded by first 2 hex chars
+ *       revisions/rev-NNNN.json revision manifest: metadata + item→hash map
+ *
+ * One uniform approach across all storage providers — the provider
+ * interface remains read/write bytes at paths; no provider-native
+ * versioning (S3 object versions, git commits) is used.
+ *
+ * This module declares the types and provider interface. Implementation
+ * lands in a later phase.
+ */
+export {};
+//# sourceMappingURL=history.js.map

package/dist/history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.js","sourceRoot":"","sources":["../src/history.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG"}

package/dist/index.d.ts

@@ -1,9 +1,29 @@
-export type { RenderOutput, TemplateFunction, EditorMount, FieldMount, TemplateModule, ComponentManifest, FragmentManifest, PageManifest, SiteManifest, ResolvedComponent, TargetConfig, StorageConfig, WorkerConfig, CacheConfig, DirEntry, StorageProvider, PurgeStrategy, } from './types.js';
-export { getPublishMode } from './types.js';
-export { renderComponent, renderFragment, renderPage } from './renderer.js';
+export type { RenderOutput, TemplateFunction, EditorMount, FieldMount, TemplateModule, ComponentManifest, FragmentManifest, PageManifest, SiteManifest, ResolvedComponent, TargetConfig, StorageConfig, WorkerConfig, CacheConfig, DirEntry, StorageProvider, ByteRange, PurgeStrategy, } from './types.js';
+export { getType, isEditable } from './types.js';
+export type { TargetType } from './types.js';
+export { createTargetRegistryView, listEditableTargets, UnknownTargetError, NoEditableTargetError, } from './targets.js';
+export type { TargetRegistry } from './targets.js';
+export { createContentRoot } from './content-root.js';
+export type { ContentRoot } from './content-root.js';
+export { createSourceContext, createSourceContextFromRegistry } from './admin-api/source-context.js';
+export type { SourceContext } from './admin-api/source-context.js';
+export type { HistoryProvider, Revision, RevisionInput, RevisionManifest, RevisionOperation, HistoryRetention, } from './history.js';
+export { createHistoryProvider } from './history-provider.js';
+export type { CreateHistoryProviderOptions } from './history-provider.js';
+export { recordWrite, DEFAULT_SCAN_LOCATIONS, DEFAULT_SCAN_ROOT_FILES, } from './history-recorder.js';
+export type { RecordWriteOptions, WrittenItem, ScanLocation, } from './history-recorder.js';
+export { restoreRevision } from './history-restorer.js';
+export type { RestoreRevisionOptions } from './history-restorer.js';
+export { isHistoryEnabled, getHistoryRetention, DEFAULT_HISTORY_RETENTION, } from './types.js';
+export type { HistoryConfig, LocalesConfig, PageMetadata } from './types.js';
+export { isValidLocale, normalizeLocale, defaultLocaleFor, resolveSiteLocales, resolveTargetLocales, localeFromFilename, localeFilename, resolveLocaleFallback, localeRoutePrefix, } from './locale.js';
+export type { ResolvedLocales } from './locale.js';
+export { renderComponent, renderFragment, renderPage, type RenderPageOptions, type SeoContext, } from './renderer.js';
+export { resolveSeoTags, type ResolveSeoTagsInput } from './seo.js';
 export { resolveComponent, resolveFragment, resolvePage } from './resolver.js';
 export { loadSite } from './site-loader.js';
-export type { Site, LoadSiteOptions } from './site-loader.js';
+export type { Site, LocalizedEntry, PageEntry, FragmentEntry, LoadSiteOptions } from './site-loader.js';
+export { allPageEntries, allFragmentEntries } from './site-loader.js';
 export { loadTemplate, invalidateTemplate, invalidateAllTemplates } from './template-loader.js';
 export { scopeHtml, scopeCss, hashPath } from './scope.js';
 export { createFilesystemProvider } from './providers/filesystem.js';
@@ -11,13 +31,13 @@ export { createAzureBlobProvider } from './providers/azure-blob.js';
 export type { AzureBlobProviderOptions } from './providers/azure-blob.js';
 export { createS3Provider } from './providers/s3.js';
 export type { S3ProviderOptions } from './providers/s3.js';
-export { createR2RestProvider } from './providers/r2.js';
-export type { R2RestProviderOptions } from './providers/r2.js';
 export { createStorageProvider, createTargetRegistry } from './targets.js';
+export { bootstrapFromSiteYaml, buildSourceContext } from './cli/bootstrap.js';
+export type { BootstrapResult, BuildSourceContextOptions } from './cli/bootstrap.js';
 export { createServer } from './serve.js';
 export type { ServeOptions } from './serve.js';
 export { publishItems, resolveDependencies } from './publish.js';
-export { publishPageRendered, publishPageStatic, publishFragmentRendered, publishSiteManifest, publishFragmentIndex, publishFragmentWithPurge, publishPageWithPurge } from './publish-rendered.js';
+export { publishPageRendered, publishPageStatic, publishFragmentRendered, publishSiteManifest, publishDepIndices, } from './publish-rendered.js';
 export { format } from './formats.js';
 export { assembleEsi, parseCacheComment, splitFragment, findEsiPaths } from './assemble.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,WAAW,EACX,UAAU,EACV,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,WAAW,EACX,QAAQ,EACR,eAAe,EACf,aAAa,GACd,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAG3C,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAC3E,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC9E,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAC7D,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAA;AAC/F,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAG1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAA;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAA;AACnE,YAAY,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAA;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAA;AACpD,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AACxD,YAAY,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAA;AAG9D,OAAO,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAA;AAG1E,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACzC,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAG9C,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAChE,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAA;AAGlM,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAGrC,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,22 +1,34 @@
-export { getPublishMode } from './types.js';
+export { getType, isEditable } from './types.js';
+export { createTargetRegistryView, listEditableTargets, UnknownTargetError, NoEditableTargetError, } from './targets.js';
+export { createContentRoot } from './content-root.js';
+export { createSourceContext, createSourceContextFromRegistry } from './admin-api/source-context.js';
+export { createHistoryProvider } from './history-provider.js';
+export { recordWrite, DEFAULT_SCAN_LOCATIONS, DEFAULT_SCAN_ROOT_FILES, } from './history-recorder.js';
+export { restoreRevision } from './history-restorer.js';
+export { isHistoryEnabled, getHistoryRetention, DEFAULT_HISTORY_RETENTION, } from './types.js';
+// Locale resolution
+export { isValidLocale, normalizeLocale, defaultLocaleFor, resolveSiteLocales, resolveTargetLocales, localeFromFilename, localeFilename, resolveLocaleFallback, localeRoutePrefix, } from './locale.js';
 // Renderer
-export { renderComponent, renderFragment, renderPage } from './renderer.js';
+export { renderComponent, renderFragment, renderPage, } from './renderer.js';
+export { resolveSeoTags } from './seo.js';
 export { resolveComponent, resolveFragment, resolvePage } from './resolver.js';
 export { loadSite } from './site-loader.js';
+export { allPageEntries, allFragmentEntries } from './site-loader.js';
 export { loadTemplate, invalidateTemplate, invalidateAllTemplates } from './template-loader.js';
 export { scopeHtml, scopeCss, hashPath } from './scope.js';
 // Storage providers
 export { createFilesystemProvider } from './providers/filesystem.js';
 export { createAzureBlobProvider } from './providers/azure-blob.js';
 export { createS3Provider } from './providers/s3.js';
-export { createR2RestProvider } from './providers/r2.js';
 // Targets
 export { createStorageProvider, createTargetRegistry } from './targets.js';
+// Bootstrap helpers — read site.yaml, build registry, derive SourceContext
+export { bootstrapFromSiteYaml, buildSourceContext } from './cli/bootstrap.js';
 // Server
 export { createServer } from './serve.js';
 // Publish
 export { publishItems, resolveDependencies } from './publish.js';
-export { publishPageRendered, publishPageStatic, publishFragmentRendered, publishSiteManifest, publishFragmentIndex, publishFragmentWithPurge, publishPageWithPurge } from './publish-rendered.js';
+export { publishPageRendered, publishPageStatic, publishFragmentRendered, publishSiteManifest, publishDepIndices, } from './publish-rendered.js';
 // Format helpers
 export { format } from './formats.js';
 // ESI assembly (for edge workers and servers)