@btst/stack 2.3.0 → 2.5.0

package/dist/packages/stack/src/plugins/blog/client/components/forms/post-forms.cjs

@@ -250,9 +250,14 @@ const CustomPostUpdateSchema = schemas.updatePostSchema.omit({
 const addPostFormPropsAreEqual = (prevProps, nextProps) => {
   if (prevProps.onClose !== nextProps.onClose) return false;
   if (prevProps.onSuccess !== nextProps.onSuccess) return false;
+  if (prevProps.onFormReady !== nextProps.onFormReady) return false;
   return true;
 };
-const AddPostFormComponent = ({ onClose, onSuccess }) => {
+const AddPostFormComponent = ({
+  onClose,
+  onSuccess,
+  onFormReady
+}) => {
   const [featuredImageUploading, setFeaturedImageUploading] = React.useState(false);
   const { localization } = context.usePluginOverrides("blog", {
     localization: index.BLOG_LOCALIZATION
@@ -290,6 +295,9 @@ const AddPostFormComponent = ({ onClose, onSuccess }) => {
       tags: []
     }
   });
+  React.useEffect(() => {
+    onFormReady?.(form);
+  }, []);
   return /* @__PURE__ */ jsxRuntime.jsx(
     PostFormBody,
     {
@@ -309,13 +317,15 @@ const editPostFormPropsAreEqual = (prevProps, nextProps) => {
   if (prevProps.onClose !== nextProps.onClose) return false;
   if (prevProps.onSuccess !== nextProps.onSuccess) return false;
   if (prevProps.onDelete !== nextProps.onDelete) return false;
+  if (prevProps.onFormReady !== nextProps.onFormReady) return false;
   return true;
 };
 const EditPostFormComponent = ({
   postSlug,
   onClose,
   onSuccess,
-  onDelete
+  onDelete,
+  onFormReady
 }) => {
   const [featuredImageUploading, setFeaturedImageUploading] = React.useState(false);
   const [deleteDialogOpen, setDeleteDialogOpen] = React.useState(false);
@@ -391,6 +401,9 @@ const EditPostFormComponent = ({
     },
     values: initialData
   });
+  React.useEffect(() => {
+    onFormReady?.(form);
+  }, []);
   if (!post) {
     return /* @__PURE__ */ jsxRuntime.jsx(emptyList.EmptyList, { message: localization.BLOG_PAGE_NOT_FOUND_DESCRIPTION });
   }

package/dist/packages/stack/src/plugins/blog/client/components/forms/post-forms.mjs

@@ -11,7 +11,7 @@ import { slugify } from '../../../utils.mjs';
 import { AlertDialog, AlertDialogTrigger, AlertDialogContent, AlertDialogHeader, AlertDialogTitle, AlertDialogDescription, AlertDialogFooter, AlertDialogCancel, AlertDialogAction } from '../../../../../../../ui/src/components/alert-dialog.mjs';
 import { zodResolver } from '@hookform/resolvers/zod';
 import { Loader2 } from 'lucide-react';
-import { memo, useState, useMemo, Suspense, lazy } from 'react';
+import { memo, useState, useEffect, useMemo, Suspense, lazy } from 'react';
 import { useForm } from 'react-hook-form';
 import { toast } from 'sonner';
 import { FeaturedImageField } from './image-field.mjs';
@@ -248,9 +248,14 @@ const CustomPostUpdateSchema = updatePostSchema.omit({
 const addPostFormPropsAreEqual = (prevProps, nextProps) => {
   if (prevProps.onClose !== nextProps.onClose) return false;
   if (prevProps.onSuccess !== nextProps.onSuccess) return false;
+  if (prevProps.onFormReady !== nextProps.onFormReady) return false;
   return true;
 };
-const AddPostFormComponent = ({ onClose, onSuccess }) => {
+const AddPostFormComponent = ({
+  onClose,
+  onSuccess,
+  onFormReady
+}) => {
   const [featuredImageUploading, setFeaturedImageUploading] = useState(false);
   const { localization } = usePluginOverrides("blog", {
     localization: BLOG_LOCALIZATION
@@ -288,6 +293,9 @@ const AddPostFormComponent = ({ onClose, onSuccess }) => {
       tags: []
     }
   });
+  useEffect(() => {
+    onFormReady?.(form);
+  }, []);
   return /* @__PURE__ */ jsx(
     PostFormBody,
     {
@@ -307,13 +315,15 @@ const editPostFormPropsAreEqual = (prevProps, nextProps) => {
   if (prevProps.onClose !== nextProps.onClose) return false;
   if (prevProps.onSuccess !== nextProps.onSuccess) return false;
   if (prevProps.onDelete !== nextProps.onDelete) return false;
+  if (prevProps.onFormReady !== nextProps.onFormReady) return false;
   return true;
 };
 const EditPostFormComponent = ({
   postSlug,
   onClose,
   onSuccess,
-  onDelete
+  onDelete,
+  onFormReady
 }) => {
   const [featuredImageUploading, setFeaturedImageUploading] = useState(false);
   const [deleteDialogOpen, setDeleteDialogOpen] = useState(false);
@@ -389,6 +399,9 @@ const EditPostFormComponent = ({
     },
     values: initialData
   });
+  useEffect(() => {
+    onFormReady?.(form);
+  }, []);
   if (!post) {
     return /* @__PURE__ */ jsx(EmptyList, { message: localization.BLOG_PAGE_NOT_FOUND_DESCRIPTION });
   }

package/dist/packages/stack/src/plugins/blog/client/components/pages/edit-post-page.internal.cjs

@@ -8,6 +8,9 @@ const pageHeader = require('../shared/page-header.cjs');
 const pageWrapper = require('../shared/page-wrapper.cjs');
 const index = require('../../localization/index.cjs');
 const useRouteLifecycle = require('../../../../../../../ui/src/hooks/use-route-lifecycle.cjs');
+const context$1 = require('@btst/stack/plugins/ai-chat/client/context');
+const React = require('react');
+const fillBlogFormHandler = require('./fill-blog-form-handler.cjs');
 
 function EditPostPage({ slug }) {
   const overrides = context.usePluginOverrides("blog", {
@@ -30,6 +33,25 @@ function EditPostPage({ slug }) {
       return true;
     }
   });
+  const formRef = React.useRef(null);
+  const handleFormReady = React.useCallback((form) => {
+    formRef.current = form;
+  }, []);
+  context$1.useRegisterPageAIContext({
+    routeName: "blog-edit-post",
+    pageDescription: `User is editing a blog post (slug: "${slug}") in the admin editor.`,
+    suggestions: [
+      "Improve this post's title",
+      "Rewrite the intro paragraph",
+      "Suggest better tags"
+    ],
+    clientTools: {
+      fillBlogForm: fillBlogFormHandler.createFillBlogFormHandler(
+        formRef,
+        "Form updated successfully"
+      )
+    }
+  });
   const handleClose = () => {
     navigate(`${basePath}/blog`);
   };
@@ -53,7 +75,8 @@ function EditPostPage({ slug }) {
         postSlug: slug,
         onClose: handleClose,
         onSuccess: handleSuccess,
-        onDelete: handleDelete
+        onDelete: handleDelete,
+        onFormReady: handleFormReady
       }
     )
   ] });

package/dist/packages/stack/src/plugins/blog/client/components/pages/edit-post-page.internal.mjs

@@ -6,6 +6,9 @@ import { PageHeader } from '../shared/page-header.mjs';
 import { PageWrapper } from '../shared/page-wrapper.mjs';
 import { BLOG_LOCALIZATION } from '../../localization/index.mjs';
 import { useRouteLifecycle } from '../../../../../../../ui/src/hooks/use-route-lifecycle.mjs';
+import { useRegisterPageAIContext } from '@btst/stack/plugins/ai-chat/client/context';
+import { useRef, useCallback } from 'react';
+import { createFillBlogFormHandler } from './fill-blog-form-handler.mjs';
 
 function EditPostPage({ slug }) {
   const overrides = usePluginOverrides("blog", {
@@ -28,6 +31,25 @@ function EditPostPage({ slug }) {
       return true;
     }
   });
+  const formRef = useRef(null);
+  const handleFormReady = useCallback((form) => {
+    formRef.current = form;
+  }, []);
+  useRegisterPageAIContext({
+    routeName: "blog-edit-post",
+    pageDescription: `User is editing a blog post (slug: "${slug}") in the admin editor.`,
+    suggestions: [
+      "Improve this post's title",
+      "Rewrite the intro paragraph",
+      "Suggest better tags"
+    ],
+    clientTools: {
+      fillBlogForm: createFillBlogFormHandler(
+        formRef,
+        "Form updated successfully"
+      )
+    }
+  });
   const handleClose = () => {
     navigate(`${basePath}/blog`);
   };
@@ -51,7 +73,8 @@ function EditPostPage({ slug }) {
         postSlug: slug,
         onClose: handleClose,
         onSuccess: handleSuccess,
-        onDelete: handleDelete
+        onDelete: handleDelete,
+        onFormReady: handleFormReady
       }
     )
   ] });

package/dist/packages/stack/src/plugins/blog/client/components/pages/fill-blog-form-handler.cjs

@@ -0,0 +1,26 @@
+'use strict';
+
+function createFillBlogFormHandler(formRef, successMessage) {
+  return async ({
+    title,
+    content,
+    excerpt,
+    tags
+  }) => {
+    const form = formRef.current;
+    if (!form) return { success: false, message: "Form not ready" };
+    if (title !== void 0)
+      form.setValue("title", title, { shouldValidate: true });
+    if (content !== void 0)
+      form.setValue("content", content, { shouldValidate: true });
+    if (excerpt !== void 0) form.setValue("excerpt", excerpt);
+    if (tags !== void 0)
+      form.setValue(
+        "tags",
+        tags.map((name) => ({ name }))
+      );
+    return { success: true, message: successMessage };
+  };
+}
+
+exports.createFillBlogFormHandler = createFillBlogFormHandler;

package/dist/packages/stack/src/plugins/blog/client/components/pages/fill-blog-form-handler.mjs

@@ -0,0 +1,24 @@
+function createFillBlogFormHandler(formRef, successMessage) {
+  return async ({
+    title,
+    content,
+    excerpt,
+    tags
+  }) => {
+    const form = formRef.current;
+    if (!form) return { success: false, message: "Form not ready" };
+    if (title !== void 0)
+      form.setValue("title", title, { shouldValidate: true });
+    if (content !== void 0)
+      form.setValue("content", content, { shouldValidate: true });
+    if (excerpt !== void 0) form.setValue("excerpt", excerpt);
+    if (tags !== void 0)
+      form.setValue(
+        "tags",
+        tags.map((name) => ({ name }))
+      );
+    return { success: true, message: successMessage };
+  };
+}
+
+export { createFillBlogFormHandler };

package/dist/packages/stack/src/plugins/blog/client/components/pages/new-post-page.internal.cjs

@@ -8,6 +8,9 @@ const pageHeader = require('../shared/page-header.cjs');
 const pageWrapper = require('../shared/page-wrapper.cjs');
 const index = require('../../localization/index.cjs');
 const useRouteLifecycle = require('../../../../../../../ui/src/hooks/use-route-lifecycle.cjs');
+const context$1 = require('@btst/stack/plugins/ai-chat/client/context');
+const React = require('react');
+const fillBlogFormHandler = require('./fill-blog-form-handler.cjs');
 
 function NewPostPage() {
   const overrides = context.usePluginOverrides("blog", {
@@ -29,6 +32,25 @@ function NewPostPage() {
       return true;
     }
   });
+  const formRef = React.useRef(null);
+  const handleFormReady = React.useCallback((form) => {
+    formRef.current = form;
+  }, []);
+  context$1.useRegisterPageAIContext({
+    routeName: "blog-new-post",
+    pageDescription: "User is creating a new blog post in the admin editor. IMPORTANT: When asked to write, draft, or create a blog post, you MUST call the fillBlogForm tool to populate the form fields directly \u2014 do NOT just output the text in your response.",
+    suggestions: [
+      "Write a post about AI trends",
+      "Draft an intro paragraph",
+      "Suggest 5 tags for this post"
+    ],
+    clientTools: {
+      fillBlogForm: fillBlogFormHandler.createFillBlogFormHandler(
+        formRef,
+        "Form filled successfully"
+      )
+    }
+  });
   const handleClose = () => {
     navigate(`${basePath}/blog`);
   };
@@ -47,7 +69,14 @@ function NewPostPage() {
         description: localization.BLOG_POST_ADD_DESCRIPTION
       }
     ),
-    /* @__PURE__ */ jsxRuntime.jsx(postForms.AddPostForm, { onClose: handleClose, onSuccess: handleSuccess })
+    /* @__PURE__ */ jsxRuntime.jsx(
+      postForms.AddPostForm,
+      {
+        onClose: handleClose,
+        onSuccess: handleSuccess,
+        onFormReady: handleFormReady
+      }
+    )
   ] });
 }
 

package/dist/packages/stack/src/plugins/blog/client/components/pages/new-post-page.internal.mjs

@@ -6,6 +6,9 @@ import { PageHeader } from '../shared/page-header.mjs';
 import { PageWrapper } from '../shared/page-wrapper.mjs';
 import { BLOG_LOCALIZATION } from '../../localization/index.mjs';
 import { useRouteLifecycle } from '../../../../../../../ui/src/hooks/use-route-lifecycle.mjs';
+import { useRegisterPageAIContext } from '@btst/stack/plugins/ai-chat/client/context';
+import { useRef, useCallback } from 'react';
+import { createFillBlogFormHandler } from './fill-blog-form-handler.mjs';
 
 function NewPostPage() {
   const overrides = usePluginOverrides("blog", {
@@ -27,6 +30,25 @@ function NewPostPage() {
       return true;
     }
   });
+  const formRef = useRef(null);
+  const handleFormReady = useCallback((form) => {
+    formRef.current = form;
+  }, []);
+  useRegisterPageAIContext({
+    routeName: "blog-new-post",
+    pageDescription: "User is creating a new blog post in the admin editor. IMPORTANT: When asked to write, draft, or create a blog post, you MUST call the fillBlogForm tool to populate the form fields directly \u2014 do NOT just output the text in your response.",
+    suggestions: [
+      "Write a post about AI trends",
+      "Draft an intro paragraph",
+      "Suggest 5 tags for this post"
+    ],
+    clientTools: {
+      fillBlogForm: createFillBlogFormHandler(
+        formRef,
+        "Form filled successfully"
+      )
+    }
+  });
   const handleClose = () => {
     navigate(`${basePath}/blog`);
   };
@@ -45,7 +67,14 @@ function NewPostPage() {
         description: localization.BLOG_POST_ADD_DESCRIPTION
       }
     ),
-    /* @__PURE__ */ jsx(AddPostForm, { onClose: handleClose, onSuccess: handleSuccess })
+    /* @__PURE__ */ jsx(
+      AddPostForm,
+      {
+        onClose: handleClose,
+        onSuccess: handleSuccess,
+        onFormReady: handleFormReady
+      }
+    )
   ] });
 }
 

