@krantho/api 0.0.0-stage → 1.0.0

package/dist/handlers/seo-sitemap.js

@@ -0,0 +1,178 @@
+import { documentPath, rendersPages } from '@krantho/core';
+import { canReadPublished } from '@krantho/persistence';
+import { buildSeoFieldMap, resolveSeoField } from '@krantho/seo-shared';
+import { PUBLIC_MACHINE_READ_CACHE_CONTROL } from '../public-cache.js';
+/**
+ * Canonical paths for the SEO routes registered in `create-api-handlers.ts`.
+ *
+ * Exported as constants so callers (e.g., the robots.txt handler) reference
+ * the same path the router registers, preventing drift if a route is renamed.
+ */
+export const SEO_SITEMAP_PATH = '/api/seo/sitemap';
+/** Where a site serves the sitemap — the address robots.txt names; the site routes it to SEO_SITEMAP_PATH */
+export const SITEMAP_PUBLIC_PATH = '/sitemap.xml';
+export const SEO_SITEMAP_JSON_PATH = '/api/seo/sitemap.json';
+export const SEO_ROBOTS_PATH = '/api/seo/robots.txt';
+/**
+ * Whether a document asks not to be indexed. The field name is resolved
+ * dynamically so CMS schemas with different conventions (e.g. `robots-index`
+ * vs `noindex`) all work.
+ */
+export function isNoindex(fields) {
+    const fieldMap = buildSeoFieldMap(Object.keys(fields));
+    const robotsField = fieldMap.robotsIndex;
+    if (!robotsField)
+        return false;
+    const rawValue = fields[robotsField];
+    if (rawValue === false || rawValue === 'false' || rawValue === 'noindex')
+        return true;
+    // resolveSeoField returns strings; the raw false/string cases are handled above
+    const resolved = resolveSeoField(fieldMap, 'robotsIndex', fields);
+    return resolved === 'false' || resolved === 'noindex';
+}
+/**
+ * Build the list of sitemap URLs from the handler's content config.
+ *
+ * Pure: reads from the context, returns an array. No side effects. This is
+ * the shared core used by both `seoSitemap` (XML output) and `seoSitemapJson`
+ * (JSON output for the Studio preview), plus any future consumer that needs
+ * the url list.
+ *
+ * Iterates every published item in every collection that renders pages
+ * (`rendersPages()`), skips noindex pages (resolved via the dynamic field map
+ * so CMS field names can differ), and derives the URL with `documentPath()`
+ * from the collection's `path` — or, without one, `pages` items at the site
+ * root (the `home` page is the homepage) and other collections under their
+ * name (`/{name}/slug`). A path is listed once: the homepage, and a fixed-path
+ * collection whose documents share one page.
+ */
+export async function buildSitemapUrls(ctx) {
+    const baseUrl = ctx.config.site.baseUrl.replace(/\/$/, '');
+    const urls = [];
+    const listed = new Set();
+    for (const [name, collection] of ctx.contentConfig.collections) {
+        if (!rendersPages(collection))
+            continue;
+        if (!canReadPublished(ctx.adapter))
+            continue;
+        try {
+            // The live version of each document: a page with a newer draft stays
+            // listed, and an unpublished page drops out
+            const { items } = await ctx.adapter.query({
+                state: 'published',
+                projection: 'summary',
+                collections: [name],
+            });
+            for (const item of items) {
+                if (isNoindex(item.fields))
+                    continue;
+                const path = documentPath(collection, item.meta.slug);
+                if (path === null || listed.has(path))
+                    continue;
+                listed.add(path);
+                // Each save writes a new version, so the live version's `createdAt` is
+                // when the page last changed: an editor's publish, or for an imported
+                // file its last commit (`generateContentDates`)
+                const lastmod = w3cDatetime(item.meta.createdAt);
+                const home = path === '/';
+                urls.push({
+                    loc: `${baseUrl}${path}`,
+                    ...(lastmod ? { lastmod } : {}),
+                    changefreq: home || name === 'pages' ? 'weekly' : 'monthly',
+                    priority: home ? '1.0' : name === 'pages' ? '0.8' : '0.6',
+                });
+            }
+        }
+        catch {
+            // Collection may not support listing
+        }
+    }
+    return withHomepageFirst(urls, baseUrl);
+}
+/**
+ * A timestamp as the sitemap protocol's W3C Datetime, in UTC with full time
+ * (`2026-09-30T22:17:06.000Z`), or undefined when there is none to give.
+ */
+function w3cDatetime(value) {
+    const time = value ? Date.parse(value) : Number.NaN;
+    return Number.isNaN(time) ? undefined : new Date(time).toISOString();
+}
+/**
+ * The homepage leads the list. A document that renders `/` supplies its entry,
+ * with its `lastmod`; without one, the site's root is listed bare.
+ */
+function withHomepageFirst(urls, baseUrl) {
+    const homeLoc = `${baseUrl}/`;
+    const home = urls.find((url) => url.loc === homeLoc) ?? {
+        loc: homeLoc,
+        changefreq: 'weekly',
+        priority: '1.0',
+    };
+    return [home, ...urls.filter((url) => url.loc !== homeLoc)];
+}
+/**
+ * Serialize a list of sitemap URLs to XML.
+ *
+ * Exported so tests can drive the serializer directly without needing to
+ * stub the full ApiContext. Also used by the XML handler below.
+ */
+export function serializeSitemapXml(urls) {
+    const urlEntries = urls
+        .map((u) => {
+        const parts = [`    <loc>${escapeXml(u.loc)}</loc>`];
+        if (u.lastmod)
+            parts.push(`    <lastmod>${u.lastmod}</lastmod>`);
+        parts.push(`    <changefreq>${u.changefreq}</changefreq>`);
+        parts.push(`    <priority>${u.priority}</priority>`);
+        return `  <url>\n${parts.join('\n')}\n  </url>`;
+    })
+        .join('\n');
+    return `<?xml version="1.0" encoding="UTF-8"?>\n<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">\n${urlEntries}\n</urlset>`;
+}
+/**
+ * GET /api/seo/sitemap — generate sitemap XML dynamically from all collections.
+ *
+ * Lists all published content across the collections that render pages, at
+ * site.baseUrl + `documentPath()`. Excludes collections without pages and
+ * noindex pages.
+ */
+export const seoSitemap = async (_req, ctx) => {
+    const urls = await buildSitemapUrls(ctx);
+    return {
+        status: 200,
+        body: serializeSitemapXml(urls),
+        headers: {
+            'content-type': 'application/xml; charset=utf-8',
+            'cache-control': PUBLIC_MACHINE_READ_CACHE_CONTROL,
+        },
+    };
+};
+/**
+ * GET /api/seo/sitemap.json — same url list as the XML handler, served as JSON.
+ *
+ * Used by Studio's Structure → Sitemap & Robots tab to render a sortable table
+ * without parsing XML client-side. Not intended as a public SEO endpoint —
+ * search engines consume the XML at `/api/seo/sitemap` (or wherever your
+ * framework rewrites it, e.g. `/sitemap.xml`).
+ */
+export const seoSitemapJson = async (_req, ctx) => {
+    const urls = await buildSitemapUrls(ctx);
+    return {
+        status: 200,
+        body: { urls },
+    };
+};
+/**
+ * Escape XML special characters for use inside `<loc>` element values.
+ *
+ * Intentionally minimal: only escapes the three characters that XML treats
+ * as control characters in element content (`&`, `<`, `>`). Quote characters
+ * (`'` and `"`) are not escaped because we never embed values inside attribute
+ * contexts in this sitemap output — every interpolated value goes between
+ * element tags. If you start emitting values inside attributes (e.g.
+ * `<image:image href="...">`), extend this to also escape `'` and `"`.
+ */
+function escapeXml(str) {
+    return str.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+}
+//# sourceMappingURL=seo-sitemap.js.map

