@btst/stack 3.0.0-rc.2 → 3.0.0-rc.4

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

@@ -1,10 +1,122 @@
-export { B as BoardListResult, C as CreateKanbanTaskInput, i as KANBAN_QUERY_KEYS, b as KanbanApiContext, K as KanbanApiRouter, c as KanbanBackendHooks, a as KanbanRouteKey, e as createKanbanTask, f as findOrCreateKanbanBoard, g as getAllBoards, d as getBoardById, h as getKanbanColumnsByBoardId, k as kanbanBackendPlugin } from '../../../shared/stack.CuI_-z-_.cjs';
-import { B as BoardWithColumns, S as SerializedBoardWithColumns, C as ColumnWithTasks, a as SerializedColumn, T as Task, b as SerializedTask } from '../../../shared/stack.DJaKVY7v.cjs';
+export { g as KANBAN_QUERY_KEYS, K as KanbanApiRouter, a as KanbanBackendOptions, e as KanbanBoardListResult, c as KanbanOperationError, f as KanbanOperations, b as KanbanRouteKey, d as createKanbanOperations, k as kanbanBackendPlugin } from '../../../shared/stack.Mak7pzIV.cjs';
+export { kanbanPermissions } from '../permissions.cjs';
+import { B as BoardListQuerySchema, i as BoardWithColumns, j as BoardWithColumnsOnly, P as Priority, T as Task, k as Board, C as Column, a as SerializedBoardWithColumns, l as ColumnWithTasks, d as SerializedColumn, e as SerializedTask } from '../../../shared/stack.CvlC5kqe.cjs';
+export { u as BoardCreateOperationContext, v as BoardCreateOperationResultContext, y as BoardDeleteOperationContext, z as BoardDeleteOperationResultContext, p as BoardListOperationContext, q as BoardListOperationResultContext, s as BoardReadOperationContext, t as BoardReadOperationResultContext, w as BoardUpdateOperationContext, x as BoardUpdateOperationResultContext, A as ColumnCreateOperationContext, D as ColumnCreateOperationResultContext, G as ColumnDeleteOperationContext, H as ColumnDeleteOperationResultContext, I as ColumnReorderOperationContext, J as ColumnReorderOperationResultContext, E as ColumnUpdateOperationContext, F as ColumnUpdateOperationResultContext, n as KanbanApiContext, o as KanbanApiResultContext, K as KanbanBackendHooks, S as SerializedBoardSummary, L as TaskCreateOperationContext, M as TaskCreateOperationResultContext, Q as TaskDeleteOperationContext, R as TaskDeleteOperationResultContext, U as TaskMoveOperationContext, V as TaskMoveOperationResultContext, W as TaskReorderOperationContext, X as TaskReorderOperationResultContext, N as TaskUpdateOperationContext, O as TaskUpdateOperationResultContext } from '../../../shared/stack.CvlC5kqe.cjs';
+import { DBAdapter } from '@btst/db';
+import { z } from 'zod';
 import '@btst/stack/plugins/api';
-import '@btst/db';
-import 'zod';
+import 'zod/v4/core';
 import 'better-call';
 import '@tanstack/react-query';
