@btst/stack 2.7.0 → 2.8.0

package/dist/plugins/comments/query-keys.d.cts

@@ -0,0 +1,71 @@
+import * as _tanstack_react_query from '@tanstack/react-query';
+import { b as CommentsListDiscriminator, C as CommentListResult, c as CommentCountDiscriminator, a as CommentsThreadDiscriminator } from '../../shared/stack.C-b3Sn8j.cjs';
+import { createApiClient } from '@btst/stack/plugins/client';
+import { C as CommentsApiRouter } from '../../shared/stack.CmHRdhl8.cjs';
+import '@btst/stack/plugins/api';
+import 'better-call';
+import 'zod';
+
+interface CommentsListParams {
+    resourceId?: string;
+    resourceType?: string;
+    parentId?: string | null;
+    status?: "pending" | "approved" | "spam";
+    currentUserId?: string;
+    authorId?: string;
+    sort?: "asc" | "desc";
+    limit?: number;
+    offset?: number;
+}
+interface CommentCountParams {
+    resourceId: string;
+    resourceType: string;
+    status?: "pending" | "approved" | "spam";
+}
+declare function createCommentsQueryKeys(client: ReturnType<typeof createApiClient<CommentsApiRouter>>, headers?: HeadersInit): {
+    comments: {
+        _def: readonly ["comments"];
+    } & {
+        list: ((params?: CommentsListParams | undefined) => Omit<{
+            queryKey: readonly ["comments", "list", CommentsListDiscriminator];
+            queryFn: _tanstack_react_query.QueryFunction<CommentListResult, readonly ["comments", "list", CommentsListDiscriminator]>;
+        } & {
+            _def: readonly ["comments", "list"];
+        }, "_def">) & {
+            _def: readonly ["comments", "list"];
+        };
+    };
+    commentCount: {
+        _def: readonly ["commentCount"];
+    } & {
+        byResource: ((params: CommentCountParams) => Omit<{
+            queryKey: readonly ["commentCount", "byResource", CommentCountDiscriminator];
+            queryFn: _tanstack_react_query.QueryFunction<number, readonly ["commentCount", "byResource", CommentCountDiscriminator]>;
+        } & {
+            _def: readonly ["commentCount", "byResource"];
+        }, "_def">) & {
+            _def: readonly ["commentCount", "byResource"];
+        };
+    };
+    commentsThread: {
+        _def: readonly ["commentsThread"];
+    } & {
+        list: ((params?: {
+            resourceId?: string;
+            resourceType?: string;
+            parentId?: string | null;
+            status?: "pending" | "approved" | "spam";
+            currentUserId?: string;
+            limit?: number;
+        } | undefined) => Omit<Omit<{
+            queryKey: readonly ["commentsThread", "list", CommentsThreadDiscriminator];
+            queryFn: _tanstack_react_query.QueryFunction<unknown, readonly ["commentsThread", "list", CommentsThreadDiscriminator]>;
+        }, "queryFn"> & {
+            _def: readonly ["commentsThread", "list"];
+        }, "_def">) & {
+            _def: readonly ["commentsThread", "list"];
+        };
+    };
+};
+
+export { createCommentsQueryKeys };

package/dist/plugins/comments/query-keys.d.mts

