@geekity/cms 0.24.0 → 0.26.0

package/dist/plugin.d.ts

@@ -0,0 +1,524 @@
+/**
+ * `@geekity/cms/plugin`: the whole of what a plugin may import from core
+ * (decision-33). Types, the host API version and {@link definePlugin}, which is
+ * an identity function so a bundled plugin needs no runtime import of core.
+ *
+ * Removing or reshaping anything here is a breaking change to `@geekity/cms`
+ * (decision-6), and bumps {@link HOST_API_VERSION}.
+ */
+import type { webcrypto } from 'node:crypto';
+import type { KvStore } from '@fedify/fedify';
+/**
+ * The version of the host API this core provides. A plugin names the version
+ * it targets in {@link Plugin.hostApi}, and one that targets a newer version
+ * than this is unavailable.
+ */
+export declare const HOST_API_VERSION = 1;
+/**
+ * The site federation's key-value store, as Fedify defines it. A plugin that
+ * runs a federation of its own hands it this store, so the two agree about
+ * which activities they have already handled.
+ */
+export type { KvStore };
+/** What a plugin's route handler is handed. */
+export interface PluginRequestContext {
+    /** The request as it arrived. */
+    readonly request: Request;
+    /** The named parameters of the route's path, such as `:slug`. */
+    readonly params: Readonly<Record<string, string>>;
+}
+/** Answers one request to a plugin's route. */
+export type PluginRouteHandler = (context: PluginRequestContext) => Response | Promise<Response>;
+/**
+ * A JSON-LD document as plain data. Documents cross the host boundary this way
+ * rather than as objects built by a library, because a bundled plugin carries
+ * its own copy of every library and an `instanceof` across two copies fails.
+ */
+export type JsonLdDocument = Readonly<Record<string, unknown>>;
+/** One account on the site. */
+export interface PluginUser {
+    readonly username: string;
+    /** The ActivityStreams id this person was published under elsewhere, if any. */
+    readonly actorId?: string | undefined;
+}
+/** A follower, as a user's `followers.json` holds one. */
+export interface PluginFollower {
+    readonly actorId: string;
+    readonly inboxId: string;
+    readonly sharedInboxId: string | null;
+    /** `@name@host`, or `null`. */
+    readonly handle: string | null;
+    readonly name: string | null;
+    readonly iconUrl: string | null;
+    readonly url: string | null;
+}
+/** The algorithms an actor holds a key pair for. */
+export type PluginKeyAlgorithm = 'RSASSA-PKCS1-v1_5' | 'Ed25519';
+/** One of a user's key files. */
+export interface PluginActorKey {
+    /** The file, absolute. */
+    readonly file: string;
+    /** The private JWK it holds, or `undefined` when there is no file yet. */
+    readonly jwk: string | undefined;
+}
+/** The site's accounts, keys and followers, as a plugin may read and change them. */
+export interface PluginSite {
+    readonly baseUrl: string;
+    /** Every account, in the users file's order. */
+    users(): readonly PluginUser[];
+    /**
+     * Set the id a user was published under elsewhere. Returns whether anything
+     * changed. Throws for a user the site does not have, or an id another user
+     * already carries.
+     */
+    setActorId(username: string, actorId: string): Promise<boolean>;
+    actorKey(username: string, algorithm: PluginKeyAlgorithm): PluginActorKey;
+    /** Write a private JWK as the user's key for one algorithm. */
+    writeActorKey(username: string, algorithm: PluginKeyAlgorithm, jwk: string): void;
+    /**
+     * Load every key pair the user signs with, minting any that is missing.
+     * Throws when a key file does not import.
+     */
+    loadActorKeys(username: string): Promise<void>;
+    followers(username: string): readonly PluginFollower[];
+    /** Add a follower, or refresh the one already held. */
+    addFollower(username: string, follower: PluginFollower): Promise<void>;
+}
+/** The plugin's private folder, `data/plugins/<package name>/`. */
+export interface PluginDataFolder {
+    /** The folder, absolute. */
+    readonly path: string;
+    /** A file's text, or `undefined` when it is not there. */
+    read(file: string): string | undefined;
+    /**
+     * Read a file, decide what it says next and write it, as one step nothing
+     * else writing that file can get between. The write is atomic.
+     */
+    update(file: string, change: (current: string | undefined) => string): Promise<void>;
+}
+/** One page of a collection the site's federation publishes. */
+export interface PluginCollectionPage<Item> {
+    readonly items: readonly Item[];
+    readonly nextCursor: string | null;
+    readonly prevCursor: string | null;
+}
+/** A collection the site's federation publishes, paged by offset cursors. */
+export interface PluginCollection<Item> {
+    readonly totalItems: number;
+    readonly firstCursor: string;
+    readonly lastCursor: string;
+    /** One page; a `null` cursor is every item at once. */
+    page(cursor: string | null): Promise<PluginCollectionPage<Item>>;
+}
+/** A follower as a delivery reaches them. */
+export interface PluginRecipient {
+    readonly id: string;
+    readonly inboxId: string;
+    readonly sharedInboxId: string | null;
+}
+/** What a federation middleware is handed for one request. */
+export interface PluginFederationContext {
+    readonly request: Request;
+    readonly site: PluginSite;
+    /** The site federation's store, for idempotence shared with its inboxes. */
+    readonly kv: KvStore;
+    /** Whether the site's federation may fetch from private addresses. */
+    readonly allowPrivateAddress: boolean;
+    /** The site's clock. */
+    now(): Date;
+    /** A user's actor document, exactly as the site's federation serves it. */
+    actor(username: string): Promise<JsonLdDocument | undefined>;
+    /**
+     * The key pairs a user signs with, as WebCrypto keys, which belong to no
+     * library. Empty for a user the site does not have.
+     */
+    keyPairs(username: string): Promise<webcrypto.CryptoKeyPair[]>;
+    /**
+     * A user's outbox, the activities announcing their posts, or `undefined`
+     * for a user the site does not have.
+     */
+    outbox(username: string): PluginCollection<JsonLdDocument> | undefined;
+    /** A user's followers, or `undefined` for a user the site does not have. */
+    followers(username: string): PluginCollection<PluginRecipient> | undefined;
+    /**
+     * Handle an activity a plugin's inbox verified, as the site's own inbox
+     * handles it. `recipient` is the username of the personal inbox it arrived
+     * at, or `null` for a shared inbox.
+     */
+    receive(activity: JsonLdDocument, recipient: string | null): Promise<void>;
+}
+/**
+ * Answers a request in the federation mount, or hands it on with `next`, which
+ * resolves to what the rest of the site answers.
+ */
+export type PluginFederationMiddleware = (context: PluginFederationContext, next: () => Promise<Response>) => Promise<Response>;
+/** Text on a plugin screen: plain, or set as code. */
+export type PluginScreenText = string | {
+    readonly code: string;
+};
+/** A table cell: text, or an instant drawn as a date, `null` for never. */
+export type PluginScreenCell = PluginScreenText | {
+    readonly time: string | null;
+};
+/** One block of a plugin screen's card. */
+export type PluginScreenBlock = {
+    readonly paragraph: readonly PluginScreenText[];
+} | {
+    readonly table: {
+        readonly caption: string;
+        readonly columns: readonly string[];
+        readonly rows: readonly (readonly PluginScreenCell[])[];
+    };
+};
+/** One card on a plugin screen. */
+export interface PluginScreenCard {
+    readonly title: string;
+    readonly blocks: readonly PluginScreenBlock[];
+}
+/** What a plugin screen's render and its actions are handed. */
+export interface PluginScreenContext {
+    readonly site: PluginSite;
+}
+/** What an action reports, which the screen shows as a notice or an error. */
+export interface PluginScreenOutcome {
+    readonly ok: boolean;
+    /** Plain words. Core shows them escaped. */
+    readonly message: string;
+}
+/** A button on a plugin's screen, such as Test connection. */
+export interface PluginScreenAction {
+    /** Lower case words joined by `-`, unique on the screen. */
+    readonly id: string;
+    readonly label: string;
+    run(context: PluginScreenContext): PluginScreenOutcome | Promise<PluginScreenOutcome>;
+}
+/**
+ * A screen under Plugins in the admin, listed in the menu while the plugin is
+ * active. Core draws it, so a plugin writes no markup.
+ */
+export interface PluginScreen {
+    /** Its heading and its label in the menu. */
+    readonly title: string;
+    render(context: PluginScreenContext): readonly PluginScreenCard[];
+    /** Buttons core draws under the settings, each run when pressed. */
+    readonly actions?: readonly PluginScreenAction[] | undefined;
+}
+/** What every settings field has. */
+interface PluginSettingBase {
+    /**
+     * Lower case words joined by `_`, such as `api_key`. It is the key in
+     * `site.json` or `secrets.json`, and upper-cased it ends the field's
+     * environment variable.
+     */
+    readonly key: string;
+    readonly label: string;
+    /** A sentence under the box. */
+    readonly hint?: string | undefined;
+}
+/** A line of text. An empty box stores nothing, so the default applies. */
+export interface PluginTextSetting extends PluginSettingBase {
+    readonly type: 'text';
+    readonly default?: string | undefined;
+}
+/** An absolute `http:` or `https:` URL. */
+export interface PluginUrlSetting extends PluginSettingBase {
+    readonly type: 'url';
+    readonly default?: string | undefined;
+}
+/** One of a fixed list. */
+export interface PluginSelectSetting extends PluginSettingBase {
+    readonly type: 'select';
+    readonly options: readonly {
+        readonly value: string;
+        readonly label: string;
+    }[];
+    readonly default: string;
+}
+/** On or off, off unless a default says otherwise. */
+export interface PluginCheckboxSetting extends PluginSettingBase {
+    readonly type: 'checkbox';
+    readonly default?: boolean | undefined;
+}
+/**
+ * A credential. It is kept in `secrets.json` in the plugin's data folder at
+ * mode 0600, or set by an environment variable, and is never drawn on a page.
+ */
+export interface PluginSecretSetting extends PluginSettingBase {
+    readonly type: 'secret';
+}
+/** One field of a plugin's settings form. */
+export type PluginSettingField = PluginTextSetting | PluginUrlSetting | PluginSelectSetting | PluginCheckboxSetting | PluginSecretSetting;
+/** What one field hands the plugin: a secret may be unset, the rest always have a value. */
+export type PluginSettingValue<Field extends PluginSettingField> = Field extends PluginCheckboxSetting ? boolean : Field extends PluginSecretSetting ? string | undefined : Field extends PluginSelectSetting ? Field['options'][number]['value'] : string;
+/** Every field's value, keyed by its key. */
+export type PluginSettingValues<Fields extends readonly PluginSettingField[]> = {
+    readonly [Field in Fields[number] as Field['key']]: PluginSettingValue<Field>;
+};
+/** A plugin's settings, as {@link PluginHost.settings} hands them back. */
+export interface PluginSettings<Fields extends readonly PluginSettingField[]> {
+    /**
+     * The values now, read from the files and the environment on every call. A
+     * stored value the field does not accept is replaced by the field's default.
+     */
+    current(): PluginSettingValues<Fields>;
+}
+/** One option a command takes. */
+export interface PluginCommandOption {
+    /** Its name without the dashes. */
+    readonly name: string;
+    /** What its value is called in the help, or absent for an on-off switch. */
+    readonly value?: string | undefined;
+    readonly description: string;
+}
+/** What a command's run is handed. */
+export interface PluginCommandContext {
+    /** The arguments after the command's words. */
+    readonly args: readonly string[];
+    /** Each option given: the text after it, or `true` for a switch. */
+    readonly options: Readonly<Record<string, string | true>>;
+    /** The directory the command was run from. */
+    readonly cwd: string;
+    readonly site: PluginSite;
+    /** Write to standard output. */
+    write(text: string): void;
+}
+/** A command on the `geekity` command line. */
+export interface PluginCommand {
+    /** The words that name it, such as `['import', 'old-blog']`. */
+    readonly words: readonly string[];
+    /** What follows the words in the usage line, such as `<username> --id <n>`. */
+    readonly usage: string;
+    /** What `geekity --help` says it does. */
+    readonly summary: string;
+    /** Every option it takes; any other is refused. */
+    readonly options?: readonly PluginCommandOption[] | undefined;
+    /** Run it and answer the exit code. A thrown error is printed and exits 1. */
+    run(context: PluginCommandContext): number | Promise<number>;
+}
+/**
+ * The service each plugin provides, keyed by its package name. Empty here: a
+ * plugin package that provides one adds its entry by declaration merging, and
+ * a consumer that imports the package's types sees it.
+ *
+ * ```ts
+ * declare module '@geekity/cms/plugin' {
+ *   interface PluginServices {
+ *     '@acme/plugin-clock': Clock;
+ *   }
+ * }
+ * ```
+ */
+export interface PluginServices {
+}
+/** The service a package provides, as {@link PluginServices} says, or `unknown` when it says nothing. */
+export type PluginService<Name extends string> = Name extends keyof PluginServices ? PluginServices[Name] : unknown;
+/** A field of the post and page editor that a plugin's button can sit beside. */
+export type PluginEditorField = 'title' | 'description' | 'tags';
+/**
+ * What kind of post a draft is, by Post Type Discovery over what the editor
+ * holds: a post with a `like-of` is a `like`, one with photos a `photo`, an
+ * untitled one a `note` and a titled one an `article`.
+ */
+export type PluginPostType = 'event' | 'rsvp' | 'repost' | 'like' | 'reply' | 'photo' | 'read' | 'bookmark' | 'note' | 'article';
+/** The document in the editor as it stands when a button is pressed, saved or not. */
+export interface PluginEditorDraft {
+    readonly type: 'post' | 'page';
+    /** A post's kind, or `undefined` for a page. */
+    readonly postType: PluginPostType | undefined;
+    /** Whether the document is on disk, rather than new in the editor. */
+    readonly saved: boolean;
+    readonly title: string;
+    /** The Markdown body. */
+    readonly body: string;
+    readonly description: string;
+    readonly tags: readonly string[];
+    /** The language it is written in: its own `lang`, else the site's. */
+    readonly lang: string;
+}
+/** What a press of an editor button hands its plugin. */
+export interface PluginEditorContext {
+    readonly draft: PluginEditorDraft;
+    /** Every tag on the site's published documents, as written, most used first. */
+    readonly siteTags: readonly string[];
+    /**
+     * The titles of the site's latest published posts that have one, newest
+     * first, at most ten, leaving out any the draft's own title repeats.
+     */
+    readonly recentTitles: readonly string[];
+    /** Aborts when the author leaves the page before the answer comes. */
+    readonly signal: AbortSignal;
+}
+/** One of several values an editor button offers, each drawn with a box to tick. */
+export interface PluginEditorChoice {
+    readonly value: string;
+    /** A few words after it, such as `120 followers`. */
+    readonly note?: string | undefined;
+    /** A word or two drawn as a badge, such as `Used here`. */
+    readonly badge?: string | undefined;
+    /**
+     * The heading the choice is listed under, such as `For reach`. The editor
+     * draws the heading before a choice whose group differs from the one before
+     * it, so a plugin lists each group's choices together.
+     */
+    readonly group?: string | undefined;
+}
+/**
+ * What an editor button answers: a value the author may accept into the
+ * field, choices the author ticks before accepting, or why there is none, in
+ * plain words. Core shows each escaped. Choices are for the tags field, and
+ * accepting adds every ticked one; beside another field they are a failure.
+ */
+export type PluginEditorSuggestion = {
+    readonly ok: true;
+    readonly value: string;
+} | {
+    readonly ok: true;
+    readonly choices: readonly PluginEditorChoice[];
+} | {
+    readonly ok: false;
+    readonly message: string;
+};
+/**
+ * A button beside an editor field. Core draws it, posts the draft to the
+ * plugin when it is pressed, and shows the suggestion with Accept and
+ * Dismiss. Accepting fills the field and saves nothing; nothing is sent
+ * unless the author presses the button. Without JavaScript there is no
+ * button.
+ */
+export interface PluginEditorAction {
+    /** Lower case words joined by `-`, unique among the plugin's editor actions. */
+    readonly id: string;
+    readonly field: PluginEditorField;
+    /** The button's words, such as `Suggest title`. */
+    readonly label: string;
+    /**
+     * Whether the button is offered for this draft. Asked when the editor opens
+     * and again when the button is pressed. Absent offers it always.
+     */
+    offers?(draft: PluginEditorDraft): boolean;
+    suggest(context: PluginEditorContext): PluginEditorSuggestion | Promise<PluginEditorSuggestion>;
+}
+/** What a plugin's {@link PluginHost.fetch} sends besides the URL. */
+export interface PluginFetchInit {
+    readonly headers?: Readonly<Record<string, string>> | undefined;
+    /** Ends the request, and any redirect it leads to, when it aborts. */
+    readonly signal?: AbortSignal | undefined;
+}
+/** What a plugin knows of the site it runs on. */
+export interface PluginSiteInfo {
+    /** The site's public URL. */
+    readonly baseUrl: string;
+    /** The site title, as the site's settings have it now. */
+    readonly title: string;
+}
+/**
+ * A plugin's only door into the CMS, handed to {@link Plugin.register}. It
+ * reaches no other plugin during `register`: registration order never
+ * matters. Everything is declared during `register`; a declaration after it
+ * returns throws.
+ */
+export interface PluginHost<Name extends string = string, Requires extends PluginRequirements = PluginRequirements> {
+    /** {@link HOST_API_VERSION} of the core running the plugin. */
+    readonly apiVersion: number;
+    /** The name of the plugin this host belongs to. */
+    readonly name: Name;
+    /** The plugin's private folder under `data/`. */
+    readonly data: PluginDataFolder;
+    /**
+     * Answer `GET` (and `HEAD`) on a public path, in Hono's path syntax. The
+     * route answers only while the plugin is enabled; otherwise the request
+     * falls through as if the route were absent.
+     */
+    get(path: string, handler: PluginRouteHandler): void;
+    /**
+     * Run a middleware in the federation mount, after the site's own federation
+     * has answered its paths and before stored ids are. It runs only while the
+     * plugin is enabled.
+     */
+    federation(middleware: PluginFederationMiddleware): void;
+    /** Add the plugin's screen under Plugins. At most one per plugin. */
+    screen(screen: PluginScreen): void;
+    /**
+     * Declare the plugin's settings, which core draws as a form on its screen.
+     * At most once per plugin. Public values are kept under the plugin's key in
+     * `content/_data/site.json`; secrets in `secrets.json` in its data folder,
+     * or in the environment variable named by the package name, `__` and the
+     * key, upper-cased with every run of other characters as one `_`.
+     */
+    settings<const Fields extends readonly PluginSettingField[]>(fields: Fields): PluginSettings<Fields>;
+    /**
+     * Add a command to the command line. It runs whenever the plugin is
+     * installed and available, enabled or not.
+     */
+    command(command: PluginCommand): void;
+    /**
+     * Add a button beside a field of the post and page editor, drawn while the
+     * plugin is enabled. Pressing it posts the draft to
+     * `/admin/plugins/<package name>/editor/<id>`, which only a signed-in user
+     * with the page's CSRF token reaches.
+     */
+    editorAction(action: PluginEditorAction): void;
+    /** The site's base URL and title, read when asked. */
+    siteInfo(): PluginSiteInfo;
+    /**
+     * `GET` another site's URL. Redirects are followed, at most five, and every
+     * address on the way must be public: a loopback, private or link-local
+     * address, or a name that resolves to one, rejects with an error, unless
+     * the site lets its federation reach private addresses. Rejects as `fetch`
+     * does when the host cannot be reached; any status is answered as it came.
+     */
+    fetch(url: string, init?: PluginFetchInit): Promise<Response>;
+    /**
+     * Offer this plugin's service to the plugins that require it, under the
+     * plugin's own package name. At most once per plugin, during `register`.
+     * Every consumer receives this one instance, so it carries plain data and
+     * the host's types across, never an object built by a library.
+     */
+    provide(service: PluginService<Name>): void;
+    /**
+     * The service a required plugin provides. Only a name in `requires` is
+     * accepted, and only once every plugin has registered: call it when
+     * handling a request, a command or a job, never in `register`.
+     */
+    use<Dependency extends keyof Requires & string>(name: Dependency): PluginService<Dependency>;
+}
+/**
+ * The plugins this one depends on: package name to the semver range it
+ * needs, the same pairs as its peer dependencies.
+ */
+export type PluginRequirements = Readonly<Record<string, string>>;
+/** A plugin, as a site config or a bundle's default export hands it over. */
+export interface Plugin<Name extends string = string, Requires extends PluginRequirements = PluginRequirements> {
+    /**
+     * The npm package name, such as `@geekity/plugin-llm`. A plugin installed by
+     * hand still declares a package-style name. It is the key of the plugin
+     * everywhere: `requires`, the `plugins` key in `site.json` and its data.
+     */
+    readonly name: Name;
+    /** The package version, shown on the Plugins screen. */
+    readonly version: string;
+    /** What the Plugins screen calls it. */
+    readonly label: string;
+    /** One or two sentences on what it does. */
+    readonly description: string;
+    /** The {@link HOST_API_VERSION} it was written against. */
+    readonly hostApi: number;
+    /** The plugins it needs installed and enabled before it can be enabled. */
+    readonly requires?: Requires;
+    /**
+     * Called once at boot for every installed plugin, enabled or not, to
+     * declare what the plugin contributes.
+     */
+    register(host: PluginHost<Name, Requires>): void;
+    /** Called when the plugin starts running: at boot when enabled, and on enable. */
+    start?(): void | Promise<void>;
+    /** Called when it stops: on disable and when the CMS closes. */
+    stop?(): void | Promise<void>;
+}
+/**
+ * Declare a plugin, typed. Returns it unchanged. Its name and `requires` are
+ * kept as written, so `host.use` accepts only a required name and
+ * `host.provide` only the service {@link PluginServices} names for the plugin.
+ */
+export declare function definePlugin<const Name extends string, const Requires extends PluginRequirements = {}>(plugin: Plugin<Name, Requires>): Plugin<NoInfer<Name>, NoInfer<Requires>>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

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

