@geekity/cms 0.24.0 → 0.26.0

package/dist/plugins/federation.d.ts

@@ -0,0 +1,26 @@
+/**
+ * The federation phase plugins answer in (decision-33): after the canonical
+ * federation, before stored ids. A plugin running a federation of its own
+ * reaches the site's through {@link PluginFederationContext}, and everything
+ * that crosses is plain data, because a bundled plugin carries its own copy
+ * of Fedify and an object built by one copy fails the other's type checks.
+ */
+import type { KvStore } from '@fedify/fedify';
+import type { MiddlewareHandler } from 'hono';
+import type { GeekityEnv } from '../env.ts';
+import type { SiteFederation } from '../federation/federation.ts';
+import type { PluginRegistry } from './registry.ts';
+/** What every plugin federation shares with the site's own. */
+export interface PluginFederationOptions {
+    registry: PluginRegistry;
+    canonical: SiteFederation;
+    kv: KvStore;
+    allowPrivateAddress: boolean;
+}
+/**
+ * Run each active plugin's federation middleware in turn. A request no
+ * plugin answers, and every request while none is active, goes on to the
+ * rest of the site.
+ */
+export declare function pluginFederation(options: PluginFederationOptions): MiddlewareHandler<GeekityEnv>;
+//# sourceMappingURL=federation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"federation.d.ts","sourceRoot":"","sources":["../../src/plugins/federation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,KAAK,EAAW,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAGvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAG5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAWlE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGpD,+DAA+D;AAC/D,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,cAAc,CAAC;IACzB,SAAS,EAAE,cAAc,CAAC;IAC1B,EAAE,EAAE,OAAO,CAAC;IACZ,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAsBhG"}

package/dist/plugins/federation.js

@@ -0,0 +1,114 @@
+/**
+ * The federation phase plugins answer in (decision-33): after the canonical
+ * federation, before stored ids. A plugin running a federation of its own
+ * reaches the site's through {@link PluginFederationContext}, and everything
+ * that crosses is plain data, because a bundled plugin carries its own copy
+ * of Fedify and an object built by one copy fails the other's type checks.
+ */
+import { listUsers } from '../admin/accounts.js';
+import { userActor, userByUsername } from '../federation/actor.js';
+import { lastOutboxCursor, outboxPage } from '../federation/federation.js';
+import { followersPage, lastFollowersCursor } from '../federation/followers.js';
+import { receiveActivity } from '../federation/inbox.js';
+import { loadActorKeyPairs } from '../federation/keys.js';
+import { contextData } from '../federation/mount.js';
+import { authorNames } from '../web/authors.js';
+import { pluginSite } from './site.js';
+/**
+ * Run each active plugin's federation middleware in turn. A request no
+ * plugin answers, and every request while none is active, goes on to the
+ * rest of the site.
+ */
+export function pluginFederation(options) {
+    const mounted = options.registry.plugins.filter((entry) => entry.problem === undefined && entry.federation.length > 0);
+    return async (c, next) => {
+        const running = mounted
+            .filter((entry) => c.var.activePlugins.has(entry.plugin.name))
+            .flatMap((entry) => entry.federation);
+        if (running.length === 0)
+            return await next();
+        const context = federationContext(c, options);
+        const dispatch = async (index) => {
+            const middleware = running[index];
+            if (middleware === undefined) {
+                await next();
+                return c.res;
+            }
+            return await middleware(context, () => dispatch(index + 1));
+        };
+        return await dispatch(0);
+    };
+}
+function federationContext(c, options) {
+    const { config } = c.var;
+    const canonical = () => options.canonical.createContext(c.req.raw, contextData(c));
+    const userNamed = (username) => userByUsername(config.dataDir, username);
+    return {
+        request: c.req.raw,
+        site: pluginSite({ admin: c.var.admin, config }),
+        kv: options.kv,
+        allowPrivateAddress: options.allowPrivateAddress,
+        now: () => config.now(),
+        async actor(username) {
+            const user = userNamed(username);
+            if (user === undefined)
+                return undefined;
+            const context = canonical();
+            const actor = await userActor(context, user, { baseUrl: config.baseUrl });
+            return (await actor.toJsonLd({ contextLoader: context.contextLoader }));
+        },
+        async keyPairs(username) {
+            if (userNamed(username) === undefined)
+                return [];
+            return await loadActorKeyPairs(config.dataDir, username);
+        },
+        outbox(username) {
+            const user = userNamed(username);
+            if (user === undefined)
+                return undefined;
+            const names = authorNames(listUsers(config.dataDir), user);
+            const totalItems = c.var.store.countByAuthor(names);
+            return {
+                totalItems,
+                firstCursor: '0',
+                lastCursor: lastOutboxCursor(totalItems),
+                async page(cursor) {
+                    const context = canonical();
+                    const page = outboxPage(context, names, cursor);
+                    const items = await Promise.all(page.items.map(async (item) => (await item.toJsonLd({ contextLoader: context.contextLoader }))));
+                    return {
+                        items,
+                        nextCursor: page.nextCursor ?? null,
+                        prevCursor: page.prevCursor ?? null,
+                    };
+                },
+            };
+        },
+        followers(username) {
+            if (userNamed(username) === undefined)
+                return undefined;
+            const totalItems = c.var.admin.countFollowers(username);
+            return {
+                totalItems,
+                firstCursor: '0',
+                lastCursor: lastFollowersCursor(totalItems),
+                page(cursor) {
+                    const page = followersPage(canonical(), username, cursor);
+                    return Promise.resolve({
+                        items: page.items.map((recipient) => ({
+                            id: recipient.id?.href ?? '',
+                            inboxId: recipient.inboxId?.href ?? '',
+                            sharedInboxId: recipient.endpoints?.sharedInbox?.href ?? null,
+                        })),
+                        nextCursor: page.nextCursor ?? null,
+                        prevCursor: page.prevCursor ?? null,
+                    });
+                },
+            };
+        },
+        async receive(activity, recipient) {
+            await receiveActivity(canonical(), activity, recipient);
+        },
+    };
+}
+//# sourceMappingURL=federation.js.map

