@btst/stack 2.12.2 → 3.0.0-rc.2

package/dist/shared/{stack.ufcExQIR.d.ts → stack.WELCDuMs.d.ts}

@@ -1,12 +1,12 @@
-import * as _tanstack_react_query from '@tanstack/react-query';
-import { QueryClient } from '@tanstack/react-query';
+import * as _btst_stack_plugins_client from '@btst/stack/plugins/client';
 import { createApiClient } from '@btst/stack/plugins/client';
+import { z } from 'zod';
+import { c as createPostSchema, u as updatePostSchema } from './stack.D18Dq3ve.js';
 import { P as Post, T as Tag, S as SerializedPost, a as SerializedTag } from './stack.Dsatjh0B.js';
 import * as _btst_stack_plugins_api from '@btst/stack/plugins/api';
 import { DBAdapter } from '@btst/db';
 import * as better_call from 'better-call';
-import { z } from 'zod';
-import { c as createPostSchema, u as updatePostSchema } from './stack.CuhcFsAx.js';
+import { QueryClient } from '@tanstack/react-query';
 
 /**
  * Parameters for filtering/paginating posts.
@@ -325,11 +325,11 @@ declare const blogBackendPlugin: (hooks?: BlogBackendHooks) => _btst_stack_plugi
                 slug: string;
             })[] | undefined;
             slug?: string | undefined;
-            published?: boolean | undefined;
             publishedAt?: unknown;
             createdAt?: unknown;
             updatedAt?: unknown;
             image?: string | undefined;
+            published?: boolean | undefined;
         }, {
             title: string;
             content: string;
@@ -342,11 +342,11 @@ declare const blogBackendPlugin: (hooks?: BlogBackendHooks) => _btst_stack_plugi
                 slug: string;
             })[] | undefined;
             slug?: string | undefined;
-            published?: boolean | undefined;
             publishedAt?: unknown;
             createdAt?: unknown;
             updatedAt?: unknown;
             image?: string | undefined;
+            published?: boolean | undefined;
         }>;
     }, Post>;
     readonly updatePost: better_call.StrictEndpoint<"/posts/:id", {} & {
@@ -481,84 +481,360 @@ interface PostsListParams {
     published?: boolean;
     tagSlug?: string;
 }
-declare function createBlogQueryKeys(client: ReturnType<typeof createApiClient<BlogApiRouter>>, headers?: HeadersInit): {
+type PostCreateInput = z.infer<typeof createPostSchema>;
+type PostUpdateInput = z.infer<typeof updatePostSchema>;
+/**
+ * Blog resource declaration — the single source of truth for query keys,
+ * HTTP mappings and mutations. Feeds both `createBlogQueryKeys` (SSR
+ * loaders) and `createResource` (client hooks, see `client/hooks`).
+ *
+ * Key shapes intentionally match `BLOG_QUERY_KEYS` in
+ * `api/query-key-defs.ts` so SSG `prefetchForRoute` hydration keeps working.
+ */
+declare const blogResources: {
     posts: {
-        _def: readonly ["posts"];
-    } & {
-        list: ((params?: PostsListParams | undefined) => Omit<Omit<{
-            queryKey: readonly ["posts", "list", PostsListDiscriminator];
-            queryFn: _tanstack_react_query.QueryFunction<unknown, readonly ["posts", "list", PostsListDiscriminator]>;
-        }, "queryFn"> & {
-            _def: readonly ["posts", "list"];
-        }, "_def">) & {
-            _def: readonly ["posts", "list"];
+        queries: {
+            list: {
+                path: string;
+                query: (params?: PostsListParams) => {
+                    query: string | undefined;
+                    limit: number;
+                    published: string | undefined;
+                    tagSlug: string | undefined;
+                };
+                key: (params?: PostsListParams) => PostsListDiscriminator[];
+                select: (data: any, _params?: PostsListParams) => SerializedPost[];
+                infinite: true;
+                pageSize: (params?: PostsListParams) => number;
+            };
+            detail: {
+                path: string;
+                query: (slug: string) => {
+                    slug: string;
+                    limit: number;
+                };
+                key: (slug: string) => string[];
+                select: (data: any, _slug: string) => SerializedPost | null;
+                skip: (slug: string) => boolean;
+            };
+            nextPrevious: {
+                path: string;
+                query: (date: Date | string) => {
+                    date: string;
+                };
+                key: (date: Date | string) => (string | Date)[];
+                select: (data: any, _date: Date | string) => {
+                    previous: SerializedPost | null;
+                    next: SerializedPost | null;
+                };
+            };
+            recent: {
+                path: string;
+                query: (params?: {
+                    limit?: number;
+                    excludeSlug?: string;
+                }) => {
+                    limit: number;
+                    published: string;
+                };
+                key: (params?: {
+                    limit?: number;
+                    excludeSlug?: string;
+                }) => (string | {
+                    limit?: number;
+                    excludeSlug?: string;
+                } | undefined)[];
+                select: (data: any, params?: {
+                    limit?: number;
+                    excludeSlug?: string;
+                }) => SerializedPost[];
+            };
         };
-        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"];
+        mutations: {
+            create: {
+                path: string;
+                method: "POST";
+                input: (vars: PostCreateInput) => {
+                    body: {
+                        published: boolean;
+                        title: string;
+                        content: string;
+                        excerpt: string;
+                        tags: ({
+                            name: string;
+                        } | {
+                            id: string;
+                            name: string;
+                            slug: string;
+                        })[];
+                        slug?: string | undefined;
+                        publishedAt?: Date | undefined;
+                        createdAt?: Date | undefined;
+                        updatedAt?: Date | undefined;
+                        image?: string | undefined;
+                    };
+                };
+                select: (data: any) => SerializedPost | null;
+                invalidates: string[];
+                setData: {
+                    query: string;
+                    args: (created: SerializedPost | null) => string[] | null;
+                };
+            };
+            update: {
+                path: string;
+                method: "PUT";
+                input: (vars: {
+                    id: string;
+                    data: PostUpdateInput;
+                }) => {
+                    params: {
+                        id: string;
+                    };
+                    body: {
+                        title: string;
+                        content: string;
+                        excerpt: string;
+                        published: boolean;
+                        slug: string;
+                        tags: ({
+                            name: string;
+                        } | {
+                            id: string;
+                            name: string;
+                            slug: string;
+                        })[];
+                        id: string;
+                        publishedAt?: Date | undefined;
+                        createdAt?: Date | undefined;
+                        updatedAt?: Date | undefined;
+                        image?: string | undefined;
+                    };
+                };
+                select: (data: any) => SerializedPost | null;
+                invalidates: string[];
+                setData: {
+                    query: string;
+                    args: (updated: SerializedPost | null) => string[] | null;
+                };
+            };
+            delete: {
+                path: string;
+                method: "DELETE";
+                input: (vars: {
+                    id: string;
+                }) => {
+                    params: {
+                        id: string;
+                    };
+                };
+                select: (data: any) => {
+                    success: boolean;
+                };
+                invalidates: string[];
+            };
         };
-        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"];
+    };
+    drafts: {
+        queries: {
+            list: {
+                path: string;
+                query: (params?: PostsListParams) => {
+                    query: string | undefined;
+                    limit: number;
+                    published: string;
+                };
+                key: (params?: PostsListParams) => {
+                    limit?: number | undefined;
+                }[];
+                select: (data: any, _params?: PostsListParams) => SerializedPost[];
+                infinite: true;
+                pageSize: (params?: PostsListParams) => number;
+            };
+        };
+    };
+    tags: {
+        queries: {
+            list: {
+                path: string;
+                key: () => string[];
+                select: (data: any) => SerializedTag[];
+            };
+        };
+    };
+};
+declare function createBlogQueryKeys(client: ReturnType<typeof createApiClient<BlogApiRouter>>, headers?: HeadersInit): _btst_stack_plugins_client.ResourceQueryKeys<{
+    posts: {
+        queries: {
+            list: {
+                path: string;
+                query: (params?: PostsListParams) => {
+                    query: string | undefined;
+                    limit: number;
+                    published: string | undefined;
+                    tagSlug: string | undefined;
+                };
+                key: (params?: PostsListParams) => PostsListDiscriminator[];
+                select: (data: any, _params?: PostsListParams) => SerializedPost[];
+                infinite: true;
+                pageSize: (params?: PostsListParams) => number;
+            };
+            detail: {
+                path: string;
+                query: (slug: string) => {
+                    slug: string;
+                    limit: number;
+                };
+                key: (slug: string) => string[];
+                select: (data: any, _slug: string) => SerializedPost | null;
+                skip: (slug: string) => boolean;
+            };
+            nextPrevious: {
+                path: string;
+                query: (date: Date | string) => {
+                    date: string;
+                };
+                key: (date: Date | string) => (string | Date)[];
+                select: (data: any, _date: Date | string) => {
+                    previous: SerializedPost | null;
+                    next: SerializedPost | null;
+                };
+            };
+            recent: {
+                path: string;
+                query: (params?: {
+                    limit?: number;
+                    excludeSlug?: string;
+                }) => {
+                    limit: number;
+                    published: string;
+                };
+                key: (params?: {
+                    limit?: number;
+                    excludeSlug?: string;
+                }) => (string | {
+                    limit?: number;
+                    excludeSlug?: string;
+                } | undefined)[];
+                select: (data: any, params?: {
+                    limit?: number;
+                    excludeSlug?: string;
+                }) => SerializedPost[];
+            };
         };
-        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"];
+        mutations: {
+            create: {
+                path: string;
+                method: "POST";
+                input: (vars: PostCreateInput) => {
+                    body: {
+                        published: boolean;
+                        title: string;
+                        content: string;
+                        excerpt: string;
+                        tags: ({
+                            name: string;
+                        } | {
+                            id: string;
+                            name: string;
+                            slug: string;
+                        })[];
+                        slug?: string | undefined;
+                        publishedAt?: Date | undefined;
+                        createdAt?: Date | undefined;
+                        updatedAt?: Date | undefined;
+                        image?: string | undefined;
+                    };
+                };
+                select: (data: any) => SerializedPost | null;
+                invalidates: string[];
+                setData: {
+                    query: string;
+                    args: (created: SerializedPost | null) => string[] | null;
+                };
+            };
+            update: {
+                path: string;
+                method: "PUT";
+                input: (vars: {
+                    id: string;
+                    data: PostUpdateInput;
+                }) => {
+                    params: {
+                        id: string;
+                    };
+                    body: {
+                        title: string;
+                        content: string;
+                        excerpt: string;
+                        published: boolean;
+                        slug: string;
+                        tags: ({
+                            name: string;
+                        } | {
+                            id: string;
+                            name: string;
+                            slug: string;
+                        })[];
+                        id: string;
+                        publishedAt?: Date | undefined;
+                        createdAt?: Date | undefined;
+                        updatedAt?: Date | undefined;
+                        image?: string | undefined;
+                    };
+                };
+                select: (data: any) => SerializedPost | null;
+                invalidates: string[];
+                setData: {
+                    query: string;
+                    args: (updated: SerializedPost | null) => string[] | null;
+                };
+            };
+            delete: {
+                path: string;
+                method: "DELETE";
+                input: (vars: {
+                    id: string;
+                }) => {
+                    params: {
+                        id: string;
+                    };
+                };
+                select: (data: any) => {
+                    success: boolean;
+                };
+                invalidates: string[];
+            };
         };
     };
     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"];
+        queries: {
+            list: {
+                path: string;
+                query: (params?: PostsListParams) => {
+                    query: string | undefined;
+                    limit: number;
+                    published: string;
+                };
+                key: (params?: PostsListParams) => {
+                    limit?: number | undefined;
+                }[];
+                select: (data: any, _params?: PostsListParams) => SerializedPost[];
+                infinite: true;
+                pageSize: (params?: PostsListParams) => number;
+            };
         };
     };
     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"];
+        queries: {
+            list: {
+                path: string;
+                key: () => string[];
+                select: (data: any) => SerializedTag[];
+            };
         };
     };
