@crowi/api 2.0.0-alpha.0

package/dist/notifications/attach.js.map

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

package/dist/notifications/channel.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Redis pub/sub channel naming for per-user notification invalidation
+ * signals. One channel per recipient (`crowi:notifications:user:<userId>`)
+ * so a publish only reaches instances that actually have that user
+ * connected and the WebSocket fan-out stays bounded.
+ *
+ * Kept as a standalone leaf module so the model-layer publisher
+ * (`models/notification.ts`) and the WebSocket transport
+ * (`notifications/attach.ts`) share the naming without the model
+ * having to depend on the transport.
+ */
+export declare const NOTIFICATIONS_CHANNEL_PREFIX = "crowi:notifications:user:";
+export declare const channelForUser: (userId: string) => string;

package/dist/notifications/channel.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.channelForUser = exports.NOTIFICATIONS_CHANNEL_PREFIX = void 0;
+/**
+ * Redis pub/sub channel naming for per-user notification invalidation
+ * signals. One channel per recipient (`crowi:notifications:user:<userId>`)
+ * so a publish only reaches instances that actually have that user
+ * connected and the WebSocket fan-out stays bounded.
+ *
+ * Kept as a standalone leaf module so the model-layer publisher
+ * (`models/notification.ts`) and the WebSocket transport
+ * (`notifications/attach.ts`) share the naming without the model
+ * having to depend on the transport.
+ */
+exports.NOTIFICATIONS_CHANNEL_PREFIX = 'crowi:notifications:user:';
+const channelForUser = (userId) => `${exports.NOTIFICATIONS_CHANNEL_PREFIX}${userId}`;
+exports.channelForUser = channelForUser;
+//# sourceMappingURL=channel.js.map

package/dist/notifications/channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.js","sourceRoot":"","sources":["../../src/notifications/channel.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;GAUG;AACU,QAAA,4BAA4B,GAAG,2BAA2B,CAAC;AAEjE,MAAM,cAAc,GAAG,CAAC,MAAc,EAAU,EAAE,CAAC,GAAG,oCAA4B,GAAG,MAAM,EAAE,CAAC;AAAxF,QAAA,cAAc,kBAA0E"}

package/dist/plugin/index.d.ts

@@ -0,0 +1,2 @@
+export { PluginManager } from './plugin-manager';
+export type { PluginRegistries } from './plugin-manager';

package/dist/plugin/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PluginManager = void 0;
+var plugin_manager_1 = require("./plugin-manager");
+Object.defineProperty(exports, "PluginManager", { enumerable: true, get: function () { return plugin_manager_1.PluginManager; } });
+//# sourceMappingURL=index.js.map

package/dist/plugin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/plugin/index.ts"],"names":[],"mappings":";;;AAAA,mDAAiD;AAAxC,+GAAA,aAAa,OAAA"}

package/dist/plugin/plugin-context.d.ts

@@ -0,0 +1,22 @@
+import type { CrowiPlugin, PluginContext } from '@crowi/plugin-api';
+import type Crowi from '../crowi';
+/**
+ * Closure over the registry of loaded plugins, used by
+ * `PluginContext.dependencyConfig` to resolve another plugin's
+ * configSchema. Decoupled from the PluginManager so we don't create a
+ * circular import.
+ */
+export interface PluginLookup {
+    getLoadedPlugin(name: string): CrowiPlugin | undefined;
+}
+/**
+ * Build a `PluginContext` instance for a single plugin. The runtime
+ * passes this object to every `register*` callback and to the
+ * `onInstall` / `onUninstall` lifecycle hooks; from the plugin's POV
+ * it's the only handle on core state.
+ *
+ * Each plugin gets its own context with `name` already closed over so
+ * config / pageMetadata reads are scoped without the plugin needing
+ * to thread the name everywhere.
+ */
+export declare function createPluginContext(plugin: CrowiPlugin, crowi: Crowi, lookup: PluginLookup): PluginContext;

package/dist/plugin/plugin-context.js

