@geekity/cms 0.24.0 → 0.26.0

package/dist/plugins/registry.js

@@ -0,0 +1,447 @@
+/**
+ * The plugin registry (decision-33): every installed plugin, registered once
+ * at boot, and what the dependency graph says about each.
+ *
+ * Installed and enabled are separate. Installed is fixed for the life of the
+ * process: the plugins handed to `createCms`. Enabled is the `plugins` key of
+ * `site.json`, read per request, so every question that depends on it takes
+ * the enabled set as an argument rather than holding one.
+ */
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import semver from 'semver';
+import { readFileIfPresentSync, updateFileAtomically } from '../files/atomic.js';
+import { HOST_API_VERSION } from '../plugin.js';
+import { pluginFetch } from './fetch.js';
+import { pluginEnvPrefix, pluginFolderPath, resolvePluginSettings, settingFieldsProblem, settingValues, } from './settings.js';
+/** Two installed plugins with one name. */
+export class DuplicatePluginError extends Error {
+    constructor(name, first, second) {
+        super(`Two plugins are named ${name}: one from ${first} and one from ${second}.`);
+        this.name = 'DuplicatePluginError';
+    }
+}
+const CORE_PACKAGE = '@geekity/cms';
+const CORE_VERSION = createRequire(import.meta.url)('../../package.json')
+    .version;
+/** npm's rule for a package name, scoped or not. */
+export const PACKAGE_NAME = /^(?:@[a-z0-9-~][a-z0-9-._~]*\/)?[a-z0-9-~][a-z0-9-._~]*$/;
+const PACKAGE_NAME_MAX = 214;
+/**
+ * Register every installed plugin and resolve the dependency graph. Throws
+ * {@link DuplicatePluginError} when two plugins share a name; every other
+ * problem leaves that plugin unavailable and the site booting.
+ */
+export function createPluginRegistry(installed, options) {
+    const bySource = new Map();
+    for (const entry of installed) {
+        const earlier = bySource.get(entry.plugin.name);
+        if (earlier !== undefined) {
+            throw new DuplicatePluginError(entry.plugin.name, earlier.source, entry.source);
+        }
+        bySource.set(entry.plugin.name, entry);
+    }
+    const own = new Map();
+    const contributions = new Map();
+    const services = new Map();
+    let registered = false;
+    const serviceFor = (consumer, dependency) => {
+        if (!Object.hasOwn(consumer.requires ?? {}, dependency)) {
+            throw new Error(`${consumer.name} uses ${dependency}, which is not in its requires.`);
+        }
+        if (!registered) {
+            throw new Error(`${consumer.name} called use(${JSON.stringify(dependency)}) in its register. Call it when handling a request, a command or a job, once every plugin has registered.`);
+        }
+        if (!services.has(dependency))
+            throw new Error(`${dependency} provides no service.`);
+        return services.get(dependency);
+    };
+    for (const entry of installed) {
+        const { problem, declared, service } = entry.problem === undefined
+            ? register(entry.plugin, options, serviceFor)
+            : { problem: entry.problem, declared: NOTHING_DECLARED, service: undefined };
+        own.set(entry.plugin.name, problem);
+        contributions.set(entry.plugin.name, declared);
+        if (service !== undefined)
+            services.set(entry.plugin.name, service.value);
+    }
+    registered = true;
+    const cyclic = cyclicNames(installed.map((entry) => entry.plugin));
+    const sharedPrefixes = prefixCollisions(installed.map((entry) => entry.plugin.name));
+    const problems = new Map();
+    function problem(name) {
+        if (problems.has(name))
+            return problems.get(name);
+        const found = resolveProblem(name);
+        problems.set(name, found);
+        return found;
+    }
+    function resolveProblem(name) {
+        const entry = bySource.get(name);
+        if (entry === undefined)
+            return 'It is not installed.';
+        const shared = sharedPrefixes.get(name);
+        if (shared !== undefined) {
+            return `Its environment variables would start ${pluginEnvPrefix(name)}__, as those of ${shared.join(' and ')} would, so none of them loads. Rename one package.`;
+        }
+        const intrinsic = own.get(name);
+        if (intrinsic !== undefined)
+            return intrinsic;
+        const cycle = cyclic.get(name);
+        if (cycle !== undefined)
+            return `It is in a dependency cycle: ${cycle.join(' → ')}.`;
+        for (const [dependency, range] of Object.entries(entry.peerDependencies ?? {})) {
+            const version = dependency === CORE_PACKAGE ? CORE_VERSION : bySource.get(dependency)?.plugin.version;
+            if (version === undefined || semver.satisfies(version, range))
+                continue;
+            return dependency === CORE_PACKAGE
+                ? `It needs ${CORE_PACKAGE} ${range}, and this core is ${version}.`
+                : `It needs ${dependency} ${range}, and ${version} is installed.`;
+        }
+        for (const [dependency, range] of requirementsOf(entry.plugin)) {
+            if (!bySource.has(dependency)) {
+                return `It requires ${dependency} ${range}, which is not installed.`;
+            }
+            if (problem(dependency) !== undefined) {
+                return `It requires ${dependency} ${range}, which is unavailable.`;
+            }
+        }
+        return undefined;
+    }
+    const plugins = installed.map((entry) => {
+        const declared = contributions.get(entry.plugin.name) ?? NOTHING_DECLARED;
+        return {
+            ...entry,
+            ...declared,
+            problem: problem(entry.plugin.name),
+            settingsPlace: { ...options, name: entry.plugin.name, fields: declared.settings },
+        };
+    });
+    const order = dependencyOrder(plugins.filter((entry) => entry.problem === undefined));
+    function active(enabled) {
+        const running = new Set();
+        for (const entry of order) {
+            const { name } = entry.plugin;
+            if (!enabled.has(name))
+                continue;
+            if (requirementsOf(entry.plugin).every(([dependency]) => running.has(dependency))) {
+                running.add(name);
+            }
+        }
+        return running;
+    }
+    const startAttempted = [];
+    let closed = false;
+    let queue = Promise.resolve();
+    function serialized(step) {
+        queue = queue.then(step);
+        return queue;
+    }
+    async function stopFrom(shouldStop) {
+        for (const entry of [...startAttempted].reverse()) {
+            if (!shouldStop(entry.name))
+                continue;
+            startAttempted.splice(startAttempted.indexOf(entry), 1);
+            await lifecycle(entry, 'stop');
+        }
+    }
+    async function attemptStart(plugin) {
+        startAttempted.push(plugin);
+        await lifecycle(plugin, 'start');
+    }
+    return {
+        plugins,
+        find: (name) => plugins.find((entry) => entry.plugin.name === name),
+        problem,
+        active,
+        requirements(name, enabled) {
+            const entry = bySource.get(name);
+            if (entry === undefined)
+                return [];
+            const running = active(enabled);
+            return requirementsOf(entry.plugin).map(([dependency, range]) => ({
+                name: dependency,
+                range,
+                state: requirementState(dependency, enabled, running),
+            }));
+        },
+        enabledDependents(name, enabled) {
+            return plugins
+                .filter((entry) => enabled.has(entry.plugin.name))
+                .filter((entry) => requirementsOf(entry.plugin).some(([dependency]) => dependency === name))
+                .map((entry) => entry.plugin.name);
+        },
+        reconcile(enabled) {
+            return serialized(async () => {
+                if (closed)
+                    return;
+                const running = active(enabled);
+                await stopFrom((name) => !running.has(name));
+                for (const { plugin } of order) {
+                    if (running.has(plugin.name) && !startAttempted.includes(plugin)) {
+                        await attemptStart(plugin);
+                    }
+                }
+            });
+        },
+        close() {
+            return serialized(async () => {
+                closed = true;
+                await stopFrom(() => true);
+            });
+        },
+    };
+    function requirementState(dependency, enabled, running) {
+        if (!bySource.has(dependency))
+            return 'missing';
+        if (problem(dependency) !== undefined)
+            return 'unavailable';
+        if (running.has(dependency))
+            return 'enabled';
+        return enabled.has(dependency) ? 'blocked' : 'disabled';
+    }
+}
+const NOTHING_DECLARED = {
+    routes: [],
+    federation: [],
+    screen: undefined,
+    commands: [],
+    settings: [],
+    editorActions: [],
+};
+/**
+ * Run a plugin's `register`, returning why it cannot run, if it cannot, what
+ * it declared and the service it provided. A plugin whose register fails
+ * declares and provides nothing.
+ */
+function register(plugin, options, serviceFor) {
+    const { name } = plugin;
+    if (name.length > PACKAGE_NAME_MAX || !PACKAGE_NAME.test(name)) {
+        return {
+            problem: `${JSON.stringify(name)} is not an npm package name, which a plugin is named by.`,
+            declared: NOTHING_DECLARED,
+        };
+    }
+    if (!Number.isInteger(plugin.hostApi) || plugin.hostApi > HOST_API_VERSION) {
+        return {
+            problem: `It targets host API version ${String(plugin.hostApi)}, and this core provides version ${String(HOST_API_VERSION)}.`,
+            declared: NOTHING_DECLARED,
+        };
+    }
+    const routes = [];
+    const federation = [];
+    const commands = [];
+    const editorActions = [];
+    let screen;
+    let settings;
+    let service;
+    let registering = true;
+    function declaring(what) {
+        if (!registering)
+            throw new Error(`${name} declared ${what} after its register returned.`);
+    }
+    const host = {
+        apiVersion: HOST_API_VERSION,
+        name,
+        data: pluginDataFolder(options.dataDir, name),
+        get(path, handler) {
+            declaring('a route');
+            routes.push({ path, handler });
+        },
+        federation(middleware) {
+            declaring('a federation middleware');
+            federation.push(middleware);
+        },
+        screen(declared) {
+            declaring('a screen');
+            if (screen !== undefined)
+                throw new Error('A plugin has at most one screen.');
+            screen = declared;
+        },
+        command(declared) {
+            declaring('a command');
+            commands.push(declared);
+        },
+        editorAction(declared) {
+            declaring('an editor action');
+            if (!EDITOR_ACTION_ID.test(declared.id)) {
+                throw new Error(`${JSON.stringify(declared.id)} is not an editor action id: use lower case words joined by -.`);
+            }
+            if (editorActions.some((entry) => entry.id === declared.id)) {
+                throw new Error(`${name} declares two editor actions with the id ${JSON.stringify(declared.id)}.`);
+            }
+            editorActions.push(declared);
+        },
+        siteInfo: () => options.siteInfo(),
+        fetch: (url, init = {}) => pluginFetch(url, init, options),
+        provide(value) {
+            declaring('a service');
+            if (service !== undefined) {
+                throw new Error(`${name} provides a second service. A plugin provides at most one, named by its package name.`);
+            }
+            service = { value };
+        },
+        use: (dependency) => serviceFor(plugin, dependency),
+        settings(fields) {
+            declaring('its settings');
+            if (settings !== undefined)
+                throw new Error('A plugin declares its settings once.');
+            const problem = settingFieldsProblem(fields);
+            if (problem !== undefined)
+                throw new Error(problem);
+            settings = fields;
+            const place = { ...options, name, fields };
+            return {
+                // Each value is built from its field's type, which is what the mapped
+                // type says, but TypeScript cannot follow a map over the fields.
+                current: () => settingValues(resolvePluginSettings(place)),
+            };
+        },
+    };
+    try {
+        plugin.register(host);
+        return {
+            problem: undefined,
+            declared: { routes, federation, screen, commands, settings: settings ?? [], editorActions },
+            service,
+        };
+    }
+    catch (error) {
+        return {
+            problem: `Its register failed: ${error instanceof Error ? error.message : String(error)}`,
+            declared: NOTHING_DECLARED,
+        };
+    }
+    finally {
+        registering = false;
+    }
+}
+/** An editor action's id, which is the last segment of its endpoint's path. */
+const EDITOR_ACTION_ID = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+/** A file name a plugin may use in its folder: one segment, not hidden. */
+const DATA_FILE_NAME = /^[A-Za-z0-9_-][A-Za-z0-9._-]*$/;
+/** `data/plugins/<package name>/`, which only its plugin reads and writes. */
+export function pluginDataFolder(dataDir, name) {
+    const folder = pluginFolderPath(dataDir, name);
+    function fileIn(file) {
+        if (!DATA_FILE_NAME.test(file)) {
+            throw new Error(`${JSON.stringify(file)} is not a file name a plugin can use in its folder.`);
+        }
+        return path.join(folder, file);
+    }
+    return {
+        path: folder,
+        read: (file) => readFileIfPresentSync(fileIn(file)),
+        update: (file, change) => updateFileAtomically(fileIn(file), change),
+    };
+}
+async function lifecycle(plugin, hook) {
+    try {
+        await plugin[hook]?.();
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.warn(`The ${plugin.name} plugin's ${hook} failed: ${message}`);
+    }
+}
+/**
+ * Each installed name whose environment variable prefix another installed
+ * name shares, with those others: `@a/b-c` and `@a-b/c` both make `A_B_C`.
+ */
+function prefixCollisions(names) {
+    const byPrefix = new Map();
+    for (const name of names) {
+        const prefix = pluginEnvPrefix(name);
+        byPrefix.set(prefix, [...(byPrefix.get(prefix) ?? []), name]);
+    }
+    const collisions = new Map();
+    for (const group of byPrefix.values()) {
+        if (group.length < 2)
+            continue;
+        for (const name of group) {
+            collisions.set(name, group.filter((other) => other !== name));
+        }
+    }
+    return collisions;
+}
+function requirementsOf(plugin) {
+    return Object.entries(plugin.requires ?? {});
+}
+/**
+ * Each plugin that sits in a dependency cycle, with the cycle it is in, found
+ * as the strongly connected components (Tarjan) of the installed graph.
+ */
+function cyclicNames(plugins) {
+    const installed = new Map(plugins.map((plugin) => [plugin.name, plugin]));
+    const index = new Map();
+    const low = new Map();
+    const stack = [];
+    const onStack = new Set();
+    const cyclic = new Map();
+    let next = 0;
+    function visit(name) {
+        index.set(name, next);
+        low.set(name, next);
+        next += 1;
+        stack.push(name);
+        onStack.add(name);
+        const plugin = installed.get(name);
+        for (const [dependency] of plugin === undefined ? [] : requirementsOf(plugin)) {
+            if (!installed.has(dependency))
+                continue;
+            if (!index.has(dependency)) {
+                visit(dependency);
+                low.set(name, Math.min(low.get(name) ?? 0, low.get(dependency) ?? 0));
+            }
+            else if (onStack.has(dependency)) {
+                low.set(name, Math.min(low.get(name) ?? 0, index.get(dependency) ?? 0));
+            }
+        }
+        if (low.get(name) !== index.get(name))
+            return;
+        const component = [];
+        let member;
+        do {
+            member = stack.pop();
+            if (member === undefined)
+                break;
+            onStack.delete(member);
+            component.push(member);
+        } while (member !== name);
+        const selfLoop = Object.hasOwn(plugin?.requires ?? {}, name);
+        if (component.length > 1 || selfLoop) {
+            const cycle = [...component.reverse(), component[0] ?? name];
+            for (const entry of component)
+                cyclic.set(entry, cycle);
+        }
+    }
+    for (const plugin of plugins)
+        if (!index.has(plugin.name))
+            visit(plugin.name);
+    return cyclic;
+}
+/**
+ * Available plugins with every plugin before the ones that require it. Every
+ * requirement of an available plugin is available, so this is a plain
+ * depth-first post-order.
+ */
+function dependencyOrder(available) {
+    const byName = new Map(available.map((entry) => [entry.plugin.name, entry]));
+    const ordered = [];
+    const seen = new Set();
+    function visit(entry) {
+        if (seen.has(entry.plugin.name))
+            return;
+        seen.add(entry.plugin.name);
+        for (const [dependency] of requirementsOf(entry.plugin)) {
+            const required = byName.get(dependency);
+            if (required !== undefined)
+                visit(required);
+        }
+        ordered.push(entry);
+    }
+    for (const entry of available)
+        visit(entry);
+    return ordered;
+}
+//# sourceMappingURL=registry.js.map