-};
+}>;
 
-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 { 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, blogResources as n, 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.DFtpFS00.d.cts → stack.aXdBOJAR.d.cts}

@@ -170,4 +170,4 @@ interface CMSBackendConfig {
     maxPageSize?: number;
 }
 
-export type { ContentTypeConfig as C, InverseRelation as I, PaginatedContentItems as P, SerializedContentType as S, SerializedContentItemWithType as a, ContentType as b, ContentItem as c, SerializedContentItem as d, ContentItemWithType as e, CMSBackendConfig as f };
+export type { ContentType as C, InverseRelation as I, PaginatedContentItems as P, SerializedContentType as S, SerializedContentItemWithType as a, ContentItem as b, SerializedContentItem as c, ContentItemWithType as d, CMSBackendConfig as e, ContentTypeConfig as f };

package/dist/shared/{stack.DFtpFS00.d.mts → stack.aXdBOJAR.d.mts}

@@ -170,4 +170,4 @@ interface CMSBackendConfig {
     maxPageSize?: number;
 }
 
-export type { ContentTypeConfig as C, InverseRelation as I, PaginatedContentItems as P, SerializedContentType as S, SerializedContentItemWithType as a, ContentType as b, ContentItem as c, SerializedContentItem as d, ContentItemWithType as e, CMSBackendConfig as f };
+export type { ContentType as C, InverseRelation as I, PaginatedContentItems as P, SerializedContentType as S, SerializedContentItemWithType as a, ContentItem as b, SerializedContentItem as c, ContentItemWithType as d, CMSBackendConfig as e, ContentTypeConfig as f };