@@ -0,0 +1,126 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPluginContext = createPluginContext;
+const debug_1 = __importDefault(require("debug"));
+const crypto_1 = require("../util/crypto");
+const plugin_namespace_1 = require("./plugin-namespace");
+/**
+ * Build a `PluginContext` instance for a single plugin. The runtime
+ * passes this object to every `register*` callback and to the
+ * `onInstall` / `onUninstall` lifecycle hooks; from the plugin's POV
+ * it's the only handle on core state.
+ *
+ * Each plugin gets its own context with `name` already closed over so
+ * config / pageMetadata reads are scoped without the plugin needing
+ * to thread the name everywhere.
+ */
+function createPluginContext(plugin, crowi, lookup) {
+    const log = (() => {
+        const debug = (0, debug_1.default)(`crowi:plugin:${plugin.name}`);
+        return {
+            debug: (msg, ...args) => debug(msg, ...args),
+            info: (msg, ...args) => debug(`[info] ${msg}`, ...args),
+            warn: (msg, ...args) => console.warn(`[crowi:plugin:${plugin.name}] ${msg}`, ...args),
+            error: (msg, ...args) => console.error(`[crowi:plugin:${plugin.name}] ${msg}`, ...args),
+        };
+    })();
+    const crypto = { encrypt: crypto_1.encrypt, decrypt: crypto_1.decrypt };
+    return {
+        config() {
+            const schema = plugin.configSchema;
+            if (!schema) {
+                throw new Error(`Plugin '${plugin.name}' called config() but did not declare a configSchema.`);
+            }
+            const ns = readPluginConfigNamespace(crowi, plugin.name);
+            const result = schema.safeParse(ns);
+            if (!result.success) {
+                throw new Error(`Plugin '${plugin.name}' config validation failed: ${result.error.message}`);
+            }
+            return result.data;
+        },
+        dependencyConfig(dependencyName) {
+            if (!plugin.requires?.includes(dependencyName)) {
+                throw new Error(`Plugin '${plugin.name}' tried to read dependency config of '${dependencyName}', but did not list it in 'requires'.`);
+            }
+            const dep = lookup.getLoadedPlugin(dependencyName);
+            if (!dep) {
+                // The PluginManager already validates `requires` at load
+                // time, so this branch only fires on a programming bug.
+                throw new Error(`Dependency plugin '${dependencyName}' is not loaded — PluginManager invariant broken.`);
+            }
+            const schema = dep.configSchema;
+            if (!schema) {
+                throw new Error(`Dependency plugin '${dependencyName}' did not declare a configSchema.`);
+            }
+            const ns = readPluginConfigNamespace(crowi, dependencyName);
+            const result = schema.safeParse(ns);
+            if (!result.success) {
+                throw new Error(`Dependency plugin '${dependencyName}' config validation failed: ${result.error.message}`);
+            }
+            return result.data;
+        },
+        async setConfig(key, value) {
+            await crowi.getConfigService().saveConfigValue('crowi', (0, plugin_namespace_1.formatPluginConfigKey)(plugin.name, key), value);
+        },
+        pageMetadata: makePageMetadataAccessor(plugin.name, crowi),
+        model(name) {
+            // crowi.model has a strongly-typed signature elsewhere; the
+            // plugin contract intentionally types this loosely so plugins
+            // can narrow at the call site.
+            // biome-ignore lint/suspicious/noExplicitAny: Crowi.model<K> requires a literal
+            return crowi.model(name);
+        },
+        crypto,
+        log,
+    };
+}
+/**
+ * Pull the `plugin:<name>:*` rows out of the in-memory Config cache
+ * and return them as a flat object keyed by the part after the second
+ * colon (matching the plugin's `configSchema` shape).
+ */
+function readPluginConfigNamespace(crowi, pluginName) {
+    const all = crowi.getConfig();
+    const crowiNs = (all && typeof all === 'object' ? all.crowi : undefined) ?? {};
+    const prefix = (0, plugin_namespace_1.pluginConfigKeyPrefix)(pluginName);
+    const out = {};
+    for (const [key, value] of Object.entries(crowiNs)) {
+        if (key.startsWith(prefix)) {
+            out[key.slice(prefix.length)] = value;
+        }
+    }
+    return out;
+}
+/**
+ * Build a `PageMetadataAccessor` that scopes reads / writes to the
+ * plugin's namespace on `Page.metadata`. The namespace is the plugin
+ * name itself; collisions across plugins are impossible because npm
+ * names are unique.
+ */
+function makePageMetadataAccessor(pluginName, crowi) {
+    return {
+        async get(pageId) {
+            // biome-ignore lint/suspicious/noExplicitAny: Crowi.model<K> requires a literal
+            const Page = crowi.model('Page');
+            const doc = await Page.findOne({ _id: pageId }).select('metadata').lean();
+            if (!doc?.metadata || typeof doc.metadata !== 'object')
+                return null;
+            const slot = doc.metadata[pluginName];
+            return slot ?? null;
+        },
+        async set(pageId, value) {
+            // biome-ignore lint/suspicious/noExplicitAny: Crowi.model<K> requires a literal
+            const Page = crowi.model('Page');
+            await Page.updateOne({ _id: pageId }, { $set: { [`metadata.${pluginName}`]: value } });
+        },
+        async remove(pageId) {
+            // biome-ignore lint/suspicious/noExplicitAny: Crowi.model<K> requires a literal
+            const Page = crowi.model('Page');
+            await Page.updateOne({ _id: pageId }, { $unset: { [`metadata.${pluginName}`]: '' } });
+        },
+    };
+}
+//# sourceMappingURL=plugin-context.js.map

