@btst/stack 2.1.0 → 2.3.0

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

@@ -1,333 +1,8 @@
-import * as _btst_stack_plugins_api from '@btst/stack/plugins/api';
-import * as better_call from 'better-call';
-import { z } from 'zod';
-import { c as createPostSchema, u as updatePostSchema, P as Post, T as Tag, S as SerializedPost, a as SerializedTag } from '../../shared/stack.CbuN2zVV.js';
-import * as _tanstack_react_query from '@tanstack/react-query';
-import { createApiClient } from '@btst/stack/plugins/client';
-
-declare const PostListQuerySchema: z.ZodObject<{
-    slug: z.ZodOptional<z.ZodString>;
-    tagSlug: z.ZodOptional<z.ZodString>;
-    offset: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
-    limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
-    query: z.ZodOptional<z.ZodString>;
-    published: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<boolean | undefined, string | undefined>>;
-}, z.core.$strip>;
-declare const NextPreviousPostsQuerySchema: z.ZodObject<{
-    date: z.ZodCoercedDate<unknown>;
-}, z.core.$strip>;
-/**
- * Context passed to blog API hooks
- */
-interface BlogApiContext<TBody = any, TParams = any, TQuery = any> {
-    body?: TBody;
-    params?: TParams;
-    query?: TQuery;
-    request?: Request;
-    headers?: Headers;
-    [key: string]: any;
-}
-/**
- * Configuration hooks for blog backend plugin
- * All hooks are optional and allow consumers to customize behavior
- */
-interface BlogBackendHooks {
-    /**
-     * Called before listing posts. Return false to deny access.
-     * @param filter - Query parameters for filtering posts
-     * @param context - Request context with headers, etc.
-     */
-    onBeforeListPosts?: (filter: z.infer<typeof PostListQuerySchema>, context: BlogApiContext) => Promise<boolean> | boolean;
-    /**
-     * Called before creating a post. Return false to deny access.
-     * @param data - Post data being created
-     * @param context - Request context with headers, etc.
-     */
-    onBeforeCreatePost?: (data: z.infer<typeof createPostSchema>, context: BlogApiContext) => Promise<boolean> | boolean;
-    /**
-     * Called before updating a post. Return false to deny access.
-     * @param postId - ID of the post being updated
-     * @param data - Updated post data
-     * @param context - Request context with headers, etc.
-     */
-    onBeforeUpdatePost?: (postId: string, data: z.infer<typeof updatePostSchema>, context: BlogApiContext) => Promise<boolean> | boolean;
-    /**
-     * Called before deleting a post. Return false to deny access.
-     * @param postId - ID of the post being deleted
-     * @param context - Request context with headers, etc.
-     */
-    onBeforeDeletePost?: (postId: string, context: BlogApiContext) => Promise<boolean> | boolean;
-    /**
-     * Called after posts are read successfully
-     * @param posts - Array of posts that were read
-     * @param filter - Query parameters used for filtering
-     * @param context - Request context
-     */
-    onPostsRead?: (posts: Post[], filter: z.infer<typeof PostListQuerySchema>, context: BlogApiContext) => Promise<void> | void;
-    /**
-     * Called after a post is created successfully
-     * @param post - The created post
-     * @param context - Request context
-     */
-    onPostCreated?: (post: Post, context: BlogApiContext) => Promise<void> | void;
-    /**
-     * Called after a post is updated successfully
-     * @param post - The updated post
-     * @param context - Request context
-     */
-    onPostUpdated?: (post: Post, context: BlogApiContext) => Promise<void> | void;
-    /**
-     * Called after a post is deleted successfully
-     * @param postId - ID of the deleted post
-     * @param context - Request context
-     */
-    onPostDeleted?: (postId: string, context: BlogApiContext) => Promise<void> | void;
-    /**
-     * Called when listing posts fails
-     * @param error - The error that occurred
-     * @param context - Request context
-     */
-    onListPostsError?: (error: Error, context: BlogApiContext) => Promise<void> | void;
-    /**
-     * Called when creating a post fails
-     * @param error - The error that occurred
-     * @param context - Request context
-     */
-    onCreatePostError?: (error: Error, context: BlogApiContext) => Promise<void> | void;
-    /**
-     * Called when updating a post fails
-     * @param error - The error that occurred
-     * @param context - Request context
-     */
-    onUpdatePostError?: (error: Error, context: BlogApiContext) => Promise<void> | void;
-    /**
-     * Called when deleting a post fails
-     * @param error - The error that occurred
-     * @param context - Request context
-     */
-    onDeletePostError?: (error: Error, context: BlogApiContext) => Promise<void> | void;
-}
-/**
- * Blog backend plugin
- * Provides API endpoints for managing blog posts
- * Uses better-db adapter for database operations
- *
- * @param hooks - Optional configuration hooks for customizing plugin behavior
- */
-declare const blogBackendPlugin: (hooks?: BlogBackendHooks) => _btst_stack_plugins_api.BackendPlugin<{
-    readonly listPosts: better_call.StrictEndpoint<"/posts", {
-        method: "GET";
-        query: z.ZodObject<{
-            slug: z.ZodOptional<z.ZodString>;
-            tagSlug: z.ZodOptional<z.ZodString>;
-            offset: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
-            limit: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
-            query: z.ZodOptional<z.ZodString>;
-            published: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<boolean | undefined, string | undefined>>;
-        }, z.core.$strip>;
-    }, {
-        tags: Tag[];
-        id: string;
-        authorId?: string;
-        defaultLocale?: string;
-        slug: string;
-        title: string;
-        content: string;
-        excerpt: string;
-        image?: string;
-        published: boolean;
-        status?: "DRAFT" | "PUBLISHED";
-        publishedAt?: Date;
-        createdAt: Date;
-        updatedAt: Date;
-    }[]>;
-    readonly createPost: better_call.StrictEndpoint<"/posts", {
-        method: "POST";
-        body: z.ZodObject<{
-            slug: z.ZodOptional<z.ZodString>;
-            publishedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
-            createdAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
-            updatedAt: 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>>;
-            tags: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
-                name: z.ZodString;
-            }, z.core.$strip>, z.ZodObject<{
-                id: z.ZodString;
-                name: z.ZodString;
-                slug: z.ZodString;
-            }, z.core.$strip>]>>>>;
-        }, z.core.$strip>;
-    }, Post>;
-    readonly updatePost: better_call.StrictEndpoint<"/posts/:id", {
-        method: "PUT";
-        body: z.ZodObject<{
-            publishedAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
-            createdAt: z.ZodOptional<z.ZodCoercedDate<unknown>>;
-            updatedAt: 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>>;
-            slug: z.ZodString;
-            tags: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodUnion<readonly [z.ZodObject<{
-                name: z.ZodString;
-            }, z.core.$strip>, z.ZodObject<{
-                id: z.ZodString;
-                name: z.ZodString;
-                slug: z.ZodString;
-            }, z.core.$strip>]>>>>;
-            id: z.ZodString;
-        }, z.core.$strip>;
-    }, Post>;
-    readonly deletePost: better_call.StrictEndpoint<"/posts/:id", {
-        method: "DELETE";
-    }, {
-        success: boolean;
-    }>;
-    readonly getNextPreviousPosts: better_call.StrictEndpoint<"/posts/next-previous", {
-        method: "GET";
-        query: z.ZodObject<{
-            date: z.ZodCoercedDate<unknown>;
-        }, z.core.$strip>;
-    }, {
-        previous: {
-            tags: Tag[];
-            id: string;
-            authorId?: string;
-            defaultLocale?: string;
-            slug: string;
-            title: string;
-            content: string;
-            excerpt: string;
-            image?: string;
-            published: boolean;
-            status?: "DRAFT" | "PUBLISHED";
-            publishedAt?: Date;
-            createdAt: Date;
-            updatedAt: Date;
-        } | null;
-        next: {
-            tags: Tag[];
-            id: string;
-            authorId?: string;
-            defaultLocale?: string;
-            slug: string;
-            title: string;
-            content: string;
-            excerpt: string;
-            image?: string;
-            published: boolean;
-            status?: "DRAFT" | "PUBLISHED";
-            publishedAt?: Date;
-            createdAt: Date;
-            updatedAt: Date;
-        } | null;
-    }>;
-    readonly listTags: better_call.StrictEndpoint<"/tags", {
-        method: "GET";
-    }, Tag[]>;
-}>;
-type BlogApiRouter = ReturnType<ReturnType<typeof blogBackendPlugin>["routes"]>;
-
-interface PostsListParams {
-    query?: string;
-    limit?: number;
-    published?: boolean;
-    tagSlug?: string;
-}
-declare function createBlogQueryKeys(client: ReturnType<typeof createApiClient<BlogApiRouter>>, headers?: HeadersInit): {
-    posts: {
-        _def: readonly ["posts"];
-    } & {
-        list: ((params?: PostsListParams | undefined) => Omit<Omit<{
-            queryKey: readonly ["posts", "list", {
-                query: string | undefined;
-                limit: number;
-                published: boolean;
-                tagSlug: string | undefined;
-            }];
-            queryFn: _tanstack_react_query.QueryFunction<unknown, readonly ["posts", "list", {
-                query: string | undefined;
-                limit: number;
-                published: boolean;
-                tagSlug: string | undefined;
-            }]>;
-        }, "queryFn"> & {
-            _def: readonly ["posts", "list"];
-        }, "_def">) & {
-            _def: readonly ["posts", "list"];
-        };
-        detail: ((slug: string) => Omit<{
-            queryKey: readonly ["posts", "detail", string];
-            queryFn: _tanstack_react_query.QueryFunction<SerializedPost | null, readonly ["posts", "detail", string]>;
-        } & {
-            _def: readonly ["posts", "detail"];
-        }, "_def">) & {
-            _def: readonly ["posts", "detail"];
-        };
-        nextPrevious: ((date: string | Date) => Omit<{
-            queryKey: readonly ["posts", "nextPrevious", string, string | Date];
-            queryFn: _tanstack_react_query.QueryFunction<{
-                previous: SerializedPost | null;
-                next: SerializedPost | null;
-            }, readonly ["posts", "nextPrevious", string, string | Date]>;
-        } & {
-            _def: readonly ["posts", "nextPrevious"];
-        }, "_def">) & {
-            _def: readonly ["posts", "nextPrevious"];
-        };
-        recent: ((params?: {
-            limit?: number;
-            excludeSlug?: string;
-        } | undefined) => Omit<{
-            queryKey: readonly ["posts", "recent", string, {
-                limit?: number;
-                excludeSlug?: string;
-            } | undefined];
-            queryFn: _tanstack_react_query.QueryFunction<SerializedPost[], readonly ["posts", "recent", string, {
-                limit?: number;
-                excludeSlug?: string;
-            } | undefined]>;
-        } & {
-            _def: readonly ["posts", "recent"];
-        }, "_def">) & {
-            _def: readonly ["posts", "recent"];
-        };
-    };
-    drafts: {
-        _def: readonly ["drafts"];
-    } & {
-        list: ((params?: PostsListParams | undefined) => Omit<Omit<{
-            queryKey: readonly ["drafts", "list", {
-                limit?: number | undefined;
-            }];
-            queryFn: _tanstack_react_query.QueryFunction<unknown, readonly ["drafts", "list", {
-                limit?: number | undefined;
-            }]>;
-        }, "queryFn"> & {
-            _def: readonly ["drafts", "list"];
-        }, "_def">) & {
-            _def: readonly ["drafts", "list"];
-        };
-    };
-    tags: {
-        _def: readonly ["tags"];
-    } & {
-        list: (() => Omit<{
-            queryKey: readonly ["tags", "list", string];
-            queryFn: _tanstack_react_query.QueryFunction<SerializedTag[], readonly ["tags", "list", string]>;
-        } & {
-            _def: readonly ["tags", "list"];
-        }, "_def">) & {
-            _def: readonly ["tags", "list"];
-        };
-    };
-};
-
-export { NextPreviousPostsQuerySchema as N, PostListQuerySchema as P, blogBackendPlugin as b, createBlogQueryKeys };
-export type { BlogApiContext as B, BlogBackendHooks as a, BlogApiRouter as c };
+import '@tanstack/react-query';
+export { d as createBlogQueryKeys } from '../../shared/stack.BKfolAyK.js';
+import '@btst/stack/plugins/client';
+import '../../shared/stack.CBON0dWL.js';
+import '@btst/stack/plugins/api';
+import 'better-call';
+import '@btst/db';
+import 'zod';

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

