@btst/stack 2.9.3 → 2.10.0

package/dist/packages/stack/src/plugins/ui-builder/client/plugin.mjs

@@ -1,8 +1,9 @@
 import { jsx } from 'react/jsx-runtime';
 import { lazy } from 'react';
-import { defineClientPlugin, createApiClient, runClientHookWithShim } from '@btst/stack/plugins/client';
+import { defineClientPlugin, createApiClient, runClientHookWithShim, isConnectionError } from '@btst/stack/plugins/client';
 import { createRoute } from '@btst/yar';
 import { createCMSQueryKeys } from '../../../../../../plugins/cms/query-keys.mjs';
+import { createSanitizedSSRLoaderError } from '../../utils.mjs';
 import { UI_BUILDER_TYPE_SLUG } from '../schemas.mjs';
 
 const PageListPageComponent = lazy(
@@ -27,6 +28,18 @@ function createPageListLoader(config) {
         apiBasePath,
         headers
       };
+      const client = createApiClient({
+        baseURL: apiBaseURL,
+        basePath: apiBasePath
+      });
+      const queries = createCMSQueryKeys(client, headers);
+      const limit = 20;
+      const listQuery = queries.cmsContent.list({
+        typeSlug,
+        limit,
+        offset: 0
+      });
+      const uiBuilderListQueryKey = [...listQuery.queryKey, "ui-builder"];
       try {
         if (hooks?.beforeLoadPageList) {
           await runClientHookWithShim(
@@ -34,19 +47,8 @@ function createPageListLoader(config) {
             "Load prevented by beforeLoadPageList hook"
           );
         }
-        const client = createApiClient({
-          baseURL: apiBaseURL,
-          basePath: apiBasePath
-        });
-        const queries = createCMSQueryKeys(client, headers);
-        const limit = 20;
-        const listQuery = queries.cmsContent.list({
-          typeSlug,
-          limit,
-          offset: 0
-        });
         await queryClient.prefetchInfiniteQuery({
-          queryKey: [...listQuery.queryKey, "ui-builder"],
+          queryKey: uiBuilderListQueryKey,
           queryFn: async ({ pageParam = 0 }) => {
             const response = await client("/content/:typeSlug", {
               method: "GET",
@@ -65,14 +67,28 @@ function createPageListLoader(config) {
           await hooks.afterLoadPageList(context);
         }
         const queryState = queryClient.getQueryState([
-          ...listQuery.queryKey,
-          "ui-builder"
+          ...uiBuilderListQueryKey
         ]);
         if (queryState?.error && hooks?.onLoadError) {
           const error = queryState.error instanceof Error ? queryState.error : new Error(String(queryState.error));
           await hooks.onLoadError(error, context);
         }
       } catch (error) {
+        if (isConnectionError(error)) {
+          console.warn(
+            "[btst/ui-builder] route.loader() failed \u2014 no server running at build time. Use myStack.api.uiBuilder.prefetchForRoute() for SSG data prefetching."
+          );
+        } else {
+          const errToStore = createSanitizedSSRLoaderError();
+          await queryClient.prefetchInfiniteQuery({
+            queryKey: uiBuilderListQueryKey,
+            queryFn: () => {
+              throw errToStore;
+            },
+            initialPageParam: 0,
+            retry: false
+          });
+        }
         if (hooks?.onLoadError) {
           await hooks.onLoadError(error, context);
         }
@@ -93,6 +109,12 @@ function createPageBuilderLoader(id, config) {
         apiBasePath,
         headers
       };
+      const client = createApiClient({
+        baseURL: apiBaseURL,
+        basePath: apiBasePath
+      });
+      const queries = createCMSQueryKeys(client, headers);
+      const pageQuery = id ? queries.cmsContent.detail(typeSlug, id) : void 0;
       try {
         if (hooks?.beforeLoadPageBuilder) {
           await runClientHookWithShim(
@@ -100,29 +122,34 @@ function createPageBuilderLoader(id, config) {
             "Load prevented by beforeLoadPageBuilder hook"
           );
         }
-        const client = createApiClient({
-          baseURL: apiBaseURL,
-          basePath: apiBasePath
-        });
-        const queries = createCMSQueryKeys(client, headers);
         if (id) {
-          await queryClient.prefetchQuery(
-            queries.cmsContent.detail(typeSlug, id)
-          );
+          await queryClient.prefetchQuery(pageQuery);
         }
         if (hooks?.afterLoadPageBuilder) {
           await hooks.afterLoadPageBuilder(id, context);
         }
         if (id) {
-          const queryState = queryClient.getQueryState(
-            queries.cmsContent.detail(typeSlug, id).queryKey
-          );
+          const queryState = queryClient.getQueryState(pageQuery.queryKey);
           if (queryState?.error && hooks?.onLoadError) {
             const error = queryState.error instanceof Error ? queryState.error : new Error(String(queryState.error));
             await hooks.onLoadError(error, context);
           }
         }
       } catch (error) {
+        if (isConnectionError(error)) {
+          console.warn(
+            "[btst/ui-builder] route.loader() failed \u2014 no server running at build time. Use myStack.api.uiBuilder.prefetchForRoute() for SSG data prefetching."
+          );
+        } else if (pageQuery) {
+          const errToStore = createSanitizedSSRLoaderError();
+          await queryClient.prefetchQuery({
+            queryKey: pageQuery.queryKey,
+            queryFn: () => {
+              throw errToStore;
+            },
+            retry: false
+          });
+        }
         if (hooks?.onLoadError) {
           await hooks.onLoadError(error, context);
         }

package/dist/packages/stack/src/plugins/utils.cjs

@@ -47,6 +47,10 @@ function isConnectionError(err) {
   const code = err.cause?.code ?? err.code;
   return err.message.includes("ECONNREFUSED") || err.message.includes("fetch failed") || err.message.includes("ERR_CONNECTION_REFUSED") || code === "ECONNREFUSED" || code === "ERR_CONNECTION_REFUSED";
 }
+const SSR_LOADER_ERROR_MESSAGE = "Failed to load data.";
+function createSanitizedSSRLoaderError() {
+  return new Error(SSR_LOADER_ERROR_MESSAGE);
+}
 function createApiClient(options) {
   const { baseURL = "", basePath = "/" } = options ?? {};
   const normalizedBaseURL = baseURL ? baseURL.replace(/\/$/, "") : "";
@@ -58,7 +62,9 @@ function createApiClient(options) {
   });
 }
 
+exports.SSR_LOADER_ERROR_MESSAGE = SSR_LOADER_ERROR_MESSAGE;
 exports.createApiClient = createApiClient;
+exports.createSanitizedSSRLoaderError = createSanitizedSSRLoaderError;
 exports.isConnectionError = isConnectionError;
 exports.runClientHookWithShim = runClientHookWithShim;
 exports.runHookWithShim = runHookWithShim;

package/dist/packages/stack/src/plugins/utils.mjs

@@ -45,6 +45,10 @@ function isConnectionError(err) {
   const code = err.cause?.code ?? err.code;
   return err.message.includes("ECONNREFUSED") || err.message.includes("fetch failed") || err.message.includes("ERR_CONNECTION_REFUSED") || code === "ECONNREFUSED" || code === "ERR_CONNECTION_REFUSED";
 }
+const SSR_LOADER_ERROR_MESSAGE = "Failed to load data.";
+function createSanitizedSSRLoaderError() {
+  return new Error(SSR_LOADER_ERROR_MESSAGE);
+}
 function createApiClient(options) {
   const { baseURL = "", basePath = "/" } = options ?? {};
   const normalizedBaseURL = baseURL ? baseURL.replace(/\/$/, "") : "";
@@ -56,4 +60,4 @@ function createApiClient(options) {
   });
 }
 
-export { createApiClient, isConnectionError, runClientHookWithShim, runHookWithShim };
+export { SSR_LOADER_ERROR_MESSAGE, createApiClient, createSanitizedSSRLoaderError, isConnectionError, runClientHookWithShim, runHookWithShim };

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

@@ -1,5 +1,5 @@
-export { B as BLOG_QUERY_KEYS, h as BlogApiContext, k as BlogApiRouter, i as BlogBackendHooks, e as BlogRouteKey, N as NextPreviousPostsQuerySchema, P as PostListParams, f as PostListQuerySchema, c as PostListResult, j as blogBackendPlugin, d as createBlogQueryKeys, g as getAllPosts, b as getAllTags, a as getPostBySlug } from '../../../shared/stack.DjgpFWq3.cjs';
-import { P as Post, T as Tag, S as SerializedPost, a as SerializedTag } from '../../../shared/stack.BQmuNl5p.cjs';
+export { B as BLOG_QUERY_KEYS, h as BlogApiContext, k as BlogApiRouter, i as BlogBackendHooks, e as BlogRouteKey, N as NextPreviousPostsQuerySchema, P as PostListParams, f as PostListQuerySchema, c as PostListResult, j as blogBackendPlugin, d as createBlogQueryKeys, g as getAllPosts, b as getAllTags, a as getPostBySlug } from '../../../shared/stack.BSqJrCTM.cjs';
+import { P as Post, T as Tag, S as SerializedPost, a as SerializedTag } from '../../../shared/stack.BWp0hcm9.cjs';
 import '@tanstack/react-query';
 import '@btst/stack/plugins/client';
 import '@btst/stack/plugins/api';

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

@@ -1,5 +1,5 @@
-export { B as BLOG_QUERY_KEYS, h as BlogApiContext, k as BlogApiRouter, i as BlogBackendHooks, e as BlogRouteKey, N as NextPreviousPostsQuerySchema, P as PostListParams, f as PostListQuerySchema, c as PostListResult, j as blogBackendPlugin, d as createBlogQueryKeys, g as getAllPosts, b as getAllTags, a as getPostBySlug } from '../../../shared/stack.IUeyQKrm.mjs';
-import { P as Post, T as Tag, S as SerializedPost, a as SerializedTag } from '../../../shared/stack.BQmuNl5p.mjs';
+export { B as BLOG_QUERY_KEYS, h as BlogApiContext, k as BlogApiRouter, i as BlogBackendHooks, e as BlogRouteKey, N as NextPreviousPostsQuerySchema, P as PostListParams, f as PostListQuerySchema, c as PostListResult, j as blogBackendPlugin, d as createBlogQueryKeys, g as getAllPosts, b as getAllTags, a as getPostBySlug } from '../../../shared/stack.DzOhpIYM.mjs';
+import { P as Post, T as Tag, S as SerializedPost, a as SerializedTag } from '../../../shared/stack.BWp0hcm9.mjs';
 import '@tanstack/react-query';
 import '@btst/stack/plugins/client';
 import '@btst/stack/plugins/api';

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

@@ -1,5 +1,5 @@
-export { B as BLOG_QUERY_KEYS, h as BlogApiContext, k as BlogApiRouter, i as BlogBackendHooks, e as BlogRouteKey, N as NextPreviousPostsQuerySchema, P as PostListParams, f as PostListQuerySchema, c as PostListResult, j as blogBackendPlugin, d as createBlogQueryKeys, g as getAllPosts, b as getAllTags, a as getPostBySlug } from '../../../shared/stack.D7HSzZdG.js';
-import { P as Post, T as Tag, S as SerializedPost, a as SerializedTag } from '../../../shared/stack.BQmuNl5p.js';
+export { B as BLOG_QUERY_KEYS, h as BlogApiContext, k as BlogApiRouter, i as BlogBackendHooks, e as BlogRouteKey, N as NextPreviousPostsQuerySchema, P as PostListParams, f as PostListQuerySchema, c as PostListResult, j as blogBackendPlugin, d as createBlogQueryKeys, g as getAllPosts, b as getAllTags, a as getPostBySlug } from '../../../shared/stack.BXxrFL9R.js';
+import { P as Post, T as Tag, S as SerializedPost, a as SerializedTag } from '../../../shared/stack.BWp0hcm9.js';
 import '@tanstack/react-query';
 import '@btst/stack/plugins/client';
 import '@btst/stack/plugins/api';

package/dist/plugins/blog/client/hooks/index.d.cts

@@ -1,6 +1,6 @@
-export { P as PostCreateInput, e as PostUpdateInput, o as UseNextPreviousPostsOptions, p as UseNextPreviousPostsResult, d as UsePostResult, b as UsePostSearchOptions, c as UsePostSearchResult, U as UsePostsOptions, a as UsePostsResult, r as UseRecentPostsOptions, s as UseRecentPostsResult, k as useCreatePost, m as useDeletePost, q as useNextPreviousPosts, g as usePost, n as usePostSearch, u as usePosts, t as useRecentPosts, h as useSuspensePost, f as useSuspensePosts, j as useSuspenseTags, i as useTags, l as useUpdatePost } from '../../../../shared/stack.AJTXI7kw.cjs';
+export { P as PostCreateInput, e as PostUpdateInput, o as UseNextPreviousPostsOptions, p as UseNextPreviousPostsResult, d as UsePostResult, b as UsePostSearchOptions, c as UsePostSearchResult, U as UsePostsOptions, a as UsePostsResult, r as UseRecentPostsOptions, s as UseRecentPostsResult, k as useCreatePost, m as useDeletePost, q as useNextPreviousPosts, g as usePost, n as usePostSearch, u as usePosts, t as useRecentPosts, h as useSuspensePost, f as useSuspensePosts, j as useSuspenseTags, i as useTags, l as useUpdatePost } from '../../../../shared/stack.DX-tQ93o.cjs';
 import '@tanstack/react-query';
-import '../../../../shared/stack.BQmuNl5p.cjs';
+import '../../../../shared/stack.BWp0hcm9.cjs';
 import 'zod';
 
 declare function useDebounce<T>(value: T, delay?: number): T;

package/dist/plugins/blog/client/hooks/index.d.mts

@@ -1,6 +1,6 @@
-export { P as PostCreateInput, e as PostUpdateInput, o as UseNextPreviousPostsOptions, p as UseNextPreviousPostsResult, d as UsePostResult, b as UsePostSearchOptions, c as UsePostSearchResult, U as UsePostsOptions, a as UsePostsResult, r as UseRecentPostsOptions, s as UseRecentPostsResult, k as useCreatePost, m as useDeletePost, q as useNextPreviousPosts, g as usePost, n as usePostSearch, u as usePosts, t as useRecentPosts, h as useSuspensePost, f as useSuspensePosts, j as useSuspenseTags, i as useTags, l as useUpdatePost } from '../../../../shared/stack.6mEHS2WH.mjs';
+export { P as PostCreateInput, e as PostUpdateInput, o as UseNextPreviousPostsOptions, p as UseNextPreviousPostsResult, d as UsePostResult, b as UsePostSearchOptions, c as UsePostSearchResult, U as UsePostsOptions, a as UsePostsResult, r as UseRecentPostsOptions, s as UseRecentPostsResult, k as useCreatePost, m as useDeletePost, q as useNextPreviousPosts, g as usePost, n as usePostSearch, u as usePosts, t as useRecentPosts, h as useSuspensePost, f as useSuspensePosts, j as useSuspenseTags, i as useTags, l as useUpdatePost } from '../../../../shared/stack.DOZ1EXjM.mjs';
 import '@tanstack/react-query';
-import '../../../../shared/stack.BQmuNl5p.mjs';
+import '../../../../shared/stack.BWp0hcm9.mjs';
 import 'zod';
 
 declare function useDebounce<T>(value: T, delay?: number): T;

package/dist/plugins/blog/client/hooks/index.d.ts

@@ -1,6 +1,6 @@
-export { P as PostCreateInput, e as PostUpdateInput, o as UseNextPreviousPostsOptions, p as UseNextPreviousPostsResult, d as UsePostResult, b as UsePostSearchOptions, c as UsePostSearchResult, U as UsePostsOptions, a as UsePostsResult, r as UseRecentPostsOptions, s as UseRecentPostsResult, k as useCreatePost, m as useDeletePost, q as useNextPreviousPosts, g as usePost, n as usePostSearch, u as usePosts, t as useRecentPosts, h as useSuspensePost, f as useSuspensePosts, j as useSuspenseTags, i as useTags, l as useUpdatePost } from '../../../../shared/stack.QYn-Px94.js';
+export { P as PostCreateInput, e as PostUpdateInput, o as UseNextPreviousPostsOptions, p as UseNextPreviousPostsResult, d as UsePostResult, b as UsePostSearchOptions, c as UsePostSearchResult, U as UsePostsOptions, a as UsePostsResult, r as UseRecentPostsOptions, s as UseRecentPostsResult, k as useCreatePost, m as useDeletePost, q as useNextPreviousPosts, g as usePost, n as usePostSearch, u as usePosts, t as useRecentPosts, h as useSuspensePost, f as useSuspensePosts, j as useSuspenseTags, i as useTags, l as useUpdatePost } from '../../../../shared/stack.VF6FhyZw.js';
 import '@tanstack/react-query';
-import '../../../../shared/stack.BQmuNl5p.js';
+import '../../../../shared/stack.BWp0hcm9.js';
 import 'zod';
 
 declare function useDebounce<T>(value: T, delay?: number): T;

package/dist/plugins/blog/client/index.d.cts

@@ -2,8 +2,8 @@ import * as _btst_stack_plugins_client from '@btst/stack/plugins/client';
 import * as _btst_yar from '@btst/yar';
 import { ComponentType, ReactNode } from 'react';
 import { QueryClient } from '@tanstack/react-query';
-import { P as Post, S as SerializedPost } from '../../../shared/stack.BQmuNl5p.cjs';
-export { U as UsePostsOptions, a as UsePostsResult } from '../../../shared/stack.AJTXI7kw.cjs';
+import { P as Post, S as SerializedPost } from '../../../shared/stack.BWp0hcm9.cjs';
+export { U as UsePostsOptions, a as UsePostsResult } from '../../../shared/stack.DX-tQ93o.cjs';
 import 'zod';
 
 /**

package/dist/plugins/blog/client/index.d.mts

@@ -2,8 +2,8 @@ import * as _btst_stack_plugins_client from '@btst/stack/plugins/client';
 import * as _btst_yar from '@btst/yar';
 import { ComponentType, ReactNode } from 'react';
 import { QueryClient } from '@tanstack/react-query';
-import { P as Post, S as SerializedPost } from '../../../shared/stack.BQmuNl5p.mjs';
-export { U as UsePostsOptions, a as UsePostsResult } from '../../../shared/stack.6mEHS2WH.mjs';
+import { P as Post, S as SerializedPost } from '../../../shared/stack.BWp0hcm9.mjs';
+export { U as UsePostsOptions, a as UsePostsResult } from '../../../shared/stack.DOZ1EXjM.mjs';
 import 'zod';
 
 /**

package/dist/plugins/blog/client/index.d.ts

@@ -2,8 +2,8 @@ import * as _btst_stack_plugins_client from '@btst/stack/plugins/client';
 import * as _btst_yar from '@btst/yar';
 import { ComponentType, ReactNode } from 'react';
 import { QueryClient } from '@tanstack/react-query';
-import { P as Post, S as SerializedPost } from '../../../shared/stack.BQmuNl5p.js';
-export { U as UsePostsOptions, a as UsePostsResult } from '../../../shared/stack.QYn-Px94.js';
+import { P as Post, S as SerializedPost } from '../../../shared/stack.BWp0hcm9.js';
+export { U as UsePostsOptions, a as UsePostsResult } from '../../../shared/stack.VF6FhyZw.js';
 import 'zod';
 
 /**

package/dist/plugins/blog/query-keys.d.cts

@@ -1,7 +1,7 @@
 import '@tanstack/react-query';
-export { d as createBlogQueryKeys } from '../../shared/stack.DjgpFWq3.cjs';
+export { d as createBlogQueryKeys } from '../../shared/stack.BSqJrCTM.cjs';
 import '@btst/stack/plugins/client';
-import '../../shared/stack.BQmuNl5p.cjs';
+import '../../shared/stack.BWp0hcm9.cjs';
 import '@btst/stack/plugins/api';
 import '@btst/db';
 import 'better-call';

package/dist/plugins/blog/query-keys.d.mts

@@ -1,7 +1,7 @@
 import '@tanstack/react-query';
-export { d as createBlogQueryKeys } from '../../shared/stack.IUeyQKrm.mjs';
+export { d as createBlogQueryKeys } from '../../shared/stack.DzOhpIYM.mjs';
 import '@btst/stack/plugins/client';
-import '../../shared/stack.BQmuNl5p.mjs';
+import '../../shared/stack.BWp0hcm9.mjs';
 import '@btst/stack/plugins/api';
 import '@btst/db';
 import 'better-call';

package/dist/plugins/blog/query-keys.d.ts

@@ -1,7 +1,7 @@
 import '@tanstack/react-query';
-export { d as createBlogQueryKeys } from '../../shared/stack.D7HSzZdG.js';
+export { d as createBlogQueryKeys } from '../../shared/stack.BXxrFL9R.js';
 import '@btst/stack/plugins/client';
-import '../../shared/stack.BQmuNl5p.js';
+import '../../shared/stack.BWp0hcm9.js';
 import '@btst/stack/plugins/api';
 import '@btst/db';
 import 'better-call';

package/dist/plugins/client/index.cjs

@@ -8,7 +8,9 @@ function defineClientPlugin(plugin) {
   return plugin;
 }
 
+exports.SSR_LOADER_ERROR_MESSAGE = utils.SSR_LOADER_ERROR_MESSAGE;
 exports.createApiClient = utils.createApiClient;
+exports.createSanitizedSSRLoaderError = utils.createSanitizedSSRLoaderError;
 exports.isConnectionError = utils.isConnectionError;
 exports.runClientHookWithShim = utils.runClientHookWithShim;
 exports.createRoute = yar.createRoute;

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

@@ -20,6 +20,20 @@ declare function runClientHookWithShim<T>(hookFn: () => Promise<T> | T, defaultM
  * `route.loader()` is called during `next build` with no HTTP server running.
  */
 declare function isConnectionError(err: unknown): boolean;
+/**
+ * Public-safe message used when SSR loader failures are intentionally seeded
+ * into React Query so Error Boundaries can render on the client.
+ *
+ * Never include raw server error text here because dehydrated query state can
+ * be serialized into HTML.
+ */
+declare const SSR_LOADER_ERROR_MESSAGE = "Failed to load data.";
+/**
+ * Creates a sanitized Error for SSR loader cache seeding.
+ *
+ * Use this instead of storing raw server errors in dehydrated query state.
+ */
+declare function createSanitizedSSRLoaderError(): Error;
 
 interface CreateApiClientOptions {
     baseURL?: string;
@@ -67,4 +81,4 @@ declare function createApiClient<TRouter extends Router | Record<string, Endpoin
  */
 declare function defineClientPlugin<TOverrides = Record<string, never>, TRoutes extends Record<string, Route> = Record<string, Route>>(plugin: ClientPlugin<TOverrides, TRoutes>): ClientPlugin<TOverrides, TRoutes>;
 
-export { ClientPlugin, createApiClient, defineClientPlugin, isConnectionError, runClientHookWithShim };
+export { ClientPlugin, SSR_LOADER_ERROR_MESSAGE, createApiClient, createSanitizedSSRLoaderError, defineClientPlugin, isConnectionError, runClientHookWithShim };

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

@@ -20,6 +20,20 @@ declare function runClientHookWithShim<T>(hookFn: () => Promise<T> | T, defaultM
  * `route.loader()` is called during `next build` with no HTTP server running.
  */
 declare function isConnectionError(err: unknown): boolean;
+/**
+ * Public-safe message used when SSR loader failures are intentionally seeded
+ * into React Query so Error Boundaries can render on the client.
+ *
+ * Never include raw server error text here because dehydrated query state can
+ * be serialized into HTML.
+ */
+declare const SSR_LOADER_ERROR_MESSAGE = "Failed to load data.";
+/**
+ * Creates a sanitized Error for SSR loader cache seeding.
+ *
+ * Use this instead of storing raw server errors in dehydrated query state.
+ */
+declare function createSanitizedSSRLoaderError(): Error;
 
 interface CreateApiClientOptions {
     baseURL?: string;
@@ -67,4 +81,4 @@ declare function createApiClient<TRouter extends Router | Record<string, Endpoin
  */
 declare function defineClientPlugin<TOverrides = Record<string, never>, TRoutes extends Record<string, Route> = Record<string, Route>>(plugin: ClientPlugin<TOverrides, TRoutes>): ClientPlugin<TOverrides, TRoutes>;
 
-export { ClientPlugin, createApiClient, defineClientPlugin, isConnectionError, runClientHookWithShim };
+export { ClientPlugin, SSR_LOADER_ERROR_MESSAGE, createApiClient, createSanitizedSSRLoaderError, defineClientPlugin, isConnectionError, runClientHookWithShim };

package/dist/plugins/client/index.d.ts

@@ -20,6 +20,20 @@ declare function runClientHookWithShim<T>(hookFn: () => Promise<T> | T, defaultM
  * `route.loader()` is called during `next build` with no HTTP server running.
  */
 declare function isConnectionError(err: unknown): boolean;
+/**
+ * Public-safe message used when SSR loader failures are intentionally seeded
+ * into React Query so Error Boundaries can render on the client.
+ *
+ * Never include raw server error text here because dehydrated query state can
+ * be serialized into HTML.
+ */
+declare const SSR_LOADER_ERROR_MESSAGE = "Failed to load data.";
+/**
+ * Creates a sanitized Error for SSR loader cache seeding.
+ *
+ * Use this instead of storing raw server errors in dehydrated query state.
+ */
+declare function createSanitizedSSRLoaderError(): Error;
 
 interface CreateApiClientOptions {
     baseURL?: string;
@@ -67,4 +81,4 @@ declare function createApiClient<TRouter extends Router | Record<string, Endpoin
  */
 declare function defineClientPlugin<TOverrides = Record<string, never>, TRoutes extends Record<string, Route> = Record<string, Route>>(plugin: ClientPlugin<TOverrides, TRoutes>): ClientPlugin<TOverrides, TRoutes>;
 
-export { ClientPlugin, createApiClient, defineClientPlugin, isConnectionError, runClientHookWithShim };
+export { ClientPlugin, SSR_LOADER_ERROR_MESSAGE, createApiClient, createSanitizedSSRLoaderError, defineClientPlugin, isConnectionError, runClientHookWithShim };

package/dist/plugins/client/index.mjs

@@ -1,4 +1,4 @@
-export { createApiClient, isConnectionError, runClientHookWithShim } from '../../packages/stack/src/plugins/utils.mjs';
+export { SSR_LOADER_ERROR_MESSAGE, createApiClient, createSanitizedSSRLoaderError, isConnectionError, runClientHookWithShim } from '../../packages/stack/src/plugins/utils.mjs';
 export { createRoute, createRouter } from '@btst/yar';
 export { createClient } from 'better-call/client';
 

package/dist/plugins/comments/client/index.d.cts

@@ -21,6 +21,11 @@ interface LoaderContext {
     apiBasePath: string;
     /** Optional headers for the request */
     headers?: Headers;
+    /**
+     * Optional current user ID for SSR loaders that need user-scoped query keys.
+     * Hooks (e.g. beforeLoadUserComments) may populate this.
+     */
+    currentUserId?: string;
     /** Additional context properties */
     [key: string]: unknown;
 }

package/dist/plugins/comments/client/index.d.mts

@@ -21,6 +21,11 @@ interface LoaderContext {
     apiBasePath: string;
     /** Optional headers for the request */
     headers?: Headers;
+    /**
+     * Optional current user ID for SSR loaders that need user-scoped query keys.
+     * Hooks (e.g. beforeLoadUserComments) may populate this.
+     */
+    currentUserId?: string;
     /** Additional context properties */
     [key: string]: unknown;
 }

package/dist/plugins/comments/client/index.d.ts

@@ -21,6 +21,11 @@ interface LoaderContext {
     apiBasePath: string;
     /** Optional headers for the request */
     headers?: Headers;
+    /**
+     * Optional current user ID for SSR loaders that need user-scoped query keys.
+     * Hooks (e.g. beforeLoadUserComments) may populate this.
+     */
+    currentUserId?: string;
     /** Additional context properties */
     [key: string]: unknown;
 }

package/dist/plugins/comments/query-keys.cjs

@@ -2,7 +2,7 @@
 
 const queryKeyFactory = require('@lukemorales/query-key-factory');
 const queryKeyDefs = require('../../packages/stack/src/plugins/comments/api/query-key-defs.cjs');
-const utils = require('../../packages/stack/src/plugins/comments/client/utils.cjs');
+const errorUtils = require('../../packages/stack/src/plugins/comments/error-utils.cjs');
 
 function isErrorResponse(response) {
   return typeof response === "object" && response !== null && "error" in response && response.error !== null && response.error !== void 0;
@@ -40,7 +40,7 @@ function createCommentsQueries(client, headers) {
           headers
         });
         if (isErrorResponse(response)) {
-          throw utils.toError(response.error);
+          throw errorUtils.toError(response.error);
         }
         const data = response.data;
         return data ?? { items: [], total: 0, limit: 20, offset: 0 };
@@ -63,7 +63,7 @@ function createCommentCountQueries(client, headers) {
           headers
         });
         if (isErrorResponse(response)) {
-          throw utils.toError(response.error);
+          throw errorUtils.toError(response.error);
         }
         const data = response.data;
         return data?.count ?? 0;
@@ -96,7 +96,7 @@ function createCommentsThreadQueries(client, headers) {
           headers
         });
         if (isErrorResponse(response)) {
-          throw utils.toError(response.error);
+          throw errorUtils.toError(response.error);
         }
         const data = response.data;
         return data ?? {

package/dist/plugins/comments/query-keys.mjs

@@ -1,6 +1,6 @@
 import { mergeQueryKeys, createQueryKeys } from '@lukemorales/query-key-factory';
 import { commentsListDiscriminator, commentCountDiscriminator, commentsThreadDiscriminator } from '../../packages/stack/src/plugins/comments/api/query-key-defs.mjs';
-import { toError } from '../../packages/stack/src/plugins/comments/client/utils.mjs';
+import { toError } from '../../packages/stack/src/plugins/comments/error-utils.mjs';
 
 function isErrorResponse(response) {
   return typeof response === "object" && response !== null && "error" in response && response.error !== null && response.error !== void 0;

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

@@ -1,4 +1,4 @@
-export { B as BoardListResult, C as CreateKanbanTaskInput, i as KANBAN_QUERY_KEYS, b as KanbanApiContext, K as KanbanApiRouter, c as KanbanBackendHooks, a as KanbanRouteKey, e as createKanbanTask, f as findOrCreateKanbanBoard, g as getAllBoards, d as getBoardById, h as getKanbanColumnsByBoardId, k as kanbanBackendPlugin } from '../../../shared/stack.eq5eg1yt.cjs';
+export { B as BoardListResult, C as CreateKanbanTaskInput, i as KANBAN_QUERY_KEYS, b as KanbanApiContext, K as KanbanApiRouter, c as KanbanBackendHooks, a as KanbanRouteKey, e as createKanbanTask, f as findOrCreateKanbanBoard, g as getAllBoards, d as getBoardById, h as getKanbanColumnsByBoardId, k as kanbanBackendPlugin } from '../../../shared/stack.BOokfhZD.cjs';
 import { B as BoardWithColumns, S as SerializedBoardWithColumns, C as ColumnWithTasks, a as SerializedColumn, T as Task, b as SerializedTask } from '../../../shared/stack.DJaKVY7v.cjs';
 import '@btst/stack/plugins/api';
 import '@btst/db';

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

@@ -1,4 +1,4 @@
-export { B as BoardListResult, C as CreateKanbanTaskInput, i as KANBAN_QUERY_KEYS, b as KanbanApiContext, K as KanbanApiRouter, c as KanbanBackendHooks, a as KanbanRouteKey, e as createKanbanTask, f as findOrCreateKanbanBoard, g as getAllBoards, d as getBoardById, h as getKanbanColumnsByBoardId, k as kanbanBackendPlugin } from '../../../shared/stack.Dj04W2c3.mjs';
+export { B as BoardListResult, C as CreateKanbanTaskInput, i as KANBAN_QUERY_KEYS, b as KanbanApiContext, K as KanbanApiRouter, c as KanbanBackendHooks, a as KanbanRouteKey, e as createKanbanTask, f as findOrCreateKanbanBoard, g as getAllBoards, d as getBoardById, h as getKanbanColumnsByBoardId, k as kanbanBackendPlugin } from '../../../shared/stack.CWxAl9K3.mjs';
 import { B as BoardWithColumns, S as SerializedBoardWithColumns, C as ColumnWithTasks, a as SerializedColumn, T as Task, b as SerializedTask } from '../../../shared/stack.DJaKVY7v.mjs';
 import '@btst/stack/plugins/api';
 import '@btst/db';

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

@@ -1,4 +1,4 @@
-export { B as BoardListResult, C as CreateKanbanTaskInput, i as KANBAN_QUERY_KEYS, b as KanbanApiContext, K as KanbanApiRouter, c as KanbanBackendHooks, a as KanbanRouteKey, e as createKanbanTask, f as findOrCreateKanbanBoard, g as getAllBoards, d as getBoardById, h as getKanbanColumnsByBoardId, k as kanbanBackendPlugin } from '../../../shared/stack.CMbX8Q5C.js';
+export { B as BoardListResult, C as CreateKanbanTaskInput, i as KANBAN_QUERY_KEYS, b as KanbanApiContext, K as KanbanApiRouter, c as KanbanBackendHooks, a as KanbanRouteKey, e as createKanbanTask, f as findOrCreateKanbanBoard, g as getAllBoards, d as getBoardById, h as getKanbanColumnsByBoardId, k as kanbanBackendPlugin } from '../../../shared/stack.BvCR4-9H.js';
 import { B as BoardWithColumns, S as SerializedBoardWithColumns, C as ColumnWithTasks, a as SerializedColumn, T as Task, b as SerializedTask } from '../../../shared/stack.DJaKVY7v.js';
 import '@btst/stack/plugins/api';
 import '@btst/db';

package/dist/plugins/kanban/query-keys.d.cts

@@ -1,5 +1,5 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
-import { K as KanbanApiRouter, j as BoardsListDiscriminator } from '../../shared/stack.eq5eg1yt.cjs';
+import { K as KanbanApiRouter, j as BoardsListDiscriminator } from '../../shared/stack.BOokfhZD.cjs';
 import { createApiClient } from '@btst/stack/plugins/client';
 import { S as SerializedBoardWithColumns } from '../../shared/stack.DJaKVY7v.cjs';
 import '@btst/stack/plugins/api';

package/dist/plugins/kanban/query-keys.d.mts

@@ -1,5 +1,5 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
-import { K as KanbanApiRouter, j as BoardsListDiscriminator } from '../../shared/stack.Dj04W2c3.mjs';
+import { K as KanbanApiRouter, j as BoardsListDiscriminator } from '../../shared/stack.CWxAl9K3.mjs';
 import { createApiClient } from '@btst/stack/plugins/client';
 import { S as SerializedBoardWithColumns } from '../../shared/stack.DJaKVY7v.mjs';
 import '@btst/stack/plugins/api';

package/dist/plugins/kanban/query-keys.d.ts

@@ -1,5 +1,5 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
-import { K as KanbanApiRouter, j as BoardsListDiscriminator } from '../../shared/stack.CMbX8Q5C.js';
+import { K as KanbanApiRouter, j as BoardsListDiscriminator } from '../../shared/stack.BvCR4-9H.js';
 import { createApiClient } from '@btst/stack/plugins/client';
 import { S as SerializedBoardWithColumns } from '../../shared/stack.DJaKVY7v.js';
 import '@btst/stack/plugins/api';

package/dist/shared/{stack.IUeyQKrm.d.mts → stack.BSqJrCTM.d.cts}

@@ -1,7 +1,7 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { QueryClient } from '@tanstack/react-query';
 import { createApiClient } from '@btst/stack/plugins/client';
-import { P as Post, T as Tag, c as createPostSchema, u as updatePostSchema, S as SerializedPost, a as SerializedTag } from './stack.BQmuNl5p.mjs';
+import { P as Post, T as Tag, c as createPostSchema, u as updatePostSchema, S as SerializedPost, a as SerializedTag } from './stack.BWp0hcm9.cjs';
 import * as _btst_stack_plugins_api from '@btst/stack/plugins/api';
 import { DBAdapter } from '@btst/db';
 import * as better_call from 'better-call';
@@ -244,11 +244,11 @@ declare const blogBackendPlugin: (hooks?: BlogBackendHooks) => _btst_stack_plugi
                 slug: string;
             })[] | undefined;
             slug?: string | undefined;
+            published?: boolean | undefined;
+            publishedAt?: unknown;
             createdAt?: unknown;
             updatedAt?: unknown;
-            publishedAt?: unknown;
             image?: string | undefined;
-            published?: boolean | undefined;
         }, {
             title: string;
             content: string;
@@ -261,11 +261,11 @@ declare const blogBackendPlugin: (hooks?: BlogBackendHooks) => _btst_stack_plugi
                 slug: string;
             })[] | undefined;
             slug?: string | undefined;
+            published?: boolean | undefined;
+            publishedAt?: unknown;
             createdAt?: unknown;
             updatedAt?: unknown;
-            publishedAt?: unknown;
             image?: string | undefined;
-            published?: boolean | undefined;
         }>;
     }, Post>;
     readonly updatePost: better_call.StrictEndpoint<"/posts/:id", {} & {

package/dist/shared/{stack.D7HSzZdG.d.ts → stack.BXxrFL9R.d.ts}

@@ -1,7 +1,7 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { QueryClient } from '@tanstack/react-query';
 import { createApiClient } from '@btst/stack/plugins/client';
-import { P as Post, T as Tag, c as createPostSchema, u as updatePostSchema, S as SerializedPost, a as SerializedTag } from './stack.BQmuNl5p.js';
+import { P as Post, T as Tag, c as createPostSchema, u as updatePostSchema, S as SerializedPost, a as SerializedTag } from './stack.BWp0hcm9.js';
 import * as _btst_stack_plugins_api from '@btst/stack/plugins/api';
 import { DBAdapter } from '@btst/db';
 import * as better_call from 'better-call';
@@ -244,11 +244,11 @@ declare const blogBackendPlugin: (hooks?: BlogBackendHooks) => _btst_stack_plugi
                 slug: string;
             })[] | undefined;
             slug?: string | undefined;
+            published?: boolean | undefined;
+            publishedAt?: unknown;
             createdAt?: unknown;
             updatedAt?: unknown;
-            publishedAt?: unknown;
             image?: string | undefined;
-            published?: boolean | undefined;
         }, {
             title: string;
             content: string;
@@ -261,11 +261,11 @@ declare const blogBackendPlugin: (hooks?: BlogBackendHooks) => _btst_stack_plugi
                 slug: string;
             })[] | undefined;
             slug?: string | undefined;
+            published?: boolean | undefined;
+            publishedAt?: unknown;
             createdAt?: unknown;
             updatedAt?: unknown;
-            publishedAt?: unknown;
             image?: string | undefined;
-            published?: boolean | undefined;
         }>;
     }, Post>;
     readonly updatePost: better_call.StrictEndpoint<"/posts/:id", {} & {