package/dist/plugin.js

@@ -0,0 +1,23 @@
+/**
+ * `@geekity/cms/plugin`: the whole of what a plugin may import from core
+ * (decision-33). Types, the host API version and {@link definePlugin}, which is
+ * an identity function so a bundled plugin needs no runtime import of core.
+ *
+ * Removing or reshaping anything here is a breaking change to `@geekity/cms`
+ * (decision-6), and bumps {@link HOST_API_VERSION}.
+ */
+/**
+ * The version of the host API this core provides. A plugin names the version
+ * it targets in {@link Plugin.hostApi}, and one that targets a newer version
+ * than this is unavailable.
+ */
+export const HOST_API_VERSION = 1;
+/**
+ * Declare a plugin, typed. Returns it unchanged. Its name and `requires` are
+ * kept as written, so `host.use` accepts only a required name and
+ * `host.provide` only the service {@link PluginServices} names for the plugin.
+ */
+export function definePlugin(plugin) {
+    return plugin;
+}
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AA+jBlC;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAK1B,MAA8B;IAI9B,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/plugins/enabled.d.ts

@@ -0,0 +1,23 @@
+/**
+ * The enabled set: the `plugins` key of `content/_data/site.json`, an object
+ * keyed by package name (decision-33). Each value is an object of its own, so
+ * a plugin's public settings can sit beside `enabled` and survive a disable.
+ */
+export declare const PLUGINS_KEY = "plugins";
+/** The names the site has enabled, read from the file now. */
+export declare function readEnabledPlugins(contentDir: string): ReadonlySet<string>;
+/** Write one plugin's `enabled`, keeping every other key in the file. */
+export declare function setPluginEnabled(options: {
+    contentDir: string;
+    name: string;
+    enabled: boolean;
+}): Promise<void>;
+/** One plugin's object under `plugins`, empty when it has none. */
+export declare function readPluginEntry(contentDir: string, name: string): Record<string, unknown>;
+/**
+ * Rewrite one plugin's object under `plugins`, keeping every other key in the
+ * file. The only writer of the `plugins` key: enabling and settings both go
+ * through it.
+ */
+export declare function updatePluginEntry(contentDir: string, name: string, change: (entry: Record<string, unknown>) => Record<string, unknown>): Promise<void>;
+//# sourceMappingURL=enabled.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"enabled.d.ts","sourceRoot":"","sources":["../../src/plugins/enabled.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,eAAO,MAAM,WAAW,YAAY,CAAC;AAErC,8DAA8D;AAC9D,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAM1E;AAED,yEAAyE;AACzE,wBAAsB,gBAAgB,CAAC,OAAO,EAAE;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;CAClB,GAAG,OAAO,CAAC,IAAI,CAAC,CAGhB;AAED,mEAAmE;AACnE,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAGzF;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClE,OAAO,CAAC,IAAI,CAAC,CAQf"}