@@ -1,4 +1,5 @@
 import { mergeQueryKeys, createQueryKeys } from '@lukemorales/query-key-factory';
+import { postsListDiscriminator } from '../../packages/stack/src/plugins/blog/api/query-key-defs.mjs';
 
 function isErrorResponse(response) {
   return typeof response === "object" && response !== null && "error" in response && response.error !== null && response.error !== void 0;
@@ -26,12 +27,12 @@ function createPostsQueries(client, headers) {
   return createQueryKeys("posts", {
     list: (params) => ({
       queryKey: [
-        {
-          query: params?.query !== void 0 && params?.query?.trim() === "" ? void 0 : params?.query,
-          limit: params?.limit ?? 10,
+        postsListDiscriminator({
           published: params?.published ?? true,
-          tagSlug: params?.tagSlug
-        }
+          limit: params?.limit ?? 10,
+          tagSlug: params?.tagSlug,
+          query: params?.query
+        })
       ],
       queryFn: async ({ pageParam }) => {
         try {
@@ -50,7 +51,8 @@ function createPostsQueries(client, headers) {
             const errorResponse = response;
             throw toError(errorResponse.error);
           }
-          return response.data ?? [];
+          const dataResponse = response;
+          return dataResponse.data?.items ?? [];
         } catch (error) {
           throw error;
         }
@@ -72,7 +74,7 @@ function createPostsQueries(client, headers) {
             throw toError(errorResponse.error);
           }
           const dataResponse = response;
-          return dataResponse.data?.[0] ?? null;
+          return dataResponse.data?.items?.[0] ?? null;
         } catch (error) {
           throw error;
         }
@@ -115,7 +117,8 @@ function createPostsQueries(client, headers) {
             const errorResponse = response;
             throw toError(errorResponse.error);
           }
-          let posts = response.data ?? [];
+          const recentResponse = response;
+          let posts = recentResponse.data?.items ?? [];
           if (params?.excludeSlug) {
             posts = posts.filter((post) => post.slug !== params.excludeSlug);
           }
@@ -151,7 +154,8 @@ function createDraftsQueries(client, headers) {
             const errorResponse = response;
             throw toError(errorResponse.error);
           }
-          return response.data ?? [];
+          const draftsResponse = response;
+          return draftsResponse.data?.items ?? [];
         } catch (error) {
           throw error;
         }

package/dist/plugins/client/index.cjs

@@ -9,6 +9,7 @@ function defineClientPlugin(plugin) {
 }
 
 exports.createApiClient = utils.createApiClient;
+exports.isConnectionError = utils.isConnectionError;
 exports.createRoute = yar.createRoute;
 exports.createRouter = yar.createRouter;
 exports.createClient = client.createClient;

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

@@ -1,5 +1,5 @@
-import { C as ClientPlugin } from '../../shared/stack.BoA0xkJv.cjs';
-export { P as PluginOverrides } from '../../shared/stack.BoA0xkJv.cjs';
+import { C as ClientPlugin } from '../../shared/stack.7n9Y_u7N.cjs';
+export { P as PluginOverrides } from '../../shared/stack.7n9Y_u7N.cjs';
 import { Route } from '@btst/yar';
 export { Route, createRoute, createRouter } from '@btst/yar';
 import { createClient } from 'better-call/client';
@@ -7,6 +7,13 @@ export { createClient } from 'better-call/client';
 import { Router, Endpoint } from 'better-call';
 import '@btst/db';
 
+/**
+ * Returns true when a fetch error is a connection-refused / no-server error.
+ * Used in SSR loaders to emit an actionable build-time warning when
+ * `route.loader()` is called during `next build` with no HTTP server running.
+ */
+declare function isConnectionError(err: unknown): boolean;
+
 interface CreateApiClientOptions {
     baseURL?: string;
     basePath?: string;
@@ -53,4 +60,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 };
+export { ClientPlugin, createApiClient, defineClientPlugin, isConnectionError };

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

@@ -1,5 +1,5 @@
-import { C as ClientPlugin } from '../../shared/stack.BoA0xkJv.mjs';
-export { P as PluginOverrides } from '../../shared/stack.BoA0xkJv.mjs';
+import { C as ClientPlugin } from '../../shared/stack.7n9Y_u7N.mjs';
+export { P as PluginOverrides } from '../../shared/stack.7n9Y_u7N.mjs';
 import { Route } from '@btst/yar';
 export { Route, createRoute, createRouter } from '@btst/yar';
 import { createClient } from 'better-call/client';
@@ -7,6 +7,13 @@ export { createClient } from 'better-call/client';
 import { Router, Endpoint } from 'better-call';
 import '@btst/db';
 
+/**
+ * Returns true when a fetch error is a connection-refused / no-server error.
+ * Used in SSR loaders to emit an actionable build-time warning when
+ * `route.loader()` is called during `next build` with no HTTP server running.
+ */
+declare function isConnectionError(err: unknown): boolean;
+
 interface CreateApiClientOptions {
     baseURL?: string;
     basePath?: string;
@@ -53,4 +60,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 };
+export { ClientPlugin, createApiClient, defineClientPlugin, isConnectionError };

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

@@ -1,5 +1,5 @@
-import { C as ClientPlugin } from '../../shared/stack.BoA0xkJv.js';
-export { P as PluginOverrides } from '../../shared/stack.BoA0xkJv.js';
+import { C as ClientPlugin } from '../../shared/stack.7n9Y_u7N.js';
+export { P as PluginOverrides } from '../../shared/stack.7n9Y_u7N.js';
 import { Route } from '@btst/yar';
 export { Route, createRoute, createRouter } from '@btst/yar';
 import { createClient } from 'better-call/client';
@@ -7,6 +7,13 @@ export { createClient } from 'better-call/client';
 import { Router, Endpoint } from 'better-call';
 import '@btst/db';
 
+/**
+ * Returns true when a fetch error is a connection-refused / no-server error.
+ * Used in SSR loaders to emit an actionable build-time warning when
+ * `route.loader()` is called during `next build` with no HTTP server running.
+ */
+declare function isConnectionError(err: unknown): boolean;
+
 interface CreateApiClientOptions {
     baseURL?: string;
     basePath?: string;
@@ -53,4 +60,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 };
+export { ClientPlugin, createApiClient, defineClientPlugin, isConnectionError };

package/dist/plugins/client/index.mjs

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

package/dist/plugins/cms/api/index.cjs

@@ -1,7 +1,17 @@
 'use strict';
 
 const plugin = require('../../../packages/stack/src/plugins/cms/api/plugin.cjs');
+const getters = require('../../../packages/stack/src/plugins/cms/api/getters.cjs');
+const queryKeyDefs = require('../../../packages/stack/src/plugins/cms/api/query-key-defs.cjs');
 
 
 
 exports.cmsBackendPlugin = plugin.cmsBackendPlugin;
+exports.getAllContentItems = getters.getAllContentItems;
+exports.getAllContentTypes = getters.getAllContentTypes;
+exports.getContentItemById = getters.getContentItemById;
+exports.getContentItemBySlug = getters.getContentItemBySlug;
+exports.serializeContentItem = getters.serializeContentItem;
+exports.serializeContentItemWithType = getters.serializeContentItemWithType;
+exports.serializeContentType = getters.serializeContentType;
+exports.CMS_QUERY_KEYS = queryKeyDefs.CMS_QUERY_KEYS;