@btst/stack 2.6.2 → 2.8.0

package/dist/shared/{stack.j75TpKh2.d.ts → stack.BvCR4-9H.d.ts}

@@ -1,18 +1,18 @@
 import * as _btst_stack_plugins_api from '@btst/stack/plugins/api';
-import * as better_call from 'better-call';
-import { Adapter } from '@btst/db';
+import { DBAdapter } from '@btst/db';
 import { B as BoardWithColumns, P as Priority, T as Task, d as Board, e as Column, C as ColumnWithTasks } from './stack.DJaKVY7v.js';
 import { z } from 'zod';
+import * as better_call from 'better-call';
 import { QueryClient } from '@tanstack/react-query';
 
 declare const createBoardSchema: z.ZodObject<{
     description: z.ZodOptional<z.ZodString>;
     name: z.ZodString;
+    createdAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+    updatedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
     slug: z.ZodOptional<z.ZodString>;
     ownerId: z.ZodOptional<z.ZodString>;
     organizationId: z.ZodOptional<z.ZodString>;
-    createdAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
-    updatedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
 }, z.core.$strip>;
 declare const updateBoardSchema: z.ZodObject<{
     createdAt: z.ZodOptional<z.ZodOptional<z.ZodCoercedDate<unknown>>>;
@@ -28,8 +28,8 @@ declare const createColumnSchema: z.ZodObject<{
     title: z.ZodString;
     createdAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
     updatedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
-    order: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     boardId: z.ZodString;
+    order: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
 }, z.core.$strip>;
 declare const updateColumnSchema: z.ZodObject<{
     createdAt: z.ZodOptional<z.ZodOptional<z.ZodCoercedDate<unknown>>>;
@@ -98,7 +98,7 @@ interface BoardListResult {
  * @param adapter - The database adapter
  * @param params - Optional filter/pagination parameters (same shape as the list API query)
  */
-declare function getAllBoards(adapter: Adapter, params?: z.infer<typeof BoardListQuerySchema>): Promise<BoardListResult>;
+declare function getAllBoards(adapter: DBAdapter, params?: z.infer<typeof BoardListQuerySchema>): Promise<BoardListResult>;
 /**
  * Retrieve a single board by its ID, with all columns and tasks.
  * Returns null if the board is not found.
@@ -107,7 +107,7 @@ declare function getAllBoards(adapter: Adapter, params?: z.infer<typeof BoardLis
  * @param adapter - The database adapter
  * @param id - The board ID
  */
-declare function getBoardById(adapter: Adapter, id: string): Promise<BoardWithColumns | null>;
+declare function getBoardById(adapter: DBAdapter, id: string): Promise<BoardWithColumns | null>;
 
 /**
  * Input for creating a new Kanban task.
@@ -130,7 +130,7 @@ interface CreateKanbanTaskInput {
  * @param adapter - The database adapter
  * @param input - Task creation input
  */
-declare function createKanbanTask(adapter: Adapter, input: CreateKanbanTaskInput): Promise<Task>;
+declare function createKanbanTask(adapter: DBAdapter, input: CreateKanbanTaskInput): Promise<Task>;
 /**
  * Find a board by slug, or create it with the given name and custom column titles.
  *
@@ -148,7 +148,7 @@ declare function createKanbanTask(adapter: Adapter, input: CreateKanbanTaskInput
  * @param name - Display name for the board (used only on creation)
  * @param columnTitles - Ordered list of column names to create (used only on creation)
  */
-declare function findOrCreateKanbanBoard(adapter: Adapter, slug: string, name: string, columnTitles: string[]): Promise<Board>;
+declare function findOrCreateKanbanBoard(adapter: DBAdapter, slug: string, name: string, columnTitles: string[]): Promise<Board>;
 /**
  * Retrieve all columns for a given board, sorted by order.
  * Co-located with mutations because it is primarily used alongside
@@ -159,7 +159,7 @@ declare function findOrCreateKanbanBoard(adapter: Adapter, slug: string, name: s
  * @param adapter - The database adapter
  * @param boardId - The board ID
  */
-declare function getKanbanColumnsByBoardId(adapter: Adapter, boardId: string): Promise<Column[]>;
+declare function getKanbanColumnsByBoardId(adapter: DBAdapter, boardId: string): Promise<Column[]>;
 
 /**
  * Route keys for the Kanban plugin — matches the keys returned by
@@ -306,30 +306,45 @@ interface KanbanBackendHooks {
  * @param hooks - Optional configuration hooks for customizing plugin behavior
  */
 declare const kanbanBackendPlugin: (hooks?: KanbanBackendHooks) => _btst_stack_plugins_api.BackendPlugin<{
-    readonly listBoards: better_call.StrictEndpoint<"/boards", {
+    readonly listBoards: better_call.StrictEndpoint<"/boards", {} & {
         method: "GET";
-        query: z.ZodObject<{
-            slug: z.ZodOptional<z.ZodString>;
-            ownerId: z.ZodOptional<z.ZodString>;
-            organizationId: z.ZodOptional<z.ZodString>;
-            offset: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
-            limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
-        }, z.core.$strip>;
+    } & {
+        query: better_call.StandardSchemaV1<{
+            slug?: string | undefined;
+            ownerId?: string | undefined;
+            organizationId?: string | undefined;
+            offset?: unknown;
+            limit?: unknown;
+        }, {
+            slug?: string | undefined;
+            ownerId?: string | undefined;
+            organizationId?: string | undefined;
+            offset?: unknown;
+            limit?: unknown;
+        }>;
     }, BoardListResult>;
-    readonly getBoard: better_call.StrictEndpoint<"/boards/:id", {
+    readonly getBoard: better_call.StrictEndpoint<"/boards/:id", {} & {
         method: "GET";
     }, BoardWithColumns>;
-    readonly createBoard: better_call.StrictEndpoint<"/boards", {
+    readonly createBoard: better_call.StrictEndpoint<"/boards", {} & {
         method: "POST";
-        body: z.ZodObject<{
-            description: z.ZodOptional<z.ZodString>;
-            name: z.ZodString;
-            slug: z.ZodOptional<z.ZodString>;
-            ownerId: z.ZodOptional<z.ZodString>;
-            organizationId: z.ZodOptional<z.ZodString>;
-            createdAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
-            updatedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
-        }, z.core.$strip>;
+        body: better_call.StandardSchemaV1<{
+            name: string;
+            description?: string | undefined;
+            createdAt?: unknown;
+            updatedAt?: unknown;
+            slug?: string | undefined;
+            ownerId?: string | undefined;
+            organizationId?: string | undefined;
+        }, {
+            name: string;
+            description?: string | undefined;
+            createdAt?: unknown;
+            updatedAt?: unknown;
+            slug?: string | undefined;
+            ownerId?: string | undefined;
+            organizationId?: string | undefined;
+        }>;
     }, {
         columns: ColumnWithTasks[];
         id: string;
@@ -341,116 +356,161 @@ declare const kanbanBackendPlugin: (hooks?: KanbanBackendHooks) => _btst_stack_p
         createdAt: Date;
         updatedAt: Date;
     }>;
-    readonly updateBoard: better_call.StrictEndpoint<"/boards/:id", {
+    readonly updateBoard: better_call.StrictEndpoint<"/boards/:id", {} & {
         method: "PUT";
-        body: z.ZodObject<{
-            description: z.ZodOptional<z.ZodOptional<z.ZodString>>;
-            name: z.ZodOptional<z.ZodString>;
-            slug: z.ZodOptional<z.ZodString>;
-            ownerId: z.ZodOptional<z.ZodOptional<z.ZodString>>;
-            organizationId: z.ZodOptional<z.ZodOptional<z.ZodString>>;
-            createdAt: z.ZodOptional<z.ZodOptional<z.ZodCoercedDate<unknown>>>;
-            updatedAt: z.ZodOptional<z.ZodOptional<z.ZodCoercedDate<unknown>>>;
-        }, z.core.$strip>;
+        body: better_call.StandardSchemaV1<{
+            description?: string | undefined;
+            name?: string | undefined;
+            createdAt?: unknown;
+            updatedAt?: unknown;
+            slug?: string | undefined;
+            ownerId?: string | undefined;
+            organizationId?: string | undefined;
+        }, {
+            description?: string | undefined;
+            name?: string | undefined;
+            createdAt?: unknown;
+            updatedAt?: unknown;
+            slug?: string | undefined;
+            ownerId?: string | undefined;
+            organizationId?: string | undefined;
+        }>;
     }, Board>;
-    readonly deleteBoard: better_call.StrictEndpoint<"/boards/:id", {
+    readonly deleteBoard: better_call.StrictEndpoint<"/boards/:id", {} & {
         method: "DELETE";
+        body: better_call.StandardSchemaV1<unknown, unknown>;
     }, {
         success: boolean;
     }>;
-    readonly createColumn: better_call.StrictEndpoint<"/columns", {
+    readonly createColumn: better_call.StrictEndpoint<"/columns", {} & {
         method: "POST";
-        body: z.ZodObject<{
-            title: z.ZodString;
-            createdAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
-            updatedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
-            order: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-            boardId: z.ZodString;
-        }, z.core.$strip>;
+        body: better_call.StandardSchemaV1<{
+            title: string;
+            boardId: string;
+            createdAt?: unknown;
+            updatedAt?: unknown;
+            order?: number | undefined;
+        }, {
+            title: string;
+            boardId: string;
+            createdAt?: unknown;
+            updatedAt?: unknown;
+            order?: number | undefined;
+        }>;
     }, Column>;
-    readonly updateColumn: better_call.StrictEndpoint<"/columns/:id", {
+    readonly updateColumn: better_call.StrictEndpoint<"/columns/:id", {} & {
         method: "PUT";
-        body: z.ZodObject<{
-            title: z.ZodOptional<z.ZodString>;
-            createdAt: z.ZodOptional<z.ZodOptional<z.ZodCoercedDate<unknown>>>;
-            updatedAt: z.ZodOptional<z.ZodOptional<z.ZodCoercedDate<unknown>>>;
-            order: z.ZodOptional<z.ZodDefault<z.ZodOptional<z.ZodNumber>>>;
-            boardId: z.ZodOptional<z.ZodString>;
-        }, z.core.$strip>;
+        body: better_call.StandardSchemaV1<{
+            title?: string | undefined;
+            createdAt?: unknown;
+            updatedAt?: unknown;
+            boardId?: string | undefined;
+            order?: number | undefined;
+        }, {
+            title?: string | undefined;
+            createdAt?: unknown;
+            updatedAt?: unknown;
+            boardId?: string | undefined;
+            order?: number | undefined;
+        }>;
     }, Column>;
-    readonly deleteColumn: better_call.StrictEndpoint<"/columns/:id", {
+    readonly deleteColumn: better_call.StrictEndpoint<"/columns/:id", {} & {
         method: "DELETE";
+        body: better_call.StandardSchemaV1<unknown, unknown>;
     }, {
         success: boolean;
     }>;
-    readonly reorderColumns: better_call.StrictEndpoint<"/columns/reorder", {
+    readonly reorderColumns: better_call.StrictEndpoint<"/columns/reorder", {} & {
         method: "POST";
-        body: z.ZodObject<{
-            boardId: z.ZodString;
-            columnIds: z.ZodArray<z.ZodString>;
-        }, z.core.$strip>;
+        body: better_call.StandardSchemaV1<{
+            boardId: string;
+            columnIds: string[];
+        }, {
+            boardId: string;
+            columnIds: string[];
+        }>;
     }, {
         success: boolean;
     }>;
-    readonly createTask: better_call.StrictEndpoint<"/tasks", {
+    readonly createTask: better_call.StrictEndpoint<"/tasks", {} & {
         method: "POST";
-        body: z.ZodObject<{
-            title: z.ZodString;
-            description: z.ZodOptional<z.ZodString>;
-            createdAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
-            updatedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
-            order: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
-            completedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
-            priority: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
-                LOW: "LOW";
-                MEDIUM: "MEDIUM";
-                HIGH: "HIGH";
-                URGENT: "URGENT";
-            }>>>;
-            columnId: z.ZodString;
-            assigneeId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
-            isArchived: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
-        }, z.core.$strip>;
+        body: better_call.StandardSchemaV1<{
+            title: string;
+            columnId: string;
+            description?: string | undefined;
+            createdAt?: unknown;
+            updatedAt?: unknown;
+            order?: number | undefined;
+            completedAt?: unknown;
+            priority?: "LOW" | "MEDIUM" | "HIGH" | "URGENT" | undefined;
+            assigneeId?: string | null | undefined;
+            isArchived?: boolean | undefined;
+        }, {
+            title: string;
+            columnId: string;
+            description?: string | undefined;
+            createdAt?: unknown;
+            updatedAt?: unknown;
+            order?: number | undefined;
+            completedAt?: unknown;
+            priority?: "LOW" | "MEDIUM" | "HIGH" | "URGENT" | undefined;
+            assigneeId?: string | null | undefined;
+            isArchived?: boolean | undefined;
+        }>;
     }, Task>;
-    readonly updateTask: better_call.StrictEndpoint<"/tasks/:id", {
+    readonly updateTask: better_call.StrictEndpoint<"/tasks/:id", {} & {
         method: "PUT";
-        body: z.ZodObject<{
-            title: z.ZodOptional<z.ZodString>;
-            description: z.ZodOptional<z.ZodOptional<z.ZodString>>;
-            createdAt: z.ZodOptional<z.ZodOptional<z.ZodCoercedDate<unknown>>>;
-            updatedAt: z.ZodOptional<z.ZodOptional<z.ZodCoercedDate<unknown>>>;
-            order: z.ZodOptional<z.ZodDefault<z.ZodOptional<z.ZodNumber>>>;
-            completedAt: z.ZodOptional<z.ZodOptional<z.ZodCoercedDate<unknown>>>;
-            priority: z.ZodOptional<z.ZodDefault<z.ZodOptional<z.ZodEnum<{
-                LOW: "LOW";
-                MEDIUM: "MEDIUM";
-                HIGH: "HIGH";
-                URGENT: "URGENT";
-            }>>>>;
-            columnId: z.ZodOptional<z.ZodString>;
-            assigneeId: z.ZodOptional<z.ZodNullable<z.ZodOptional<z.ZodString>>>;
-            isArchived: z.ZodOptional<z.ZodDefault<z.ZodOptional<z.ZodBoolean>>>;
-        }, z.core.$strip>;
+        body: better_call.StandardSchemaV1<{
+            title?: string | undefined;
+            description?: string | undefined;
+            createdAt?: unknown;
+            updatedAt?: unknown;
+            order?: number | undefined;
+            completedAt?: unknown;
+            priority?: "LOW" | "MEDIUM" | "HIGH" | "URGENT" | undefined;
+            columnId?: string | undefined;
+            assigneeId?: string | null | undefined;
+            isArchived?: boolean | undefined;
+        }, {
+            title?: string | undefined;
+            description?: string | undefined;
+            createdAt?: unknown;
+            updatedAt?: unknown;
+            order?: number | undefined;
+            completedAt?: unknown;
+            priority?: "LOW" | "MEDIUM" | "HIGH" | "URGENT" | undefined;
+            columnId?: string | undefined;
+            assigneeId?: string | null | undefined;
+            isArchived?: boolean | undefined;
+        }>;
     }, Task>;
-    readonly deleteTask: better_call.StrictEndpoint<"/tasks/:id", {
+    readonly deleteTask: better_call.StrictEndpoint<"/tasks/:id", {} & {
         method: "DELETE";
+        body: better_call.StandardSchemaV1<unknown, unknown>;
     }, {
         success: boolean;
     }>;
-    readonly moveTask: better_call.StrictEndpoint<"/tasks/move", {
+    readonly moveTask: better_call.StrictEndpoint<"/tasks/move", {} & {
         method: "POST";
-        body: z.ZodObject<{
-            taskId: z.ZodString;
-            targetColumnId: z.ZodString;
-            targetOrder: z.ZodNumber;
-        }, z.core.$strip>;
+        body: better_call.StandardSchemaV1<{
+            taskId: string;
+            targetColumnId: string;
+            targetOrder: number;
+        }, {
+            taskId: string;
+            targetColumnId: string;
+            targetOrder: number;
+        }>;
     }, Task>;
-    readonly reorderTasks: better_call.StrictEndpoint<"/tasks/reorder", {
+    readonly reorderTasks: better_call.StrictEndpoint<"/tasks/reorder", {} & {
         method: "POST";
-        body: z.ZodObject<{
-            columnId: z.ZodString;
-            taskIds: z.ZodArray<z.ZodString>;
-        }, z.core.$strip>;
+        body: better_call.StandardSchemaV1<{
+            columnId: string;
+            taskIds: string[];
+        }, {
+            columnId: string;
+            taskIds: string[];
+        }>;
     }, {
         success: boolean;
     }>;

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