@@ -0,0 +1,71 @@
+import * as _tanstack_react_query from '@tanstack/react-query';
+import { b as CommentsListDiscriminator, C as CommentListResult, c as CommentCountDiscriminator, a as CommentsThreadDiscriminator } from '../../shared/stack.C-b3Sn8j.mjs';
+import { createApiClient } from '@btst/stack/plugins/client';
+import { C as CommentsApiRouter } from '../../shared/stack.Dcz6636A.mjs';
+import '@btst/stack/plugins/api';
+import 'better-call';
+import 'zod';
+
+interface CommentsListParams {
+    resourceId?: string;
+    resourceType?: string;
+    parentId?: string | null;
+    status?: "pending" | "approved" | "spam";
+    currentUserId?: string;
+    authorId?: string;
+    sort?: "asc" | "desc";
+    limit?: number;
+    offset?: number;
+}
+interface CommentCountParams {
+    resourceId: string;
+    resourceType: string;
+    status?: "pending" | "approved" | "spam";
+}
+declare function createCommentsQueryKeys(client: ReturnType<typeof createApiClient<CommentsApiRouter>>, headers?: HeadersInit): {
+    comments: {
+        _def: readonly ["comments"];
+    } & {
+        list: ((params?: CommentsListParams | undefined) => Omit<{
+            queryKey: readonly ["comments", "list", CommentsListDiscriminator];
+            queryFn: _tanstack_react_query.QueryFunction<CommentListResult, readonly ["comments", "list", CommentsListDiscriminator]>;
+        } & {
+            _def: readonly ["comments", "list"];
+        }, "_def">) & {
+            _def: readonly ["comments", "list"];
+        };
+    };
+    commentCount: {
+        _def: readonly ["commentCount"];
+    } & {
+        byResource: ((params: CommentCountParams) => Omit<{
+            queryKey: readonly ["commentCount", "byResource", CommentCountDiscriminator];
+            queryFn: _tanstack_react_query.QueryFunction<number, readonly ["commentCount", "byResource", CommentCountDiscriminator]>;
+        } & {
+            _def: readonly ["commentCount", "byResource"];
+        }, "_def">) & {
+            _def: readonly ["commentCount", "byResource"];
+        };
+    };
+    commentsThread: {
+        _def: readonly ["commentsThread"];
+    } & {
+        list: ((params?: {
+            resourceId?: string;
+            resourceType?: string;
+            parentId?: string | null;
+            status?: "pending" | "approved" | "spam";
+            currentUserId?: string;
+            limit?: number;
+        } | undefined) => Omit<Omit<{
+            queryKey: readonly ["commentsThread", "list", CommentsThreadDiscriminator];
+            queryFn: _tanstack_react_query.QueryFunction<unknown, readonly ["commentsThread", "list", CommentsThreadDiscriminator]>;
+        }, "queryFn"> & {
+            _def: readonly ["commentsThread", "list"];
+        }, "_def">) & {
+            _def: readonly ["commentsThread", "list"];
+        };
+    };
+};
+
+export { createCommentsQueryKeys };

package/dist/plugins/comments/query-keys.d.ts

@@ -0,0 +1,71 @@
+import * as _tanstack_react_query from '@tanstack/react-query';
+import { b as CommentsListDiscriminator, C as CommentListResult, c as CommentCountDiscriminator, a as CommentsThreadDiscriminator } from '../../shared/stack.C-b3Sn8j.js';
+import { createApiClient } from '@btst/stack/plugins/client';
+import { C as CommentsApiRouter } from '../../shared/stack.CJE9sAjV.js';
+import '@btst/stack/plugins/api';
+import 'better-call';
+import 'zod';
+
+interface CommentsListParams {
+    resourceId?: string;
+    resourceType?: string;
+    parentId?: string | null;
+    status?: "pending" | "approved" | "spam";
+    currentUserId?: string;
+    authorId?: string;
+    sort?: "asc" | "desc";
+    limit?: number;
+    offset?: number;
+}
+interface CommentCountParams {
+    resourceId: string;
+    resourceType: string;
+    status?: "pending" | "approved" | "spam";
+}
+declare function createCommentsQueryKeys(client: ReturnType<typeof createApiClient<CommentsApiRouter>>, headers?: HeadersInit): {
+    comments: {
+        _def: readonly ["comments"];
+    } & {
+        list: ((params?: CommentsListParams | undefined) => Omit<{
+            queryKey: readonly ["comments", "list", CommentsListDiscriminator];
+            queryFn: _tanstack_react_query.QueryFunction<CommentListResult, readonly ["comments", "list", CommentsListDiscriminator]>;
+        } & {
+            _def: readonly ["comments", "list"];
+        }, "_def">) & {
+            _def: readonly ["comments", "list"];
+        };
+    };
+    commentCount: {
+        _def: readonly ["commentCount"];
+    } & {
+        byResource: ((params: CommentCountParams) => Omit<{
+            queryKey: readonly ["commentCount", "byResource", CommentCountDiscriminator];
+            queryFn: _tanstack_react_query.QueryFunction<number, readonly ["commentCount", "byResource", CommentCountDiscriminator]>;
+        } & {
+            _def: readonly ["commentCount", "byResource"];
+        }, "_def">) & {
+            _def: readonly ["commentCount", "byResource"];
+        };
+    };
+    commentsThread: {
+        _def: readonly ["commentsThread"];
+    } & {
+        list: ((params?: {
+            resourceId?: string;
+            resourceType?: string;
+            parentId?: string | null;
+            status?: "pending" | "approved" | "spam";
+            currentUserId?: string;
+            limit?: number;
+        } | undefined) => Omit<Omit<{
+            queryKey: readonly ["commentsThread", "list", CommentsThreadDiscriminator];
+            queryFn: _tanstack_react_query.QueryFunction<unknown, readonly ["commentsThread", "list", CommentsThreadDiscriminator]>;
+        }, "queryFn"> & {
+            _def: readonly ["commentsThread", "list"];
+        }, "_def">) & {
+            _def: readonly ["commentsThread", "list"];
+        };
+    };
+};
+
+export { createCommentsQueryKeys };