package/dist/plugins/federation.js.map

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

package/dist/plugins/fetch.d.ts

@@ -0,0 +1,15 @@
+/**
+ * A plugin's outbound fetch (decision-33): `GET` another site's URL with the
+ * rule the site's federation keeps, so a plugin cannot be steered into the
+ * site's own network unless the site allows private addresses.
+ */
+import type { PluginFetchInit } from '../plugin.ts';
+import type { HostLookup } from '../webmention/public-address.ts';
+/** What decides which addresses a plugin may reach. */
+export interface PluginFetchOptions {
+    /** The site federation's own switch; on only for tests and private networks. */
+    allowPrivateAddress: boolean;
+    lookup: HostLookup;
+}
+export declare function pluginFetch(target: string, init: PluginFetchInit, options: PluginFetchOptions): Promise<Response>;
+//# sourceMappingURL=fetch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../src/plugins/fetch.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAGpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAKlE,uDAAuD;AACvD,MAAM,WAAW,kBAAkB;IACjC,gFAAgF;IAChF,mBAAmB,EAAE,OAAO,CAAC;IAC7B,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,wBAAsB,WAAW,CAC/B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,eAAe,EACrB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,QAAQ,CAAC,CAqBnB"}

package/dist/plugins/fetch.js

@@ -0,0 +1,33 @@
+/**
+ * A plugin's outbound fetch (decision-33): `GET` another site's URL with the
+ * rule the site's federation keeps, so a plugin cannot be steered into the
+ * site's own network unless the site allows private addresses.
+ */
+import { webUrl } from '../webmention/fetch-public.js';
+import { publicHost } from '../webmention/public-address.js';
+/** How many redirects are followed, each one checked like the first. */
+const MAX_REDIRECTS = 5;
+export async function pluginFetch(target, init, options) {
+    let at = target;
+    for (let hop = 0;; hop += 1) {
+        const url = webUrl(at);
+        if (url === undefined)
+            throw new Error(`${at} is not an http or https URL.`);
+        if (!options.allowPrivateAddress && !(await publicHost(url.hostname, options.lookup))) {
+            throw new Error(`${url.href} is not a public address.`);
+        }
+        const response = await fetch(url, {
+            ...(init.headers === undefined ? {} : { headers: init.headers }),
+            ...(init.signal === undefined ? {} : { signal: init.signal }),
+            redirect: 'manual',
+        });
+        const location = response.headers.get('location');
+        if (response.status < 300 || response.status >= 400 || location === null)
+            return response;
+        await response.body?.cancel();
+        if (hop === MAX_REDIRECTS)
+            throw new Error(`${target} redirected too many times.`);
+        at = new URL(location, url).href;
+    }
+}
+//# sourceMappingURL=fetch.js.map

