@btst/stack 2.12.2 → 3.0.0-rc.2

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.BnSAhKJi.d.ts → stack.DseBJmGF.d.ts}

@@ -1,7 +1,8 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
-import { S as SerializedPost, a as SerializedTag } from './stack.Dsatjh0B.js';
 import { z } from 'zod';
-import { c as createPostSchema, u as updatePostSchema } from './stack.CuhcFsAx.js';
+import { ResourceFormConfig, ResourceFormResult } from '@btst/stack/plugins/client/hooks';
+import { S as SerializedPost, a as SerializedTag } from './stack.Dsatjh0B.js';
+import { c as createPostSchema, u as updatePostSchema } from './stack.D18Dq3ve.js';
 
 /**
  * Options for the usePosts hook
@@ -127,8 +128,15 @@ declare function useSuspenseTags(): {
     tags: SerializedTag[];
     refetch: () => Promise<unknown>;
 };
+/**
+ * Form lifecycle hook for creating/editing posts, built on the core
+ * resource `useForm`: submits the right mutation, awaits invalidation,
+ * notifies, redirects, and maps server validation issues to `fieldErrors`.
+ */
+declare function usePostForm<TValues>(config: ResourceFormConfig<TValues, SerializedPost | null, SerializedPost | null>): ResourceFormResult<TValues, SerializedPost | null, SerializedPost | null>;
 /** Create a new post */
 declare function useCreatePost(): _tanstack_react_query.UseMutationResult<SerializedPost | null, Error, {
+    title: string;
     tags: ({
         name: string;
     } | {
@@ -136,27 +144,44 @@ declare function useCreatePost(): _tanstack_react_query.UseMutationResult<Serial
         name: string;
         slug: string;
     })[];
-    published: boolean;
-    title: string;
     content: string;
     excerpt: string;
+    published: boolean;
     slug?: string | undefined;
     publishedAt?: Date | undefined;
     createdAt?: Date | undefined;
     updatedAt?: Date | undefined;
     image?: string | undefined;
-}, unknown>;
+}>;
 /** Update an existing post by id */
 declare function useUpdatePost(): _tanstack_react_query.UseMutationResult<SerializedPost | null, Error, {
     id: string;
-    data: PostUpdateInput;
-}, unknown>;
+    data: {
+        title: string;
+        content: string;
+        excerpt: string;
+        published: boolean;
+        slug: string;
+        tags: ({
+            name: string;
+        } | {
+            id: string;
+            name: string;
+            slug: string;
+        })[];
+        id: string;
+        publishedAt?: Date | undefined;
+        createdAt?: Date | undefined;
+        updatedAt?: Date | undefined;
+        image?: string | undefined;
+    };
+}>;
 /** Delete a post by id */
 declare function useDeletePost(): _tanstack_react_query.UseMutationResult<{
     success: boolean;
 }, Error, {
     id: string;
-}, unknown>;
+}>;
 /**
  * Hook for searching posts by a free-text query. Uses `usePosts` under the hood.
  * Debounces the query and preserves last successful results to avoid flicker.
@@ -219,5 +244,5 @@ interface UseRecentPostsResult {
  */
 declare function useRecentPosts(options?: UseRecentPostsOptions): UseRecentPostsResult;
 
-export { useSuspensePosts as f, usePost as g, useSuspensePost as h, useTags as i, useSuspenseTags as j, useCreatePost as k, useUpdatePost as l, useDeletePost as m, usePostSearch as n, useNextPreviousPosts as q, useRecentPosts as t, usePosts as u };
-export type { PostCreateInput as P, UsePostsOptions as U, UsePostsResult as a, UsePostSearchOptions as b, UsePostSearchResult as c, UsePostResult as d, PostUpdateInput as e, UseNextPreviousPostsOptions as o, UseNextPreviousPostsResult as p, UseRecentPostsOptions as r, UseRecentPostsResult as s };
+export { useSuspensePosts as f, usePost as g, useSuspensePost as h, useTags as i, useSuspenseTags as j, usePostForm as k, useCreatePost as l, useUpdatePost as m, useDeletePost as n, usePostSearch as o, useNextPreviousPosts as r, usePosts as u, useRecentPosts as v };
+export type { PostCreateInput as P, UsePostsOptions as U, UsePostsResult as a, UsePostSearchOptions as b, UsePostSearchResult as c, UsePostResult as d, PostUpdateInput as e, UseNextPreviousPostsOptions as p, UseNextPreviousPostsResult as q, UseRecentPostsOptions as s, UseRecentPostsResult as t };

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

package/dist/shared/{stack.DNLuzDb3.d.cts → stack.DzwZw-Ck.d.cts}

@@ -1,7 +1,8 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
-import { S as SerializedPost, a as SerializedTag } from './stack.Dsatjh0B.cjs';
 import { z } from 'zod';
