@prenta/core 8.9.2 → 8.10.0

package/dist/chrome/routes.js

@@ -0,0 +1,306 @@
+import { guardedDb } from '../api/guarded-db.js';
+import { ADMIN_ROLES, errorResponse, internalError, json, jsonWithCache, requireAuth, requireGlobalScope, requireRole, requireStaffAccess, } from '../api/route-helpers.js';
+import { cachedRead } from '../cache/http.js';
+import { getPrentaConfig } from '../config/runtime.js';
+import { loadUserRefs } from '../jobs/serialize.js';
+import { logEvent } from '../security/audit.js';
+import { parseSchemaRead } from './parse.js';
+import { PrismaChromeStore } from './prisma-store.js';
+import { chromeReadTags, loadPublicChrome, normalizeChromePath } from './public.js';
+import { revalidateChrome } from './revalidate.js';
+import { CHROME_REGIONS } from './schema.js';
+import { announcementEtag, getAnnouncement, getChromeSchema, getRegion, readChromeSchema, readIfMatch, regionEtag, removeOrphan, saveAnnouncement, saveRegion, } from './service.js';
+import { getChromeSettings, saveChromeSettings } from './settings.js';
+/** The API key global scope that covers `/chrome/*`. */
+const CHROME_SCOPE = 'chrome';
+/** Who can save chrome: a save is live at once, so the roles that can publish. */
+const EDIT_ROLES = new Set(['OWNER', 'ADMIN', 'EDITOR']);
+function isFailure(value) {
+    return typeof value === 'object' && value !== null && value.ok === false;
+}
+function failure(result) {
+    return errorResponse(result.error, result.status);
+}
+function withHeader(response, name, value) {
+    response.headers.set(name, value);
+    return response;
+}
+function regionParam(value) {
+    return CHROME_REGIONS.includes(value ?? '')
+        ? value
+        : null;
+}
+function decodeParam(value) {
+    try {
+        return decodeURIComponent(value ?? '');
+    }
+    catch {
+        return value ?? '';
+    }
+}
+async function readSession(request) {
+    const auth = await requireAuth(request);
+    if (auth.error)
+        return auth.error;
+    return requireGlobalScope(auth.session, CHROME_SCOPE) ?? auth.session;
+}
+async function writeSession(request, roles) {
+    const session = await readSession(request);
+    if (session instanceof Response)
+        return session;
+    // An API key's actions must allow the method, as on every other staff write.
+    return requireStaffAccess(session, request) ?? requireRole(session.role, roles) ?? session;
+}
+function serializeRegion(region, view, refs) {
+    const { row } = view;
+    return {
+        region,
+        variant: view.variant,
+        fields: row.values,
+        orphans: view.orphans,
+        updatedBy: row.updatedById ? (refs.get(row.updatedById) ?? null) : null,
+        updatedAt: row.updatedAt ? row.updatedAt.toISOString() : null,
+    };
+}
+function weakMatch(header, etag) {
+    if (!header)
+        return false;
+    return header.split(',').some((tag) => {
+        const value = tag.trim();
+        return value === '*' || value === etag || value.replace(/^W\//, '') === etag.replace(/^W\//, '');
+    });
+}
+export function registerChromeRoutes(router) {
+    const db = guardedDb;
+    const store = () => new PrismaChromeStore(db());
+    async function regionResponse(region, view, now) {
+        const refs = await loadUserRefs(db(), view.row.updatedById ? [view.row.updatedById] : []);
+        return withHeader(json({ data: serializeRegion(region, view, refs) }), 'ETag', regionEtag(view.row, now));
+    }
+    router.get('/chrome/schema', async (request) => {
+        try {
+            const session = await readSession(request);
+            if (session instanceof Response)
+                return session;
+            return json({ data: await getChromeSchema(store()) });
+        }
+        catch (err) {
+            return internalError(err, 'chrome schema');
+        }
+    });
+    router.put('/chrome/schema', async (request) => {
+        try {
+            const session = await writeSession(request, ADMIN_ROLES);
+            if (session instanceof Response)
+                return session;
+            const body = await request.json().catch(() => null);
+            const input = parseSchemaRead(body);
+            if (!input.ok)
+                return errorResponse(input.error, 400);
+            const result = await readChromeSchema(store(), input.value, {
+                userId: session.userId,
+                now: new Date(),
+            });
+            if (isFailure(result)) {
+                // A region before the one that failed may already be written, and pushing
+                // again won't see it as changed. Revalidating an unchanged region is harmless.
+                for (const region of CHROME_REGIONS)
+                    await revalidateChrome(region);
+                return failure(result);
+            }
+            for (const region of result.regions) {
+                if (region.changed)
+                    await revalidateChrome(region.region);
+            }
+            await logEvent({
+                event: 'settings_changed',
+                userId: session.userId,
+                details: {
+                    action: 'chrome_schema_read',
+                    commit: result.source.commit,
+                    regions: result.regions.filter((region) => region.changed).map((region) => region.region),
+                },
+            });
+            return json({ data: result });
+        }
+        catch (err) {
+            return internalError(err, 'chrome schema read');
+        }
+    });
+    router.get('/chrome/settings', async (request) => {
+        try {
+            const session = await readSession(request);
+            if (session instanceof Response)
+                return session;
+            return json({
+                data: await getChromeSettings(db(), { admin: ADMIN_ROLES.has(session.role) }),
+            });
+        }
+        catch (err) {
+            return internalError(err, 'chrome settings');
+        }
+    });
+    router.put('/chrome/settings', async (request) => {
+        try {
+            const session = await writeSession(request, ADMIN_ROLES);
+            if (session instanceof Response)
+                return session;
+            const body = await request.json().catch(() => null);
+            const result = await saveChromeSettings(db(), body);
+            if (isFailure(result))
+                return failure(result);
+            await logEvent({
+                event: 'settings_changed',
+                userId: session.userId,
+                details: {
+                    action: 'chrome_settings_changed',
+                    revalidateUrl: result.settings.revalidateUrl,
+                },
+            });
+            return json({
+                data: { ...result.settings, ...(result.secret ? { secret: result.secret } : {}) },
+            });
+        }
+        catch (err) {
+            return internalError(err, 'chrome settings save');
+        }
+    });
+    router.get('/chrome/announcement', async (request) => {
+        try {
+            const session = await readSession(request);
+            if (session instanceof Response)
+                return session;
+            const { announcement } = await getAnnouncement(store());
+            return withHeader(json({ data: announcement }), 'ETag', announcementEtag(announcement));
+        }
+        catch (err) {
+            return internalError(err, 'chrome announcement');
+        }
+    });
+    router.put('/chrome/announcement', async (request) => {
+        try {
+            const session = await writeSession(request, EDIT_ROLES);
+            if (session instanceof Response)
+                return session;
+            const body = await request.json().catch(() => null);
+            const result = await saveAnnouncement(store(), body, {
+                userId: session.userId,
+                ifMatch: readIfMatch(request),
+                now: new Date(),
+            });
+            if (isFailure(result))
+                return failure(result);
+            await revalidateChrome('announcement');
+            return withHeader(json({ data: result.announcement }), 'ETag', announcementEtag(result.announcement));
+        }
+        catch (err) {
+            return internalError(err, 'chrome announcement save');
+        }
+    });
+    router.get('/chrome/:region', async (request, params) => {
+        try {
+            const session = await readSession(request);
+            if (session instanceof Response)
+                return session;
+            const region = regionParam(params.region);
+            if (!region)
+                return errorResponse('Unknown chrome region', 404);
+            const now = new Date();
+            const view = await getRegion(store(), region, now);
+            if (isFailure(view))
+                return failure(view);
+            return regionResponse(region, view, now);
+        }
+        catch (err) {
+            return internalError(err, 'chrome region');
+        }
+    });
+    router.put('/chrome/:region', async (request, params) => {
+        try {
+            const session = await writeSession(request, EDIT_ROLES);
+            if (session instanceof Response)
+                return session;
+            const region = regionParam(params.region);
+            if (!region)
+                return errorResponse('Unknown chrome region', 404);
+            const body = await request.json().catch(() => null);
+            const now = new Date();
+            const view = await saveRegion(store(), region, body, {
+                userId: session.userId,
+                ifMatch: readIfMatch(request),
+                now,
+            });
+            if (isFailure(view))
+                return failure(view);
+            await revalidateChrome(region);
+            return regionResponse(region, view, now);
+        }
+        catch (err) {
+            return internalError(err, 'chrome region save');
+        }
+    });
+    router.delete('/chrome/:region/orphans/:key', async (request, params) => {
+        try {
+            const session = await writeSession(request, EDIT_ROLES);
+            if (session instanceof Response)
+                return session;
+            const region = regionParam(params.region);
+            if (!region)
+                return errorResponse('Unknown chrome region', 404);
+            const now = new Date();
+            const view = await removeOrphan(store(), region, decodeParam(params.key), {
+                userId: session.userId,
+                now,
+            });
+            if (isFailure(view))
+                return failure(view);
+            // Orphans never reach the site, so there is nothing to revalidate.
+            return regionResponse(region, view, now);
+        }
+        catch (err) {
+            return internalError(err, 'chrome orphan remove');
+        }
+    });
+    // Public, for the site: site defaults, page overrides and the announcement
+    // schedule, resolved for one path. Cached like the other public reads, with
+    // an ETag so an unchanged chrome answers 304.
+    router.get('/public/chrome', async (request) => {
+        try {
+            const path = normalizeChromePath(new URL(request.url).searchParams.get('path'));
+            if (!path) {
+                return errorResponse('Send the page path, like ?path=/about', 400);
+            }
+            const config = getPrentaConfig();
+            return cachedRead(request, {
+                cache: config?.cache,
+                tags: chromeReadTags(config ?? null, path),
+                wrap: (payload, req) => {
+                    const body = payload;
+                    const etag = body.data.etag;
+                    if (weakMatch(req.headers.get('if-none-match'), etag)) {
+                        const notModified = new Response(null, { status: 304 });
+                        const cacheControl = jsonWithCache(null, req).headers.get('Cache-Control');
+                        if (cacheControl)
+                            notModified.headers.set('Cache-Control', cacheControl);
+                        notModified.headers.set('ETag', etag);
+                        return notModified;
+                    }
+                    return withHeader(jsonWithCache(body, req), 'ETag', etag);
+                },
+                build: async () => ({
+                    data: await loadPublicChrome({
+                        db: db(),
+                        store: store(),
+                        config: config ?? null,
+                        path,
+                        now: new Date(),
+                    }),
+                }),
+            });
+        }
+        catch (err) {
+            return internalError(err, 'public chrome');
+        }
+    });
+}
+//# sourceMappingURL=routes.js.map

package/dist/chrome/routes.js.map

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

package/dist/chrome/schema.d.ts

@@ -0,0 +1,231 @@
+/**
+ * Code-first site chrome (DATA_CONTRACTS §2). A site declares what editors may
+ * change in its header and footer with `defineRegion` and the `field.*`
+ * builders, imported from `@prenta/core/config`:
+ *
+ *   export const header = defineRegion('header', {
+ *     component: './src/components/site/Header.astro',
+ *     variants: { default: 'Logo left, menu right', minimal: 'Logo + CTA' },
+ *     fields: { menu: field.menu({ default: 'main' }), cta: field.link({ optional: true }) },
+ *   })
+ *
+ * Markup stays in the site's components. `prenta push chrome` sends the
+ * serialized schema to the CMS on deploy, and the saved values are typed per
+ * region: `RegionFieldValues<typeof header>` for what the CMS stores,
+ * `ChromeFieldsOf<typeof header>` for what `getChrome` returns.
+ *
+ * This module has no runtime dependencies, so a site can import it anywhere.
+ */
+import type { ResolvedLogo } from '../appearance/types.js';
+import type { PublicNavItem } from '../site.js';
+/** The regions a site can define. The announcement bar is CMS-owned. */
+export declare const CHROME_REGIONS: readonly ["header", "footer"];
+export type ChromeRegionName = (typeof CHROME_REGIONS)[number];
+/** Options every field takes. */
+export interface FieldCommon {
+    label?: string;
+    help?: string;
+    /** The key this field had before. Its saved value moves over on the next schema read. */
+    renamedFrom?: string;
+}
+/** Read-only. The value comes from Settings > Brand. */
+export interface BrandFieldDef extends FieldCommon {
+    type: 'brand';
+    key: 'logo' | 'name';
+}
+/** A menu, by its slug. `list` picks up to `max` menus (footer columns). */
+export interface MenuFieldDef extends FieldCommon {
+    type: 'menu';
+    optional?: boolean;
+    list?: boolean;
+    max?: number;
+    default?: string;
+}
+export interface LinkFieldDef extends FieldCommon {
+    type: 'link';
+    optional?: boolean;
+}
+export interface TextFieldDef extends FieldCommon {
+    type: 'text';
+    optional?: boolean;
+    format?: 'tel' | 'email';
+    /** Placeholders the CMS fills in, such as `{year}`. */
+    tokens?: readonly string[];
+    max?: number;
+}
+export interface TextareaFieldDef extends FieldCommon {
+    type: 'textarea';
+    max?: number;
+}
+export interface SelectFieldDef<O extends string = string> extends FieldCommon {
+    type: 'select';
+    options: readonly O[];
+    default?: O;
+}
+export interface BooleanFieldDef extends FieldCommon {
+    type: 'boolean';
+    default?: boolean;
+}
+/** A list of `{ platform, url }` links. */
+export interface SocialFieldDef extends FieldCommon {
+    type: 'social';
+}
+export type FieldDef = BrandFieldDef | MenuFieldDef | LinkFieldDef | TextFieldDef | TextareaFieldDef | SelectFieldDef | BooleanFieldDef | SocialFieldDef;
+export type FieldType = FieldDef['type'];
+export interface RegionDefinition<N extends ChromeRegionName = ChromeRegionName, V extends string = string, F extends Record<string, FieldDef> = Record<string, FieldDef>> {
+    region: N;
+    /** Path of the component that renders the region, shown in the CMS. */
+    component: string;
+    /** Variant id → label. The first one is the site default until an editor picks another. */
+    variants: Record<V, string>;
+    fields: F;
+}
+type Options<T extends FieldDef> = Omit<T, 'type'>;
+/** A builder called without options. */
+type NoOptions = Record<never, never>;
+/**
+ * Field builders. Each keeps its options as literal types, so
+ * `field.link({ optional: true })` stores `{ on, label, url }` and
+ * `field.select(['dark', 'light'])` stores `'dark' | 'light'`.
+ */
+export declare const field: {
+    brand<const K extends BrandFieldDef["key"]>(key: K, options?: FieldCommon): {
+        type: "brand";
+        key: K;
+    };
+    menu<const O extends Options<MenuFieldDef> = NoOptions>(options?: O): {
+        type: "menu";
+    } & O;
+    link<const O extends Options<LinkFieldDef> = NoOptions>(options?: O): {
+        type: "link";
+    } & O;
+    text<const O extends Options<TextFieldDef> = NoOptions>(options?: O): {
+        type: "text";
+    } & O;
+    textarea<const O extends Options<TextareaFieldDef> = NoOptions>(options?: O): {
+        type: "textarea";
+    } & O;
+    select<const T extends string, const O extends Omit<Options<SelectFieldDef<T>>, "options" | "default"> & {
+        default?: NoInfer<T>;
+    } = NoOptions>(options: readonly T[], extra?: O): {
+        type: "select";
+        options: T[];
+    } & O;
+    boolean<const O extends Options<BooleanFieldDef> = NoOptions>(options?: O): {
+        type: "boolean";
+    } & O;
+    social<const O extends Options<SocialFieldDef> = NoOptions>(options?: O): {
+        type: "social";
+    } & O;
+};
+/**
+ * Declare an editable region. The returned object is plain data plus a hidden
+ * marker, so `prenta push chrome` can find every region a config exports.
+ */
+export declare function defineRegion<const N extends ChromeRegionName, const V extends string, const F extends Record<string, FieldDef>>(name: N, definition: {
+    component: string;
+    variants: Record<V, string>;
+    fields: F;
+}): RegionDefinition<N, V, F>;
+/** Whether a value came from `defineRegion`. */
+export declare function isRegionDefinition(value: unknown): value is RegionDefinition;
+/** The plain JSON `prenta push chrome` sends for one region (`PUT /chrome/schema`). */
+export declare function serializeRegion(definition: RegionDefinition): {
+    region: ChromeRegionName;
+    component: string;
+    variants: Record<string, string>;
+    fields: Record<string, FieldDef>;
+};
+export interface ChromeLinkValue {
+    label: string;
+    url: string;
+}
+export interface ChromeSocialLink {
+    platform: string;
+    url: string;
+}
+/** How an optional field is stored: a switch next to its value. */
+export type Toggle<T> = {
+    on: boolean;
+} & T;
+/** What the CMS stores for one field. Brand fields store nothing. */
+export type StoredFieldValue<F extends FieldDef> = F extends {
+    type: 'menu';
+    list: true;
+} ? string[] : F extends {
+    type: 'menu';
+    optional: true;
+} ? Toggle<{
+    value: string;
+}> : F extends {
+    type: 'menu';
+} ? string : F extends {
+    type: 'link';
+    optional: true;
+} ? Toggle<ChromeLinkValue> : F extends {
+    type: 'link';
+} ? ChromeLinkValue : F extends {
+    type: 'text';
+    optional: true;
+} ? Toggle<{
+    value: string;
+}> : F extends {
+    type: 'text' | 'textarea';
+} ? string : F extends {
+    type: 'select';
+    options: readonly (infer O extends string)[];
+} ? O : F extends {
+    type: 'boolean';
+} ? boolean : F extends {
+    type: 'social';
+} ? ChromeSocialLink[] : never;
+type FieldsOf<R extends RegionDefinition> = R['fields'];
+/** `RegionValues.fields` for one region: every editable field, each optional. */
+export type RegionFieldValues<R extends RegionDefinition> = {
+    [K in keyof FieldsOf<R> as FieldsOf<R>[K] extends {
+        type: 'brand';
+    } ? never : K]?: StoredFieldValue<FieldsOf<R>[K]>;
+};
+/** A menu as the site receives it. `id` is the menu's slug. */
+export interface ChromeMenu {
+    id: string;
+    name: string;
+    items: PublicNavItem[];
+}
+/** What `getChrome` returns for one field. */
+export type PublicFieldValue<F extends FieldDef> = F extends {
+    type: 'brand';
+    key: 'logo';
+} ? ResolvedLogo | null : F extends {
+    type: 'brand';
+} ? string : F extends {
+    type: 'menu';
+    list: true;
+} ? ChromeMenu[] : F extends {
+    type: 'menu';
+} ? ChromeMenu | null : F extends {
+    type: 'link';
+} ? ChromeLinkValue | null : F extends {
+    type: 'text';
+    optional: true;
+} ? string | null : F extends {
+    type: 'text' | 'textarea';
+} ? string : F extends {
+    type: 'select';
+    options: readonly (infer O extends string)[];
+} ? O : F extends {
+    type: 'boolean';
+} ? boolean : F extends {
+    type: 'social';
+} ? ChromeSocialLink[] : never;
+/** The `fields` a site receives for one region. */
+export type ChromeFieldsOf<R extends RegionDefinition> = {
+    [K in keyof FieldsOf<R>]: PublicFieldValue<FieldsOf<R>[K]>;
+};
+/** A region as `getChrome` returns it. */
+export interface ResolvedRegion<R extends RegionDefinition = RegionDefinition> {
+    variant: Extract<keyof R['variants'], string>;
+    fields: ChromeFieldsOf<R>;
+}
+export {};
+//# sourceMappingURL=schema.d.ts.map

package/dist/chrome/schema.d.ts.map

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

package/dist/chrome/schema.js

@@ -0,0 +1,73 @@
+/** The regions a site can define. The announcement bar is CMS-owned. */
+export const CHROME_REGIONS = ['header', 'footer'];
+/** Copy only the options that were set, so the serialized schema stays small and stable. */
+function defined(type, options) {
+    const out = { type };
+    for (const [key, value] of Object.entries(options ?? {})) {
+        if (value !== undefined)
+            out[key] = Array.isArray(value) ? [...value] : value;
+    }
+    return out;
+}
+/**
+ * Field builders. Each keeps its options as literal types, so
+ * `field.link({ optional: true })` stores `{ on, label, url }` and
+ * `field.select(['dark', 'light'])` stores `'dark' | 'light'`.
+ */
+export const field = {
+    brand(key, options) {
+        return { ...defined('brand', options), key };
+    },
+    menu(options) {
+        return defined('menu', options);
+    },
+    link(options) {
+        return defined('link', options);
+    },
+    text(options) {
+        return defined('text', options);
+    },
+    textarea(options) {
+        return defined('textarea', options);
+    },
+    select(options, extra) {
+        return { ...defined('select', extra), options: [...options] };
+    },
+    boolean(options) {
+        return defined('boolean', options);
+    },
+    social(options) {
+        return defined('social', options);
+    },
+};
+const REGION_BRAND = Symbol.for('prenta.chrome.region');
+/**
+ * Declare an editable region. The returned object is plain data plus a hidden
+ * marker, so `prenta push chrome` can find every region a config exports.
+ */
+export function defineRegion(name, definition) {
+    const region = {
+        region: name,
+        component: definition.component,
+        variants: { ...definition.variants },
+        fields: { ...definition.fields },
+    };
+    Object.defineProperty(region, REGION_BRAND, { value: true });
+    return region;
+}
+/** Whether a value came from `defineRegion`. */
+export function isRegionDefinition(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        value[REGION_BRAND] === true);
+}
+/** The plain JSON `prenta push chrome` sends for one region (`PUT /chrome/schema`). */
+export function serializeRegion(definition) {
+    return JSON.parse(JSON.stringify({
+        region: definition.region,
+        component: definition.component,
+        variants: definition.variants,
+        fields: definition.fields,
+    }));
+}
+//# sourceMappingURL=schema.js.map

package/dist/chrome/schema.js.map

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