@kernhq/module-quire 0.3.0 → 0.4.0

package/dist/server/services/comments.d.ts

@@ -0,0 +1,172 @@
+import type { Principal } from '@kernhq/contracts';
+import { type Tx } from '@kernhq/kernel';
+import type { Comment } from '../../contract/index.js';
+import { comments } from '../schema.js';
+import type { QuireAccess } from './access.js';
+type CommentRow = typeof comments.$inferSelect;
+export declare function toComment(row: CommentRow): Comment;
+/**
+ * Flatten a comment body to text, for search and for a notification's one-line preview.
+ *
+ * Deliberately dumb: it walks whatever the editor produced and takes the `text` leaves. A renderer
+ * that understood every node would have to be kept in step with the editor's schema, and the only
+ * thing this is used for is a line of plain prose.
+ */
+export declare function flattenBody(body: unknown): string;
+/** Every user id mentioned in the body, so they can be notified without a second parse. */
+export declare function mentionsIn(body: unknown): string[];
+export declare function quireComments(access: QuireAccess): {
+    list(tx: Tx, workspaceId: string, pageId: string, includeResolved: boolean): Promise<{
+        id: string;
+        root: {
+            id: string;
+            workspaceId: string & import("zod").$brand<"WorkspaceId">;
+            pageId: string;
+            parentId: string | null;
+            threadId: string;
+            authorId: (string & import("zod").$brand<"UserId">) | null;
+            body: Record<string, unknown>;
+            bodyText: string;
+            mentionIds: (string & import("zod").$brand<"UserId">)[];
+            anchor: {
+                from: string;
+                to: string;
+            } | null;
+            quotedText: string;
+            resolvedAt: string | null;
+            resolvedBy: (string & import("zod").$brand<"UserId">) | null;
+            editedAt: string | null;
+            createdAt: string;
+        };
+        replies: {
+            id: string;
+            workspaceId: string & import("zod").$brand<"WorkspaceId">;
+            pageId: string;
+            parentId: string | null;
+            threadId: string;
+            authorId: (string & import("zod").$brand<"UserId">) | null;
+            body: Record<string, unknown>;
+            bodyText: string;
+            mentionIds: (string & import("zod").$brand<"UserId">)[];
+            anchor: {
+                from: string;
+                to: string;
+            } | null;
+            quotedText: string;
+            resolvedAt: string | null;
+            resolvedBy: (string & import("zod").$brand<"UserId">) | null;
+            editedAt: string | null;
+            createdAt: string;
+        }[];
+        resolved: boolean;
+    }[]>;
+    row(tx: Tx, workspaceId: string, commentId: string): Promise<{
+        id: string;
+        workspaceId: string;
+        pageId: string;
+        parentId: string | null;
+        threadId: string;
+        authorId: string | null;
+        body: unknown;
+        bodyText: string;
+        mentionIds: string[];
+        anchor: unknown;
+        quotedText: string;
+        resolvedAt: Date | null;
+        resolvedBy: string | null;
+        editedAt: Date | null;
+        deletedAt: Date | null;
+        createdAt: Date;
+        updatedAt: Date;
+    }>;
+    create(tx: Tx, principal: Principal, workspaceId: string, input: {
+        pageId: string;
+        body: Record<string, unknown>;
+        anchor: {
+            from: string;
+            to: string;
+        } | null;
+        quotedText: string;
+        parentId: string | null;
+    }): Promise<{
+        id: string;
+        pageId: string;
+        workspaceId: string;
+        anchor: unknown;
+        parentId: string | null;
+        createdAt: Date;
+        updatedAt: Date;
+        deletedAt: Date | null;
+        authorId: string | null;
+        threadId: string;
+        body: unknown;
+        bodyText: string;
+        mentionIds: string[];
+        quotedText: string;
+        resolvedAt: Date | null;
+        resolvedBy: string | null;
+        editedAt: Date | null;
+    }>;
+    update(tx: Tx, principal: Principal, workspaceId: string, commentId: string, body: Record<string, unknown>): Promise<{
+        id: string;
+        workspaceId: string;
+        pageId: string;
+        parentId: string | null;
+        threadId: string;
+        authorId: string | null;
+        body: unknown;
+        bodyText: string;
+        mentionIds: string[];
+        anchor: unknown;
+        quotedText: string;
+        resolvedAt: Date | null;
+        resolvedBy: string | null;
+        editedAt: Date | null;
+        deletedAt: Date | null;
+        createdAt: Date;
+        updatedAt: Date;
+    }>;
+    /** Soft, so a thread does not lose its shape when one remark in the middle goes. */
+    remove(tx: Tx, principal: Principal, workspaceId: string, commentId: string): Promise<{
+        id: string;
+        workspaceId: string;
+        pageId: string;
+        parentId: string | null;
+        threadId: string;
+        authorId: string | null;
+        body: unknown;
+        bodyText: string;
+        mentionIds: string[];
+        anchor: unknown;
+        quotedText: string;
+        resolvedAt: Date | null;
+        resolvedBy: string | null;
+        editedAt: Date | null;
+        deletedAt: Date | null;
+        createdAt: Date;
+        updatedAt: Date;
+    }>;
+    /** Resolving is a property of the thread, so it is written on the root. */
+    resolve(tx: Tx, principal: Principal, workspaceId: string, commentId: string, resolved: boolean): Promise<{
+        id: string;
+        workspaceId: string;
+        pageId: string;
+        parentId: string | null;
+        threadId: string;
+        authorId: string | null;
+        body: unknown;
+        bodyText: string;
+        mentionIds: string[];
+        anchor: unknown;
+        quotedText: string;
+        resolvedAt: Date | null;
+        resolvedBy: string | null;
+        editedAt: Date | null;
+        deletedAt: Date | null;
+        createdAt: Date;
+        updatedAt: Date;
+    }>;
+};
+export type QuireComments = ReturnType<typeof quireComments>;
+export {};
+//# sourceMappingURL=comments.d.ts.map

