@btst/stack 2.7.0 → 2.8.0

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

@@ -0,0 +1,126 @@
+import { a as CommentListParamsSchema, b as CommentCountQuerySchema } from '../../../shared/stack.CmHRdhl8.cjs';
+export { d as CommentsApiContext, C as CommentsApiRouter, e as CommentsBackendOptions, c as commentsBackendPlugin } from '../../../shared/stack.CmHRdhl8.cjs';
+import { DBAdapter } from '@btst/db';
+import { C as CommentListResult, S as SerializedComment, d as Comment } from '../../../shared/stack.C-b3Sn8j.cjs';
+export { e as COMMENTS_QUERY_KEYS } from '../../../shared/stack.C-b3Sn8j.cjs';
+import { z } from 'zod';
+import '@btst/stack/plugins/api';
+import 'better-call';
+
+/**
+ * List comments for a resource, optionally filtered by status and parentId.
+ * Server-side resolves author display info and like status.
+ *
+ * When `status` is "approved" (default) and `currentUserId` is provided, the
+ * result also includes the current user's own pending comments so they remain
+ * visible after a page refresh without requiring admin access.
+ *
+ * Pure DB function — no hooks, no HTTP context. Safe for server-side use.
+ *
+ * @param adapter - The database adapter
+ * @param params - Filter/pagination parameters
+ * @param resolveUser - Optional consumer hook to resolve author display info
+ */
+declare function listComments(adapter: DBAdapter, params: z.infer<typeof CommentListParamsSchema>, resolveUser?: (authorId: string) => Promise<{
+    name: string;
+    avatarUrl?: string;
+} | null>): Promise<CommentListResult>;
+/**
+ * Get a single comment by ID, enriched with author info.
+ * Returns null if not found.
+ *
+ * Pure DB function — no hooks, no HTTP context.
+ */
+declare function getCommentById(adapter: DBAdapter, id: string, resolveUser?: (authorId: string) => Promise<{
+    name: string;
+    avatarUrl?: string;
+} | null>, currentUserId?: string): Promise<SerializedComment | null>;
+/**
+ * Count comments for a resource, optionally filtered by status.
+ *
+ * Pure DB function — no hooks, no HTTP context.
+ */
+declare function getCommentCount(adapter: DBAdapter, params: z.infer<typeof CommentCountQuerySchema>): Promise<number>;
+
+/**
+ * Input for creating a new comment.
+ */
+interface CreateCommentInput {
+    resourceId: string;
+    resourceType: string;
+    parentId?: string | null;
+    authorId: string;
+    body: string;
+    status?: "pending" | "approved" | "spam";
+}
+/**
+ * Create a new comment.
+ *
+ * @remarks **Security:** No authorization hooks are called. The caller is
+ * responsible for any access-control checks (e.g., onBeforePost) before
+ * invoking this function.
+ */
+declare function createComment(adapter: DBAdapter, input: CreateCommentInput): Promise<Comment>;
+/**
+ * Update the body of an existing comment and set editedAt.
+ *
+ * @remarks **Security:** No authorization hooks are called. The caller is
+ * responsible for ensuring the requesting user owns the comment (onBeforeEdit).
+ */
+declare function updateComment(adapter: DBAdapter, id: string, body: string): Promise<Comment | null>;
+/**
+ * Update the status of a comment (approve, reject, spam).
+ *
+ * @remarks **Security:** No authorization hooks are called. Callers should
+ * ensure the requesting user has moderation privileges.
+ */
+declare function updateCommentStatus(adapter: DBAdapter, id: string, status: "pending" | "approved" | "spam"): Promise<Comment | null>;
+/**
+ * Delete a comment by ID, cascading to any child replies.
+ *
+ * Replies reference the parent via `parentId`. Because the schema declares no
+ * DB-level cascade on `comment.parentId`, orphaned replies must be removed here
+ * in the application layer. `commentLike` rows are covered by the FK cascade
+ * on `commentLike.commentId` (declared in `db.ts`).
+ *
+ * Comments are only one level deep (the UI prevents replying to replies), so a
+ * single-level cascade is sufficient — no recursive walk is needed.
+ *
+ * @remarks **Security:** No authorization hooks are called. Callers should
+ * ensure the requesting user has permission to delete this comment.
+ */
+declare function deleteComment(adapter: DBAdapter, id: string): Promise<boolean>;
+/**
+ * Toggle a like on a comment for a given authorId.
+ * - If the user has not liked the comment: creates a commentLike row and increments the likes counter.
+ * - If the user has already liked the comment: deletes the commentLike row and decrements the likes counter.
+ * Returns the updated likes count.
+ *
+ * All reads and writes are performed inside a single transaction to prevent
+ * concurrent requests from causing counter drift or duplicate like rows.
+ *
+ * @remarks **Security:** No authorization hooks are called. The caller is
+ * responsible for ensuring the requesting user is authenticated (authorId is valid).
+ */
+declare function toggleCommentLike(adapter: DBAdapter, commentId: string, authorId: string): Promise<{
+    likes: number;
+    isLiked: boolean;
+}>;
+
+/**
+ * Serialize a raw Comment DB record into a SerializedComment for SSG/setQueryData.
+ * Note: resolvedAuthorName, resolvedAvatarUrl, and isLikedByCurrentUser are not
+ * available from the DB record alone — use getters.ts enrichment for those.
+ * This serializer is for cases where you already have a SerializedComment from
+ * the HTTP layer and just need a type-safe round-trip.
+ *
+ * Pure function — no DB access, no hooks.
+ */
+declare function serializeComment(comment: Comment): Omit<SerializedComment, "resolvedAuthorName" | "resolvedAvatarUrl" | "isLikedByCurrentUser"> & {
+    resolvedAuthorName: string;
+    resolvedAvatarUrl: null;
+    isLikedByCurrentUser: false;
+};
+
+export { createComment, deleteComment, getCommentById, getCommentCount, listComments, serializeComment, toggleCommentLike, updateComment, updateCommentStatus };
+export type { CreateCommentInput };

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

