@btst/stack 2.6.2 → 2.8.0

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

@@ -1,6 +1,6 @@
-export { P as PostCreateInput, e as PostUpdateInput, o as UseNextPreviousPostsOptions, p as UseNextPreviousPostsResult, d as UsePostResult, b as UsePostSearchOptions, c as UsePostSearchResult, U as UsePostsOptions, a as UsePostsResult, r as UseRecentPostsOptions, s as UseRecentPostsResult, k as useCreatePost, m as useDeletePost, q as useNextPreviousPosts, g as usePost, n as usePostSearch, u as usePosts, t as useRecentPosts, h as useSuspensePost, f as useSuspensePosts, j as useSuspenseTags, i as useTags, l as useUpdatePost } from '../../../../shared/stack.BwA7trxA.cjs';
+export { P as PostCreateInput, e as PostUpdateInput, o as UseNextPreviousPostsOptions, p as UseNextPreviousPostsResult, d as UsePostResult, b as UsePostSearchOptions, c as UsePostSearchResult, U as UsePostsOptions, a as UsePostsResult, r as UseRecentPostsOptions, s as UseRecentPostsResult, k as useCreatePost, m as useDeletePost, q as useNextPreviousPosts, g as usePost, n as usePostSearch, u as usePosts, t as useRecentPosts, h as useSuspensePost, f as useSuspensePosts, j as useSuspenseTags, i as useTags, l as useUpdatePost } from '../../../../shared/stack.DX-tQ93o.cjs';
 import '@tanstack/react-query';
-import '../../../../shared/stack.BQmuNl5p.cjs';
+import '../../../../shared/stack.BWp0hcm9.cjs';
 import 'zod';
 
 declare function useDebounce<T>(value: T, delay?: number): T;

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

@@ -1,6 +1,6 @@
-export { P as PostCreateInput, e as PostUpdateInput, o as UseNextPreviousPostsOptions, p as UseNextPreviousPostsResult, d as UsePostResult, b as UsePostSearchOptions, c as UsePostSearchResult, U as UsePostsOptions, a as UsePostsResult, r as UseRecentPostsOptions, s as UseRecentPostsResult, k as useCreatePost, m as useDeletePost, q as useNextPreviousPosts, g as usePost, n as usePostSearch, u as usePosts, t as useRecentPosts, h as useSuspensePost, f as useSuspensePosts, j as useSuspenseTags, i as useTags, l as useUpdatePost } from '../../../../shared/stack.B8vT-Yt4.mjs';
+export { P as PostCreateInput, e as PostUpdateInput, o as UseNextPreviousPostsOptions, p as UseNextPreviousPostsResult, d as UsePostResult, b as UsePostSearchOptions, c as UsePostSearchResult, U as UsePostsOptions, a as UsePostsResult, r as UseRecentPostsOptions, s as UseRecentPostsResult, k as useCreatePost, m as useDeletePost, q as useNextPreviousPosts, g as usePost, n as usePostSearch, u as usePosts, t as useRecentPosts, h as useSuspensePost, f as useSuspensePosts, j as useSuspenseTags, i as useTags, l as useUpdatePost } from '../../../../shared/stack.DOZ1EXjM.mjs';
 import '@tanstack/react-query';
-import '../../../../shared/stack.BQmuNl5p.mjs';
+import '../../../../shared/stack.BWp0hcm9.mjs';
 import 'zod';
 
 declare function useDebounce<T>(value: T, delay?: number): T;

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

@@ -1,6 +1,6 @@
-export { P as PostCreateInput, e as PostUpdateInput, o as UseNextPreviousPostsOptions, p as UseNextPreviousPostsResult, d as UsePostResult, b as UsePostSearchOptions, c as UsePostSearchResult, U as UsePostsOptions, a as UsePostsResult, r as UseRecentPostsOptions, s as UseRecentPostsResult, k as useCreatePost, m as useDeletePost, q as useNextPreviousPosts, g as usePost, n as usePostSearch, u as usePosts, t as useRecentPosts, h as useSuspensePost, f as useSuspensePosts, j as useSuspenseTags, i as useTags, l as useUpdatePost } from '../../../../shared/stack.BAT540yW.js';
+export { P as PostCreateInput, e as PostUpdateInput, o as UseNextPreviousPostsOptions, p as UseNextPreviousPostsResult, d as UsePostResult, b as UsePostSearchOptions, c as UsePostSearchResult, U as UsePostsOptions, a as UsePostsResult, r as UseRecentPostsOptions, s as UseRecentPostsResult, k as useCreatePost, m as useDeletePost, q as useNextPreviousPosts, g as usePost, n as usePostSearch, u as usePosts, t as useRecentPosts, h as useSuspensePost, f as useSuspensePosts, j as useSuspenseTags, i as useTags, l as useUpdatePost } from '../../../../shared/stack.VF6FhyZw.js';
 import '@tanstack/react-query';
