@krantho/api 0.0.0-stage → 1.0.1

package/dist/handlers/seo-enrich-meta.js

@@ -0,0 +1,121 @@
+import { structuredComplete } from '@krantho/ai';
+import { buildSeoFieldMap, documentSeoProperties } from '@krantho/seo-shared';
+import { getActiveContract } from '../merged-schema.js';
+import { saveDocument } from '../save-document.js';
+export const DESCRIPTION_SCHEMA = {
+    type: 'object',
+    properties: { description: { type: 'string' } },
+    required: ['description'],
+};
+export function buildMetaPrompt(siteName, language, text, limits) {
+    return `You are an SEO expert for ${siteName}.
+
+Write a meta description based on the text below.
+
+Requirements:
+- Between ${limits.minChars} and ${limits.maxChars} characters including spaces, so it displays in full in search results
+- Written in ${language}
+- Natural language, no keyword-stuffing
+- No quotation marks around the text
+- Only the description itself, nothing else
+- Focus on what the user can expect from the page
+
+Text:
+${text.slice(0, limits.contentCap)}`;
+}
+/**
+ * Whether a document needs a generated meta description: a description in its
+ * SEO config or in its description field is never replaced unless `force`, and
+ * a document with too little text is skipped. The reason when it is skipped.
+ */
+export async function prepareMetaDescription(_target, content, _seoConfigAdapter, force) {
+    const description = documentSeoProperties(content.metadata)['description'];
+    if (typeof description === 'string' && description.length > 0 && !force) {
+        return { skip: `Authored description exists (${description.length} chars) — preserved` };
+    }
+    // Resolve which CMS field holds the description dynamically
+    const properties = content.contract?.fields['properties'];
+    const field = buildSeoFieldMap(Object.keys(properties && typeof properties === 'object' ? properties : content.fields)).description;
+    // Check existing CMS field
+    const existing = field ? content.fields[field] : undefined;
+    if (typeof existing === 'string' && existing.length > 0 && !force) {
+        return { skip: `Already has ${field} (${existing.length} chars)` };
+    }
+    const text = descriptionSourceText(content, field);
+    if (text.length < 20)
+        return { skip: 'Insufficient content' };
+    return { field, text };
+}
+/** Body text, or the document's string fields when the body is short */
+function descriptionSourceText(content, descriptionField) {
+    const text = content.body?.trim() ?? '';
+    if (text.length >= 50)
+        return text;
+    const parts = [];
+    for (const [key, val] of Object.entries(content.fields)) {
+        if (key === 'status' || key === descriptionField)
+            continue;
+        if (typeof val === 'string' && val.length > 3)
+            parts.push(val);
+    }
+    return parts.join('. ');
+}
+/** Generate a meta description from `text`, cut to `limits.maxChars` */
+export async function generateMetaDescription(text, llm, site, limits) {
+    const prompt = buildMetaPrompt(site.name, site.language, text, limits);
+    const result = await structuredComplete(llm, prompt, DESCRIPTION_SCHEMA, { maxTokens: limits.maxTokens });
+    // LLMs can't count characters reliably — hard truncate if too long
+    const desc = result.description.trim();
+    if (desc.length <= limits.maxChars)
+        return desc;
+    return `${desc.slice(0, limits.maxChars - 1).replace(/\s+\S*$/, '')}.`;
+}
+/** Enrich meta-description for a single item */
+export async function enrichMetaDescription(item, content, llm, ctx, seoConfigAdapter, site, limits, force) {
+    const collection = ctx.contentConfig.collections.get(item.collection);
+    if (!collection)
+        throw new Error('Collection not found');
+    const contract = await getActiveContract(collection, ctx.adapter);
+    const source = await prepareMetaDescription(item, { ...content, contract }, seoConfigAdapter, force);
+    if ('skip' in source) {
+        item.status = 'skipped';
+        item.result = source.skip;
+        return 'skipped';
+    }
+    if (!source.field && !contract.metadata['sharing']) {
+        item.status = 'skipped';
+        item.result = 'No description property is declared by this document contract';
+        return 'skipped';
+    }
+    item.status = 'generating';
+    const desc = await generateMetaDescription(source.text, llm, site, limits);
+    const fields = { ...content.fields };
+    const metadata = structuredClone(content.metadata);
+    if (source.field)
+        fields[source.field] = desc;
+    else if (contract.metadata['sharing']) {
+        metadata['sharing'] = { ...metadata['sharing'], description: desc };
+    }
+    else {
+        item.status = 'skipped';
+        item.result = 'No description property is declared by this document contract';
+        return 'skipped';
+    }
+    const saved = await saveDocument(ctx, {
+        collection: item.collection,
+        slug: item.slug,
+        locale: content.meta.locale,
+        fields,
+        metadata,
+        body: content.body,
+        isNew: false,
+        expectedVersion: content.meta.version,
+        changedBy: 'seo-enrichment',
+    });
+    if (!saved.ok)
+        throw new Error(String(saved.response.body.error ?? 'Document save failed'));
+    item.status = 'complete';
+    item.result = `${desc.length} chars: ${desc}`;
+    return 'generated';
+}
+//# sourceMappingURL=seo-enrich-meta.js.map