@@ -0,0 +1,126 @@
+import { a as CommentListParamsSchema, b as CommentCountQuerySchema } from '../../../shared/stack.Dcz6636A.mjs';
+export { d as CommentsApiContext, C as CommentsApiRouter, e as CommentsBackendOptions, c as commentsBackendPlugin } from '../../../shared/stack.Dcz6636A.mjs';
+import { DBAdapter } from '@btst/db';
+import { C as CommentListResult, S as SerializedComment, d as Comment } from '../../../shared/stack.C-b3Sn8j.mjs';
+export { e as COMMENTS_QUERY_KEYS } from '../../../shared/stack.C-b3Sn8j.mjs';
+import { z } from 'zod';
+import '@btst/stack/plugins/api';
+import 'better-call';
+
+/**
+ * List comments for a resource, optionally filtered by status and parentId.
+ * Server-side resolves author display info and like status.
+ *
+ * When `status` is "approved" (default) and `currentUserId` is provided, the
+ * result also includes the current user's own pending comments so they remain
+ * visible after a page refresh without requiring admin access.
+ *
+ * Pure DB function — no hooks, no HTTP context. Safe for server-side use.
+ *
+ * @param adapter - The database adapter
+ * @param params - Filter/pagination parameters
+ * @param resolveUser - Optional consumer hook to resolve author display info
+ */
+declare function listComments(adapter: DBAdapter, params: z.infer<typeof CommentListParamsSchema>, resolveUser?: (authorId: string) => Promise<{
+    name: string;
+    avatarUrl?: string;
+} | null>): Promise<CommentListResult>;
+/**
+ * Get a single comment by ID, enriched with author info.
+ * Returns null if not found.
+ *
+ * Pure DB function — no hooks, no HTTP context.
+ */
+declare function getCommentById(adapter: DBAdapter, id: string, resolveUser?: (authorId: string) => Promise<{
+    name: string;
+    avatarUrl?: string;
+} | null>, currentUserId?: string): Promise<SerializedComment | null>;
+/**
+ * Count comments for a resource, optionally filtered by status.
+ *
+ * Pure DB function — no hooks, no HTTP context.
+ */
+declare function getCommentCount(adapter: DBAdapter, params: z.infer<typeof CommentCountQuerySchema>): Promise<number>;
+
+/**
+ * Input for creating a new comment.
+ */
+interface CreateCommentInput {
+    resourceId: string;
+    resourceType: string;
+    parentId?: string | null;
+    authorId: string;
+    body: string;
+    status?: "pending" | "approved" | "spam";
+}
+/**
+ * Create a new comment.
+ *
+ * @remarks **Security:** No authorization hooks are called. The caller is
+ * responsible for any access-control checks (e.g., onBeforePost) before
+ * invoking this function.
+ */
+declare function createComment(adapter: DBAdapter, input: CreateCommentInput): Promise<Comment>;
+/**
+ * Update the body of an existing comment and set editedAt.
+ *
+ * @remarks **Security:** No authorization hooks are called. The caller is
+ * responsible for ensuring the requesting user owns the comment (onBeforeEdit).
+ */
+declare function updateComment(adapter: DBAdapter, id: string, body: string): Promise<Comment | null>;
+/**
+ * Update the status of a comment (approve, reject, spam).
+ *
+ * @remarks **Security:** No authorization hooks are called. Callers should
+ * ensure the requesting user has moderation privileges.
+ */
+declare function updateCommentStatus(adapter: DBAdapter, id: string, status: "pending" | "approved" | "spam"): Promise<Comment | null>;
+/**
+ * Delete a comment by ID, cascading to any child replies.
+ *
+ * Replies reference the parent via `parentId`. Because the schema declares no
+ * DB-level cascade on `comment.parentId`, orphaned replies must be removed here
+ * in the application layer. `commentLike` rows are covered by the FK cascade
+ * on `commentLike.commentId` (declared in `db.ts`).
+ *
+ * Comments are only one level deep (the UI prevents replying to replies), so a
+ * single-level cascade is sufficient — no recursive walk is needed.
+ *
+ * @remarks **Security:** No authorization hooks are called. Callers should
+ * ensure the requesting user has permission to delete this comment.
+ */
+declare function deleteComment(adapter: DBAdapter, id: string): Promise<boolean>;
+/**
+ * Toggle a like on a comment for a given authorId.
+ * - If the user has not liked the comment: creates a commentLike row and increments the likes counter.
+ * - If the user has already liked the comment: deletes the commentLike row and decrements the likes counter.
+ * Returns the updated likes count.
+ *
+ * All reads and writes are performed inside a single transaction to prevent
+ * concurrent requests from causing counter drift or duplicate like rows.
+ *
+ * @remarks **Security:** No authorization hooks are called. The caller is
+ * responsible for ensuring the requesting user is authenticated (authorId is valid).
+ */
+declare function toggleCommentLike(adapter: DBAdapter, commentId: string, authorId: string): Promise<{
+    likes: number;
+    isLiked: boolean;
+}>;
+
+/**
+ * Serialize a raw Comment DB record into a SerializedComment for SSG/setQueryData.
+ * Note: resolvedAuthorName, resolvedAvatarUrl, and isLikedByCurrentUser are not
+ * available from the DB record alone — use getters.ts enrichment for those.
+ * This serializer is for cases where you already have a SerializedComment from
+ * the HTTP layer and just need a type-safe round-trip.
+ *
+ * Pure function — no DB access, no hooks.
+ */
+declare function serializeComment(comment: Comment): Omit<SerializedComment, "resolvedAuthorName" | "resolvedAvatarUrl" | "isLikedByCurrentUser"> & {
+    resolvedAuthorName: string;
+    resolvedAvatarUrl: null;
+    isLikedByCurrentUser: false;
+};
+
+export { createComment, deleteComment, getCommentById, getCommentCount, listComments, serializeComment, toggleCommentLike, updateComment, updateCommentStatus };
+export type { CreateCommentInput };

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

