@crowi/api 2.0.0-alpha.0

package/dist/renderer/__fixtures__/echo-embed.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Test-only fixture plugin for Phase 4 e2e tests. Provides a single
+ * embed-tag `@[echo](payload)` that renders the trivial
+ * `<div class="echo">payload</div>` so we can validate the parse →
+ * cache miss → render → cache set → re-read flow end-to-end without
+ * a real I/O plugin.
+ *
+ * **MUST NOT be imported from production code paths.** This file lives
+ * under `__fixtures__/` to make the boundary visible to humans /
+ * code reviewers. The `render()` function additionally probes
+ * `process.env.NODE_ENV` and throws when invoked outside of `test`
+ * so an accidental production import surfaces immediately on first
+ * call (rather than silently shipping a debug-only renderer).
+ *
+ * Will be removed once Phase 6/7 ships a real plugin (PlantUML /
+ * KaTeX / Mermaid / GitHub Embed).
+ */
+import type { EmbedRenderer } from '@crowi/plugin-api';
+export declare const ECHO_TAG = "echo";
+/** Bump if the fixture's output shape changes; not exercised but kept for parity with real plugins. */
+export declare const ECHO_CACHE_VERSION = 1;
+/**
+ * Simple `@[echo](payload)` → `<div class="echo">payload</div>` renderer.
+ * The output html is HTML-escape-free on purpose — payloads in tests
+ * are controlled and the assertion targets the verbatim string.
+ */
+export declare const echoEmbedRenderer: EmbedRenderer;

package/dist/renderer/__fixtures__/echo-embed.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.echoEmbedRenderer = exports.ECHO_CACHE_VERSION = exports.ECHO_TAG = void 0;
+exports.ECHO_TAG = 'echo';
+/** Bump if the fixture's output shape changes; not exercised but kept for parity with real plugins. */
+exports.ECHO_CACHE_VERSION = 1;
+/**
+ * Simple `@[echo](payload)` → `<div class="echo">payload</div>` renderer.
+ * The output html is HTML-escape-free on purpose — payloads in tests
+ * are controlled and the assertion targets the verbatim string.
+ */
+exports.echoEmbedRenderer = {
+    cacheVersion: exports.ECHO_CACHE_VERSION,
+    render: async (input) => {
+        if (process.env.NODE_ENV !== 'test') {
+            throw new Error('[crowi:renderer:__fixtures__/echo-embed] This fixture plugin is for tests only. Do not register it from production code.');
+        }
+        return {
+            html: `<div class="echo">${input.url}</div>`,
+            ttlSec: 300,
+        };
+    },
+};
+//# sourceMappingURL=echo-embed.js.map

package/dist/renderer/__fixtures__/echo-embed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"echo-embed.js","sourceRoot":"","sources":["../../../src/renderer/__fixtures__/echo-embed.ts"],"names":[],"mappings":";;;AAmBa,QAAA,QAAQ,GAAG,MAAM,CAAC;AAE/B,uGAAuG;AAC1F,QAAA,kBAAkB,GAAG,CAAC,CAAC;AAEpC;;;;GAIG;AACU,QAAA,iBAAiB,GAAkB;IAC9C,YAAY,EAAE,0BAAkB;IAChC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;QACtB,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,0HAA0H,CAAC,CAAC;QAC9I,CAAC;QACD,OAAO;YACL,IAAI,EAAE,qBAAqB,KAAK,CAAC,GAAG,QAAQ;YAC5C,MAAM,EAAE,GAAG;SACZ,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/renderer/cache/index.d.ts

