@btst/stack 2.3.0 → 2.4.0

package/src/plugins/kanban/api/mutations.ts

@@ -0,0 +1,169 @@
+import type { Adapter } from "@btst/db";
+import type { Board, Column, Task, Priority } from "../types";
+
+/**
+ * Input for creating a new Kanban task.
+ */
+export 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:** No authorization hooks (onBeforeCreateTask) are called.
+ * The caller is responsible for any access-control checks before invoking this
+ * function.
+ *
+ * @param adapter - The database adapter
+ * @param input - Task creation input
+ */
+export async function createKanbanTask(
+	adapter: Adapter,
+	input: CreateKanbanTaskInput,
+): Promise<Task> {
+	const existingTasks = await adapter.findMany<Task>({
+		model: "kanbanTask",
+		where: [
+			{
+				field: "columnId",
+				value: input.columnId,
+				operator: "eq" as const,
+			},
+		],
+	});
+
+	const nextOrder =
+		existingTasks.length > 0
+			? Math.max(...existingTasks.map((t) => t.order)) + 1
+			: 0;
+
+	return adapter.create<Task>({
+		model: "kanbanTask",
+		data: {
+			title: input.title,
+			columnId: input.columnId,
+			description: input.description,
+			priority: input.priority ?? "MEDIUM",
+			order: nextOrder,
+			assigneeId: input.assigneeId,
+			isArchived: false,
+			createdAt: new Date(),
+			updatedAt: new Date(),
+		},
+	});
+}
+
+/**
+ * Coalesces concurrent `findOrCreateKanbanBoard` calls within the same process.
+ * Keyed by slug; entries are removed once the creation promise settles.
+ */
+const _pendingBoardCreations = new Map<string, Promise<Board>>();
+
+/**
+ * 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:** No authorization hooks are 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)
+ */
+export async function findOrCreateKanbanBoard(
+	adapter: Adapter,
+	slug: string,
+	name: string,
+	columnTitles: string[],
+): Promise<Board> {
+	const existing = await adapter.findOne<Board>({
+		model: "kanbanBoard",
+		where: [{ field: "slug", value: slug, operator: "eq" as const }],
+	});
+
+	if (existing) return existing;
+
+	// Coalesce same-process concurrent calls for this slug
+	const inflight = _pendingBoardCreations.get(slug);
+	if (inflight) return inflight;
+
+	const creation = (async () => {
+		try {
+			const board = await adapter.create<Board>({
+				model: "kanbanBoard",
+				data: {
+					name,
+					slug,
+					createdAt: new Date(),
+					updatedAt: new Date(),
+				},
+			});
+
+			await Promise.all(
+				columnTitles.map((title, index) =>
+					adapter.create<Column>({
+						model: "kanbanColumn",
+						data: {
+							title,
+							boardId: board.id,
+							order: index,
+							createdAt: new Date(),
+							updatedAt: new Date(),
+						},
+					}),
+				),
+			);
+
+			return board;
+		} catch (err) {
+			// Cross-instance race: another process won the unique-constraint race.
+			// Re-fetch so all callers return the same board.
+			const winner = await adapter.findOne<Board>({
+				model: "kanbanBoard",
+				where: [{ field: "slug", value: slug, operator: "eq" as const }],
+			});
+			if (winner) return winner;
+			throw err;
+		}
+	})();
+
+	_pendingBoardCreations.set(slug, creation);
+	try {
+		return await creation;
+	} finally {
+		_pendingBoardCreations.delete(slug);
+	}
+}
+
+/**
+ * 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:** No authorization hooks are called.
+ *
+ * @param adapter - The database adapter
+ * @param boardId - The board ID
+ */
+export async function getKanbanColumnsByBoardId(
+	adapter: Adapter,
+	boardId: string,
+): Promise<Column[]> {
+	return adapter.findMany<Column>({
+		model: "kanbanColumn",
+		where: [{ field: "boardId", value: boardId, operator: "eq" as const }],
+		sortBy: { field: "order", direction: "asc" },
+	});
+}

package/src/plugins/kanban/api/plugin.ts

@@ -24,6 +24,11 @@ import {
 	updateTaskSchema,
 } from "../schemas";
 import { getAllBoards, getBoardById } from "./getters";
+import {
+	createKanbanTask,
+	findOrCreateKanbanBoard,
+	getKanbanColumnsByBoardId,
+} from "./mutations";
 import { KANBAN_QUERY_KEYS } from "./query-key-defs";
 import { serializeBoard } from "./serializers";
 import type { QueryClient } from "@tanstack/react-query";
@@ -317,6 +322,13 @@ export const kanbanBackendPlugin = (hooks?: KanbanBackendHooks) =>
 				getAllBoards(adapter, params),
 			getBoardById: (id: string) => getBoardById(adapter, id),
 			prefetchForRoute: createKanbanPrefetchForRoute(adapter),