@@ -0,0 +1,126 @@
+import { a as CommentListParamsSchema, b as CommentCountQuerySchema } from '../../../shared/stack.CJE9sAjV.js';
+export { d as CommentsApiContext, C as CommentsApiRouter, e as CommentsBackendOptions, c as commentsBackendPlugin } from '../../../shared/stack.CJE9sAjV.js';
+import { DBAdapter } from '@btst/db';
+import { C as CommentListResult, S as SerializedComment, d as Comment } from '../../../shared/stack.C-b3Sn8j.js';
+export { e as COMMENTS_QUERY_KEYS } from '../../../shared/stack.C-b3Sn8j.js';
+import { z } from 'zod';
+import '@btst/stack/plugins/api';
+import 'better-call';
+
+/**
+ * List comments for a resource, optionally filtered by status and parentId.
+ * Server-side resolves author display info and like status.
+ *
+ * When `status` is "approved" (default) and `currentUserId` is provided, the
+ * result also includes the current user's own pending comments so they remain
+ * visible after a page refresh without requiring admin access.
+ *
+ * Pure DB function — no hooks, no HTTP context. Safe for server-side use.
+ *
+ * @param adapter - The database adapter
+ * @param params - Filter/pagination parameters
+ * @param resolveUser - Optional consumer hook to resolve author display info
+ */
+declare function listComments(adapter: DBAdapter, params: z.infer<typeof CommentListParamsSchema>, resolveUser?: (authorId: string) => Promise<{
+    name: string;
+    avatarUrl?: string;
+} | null>): Promise<CommentListResult>;
+/**
+ * Get a single comment by ID, enriched with author info.
+ * Returns null if not found.
+ *
+ * Pure DB function — no hooks, no HTTP context.
+ */
+declare function getCommentById(adapter: DBAdapter, id: string, resolveUser?: (authorId: string) => Promise<{
+    name: string;
+    avatarUrl?: string;
+} | null>, currentUserId?: string): Promise<SerializedComment | null>;
+/**
+ * Count comments for a resource, optionally filtered by status.
+ *
+ * Pure DB function — no hooks, no HTTP context.
+ */
+declare function getCommentCount(adapter: DBAdapter, params: z.infer<typeof CommentCountQuerySchema>): Promise<number>;
+
+/**
+ * Input for creating a new comment.
+ */
+interface CreateCommentInput {
+    resourceId: string;
+    resourceType: string;
+    parentId?: string | null;
+    authorId: string;
+    body: string;
+    status?: "pending" | "approved" | "spam";
+}
+/**
+ * Create a new comment.
+ *
+ * @remarks **Security:** No authorization hooks are called. The caller is
+ * responsible for any access-control checks (e.g., onBeforePost) before
+ * invoking this function.
+ */
+declare function createComment(adapter: DBAdapter, input: CreateCommentInput): Promise<Comment>;
+/**
+ * Update the body of an existing comment and set editedAt.
+ *
+ * @remarks **Security:** No authorization hooks are called. The caller is
+ * responsible for ensuring the requesting user owns the comment (onBeforeEdit).
+ */
+declare function updateComment(adapter: DBAdapter, id: string, body: string): Promise<Comment | null>;
+/**
+ * Update the status of a comment (approve, reject, spam).
+ *
+ * @remarks **Security:** No authorization hooks are called. Callers should
+ * ensure the requesting user has moderation privileges.
+ */
+declare function updateCommentStatus(adapter: DBAdapter, id: string, status: "pending" | "approved" | "spam"): Promise<Comment | null>;
+/**
+ * Delete a comment by ID, cascading to any child replies.
+ *
+ * Replies reference the parent via `parentId`. Because the schema declares no
+ * DB-level cascade on `comment.parentId`, orphaned replies must be removed here
+ * in the application layer. `commentLike` rows are covered by the FK cascade
+ * on `commentLike.commentId` (declared in `db.ts`).
+ *
+ * Comments are only one level deep (the UI prevents replying to replies), so a
+ * single-level cascade is sufficient — no recursive walk is needed.
+ *
+ * @remarks **Security:** No authorization hooks are called. Callers should
+ * ensure the requesting user has permission to delete this comment.
+ */
+declare function deleteComment(adapter: DBAdapter, id: string): Promise<boolean>;
+/**
+ * Toggle a like on a comment for a given authorId.
+ * - If the user has not liked the comment: creates a commentLike row and increments the likes counter.
+ * - If the user has already liked the comment: deletes the commentLike row and decrements the likes counter.
+ * Returns the updated likes count.
+ *
+ * All reads and writes are performed inside a single transaction to prevent
+ * concurrent requests from causing counter drift or duplicate like rows.
+ *
+ * @remarks **Security:** No authorization hooks are called. The caller is
+ * responsible for ensuring the requesting user is authenticated (authorId is valid).
+ */
+declare function toggleCommentLike(adapter: DBAdapter, commentId: string, authorId: string): Promise<{
+    likes: number;
+    isLiked: boolean;
+}>;
+
+/**
+ * Serialize a raw Comment DB record into a SerializedComment for SSG/setQueryData.
+ * Note: resolvedAuthorName, resolvedAvatarUrl, and isLikedByCurrentUser are not
+ * available from the DB record alone — use getters.ts enrichment for those.
+ * This serializer is for cases where you already have a SerializedComment from
+ * the HTTP layer and just need a type-safe round-trip.
+ *
+ * Pure function — no DB access, no hooks.
+ */
+declare function serializeComment(comment: Comment): Omit<SerializedComment, "resolvedAuthorName" | "resolvedAvatarUrl" | "isLikedByCurrentUser"> & {
+    resolvedAuthorName: string;
+    resolvedAvatarUrl: null;
+    isLikedByCurrentUser: false;
+};
+
+export { createComment, deleteComment, getCommentById, getCommentCount, listComments, serializeComment, toggleCommentLike, updateComment, updateCommentStatus };
+export type { CreateCommentInput };

