gazetta 0.4.0 → 0.6.0

package/dist/cli/bootstrap.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Shared bootstrap helpers for CLI commands and the dev server admin bootstrap.
+ *
+ * Responsibility: read site.yaml from the project site directory, build a
+ * TargetRegistry from its targets, and derive a SourceContext pointing at
+ * the default editable target. Callers compose these primitives; the admin
+ * API and `createApp` runtime take over from there.
+ */
+import type { SiteManifest, TargetConfig } from '../types.js';
+import { type SourceContext } from '../admin-api/source-context.js';
+import type { TargetRegistry } from '../targets.js';
+import type { SourceSidecarWriter } from '../source-sidecars.js';
+export interface BootstrapResult {
+    /** Parsed site.yaml content. */
+    manifest: SiteManifest;
+    /** Target configurations declared in site.yaml. */
+    targetConfigs: Record<string, TargetConfig>;
+    /** Fully-initialized target registry (providers built, cloud targets connected). */
+    registry: TargetRegistry;
+}
+/**
+ * Read site.yaml, initialize all targets, and return a TargetRegistry view.
+ * Throws if site.yaml is missing or has no targets declared.
+ */
+export declare function bootstrapFromSiteYaml(projectSiteDir: string): Promise<BootstrapResult>;
+export interface BuildSourceContextOptions {
+    projectSiteDir: string;
+    /** Pre-parsed manifest to avoid re-reading site.yaml when caller already has it. */
+    manifest?: SiteManifest;
+    /** Explicit target name. Defaults to the registry's defaultEditable(). */
+    targetName?: string;
+    sidecarWriter?: SourceSidecarWriter;
+}
+/**
+ * High-level: read site.yaml, init only the chosen editable target, return a
+ * SourceContext and metadata. Cloud/remote targets are not initialized —
+ * callers that need them (publish, fetch, compare) init on demand.
+ *
+ * Rationale: validate and dev-bootstrap only need the source (editable local)
+ * target; initializing cloud targets upfront adds seconds of latency and
+ * surfaces spurious failures when credentials aren't configured.
+ */
+export declare function buildSourceContext(opts: BuildSourceContextOptions): Promise<{
+    source: SourceContext;
+    manifest: SiteManifest;
+    targetConfigs: Record<string, TargetConfig>;
+}>;
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/cli/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/cli/bootstrap.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAmB,MAAM,aAAa,CAAA;AAC9E,OAAO,EAAmC,KAAK,aAAa,EAAE,MAAM,gCAAgC,CAAA;AACpG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AACnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAEhE,MAAM,WAAW,eAAe;IAC9B,gCAAgC;IAChC,QAAQ,EAAE,YAAY,CAAA;IACtB,mDAAmD;IACnD,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IAC3C,oFAAoF;IACpF,QAAQ,EAAE,cAAc,CAAA;CACzB;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAe5F;AAED,MAAM,WAAW,yBAAyB;IACxC,cAAc,EAAE,MAAM,CAAA;IACtB,oFAAoF;IACpF,QAAQ,CAAC,EAAE,YAAY,CAAA;IACvB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,aAAa,CAAC,EAAE,mBAAmB,CAAA;CACpC;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,yBAAyB,GAAG,OAAO,CAAC;IACjF,MAAM,EAAE,aAAa,CAAA;IACrB,QAAQ,EAAE,YAAY,CAAA;IACtB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;CAC5C,CAAC,CAsDD"}

package/dist/cli/bootstrap.js

