@krantho/api 0.0.0-stage → 1.0.1

package/dist/handlers/restore-version.js

@@ -0,0 +1,69 @@
+import { hasVersioning } from '@krantho/persistence';
+import { lockedByOther } from '../content-locks.js';
+import { changedByFromAuth, requireRole } from '../permissions.js';
+import { saveDocument } from '../save-document.js';
+import { parseLocaleParam, parsePositiveInt, requireParam, validateCollectionParam, } from '../validators.js';
+/** POST /api/content/:collection/:slug/restore/:version — restore a version */
+export const restoreVersion = async (req, ctx) => {
+    const denied = requireRole(ctx.auth, 'admin');
+    if (denied)
+        return denied;
+    const validated = validateCollectionParam(req.params['collection'], ctx);
+    if (!validated.isValid)
+        return validated.response;
+    const slugResult = requireParam(req.params, 'slug');
+    if (!slugResult.isValid)
+        return slugResult.response;
+    const slug = slugResult.value;
+    const version = parsePositiveInt(req.params['version']);
+    if (version === undefined || version < 1) {
+        return { status: 400, body: { error: 'Invalid version number' } };
+    }
+    if (!hasVersioning(ctx.adapter)) {
+        return { status: 501, body: { error: 'Adapter does not support version restore' } };
+    }
+    const changedBy = changedByFromAuth(ctx.auth);
+    const locale = parseLocaleParam(req.query['locale']);
+    const locked = await lockedByOther(ctx, { collection: validated.collection, slug, locale });
+    if (locked)
+        return locked;
+    const snapshot = await ctx.adapter.getVersion(validated.collection, slug, version, locale);
+    if (!snapshot)
+        return { status: 404, body: { error: `Version ${version} not found for "${slug}"` } };
+    const currentDocument = await ctx.adapter.getContent?.(validated.collection, slug, locale);
+    const saved = await saveDocument(ctx, {
+        collection: validated.collection,
+        slug,
+        locale,
+        isNew: false,
+        fields: snapshot.fields,
+        metadata: snapshot.metadata,
+        defaults: snapshot.defaults,
+        body: snapshot.body,
+        expectedVersion: currentDocument?.meta.version,
+        changedBy,
+    });
+    if (!saved.ok)
+        return {
+            ...saved.response,
+            body: {
+                ...saved.response.body,
+                restoredVersion: version,
+                message: 'This snapshot needs changes before it can be saved. Prepare a draft to review them.',
+            },
+        };
+    const current = saved.version;
+    const liveVersion = saved.liveVersion;
+    return {
+        status: 200,
+        body: {
+            slug,
+            collection: validated.collection,
+            restoredVersion: version,
+            version: current,
+            liveVersion,
+            message: 'Restored',
+        },
+    };
+};
+//# sourceMappingURL=restore-version.js.map

package/dist/handlers/restore-version.js.map

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

package/dist/handlers/runtime-metadata.d.ts

@@ -0,0 +1,6 @@
+import type { ApiHandler } from '../types.js';
+/** Definition edits create new contracts; they never rewrite existing document revisions. */
+export declare const saveRuntimeMetadata: ApiHandler;
+/** Removing a runtime group changes only the active definition, never saved snapshots. */
+export declare const deleteRuntimeMetadata: ApiHandler;
+//# sourceMappingURL=runtime-metadata.d.ts.map

package/dist/handlers/runtime-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-metadata.d.ts","sourceRoot":"","sources":["../../src/handlers/runtime-metadata.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAa7C,6FAA6F;AAC7F,eAAO,MAAM,mBAAmB,EAAE,UAoCjC,CAAA;AAED,0FAA0F;AAC1F,eAAO,MAAM,qBAAqB,EAAE,UAqBnC,CAAA"}

package/dist/handlers/runtime-metadata.js