package/dist/handlers/seo-sitemap.js.map

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

package/dist/handlers/seo-status.d.ts

@@ -0,0 +1,4 @@
+import type { ApiHandler } from '../types.js';
+/** GET /api/seo/status — SEO file status overview */
+export declare const seoStatus: ApiHandler;
+//# sourceMappingURL=seo-status.d.ts.map

package/dist/handlers/seo-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seo-status.d.ts","sourceRoot":"","sources":["../../src/handlers/seo-status.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAuD7C,qDAAqD;AACrD,eAAO,MAAM,SAAS,EAAE,UAevB,CAAA"}

package/dist/handlers/seo-status.js

@@ -0,0 +1,61 @@
+import { readFile, stat } from 'node:fs/promises';
+import { join } from 'node:path';
+async function checkJsonFile(filePath, countKey) {
+    let raw;
+    try {
+        raw = await readFile(filePath, 'utf-8');
+    }
+    catch {
+        return { exists: false };
+    }
+    try {
+        const data = JSON.parse(raw);
+        let count = 0;
+        if (Array.isArray(data)) {
+            count = data.length;
+        }
+        else if (data && typeof data === 'object') {
+            count = Object.keys(data).length;
+        }
+        return { exists: true, [countKey]: count };
+    }
+    catch {
+        // File exists but contains invalid JSON
+        return { exists: true, [countKey]: 0 };
+    }
+}
+async function checkTextFile(filePath) {
+    try {
+        const info = await stat(filePath);
+        return { exists: true, bytes: info.size };
+    }
+    catch {
+        return { exists: false };
+    }
+}
+async function checkSitemapFile(filePath) {
+    try {
+        const raw = await readFile(filePath, 'utf-8');
+        const urls = (raw.match(/<url>/g) ?? []).length;
+        return { exists: true, urls };
+    }
+    catch {
+        return { exists: false };
+    }
+}
+/** GET /api/seo/status — SEO file status overview */
+export const seoStatus = async (_req, ctx) => {
+    const basePath = ctx.config.paths.seoGeneratedDir;
+    const [structuredData, faqPages, llmsTxt, sitemap, contentDates] = await Promise.all([
+        checkJsonFile(join(basePath, 'structured-data.json'), 'entries'),
+        checkJsonFile(join(basePath, 'faq-pages.json'), 'routes'),
+        checkTextFile(join(basePath, 'llms.txt')),
+        checkSitemapFile(join(basePath, 'sitemap.xml')),
+        checkJsonFile(join(basePath, 'content-dates.json'), 'entries'),
+    ]);
+    return {
+        status: 200,
+        body: { structuredData, faqPages, llmsTxt, sitemap, contentDates },
+    };
+};
+//# sourceMappingURL=seo-status.js.map