@@ -0,0 +1,60 @@
+import type { CacheStorage, EmbedInput, EmbedRenderer, RenderContext, RenderError, RenderResult, ScopedCacheStorage } from '@crowi/plugin-api';
+import { MongoCacheStorage } from './mongodb-cache';
+export { MongoCacheStorage, createMongoCacheStorage } from './mongodb-cache';
+export { errorPlaceholder, sizeLimitPlaceholder, renderReservation } from './reservation';
+export type { CacheSetReject } from './mongodb-cache';
+/**
+ * Default fresh-TTL when `RenderResult.ttlSec` is unset. RFC §"Stale-
+ * while-revalidate".
+ */
+export declare const DEFAULT_FRESH_TTL_SEC: number;
+/**
+ * Default `staleAfterSec` multiplier — entries stay revalidate-in-
+ * background until `ttlSec * 4`, after which a read blocks on the
+ * re-render.
+ */
+export declare const DEFAULT_STALE_MULTIPLIER = 4;
+/**
+ * Per-code TTLs for cached error responses (RFC §"Error caching").
+ * `rate_limit` is overridable per-call via `RenderError.retryAfterSec`.
+ */
+export declare const RENDER_ERROR_TTL: Readonly<Record<RenderError['code'], number>>;
+/**
+ * Compute the cache embed-key for an input. Default
+ * `sha256(JSON.stringify(input))` keeps callers honest about input
+ * stability; plugins can override via `EmbedRenderer.computeEmbedKey`
+ * to canonicalise query strings, ignore tracking params, etc.
+ */
+export declare function defaultEmbedKey(input: EmbedInput): string;
+/**
+ * Wrap a `CacheStorage` in a per-plugin view that auto-stamps
+ * `pluginName` on every key. Plugins receive this on
+ * `RenderContext.cache` and never see other plugins' entries.
+ */
+export declare function scopeForPlugin(storage: CacheStorage, pluginName: string): ScopedCacheStorage;
+/** What `cachedRender` may return — html plus a freshness hint for SSR layers. */
+export interface CachedRenderResult {
+    html: string;
+    /** 'fresh' | 'stale' so a caller can emit `data-stale="true"` if desired. */
+    freshness: 'fresh' | 'stale';
+    /** The full `RenderResult` (errors included) for downstream telemetry. */
+    result: RenderResult;
+}
+/**
+ * Stale-while-revalidate wrapper for a single embed render. Resolves
+ * the four cases:
+ *
+ *   - **miss**: render now, cache, return fresh.
+ *   - **hit + fresh** (`now < expiresAt`): return cached, no re-render.
+ *   - **hit + stale-within-window** (`expiresAt < now < expiresAt + (stale*ttl)`):
+ *     return cached, fire background re-render.
+ *   - **hit + expired**: block on re-render, cache, return.
+ *
+ * Errors from `render()` (both thrown and `RenderResult.error`) cache
+ * with `RENDER_ERROR_TTL[code]` and surface an error placeholder.
+ *
+ * NOTE: this is the **internal** wrapper used by Phase 4 core plugins
+ * (`embed-tags.ts`, `url-inline-expand.ts`). Plugins do not call it
+ * directly; they call `EmbedRenderer.render()` and the core wraps.
+ */
+export declare function cachedRender(storage: MongoCacheStorage, pluginName: string, renderer: EmbedRenderer, input: EmbedInput, ctx: RenderContext): Promise<CachedRenderResult>;

package/dist/renderer/cache/index.js