-import '../../../../shared/stack.BQmuNl5p.js';
+import '../../../../shared/stack.BWp0hcm9.js';
 import 'zod';
 
 declare function useDebounce<T>(value: T, delay?: number): T;

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

@@ -1,9 +1,9 @@
 import * as _btst_stack_plugins_client from '@btst/stack/plugins/client';
 import * as _btst_yar from '@btst/yar';
-import { ComponentType } from 'react';
+import { ComponentType, ReactNode } from 'react';
 import { QueryClient } from '@tanstack/react-query';
-import { P as Post, S as SerializedPost } from '../../../shared/stack.BQmuNl5p.cjs';
-export { U as UsePostsOptions, a as UsePostsResult } from '../../../shared/stack.BwA7trxA.cjs';
+import { P as Post, S as SerializedPost } from '../../../shared/stack.BWp0hcm9.cjs';
+export { U as UsePostsOptions, a as UsePostsResult } from '../../../shared/stack.DX-tQ93o.cjs';
 import 'zod';
 
 /**
@@ -503,6 +503,28 @@ interface BlogPluginOverrides {
      * @param context - Route context
      */
     onBeforeDraftsPageRendered?: (context: RouteContext) => boolean;
+    /**
+     * Optional slot rendered below the blog post body.
+     * Use this to inject a comment thread or any custom content without
+     * coupling the blog plugin to the comments plugin.
+     *
+     * @example
+     * ```tsx
+     * blog: {
+     *   postBottomSlot: (post) => (
+     *     <CommentThread
+     *       resourceId={post.slug}
+     *       resourceType="blog-post"
+     *       apiBaseURL={apiBaseURL}
+     *       apiBasePath="/api/data"
+     *       currentUserId={session?.userId}
+     *       loginHref="/login"
+     *     />
+     *   ),
+     * }
+     * ```
+     */
+    postBottomSlot?: (post: SerializedPost) => ReactNode;
 }
 
 export { blogClientPlugin };

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

@@ -1,9 +1,9 @@
 import * as _btst_stack_plugins_client from '@btst/stack/plugins/client';
 import * as _btst_yar from '@btst/yar';
-import { ComponentType } from 'react';
+import { ComponentType, ReactNode } from 'react';
 import { QueryClient } from '@tanstack/react-query';
-import { P as Post, S as SerializedPost } from '../../../shared/stack.BQmuNl5p.mjs';
-export { U as UsePostsOptions, a as UsePostsResult } from '../../../shared/stack.B8vT-Yt4.mjs';
+import { P as Post, S as SerializedPost } from '../../../shared/stack.BWp0hcm9.mjs';
+export { U as UsePostsOptions, a as UsePostsResult } from '../../../shared/stack.DOZ1EXjM.mjs';
 import 'zod';
 
 /**
@@ -503,6 +503,28 @@ interface BlogPluginOverrides {
      * @param context - Route context
      */
     onBeforeDraftsPageRendered?: (context: RouteContext) => boolean;
+    /**
+     * Optional slot rendered below the blog post body.
+     * Use this to inject a comment thread or any custom content without
+     * coupling the blog plugin to the comments plugin.
+     *
+     * @example
+     * ```tsx
+     * blog: {
+     *   postBottomSlot: (post) => (
+     *     <CommentThread
+     *       resourceId={post.slug}
+     *       resourceType="blog-post"
+     *       apiBaseURL={apiBaseURL}
+     *       apiBasePath="/api/data"
+     *       currentUserId={session?.userId}
+     *       loginHref="/login"
+     *     />
+     *   ),
+     * }
+     * ```
+     */
+    postBottomSlot?: (post: SerializedPost) => ReactNode;
 }
 
 export { blogClientPlugin };

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

@@ -1,9 +1,9 @@
 import * as _btst_stack_plugins_client from '@btst/stack/plugins/client';
 import * as _btst_yar from '@btst/yar';