package/dist/plugins/comments/query-keys.mjs

@@ -0,0 +1,111 @@
+import { mergeQueryKeys, createQueryKeys } from '@lukemorales/query-key-factory';
+import { commentsListDiscriminator, commentCountDiscriminator, commentsThreadDiscriminator } from '../../packages/stack/src/plugins/comments/api/query-key-defs.mjs';
+import { toError } from '../../packages/stack/src/plugins/comments/client/utils.mjs';
+
+function isErrorResponse(response) {
+  return typeof response === "object" && response !== null && "error" in response && response.error !== null && response.error !== void 0;
+}
+function createCommentsQueryKeys(client, headers) {
+  return mergeQueryKeys(
+    createCommentsQueries(client, headers),
+    createCommentCountQueries(client, headers),
+    createCommentsThreadQueries(client, headers)
+  );
+}
+function createCommentsQueries(client, headers) {
+  return createQueryKeys("comments", {
+    list: (params) => ({
+      queryKey: [commentsListDiscriminator(params)],
+      queryFn: async () => {
+        const response = await client("/comments", {
+          method: "GET",
+          query: {
+            resourceId: params?.resourceId,
+            resourceType: params?.resourceType,
+            parentId: params?.parentId === null ? "null" : params?.parentId,
+            status: params?.status,
+            // currentUserId is intentionally NOT sent to the server.
+            // The server resolves the caller's identity server-side via the
+            // resolveCurrentUserId hook. Sending it would allow any caller to
+            // impersonate another user and read their pending comments.
+            // It is still included in the queryKey above for client-side
+            // cache segregation (different users get different cache entries).
+            authorId: params?.authorId,
+            sort: params?.sort,
+            limit: params?.limit ?? 20,
+            offset: params?.offset ?? 0
+          },
+          headers
+        });
+        if (isErrorResponse(response)) {
+          throw toError(response.error);
+        }
+        const data = response.data;
+        return data ?? { items: [], total: 0, limit: 20, offset: 0 };
+      }
+    })
+  });
+}
+function createCommentCountQueries(client, headers) {
+  return createQueryKeys("commentCount", {
+    byResource: (params) => ({
+      queryKey: [commentCountDiscriminator(params)],
+      queryFn: async () => {
+        const response = await client("/comments/count", {
+          method: "GET",
+          query: {
+            resourceId: params.resourceId,
+            resourceType: params.resourceType,
+            status: params.status
+          },
+          headers
+        });
+        if (isErrorResponse(response)) {
+          throw toError(response.error);
+        }
+        const data = response.data;
+        return data?.count ?? 0;
+      }
+    })
+  });
+}
+function createCommentsThreadQueries(client, headers) {
+  return createQueryKeys("commentsThread", {
+    list: (params) => ({
+      // Offset is excluded from the key — it is driven by pageParam.
+      queryKey: [commentsThreadDiscriminator(params)],
+      queryFn: async ({
+        pageParam
+      } = {}) => {
+        const response = await client("/comments", {
+          method: "GET",
+          query: {
+            resourceId: params?.resourceId,
+            resourceType: params?.resourceType,
+            parentId: params?.parentId === null ? "null" : params?.parentId,
+            status: params?.status,
+            // currentUserId is intentionally NOT sent to the server.
+            // The server resolves the caller's identity server-side via the
+            // resolveCurrentUserId hook. It is still included in the queryKey
+            // above for client-side cache segregation.
+            limit: params?.limit ?? 20,
+            offset: pageParam ?? 0
+          },
+          headers
+        });
+        if (isErrorResponse(response)) {
+          throw toError(response.error);
+        }
+        const data = response.data;
+        return data ?? {
+          items: [],
+          total: 0,
+          limit: params?.limit ?? 20,
+          offset: pageParam ?? 0
+        };
+      }
+    })
+  });
+}
+
+export { createCommentsQueryKeys };

