@crowi/api 2.0.0-alpha.0

package/dist/hono/handlers/presence.js

@@ -0,0 +1,163 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerPresenceRoutes = void 0;
+/**
+ * RFC-0006 Phase 4 Batch 5 — `presence` resource Hono port.
+ *
+ * Replaces `packages/api/src/routes/ts-rest/presence.ts`. Two endpoints:
+ *
+ *   GET /pages/:id/presence-token — RFC-0005 viewer presence wsToken
+ *   GET /pages/:id/likers         — RFC-0005 Phase 3 liker list
+ *
+ * Auth shared with `page` / `page-preview` / `pageCollab`: the
+ * `revision` handler installs `createJwtAuth(crowi)` broadly on
+ * `/pages/*` (see `packages/api/src/hono/handlers/revision.ts`); this
+ * handler relies on register order (`revision -> page -> page-preview ->
+ * pageCollab -> presence -> notification` in `buildHonoApp`) and does
+ * NOT re-install jwtAuth — Hono does not dedupe middleware references.
+ *
+ * Behaviour parity (wire-format / authorisation), both endpoints:
+ *
+ *  - 401 if no Authorization header (`createJwtAuth`).
+ *  - 400 INVALID_PAGE_ID for non-hex `:id`.
+ *  - 404 PAGE_NOT_FOUND for missing-or-not-granted (existence leak
+ *    guard collapses both — same as collab / page resources).
+ *  - 500 INTERNAL_ERROR on signing / DB exception.
+ *
+ * Unlike `pageCollab`, there is no draft-author gate: presence is
+ * read-only viewer tracking, so any user with read grant can appear in
+ * the viewer list. A non-author already gets the 404 from
+ * `loadGrantedPage` when the page is private.
+ */
+const api_contract_1 = require("@crowi/api-contract");
+const debug_1 = __importDefault(require("debug"));
+const activityDefine_1 = __importDefault(require("../../util/activityDefine"));
+const presence_token_1 = require("../../util/presence-token");
+const ts_rest_helpers_1 = require("../../util/ts-rest-helpers");
+const errors_1 = require("./_helpers/errors");
+const debug = (0, debug_1.default)('crowi:hono:handlers:presence');
+const registerPresenceRoutes = (app, crowi) => {
+    const Page = crowi.model('Page');
+    const User = crowi.model('User');
+    const Activity = crowi.model('Activity');
+    // Resolve / sign helper once per server (closure-captures the secret).
+    // Same construction-time-capture caveat as `pageCollab`: tests pin
+    // `WS_TOKEN_SECRET` before importing `src/test/setup`.
+    const presenceTokenUtil = (0, presence_token_1.createPresenceTokenUtil)();
+    return (app
+        // --------------------------------------------------------------
+        // GET /pages/:id/presence-token
+        // --------------------------------------------------------------
+        .openapi(api_contract_1.getPresenceTokenRoute, async (c) => {
+        const user = c.get('user');
+        const { id: pageId } = c.req.valid('param');
+        debug('getPresenceToken called', { pageId, userId: user._id.toString() });
+        if (!(0, ts_rest_helpers_1.isValidObjectId)(pageId)) {
+            return c.json(errors_1.INVALID_PAGE_ID_BODY, 400);
+        }
+        const loaded = await (0, ts_rest_helpers_1.loadGrantedPage)(Page, pageId, user);
+        if ('error' in loaded) {
+            return c.json(errors_1.PAGE_NOT_FOUND_BODY, 404);
+        }
+        try {
+            const userId = user._id.toString();
+            const { token, expiresAt } = presenceTokenUtil.signPresenceToken({ userId, pageId });
+            return c.json({
+                token,
+                pageId,
+                selfUserId: userId,
+                expiresAt: expiresAt.toISOString(),
+            }, 200);
+        }
+        catch (err) {
+            debug('presence token signing failed:', err.message);
+            return c.json(errors_1.INTERNAL_ERROR_BODY, 500);
+        }
+    })
+        // --------------------------------------------------------------
+        // GET /pages/:id/likers — liked-by list (RFC-0005 Phase 3)
+        // --------------------------------------------------------------
+        //
+        // The liker list is sourced from `page.liker` (the authoritative
+        // ObjectId set). `likedAt` is a best-effort enrichment: we look
+        // up the `ACTION_LIKE` Activity rows for the page in one query
+        // and join them in. Entries without an Activity row keep
+        // `likedAt: null` (likes recorded before activity logging
+        // existed, or rows pruned by retention).
+        //
+        // Sorted newest-liked first; entries with an unknown `likedAt`
+        // sort last so the list order stays stable.
+        .openapi(api_contract_1.getLikersRoute, async (c) => {
+        const user = c.get('user');
+        const { id: pageId } = c.req.valid('param');
+        const { limit } = c.req.valid('query');
+        debug('getLikers called', { pageId, limit, userId: user._id.toString() });
+        if (!(0, ts_rest_helpers_1.isValidObjectId)(pageId)) {
+            return c.json(errors_1.INVALID_PAGE_ID_BODY, 400);
+        }
+        const loaded = await (0, ts_rest_helpers_1.loadGrantedPage)(Page, pageId, user);
+        if ('error' in loaded) {
+            return c.json(errors_1.PAGE_NOT_FOUND_BODY, 404);
+        }
+        try {
+            const likerIds = (loaded.page.liker ?? []).filter((id) => id != null);
+            const totalCount = likerIds.length;
+            if (totalCount === 0) {
+                return c.json({ users: [], totalCount }, 200);
+            }
+            // Best-effort `likedAt` join: map userId -> most recent LIKE
+            // activity. The two reads are independent, so run them together.
+            const [activities, populated] = await Promise.all([
+                Activity.find({
+                    target: loaded.page._id,
+                    targetModel: activityDefine_1.default.MODEL_PAGE,
+                    action: activityDefine_1.default.ACTION_LIKE,
+                })
+                    .select('user createdAt')
+                    .lean(),
+                User.findUsersByIds(likerIds),
+            ]);
+            const likedAtByUser = new Map();
+            for (const activity of activities) {
+                const uid = String(activity.user);
+                const at = activity.createdAt;
+                if (!at)
+                    continue;
+                const existing = likedAtByUser.get(uid);
+                if (!existing || at.getTime() > existing.getTime())
+                    likedAtByUser.set(uid, at);
+            }
+            const likers = populated.map((u) => {
+                const likedAt = likedAtByUser.get(u._id.toString());
+                return {
+                    id: u._id.toString(),
+                    username: u.username ?? '',
+                    displayName: u.name ?? u.username ?? '',
+                    avatarUrl: u.image ?? null,
+                    likedAt: likedAt ? likedAt.toISOString() : null,
+                };
+            });
+            // Newest-liked first; unknown `likedAt` sorts last.
+            likers.sort((a, b) => {
+                if (a.likedAt && b.likedAt)
+                    return b.likedAt.localeCompare(a.likedAt);
+                if (a.likedAt)
+                    return -1;
+                if (b.likedAt)
+                    return 1;
+                return 0;
+            });
+            const users = limit !== undefined ? likers.slice(0, limit) : likers;
+            return c.json({ users, totalCount }, 200);
+        }
+        catch (err) {
+            debug('getLikers failed:', err.message);
+            return c.json(errors_1.INTERNAL_ERROR_BODY, 500);
+        }
+    }));
+};
+exports.registerPresenceRoutes = registerPresenceRoutes;
+//# sourceMappingURL=presence.js.map