-import { c as createPostSchema, u as updatePostSchema } from './stack.CuhcFsAx.cjs';
+import { ResourceFormConfig, ResourceFormResult } from '@btst/stack/plugins/client/hooks';
+import { S as SerializedPost, a as SerializedTag } from './stack.Dsatjh0B.cjs';
+import { c as createPostSchema, u as updatePostSchema } from './stack.D18Dq3ve.cjs';
 
 /**
  * Options for the usePosts hook
@@ -127,8 +128,15 @@ declare function useSuspenseTags(): {
     tags: SerializedTag[];
     refetch: () => Promise<unknown>;
 };
+/**
+ * Form lifecycle hook for creating/editing posts, built on the core
+ * resource `useForm`: submits the right mutation, awaits invalidation,
+ * notifies, redirects, and maps server validation issues to `fieldErrors`.
+ */
+declare function usePostForm<TValues>(config: ResourceFormConfig<TValues, SerializedPost | null, SerializedPost | null>): ResourceFormResult<TValues, SerializedPost | null, SerializedPost | null>;
 /** Create a new post */
 declare function useCreatePost(): _tanstack_react_query.UseMutationResult<SerializedPost | null, Error, {
+    title: string;
     tags: ({
         name: string;
     } | {
@@ -136,27 +144,44 @@ declare function useCreatePost(): _tanstack_react_query.UseMutationResult<Serial
         name: string;
         slug: string;
     })[];
-    published: boolean;
-    title: string;
     content: string;
     excerpt: string;
+    published: boolean;
     slug?: string | undefined;
     publishedAt?: Date | undefined;
     createdAt?: Date | undefined;
     updatedAt?: Date | undefined;
     image?: string | undefined;
-}, unknown>;
+}>;
 /** Update an existing post by id */
 declare function useUpdatePost(): _tanstack_react_query.UseMutationResult<SerializedPost | null, Error, {
     id: string;
-    data: PostUpdateInput;
-}, unknown>;
+    data: {
+        title: string;
+        content: string;
+        excerpt: string;
+        published: boolean;
+        slug: string;
+        tags: ({
+            name: string;
+        } | {
+            id: string;
+            name: string;
+            slug: string;
+        })[];
+        id: string;
+        publishedAt?: Date | undefined;
+        createdAt?: Date | undefined;
+        updatedAt?: Date | undefined;
+        image?: string | undefined;
+    };
+}>;
 /** Delete a post by id */
 declare function useDeletePost(): _tanstack_react_query.UseMutationResult<{
     success: boolean;
 }, Error, {
     id: string;
-}, unknown>;
+}>;
 /**
  * Hook for searching posts by a free-text query. Uses `usePosts` under the hood.
  * Debounces the query and preserves last successful results to avoid flicker.
@@ -219,5 +244,5 @@ interface UseRecentPostsResult {
  */
 declare function useRecentPosts(options?: UseRecentPostsOptions): UseRecentPostsResult;
 
-export { useSuspensePosts as f, usePost as g, useSuspensePost as h, useTags as i, useSuspenseTags as j, useCreatePost as k, useUpdatePost as l, useDeletePost as m, usePostSearch as n, useNextPreviousPosts as q, useRecentPosts as t, usePosts as u };
-export type { PostCreateInput as P, UsePostsOptions as U, UsePostsResult as a, UsePostSearchOptions as b, UsePostSearchResult as c, UsePostResult as d, PostUpdateInput as e, UseNextPreviousPostsOptions as o, UseNextPreviousPostsResult as p, UseRecentPostsOptions as r, UseRecentPostsResult as s };
+export { useSuspensePosts as f, usePost as g, useSuspensePost as h, useTags as i, useSuspenseTags as j, usePostForm as k, useCreatePost as l, useUpdatePost as m, useDeletePost as n, usePostSearch as o, useNextPreviousPosts as r, usePosts as u, useRecentPosts as v };
+export type { PostCreateInput as P, UsePostsOptions as U, UsePostsResult as a, UsePostSearchOptions as b, UsePostSearchResult as c, UsePostResult as d, PostUpdateInput as e, UseNextPreviousPostsOptions as p, UseNextPreviousPostsResult as q, UseRecentPostsOptions as s, UseRecentPostsResult as t };

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

@@ -0,0 +1,39 @@
+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;
+/**
+ * Consumer-provided resolver for lifecycle phases that can await request-aware
+ * stack client creation.
+ */
+type ResolveStackClient<TContext> = (queryClient: QueryClient, context: TContext) => StackClientLike | PromiseLike<StackClientLike>;
+/**
+ * A framework-agnostic BTST API handler, as returned by
+ * `createBackendHandler(...).handler`.
+ */
+type StackRequestHandler = (request: Request) => Response | Promise<Response>;
+
+export type { GetStackClient as G, ResolveStackClient as R, StackRequestHandler as S };

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

@@ -0,0 +1,39 @@
+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;
+/**
+ * Consumer-provided resolver for lifecycle phases that can await request-aware
+ * stack client creation.
+ */
+type ResolveStackClient<TContext> = (queryClient: QueryClient, context: TContext) => StackClientLike | PromiseLike<StackClientLike>;
+/**
+ * A framework-agnostic BTST API handler, as returned by
+ * `createBackendHandler(...).handler`.
+ */
+type StackRequestHandler = (request: Request) => Response | Promise<Response>;
+
+export type { GetStackClient as G, ResolveStackClient as R, StackRequestHandler as S };

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

@@ -0,0 +1,39 @@
+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;
+/**
+ * Consumer-provided resolver for lifecycle phases that can await request-aware
+ * stack client creation.
+ */
+type ResolveStackClient<TContext> = (queryClient: QueryClient, context: TContext) => StackClientLike | PromiseLike<StackClientLike>;
+/**
+ * A framework-agnostic BTST API handler, as returned by
+ * `createBackendHandler(...).handler`.
+ */
+type StackRequestHandler = (request: Request) => Response | Promise<Response>;
+
+export type { GetStackClient as G, ResolveStackClient as R, StackRequestHandler as S };