@@ -0,0 +1,82 @@
+import { hasRuntimeSchema } from '@krantho/persistence';
+import { resolveCollectionContract } from '@krantho/schema';
+import { z } from 'zod';
+import { changedByFromAuth, requireRole } from '../permissions.js';
+import { formatZodErrors, validateCollectionParam } from '../validators.js';
+const definition = z
+    .object({
+    slot: z.string(),
+    id: z.string(),
+    label: z.string(),
+    required: z.boolean(),
+    schema: z.record(z.string(), z.unknown()),
+})
+    .strict();
+/** Definition edits create new contracts; they never rewrite existing document revisions. */
+export const saveRuntimeMetadata = async (req, ctx) => {
+    const denied = requireRole(ctx.auth, 'admin');
+    if (denied)
+        return denied;
+    const checked = validateCollectionParam(req.params['collection'], ctx);
+    if (!checked.isValid)
+        return checked.response;
+    if (!hasRuntimeSchema(ctx.adapter))
+        return { status: 501, body: { error: 'Adapter does not support runtime definitions' } };
+    const parsed = definition.safeParse(req.body);
+    if (!parsed.success)
+        return {
+            status: 422,
+            body: { error: 'Invalid metadata definition', details: formatZodErrors(parsed.error.issues) },
+        };
+    const group = parsed.data;
+    if (Object.hasOwn(checked.collectionDef.archetype.metadata, group.slot))
+        return { status: 409, body: { error: 'This metadata group is defined in code' } };
+    const previous = await ctx.adapter.getRuntimeSchema(checked.collection);
+    const existing = previous?.metadata?.find((entry) => entry.slot === group.slot);
+    if (existing && existing.id !== group.id)
+        return { status: 409, body: { error: 'A metadata group keeps its identity' } };
+    const next = {
+        collection: checked.collection,
+        fields: previous?.fields ?? [],
+        metadata: [...(previous?.metadata ?? []).filter((entry) => entry.slot !== group.slot), group],
+        updatedAt: new Date().toISOString(),
+    };
+    try {
+        resolveCollectionContract(checked.collectionDef, next);
+    }
+    catch (error) {
+        return {
+            status: 422,
+            body: { error: error instanceof Error ? error.message : 'Unsupported definition' },
+        };
+    }
+    await ctx.adapter.saveRuntimeSchema(checked.collection, next, changedByFromAuth(ctx.auth));
+    return { status: 200, body: { contract: resolveCollectionContract(checked.collectionDef, next) } };
+};
+/** Removing a runtime group changes only the active definition, never saved snapshots. */
+export const deleteRuntimeMetadata = async (req, ctx) => {
+    const denied = requireRole(ctx.auth, 'admin');
+    if (denied)
+        return denied;
+    const checked = validateCollectionParam(req.params['collection'], ctx);
+    if (!checked.isValid)
+        return checked.response;
+    if (!hasRuntimeSchema(ctx.adapter))
+        return { status: 501, body: { error: 'Adapter does not support runtime definitions' } };
+    const slot = req.params['slot'];
+    if (!slot)
+        return { status: 400, body: { error: 'Missing metadata slot' } };
+    if (Object.hasOwn(checked.collectionDef.archetype.metadata, slot))
+        return { status: 409, body: { error: 'This metadata group is defined in code' } };
+    const current = await ctx.adapter.getRuntimeSchema(checked.collection);
+    if (!current?.metadata?.some((group) => group.slot === slot))
+        return { status: 404, body: { error: 'Metadata group not found' } };
+    const next = {
+        ...current,
+        metadata: current.metadata.filter((group) => group.slot !== slot),
+        updatedAt: new Date().toISOString(),
+    };
+    await ctx.adapter.saveRuntimeSchema(checked.collection, next, changedByFromAuth(ctx.auth));
+    return { status: 200, body: { contract: resolveCollectionContract(checked.collectionDef, next) } };
+};
+//# sourceMappingURL=runtime-metadata.js.map

package/dist/handlers/runtime-metadata.js.map

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

package/dist/handlers/save-runtime-field.d.ts

@@ -0,0 +1,4 @@
+import type { ApiHandler } from '../types.js';
+/** PUT /api/schema/:collection/fields — add or update a runtime field */
+export declare const saveRuntimeField: ApiHandler;
+//# sourceMappingURL=save-runtime-field.d.ts.map

package/dist/handlers/save-runtime-field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"save-runtime-field.d.ts","sourceRoot":"","sources":["../../src/handlers/save-runtime-field.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAgB7C,yEAAyE;AACzE,eAAO,MAAM,gBAAgB,EAAE,UAiG9B,CAAA"}