+			// Mutations
+			createTask: (input: Parameters<typeof createKanbanTask>[1]) =>
+				createKanbanTask(adapter, input),
+			findOrCreateBoard: (slug: string, name: string, columnTitles: string[]) =>
+				findOrCreateKanbanBoard(adapter, slug, name, columnTitles),
+			getColumnsByBoardId: (boardId: string) =>
+				getKanbanColumnsByBoardId(adapter, boardId),
 		}),
 
 		routes: (adapter: Adapter) => {

package/src/plugins/kanban/client/hooks/kanban-hooks.tsx

@@ -85,6 +85,7 @@ export function useBoards(params?: {
 	return useQuery({
 		...queries.boards.list(params),
 		staleTime: 30_000,
+		refetchOnWindowFocus: true,
 	});
 }
 
@@ -102,6 +103,7 @@ export function useSuspenseBoards(params?: {
 	const result = useSuspenseQuery({
 		...queries.boards.list(params),
 		staleTime: 30_000,
+		refetchOnWindowFocus: true,
 	});
 
 	if (result.error && !result.isFetching) {
@@ -121,6 +123,7 @@ export function useBoard(boardId: string) {
 	return useQuery({
 		...queries.boards.detail(boardId),
 		staleTime: 30_000,
+		refetchOnWindowFocus: true,
 		enabled: !!boardId,
 	});
 }
@@ -135,6 +138,7 @@ export function useSuspenseBoard(boardId: string) {
 	const result = useSuspenseQuery({
 		...queries.boards.detail(boardId),
 		staleTime: 30_000,
+		refetchOnWindowFocus: true,
 	});
 
 	if (result.error && !result.isFetching) {

package/src/plugins/ui-builder/client/components/pages/page-builder-page.internal.tsx

@@ -22,9 +22,12 @@ import { toast } from "sonner";
 import UIBuilder from "@workspace/ui/components/ui-builder";
 import type {
 	ComponentLayer,
+	ComponentRegistry,
 	Variable,
 } from "@workspace/ui/components/ui-builder/types";
 
+import { useLayerStore } from "@workspace/ui/lib/ui-builder/store/layer-store";
+import { useRegisterPageAIContext } from "@btst/stack/plugins/ai-chat/client/context";
 import {
 	useSuspenseUIBuilderPage,
 	useCreateUIBuilderPage,
@@ -39,6 +42,104 @@ export interface PageBuilderPageProps {
 	id?: string;
 }
 
+/**
+ * Generate a concise AI-readable description of the available components
+ * in the component registry, including their prop names.
+ */
+function buildRegistryDescription(registry: ComponentRegistry): string {
+	const lines: string[] = [];
+	for (const [name, entry] of Object.entries(registry) as [
+		string,
+		{ schema?: unknown },
+	][]) {
+		let propsLine = "";
+		try {
+			const shape = (entry.schema as any)?.shape as
+				| Record<string, unknown>
+				| undefined;
+			if (shape) {
+				const fields = Object.keys(shape).join(", ");
+				propsLine = ` — props: ${fields}`;
+			}
+		} catch {
+			// ignore schema introspection errors
+		}
+		lines.push(`- ${name}${propsLine}`);
+	}
+	return lines.join("\n");
+}
+
+/**
+ * Build the full page description string for the AI context.
+ * Stays within the 8,000-character pageContext limit.
+ */
+function buildPageDescription(
+	id: string | undefined,
+	slug: string,
+	layers: ComponentLayer[],
+	registry: ComponentRegistry,
+): string {
+	const header = id
+		? `UI Builder — editing page (slug: "${slug}")`
+		: "UI Builder — creating new page";
+
+	const layersJson = JSON.stringify(layers, null, 2);
+
+	const registryDesc = buildRegistryDescription(registry);
+
+	const layerFormat = `Each layer: { id: string, type: string, name: string, props: Record<string,any>, children?: ComponentLayer[] | string }`;
+
+	const full = [
+		header,
+		"",
+		`## Current Layers (${layers.length})`,
+		layersJson,
+		"",
+		`## Available Component Types`,
+		registryDesc,
+		"",
+		`## ComponentLayer format`,
+		layerFormat,
+	].join("\n");
+
+	// Trim to fit the 16,000-char server-side limit, cutting the layers JSON if needed
+	if (full.length <= 16000) return full;
+
+	// Re-build with truncated layers JSON
+	const overhead =
+		[
+			header,
+			"",
+			`## Current Layers (${layers.length})`,
+			"",
+			"",
+			`## Available Component Types`,
+			registryDesc,
+			"",
+			`## ComponentLayer format`,
+			layerFormat,
+		].join("\n").length + 30; // 30-char buffer for "...(truncated)"
+
+	const budget = Math.max(0, 16000 - overhead);
+	const truncatedLayers =
+		layersJson.length > budget
+			? layersJson.slice(0, budget) + "\n...(truncated)"
+			: layersJson;
+
+	return [
+		header,
+		"",
+		`## Current Layers (${layers.length})`,
+		truncatedLayers,
+		"",
+		`## Available Component Types`,
+		registryDesc,
+		"",
+		`## ComponentLayer format`,
+		layerFormat,
+	].join("\n");
+}
+
 /**
  * Slugify a string for URL-friendly slugs
  */
@@ -139,6 +240,37 @@ function PageBuilderPageContent({
 	// Auto-generate slug from first page name
 	const [autoSlug, setAutoSlug] = useState(!id);
 
+	// Register AI context so the chat can update the page layout
+	useRegisterPageAIContext({
+		routeName: id ? "ui-builder-edit-page" : "ui-builder-new-page",
+		pageDescription: buildPageDescription(id, slug, layers, componentRegistry),
+		suggestions: [
+			"Add a hero section",
+			"Add a 3-column feature grid",
+			"Make the layout full-width",
+			"Add a card with a title, description, and button",
+			"Replace the layout with a centered single-column design",
+		],
+		clientTools: {
+			updatePageLayers: async ({ layers: newLayers }) => {
+				// Drive the UIBuilder's Zustand store directly so the editor
+				// and layers panel update immediately. The store's onChange
+				// callback will propagate back to the parent's `layers` state.
+				const store = useLayerStore.getState();
+				store.initialize(
+					newLayers,
+					store.selectedPageId || newLayers[0]?.id,
+					undefined,
+					store.variables,
+				);
+				return {
+					success: true,
+					message: `Applied ${newLayers.length} layer(s) to the page`,
+				};
+			},
+		},
+	});
+
 	// Handle layers change from UIBuilder
 	const handleLayersChange = useCallback(
 		(newLayers: ComponentLayer[]) => {

package/dist/shared/{stack.C5dtIncc.d.mts → stack.B7ONvlD_.d.mts}

@@ -191,8 +191,8 @@ declare const formBuilderBackendPlugin: (config?: FormBuilderBackendConfig) => _
         };
         submittedAt: string;
         id: string;
-        formId: string;
         data: string;
+        formId: string;
         submittedBy?: string | undefined;
         ipAddress?: string | undefined;
         userAgent?: string | undefined;

package/dist/shared/{stack.CBON0dWL.d.cts → stack.BQmuNl5p.d.cts}

@@ -42,11 +42,11 @@ declare const createPostSchema: z.ZodObject<{
         name: z.ZodString;
         slug: z.ZodString;
     }, z.core.$strip>]>>>>;
+    title: z.ZodString;
     slug: z.ZodOptional<z.ZodString>;
-    publishedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
     createdAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
     updatedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
-    title: z.ZodString;
+    publishedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
     content: z.ZodString;
     excerpt: z.ZodString;
     image: z.ZodOptional<z.ZodString>;

package/dist/shared/{stack.CBON0dWL.d.mts → stack.BQmuNl5p.d.mts}

@@ -42,11 +42,11 @@ declare const createPostSchema: z.ZodObject<{
         name: z.ZodString;
         slug: z.ZodString;
     }, z.core.$strip>]>>>>;
+    title: z.ZodString;
     slug: z.ZodOptional<z.ZodString>;
-    publishedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
     createdAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
     updatedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
-    title: z.ZodString;
+    publishedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
     content: z.ZodString;
     excerpt: z.ZodString;
     image: z.ZodOptional<z.ZodString>;

package/dist/shared/{stack.CBON0dWL.d.ts → stack.BQmuNl5p.d.ts}

@@ -42,11 +42,11 @@ declare const createPostSchema: z.ZodObject<{
         name: z.ZodString;
         slug: z.ZodString;
     }, z.core.$strip>]>>>>;
+    title: z.ZodString;
     slug: z.ZodOptional<z.ZodString>;
-    publishedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
     createdAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
     updatedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
-    title: z.ZodString;
+    publishedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
     content: z.ZodString;
     excerpt: z.ZodString;
     image: z.ZodOptional<z.ZodString>;

package/dist/shared/{stack.CIP6QS9l.d.ts → stack.Kq2-QzOC.d.ts}

@@ -191,8 +191,8 @@ declare const formBuilderBackendPlugin: (config?: FormBuilderBackendConfig) => _
         };
         submittedAt: string;
         id: string;
-        formId: string;
         data: string;
+        formId: string;
         submittedBy?: string | undefined;
         ipAddress?: string | undefined;
         userAgent?: string | undefined;

package/dist/shared/{stack.Dw0Ly2TM.d.cts → stack.kcdnD4gA.d.cts}

@@ -191,8 +191,8 @@ declare const formBuilderBackendPlugin: (config?: FormBuilderBackendConfig) => _
         };
         submittedAt: string;
         id: string;
-        formId: string;
         data: string;
+        formId: string;
         submittedBy?: string | undefined;
         ipAddress?: string | undefined;
         userAgent?: string | undefined;