-import { ComponentType } from 'react';
+import { ComponentType, ReactNode } from 'react';
 import { QueryClient } from '@tanstack/react-query';
-import { P as Post, S as SerializedPost } from '../../../shared/stack.BQmuNl5p.js';
-export { U as UsePostsOptions, a as UsePostsResult } from '../../../shared/stack.BAT540yW.js';
+import { P as Post, S as SerializedPost } from '../../../shared/stack.BWp0hcm9.js';
+export { U as UsePostsOptions, a as UsePostsResult } from '../../../shared/stack.VF6FhyZw.js';
 import 'zod';
 
 /**
@@ -503,6 +503,28 @@ interface BlogPluginOverrides {
      * @param context - Route context
      */
     onBeforeDraftsPageRendered?: (context: RouteContext) => boolean;
+    /**
+     * Optional slot rendered below the blog post body.
+     * Use this to inject a comment thread or any custom content without
+     * coupling the blog plugin to the comments plugin.
+     *
+     * @example
+     * ```tsx
+     * blog: {
+     *   postBottomSlot: (post) => (
+     *     <CommentThread
+     *       resourceId={post.slug}
+     *       resourceType="blog-post"
+     *       apiBaseURL={apiBaseURL}
+     *       apiBasePath="/api/data"
+     *       currentUserId={session?.userId}
+     *       loginHref="/login"
+     *     />
+     *   ),
+     * }
+     * ```
+     */
+    postBottomSlot?: (post: SerializedPost) => ReactNode;
 }
 
 export { blogClientPlugin };

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

@@ -1,8 +1,8 @@
 import '@tanstack/react-query';
-export { d as createBlogQueryKeys } from '../../shared/stack.DaZM10cp.cjs';
+export { d as createBlogQueryKeys } from '../../shared/stack.BSqJrCTM.cjs';
 import '@btst/stack/plugins/client';
-import '../../shared/stack.BQmuNl5p.cjs';
+import '../../shared/stack.BWp0hcm9.cjs';
 import '@btst/stack/plugins/api';
-import 'better-call';
 import '@btst/db';
+import 'better-call';
 import 'zod';

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

@@ -1,8 +1,8 @@
 import '@tanstack/react-query';
-export { d as createBlogQueryKeys } from '../../shared/stack.cfCkioTe.mjs';
+export { d as createBlogQueryKeys } from '../../shared/stack.DzOhpIYM.mjs';
 import '@btst/stack/plugins/client';
-import '../../shared/stack.BQmuNl5p.mjs';
+import '../../shared/stack.BWp0hcm9.mjs';
 import '@btst/stack/plugins/api';
-import 'better-call';
 import '@btst/db';
+import 'better-call';
 import 'zod';

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

@@ -1,8 +1,8 @@
 import '@tanstack/react-query';
-export { d as createBlogQueryKeys } from '../../shared/stack.DXnclTG7.js';
+export { d as createBlogQueryKeys } from '../../shared/stack.BXxrFL9R.js';
 import '@btst/stack/plugins/client';
-import '../../shared/stack.BQmuNl5p.js';
+import '../../shared/stack.BWp0hcm9.js';
 import '@btst/stack/plugins/api';
-import 'better-call';
 import '@btst/db';
+import 'better-call';
 import 'zod';

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

@@ -1,5 +1,5 @@
-import { C as ClientPlugin } from '../../shared/stack.7n9Y_u7N.cjs';
-export { P as PluginOverrides } from '../../shared/stack.7n9Y_u7N.cjs';
+import { C as ClientPlugin } from '../../shared/stack.CQnwAN7x.cjs';
+export { P as PluginOverrides } from '../../shared/stack.CQnwAN7x.cjs';
 import { Route } from '@btst/yar';
 export { Route, createRoute, createRouter } from '@btst/yar';
 import { createClient } from 'better-call/client';

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

@@ -1,5 +1,5 @@
-import { C as ClientPlugin } from '../../shared/stack.7n9Y_u7N.mjs';
-export { P as PluginOverrides } from '../../shared/stack.7n9Y_u7N.mjs';
+import { C as ClientPlugin } from '../../shared/stack.CQnwAN7x.mjs';
+export { P as PluginOverrides } from '../../shared/stack.CQnwAN7x.mjs';
 import { Route } from '@btst/yar';
 export { Route, createRoute, createRouter } from '@btst/yar';
 import { createClient } from 'better-call/client';

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