package/dist/handlers/save-runtime-field.js

@@ -0,0 +1,108 @@
+import { hasRuntimeSchema } from '@krantho/persistence';
+import { assertAuthorProperty } from '@krantho/schema';
+import { requireRole } from '../permissions.js';
+import { isTextList, runtimeFieldError } from '../runtime-field-checks.js';
+import { isOneOf, validateCollectionParam, validateRequestBody } from '../validators.js';
+const VALID_FIELD_TYPES = [
+    'string',
+    'number',
+    'boolean',
+    'date',
+    'enum',
+    'url',
+    'email',
+    'textarea',
+    'color',
+    'reference',
+];
+/** PUT /api/schema/:collection/fields — add or update a runtime field */
+export const saveRuntimeField = async (req, ctx) => {
+    const denied = requireRole(ctx.auth, 'admin');
+    if (denied)
+        return denied;
+    const validated = validateCollectionParam(req.params['collection'], ctx);
+    if (!validated.isValid)
+        return validated.response;
+    if (!hasRuntimeSchema(ctx.adapter)) {
+        return { status: 501, body: { error: 'Adapter does not support runtime schemas' } };
+    }
+    const bodyCheck = validateRequestBody(req.body);
+    if (!bodyCheck.isValid)
+        return bodyCheck.response;
+    const body = bodyCheck.body;
+    const fieldName = body['name'];
+    const fieldType = body['type'];
+    if (!fieldName || typeof fieldName !== 'string') {
+        return { status: 400, body: { error: 'Field "name" is required' } };
+    }
+    try {
+        assertAuthorProperty(fieldName);
+    }
+    catch (error) {
+        return {
+            status: 400,
+            body: { error: error instanceof Error ? error.message : 'Invalid field name' },
+        };
+    }
+    if (!fieldType || typeof fieldType !== 'string' || !isOneOf(VALID_FIELD_TYPES, fieldType)) {
+        return {
+            status: 400,
+            body: { error: `Invalid field type. Must be one of: ${VALID_FIELD_TYPES.join(', ')}` },
+        };
+    }
+    // Don't allow overriding code-defined fields
+    const codeFieldNames = new Set(Object.keys(validated.collectionDef.schema.shape));
+    if (codeFieldNames.has(fieldName)) {
+        return {
+            status: 409,
+            body: { error: `Field "${fieldName}" is defined in code and cannot be overridden` },
+        };
+    }
+    const enumValues = body['enumValues'];
+    if (enumValues !== undefined && !isTextList(enumValues)) {
+        return { status: 400, body: { error: 'An enum’s values are a list of text.' } };
+    }
+    // Get existing runtime schema
+    const existing = await ctx.adapter.getRuntimeSchema(validated.collection);
+    const fields = existing?.fields ?? [];
+    // Build validated field definition from body
+    const idx = fields.findIndex((f) => f.name === fieldName);
+    const normalized = {
+        name: fieldName,
+        type: fieldType,
+        required: body['required'] === true,
+        default: body['default'],
+        description: typeof body['description'] === 'string' ? body['description'] : undefined,
+        enumValues: isTextList(enumValues) ? enumValues : undefined,
+        isArray: body['isArray'] === true,
+        refCollection: typeof body['refCollection'] === 'string' ? body['refCollection'] : undefined,
+        min: typeof body['min'] === 'number' ? body['min'] : undefined,
+        max: typeof body['max'] === 'number' ? body['max'] : undefined,
+        pattern: typeof body['pattern'] === 'string' ? body['pattern'] : undefined,
+    };
+    const invalid = runtimeFieldError(normalized, new Set(ctx.contentConfig.collections.keys()));
+    if (invalid)
+        return { status: 400, body: { error: invalid } };
+    // Documents already hold values of the field's type: changing it is not additive
+    const before = fields[idx];
+    if (before && before.type !== normalized.type) {
+        return {
+            status: 409,
+            body: { error: `Field "${fieldName}" is a ${before.type} field: a field keeps its type` },
+        };
+    }
+    if (idx >= 0) {
+        fields[idx] = normalized;
+    }
+    else {
+        fields.push(normalized);
+    }
+    await ctx.adapter.saveRuntimeSchema(validated.collection, {
+        collection: validated.collection,
+        fields,
+        metadata: existing?.metadata ?? [],
+        updatedAt: new Date().toISOString(),
+    });
+    return { status: 200, body: { message: 'Field saved', field: normalized } };
+};
+//# sourceMappingURL=save-runtime-field.js.map

