@btst/stack 4.6.0 → 5.0.0

package/dist/shared/stack.IWIKQJ2Z.d.mts

@@ -0,0 +1,707 @@
+import * as _btst_stack_plugins_api from '@btst/stack/plugins/api';
+import { DeepReadonly, OperationContext } from '@btst/stack/plugins/api';
+import { PermissionDescriptor } from '../authorization/index.mjs';
+import * as zod_v4_core from 'zod/v4/core';
+import * as zod from 'zod';
+import { z } from 'zod';
+import { S as SerializedComment, C as CommentListResult, b as CommentStatus } from './stack.COrJrztD.mjs';
+import * as better_call from 'better-call';
+import { PermissionFactsFor } from '@btst/stack/authorization';
+import { commentsPermissions } from '../plugins/comments/permissions.mjs';
+
+/**
+ * Schema for the POST /comments request body.
+ * authorId is intentionally absent — request operations resolve it through
+ * the generic server auth adapter. Never trust authorId from the client body.
+ */
+declare const createCommentSchema: z.ZodObject<{
+    resourceId: z.ZodString;
+    resourceType: z.ZodString;
+    parentId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    body: z.ZodString;
+}, z.core.$strip>;
+/**
+ * Schema for GET /comments query parameters.
+ *
+ * `currentUserId` is intentionally absent — it is never accepted from the client.
+ * The server always resolves the caller's identity through the generic auth
+ * adapter and injects it internally. Accepting it from the client would allow any
+ * anonymous caller to supply an arbitrary user ID and read that user's pending
+ * (pre-moderation) comments.
+ */
+declare const CommentListQuerySchema: z.ZodObject<{
+    resourceId: z.ZodOptional<z.ZodString>;
+    resourceType: z.ZodOptional<z.ZodString>;
+    parentId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    status: z.ZodOptional<z.ZodEnum<{
+        pending: "pending";
+        approved: "approved";
+        spam: "spam";
+    }>>;
+    authorId: z.ZodOptional<z.ZodString>;
+    sort: z.ZodOptional<z.ZodEnum<{
+        asc: "asc";
+        desc: "desc";
+    }>>;
+    limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    offset: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+/**
+ * Lower-level params schema used by `listComments()`.
+ * Extends the HTTP query schema with `currentUserId`, which is always injected
+ * server-side (by the maintained operation from request identity, or by a
+ * raw data-layer caller such as a Server Component or cron job).
+ */
+declare const CommentListParamsSchema: z.ZodObject<{
+    resourceId: z.ZodOptional<z.ZodString>;
+    resourceType: z.ZodOptional<z.ZodString>;
+    parentId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    status: z.ZodOptional<z.ZodEnum<{
+        pending: "pending";
+        approved: "approved";
+        spam: "spam";
+    }>>;
+    authorId: z.ZodOptional<z.ZodString>;
+    sort: z.ZodOptional<z.ZodEnum<{
+        asc: "asc";
+        desc: "desc";
+    }>>;
+    limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    offset: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    currentUserId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const CommentCountQuerySchema: z.ZodObject<{
+    resourceId: z.ZodString;
+    resourceType: z.ZodString;
+    status: z.ZodOptional<z.ZodEnum<{
+        pending: "pending";
+        approved: "approved";
+        spam: "spam";
+    }>>;
+}, z.core.$strip>;
+
+declare const CreateCommentOperationInputSchema: z.ZodObject<{
+    resourceId: z.ZodString;
+    resourceType: z.ZodString;
+    parentId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    body: z.ZodString;
+    authorId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const UpdateCommentOperationInputSchema: z.ZodObject<{
+    id: z.ZodString;
+    data: z.ZodObject<{
+        body: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+declare const ToggleCommentLikeOperationInputSchema: z.ZodObject<{
+    id: z.ZodString;
+    authorId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const UpdateCommentStatusOperationInputSchema: z.ZodObject<{
+    id: z.ZodString;
+    data: z.ZodObject<{
+        status: z.ZodEnum<{
+            pending: "pending";
+            approved: "approved";
+            spam: "spam";
+        }>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+declare const DeleteCommentOperationInputSchema: z.ZodObject<{
+    id: z.ZodString;
+}, z.core.$strip>;
+type ReadFacts = PermissionFactsFor<typeof commentsPermissions.thread.read>;
+type CreateFacts = PermissionFactsFor<typeof commentsPermissions.thread.createComment>;
+type EditFacts = PermissionFactsFor<typeof commentsPermissions.comment.edit>;
+type DeleteFacts = PermissionFactsFor<typeof commentsPermissions.comment.delete>;
+type ReactFacts = PermissionFactsFor<typeof commentsPermissions.comment.react>;
+type ModerateFacts = PermissionFactsFor<typeof commentsPermissions.comment.moderate>;
+type ListInput = z.output<typeof CommentListQuerySchema>;
+type CountInput = z.output<typeof CommentCountQuerySchema>;
+type CreateInput = z.output<typeof CreateCommentOperationInputSchema>;
+type UpdateInput = z.output<typeof UpdateCommentOperationInputSchema>;
+type ToggleLikeInput = z.output<typeof ToggleCommentLikeOperationInputSchema>;
+type UpdateStatusInput = z.output<typeof UpdateCommentStatusOperationInputSchema>;
+type DeleteInput = z.output<typeof DeleteCommentOperationInputSchema>;
+type RequestFields = {
+    /** Request that entered the authorized transport, when one exists. */
+    readonly request?: Request;
+    /** Headers from the request that entered the authorized transport. */
+    readonly headers?: Headers;
+};
+/** Authorized context supplied before a Comments list query executes. */
+interface CommentsListOperationContext extends OperationContext<ListInput, ReadFacts>, RequestFields {
+    /** Validated immutable list query. */
+    readonly query: DeepReadonly<ListInput>;
+}
+/** Authorized context supplied before a Comments count query executes. */
+interface CommentsCountOperationContext extends OperationContext<CountInput, ReadFacts>, RequestFields {
+    /** Validated immutable count query. */
+    readonly query: DeepReadonly<CountInput>;
+}
+/** Authorized context supplied before a comment is created. */
+interface CommentsCreateOperationContext extends OperationContext<CreateInput, CreateFacts>, RequestFields {
+    /** Validated immutable comment input. */
+    readonly body: DeepReadonly<CreateInput>;
+}
+/** Comment-create context after execution. */
+interface CommentsCreateResultContext extends CommentsCreateOperationContext {
+    /** Immutable serialized comment returned by the operation. */
+    readonly result: DeepReadonly<SerializedComment>;
+}
+/** Authorized context supplied before a comment is edited. */
+interface CommentsEditOperationContext extends OperationContext<UpdateInput, EditFacts>, RequestFields {
+    /** Validated route parameters. */
+    readonly params: {
+        readonly id: string;
+    };
+    /** Validated immutable edit body. */
+    readonly body: DeepReadonly<UpdateInput["data"]>;
+}
+/** Comment-edit context after execution. */
+interface CommentsEditResultContext extends CommentsEditOperationContext {
+    /** Immutable serialized comment returned by the operation. */
+    readonly result: DeepReadonly<SerializedComment>;
+}
+/** Authorized context supplied before a reaction is toggled. */
+interface CommentsReactOperationContext extends OperationContext<ToggleLikeInput, ReactFacts>, RequestFields {
+    /** Validated route parameters. */
+    readonly params: {
+        readonly id: string;
+    };
+}
+/** Authorized context supplied before a comment is moderated. */
+interface CommentsModerateOperationContext extends OperationContext<UpdateStatusInput, ModerateFacts>, RequestFields {
+    /** Validated route parameters. */
+    readonly params: {
+        readonly id: string;
+    };
+    /** Validated immutable moderation body. */
+    readonly body: DeepReadonly<UpdateStatusInput["data"]>;
+}
+/** Comment-moderation context after execution. */
+interface CommentsModerateResultContext extends CommentsModerateOperationContext {
+    /** Immutable serialized comment returned by the operation. */
+    readonly result: DeepReadonly<SerializedComment>;
+}
+/** Authorized context supplied before a comment is deleted. */
+interface CommentsDeleteOperationContext extends OperationContext<DeleteInput, DeleteFacts>, RequestFields {
+    /** Validated route parameters. */
+    readonly params: {
+        readonly id: string;
+    };
+}
+/** Comment-delete context after execution. */
+interface CommentsDeleteResultContext extends CommentsDeleteOperationContext {
+    /** Immutable deletion result returned by the operation. */
+    readonly result: {
+        readonly success: true;
+    };
+}
+/** Domain lifecycle hooks that run only after successful Comments authorization. */
+interface CommentsBackendHooks {
+    /** Run before an authorized comment-list query. */
+    onBeforeListComments?: (query: DeepReadonly<ListInput>, context: CommentsListOperationContext) => Promise<void> | void;
+    /** Run before an authorized comment-count query. */
+    onBeforeCountComments?: (query: DeepReadonly<CountInput>, context: CommentsCountOperationContext) => Promise<void> | void;
+    /** Run before an authorized author-scoped list query. */
+    onBeforeListCommentsByAuthor?: (authorId: string, query: DeepReadonly<ListInput>, context: CommentsListOperationContext) => Promise<void> | void;
+    /** Run before an authorized comment create. */
+    onBeforeCreateComment?: (input: DeepReadonly<z.output<typeof createCommentSchema>>, context: CommentsCreateOperationContext) => Promise<void> | void;
+    /** Run after a comment is created. */
+    onAfterCreateComment?: (comment: DeepReadonly<SerializedComment>, context: CommentsCreateResultContext) => Promise<void> | void;
+    /** Run before an authorized comment edit. */
+    onBeforeUpdateComment?: (commentId: string, update: DeepReadonly<UpdateInput["data"]>, context: CommentsEditOperationContext) => Promise<void> | void;
+    /** Run after a comment is edited. */
+    onAfterUpdateComment?: (comment: DeepReadonly<SerializedComment>, context: CommentsEditResultContext) => Promise<void> | void;
+    /** Run before an authorized reaction is toggled. */
+    onBeforeToggleCommentReaction?: (commentId: string, authorId: string, context: CommentsReactOperationContext) => Promise<void> | void;
+    /** Run before an authorized moderation status change. */
+    onBeforeModerateComment?: (commentId: string, status: "pending" | "approved" | "spam", context: CommentsModerateOperationContext) => Promise<void> | void;
+    /** Run after a comment is approved. */
+    onAfterApproveComment?: (comment: DeepReadonly<SerializedComment>, context: CommentsModerateResultContext) => Promise<void> | void;
+    /** Run before an authorized comment deletion. */
+    onBeforeDeleteComment?: (commentId: string, context: CommentsDeleteOperationContext) => Promise<void> | void;
+    /** Run after a comment is deleted. */
+    onAfterDeleteComment?: (commentId: string, context: CommentsDeleteResultContext) => Promise<void> | void;
+}
+/** Configuration for the Comments backend plugin. */
+interface CommentsBackendOptions {
+    /** Automatically approve newly created comments. @default false */
+    autoApprove?: boolean;
+    /** Register the create-comment HTTP endpoint. @default true */
+    allowPosting?: boolean;
+    /** Register the edit-comment HTTP endpoint. @default true */
+    allowEditing?: boolean;
+    /** Resolve public display data for comment authors. */
+    resolveUser?: (authorId: string) => Promise<{
+        name: string;
+        avatarUrl?: string;
+    } | null>;
+    /** Post-authorization domain lifecycle hooks. */
+    hooks?: CommentsBackendHooks;
+}
+/** Serialized list result returned by maintained Comments read operations. */
+type SerializedCommentListResult = CommentListResult;
+
+/**
+ * Comments backend plugin. Maintained HTTP endpoints adapt the same operation
+ * inventory exposed by `forRequest(request).operations.comments` and
+ * `trusted.comments`.
+ */
+declare const commentsBackendPlugin: (options?: CommentsBackendOptions) => _btst_stack_plugins_api.BackendPlugin<{
+    readonly getCommentCount: better_call.StrictEndpoint<"/comments/count", {
+        requireRequest: true;
+    } & {
+        method: "GET";
+    } & {
+        query: better_call.StandardSchemaV1<{
+            resourceId: string;
+            resourceType: string;
+            status?: "pending" | "approved" | "spam" | undefined;
+        }, {
+            resourceId: string;
+            resourceType: string;
+            status?: "pending" | "approved" | "spam" | undefined;
+        }>;
+    }, {
+        readonly count: number;
+    }>;
+    readonly toggleLike: better_call.StrictEndpoint<"/comments/:id/like", {
+        requireRequest: true;
+    } & {
+        method: "POST";
+        body: better_call.StandardSchemaV1<{
+            authorId?: string | undefined;
+        }, {
+            authorId?: string | undefined;
+        }>;
+    }, {
+        readonly likes: number;
+        readonly isLiked: boolean;
+    }>;
+    readonly updateCommentStatus: better_call.StrictEndpoint<"/comments/:id/status", {
+        requireRequest: true;
+    } & {
+        method: "PATCH";
+        body: better_call.StandardSchemaV1<{
+            status: "pending" | "approved" | "spam";
+        }, {
+            status: "pending" | "approved" | "spam";
+        }>;
+    }, {
+        readonly id: string;
+        readonly resourceId: string;
+        readonly resourceType: string;
+        readonly parentId: string | null;
+        readonly authorId: string;
+        readonly resolvedAuthorName: string;
+        readonly resolvedAvatarUrl: string | null;
+        readonly body: string;
+        readonly status: CommentStatus;
+        readonly likes: number;
+        readonly isLikedByCurrentUser: boolean;
+        readonly editedAt: string | null;
+        readonly createdAt: string;
+        readonly updatedAt: string;
+        readonly replyCount: number;
+    }>;
+    readonly deleteComment: better_call.StrictEndpoint<"/comments/:id", {
+        requireRequest: true;
+    } & {
+        method: "DELETE";
+        body: better_call.StandardSchemaV1<unknown, unknown>;
+    }, {
+        readonly success: true;
+    }>;
+    readonly updateComment?: better_call.StrictEndpoint<"/comments/:id", {
+        requireRequest: true;
+    } & {
+        method: "PATCH";
+        body: better_call.StandardSchemaV1<{
+            body: string;
+        }, {
+            body: string;
+        }>;
+    }, {
+        readonly id: string;
+        readonly resourceId: string;
+        readonly resourceType: string;
+        readonly parentId: string | null;
+        readonly authorId: string;
+        readonly resolvedAuthorName: string;
+        readonly resolvedAvatarUrl: string | null;
+        readonly body: string;
+        readonly status: CommentStatus;
+        readonly likes: number;
+        readonly isLikedByCurrentUser: boolean;
+        readonly editedAt: string | null;
+        readonly createdAt: string;
+        readonly updatedAt: string;
+        readonly replyCount: number;
+    }> | undefined;
+    readonly createComment?: better_call.StrictEndpoint<"/comments", {
+        requireRequest: true;
+    } & {
+        method: "POST";
+        body: better_call.StandardSchemaV1<{
+            resourceId: string;
+            resourceType: string;
+            body: string;
+            parentId?: string | null | undefined;
+        }, {
+            resourceId: string;
+            resourceType: string;
+            body: string;
+            parentId?: string | null | undefined;
+        }>;
+    }, {
+        readonly id: string;
+        readonly resourceId: string;
+        readonly resourceType: string;
+        readonly parentId: string | null;
+        readonly authorId: string;
+        readonly resolvedAuthorName: string;
+        readonly resolvedAvatarUrl: string | null;
+        readonly body: string;
+        readonly status: CommentStatus;
+        readonly likes: number;
+        readonly isLikedByCurrentUser: boolean;
+        readonly editedAt: string | null;
+        readonly createdAt: string;
+        readonly updatedAt: string;
+        readonly replyCount: number;
+    }> | undefined;
+    readonly listComments: better_call.StrictEndpoint<"/comments", {
+        requireRequest: true;
+    } & {
+        method: "GET";
+    } & {
+        query: better_call.StandardSchemaV1<{
+            resourceId?: string | undefined;
+            resourceType?: string | undefined;
+            parentId?: string | null | undefined;
+            status?: "pending" | "approved" | "spam" | undefined;
+            authorId?: string | undefined;
+            sort?: "asc" | "desc" | undefined;
+            limit?: unknown;
+            offset?: unknown;
+        }, {
+            resourceId?: string | undefined;
+            resourceType?: string | undefined;
+            parentId?: string | null | undefined;
+            status?: "pending" | "approved" | "spam" | undefined;
+            authorId?: string | undefined;
+            sort?: "asc" | "desc" | undefined;
+            limit?: unknown;
+            offset?: unknown;
+        }>;
+    }, {
+        readonly items: readonly {
+            readonly id: string;
+            readonly resourceId: string;
+            readonly resourceType: string;
+            readonly parentId: string | null;
+            readonly authorId: string;
+            readonly resolvedAuthorName: string;
+            readonly resolvedAvatarUrl: string | null;
+            readonly body: string;
+            readonly status: CommentStatus;
+            readonly likes: number;
+            readonly isLikedByCurrentUser: boolean;
+            readonly editedAt: string | null;
+            readonly createdAt: string;
+            readonly updatedAt: string;
+            readonly replyCount: number;
+        }[];
+        readonly total: number;
+        readonly limit: number;
+        readonly offset: number;
+    }>;
+}, never, {
+    readonly listComments: _btst_stack_plugins_api.Operation<zod.ZodObject<{
+        resourceId: zod.ZodOptional<zod.ZodString>;
+        resourceType: zod.ZodOptional<zod.ZodString>;
+        parentId: zod.ZodNullable<zod.ZodOptional<zod.ZodString>>;
+        status: zod.ZodOptional<zod.ZodEnum<{
+            pending: "pending";
+            approved: "approved";
+            spam: "spam";
+        }>>;
+        authorId: zod.ZodOptional<zod.ZodString>;
+        sort: zod.ZodOptional<zod.ZodEnum<{
+            asc: "asc";
+            desc: "desc";
+        }>>;
+        limit: zod.ZodOptional<zod.ZodCoercedNumber<unknown>>;
+        offset: zod.ZodOptional<zod.ZodCoercedNumber<unknown>>;
+    }, zod_v4_core.$strip>, PermissionDescriptor<"comments:thread.read", zod.ZodDiscriminatedUnion<[zod.ZodObject<{
+        scope: zod.ZodLiteral<"public">;
+        resourceId: zod.ZodString;
+        resourceType: zod.ZodString;
+    }, zod_v4_core.$strip>, zod.ZodObject<{
+        scope: zod.ZodLiteral<"own">;
+        authorId: zod.ZodString;
+    }, zod_v4_core.$strip>, zod.ZodObject<{
+        resourceId: zod.ZodOptional<zod.ZodString>;
+        resourceType: zod.ZodOptional<zod.ZodString>;
+        scope: zod.ZodLiteral<"moderation">;
+        status: zod.ZodEnum<{
+            pending: "pending";
+            approved: "approved";
+            spam: "spam";
+        }>;
+    }, zod_v4_core.$strip>], "scope">>, {
+        items: {
+            id: string;
+            resourceId: string;
+            resourceType: string;
+            parentId: string | null;
+            authorId: string;
+            resolvedAuthorName: string;
+            resolvedAvatarUrl: string | null;
+            body: string;
+            status: CommentStatus;
+            likes: number;
+            isLikedByCurrentUser: boolean;
+            editedAt: string | null;
+            createdAt: string;
+            updatedAt: string;
+            replyCount: number;
+        }[];
+        total: number;
+        limit: number;
+        offset: number;
+    }, false>;
+    readonly getCommentCount: _btst_stack_plugins_api.Operation<zod.ZodObject<{
+        resourceId: zod.ZodString;
+        resourceType: zod.ZodString;
+        status: zod.ZodOptional<zod.ZodEnum<{
+            pending: "pending";
+            approved: "approved";
+            spam: "spam";
+        }>>;
+    }, zod_v4_core.$strip>, PermissionDescriptor<"comments:thread.read", zod.ZodDiscriminatedUnion<[zod.ZodObject<{
+        scope: zod.ZodLiteral<"public">;
+        resourceId: zod.ZodString;
+        resourceType: zod.ZodString;
+    }, zod_v4_core.$strip>, zod.ZodObject<{
+        scope: zod.ZodLiteral<"own">;
+        authorId: zod.ZodString;
+    }, zod_v4_core.$strip>, zod.ZodObject<{
+        resourceId: zod.ZodOptional<zod.ZodString>;
+        resourceType: zod.ZodOptional<zod.ZodString>;
+        scope: zod.ZodLiteral<"moderation">;
+        status: zod.ZodEnum<{
+            pending: "pending";
+            approved: "approved";
+            spam: "spam";
+        }>;
+    }, zod_v4_core.$strip>], "scope">>, {
+        count: number;
+    }, false>;
+    readonly createComment: _btst_stack_plugins_api.Operation<zod.ZodObject<{
+        resourceId: zod.ZodString;
+        resourceType: zod.ZodString;
+        parentId: zod.ZodNullable<zod.ZodOptional<zod.ZodString>>;
+        body: zod.ZodString;
+        authorId: zod.ZodOptional<zod.ZodString>;
+    }, zod_v4_core.$strip>, PermissionDescriptor<"comments:thread.createComment", zod.ZodObject<{
+        resourceId: zod.ZodString;
+        resourceType: zod.ZodString;
+        parentId: zod.ZodNullable<zod.ZodString>;
+    }, zod_v4_core.$strip>>, {
+        id: string;
+        resourceId: string;
+        resourceType: string;
+        parentId: string | null;
+        authorId: string;
+        resolvedAuthorName: string;
+        resolvedAvatarUrl: string | null;
+        body: string;
+        status: CommentStatus;
+        likes: number;
+        isLikedByCurrentUser: boolean;
+        editedAt: string | null;
+        createdAt: string;
+        updatedAt: string;
+        replyCount: number;
+    }, false>;
+    readonly updateComment: _btst_stack_plugins_api.Operation<zod.ZodObject<{
+        id: zod.ZodString;
+        data: zod.ZodObject<{
+            body: zod.ZodString;
+        }, zod_v4_core.$strip>;
+    }, zod_v4_core.$strip>, PermissionDescriptor<"comments:comment.edit", zod.ZodObject<{
+        commentId: zod.ZodString;
+        authorId: zod.ZodString;
+        status: zod.ZodEnum<{
+            pending: "pending";
+            approved: "approved";
+            spam: "spam";
+        }>;
+    }, zod_v4_core.$strip>>, {
+        id: string;
+        resourceId: string;
+        resourceType: string;
+        parentId: string | null;
+        authorId: string;
+        resolvedAuthorName: string;
+        resolvedAvatarUrl: string | null;
+        body: string;
+        status: CommentStatus;
+        likes: number;
+        isLikedByCurrentUser: boolean;
+        editedAt: string | null;
+        createdAt: string;
+        updatedAt: string;
+        replyCount: number;
+    }, false>;
+    readonly toggleLike: _btst_stack_plugins_api.Operation<zod.ZodObject<{
+        id: zod.ZodString;
+        authorId: zod.ZodOptional<zod.ZodString>;
+    }, zod_v4_core.$strip>, PermissionDescriptor<"comments:comment.react", zod.ZodObject<{
+        commentId: zod.ZodString;
+        status: zod.ZodEnum<{
+            pending: "pending";
+            approved: "approved";
+            spam: "spam";
+        }>;
+    }, zod_v4_core.$strip>>, {
+        likes: number;
+        isLiked: boolean;
+    }, false>;
+    readonly updateCommentStatus: _btst_stack_plugins_api.Operation<zod.ZodObject<{
+        id: zod.ZodString;
+        data: zod.ZodObject<{
+            status: zod.ZodEnum<{
+                pending: "pending";
+                approved: "approved";
+                spam: "spam";
+            }>;
+        }, zod_v4_core.$strip>;
+    }, zod_v4_core.$strip>, PermissionDescriptor<"comments:comment.moderate", zod.ZodObject<{
+        commentId: zod.ZodString;
+        resourceId: zod.ZodString;
+        resourceType: zod.ZodString;
+        currentStatus: zod.ZodEnum<{
+            pending: "pending";
+            approved: "approved";
+            spam: "spam";
+        }>;
+        nextStatus: zod.ZodEnum<{
+            pending: "pending";
+            approved: "approved";
+            spam: "spam";
+        }>;
+    }, zod_v4_core.$strip>>, {
+        id: string;
+        resourceId: string;
+        resourceType: string;
+        parentId: string | null;
+        authorId: string;
+        resolvedAuthorName: string;
+        resolvedAvatarUrl: string | null;
+        body: string;
+        status: CommentStatus;
+        likes: number;
+        isLikedByCurrentUser: boolean;
+        editedAt: string | null;
+        createdAt: string;
+        updatedAt: string;
+        replyCount: number;
+    }, false>;
+    readonly deleteComment: _btst_stack_plugins_api.Operation<zod.ZodObject<{
+        id: zod.ZodString;
+    }, zod_v4_core.$strip>, PermissionDescriptor<"comments:comment.delete", zod.ZodObject<{
+        commentId: zod.ZodString;
+        authorId: zod.ZodString;
+    }, zod_v4_core.$strip>>, {
+        readonly success: true;
+    }, false>;
+}, "comments">;
+type CommentsApiRouter = ReturnType<ReturnType<typeof commentsBackendPlugin>["routes"]>;
+
+/**
+ * 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;
+    sort: 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, sort, 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;
+        sort?: string;
+        limit?: number;
+    }) => readonly ["commentsThread", "list", CommentsThreadDiscriminator];
+};
+
+export { DeleteCommentOperationInputSchema as D, ToggleCommentLikeOperationInputSchema as T, UpdateCommentOperationInputSchema as U, CommentCountQuerySchema as d, CommentListParamsSchema as e, COMMENTS_QUERY_KEYS as f, CreateCommentOperationInputSchema as t, UpdateCommentStatusOperationInputSchema as u, commentsBackendPlugin as v };
+export type { CommentsListDiscriminator as C, SerializedCommentListResult as S, CommentCountDiscriminator as a, CommentsThreadDiscriminator as b, CommentsApiRouter as c, CommentsBackendHooks as g, CommentsBackendOptions as h, CommentsCountOperationContext as i, CommentsCreateOperationContext as j, CommentsCreateResultContext as k, CommentsDeleteOperationContext as l, CommentsDeleteResultContext as m, CommentsEditOperationContext as n, CommentsEditResultContext as o, CommentsListOperationContext as p, CommentsModerateOperationContext as q, CommentsModerateResultContext as r, CommentsReactOperationContext as s };