package/dist/plugins/comments/style.css

@@ -0,0 +1,15 @@
+@import "./client.css";
+
+/*
+ * Comments Plugin CSS - Includes Tailwind class scanning
+ *
+ * When consumed from npm, Tailwind v4 will automatically scan this package's
+ * source files for Tailwind classes. Consumers only need:
+ *   @import "@btst/stack/plugins/comments/css";
+ */
+
+/* Scan this package's source files for Tailwind classes */
+@source "../../../src/**/*.{ts,tsx}";
+
+/* Scan UI package components (when installed as npm package the UI package will be in this dir) */
+@source "../../packages/ui/src";

package/dist/plugins/kanban/api/index.d.cts

@@ -1,4 +1,4 @@
-export { B as BoardListResult, C as CreateKanbanTaskInput, i as KANBAN_QUERY_KEYS, b as KanbanApiContext, K as KanbanApiRouter, c as KanbanBackendHooks, a as KanbanRouteKey, e as createKanbanTask, f as findOrCreateKanbanBoard, g as getAllBoards, d as getBoardById, h as getKanbanColumnsByBoardId, k as kanbanBackendPlugin } from '../../../shared/stack.Rtcvl8sS.cjs';
+export { B as BoardListResult, C as CreateKanbanTaskInput, i as KANBAN_QUERY_KEYS, b as KanbanApiContext, K as KanbanApiRouter, c as KanbanBackendHooks, a as KanbanRouteKey, e as createKanbanTask, f as findOrCreateKanbanBoard, g as getAllBoards, d as getBoardById, h as getKanbanColumnsByBoardId, k as kanbanBackendPlugin } from '../../../shared/stack.BOokfhZD.cjs';
 import { B as BoardWithColumns, S as SerializedBoardWithColumns, C as ColumnWithTasks, a as SerializedColumn, T as Task, b as SerializedTask } from '../../../shared/stack.DJaKVY7v.cjs';
 import '@btst/stack/plugins/api';
 import '@btst/db';

package/dist/plugins/kanban/api/index.d.mts

@@ -1,4 +1,4 @@
-export { B as BoardListResult, C as CreateKanbanTaskInput, i as KANBAN_QUERY_KEYS, b as KanbanApiContext, K as KanbanApiRouter, c as KanbanBackendHooks, a as KanbanRouteKey, e as createKanbanTask, f as findOrCreateKanbanBoard, g as getAllBoards, d as getBoardById, h as getKanbanColumnsByBoardId, k as kanbanBackendPlugin } from '../../../shared/stack.HE_IvqV5.mjs';
+export { B as BoardListResult, C as CreateKanbanTaskInput, i as KANBAN_QUERY_KEYS, b as KanbanApiContext, K as KanbanApiRouter, c as KanbanBackendHooks, a as KanbanRouteKey, e as createKanbanTask, f as findOrCreateKanbanBoard, g as getAllBoards, d as getBoardById, h as getKanbanColumnsByBoardId, k as kanbanBackendPlugin } from '../../../shared/stack.CWxAl9K3.mjs';
 import { B as BoardWithColumns, S as SerializedBoardWithColumns, C as ColumnWithTasks, a as SerializedColumn, T as Task, b as SerializedTask } from '../../../shared/stack.DJaKVY7v.mjs';
 import '@btst/stack/plugins/api';
 import '@btst/db';

package/dist/plugins/kanban/api/index.d.ts