package/dist/plugin/plugin-context.js.map

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

package/dist/plugin/plugin-manager.d.ts

@@ -0,0 +1,164 @@
+import type { AuthDriver, CrowiPlugin, MailSender, NotifierDriver, SearchDriver, StorageDriver } from '@crowi/plugin-api';
+import type Crowi from '../crowi';
+import { DriverRegistry } from './registries';
+/**
+ * What `PluginManager.bootstrap()` returns to the surrounding Crowi
+ * boot sequence — the resolved registries and active driver
+ * resolution. Core services (file uploader, search service, …) read
+ * the active drivers from here.
+ *
+ * `active.storage` and `active.search` are nullable: if no plugin
+ * registered the configured driver name, we log a warning and leave
+ * the active slot null so legacy in-core code paths keep handling
+ * those concerns. This is the v2.0 transition state — once the
+ * built-in `@crowi/plugin-storage-local` and `@crowi/plugin-search-mongo` plugins
+ * land (Step 3+), the active slots are always populated.
+ */
+export interface PluginRegistries {
+    storage: DriverRegistry<StorageDriver>;
+    search: DriverRegistry<SearchDriver>;
+    auth: DriverRegistry<AuthDriver>;
+    notifier: DriverRegistry<NotifierDriver>;
+    mail: DriverRegistry<MailSender>;
+    /** Active driver for each registry, resolved from `crowi.config.json`. */
+    active: {
+        storage: StorageDriver | null;
+        search: SearchDriver | null;
+        /** Auth and notifier are always lists — zero or more providers. */
+        auth: AuthDriver[];
+        notifiers: NotifierDriver[];
+        /** Single active mail sender, selected by `mail.driver`. */
+        mail: MailSender | null;
+    };
+}
+/**
+ * Loads the plugins listed in `crowi.config.json`, resolves their
+ * dependency order, runs each plugin's `register*` callbacks, and
+ * exposes the resulting registries to the rest of the application.
+ *
+ * Lifecycle:
+ *   1. `loadCrowiConfigFile()` reads the JSON.
+ *   2. For each plugin name, `await import(name)` pulls the package's
+ *      default export and validates it as a `CrowiPlugin`.
+ *   3. `topoSortPlugins()` orders by `requires`.
+ *   4. For each plugin in order:
+ *      a) build a `PluginContext` for it
+ *      b) if first time loaded, `await onInstall(ctx)` (idempotency
+ *         is the plugin's responsibility — we re-call on every boot
+ *         until the install-tracker is added in a follow-up step)
+ *      c) call each provided `register*` callback with the matching
+ *         registry scope
+ *   5. Resolve active drivers from `crowi.config.json:storage.driver`
+ *      / `search.driver`. All registered auth and notifier drivers
+ *      are active simultaneously.
+ *
+ * Errors at any step fail boot. The legacy boot path in `Crowi.init()`
+ * is unchanged when `crowi.config.json` is absent — defaults
+ * (`{ plugins: [], storage.driver: 'local', search.driver: 'mongo' }`)
+ * mean the manager runs with only the implicit-default plugins.
+ */
+export declare class PluginManager {
+    private readonly crowi;
+    private storage;
+    private search;
+    private auth;
+    private notifier;
+    private mail;
+    private loadedPlugins;
+    /** plugin name → set of plugin names that `requires` it */
+    private dependents;
+    constructor(crowi: Crowi);
+    /**
+     * Run the full lifecycle and return the resolved registries +
+     * active drivers. Call once during `Crowi.init()`.
+     */
+    bootstrap(projectDir?: string): Promise<PluginRegistries>;
+    /**
+     * Walk the loaded plugins' `requires` arrays and invert them into
+     * `dependents: name → set of plugins that require it`. Used to fan
+     * out `reconfigure` calls when a base plugin's config changes (e.g.
+     * `@crowi/plugin-aws` credentials changing should reconfigure
+     * `@crowi/plugin-storage-aws-s3`).
+     */
+    private buildDependentsMap;
+    /**
+     * Listener bound to ConfigService.onConfigChange. We only auto-fire
+     * reconfigure for `'remote'` changes (= another instance saved via
+     * Redis pub/sub). For `'local'` changes the admin save handler calls
+     * `reconfigureAffected` itself so it can include the result in the
+     * response body — running it here too would double-fire.
+     */
+    private handleConfigChange;
+    /**
+     * Resolve `changedNamespaces` (e.g. `['plugin:@crowi/plugin-aws']`)
+     * to the concrete set of plugin names that need their `reconfigure`
+     * called: the changed plugin itself plus every plugin that has it in
+     * `requires`. The `'*'` sentinel (used by older pub/sub publishers)
+     * fans out to every loaded plugin.
+     */
+    private affectedPluginsFromNamespaces;
+    /**
+     * Call `reconfigure(ctx)` on each plugin in `affected` that
+     * implements it. Errors are logged + reported via the plugin's debug
+     * logger but never propagated — a single misconfigured plugin must
+     * not lock operators out of the admin UI.
+     *
+     * Returns whether any plugin both (a) implements reconfigure and
+     * (b) completed without throwing — used by the admin save handler
+     * to pick the right toast.
+     */
+    runReconfigure(affected: Set<string>): Promise<{
+        attempted: number;
+        succeeded: number;
+    }>;
+    /**
+     * Public entry-point used by the admin "save plugin config" handler
+     * to await reconfigure completion in the same request and surface
+     * the result in the response body.
+     */
+    reconfigureAffected(changedNamespaces: string[]): Promise<{
+        attempted: number;
+        succeeded: number;
+    }>;
+    /**
+     * Look up a plugin by npm name from the loaded set. Used by
+     * `PluginContext.dependencyConfig` to resolve another plugin's
+     * configSchema. Returns undefined when the name isn't loaded.
+     */
+    getLoadedPlugin(name: string): CrowiPlugin | undefined;
+    /**
+     * The list of plugins the manager loaded, in topological order.
+     * Surfaced for `crowi plugin list` and admin UI.
+     */
+    getLoadedPlugins(): readonly CrowiPlugin[];
+    /**
+     * Walk every loaded plugin's `configSchema` and return the union of
+     * field paths marked `@sensitive`. The "re-encrypt all" admin
+     * routine consults this list. See RFC-0001 §5.
+     */
+    listSensitiveKeys(): string[];
+    /**
+     * Deactivate a loaded plugin. Phase 4 only touches the render
+     * cache: every cached entry contributed by the named plugin is
+     * removed (`invalidatePlugin(name)`). Phase 5+ will broaden this
+     * to (a) drop the plugin from the loaded set + driver registries,
+     * (b) emit a deactivation event for dependents, (c) wire the
+     * `--purge` CLI path.
+     *
+     * Returns true when at least the render-cache invalidation ran
+     * (false when the plugin wasn't loaded). Failures are logged but
+     * never propagated — operators trigger deactivate from the admin
+     * UI or CLI and a partial cleanup is still better than no cleanup.
+     */
+    deactivate(name: string): Promise<boolean>;
+    private activate;
+    private resolveActiveDrivers;
+    /**
+     * Look up `driverName` in `registry`. Returns null + logs a warning
+     * if absent. v2.0 transition behaviour: legacy in-core code keeps
+     * handling the concern when the active driver is null. After the
+     * Step 3+ plugin extractions land, missing-driver becomes a hard
+     * error.
+     */
+    private resolveOrWarn;
+}