package/dist/packages/stack/src/plugins/blog/client/components/pages/post-page.internal.cjs

@@ -16,6 +16,7 @@ const recentPostsCarousel = require('../shared/recent-posts-carousel.cjs');
 const badge = require('../../../../../../../ui/src/components/badge.cjs');
 const useRouteLifecycle = require('../../../../../../../ui/src/hooks/use-route-lifecycle.cjs');
 const onThisPage = require('../shared/on-this-page.cjs');
+const context$1 = require('@btst/stack/plugins/ai-chat/client/context');
 
 function PostPage({ slug }) {
   const overrides = context.usePluginOverrides("blog", {
@@ -50,6 +51,23 @@ function PostPage({ slug }) {
     excludeSlug: slug,
     enabled: !!post
   });
+  context$1.useRegisterPageAIContext(
+    post ? {
+      routeName: "blog-post",
+      pageDescription: `Blog post: "${post.title}"
+Author: ${post.authorId ?? "Unknown"}
+
+${post.content ?? ""}`.slice(
+        0,
+        16e3
+      ),
+      suggestions: [
+        "Summarize this post",
+        "What are the key takeaways?",
+        "Explain this in simpler terms"
+      ]
+    } : null
+  );
   if (!slug || !post) {
     return /* @__PURE__ */ jsxRuntime.jsx(pageWrapper.PageWrapper, { children: /* @__PURE__ */ jsxRuntime.jsx(emptyList.EmptyList, { message: localization.BLOG_PAGE_NOT_FOUND_DESCRIPTION }) });
   }

package/dist/packages/stack/src/plugins/blog/client/components/pages/post-page.internal.mjs

@@ -14,6 +14,7 @@ import { RecentPostsCarousel } from '../shared/recent-posts-carousel.mjs';
 import { Badge } from '../../../../../../../ui/src/components/badge.mjs';
 import { useRouteLifecycle } from '../../../../../../../ui/src/hooks/use-route-lifecycle.mjs';
 import { OnThisPageSelect, OnThisPage } from '../shared/on-this-page.mjs';
+import { useRegisterPageAIContext } from '@btst/stack/plugins/ai-chat/client/context';
 
 function PostPage({ slug }) {
   const overrides = usePluginOverrides("blog", {
@@ -48,6 +49,23 @@ function PostPage({ slug }) {
     excludeSlug: slug,
     enabled: !!post
   });
+  useRegisterPageAIContext(
+    post ? {
+      routeName: "blog-post",
+      pageDescription: `Blog post: "${post.title}"
+Author: ${post.authorId ?? "Unknown"}
+
+${post.content ?? ""}`.slice(
+        0,
+        16e3
+      ),
+      suggestions: [
+        "Summarize this post",
+        "What are the key takeaways?",
+        "Explain this in simpler terms"
+      ]
+    } : null
+  );
   if (!slug || !post) {
     return /* @__PURE__ */ jsx(PageWrapper, { children: /* @__PURE__ */ jsx(EmptyList, { message: localization.BLOG_PAGE_NOT_FOUND_DESCRIPTION }) });
   }

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

@@ -23,10 +23,10 @@ function createPostsLoader(published, config) {
       };
       try {
         if (hooks?.beforeLoadPosts) {
-          const canLoad = await hooks.beforeLoadPosts({ published }, context);
-          if (!canLoad) {
-            throw new Error("Load prevented by beforeLoadPosts hook");
-          }
+          await client.runClientHookWithShim(
+            () => hooks.beforeLoadPosts({ published }, context),
+            "Load prevented by beforeLoadPosts hook"
+          );
         }
         const limit = 10;
         const client$1 = client.createApiClient({
@@ -47,14 +47,10 @@ function createPostsLoader(published, config) {
         await queryClient.prefetchQuery(tagsQuery);
         if (hooks?.afterLoadPosts) {
           const posts = queryClient.getQueryData(listQuery.queryKey) || null;
-          const canContinue = await hooks.afterLoadPosts(
-            posts,
-            { published },
-            context
+          await client.runClientHookWithShim(
+            () => hooks.afterLoadPosts(posts, { published }, context),
+            "Load prevented by afterLoadPosts hook"
           );
-          if (canContinue === false) {
-            throw new Error("Load prevented by afterLoadPosts hook");
-          }
         }
         const queryState = queryClient.getQueryState(listQuery.queryKey);
         if (queryState?.error) {
@@ -90,10 +86,10 @@ function createPostLoader(slug, config, path) {
       };
       try {
         if (hooks?.beforeLoadPost) {
-          const canLoad = await hooks.beforeLoadPost(slug, context);
-          if (!canLoad) {
-            throw new Error("Load prevented by beforeLoadPost hook");
-          }
+          await client.runClientHookWithShim(
+            () => hooks.beforeLoadPost(slug, context),
+            "Load prevented by beforeLoadPost hook"
+          );
         }
         const client$1 = client.createApiClient({
           baseURL: apiBaseURL,
@@ -104,10 +100,10 @@ function createPostLoader(slug, config, path) {
         await queryClient.prefetchQuery(postQuery);
         if (hooks?.afterLoadPost) {
           const post = queryClient.getQueryData(postQuery.queryKey) || null;
-          const canContinue = await hooks.afterLoadPost(post, slug, context);
-          if (canContinue === false) {
-            throw new Error("Load prevented by afterLoadPost hook");
-          }
+          await client.runClientHookWithShim(
+            () => hooks.afterLoadPost(post, slug, context),
+            "Load prevented by afterLoadPost hook"
+          );
         }
         const queryState = queryClient.getQueryState(postQuery.queryKey);
         if (queryState?.error) {
@@ -142,16 +138,16 @@ function createNewPostLoader(config) {
       };
       try {
         if (hooks?.beforeLoadNewPost) {
-          const canLoad = await hooks.beforeLoadNewPost(context);
-          if (!canLoad) {
-            throw new Error("Load prevented by beforeLoadNewPost hook");
-          }
+          await client.runClientHookWithShim(
+            () => hooks.beforeLoadNewPost(context),
+            "Load prevented by beforeLoadNewPost hook"
+          );
         }
         if (hooks?.afterLoadNewPost) {
-          const canContinue = await hooks.afterLoadNewPost(context);
-          if (canContinue === false) {
-            throw new Error("Load prevented by afterLoadNewPost hook");
-          }
+          await client.runClientHookWithShim(
+            () => hooks.afterLoadNewPost(context),
+            "Load prevented by afterLoadNewPost hook"
+          );
         }
       } catch (error) {
         if (hooks?.onLoadError) {

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

@@ -1,5 +1,5 @@
 import { jsx } from 'react/jsx-runtime';
-import { defineClientPlugin, createApiClient, isConnectionError } from '@btst/stack/plugins/client';
+import { defineClientPlugin, createApiClient, runClientHookWithShim, 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';
@@ -21,10 +21,10 @@ function createPostsLoader(published, config) {
       };
       try {
         if (hooks?.beforeLoadPosts) {
-          const canLoad = await hooks.beforeLoadPosts({ published }, context);
-          if (!canLoad) {
-            throw new Error("Load prevented by beforeLoadPosts hook");
-          }
+          await runClientHookWithShim(
+            () => hooks.beforeLoadPosts({ published }, context),
+            "Load prevented by beforeLoadPosts hook"
+          );
         }
         const limit = 10;
         const client = createApiClient({
@@ -45,14 +45,10 @@ function createPostsLoader(published, config) {
         await queryClient.prefetchQuery(tagsQuery);
         if (hooks?.afterLoadPosts) {
           const posts = queryClient.getQueryData(listQuery.queryKey) || null;
-          const canContinue = await hooks.afterLoadPosts(
-            posts,
-            { published },
-            context
+          await runClientHookWithShim(
+            () => hooks.afterLoadPosts(posts, { published }, context),
+            "Load prevented by afterLoadPosts hook"
           );
-          if (canContinue === false) {
-            throw new Error("Load prevented by afterLoadPosts hook");
-          }
         }
         const queryState = queryClient.getQueryState(listQuery.queryKey);
         if (queryState?.error) {
@@ -88,10 +84,10 @@ function createPostLoader(slug, config, path) {
       };
       try {
         if (hooks?.beforeLoadPost) {
-          const canLoad = await hooks.beforeLoadPost(slug, context);
-          if (!canLoad) {
-            throw new Error("Load prevented by beforeLoadPost hook");
-          }
+          await runClientHookWithShim(
+            () => hooks.beforeLoadPost(slug, context),
+            "Load prevented by beforeLoadPost hook"
+          );
         }
         const client = createApiClient({
           baseURL: apiBaseURL,
@@ -102,10 +98,10 @@ function createPostLoader(slug, config, path) {
         await queryClient.prefetchQuery(postQuery);
         if (hooks?.afterLoadPost) {
           const post = queryClient.getQueryData(postQuery.queryKey) || null;
-          const canContinue = await hooks.afterLoadPost(post, slug, context);
-          if (canContinue === false) {
-            throw new Error("Load prevented by afterLoadPost hook");
-          }
+          await runClientHookWithShim(
+            () => hooks.afterLoadPost(post, slug, context),
+            "Load prevented by afterLoadPost hook"
+          );
         }
         const queryState = queryClient.getQueryState(postQuery.queryKey);
         if (queryState?.error) {
@@ -140,16 +136,16 @@ function createNewPostLoader(config) {
       };
       try {
         if (hooks?.beforeLoadNewPost) {
-          const canLoad = await hooks.beforeLoadNewPost(context);
-          if (!canLoad) {
-            throw new Error("Load prevented by beforeLoadNewPost hook");
-          }
+          await runClientHookWithShim(
+            () => hooks.beforeLoadNewPost(context),
+            "Load prevented by beforeLoadNewPost hook"
+          );
         }
         if (hooks?.afterLoadNewPost) {
-          const canContinue = await hooks.afterLoadNewPost(context);
-          if (canContinue === false) {
-            throw new Error("Load prevented by afterLoadNewPost hook");
-          }
+          await runClientHookWithShim(
+            () => hooks.afterLoadNewPost(context),
+            "Load prevented by afterLoadNewPost hook"
+          );
         }
       } catch (error) {
         if (hooks?.onLoadError) {

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

@@ -0,0 +1,48 @@
+'use strict';
+
+const getters = require('./getters.cjs');
+
+async function createCMSContentItem(adapter, contentTypeSlug, input) {
+  const contentType = await adapter.findOne({
+    model: "contentType",
+    where: [
+      {
+        field: "slug",
+        value: contentTypeSlug,
+        operator: "eq"
+      }
+    ]
+  });
+  if (!contentType) {
+    throw new Error(`Content type "${contentTypeSlug}" not found`);
+  }
+  const existing = await adapter.findOne({
+    model: "contentItem",
+    where: [
+      {
+        field: "contentTypeId",
+        value: contentType.id,
+        operator: "eq"
+      },
+      { field: "slug", value: input.slug, operator: "eq" }
+    ]
+  });
+  if (existing) {
+    throw new Error(
+      `Content item with slug "${input.slug}" already exists in type "${contentTypeSlug}"`
+    );
+  }
+  const item = await adapter.create({
+    model: "contentItem",
+    data: {
+      contentTypeId: contentType.id,
+      slug: input.slug,
+      data: JSON.stringify(input.data),
+      createdAt: /* @__PURE__ */ new Date(),
+      updatedAt: /* @__PURE__ */ new Date()
+    }
+  });
+  return getters.serializeContentItem(item);
+}
+
+exports.createCMSContentItem = createCMSContentItem;