@btst/stack 2.2.0 → 2.3.0

package/dist/packages/stack/src/plugins/blog/api/plugin.cjs

@@ -6,7 +6,57 @@ const db = require('../db.cjs');
 const utils = require('../utils.cjs');
 const schemas = require('../schemas.cjs');
 const getters = require('./getters.cjs');
+const queryKeyDefs = require('./query-key-defs.cjs');
+const serializers = require('./serializers.cjs');
 
+function createBlogPrefetchForRoute(adapter) {
+  return async function prefetchForRoute(key, qc, params) {
+    switch (key) {
+      case "posts":
+      case "drafts": {
+        const published = key === "posts";
+        const [result, tags] = await Promise.all([
+          getters.getAllPosts(adapter, { published, limit: 10 }),
+          getters.getAllTags(adapter)
+        ]);
+        qc.setQueryData(queryKeyDefs.BLOG_QUERY_KEYS.postsList({ published, limit: 10 }), {
+          pages: [result.items.map(serializers.serializePost)],
+          pageParams: [0]
+        });
+        qc.setQueryData(queryKeyDefs.BLOG_QUERY_KEYS.tagsList(), tags.map(serializers.serializeTag));
+        break;
+      }
+      case "post":
+      case "editPost": {
+        const slug = params?.slug ?? "";
+        if (slug) {
+          const post = await getters.getPostBySlug(adapter, slug);
+          qc.setQueryData(
+            queryKeyDefs.BLOG_QUERY_KEYS.postDetail(slug),
+            post ? serializers.serializePost(post) : null
+          );
+        }
+        break;
+      }
+      case "tag": {
+        const tagSlug = params?.tagSlug ?? "";
+        const [result, tags] = await Promise.all([
+          getters.getAllPosts(adapter, { published: true, limit: 10, tagSlug }),
+          getters.getAllTags(adapter)
+        ]);
+        qc.setQueryData(
+          queryKeyDefs.BLOG_QUERY_KEYS.postsList({ published: true, limit: 10, tagSlug }),
+          {
+            pages: [result.items.map(serializers.serializePost)],
+            pageParams: [0]
+          }
+        );
+        qc.setQueryData(queryKeyDefs.BLOG_QUERY_KEYS.tagsList(), tags.map(serializers.serializeTag));
+        break;
+      }
+    }
+  };
+}
 const PostListQuerySchema = z.z.object({
   slug: z.z.string().optional(),
   tagSlug: z.z.string().optional(),
@@ -29,7 +79,8 @@ const blogBackendPlugin = (hooks) => api.defineBackendPlugin({
   api: (adapter) => ({
     getAllPosts: (params) => getters.getAllPosts(adapter, params),
     getPostBySlug: (slug) => getters.getPostBySlug(adapter, slug),
-    getAllTags: () => getters.getAllTags(adapter)
+    getAllTags: () => getters.getAllTags(adapter),
+    prefetchForRoute: createBlogPrefetchForRoute(adapter)
   }),
   routes: (adapter) => {
     const findOrCreateTags = async (tagInputs) => {

package/dist/packages/stack/src/plugins/blog/api/plugin.mjs

@@ -4,7 +4,57 @@ import { blogSchema } from '../db.mjs';
 import { slugify } from '../utils.mjs';
 import { createPostSchema, updatePostSchema } from '../schemas.mjs';
 import { getAllTags, getPostBySlug, getAllPosts } from './getters.mjs';
+import { BLOG_QUERY_KEYS } from './query-key-defs.mjs';
+import { serializePost, serializeTag } from './serializers.mjs';
 
+function createBlogPrefetchForRoute(adapter) {
+  return async function prefetchForRoute(key, qc, params) {
+    switch (key) {
+      case "posts":
+      case "drafts": {
+        const published = key === "posts";
+        const [result, tags] = await Promise.all([
+          getAllPosts(adapter, { published, limit: 10 }),
+          getAllTags(adapter)
+        ]);
+        qc.setQueryData(BLOG_QUERY_KEYS.postsList({ published, limit: 10 }), {
+          pages: [result.items.map(serializePost)],
+          pageParams: [0]
+        });
+        qc.setQueryData(BLOG_QUERY_KEYS.tagsList(), tags.map(serializeTag));
+        break;
+      }
+      case "post":
+      case "editPost": {
+        const slug = params?.slug ?? "";
+        if (slug) {
+          const post = await getPostBySlug(adapter, slug);
+          qc.setQueryData(
+            BLOG_QUERY_KEYS.postDetail(slug),
+            post ? serializePost(post) : null
+          );
+        }
+        break;
+      }
+      case "tag": {
+        const tagSlug = params?.tagSlug ?? "";
+        const [result, tags] = await Promise.all([
+          getAllPosts(adapter, { published: true, limit: 10, tagSlug }),
+          getAllTags(adapter)
+        ]);
+        qc.setQueryData(
+          BLOG_QUERY_KEYS.postsList({ published: true, limit: 10, tagSlug }),
+          {
+            pages: [result.items.map(serializePost)],
+            pageParams: [0]
+          }
+        );
+        qc.setQueryData(BLOG_QUERY_KEYS.tagsList(), tags.map(serializeTag));
+        break;
+      }
+    }
+  };
+}
 const PostListQuerySchema = z.object({
   slug: z.string().optional(),
   tagSlug: z.string().optional(),
@@ -27,7 +77,8 @@ const blogBackendPlugin = (hooks) => defineBackendPlugin({
   api: (adapter) => ({
     getAllPosts: (params) => getAllPosts(adapter, params),
     getPostBySlug: (slug) => getPostBySlug(adapter, slug),
-    getAllTags: () => getAllTags(adapter)
+    getAllTags: () => getAllTags(adapter),
+    prefetchForRoute: createBlogPrefetchForRoute(adapter)
   }),
   routes: (adapter) => {
     const findOrCreateTags = async (tagInputs) => {

package/dist/packages/stack/src/plugins/blog/api/query-key-defs.cjs

@@ -0,0 +1,18 @@
+'use strict';
+
+function postsListDiscriminator(params) {
+  return {
+    query: params.query !== void 0 && params.query.trim() === "" ? void 0 : params.query,
+    limit: params.limit ?? 10,
+    published: params.published,
+    tagSlug: params.tagSlug
+  };
+}
+const BLOG_QUERY_KEYS = {
+  postsList: (params) => ["posts", "list", postsListDiscriminator(params)],
+  postDetail: (slug) => ["posts", "detail", slug],
+  tagsList: () => ["tags", "list", "tags"]
+};
+
+exports.BLOG_QUERY_KEYS = BLOG_QUERY_KEYS;
+exports.postsListDiscriminator = postsListDiscriminator;

package/dist/packages/stack/src/plugins/blog/api/query-key-defs.mjs

@@ -0,0 +1,15 @@
+function postsListDiscriminator(params) {
+  return {
+    query: params.query !== void 0 && params.query.trim() === "" ? void 0 : params.query,
+    limit: params.limit ?? 10,
+    published: params.published,
+    tagSlug: params.tagSlug
+  };
+}
+const BLOG_QUERY_KEYS = {
+  postsList: (params) => ["posts", "list", postsListDiscriminator(params)],
+  postDetail: (slug) => ["posts", "detail", slug],
+  tagsList: () => ["tags", "list", "tags"]
+};
+
+export { BLOG_QUERY_KEYS, postsListDiscriminator };

package/dist/packages/stack/src/plugins/blog/api/serializers.cjs

@@ -0,0 +1,21 @@
+'use strict';
+
+function serializeTag(tag) {
+  return {
+    ...tag,
+    createdAt: tag.createdAt.toISOString(),
+    updatedAt: tag.updatedAt.toISOString()
+  };
+}
+function serializePost(post) {
+  return {
+    ...post,
+    createdAt: post.createdAt.toISOString(),
+    updatedAt: post.updatedAt.toISOString(),
+    publishedAt: post.publishedAt?.toISOString(),
+    tags: post.tags.map(serializeTag)
+  };
+}
+
+exports.serializePost = serializePost;
+exports.serializeTag = serializeTag;

package/dist/packages/stack/src/plugins/blog/api/serializers.mjs

@@ -0,0 +1,18 @@
+function serializeTag(tag) {
+  return {
+    ...tag,
+    createdAt: tag.createdAt.toISOString(),
+    updatedAt: tag.updatedAt.toISOString()
+  };
+}
+function serializePost(post) {
+  return {
+    ...post,
+    createdAt: post.createdAt.toISOString(),
+    updatedAt: post.updatedAt.toISOString(),
+    publishedAt: post.publishedAt?.toISOString(),
+    tags: post.tags.map(serializeTag)
+  };
+}
+
+export { serializePost, serializeTag };

package/dist/packages/stack/src/plugins/blog/client/plugin.cjs

@@ -64,6 +64,11 @@ function createPostsLoader(published, config) {
           }
         }
       } catch (error) {
+        if (client.isConnectionError(error)) {
+          console.warn(
+            "[btst/blog] route.loader() failed \u2014 no server running at build time. Use myStack.api.blog.prefetchForRoute() for SSG data prefetching."
+          );
+        }
         if (hooks?.onLoadError) {
           await hooks.onLoadError(error, context);
         }
@@ -112,6 +117,11 @@ function createPostLoader(slug, config, path) {
           }
         }
       } catch (error) {
+        if (client.isConnectionError(error)) {
+          console.warn(
+            "[btst/blog] route.loader() failed \u2014 no server running at build time. Use myStack.api.blog.prefetchForRoute() for SSG data prefetching."
+          );
+        }
         if (hooks?.onLoadError) {
           await hooks.onLoadError(error, context);
         }
@@ -190,6 +200,11 @@ function createTagLoader(tagSlug, config) {
           await hooks.onLoadError(error, context);
         }
       } catch (error) {
+        if (client.isConnectionError(error)) {
+          console.warn(
+            "[btst/blog] route.loader() failed \u2014 no server running at build time. Use myStack.api.blog.prefetchForRoute() for SSG data prefetching."
+          );
+        }
         if (hooks?.onLoadError) {
           await hooks.onLoadError(error, context);
         }

package/dist/packages/stack/src/plugins/blog/client/plugin.mjs

@@ -1,5 +1,5 @@
 import { jsx } from 'react/jsx-runtime';
-import { defineClientPlugin, createApiClient } from '@btst/stack/plugins/client';
+import { defineClientPlugin, createApiClient, isConnectionError } from '@btst/stack/plugins/client';
 import { createRoute } from '@btst/yar';
 import { createBlogQueryKeys } from '../../../../../../plugins/blog/query-keys.mjs';
 import { HomePageComponent } from './components/pages/home-page.mjs';
@@ -62,6 +62,11 @@ function createPostsLoader(published, config) {
           }
         }
       } catch (error) {
+        if (isConnectionError(error)) {
+          console.warn(
+            "[btst/blog] route.loader() failed \u2014 no server running at build time. Use myStack.api.blog.prefetchForRoute() for SSG data prefetching."
+          );
+        }
         if (hooks?.onLoadError) {
           await hooks.onLoadError(error, context);
         }
@@ -110,6 +115,11 @@ function createPostLoader(slug, config, path) {
           }
         }
       } catch (error) {
+        if (isConnectionError(error)) {
+          console.warn(
+            "[btst/blog] route.loader() failed \u2014 no server running at build time. Use myStack.api.blog.prefetchForRoute() for SSG data prefetching."
+          );
+        }
         if (hooks?.onLoadError) {
           await hooks.onLoadError(error, context);
         }
@@ -188,6 +198,11 @@ function createTagLoader(tagSlug, config) {
           await hooks.onLoadError(error, context);
         }
       } catch (error) {
+        if (isConnectionError(error)) {
+          console.warn(
+            "[btst/blog] route.loader() failed \u2014 no server running at build time. Use myStack.api.blog.prefetchForRoute() for SSG data prefetching."
+          );
+        }
         if (hooks?.onLoadError) {
           await hooks.onLoadError(error, context);
         }

package/dist/packages/stack/src/plugins/cms/api/getters.cjs

@@ -105,6 +105,15 @@ async function getAllContentItems(adapter, contentTypeSlug, params) {
     offset: params?.offset
   };
 }
+async function getContentItemById(adapter, id) {
+  const item = await adapter.findOne({
+    model: "contentItem",
+    where: [{ field: "id", value: id, operator: "eq" }],
+    join: { contentType: true }
+  });
+  if (!item) return null;
+  return serializeContentItemWithType(item);
+}
 async function getContentItemBySlug(adapter, contentTypeSlug, slug) {
   const contentType = await adapter.findOne({
     model: "contentType",
@@ -139,6 +148,7 @@ async function getContentItemBySlug(adapter, contentTypeSlug, slug) {
 
 exports.getAllContentItems = getAllContentItems;
 exports.getAllContentTypes = getAllContentTypes;
+exports.getContentItemById = getContentItemById;
 exports.getContentItemBySlug = getContentItemBySlug;
 exports.migrateToUnifiedSchema = migrateToUnifiedSchema;
 exports.serializeContentItem = serializeContentItem;

package/dist/packages/stack/src/plugins/cms/api/getters.mjs

@@ -103,6 +103,15 @@ async function getAllContentItems(adapter, contentTypeSlug, params) {
     offset: params?.offset
   };
 }
+async function getContentItemById(adapter, id) {
+  const item = await adapter.findOne({
+    model: "contentItem",
+    where: [{ field: "id", value: id, operator: "eq" }],
+    join: { contentType: true }
+  });
+  if (!item) return null;
+  return serializeContentItemWithType(item);
+}
 async function getContentItemBySlug(adapter, contentTypeSlug, slug) {
   const contentType = await adapter.findOne({
     model: "contentType",
@@ -135,4 +144,4 @@ async function getContentItemBySlug(adapter, contentTypeSlug, slug) {
   return serializeContentItemWithType(item);
 }
 
-export { getAllContentItems, getAllContentTypes, getContentItemBySlug, migrateToUnifiedSchema, serializeContentItem, serializeContentItemWithType, serializeContentType };
+export { getAllContentItems, getAllContentTypes, getContentItemById, getContentItemBySlug, migrateToUnifiedSchema, serializeContentItem, serializeContentItemWithType, serializeContentType };

package/dist/packages/stack/src/plugins/cms/api/plugin.cjs

@@ -7,6 +7,7 @@ const db = require('../db.cjs');
 const schemas = require('../schemas.cjs');
 const utils = require('../utils.cjs');
 const getters = require('./getters.cjs');
+const queryKeyDefs = require('./query-key-defs.cjs');
 
 async function syncContentTypes(adapter, config) {
   for (const ct of config.contentTypes) {
@@ -243,6 +244,69 @@ const cmsBackendPlugin = (config) => {
     }
     return syncPromise;
   };
+  const getContentTypesWithCounts = async (adapter) => {
+    const contentTypes = await getters.getAllContentTypes(adapter);
+    return Promise.all(
+      contentTypes.map(async (ct) => {
+        const count = await adapter.count({
+          model: "contentItem",
+          where: [
+            { field: "contentTypeId", value: ct.id, operator: "eq" }
+          ]
+        });
+        return { ...ct, itemCount: count };
+      })
+    );
+  };
+  const createCMSPrefetchForRoute = (adapter) => {
+    return async function prefetchForRoute(key, qc, params) {
+      await ensureSynced(adapter);
+      switch (key) {
+        case "dashboard":
+        case "newContent": {
+          const typesWithCounts = await getContentTypesWithCounts(adapter);
+          qc.setQueryData(queryKeyDefs.CMS_QUERY_KEYS.typesList(), typesWithCounts);
+          break;
+        }
+        case "contentList": {
+          const typeSlug = params?.typeSlug ?? "";
+          const [contentTypes, contentItems] = await Promise.all([
+            getContentTypesWithCounts(adapter),
+            getters.getAllContentItems(adapter, typeSlug, { limit: 20, offset: 0 })
+          ]);
+          qc.setQueryData(queryKeyDefs.CMS_QUERY_KEYS.typesList(), contentTypes);
+          qc.setQueryData(
+            queryKeyDefs.CMS_QUERY_KEYS.contentList({ typeSlug, limit: 20, offset: 0 }),
+            {
+              pages: [
+                {
+                  items: contentItems.items,
+                  total: contentItems.total,
+                  limit: contentItems.limit ?? 20,
+                  offset: contentItems.offset ?? 0
+                }
+              ],
+              pageParams: [0]
+            }
+          );
+          break;
+        }
+        case "editContent": {
+          const typeSlug = params?.typeSlug ?? "";
+          const id = params?.id ?? "";
+          const [contentTypes, item] = await Promise.all([
+            getContentTypesWithCounts(adapter),
+            id ? getters.getContentItemById(adapter, id) : Promise.resolve(null)
+          ]);
+          qc.setQueryData(queryKeyDefs.CMS_QUERY_KEYS.typesList(), contentTypes);
+          if (id) {
+            qc.setQueryData(queryKeyDefs.CMS_QUERY_KEYS.contentDetail(typeSlug, id), item);
+          }
+          break;
+        }
+      }
+    };
+  };
   return api.defineBackendPlugin({
     name: "cms",
     dbPlugin: db.cmsSchema,
@@ -258,7 +322,12 @@ const cmsBackendPlugin = (config) => {
       getContentItemBySlug: async (contentTypeSlug, slug) => {
         await ensureSynced(adapter);
         return getters.getContentItemBySlug(adapter, contentTypeSlug, slug);
-      }
+      },
+      getContentItemById: async (id) => {
+        await ensureSynced(adapter);
+        return getters.getContentItemById(adapter, id);
+      },
+      prefetchForRoute: createCMSPrefetchForRoute(adapter)
     }),
     routes: (adapter) => {
       const getContentType = async (slug) => {

package/dist/packages/stack/src/plugins/cms/api/plugin.mjs

@@ -4,7 +4,8 @@ import { formSchemaToZod, zodToFormSchema } from '../../../../../ui/src/lib/sche
 import { cmsSchema } from '../db.mjs';
 import { listContentQuerySchema } from '../schemas.mjs';
 import { slugify } from '../utils.mjs';
-import { serializeContentType, getAllContentItems, serializeContentItemWithType, serializeContentItem, getContentItemBySlug, getAllContentTypes } from './getters.mjs';
+import { serializeContentType, getAllContentItems, serializeContentItemWithType, serializeContentItem, getContentItemById, getContentItemBySlug, getAllContentTypes } from './getters.mjs';
+import { CMS_QUERY_KEYS } from './query-key-defs.mjs';
 
 async function syncContentTypes(adapter, config) {
   for (const ct of config.contentTypes) {
@@ -241,6 +242,69 @@ const cmsBackendPlugin = (config) => {
     }
     return syncPromise;
   };
+  const getContentTypesWithCounts = async (adapter) => {
+    const contentTypes = await getAllContentTypes(adapter);
+    return Promise.all(
+      contentTypes.map(async (ct) => {
+        const count = await adapter.count({
+          model: "contentItem",
+          where: [
+            { field: "contentTypeId", value: ct.id, operator: "eq" }
+          ]
+        });
+        return { ...ct, itemCount: count };
+      })
+    );
+  };
+  const createCMSPrefetchForRoute = (adapter) => {
+    return async function prefetchForRoute(key, qc, params) {
+      await ensureSynced(adapter);
+      switch (key) {
+        case "dashboard":
+        case "newContent": {
+          const typesWithCounts = await getContentTypesWithCounts(adapter);
+          qc.setQueryData(CMS_QUERY_KEYS.typesList(), typesWithCounts);
+          break;
+        }
+        case "contentList": {
+          const typeSlug = params?.typeSlug ?? "";
+          const [contentTypes, contentItems] = await Promise.all([
+            getContentTypesWithCounts(adapter),
+            getAllContentItems(adapter, typeSlug, { limit: 20, offset: 0 })
+          ]);
+          qc.setQueryData(CMS_QUERY_KEYS.typesList(), contentTypes);
+          qc.setQueryData(
+            CMS_QUERY_KEYS.contentList({ typeSlug, limit: 20, offset: 0 }),
+            {
+              pages: [
+                {
+                  items: contentItems.items,
+                  total: contentItems.total,
+                  limit: contentItems.limit ?? 20,
+                  offset: contentItems.offset ?? 0
+                }
+              ],
+              pageParams: [0]
+            }
+          );
+          break;
+        }
+        case "editContent": {
+          const typeSlug = params?.typeSlug ?? "";
+          const id = params?.id ?? "";
+          const [contentTypes, item] = await Promise.all([
+            getContentTypesWithCounts(adapter),
+            id ? getContentItemById(adapter, id) : Promise.resolve(null)
+          ]);
+          qc.setQueryData(CMS_QUERY_KEYS.typesList(), contentTypes);
+          if (id) {
+            qc.setQueryData(CMS_QUERY_KEYS.contentDetail(typeSlug, id), item);
+          }
+          break;
+        }
+      }
+    };
+  };
   return defineBackendPlugin({
     name: "cms",
     dbPlugin: cmsSchema,
@@ -256,7 +320,12 @@ const cmsBackendPlugin = (config) => {
       getContentItemBySlug: async (contentTypeSlug, slug) => {
         await ensureSynced(adapter);
         return getContentItemBySlug(adapter, contentTypeSlug, slug);
-      }
+      },
+      getContentItemById: async (id) => {
+        await ensureSynced(adapter);
+        return getContentItemById(adapter, id);
+      },
+      prefetchForRoute: createCMSPrefetchForRoute(adapter)
     }),
     routes: (adapter) => {
       const getContentType = async (slug) => {

package/dist/packages/stack/src/plugins/cms/api/query-key-defs.cjs

@@ -0,0 +1,29 @@
+'use strict';
+
+function contentListDiscriminator(params) {
+  return {
+    typeSlug: params.typeSlug,
+    limit: params.limit ?? 20,
+    offset: params.offset ?? 0
+  };
+}
+const CMS_QUERY_KEYS = {
+  /**
+   * Key for the cmsTypes.list() query.
+   * Full key: ["cmsTypes", "list", "list"]
+   */
+  typesList: () => ["cmsTypes", "list", "list"],
+  /**
+   * Key for the cmsContent.list({ typeSlug, limit, offset }) query.
+   * Full key: ["cmsContent", "list", { typeSlug, limit, offset }]
+   */
+  contentList: (params) => ["cmsContent", "list", contentListDiscriminator(params)],
+  /**
+   * Key for the cmsContent.detail(typeSlug, id) query.
+   * Full key: ["cmsContent", "detail", typeSlug, id]
+   */
+  contentDetail: (typeSlug, id) => ["cmsContent", "detail", typeSlug, id]
+};
+
+exports.CMS_QUERY_KEYS = CMS_QUERY_KEYS;
+exports.contentListDiscriminator = contentListDiscriminator;

package/dist/packages/stack/src/plugins/cms/api/query-key-defs.mjs

@@ -0,0 +1,26 @@
+function contentListDiscriminator(params) {
+  return {
+    typeSlug: params.typeSlug,
+    limit: params.limit ?? 20,
+    offset: params.offset ?? 0
+  };
+}
+const CMS_QUERY_KEYS = {
+  /**
+   * Key for the cmsTypes.list() query.
+   * Full key: ["cmsTypes", "list", "list"]
+   */
+  typesList: () => ["cmsTypes", "list", "list"],
+  /**
+   * Key for the cmsContent.list({ typeSlug, limit, offset }) query.
+   * Full key: ["cmsContent", "list", { typeSlug, limit, offset }]
+   */
+  contentList: (params) => ["cmsContent", "list", contentListDiscriminator(params)],
+  /**
+   * Key for the cmsContent.detail(typeSlug, id) query.
+   * Full key: ["cmsContent", "detail", typeSlug, id]
+   */
+  contentDetail: (typeSlug, id) => ["cmsContent", "detail", typeSlug, id]
+};
+
+export { CMS_QUERY_KEYS, contentListDiscriminator };

package/dist/packages/stack/src/plugins/cms/client/plugin.cjs

@@ -56,6 +56,11 @@ function createDashboardLoader(config) {
           await hooks.onLoadError(error, context);
         }
       } catch (error) {
+        if (client.isConnectionError(error)) {
+          console.warn(
+            "[btst/cms] route.loader() failed \u2014 no server running at build time. Use myStack.api.cms.prefetchForRoute() for SSG data prefetching."
+          );
+        }
         if (hooks?.onLoadError) {
           await hooks.onLoadError(error, context);
         }
@@ -123,6 +128,11 @@ function createContentListLoader(typeSlug, config) {
           await hooks.onLoadError(error, context);
         }
       } catch (error) {
+        if (client.isConnectionError(error)) {
+          console.warn(
+            "[btst/cms] route.loader() failed \u2014 no server running at build time. Use myStack.api.cms.prefetchForRoute() for SSG data prefetching."
+          );
+        }
         if (hooks?.onLoadError) {
           await hooks.onLoadError(error, context);
         }
@@ -180,6 +190,11 @@ function createContentEditorLoader(typeSlug, id, config) {
           await hooks.onLoadError(error, context);
         }
       } catch (error) {
+        if (client.isConnectionError(error)) {
+          console.warn(
+            "[btst/cms] route.loader() failed \u2014 no server running at build time. Use myStack.api.cms.prefetchForRoute() for SSG data prefetching."
+          );
+        }
         if (hooks?.onLoadError) {
           await hooks.onLoadError(error, context);
         }

package/dist/packages/stack/src/plugins/cms/client/plugin.mjs

@@ -1,6 +1,6 @@
 import { jsx } from 'react/jsx-runtime';
 import { lazy } from 'react';
-import { defineClientPlugin, createApiClient } from '@btst/stack/plugins/client';
+import { defineClientPlugin, createApiClient, isConnectionError } from '@btst/stack/plugins/client';
 import { createRoute } from '@btst/yar';
 import { createCMSQueryKeys } from '../../../../../../plugins/cms/query-keys.mjs';
 
@@ -54,6 +54,11 @@ function createDashboardLoader(config) {
           await hooks.onLoadError(error, context);
         }
       } catch (error) {
+        if (isConnectionError(error)) {
+          console.warn(
+            "[btst/cms] route.loader() failed \u2014 no server running at build time. Use myStack.api.cms.prefetchForRoute() for SSG data prefetching."
+          );
+        }
         if (hooks?.onLoadError) {
           await hooks.onLoadError(error, context);
         }
@@ -121,6 +126,11 @@ function createContentListLoader(typeSlug, config) {
           await hooks.onLoadError(error, context);
         }
       } catch (error) {
+        if (isConnectionError(error)) {
+          console.warn(
+            "[btst/cms] route.loader() failed \u2014 no server running at build time. Use myStack.api.cms.prefetchForRoute() for SSG data prefetching."
+          );
+        }
         if (hooks?.onLoadError) {
           await hooks.onLoadError(error, context);
         }
@@ -178,6 +188,11 @@ function createContentEditorLoader(typeSlug, id, config) {
           await hooks.onLoadError(error, context);
         }
       } catch (error) {
+        if (isConnectionError(error)) {
+          console.warn(
+            "[btst/cms] route.loader() failed \u2014 no server running at build time. Use myStack.api.cms.prefetchForRoute() for SSG data prefetching."
+          );
+        }
         if (hooks?.onLoadError) {
           await hooks.onLoadError(error, context);
         }