package/dist/server/services/comments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comments.d.ts","sourceRoot":"","sources":["../../../src/server/services/comments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,EAAa,KAAK,EAAE,EAAU,MAAM,gBAAgB,CAAA;AAE3D,OAAO,KAAK,EAAE,OAAO,EAAiB,MAAM,yBAAyB,CAAA;AACrE,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AACvC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C,KAAK,UAAU,GAAG,OAAO,QAAQ,CAAC,YAAY,CAAA;AAE9C,wBAAgB,SAAS,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAkBlD;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAUjD;AAED,2FAA2F;AAC3F,wBAAgB,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,EAAE,CAUlD;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW;aAE9B,EAAE,eAAe,MAAM,UAAU,MAAM,mBAAmB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YAoClE,EAAE,eAAe,MAAM,aAAa,MAAM;;;;;;;;;;;;;;;;;;;eAalD,EAAE,aACK,SAAS,eACP,MAAM,SACZ;QACL,MAAM,EAAE,MAAM,CAAA;QACd,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QAC7B,MAAM,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,EAAE,EAAE,MAAM,CAAA;SAAE,GAAG,IAAI,CAAA;QAC3C,UAAU,EAAE,MAAM,CAAA;QAClB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KACxB;;;;;;;;;;;;;;;;;;;eAkCG,EAAE,aACK,SAAS,eACP,MAAM,aACR,MAAM,QACX,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;;;;;;;;;;;;;;;IAmB/B,oFAAoF;eACnE,EAAE,aAAa,SAAS,eAAe,MAAM,aAAa,MAAM;;;;;;;;;;;;;;;;;;;IAajF,2EAA2E;gBACzD,EAAE,aAAa,SAAS,eAAe,MAAM,aAAa,MAAM,YAAY,OAAO;;;;;;;;;;;;;;;;;;;EAaxG;AACD,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAA"}

package/dist/server/services/comments.js

