@geekity/cms 0.24.0 → 0.26.0

package/dist/plugins/install.js

@@ -0,0 +1,275 @@
+/**
+ * `geekity plugin add` and `geekity plugin remove` (decision-33): a plugin
+ * package's bundle, fetched from the npm registry and unpacked into the
+ * plugins folder, with no npm and no `package.json` on the machine.
+ *
+ * Every check runs before the folder is touched. The new folder is written
+ * beside the live one under a dot-prefixed name, which a scan skips, and
+ * renamed into place, so a reload never sees a half-written folder.
+ */
+import { createHash, randomBytes } from 'node:crypto';
+import { existsSync } from 'node:fs';
+import { mkdir, rename, rm, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { gunzipSync } from 'node:zlib';
+import semver from 'semver';
+import { HOST_API_VERSION } from '../plugin.js';
+import { PLUGIN_ENTRY, PLUGIN_MANIFEST, readPluginManifest, scanPluginFolders } from './folder.js';
+import { PACKAGE_NAME } from './registry.js';
+export const DEFAULT_REGISTRY = 'https://registry.npmjs.org/';
+/** The folder in a package that is the plugin's folder once installed. */
+const BUNDLE_PREFIX = 'dist/bundle/';
+/** `@scope/name@1.2.3`, `name@next` or a bare name. */
+export function parsePackageSpec(spec) {
+    const at = spec.indexOf('@', 1);
+    const name = at === -1 ? spec : spec.slice(0, at);
+    const wanted = at === -1 ? 'latest' : spec.slice(at + 1);
+    if (!PACKAGE_NAME.test(name) || wanted === '') {
+        throw new Error(`${JSON.stringify(spec)} is not a package, such as @geekity/plugin-llm or @geekity/plugin-llm@0.1.0.`);
+    }
+    return { name, wanted };
+}
+/** Fetch, check and install one plugin package. Throws, leaving the folder alone, when it cannot. */
+export async function addPlugin(spec, options) {
+    const { name } = spec;
+    const release = await resolveRelease(spec, options.registry);
+    const label = `${name} ${release.version}`;
+    const response = await fetch(release.tarball);
+    if (!response.ok) {
+        throw new Error(`Downloading ${label} failed: the registry answered ${String(response.status)}.`);
+    }
+    const tarball = Buffer.from(await response.arrayBuffer());
+    const integrityProblem = checkIntegrity(tarball, release);
+    if (integrityProblem !== undefined)
+        throw new Error(`${label} was refused: ${integrityProblem}`);
+    const files = bundleFiles(unpackTarball(tarball));
+    if (!files.has(PLUGIN_ENTRY) || !files.has(PLUGIN_MANIFEST)) {
+        throw new Error(`${label} has no plugin bundle (${BUNDLE_PREFIX}${PLUGIN_ENTRY} and ${BUNDLE_PREFIX}${PLUGIN_MANIFEST}). A plugin that is not bundled can only be installed with npm, by a site with its own server.`);
+    }
+    const directory = path.join(options.pluginsDir, ...name.split('/'));
+    const parent = path.dirname(directory);
+    await mkdir(parent, { recursive: true });
+    const staging = path.join(parent, hidden('adding', directory));
+    try {
+        for (const [file, bytes] of files) {
+            const target = path.join(staging, ...file.split('/'));
+            await mkdir(path.dirname(target), { recursive: true });
+            await writeFile(target, bytes);
+        }
+        const manifest = stagedManifest(staging, label, name);
+        const replaced = existsSync(directory) ? installedVersion(directory) : undefined;
+        await swapInto(staging, directory);
+        return { manifest, directory, replaced };
+    }
+    finally {
+        await rm(staging, { recursive: true, force: true });
+    }
+}
+/** Delete a plugin's folder. Throws when there is none. */
+export async function removePlugin(name, pluginsDir) {
+    const directory = path.join(pluginsDir, ...name.split('/'));
+    if (!PACKAGE_NAME.test(name) || !existsSync(directory)) {
+        throw new Error(`${name} is not in the plugins folder, ${pluginsDir}.`);
+    }
+    const doomed = path.join(path.dirname(directory), hidden('removing', directory));
+    await rename(directory, doomed);
+    await rm(doomed, { recursive: true, force: true });
+    return directory;
+}
+/**
+ * A line for each plugin the manifest requires that is not installed or not
+ * in range, and for a core out of range. `installed` maps each installed
+ * plugin to its version, or to `undefined` when that is not known.
+ */
+export function requirementNotes(manifest, installed, coreVersion) {
+    const notes = [];
+    for (const [dependency, range] of Object.entries(manifest.peerDependencies)) {
+        if (dependency === CORE_PACKAGE) {
+            if (!semver.satisfies(coreVersion, range)) {
+                notes.push(`It needs ${CORE_PACKAGE} ${range}, and this core is ${coreVersion}, so it will be unavailable.`);
+            }
+            continue;
+        }
+        if (!installed.has(dependency)) {
+            notes.push(`It requires ${dependency} ${range}, which is not installed. Add it with: geekity plugin add ${dependency}`);
+            continue;
+        }
+        const version = installed.get(dependency);
+        if (version !== undefined && !semver.satisfies(version, range)) {
+            notes.push(`It requires ${dependency} ${range}, and ${version} is installed.`);
+        }
+    }
+    return notes;
+}
+const CORE_PACKAGE = '@geekity/cms';
+async function resolveRelease(spec, registry) {
+    const url = new URL(spec.name.replace('/', '%2f'), registry.endsWith('/') ? registry : `${registry}/`);
+    const response = await fetch(url, {
+        headers: { accept: 'application/vnd.npm.install-v1+json; q=1.0, application/json; q=0.8' },
+    });
+    if (response.status === 404) {
+        throw new Error(`${spec.name} is not on the registry at ${registry}.`);
+    }
+    if (!response.ok) {
+        throw new Error(`The registry at ${registry} answered ${String(response.status)} for ${spec.name}.`);
+    }
+    const document = (await response.json());
+    const versions = Object.keys(document.versions ?? {});
+    const version = document['dist-tags']?.[spec.wanted] ??
+        (semver.valid(spec.wanted) !== null && versions.includes(spec.wanted)
+            ? spec.wanted
+            : semver.validRange(spec.wanted) !== null
+                ? semver.maxSatisfying(versions, spec.wanted)
+                : null);
+    const dist = version === null ? undefined : document.versions?.[version]?.dist;
+    if (version === null || dist?.tarball === undefined) {
+        throw new Error(`${spec.name} has no version matching ${spec.wanted}.`);
+    }
+    return { version, tarball: dist.tarball, integrity: dist.integrity, shasum: dist.shasum };
+}
+const HASHES = ['sha512', 'sha384', 'sha256', 'sha1'];
+/** Why the tarball does not match what the registry published, or `undefined`. */
+function checkIntegrity(tarball, release) {
+    const claims = (release.integrity ?? '').split(/\s+/).filter((claim) => claim !== '');
+    for (const algorithm of HASHES) {
+        const expected = claims
+            .filter((claim) => claim.startsWith(`${algorithm}-`))
+            .map((claim) => claim.slice(algorithm.length + 1).replace(/\?.*$/, ''));
+        if (expected.length === 0)
+            continue;
+        const actual = createHash(algorithm).update(tarball).digest('base64');
+        return expected.includes(actual)
+            ? undefined
+            : `its ${algorithm} integrity hash does not match the one the registry published.`;
+    }
+    if (release.shasum !== undefined) {
+        return createHash('sha1').update(tarball).digest('hex') === release.shasum.toLowerCase()
+            ? undefined
+            : 'its sha1 hash does not match the one the registry published.';
+    }
+    return 'the registry published no integrity hash to check it against.';
+}
+/**
+ * The regular files in a gzipped tar, by path with the archive's top folder
+ * (`package/` in an npm tarball) removed. Links and devices are skipped.
+ */
+export function unpackTarball(gzipped) {
+    const archive = gunzipSync(gzipped);
+    const files = new Map();
+    let longName;
+    let offset = 0;
+    while (offset + 512 <= archive.length) {
+        const header = archive.subarray(offset, offset + 512);
+        if (header.every((byte) => byte === 0))
+            break;
+        const size = Number.parseInt(field(header, 124, 12).trim() || '0', 8);
+        const type = String.fromCharCode(header[156] ?? 0);
+        const body = archive.subarray(offset + 512, offset + 512 + size);
+        offset += 512 + Math.ceil(size / 512) * 512;
+        if (type === 'x') {
+            longName = paxPath(body.toString('utf8')) ?? longName;
+            continue;
+        }
+        if (type === 'L') {
+            longName = body.toString('utf8').replace(/\0.*$/s, '');
+            continue;
+        }
+        const prefix = field(header, 345, 155);
+        const name = longName ?? (prefix === '' ? '' : `${prefix}/`) + field(header, 0, 100);
+        longName = undefined;
+        if (type !== '0' && type !== '\0')
+            continue;
+        const relative = name.split('/').slice(1).join('/');
+        if (relative !== '')
+            files.set(relative, Buffer.from(body));
+    }
+    return files;
+}
+function field(header, start, length) {
+    return header
+        .subarray(start, start + length)
+        .toString('utf8')
+        .replace(/\0.*$/s, '');
+}
+function paxPath(records) {
+    for (const record of records.split('\n')) {
+        const match = /^\d+ path=(.*)$/.exec(record);
+        if (match !== null)
+            return match[1];
+    }
+    return undefined;
+}
+/** The files under the package's `dist/bundle/`, by path inside it. Anything that would climb out is refused. */
+function bundleFiles(files) {
+    const bundle = new Map();
+    for (const [file, bytes] of files) {
+        if (!file.startsWith(BUNDLE_PREFIX))
+            continue;
+        const inside = file.slice(BUNDLE_PREFIX.length);
+        const segments = inside.split('/');
+        if (segments.some((segment) => segment === '' || segment === '.' || segment === '..')) {
+            throw new Error(`The package holds a file the plugins folder cannot take: ${file}.`);
+        }
+        bundle.set(inside, bytes);
+    }
+    return bundle;
+}
+function stagedManifest(staging, label, name) {
+    let manifest;
+    try {
+        manifest = readPluginManifest(staging);
+    }
+    catch (error) {
+        throw new Error(`${label} was refused: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+    }
+    if (manifest === undefined)
+        throw new Error(`${label} has no ${PLUGIN_MANIFEST}.`);
+    if (manifest.name !== name) {
+        throw new Error(`${label} was refused: its ${PLUGIN_MANIFEST} names ${manifest.name}.`);
+    }
+    if (manifest.hostApi > HOST_API_VERSION) {
+        throw new Error(`${label} targets host API version ${String(manifest.hostApi)}, and this core provides version ${String(HOST_API_VERSION)}. Upgrade @geekity/cms, or add an older version of the plugin.`);
+    }
+    return manifest;
+}
+/** Each plugin folder by name, with the version its `plugin.json` names, when it has a usable one. */
+export function installedFolders(pluginsDir) {
+    return new Map(scanPluginFolders(pluginsDir).map((folder) => [
+        folder.name,
+        installedVersion(folder.directory),
+    ]));
+}
+function installedVersion(directory) {
+    try {
+        return readPluginManifest(directory)?.version;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Put the staged folder where the live one is. A directory cannot be renamed
+ * over a full one, so the old one is moved aside first, and back if the second
+ * rename fails.
+ */
+async function swapInto(staging, directory) {
+    if (!existsSync(directory)) {
+        await rename(staging, directory);
+        return;
+    }
+    const old = path.join(path.dirname(directory), hidden('replaced', directory));
+    await rename(directory, old);
+    try {
+        await rename(staging, directory);
+    }
+    catch (error) {
+        await rename(old, directory);
+        throw error;
+    }
+    await rm(old, { recursive: true, force: true });
+}
+/** A dot-prefixed sibling name, which a scan of the plugins folder skips. */
+function hidden(purpose, directory) {
+    return `.${purpose}-${path.basename(directory)}-${randomBytes(4).toString('hex')}`;
+}
+//# sourceMappingURL=install.js.map

package/dist/plugins/install.js.map

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

package/dist/plugins/mount.d.ts

@@ -0,0 +1,17 @@
+import type { Hono, MiddlewareHandler } from 'hono';
+import type { GeekityEnv } from '../env.ts';
+import type { PluginRegistry } from './registry.ts';
+/**
+ * Read the enabled set for this request, bring the running plugins into line
+ * with it, and put the active set on the context. A site with no plugins
+ * reads nothing. A worker draining for a reload has stopped its plugins and
+ * leaves them stopped.
+ */
+export declare function pluginLifecycle(registry: PluginRegistry, draining: () => boolean): MiddlewareHandler<GeekityEnv>;
+/**
+ * Every available plugin's public routes. A route whose plugin is not active
+ * for this request hands on to the next match, so it answers exactly what an
+ * absent route would.
+ */
+export declare function mountPluginRoutes(app: Hono<GeekityEnv>, registry: PluginRegistry): void;
+//# sourceMappingURL=mount.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mount.d.ts","sourceRoot":"","sources":["../../src/plugins/mount.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAEpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAIpD;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,cAAc,EACxB,QAAQ,EAAE,MAAM,OAAO,GACtB,iBAAiB,CAAC,UAAU,CAAC,CAY/B;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,IAAI,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,cAAc,GAAG,IAAI,CAavF"}

package/dist/plugins/mount.js

@@ -0,0 +1,44 @@
+import { readEnabledPlugins } from './enabled.js';
+const NONE = new Set();
+/**
+ * Read the enabled set for this request, bring the running plugins into line
+ * with it, and put the active set on the context. A site with no plugins
+ * reads nothing. A worker draining for a reload has stopped its plugins and
+ * leaves them stopped.
+ */
+export function pluginLifecycle(registry, draining) {
+    return async (c, next) => {
+        c.set('plugins', registry);
+        if (registry.plugins.length === 0) {
+            c.set('activePlugins', NONE);
+        }
+        else {
+            const enabled = readEnabledPlugins(c.var.config.contentDir);
+            if (!draining())
+                await registry.reconcile(enabled);
+            c.set('activePlugins', registry.active(enabled));
+        }
+        await next();
+    };
+}
+/**
+ * Every available plugin's public routes. A route whose plugin is not active
+ * for this request hands on to the next match, so it answers exactly what an
+ * absent route would.
+ */
+export function mountPluginRoutes(app, registry) {
+    for (const { plugin, problem, routes } of registry.plugins) {
+        if (problem !== undefined)
+            continue;
+        for (const route of routes) {
+            app.get(route.path, async (c, next) => {
+                if (!c.var.activePlugins.has(plugin.name)) {
+                    await next();
+                    return;
+                }
+                return route.handler({ request: c.req.raw, params: c.req.param() });
+            });
+        }
+    }
+}
+//# sourceMappingURL=mount.js.map

package/dist/plugins/mount.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount.js","sourceRoot":"","sources":["../../src/plugins/mount.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGlD,MAAM,IAAI,GAAwB,IAAI,GAAG,EAAE,CAAC;AAE5C;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC7B,QAAwB,EACxB,QAAuB;IAEvB,OAAO,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE;QACvB,CAAC,CAAC,GAAG,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;QAC3B,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAClC,CAAC,CAAC,GAAG,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;QAC/B,CAAC;aAAM,CAAC;YACN,MAAM,OAAO,GAAG,kBAAkB,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAC5D,IAAI,CAAC,QAAQ,EAAE;gBAAE,MAAM,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YACnD,CAAC,CAAC,GAAG,CAAC,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QACnD,CAAC;QACD,MAAM,IAAI,EAAE,CAAC;IACf,CAAC,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAqB,EAAE,QAAwB;IAC/E,KAAK,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QAC3D,IAAI,OAAO,KAAK,SAAS;YAAE,SAAS;QACpC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE;gBACpC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC1C,MAAM,IAAI,EAAE,CAAC;oBACb,OAAO;gBACT,CAAC;gBACD,OAAO,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACtE,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/plugins/registry.d.ts

@@ -0,0 +1,110 @@
+/**
+ * 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 type { Plugin, PluginCommand, PluginDataFolder, PluginEditorAction, PluginFederationMiddleware, PluginRouteHandler, PluginScreen, PluginSettingField, PluginSiteInfo } from '../plugin.ts';
+import type { PluginFetchOptions } from './fetch.ts';
+import type { PluginSettingsPlace } from './settings.ts';
+/** A plugin as it arrived, and a description of where it came from. */
+export interface InstalledPlugin {
+    plugin: Plugin;
+    /** Where it came from, as the Plugins screen and a boot error name it. */
+    source: string;
+    /**
+     * Why it could not be loaded, such as a folder whose module failed to
+     * import. Such a plugin is never registered, and `plugin` only names it.
+     */
+    problem?: string | undefined;
+    /**
+     * The ranges a folder install's `plugin.json` names, of `@geekity/cms` and
+     * of each plugin it requires. npm checks them for a package it installs.
+     */
+    peerDependencies?: Readonly<Record<string, string>> | undefined;
+}
+/** One public route a plugin declared in `register`. */
+export interface PluginRoute {
+    path: string;
+    handler: PluginRouteHandler;
+}
+/** What a plugin declared in `register`. */
+export interface PluginContributions {
+    routes: readonly PluginRoute[];
+    federation: readonly PluginFederationMiddleware[];
+    screen: PluginScreen | undefined;
+    commands: readonly PluginCommand[];
+    /** The settings fields it declared, empty when it has none. */
+    settings: readonly PluginSettingField[];
+    /** Its buttons beside editor fields, in the order it declared them. */
+    editorActions: readonly PluginEditorAction[];
+}
+/**
+ * What plugins read through the registry: the site's folders, its
+ * environment, its base URL and title, and which addresses they may fetch.
+ */
+export interface PluginRegistryOptions extends PluginFetchOptions {
+    dataDir: string;
+    contentDir: string;
+    env: Readonly<Record<string, string | undefined>>;
+    siteInfo(): PluginSiteInfo;
+}
+/** An installed plugin after registration. */
+export interface RegisteredPlugin extends InstalledPlugin, PluginContributions {
+    /** Why it cannot run, or `undefined` when it can be enabled. */
+    problem: string | undefined;
+    /** Where its settings are read from and written to. */
+    settingsPlace: PluginSettingsPlace;
+}
+/**
+ * Where one requirement of a plugin stands. `blocked` is a plugin that is
+ * enabled but cannot run, because something it requires is not running.
+ */
+export type RequirementState = 'enabled' | 'blocked' | 'disabled' | 'unavailable' | 'missing';
+export interface Requirement {
+    name: string;
+    range: string;
+    state: RequirementState;
+}
+export interface PluginRegistry {
+    /** Every installed plugin, in the order it was installed. */
+    readonly plugins: readonly RegisteredPlugin[];
+    find(name: string): RegisteredPlugin | undefined;
+    /** Why the plugin cannot run, or `undefined`. */
+    problem(name: string): string | undefined;
+    /**
+     * The plugins that run under this enabled set: enabled, available, and
+     * with everything they require running.
+     */
+    active(enabled: ReadonlySet<string>): ReadonlySet<string>;
+    /** Each plugin this one requires, and where it stands. */
+    requirements(name: string, enabled: ReadonlySet<string>): Requirement[];
+    /** The enabled plugins that require this one. */
+    enabledDependents(name: string, enabled: ReadonlySet<string>): string[];
+    /**
+     * Start the plugins that should run and stop the ones that should not, so
+     * the running set is {@link PluginRegistry.active}. Safe to call on every
+     * request: when nothing changed it does nothing. Calls are serialized.
+     */
+    reconcile(enabled: ReadonlySet<string>): Promise<void>;
+    /** Stop every running plugin, dependents first. Nothing starts after. */
+    close(): Promise<void>;
+}
+/** Two installed plugins with one name. */
+export declare class DuplicatePluginError extends Error {
+    constructor(name: string, first: string, second: string);
+}
+/** npm's rule for a package name, scoped or not. */
+export declare const PACKAGE_NAME: RegExp;
+/**
+ * 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 declare function createPluginRegistry(installed: readonly InstalledPlugin[], options: PluginRegistryOptions): PluginRegistry;
+/** `data/plugins/<package name>/`, which only its plugin reads and writes. */
+export declare function pluginDataFolder(dataDir: string, name: string): PluginDataFolder;
+//# sourceMappingURL=registry.d.ts.map

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

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