@usecds/server 0.0.0-stage → 0.1.1

package/dist/core/publisher.js

@@ -0,0 +1,263 @@
+import path from "path";
+import { deterministicStringify, sha256 } from "../utils.js";
+import { validateCollection, validateReleaseManifest, validateChannelManifest } from "../validation.js";
+import { analyzeStorage } from "./storage-report.js";
+import { analyzeTranslations, inferSourceLocale, toTranslationSummary, DEFAULT_SOURCE_LOCALE } from "./translations.js";
+import { resolveTargets } from "./targets.js";
+import { buildContentReport } from "./content-report.js";
+import { collectMediaUsage, mediaLocales, MEDIA_COLLECTION, validateMediaMetadata } from "./media-metadata.js";
+import { validateJsonLd } from "./jsonld.js";
+import { validateSite } from "./site.js";
+import { validateMenu } from "./menu.js";
+import { validateSettings } from "./settings.js";
+/**
+ * Thrown when content fails a target requirement. Nothing has been written to the store.
+ * The artifacts (including the content report) are attached for the pipeline.
+ */
+export class PublishRequirementsError extends Error {
+    artifacts;
+    constructor(artifacts) {
+        const failed = artifacts.content.issues.filter((i) => i.severity === "requirement");
+        super(`Publish failed: ${failed.length} unmet target requirement(s)\n` +
+            failed.slice(0, 20).map((i) => `  [${i.target}] ${i.collection ? i.collection + (i.id ? "/" + i.id : "") + ": " : ""}${i.message}`).join("\n"));
+        this.artifacts = artifacts;
+        this.name = "PublishRequirementsError";
+    }
+}
+export class Publisher {
+    source;
+    store;
+    config;
+    constructor(source, store, config = {}) {
+        this.source = source;
+        this.store = store;
+        this.config = {
+            retentionCount: 3,
+            ...config
+        };
+    }
+    /**
+     * Compiles the source content and publishes a new release to the object store.
+     * Updates the channel manifest as the final atomic action.
+     */
+    async publish(channel, releaseId, options = {}) {
+        // The content's state is the source's as of this moment (or later): previews use it to drop
+        // edits saved before it, which the release therefore contains
+        const sourceReadAt = new Date().toISOString();
+        const sourceCollections = await this.source.getCollections();
+        const sourceMedia = await this.source.getMedia();
+        const sourceMap = this.source.getSourceMap ? await this.source.getSourceMap() : undefined;
+        // Only media referenced by content is published; the rest (and its _media entries) is ignored
+        const usage = collectMediaUsage(sourceCollections);
+        const rawMedia = sourceMedia.filter((m) => usage.has(m.virtualPath));
+        const warnings = mediaWarnings(sourceCollections, sourceMedia, usage);
+        const published = new Set(rawMedia.map((m) => m.virtualPath));
+        const rawCollections = { ...sourceCollections };
+        if (rawCollections[MEDIA_COLLECTION]) {
+            rawCollections[MEDIA_COLLECTION] = rawCollections[MEDIA_COLLECTION].filter((m) => published.has(m.id));
+        }
+        const itemLocales = (collection, item) => collection === MEDIA_COLLECTION ? mediaLocales(usage, item.id) : undefined;
+        const collectionsMeta = {};
+        const mediaMeta = {};
+        const objects = [];
+        // 1. Normalize, validate and hash collections (nothing is written before all checks pass)
+        for (const [colName, items] of Object.entries(rawCollections)) {
+            const normalizedCollection = {
+                schemaVersion: 1,
+                collection: colName,
+                items: items
+            };
+            // Validate collection against JSON Schema
+            validateCollection(normalizedCollection);
+            // Serialize deterministically and compute SHA-256 hash
+            const serialized = deterministicStringify(normalizedCollection);
+            const hash = sha256(serialized);
+            objects.push({ hash, serialized });
+            // Update release manifest metadata
+            collectionsMeta[colName] = {
+                hash,
+                itemCount: items.length,
+                size: Buffer.byteLength(serialized, "utf-8")
+            };
+        }
+        // 2. Hash media
+        const mediaHashes = rawMedia.map((item) => sha256(item.content));
+        rawMedia.forEach((item, i) => {
+            mediaMeta[item.virtualPath] = {
+                hash: mediaHashes[i],
+                size: item.content.length,
+                mimeType: item.mimeType
+            };
+        });
+        // Media metadata must describe media that is actually in the release
+        if (rawCollections[MEDIA_COLLECTION]) {
+            validateMediaMetadata(rawCollections[MEDIA_COLLECTION], mediaMeta);
+        }
+        // JSON-LD definitions must be valid and refer to existing collections and definitions
+        validateJsonLd(rawCollections);
+        // Optional site structure (_routes, _pages, _blocks, _menu, _site, _languages) must be consistent
+        validateSite(rawCollections);
+        validateMenu(rawCollections);
+        validateSettings(rawCollections);
+        // 3. Measure translation completeness against the source locale and the channel's current release
+        const { locale: sourceLocale, origin } = await this.resolveSourceLocale(options.sourceLocale, rawCollections);
+        const previousCollections = await this.readChannelCollections(channel);
+        const translations = analyzeTranslations(rawCollections, sourceLocale, origin, previousCollections, itemLocales);
+        // 4. Check targets; an unmet requirement fails the build before anything is written
+        const resolved = resolveTargets(options.targets ?? []);
+        const content = buildContentReport(rawCollections, translations, resolved, {
+            sourceMap,
+            itemLocales,
+            mediaPaths: rawMedia.map((m) => m.virtualPath)
+        });
+        content.warnings.push(...warnings);
+        const artifacts = { translations, content, targets: resolved.effective };
+        if (sourceMap) {
+            artifacts.sourceMap = { releaseId, ...sourceMap };
+        }
+        if (content.issues.some((i) => i.severity === "requirement")) {
+            throw new PublishRequirementsError(artifacts);
+        }
+        // 5. Write objects and media to CAS
+        for (const { hash, serialized } of objects) {
+            await this.store.writeObject(hash, serialized);
+        }
+        for (const [i, item] of rawMedia.entries()) {
+            await this.store.writeMedia(mediaHashes[i], path.extname(item.virtualPath), item.content);
+        }
+        // 6. Construct and write the Release Manifest
+        const releaseManifest = {
+            schemaVersion: 1,
+            releaseId,
+            createdAt: new Date().toISOString(),
+            sourceReadAt,
+            collections: collectionsMeta,
+            media: mediaMeta,
+            translations: toTranslationSummary(translations),
+            targets: Object.keys(content.targets).sort()
+        };
+        validateReleaseManifest(releaseManifest);
+        await this.store.writeRelease(releaseId, releaseManifest);
+        // 7. Update the Channel Manifest (LAST atomic step)
+        const channelManifest = {
+            schemaVersion: 1,
+            channel,
+            releaseId,
+            updatedAt: releaseManifest.createdAt
+        };
+        validateChannelManifest(channelManifest);
+        await this.store.writeChannelManifest(channel, channelManifest);
+        // 8. Clean up old releases if they exceed retention limit
+        await this.manageReleaseRetention();
+        return { manifest: releaseManifest, artifacts };
+    }
+    /**
+     * Source locale precedence: publish argument → ContentSource → inferred from markers → "en".
+     */
+    async resolveSourceLocale(argument, collections) {
+        if (argument)
+            return { locale: argument, origin: "argument" };
+        const fromSource = this.source.getSourceLocale ? await this.source.getSourceLocale() : undefined;
+        if (fromSource)
+            return { locale: fromSource, origin: "source" };
+        const inferred = inferSourceLocale(collections);
+        if (inferred)
+            return { locale: inferred, origin: "inferred" };
+        return { locale: DEFAULT_SOURCE_LOCALE, origin: "fallback" };
+    }
+    /**
+     * Reads the collections of the release a channel currently points to, or undefined
+     * if the channel, its release or any of its objects are missing.
+     */
+    async readChannelCollections(channel) {
+        const channelManifest = await this.store.readChannelManifest(channel);
+        if (!channelManifest)
+            return undefined;
+        const release = await this.store.readRelease(channelManifest.releaseId);
+        if (!release)
+            return undefined;
+        const collections = {};
+        for (const [name, meta] of Object.entries(release.collections)) {
+            const content = await this.store.readObject(meta.hash);
+            if (content === null)
+                return undefined;
+            collections[name] = JSON.parse(content).items;
+        }
+        return collections;
+    }
+    /**
+     * Cleans up old releases that exceed the configured retention limit.
+     * Releases that a channel currently points to are never deleted.
+     */
+    async manageReleaseRetention() {
+        const limit = this.config.retentionCount ?? 3;
+        const releases = await this.store.listReleases();
+        // Sort releases lexicographically (or by timestamp if ids are formatted as ISO timestamps)
+        // To be safe, we sort them so latest are at the end, and we delete from the beginning (oldest).
+        releases.sort();
+        if (releases.length > limit) {
+            const pinned = new Set();
+            for (const channel of await this.store.listChannels()) {
+                const manifest = await this.store.readChannelManifest(channel);
+                if (manifest)
+                    pinned.add(manifest.releaseId);
+            }
+            const toDelete = releases.slice(0, releases.length - limit);
+            for (const relId of toDelete) {
+                if (pinned.has(relId))
+                    continue;
+                await this.store.deleteRelease(relId);
+            }
+        }
+    }
+    /**
+     * Reports per-release storage usage, diffs between releases, channel pointers
+     * and orphaned files. Read-only.
+     */
+    async analyzeStorage() {
+        return analyzeStorage(this.store);
+    }
+    /**
+     * Deletes all objects/media not referenced by any retained release.
+     * Deletes exactly the orphans listed in the returned report.
+     */
+    async garbageCollect(options = {}) {
+        const dryRun = options.dryRun ?? false;
+        const report = await analyzeStorage(this.store);
+        let deletedObjects = 0;
+        let deletedMedia = 0;
+        for (const orphan of report.orphans.files) {
+            if (orphan.kind === "object") {
+                if (!dryRun)
+                    await this.store.deleteObject(orphan.hash);
+                deletedObjects++;
+            }
+            else {
+                if (!dryRun)
+                    await this.store.deleteMedia(orphan.file.slice("media/".length));
+                deletedMedia++;
+            }
+        }
+        return { dryRun, deletedObjects, deletedMedia, freedBytes: report.orphans.bytes, report };
+    }
+}
+// Reports media the publisher leaves out, and references to media the source doesn't provide
+function mediaWarnings(collections, media, usage) {
+    const warnings = [];
+    const provided = new Set(media.map((m) => m.virtualPath));
+    for (const path of provided) {
+        if (!usage.has(path))
+            warnings.push(`Media ${path} is not referenced by any item and was not published`);
+    }
+    for (const item of collections[MEDIA_COLLECTION] ?? []) {
+        if (!provided.has(item.id) || !usage.has(item.id)) {
+            warnings.push(`_media entry ${item.id} was ignored because the media isn't published`);
+        }
+    }
+    for (const path of usage.keys()) {
+        if (!provided.has(path))
+            warnings.push(`Media ${path} is referenced but not provided by the source`);
+    }
+    return warnings;
+}
+//# sourceMappingURL=publisher.js.map