package/dist/handlers/seo-status.js.map

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

package/dist/handlers/seo-structured-data.d.ts

@@ -0,0 +1,4 @@
+import type { ApiHandler } from '../types.js';
+/** GET /api/seo/structured-data — return generated structured-data.json */
+export declare const seoStructuredData: ApiHandler;
+//# sourceMappingURL=seo-structured-data.d.ts.map

package/dist/handlers/seo-structured-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seo-structured-data.d.ts","sourceRoot":"","sources":["../../src/handlers/seo-structured-data.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE7C,2EAA2E;AAC3E,eAAO,MAAM,iBAAiB,EAAE,UAa/B,CAAA"}

package/dist/handlers/seo-structured-data.js

@@ -0,0 +1,18 @@
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+/** GET /api/seo/structured-data — return generated structured-data.json */
+export const seoStructuredData = async (_req, ctx) => {
+    const basePath = ctx.config.paths.seoGeneratedDir;
+    try {
+        const raw = await readFile(join(basePath, 'structured-data.json'), 'utf-8');
+        const data = JSON.parse(raw);
+        return { status: 200, body: data };
+    }
+    catch {
+        return {
+            status: 404,
+            body: { error: 'structured-data.json not found — run seo:generate to create it' },
+        };
+    }
+};
+//# sourceMappingURL=seo-structured-data.js.map

