@geekity/cms 0.3.0

package/dist/cli.js

@@ -0,0 +1,424 @@
+#!/usr/bin/env node
+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 { existsSync, realpathSync } from 'node:fs';
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import { createInterface } from 'node:readline';
+import { Writable } from 'node:stream';
+import { pathToFileURL } from 'node:url';
+import { credentialProblem } from './admin/credentials.js';
+import { DuplicateUsernameError, openAdminStore } from './admin/store.js';
+import { resolveConfig } from './config.js';
+import { createCms } from './index.js';
+import { initSite, ownManifest } from './init.js';
+/** The commands a site can name on the command line, as opposed to the flags. */
+const COMMANDS = ['serve', 'init', 'sync', 'user'];
+const CONFIG_FILENAMES = ['geekity.config.ts', 'geekity.config.js', 'geekity.config.mjs'];
+const USAGE = `geekity — the Geekity CMS command line
+
+Usage:
+  geekity [serve] [--config <file>]
+  geekity init <directory>
+  geekity sync [--config <file>]
+  geekity user add <username> [--password <pw>] [--config <file>]
+
+Commands:
+  serve            Start the CMS (the default when no command is given).
+  init             Create a new site in <directory>.
+  sync             Rebuild the content index once and exit.
+  user add         Create an admin user, so a site can get its first login
+                   without the setup screen.
+
+Options:
+  --config <file>  Config file to load. Defaults to the first of
+                   ${CONFIG_FILENAMES.join(', ')} found in the working directory.
+  --password <pw>  The new user's password. Left off, it is asked for without
+                   echo, or read as one line when standard input is a pipe.
+                   A password on the command line is visible in the process
+                   list and in shell history, so prefer being asked.
+  -h, --help       Show this help.
+  -v, --version    Show the installed version.
+
+Environment overrides:
+  GEEKITY_PORT (or PORT), GEEKITY_CONTENT_DIR, GEEKITY_DATA_DIR,
+  GEEKITY_THEME_DIR, GEEKITY_BASE_URL, GEEKITY_WATCH
+`;
+/** Turn `process.argv.slice(2)` into a command, its options and its arguments. */
+export function parseArgs(argv) {
+    let command;
+    let configPath;
+    let password;
+    const args = [];
+    for (let i = 0; i < argv.length; i += 1) {
+        const arg = argv[i];
+        if (arg === '--help' || arg === '-h')
+            return { command: 'help', configPath, password, args };
+        if (arg === '--version' || arg === '-v') {
+            return { command: 'version', configPath, password, args };
+        }
+        if (arg === '--config') {
+            const value = argv[i + 1];
+            if (value === undefined || value.startsWith('-')) {
+                throw new Error('--config needs a file path, for example --config geekity.config.ts');
+            }
+            configPath = value;
+            i += 1;
+            continue;
+        }
+        if (arg.startsWith('--config=')) {
+            const value = arg.slice('--config='.length);
+            if (value === '') {
+                throw new Error('--config needs a file path, for example --config geekity.config.ts');
+            }
+            configPath = value;
+            continue;
+        }
+        // Unlike --config, the value after --password is taken as given: a
+        // password may legitimately start with a dash, and `--password=` with
+        // nothing after it is refused by the password rules, which say why.
+        if (arg === '--password') {
+            const value = argv[i + 1];
+            if (value === undefined) {
+                throw new Error('--password needs a value, or leave it off to be asked for one.');
+            }
+            password = value;
+            i += 1;
+            continue;
+        }
+        if (arg.startsWith('--password=')) {
+            password = arg.slice('--password='.length);
+            continue;
+        }
+        // The first bare word is the command; everything bare after it belongs to
+        // that command, so `geekity user add ada` reaches `user` with `add ada`.
+        if (command === undefined) {
+            if (!isCommand(arg)) {
+                throw new Error(`Unknown command "${arg}". Run geekity --help to see what is available.`);
+            }
+            command = arg;
+            continue;
+        }
+        args.push(arg);
+    }
+    return { command: command ?? 'serve', configPath, password, args };
+}
+function isCommand(value) {
+    return COMMANDS.includes(value);
+}
+/** Extensions that need TypeScript support in the loader. */
+const TYPESCRIPT_EXTENSIONS = new Set(['.ts', '.mts', '.cts']);
+/**
+ * Load a config module, returning `{}` when the site has no config file.
+ *
+ * A TypeScript config is imported directly first. That is all it takes on Node
+ * 24, which strips types without a flag, and inside this repository, where
+ * the CLI already runs under tsx. A Node started with stripping disabled — and
+ * any file carrying TypeScript syntax that stripping cannot erase — falls back to
+ * registering tsx from the *site's* own dependencies, which is where a site
+ * scaffolded by `geekity init` has it. A site with neither writes
+ * `geekity.config.js` instead; it is in the candidate list for exactly that.
+ */
+export async function loadConfig(cwd, configPath) {
+    const candidates = configPath === undefined
+        ? CONFIG_FILENAMES.map((name) => path.resolve(cwd, name))
+        : [path.resolve(cwd, configPath)];
+    for (const candidate of candidates) {
+        const href = pathToFileURL(candidate).href;
+        let module;
+        try {
+            module = (await import(__rewriteRelativeImportExtension(href)));
+        }
+        catch (error) {
+            if (isModuleNotFound(error, candidate))
+                continue;
+            if (!needsTypeScriptLoader(error, candidate))
+                throw error;
+            await registerTypeScriptLoader(cwd, candidate);
+            module = (await import(__rewriteRelativeImportExtension(href)));
+        }
+        return module.default ?? {};
+    }
+    if (configPath !== undefined) {
+        throw new Error(`Config file not found: ${path.resolve(cwd, configPath)}`);
+    }
+    return {};
+}
+/**
+ * The site's own tsx, as the directory the package was installed into, or
+ * `undefined` when the site does not have one.
+ *
+ * Node's resolver is deliberately not asked: this has to be the tsx the *site*
+ * installed, and a resolver anchored anywhere else — or patched by a tsx that
+ * is already loaded, which is what happens inside this repository — would
+ * happily answer with somebody else's copy.
+ */
+export function findSiteTsx(cwd) {
+    let directory = path.resolve(cwd);
+    for (;;) {
+        const candidate = path.join(directory, 'node_modules', 'tsx');
+        if (existsSync(path.join(candidate, 'package.json')))
+            return candidate;
+        const parent = path.dirname(directory);
+        if (parent === directory)
+            return undefined;
+        directory = parent;
+    }
+}
+/**
+ * Teach this process to import TypeScript, using the tsx installed alongside
+ * the site.
+ *
+ * tsx is the site's rather than this package's because the CMS does not depend
+ * on it at runtime: a site that runs `server.ts` already has it, and a site
+ * that does not want it writes its config in JavaScript instead.
+ */
+export async function registerTypeScriptLoader(cwd, configFile) {
+    const tsx = findSiteTsx(cwd);
+    if (tsx === undefined) {
+        throw new Error(`Could not load ${configFile}: this Node cannot import TypeScript on its own and tsx is ` +
+            'not installed in this site. Either add it (pnpm add -D tsx), or write the config as ' +
+            'geekity.config.js instead.');
+    }
+    const fromTsx = createRequire(path.join(tsx, 'package.json'));
+    const api = (await import(__rewriteRelativeImportExtension(pathToFileURL(fromTsx.resolve('tsx/esm/api')).href)));
+    api.register();
+}
+/**
+ * Whether an import failed because the loader could not handle TypeScript.
+ *
+ * `ERR_UNKNOWN_FILE_EXTENSION` is Node before type stripping was on by
+ * default; `ERR_UNSUPPORTED_TYPESCRIPT_SYNTAX` is a file using `enum` or
+ * `namespace`, which stripping refuses because erasing it is not enough.
+ */
+function needsTypeScriptLoader(error, candidate) {
+    if (!TYPESCRIPT_EXTENSIONS.has(path.extname(candidate).toLowerCase()))
+        return false;
+    const code = error?.code;
+    return code === 'ERR_UNKNOWN_FILE_EXTENSION' || code === 'ERR_UNSUPPORTED_TYPESCRIPT_SYNTAX';
+}
+function isModuleNotFound(error, candidate) {
+    return (typeof error === 'object' &&
+        error !== null &&
+        'code' in error &&
+        error.code === 'ERR_MODULE_NOT_FOUND' &&
+        String(error.message ?? '').includes(candidate));
+}
+/** Run one command. Resolves with the exit code the process should use. */
+async function main(argv) {
+    const { command, configPath, password, args } = parseArgs(argv);
+    if (command === 'help') {
+        process.stdout.write(USAGE);
+        return 0;
+    }
+    if (command === 'version') {
+        process.stdout.write(`${ownManifest().version}\n`);
+        return 0;
+    }
+    if (command === 'init')
+        return init(args);
+    if (command === 'user')
+        return userCommand(args, configPath, password);
+    if (command === 'sync')
+        return syncCommand(configPath);
+    return serveCommand(configPath);
+}
+/** `geekity init <directory>`: scaffold a new site. */
+async function init(args) {
+    const directory = args[0];
+    if (directory === undefined) {
+        throw new Error('geekity init <directory> needs the directory to create.');
+    }
+    const site = await initSite({ directory, cwd: process.cwd() });
+    const relative = path.relative(process.cwd(), site.directory) || '.';
+    process.stdout.write([
+        `Created ${site.directory}`,
+        '',
+        'Next:',
+        `  cd ${relative}`,
+        '  pnpm install',
+        '  pnpm dev',
+        '',
+    ].join('\n'));
+    return 0;
+}
+/**
+ * `geekity sync`: bring the index into line with the files once and stop.
+ *
+ * Watching is forced off whatever the config says, because a one-shot scan
+ * that then sat in a watcher would never exit.
+ */
+async function syncCommand(configPath) {
+    const config = await loadConfig(process.cwd(), configPath);
+    const cms = createCms({ ...config, watch: false });
+    try {
+        const result = await cms.sync();
+        process.stdout.write(`Scanned ${String(result.scanned)}: ${String(result.created)} created, ` +
+            `${String(result.updated)} updated, ${String(result.removed)} removed, ` +
+            `${String(result.unchanged)} unchanged, ${String(result.failed)} failed\n`);
+        if (result.failed > 0) {
+            process.stderr.write(`${String(result.failed)} file${result.failed === 1 ? '' : 's'} could not be parsed and ` +
+                `${result.failed === 1 ? 'was' : 'were'} left out of the index; the warnings above name ` +
+                `${result.failed === 1 ? 'it' : 'them'}.\n`);
+            return 1;
+        }
+        return 0;
+    }
+    finally {
+        await cms.close();
+    }
+}
+/** `geekity serve`: the default. Runs until it is signalled. */
+async function serveCommand(configPath) {
+    const cms = createCms(await loadConfig(process.cwd(), configPath));
+    const { port } = await cms.serve();
+    process.stdout.write(`Geekity is serving ${cms.config.baseUrl} on port ${String(port)}\n`);
+    for (const signal of ['SIGINT', 'SIGTERM']) {
+        process.once(signal, () => {
+            void cms.close().then(() => process.exit(0));
+        });
+    }
+    return 0;
+}
+/**
+ * `geekity user add <username>`: create an admin without the setup screen.
+ *
+ * The other door into the users table is the first-run setup form, and this
+ * one has to leave the same thing behind it, so both go through
+ * {@link credentialProblem} rather than each carrying its own idea of a legal
+ * username. The store is opened against the config's `dataDir`, which is the
+ * same file the server will read, and it is closed whatever happens.
+ */
+async function userCommand(args, configPath, flagPassword) {
+    const subcommand = args[0];
+    if (subcommand === undefined) {
+        throw new Error('geekity user add <username> needs a subcommand. The only one is: add.');
+    }
+    if (subcommand !== 'add') {
+        throw new Error(`Unknown user subcommand "${subcommand}". The only one is: add.`);
+    }
+    const username = args[1];
+    if (username === undefined) {
+        throw new Error('geekity user add <username> needs the name of the user to create.');
+    }
+    const password = flagPassword ?? (await readPassword({ prompt: `Password for ${username}: ` }));
+    const problem = credentialProblem(username, password);
+    if (problem !== undefined) {
+        process.stderr.write(`${problem}\n`);
+        return 1;
+    }
+    const config = resolveConfig(await loadConfig(process.cwd(), configPath));
+    const admin = openAdminStore({ dataDir: config.dataDir });
+    try {
+        const user = admin.createUser({ username, password });
+        process.stdout.write(`Created admin user ${user.username}. Sign in at ${LOGIN_URL}.\n`);
+        return 0;
+    }
+    catch (error) {
+        if (error instanceof DuplicateUsernameError) {
+            process.stderr.write(`${error.message} Pick another name, or change that user's password from the admin.\n`);
+            return 1;
+        }
+        throw error;
+    }
+    finally {
+        admin.close();
+    }
+}
+/** Where the success line points a new admin. Relative, because the host is the site's. */
+const LOGIN_URL = '/admin/login';
+/**
+ * Ask for a password once, without putting it on the screen.
+ *
+ * Two things would otherwise echo it, and both are turned off: the terminal
+ * driver, silenced by putting the input into raw mode, and readline, whose
+ * output goes to a writable that keeps nothing. Readline happens to set raw
+ * mode itself, but it is set here as well rather than relied on: the day that
+ * changes, a password would be printed. Raw mode also means readline sees
+ * Ctrl-C as a byte rather than a signal, so it is turned back into a
+ * cancellation here.
+ *
+ * Off a terminal — a pipe, a heredoc, a CI job — nothing is printed and the
+ * first line is the password, which is what makes
+ * `printf '%s\n' "$PW" | geekity user add ada` work.
+ */
+export async function readPassword(options = {}) {
+    const input = options.input ?? process.stdin;
+    const output = options.output ?? process.stderr;
+    const terminal = input.isTTY === true;
+    if (terminal && options.prompt !== undefined)
+        output.write(options.prompt);
+    const wasRaw = input.isRaw === true;
+    if (terminal)
+        input.setRawMode?.(true);
+    const muted = new Writable({
+        write(_chunk, _encoding, callback) {
+            callback();
+        },
+    });
+    const reader = createInterface({ input, output: muted, terminal });
+    let cancelled = false;
+    reader.on('SIGINT', () => {
+        cancelled = true;
+        reader.close();
+    });
+    try {
+        for await (const line of reader) {
+            if (!cancelled)
+                return line;
+            break;
+        }
+    }
+    finally {
+        reader.close();
+        if (terminal) {
+            input.setRawMode?.(wasRaw);
+            // The terminal is left on the line the swallowed newline never printed.
+            output.write('\n');
+        }
+        input.pause();
+    }
+    if (cancelled)
+        throw new Error('Cancelled; no user was created.');
+    throw new Error('No password was given: standard input ended before a line arrived. Pass --password, or ' +
+        'pipe the password in as a single line.');
+}
+/**
+ * True when this module is the process entry point.
+ *
+ * The entry path is realpath'd first: package managers link a bin through
+ * `node_modules/.bin`, so `process.argv[1]` reaches this file through a symlink
+ * while `import.meta.url` is already resolved.
+ */
+function isEntryPoint() {
+    const entry = process.argv[1];
+    if (entry === undefined)
+        return false;
+    try {
+        return import.meta.url === pathToFileURL(realpathSync(entry)).href;
+    }
+    catch {
+        return false;
+    }
+}
+if (isEntryPoint()) {
+    main(process.argv.slice(2))
+        .then((code) => {
+        // `serve` resolves with 0 while the server is still listening; exiting
+        // here would kill it, so only a command that finished sets the code and
+        // lets the event loop empty on its own.
+        if (code !== 0)
+            process.exitCode = code;
+    })
+        .catch((error) => {
+        process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,172 @@
+import type { KvStore, MessageQueue } from '@fedify/fedify';
+import type { DocumentChange } from './content/sync.ts';
+/**
+ * Something a site wants to happen when the index changes.
+ *
+ * Whatever a hook returns is ignored, which is what the `unknown` return says:
+ * `void` would have a linter reject an `async` hook, and `void | Promise<void>`
+ * would have the compiler reject a one-expression hook like
+ * `(change) => queue.push(change)`. A hook may therefore be `async`, and a
+ * promise that rejects is caught and reported rather than left unhandled. The
+ * CMS never waits for a hook, so a slow or broken subscriber can neither delay
+ * nor wedge the watcher.
+ */
+export type DocumentChangeHook = (change: DocumentChange) => unknown;
+/**
+ * The federation stores and guards a site may swap, which decision-5 promised
+ * would be configuration rather than a redesign.
+ *
+ * Everything here has a default that is right for a single-process personal
+ * blog; a site only names one when it has outgrown that, and a test names one
+ * when it needs the federation to behave predictably.
+ */
+export interface FederationOverrides {
+    /**
+     * Fedify's cache and idempotence store. Defaults to an in-memory one, per
+     * decision-5: nothing that has to survive a restart lives in it.
+     */
+    kv?: KvStore | undefined;
+    /**
+     * The delivery and inbox queue. Defaults to Fedify's in-process one.
+     *
+     * `null` means no queue at all: an inbound activity is handled, and an
+     * outbound one delivered, before the request that carried it is answered.
+     * That is slower under load and has no retry, which is why it is not the
+     * default, but it is the only way to know from outside when the work is
+     * done — so it is what a test asks for.
+     */
+    queue?: MessageQueue | null | undefined;
+    /**
+     * Whether Fedify's document loader may fetch private and loopback
+     * addresses. Off, as it must be in production: turning it on removes the
+     * guard that stops a hostile actor id from making the server fetch its own
+     * network. Tests that federate two make-believe hosts turn it on.
+     */
+    allowPrivateAddress?: boolean | undefined;
+}
+/**
+ * What a site writes in `geekity.config.ts`. Every field is optional; see
+ * {@link DEFAULT_PORT} and friends for what each one falls back to.
+ */
+export interface GeekityConfig {
+    /** Port the HTTP server listens on. Default 3000. Overridden by `GEEKITY_PORT`, then `PORT`. */
+    port?: number;
+    /** Markdown content directory. Default `<cwd>/content`. Overridden by `GEEKITY_CONTENT_DIR`. */
+    contentDir?: string;
+    /** Directory for derived state such as the SQLite index. Default `<cwd>/data`. Overridden by `GEEKITY_DATA_DIR`. */
+    dataDir?: string;
+    /** Site template overrides, resolved before the packaged default theme. Default `<cwd>/theme`. Overridden by `GEEKITY_THEME_DIR`. */
+    themeDir?: string;
+    /** Public origin, used for canonical URLs, feeds and ActivityPub ids. Default `http://localhost:<port>`. Overridden by `GEEKITY_BASE_URL`. */
+    baseUrl?: string;
+    /**
+     * Watch the content directory and keep the index in step with it while the
+     * server runs. Default `true`. Turn it off for a one-shot sync or a host
+     * whose content cannot change under the process. Overridden by `GEEKITY_WATCH`.
+     */
+    watch?: boolean;
+    /**
+     * How long an admin login lasts, in seconds. Default 14 days. Overridden by
+     * `GEEKITY_SESSION_LIFETIME`. The clock starts when the session is created,
+     * and an expired session is deleted rather than merely ignored.
+     */
+    sessionLifetime?: number;
+    /**
+     * Largest file the editor's upload endpoint accepts, in bytes. Default 10
+     * MiB. Overridden by `GEEKITY_UPLOAD_MAX_BYTES`.
+     */
+    uploadMaxBytes?: number;
+    /**
+     * File extensions the upload endpoint accepts, with or without the leading
+     * dot and in any case. Default: PNG, JPEG, GIF, WebP, AVIF, PDF, plain text
+     * and Markdown. Overridden by `GEEKITY_UPLOAD_TYPES`, a comma-separated
+     * list. Every entry has to be one the CMS knows a media type for; see
+     * `KNOWN_UPLOAD_TYPES`.
+     */
+    uploadTypes?: string[];
+    /**
+     * Called for every `created`, `updated` and `deleted` the index records.
+     *
+     * The boot scan reports a cold index as a directory full of creations, so a
+     * hook that must not re-fire on a rebuilt index should check
+     * `change.origin !== 'scan'`.
+     */
+    onDocumentChange?: DocumentChangeHook;
+    /**
+     * Called when a document becomes visible on the public site: created live, a
+     * draft published, or a document restored from the trash. Subject to the
+     * same `origin` caveat as {@link GeekityConfig.onDocumentChange}.
+     */
+    onPublish?: DocumentChangeHook;
+    /**
+     * Federation stores and guards. Every field has a default; see
+     * {@link FederationOverrides}.
+     */
+    federation?: FederationOverrides;
+}
+/**
+ * A {@link GeekityConfig} with every field filled in and every path absolute.
+ *
+ * The two hooks are the exception to "filled in": they have no default, so
+ * they are present and `undefined` when the site named neither.
+ */
+export interface ResolvedConfig {
+    port: number;
+    contentDir: string;
+    dataDir: string;
+    themeDir: string;
+    baseUrl: string;
+    /**
+     * Where {@link ResolvedConfig.baseUrl} came from.
+     *
+     * `default` means nobody named one and it is the `http://localhost:<port>`
+     * fallback, which is what lets the admin's settings screen offer a base URL
+     * of its own: an `environment` or `config` value is a deployment fact and
+     * wins over anything stored in SQLite.
+     */
+    baseUrlSource: 'environment' | 'config' | 'default';
+    watch: boolean;
+    sessionLifetime: number;
+    uploadMaxBytes: number;
+    /** Normalised: lower case, each with its leading dot. */
+    uploadTypes: string[];
+    onDocumentChange: DocumentChangeHook | undefined;
+    onPublish: DocumentChangeHook | undefined;
+    /** Federation stores and guards, empty when the site named none. */
+    federation: FederationOverrides;
+}
+/** Ambient inputs {@link resolveConfig} reads, injectable so the resolution is testable. */
+export interface ResolveConfigContext {
+    /** Directory relative paths resolve against. Defaults to `process.cwd()`. */
+    cwd?: string;
+    /** Environment to read overrides from. Defaults to `process.env`. */
+    env?: Record<string, string | undefined>;
+}
+export declare const DEFAULT_PORT = 3000;
+export declare const DEFAULT_CONTENT_DIR = "content";
+export declare const DEFAULT_DATA_DIR = "data";
+export declare const DEFAULT_THEME_DIR = "theme";
+/** How long an admin login lasts by default: fourteen days, in seconds. */
+export declare const DEFAULT_SESSION_LIFETIME: number;
+/** Largest upload a site accepts by default: ten mebibytes. */
+export declare const DEFAULT_UPLOAD_MAX_BYTES: number;
+/**
+ * What the editor may upload by default: the raster image formats a browser
+ * displays, PDFs, and the two text formats. Everything the CMS knows about
+ * except SVG, which is script-bearing markup served from the site's own origin
+ * and so is opt-in.
+ */
+export declare const DEFAULT_UPLOAD_TYPES: readonly string[];
+/**
+ * Identity helper that gives a `geekity.config.ts` file type checking and
+ * completion without the site importing the type by hand.
+ */
+export declare function defineConfig(config: GeekityConfig): GeekityConfig;
+/**
+ * Merge a site's config with environment overrides and defaults.
+ *
+ * Precedence is environment variable, then config file, then default. Relative
+ * directories resolve against `cwd`; absolute ones are left alone.
+ */
+export declare function resolveConfig(config?: GeekityConfig, context?: ResolveConfigContext): ResolvedConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

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