@@ -0,0 +1,219 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RENDER_ERROR_TTL = exports.DEFAULT_STALE_MULTIPLIER = exports.DEFAULT_FRESH_TTL_SEC = exports.renderReservation = exports.sizeLimitPlaceholder = exports.errorPlaceholder = exports.createMongoCacheStorage = exports.MongoCacheStorage = void 0;
+exports.defaultEmbedKey = defaultEmbedKey;
+exports.scopeForPlugin = scopeForPlugin;
+exports.cachedRender = cachedRender;
+const node_crypto_1 = require("node:crypto");
+const reservation_1 = require("./reservation");
+var mongodb_cache_1 = require("./mongodb-cache");
+Object.defineProperty(exports, "MongoCacheStorage", { enumerable: true, get: function () { return mongodb_cache_1.MongoCacheStorage; } });
+Object.defineProperty(exports, "createMongoCacheStorage", { enumerable: true, get: function () { return mongodb_cache_1.createMongoCacheStorage; } });
+var reservation_2 = require("./reservation");
+Object.defineProperty(exports, "errorPlaceholder", { enumerable: true, get: function () { return reservation_2.errorPlaceholder; } });
+Object.defineProperty(exports, "sizeLimitPlaceholder", { enumerable: true, get: function () { return reservation_2.sizeLimitPlaceholder; } });
+Object.defineProperty(exports, "renderReservation", { enumerable: true, get: function () { return reservation_2.renderReservation; } });
+/**
+ * Default fresh-TTL when `RenderResult.ttlSec` is unset. RFC §"Stale-
+ * while-revalidate".
+ */
+exports.DEFAULT_FRESH_TTL_SEC = 5 * 60; // 5min
+/**
+ * Default `staleAfterSec` multiplier — entries stay revalidate-in-
+ * background until `ttlSec * 4`, after which a read blocks on the
+ * re-render.
+ */
+exports.DEFAULT_STALE_MULTIPLIER = 4;
+/**
+ * Per-code TTLs for cached error responses (RFC §"Error caching").
+ * `rate_limit` is overridable per-call via `RenderError.retryAfterSec`.
+ */
+exports.RENDER_ERROR_TTL = {
+    auth: 60,
+    rate_limit: 5 * 60,
+    not_found: 60 * 60,
+    network: 5 * 60,
+    timeout: 5 * 60,
+    unknown: 5 * 60,
+};
+/**
+ * Compute the cache embed-key for an input. Default
+ * `sha256(JSON.stringify(input))` keeps callers honest about input
+ * stability; plugins can override via `EmbedRenderer.computeEmbedKey`
+ * to canonicalise query strings, ignore tracking params, etc.
+ */
+function defaultEmbedKey(input) {
+    const json = JSON.stringify({ tag: input.tag, url: input.url });
+    return (0, node_crypto_1.createHash)('sha256').update(json).digest('hex');
+}
+/**
+ * Wrap a `CacheStorage` in a per-plugin view that auto-stamps
+ * `pluginName` on every key. Plugins receive this on
+ * `RenderContext.cache` and never see other plugins' entries.
+ */
+function scopeForPlugin(storage, pluginName) {
+    return {
+        async get(key) {
+            return storage.get({ ...key, pluginName });
+        },
+        async set(key, entry) {
+            await storage.set({ ...key, pluginName }, entry);
+        },
+        async invalidatePage(pageId) {
+            // Pull only this plugin's entries on this page. The underlying
+            // storage's `invalidatePlugin` would nuke other pages too, so we
+            // intentionally do not expose it through the scoped view.
+            return storage.invalidatePage(pageId);
+        },
+    };
+}
+// Process-wide in-flight tracker — collapses concurrent renders for the
+// same cache key into a single upstream call. Without this, K viewers
+// of a page entering the stale window each kick off a background
+// `renderAndStore`, multiplying load against the plugin's upstream
+// (`addEmbedTag` is typically a GitHub / Slack / KaTeX / Mermaid call).
+const inFlightRender = new Map();
+function cacheKeyString(key) {
+    return `${key.pluginName}
${key.pluginCacheVersion}
${key.pageId}
${key.embedKey}`;
+}
+/**
+ * Stale-while-revalidate wrapper for a single embed render. Resolves
+ * the four cases:
+ *
+ *   - **miss**: render now, cache, return fresh.
+ *   - **hit + fresh** (`now < expiresAt`): return cached, no re-render.
+ *   - **hit + stale-within-window** (`expiresAt < now < expiresAt + (stale*ttl)`):
+ *     return cached, fire background re-render.
+ *   - **hit + expired**: block on re-render, cache, return.
+ *
+ * Errors from `render()` (both thrown and `RenderResult.error`) cache
+ * with `RENDER_ERROR_TTL[code]` and surface an error placeholder.
+ *
+ * NOTE: this is the **internal** wrapper used by Phase 4 core plugins
+ * (`embed-tags.ts`, `url-inline-expand.ts`). Plugins do not call it
+ * directly; they call `EmbedRenderer.render()` and the core wraps.
+ */
+async function cachedRender(storage, pluginName, renderer, input, ctx) {
+    const embedKey = renderer.computeEmbedKey ? renderer.computeEmbedKey(input) : defaultEmbedKey(input);
+    const key = {
+        pluginName,
+        pluginCacheVersion: renderer.cacheVersion,
+        pageId: input.pageId,
+        embedKey,
+    };
+    const cached = await storage.get(key);
+    const now = Date.now();
+    if (cached) {
+        const expiresMs = cached.expiresAt.getTime();
+        const ttlMs = expiresMs - cached.fetchedAt.getTime();
+        const staleWindowMs = ttlMs * exports.DEFAULT_STALE_MULTIPLIER;
+        const isFresh = now < expiresMs;
+        const isWithinStaleWindow = !isFresh && now < expiresMs + staleWindowMs;
+        if (isFresh) {
+            return { html: cached.html, freshness: 'fresh', result: cached.result };
+        }
+        if (isWithinStaleWindow) {
+            // Skip the background fire if a re-render is already in flight
+            // for this cache key — otherwise K concurrent viewers each kick
+            // off a parallel `render()` and amplify upstream load by K.
+            const ks = cacheKeyString(key);
+            if (!inFlightRender.has(ks)) {
+                // `setImmediate` rather than `Promise.resolve().then` so it
+                // lands at the start of the next event loop tick (lower priority
+                // than the in-flight request).
+                setImmediate(() => {
+                    void dedupedRenderAndStore(ks, storage, key, renderer, input, ctx).catch((err) => {
+                        ctx.log.warn(`[plugin-render-cache] background re-render failed for plugin=${pluginName} pageId=${input.pageId}: ${stringifyError(err)}`);
+                    });
+                });
+            }
+            return { html: cached.html, freshness: 'stale', result: cached.result };
+        }
+        // expired beyond stale window — block on re-render.
+    }
+    // miss or expired: render now (de-duped against any concurrent miss
+    // for the same key — second viewer awaits the first viewer's render).
+    const ks = cacheKeyString(key);
+    const result = await dedupedRenderAndStore(ks, storage, key, renderer, input, ctx);
+    return { html: result.html, freshness: 'fresh', result: result.result };
+}
+function dedupedRenderAndStore(ks, storage, key, renderer, input, ctx) {
+    const existing = inFlightRender.get(ks);
+    if (existing)
+        return existing;
+    const p = renderAndStore(storage, key, renderer, input, ctx).finally(() => {
+        inFlightRender.delete(ks);
+    });
+    inFlightRender.set(ks, p);
+    return p;
+}
+async function renderAndStore(storage, key, renderer, input, ctx) {
+    let result;
+    try {
+        result = await renderer.render(input, ctx);
+    }
+    catch (err) {
+        // Thrown error → treat as `unknown` and cache.
+        result = {
+            html: '',
+            error: {
+                code: 'unknown',
+                message: stringifyError(err),
+            },
+        };
+    }
+    const now = new Date();
+    const ttlSec = pickTtl(result);
+    const expiresAt = new Date(now.getTime() + ttlSec * 1000);
+    // Error responses get a fixed placeholder regardless of what the
+    // plugin returned in `html`. We still cache the plugin's error meta
+    // so admin telemetry has context.
+    const html = result.error ? (0, reservation_1.errorPlaceholder)(result.error.code, renderer.reservation) : result.html;
+    const cachedHtml = html;
+    const cacheEntry = {
+        html: cachedHtml,
+        result: { ...result, html: cachedHtml },
+        fetchedAt: now,
+        expiresAt,
+    };
+    const rejection = await storage.setOrReject(key, cacheEntry);
+    if (rejection) {
+        // Size-limit reject → fall back to a placeholder for THIS render
+        // call. We don't write the placeholder to the cache (it would
+        // pollute the slot if the plugin shrinks its output later); the
+        // next read just sees a miss and re-renders.
+        return {
+            html: (0, reservation_1.sizeLimitPlaceholder)(rejection, renderer.reservation),
+            result: cacheEntry.result,
+        };
+    }
+    return { html: cachedHtml, result: cacheEntry.result };
+}
+/**
+ * Resolve the effective fresh-TTL for a render result. Error responses
+ * use the per-code default table (with `retryAfterSec` override for
+ * rate-limit); successful responses honour `RenderResult.ttlSec` or
+ * fall back to `DEFAULT_FRESH_TTL_SEC`.
+ */
+function pickTtl(result) {
+    if (result.error) {
+        if (result.error.code === 'rate_limit' && typeof result.error.retryAfterSec === 'number') {
+            return Math.max(1, result.error.retryAfterSec);
+        }
+        return exports.RENDER_ERROR_TTL[result.error.code];
+    }
+    return result.ttlSec ?? exports.DEFAULT_FRESH_TTL_SEC;
+}
+function stringifyError(err) {
+    if (err instanceof Error)
+        return err.message;
+    if (typeof err === 'string')
+        return err;
+    try {
+        return JSON.stringify(err);
+    }
+    catch {
+        return String(err);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/renderer/cache/index.js.map

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

package/dist/renderer/cache/mongodb-cache.d.ts

@@ -0,0 +1,82 @@
+import type { CacheEntry, CacheKey, CacheStorage } from '@crowi/plugin-api';
+import type Crowi from '../../crowi';
+import type { PluginRenderCacheModel } from '../../models/plugin-render-cache';
+/**
+ * Per-entry warn threshold. Logged but not rejected.
+ * RFC §"Size limits" — 50KB warn, 100KB reject.
+ */
+export declare const SINGLE_ENTRY_WARN_BYTES: number;
+/** Per-entry reject threshold. Above this we drop the write and let the caller fall back to a placeholder. */
+export declare const SINGLE_ENTRY_REJECT_BYTES: number;
+/** Per-page cumulative reject threshold. */
+export declare const PER_PAGE_REJECT_BYTES: number;
+/** Why a `set()` call rejected the entry. Surfaced to the SWR wrapper for placeholder fallback. */
+export type CacheSetReject = 'entry-too-large' | 'page-quota-exceeded';
+export interface MongoCacheStorageDeps {
+    PluginRenderCache: PluginRenderCacheModel;
+    /** Logger for size-limit warnings. The cache itself is plugin-agnostic. */
+    log: {
+        warn(msg: string, ...args: unknown[]): void;
+        debug(msg: string, ...args: unknown[]): void;
+    };
+}
+/**
+ * MongoDB-backed implementation of `CacheStorage`. The schema +
+ * indexes live in `models/plugin-render-cache.ts`; this class is the
+ * thin query layer.
+ *
+ * Behaviour quirks worth noting:
+ *
+ *   - **TTL defence-in-depth.** MongoDB's TTL monitor sweeps every
+ *     ~60s, so a row whose `expiresAt` just elapsed may still be on
+ *     disk. `get()` checks `expiresAt < now` and treats the hit as a
+ *     miss + deletes the row so the next read is fast.
+ *
+ *   - **`pluginCacheVersion` mismatch = miss.** Plugins bump their
+ *     `cacheVersion` to invalidate every cached entry without an
+ *     operator action. We don't actively delete stale-version rows
+ *     (the TTL eventually does); we just refuse to return them.
+ *
+ *   - **Size limits.** `set()` rejects entries `> 100KB` and entries
+ *     that would push the page over 10MB. Both rejections log a warn
+ *     with `pluginName` + `pageId` and surface a `CacheSetReject`
+ *     code via the `setOrReject` helper used by the SWR wrapper.
+ *     Entries `> 50KB` but `< 100KB` warn but write.
+ */
+export declare class MongoCacheStorage implements CacheStorage {
+    private readonly deps;
+    constructor(deps: MongoCacheStorageDeps);
+    /**
+     * Read an entry. Returns null only when:
+     *   - row absent
+     *   - `pluginCacheVersion` mismatch (version bump is a logical miss)
+     *
+     * **`expiresAt < now` is NOT treated as a miss here.** The SWR
+     * wrapper (`cachedRender`) needs to see expired-but-within-stale-
+     * window entries to serve them while a background re-render runs.
+     * Entries past the SWR window are evicted by the wrapper itself
+     * after the blocking re-render; MongoDB's TTL sweep is the
+     * disk-reclaim safety net (RFC §"TTL index of operational note").
+     */
+    get(key: CacheKey): Promise<CacheEntry | null>;
+    /**
+     * Write an entry, replacing any existing row with the same compound
+     * key. Use `setOrReject` instead when callers need to know whether
+     * the write was rejected by size limits.
+     */
+    set(key: CacheKey, entry: CacheEntry): Promise<void>;
+    /**
+     * Like `set` but returns the rejection reason instead of silently
+     * dropping. Used by the SWR wrapper to fall back to a placeholder
+     * when an oversized payload would otherwise vanish from the cache.
+     */
+    setOrReject(key: CacheKey, entry: CacheEntry): Promise<CacheSetReject | null>;
+    /** Drop every cached entry for a page. Returns the number of deleted rows. */
+    invalidatePage(pageId: string): Promise<number>;
+    /** Drop every cached entry written by a single plugin. Returns the number of deleted rows. */
+    invalidatePlugin(pluginName: string): Promise<number>;
+    /** Drop every cached entry. Returns the number of deleted rows. */
+    invalidateAll(): Promise<number>;
+}
+/** Convenience factory that pulls the model + a logger from a Crowi instance. */
+export declare function createMongoCacheStorage(crowi: Crowi): MongoCacheStorage;

package/dist/renderer/cache/mongodb-cache.js

@@ -0,0 +1,180 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MongoCacheStorage = exports.PER_PAGE_REJECT_BYTES = exports.SINGLE_ENTRY_REJECT_BYTES = exports.SINGLE_ENTRY_WARN_BYTES = void 0;
+exports.createMongoCacheStorage = createMongoCacheStorage;
+const mongoose_1 = require("mongoose");
+/**
+ * Per-entry warn threshold. Logged but not rejected.
+ * RFC §"Size limits" — 50KB warn, 100KB reject.
+ */
+exports.SINGLE_ENTRY_WARN_BYTES = 50 * 1024;
+/** Per-entry reject threshold. Above this we drop the write and let the caller fall back to a placeholder. */
+exports.SINGLE_ENTRY_REJECT_BYTES = 100 * 1024;
+/** Per-page cumulative reject threshold. */
+exports.PER_PAGE_REJECT_BYTES = 10 * 1024 * 1024;
+/**
+ * MongoDB-backed implementation of `CacheStorage`. The schema +
+ * indexes live in `models/plugin-render-cache.ts`; this class is the
+ * thin query layer.
+ *
+ * Behaviour quirks worth noting:
+ *
+ *   - **TTL defence-in-depth.** MongoDB's TTL monitor sweeps every
+ *     ~60s, so a row whose `expiresAt` just elapsed may still be on
+ *     disk. `get()` checks `expiresAt < now` and treats the hit as a
+ *     miss + deletes the row so the next read is fast.
+ *
+ *   - **`pluginCacheVersion` mismatch = miss.** Plugins bump their
+ *     `cacheVersion` to invalidate every cached entry without an
+ *     operator action. We don't actively delete stale-version rows
+ *     (the TTL eventually does); we just refuse to return them.
+ *
+ *   - **Size limits.** `set()` rejects entries `> 100KB` and entries
+ *     that would push the page over 10MB. Both rejections log a warn
+ *     with `pluginName` + `pageId` and surface a `CacheSetReject`
+ *     code via the `setOrReject` helper used by the SWR wrapper.
+ *     Entries `> 50KB` but `< 100KB` warn but write.
+ */
+class MongoCacheStorage {
+    deps;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    /**
+     * Read an entry. Returns null only when:
+     *   - row absent
+     *   - `pluginCacheVersion` mismatch (version bump is a logical miss)
+     *
+     * **`expiresAt < now` is NOT treated as a miss here.** The SWR
+     * wrapper (`cachedRender`) needs to see expired-but-within-stale-
+     * window entries to serve them while a background re-render runs.
+     * Entries past the SWR window are evicted by the wrapper itself
+     * after the blocking re-render; MongoDB's TTL sweep is the
+     * disk-reclaim safety net (RFC §"TTL index of operational note").
+     */
+    async get(key) {
+        const filter = {
+            pageId: new mongoose_1.Types.ObjectId(key.pageId),
+            pluginName: key.pluginName,
+            embedKey: key.embedKey,
+            pluginCacheVersion: key.pluginCacheVersion,
+        };
+        const doc = await this.deps.PluginRenderCache.findOne(filter).lean().exec();
+        if (!doc)
+            return null;
+        return {
+            html: doc.html,
+            result: doc.result,
+            fetchedAt: doc.fetchedAt,
+            expiresAt: doc.expiresAt,
+        };
+    }
+    /**
+     * Write an entry, replacing any existing row with the same compound
+     * key. Use `setOrReject` instead when callers need to know whether
+     * the write was rejected by size limits.
+     */
+    async set(key, entry) {
+        await this.setOrReject(key, entry);
+    }
+    /**
+     * Like `set` but returns the rejection reason instead of silently
+     * dropping. Used by the SWR wrapper to fall back to a placeholder
+     * when an oversized payload would otherwise vanish from the cache.
+     */
+    async setOrReject(key, entry) {
+        const html = entry.html;
+        const htmlBytes = Buffer.byteLength(html, 'utf8');
+        if (htmlBytes > exports.SINGLE_ENTRY_REJECT_BYTES) {
+            this.deps.log.warn(`[plugin-render-cache] entry too large; refusing to write. pluginName=${key.pluginName} pageId=${key.pageId} bytes=${htmlBytes} (limit=${exports.SINGLE_ENTRY_REJECT_BYTES})`);
+            return 'entry-too-large';
+        }
+        if (htmlBytes > exports.SINGLE_ENTRY_WARN_BYTES) {
+            this.deps.log.warn(`[plugin-render-cache] entry exceeds warn threshold; writing anyway. pluginName=${key.pluginName} pageId=${key.pageId} bytes=${htmlBytes} (warn=${exports.SINGLE_ENTRY_WARN_BYTES})`);
+        }
+        // Per-page cumulative check. One aggregate computes the page-wide
+        // total and the existing-entry-for-this-key bytes simultaneously,
+        // so the projected total after the upsert can be checked in one
+        // round-trip (plus the upsert itself). `htmlBytes` is denormalised
+        // on the doc so the sum is a cheap `$sum: '$htmlBytes'` rather
+        // than `$strLenBytes` over every cached HTML string.
+        const pageId = new mongoose_1.Types.ObjectId(key.pageId);
+        const cumulative = await this.deps.PluginRenderCache.aggregate([
+            { $match: { pageId } },
+            {
+                $group: {
+                    _id: null,
+                    totalBytes: { $sum: '$htmlBytes' },
+                    existingBytes: {
+                        $sum: {
+                            $cond: [
+                                {
+                                    $and: [
+                                        { $eq: ['$pluginName', key.pluginName] },
+                                        { $eq: ['$embedKey', key.embedKey] },
+                                        { $eq: ['$pluginCacheVersion', key.pluginCacheVersion] },
+                                    ],
+                                },
+                                '$htmlBytes',
+                                0,
+                            ],
+                        },
+                    },
+                },
+            },
+        ]).exec();
+        const { totalBytes = 0, existingBytes = 0 } = cumulative[0] ?? {};
+        const projected = totalBytes - existingBytes + htmlBytes;
+        if (projected > exports.PER_PAGE_REJECT_BYTES) {
+            this.deps.log.warn(`[plugin-render-cache] page would exceed cumulative quota; refusing to write. pluginName=${key.pluginName} pageId=${key.pageId} projectedBytes=${projected} (limit=${exports.PER_PAGE_REJECT_BYTES})`);
+            return 'page-quota-exceeded';
+        }
+        await this.deps.PluginRenderCache.updateOne({
+            pageId,
+            pluginName: key.pluginName,
+            embedKey: key.embedKey,
+            pluginCacheVersion: key.pluginCacheVersion,
+        }, {
+            $set: {
+                pageId,
+                pluginName: key.pluginName,
+                embedKey: key.embedKey,
+                pluginCacheVersion: key.pluginCacheVersion,
+                html,
+                htmlBytes,
+                fetchedAt: entry.fetchedAt,
+                expiresAt: entry.expiresAt,
+                result: entry.result,
+            },
+        }, { upsert: true }).exec();
+        return null;
+    }
+    /** Drop every cached entry for a page. Returns the number of deleted rows. */
+    async invalidatePage(pageId) {
+        const res = await this.deps.PluginRenderCache.deleteMany({ pageId: new mongoose_1.Types.ObjectId(pageId) }).exec();
+        return res.deletedCount ?? 0;
+    }
+    /** Drop every cached entry written by a single plugin. Returns the number of deleted rows. */
+    async invalidatePlugin(pluginName) {
+        const res = await this.deps.PluginRenderCache.deleteMany({ pluginName }).exec();
+        return res.deletedCount ?? 0;
+    }
+    /** Drop every cached entry. Returns the number of deleted rows. */
+    async invalidateAll() {
+        const res = await this.deps.PluginRenderCache.deleteMany({}).exec();
+        return res.deletedCount ?? 0;
+    }
+}
+exports.MongoCacheStorage = MongoCacheStorage;
+/** Convenience factory that pulls the model + a logger from a Crowi instance. */
+function createMongoCacheStorage(crowi) {
+    const PluginRenderCache = crowi.model('PluginRenderCache');
+    return new MongoCacheStorage({
+        PluginRenderCache,
+        log: {
+            warn: (msg, ...args) => console.warn(msg, ...args),
+            debug: () => undefined,
+        },
+    });
+}
+//# sourceMappingURL=mongodb-cache.js.map

package/dist/renderer/cache/mongodb-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongodb-cache.js","sourceRoot":"","sources":["../../../src/renderer/cache/mongodb-cache.ts"],"names":[],"mappings":";;;AAqMA,0DASC;AA9MD,uCAAiC;AAKjC;;;GAGG;AACU,QAAA,uBAAuB,GAAG,EAAE,GAAG,IAAI,CAAC;AACjD,8GAA8G;AACjG,QAAA,yBAAyB,GAAG,GAAG,GAAG,IAAI,CAAC;AACpD,4CAA4C;AAC/B,QAAA,qBAAqB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AActD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAa,iBAAiB;IACC;IAA7B,YAA6B,IAA2B;QAA3B,SAAI,GAAJ,IAAI,CAAuB;IAAG,CAAC;IAE5D;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,GAAG,CAAC,GAAa;QACrB,MAAM,MAAM,GAAG;YACb,MAAM,EAAE,IAAI,gBAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC;YACtC,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,kBAAkB,EAAE,GAAG,CAAC,kBAAkB;SAC3C,CAAC;QACF,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,EAAoC,CAAC,IAAI,EAAE,CAAC;QAC9G,IAAI,CAAC,GAAG;YAAE,OAAO,IAAI,CAAC;QACtB,OAAO;YACL,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,SAAS,EAAE,GAAG,CAAC,SAAS;SACzB,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,GAAG,CAAC,GAAa,EAAE,KAAiB;QACxC,MAAM,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACrC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,WAAW,CAAC,GAAa,EAAE,KAAiB;QAChD,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACxB,MAAM,SAAS,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAElD,IAAI,SAAS,GAAG,iCAAyB,EAAE,CAAC;YAC1C,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAChB,wEAAwE,GAAG,CAAC,UAAU,WAAW,GAAG,CAAC,MAAM,UAAU,SAAS,WAAW,iCAAyB,GAAG,CACtK,CAAC;YACF,OAAO,iBAAiB,CAAC;QAC3B,CAAC;QACD,IAAI,SAAS,GAAG,+BAAuB,EAAE,CAAC;YACxC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAChB,kFAAkF,GAAG,CAAC,UAAU,WAAW,GAAG,CAAC,MAAM,UAAU,SAAS,UAAU,+BAAuB,GAAG,CAC7K,CAAC;QACJ,CAAC;QAED,kEAAkE;QAClE,kEAAkE;QAClE,gEAAgE;QAChE,mEAAmE;QACnE,+DAA+D;QAC/D,qDAAqD;QACrD,MAAM,MAAM,GAAG,IAAI,gBAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC9C,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAgD;YAC5G,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE;YACtB;gBACE,MAAM,EAAE;oBACN,GAAG,EAAE,IAAI;oBACT,UAAU,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE;oBAClC,aAAa,EAAE;wBACb,IAAI,EAAE;4BACJ,KAAK,EAAE;gCACL;oCACE,IAAI,EAAE;wCACJ,EAAE,GAAG,EAAE,CAAC,aAAa,EAAE,GAAG,CAAC,UAAU,CAAC,EAAE;wCACxC,EAAE,GAAG,EAAE,CAAC,WAAW,EAAE,GAAG,CAAC,QAAQ,CAAC,EAAE;wCACpC,EAAE,GAAG,EAAE,CAAC,qBAAqB,EAAE,GAAG,CAAC,kBAAkB,CAAC,EAAE;qCACzD;iCACF;gCACD,YAAY;gCACZ,CAAC;6BACF;yBACF;qBACF;iBACF;aACF;SACF,CAAC,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,EAAE,UAAU,GAAG,CAAC,EAAE,aAAa,GAAG,CAAC,EAAE,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAClE,MAAM,SAAS,GAAG,UAAU,GAAG,aAAa,GAAG,SAAS,CAAC;QACzD,IAAI,SAAS,GAAG,6BAAqB,EAAE,CAAC;YACtC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAChB,2FAA2F,GAAG,CAAC,UAAU,WAAW,GAAG,CAAC,MAAM,mBAAmB,SAAS,WAAW,6BAAqB,GAAG,CAC9L,CAAC;YACF,OAAO,qBAAqB,CAAC;QAC/B,CAAC;QAED,MAAM,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,SAAS,CACzC;YACE,MAAM;YACN,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,kBAAkB,EAAE,GAAG,CAAC,kBAAkB;SAC3C,EACD;YACE,IAAI,EAAE;gBACJ,MAAM;gBACN,UAAU,EAAE,GAAG,CAAC,UAAU;gBAC1B,QAAQ,EAAE,GAAG,CAAC,QAAQ;gBACtB,kBAAkB,EAAE,GAAG,CAAC,kBAAkB;gBAC1C,IAAI;gBACJ,SAAS;gBACT,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;gBAC1B,MAAM,EAAE,KAAK,CAAC,MAA6B;aAC5C;SACF,EACD,EAAE,MAAM,EAAE,IAAI,EAAE,CACjB,CAAC,IAAI,EAAE,CAAC;QACT,OAAO,IAAI,CAAC;IACd,CAAC;IAED,8EAA8E;IAC9E,KAAK,CAAC,cAAc,CAAC,MAAc;QACjC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,IAAI,gBAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACxG,OAAO,GAAG,CAAC,YAAY,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,8FAA8F;IAC9F,KAAK,CAAC,gBAAgB,CAAC,UAAkB;QACvC,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAChF,OAAO,GAAG,CAAC,YAAY,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,mEAAmE;IACnE,KAAK,CAAC,aAAa;QACjB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACpE,OAAO,GAAG,CAAC,YAAY,IAAI,CAAC,CAAC;IAC/B,CAAC;CACF;AAhJD,8CAgJC;AAED,iFAAiF;AACjF,SAAgB,uBAAuB,CAAC,KAAY;IAClD,MAAM,iBAAiB,GAAG,KAAK,CAAC,KAAK,CAAC,mBAAmB,CAAsC,CAAC;IAChG,OAAO,IAAI,iBAAiB,CAAC;QAC3B,iBAAiB;QACjB,GAAG,EAAE;YACH,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC;YAClD,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS;SACvB;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/renderer/cache/reservation.d.ts

@@ -0,0 +1,20 @@
+import type { RenderError, Reservation } from '@crowi/plugin-api';
+import type { CacheSetReject } from './mongodb-cache';
+/**
+ * Build the placeholder HTML for a given `Reservation`. Numeric
+ * values are coerced to integers via `Math.max(0, Math.round(n))` so
+ * a bogus float / negative declaration never produces malformed
+ * style attributes.
+ */
+export declare function renderReservation(reservation: Reservation): string;
+/**
+ * Placeholder HTML for a render error. The user-facing message comes
+ * from a fixed table per error code; plugin-supplied `error.message`
+ * never reaches the HTML (potential PII / API-key leak).
+ */
+export declare function errorPlaceholder(code: RenderError['code'], reservation: Reservation | undefined): string;
+/**
+ * Placeholder for a size-limit reject. We distinguish the two
+ * sub-cases so admin telemetry / e2e tests can tell them apart.
+ */
+export declare function sizeLimitPlaceholder(reason: CacheSetReject, reservation: Reservation | undefined): string;