package/dist/handlers/seo-structured-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seo-structured-data.js","sourceRoot":"","sources":["../../src/handlers/seo-structured-data.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAGhC,2EAA2E;AAC3E,MAAM,CAAC,MAAM,iBAAiB,GAAe,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;IAC/D,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,CAAA;IAEjD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,sBAAsB,CAAC,EAAE,OAAO,CAAC,CAAA;QAC3E,MAAM,IAAI,GAAY,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;QACrC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,CAAA;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;YACL,MAAM,EAAE,GAAG;YACX,IAAI,EAAE,EAAE,KAAK,EAAE,gEAAgE,EAAE;SAClF,CAAA;IACH,CAAC;AACH,CAAC,CAAA"}

package/dist/handlers/site-config.d.ts

@@ -0,0 +1,8 @@
+import type { ApiHandler } from '../types.js';
+/**
+ * GET /api/site-config — the browser-safe configuration (`PublicConfig`: site
+ * identity, SEO limits and readers, features, page-cache settings) and the
+ * collection schemas
+ */
+export declare const siteConfigHandler: ApiHandler;
+//# sourceMappingURL=site-config.d.ts.map

package/dist/handlers/site-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-config.d.ts","sourceRoot":"","sources":["../../src/handlers/site-config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE7C;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,UAwB/B,CAAA"}

package/dist/handlers/site-config.js

@@ -0,0 +1,26 @@
+import { toPublicConfig } from '@krantho/config/public';
+/**
+ * GET /api/site-config — the browser-safe configuration (`PublicConfig`: site
+ * identity, SEO limits and readers, features, page-cache settings) and the
+ * collection schemas
+ */
+export const siteConfigHandler = async (_req, ctx) => {
+    const collections = [];
+    for (const [name, collection] of ctx.contentConfig.collections) {
+        const schema = collection.schema;
+        let fieldCount = 0;
+        if (schema && 'shape' in schema && typeof schema.shape === 'object' && schema.shape) {
+            fieldCount = Object.keys(schema.shape).length;
+        }
+        collections.push({
+            name,
+            source: collection.source,
+            fieldCount,
+        });
+    }
+    return {
+        status: 200,
+        body: { ...toPublicConfig(ctx.config), collections },
+    };
+};
+//# sourceMappingURL=site-config.js.map

package/dist/handlers/site-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-config.js","sourceRoot":"","sources":["../../src/handlers/site-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAGvD;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAe,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;IAC/D,MAAM,WAAW,GAIZ,EAAE,CAAA;IAEP,KAAK,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,GAAG,CAAC,aAAa,CAAC,WAAW,EAAE,CAAC;QAC/D,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAA;QAChC,IAAI,UAAU,GAAG,CAAC,CAAA;QAClB,IAAI,MAAM,IAAI,OAAO,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;YACpF,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAA;QAC/C,CAAC;QACD,WAAW,CAAC,IAAI,CAAC;YACf,IAAI;YACJ,MAAM,EAAE,UAAU,CAAC,MAAM;YACzB,UAAU;SACX,CAAC,CAAA;IACJ,CAAC;IAED,OAAO;QACL,MAAM,EAAE,GAAG;QACX,IAAI,EAAE,EAAE,GAAG,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE;KACrD,CAAA;AACH,CAAC,CAAA"}

package/dist/handlers/site-preview.d.ts

@@ -0,0 +1,10 @@
+import type { ApiHandler } from '../types.js';
+/**
+ * GET /api/preview?collection=&slug= — may this user preview the document on
+ * the site, and at which path? Registered when the host renders drafts for
+ * editors (`sitePreview`). In `draft-mode` it answers `{ path }` and the host
+ * turns that into its own preview mode; in `signed-url` it sends the editor to
+ * the page with a short-lived token bound to that path.
+ */
+export declare const sitePreview: ApiHandler;
+//# sourceMappingURL=site-preview.d.ts.map

package/dist/handlers/site-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-preview.d.ts","sourceRoot":"","sources":["../../src/handlers/site-preview.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAe,MAAM,aAAa,CAAA;AAM1D;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,EAAE,UAezB,CAAA"}

