@btst/stack 2.9.3 → 2.10.0

package/src/plugins/ui-builder/client/plugin.tsx

@@ -3,6 +3,7 @@ import { lazy } from "react";
 import {
 	defineClientPlugin,
 	createApiClient,
+	isConnectionError,
 	runClientHookWithShim,
 } from "@btst/stack/plugins/client";
 import { createRoute } from "@btst/yar";
@@ -10,6 +11,7 @@ import type { ComponentType } from "react";
 import type { QueryClient } from "@tanstack/react-query";
 import type { CMSApiRouter } from "../../cms/api";
 import { createCMSQueryKeys } from "../../cms/query-keys";
+import { createSanitizedSSRLoaderError } from "../../utils";
 import { UI_BUILDER_TYPE_SLUG } from "../schemas";
 import type {
 	UIBuilderClientHooks,
@@ -81,6 +83,18 @@ function createPageListLoader(config: UIBuilderClientConfig) {
 				apiBasePath,
 				headers,
 			};
+			const client = createApiClient<CMSApiRouter>({
+				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 {
 				// Before hook - authorization check
@@ -91,21 +105,9 @@ function createPageListLoader(config: UIBuilderClientConfig) {
 					);
 				}
 
-				const client = createApiClient<CMSApiRouter>({
-					baseURL: apiBaseURL,
-					basePath: apiBasePath,
-				});
-				const queries = createCMSQueryKeys(client, headers);
-				const limit = 20;
-
 				// Prefetch pages using infinite query
-				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: unknown = await client("/content/:typeSlug", {
 							method: "GET",
@@ -133,8 +135,7 @@ function createPageListLoader(config: UIBuilderClientConfig) {
 
 				// Check if there was an error
 				const queryState = queryClient.getQueryState([
-					...listQuery.queryKey,
-					"ui-builder",
+					...uiBuilderListQueryKey,
 				]);
 				if (queryState?.error && hooks?.onLoadError) {
 					const error =
@@ -145,6 +146,22 @@ function createPageListLoader(config: UIBuilderClientConfig) {
 				}
 			} catch (error) {
 				// Error hook - log the error but don't throw during SSR
+				if (isConnectionError(error)) {
+					console.warn(
+						"[btst/ui-builder] route.loader() failed — 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 as Error, context);
 				}
@@ -173,6 +190,14 @@ function createPageBuilderLoader(
 				apiBasePath,
 				headers,
 			};
+			const client = createApiClient<CMSApiRouter>({
+				baseURL: apiBaseURL,
+				basePath: apiBasePath,
+			});
+			const queries = createCMSQueryKeys(client, headers);
+			const pageQuery = id
+				? queries.cmsContent.detail(typeSlug, id)
+				: undefined;
 
 			try {
 				// Before hook - authorization check
@@ -183,17 +208,9 @@ function createPageBuilderLoader(
 					);
 				}
 
-				const client = createApiClient<CMSApiRouter>({
-					baseURL: apiBaseURL,
-					basePath: apiBasePath,
-				});
-				const queries = createCMSQueryKeys(client, headers);
-
 				// Prefetch page if editing
 				if (id) {
-					await queryClient.prefetchQuery(
-						queries.cmsContent.detail(typeSlug, id),
-					);
+					await queryClient.prefetchQuery(pageQuery!);
 				}
 
 				// After hook
@@ -203,9 +220,7 @@ function createPageBuilderLoader(
 
 				// Check if there was an error
 				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
@@ -216,6 +231,21 @@ function createPageBuilderLoader(
 				}
 			} catch (error) {
 				// Error hook - log the error but don't throw during SSR
+				if (isConnectionError(error)) {
+					console.warn(
+						"[btst/ui-builder] route.loader() failed — 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 as Error, context);
 				}

package/src/plugins/utils.ts

@@ -109,6 +109,24 @@ export function isConnectionError(err: unknown): boolean {
 		code === "ERR_CONNECTION_REFUSED"
 	);
 }
+
+/**
+ * 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.
+ */
+export 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.
+ */
+export function createSanitizedSSRLoaderError(): Error {
+	return new Error(SSR_LOADER_ERROR_MESSAGE);
+}
 import type { Router, Endpoint, Status, statusCodes } from "better-call";
 
 interface CreateApiClientOptions {

package/dist/shared/{stack.eq5eg1yt.d.cts → stack.BOokfhZD.d.cts}

@@ -8,11 +8,11 @@ import { QueryClient } from '@tanstack/react-query';
 declare const createBoardSchema: z.ZodObject<{
     description: z.ZodOptional<z.ZodString>;
     name: z.ZodString;
+    createdAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+    updatedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
     slug: z.ZodOptional<z.ZodString>;
     ownerId: z.ZodOptional<z.ZodString>;
     organizationId: z.ZodOptional<z.ZodString>;
-    createdAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
-    updatedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
 }, z.core.$strip>;
 declare const updateBoardSchema: z.ZodObject<{
     createdAt: z.ZodOptional<z.ZodOptional<z.ZodCoercedDate<unknown>>>;
@@ -26,9 +26,9 @@ declare const updateBoardSchema: z.ZodObject<{
 }, z.core.$strip>;
 declare const createColumnSchema: z.ZodObject<{
     title: z.ZodString;
-    boardId: z.ZodString;
     createdAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
     updatedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+    boardId: z.ZodString;
     order: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
 }, z.core.$strip>;
 declare const updateColumnSchema: z.ZodObject<{
@@ -331,19 +331,19 @@ declare const kanbanBackendPlugin: (hooks?: KanbanBackendHooks) => _btst_stack_p
         body: better_call.StandardSchemaV1<{
             name: string;
             description?: string | undefined;
+            createdAt?: unknown;
+            updatedAt?: unknown;
             slug?: string | undefined;
             ownerId?: string | undefined;
             organizationId?: string | undefined;
-            createdAt?: unknown;
-            updatedAt?: unknown;
         }, {
             name: string;
             description?: string | undefined;
+            createdAt?: unknown;
+            updatedAt?: unknown;
             slug?: string | undefined;
             ownerId?: string | undefined;
             organizationId?: string | undefined;
-            createdAt?: unknown;
-            updatedAt?: unknown;
         }>;
     }, {
         columns: ColumnWithTasks[];
@@ -361,19 +361,19 @@ declare const kanbanBackendPlugin: (hooks?: KanbanBackendHooks) => _btst_stack_p
         body: better_call.StandardSchemaV1<{
             description?: string | undefined;
             name?: string | undefined;
+            createdAt?: unknown;
+            updatedAt?: unknown;
             slug?: string | undefined;
             ownerId?: string | undefined;
             organizationId?: string | undefined;
-            createdAt?: unknown;
-            updatedAt?: unknown;
         }, {
             description?: string | undefined;
             name?: string | undefined;
+            createdAt?: unknown;
+            updatedAt?: unknown;
             slug?: string | undefined;
             ownerId?: string | undefined;
             organizationId?: string | undefined;
-            createdAt?: unknown;
-            updatedAt?: unknown;
         }>;
     }, Board>;
     readonly deleteBoard: better_call.StrictEndpoint<"/boards/:id", {} & {
@@ -402,15 +402,15 @@ declare const kanbanBackendPlugin: (hooks?: KanbanBackendHooks) => _btst_stack_p
         method: "PUT";
         body: better_call.StandardSchemaV1<{
             title?: string | undefined;
-            boardId?: string | undefined;
             createdAt?: unknown;
             updatedAt?: unknown;
+            boardId?: string | undefined;
             order?: number | undefined;
         }, {
             title?: string | undefined;
-            boardId?: string | undefined;
             createdAt?: unknown;
             updatedAt?: unknown;
+            boardId?: string | undefined;
             order?: number | undefined;
         }>;
     }, Column>;

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

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

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

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

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

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

package/dist/shared/{stack.CMbX8Q5C.d.ts → stack.BvCR4-9H.d.ts}

@@ -8,11 +8,11 @@ import { QueryClient } from '@tanstack/react-query';
 declare const createBoardSchema: z.ZodObject<{
     description: z.ZodOptional<z.ZodString>;
     name: z.ZodString;
+    createdAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+    updatedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
     slug: z.ZodOptional<z.ZodString>;
     ownerId: z.ZodOptional<z.ZodString>;
     organizationId: z.ZodOptional<z.ZodString>;
-    createdAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
-    updatedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
 }, z.core.$strip>;
 declare const updateBoardSchema: z.ZodObject<{
     createdAt: z.ZodOptional<z.ZodOptional<z.ZodCoercedDate<unknown>>>;
@@ -26,9 +26,9 @@ declare const updateBoardSchema: z.ZodObject<{
 }, z.core.$strip>;
 declare const createColumnSchema: z.ZodObject<{
     title: z.ZodString;
-    boardId: z.ZodString;
     createdAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
     updatedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+    boardId: z.ZodString;
     order: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
 }, z.core.$strip>;
 declare const updateColumnSchema: z.ZodObject<{
@@ -331,19 +331,19 @@ declare const kanbanBackendPlugin: (hooks?: KanbanBackendHooks) => _btst_stack_p
         body: better_call.StandardSchemaV1<{
             name: string;
             description?: string | undefined;
+            createdAt?: unknown;
+            updatedAt?: unknown;
             slug?: string | undefined;
             ownerId?: string | undefined;
             organizationId?: string | undefined;
-            createdAt?: unknown;
-            updatedAt?: unknown;
         }, {
             name: string;
             description?: string | undefined;
+            createdAt?: unknown;
+            updatedAt?: unknown;
             slug?: string | undefined;
             ownerId?: string | undefined;
             organizationId?: string | undefined;
-            createdAt?: unknown;
-            updatedAt?: unknown;
         }>;
     }, {
         columns: ColumnWithTasks[];
@@ -361,19 +361,19 @@ declare const kanbanBackendPlugin: (hooks?: KanbanBackendHooks) => _btst_stack_p
         body: better_call.StandardSchemaV1<{
             description?: string | undefined;
             name?: string | undefined;
+            createdAt?: unknown;
+            updatedAt?: unknown;
             slug?: string | undefined;
             ownerId?: string | undefined;
             organizationId?: string | undefined;
-            createdAt?: unknown;
-            updatedAt?: unknown;
         }, {
             description?: string | undefined;
             name?: string | undefined;
+            createdAt?: unknown;
+            updatedAt?: unknown;
             slug?: string | undefined;
             ownerId?: string | undefined;
             organizationId?: string | undefined;
-            createdAt?: unknown;
-            updatedAt?: unknown;
         }>;
     }, Board>;
     readonly deleteBoard: better_call.StrictEndpoint<"/boards/:id", {} & {
@@ -402,15 +402,15 @@ declare const kanbanBackendPlugin: (hooks?: KanbanBackendHooks) => _btst_stack_p
         method: "PUT";
         body: better_call.StandardSchemaV1<{
             title?: string | undefined;
-            boardId?: string | undefined;
             createdAt?: unknown;
             updatedAt?: unknown;
+            boardId?: string | undefined;
             order?: number | undefined;
         }, {
             title?: string | undefined;
-            boardId?: string | undefined;
             createdAt?: unknown;
             updatedAt?: unknown;
+            boardId?: string | undefined;
             order?: number | undefined;
         }>;
     }, Column>;

package/dist/shared/{stack.Dj04W2c3.d.mts → stack.CWxAl9K3.d.mts}

@@ -8,11 +8,11 @@ import { QueryClient } from '@tanstack/react-query';
 declare const createBoardSchema: z.ZodObject<{
     description: z.ZodOptional<z.ZodString>;
     name: z.ZodString;
+    createdAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+    updatedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
     slug: z.ZodOptional<z.ZodString>;
     ownerId: z.ZodOptional<z.ZodString>;
     organizationId: z.ZodOptional<z.ZodString>;
-    createdAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
-    updatedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
 }, z.core.$strip>;
 declare const updateBoardSchema: z.ZodObject<{
     createdAt: z.ZodOptional<z.ZodOptional<z.ZodCoercedDate<unknown>>>;
@@ -26,9 +26,9 @@ declare const updateBoardSchema: z.ZodObject<{
 }, z.core.$strip>;
 declare const createColumnSchema: z.ZodObject<{
     title: z.ZodString;
-    boardId: z.ZodString;
     createdAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
     updatedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
+    boardId: z.ZodString;
     order: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
 }, z.core.$strip>;
 declare const updateColumnSchema: z.ZodObject<{
@@ -331,19 +331,19 @@ declare const kanbanBackendPlugin: (hooks?: KanbanBackendHooks) => _btst_stack_p
         body: better_call.StandardSchemaV1<{
             name: string;
             description?: string | undefined;
+            createdAt?: unknown;
+            updatedAt?: unknown;
             slug?: string | undefined;
             ownerId?: string | undefined;
             organizationId?: string | undefined;
-            createdAt?: unknown;
-            updatedAt?: unknown;
         }, {
             name: string;
             description?: string | undefined;
+            createdAt?: unknown;
+            updatedAt?: unknown;
             slug?: string | undefined;
             ownerId?: string | undefined;
             organizationId?: string | undefined;
-            createdAt?: unknown;
-            updatedAt?: unknown;
         }>;
     }, {
         columns: ColumnWithTasks[];
@@ -361,19 +361,19 @@ declare const kanbanBackendPlugin: (hooks?: KanbanBackendHooks) => _btst_stack_p
         body: better_call.StandardSchemaV1<{
             description?: string | undefined;
             name?: string | undefined;
+            createdAt?: unknown;
+            updatedAt?: unknown;
             slug?: string | undefined;
             ownerId?: string | undefined;
             organizationId?: string | undefined;
-            createdAt?: unknown;
-            updatedAt?: unknown;
         }, {
             description?: string | undefined;
             name?: string | undefined;
+            createdAt?: unknown;
+            updatedAt?: unknown;
             slug?: string | undefined;
             ownerId?: string | undefined;
             organizationId?: string | undefined;
-            createdAt?: unknown;
-            updatedAt?: unknown;
         }>;
     }, Board>;
     readonly deleteBoard: better_call.StrictEndpoint<"/boards/:id", {} & {
@@ -402,15 +402,15 @@ declare const kanbanBackendPlugin: (hooks?: KanbanBackendHooks) => _btst_stack_p
         method: "PUT";
         body: better_call.StandardSchemaV1<{
             title?: string | undefined;
-            boardId?: string | undefined;
             createdAt?: unknown;
             updatedAt?: unknown;
+            boardId?: string | undefined;
             order?: number | undefined;
         }, {
             title?: string | undefined;
-            boardId?: string | undefined;
             createdAt?: unknown;
             updatedAt?: unknown;
+            boardId?: string | undefined;
             order?: number | undefined;
         }>;
     }, Column>;