@@ -0,0 +1,182 @@
+import { KernError, uuidv7 } from '@kernhq/kernel';
+import { and, asc, eq, isNull } from 'drizzle-orm';
+import { comments } from '../schema.js';
+export function toComment(row) {
+    return {
+        id: row.id,
+        workspaceId: row.workspaceId,
+        pageId: row.pageId,
+        parentId: row.parentId,
+        threadId: row.threadId,
+        authorId: row.authorId,
+        body: row.body,
+        bodyText: row.bodyText,
+        mentionIds: row.mentionIds,
+        anchor: row.anchor,
+        quotedText: row.quotedText,
+        resolvedAt: row.resolvedAt?.toISOString() ?? null,
+        resolvedBy: row.resolvedBy,
+        editedAt: row.editedAt?.toISOString() ?? null,
+        createdAt: row.createdAt.toISOString(),
+    };
+}
+/**
+ * Flatten a comment body to text, for search and for a notification's one-line preview.
+ *
+ * Deliberately dumb: it walks whatever the editor produced and takes the `text` leaves. A renderer
+ * that understood every node would have to be kept in step with the editor's schema, and the only
+ * thing this is used for is a line of plain prose.
+ */
+export function flattenBody(body) {
+    const out = [];
+    const walk = (node) => {
+        if (!node || typeof node !== 'object')
+            return;
+        const n = node;
+        if (typeof n.text === 'string')
+            out.push(n.text);
+        if (Array.isArray(n.content))
+            for (const child of n.content)
+                walk(child);
+    };
+    walk(body);
+    return out.join(' ').replace(/\s+/g, ' ').trim();
+}
+/** Every user id mentioned in the body, so they can be notified without a second parse. */
+export function mentionsIn(body) {
+    const ids = new Set();
+    const walk = (node) => {
+        if (!node || typeof node !== 'object')
+            return;
+        const n = node;
+        if (n.type === 'mention' && typeof n.attrs?.id === 'string')
+            ids.add(n.attrs.id);
+        if (Array.isArray(n.content))
+            for (const child of n.content)
+                walk(child);
+    };
+    walk(body);
+    return [...ids];
+}
+export function quireComments(access) {
+    return {
+        async list(tx, workspaceId, pageId, includeResolved) {
+            await access.pageRow(tx, workspaceId, pageId);
+            const rows = await tx
+                .select()
+                .from(comments)
+                .where(and(eq(comments.workspaceId, workspaceId), eq(comments.pageId, pageId), isNull(comments.deletedAt)))
+                .orderBy(asc(comments.createdAt));
+            const byThread = new Map();
+            for (const row of rows) {
+                const list = byThread.get(row.threadId) ?? [];
+                list.push(row);
+                byThread.set(row.threadId, list);
+            }
+            const threads = [];
+            for (const [threadId, list] of byThread) {
+                const root = list.find((r) => r.id === threadId);
+                // A thread whose root was deleted while replies remain: the replies are still somebody's
+                // words, so the thread is kept and the oldest remaining comment leads it.
+                const lead = root ?? list[0];
+                if (!lead)
+                    continue;
+                const resolved = Boolean(lead.resolvedAt);
+                if (resolved && !includeResolved)
+                    continue;
+                threads.push({
+                    id: threadId,
+                    root: toComment(lead),
+                    replies: list.filter((r) => r.id !== lead.id).map(toComment),
+                    resolved,
+                });
+            }
+            return threads;
+        },
+        async row(tx, workspaceId, commentId) {
+            const [row] = await tx
+                .select()
+                .from(comments)
+                .where(and(eq(comments.workspaceId, workspaceId), eq(comments.id, commentId), isNull(comments.deletedAt)))
+                .limit(1);
+            if (!row)
+                throw KernError.notFound('Comment');
+            return row;
+        },
+        async create(tx, principal, workspaceId, input) {
+            await access.pageRow(tx, workspaceId, input.pageId);
+            let threadId = uuidv7();
+            if (input.parentId) {
+                const parent = await this.row(tx, workspaceId, input.parentId);
+                if (parent.pageId !== input.pageId)
+                    throw KernError.badRequest('That comment is on a different page');
+                // Replying to a reply joins the thread rather than nesting further: a margin note is a
+                // conversation, and arbitrary depth in a 320px column is unreadable.
+                threadId = parent.threadId;
+            }
+            const id = uuidv7();
+            const [row] = await tx
+                .insert(comments)
+                .values({
+                id,
+                workspaceId,
+                pageId: input.pageId,
+                parentId: input.parentId,
+                threadId: input.parentId ? threadId : id,
+                authorId: principal.userId,
+                body: input.body,
+                bodyText: flattenBody(input.body),
+                mentionIds: mentionsIn(input.body),
+                anchor: input.anchor,
+                quotedText: input.quotedText,
+            })
+                .returning();
+            return row;
+        },
+        async update(tx, principal, workspaceId, commentId, body) {
+            const row = await this.row(tx, workspaceId, commentId);
+            // Editing somebody else's words is not a permission anybody should hold.
+            if (row.authorId !== principal.userId)
+                throw KernError.forbidden('quire.page.comment');
+            const [updated] = await tx
+                .update(comments)
+                .set({
+                body,
+                bodyText: flattenBody(body),
+                mentionIds: mentionsIn(body),
+                editedAt: new Date(),
+                updatedAt: new Date(),
+            })
+                .where(and(eq(comments.workspaceId, workspaceId), eq(comments.id, commentId)))
+                .returning();
+            return updated;
+        },
+        /** Soft, so a thread does not lose its shape when one remark in the middle goes. */
+        async remove(tx, principal, workspaceId, commentId) {
+            const row = await this.row(tx, workspaceId, commentId);
+            if (row.authorId !== principal.userId && !principal.instanceAdmin) {
+                const scope = await access.scopeOf(tx, workspaceId, row.pageId);
+                await access.requirePage(principal, 'quire.page.manage', workspaceId, scope);
+            }
+            await tx
+                .update(comments)
+                .set({ deletedAt: new Date(), updatedAt: new Date() })
+                .where(and(eq(comments.workspaceId, workspaceId), eq(comments.id, commentId)));
+            return row;
+        },
+        /** Resolving is a property of the thread, so it is written on the root. */
+        async resolve(tx, principal, workspaceId, commentId, resolved) {
+            const row = await this.row(tx, workspaceId, commentId);
+            await tx
+                .update(comments)
+                .set({
+                resolvedAt: resolved ? new Date() : null,
+                resolvedBy: resolved ? principal.userId : null,
+                updatedAt: new Date(),
+            })
+                .where(and(eq(comments.workspaceId, workspaceId), eq(comments.id, row.threadId)));
+            return row;
+        },
+    };
+}
+//# sourceMappingURL=comments.js.map