package/dist/plugins/fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../../src/plugins/fetch.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAG7D,wEAAwE;AACxE,MAAM,aAAa,GAAG,CAAC,CAAC;AASxB,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,MAAc,EACd,IAAqB,EACrB,OAA2B;IAE3B,IAAI,EAAE,GAAG,MAAM,CAAC;IAChB,KAAK,IAAI,GAAG,GAAG,CAAC,GAAI,GAAG,IAAI,CAAC,EAAE,CAAC;QAC7B,MAAM,GAAG,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC;QACvB,IAAI,GAAG,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,EAAE,+BAA+B,CAAC,CAAC;QAC7E,IAAI,CAAC,OAAO,CAAC,mBAAmB,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;YACtF,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,CAAC,IAAI,2BAA2B,CAAC,CAAC;QAC1D,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE;YAChC,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;YAChE,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;YAC7D,QAAQ,EAAE,QAAQ;SACnB,CAAC,CAAC;QACH,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAClD,IAAI,QAAQ,CAAC,MAAM,GAAG,GAAG,IAAI,QAAQ,CAAC,MAAM,IAAI,GAAG,IAAI,QAAQ,KAAK,IAAI;YAAE,OAAO,QAAQ,CAAC;QAE1F,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAC9B,IAAI,GAAG,KAAK,aAAa;YAAE,MAAM,IAAI,KAAK,CAAC,GAAG,MAAM,6BAA6B,CAAC,CAAC;QACnF,EAAE,GAAG,IAAI,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC;IACnC,CAAC;AACH,CAAC"}

package/dist/plugins/folder.d.ts

@@ -0,0 +1,50 @@
+/**
+ * The plugins folder (decision-33): one folder per plugin, `<name>/` or
+ * `@scope/<name>/`, each with a bundled `index.js` whose default export is
+ * the plugin, and the `plugin.json` manifest the bundle build writes beside
+ * it. `geekity serve` imports them at boot. The Plugins screen
+ * compares the folder with what the running worker loaded and offers Reload
+ * when they differ (TASK-288).
+ */
+import type { InstalledPlugin } from './registry.ts';
+export declare const PLUGIN_ENTRY = "index.js";
+export declare const PLUGIN_MANIFEST = "plugin.json";
+/**
+ * `plugin.json`: what the bundle build writes from the package's
+ * `package.json`, so a folder install can be checked without npm.
+ */
+export interface PluginManifest {
+    readonly name: string;
+    readonly version: string;
+    readonly hostApi: number;
+    /** The ranges of `@geekity/cms` and of each plugin package it requires. */
+    readonly peerDependencies: Readonly<Record<string, string>>;
+}
+/** One plugin's folder as it stood when it was scanned. */
+export interface PluginFolder {
+    /** Its package name: the folder's path under the plugins folder. */
+    readonly name: string;
+    readonly directory: string;
+    /** A hash of every file in it, so a replaced bundle reads as changed. */
+    readonly fingerprint: string;
+}
+export interface PluginFolderChanges {
+    readonly added: readonly string[];
+    readonly removed: readonly string[];
+    readonly updated: readonly string[];
+}
+/** Every plugin folder, by name. A missing folder, or none named, holds none. */
+export declare function scanPluginFolders(pluginsDir: string | undefined): PluginFolder[];
+/** What changed between two scans, or `undefined` when nothing did. */
+export declare function pluginFolderChanges(loaded: readonly PluginFolder[], current: readonly PluginFolder[]): PluginFolderChanges | undefined;
+/**
+ * Import each folder's bundle. A folder that cannot be loaded comes back as
+ * an unavailable plugin, named by its folder, so the site still boots.
+ */
+export declare function importPluginFolders(folders: readonly PluginFolder[]): Promise<InstalledPlugin[]>;
+/**
+ * The folder's `plugin.json`, or `undefined` when it has none, as a folder
+ * copied by hand may not. Throws when the file is there but unusable.
+ */
+export declare function readPluginManifest(directory: string): PluginManifest | undefined;
+//# sourceMappingURL=folder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"folder.d.ts","sourceRoot":"","sources":["../../src/plugins/folder.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD,eAAO,MAAM,YAAY,aAAa,CAAC;AACvC,eAAO,MAAM,eAAe,gBAAgB,CAAC;AAE7C;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,2EAA2E;IAC3E,QAAQ,CAAC,gBAAgB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAC7D;AAED,2DAA2D;AAC3D,MAAM,WAAW,YAAY;IAC3B,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,yEAAyE;IACzE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,EAAE,CAahF;AAED,uEAAuE;AACvE,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,YAAY,EAAE,EAC/B,OAAO,EAAE,SAAS,YAAY,EAAE,GAC/B,mBAAmB,GAAG,SAAS,CAWjC;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,OAAO,EAAE,SAAS,YAAY,EAAE,GAC/B,OAAO,CAAC,eAAe,EAAE,CAAC,CAmB5B;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CA4BhF"}