package/dist/plugins/comments/api/index.mjs

@@ -0,0 +1,5 @@
+export { commentsBackendPlugin } from '../../../packages/stack/src/plugins/comments/api/plugin.mjs';
+export { getCommentById, getCommentCount, listComments } from '../../../packages/stack/src/plugins/comments/api/getters.mjs';
+export { createComment, deleteComment, toggleCommentLike, updateComment, updateCommentStatus } from '../../../packages/stack/src/plugins/comments/api/mutations.mjs';
+export { serializeComment } from '../../../packages/stack/src/plugins/comments/api/serializers.mjs';
+export { COMMENTS_QUERY_KEYS } from '../../../packages/stack/src/plugins/comments/api/query-key-defs.mjs';

package/dist/plugins/comments/client/components/index.cjs

@@ -0,0 +1,15 @@
+'use strict';
+
+const commentThread = require('../../../../packages/stack/src/plugins/comments/client/components/comment-thread.cjs');
+const commentCount = require('../../../../packages/stack/src/plugins/comments/client/components/comment-count.cjs');
+const commentForm = require('../../../../packages/stack/src/plugins/comments/client/components/comment-form.cjs');
+const moderationPage = require('../../../../packages/stack/src/plugins/comments/client/components/pages/moderation-page.cjs');
+const resourceCommentsPage = require('../../../../packages/stack/src/plugins/comments/client/components/pages/resource-comments-page.cjs');
+
+
+
+exports.CommentThread = commentThread.CommentThread;
+exports.CommentCount = commentCount.CommentCount;
+exports.CommentForm = commentForm.CommentForm;
+exports.ModerationPageComponent = moderationPage.ModerationPageComponent;
+exports.ResourceCommentsPageComponent = resourceCommentsPage.ResourceCommentsPageComponent;

