@btst/stack 2.12.2 → 3.0.0-rc.1

package/dist/shared/{stack.zpwVhSJb.d.mts → stack.DQq8DEIv.d.mts}

@@ -1,15 +1,84 @@
 import * as _btst_stack_plugins_api from '@btst/stack/plugins/api';
 import { S as StorageAdapter, b as S3UploadToken } from './stack.lkebw2nj.mjs';
-import { d as AssetListResult, l as listAssets, a as listFolders, A as AssetListParams } from './stack.C7u9lq9T.mjs';
 import * as better_call from 'better-call';
 import { z } from 'zod';
 import { A as Asset, F as Folder } from './stack.BMlLOMED.mjs';
 import { DBAdapter } from '@btst/db';
 
+/**
+ * Parameters for filtering and paginating the asset list.
+ */
+interface AssetListParams {
+    folderId?: string;
+    mimeType?: string;
+    query?: string;
+    offset?: number;
+    limit?: number;
+    tenantId?: string;
+}
+/**
+ * Paginated result returned by {@link listAssets}.
+ */
+interface AssetListResult {
+    items: Asset[];
+    total: number;
+    limit?: number;
+    offset?: number;
+}
+/**
+ * Parameters for filtering the folder list.
+ */
+interface FolderListParams {
+    parentId?: string | null;
+    tenantId?: string;
+}
+/**
+ * Retrieve all assets matching optional filter criteria.
+ * Pure DB function — no hooks, no HTTP context. Safe for server-side use.
+ *
+ * @remarks **Security:** Authorization hooks are NOT called. The caller is
+ * responsible for any access-control checks before invoking this function.
+ */
+declare function listAssets(adapter: DBAdapter, params?: AssetListParams): Promise<AssetListResult>;
+/**
+ * Retrieve a single asset by its ID.
+ * Returns `null` if no asset is found.
+ * Pure DB function — no hooks, no HTTP context.
+ *
+ * @remarks **Security:** Authorization hooks are NOT called.
+ */
+declare function getAssetById(adapter: DBAdapter, id: string): Promise<Asset | null>;
+/**
+ * Retrieve all folders, optionally filtered by `parentId`.
+ * Pass `null` to list root-level folders (those without a parent).
+ * Pure DB function — no hooks, no HTTP context.
+ *
+ * @remarks **Security:** Authorization hooks are NOT called.
+ */
+declare function listFolders(adapter: DBAdapter, params?: FolderListParams): Promise<Folder[]>;
+/**
+ * Retrieve a single folder by its ID.
+ * Returns `null` if no folder is found.
+ * Pure DB function — no hooks, no HTTP context.
+ *
+ * @remarks **Security:** Authorization hooks are NOT called.
+ */
+declare function getFolderById(adapter: DBAdapter, id: string): Promise<Folder | null>;
+/**
+ * Find a single folder by name, optionally scoped to a specific parent and/or tenant.
+ * Pass `null` for `parentId` to search only root-level folders.
+ * Pass `undefined` for `parentId` to search regardless of parent.
+ * Returns `null` if no matching folder is found.
+ *
+ * Pure DB function — no hooks, no HTTP context.
+ * The caller is responsible for any access-control checks.
+ */
+declare function getFolderByName(adapter: DBAdapter, name: string, parentId?: string | null, tenantId?: string): Promise<Folder | null>;
+
 declare const AssetListQuerySchema: z.ZodObject<{
     folderId: z.ZodOptional<z.ZodString>;
     mimeType: z.ZodOptional<z.ZodString>;
-    query: z.ZodOptional<z.ZodString>;
+    query: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>>;
     offset: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
     limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
 }, z.core.$strip>;