package/dist/handlers/site-preview.js

@@ -0,0 +1,54 @@
+import { documentPath, resolveSitePath } from '@krantho/core';
+import { requireRole } from '../permissions.js';
+import { PREVIEW_PARAM, signPreviewToken } from '../preview-token.js';
+import { requireParam, validateCollectionParam } from '../validators.js';
+/** Any fixed origin: only the path of the redirect matters, and it must stay on it */
+const SITE_ORIGIN = 'http://localhost';
+/**
+ * GET /api/preview?collection=&slug= — may this user preview the document on
+ * the site, and at which path? Registered when the host renders drafts for
+ * editors (`sitePreview`). In `draft-mode` it answers `{ path }` and the host
+ * turns that into its own preview mode; in `signed-url` it sends the editor to
+ * the page with a short-lived token bound to that path.
+ */
+export const sitePreview = async (req, ctx) => {
+    const denied = requireRole(ctx.auth, 'editor');
+    if (denied)
+        return denied;
+    const validated = validateCollectionParam(req.query['collection'], ctx);
+    if (!validated.isValid)
+        return validated.response;
+    const slugResult = requireParam(req.query, 'slug');
+    if (!slugResult.isValid)
+        return slugResult.response;
+    const path = documentPath(validated.collectionDef, slugResult.value);
+    if (path === null) {
+        return { status: 400, body: { error: `"${validated.collection}" has no pages to preview` } };
+    }
+    if (ctx.sitePreview !== 'signed-url')
+        return { status: 200, body: { path } };
+    return signedRedirect(path, ctx.config.auth.jwtSecret);
+};
+/**
+ * Send the editor to the page with a token signed for its path. The path is
+ * resolved as the browser will request it, and must stay on the site: a slug
+ * that normalises to another host (`..//host`) gets no link and no token.
+ */
+function signedRedirect(path, secret) {
+    // The API always resolves a signing secret (configured or ephemeral); never sign without one
+    if (!secret)
+        return { status: 500, body: { error: 'No signing secret for preview links' } };
+    const target = resolveSitePath(path, SITE_ORIGIN);
+    if (!target)
+        return { status: 400, body: { error: 'The page path leaves the site' } };
+    const token = signPreviewToken(target.pathname, secret);
+    return {
+        status: 307,
+        body: null,
+        headers: {
+            location: `${target.pathname}?${new URLSearchParams({ [PREVIEW_PARAM]: token })}`,
+            'cache-control': 'no-store',
+        },
+    };
+}
+//# sourceMappingURL=site-preview.js.map

package/dist/handlers/site-preview.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-preview.js","sourceRoot":"","sources":["../../src/handlers/site-preview.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAErE,OAAO,EAAE,YAAY,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAA;AAExE,sFAAsF;AACtF,MAAM,WAAW,GAAG,kBAAkB,CAAA;AAEtC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,WAAW,GAAe,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;IACxD,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IAC9C,IAAI,MAAM;QAAE,OAAO,MAAM,CAAA;IAEzB,MAAM,SAAS,GAAG,uBAAuB,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,GAAG,CAAC,CAAA;IACvE,IAAI,CAAC,SAAS,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC,QAAQ,CAAA;IACjD,MAAM,UAAU,GAAG,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;IAClD,IAAI,CAAC,UAAU,CAAC,OAAO;QAAE,OAAO,UAAU,CAAC,QAAQ,CAAA;IAEnD,MAAM,IAAI,GAAG,YAAY,CAAC,SAAS,CAAC,aAAa,EAAE,UAAU,CAAC,KAAK,CAAC,CAAA;IACpE,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,SAAS,CAAC,UAAU,2BAA2B,EAAE,EAAE,CAAA;IAC9F,CAAC;IACD,IAAI,GAAG,CAAC,WAAW,KAAK,YAAY;QAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,CAAA;IAC5E,OAAO,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;AACxD,CAAC,CAAA;AAED;;;;GAIG;AACH,SAAS,cAAc,CAAC,IAAY,EAAE,MAA0B;IAC9D,6FAA6F;IAC7F,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,qCAAqC,EAAE,EAAE,CAAA;IAC3F,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,EAAE,WAAW,CAAC,CAAA;IACjD,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,+BAA+B,EAAE,EAAE,CAAA;IACrF,MAAM,KAAK,GAAG,gBAAgB,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;IACvD,OAAO;QACL,MAAM,EAAE,GAAG;QACX,IAAI,EAAE,IAAI;QACV,OAAO,EAAE;YACP,QAAQ,EAAE,GAAG,MAAM,CAAC,QAAQ,IAAI,IAAI,eAAe,CAAC,EAAE,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE;YACjF,eAAe,EAAE,UAAU;SAC5B;KACF,CAAA;AACH,CAAC"}