@@ -1,4 +1,4 @@
-export { B as BoardListResult, C as CreateKanbanTaskInput, i as KANBAN_QUERY_KEYS, b as KanbanApiContext, K as KanbanApiRouter, c as KanbanBackendHooks, a as KanbanRouteKey, e as createKanbanTask, f as findOrCreateKanbanBoard, g as getAllBoards, d as getBoardById, h as getKanbanColumnsByBoardId, k as kanbanBackendPlugin } from '../../../shared/stack.D4Cea8II.js';
+export { B as BoardListResult, C as CreateKanbanTaskInput, i as KANBAN_QUERY_KEYS, b as KanbanApiContext, K as KanbanApiRouter, c as KanbanBackendHooks, a as KanbanRouteKey, e as createKanbanTask, f as findOrCreateKanbanBoard, g as getAllBoards, d as getBoardById, h as getKanbanColumnsByBoardId, k as kanbanBackendPlugin } from '../../../shared/stack.BvCR4-9H.js';
 import { B as BoardWithColumns, S as SerializedBoardWithColumns, C as ColumnWithTasks, a as SerializedColumn, T as Task, b as SerializedTask } from '../../../shared/stack.DJaKVY7v.js';
 import '@btst/stack/plugins/api';
 import '@btst/db';

package/dist/plugins/kanban/client/hooks/index.d.cts

@@ -1,5 +1,5 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
-import { a as KanbanUser } from '../../../../shared/stack.FeaWkglm.cjs';
+import { a as KanbanUser } from '../../../../shared/stack.BxFl46lB.cjs';
 import { S as SerializedBoardWithColumns, c as SerializedBoard, a as SerializedColumn, b as SerializedTask, P as Priority } from '../../../../shared/stack.DJaKVY7v.cjs';
 import 'react';
 

package/dist/plugins/kanban/client/hooks/index.d.mts

@@ -1,5 +1,5 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
-import { a as KanbanUser } from '../../../../shared/stack.FeaWkglm.mjs';
+import { a as KanbanUser } from '../../../../shared/stack.Jb0kQDJC.mjs';
 import { S as SerializedBoardWithColumns, c as SerializedBoard, a as SerializedColumn, b as SerializedTask, P as Priority } from '../../../../shared/stack.DJaKVY7v.mjs';
 import 'react';
 

package/dist/plugins/kanban/client/hooks/index.d.ts

@@ -1,5 +1,5 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
-import { a as KanbanUser } from '../../../../shared/stack.FeaWkglm.js';
+import { a as KanbanUser } from '../../../../shared/stack.DRpeDS6X.js';
 import { S as SerializedBoardWithColumns, c as SerializedBoard, a as SerializedColumn, b as SerializedTask, P as Priority } from '../../../../shared/stack.DJaKVY7v.js';
 import 'react';
 

package/dist/plugins/kanban/client/index.d.cts

@@ -3,7 +3,7 @@ import * as _btst_yar from '@btst/yar';
 import { ComponentType } from 'react';
 import { QueryClient } from '@tanstack/react-query';
 import { S as SerializedBoardWithColumns } from '../../../shared/stack.DJaKVY7v.cjs';