package/dist/plugins/comments/client/components/index.d.cts

@@ -0,0 +1,125 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ComponentType } from 'react';
+import { C as CommentsLocalization } from '../../../../shared/stack.Ldfkr5b2.cjs';
+
+/** Custom input component props */
+interface CommentInputProps {
+    value: string;
+    onChange: (value: string) => void;
+    disabled?: boolean;
+    placeholder?: string;
+}
+/** Custom renderer component props */
+interface CommentRendererProps {
+    body: string;
+}
+/** Override slot for custom input + renderer */
+interface CommentComponents {
+    Input?: ComponentType<CommentInputProps>;
+    Renderer?: ComponentType<CommentRendererProps>;
+}
+interface CommentThreadProps {
+    /** The resource this thread is attached to (e.g. post slug, task ID) */
+    resourceId: string;
+    /** Discriminates resources across plugins (e.g. "blog-post", "kanban-task") */
+    resourceType: string;
+    /** Base URL for API calls */
+    apiBaseURL: string;
+    /** Path where the API is mounted */
+    apiBasePath: string;
+    /** Currently authenticated user ID. Omit for read-only / unauthenticated. */
+    currentUserId?: string;
+    /**
+     * URL to redirect unauthenticated users to.
+     * When provided and currentUserId is absent, shows a "Please login to comment" prompt.
+     */
+    loginHref?: string;
+    /** Optional HTTP headers for API calls (e.g. forwarding cookies) */
+    headers?: HeadersInit;
+    /** Swap in custom Input / Renderer components */
+    components?: CommentComponents;
+    /** Optional className applied to the root wrapper */
+    className?: string;
+    /** Localization strings — defaults to English */
+    localization?: Partial<CommentsLocalization>;
+    /**
+     * Number of top-level comments to load per page.
+     * Clicking "Load more" fetches the next page. Default: 10.
+     */
+    pageSize?: number;
+    /**
+     * When false, the comment form and reply buttons are hidden.
+     * Overrides the global `allowPosting` from `CommentsPluginOverrides`.
+     * Defaults to true.
+     */
+    allowPosting?: boolean;
+    /**
+     * When false, the edit button is hidden on comment cards.
+     * Overrides the global `allowEditing` from `CommentsPluginOverrides`.
+     * Defaults to true.
+     */
+    allowEditing?: boolean;
+}
+declare function CommentThread(props: CommentThreadProps): react_jsx_runtime.JSX.Element;
+
+interface CommentCountProps {
+    resourceId: string;
+    resourceType: string;
+    /** Only count approved comments (default) */
+    status?: "pending" | "approved" | "spam";
+    apiBaseURL: string;
+    apiBasePath: string;
+    headers?: HeadersInit;
+    /** Optional className for the wrapper span */
+    className?: string;
+}
+/**
+ * Lightweight badge showing the comment count for a resource.
+ * Does not mount a full comment thread — suitable for post list cards.
+ *
+ * @example
+ * ```tsx
+ * <CommentCount
+ *   resourceId={post.slug}
+ *   resourceType="blog-post"
+ *   apiBaseURL="https://example.com"
+ *   apiBasePath="/api/data"
+ * />
+ * ```
+ */
+declare function CommentCount({ resourceId, resourceType, status, apiBaseURL, apiBasePath, headers, className, }: CommentCountProps): react_jsx_runtime.JSX.Element;
+
+interface CommentFormProps {
+    /** Current user's ID — required to post */
+    authorId: string;
+    /** Optional parent comment ID for replies */
+    parentId?: string | null;
+    /** Initial body value (for editing) */
+    initialBody?: string;
+    /** Label for the submit button */
+    submitLabel?: string;
+    /** Called when form is submitted */
+    onSubmit: (body: string) => Promise<void>;
+    /** Called when cancel is clicked (shows Cancel button when provided) */
+    onCancel?: () => void;
+    /** Custom input component — defaults to a plain Textarea */
+    InputComponent?: ComponentType<{
+        value: string;
+        onChange: (value: string) => void;
+        disabled?: boolean;
+        placeholder?: string;
+    }>;
+    /** Localization strings */
+    localization?: Partial<CommentsLocalization>;
+}
+declare function CommentForm({ authorId: _authorId, initialBody, submitLabel, onSubmit, onCancel, InputComponent, localization: localizationProp, }: CommentFormProps): react_jsx_runtime.JSX.Element;
+
+declare function ModerationPageComponent(): react_jsx_runtime.JSX.Element;
+
+declare function ResourceCommentsPageComponent({ resourceId, resourceType, }: {
+    resourceId: string;
+    resourceType: string;
+}): react_jsx_runtime.JSX.Element;
+
+export { CommentCount, CommentForm, CommentThread, ModerationPageComponent, ResourceCommentsPageComponent };
+export type { CommentComponents, CommentCountProps, CommentFormProps, CommentInputProps, CommentRendererProps, CommentThreadProps };