package/dist/handlers/site-settings.d.ts

@@ -0,0 +1,17 @@
+import type { ApiHandler } from '../types.js';
+/**
+ * GET /api/settings/locales — the site's locales.
+ *
+ * The default locale is always the configuration's `site.defaultLocale`.
+ * `configuredLocales` are the locales the configuration lists; `supportedLocales`
+ * are the active ones (`activeLocales`).
+ */
+export declare const getLocaleSettings: ApiHandler;
+/**
+ * PUT /api/settings/locales — choose which of the configured locales are active.
+ *
+ * The body is `{ supportedLocales: string[] }`. The default locale is the
+ * configuration's and is not set here.
+ */
+export declare const updateLocaleSettings: ApiHandler;
+//# sourceMappingURL=site-settings.d.ts.map

package/dist/handlers/site-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-settings.d.ts","sourceRoot":"","sources":["../../src/handlers/site-settings.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAG7C;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,UAa/B,CAAA;AAoBD;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,EAAE,UAiClC,CAAA"}

package/dist/handlers/site-settings.js

@@ -0,0 +1,75 @@
+import { activeLocales } from '../active-locales.js';
+import { requireRole } from '../permissions.js';
+import { validateRequestBody } from '../validators.js';
+/**
+ * GET /api/settings/locales — the site's locales.
+ *
+ * The default locale is always the configuration's `site.defaultLocale`.
+ * `configuredLocales` are the locales the configuration lists; `supportedLocales`
+ * are the active ones (`activeLocales`).
+ */
+export const getLocaleSettings = async (_req, ctx) => {
+    const { defaultLocale, supportedLocales: configuredLocales } = ctx.config.site;
+    const { locales, stored } = await activeLocales(ctx);
+    return {
+        status: 200,
+        body: {
+            defaultLocale,
+            configuredLocales,
+            supportedLocales: locales,
+            source: stored ? 'database' : 'config',
+        },
+    };
+};
+/** The reason a list of active locales is not valid for the site, or null */
+function localeListError(locales, configured, defaultLocale) {
+    if (locales.length === 0)
+        return 'At least one locale is required';
+    if (new Set(locales).size !== locales.length)
+        return 'The list names a locale more than once';
+    const unknown = locales.filter((locale) => !configured.includes(locale));
+    if (unknown.length > 0) {
+        return `${unknown.join(', ')} is not in site.supportedLocales in the configuration (${configured.join(', ')})`;
+    }
+    if (!locales.includes(defaultLocale)) {
+        return `The default locale ${defaultLocale} must stay active`;
+    }
+    return null;
+}
+/**
+ * PUT /api/settings/locales — choose which of the configured locales are active.
+ *
+ * The body is `{ supportedLocales: string[] }`. The default locale is the
+ * configuration's and is not set here.
+ */
+export const updateLocaleSettings = async (req, ctx) => {
+    const denied = requireRole(ctx.auth, 'admin');
+    if (denied)
+        return denied;
+    if (!ctx.siteSettingsAdapter) {
+        return { status: 501, body: { error: 'Site settings storage not available' } };
+    }
+    const bodyCheck = validateRequestBody(req.body);
+    if (!bodyCheck.isValid)
+        return bodyCheck.response;
+    const payload = bodyCheck.body;
+    const requested = payload['supportedLocales'];
+    if (!Array.isArray(requested) || !requested.every((l) => typeof l === 'string')) {
+        return { status: 400, body: { error: 'supportedLocales must be an array of locale codes' } };
+    }
+    const { defaultLocale, supportedLocales: configuredLocales } = ctx.config.site;
+    const error = localeListError(requested, configuredLocales, defaultLocale);
+    if (error)
+        return { status: 400, body: { error } };
+    await ctx.siteSettingsAdapter.setSetting('supportedLocales', JSON.stringify(requested));
+    return {
+        status: 200,
+        body: {
+            defaultLocale,
+            configuredLocales,
+            supportedLocales: requested,
+            source: 'database',
+        },
+    };
+};
+//# sourceMappingURL=site-settings.js.map