-export { K as KanbanPluginOverrides, a as KanbanUser } from '../../../shared/stack.FeaWkglm.cjs';
+export { K as KanbanPluginOverrides, a as KanbanUser } from '../../../shared/stack.BxFl46lB.cjs';
 
 /**
  * Context passed to route hooks

package/dist/plugins/kanban/client/index.d.mts

@@ -3,7 +3,7 @@ import * as _btst_yar from '@btst/yar';
 import { ComponentType } from 'react';
 import { QueryClient } from '@tanstack/react-query';
 import { S as SerializedBoardWithColumns } from '../../../shared/stack.DJaKVY7v.mjs';
-export { K as KanbanPluginOverrides, a as KanbanUser } from '../../../shared/stack.FeaWkglm.mjs';
+export { K as KanbanPluginOverrides, a as KanbanUser } from '../../../shared/stack.Jb0kQDJC.mjs';
 
 /**
  * Context passed to route hooks

package/dist/plugins/kanban/client/index.d.ts

@@ -3,7 +3,7 @@ import * as _btst_yar from '@btst/yar';
 import { ComponentType } from 'react';
 import { QueryClient } from '@tanstack/react-query';
 import { S as SerializedBoardWithColumns } from '../../../shared/stack.DJaKVY7v.js';
-export { K as KanbanPluginOverrides, a as KanbanUser } from '../../../shared/stack.FeaWkglm.js';
+export { K as KanbanPluginOverrides, a as KanbanUser } from '../../../shared/stack.DRpeDS6X.js';
 
 /**
  * Context passed to route hooks

package/dist/plugins/kanban/query-keys.d.cts

@@ -1,5 +1,5 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
-import { K as KanbanApiRouter, j as BoardsListDiscriminator } from '../../shared/stack.Rtcvl8sS.cjs';
+import { K as KanbanApiRouter, j as BoardsListDiscriminator } from '../../shared/stack.BOokfhZD.cjs';
 import { createApiClient } from '@btst/stack/plugins/client';
 import { S as SerializedBoardWithColumns } from '../../shared/stack.DJaKVY7v.cjs';
 import '@btst/stack/plugins/api';

package/dist/plugins/kanban/query-keys.d.mts

@@ -1,5 +1,5 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
-import { K as KanbanApiRouter, j as BoardsListDiscriminator } from '../../shared/stack.HE_IvqV5.mjs';
+import { K as KanbanApiRouter, j as BoardsListDiscriminator } from '../../shared/stack.CWxAl9K3.mjs';
 import { createApiClient } from '@btst/stack/plugins/client';
 import { S as SerializedBoardWithColumns } from '../../shared/stack.DJaKVY7v.mjs';
 import '@btst/stack/plugins/api';

package/dist/plugins/kanban/query-keys.d.ts

@@ -1,5 +1,5 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
-import { K as KanbanApiRouter, j as BoardsListDiscriminator } from '../../shared/stack.D4Cea8II.js';
+import { K as KanbanApiRouter, j as BoardsListDiscriminator } from '../../shared/stack.BvCR4-9H.js';
 import { createApiClient } from '@btst/stack/plugins/client';
 import { S as SerializedBoardWithColumns } from '../../shared/stack.DJaKVY7v.js';
 import '@btst/stack/plugins/api';

package/dist/shared/{stack.FeaWkglm.d.ts → stack.BxFl46lB.d.cts}

@@ -1,4 +1,5 @@
-import { ComponentType } from 'react';
+import { ComponentType, ReactNode } from 'react';
+import { b as SerializedTask } from './stack.DJaKVY7v.cjs';
 
 interface KanbanCommonLocalization {
     backToBoards: string;
@@ -185,6 +186,28 @@ interface KanbanPluginOverrides {
      * @param context - Route context
      */
     onBeforeNewBoardPageRendered?: (context: RouteContext) => boolean;
+    /**
+     * Optional slot rendered at the bottom of the task detail dialog.
+     * Use this to inject a comment thread or any custom content without
+     * coupling the kanban plugin to the comments plugin.
+     *
+     * @example
+     * ```tsx
+     * kanban: {
+     *   taskDetailBottomSlot: (task) => (
+     *     <CommentThread
+     *       resourceId={task.id}
+     *       resourceType="kanban-task"
+     *       apiBaseURL={apiBaseURL}
+     *       apiBasePath="/api/data"
+     *       currentUserId={session?.userId}
+     *       loginHref="/login"
+     *     />
+     *   ),
+     * }
+     * ```
+     */
+    taskDetailBottomSlot?: (task: SerializedTask) => ReactNode;
 }
 
 export type { KanbanPluginOverrides as K, KanbanUser as a };

package/dist/shared/stack.C-b3Sn8j.d.cts

