@btst/stack 2.11.1 → 2.11.2

package/dist/shared/{stack.DGsFF5qb.d.cts → stack.DOZ1EXjM.d.mts}

@@ -1,5 +1,5 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
-import { S as SerializedPost, c as createPostSchema, u as updatePostSchema, a as SerializedTag } from './stack.Sod_PZhB.cjs';
+import { S as SerializedPost, c as createPostSchema, u as updatePostSchema, a as SerializedTag } from './stack.BWp0hcm9.mjs';
 import { z } from 'zod';
 
 /**
@@ -128,10 +128,6 @@ declare function useSuspenseTags(): {
 };
 /** Create a new post */
 declare function useCreatePost(): _tanstack_react_query.UseMutationResult<SerializedPost | null, Error, {
-    published: boolean;
-    title: string;
-    content: string;
-    excerpt: string;
     tags: ({
         name: string;
     } | {
@@ -139,6 +135,10 @@ declare function useCreatePost(): _tanstack_react_query.UseMutationResult<Serial
         name: string;
         slug: string;
     })[];
+    published: boolean;
+    title: string;
+    content: string;
+    excerpt: string;
     slug?: string | undefined;
     publishedAt?: Date | undefined;
     createdAt?: Date | undefined;

package/dist/shared/{stack.qta0-CPq.d.ts → stack.DWipT53I.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.Sod_PZhB.js';
+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';
@@ -67,6 +67,86 @@ declare function getPostBySlug(adapter: DBAdapter, slug: string): Promise<(Post
  */
 declare function getAllTags(adapter: DBAdapter): Promise<Tag[]>;
 
+type TagInput = {
+    name: string;
+} | {
+    id: string;
+    name: string;
+    slug: string;
+};
+/**
+ * Input for creating a new blog post.
+ * `slug` must already be slugified by the caller.
+ */
+interface CreatePostInput {
+    title: string;
+    content: string;
+    excerpt: string;
+    /** Pre-slugified URL slug — use {@link slugify} before passing. */
+    slug: string;
+    image?: string;
+    published?: boolean;
+    publishedAt?: Date;
+    createdAt?: Date;
+    updatedAt?: Date;
+    tags?: TagInput[];
+}
+/**
+ * Input for updating an existing blog post.
+ * If `slug` is provided it must already be slugified by the caller.
+ */
+interface UpdatePostInput {
+    title?: string;
+    content?: string;
+    excerpt?: string;
+    /** Pre-slugified URL slug — use {@link slugify} before passing. */
+    slug?: string;
+    image?: string;
+    published?: boolean;
+    publishedAt?: Date;
+    createdAt?: Date;
+    updatedAt?: Date;
+    tags?: TagInput[];
+}
+/**
+ * Create a new blog post with optional tag associations.
+ * Pure DB function — no hooks, no HTTP context. Safe for server-side and SSG use.
+ *
+ * @remarks **Security:** Authorization hooks (e.g. `onBeforeCreatePost`) are NOT
+ * called. The caller is responsible for any access-control checks before
+ * invoking this function.
+ *
+ * @param adapter - The database adapter
+ * @param input - Post data; `slug` must be pre-slugified
+ */
+declare function createPost(adapter: DBAdapter, input: CreatePostInput): Promise<Post>;
+/**
+ * Update an existing blog post and reconcile its tag associations.
+ * Returns `null` if no post with the given `id` exists.
+ * Pure DB function — no hooks, no HTTP context. Safe for server-side use.
+ *
+ * @remarks **Security:** Authorization hooks (e.g. `onBeforeUpdatePost`) are NOT
+ * called. The caller is responsible for any access-control checks before
+ * invoking this function.
+ *
+ * @param adapter - The database adapter
+ * @param id - The post ID to update
+ * @param input - Partial post data to apply; `slug` must be pre-slugified if provided
+ */
+declare function updatePost(adapter: DBAdapter, id: string, input: UpdatePostInput): Promise<Post | null>;
+/**
+ * Delete a blog post by ID.
+ * Pure DB function — no hooks, no HTTP context. Safe for server-side use.
+ *
+ * @remarks **Security:** Authorization hooks (e.g. `onBeforeDeletePost`) are NOT
+ * called. The caller is responsible for any access-control checks before
+ * invoking this function.
+ *
+ * @param adapter - The database adapter
+ * @param id - The post ID to delete
+ */
+declare function deletePost(adapter: DBAdapter, id: string): Promise<void>;
+
 /**
  * Route keys for the blog plugin — matches the keys returned by
  * `stackClient.router.getRoute(path).routeKey`.
@@ -236,12 +316,6 @@ declare const blogBackendPlugin: (hooks?: BlogBackendHooks) => _btst_stack_plugi
             title: string;
             content: string;
             excerpt: string;
-            slug?: string | undefined;
-            published?: boolean | undefined;
-            publishedAt?: unknown;
-            createdAt?: unknown;
-            updatedAt?: unknown;
-            image?: string | undefined;
             tags?: ({
                 name: string;
             } | {
@@ -249,16 +323,16 @@ declare const blogBackendPlugin: (hooks?: BlogBackendHooks) => _btst_stack_plugi
                 name: string;
                 slug: string;
             })[] | undefined;
-        }, {
-            title: string;
-            content: string;
-            excerpt: string;
             slug?: string | undefined;
             published?: boolean | undefined;
             publishedAt?: unknown;
             createdAt?: unknown;
             updatedAt?: unknown;
             image?: string | undefined;
+        }, {
+            title: string;
+            content: string;
+            excerpt: string;
             tags?: ({
                 name: string;
             } | {
@@ -266,6 +340,12 @@ declare const blogBackendPlugin: (hooks?: BlogBackendHooks) => _btst_stack_plugi
                 name: string;
                 slug: string;
             })[] | undefined;
+            slug?: string | undefined;
+            published?: boolean | undefined;
+            publishedAt?: unknown;
+            createdAt?: unknown;
+            updatedAt?: unknown;
+            image?: string | undefined;
         }>;
     }, Post>;
     readonly updatePost: better_call.StrictEndpoint<"/posts/:id", {} & {
@@ -366,6 +446,9 @@ declare const blogBackendPlugin: (hooks?: BlogBackendHooks) => _btst_stack_plugi
     }) | null>;
     getAllTags: () => Promise<Tag[]>;
     prefetchForRoute: BlogPrefetchForRoute;
+    createPost: (input: CreatePostInput) => Promise<Post>;
+    updatePost: (id: string, input: UpdatePostInput) => Promise<Post | null>;
+    deletePost: (id: string) => Promise<void>;
 }>;
 type BlogApiRouter = ReturnType<ReturnType<typeof blogBackendPlugin>["routes"]>;
 
@@ -476,5 +559,5 @@ declare function createBlogQueryKeys(client: ReturnType<typeof createApiClient<B
     };
 };
 
-export { BLOG_QUERY_KEYS as B, NextPreviousPostsQuerySchema as N, getPostBySlug as a, getAllTags as b, createBlogQueryKeys as d, PostListQuerySchema as f, getAllPosts as g, blogBackendPlugin as j };
-export type { PostListParams as P, PostListResult as c, BlogRouteKey as e, BlogApiContext as h, BlogBackendHooks as i, BlogApiRouter as k };
+export { BLOG_QUERY_KEYS as B, NextPreviousPostsQuerySchema as N, getPostBySlug as a, getAllTags as b, createPost as d, deletePost as e, createBlogQueryKeys as f, getAllPosts as g, PostListQuerySchema as i, blogBackendPlugin as l, updatePost as u };
+export type { CreatePostInput as C, PostListParams as P, UpdatePostInput as U, PostListResult as c, BlogRouteKey as h, BlogApiContext as j, BlogBackendHooks as k, BlogApiRouter as m };

package/dist/shared/{stack.NtflNnnH.d.mts → stack.DX-tQ93o.d.cts}

@@ -1,5 +1,5 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
-import { S as SerializedPost, c as createPostSchema, u as updatePostSchema, a as SerializedTag } from './stack.Sod_PZhB.mjs';
+import { S as SerializedPost, c as createPostSchema, u as updatePostSchema, a as SerializedTag } from './stack.BWp0hcm9.cjs';
 import { z } from 'zod';
 
 /**
@@ -128,10 +128,6 @@ declare function useSuspenseTags(): {
 };
 /** Create a new post */
 declare function useCreatePost(): _tanstack_react_query.UseMutationResult<SerializedPost | null, Error, {
-    published: boolean;
-    title: string;
-    content: string;
-    excerpt: string;
     tags: ({
         name: string;
     } | {
@@ -139,6 +135,10 @@ declare function useCreatePost(): _tanstack_react_query.UseMutationResult<Serial
         name: string;
         slug: string;
     })[];
+    published: boolean;
+    title: string;
+    content: string;
+    excerpt: string;
     slug?: string | undefined;
     publishedAt?: Date | undefined;
     createdAt?: Date | undefined;

package/dist/shared/{stack.DEW8EtFu.d.cts → stack.E17kSK1W.d.mts}

@@ -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.Sod_PZhB.cjs';
+import { P as Post, T as Tag, c as createPostSchema, u as updatePostSchema, S as SerializedPost, a as SerializedTag } from './stack.BWp0hcm9.mjs';
 import * as _btst_stack_plugins_api from '@btst/stack/plugins/api';
 import { DBAdapter } from '@btst/db';
 import * as better_call from 'better-call';
@@ -67,6 +67,86 @@ declare function getPostBySlug(adapter: DBAdapter, slug: string): Promise<(Post
  */
 declare function getAllTags(adapter: DBAdapter): Promise<Tag[]>;
 
+type TagInput = {
+    name: string;
+} | {
+    id: string;
+    name: string;
+    slug: string;
+};
+/**
+ * Input for creating a new blog post.
+ * `slug` must already be slugified by the caller.
+ */
+interface CreatePostInput {
+    title: string;
+    content: string;
+    excerpt: string;
+    /** Pre-slugified URL slug — use {@link slugify} before passing. */
+    slug: string;
+    image?: string;
+    published?: boolean;
+    publishedAt?: Date;
+    createdAt?: Date;
+    updatedAt?: Date;
+    tags?: TagInput[];
+}
+/**
+ * Input for updating an existing blog post.
+ * If `slug` is provided it must already be slugified by the caller.
+ */
+interface UpdatePostInput {
+    title?: string;
+    content?: string;
+    excerpt?: string;
+    /** Pre-slugified URL slug — use {@link slugify} before passing. */
+    slug?: string;
+    image?: string;
+    published?: boolean;
+    publishedAt?: Date;
+    createdAt?: Date;
+    updatedAt?: Date;
+    tags?: TagInput[];
+}
+/**
+ * Create a new blog post with optional tag associations.
+ * Pure DB function — no hooks, no HTTP context. Safe for server-side and SSG use.
+ *
+ * @remarks **Security:** Authorization hooks (e.g. `onBeforeCreatePost`) are NOT
+ * called. The caller is responsible for any access-control checks before
+ * invoking this function.
+ *
+ * @param adapter - The database adapter
+ * @param input - Post data; `slug` must be pre-slugified
+ */
+declare function createPost(adapter: DBAdapter, input: CreatePostInput): Promise<Post>;
+/**
+ * Update an existing blog post and reconcile its tag associations.
+ * Returns `null` if no post with the given `id` exists.
+ * Pure DB function — no hooks, no HTTP context. Safe for server-side use.
+ *
+ * @remarks **Security:** Authorization hooks (e.g. `onBeforeUpdatePost`) are NOT
+ * called. The caller is responsible for any access-control checks before
+ * invoking this function.
+ *
+ * @param adapter - The database adapter
+ * @param id - The post ID to update
+ * @param input - Partial post data to apply; `slug` must be pre-slugified if provided
+ */
+declare function updatePost(adapter: DBAdapter, id: string, input: UpdatePostInput): Promise<Post | null>;
+/**
+ * Delete a blog post by ID.
+ * Pure DB function — no hooks, no HTTP context. Safe for server-side use.
+ *
+ * @remarks **Security:** Authorization hooks (e.g. `onBeforeDeletePost`) are NOT
+ * called. The caller is responsible for any access-control checks before
+ * invoking this function.
+ *
+ * @param adapter - The database adapter
+ * @param id - The post ID to delete
+ */
+declare function deletePost(adapter: DBAdapter, id: string): Promise<void>;
+
 /**
  * Route keys for the blog plugin — matches the keys returned by
  * `stackClient.router.getRoute(path).routeKey`.
@@ -236,12 +316,6 @@ declare const blogBackendPlugin: (hooks?: BlogBackendHooks) => _btst_stack_plugi
             title: string;
             content: string;
             excerpt: string;
-            slug?: string | undefined;
-            published?: boolean | undefined;
-            publishedAt?: unknown;
-            createdAt?: unknown;
-            updatedAt?: unknown;
-            image?: string | undefined;
             tags?: ({
                 name: string;
             } | {
@@ -249,16 +323,16 @@ declare const blogBackendPlugin: (hooks?: BlogBackendHooks) => _btst_stack_plugi
                 name: string;
                 slug: string;
             })[] | undefined;
-        }, {
-            title: string;
-            content: string;
-            excerpt: string;
             slug?: string | undefined;
             published?: boolean | undefined;
             publishedAt?: unknown;
             createdAt?: unknown;
             updatedAt?: unknown;
             image?: string | undefined;
+        }, {
+            title: string;
+            content: string;
+            excerpt: string;
             tags?: ({
                 name: string;
             } | {
@@ -266,6 +340,12 @@ declare const blogBackendPlugin: (hooks?: BlogBackendHooks) => _btst_stack_plugi
                 name: string;
                 slug: string;
             })[] | undefined;
+            slug?: string | undefined;
+            published?: boolean | undefined;
+            publishedAt?: unknown;
+            createdAt?: unknown;
+            updatedAt?: unknown;
+            image?: string | undefined;
         }>;
     }, Post>;
     readonly updatePost: better_call.StrictEndpoint<"/posts/:id", {} & {
@@ -366,6 +446,9 @@ declare const blogBackendPlugin: (hooks?: BlogBackendHooks) => _btst_stack_plugi
     }) | null>;
     getAllTags: () => Promise<Tag[]>;
     prefetchForRoute: BlogPrefetchForRoute;
+    createPost: (input: CreatePostInput) => Promise<Post>;
+    updatePost: (id: string, input: UpdatePostInput) => Promise<Post | null>;
+    deletePost: (id: string) => Promise<void>;
 }>;
 type BlogApiRouter = ReturnType<ReturnType<typeof blogBackendPlugin>["routes"]>;
 
@@ -476,5 +559,5 @@ declare function createBlogQueryKeys(client: ReturnType<typeof createApiClient<B
     };
 };
 
-export { BLOG_QUERY_KEYS as B, NextPreviousPostsQuerySchema as N, getPostBySlug as a, getAllTags as b, createBlogQueryKeys as d, PostListQuerySchema as f, getAllPosts as g, blogBackendPlugin as j };
-export type { PostListParams as P, PostListResult as c, BlogRouteKey as e, BlogApiContext as h, BlogBackendHooks as i, BlogApiRouter as k };
+export { BLOG_QUERY_KEYS as B, NextPreviousPostsQuerySchema as N, getPostBySlug as a, getAllTags as b, createPost as d, deletePost as e, createBlogQueryKeys as f, getAllPosts as g, PostListQuerySchema as i, blogBackendPlugin as l, updatePost as u };
+export type { CreatePostInput as C, PostListParams as P, UpdatePostInput as U, PostListResult as c, BlogRouteKey as h, BlogApiContext as j, BlogBackendHooks as k, BlogApiRouter as m };

package/dist/shared/{stack.QrBE0Bc8.d.ts → stack.VF6FhyZw.d.ts}

@@ -1,5 +1,5 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
-import { S as SerializedPost, c as createPostSchema, u as updatePostSchema, a as SerializedTag } from './stack.Sod_PZhB.js';
+import { S as SerializedPost, c as createPostSchema, u as updatePostSchema, a as SerializedTag } from './stack.BWp0hcm9.js';
 import { z } from 'zod';
 
 /**
@@ -128,10 +128,6 @@ declare function useSuspenseTags(): {
 };
 /** Create a new post */
 declare function useCreatePost(): _tanstack_react_query.UseMutationResult<SerializedPost | null, Error, {
-    published: boolean;
-    title: string;
-    content: string;
-    excerpt: string;
     tags: ({
         name: string;
     } | {
@@ -139,6 +135,10 @@ declare function useCreatePost(): _tanstack_react_query.UseMutationResult<Serial
         name: string;
         slug: string;
     })[];
+    published: boolean;
+    title: string;
+    content: string;
+    excerpt: string;
     slug?: string | undefined;
     publishedAt?: Date | undefined;
     createdAt?: Date | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@btst/stack",
-  "version": "2.11.1",
+  "version": "2.11.2",
   "description": "A composable, plugin-based library for building full-stack applications.",
   "repository": {
     "type": "git",

package/src/plugins/blog/api/index.ts

@@ -6,6 +6,13 @@ export {
 	type PostListParams,
 	type PostListResult,
 } from "./getters";
+export {
+	createPost,
+	updatePost,
+	deletePost,
+	type CreatePostInput,
+	type UpdatePostInput,
+} from "./mutations";
 export { serializePost, serializeTag } from "./serializers";
 export { BLOG_QUERY_KEYS } from "./query-key-defs";
 export { createBlogQueryKeys } from "../query-keys";