@actuate-media/cms-core 0.41.0 → 0.43.0

package/dist/api/handlers.js

@@ -8128,6 +8128,15 @@ export function registerCMSRoutes(router) {
             if (site === undefined && collections === undefined) {
                 return errorResponse('Body must include at least one of `site` or `collections`', 400);
             }
+            // Validate the title template server-side so an unsupported token can't be
+            // persisted and then silently break public title rendering.
+            if (site && typeof site.titleTemplate === 'string') {
+                const { validateTitleTemplate } = await import('../seo/title-templates.js');
+                const result = validateTitleTemplate(site.titleTemplate);
+                if (!result.valid) {
+                    return errorResponse(result.errors.join(' '), 400);
+                }
+            }
             const { putSeoOverrides, getSeoOverrides } = await import('../seo/config-store.js');
             // Merge with whatever's currently stored so the UI can PATCH a single
             // section without wiping the other — `PUT /seo/config { site: {...} }`
@@ -8143,16 +8152,39 @@ export function registerCMSRoutes(router) {
                 module: current.module,
             };
             const saved = await putSeoOverrides(db(), next, auth.session.userId);
-            // Audit so changes to public SEO surface are traceable.
+            // Audit so changes to public SEO surface are traceable. We log a
+            // field-level diff (previous → new) for the site defaults, but redact
+            // verification token VALUES — only record which providers changed, never
+            // the token itself, since those land in public <meta> tags and shouldn't
+            // be duplicated into the audit trail.
             try {
-                await db().auditLog?.create?.({
-                    data: {
-                        action: 'update_seo_config',
-                        actorId: auth.session.userId,
-                        metadata: {
-                            siteKeys: Object.keys(site ?? {}),
-                            collectionKeys: Object.keys(collections ?? {}),
-                        },
+                const { resolveSeoEnvironment } = await import('../seo/robots.js');
+                const prevSite = (current.site ?? {});
+                const nextSite = (site ?? prevSite);
+                const changedFields = [];
+                for (const key of new Set([...Object.keys(prevSite), ...Object.keys(nextSite)])) {
+                    if (key === 'verification')
+                        continue;
+                    if (JSON.stringify(prevSite[key]) !== JSON.stringify(nextSite[key])) {
+                        changedFields.push({
+                            field: key,
+                            from: prevSite[key] ?? null,
+                            to: nextSite[key] ?? null,
+                        });
+                    }
+                }
+                const prevVer = (prevSite.verification ?? {});
+                const nextVer = (nextSite.verification ?? {});
+                const verificationChanged = Object.keys({ ...prevVer, ...nextVer }).filter((k) => JSON.stringify(prevVer[k]) !== JSON.stringify(nextVer[k]));
+                await logEvent({
+                    event: 'update_seo_config',
+                    userId: auth.session.userId,
+                    details: {
+                        changedFields,
+                        verificationChanged,
+                        collectionKeys: Object.keys(collections ?? {}),
+                        environment: resolveSeoEnvironment(),
+                        source: 'settings.seo',
                     },
                 });
             }
@@ -8316,6 +8348,9 @@ export function registerCMSRoutes(router) {
                     includePostsInSitemap: s.includePostsInSitemap,
                     noindexPaginatedArchives: s.noindexPaginatedArchives,
                     noindexTagPages: s.noindexTagPages,
+                    sitemapEnabled: s.sitemapEnabled,
+                    autoRegenerateSitemapOnPublish: s.autoRegenerateSitemapOnPublish,
+                    pingSearchEnginesOnPublish: s.pingSearchEnginesOnPublish,
                 },
             });
         }
@@ -8341,6 +8376,9 @@ export function registerCMSRoutes(router) {
                 'includePostsInSitemap',
                 'noindexPaginatedArchives',
                 'noindexTagPages',
+                'sitemapEnabled',
+                'autoRegenerateSitemapOnPublish',
+                'pingSearchEnginesOnPublish',
             ];
             const patch = {};
             for (const key of allowed) {
@@ -8350,12 +8388,26 @@ export function registerCMSRoutes(router) {
             if (Object.keys(patch).length === 0) {
                 return errorResponse('No valid crawl settings provided', 400);
             }
+            // Snapshot current values so the audit trail records prev → new.
+            const { getSeoOverrides, resolveSeoModuleSettings } = await import('../seo/config-store.js');
+            const { resolveSeoEnvironment } = await import('../seo/robots.js');
+            const before = resolveSeoModuleSettings(await getSeoOverrides(db()));
             await patchSeoModule(patch, auth.session.userId);
             try {
+                const changedFields = Object.keys(patch).map((key) => ({
+                    field: key,
+                    from: before[key] ?? null,
+                    to: patch[key],
+                }));
                 await logEvent({
                     event: 'update_seo_config',
                     userId: auth.session.userId,
-                    details: { section: 'crawl-settings', keys: Object.keys(patch) },
+                    details: {
+                        section: 'crawl-settings',
+                        changedFields,
+                        environment: resolveSeoEnvironment(),
+                        source: 'settings.seo',
+                    },
                 });
             }
             catch {
@@ -10021,6 +10073,483 @@ export function registerCMSRoutes(router) {
             return internalError(err, 'ai status');
         }
     });
+    // ---------------------------------------------------------------------------
+    // Settings > AI — provider connections, dynamic model catalog, feature flags.
+    // Backed by the `__ai_config__` config document (see `../ai/config-store.ts`).
+    // ADMIN-gated. Provider API keys are encrypted at rest and NEVER returned.
+    // ---------------------------------------------------------------------------
+    const AI_PROVIDER_KEYS = ['openai', 'anthropic', 'xai', 'custom'];
+    function isAiProviderKey(value) {
+        return typeof value === 'string' && AI_PROVIDER_KEYS.includes(value);
+    }
+    function defaultProviderName(provider) {
+        switch (provider) {
+            case 'openai':
+                return 'OpenAI';
+            case 'anthropic':
+                return 'Anthropic';
+            case 'xai':
+                return 'xAI (Grok)';
+            default:
+                return 'Custom provider';
+        }
+    }
+    router.get('/ai/settings', async (request) => {
+        try {
+            const auth = await requireAuth(request);
+            if (auth.error)
+                return auth.error;
+            const adminErr = requireAdminScope(auth.session);
+            if (adminErr)
+                return adminErr;
+            const { getAIConfig, toPublicConfig, getModels, resolveModelOrUnavailable } = await import('../ai/index.js');
+            const config = await getAIConfig(db());
+            const pub = toPublicConfig(config);
+            const catalog = await getModels(db());
+            const defaultModel = resolveModelOrUnavailable(config.settings.defaultModelId, catalog);
+            return json({
+                data: {
+                    settings: pub.settings,
+                    providers: pub.providers,
+                    defaultModel,
+                    updatedAt: config.updatedAt ?? null,
+                    updatedBy: config.updatedBy ?? null,
+                },
+            });
+        }
+        catch (err) {
+            return internalError(err, 'ai/settings GET');
+        }
+    });
+    router.put('/ai/settings', async (request) => {
+        try {
+            const auth = await requireAuth(request);
+            if (auth.error)
+                return auth.error;
+            const adminErr = requireAdminScope(auth.session);
+            if (adminErr)
+                return adminErr;
+            const body = (await request.json().catch(() => null));
+            if (!body || typeof body !== 'object') {
+                return errorResponse('Request body must be an object', 400);
+            }
+            const { getAIConfig, putAIConfig, getModels } = await import('../ai/index.js');
+            const config = await getAIConfig(db());
+            const catalog = await getModels(db());
+            // Validate the selected default provider exists.
+            if (body.defaultProviderId &&
+                !config.providers.some((p) => p.id === body.defaultProviderId)) {
+                return errorResponse('Selected provider is not connected', 400);
+            }
+            // Validate the selected default model is in the catalog and available.
+            if (body.defaultModelId) {
+                const model = catalog.find((m) => m.id === body.defaultModelId || m.providerModelId === body.defaultModelId);
+                if (!model)
+                    return errorResponse('Selected model is not in the catalog', 400);
+                if (model.status === 'unavailable') {
+                    return errorResponse('Selected model is currently unavailable', 400);
+                }
+            }
+            // Validate budget.
+            let monthlyTokenLimit = config.settings.budget.monthlyTokenLimit;
+            if (body.budget && 'monthlyTokenLimit' in body.budget) {
+                const v = body.budget.monthlyTokenLimit;
+                if (v === null)
+                    monthlyTokenLimit = undefined;
+                else if (typeof v === 'number' && Number.isFinite(v) && v >= 0)
+                    monthlyTokenLimit = v;
+                else
+                    return errorResponse('monthlyTokenLimit must be a non-negative number or null', 400);
+            }
+            // Apply feature toggles by key (ignore unknown keys).
+            const toggles = new Map((body.features ?? []).map((f) => [f.key, Boolean(f.enabled)]));
+            const nextFeatures = config.settings.features.map((f) => toggles.has(f.key) ? { ...f, enabled: toggles.get(f.key) } : f);
+            const changedFeatures = config.settings.features
+                .filter((f) => toggles.has(f.key) && toggles.get(f.key) !== f.enabled)
+                .map((f) => ({ key: f.key, from: f.enabled, to: toggles.get(f.key) }));
+            const nextSettings = {
+                ...config.settings,
+                defaultProviderId: body.defaultProviderId === null
+                    ? undefined
+                    : (body.defaultProviderId ?? config.settings.defaultProviderId),
+                defaultModelId: body.defaultModelId === null
+                    ? undefined
+                    : (body.defaultModelId ?? config.settings.defaultModelId),
+                features: nextFeatures,
+                budget: { ...config.settings.budget, monthlyTokenLimit },
+            };
+            const saved = await putAIConfig(db(), { ...config, settings: nextSettings }, auth.session.userId);
+            try {
+                await logEvent({
+                    event: 'update_ai_settings',
+                    userId: auth.session.userId,
+                    details: {
+                        defaultProviderId: nextSettings.defaultProviderId ?? null,
+                        defaultModelId: nextSettings.defaultModelId ?? null,
+                        monthlyTokenLimit: monthlyTokenLimit ?? null,
+                        changedFeatures,
+                        source: 'settings.ai',
+                    },
+                });
+            }
+            catch {
+                // Audit must never block the write.
+            }
+            const { toPublicConfig } = await import('../ai/index.js');
+            return json({ data: toPublicConfig(saved) });
+        }
+        catch (err) {
+            return internalError(err, 'ai/settings PUT');
+        }
+    });
+    router.post('/ai/providers', async (request) => {
+        try {
+            const auth = await requireAuth(request);
+            if (auth.error)
+                return auth.error;
+            const adminErr = requireAdminScope(auth.session);
+            if (adminErr)
+                return adminErr;
+            const body = (await request.json().catch(() => null));
+            if (!body || !isAiProviderKey(body.provider)) {
+                return errorResponse('A valid `provider` is required', 400);
+            }
+            const provider = body.provider;
+            if (provider === 'custom') {
+                if (!body.baseUrl || typeof body.baseUrl !== 'string') {
+                    return errorResponse('A `baseUrl` is required for a custom provider', 400);
+                }
+                const { validateWebhookUrl } = await import('../security/webhook.js');
+                const check = validateWebhookUrl(body.baseUrl);
+                if (!check.valid)
+                    return errorResponse(`Invalid baseUrl: ${check.error ?? 'unsafe'}`, 400);
+            }
+            const { getAIConfig, putAIConfig, encryptProviderKey, getEnvApiKey, resolveProviderKey, toPublicProvider, } = await import('../ai/index.js');
+            const { testConnection } = await import('../ai/providers/index.js');
+            const config = await getAIConfig(db());
+            const now = new Date().toISOString();
+            const envManaged = Boolean(getEnvApiKey(provider));
+            let apiKeyEncrypted;
+            let apiKeyLast4;
+            if (!envManaged && typeof body.apiKey === 'string' && body.apiKey.trim()) {
+                const enc = await encryptProviderKey(body.apiKey.trim());
+                apiKeyEncrypted = enc.apiKeyEncrypted;
+                apiKeyLast4 = enc.apiKeyLast4;
+            }
+            const connection = {
+                id: crypto.randomUUID(),
+                provider,
+                displayName: (typeof body.displayName === 'string' && body.displayName.trim()) ||
+                    defaultProviderName(provider),
+                enabled: body.enabled !== false,
+                status: 'unknown',
+                apiKeyEncrypted,
+                apiKeyLast4,
+                baseUrl: provider === 'custom' ? body.baseUrl : undefined,
+                organizationId: body.organizationId?.trim() || undefined,
+                projectId: body.projectId?.trim() || undefined,
+                lastTestedAt: undefined,
+                createdAt: now,
+                updatedAt: now,
+                updatedBy: auth.session.userId,
+            };
+            // Optional test-before-save.
+            if (body.test) {
+                const key = await resolveProviderKey(connection);
+                const result = await testConnection(provider, {
+                    apiKey: key ?? '',
+                    baseUrl: connection.baseUrl,
+                    organizationId: connection.organizationId,
+                    projectId: connection.projectId,
+                });
+                connection.status = result.status;
+                connection.lastTestedAt = result.testedAt;
+            }
+            const saved = await putAIConfig(db(), { ...config, providers: [...config.providers, connection] }, auth.session.userId);
+            try {
+                await logEvent({
+                    event: 'create_ai_provider',
+                    userId: auth.session.userId,
+                    details: {
+                        providerId: connection.id,
+                        provider,
+                        envManaged,
+                        tested: Boolean(body.test),
+                        status: connection.status,
+                        source: 'settings.ai',
+                    },
+                });
+            }
+            catch {
+                /* never block on audit */
+            }
+            const created = saved.providers.find((p) => p.id === connection.id);
+            return json({ data: toPublicProvider(created) }, 201);
+        }
+        catch (err) {
+            return internalError(err, 'ai/providers POST');
+        }
+    });
+    router.put('/ai/providers/:id', async (request, params) => {
+        try {
+            const auth = await requireAuth(request);
+            if (auth.error)
+                return auth.error;
+            const adminErr = requireAdminScope(auth.session);
+            if (adminErr)
+                return adminErr;
+            const body = (await request.json().catch(() => null));
+            if (!body || typeof body !== 'object') {
+                return errorResponse('Request body must be an object', 400);
+            }
+            const { getAIConfig, putAIConfig, encryptProviderKey, getEnvApiKey, toPublicProvider } = await import('../ai/index.js');
+            const config = await getAIConfig(db());
+            const idx = config.providers.findIndex((p) => p.id === params.id);
+            if (idx === -1)
+                return errorResponse('Provider connection not found', 404);
+            const prev = config.providers[idx];
+            if (prev.provider === 'custom' && typeof body.baseUrl === 'string') {
+                const { validateWebhookUrl } = await import('../security/webhook.js');
+                const check = validateWebhookUrl(body.baseUrl);
+                if (!check.valid)
+                    return errorResponse(`Invalid baseUrl: ${check.error ?? 'unsafe'}`, 400);
+            }
+            const envManaged = Boolean(getEnvApiKey(prev.provider));
+            let { apiKeyEncrypted, apiKeyLast4 } = prev;
+            let keyChanged = false;
+            if (!envManaged && body.apiKey !== undefined) {
+                if (body.apiKey === null || body.apiKey === '') {
+                    apiKeyEncrypted = undefined;
+                    apiKeyLast4 = undefined;
+                    keyChanged = true;
+                }
+                else if (typeof body.apiKey === 'string' && body.apiKey.trim()) {
+                    const enc = await encryptProviderKey(body.apiKey.trim());
+                    apiKeyEncrypted = enc.apiKeyEncrypted;
+                    apiKeyLast4 = enc.apiKeyLast4;
+                    keyChanged = true;
+                }
+            }
+            const updated = {
+                ...prev,
+                displayName: typeof body.displayName === 'string' && body.displayName.trim()
+                    ? body.displayName.trim()
+                    : prev.displayName,
+                enabled: typeof body.enabled === 'boolean' ? body.enabled : prev.enabled,
+                baseUrl: prev.provider === 'custom' && typeof body.baseUrl === 'string'
+                    ? body.baseUrl
+                    : prev.baseUrl,
+                organizationId: body.organizationId === null
+                    ? undefined
+                    : (body.organizationId?.trim() ?? prev.organizationId),
+                projectId: body.projectId === null ? undefined : (body.projectId?.trim() ?? prev.projectId),
+                apiKeyEncrypted,
+                apiKeyLast4,
+                // A new key invalidates the previous test result.
+                status: keyChanged ? 'unknown' : prev.status,
+                lastTestedAt: keyChanged ? undefined : prev.lastTestedAt,
+                updatedAt: new Date().toISOString(),
+                updatedBy: auth.session.userId,
+            };
+            const nextProviders = [...config.providers];
+            nextProviders[idx] = updated;
+            const saved = await putAIConfig(db(), { ...config, providers: nextProviders }, auth.session.userId);
+            try {
+                await logEvent({
+                    event: 'update_ai_provider',
+                    userId: auth.session.userId,
+                    details: {
+                        providerId: prev.id,
+                        provider: prev.provider,
+                        keyChanged,
+                        source: 'settings.ai',
+                    },
+                });
+            }
+            catch {
+                /* never block on audit */
+            }
+            const out = saved.providers.find((p) => p.id === prev.id);
+            return json({ data: toPublicProvider(out) });
+        }
+        catch (err) {
+            return internalError(err, 'ai/providers PUT');
+        }
+    });
+    router.delete('/ai/providers/:id', async (request, params) => {
+        try {
+            const auth = await requireAuth(request);
+            if (auth.error)
+                return auth.error;
+            const adminErr = requireAdminScope(auth.session);
+            if (adminErr)
+                return adminErr;
+            const id = params.id;
+            if (!id)
+                return errorResponse('Provider connection not found', 404);
+            const { getAIConfig, putAIConfig } = await import('../ai/index.js');
+            const config = await getAIConfig(db());
+            const exists = config.providers.some((p) => p.id === id);
+            if (!exists)
+                return errorResponse('Provider connection not found', 404);
+            const nextCatalog = { ...(config.catalog ?? {}) };
+            delete nextCatalog[id];
+            // Clear default selectors that pointed at the removed provider.
+            const clearedProvider = config.settings.defaultProviderId === id;
+            const nextSettings = clearedProvider
+                ? { ...config.settings, defaultProviderId: undefined, defaultModelId: undefined }
+                : config.settings;
+            await putAIConfig(db(), {
+                ...config,
+                providers: config.providers.filter((p) => p.id !== id),
+                catalog: nextCatalog,
+                settings: nextSettings,
+            }, auth.session.userId);
+            try {
+                await logEvent({
+                    event: 'delete_ai_provider',
+                    userId: auth.session.userId,
+                    details: { providerId: id, source: 'settings.ai' },
+                });
+            }
+            catch {
+                /* never block on audit */
+            }
+            return json({ data: { id: params.id, deleted: true } });
+        }
+        catch (err) {
+            return internalError(err, 'ai/providers DELETE');
+        }
+    });
+    router.post('/ai/providers/:id/test', async (request, params) => {
+        try {
+            const auth = await requireAuth(request);
+            if (auth.error)
+                return auth.error;
+            const adminErr = requireAdminScope(auth.session);
+            if (adminErr)
+                return adminErr;
+            const { getAIConfig, putAIConfig, resolveProviderKey, toPublicProvider } = await import('../ai/index.js');
+            const { testConnection } = await import('../ai/providers/index.js');
+            const config = await getAIConfig(db());
+            const idx = config.providers.findIndex((p) => p.id === params.id);
+            if (idx === -1)
+                return errorResponse('Provider connection not found', 404);
+            const conn = config.providers[idx];
+            const key = await resolveProviderKey(conn);
+            const result = await testConnection(conn.provider, {
+                apiKey: key ?? '',
+                baseUrl: conn.baseUrl,
+                organizationId: conn.organizationId,
+                projectId: conn.projectId,
+            });
+            const updated = { ...conn, status: result.status, lastTestedAt: result.testedAt };
+            const nextProviders = [...config.providers];
+            nextProviders[idx] = updated;
+            const saved = await putAIConfig(db(), { ...config, providers: nextProviders }, auth.session.userId);
+            try {
+                await logEvent({
+                    event: 'test_ai_provider',
+                    userId: auth.session.userId,
+                    details: {
+                        providerId: conn.id,
+                        provider: conn.provider,
+                        status: result.status,
+                        source: 'settings.ai',
+                    },
+                });
+            }
+            catch {
+                /* never block on audit */
+            }
+            const out = saved.providers.find((p) => p.id === conn.id);
+            return json({ data: { provider: toPublicProvider(out), result } });
+        }
+        catch (err) {
+            return internalError(err, 'ai/providers test');
+        }
+    });
+    router.post('/ai/providers/:id/sync-models', async (request, params) => {
+        try {
+            const auth = await requireAuth(request);
+            if (auth.error)
+                return auth.error;
+            const adminErr = requireAdminScope(auth.session);
+            if (adminErr)
+                return adminErr;
+            const id = params.id;
+            if (!id)
+                return errorResponse('Provider connection not found', 404);
+            const { syncModels } = await import('../ai/index.js');
+            const result = await syncModels(db(), id).catch((err) => {
+                if (err instanceof Error && /not found/i.test(err.message))
+                    return null;
+                throw err;
+            });
+            if (!result)
+                return errorResponse('Provider connection not found', 404);
+            try {
+                await logEvent({
+                    event: 'sync_ai_models',
+                    userId: auth.session.userId,
+                    details: {
+                        providerId: id,
+                        modelCount: result.models.length,
+                        fromFallback: result.fromFallback,
+                        source: 'settings.ai',
+                    },
+                });
+            }
+            catch {
+                /* never block on audit */
+            }
+            return json({
+                data: {
+                    models: result.models,
+                    fromFallback: result.fromFallback,
+                    warning: result.warning ?? null,
+                },
+            });
+        }
+        catch (err) {
+            return internalError(err, 'ai/providers sync-models');
+        }
+    });
+    router.get('/ai/models', async (request) => {
+        try {
+            const auth = await requireAuth(request);
+            if (auth.error)
+                return auth.error;
+            const adminErr = requireAdminScope(auth.session);
+            if (adminErr)
+                return adminErr;
+            const url = new URL(request.url);
+            const connectionId = url.searchParams.get('connectionId') ?? undefined;
+            const provider = url.searchParams.get('provider') ?? undefined;
+            const { getModels } = await import('../ai/index.js');
+            const models = await getModels(db(), { connectionId, provider });
+            return json({ data: { models } });
+        }
+        catch (err) {
+            return internalError(err, 'ai/models GET');
+        }
+    });
+    router.get('/ai/usage/summary', async (request) => {
+        try {
+            const auth = await requireAuth(request);
+            if (auth.error)
+                return auth.error;
+            const adminErr = requireAdminScope(auth.session);
+            if (adminErr)
+                return adminErr;
+            const { getUsageSummary } = await import('../ai/index.js');
+            const summary = await getUsageSummary(db());
+            return json({ data: summary });
+        }
+        catch (err) {
+            return internalError(err, 'ai/usage/summary GET');
+        }
+    });
     router.put('/security', async (request) => {
         try {
             const auth = await requireAuth(request);