package/dist/handlers/seo-enrich-meta.js.map

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

package/dist/handlers/seo-enrich-runner.d.ts

@@ -0,0 +1,65 @@
+import type { LLMAdapter } from '@krantho/ai';
+import { type GetTypePropertiesFn } from './seo-enrich-archetype.js';
+/** In-memory job state (one job at a time) */
+export interface EnrichJob {
+    id: string;
+    status: 'running' | 'complete' | 'error';
+    type: string;
+    /** Whether the run writes over values someone set */
+    force: boolean;
+    items: Array<{
+        collection: string;
+        slug: string;
+        locale?: string | undefined;
+        status: 'pending' | 'generating' | 'complete' | 'skipped' | 'error';
+        result?: string | undefined;
+        error?: string | undefined;
+    }>;
+    startedAt: number;
+    /** The run that works on the job; a run that finds another's token in the saved job stops */
+    runner?: string | undefined;
+    /** When the job last saved its progress: a running job that has not for a while has lost its runner */
+    updatedAt: number;
+    completedAt?: number | undefined;
+    summary?: {
+        generated: number;
+        skipped: number;
+        errors: number;
+    } | undefined;
+    /** What the provider reported for the job's completions; zero when it reports none */
+    usage: EnrichUsage;
+}
+/** Tokens the job's completions used, and the model that served the first of them */
+export interface EnrichUsage {
+    inputTokens: number;
+    outputTokens: number;
+    model: string | null;
+}
+declare class JobStore {
+    private job;
+    get(): EnrichJob | null;
+    set(job: EnrichJob): void;
+    clear(): void;
+}
+export declare const jobStore: JobStore;
+/** Whether a running job has stopped saving: its runner is lost */
+export declare function isStale(job: EnrichJob): boolean;
+/**
+ * The latest job from any instance. A job this instance is running is read from memory; for
+ * another, the saved copy is read, because consecutive requests may reach different instances.
+ */
+export declare function currentJob(ctx: ApiContext): Promise<EnrichJob | null>;
+/** Save the job's first state, so any instance can answer for it from the start */
+export declare function announceJob(ctx: ApiContext, job: EnrichJob): Promise<void>;
+import type { ApiContext } from '../types.js';
+/**
+ * Load `getTypeProperties` from the optional `@krantho/seo` package once per
+ * job. If the package isn't installed, return null — archetype enrichment will
+ * short-circuit to error for each item, but meta-description enrichment still
+ * runs independently.
+ */
+export declare function loadGetTypeProperties(): Promise<GetTypePropertiesFn | null>;
+/** Background enrichment runner */
+export declare function runEnrichment(job: EnrichJob, llm: LLMAdapter, ctx: ApiContext, type: string, force: boolean): Promise<void>;
+export {};
+//# sourceMappingURL=seo-enrich-runner.d.ts.map