package/dist/server/services/comments.js.map

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

package/dist/server/services/index.d.ts

@@ -1,5 +1,6 @@
 import type { Kernel } from '@kernhq/kernel';
 import { quireAccess } from './access.js';
+import { quireComments } from './comments.js';
 import { quirePages } from './pages.js';
 import { quireSpaces } from './spaces.js';
 import { quireVersions } from './versions.js';
@@ -8,10 +9,12 @@ export interface QuireServices {
     spaces: ReturnType<typeof quireSpaces>;
     pages: ReturnType<typeof quirePages>;
     versions: ReturnType<typeof quireVersions>;
+    comments: ReturnType<typeof quireComments>;
 }
 /** One set of services per kernel: they are stateless, and rebuilding them per request is waste. */
 export declare function quireServices(kernel: Kernel): QuireServices;
 export * from './access.js';
+export * from './comments.js';
 export * from './pages.js';
 export * from './spaces.js';
 export * from './versions.js';

package/dist/server/services/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAE7C,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAA;IACtC,MAAM,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAA;IACtC,KAAK,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAA;IACpC,QAAQ,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAA;CAC3C;AAID,oGAAoG;AACpG,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAY3D;AAED,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/services/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAE7C,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAA;IACtC,MAAM,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,CAAA;IACtC,KAAK,EAAE,UAAU,CAAC,OAAO,UAAU,CAAC,CAAA;IACpC,QAAQ,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAA;IAC1C,QAAQ,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC,CAAA;CAC3C;AAID,oGAAoG;AACpG,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAa3D;AAED,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA"}

package/dist/server/services/index.js

@@ -1,4 +1,5 @@
 import { quireAccess } from './access.js';
+import { quireComments } from './comments.js';
 import { quirePages } from './pages.js';
 import { quireSpaces } from './spaces.js';
 import { quireVersions } from './versions.js';
@@ -14,11 +15,13 @@ export function quireServices(kernel) {
         spaces: quireSpaces(access),
         pages: quirePages(access),
         versions: quireVersions(kernel, access),
+        comments: quireComments(access),
     };
     cache.set(kernel, services);
     return services;
 }
 export * from './access.js';
+export * from './comments.js';
 export * from './pages.js';
 export * from './spaces.js';
 export * from './versions.js';