package/dist/core/publisher.js.map

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

package/dist/core/report.d.ts

@@ -0,0 +1,54 @@
+import { ReleaseManifest, TranslationCounts } from "../types.js";
+import { ContentIssue, TargetResult } from "./content-report.js";
+import { PublishArtifacts } from "./publisher.js";
+import { SourceLocaleOrigin } from "./translations.js";
+export interface PublishReport {
+    schemaVersion: 1;
+    status: "published" | "failed";
+    channel: string;
+    releaseId: string;
+    createdAt: string;
+    error?: string;
+    summary: {
+        requirements: number;
+        recommendations: number;
+        warnings: number;
+        targets: {
+            satisfied: number;
+            total: number;
+        };
+        translations: TranslationCounts;
+    };
+    release?: {
+        collections: number;
+        items: number;
+        media: number;
+    };
+    targets: Record<string, TargetResult>;
+    translations: {
+        sourceLocale: string;
+        sourceLocaleOrigin: SourceLocaleOrigin;
+        locales: Record<string, TranslationCounts>;
+        collections: Record<string, Record<string, TranslationCounts>>;
+        itemsWithoutSource: {
+            collection: string;
+            id: string;
+        }[];
+    };
+    issues: ContentIssue[];
+    warnings: string[];
+}
+/**
+ * Builds the report for a publish run, successful (with manifest) or failed (with error).
+ */
+export declare function createPublishReport(input: {
+    channel: string;
+    releaseId: string;
+    artifacts: PublishArtifacts;
+    manifest?: ReleaseManifest;
+    error?: Error;
+}): PublishReport;
+/**
+ * Renders a report as a self-contained HTML page (no external resources, works offline).
+ */
+export declare function renderPublishReportHtml(report: PublishReport): string;