package/dist/handlers/site-settings.js.map

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

package/dist/handlers/snapshot-create.d.ts

@@ -0,0 +1,4 @@
+import type { ApiHandler } from '../types.js';
+/** POST /api/checkpoints — create a manual checkpoint */
+export declare const snapshotCreate: ApiHandler;
+//# sourceMappingURL=snapshot-create.d.ts.map

package/dist/handlers/snapshot-create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-create.d.ts","sourceRoot":"","sources":["../../src/handlers/snapshot-create.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE7C,yDAAyD;AACzD,eAAO,MAAM,cAAc,EAAE,UAa5B,CAAA"}

package/dist/handlers/snapshot-create.js

@@ -0,0 +1,15 @@
+import { requireRole } from '../permissions.js';
+/** POST /api/checkpoints — create a manual checkpoint */
+export const snapshotCreate = async (req, ctx) => {
+    const denied = requireRole(ctx.auth, 'editor');
+    if (denied)
+        return denied;
+    if (!ctx.checkpointAdapter) {
+        return { status: 501, body: { error: 'Checkpoint system not configured' } };
+    }
+    const body = req.body;
+    const name = typeof body?.name === 'string' ? body.name : undefined;
+    const checkpoint = await ctx.checkpointAdapter.createCheckpoint(name, 'manual');
+    return { status: 201, body: checkpoint };
+};
+//# sourceMappingURL=snapshot-create.js.map

package/dist/handlers/snapshot-create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-create.js","sourceRoot":"","sources":["../../src/handlers/snapshot-create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAG/C,yDAAyD;AACzD,MAAM,CAAC,MAAM,cAAc,GAAe,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;IAC3D,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IAC9C,IAAI,MAAM;QAAE,OAAO,MAAM,CAAA;IAEzB,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC;QAC3B,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,kCAAkC,EAAE,EAAE,CAAA;IAC7E,CAAC;IAED,MAAM,IAAI,GAAG,GAAG,CAAC,IAAqC,CAAA;IACtD,MAAM,IAAI,GAAG,OAAO,IAAI,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAA;IAEnE,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IAC/E,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,CAAA;AAC1C,CAAC,CAAA"}

package/dist/handlers/snapshot-delete.d.ts

@@ -0,0 +1,4 @@
+import type { ApiHandler } from '../types.js';
+/** DELETE /api/checkpoints/:version — delete a checkpoint */
+export declare const snapshotDelete: ApiHandler;
+//# sourceMappingURL=snapshot-delete.d.ts.map

package/dist/handlers/snapshot-delete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-delete.d.ts","sourceRoot":"","sources":["../../src/handlers/snapshot-delete.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAG7C,6DAA6D;AAC7D,eAAO,MAAM,cAAc,EAAE,UAkB5B,CAAA"}

package/dist/handlers/snapshot-delete.js