+import '@btst/stack/authorization';
+import '@btst/stack/context';
+
+/**
+ * Removed Kanban lifecycle names and their canonical v3 replacements.
+ *
+ * Reorder and move operations continue to use the existing update lifecycle;
+ * this migration does not invent operation-specific phases.
+ */
+declare const KANBAN_LIFECYCLE_HOOK_MIGRATIONS: Readonly<{
+    readonly onBeforeReadBoard: "onBeforeGetBoard";
+    readonly onBoardsRead: "onAfterListBoards";
+    readonly onBoardRead: "onAfterGetBoard";
+    readonly onBoardCreated: "onAfterCreateBoard";
+    readonly onBoardUpdated: "onAfterUpdateBoard";
+    readonly onBoardDeleted: "onAfterDeleteBoard";
+    readonly onListBoardsError: "onErrorListBoards";
+    readonly onReadBoardError: "onErrorGetBoard";
+    readonly onCreateBoardError: "onErrorCreateBoard";
+    readonly onUpdateBoardError: "onErrorUpdateBoard";
+    readonly onDeleteBoardError: "onErrorDeleteBoard";
+    readonly onColumnCreated: "onAfterCreateColumn";
+    readonly onColumnUpdated: "onAfterUpdateColumn";
+    readonly onColumnDeleted: "onAfterDeleteColumn";
+    readonly onTaskCreated: "onAfterCreateTask";
+    readonly onTaskUpdated: "onAfterUpdateTask";
+    readonly onTaskDeleted: "onAfterDeleteTask";
+}>;
+
+/**
+ * Paginated result returned by {@link getAllBoards}.
+ */
+interface BoardListResult<TBoard = BoardWithColumns> {
+    items: TBoard[];
+    total: number;
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Retrieve all boards matching optional filter criteria, with columns and tasks.
+ * Pure DB function - no hooks, no HTTP context. Safe for SSG and server-side use.
+ *
+ * @param adapter - The database adapter
+ * @param params - Optional filter/pagination parameters (same shape as the list API query)
+ */
+declare function getAllBoards(adapter: DBAdapter, params?: z.infer<typeof BoardListQuerySchema>): Promise<BoardListResult>;
+/** Retrieve collection-safe board and column metadata without loading tasks. */
+declare function getBoardSummaries(adapter: DBAdapter, params?: z.infer<typeof BoardListQuerySchema>): Promise<BoardListResult<BoardWithColumnsOnly>>;
+/**
+ * Retrieve a single board by its ID, with all columns and tasks.
+ * Returns null if the board is not found.
+ * Pure DB function - no hooks, no HTTP context. Safe for SSG and server-side use.
+ *
+ * @param adapter - The database adapter
+ * @param id - The board ID
+ */
+declare function getBoardById(adapter: DBAdapter, id: string): Promise<BoardWithColumns | null>;
+
+/**
+ * Input for creating a new Kanban task.
+ */
+interface CreateKanbanTaskInput {
+    title: string;
+    columnId: string;
+    description?: string;
+    priority?: Priority;
+    assigneeId?: string;
+}
+/**
+ * Create a new task in a Kanban column.
+ * Computes the next order value from existing tasks in the column.
+ *
+ * @remarks **Security:** Operation authorization and lifecycle hooks are not called.
+ * The caller is responsible for any access-control checks before invoking this
+ * function.
+ *
+ * @param adapter - The database adapter
+ * @param input - Task creation input
+ */
+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.
+ *
+ * Concurrency-safe at two levels:
+ * - **Same process**: concurrent calls with the same slug share a single in-flight
+ *   Promise (via `_pendingBoardCreations`), so only one DB write is attempted.
+ * - **Cross-instance**: the DB `unique` constraint on `slug` causes the losing
+ *   write to throw; the catch block re-fetches and returns the winner's board.
+ *
+ * @remarks **Security:** Operation authorization and lifecycle hooks are not called. The caller is
+ * responsible for any access-control checks before invoking this function.
+ *
+ * @param adapter - The database adapter
+ * @param slug - Unique URL-safe slug for the board
+ * @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: 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
+ * {@link createKanbanTask} to resolve column IDs before task creation.
+ *
+ * @remarks **Security:** Operation authorization and lifecycle hooks are not called.
+ *
+ * @param adapter - The database adapter
+ * @param boardId - The board ID
+ */
+declare function getKanbanColumnsByBoardId(adapter: DBAdapter, boardId: string): Promise<Column[]>;
 
 /**
  * Serialize a Task for SSR/SSG use (convert dates to strings).
@@ -21,5 +133,25 @@ declare function serializeColumn(col: ColumnWithTasks): SerializedColumn;
  * Pure function — no DB access, no hooks.
  */
 declare function serializeBoard(board: BoardWithColumns): SerializedBoardWithColumns;
+/** Serialize a collection-safe board summary without task rows. */
+declare function serializeBoardSummary(board: BoardWithColumnsOnly): {
+    id: string;
+    name: string;
+    slug: string;
+    description: string | undefined;
+    ownerId: string | undefined;
+    organizationId: string | undefined;
+    createdAt: string;
+    updatedAt: string;
+    columns: {
+        createdAt: string;
+        updatedAt: string;
+        id: string;
+        title: string;
+        order: number;
+        boardId: string;
+    }[];
+};
 
-export { serializeBoard, serializeColumn, serializeTask };
+export { KANBAN_LIFECYCLE_HOOK_MIGRATIONS, createKanbanTask, findOrCreateKanbanBoard, getAllBoards, getBoardById, getBoardSummaries, getKanbanColumnsByBoardId, serializeBoard, serializeBoardSummary, serializeColumn, serializeTask };
+export type { BoardListResult, CreateKanbanTaskInput };

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

@@ -1,10 +1,122 @@
-export { B as BoardListResult, C as CreateKanbanTaskInput, i as KANBAN_QUERY_KEYS, b as KanbanApiContext, K as KanbanApiRouter, c as KanbanBackendHooks, a as KanbanRouteKey, e as createKanbanTask, f as findOrCreateKanbanBoard, g as getAllBoards, d as getBoardById, h as getKanbanColumnsByBoardId, k as kanbanBackendPlugin } from '../../../shared/stack.D2RVkQD8.mjs';
-import { B as BoardWithColumns, S as SerializedBoardWithColumns, C as ColumnWithTasks, a as SerializedColumn, T as Task, b as SerializedTask } from '../../../shared/stack.DJaKVY7v.mjs';
+export { g as KANBAN_QUERY_KEYS, K as KanbanApiRouter, a as KanbanBackendOptions, e as KanbanBoardListResult, c as KanbanOperationError, f as KanbanOperations, b as KanbanRouteKey, d as createKanbanOperations, k as kanbanBackendPlugin } from '../../../shared/stack.B1UrNoVl.mjs';
+export { kanbanPermissions } from '../permissions.mjs';
+import { B as BoardListQuerySchema, i as BoardWithColumns, j as BoardWithColumnsOnly, P as Priority, T as Task, k as Board, C as Column, a as SerializedBoardWithColumns, l as ColumnWithTasks, d as SerializedColumn, e as SerializedTask } from '../../../shared/stack.DlCycSM-.mjs';
+export { u as BoardCreateOperationContext, v as BoardCreateOperationResultContext, y as BoardDeleteOperationContext, z as BoardDeleteOperationResultContext, p as BoardListOperationContext, q as BoardListOperationResultContext, s as BoardReadOperationContext, t as BoardReadOperationResultContext, w as BoardUpdateOperationContext, x as BoardUpdateOperationResultContext, A as ColumnCreateOperationContext, D as ColumnCreateOperationResultContext, G as ColumnDeleteOperationContext, H as ColumnDeleteOperationResultContext, I as ColumnReorderOperationContext, J as ColumnReorderOperationResultContext, E as ColumnUpdateOperationContext, F as ColumnUpdateOperationResultContext, n as KanbanApiContext, o as KanbanApiResultContext, K as KanbanBackendHooks, S as SerializedBoardSummary, L as TaskCreateOperationContext, M as TaskCreateOperationResultContext, Q as TaskDeleteOperationContext, R as TaskDeleteOperationResultContext, U as TaskMoveOperationContext, V as TaskMoveOperationResultContext, W as TaskReorderOperationContext, X as TaskReorderOperationResultContext, N as TaskUpdateOperationContext, O as TaskUpdateOperationResultContext } from '../../../shared/stack.DlCycSM-.mjs';
+import { DBAdapter } from '@btst/db';
+import { z } from 'zod';
 import '@btst/stack/plugins/api';
-import '@btst/db';
-import 'zod';
+import 'zod/v4/core';
 import 'better-call';
 import '@tanstack/react-query';
+import '@btst/stack/authorization';
+import '@btst/stack/context';
+
+/**
+ * Removed Kanban lifecycle names and their canonical v3 replacements.
+ *
+ * Reorder and move operations continue to use the existing update lifecycle;
+ * this migration does not invent operation-specific phases.
+ */
+declare const KANBAN_LIFECYCLE_HOOK_MIGRATIONS: Readonly<{
+    readonly onBeforeReadBoard: "onBeforeGetBoard";
+    readonly onBoardsRead: "onAfterListBoards";
+    readonly onBoardRead: "onAfterGetBoard";
+    readonly onBoardCreated: "onAfterCreateBoard";
+    readonly onBoardUpdated: "onAfterUpdateBoard";
+    readonly onBoardDeleted: "onAfterDeleteBoard";
+    readonly onListBoardsError: "onErrorListBoards";
+    readonly onReadBoardError: "onErrorGetBoard";
+    readonly onCreateBoardError: "onErrorCreateBoard";
+    readonly onUpdateBoardError: "onErrorUpdateBoard";
+    readonly onDeleteBoardError: "onErrorDeleteBoard";
+    readonly onColumnCreated: "onAfterCreateColumn";
+    readonly onColumnUpdated: "onAfterUpdateColumn";
+    readonly onColumnDeleted: "onAfterDeleteColumn";
+    readonly onTaskCreated: "onAfterCreateTask";
+    readonly onTaskUpdated: "onAfterUpdateTask";
+    readonly onTaskDeleted: "onAfterDeleteTask";
+}>;
+
+/**
+ * Paginated result returned by {@link getAllBoards}.
+ */
+interface BoardListResult<TBoard = BoardWithColumns> {
+    items: TBoard[];
+    total: number;
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Retrieve all boards matching optional filter criteria, with columns and tasks.
+ * Pure DB function - no hooks, no HTTP context. Safe for SSG and server-side use.
+ *
+ * @param adapter - The database adapter
+ * @param params - Optional filter/pagination parameters (same shape as the list API query)
+ */
+declare function getAllBoards(adapter: DBAdapter, params?: z.infer<typeof BoardListQuerySchema>): Promise<BoardListResult>;
+/** Retrieve collection-safe board and column metadata without loading tasks. */
+declare function getBoardSummaries(adapter: DBAdapter, params?: z.infer<typeof BoardListQuerySchema>): Promise<BoardListResult<BoardWithColumnsOnly>>;
+/**
+ * Retrieve a single board by its ID, with all columns and tasks.
+ * Returns null if the board is not found.
+ * Pure DB function - no hooks, no HTTP context. Safe for SSG and server-side use.
+ *
+ * @param adapter - The database adapter
+ * @param id - The board ID
+ */
+declare function getBoardById(adapter: DBAdapter, id: string): Promise<BoardWithColumns | null>;
+
+/**
+ * Input for creating a new Kanban task.
+ */
+interface CreateKanbanTaskInput {
+    title: string;
+    columnId: string;
+    description?: string;
+    priority?: Priority;
+    assigneeId?: string;
+}
+/**
+ * Create a new task in a Kanban column.
+ * Computes the next order value from existing tasks in the column.
+ *
+ * @remarks **Security:** Operation authorization and lifecycle hooks are not called.
+ * The caller is responsible for any access-control checks before invoking this
+ * function.
+ *
+ * @param adapter - The database adapter
+ * @param input - Task creation input
+ */
+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.
+ *
+ * Concurrency-safe at two levels:
+ * - **Same process**: concurrent calls with the same slug share a single in-flight
+ *   Promise (via `_pendingBoardCreations`), so only one DB write is attempted.
+ * - **Cross-instance**: the DB `unique` constraint on `slug` causes the losing
+ *   write to throw; the catch block re-fetches and returns the winner's board.
+ *
+ * @remarks **Security:** Operation authorization and lifecycle hooks are not called. The caller is
+ * responsible for any access-control checks before invoking this function.
+ *
+ * @param adapter - The database adapter
+ * @param slug - Unique URL-safe slug for the board
+ * @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: 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
+ * {@link createKanbanTask} to resolve column IDs before task creation.
+ *
+ * @remarks **Security:** Operation authorization and lifecycle hooks are not called.
+ *
+ * @param adapter - The database adapter
+ * @param boardId - The board ID
+ */
+declare function getKanbanColumnsByBoardId(adapter: DBAdapter, boardId: string): Promise<Column[]>;
 
 /**
  * Serialize a Task for SSR/SSG use (convert dates to strings).
@@ -21,5 +133,25 @@ declare function serializeColumn(col: ColumnWithTasks): SerializedColumn;
  * Pure function — no DB access, no hooks.
  */
 declare function serializeBoard(board: BoardWithColumns): SerializedBoardWithColumns;
+/** Serialize a collection-safe board summary without task rows. */
+declare function serializeBoardSummary(board: BoardWithColumnsOnly): {
+    id: string;
+    name: string;
+    slug: string;
+    description: string | undefined;
+    ownerId: string | undefined;
+    organizationId: string | undefined;
+    createdAt: string;
+    updatedAt: string;
+    columns: {
+        createdAt: string;
+        updatedAt: string;
+        id: string;
+        title: string;
+        order: number;
+        boardId: string;
+    }[];
+};
 
-export { serializeBoard, serializeColumn, serializeTask };
+export { KANBAN_LIFECYCLE_HOOK_MIGRATIONS, createKanbanTask, findOrCreateKanbanBoard, getAllBoards, getBoardById, getBoardSummaries, getKanbanColumnsByBoardId, serializeBoard, serializeBoardSummary, serializeColumn, serializeTask };
+export type { BoardListResult, CreateKanbanTaskInput };

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

@@ -1,10 +1,122 @@
-export { B as BoardListResult, C as CreateKanbanTaskInput, i as KANBAN_QUERY_KEYS, b as KanbanApiContext, K as KanbanApiRouter, c as KanbanBackendHooks, a as KanbanRouteKey, e as createKanbanTask, f as findOrCreateKanbanBoard, g as getAllBoards, d as getBoardById, h as getKanbanColumnsByBoardId, k as kanbanBackendPlugin } from '../../../shared/stack.DXrOtuek.js';
-import { B as BoardWithColumns, S as SerializedBoardWithColumns, C as ColumnWithTasks, a as SerializedColumn, T as Task, b as SerializedTask } from '../../../shared/stack.DJaKVY7v.js';
+export { g as KANBAN_QUERY_KEYS, K as KanbanApiRouter, a as KanbanBackendOptions, e as KanbanBoardListResult, c as KanbanOperationError, f as KanbanOperations, b as KanbanRouteKey, d as createKanbanOperations, k as kanbanBackendPlugin } from '../../../shared/stack.0y6iTP03.js';
+export { kanbanPermissions } from '../permissions.js';
+import { B as BoardListQuerySchema, i as BoardWithColumns, j as BoardWithColumnsOnly, P as Priority, T as Task, k as Board, C as Column, a as SerializedBoardWithColumns, l as ColumnWithTasks, d as SerializedColumn, e as SerializedTask } from '../../../shared/stack.CpE1mS3p.js';
+export { u as BoardCreateOperationContext, v as BoardCreateOperationResultContext, y as BoardDeleteOperationContext, z as BoardDeleteOperationResultContext, p as BoardListOperationContext, q as BoardListOperationResultContext, s as BoardReadOperationContext, t as BoardReadOperationResultContext, w as BoardUpdateOperationContext, x as BoardUpdateOperationResultContext, A as ColumnCreateOperationContext, D as ColumnCreateOperationResultContext, G as ColumnDeleteOperationContext, H as ColumnDeleteOperationResultContext, I as ColumnReorderOperationContext, J as ColumnReorderOperationResultContext, E as ColumnUpdateOperationContext, F as ColumnUpdateOperationResultContext, n as KanbanApiContext, o as KanbanApiResultContext, K as KanbanBackendHooks, S as SerializedBoardSummary, L as TaskCreateOperationContext, M as TaskCreateOperationResultContext, Q as TaskDeleteOperationContext, R as TaskDeleteOperationResultContext, U as TaskMoveOperationContext, V as TaskMoveOperationResultContext, W as TaskReorderOperationContext, X as TaskReorderOperationResultContext, N as TaskUpdateOperationContext, O as TaskUpdateOperationResultContext } from '../../../shared/stack.CpE1mS3p.js';
+import { DBAdapter } from '@btst/db';
+import { z } from 'zod';
 import '@btst/stack/plugins/api';
-import '@btst/db';
-import 'zod';
+import 'zod/v4/core';
 import 'better-call';
 import '@tanstack/react-query';
+import '@btst/stack/authorization';
+import '@btst/stack/context';
+
+/**
+ * Removed Kanban lifecycle names and their canonical v3 replacements.
+ *
+ * Reorder and move operations continue to use the existing update lifecycle;
+ * this migration does not invent operation-specific phases.
+ */
+declare const KANBAN_LIFECYCLE_HOOK_MIGRATIONS: Readonly<{
+    readonly onBeforeReadBoard: "onBeforeGetBoard";
+    readonly onBoardsRead: "onAfterListBoards";
+    readonly onBoardRead: "onAfterGetBoard";
+    readonly onBoardCreated: "onAfterCreateBoard";
+    readonly onBoardUpdated: "onAfterUpdateBoard";
+    readonly onBoardDeleted: "onAfterDeleteBoard";
+    readonly onListBoardsError: "onErrorListBoards";
+    readonly onReadBoardError: "onErrorGetBoard";
+    readonly onCreateBoardError: "onErrorCreateBoard";
+    readonly onUpdateBoardError: "onErrorUpdateBoard";
+    readonly onDeleteBoardError: "onErrorDeleteBoard";
+    readonly onColumnCreated: "onAfterCreateColumn";
+    readonly onColumnUpdated: "onAfterUpdateColumn";
+    readonly onColumnDeleted: "onAfterDeleteColumn";
+    readonly onTaskCreated: "onAfterCreateTask";
+    readonly onTaskUpdated: "onAfterUpdateTask";
+    readonly onTaskDeleted: "onAfterDeleteTask";
+}>;
+
+/**
+ * Paginated result returned by {@link getAllBoards}.
+ */
+interface BoardListResult<TBoard = BoardWithColumns> {
+    items: TBoard[];
+    total: number;
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Retrieve all boards matching optional filter criteria, with columns and tasks.
+ * Pure DB function - no hooks, no HTTP context. Safe for SSG and server-side use.
+ *
+ * @param adapter - The database adapter
+ * @param params - Optional filter/pagination parameters (same shape as the list API query)
+ */
+declare function getAllBoards(adapter: DBAdapter, params?: z.infer<typeof BoardListQuerySchema>): Promise<BoardListResult>;
+/** Retrieve collection-safe board and column metadata without loading tasks. */
+declare function getBoardSummaries(adapter: DBAdapter, params?: z.infer<typeof BoardListQuerySchema>): Promise<BoardListResult<BoardWithColumnsOnly>>;
+/**
+ * Retrieve a single board by its ID, with all columns and tasks.
+ * Returns null if the board is not found.
+ * Pure DB function - no hooks, no HTTP context. Safe for SSG and server-side use.
+ *
+ * @param adapter - The database adapter
+ * @param id - The board ID
+ */
+declare function getBoardById(adapter: DBAdapter, id: string): Promise<BoardWithColumns | null>;
+
+/**
+ * Input for creating a new Kanban task.
+ */
+interface CreateKanbanTaskInput {
+    title: string;
+    columnId: string;
+    description?: string;
+    priority?: Priority;
+    assigneeId?: string;
+}
+/**
+ * Create a new task in a Kanban column.
+ * Computes the next order value from existing tasks in the column.
+ *
+ * @remarks **Security:** Operation authorization and lifecycle hooks are not called.
+ * The caller is responsible for any access-control checks before invoking this
+ * function.
+ *
+ * @param adapter - The database adapter
+ * @param input - Task creation input
+ */
+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.
+ *
+ * Concurrency-safe at two levels:
+ * - **Same process**: concurrent calls with the same slug share a single in-flight
+ *   Promise (via `_pendingBoardCreations`), so only one DB write is attempted.
+ * - **Cross-instance**: the DB `unique` constraint on `slug` causes the losing
+ *   write to throw; the catch block re-fetches and returns the winner's board.
+ *
+ * @remarks **Security:** Operation authorization and lifecycle hooks are not called. The caller is
+ * responsible for any access-control checks before invoking this function.
+ *
+ * @param adapter - The database adapter
+ * @param slug - Unique URL-safe slug for the board
+ * @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: 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
+ * {@link createKanbanTask} to resolve column IDs before task creation.
+ *
+ * @remarks **Security:** Operation authorization and lifecycle hooks are not called.
+ *
+ * @param adapter - The database adapter
+ * @param boardId - The board ID
+ */
+declare function getKanbanColumnsByBoardId(adapter: DBAdapter, boardId: string): Promise<Column[]>;
 
 /**
  * Serialize a Task for SSR/SSG use (convert dates to strings).
@@ -21,5 +133,25 @@ declare function serializeColumn(col: ColumnWithTasks): SerializedColumn;
  * Pure function — no DB access, no hooks.
  */
 declare function serializeBoard(board: BoardWithColumns): SerializedBoardWithColumns;
+/** Serialize a collection-safe board summary without task rows. */
+declare function serializeBoardSummary(board: BoardWithColumnsOnly): {
+    id: string;
+    name: string;
+    slug: string;
+    description: string | undefined;
+    ownerId: string | undefined;
+    organizationId: string | undefined;
+    createdAt: string;
+    updatedAt: string;
+    columns: {
+        createdAt: string;
+        updatedAt: string;
+        id: string;
+        title: string;
+        order: number;
+        boardId: string;
+    }[];
+};
 
-export { serializeBoard, serializeColumn, serializeTask };
+export { KANBAN_LIFECYCLE_HOOK_MIGRATIONS, createKanbanTask, findOrCreateKanbanBoard, getAllBoards, getBoardById, getBoardSummaries, getKanbanColumnsByBoardId, serializeBoard, serializeBoardSummary, serializeColumn, serializeTask };
+export type { BoardListResult, CreateKanbanTaskInput };

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

@@ -1,5 +1,8 @@
 export { kanbanBackendPlugin } from '../../../packages/stack/src/plugins/kanban/api/plugin.mjs';
-export { getAllBoards, getBoardById } from '../../../packages/stack/src/plugins/kanban/api/getters.mjs';
+export { KANBAN_LIFECYCLE_HOOK_MIGRATIONS } from '../../../packages/stack/src/plugins/kanban/api/lifecycle-migrations.mjs';
+export { KanbanOperationError, createKanbanOperations } from '../../../packages/stack/src/plugins/kanban/api/operations.mjs';
+export { kanbanPermissions } from '../permissions.mjs';
+export { getAllBoards, getBoardById, getBoardSummaries } from '../../../packages/stack/src/plugins/kanban/api/getters.mjs';
 export { createKanbanTask, findOrCreateKanbanBoard, getKanbanColumnsByBoardId } from '../../../packages/stack/src/plugins/kanban/api/mutations.mjs';
-export { serializeBoard, serializeColumn, serializeTask } from '../../../packages/stack/src/plugins/kanban/api/serializers.mjs';
+export { serializeBoard, serializeBoardSummary, serializeColumn, serializeTask } from '../../../packages/stack/src/plugins/kanban/api/serializers.mjs';
 export { KANBAN_QUERY_KEYS } from '../../../packages/stack/src/plugins/kanban/api/query-key-defs.mjs';

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

@@ -2,7 +2,12 @@ export { B as BoardsListPageComponent, N as NewBoardPageComponent } from '../../
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
 import { HTMLAttributes, ReactNode } from 'react';
-import { a as SerializedColumn, b as SerializedTask, c as SerializedBoard } from '../../../../shared/stack.DJaKVY7v.cjs';
+import { d as SerializedColumn, e as SerializedTask, b as SerializedBoard } from '../../../../shared/stack.CvlC5kqe.cjs';
+import '@btst/stack/authorization';
+import '@btst/stack/context';
+import '@btst/stack/plugins/api';
+import 'zod';
+import '../../permissions.cjs';
 
 interface BoardPageComponentProps {
     boardId: string;
@@ -33,44 +38,45 @@ declare function DefaultError({ error, reset }: DefaultErrorProps): react_jsx_ru
 
 interface KanbanBoardProps {
     boardId: string;
+    ownerId?: string;
+    organizationId?: string;
     columns: (SerializedColumn & {
         tasks: SerializedTask[];
     })[];
     kanbanState: Record<string, SerializedTask[]>;
-    canMoveColumns: boolean;
-    canMoveTasks: boolean;
     onKanbanChange: (newData: Record<string, SerializedTask[]>) => void;
     onAddTask: (columnId: string) => void;
     onEditTask: (columnId: string, taskId: string) => void;
     onEditColumn: (columnId: string) => void;
     onDeleteColumn: (columnId: string) => void;
 }
-declare function KanbanBoardComponent({ boardId, columns, kanbanState, canMoveColumns, canMoveTasks, onKanbanChange, onAddTask, onEditTask, onEditColumn, onDeleteColumn, }: KanbanBoardProps): react_jsx_runtime.JSX.Element;
+declare function KanbanBoardComponent({ boardId, ownerId, organizationId, columns, kanbanState, onKanbanChange, onAddTask, onEditTask, onEditColumn, onDeleteColumn, }: KanbanBoardProps): react_jsx_runtime.JSX.Element;
 declare const KanbanBoard: React.MemoExoticComponent<typeof KanbanBoardComponent>;
 
 interface ColumnContentProps {
     boardId: string;
+    ownerId?: string;
+    organizationId?: string;
     column: SerializedColumn & {
         tasks: SerializedTask[];
     };
-    canMoveColumn: boolean;
-    canMoveTasks: boolean;
     onAddTask: () => void;
     onEditTask: (taskId: string) => void;
     onEditColumn: () => void;
     onDeleteColumn: () => void;
 }
-declare function ColumnContentComponent({ boardId, column, canMoveColumn, canMoveTasks, onAddTask, onEditTask, onEditColumn, onDeleteColumn, }: ColumnContentProps): react_jsx_runtime.JSX.Element;
+declare function ColumnContentComponent({ boardId, ownerId, organizationId, column, onAddTask, onEditTask, onEditColumn, onDeleteColumn, }: ColumnContentProps): react_jsx_runtime.JSX.Element;
 declare const ColumnContent: React.MemoExoticComponent<typeof ColumnContentComponent>;
 
 interface TaskCardProps {
     boardId: string;
+    ownerId?: string;
+    organizationId?: string;
     columnId: string;
     task: SerializedTask;
-    canMove: boolean;
     onClick: () => void;
 }
-declare function TaskCardComponent({ boardId, columnId, task, canMove, onClick, }: TaskCardProps): react_jsx_runtime.JSX.Element;
+declare function TaskCardComponent({ boardId, ownerId, organizationId, columnId, task, onClick, }: TaskCardProps): react_jsx_runtime.JSX.Element;
 declare const TaskCard: React.MemoExoticComponent<typeof TaskCardComponent>;
 
 interface BoardFormProps {
@@ -92,6 +98,8 @@ declare function ColumnForm({ boardId, columnId, column, onClose, onSuccess, }:
 interface TaskFormProps {
     columnId: string;
     boardId: string;
+    ownerId?: string;
+    organizationId?: string;
     taskId?: string;
     task?: SerializedTask;
     columns: SerializedColumn[];
@@ -99,7 +107,7 @@ interface TaskFormProps {
     onSuccess: () => void;
     onDelete?: () => void | Promise<void>;
 }
-declare function TaskForm({ columnId, boardId, taskId, task, columns, onClose, onSuccess, onDelete, }: TaskFormProps): react_jsx_runtime.JSX.Element;
+declare function TaskForm({ columnId, boardId, ownerId, organizationId, taskId, task, columns, onClose, onSuccess, onDelete, }: TaskFormProps): react_jsx_runtime.JSX.Element;
 
 declare function BoardsListSkeleton(): react_jsx_runtime.JSX.Element;
 

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

@@ -2,7 +2,12 @@ export { B as BoardsListPageComponent, N as NewBoardPageComponent } from '../../
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
 import { HTMLAttributes, ReactNode } from 'react';
-import { a as SerializedColumn, b as SerializedTask, c as SerializedBoard } from '../../../../shared/stack.DJaKVY7v.mjs';
+import { d as SerializedColumn, e as SerializedTask, b as SerializedBoard } from '../../../../shared/stack.DlCycSM-.mjs';
+import '@btst/stack/authorization';
+import '@btst/stack/context';
+import '@btst/stack/plugins/api';
+import 'zod';
+import '../../permissions.mjs';
 
 interface BoardPageComponentProps {
     boardId: string;
@@ -33,44 +38,45 @@ declare function DefaultError({ error, reset }: DefaultErrorProps): react_jsx_ru
 
 interface KanbanBoardProps {
     boardId: string;
+    ownerId?: string;
+    organizationId?: string;
     columns: (SerializedColumn & {
         tasks: SerializedTask[];
     })[];
     kanbanState: Record<string, SerializedTask[]>;
-    canMoveColumns: boolean;
-    canMoveTasks: boolean;
     onKanbanChange: (newData: Record<string, SerializedTask[]>) => void;
     onAddTask: (columnId: string) => void;
     onEditTask: (columnId: string, taskId: string) => void;
     onEditColumn: (columnId: string) => void;
     onDeleteColumn: (columnId: string) => void;
 }
-declare function KanbanBoardComponent({ boardId, columns, kanbanState, canMoveColumns, canMoveTasks, onKanbanChange, onAddTask, onEditTask, onEditColumn, onDeleteColumn, }: KanbanBoardProps): react_jsx_runtime.JSX.Element;
+declare function KanbanBoardComponent({ boardId, ownerId, organizationId, columns, kanbanState, onKanbanChange, onAddTask, onEditTask, onEditColumn, onDeleteColumn, }: KanbanBoardProps): react_jsx_runtime.JSX.Element;
 declare const KanbanBoard: React.MemoExoticComponent<typeof KanbanBoardComponent>;
 
 interface ColumnContentProps {
     boardId: string;
+    ownerId?: string;
+    organizationId?: string;
     column: SerializedColumn & {
         tasks: SerializedTask[];
     };
-    canMoveColumn: boolean;
-    canMoveTasks: boolean;
     onAddTask: () => void;
     onEditTask: (taskId: string) => void;
     onEditColumn: () => void;
     onDeleteColumn: () => void;
 }
-declare function ColumnContentComponent({ boardId, column, canMoveColumn, canMoveTasks, onAddTask, onEditTask, onEditColumn, onDeleteColumn, }: ColumnContentProps): react_jsx_runtime.JSX.Element;
+declare function ColumnContentComponent({ boardId, ownerId, organizationId, column, onAddTask, onEditTask, onEditColumn, onDeleteColumn, }: ColumnContentProps): react_jsx_runtime.JSX.Element;
 declare const ColumnContent: React.MemoExoticComponent<typeof ColumnContentComponent>;
 
 interface TaskCardProps {
     boardId: string;
+    ownerId?: string;
+    organizationId?: string;
     columnId: string;
     task: SerializedTask;
-    canMove: boolean;
     onClick: () => void;
 }
-declare function TaskCardComponent({ boardId, columnId, task, canMove, onClick, }: TaskCardProps): react_jsx_runtime.JSX.Element;
+declare function TaskCardComponent({ boardId, ownerId, organizationId, columnId, task, onClick, }: TaskCardProps): react_jsx_runtime.JSX.Element;
 declare const TaskCard: React.MemoExoticComponent<typeof TaskCardComponent>;
 
 interface BoardFormProps {
@@ -92,6 +98,8 @@ declare function ColumnForm({ boardId, columnId, column, onClose, onSuccess, }:
 interface TaskFormProps {
     columnId: string;
     boardId: string;
+    ownerId?: string;
+    organizationId?: string;
     taskId?: string;
     task?: SerializedTask;
     columns: SerializedColumn[];
@@ -99,7 +107,7 @@ interface TaskFormProps {
     onSuccess: () => void;
     onDelete?: () => void | Promise<void>;
 }
-declare function TaskForm({ columnId, boardId, taskId, task, columns, onClose, onSuccess, onDelete, }: TaskFormProps): react_jsx_runtime.JSX.Element;
+declare function TaskForm({ columnId, boardId, ownerId, organizationId, taskId, task, columns, onClose, onSuccess, onDelete, }: TaskFormProps): react_jsx_runtime.JSX.Element;
 
 declare function BoardsListSkeleton(): react_jsx_runtime.JSX.Element;