package/dist/server/services/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/server/services/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAS7C,MAAM,KAAK,GAAG,IAAI,OAAO,EAAyB,CAAA;AAElD,oGAAoG;AACpG,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IAClC,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAA;IAC7B,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAA;IAClC,MAAM,QAAQ,GAAkB;QAC9B,MAAM;QACN,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC;QAC3B,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC;QACzB,QAAQ,EAAE,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC;KACxC,CAAA;IACD,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IAC3B,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/server/services/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAU7C,MAAM,KAAK,GAAG,IAAI,OAAO,EAAyB,CAAA;AAElD,oGAAoG;AACpG,MAAM,UAAU,aAAa,CAAC,MAAc;IAC1C,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IAClC,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAA;IAC7B,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAA;IAClC,MAAM,QAAQ,GAAkB;QAC9B,MAAM;QACN,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC;QAC3B,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC;QACzB,QAAQ,EAAE,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC;QACvC,QAAQ,EAAE,aAAa,CAAC,MAAM,CAAC;KAChC,CAAA;IACD,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;IAC3B,OAAO,QAAQ,CAAA;AACjB,CAAC;AAED,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA"}

package/dist/server/services/notify.d.ts

@@ -0,0 +1,24 @@
+import type { core } from '@kernhq/contracts';
+import type { Kernel } from '@kernhq/kernel';
+import type { comments } from '../schema.js';
+/**
+ * Everything Quire tells the rest of the platform about, and nothing it needs an answer from.
+ *
+ * Every call here is best effort. A page must not fail to save, and a comment must not fail to
+ * post, because core is briefly unavailable — the module's own row is the authoritative record and
+ * a missing notification is a smaller loss than a refused write. Failures are logged, not raised.
+ */
+export declare function createNotify(kernel: Kernel): {
+    /**
+     * Tell everyone named in a comment, except whoever wrote it.
+     *
+     * Notifying somebody that they mentioned themselves is noise, and it is the commonest way an
+     * inbox stops being read.
+     */
+    mentions(workspaceId: string, comment: typeof comments.$inferSelect, actorId: string | null): Promise<void>;
+    /** Put a page in the workspace search index. */
+    index(documents: core.SearchDocument[]): Promise<void>;
+    unindex(workspaceId: string, type: string, ids: string[]): Promise<void>;
+};
+export type QuireNotify = ReturnType<typeof createNotify>;
+//# sourceMappingURL=notify.d.ts.map

package/dist/server/services/notify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notify.d.ts","sourceRoot":"","sources":["../../../src/server/services/notify.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAA;AAC7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAE5C;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM;IAWvC;;;;;OAKG;0BACyB,MAAM,WAAW,OAAO,QAAQ,CAAC,YAAY,WAAW,MAAM,GAAG,IAAI;IAoBjG,gDAAgD;qBACzB,IAAI,CAAC,cAAc,EAAE;yBAKjB,MAAM,QAAQ,MAAM,OAAO,MAAM,EAAE;EASjE;AACD,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAA"}

package/dist/server/services/notify.js

@@ -0,0 +1,54 @@
+/**
+ * Everything Quire tells the rest of the platform about, and nothing it needs an answer from.
+ *
+ * Every call here is best effort. A page must not fail to save, and a comment must not fail to
+ * post, because core is briefly unavailable — the module's own row is the authoritative record and
+ * a missing notification is a smaller loss than a refused write. Failures are logged, not raised.
+ */
+export function createNotify(kernel) {
+    const best = async (what, fn) => {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            kernel.log.warn({ err: String(err), what }, 'quire side effect failed');
+            return null;
+        }
+    };
+    return {
+        /**
+         * Tell everyone named in a comment, except whoever wrote it.
+         *
+         * Notifying somebody that they mentioned themselves is noise, and it is the commonest way an
+         * inbox stops being read.
+         */
+        async mentions(workspaceId, comment, actorId) {
+            const targets = comment.mentionIds.filter((id) => id !== actorId);
+            if (targets.length === 0)
+                return;
+            await best('notifications.create', () => Promise.all(targets.map((userId) => kernel.call('core.notifications.create', {
+                workspaceId,
+                userId,
+                type: 'quire.mention',
+                actorId,
+                object: { module: 'quire', type: 'page', id: comment.pageId },
+                title: comment.bodyText.slice(0, 140),
+                body: comment.quotedText.slice(0, 200) || null,
+            }))));
+        },
+        /** Put a page in the workspace search index. */
+        async index(documents) {
+            if (documents.length === 0)
+                return;
+            await best('search.index', () => kernel.call('core.search.index', { documents }));
+        },
+        async unindex(workspaceId, type, ids) {
+            if (ids.length === 0)
+                return;
+            await best('search.remove', () => kernel.call('core.search.remove', {
+                refs: ids.map((id) => ({ workspaceId, module: 'quire', type, id })),
+            }));
+        },
+    };
+}
+//# sourceMappingURL=notify.js.map