package/dist/handlers/save-runtime-field.js.map

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

package/dist/handlers/search-content.d.ts

@@ -0,0 +1,9 @@
+import type { ApiHandler } from '../types.js';
+/**
+ * GET /api/content/search?q=term&limit=N&offset=N&locale=xx — search every collection
+ *
+ * One `query` matches the text in the slug, the fields and the body, and answers a page of
+ * `{ meta, fields, snippet }` with `hasMore`: never the body, HTML or sections.
+ */
+export declare const searchContent: ApiHandler;
+//# sourceMappingURL=search-content.d.ts.map

package/dist/handlers/search-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-content.d.ts","sourceRoot":"","sources":["../../src/handlers/search-content.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAG7C;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE,UAiC3B,CAAA"}

package/dist/handlers/search-content.js

@@ -0,0 +1,40 @@
+import { canQuery } from '@krantho/persistence';
+import { parseLocaleParam, parsePositiveInt } from '../validators.js';
+/**
+ * GET /api/content/search?q=term&limit=N&offset=N&locale=xx — search every collection
+ *
+ * One `query` matches the text in the slug, the fields and the body, and answers a page of
+ * `{ meta, fields, snippet }` with `hasMore`: never the body, HTML or sections.
+ */
+export const searchContent = async (req, ctx) => {
+    const search = ctx.config.content.search;
+    const text = req.query['q']?.trim();
+    if (!text || text.length < search.minQueryLength) {
+        return {
+            status: 400,
+            body: { error: `Search query must be at least ${search.minQueryLength} characters` },
+        };
+    }
+    const requestedLimit = parsePositiveInt(req.query['limit']) ?? search.defaultLimit;
+    const limit = Math.min(requestedLimit, search.maxLimit);
+    if (!canQuery(ctx.adapter)) {
+        return { status: 501, body: { error: 'Adapter does not support query' } };
+    }
+    const page = await ctx.adapter.query({
+        state: 'current',
+        collections: [...ctx.contentConfig.collections.keys()],
+        projection: 'summary',
+        match: { text, in: ['slug', 'fields', 'body'] },
+        locale: parseLocaleParam(req.query['locale']),
+        limit,
+        offset: parsePositiveInt(req.query['offset']),
+    });
+    return {
+        status: 200,
+        body: {
+            items: page.items.map(({ meta, fields, snippet }) => ({ meta, fields, snippet })),
+            hasMore: page.hasMore,
+        },
+    };
+};
+//# sourceMappingURL=search-content.js.map

package/dist/handlers/search-content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-content.js","sourceRoot":"","sources":["../../src/handlers/search-content.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAA;AAE/C,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAErE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAe,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;IAC1D,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAA;IACxC,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAA;IACnC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,cAAc,EAAE,CAAC;QACjD,OAAO;YACL,MAAM,EAAE,GAAG;YACX,IAAI,EAAE,EAAE,KAAK,EAAE,iCAAiC,MAAM,CAAC,cAAc,aAAa,EAAE;SACrF,CAAA;IACH,CAAC;IAED,MAAM,cAAc,GAAG,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,MAAM,CAAC,YAAY,CAAA;IAClF,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,cAAc,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAA;IAEvD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,gCAAgC,EAAE,EAAE,CAAA;IAC3E,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC;QACnC,KAAK,EAAE,SAAS;QAChB,WAAW,EAAE,CAAC,GAAG,GAAG,CAAC,aAAa,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;QACtD,UAAU,EAAE,SAAS;QACrB,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE;QAC/C,MAAM,EAAE,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC7C,KAAK;QACL,MAAM,EAAE,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;KAC9C,CAAC,CAAA;IACF,OAAO;QACL,MAAM,EAAE,GAAG;QACX,IAAI,EAAE;YACJ,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;YACjF,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB;KACF,CAAA;AACH,CAAC,CAAA"}

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