package/dist/plugins/folder.js

@@ -0,0 +1,171 @@
+/**
+ * The plugins folder (decision-33): one folder per plugin, `<name>/` or
+ * `@scope/<name>/`, each with a bundled `index.js` whose default export is
+ * the plugin, and the `plugin.json` manifest the bundle build writes beside
+ * it. `geekity serve` imports them at boot. The Plugins screen
+ * compares the folder with what the running worker loaded and offers Reload
+ * when they differ (TASK-288).
+ */
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+import { createHash } from 'node:crypto';
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { HOST_API_VERSION } from '../plugin.js';
+export const PLUGIN_ENTRY = 'index.js';
+export const PLUGIN_MANIFEST = 'plugin.json';
+/** Every plugin folder, by name. A missing folder, or none named, holds none. */
+export function scanPluginFolders(pluginsDir) {
+    if (pluginsDir === undefined)
+        return [];
+    const folders = [];
+    for (const entry of subdirectories(pluginsDir)) {
+        if (!entry.startsWith('@')) {
+            folders.push(folder(pluginsDir, entry));
+            continue;
+        }
+        for (const scoped of subdirectories(path.join(pluginsDir, entry))) {
+            folders.push(folder(pluginsDir, `${entry}/${scoped}`));
+        }
+    }
+    return folders.sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
+}
+/** What changed between two scans, or `undefined` when nothing did. */
+export function pluginFolderChanges(loaded, current) {
+    const before = new Map(loaded.map((entry) => [entry.name, entry.fingerprint]));
+    const now = new Map(current.map((entry) => [entry.name, entry.fingerprint]));
+    const added = current.filter((entry) => !before.has(entry.name)).map((entry) => entry.name);
+    const removed = loaded.filter((entry) => !now.has(entry.name)).map((entry) => entry.name);
+    const updated = current
+        .filter((entry) => before.has(entry.name) && before.get(entry.name) !== entry.fingerprint)
+        .map((entry) => entry.name);
+    return added.length + removed.length + updated.length === 0
+        ? undefined
+        : { added, removed, updated };
+}
+/**
+ * Import each folder's bundle. A folder that cannot be loaded comes back as
+ * an unavailable plugin, named by its folder, so the site still boots.
+ */
+export async function importPluginFolders(folders) {
+    const installed = [];
+    for (const { name, directory } of folders) {
+        const source = `the plugins folder, ${name}`;
+        let manifest;
+        try {
+            manifest = readPluginManifest(directory);
+        }
+        catch (error) {
+            installed.push({ plugin: placeholder(name), source, problem: messageOf(error) });
+            continue;
+        }
+        const loaded = await importBundle(directory);
+        installed.push(typeof loaded === 'string'
+            ? { plugin: placeholder(name, manifest?.version), source, problem: loaded }
+            : { plugin: loaded, source, peerDependencies: manifest?.peerDependencies });
+    }
+    return installed;
+}
+/**
+ * The folder's `plugin.json`, or `undefined` when it has none, as a folder
+ * copied by hand may not. Throws when the file is there but unusable.
+ */
+export function readPluginManifest(directory) {
+    let text;
+    try {
+        text = readFileSync(path.join(directory, PLUGIN_MANIFEST), 'utf8');
+    }
+    catch {
+        return undefined;
+    }
+    let value;
+    try {
+        value = JSON.parse(text);
+    }
+    catch {
+        throw new Error(`Its ${PLUGIN_MANIFEST} is not JSON.`);
+    }
+    const manifest = value;
+    const peers = manifest?.peerDependencies;
+    if (typeof manifest?.name !== 'string' ||
+        typeof manifest.version !== 'string' ||
+        !Number.isInteger(manifest.hostApi) ||
+        typeof peers !== 'object' ||
+        peers === null ||
+        !Object.values(peers).every((range) => typeof range === 'string')) {
+        throw new Error(`Its ${PLUGIN_MANIFEST} needs a name, a version, a hostApi number and peerDependencies.`);
+    }
+    return manifest;
+}
+/** The bundle's plugin, or why it could not be loaded. */
+async function importBundle(directory) {
+    const entry = path.join(directory, PLUGIN_ENTRY);
+    if (!existsSync(entry))
+        return `It has no ${PLUGIN_ENTRY}.`;
+    let module;
+    try {
+        module = (await import(__rewriteRelativeImportExtension(pathToFileURL(entry).href)));
+    }
+    catch (error) {
+        return `Its ${PLUGIN_ENTRY} failed to load: ${messageOf(error)}`;
+    }
+    return isPlugin(module.default)
+        ? module.default
+        : `Its ${PLUGIN_ENTRY} does not export a plugin as its default export.`;
+}
+/** What the Plugins screen shows of a plugin it could not load. */
+function placeholder(name, version = '') {
+    return {
+        name,
+        version,
+        label: name,
+        description: '',
+        hostApi: HOST_API_VERSION,
+        register() { },
+    };
+}
+function messageOf(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+function folder(pluginsDir, name) {
+    const directory = path.join(pluginsDir, ...name.split('/'));
+    const hash = createHash('sha256');
+    for (const file of filesUnder(directory)) {
+        hash.update(path.relative(directory, file));
+        hash.update('\0');
+        hash.update(readFileSync(file));
+        hash.update('\0');
+    }
+    return { name, directory, fingerprint: hash.digest('hex') };
+}
+/** Visible subdirectories: a folder being written beside the live one starts with a dot. */
+function subdirectories(directory) {
+    try {
+        return readdirSync(directory, { withFileTypes: true })
+            .filter((entry) => entry.isDirectory() && !entry.name.startsWith('.'))
+            .map((entry) => entry.name);
+    }
+    catch {
+        return [];
+    }
+}
+function filesUnder(directory) {
+    return readdirSync(directory, { withFileTypes: true, recursive: true })
+        .filter((entry) => entry.isFile())
+        .map((entry) => path.join(entry.parentPath, entry.name))
+        .sort();
+}
+function isPlugin(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        typeof value.name === 'string' &&
+        typeof value.register === 'function');
+}
+//# sourceMappingURL=folder.js.map