package/dist/plugins/registry.js.map

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

package/dist/plugins/settings.d.ts

@@ -0,0 +1,64 @@
+/**
+ * A plugin's settings (decision-33): the fields it declares, where each value
+ * lives, and what a save writes.
+ *
+ * Public values sit under the plugin's key in `content/_data/site.json`,
+ * beside `enabled`. Secrets sit in `secrets.json` in the plugin's data folder,
+ * mode 0600, and an environment variable named by the package wins over the
+ * file, so a Docker operator can keep a key in `.env`. Every value is read
+ * from the files and the environment when it is asked for, so a save or a
+ * hand edit takes effect on the next request.
+ */
+import type { PluginSettingField } from '../plugin.ts';
+export declare const SECRETS_FILE = "secrets.json";
+/** Where a value came from: nowhere, `site.json`, `secrets.json` or the environment. */
+export type SettingSource = 'default' | 'site' | 'file' | 'environment';
+/** One field and the value it has now. */
+export interface ResolvedSetting {
+    readonly field: PluginSettingField;
+    readonly value: string | boolean | undefined;
+    readonly source: SettingSource;
+    /** Why the stored value was set aside for the default, or `undefined`. */
+    readonly problem: string | undefined;
+    /** A secret's environment variable, `undefined` for a public field. */
+    readonly variable: string | undefined;
+}
+/** Where one plugin's settings are read from. */
+export interface PluginSettingsPlace {
+    readonly contentDir: string;
+    readonly dataDir: string;
+    readonly env: Readonly<Record<string, string | undefined>>;
+    readonly name: string;
+    readonly fields: readonly PluginSettingField[];
+}
+/** A settings form as submitted: each box by key, and the secrets to forget. */
+export interface PluginSettingsSubmission {
+    readonly values: Readonly<Record<string, string | undefined>>;
+    readonly forget: ReadonlySet<string>;
+}
+/** `data/plugins/<package name>/`. */
+export declare function pluginFolderPath(dataDir: string, name: string): string;
+/**
+ * What every environment variable of a package starts with, before `__`:
+ * `GEEKITY_PLUGIN_LLM` for `@geekity/plugin-llm`. It never contains `__`, so
+ * no plugin variable can shadow a core one.
+ */
+export declare function pluginEnvPrefix(name: string): string;
+/** The environment variable that sets one setting, such as `GEEKITY_PLUGIN_LLM__API_KEY`. */
+export declare function pluginVariable(name: string, key: string): string;
+/** Why these fields cannot be stored, or `undefined` when they can. */
+export declare function settingFieldsProblem(fields: readonly PluginSettingField[]): string | undefined;
+/** Every field with its value now, in the order declared. */
+export declare function resolvePluginSettings(place: PluginSettingsPlace): ResolvedSetting[];
+/** The values a plugin is handed, keyed by field key. */
+export declare function settingValues(resolved: readonly ResolvedSetting[]): Record<string, string | boolean | undefined>;
+/**
+ * Save a submitted form. A field with a value it does not accept refuses the
+ * whole save, named in `problems`, and nothing is written. An empty public
+ * box removes the key, so the default applies; an empty secret box keeps the
+ * stored secret; a secret the environment sets is never written.
+ */
+export declare function savePluginSettings(options: PluginSettingsPlace & PluginSettingsSubmission): Promise<{
+    problems: Record<string, string>;
+}>;
+//# sourceMappingURL=settings.d.ts.map

package/dist/plugins/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/plugins/settings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGvD,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAE3C,wFAAwF;AACxF,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,aAAa,CAAC;AAExE,0CAA0C;AAC1C,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CACvC;AAED,iDAAiD;AACjD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAC3D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE,CAAC;CAChD;AAED,gFAAgF;AAChF,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAC9D,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACtC;AAED,sCAAsC;AACtC,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEtE;AASD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,6FAA6F;AAC7F,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhE;AAID,uEAAuE;AACvE,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE,GAAG,MAAM,GAAG,SAAS,CAqB9F;AAED,6DAA6D;AAC7D,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,mBAAmB,GAAG,eAAe,EAAE,CA6BnF;AAED,yDAAyD;AACzD,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,SAAS,eAAe,EAAE,GACnC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAE9C;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,mBAAmB,GAAG,wBAAwB,GACtD,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC,CA2D/C"}