@@ -0,0 +1,16 @@
+import type { ApiHandler } from '../types.js';
+/**
+ * GET /api/seo/catalog — list available Schema.org types. With `?type=`, the
+ * type's properties and each active reader's rule for it, with the
+ * documentation the rule cites.
+ */
+export declare const seoCatalog: ApiHandler;
+/** GET /api/seo/config/:id — get SEO config (site, collection:name, doc:col/slug) */
+export declare const getSeoConfig: ApiHandler;
+/** PUT /api/seo/config/:id — save SEO config */
+export declare const saveSeoConfig: ApiHandler;
+/** DELETE /api/seo/config/:id — delete SEO config */
+export declare const deleteSeoConfig: ApiHandler;
+/** DELETE /api/seo/config — delete ALL SEO configs (clean slate) */
+export declare const deleteAllSeoConfigs: ApiHandler;
+//# sourceMappingURL=seo-config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"seo-config.d.ts","sourceRoot":"","sources":["../../src/handlers/seo-config.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAG7C;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,UAsBxB,CAAA;AAwDD,qFAAqF;AACrF,eAAO,MAAM,YAAY,EAAE,UAqC1B,CAAA;AA8CD,gDAAgD;AAChD,eAAO,MAAM,aAAa,EAAE,UA6C3B,CAAA;AAED,qDAAqD;AACrD,eAAO,MAAM,eAAe,EAAE,UAyB7B,CAAA;AAED,oEAAoE;AACpE,eAAO,MAAM,mBAAmB,EAAE,UAejC,CAAA"}

package/dist/handlers/seo-config.js

