@btst/stack 2.12.2 → 3.0.0-rc.1

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

@@ -0,0 +1,251 @@
+/**
+ * Shared error contract and React Query config for all data plugins.
+ *
+ * Every plugin used to copy-paste `isErrorResponse` / `toError` /
+ * `SHARED_QUERY_CONFIG` into its own `query-keys.ts` / hooks files. These now
+ * live in core and are exported once from `@btst/stack/plugins/client`.
+ */
+/**
+ * Standardized error shape thrown by resource queries and mutations.
+ *
+ * `errors` maps field names to validation message(s), preserving Zod
+ * field-level issues from better-call endpoint validation errors so form
+ * hooks can map them onto per-field error state.
+ */
+interface StackError extends Error {
+    statusCode?: number;
+    errors?: Record<string, string | string[]>;
+}
+/**
+ * Shared React Query configuration for all plugin queries.
+ * Prevents automatic refetching to avoid hydration mismatches in SSR.
+ */
+declare const SHARED_QUERY_CONFIG: {
+    readonly retry: false;
+    readonly refetchOnWindowFocus: false;
+    readonly refetchOnMount: false;
+    readonly refetchOnReconnect: false;
+    readonly staleTime: number;
+    readonly gcTime: number;
+};
+/**
+ * Type guard for better-call error responses.
+ * better-call client returns `Error$1<unknown> | Data<T>` — we check if
+ * `error` exists and is not null/undefined to determine it's an error response.
+ */
+declare function isErrorResponse(response: unknown): response is {
+    error: unknown;
+    data?: never;
+};
+/**
+ * Converts an unknown error (typically a better-call / better-fetch error
+ * response body) into a proper `StackError` with a meaningful message.
+ *
+ * Normalizes to `{ message, statusCode?, errors? }` where `errors` maps
+ * field names to validation messages (preserved from Zod issues in
+ * better-call endpoint validation error responses).
+ */
+declare function toError(error: unknown): StackError;
+
+/**
+ * Server-safe resource declaration types and query-key/queryFn builder.
+ *
+ * A plugin declares its resources once (paths, query mappings, unwrapping,
+ * key discriminators) and gets:
+ *
+ * - `createResourceQueryKeys(client, resources, headers?)` — a query-key
+ *   factory usable from SSR loaders and `query-keys.ts` (no React), with the
+ *   same `_def` / `queryKey` shapes as `@lukemorales/query-key-factory`, so
+ *   existing SSG `prefetchForRoute` / `query-key-defs.ts` keys keep matching.
+ * - `createResource(...)` (see `./hooks`) — generated React Query hooks.
+ */
+/**
+ * Minimal better-call client shape the resource layer needs.
+ * Any `createApiClient<TRouter>()` result is assignable.
+ */
+type ResourceClient = (path: any, options?: any) => Promise<unknown>;
+/**
+ * Declaration for a single query on a resource.
+ *
+ * Query-key shape: `[resourceName, queryName, ...key(...args)]` where `key`
+ * defaults to the args themselves. Share discriminator functions with
+ * `api/query-key-defs.ts` to keep SSG prefetch keys in sync.
+ */
+interface ResourceQueryDef<TArgs extends readonly unknown[] = readonly any[], TData = unknown> {
+    /** better-call endpoint path, e.g. `"/posts"` or `"/content/:typeSlug"` */
+    path: string;
+    /** Maps hook args to the endpoint path params (for `:param` segments) */
+    params?: (...args: TArgs) => Record<string, string>;
+    /** Maps hook args to the HTTP query object */
+    query?: (...args: TArgs) => Record<string, unknown> | undefined;
+    /**
+     * Maps hook args to the queryKey discriminator cells appended after
+     * `[resourceName, queryName]`. Defaults to the args themselves.
+     */
+    key?: (...args: TArgs) => readonly unknown[];
+    /** Unwraps/selects data from the raw response data */
+    select?: (data: any, ...args: TArgs) => TData;
+    /**
+     * Offset-paginated infinite query. The queryFn receives `pageParam` and
+     * injects it into the HTTP query as `offsetParam`. `select` must return
+     * an array (one page of items).
+     */
+    infinite?: boolean;
+    /** HTTP query param carrying the page offset (default `"offset"`) */
+    offsetParam?: string;
+    /**
+     * Page size used to derive `getNextPageParam` for infinite queries
+     * (default 10). A function form derives it from the hook args.
+     */
+    pageSize?: number | ((...args: TArgs) => number);
+    /**
+     * Custom `getNextPageParam` for infinite queries whose pages are not
+     * plain item arrays (e.g. `{ items, total }` envelopes). Overrides the
+     * default page-size heuristic. Return `undefined` when there is no
+     * next page.
+     */
+    nextPageParam?: (lastPage: TData, allPages: TData[], ...args: TArgs) => unknown | undefined;
+    /** When true, skip fetching and resolve `null` (e.g. missing id) */
+    skip?: (...args: TArgs) => boolean;
+}
+/**
+ * Declaration for a single mutation on a resource.
+ */
+interface ResourceMutationDef<TVars = any, TResult = unknown> {
+    /** better-call endpoint path, e.g. `"@post/posts"` or `"@put/posts/:id"` */
+    path: string;
+    method: "POST" | "PUT" | "PATCH" | "DELETE";
+    /**
+     * Maps mutation variables to better-call call options.
+     * Defaults to `{ body: vars }`.
+     */
+    input?: (vars: TVars) => {
+        body?: unknown;
+        params?: Record<string, string>;
+        query?: Record<string, unknown>;
+    };
+    /** Unwraps the mutation result from the raw response data */
+    select?: (data: any) => TResult;
+    /**
+     * Query-key prefixes invalidated (awaited, in order) after success.
+     * `"posts"` invalidates the whole resource, `"posts.list"` one query.
+     */
+    invalidates?: readonly string[];
+    /**
+     * Which matching queries to refetch during invalidation. Defaults to
+     * React Query's `"active"`; use `"all"` when an inactive view must be
+     * refreshed before it remounts.
+     */
+    refetchType?: "active" | "inactive" | "all" | "none";
+    /**
+     * Seed a query cache entry from the mutation result (e.g. the detail
+     * entry for a created/updated record). `args` returns the key args for
+     * the target query, or `null` to skip seeding.
+     */
+    setData?: {
+        /** Target query name on the same resource (default `"detail"`) */
+        query?: string;
+        args: (result: TResult) => readonly unknown[] | null;
+        /**
+         * Optionally merge the mutation result with the existing cache value.
+         * Defaults to replacing the cached value with `result`.
+         */
+        updater?: (previous: unknown, result: TResult) => unknown;
+    };
+    /**
+     * Remove a query cache entry after success (e.g. the deleted record's
+     * detail query). `args` may derive the target key from both the result and
+     * the submitted variables, or return `null` to skip removal.
+     */
+    removeData?: {
+        /** Target query name on the same resource (default `"detail"`) */
+        query?: string;
+        args: (result: TResult, variables: TVars) => readonly unknown[] | null;
+    };
+    /**
+     * Whether to call the router `refresh` override after success (default
+     * `true`). Set `false` for mutations that must not reload server-rendered
+     * state — e.g. public submissions whose success UI lives in client state.
+     */
+    refresh?: boolean;
+}
+/** Declaration for one resource: its queries and (optionally) mutations. */
+interface ResourceDef {
+    queries: Record<string, ResourceQueryDef<any, any>>;
+    mutations?: Record<string, ResourceMutationDef<any, any>>;
+}
+/** A plugin's full resource declaration, keyed by resource name. */
+type ResourcesDeclaration = Record<string, ResourceDef>;
+/** Extracts the hook args tuple from a query declaration. */
+type ResourceQueryArgs<TDef> = TDef extends {
+    query: (...args: infer A) => any;
+} ? A : TDef extends {
+    params: (...args: infer A) => any;
+} ? A : TDef extends {
+    key: (...args: infer A) => any;
+} ? A : TDef extends {
+    select: (data: any, ...args: infer A) => any;
+} ? A : [];
+/** Extracts the (per-page, for infinite queries) data type from a query declaration. */
+type ResourceQueryData<TDef> = TDef extends {
+    select: (data: any, ...args: any[]) => infer D;
+} ? D : unknown;
+/** Extracts the variables type from a mutation declaration. */
+type ResourceMutationVars<TDef> = TDef extends {
+    input: (vars: infer V) => any;
+} ? V : unknown;
+/** Extracts the result type from a mutation declaration. */
+type ResourceMutationResult<TDef> = TDef extends {
+    select: (data: any) => infer R;
+} ? R : unknown;
+/**
+ * A query-key factory entry: call with args to get `{ queryKey, queryFn }`,
+ * read `_def` for the `[resourceName, queryName]` prefix.
+ */
+interface ResourceQueryEntry<TArgs extends readonly unknown[] = readonly any[], TData = unknown> {
+    (...args: TArgs): {
+        queryKey: readonly unknown[];
+        queryFn: (context?: {
+            pageParam?: unknown;
+        }) => Promise<TData>;
+    };
+    _def: readonly [string, string];
+}
+/** The query-key factory produced from a resources declaration. */
+type ResourceQueryKeys<TResources extends ResourcesDeclaration> = {
+    [R in keyof TResources]: {
+        [Q in keyof TResources[R]["queries"]]: ResourceQueryEntry<ResourceQueryArgs<TResources[R]["queries"][Q]>, ResourceQueryData<TResources[R]["queries"][Q]>>;
+    } & {
+        _def: readonly [R];
+    };
+};
+/** Resolves the effective page size for an infinite query declaration. */
+declare function resolvePageSize(def: ResourceQueryDef<any, any>, args: readonly unknown[]): number;
+/** Builds the full query key for a query declaration and args. */
+declare function buildQueryKey(resourceName: string, queryName: string, def: ResourceQueryDef<any, any>, args: readonly unknown[]): readonly unknown[];
+/**
+ * Executes the fetch → error-check → unwrap dance for a query declaration.
+ */
+declare function runResourceQuery(client: ResourceClient, def: ResourceQueryDef<any, any>, args: readonly unknown[], pageParam?: unknown, headers?: HeadersInit): Promise<unknown>;
+/**
+ * Executes a mutation declaration: fetch → error-check → unwrap.
+ *
+ * `headers` supports plugins whose public hooks take an explicit client
+ * config (e.g. embeddable components) instead of resolving it from
+ * `usePluginOverrides` — same as the `headers` parameter on
+ * `createResourceQueryKeys`.
+ */
+declare function runResourceMutation(client: ResourceClient, def: ResourceMutationDef<any, any>, vars: unknown, headers?: HeadersInit): Promise<unknown>;
+/**
+ * Builds a query-key factory from a resources declaration.
+ *
+ * Compatible with the shapes `@lukemorales/query-key-factory` produces:
+ * `store.posts.list(params)` → `{ queryKey: ["posts", "list", ...], queryFn }`,
+ * `store.posts.list._def` → `["posts", "list"]`, `store.posts._def` → `["posts"]`.
+ *
+ * Server-safe (no React) — usable from SSR loaders and `query-keys.ts`.
+ */
+declare function createResourceQueryKeys<const TResources extends ResourcesDeclaration>(client: ResourceClient, resources: TResources, headers?: HeadersInit): ResourceQueryKeys<TResources>;
+
+export { SHARED_QUERY_CONFIG as S, buildQueryKey as b, createResourceQueryKeys as c, runResourceMutation as d, runResourceQuery as e, isErrorResponse as i, resolvePageSize as r, toError as t };
+export type { ResourceClient as R, StackError as a, ResourceDef as f, ResourceMutationDef as g, ResourceMutationResult as h, ResourceMutationVars as j, ResourceQueryArgs as k, ResourceQueryData as l, ResourceQueryDef as m, ResourceQueryEntry as n, ResourceQueryKeys as o, ResourcesDeclaration as p };