package/dist/server/services/notify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notify.js","sourceRoot":"","sources":["../../../src/server/services/notify.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,MAAM,IAAI,GAAG,KAAK,EAAK,IAAY,EAAE,EAAoB,EAAqB,EAAE;QAC9E,IAAI,CAAC;YACH,OAAO,MAAM,EAAE,EAAE,CAAA;QACnB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,EAAE,0BAA0B,CAAC,CAAA;YACvE,OAAO,IAAI,CAAA;QACb,CAAC;IACH,CAAC,CAAA;IAED,OAAO;QACL;;;;;WAKG;QACH,KAAK,CAAC,QAAQ,CAAC,WAAmB,EAAE,OAAqC,EAAE,OAAsB;YAC/F,MAAM,OAAO,GAAI,OAAO,CAAC,UAAuB,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,OAAO,CAAC,CAAA;YAC/E,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAM;YAChC,MAAM,IAAI,CAAC,sBAAsB,EAAE,GAAG,EAAE,CACtC,OAAO,CAAC,GAAG,CACT,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CACrB,MAAM,CAAC,IAAI,CAAC,2BAA2B,EAAE;gBACvC,WAAW;gBACX,MAAM;gBACN,IAAI,EAAE,eAAe;gBACrB,OAAO;gBACP,MAAM,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,CAAC,MAAM,EAAE;gBAC7D,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;gBACrC,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,IAAI,IAAI;aAC/C,CAAC,CACH,CACF,CACF,CAAA;QACH,CAAC;QAED,gDAAgD;QAChD,KAAK,CAAC,KAAK,CAAC,SAAgC;YAC1C,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAM;YAClC,MAAM,IAAI,CAAC,cAAc,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,CAAA;QACnF,CAAC;QAED,KAAK,CAAC,OAAO,CAAC,WAAmB,EAAE,IAAY,EAAE,GAAa;YAC5D,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAM;YAC5B,MAAM,IAAI,CAAC,eAAe,EAAE,GAAG,EAAE,CAC/B,MAAM,CAAC,IAAI,CAAC,oBAAoB,EAAE;gBAChC,IAAI,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;aACpE,CAAC,CACH,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/migrations/0003_comments.sql

@@ -0,0 +1,30 @@
+CREATE TABLE IF NOT EXISTS "mod_quire"."comments" (
+	"id" uuid PRIMARY KEY DEFAULT uuidv7() NOT NULL,
+	"workspace_id" uuid NOT NULL,
+	"page_id" uuid NOT NULL,
+	"parent_id" uuid,
+	"thread_id" uuid NOT NULL,
+	"author_id" uuid,
+	"body" jsonb DEFAULT '{}'::jsonb NOT NULL,
+	"body_text" text DEFAULT '' NOT NULL,
+	"mention_ids" uuid[] DEFAULT '{}'::uuid[] NOT NULL,
+	"anchor" jsonb,
+	"quoted_text" text DEFAULT '' NOT NULL,
+	"resolved_at" timestamp with time zone,
+	"resolved_by" uuid,
+	"edited_at" timestamp with time zone,
+	"deleted_at" timestamp with time zone,
+	"created_at" timestamp with time zone DEFAULT now() NOT NULL,
+	"updated_at" timestamp with time zone DEFAULT now() NOT NULL
+);
+--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS "comments_ws_page_idx" ON "mod_quire"."comments" USING btree ("workspace_id","page_id","created_at");--> statement-breakpoint
+CREATE INDEX IF NOT EXISTS "comments_ws_thread_idx" ON "mod_quire"."comments" USING btree ("workspace_id","thread_id","created_at");--> statement-breakpoint
+
+-- Row-level security, the same triple every tenant table gets.
+ALTER TABLE "mod_quire"."comments" ENABLE ROW LEVEL SECURITY;--> statement-breakpoint
+ALTER TABLE "mod_quire"."comments" FORCE ROW LEVEL SECURITY;--> statement-breakpoint
+DROP POLICY IF EXISTS "comments_ws_isolation" ON "mod_quire"."comments";--> statement-breakpoint
+CREATE POLICY "comments_ws_isolation" ON "mod_quire"."comments"
+  USING (workspace_id::text = current_setting('app.workspace_id', true))
+  WITH CHECK (workspace_id::text = current_setting('app.workspace_id', true));