package/dist/plugins/enabled.js

@@ -0,0 +1,49 @@
+/**
+ * The enabled set: the `plugins` key of `content/_data/site.json`, an object
+ * keyed by package name (decision-33). Each value is an object of its own, so
+ * a plugin's public settings can sit beside `enabled` and survive a disable.
+ */
+import { parseSiteJson, readSiteJson, siteDataPath } from '../admin/settings.js';
+import { updateFileAtomically } from '../files/atomic.js';
+export const PLUGINS_KEY = 'plugins';
+/** The names the site has enabled, read from the file now. */
+export function readEnabledPlugins(contentDir) {
+    const enabled = new Set();
+    for (const [name, entry] of Object.entries(pluginsOf(readSiteJson(contentDir)))) {
+        if (isRecord(entry) && entry['enabled'] === true)
+            enabled.add(name);
+    }
+    return enabled;
+}
+/** Write one plugin's `enabled`, keeping every other key in the file. */
+export async function setPluginEnabled(options) {
+    const { contentDir, name, enabled } = options;
+    await updatePluginEntry(contentDir, name, (entry) => ({ ...entry, enabled }));
+}
+/** One plugin's object under `plugins`, empty when it has none. */
+export function readPluginEntry(contentDir, name) {
+    const entry = pluginsOf(readSiteJson(contentDir))[name];
+    return isRecord(entry) ? entry : {};
+}
+/**
+ * Rewrite one plugin's object under `plugins`, keeping every other key in the
+ * file. The only writer of the `plugins` key: enabling and settings both go
+ * through it.
+ */
+export async function updatePluginEntry(contentDir, name, change) {
+    await updateFileAtomically(siteDataPath(contentDir), (current) => {
+        const file = parseSiteJson(current ?? '');
+        const plugins = pluginsOf(file);
+        const entry = plugins[name];
+        file[PLUGINS_KEY] = { ...plugins, [name]: change(isRecord(entry) ? entry : {}) };
+        return `${JSON.stringify(file, null, 2)}\n`;
+    });
+}
+function pluginsOf(file) {
+    const plugins = file[PLUGINS_KEY];
+    return isRecord(plugins) ? plugins : {};
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=enabled.js.map

package/dist/plugins/enabled.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enabled.js","sourceRoot":"","sources":["../../src/plugins/enabled.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D,MAAM,CAAC,MAAM,WAAW,GAAG,SAAS,CAAC;AAErC,8DAA8D;AAC9D,MAAM,UAAU,kBAAkB,CAAC,UAAkB;IACnD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC;QAChF,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,KAAK,IAAI;YAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,yEAAyE;AACzE,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAItC;IACC,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC;IAC9C,MAAM,iBAAiB,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;AAChF,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,eAAe,CAAC,UAAkB,EAAE,IAAY;IAC9D,MAAM,KAAK,GAAG,SAAS,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACxD,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;AACtC,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,UAAkB,EAClB,IAAY,EACZ,MAAmE;IAEnE,MAAM,oBAAoB,CAAC,YAAY,CAAC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE;QAC/D,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QAC1C,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC5B,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;QACjF,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;IAC9C,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,SAAS,CAAC,IAA6B;IAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC;IAClC,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;AAC1C,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}