package/dist/shared/{stack.DFtpFS00.d.ts → stack.aXdBOJAR.d.ts}

@@ -170,4 +170,4 @@ interface CMSBackendConfig {
     maxPageSize?: number;
 }
 
-export type { ContentTypeConfig as C, InverseRelation as I, PaginatedContentItems as P, SerializedContentType as S, SerializedContentItemWithType as a, ContentType as b, ContentItem as c, SerializedContentItem as d, ContentItemWithType as e, CMSBackendConfig as f };
+export type { ContentType as C, InverseRelation as I, PaginatedContentItems as P, SerializedContentType as S, SerializedContentItemWithType as a, ContentItem as b, SerializedContentItem as c, ContentItemWithType as d, CMSBackendConfig as e, ContentTypeConfig as f };

package/dist/shared/stack.aqVZ6PEW.d.cts

@@ -0,0 +1,67 @@
+import { ComponentType } from 'react';
+
+/**
+ * Framework routing primitives shared by all plugins.
+ *
+ * Providing these fields once via the top-level `router` prop on
+ * `StackProvider` makes them available to every plugin.
+ */
+interface StackRouter {
+    /**
+     * Link component for navigation
+     */
+    Link?: ComponentType<React.ComponentProps<"a"> & Record<string, any>>;
+    /**
+     * Image component for displaying images
+     */
+    Image?: ComponentType<React.ImgHTMLAttributes<HTMLImageElement> & Record<string, any>>;
+    /**
+     * Navigation function for programmatic navigation
+     */
+    navigate?: (path: string) => void | Promise<void>;
+    /**
+     * Refresh function to invalidate server-side cache (e.g., Next.js router.refresh())
+     */
+    refresh?: () => void | Promise<void>;
+    /**
+     * Read the current URL search params
+     */
+    getSearchParams?: () => URLSearchParams;
+    /**
+     * Replace the current URL search params
+     */
+    setSearchParams?: (next: URLSearchParams, opts?: {
+        replace?: boolean;
+    }) => void;
+}
+/**
+ * Config accepted by the `router` prop on `StackProvider`.
+ *
+ * Framework presets (`nextRouter()`, `reactRouter()`, `tanstackRouter()`) are
+ * plain objects created anywhere — including module scope — so fields that
+ * need framework hooks are produced by the optional `useRouter` hook, which
+ * `StackProvider` evaluates internally. Hook results are merged over the
+ * static fields.
+ */
+interface StackRouterConfig extends StackRouter {
+    /**
+     * Optional hook evaluated inside `StackProvider`. Use this for router
+     * fields that must be derived from framework hooks (e.g. `useNavigate`).
+     */
+    useRouter?: () => StackRouter;
+}
+/**
+ * Top-level API config used by all plugin components.
+ */
+interface StackApiConfig {
+    /**
+     * API base URL (e.g. `https://example.com`)
+     */
+    baseURL: string;
+    /**
+     * API base path (e.g. `/api/data`)
+     */
+    basePath: string;
+}
+
+export type { StackRouterConfig as S, StackApiConfig as a, StackRouter as b };