@@ -1,5 +1,5 @@
-import { C as ClientPlugin } from '../../shared/stack.7n9Y_u7N.js';
-export { P as PluginOverrides } from '../../shared/stack.7n9Y_u7N.js';
+import { C as ClientPlugin } from '../../shared/stack.CQnwAN7x.js';
+export { P as PluginOverrides } from '../../shared/stack.CQnwAN7x.js';
 import { Route } from '@btst/yar';
 export { Route, createRoute, createRouter } from '@btst/yar';
 import { createClient } from 'better-call/client';

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

@@ -1,4 +1,4 @@
-export { C as CMSApiRouter, b as CMSRouteKey, l as CMS_QUERY_KEYS, k as CreateCMSContentItemInput, c as cmsBackendPlugin, j as createCMSContentItem, d as getAllContentItems, g as getAllContentTypes, f as getContentItemById, e as getContentItemBySlug, h as serializeContentItem, i as serializeContentItemWithType, s as serializeContentType } from '../../../shared/stack.C9Mg2Q46.cjs';
+export { C as CMSApiRouter, b as CMSRouteKey, l as CMS_QUERY_KEYS, k as CreateCMSContentItemInput, c as cmsBackendPlugin, j as createCMSContentItem, d as getAllContentItems, g as getAllContentTypes, f as getContentItemById, e as getContentItemBySlug, h as serializeContentItem, i as serializeContentItemWithType, s as serializeContentType } from '../../../shared/stack.C9zoS1TN.cjs';
 import '@btst/stack/plugins/api';
 import '../../../shared/stack.B8QD11QU.cjs';
 import 'zod';

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

@@ -1,4 +1,4 @@
-export { C as CMSApiRouter, b as CMSRouteKey, l as CMS_QUERY_KEYS, k as CreateCMSContentItemInput, c as cmsBackendPlugin, j as createCMSContentItem, d as getAllContentItems, g as getAllContentTypes, f as getContentItemById, e as getContentItemBySlug, h as serializeContentItem, i as serializeContentItemWithType, s as serializeContentType } from '../../../shared/stack.B58oHdqm.mjs';
+export { C as CMSApiRouter, b as CMSRouteKey, l as CMS_QUERY_KEYS, k as CreateCMSContentItemInput, c as cmsBackendPlugin, j as createCMSContentItem, d as getAllContentItems, g as getAllContentTypes, f as getContentItemById, e as getContentItemBySlug, h as serializeContentItem, i as serializeContentItemWithType, s as serializeContentType } from '../../../shared/stack.BX7MHi0J.mjs';
 import '@btst/stack/plugins/api';
 import '../../../shared/stack.B8QD11QU.mjs';
 import 'zod';

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

@@ -1,4 +1,4 @@
-export { C as CMSApiRouter, b as CMSRouteKey, l as CMS_QUERY_KEYS, k as CreateCMSContentItemInput, c as cmsBackendPlugin, j as createCMSContentItem, d as getAllContentItems, g as getAllContentTypes, f as getContentItemById, e as getContentItemBySlug, h as serializeContentItem, i as serializeContentItemWithType, s as serializeContentType } from '../../../shared/stack.sO33ZDhK.js';
+export { C as CMSApiRouter, b as CMSRouteKey, l as CMS_QUERY_KEYS, k as CreateCMSContentItemInput, c as cmsBackendPlugin, j as createCMSContentItem, d as getAllContentItems, g as getAllContentTypes, f as getContentItemById, e as getContentItemBySlug, h as serializeContentItem, i as serializeContentItemWithType, s as serializeContentType } from '../../../shared/stack.fQjVhw5a.js';
 import '@btst/stack/plugins/api';
 import '../../../shared/stack.B8QD11QU.js';
 import 'zod';

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

@@ -2,7 +2,7 @@ import * as _btst_stack_plugins_client from '@btst/stack/plugins/client';
 import * as _btst_yar from '@btst/yar';
 import { ComponentType } from 'react';
 import { QueryClient } from '@tanstack/react-query';
-import { A as AutoFormInputComponentProps } from '../../../shared/stack.fdi94T4S.cjs';
+import { A as AutoFormInputComponentProps } from '../../../shared/stack.CPsYC2-Z.cjs';
 export { b as FormSchemaMetadata, F as FormStep, f as formSchemaToZod, a as getStepGroupMap, g as getSteps, h as hasSteps, z as zodToFormSchema } from '../../../shared/stack.Co034Fpm.cjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import 'react-hook-form';

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