@@ -0,0 +1,250 @@
+import { inferSeoConfigScope } from '@krantho/seo-shared';
+import { announceChange } from '../content-change.js';
+import { documentOfSeoId, documentSeo, saveDocumentSeo } from '../document-seo.js';
+import { requireRole } from '../permissions.js';
+import { loadSeoModule } from '../seo-loader.js';
+import { isSeoModuleMissing, loadSeo } from '../seo-subsystem.js';
+import { validateRequestBody } from '../validators.js';
+/**
+ * GET /api/seo/catalog — list available Schema.org types. With `?type=`, the
+ * type's properties and each active reader's rule for it, with the
+ * documentation the rule cites.
+ */
+export const seoCatalog = async (req, ctx) => {
+    // Dynamic import to avoid bundling seo package in all builds
+    const seo = await loadSeoModule();
+    const { SCHEMA_CATALOG, CATEGORY_LABELS } = seo;
+    const typeParam = req.query['type'];
+    if (typeParam) {
+        const catalogType = seo.getCatalogType(typeParam);
+        if (!catalogType) {
+            return { status: 404, body: { error: `Unknown Schema.org type: ${typeParam}` } };
+        }
+        const properties = seo.getTypeProperties(typeParam);
+        const { readers } = await loadSeo(ctx.config);
+        const rules = readers.flatMap((id) => {
+            const profile = seo.getProfile(id);
+            const rule = profile ? seo.ruleFor(profile, typeParam) : undefined;
+            return profile && rule ? [{ reader: id, readerName: profile.name, ...rule }] : [];
+        });
+        return { status: 200, body: { type: catalogType, properties, rules } };
+    }
+    return { status: 200, body: { types: SCHEMA_CATALOG, categories: CATEGORY_LABELS } };
+};
+/** Types no entity may have: unknown to the vocabulary, superseded or retired; empty without @krantho/seo */
+async function unusableTypes(types) {
+    let seo;
+    try {
+        seo = await loadSeoModule();
+    }
+    catch (err) {
+        if (isSeoModuleMissing(err))
+            return [];
+        throw err;
+    }
+    return types.flatMap((type) => {
+        if (!seo.getVocabularyType(type))
+            return [`"${type}" is not a Schema.org type`];
+        const lifecycle = seo.lifecycleOf(type);
+        if (lifecycle?.status === 'superseded') {
+            return [`"${type}" is superseded by "${lifecycle.by}" in Schema.org`];
+        }
+        if (lifecycle?.status === 'retired')
+            return [`"${type}" is retired from Schema.org`];
+        return [];
+    });
+}
+/** A trail step as stored: a name, and a URL unless it is the page itself */
+function isTrailStep(step) {
+    if (typeof step !== 'object' || step === null)
+        return false;
+    const { name, url } = step;
+    return typeof name === 'string' && name !== '' && (url === undefined || typeof url === 'string');
+}
+/** A scope's page structure from a request; undefined when absent, null when malformed */
+function structureOf(raw) {
+    if (raw === undefined || raw === null)
+        return undefined;
+    if (typeof raw !== 'object' || Array.isArray(raw))
+        return null;
+    const { trail, kind } = raw;
+    if (trail !== undefined && !(Array.isArray(trail) && trail.every(isTrailStep)))
+        return null;
+    if (kind !== undefined && typeof kind !== 'string')
+        return null;
+    return {
+        ...(trail ? { trail: trail.map(({ name, url }) => (url ? { name, url } : { name })) } : {}),
+        ...(kind ? { kind } : {}),
+    };
+}
+/**
+ * The site's robots.txt override from a request: undefined when absent or
+ * empty, the text when the site scope gives it, else why it is refused
+ */
+function robotsTxtOf(raw, scope) {
+    if (raw === undefined || raw === null || raw === '')
+        return { robotsTxt: undefined };
+    if (typeof raw !== 'string')
+        return { error: 'robotsTxt takes the robots.txt text' };
+    if (scope !== 'site')
+        return { error: 'robotsTxt belongs to the site scope only' };
+    return { robotsTxt: raw };
+}
+/** GET /api/seo/config/:id — get SEO config (site, collection:name, doc:col/slug) */
+export const getSeoConfig = async (req, ctx) => {
+    if (!ctx.seoConfigAdapter) {
+        return { status: 501, body: { error: 'SEO configuration not available' } };
+    }
+    const id = req.params['id'] ?? req.query['id'];
+    if (!id) {
+        // List all configs
+        const scope = req.query['scope'];
+        const configs = await ctx.seoConfigAdapter.listConfigs(scope);
+        return { status: 200, body: { configs } };
+    }
+    if (documentOfSeoId(id)) {
+        const entry = await documentSeo(ctx, id, req.query['locale']);
+        return {
+            status: 200,
+            body: {
+                config: entry?.config
+                    ? {
+                        id,
+                        scope: 'document',
+                        config: entry.config,
+                        createdAt: entry.document.meta.createdAt,
+                        updatedAt: entry.document.meta.createdAt,
+                    }
+                    : null,
+                version: entry?.document.meta.version ?? null,
+            },
+        };
+    }
+    const config = await ctx.seoConfigAdapter.getConfig(id);
+    if (!config) {
+        return { status: 200, body: { config: null } };
+    }
+    return { status: 200, body: { config } };
+};
+/** An entity of a request, with only the keys an entity has */
+function entityOf(e) {
+    return {
+        '@type': String(e['@type'] ?? ''),
+        ...(e['@id'] ? { '@id': String(e['@id']) } : {}),
+        ...(e['role'] ? { role: String(e['role']) } : {}),
+        properties: (typeof e['properties'] === 'object' && e['properties'] !== null
+            ? e['properties']
+            : {}),
+    };
+}
+/**
+ * A scope's configuration from a request — `{ config: { entities, … } }`, or
+ * the same keys at the top level — or why it is refused
+ */
+function configOf(payload, scope) {
+    const nested = payload['config'];
+    const pick = (key) => nested?.[key] ?? payload[key];
+    const rawEntities = Array.isArray(nested?.['entities']) ? nested['entities'] : payload['entities'];
+    const entities = Array.isArray(rawEntities) ? rawEntities : [];
+    const rawFieldMappings = pick('fieldMappings');
+    const fieldMappings = typeof rawFieldMappings === 'object' && rawFieldMappings !== null
+        ? rawFieldMappings
+        : undefined;
+    const structure = structureOf(pick('structure'));
+    if (structure === null)
+        return { error: 'structure takes a trail of { name, url? } steps and a kind' };
+    const robots = robotsTxtOf(pick('robotsTxt'), scope);
+    if ('error' in robots)
+        return robots;
+    return {
+        config: {
+            entities: entities.map(entityOf),
+            ...(fieldMappings ? { fieldMappings } : {}),
+            ...(structure ? { structure } : {}),
+            ...(robots.robotsTxt ? { robotsTxt: robots.robotsTxt } : {}),
+        },
+    };
+}
+/** PUT /api/seo/config/:id — save SEO config */
+export const saveSeoConfig = async (req, ctx) => {
+    const denied = requireRole(ctx.auth, 'admin');
+    if (denied)
+        return denied;
+    if (!ctx.seoConfigAdapter) {
+        return { status: 501, body: { error: 'SEO configuration not available' } };
+    }
+    const bodyCheck = validateRequestBody(req.body);
+    if (!bodyCheck.isValid)
+        return bodyCheck.response;
+    const payload = bodyCheck.body;
+    const id = (req.params['id'] ?? req.query['id'] ?? payload['id']);
+    if (!id) {
+        return { status: 400, body: { error: 'Config ID is required' } };
+    }
+    const scope = inferSeoConfigScope(id);
+    const parsed = configOf(payload, scope);
+    if ('error' in parsed)
+        return { status: 400, body: { error: parsed.error } };
+    const { config } = parsed;
+    const issues = await unusableTypes(config.entities.map((entity) => entity['@type']));
+    if (issues.length > 0) {
+        return { status: 400, body: { error: 'The configuration names types it cannot use', issues } };
+    }
+    if (scope === 'document') {
+        if (!documentOfSeoId(id))
+            return { status: 400, body: { error: 'Invalid document SEO ID' } };
+        const entry = await documentSeo(ctx, id, typeof payload['locale'] === 'string' ? payload['locale'] : req.query['locale']);
+        if (!entry)
+            return { status: 404, body: { error: 'Document not found' } };
+        if (typeof payload['_version'] !== 'number')
+            return { status: 400, body: { error: 'A document version is required' } };
+        const saved = await saveDocumentSeo(ctx, entry.document, config, payload['_version']);
+        return saved.ok ? { status: 200, body: { ...saved, message: 'Saved draft' } } : saved.response;
+    }
+    await ctx.seoConfigAdapter.saveConfig({ id, scope, config });
+    await announceChange(ctx, { kind: 'seo', configId: id });
+    const saved = await ctx.seoConfigAdapter.getConfig(id);
+    return { status: 200, body: { config: saved } };
+};
+/** DELETE /api/seo/config/:id — delete SEO config */
+export const deleteSeoConfig = async (req, ctx) => {
+    const denied = requireRole(ctx.auth, 'admin');
+    if (denied)
+        return denied;
+    if (!ctx.seoConfigAdapter) {
+        return { status: 501, body: { error: 'SEO configuration not available' } };
+    }
+    const id = req.params['id'] ?? req.query['id'];
+    if (!id) {
+        return { status: 400, body: { error: 'Config ID is required' } };
+    }
+    if (documentOfSeoId(id)) {
+        const payload = req.body;
+        const entry = await documentSeo(ctx, id, payload?.locale ?? req.query['locale']);
+        if (!entry)
+            return { status: 404, body: { error: 'Document not found' } };
+        if (typeof payload?._version !== 'number')
+            return { status: 400, body: { error: 'A document version is required' } };
+        const saved = await saveDocumentSeo(ctx, entry.document, null, payload._version);
+        return saved.ok ? { status: 200, body: { ...saved, deleted: true } } : saved.response;
+    }
+    await ctx.seoConfigAdapter.deleteConfig(id);
+    await announceChange(ctx, { kind: 'seo', configId: id });
+    return { status: 200, body: { deleted: true } };
+};
+/** DELETE /api/seo/config — delete ALL SEO configs (clean slate) */
+export const deleteAllSeoConfigs = async (_req, ctx) => {
+    const denied = requireRole(ctx.auth, 'admin');
+    if (denied)
+        return denied;
+    if (!ctx.seoConfigAdapter) {
+        return { status: 501, body: { error: 'SEO configuration not available' } };
+    }
+    const count = await ctx.seoConfigAdapter.deleteAllConfigs();
+    await announceChange(ctx, { kind: 'seo' });
+    return {
+        status: 200,
+        body: { deleted: count, message: `Removed ${count} SEO configurations` },
+    };
+};
+//# sourceMappingURL=seo-config.js.map