package/dist/hono/handlers/presence.js.map

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

package/dist/hono/handlers/revision.d.ts

@@ -0,0 +1,345 @@
+import type { OpenAPIHono } from '@hono/zod-openapi';
+import type Crowi from '../../crowi';
+import type { CrowiHonoBindings } from '../app';
+export declare const registerRevisionRoutes: <E extends OpenAPIHono<CrowiHonoBindings>>(app: E, crowi: Crowi) => OpenAPIHono<CrowiHonoBindings, {
+    "/pages/:page_id/revisions": {
+        $get: {
+            input: {
+                param: {
+                    page_id: string;
+                };
+            } & {
+                query: {
+                    limit?: unknown;
+                    offset?: unknown;
+                };
+            };
+            output: {
+                revisions: {
+                    _id: string;
+                    path: string;
+                    createdAt: string;
+                    author?: {
+                        _id: string;
+                        username: string;
+                        name: string;
+                        email: string;
+                        createdAt: string;
+                        id?: string | undefined;
+                        image?: string | null | undefined;
+                    } | null | undefined;
+                    savedBy?: {
+                        _id: string;
+                        username: string;
+                        name: string;
+                        email: string;
+                        createdAt: string;
+                        id?: string | undefined;
+                        image?: string | null | undefined;
+                    } | null | undefined;
+                    contributors?: {
+                        _id: string;
+                        username: string;
+                        name: string;
+                        email: string;
+                        createdAt: string;
+                        id?: string | undefined;
+                        image?: string | null | undefined;
+                    }[] | undefined;
+                    editVia?: "web" | "oauth" | "pat" | undefined;
+                }[];
+                pager: {
+                    prev: number | null;
+                    next: number | null;
+                    offset: number;
+                };
+            };
+            outputFormat: "json";
+            status: 200;
+        } | {
+            input: {
+                param: {
+                    page_id: string;
+                };
+            } & {
+                query: {
+                    limit?: unknown;
+                    offset?: unknown;
+                };
+            };
+            output: {
+                error: {
+                    code: "INVALID_REQUEST";
+                    message: string;
+                };
+            };
+            outputFormat: "json";
+            status: 400;
+        } | {
+            input: {
+                param: {
+                    page_id: string;
+                };
+            } & {
+                query: {
+                    limit?: unknown;
+                    offset?: unknown;
+                };
+            };
+            output: {
+                error: {
+                    code: "AUTHENTICATION_REQUIRED";
+                    message: "Authentication is required";
+                    redirectTo?: string | undefined;
+                };
+            };
+            outputFormat: "json";
+            status: 401;
+        } | {
+            input: {
+                param: {
+                    page_id: string;
+                };
+            } & {
+                query: {
+                    limit?: unknown;
+                    offset?: unknown;
+                };
+            };
+            output: {
+                error: {
+                    code: "PAGE_NOT_FOUND";
+                    message: "Page not found";
+                };
+            };
+            outputFormat: "json";
+            status: 404;
+        };
+    };
+} & {
+    "/pages/revisions": {
+        $get: {
+            input: {
+                query: {
+                    ids: string;
+                };
+            };
+            output: {
+                revisions: {
+                    _id: string;
+                    path: string;
+                    body: string;
+                    format: string;
+                    createdAt: string;
+                    author?: {
+                        _id: string;
+                        username: string;
+                        name: string;
+                        email: string;
+                        createdAt: string;
+                        id?: string | undefined;
+                        image?: string | null | undefined;
+                    } | null | undefined;
+                    meta?: {
+                        toc?: {
+                            level: number;
+                            text: string;
+                            anchorId: string;
+                        }[] | undefined;
+                        wikiLinks?: {
+                            raw: string;
+                            target: string;
+                            displayText?: string | undefined;
+                        }[] | undefined;
+                        mentions?: {
+                            username: string;
+                        }[] | undefined;
+                        codeBlockLanguages?: string[] | undefined;
+                    } | undefined;
+                    renderedAst?: import("hono/utils/types").JSONValue | undefined;
+                    rendererVersion?: string | undefined;
+                    parentRevisionId?: string | null | undefined;
+                    type?: "snapshot" | "incremental" | undefined;
+                    savedBy?: string | {
+                        _id: string;
+                        username: string;
+                        name: string;
+                        email: string;
+                        createdAt: string;
+                        id?: string | undefined;
+                        image?: string | null | undefined;
+                    } | null | undefined;
+                    contributors?: (string | {
+                        _id: string;
+                        username: string;
+                        name: string;
+                        email: string;
+                        createdAt: string;
+                        id?: string | undefined;
+                        image?: string | null | undefined;
+                    })[] | undefined;
+                    message?: string | undefined;
+                    editVia?: "web" | "oauth" | "pat" | undefined;
+                }[];
+            };
+            outputFormat: "json";
+            status: 200;
+        } | {
+            input: {
+                query: {
+                    ids: string;
+                };
+            };
+            output: {
+                error: {
+                    code: "INVALID_REQUEST";
+                    message: string;
+                };
+            };
+            outputFormat: "json";
+            status: 400;
+        } | {
+            input: {
+                query: {
+                    ids: string;
+                };
+            };
+            output: {
+                error: {
+                    code: "AUTHENTICATION_REQUIRED";
+                    message: "Authentication is required";
+                    redirectTo?: string | undefined;
+                };
+            };
+            outputFormat: "json";
+            status: 401;
+        } | {
+            input: {
+                query: {
+                    ids: string;
+                };
+            };
+            output: {
+                error: {
+                    code: "PAGE_NOT_FOUND";
+                    message: "Page not found";
+                };
+            };
+            outputFormat: "json";
+            status: 404;
+        };
+    };
+} & {
+    "/pages/revisions/:id": {
+        $get: {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                revision: {
+                    _id: string;
+                    path: string;
+                    body: string;
+                    format: string;
+                    createdAt: string;
+                    author?: {
+                        _id: string;
+                        username: string;
+                        name: string;
+                        email: string;
+                        createdAt: string;
+                        id?: string | undefined;
+                        image?: string | null | undefined;
+                    } | null | undefined;
+                    meta?: {
+                        toc?: {
+                            level: number;
+                            text: string;
+                            anchorId: string;
+                        }[] | undefined;
+                        wikiLinks?: {
+                            raw: string;
+                            target: string;
+                            displayText?: string | undefined;
+                        }[] | undefined;
+                        mentions?: {
+                            username: string;
+                        }[] | undefined;
+                        codeBlockLanguages?: string[] | undefined;
+                    } | undefined;
+                    renderedAst?: import("hono/utils/types").JSONValue | undefined;
+                    rendererVersion?: string | undefined;
+                    parentRevisionId?: string | null | undefined;
+                    type?: "snapshot" | "incremental" | undefined;
+                    savedBy?: string | {
+                        _id: string;
+                        username: string;
+                        name: string;
+                        email: string;
+                        createdAt: string;
+                        id?: string | undefined;
+                        image?: string | null | undefined;
+                    } | null | undefined;
+                    contributors?: (string | {
+                        _id: string;
+                        username: string;
+                        name: string;
+                        email: string;
+                        createdAt: string;
+                        id?: string | undefined;
+                        image?: string | null | undefined;
+                    })[] | undefined;
+                    message?: string | undefined;
+                    editVia?: "web" | "oauth" | "pat" | undefined;
+                };
+            };
+            outputFormat: "json";
+            status: 200;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: {
+                    code: "INVALID_REQUEST";
+                    message: string;
+                };
+            };
+            outputFormat: "json";
+            status: 400;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: {
+                    code: "AUTHENTICATION_REQUIRED";
+                    message: "Authentication is required";
+                    redirectTo?: string | undefined;
+                };
+            };
+            outputFormat: "json";
+            status: 401;
+        } | {
+            input: {
+                param: {
+                    id: string;
+                };
+            };
+            output: {
+                error: {
+                    code: "PAGE_NOT_FOUND";
+                    message: "Page not found";
+                };
+            };
+            outputFormat: "json";
+            status: 404;
+        };
+    };
+}, "/">;