@@ -2,7 +2,7 @@ import * as _btst_stack_plugins_client from '@btst/stack/plugins/client';
 import * as _btst_yar from '@btst/yar';
 import { ComponentType } from 'react';
 import { QueryClient } from '@tanstack/react-query';
-import { A as AutoFormInputComponentProps } from '../../../shared/stack.fdi94T4S.mjs';
+import { A as AutoFormInputComponentProps } from '../../../shared/stack.CPsYC2-Z.mjs';
 export { b as FormSchemaMetadata, F as FormStep, f as formSchemaToZod, a as getStepGroupMap, g as getSteps, h as hasSteps, z as zodToFormSchema } from '../../../shared/stack.Co034Fpm.mjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import 'react-hook-form';

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

@@ -2,7 +2,7 @@ import * as _btst_stack_plugins_client from '@btst/stack/plugins/client';
 import * as _btst_yar from '@btst/yar';
 import { ComponentType } from 'react';
 import { QueryClient } from '@tanstack/react-query';
-import { A as AutoFormInputComponentProps } from '../../../shared/stack.fdi94T4S.js';
+import { A as AutoFormInputComponentProps } from '../../../shared/stack.CPsYC2-Z.js';
 export { b as FormSchemaMetadata, F as FormStep, f as formSchemaToZod, a as getStepGroupMap, g as getSteps, h as hasSteps, z as zodToFormSchema } from '../../../shared/stack.Co034Fpm.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import 'react-hook-form';

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

@@ -1,4 +1,4 @@
-import { C as CMSApiRouter, a as ContentListDiscriminator } from '../../shared/stack.C9Mg2Q46.cjs';
+import { C as CMSApiRouter, a as ContentListDiscriminator } from '../../shared/stack.C9zoS1TN.cjs';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { createApiClient } from '@btst/stack/plugins/client';
 import { S as SerializedContentType, P as PaginatedContentItems, a as SerializedContentItemWithType } from '../../shared/stack.B8QD11QU.cjs';

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

@@ -1,4 +1,4 @@
-import { C as CMSApiRouter, a as ContentListDiscriminator } from '../../shared/stack.B58oHdqm.mjs';
+import { C as CMSApiRouter, a as ContentListDiscriminator } from '../../shared/stack.BX7MHi0J.mjs';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { createApiClient } from '@btst/stack/plugins/client';
 import { S as SerializedContentType, P as PaginatedContentItems, a as SerializedContentItemWithType } from '../../shared/stack.B8QD11QU.mjs';

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

@@ -1,4 +1,4 @@
-import { C as CMSApiRouter, a as ContentListDiscriminator } from '../../shared/stack.sO33ZDhK.js';
+import { C as CMSApiRouter, a as ContentListDiscriminator } from '../../shared/stack.fQjVhw5a.js';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { createApiClient } from '@btst/stack/plugins/client';
 import { S as SerializedContentType, P as PaginatedContentItems, a as SerializedContentItemWithType } from '../../shared/stack.B8QD11QU.js';

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

@@ -0,0 +1,21 @@
+'use strict';
+
+const plugin = require('../../../packages/stack/src/plugins/comments/api/plugin.cjs');
+const getters = require('../../../packages/stack/src/plugins/comments/api/getters.cjs');
+const mutations = require('../../../packages/stack/src/plugins/comments/api/mutations.cjs');
+const serializers = require('../../../packages/stack/src/plugins/comments/api/serializers.cjs');
+const queryKeyDefs = require('../../../packages/stack/src/plugins/comments/api/query-key-defs.cjs');
+
+
+
+exports.commentsBackendPlugin = plugin.commentsBackendPlugin;
+exports.getCommentById = getters.getCommentById;
+exports.getCommentCount = getters.getCommentCount;
+exports.listComments = getters.listComments;
+exports.createComment = mutations.createComment;
+exports.deleteComment = mutations.deleteComment;
+exports.toggleCommentLike = mutations.toggleCommentLike;
+exports.updateComment = mutations.updateComment;
+exports.updateCommentStatus = mutations.updateCommentStatus;
+exports.serializeComment = serializers.serializeComment;
+exports.COMMENTS_QUERY_KEYS = queryKeyDefs.COMMENTS_QUERY_KEYS;

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 };