package/dist/plugins/folder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"folder.js","sourceRoot":"","sources":["../../src/plugins/folder.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;;;;;;;;;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAIhD,MAAM,CAAC,MAAM,YAAY,GAAG,UAAU,CAAC;AACvC,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAC;AA6B7C,iFAAiF;AACjF,MAAM,UAAU,iBAAiB,CAAC,UAA8B;IAC9D,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACxC,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,KAAK,MAAM,KAAK,IAAI,cAAc,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/C,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;YACxC,SAAS;QACX,CAAC;QACD,KAAK,MAAM,MAAM,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;YAClE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,KAAK,IAAI,MAAM,EAAE,CAAC,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAClF,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,mBAAmB,CACjC,MAA+B,EAC/B,OAAgC;IAEhC,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAC/E,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAC7E,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5F,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1F,MAAM,OAAO,GAAG,OAAO;SACpB,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,KAAK,CAAC,WAAW,CAAC;SACzF,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,KAAK,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,KAAK,CAAC;QACzD,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,OAAgC;IAEhC,MAAM,SAAS,GAAsB,EAAE,CAAC;IACxC,KAAK,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,OAAO,EAAE,CAAC;QAC1C,MAAM,MAAM,GAAG,uBAAuB,IAAI,EAAE,CAAC;QAC7C,IAAI,QAAoC,CAAC;QACzC,IAAI,CAAC;YACH,QAAQ,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;QAC3C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,SAAS,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACjF,SAAS;QACX,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC,SAAS,CAAC,CAAC;QAC7C,SAAS,CAAC,IAAI,CACZ,OAAO,MAAM,KAAK,QAAQ;YACxB,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE;YAC3E,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,QAAQ,EAAE,gBAAgB,EAAE,CAC7E,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAiB;IAClD,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC,EAAE,MAAM,CAAC,CAAC;IACrE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,IAAI,KAAc,CAAC;IACnB,IAAI,CAAC;QACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,OAAO,eAAe,eAAe,CAAC,CAAC;IACzD,CAAC;IACD,MAAM,QAAQ,GAAG,KAA8D,CAAC;IAChF,MAAM,KAAK,GAAG,QAAQ,EAAE,gBAAgB,CAAC;IACzC,IACE,OAAO,QAAQ,EAAE,IAAI,KAAK,QAAQ;QAClC,OAAO,QAAQ,CAAC,OAAO,KAAK,QAAQ;QACpC,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC;QACnC,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,KAAK,QAAQ,CAAC,EACjE,CAAC;QACD,MAAM,IAAI,KAAK,CACb,OAAO,eAAe,kEAAkE,CACzF,CAAC;IACJ,CAAC;IACD,OAAO,QAA0B,CAAC;AACpC,CAAC;AAED,0DAA0D;AAC1D,KAAK,UAAU,YAAY,CAAC,SAAiB;IAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;IACjD,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,aAAa,YAAY,GAAG,CAAC;IAC5D,IAAI,MAA6B,CAAC;IAClC,IAAI,CAAC;QACH,MAAM,GAAG,CAAC,MAAM,MAAM,kCAAC,aAAa,CAAC,KAAK,CAAC,CAAC,IAAI,EAAC,CAA0B,CAAC;IAC9E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,OAAO,YAAY,oBAAoB,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;IACnE,CAAC;IACD,OAAO,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC;QAC7B,CAAC,CAAC,MAAM,CAAC,OAAO;QAChB,CAAC,CAAC,OAAO,YAAY,kDAAkD,CAAC;AAC5E,CAAC;AAED,mEAAmE;AACnE,SAAS,WAAW,CAAC,IAAY,EAAE,OAAO,GAAG,EAAE;IAC7C,OAAO;QACL,IAAI;QACJ,OAAO;QACP,KAAK,EAAE,IAAI;QACX,WAAW,EAAE,EAAE;QACf,OAAO,EAAE,gBAAgB;QACzB,QAAQ,KAAI,CAAC;KACd,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,MAAM,CAAC,UAAkB,EAAE,IAAY;IAC9C,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5D,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAClC,KAAK,MAAM,IAAI,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QACzC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,CAAC;QAC5C,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAClB,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;QAChC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACpB,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AAC9D,CAAC;AAED,4FAA4F;AAC5F,SAAS,cAAc,CAAC,SAAiB;IACvC,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;aACnD,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;aACrE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,SAAiB;IACnC,OAAO,WAAW,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;SACpE,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;SACjC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;SACvD,IAAI,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,OAAQ,KAA4B,CAAC,IAAI,KAAK,QAAQ;QACtD,OAAQ,KAAgC,CAAC,QAAQ,KAAK,UAAU,CACjE,CAAC;AACJ,CAAC"}