package/dist/shared/{stack.RuQ9JCLo.d.ts → stack.Cf-DbL1A.d.ts}

@@ -20,7 +20,8 @@ declare function serializeFormSubmission(submission: FormSubmission): Serialized
  */
 declare function serializeFormSubmissionWithData(submission: FormSubmissionWithForm): SerializedFormSubmissionWithData;
 /**
- * Retrieve all forms with optional status filter and pagination.
+ * Retrieve all forms with optional status filter, pagination, and free-text
+ * search.
  * Pure DB function — no hooks, no HTTP context. Safe for SSG and server-side use.
  *
  * @remarks **Security:** Authorization hooks (e.g. `onBeforeListForms`) are NOT
@@ -28,12 +29,14 @@ declare function serializeFormSubmissionWithData(submission: FormSubmissionWithF
  * invoking this function.
  *
  * @param adapter - The database adapter
- * @param params - Optional filter/pagination parameters
+ * @param params - Optional filter/pagination parameters. `search` matches
+ * case-insensitively against form names and slugs.
  */
 declare function getAllForms(adapter: DBAdapter, params?: {
     status?: string;
     limit?: number;
     offset?: number;
+    search?: string;
 }): Promise<{
     items: SerializedForm[];
     total: number;
@@ -111,10 +114,12 @@ declare const formBuilderBackendPlugin: (config?: FormBuilderBackendConfig) => _
             status?: "active" | "inactive" | "archived" | undefined;
             limit?: unknown;
             offset?: unknown;
+            search?: string | undefined;
         }, {
             status?: "active" | "inactive" | "archived" | undefined;
             limit?: unknown;
             offset?: unknown;
+            search?: string | undefined;
         }>;
     }, {
         items: SerializedForm[];
@@ -285,6 +290,7 @@ interface FormsListDiscriminator {
     status?: "active" | "inactive" | "archived";
     limit: number;
     offset: number;
+    search: string | undefined;
 }
 interface SubmissionsListDiscriminator {
     formId: string;
@@ -301,6 +307,7 @@ declare const FORM_QUERY_KEYS: {
         status?: "active" | "inactive" | "archived";
         limit?: number;
         offset?: number;
+        search?: string;
     }) => readonly ["forms", "list", "list", FormsListDiscriminator];
     /**
      * Key for forms.byId(id) query.
@@ -319,4 +326,4 @@ declare const FORM_QUERY_KEYS: {
 };
 
 export { getFormById as c, getFormBySlug as d, getFormSubmissions as e, formBuilderBackendPlugin as f, getAllForms as g, serializeFormSubmission as h, serializeFormSubmissionWithData as i, FORM_QUERY_KEYS as j, serializeForm as s };
-export type { FormBuilderApiRouter as F, SubmissionsListDiscriminator as S, FormsListDiscriminator as a, FormBuilderRouteKey as b };
+export type { FormsListDiscriminator as F, SubmissionsListDiscriminator as S, FormBuilderApiRouter as a, FormBuilderRouteKey as b };

package/dist/shared/{stack.Cd6McBu1.d.mts → stack.Cp_6mO5s.d.mts}

@@ -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.Ldfkr5b2.d.mts → stack.D7bewlgt.d.cts}

@@ -1,3 +1,5 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
 declare const COMMENTS_LOCALIZATION: {
     COMMENTS_MY_LOGIN_TITLE: string;
     COMMENTS_MY_LOGIN_DESCRIPTION: string;
@@ -108,5 +110,7 @@ declare const COMMENTS_LOCALIZATION: {
 };
 type CommentsLocalization = typeof COMMENTS_LOCALIZATION;
 
-export { COMMENTS_LOCALIZATION as a };
+declare function ModerationPageComponent(): react_jsx_runtime.JSX.Element;
+
+export { ModerationPageComponent as M, COMMENTS_LOCALIZATION as a };
 export type { CommentsLocalization as C };

package/dist/shared/{stack.Ldfkr5b2.d.ts → stack.D7bewlgt.d.mts}

@@ -1,3 +1,5 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
 declare const COMMENTS_LOCALIZATION: {
     COMMENTS_MY_LOGIN_TITLE: string;
     COMMENTS_MY_LOGIN_DESCRIPTION: string;
@@ -108,5 +110,7 @@ declare const COMMENTS_LOCALIZATION: {
 };
 type CommentsLocalization = typeof COMMENTS_LOCALIZATION;
 
-export { COMMENTS_LOCALIZATION as a };
+declare function ModerationPageComponent(): react_jsx_runtime.JSX.Element;
+
+export { ModerationPageComponent as M, COMMENTS_LOCALIZATION as a };
 export type { CommentsLocalization as C };

package/dist/shared/{stack.Ldfkr5b2.d.cts → stack.D7bewlgt.d.ts}

@@ -1,3 +1,5 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
 declare const COMMENTS_LOCALIZATION: {
     COMMENTS_MY_LOGIN_TITLE: string;
     COMMENTS_MY_LOGIN_DESCRIPTION: string;
@@ -108,5 +110,7 @@ declare const COMMENTS_LOCALIZATION: {
 };
 type CommentsLocalization = typeof COMMENTS_LOCALIZATION;
 
-export { COMMENTS_LOCALIZATION as a };
+declare function ModerationPageComponent(): react_jsx_runtime.JSX.Element;
+
+export { ModerationPageComponent as M, COMMENTS_LOCALIZATION as a };
 export type { CommentsLocalization as C };

package/dist/shared/{stack.D88yU4FT.d.mts → stack.DHTvwoNG.d.mts}

@@ -20,7 +20,8 @@ declare function serializeFormSubmission(submission: FormSubmission): Serialized
  */
 declare function serializeFormSubmissionWithData(submission: FormSubmissionWithForm): SerializedFormSubmissionWithData;
 /**
- * Retrieve all forms with optional status filter and pagination.
+ * Retrieve all forms with optional status filter, pagination, and free-text
+ * search.
  * Pure DB function — no hooks, no HTTP context. Safe for SSG and server-side use.
  *
  * @remarks **Security:** Authorization hooks (e.g. `onBeforeListForms`) are NOT
@@ -28,12 +29,14 @@ declare function serializeFormSubmissionWithData(submission: FormSubmissionWithF
  * invoking this function.
  *
  * @param adapter - The database adapter
- * @param params - Optional filter/pagination parameters
+ * @param params - Optional filter/pagination parameters. `search` matches
+ * case-insensitively against form names and slugs.
  */
 declare function getAllForms(adapter: DBAdapter, params?: {
     status?: string;
     limit?: number;
     offset?: number;
+    search?: string;
 }): Promise<{
     items: SerializedForm[];
     total: number;
@@ -111,10 +114,12 @@ declare const formBuilderBackendPlugin: (config?: FormBuilderBackendConfig) => _
             status?: "active" | "inactive" | "archived" | undefined;
             limit?: unknown;
             offset?: unknown;
+            search?: string | undefined;
         }, {
             status?: "active" | "inactive" | "archived" | undefined;
             limit?: unknown;
             offset?: unknown;
+            search?: string | undefined;
         }>;
     }, {
         items: SerializedForm[];
@@ -285,6 +290,7 @@ interface FormsListDiscriminator {
     status?: "active" | "inactive" | "archived";
     limit: number;
     offset: number;
+    search: string | undefined;
 }
 interface SubmissionsListDiscriminator {
     formId: string;
@@ -301,6 +307,7 @@ declare const FORM_QUERY_KEYS: {
         status?: "active" | "inactive" | "archived";
         limit?: number;
         offset?: number;
+        search?: string;
     }) => readonly ["forms", "list", "list", FormsListDiscriminator];
     /**
      * Key for forms.byId(id) query.
@@ -319,4 +326,4 @@ declare const FORM_QUERY_KEYS: {
 };
 
 export { getFormById as c, getFormBySlug as d, getFormSubmissions as e, formBuilderBackendPlugin as f, getAllForms as g, serializeFormSubmission as h, serializeFormSubmissionWithData as i, FORM_QUERY_KEYS as j, serializeForm as s };
-export type { FormBuilderApiRouter as F, SubmissionsListDiscriminator as S, FormsListDiscriminator as a, FormBuilderRouteKey as b };
+export type { FormsListDiscriminator as F, SubmissionsListDiscriminator as S, FormBuilderApiRouter as a, FormBuilderRouteKey as b };

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

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

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

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

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

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

package/dist/shared/{stack.CCncwK6g.d.cts → stack.DKZMaVr6.d.cts}

@@ -1,5 +1,5 @@
 import * as _btst_stack_plugins_api from '@btst/stack/plugins/api';
-import { d as Comment, S as SerializedComment, C as CommentListResult } from './stack.C7KNNiJm.cjs';
+import { a as Comment, S as SerializedComment, C as CommentListResult } from './stack.C3GBG8in.cjs';
 import * as better_call from 'better-call';
 import { z } from 'zod';
 
@@ -331,5 +331,86 @@ declare const commentsBackendPlugin: (options: CommentsBackendOptions) => _btst_
 }>;
 type CommentsApiRouter = ReturnType<ReturnType<typeof commentsBackendPlugin>["routes"]>;
 
-export { CommentListParamsSchema as a, CommentCountQuerySchema as b, commentsBackendPlugin as c };
-export type { CommentsApiRouter as C, CommentsApiContext as d, CommentsBackendOptions as e };
+/**
+ * Internal query key constants for the Comments plugin.
+ * Shared between query-keys.ts (HTTP path) and any SSG/direct DB path
+ * to prevent key drift between loaders and prefetch calls.
+ */
+interface CommentsListDiscriminator {
+    resourceId: string | undefined;
+    resourceType: string | undefined;
+    parentId: string | null | undefined;
+    status: string | undefined;
+    currentUserId: string | undefined;
+    authorId: string | undefined;
+    sort: string | undefined;
+    limit: number;
+    offset: number;
+}
+interface CommentCountDiscriminator {
+    resourceId: string;
+    resourceType: string;
+    status: string | undefined;
+}
+/**
+ * Discriminator for the infinite thread query (top-level comments only).
+ * Intentionally excludes `offset` — pages are driven by `pageParam`, not the key.
+ */
+interface CommentsThreadDiscriminator {
+    resourceId: string | undefined;
+    resourceType: string | undefined;
+    parentId: string | null | undefined;
+    status: string | undefined;
+    currentUserId: string | undefined;
+    sort: string | undefined;
+    limit: number;
+}
+/** Full query key builders — use with queryClient.setQueryData() */
+declare const COMMENTS_QUERY_KEYS: {
+    /**
+     * Key for comments list query.
+     * Full key: ["comments", "list", { resourceId, resourceType, parentId, status, currentUserId, limit, offset }]
+     */
+    commentsList: (params?: {
+        resourceId?: string;
+        resourceType?: string;
+        parentId?: string | null;
+        status?: string;
+        currentUserId?: string;
+        authorId?: string;
+        sort?: string;
+        limit?: number;
+        offset?: number;
+    }) => readonly ["comments", "list", CommentsListDiscriminator];
+    /**
+     * Key for a single comment detail query.
+     * Full key: ["comments", "detail", id]
+     */
+    commentDetail: (id: string) => readonly ["comments", "detail", string];
+    /**
+     * Key for comment count query.
+     * Full key: ["comments", "count", { resourceId, resourceType, status }]
+     */
+    commentCount: (params: {
+        resourceId: string;
+        resourceType: string;
+        status?: string;
+    }) => readonly ["comments", "count", CommentCountDiscriminator];
+    /**
+     * Key for the infinite thread query (top-level comments, load-more).
+     * Full key: ["commentsThread", "list", { resourceId, resourceType, parentId, status, currentUserId, sort, limit }]
+     * Offset is excluded — it is driven by `pageParam`, not baked into the key.
+     */
+    commentsThread: (params?: {
+        resourceId?: string;
+        resourceType?: string;
+        parentId?: string | null;
+        status?: string;
+        currentUserId?: string;
+        sort?: string;
+        limit?: number;
+    }) => readonly ["commentsThread", "list", CommentsThreadDiscriminator];
+};
+
+export { CommentListParamsSchema as d, CommentCountQuerySchema as e, commentsBackendPlugin as f, COMMENTS_QUERY_KEYS as i };
+export type { CommentsListDiscriminator as C, CommentCountDiscriminator as a, CommentsThreadDiscriminator as b, CommentsApiRouter as c, CommentsApiContext as g, CommentsBackendOptions as h };