@@ -0,0 +1,142 @@
+/**
+ * Comment status values
+ */
+type CommentStatus = "pending" | "approved" | "spam";
+/**
+ * A comment record as stored in the database
+ */
+type Comment = {
+    id: string;
+    resourceId: string;
+    resourceType: string;
+    parentId: string | null;
+    authorId: string;
+    body: string;
+    status: CommentStatus;
+    likes: number;
+    editedAt?: Date;
+    createdAt: Date;
+    updatedAt: Date;
+};
+/**
+ * A comment enriched with server-resolved author info and like status.
+ * All dates are ISO strings (safe for serialisation over HTTP / React Query cache).
+ */
+interface SerializedComment {
+    id: string;
+    resourceId: string;
+    resourceType: string;
+    parentId: string | null;
+    authorId: string;
+    /** Resolved from resolveUser(authorId). Falls back to "[deleted]" when user cannot be found. */
+    resolvedAuthorName: string;
+    /** Resolved avatar URL or null */
+    resolvedAvatarUrl: string | null;
+    body: string;
+    status: CommentStatus;
+    /** Denormalized counter — updated atomically on toggleLike */
+    likes: number;
+    /** True when the currentUserId query param matches an existing commentLike row */
+    isLikedByCurrentUser: boolean;
+    /** ISO string set when the comment body was edited; null for unedited comments */
+    editedAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+    /**
+     * Number of direct replies visible to the requesting user.
+     * Includes approved replies plus any pending replies authored by `currentUserId`.
+     * Always 0 for reply comments (non-null parentId).
+     */
+    replyCount: number;
+}
+/**
+ * Paginated list result for comments
+ */
+interface CommentListResult {
+    items: SerializedComment[];
+    total: number;
+    limit: number;
+    offset: number;
+}
+
+/**
+ * Internal query key constants for the Comments plugin.
+ * Shared between query-keys.ts (HTTP path) and any SSG/direct DB path
+ * to prevent key drift between loaders and prefetch calls.
+ */
+interface CommentsListDiscriminator {
+    resourceId: string | undefined;
+    resourceType: string | undefined;
+    parentId: string | null | undefined;
+    status: string | undefined;
+    currentUserId: string | undefined;
+    authorId: string | undefined;
+    sort: string | undefined;
+    limit: number;
+    offset: number;
+}
+interface CommentCountDiscriminator {
+    resourceId: string;
+    resourceType: string;
+    status: string | undefined;
+}
+/**
+ * Discriminator for the infinite thread query (top-level comments only).
+ * Intentionally excludes `offset` — pages are driven by `pageParam`, not the key.
+ */
+interface CommentsThreadDiscriminator {
+    resourceId: string | undefined;
+    resourceType: string | undefined;
+    parentId: string | null | undefined;
+    status: string | undefined;
+    currentUserId: string | undefined;
+    limit: number;
+}
+/** Full query key builders — use with queryClient.setQueryData() */
+declare const COMMENTS_QUERY_KEYS: {
+    /**
+     * Key for comments list query.
+     * Full key: ["comments", "list", { resourceId, resourceType, parentId, status, currentUserId, limit, offset }]
+     */
+    commentsList: (params?: {
+        resourceId?: string;
+        resourceType?: string;
+        parentId?: string | null;
+        status?: string;
+        currentUserId?: string;
+        authorId?: string;
+        sort?: string;
+        limit?: number;
+        offset?: number;
+    }) => readonly ["comments", "list", CommentsListDiscriminator];
+    /**
+     * Key for a single comment detail query.
+     * Full key: ["comments", "detail", id]
+     */
+    commentDetail: (id: string) => readonly ["comments", "detail", string];
+    /**
+     * Key for comment count query.
+     * Full key: ["comments", "count", { resourceId, resourceType, status }]
+     */
+    commentCount: (params: {
+        resourceId: string;
+        resourceType: string;
+        status?: string;
+    }) => readonly ["comments", "count", CommentCountDiscriminator];
+    /**
+     * Key for the infinite thread query (top-level comments, load-more).
+     * Full key: ["commentsThread", "list", { resourceId, resourceType, parentId, status, currentUserId, limit }]
+     * Offset is excluded — it is driven by `pageParam`, not baked into the key.
+     */
+    commentsThread: (params?: {
+        resourceId?: string;
+        resourceType?: string;
+        parentId?: string | null;
+        status?: string;
+        currentUserId?: string;
+        limit?: number;
+    }) => readonly ["commentsThread", "list", CommentsThreadDiscriminator];
+};
+
+export { COMMENTS_QUERY_KEYS as e };
+export type { CommentListResult as C, SerializedComment as S, CommentsThreadDiscriminator as a, CommentsListDiscriminator as b, CommentCountDiscriminator as c, Comment as d };