package/dist/plugins/comments/client/components/index.d.mts

@@ -0,0 +1,125 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ComponentType } from 'react';
+import { C as CommentsLocalization } from '../../../../shared/stack.Ldfkr5b2.mjs';
+
+/** Custom input component props */
+interface CommentInputProps {
+    value: string;
+    onChange: (value: string) => void;
+    disabled?: boolean;
+    placeholder?: string;
+}
+/** Custom renderer component props */
+interface CommentRendererProps {
+    body: string;
+}
+/** Override slot for custom input + renderer */
+interface CommentComponents {
+    Input?: ComponentType<CommentInputProps>;
+    Renderer?: ComponentType<CommentRendererProps>;
+}
+interface CommentThreadProps {
+    /** The resource this thread is attached to (e.g. post slug, task ID) */
+    resourceId: string;
+    /** Discriminates resources across plugins (e.g. "blog-post", "kanban-task") */
+    resourceType: string;
+    /** Base URL for API calls */
+    apiBaseURL: string;
+    /** Path where the API is mounted */
+    apiBasePath: string;
+    /** Currently authenticated user ID. Omit for read-only / unauthenticated. */
+    currentUserId?: string;
+    /**
+     * URL to redirect unauthenticated users to.
+     * When provided and currentUserId is absent, shows a "Please login to comment" prompt.
+     */
+    loginHref?: string;
+    /** Optional HTTP headers for API calls (e.g. forwarding cookies) */
+    headers?: HeadersInit;
+    /** Swap in custom Input / Renderer components */
+    components?: CommentComponents;
+    /** Optional className applied to the root wrapper */
+    className?: string;
+    /** Localization strings — defaults to English */
+    localization?: Partial<CommentsLocalization>;
+    /**
+     * Number of top-level comments to load per page.
+     * Clicking "Load more" fetches the next page. Default: 10.
+     */
+    pageSize?: number;
+    /**
+     * When false, the comment form and reply buttons are hidden.
+     * Overrides the global `allowPosting` from `CommentsPluginOverrides`.
+     * Defaults to true.
+     */
+    allowPosting?: boolean;
+    /**
+     * When false, the edit button is hidden on comment cards.
+     * Overrides the global `allowEditing` from `CommentsPluginOverrides`.
+     * Defaults to true.
+     */
+    allowEditing?: boolean;
+}
+declare function CommentThread(props: CommentThreadProps): react_jsx_runtime.JSX.Element;
+
+interface CommentCountProps {
+    resourceId: string;
+    resourceType: string;
+    /** Only count approved comments (default) */
+    status?: "pending" | "approved" | "spam";
+    apiBaseURL: string;
+    apiBasePath: string;
+    headers?: HeadersInit;
+    /** Optional className for the wrapper span */
+    className?: string;
+}
+/**
+ * Lightweight badge showing the comment count for a resource.
+ * Does not mount a full comment thread — suitable for post list cards.
+ *
+ * @example
+ * ```tsx
+ * <CommentCount
+ *   resourceId={post.slug}
+ *   resourceType="blog-post"
+ *   apiBaseURL="https://example.com"
+ *   apiBasePath="/api/data"
+ * />
+ * ```
+ */
+declare function CommentCount({ resourceId, resourceType, status, apiBaseURL, apiBasePath, headers, className, }: CommentCountProps): react_jsx_runtime.JSX.Element;
+
+interface CommentFormProps {
+    /** Current user's ID — required to post */
+    authorId: string;
+    /** Optional parent comment ID for replies */
+    parentId?: string | null;
+    /** Initial body value (for editing) */
+    initialBody?: string;
+    /** Label for the submit button */
+    submitLabel?: string;
+    /** Called when form is submitted */
+    onSubmit: (body: string) => Promise<void>;
+    /** Called when cancel is clicked (shows Cancel button when provided) */
+    onCancel?: () => void;
+    /** Custom input component — defaults to a plain Textarea */
+    InputComponent?: ComponentType<{
+        value: string;
+        onChange: (value: string) => void;
+        disabled?: boolean;
+        placeholder?: string;
+    }>;
+    /** Localization strings */
+    localization?: Partial<CommentsLocalization>;
+}
+declare function CommentForm({ authorId: _authorId, initialBody, submitLabel, onSubmit, onCancel, InputComponent, localization: localizationProp, }: CommentFormProps): react_jsx_runtime.JSX.Element;
+
+declare function ModerationPageComponent(): react_jsx_runtime.JSX.Element;
+
+declare function ResourceCommentsPageComponent({ resourceId, resourceType, }: {
+    resourceId: string;
+    resourceType: string;
+}): react_jsx_runtime.JSX.Element;
+
+export { CommentCount, CommentForm, CommentThread, ModerationPageComponent, ResourceCommentsPageComponent };
+export type { CommentComponents, CommentCountProps, CommentFormProps, CommentInputProps, CommentRendererProps, CommentThreadProps };