package/dist/handlers/seo-enrich-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seo-enrich-runner.d.ts","sourceRoot":"","sources":["../../src/handlers/seo-enrich-runner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE7C,OAAO,EAA6B,KAAK,mBAAmB,EAAE,MAAM,2BAA2B,CAAA;AAG/F,8CAA8C;AAC9C,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,SAAS,GAAG,UAAU,GAAG,OAAO,CAAA;IACxC,IAAI,EAAE,MAAM,CAAA;IACZ,qDAAqD;IACrD,KAAK,EAAE,OAAO,CAAA;IACd,KAAK,EAAE,KAAK,CAAC;QACX,UAAU,EAAE,MAAM,CAAA;QAClB,IAAI,EAAE,MAAM,CAAA;QACZ,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC3B,MAAM,EAAE,SAAS,GAAG,YAAY,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,CAAA;QACnE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QAC3B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAC3B,CAAC,CAAA;IACF,SAAS,EAAE,MAAM,CAAA;IACjB,6FAA6F;IAC7F,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,uGAAuG;IACvG,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAChC,OAAO,CAAC,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAA;IAC5E,sFAAsF;IACtF,KAAK,EAAE,WAAW,CAAA;CACnB;AAED,qFAAqF;AACrF,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CACrB;AAWD,cAAM,QAAQ;IACZ,OAAO,CAAC,GAAG,CAAyB;IAEpC,GAAG,IAAI,SAAS,GAAG,IAAI;IAIvB,GAAG,CAAC,GAAG,EAAE,SAAS,GAAG,IAAI;IAIzB,KAAK,IAAI,IAAI;CAGd;AAED,eAAO,MAAM,QAAQ,UAAiB,CAAA;AA+CtC,mEAAmE;AACnE,wBAAgB,OAAO,CAAC,GAAG,EAAE,SAAS,GAAG,OAAO,CAE/C;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAQ3E;AAED,mFAAmF;AACnF,wBAAsB,WAAW,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhF;AAID,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE7C;;;;;GAKG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC,CAOjF;AAuED,mCAAmC;AACnC,wBAAsB,aAAa,CACjC,GAAG,EAAE,SAAS,EACd,GAAG,EAAE,UAAU,EACf,GAAG,EAAE,UAAU,EACf,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,IAAI,CAAC,CAmDf"}

package/dist/handlers/seo-enrich-runner.js