package/dist/plugins/install.d.ts

@@ -0,0 +1,45 @@
+/**
+ * `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 type { PluginManifest } from './folder.ts';
+export declare const DEFAULT_REGISTRY = "https://registry.npmjs.org/";
+export interface PackageSpec {
+    name: string;
+    /** A version, a dist-tag or a range; `latest` when none was given. */
+    wanted: string;
+}
+/** `@scope/name@1.2.3`, `name@next` or a bare name. */
+export declare function parsePackageSpec(spec: string): PackageSpec;
+export interface AddedPlugin {
+    manifest: PluginManifest;
+    directory: string;
+    /** The version it replaced, when the folder held one. */
+    replaced: string | undefined;
+}
+/** Fetch, check and install one plugin package. Throws, leaving the folder alone, when it cannot. */
+export declare function addPlugin(spec: PackageSpec, options: {
+    pluginsDir: string;
+    registry: string;
+}): Promise<AddedPlugin>;
+/** Delete a plugin's folder. Throws when there is none. */
+export declare function removePlugin(name: string, pluginsDir: string): Promise<string>;
+/**
+ * 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 declare function requirementNotes(manifest: PluginManifest, installed: ReadonlyMap<string, string | undefined>, coreVersion: string): string[];
+/**
+ * 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 declare function unpackTarball(gzipped: Buffer): Map<string, Buffer>;
+/** Each plugin folder by name, with the version its `plugin.json` names, when it has a usable one. */
+export declare function installedFolders(pluginsDir: string): Map<string, string | undefined>;
+//# sourceMappingURL=install.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/plugins/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAYH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAGlD,eAAO,MAAM,gBAAgB,gCAAgC,CAAC;AAK9D,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,uDAAuD;AACvD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAU1D;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,cAAc,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B;AAED,qGAAqG;AACrG,wBAAsB,SAAS,CAC7B,IAAI,EAAE,WAAW,EACjB,OAAO,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAChD,OAAO,CAAC,WAAW,CAAC,CAuCtB;AAED,2DAA2D;AAC3D,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CASpF;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,cAAc,EACxB,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EAClD,WAAW,EAAE,MAAM,GAClB,MAAM,EAAE,CAuBV;AA0ED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CA6BlE;AAsDD,sGAAsG;AACtG,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAOpF"}