@@ -0,0 +1,85 @@
+/**
+ * Shared bootstrap helpers for CLI commands and the dev server admin bootstrap.
+ *
+ * Responsibility: read site.yaml from the project site directory, build a
+ * TargetRegistry from its targets, and derive a SourceContext pointing at
+ * the default editable target. Callers compose these primitives; the admin
+ * API and `createApp` runtime take over from there.
+ */
+import { join } from 'node:path';
+import { readFileSync } from 'node:fs';
+import yaml from 'js-yaml';
+import { createTargetRegistry, createTargetRegistryView } from '../targets.js';
+import { createSourceContextFromRegistry } from '../admin-api/source-context.js';
+/**
+ * Read site.yaml, initialize all targets, and return a TargetRegistry view.
+ * Throws if site.yaml is missing or has no targets declared.
+ */
+export async function bootstrapFromSiteYaml(projectSiteDir) {
+    const siteYamlPath = join(projectSiteDir, 'site.yaml');
+    const manifest = yaml.load(readFileSync(siteYamlPath, 'utf-8'));
+    const targetConfigs = manifest.targets ?? {};
+    if (Object.keys(targetConfigs).length === 0) {
+        throw new Error(`No targets declared in ${siteYamlPath}. At least one target is required — ` +
+            `add a local target:\n\ntargets:\n  local:\n    storage:\n      type: filesystem\n`);
+    }
+    const providers = await createTargetRegistry(targetConfigs, projectSiteDir);
+    const registry = createTargetRegistryView(providers, targetConfigs);
+    return { manifest, targetConfigs, registry };
+}
+/**
+ * High-level: read site.yaml, init only the chosen editable target, return a
+ * SourceContext and metadata. Cloud/remote targets are not initialized —
+ * callers that need them (publish, fetch, compare) init on demand.
+ *
+ * Rationale: validate and dev-bootstrap only need the source (editable local)
+ * target; initializing cloud targets upfront adds seconds of latency and
+ * surfaces spurious failures when credentials aren't configured.
+ */
+export async function buildSourceContext(opts) {
+    const siteYamlPath = join(opts.projectSiteDir, 'site.yaml');
+    const manifest = opts.manifest ?? yaml.load(readFileSync(siteYamlPath, 'utf-8'));
+    const targetConfigs = manifest.targets ?? {};
+    if (Object.keys(targetConfigs).length === 0) {
+        throw new Error(`No targets declared in ${siteYamlPath}. At least one target is required — ` +
+            `add a local target:\n\ntargets:\n  local:\n    storage:\n      type: filesystem\n`);
+    }
+    // Pick the editable target (explicit override or first editable in declaration order).
+    const { isEditable } = await import('../types.js');
+    const editableNames = Object.entries(targetConfigs)
+        .filter(([, cfg]) => isEditable(cfg))
+        .map(([n]) => n);
+    if (editableNames.length === 0) {
+        throw new Error(`No editable target in ${siteYamlPath}. Add one:\n\n` +
+            `targets:\n  local:\n    storage:\n      type: filesystem\n`);
+    }
+    const targetName = opts.targetName ?? editableNames[0];
+    const config = targetConfigs[targetName];
+    if (!config) {
+        const { UnknownTargetError } = await import('../targets.js');
+        throw new UnknownTargetError(targetName);
+    }
+    if (!isEditable(config)) {
+        throw new Error(`Target "${targetName}" is not editable`);
+    }
+    // Init only the chosen target's provider.
+    const { createStorageProvider } = await import('../targets.js');
+    const storage = await createStorageProvider(config.storage, opts.projectSiteDir, targetName);
+    const initProvider = storage;
+    if (typeof initProvider.init === 'function') {
+        await initProvider.init();
+    }
+    // Build a single-target view; callers that need cross-target access call
+    // bootstrapFromSiteYaml() instead (or use admin-api's lazy target init).
+    const singleTargetProviders = new Map([[targetName, storage]]);
+    const registry = createTargetRegistryView(singleTargetProviders, targetConfigs);
+    const source = createSourceContextFromRegistry({
+        registry,
+        targetName,
+        projectSiteDir: opts.projectSiteDir,
+        sidecarWriter: opts.sidecarWriter,
+        manifest,
+    });
+    return { source, manifest, targetConfigs };
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/cli/bootstrap.js.map

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

package/dist/cli/history.d.ts

@@ -0,0 +1,45 @@
+/**
+ * CLI history commands.
+ *
+ *   gazetta history [target]           — list revisions, newest first
+ *   gazetta undo [target]              — restore the revision just before
+ *                                        head (the "undo last write" shortcut)
+ *   gazetta rollback <rev> [target]    — restore an arbitrary revision by id
+ *
+ * All three reuse the admin-api's HistoryProvider + restoreRevision —
+ * CLI and web surface the same operations. SRP: this file glues the
+ * CLI to the core; no new domain logic.
+ *
+ * Destructive ops (undo, rollback) prompt for confirmation on prod
+ * targets when running interactively. `CI=true` disables the prompt
+ * and fails if `--yes` wasn't passed.
+ */
+import type { TargetConfig } from '../types.js';
+/** Shared context passed to every command handler. */
+export interface HistoryCommandContext {
+    siteDir: string;
+    targetName: string;
+    config: TargetConfig;
+}
+/**
+ * `gazetta history [target]` — print the revision list, newest first.
+ */
+export declare function runHistoryList(ctx: HistoryCommandContext, opts?: {
+    limit?: number;
+}): Promise<void>;
+/**
+ * `gazetta undo [target]` — restore the revision just before head.
+ * Needs at least two revisions (baseline + one write). Records a
+ * forward rollback.
+ */
+export declare function runHistoryUndo(ctx: HistoryCommandContext, opts?: {
+    yes?: boolean;
+}): Promise<void>;
+/**
+ * `gazetta rollback <rev> [target]` — restore an arbitrary revision.
+ * Records a forward rollback.
+ */
+export declare function runHistoryRollback(ctx: HistoryCommandContext, revisionId: string, opts?: {
+    yes?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=history.d.ts.map

package/dist/cli/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../src/cli/history.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAOH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE/C,sDAAsD;AACtD,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,YAAY,CAAA;CACrB;AA0CD;;GAEG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,qBAAqB,EAAE,IAAI,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAkB7G;AA0BD;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,qBAAqB,EAAE,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAsB5G;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,qBAAqB,EAC1B,UAAU,EAAE,MAAM,EAClB,IAAI,GAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAA;CAAO,GAC3B,OAAO,CAAC,IAAI,CAAC,CA2Bf"}

package/dist/cli/history.js

@@ -0,0 +1,165 @@
+/**
+ * CLI history commands.
+ *
+ *   gazetta history [target]           — list revisions, newest first
+ *   gazetta undo [target]              — restore the revision just before
+ *                                        head (the "undo last write" shortcut)
+ *   gazetta rollback <rev> [target]    — restore an arbitrary revision by id
+ *
+ * All three reuse the admin-api's HistoryProvider + restoreRevision —
+ * CLI and web surface the same operations. SRP: this file glues the
+ * CLI to the core; no new domain logic.
+ *
+ * Destructive ops (undo, rollback) prompt for confirmation on prod
+ * targets when running interactively. `CI=true` disables the prompt
+ * and fails if `--yes` wasn't passed.
+ */
+import { createInterface } from 'node:readline/promises';
+import { createHistoryProvider } from '../history-provider.js';
+import { restoreRevision } from '../history-restorer.js';
+import { createContentRoot } from '../content-root.js';
+import { isHistoryEnabled, getHistoryRetention, getEnvironment } from '../types.js';
+/** Format an ISO timestamp as "Apr 16, 2026 · 11:05" for humans. */
+function formatTimestamp(iso) {
+    const d = new Date(iso);
+    return d
+        .toLocaleString('en-US', {
+        month: 'short',
+        day: 'numeric',
+        year: 'numeric',
+        hour: '2-digit',
+        minute: '2-digit',
+        hour12: false,
+    })
+        .replace(',', ' ·');
+}
+/** Abbreviate an items list for single-line display. */
+function formatItems(items) {
+    if (items.length === 0)
+        return '(none)';
+    if (items.length <= 3)
+        return items.join(', ');
+    return `${items.slice(0, 3).join(', ')} + ${items.length - 3} more`;
+}
+/**
+ * Buid a HistoryProvider for the given target. Throws with a friendly
+ * message when history is disabled — prevents the CLI from silently
+ * returning an empty list for a target the user explicitly targeted.
+ */
+async function buildHistory(ctx) {
+    if (!isHistoryEnabled(ctx.config)) {
+        throw new Error(`History disabled on target "${ctx.targetName}" (site.yaml: history.enabled: false)`);
+    }
+    const { createStorageProvider } = await import('../targets.js');
+    const storage = await createStorageProvider(ctx.config.storage, ctx.siteDir, ctx.targetName);
+    const maybeInit = storage;
+    if (typeof maybeInit.init === 'function')
+        await maybeInit.init();
+    const history = createHistoryProvider({ storage, retention: getHistoryRetention(ctx.config) });
+    const contentRoot = createContentRoot(storage);
+    return { history, contentRoot, storage };
+}
+/**
+ * `gazetta history [target]` — print the revision list, newest first.
+ */
+export async function runHistoryList(ctx, opts = {}) {
+    const { history } = await buildHistory(ctx);
+    const revisions = await history.listRevisions(opts.limit ?? 50);
+    if (revisions.length === 0) {
+        console.log(`\n  No revisions on "${ctx.targetName}" yet. Saves and publishes will record here.\n`);
+        return;
+    }
+    console.log(`\n  History — ${ctx.targetName} (${revisions.length} revision${revisions.length === 1 ? '' : 's'})\n`);
+    for (const rev of revisions) {
+        const op = rev.operation.padEnd(8);
+        const time = formatTimestamp(rev.timestamp);
+        const suffix = rev.source ? `  (from ${rev.source})` : '';
+        const message = rev.message ? `  — ${rev.message}` : '';
+        console.log(`    ${rev.id}  ${op}  ${time}${suffix}${message}`);
+        console.log(`      items: ${formatItems(rev.items)}`);
+    }
+    console.log();
+}
+async function confirm(prompt) {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        const ans = (await rl.question(`${prompt} [y/N] `)).trim().toLowerCase();
+        return ans === 'y' || ans === 'yes';
+    }
+    finally {
+        rl.close();
+    }
+}
+/**
+ * Production targets require explicit confirmation. In CI (`CI=true`)
+ * the only way to confirm is `--yes` — we never prompt a non-tty.
+ */
+async function confirmDestructive(ctx, action, flagYes) {
+    const isProd = getEnvironment(ctx.config) === 'production';
+    if (!isProd)
+        return true;
+    if (flagYes)
+        return true;
+    if (process.env.CI) {
+        throw new Error(`${action} on production target "${ctx.targetName}" in CI requires --yes to proceed`);
+    }
+    return confirm(`  ${action} on production target "${ctx.targetName}" — continue?`);
+}
+/**
+ * `gazetta undo [target]` — restore the revision just before head.
+ * Needs at least two revisions (baseline + one write). Records a
+ * forward rollback.
+ */
+export async function runHistoryUndo(ctx, opts = {}) {
+    const { history, contentRoot } = await buildHistory(ctx);
+    const recent = await history.listRevisions(2);
+    if (recent.length < 2) {
+        throw new Error(`Nothing to undo — no prior revision on "${ctx.targetName}"`);
+    }
+    const [head, prior] = recent;
+    const proceed = await confirmDestructive(ctx, 'Undo', !!opts.yes);
+    if (!proceed) {
+        console.log('  Cancelled.');
+        return;
+    }
+    const restored = await restoreRevision({
+        history,
+        contentRoot,
+        revisionId: prior.id,
+        message: `Undo ${head.operation} (rev ${head.id})`,
+    });
+    console.log(`\n  ✓ Undone. ${ctx.targetName} is now at ${prior.id} (${prior.operation} @ ${formatTimestamp(prior.timestamp)})`);
+    console.log(`    Forward revision: ${restored.id}\n`);
+}
+/**
+ * `gazetta rollback <rev> [target]` — restore an arbitrary revision.
+ * Records a forward rollback.
+ */
+export async function runHistoryRollback(ctx, revisionId, opts = {}) {
+    if (!revisionId)
+        throw new Error('rollback: missing revision id (pass as positional, e.g. gazetta rollback rev-1776337441608)');
+    const { history, contentRoot } = await buildHistory(ctx);
+    // Fail early if the revision doesn't exist — readRevision gives a
+    // clear ENOENT-style error otherwise, but we can frame it better here.
+    let target;
+    try {
+        target = await history.readRevision(revisionId);
+    }
+    catch {
+        throw new Error(`Unknown revision "${revisionId}" on target "${ctx.targetName}"`);
+    }
+    const proceed = await confirmDestructive(ctx, `Rollback to ${revisionId}`, !!opts.yes);
+    if (!proceed) {
+        console.log('  Cancelled.');
+        return;
+    }
+    const restored = await restoreRevision({
+        history,
+        contentRoot,
+        revisionId,
+        message: `Rollback to ${revisionId}`,
+    });
+    console.log(`\n  ✓ Rolled back. ${ctx.targetName} is now at ${revisionId} (${target.operation} @ ${formatTimestamp(target.timestamp)})`);
+    console.log(`    Forward revision: ${restored.id}\n`);
+}
+//# sourceMappingURL=history.js.map

package/dist/cli/history.js.map

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