package/dist/shared/stack.aqVZ6PEW.d.mts

@@ -0,0 +1,67 @@
+import { ComponentType } from 'react';
+
+/**
+ * Framework routing primitives shared by all plugins.
+ *
+ * Providing these fields once via the top-level `router` prop on
+ * `StackProvider` makes them available to every plugin.
+ */
+interface StackRouter {
+    /**
+     * Link component for navigation
+     */
+    Link?: ComponentType<React.ComponentProps<"a"> & Record<string, any>>;
+    /**
+     * Image component for displaying images
+     */
+    Image?: ComponentType<React.ImgHTMLAttributes<HTMLImageElement> & Record<string, any>>;
+    /**
+     * Navigation function for programmatic navigation
+     */
+    navigate?: (path: string) => void | Promise<void>;
+    /**
+     * Refresh function to invalidate server-side cache (e.g., Next.js router.refresh())
+     */
+    refresh?: () => void | Promise<void>;
+    /**
+     * Read the current URL search params
+     */
+    getSearchParams?: () => URLSearchParams;
+    /**
+     * Replace the current URL search params
+     */
+    setSearchParams?: (next: URLSearchParams, opts?: {
+        replace?: boolean;
+    }) => void;
+}
+/**
+ * Config accepted by the `router` prop on `StackProvider`.
+ *
+ * Framework presets (`nextRouter()`, `reactRouter()`, `tanstackRouter()`) are
+ * plain objects created anywhere — including module scope — so fields that
+ * need framework hooks are produced by the optional `useRouter` hook, which
+ * `StackProvider` evaluates internally. Hook results are merged over the
+ * static fields.
+ */
+interface StackRouterConfig extends StackRouter {
+    /**
+     * Optional hook evaluated inside `StackProvider`. Use this for router
+     * fields that must be derived from framework hooks (e.g. `useNavigate`).
+     */
+    useRouter?: () => StackRouter;
+}
+/**
+ * Top-level API config used by all plugin components.
+ */
+interface StackApiConfig {
+    /**
+     * API base URL (e.g. `https://example.com`)
+     */
+    baseURL: string;
+    /**
+     * API base path (e.g. `/api/data`)
+     */
+    basePath: string;
+}
+
+export type { StackRouterConfig as S, StackApiConfig as a, StackRouter as b };