@@ -0,0 +1,192 @@
+import { canGetContent } from '@krantho/persistence';
+import { enrichArchetypeProperties } from './seo-enrich-archetype.js';
+import { enrichMetaDescription } from './seo-enrich-meta.js';
+/** The site setting every instance reads the running job from */
+const JOB_SETTING = 'seo.enrich.job';
+/** How long a running job may go without saving before its runner counts as lost (a frozen or stopped function) */
+const STALE_MS = 90_000;
+/** How often a running job saves its progress */
+const SAVE_EVERY_MS = 2_000;
+class JobStore {
+    job = null;
+    get() {
+        return this.job;
+    }
+    set(job) {
+        this.job = job;
+    }
+    clear() {
+        this.job = null;
+    }
+}
+export const jobStore = new JobStore();
+/** Save the job where every instance can read it; failing to save never stops the job */
+async function persistJob(ctx, job) {
+    job.updatedAt = Date.now();
+    try {
+        await ctx.siteSettingsAdapter?.setSetting(JOB_SETTING, JSON.stringify(job));
+    }
+    catch {
+        // The job goes on from this instance's memory
+    }
+}
+const JOB_STATUSES = ['running', 'complete', 'error'];
+/** Whether a saved value is a job: the fields the takeover and the status endpoint read */
+function isJob(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const job = value;
+    return (typeof job['id'] === 'string' &&
+        typeof job['type'] === 'string' &&
+        JOB_STATUSES.includes(job['status']) &&
+        typeof job['startedAt'] === 'number' &&
+        typeof job['updatedAt'] === 'number' &&
+        Array.isArray(job['items']) &&
+        typeof job['usage'] === 'object' &&
+        job['usage'] !== null);
+}
+/** The job another instance saved, when there is one */
+async function storedJob(ctx) {
+    try {
+        const raw = await ctx.siteSettingsAdapter?.getSetting(JOB_SETTING);
+        const job = raw ? JSON.parse(raw) : null;
+        return isJob(job) ? job : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Whether another run has taken the job over: its token is in the saved job, not this run's */
+async function takenOver(ctx, job, runner) {
+    const stored = await storedJob(ctx);
+    return stored?.id === job.id && stored.runner !== undefined && stored.runner !== runner;
+}
+/** Whether a running job has stopped saving: its runner is lost */
+export function isStale(job) {
+    return job.status === 'running' && Date.now() - job.updatedAt > STALE_MS;
+}
+/**
+ * The latest job from any instance. A job this instance is running is read from memory; for
+ * another, the saved copy is read, because consecutive requests may reach different instances.
+ */
+export async function currentJob(ctx) {
+    const own = jobStore.get();
+    if (own?.status === 'running' && !isStale(own))
+        return own;
+    const stored = await storedJob(ctx);
+    if (!stored)
+        return own;
+    if (!own)
+        return stored;
+    if (own.id === stored.id)
+        return own.updatedAt >= stored.updatedAt ? own : stored;
+    return own.startedAt >= stored.startedAt ? own : stored;
+}
+/** Save the job's first state, so any instance can answer for it from the start */
+export async function announceJob(ctx, job) {
+    jobStore.set(job);
+    await persistJob(ctx, job);
+}
+import { lockHolder } from '../content-locks.js';
+import { loadSeoModule } from '../seo-loader.js';
+/**
+ * Load `getTypeProperties` from the optional `@krantho/seo` package once per
+ * job. If the package isn't installed, return null — archetype enrichment will
+ * short-circuit to error for each item, but meta-description enrichment still
+ * runs independently.
+ */
+export async function loadGetTypeProperties() {
+    try {
+        const seo = await loadSeoModule();
+        return seo.getTypeProperties;
+    }
+    catch {
+        return null;
+    }
+}
+/** The adapter, adding each completion's usage and model to the job's totals */
+function metered(llm, job) {
+    return {
+        get supportsJsonSchema() {
+            return llm.supportsJsonSchema;
+        },
+        async complete(prompt, options) {
+            const result = await llm.complete(prompt, options);
+            job.usage.inputTokens += result.usage.inputTokens;
+            job.usage.outputTokens += result.usage.outputTokens;
+            job.usage.model ??= result.model || null;
+            return result;
+        },
+    };
+}
+/** Enrich a single item based on the job type; returns the result classification. */
+async function enrichItem(item, content, deps) {
+    if (deps.type === 'meta-descriptions') {
+        return enrichMetaDescription(item, content, deps.llm, deps.ctx, deps.seoConfigAdapter, deps.ctx.config.site, deps.ctx.config.seo.enrichment.meta, deps.force);
+    }
+    if (deps.type === 'archetype') {
+        if (!deps.getTypeProperties) {
+            item.status = 'error';
+            item.error = '@krantho/seo not available';
+            return 'error';
+        }
+        return enrichArchetypeProperties(item, content, deps.llm, deps.seoConfigAdapter, deps.ctx.config.site, deps.ctx.config.seo.enrichment.archetype, deps.force, deps.getTypeProperties, deps.ctx);
+    }
+    item.status = 'skipped';
+    item.result = `Unsupported type: ${deps.type}`;
+    return 'skipped';
+}
+/** Background enrichment runner */
+export async function runEnrichment(job, llm, ctx, type, force) {
+    const getTypeProperties = type === 'archetype' ? await loadGetTypeProperties() : null;
+    const deps = {
+        llm: metered(llm, job),
+        ctx,
+        seoConfigAdapter: ctx.seoConfigAdapter ?? null,
+        type,
+        force,
+        getTypeProperties,
+    };
+    // Taking the job over: the run before this one, if it is still alive, stops at its next item
+    const runner = crypto.randomUUID();
+    job.runner = runner;
+    await persistJob(ctx, job);
+    let saved = Date.now();
+    // A resumed job leaves the items it finished alone
+    for (const item of job.items) {
+        if (item.status !== 'pending' && item.status !== 'generating')
+            continue;
+        if (await takenOver(ctx, job, runner))
+            return;
+        if (Date.now() - saved >= SAVE_EVERY_MS) {
+            saved = Date.now();
+            await persistJob(ctx, job);
+        }
+        try {
+            if (!canGetContent(ctx.adapter))
+                break;
+            const content = await ctx.adapter.getContent(item.collection, item.slug, item.locale);
+            if (!content) {
+                item.status = 'skipped';
+                item.result = 'Content not found';
+                continue;
+            }
+            if ((await lockHolder(ctx, item)) !== null) {
+                item.status = 'skipped';
+                item.result = 'Being edited by another user';
+                continue;
+            }
+            await enrichItem(item, content, deps);
+        }
+        catch (err) {
+            item.status = 'error';
+            item.error = err instanceof Error ? err.message : 'Unknown error';
+        }
+    }
+    const count = (status) => job.items.filter((i) => i.status === status).length;
+    job.status = 'complete';
+    job.completedAt = Date.now();
+    job.summary = { generated: count('complete'), skipped: count('skipped'), errors: count('error') };
+    await persistJob(ctx, job);
+}
+//# sourceMappingURL=seo-enrich-runner.js.map

package/dist/handlers/seo-enrich-runner.js.map

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

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

@@ -0,0 +1,10 @@
+import type { ApiHandler } from '../types.js';
+/**
+ * POST /api/seo/enrich — enrich the documents of a scope (`all`, `collection`
+ * or `item`): a collection scope reads only that collection's documents, an
+ * item only that collection's document with the slug.
+ */
+export declare const seoEnrich: ApiHandler;
+/** GET /api/seo/enrich/status — poll job progress, from whichever instance answers */
+export declare const seoEnrichStatus: ApiHandler;
+//# sourceMappingURL=seo-enrich.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"seo-enrich.d.ts","sourceRoot":"","sources":["../../src/handlers/seo-enrich.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAc,UAAU,EAAe,MAAM,aAAa,CAAA;AA6FtE;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAE,UAoCvB,CAAA;AAkBD,sFAAsF;AACtF,eAAO,MAAM,eAAe,EAAE,UAgC7B,CAAA"}

package/dist/handlers/seo-enrich.js

@@ -0,0 +1,166 @@
+import { canQuery } from '@krantho/persistence';
+import { groupByCollection } from '../group-by-collection.js';
+import { requireRole } from '../permissions.js';
+import { validateRequestBody } from '../validators.js';
+import { resolveAdapter } from './llm-resolve.js';
+import { announceJob, currentJob, isStale, runEnrichment } from './seo-enrich-runner.js';
+/**
+ * The scope a request asks for: `scope` when given, else inferred from what
+ * it names (a collection and a slug, a collection, or neither). A collection
+ * or item scope must name a configured collection, and an item its slug.
+ */
+function enrichScope(payload, ctx) {
+    const collection = typeof payload['collection'] === 'string' ? payload['collection'] : undefined;
+    const slug = typeof payload['slug'] === 'string' ? payload['slug'] : undefined;
+    const named = slug !== undefined ? 'item' : collection !== undefined ? 'collection' : 'all';
+    const scope = payload['scope'] ?? named;
+    if (scope === 'all')
+        return { scope };
+    if (scope !== 'collection' && scope !== 'item')
+        return 'scope is all, collection or item';
+    if (collection === undefined || !ctx.contentConfig.collections.has(collection)) {
+        return `scope ${scope} needs a configured collection`;
+    }
+    if (scope === 'collection')
+        return { scope, collection };
+    if (slug === undefined)
+        return 'scope item needs a slug';
+    return { scope, collection, slug };
+}
+/** The store when it can query, read and write content; null otherwise */
+function enrichStore(adapter) {
+    const { getContent, writeContent } = adapter;
+    return canQuery(adapter) && getContent && writeContent ? adapter : null;
+}
+/** The documents a job enriches: every document of the scope's collections, one document for an item */
+async function enrichItems(adapter, ctx, target) {
+    const names = target.scope === 'all' ? [...ctx.contentConfig.collections.keys()] : [target.collection];
+    const { items: metas } = await adapter.query({
+        state: 'current',
+        projection: 'meta',
+        collections: names,
+    });
+    const documents = groupByCollection(metas, names, (meta) => meta.collection);
+    const items = [];
+    for (const collection of names) {
+        for (const meta of documents.get(collection) ?? []) {
+            if (target.scope === 'item' && meta.slug !== target.slug)
+                continue;
+            items.push({ collection, slug: meta.slug, locale: meta.locale, status: 'pending' });
+        }
+    }
+    return items;
+}
+/** Start a job over the items in the background; the response names it */
+async function startJob(ctx, llm, type, force, items) {
+    const job = {
+        id: `enrich-${Date.now()}`,
+        status: 'running',
+        type,
+        force,
+        items,
+        startedAt: Date.now(),
+        updatedAt: Date.now(),
+        usage: { inputTokens: 0, outputTokens: 0, model: null },
+    };
+    await announceJob(ctx, job);
+    const run = runEnrichment(job, llm, ctx, type, force);
+    ctx.waitUntil?.(run);
+    return job;
+}
+/** The refusal while another job runs, on any instance: one job at a time; a job that lost its runner does not count */
+async function runningJob(ctx) {
+    const active = await currentJob(ctx);
+    if (active?.status !== 'running' || isStale(active))
+        return null;
+    return { status: 409, body: { error: 'An enrichment job is already running', jobId: active.id } };
+}
+/**
+ * POST /api/seo/enrich — enrich the documents of a scope (`all`, `collection`
+ * or `item`): a collection scope reads only that collection's documents, an
+ * item only that collection's document with the slug.
+ */
+export const seoEnrich = async (req, ctx) => {
+    const denied = requireRole(ctx.auth, 'admin');
+    if (denied)
+        return denied;
+    const running = await runningJob(ctx);
+    if (running)
+        return running;
+    const bodyCheck = validateRequestBody(req.body);
+    if (!bodyCheck.isValid)
+        return bodyCheck.response;
+    const payload = bodyCheck.body;
+    const target = enrichScope(payload, ctx);
+    if (typeof target === 'string')
+        return { status: 400, body: { error: target } };
+    const type = payload['type'] ?? 'meta-descriptions';
+    const llm = await resolveAdapter(ctx).catch((err) => err instanceof Error ? err.message : 'Failed to create LLM adapter');
+    if (typeof llm === 'string')
+        return { status: 400, body: { error: llm } };
+    const store = enrichStore(ctx.adapter);
+    if (!store) {
+        return {
+            status: 501,
+            body: { error: 'Persistence adapter does not support content read/write' },
+        };
+    }
+    const items = await enrichItems(store, ctx, target);
+    if (items.length === 0) {
+        return { status: 200, body: { jobId: null, message: 'No items to enrich' } };
+    }
+    const job = await startJob(ctx, llm, type, payload['force'] === true, items);
+    return {
+        status: 202,
+        body: { jobId: job.id, status: 'running', type, totalItems: items.length },
+    };
+};
+/**
+ * A job whose runner stopped (the function that ran it was frozen or ended) goes on from the
+ * pending items on this instance; the items it finished are not run again.
+ */
+async function resumeIfLost(job, ctx) {
+    if (!isStale(job))
+        return;
+    try {
+        const llm = await resolveAdapter(ctx);
+        await announceJob(ctx, job);
+        ctx.waitUntil?.(runEnrichment(job, llm, ctx, job.type, job.force));
+    }
+    catch {
+        // Without a model, or when the job cannot be saved, it is reported as it stands: the next
+        // status request tries again
+    }
+}
+/** GET /api/seo/enrich/status — poll job progress, from whichever instance answers */
+export const seoEnrichStatus = async (req, ctx) => {
+    const jobId = req.query['jobId'];
+    const current = await currentJob(ctx);
+    if (!current || (jobId && current.id !== jobId)) {
+        return { status: 404, body: { error: 'No active enrichment job' } };
+    }
+    await resumeIfLost(current, ctx);
+    const completed = current.items.filter((i) => i.status === 'complete').length;
+    const skipped = current.items.filter((i) => i.status === 'skipped').length;
+    const errors = current.items.filter((i) => i.status === 'error').length;
+    const generating = current.items.find((i) => i.status === 'generating');
+    return {
+        status: 200,
+        body: {
+            jobId: current.id,
+            status: current.status,
+            type: current.type,
+            progress: {
+                total: current.items.length,
+                completed,
+                skipped,
+                errors,
+                current: generating ? `${generating.collection}/${generating.slug}` : null,
+            },
+            items: current.items,
+            summary: current.summary,
+            usage: current.usage,
+        },
+    };
+};
+//# sourceMappingURL=seo-enrich.js.map

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

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

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

@@ -0,0 +1,4 @@
+import type { ApiHandler } from '../types.js';
+/** POST /api/seo/generate — regenerate SEO files that can be built without CLI tools */
+export declare const seoGenerate: ApiHandler;
+//# sourceMappingURL=seo-generate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"seo-generate.d.ts","sourceRoot":"","sources":["../../src/handlers/seo-generate.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAG7C,wFAAwF;AACxF,eAAO,MAAM,WAAW,EAAE,UA2BzB,CAAA"}

package/dist/handlers/seo-generate.js

@@ -0,0 +1,31 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { requireRole } from '../permissions.js';
+import { buildSitemapUrls, serializeSitemapXml } from './seo-sitemap.js';
+/** POST /api/seo/generate — regenerate SEO files that can be built without CLI tools */
+export const seoGenerate = async (_req, ctx) => {
+    const denied = requireRole(ctx.auth, 'editor');
+    if (denied)
+        return denied;
+    const basePath = ctx.config.paths.seoGeneratedDir;
+    await mkdir(basePath, { recursive: true });
+    const results = {};
+    // The same sitemap the site serves at /sitemap.xml
+    try {
+        const xml = serializeSitemapXml(await buildSitemapUrls(ctx));
+        await writeFile(join(basePath, 'sitemap.xml'), xml, 'utf-8');
+        results['sitemap'] = 'generated';
+    }
+    catch {
+        results['sitemap'] = 'failed';
+    }
+    // structured-data.json and faq-pages.json require @krantho/tools (CLI-only)
+    results['structured-data'] = 'requires CLI: pnpm run seo:generate';
+    results['faq-pages'] = 'requires CLI: pnpm run seo:generate';
+    results['llms-txt'] = 'requires CLI: pnpm run seo:generate';
+    return {
+        status: 200,
+        body: { results },
+    };
+};
+//# sourceMappingURL=seo-generate.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"seo-generate.js","sourceRoot":"","sources":["../../src/handlers/seo-generate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAExE,wFAAwF;AACxF,MAAM,CAAC,MAAM,WAAW,GAAe,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE;IACzD,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAA;IAC9C,IAAI,MAAM;QAAE,OAAO,MAAM,CAAA;IAEzB,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,eAAe,CAAA;IACjD,MAAM,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAE1C,MAAM,OAAO,GAA2B,EAAE,CAAA;IAE1C,mDAAmD;IACnD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,mBAAmB,CAAC,MAAM,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAA;QAC5D,MAAM,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,CAAA;QAC5D,OAAO,CAAC,SAAS,CAAC,GAAG,WAAW,CAAA;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,SAAS,CAAC,GAAG,QAAQ,CAAA;IAC/B,CAAC;IAED,4EAA4E;IAC5E,OAAO,CAAC,iBAAiB,CAAC,GAAG,qCAAqC,CAAA;IAClE,OAAO,CAAC,WAAW,CAAC,GAAG,qCAAqC,CAAA;IAC5D,OAAO,CAAC,UAAU,CAAC,GAAG,qCAAqC,CAAA;IAE3D,OAAO;QACL,MAAM,EAAE,GAAG;QACX,IAAI,EAAE,EAAE,OAAO,EAAE;KAClB,CAAA;AACH,CAAC,CAAA"}