@@ -140,7 +209,7 @@ interface MediaBackendHooks {
      * Called before listing folders. Throw to deny access.
      */
     onBeforeListFolders?: (filter: {
-        parentId?: string;
+        parentId?: string | null;
     }, context: MediaApiContext) => Promise<void> | void;
     /**
      * Called before creating a folder. Throw to deny access.
@@ -299,8 +368,12 @@ declare const mediaBackendPlugin: (config: MediaBackendConfig) => _btst_stack_pl
         method: "GET";
     } & {
         query: better_call.StandardSchemaV1<{
+            parentId: string | null | undefined;
+        } | {
             parentId?: string | undefined;
         }, {
+            parentId: string | null | undefined;
+        } | {
             parentId?: string | undefined;
         }>;
     }, Folder[]>;
@@ -375,12 +448,14 @@ interface AssetListDiscriminator {
     offset: number | undefined;
 }
 declare function assetListDiscriminator(params?: AssetListParams): AssetListDiscriminator;
+type FolderListDiscriminator = "all" | "root" | string;
+declare function folderListDiscriminator(parentId?: string | null): FolderListDiscriminator;
 /** Full query key builders — use these with `queryClient.setQueryData()`. */
 declare const MEDIA_QUERY_KEYS: {
-    assetsList: (params?: AssetListParams) => readonly ["media", "assets", "list", AssetListDiscriminator];
-    assetDetail: (id: string) => readonly ["media", "assets", "detail", string];
-    foldersList: (parentId?: string | null) => readonly ["media", "folders", "list", string];
+    assetsList: (params?: AssetListParams) => readonly ["mediaAssets", "list", AssetListDiscriminator];
+    assetDetail: (id: string) => readonly ["mediaAssets", "detail", string];
+    foldersList: (parentId?: string | null) => readonly ["mediaFolders", "list", string];
 };
 
-export { MEDIA_QUERY_KEYS as M, createFolder as a, deleteFolder as b, createAsset as c, deleteAsset as d, assetListDiscriminator as f, mediaBackendPlugin as m, updateAsset as u };
-export type { AssetListDiscriminator as A, CreateAssetInput as C, UpdateAssetInput as U, CreateFolderInput as e, MediaApiContext as g, MediaBackendHooks as h, MediaBackendConfig as i, MediaApiRouter as j };
+export { MEDIA_QUERY_KEYS as M, listFolders as a, getFolderById as b, getFolderByName as c, createAsset as e, deleteAsset as f, getAssetById as g, createFolder as h, deleteFolder as i, assetListDiscriminator as k, listAssets as l, folderListDiscriminator as m, mediaBackendPlugin as q, updateAsset as u };
+export type { AssetListParams as A, CreateAssetInput as C, FolderListParams as F, UpdateAssetInput as U, AssetListResult as d, CreateFolderInput as j, MediaApiContext as n, MediaBackendHooks as o, MediaBackendConfig as p, MediaApiRouter as r, AssetListDiscriminator as s };

package/dist/shared/stack.Db7crl9u.d.cts

@@ -0,0 +1,5 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+declare function FormListPageComponent(): react_jsx_runtime.JSX.Element;
+
+export { FormListPageComponent as F };

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

@@ -0,0 +1,5 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+declare function FormListPageComponent(): react_jsx_runtime.JSX.Element;
+
+export { FormListPageComponent as F };

package/dist/shared/stack.Db7crl9u.d.ts

@@ -0,0 +1,5 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+declare function FormListPageComponent(): react_jsx_runtime.JSX.Element;
+
+export { FormListPageComponent as F };

package/dist/shared/{stack.Fl2Kl_bt.d.ts → stack.Dd-8shBE.d.ts}

@@ -1,9 +1,9 @@
-import * as _tanstack_react_query from '@tanstack/react-query';
+import * as _btst_stack_plugins_client from '@btst/stack/plugins/client';
 import { createApiClient } from '@btst/stack/plugins/client';
-import { M as Message, C as Conversation, S as SerializedConversation, a as SerializedMessage } from './stack.Be1QIHEn.js';
 import * as _btst_stack_plugins_api from '@btst/stack/plugins/api';
 import * as better_call from 'better-call';
 import { Tool, LanguageModel } from 'ai';
+import { M as Message, C as Conversation, S as SerializedConversation, a as SerializedMessage } from './stack.Be1QIHEn.js';
 
 /**
  * Context passed to AI Chat API hooks
@@ -313,9 +313,9 @@ declare const aiChatBackendPlugin: <TTools extends Record<string, Tool> = Record
     updateConversation: better_call.StrictEndpoint<"/chat/conversations/:id", {} & {
         method: "PUT";
         body: better_call.StandardSchemaV1<{
-            title?: string | undefined;
+            title: string;
         }, {
-            title?: string | undefined;
+            title: string;
         }>;
     }, Conversation>;
     deleteConversation: better_call.StrictEndpoint<"/chat/conversations/:id", {} & {
@@ -335,28 +335,158 @@ type AiChatApiRouter = ReturnType<ReturnType<typeof aiChatBackendPlugin>["routes
 type ConversationWithMessages = SerializedConversation & {
     messages: SerializedMessage[];
 };
-declare function createAiChatQueryKeys(client: ReturnType<typeof createApiClient<AiChatApiRouter>>, headers?: HeadersInit): {
+interface CreateConversationInput {
+    id?: string;
+    title?: string;
+}
+interface RenameConversationInput {
+    id: string;
+    title: string;
+}
+/** Single source of truth for conversation HTTP mappings and cache behavior. */
+declare const aiChatResources: {
     conversations: {
-        _def: readonly ["conversations"];
-    } & {
-        list: (() => Omit<{
-            queryKey: readonly ["conversations", "list", string];
-            queryFn: _tanstack_react_query.QueryFunction<SerializedConversation[], readonly ["conversations", "list", string]>;
-        } & {
-            _def: readonly ["conversations", "list"];
-        }, "_def">) & {
-            _def: readonly ["conversations", "list"];
+        queries: {
+            list: {
+                path: string;
+                key: () => string[];
+                select: (data: any) => SerializedConversation[];
+            };
+            detail: {
+                path: string;
+                params: (id: string) => {
+                    id: string;
+                };
+                key: (id: string) => string[];
+                select: (data: any) => ConversationWithMessages | null;
+                skip: (id: string) => boolean;
+            };
         };
-        detail: ((id: string) => Omit<{
-            queryKey: readonly ["conversations", "detail", string];
-            queryFn: _tanstack_react_query.QueryFunction<ConversationWithMessages | null, readonly ["conversations", "detail", string]>;
-        } & {
-            _def: readonly ["conversations", "detail"];
-        }, "_def">) & {
-            _def: readonly ["conversations", "detail"];
+        mutations: {
+            create: {
+                path: string;
+                method: "POST";
+                input: (input: CreateConversationInput) => {
+                    body: CreateConversationInput;
+                };
+                select: (data: any) => SerializedConversation | null;
+                invalidates: string[];
+            };
+            rename: {
+                path: string;
+                method: "PUT";
+                input: (input: RenameConversationInput) => {
+                    params: {
+                        id: string;
+                    };
+                    body: {
+                        title: string;
+                    };
+                };
+                select: (data: any) => SerializedConversation | null;
+                invalidates: string[];
+                setData: {
+                    args: (result: SerializedConversation | null) => string[] | null;
+                    updater: (previous: unknown, result: SerializedConversation | null) => unknown;
+                };
+            };
+            delete: {
+                path: string;
+                method: "DELETE";
+                input: (input: {
+                    id: string;
+                }) => {
+                    params: {
+                        id: string;
+                    };
+                };
+                select: (data: any) => {
+                    success: boolean;
+                };
+                invalidates: string[];
+                removeData: {
+                    args: (_result: {
+                        success: boolean;
+                    }, input: {
+                        id: string;
+                    }) => string[];
+                };
+            };
         };
     };
 };
+declare function createAiChatQueryKeys(client: ReturnType<typeof createApiClient<AiChatApiRouter>>, headers?: HeadersInit): _btst_stack_plugins_client.ResourceQueryKeys<{
+    conversations: {
+        queries: {
+            list: {
+                path: string;
+                key: () => string[];
+                select: (data: any) => SerializedConversation[];
+            };
+            detail: {
+                path: string;
+                params: (id: string) => {
+                    id: string;
+                };
+                key: (id: string) => string[];
+                select: (data: any) => ConversationWithMessages | null;
+                skip: (id: string) => boolean;
+            };
+        };
+        mutations: {
+            create: {
+                path: string;
+                method: "POST";
+                input: (input: CreateConversationInput) => {
+                    body: CreateConversationInput;
+                };
+                select: (data: any) => SerializedConversation | null;
+                invalidates: string[];
+            };
+            rename: {
+                path: string;
+                method: "PUT";
+                input: (input: RenameConversationInput) => {
+                    params: {
+                        id: string;
+                    };
+                    body: {
+                        title: string;
+                    };
+                };
+                select: (data: any) => SerializedConversation | null;
+                invalidates: string[];
+                setData: {
+                    args: (result: SerializedConversation | null) => string[] | null;
+                    updater: (previous: unknown, result: SerializedConversation | null) => unknown;
+                };
+            };
+            delete: {
+                path: string;
+                method: "DELETE";
+                input: (input: {
+                    id: string;
+                }) => {
+                    params: {
+                        id: string;
+                    };
+                };
+                select: (data: any) => {
+                    success: boolean;
+                };
+                invalidates: string[];
+                removeData: {
+                    args: (_result: {
+                        success: boolean;
+                    }, input: {
+                        id: string;
+                    }) => string[];
+                };
+            };
+        };
+    };
+}>;
+type AiChatQueryKeys = ReturnType<typeof createAiChatQueryKeys>;
 
-export { createAiChatQueryKeys as c, aiChatBackendPlugin as d };
-export type { AiChatBackendHooks as A, ChatApiContext as C, AiChatMode as a, AiChatBackendConfig as b, AiChatApiRouter as e, ConversationWithMessages as f };
+export { aiChatResources as a, createAiChatQueryKeys as c, aiChatBackendPlugin as h };
+export type { AiChatQueryKeys as A, ConversationWithMessages as C, RenameConversationInput as R, CreateConversationInput as b, ChatApiContext as d, AiChatBackendHooks as e, AiChatMode as f, AiChatBackendConfig as g, AiChatApiRouter as i };

package/dist/shared/stack.Dg_m1SkT.d.cts

@@ -0,0 +1,5 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+declare function LibraryPageComponent(): react_jsx_runtime.JSX.Element;
+
+export { LibraryPageComponent as L };

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

@@ -0,0 +1,5 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+declare function LibraryPageComponent(): react_jsx_runtime.JSX.Element;
+
+export { LibraryPageComponent as L };

package/dist/shared/stack.Dg_m1SkT.d.ts

@@ -0,0 +1,5 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+declare function LibraryPageComponent(): react_jsx_runtime.JSX.Element;
+
+export { LibraryPageComponent as L };

package/dist/shared/{stack.DxQl8Wa1.d.cts → stack.Dlgtumru.d.cts}

@@ -11,6 +11,8 @@ interface KanbanCommonLocalization {
     save: string;
     loading: string;
     saving: string;
+    creating: string;
+    updating: string;
     deleting: string;
     board: string;
     boards: string;
@@ -25,8 +27,17 @@ interface KanbanCommonLocalization {
     noBoards: string;
     noColumns: string;
     noTasks: string;
+    assigned: string;
+    unassigned: string;
+    pageNotFound: string;
+    pageNotFoundDescription: string;
+    unexpectedError: string;
+    tryAgain: string;
     errorGeneric: string;
     errorNotFound: string;
+    deleteBoardError: string;
+    deleteColumnError: string;
+    deleteTaskError: string;
 }
 
 interface KanbanFormsLocalization {
@@ -51,6 +62,11 @@ interface KanbanFormsLocalization {
     taskPriority: string;
     taskColumn: string;
     taskAssignee: string;
+    selectPriority: string;
+    selectColumn: string;
+    selectAssignee: string;
+    noUsersFound: string;
+    taskMovePartialError: string;
     createTask: string;
     updateTask: string;
     deleteTask: string;
@@ -63,14 +79,26 @@ interface KanbanListLocalization {
     kanbanBoards: string;
     manageProjects: string;
     createNewBoard: string;
+    createNewBoardDescription: string;
     boardDetails: string;
+    boardDetailsDescription: string;
     newBoard: string;
     addColumn: string;
     addTask: string;
+    editBoard: string;
+    editColumn: string;
+    editTask: string;
     columnsCount: string;
     noBoardsDescription: string;
     noColumnsDescription: string;
     noTasksDescription: string;
+    boardNotFound: string;
+    boardNotFoundDescription: string;
+    addColumnDescription: string;
+    editColumnDescription: string;
+    editBoardDescription: string;
+    addTaskDescription: string;
+    editTaskDescription: string;
 }
 
 type KanbanLocalization = Partial<KanbanCommonLocalization & KanbanFormsLocalization & KanbanListLocalization>;
@@ -101,38 +129,14 @@ interface RouteContext {
 /**
  * Overridable components and functions for the Kanban plugin
  *
- * External consumers can provide their own implementations of these
- * to customize the behavior for their framework (Next.js, React Router, etc.)
+ * External consumers can provide their own implementations to customize
+ * plugin-specific components and behavior.
  */
 interface KanbanPluginOverrides {
-    /**
-     * Link component for navigation
-     */
-    Link?: ComponentType<React.ComponentProps<"a"> & Record<string, unknown>>;
-    /**
-     * Navigation function for programmatic navigation
-     */
-    navigate: (path: string) => void | Promise<void>;
-    /**
-     * Refresh function to invalidate server-side cache (e.g., Next.js router.refresh())
-     */
-    refresh?: () => void | Promise<void>;
-    /**
-     * Image component for displaying images
-     */
-    Image?: ComponentType<React.ImgHTMLAttributes<HTMLImageElement> & Record<string, unknown>>;
     /**
      * Localization object for the kanban plugin
      */
     localization?: KanbanLocalization;
-    /**
-     * API base URL
-     */
-    apiBaseURL: string;
-    /**
-     * API base path
-     */
-    apiBasePath: string;
     /**
      * Whether to show the attribution
      */
@@ -192,25 +196,6 @@ interface KanbanPluginOverrides {
      * @param context - Route context
      */
     onRouteError?: (routeName: string, error: Error, context: RouteContext) => void | Promise<void>;
-    /**
-     * Called before the boards list page is rendered
-     * Return false to prevent rendering (e.g., for authorization)
-     * @param context - Route context
-     */
-    onBeforeBoardsPageRendered?: (context: RouteContext) => boolean;
-    /**
-     * Called before a single board page is rendered
-     * Return false to prevent rendering (e.g., for authorization)
-     * @param boardId - The board ID
-     * @param context - Route context
-     */
-    onBeforeBoardPageRendered?: (boardId: string, context: RouteContext) => boolean;
-    /**
-     * Called before the new board page is rendered
-     * Return false to prevent rendering (e.g., for authorization)
-     * @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
@@ -223,10 +208,6 @@ interface KanbanPluginOverrides {
      *     <CommentThread
      *       resourceId={task.id}
      *       resourceType="kanban-task"
-     *       apiBaseURL={apiBaseURL}
-     *       apiBasePath="/api/data"
-     *       currentUserId={session?.userId}
-     *       loginHref="/login"
      *     />
      *   ),
      * }

package/dist/shared/stack.DrUBX-QE.d.cts

@@ -0,0 +1,34 @@
+import { QueryClient } from '@tanstack/react-query';
+import { ComponentType } from 'react';
+
+/**
+ * Minimal structural view of a route returned by
+ * `createStackClient(...).router.getRoute(path)`. The framework entry
+ * factories only need these three fields.
+ */
+interface StackRouteLike {
+    PageComponent?: ComponentType<any> | undefined;
+    loader?: ((...args: any[]) => unknown) | undefined;
+    meta?: ((...args: any[]) => any) | undefined;
+}
+/**
+ * Minimal structural view of the object returned by `createStackClient`.
+ * Any concrete `ClientLib<TRoutes>` is assignable to this shape.
+ */
+interface StackClientLike {
+    router: {
+        getRoute: (path: string, queryParams?: Record<string, string | string[]>) => (StackRouteLike & Record<string, any>) | null | undefined;
+    };
+}
+/**
+ * Consumer-provided factory that returns the stack client for a given
+ * QueryClient (per-request on the server, singleton on the client).
+ */
+type GetStackClient = (queryClient: QueryClient) => StackClientLike;
+/**
+ * A framework-agnostic BTST API handler, as returned by
+ * `createBackendHandler(...).handler`.
+ */
+type StackRequestHandler = (request: Request) => Response | Promise<Response>;
+
+export type { GetStackClient as G, StackRequestHandler as S };

package/dist/shared/stack.DrUBX-QE.d.mts

@@ -0,0 +1,34 @@
+import { QueryClient } from '@tanstack/react-query';
+import { ComponentType } from 'react';
+
+/**
+ * Minimal structural view of a route returned by
+ * `createStackClient(...).router.getRoute(path)`. The framework entry
+ * factories only need these three fields.
+ */
+interface StackRouteLike {
+    PageComponent?: ComponentType<any> | undefined;
+    loader?: ((...args: any[]) => unknown) | undefined;
+    meta?: ((...args: any[]) => any) | undefined;
+}
+/**
+ * Minimal structural view of the object returned by `createStackClient`.
+ * Any concrete `ClientLib<TRoutes>` is assignable to this shape.
+ */
+interface StackClientLike {
+    router: {
+        getRoute: (path: string, queryParams?: Record<string, string | string[]>) => (StackRouteLike & Record<string, any>) | null | undefined;
+    };
+}
+/**
+ * Consumer-provided factory that returns the stack client for a given
+ * QueryClient (per-request on the server, singleton on the client).
+ */
+type GetStackClient = (queryClient: QueryClient) => StackClientLike;
+/**
+ * A framework-agnostic BTST API handler, as returned by
+ * `createBackendHandler(...).handler`.
+ */
+type StackRequestHandler = (request: Request) => Response | Promise<Response>;
+
+export type { GetStackClient as G, StackRequestHandler as S };

package/dist/shared/stack.DrUBX-QE.d.ts

@@ -0,0 +1,34 @@
+import { QueryClient } from '@tanstack/react-query';
+import { ComponentType } from 'react';
+
+/**
+ * Minimal structural view of a route returned by
+ * `createStackClient(...).router.getRoute(path)`. The framework entry
+ * factories only need these three fields.
+ */
+interface StackRouteLike {
+    PageComponent?: ComponentType<any> | undefined;
+    loader?: ((...args: any[]) => unknown) | undefined;
+    meta?: ((...args: any[]) => any) | undefined;
+}
+/**
+ * Minimal structural view of the object returned by `createStackClient`.
+ * Any concrete `ClientLib<TRoutes>` is assignable to this shape.
+ */
+interface StackClientLike {
+    router: {
+        getRoute: (path: string, queryParams?: Record<string, string | string[]>) => (StackRouteLike & Record<string, any>) | null | undefined;
+    };
+}
+/**
+ * Consumer-provided factory that returns the stack client for a given
+ * QueryClient (per-request on the server, singleton on the client).
+ */
+type GetStackClient = (queryClient: QueryClient) => StackClientLike;
+/**
+ * A framework-agnostic BTST API handler, as returned by
+ * `createBackendHandler(...).handler`.
+ */
+type StackRequestHandler = (request: Request) => Response | Promise<Response>;
+
+export type { GetStackClient as G, StackRequestHandler as S };

package/dist/shared/{stack.BFoBvGML.d.mts → stack.DycBcTeg.d.mts}

@@ -72,4 +72,4 @@ interface FunctionDefinition {
  */
 type FunctionRegistry = Record<string, FunctionDefinition>;
 
-export type { ComponentLayer as C, FunctionRegistry as F, PropValue as P, RegistryEntry as R, Variable as V, ComponentRegistry as a, FieldConfigFunction as b };
+export type { ComponentLayer as C, FieldConfigFunction as F, PropValue as P, RegistryEntry as R, Variable as V, ComponentRegistry as a, FunctionRegistry as b };