package/dist/core/report.js

@@ -0,0 +1,132 @@
+/**
+ * Builds the report for a publish run, successful (with manifest) or failed (with error).
+ */
+export function createPublishReport(input) {
+    const { content, translations } = input.artifacts;
+    const severityOrder = { requirement: 0, recommendation: 1 };
+    const issues = [...content.issues].sort((a, b) => severityOrder[a.severity] - severityOrder[b.severity] ||
+        (a.collection ?? "").localeCompare(b.collection ?? "") ||
+        (a.id ?? "").localeCompare(b.id ?? "") ||
+        (a.locale ?? "").localeCompare(b.locale ?? "") ||
+        (a.field ?? "").localeCompare(b.field ?? ""));
+    const targets = Object.values(content.targets);
+    return {
+        schemaVersion: 1,
+        status: input.manifest ? "published" : "failed",
+        channel: input.channel,
+        releaseId: input.releaseId,
+        createdAt: new Date().toISOString(),
+        ...(input.error ? { error: input.error.message } : {}),
+        summary: {
+            requirements: issues.filter((i) => i.severity === "requirement").length,
+            recommendations: issues.filter((i) => i.severity === "recommendation").length,
+            warnings: content.warnings.length,
+            targets: { satisfied: targets.filter((t) => t.satisfied).length, total: targets.length },
+            translations: translations.overall
+        },
+        ...(input.manifest
+            ? {
+                release: {
+                    collections: Object.keys(input.manifest.collections).length,
+                    items: Object.values(input.manifest.collections).reduce((n, c) => n + c.itemCount, 0),
+                    media: Object.keys(input.manifest.media).length
+                }
+            }
+            : {}),
+        targets: content.targets,
+        translations: {
+            sourceLocale: translations.sourceLocale,
+            sourceLocaleOrigin: translations.sourceLocaleOrigin,
+            locales: translations.locales,
+            collections: translations.collections,
+            itemsWithoutSource: translations.itemsWithoutSource
+        },
+        issues,
+        warnings: content.warnings
+    };
+}
+const escape = (value) => String(value ?? "").replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+const percent = (c) => (c.expected === 0 ? "–" : `${Math.floor((c.translated / c.expected) * 1000) / 10}%`);
+/**
+ * Renders a report as a self-contained HTML page (no external resources, works offline).
+ */
+export function renderPublishReportHtml(report) {
+    const s = report.summary;
+    const locales = Object.keys(report.translations.locales);
+    const card = (label, value, tone = "") => `<div class="card ${tone}"><div class="value">${value}</div><div class="label">${label}</div></div>`;
+    const targetRows = Object.entries(report.targets).map(([id, t]) => `<tr><td><code>${escape(id)}</code></td><td><span class="badge ${t.satisfied ? "ok" : "bad"}">${t.satisfied ? "satisfied" : "failed"}</span></td><td class="num">${t.requirements}</td><td class="num">${t.recommendations}</td></tr>`).join("");
+    const translationRows = Object.entries(report.translations.collections).map(([collection, byLocale]) => `<tr><td><code>${escape(collection)}</code></td>${locales.map((l) => {
+        const c = byLocale[l];
+        return `<td class="num">${c ? `${percent(c)} <small>${c.translated}/${c.expected}${c.stale ? ` · ${c.stale} stale` : ""}${c.machine ? ` · ${c.machine} machine` : ""}</small>` : "–"}</td>`;
+    }).join("")}</tr>`).join("");
+    const issueRows = report.issues.map((i) => `<tr class="${i.severity}"><td><span class="badge ${i.severity === "requirement" ? "bad" : "warn"}">${i.severity}</span></td><td>${escape(i.target ?? "")}</td><td><code>${escape([i.collection, i.id].filter(Boolean).join(" / "))}</code></td><td>${escape(i.locale ?? "")}</td><td><code>${escape(i.field ?? "")}</code></td><td class="nowrap">${escape(i.issue)}</td><td>${escape(i.message)}</td><td>${i.source ? `<a href="${escape(i.source)}">open</a>` : ""}</td></tr>`).join("");
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>Publish report · ${escape(report.releaseId)}</title>
+<style>
+  :root { --bg: #f8fafc; --panel: #ffffff; --text: #0f172a; --muted: #64748b; --line: #e2e8f0; --ok: #047857; --bad: #b91c1c; --warn: #b45309; }
+  @media (prefers-color-scheme: dark) { :root { --bg: #020617; --panel: #0f172a; --text: #e2e8f0; --muted: #94a3b8; --line: #1e293b; --ok: #34d399; --bad: #f87171; --warn: #fbbf24; } }
+  * { box-sizing: border-box; }
+  body { margin: 0; padding: 32px 16px; background: var(--bg); color: var(--text); font: 14px/1.5 system-ui, sans-serif; }
+  main { max-width: 1200px; margin: 0 auto; }
+  h1 { font-size: 22px; margin: 0 0 4px; } h2 { font-size: 16px; margin: 32px 0 12px; }
+  .meta { color: var(--muted); }
+  .cards { display: grid; grid-template-columns: repeat(auto-fit, minmax(160px, 1fr)); gap: 12px; margin-top: 20px; }
+  .card { background: var(--panel); border: 1px solid var(--line); border-radius: 12px; padding: 14px 16px; }
+  .card .value { font-size: 22px; font-weight: 700; } .card .label { color: var(--muted); font-size: 12px; }
+  .card.bad .value { color: var(--bad); } .card.warn .value { color: var(--warn); } .card.ok .value { color: var(--ok); }
+  .table { overflow-x: auto; background: var(--panel); border: 1px solid var(--line); border-radius: 12px; }
+  table { width: 100%; border-collapse: collapse; }
+  th, td { text-align: left; padding: 8px 12px; border-bottom: 1px solid var(--line); vertical-align: top; }
+  th { color: var(--muted); font-size: 12px; font-weight: 600; } tr:last-child td { border-bottom: 0; }
+  .num { text-align: right; white-space: nowrap; } .nowrap { white-space: nowrap; } small { color: var(--muted); }
+  code { font: 12px ui-monospace, monospace; }
+  .badge { display: inline-block; padding: 1px 8px; border-radius: 999px; font-size: 11px; font-weight: 600; border: 1px solid currentColor; }
+  .badge.ok { color: var(--ok); } .badge.bad { color: var(--bad); } .badge.warn { color: var(--warn); }
+  .error { margin-top: 16px; padding: 12px 16px; border: 1px solid var(--bad); border-radius: 12px; color: var(--bad); white-space: pre-wrap; }
+  .empty { color: var(--muted); padding: 12px 16px; }
+  ul { margin: 0; padding: 12px 16px 12px 32px; }
+  a { color: inherit; }
+</style>
+</head>
+<body>
+<main>
+  <h1>Publish report <span class="badge ${report.status === "published" ? "ok" : "bad"}">${report.status}</span></h1>
+  <div class="meta">Release <code>${escape(report.releaseId)}</code> · channel <code>${escape(report.channel)}</code> · ${escape(report.createdAt)} · source locale <code>${escape(report.translations.sourceLocale)}</code> (${escape(report.translations.sourceLocaleOrigin)})</div>
+  ${report.error ? `<div class="error">${escape(report.error)}</div>` : ""}
+
+  <div class="cards">
+    ${card("failed requirements", String(s.requirements), s.requirements ? "bad" : "ok")}
+    ${card("recommendations", String(s.recommendations), s.recommendations ? "warn" : "ok")}
+    ${card("warnings", String(s.warnings), s.warnings ? "warn" : "ok")}
+    ${card("targets satisfied", `${s.targets.satisfied}/${s.targets.total}`, s.targets.satisfied === s.targets.total ? "ok" : "bad")}
+    ${card("translated", `${percent(s.translations)}`, s.translations.missing || s.translations.stale ? "warn" : "ok")}
+    ${report.release ? card("collections · items · media", `${report.release.collections} · ${report.release.items} · ${report.release.media}`) : ""}
+  </div>
+
+  <h2>Targets</h2>
+  <div class="table"><table><thead><tr><th>Target</th><th>Status</th><th class="num">Failed requirements</th><th class="num">Recommendations</th></tr></thead><tbody>${targetRows}</tbody></table></div>
+
+  <h2>Translations (vs. ${escape(report.translations.sourceLocale)})</h2>
+  ${locales.length
+        ? `<div class="table"><table><thead><tr><th>Collection</th>${locales.map((l) => `<th class="num">${escape(l)}</th>`).join("")}</tr></thead><tbody>${translationRows}</tbody></table></div>`
+        : `<div class="table empty">No target locales.</div>`}
+
+  <h2>Issues (${report.issues.length})</h2>
+  ${report.issues.length
+        ? `<div class="table"><table><thead><tr><th>Severity</th><th>Target</th><th>Item</th><th>Locale</th><th>Field</th><th>Issue</th><th>Message</th><th>Source</th></tr></thead><tbody>${issueRows}</tbody></table></div>`
+        : `<div class="table empty">No issues.</div>`}
+
+  <h2>Warnings (${report.warnings.length})</h2>
+  ${report.warnings.length
+        ? `<div class="table"><ul>${report.warnings.map((w) => `<li>${escape(w)}</li>`).join("")}</ul></div>`
+        : `<div class="table empty">No warnings.</div>`}
+</main>
+</body>
+</html>
+`;
+}
+//# sourceMappingURL=report.js.map

package/dist/core/report.js.map

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

package/dist/core/settings.d.ts

@@ -0,0 +1,12 @@
+import { CollectionItem } from "../types.js";
+export declare const SITE_COLLECTION = "_site";
+export declare const LANGUAGES_COLLECTION = "_languages";
+export interface SiteItem extends CollectionItem {
+    defaultLanguage?: string;
+}
+/**
+ * Checks _site and _languages (each only if present). Throws on the first problem: schema errors,
+ * a _site with other than one item, the same language twice, a defaultLanguage that isn't a
+ * language, and route paths in a language _languages doesn't list.
+ */
+export declare function validateSettings(collections: Record<string, CollectionItem[]>): void;

package/dist/core/settings.js

@@ -0,0 +1,40 @@
+import { validateLanguageItem, validateSiteItem } from "../validation.js";
+import { ROUTES_COLLECTION } from "./site.js";
+// Optional, typed reserved collections: the site's settings and the languages it's published in
+export const SITE_COLLECTION = "_site";
+export const LANGUAGES_COLLECTION = "_languages";
+/**
+ * Checks _site and _languages (each only if present). Throws on the first problem: schema errors,
+ * a _site with other than one item, the same language twice, a defaultLanguage that isn't a
+ * language, and route paths in a language _languages doesn't list.
+ */
+export function validateSettings(collections) {
+    const languages = collections[LANGUAGES_COLLECTION];
+    const keys = new Set();
+    for (const language of languages ?? []) {
+        validateLanguageItem(language);
+        if (keys.has(language.key))
+            throw new Error(`Invalid _languages item (${language.id}): language "${language.key}" is listed twice`);
+        keys.add(language.key);
+    }
+    const site = collections[SITE_COLLECTION];
+    if (site) {
+        if (site.length !== 1)
+            throw new Error(`Invalid _site: needs exactly one item, has ${site.length}`);
+        const item = site[0];
+        validateSiteItem(item);
+        if (languages && item.defaultLanguage && !keys.has(item.defaultLanguage)) {
+            throw new Error(`Invalid _site item (${item.id}): defaultLanguage "${item.defaultLanguage}" isn't in _languages`);
+        }
+    }
+    if (languages) {
+        for (const route of collections[ROUTES_COLLECTION] ?? []) {
+            for (const [locale, t] of Object.entries(route.translations)) {
+                if (typeof t?.path === "string" && !keys.has(locale)) {
+                    throw new Error(`Invalid _routes item (${route.id}): has a path in "${locale}", which isn't in _languages`);
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=settings.js.map

package/dist/core/settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../src/core/settings.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAE9C,gGAAgG;AAChG,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAC;AACvC,MAAM,CAAC,MAAM,oBAAoB,GAAG,YAAY,CAAC;AAMjD;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,WAA6C;IAC5E,MAAM,SAAS,GAAG,WAAW,CAAC,oBAAoB,CAAC,CAAC;IACpD,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,KAAK,MAAM,QAAQ,IAAI,SAAS,IAAI,EAAE,EAAE,CAAC;QACvC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;QAC/B,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,QAAQ,CAAC,EAAE,gBAAgB,QAAQ,CAAC,GAAG,mBAAmB,CAAC,CAAC;QACpI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,MAAM,IAAI,GAAG,WAAW,CAAC,eAAe,CAAC,CAAC;IAC1C,IAAI,IAAI,EAAE,CAAC;QACT,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACpG,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAa,CAAC;QACjC,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACvB,IAAI,SAAS,IAAI,IAAI,CAAC,eAAe,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,CAAC;YACzE,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,CAAC,EAAE,uBAAuB,IAAI,CAAC,eAAe,uBAAuB,CAAC,CAAC;QACpH,CAAC;IACH,CAAC;IAED,IAAI,SAAS,EAAE,CAAC;QACd,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,iBAAiB,CAAC,IAAI,EAAE,EAAE,CAAC;YACzD,KAAK,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC;gBAC7D,IAAI,OAAO,CAAC,EAAE,IAAI,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;oBACrD,MAAM,IAAI,KAAK,CAAC,yBAAyB,KAAK,CAAC,EAAE,qBAAqB,MAAM,8BAA8B,CAAC,CAAC;gBAC9G,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/core/site.d.ts

@@ -0,0 +1,37 @@
+import { CollectionItem, Reference } from "../types.js";
+export declare const ROUTES_COLLECTION = "_routes";
+export declare const PAGES_COLLECTION = "_pages";
+export declare const BLOCKS_COLLECTION = "_blocks";
+export interface RouteItem extends CollectionItem {
+    page?: string;
+    redirect?: string;
+    status?: 301 | 302;
+}
+export interface PageItem extends CollectionItem {
+    blocks?: string[];
+}
+export interface BlockItem extends CollectionItem {
+    type: string;
+    items?: Reference[];
+    source?: {
+        collection: string;
+    };
+    links?: string[];
+    settings?: Record<string, unknown>;
+}
+/**
+ * Checks _routes, _pages and _blocks (each only if present). Throws on the first problem:
+ * schema errors, a route without page or redirect (or both), unknown pages, routes, blocks,
+ * collections or items, redirect cycles, a route without any path, the same path twice in a locale,
+ * and blocks with both items and source.
+ */
+export declare function validateSite(collections: Record<string, CollectionItem[]>): void;
+/**
+ * Structure that is valid but probably unintended: pages no route shows, blocks no page uses.
+ */
+export declare function siteRecommendations(collections: Record<string, CollectionItem[]>): {
+    collection: string;
+    id: string;
+    issue: string;
+    message: string;
+}[];