@@ -0,0 +1,21 @@
+import { requireRole } from '../permissions.js';
+import { parseCheckpointVersion } from '../validators.js';
+/** DELETE /api/checkpoints/:version — delete a checkpoint */
+export const snapshotDelete = async (req, ctx) => {
+    const denied = requireRole(ctx.auth, 'admin');
+    if (denied)
+        return denied;
+    if (!ctx.checkpointAdapter) {
+        return { status: 501, body: { error: 'Checkpoint system not configured' } };
+    }
+    const parsed = parseCheckpointVersion(req.params);
+    if (!parsed.isValid)
+        return parsed.response;
+    const { version } = parsed;
+    const deleted = await ctx.checkpointAdapter.deleteCheckpoint(version);
+    if (!deleted) {
+        return { status: 404, body: { error: `Checkpoint version ${version} not found` } };
+    }
+    return { status: 200, body: { deleted: true, version } };
+};
+//# sourceMappingURL=snapshot-delete.js.map

package/dist/handlers/snapshot-delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-delete.js","sourceRoot":"","sources":["../../src/handlers/snapshot-delete.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAEzD,6DAA6D;AAC7D,MAAM,CAAC,MAAM,cAAc,GAAe,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;IAC3D,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;IAC7C,IAAI,MAAM;QAAE,OAAO,MAAM,CAAA;IAEzB,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC;QAC3B,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,kCAAkC,EAAE,EAAE,CAAA;IAC7E,CAAC;IAED,MAAM,MAAM,GAAG,sBAAsB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IACjD,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,MAAM,CAAC,QAAQ,CAAA;IAC3C,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAA;IAE1B,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAA;IACrE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,sBAAsB,OAAO,YAAY,EAAE,EAAE,CAAA;IACpF,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAAA;AAC1D,CAAC,CAAA"}

package/dist/handlers/snapshot-get.d.ts

@@ -0,0 +1,4 @@
+import type { ApiHandler } from '../types.js';
+/** GET /api/checkpoints/:version — get checkpoint details */
+export declare const snapshotGet: ApiHandler;
+//# sourceMappingURL=snapshot-get.d.ts.map

package/dist/handlers/snapshot-get.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-get.d.ts","sourceRoot":"","sources":["../../src/handlers/snapshot-get.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAG7C,6DAA6D;AAC7D,eAAO,MAAM,WAAW,EAAE,UAezB,CAAA"}

package/dist/handlers/snapshot-get.js

@@ -0,0 +1,17 @@
+import { parseCheckpointVersion } from '../validators.js';
+/** GET /api/checkpoints/:version — get checkpoint details */
+export const snapshotGet = async (req, ctx) => {
+    if (!ctx.checkpointAdapter) {
+        return { status: 501, body: { error: 'Checkpoint system not configured' } };
+    }
+    const parsed = parseCheckpointVersion(req.params);
+    if (!parsed.isValid)
+        return parsed.response;
+    const { version } = parsed;
+    const checkpoint = await ctx.checkpointAdapter.getCheckpoint(version);
+    if (!checkpoint) {
+        return { status: 404, body: { error: `Checkpoint version ${version} not found` } };
+    }
+    return { status: 200, body: checkpoint };
+};
+//# sourceMappingURL=snapshot-get.js.map

package/dist/handlers/snapshot-get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-get.js","sourceRoot":"","sources":["../../src/handlers/snapshot-get.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,kBAAkB,CAAA;AAEzD,6DAA6D;AAC7D,MAAM,CAAC,MAAM,WAAW,GAAe,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;IACxD,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC;QAC3B,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,kCAAkC,EAAE,EAAE,CAAA;IAC7E,CAAC;IAED,MAAM,MAAM,GAAG,sBAAsB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IACjD,IAAI,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,MAAM,CAAC,QAAQ,CAAA;IAC3C,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,CAAA;IAE1B,MAAM,UAAU,GAAG,MAAM,GAAG,CAAC,iBAAiB,CAAC,aAAa,CAAC,OAAO,CAAC,CAAA;IACrE,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,sBAAsB,OAAO,YAAY,EAAE,EAAE,CAAA;IACpF,CAAC;IAED,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,CAAA;AAC1C,CAAC,CAAA"}

package/dist/handlers/snapshot-list.d.ts

@@ -0,0 +1,4 @@
+import type { ApiHandler } from '../types.js';
+/** GET /api/checkpoints — list all checkpoints */
+export declare const snapshotList: ApiHandler;
+//# sourceMappingURL=snapshot-list.d.ts.map