@btst/stack 2.12.2 → 3.0.0-rc.2

package/dist/shared/{stack.Cbsrl06u.d.cts → stack.BjvOk_Bs.d.cts}

@@ -1,9 +1,9 @@
-import * as _tanstack_react_query from '@tanstack/react-query';
+import * as _btst_stack_plugins_client from '@btst/stack/plugins/client';
 import { createApiClient } from '@btst/stack/plugins/client';
-import { M as Message, C as Conversation, S as SerializedConversation, a as SerializedMessage } from './stack.Be1QIHEn.cjs';
 import * as _btst_stack_plugins_api from '@btst/stack/plugins/api';
 import * as better_call from 'better-call';
 import { Tool, LanguageModel } from 'ai';
+import { M as Message, C as Conversation, S as SerializedConversation, a as SerializedMessage } from './stack.Be1QIHEn.cjs';
 
 /**
  * Context passed to AI Chat API hooks
@@ -313,9 +313,9 @@ declare const aiChatBackendPlugin: <TTools extends Record<string, Tool> = Record
     updateConversation: better_call.StrictEndpoint<"/chat/conversations/:id", {} & {
         method: "PUT";
         body: better_call.StandardSchemaV1<{
-            title?: string | undefined;
+            title: string;
         }, {
-            title?: string | undefined;
+            title: string;
         }>;
     }, Conversation>;
     deleteConversation: better_call.StrictEndpoint<"/chat/conversations/:id", {} & {
@@ -335,28 +335,158 @@ type AiChatApiRouter = ReturnType<ReturnType<typeof aiChatBackendPlugin>["routes
 type ConversationWithMessages = SerializedConversation & {
     messages: SerializedMessage[];
 };
-declare function createAiChatQueryKeys(client: ReturnType<typeof createApiClient<AiChatApiRouter>>, headers?: HeadersInit): {
+interface CreateConversationInput {
+    id?: string;
+    title?: string;
+}
+interface RenameConversationInput {
+    id: string;
+    title: string;
+}
+/** Single source of truth for conversation HTTP mappings and cache behavior. */
+declare const aiChatResources: {
     conversations: {
-        _def: readonly ["conversations"];
-    } & {
-        list: (() => Omit<{
-            queryKey: readonly ["conversations", "list", string];
-            queryFn: _tanstack_react_query.QueryFunction<SerializedConversation[], readonly ["conversations", "list", string]>;
-        } & {
-            _def: readonly ["conversations", "list"];
-        }, "_def">) & {
-            _def: readonly ["conversations", "list"];
+        queries: {
+            list: {
+                path: string;
+                key: () => string[];
+                select: (data: any) => SerializedConversation[];
+            };
+            detail: {
+                path: string;
+                params: (id: string) => {
+                    id: string;
+                };
+                key: (id: string) => string[];
+                select: (data: any) => ConversationWithMessages | null;
+                skip: (id: string) => boolean;
+            };
         };
-        detail: ((id: string) => Omit<{
-            queryKey: readonly ["conversations", "detail", string];
-            queryFn: _tanstack_react_query.QueryFunction<ConversationWithMessages | null, readonly ["conversations", "detail", string]>;
-        } & {
-            _def: readonly ["conversations", "detail"];
-        }, "_def">) & {
-            _def: readonly ["conversations", "detail"];
+        mutations: {
+            create: {
+                path: string;
+                method: "POST";
+                input: (input: CreateConversationInput) => {
+                    body: CreateConversationInput;
+                };
+                select: (data: any) => SerializedConversation | null;
+                invalidates: string[];
+            };
+            rename: {
+                path: string;
+                method: "PUT";
+                input: (input: RenameConversationInput) => {
+                    params: {
+                        id: string;
+                    };
+                    body: {
+                        title: string;
+                    };
+                };
+                select: (data: any) => SerializedConversation | null;
+                invalidates: string[];
+                setData: {
+                    args: (result: SerializedConversation | null) => string[] | null;
+                    updater: (previous: unknown, result: SerializedConversation | null) => unknown;
+                };
+            };
+            delete: {
+                path: string;
+                method: "DELETE";
+                input: (input: {
+                    id: string;
+                }) => {
+                    params: {
+                        id: string;
+                    };
+                };
+                select: (data: any) => {
+                    success: boolean;
+                };
+                invalidates: string[];
+                removeData: {
+                    args: (_result: {
+                        success: boolean;
+                    }, input: {
+                        id: string;
+                    }) => string[];
+                };
+            };
         };
     };
 };
+declare function createAiChatQueryKeys(client: ReturnType<typeof createApiClient<AiChatApiRouter>>, headers?: HeadersInit): _btst_stack_plugins_client.ResourceQueryKeys<{
+    conversations: {
+        queries: {
+            list: {
+                path: string;
+                key: () => string[];
+                select: (data: any) => SerializedConversation[];
+            };
+            detail: {
+                path: string;
+                params: (id: string) => {
+                    id: string;
+                };
+                key: (id: string) => string[];
+                select: (data: any) => ConversationWithMessages | null;
+                skip: (id: string) => boolean;
+            };
+        };
+        mutations: {
+            create: {
+                path: string;
+                method: "POST";
+                input: (input: CreateConversationInput) => {
+                    body: CreateConversationInput;
+                };
+                select: (data: any) => SerializedConversation | null;
+                invalidates: string[];
+            };
+            rename: {
+                path: string;
+                method: "PUT";
+                input: (input: RenameConversationInput) => {
+                    params: {
+                        id: string;
+                    };
+                    body: {
+                        title: string;
+                    };
+                };
+                select: (data: any) => SerializedConversation | null;
+                invalidates: string[];
+                setData: {
+                    args: (result: SerializedConversation | null) => string[] | null;
+                    updater: (previous: unknown, result: SerializedConversation | null) => unknown;
+                };
+            };
+            delete: {
+                path: string;
+                method: "DELETE";
+                input: (input: {
+                    id: string;
+                }) => {
+                    params: {
+                        id: string;
+                    };
+                };
+                select: (data: any) => {
+                    success: boolean;
+                };
+                invalidates: string[];
+                removeData: {
+                    args: (_result: {
+                        success: boolean;
+                    }, input: {
+                        id: string;
+                    }) => string[];
+                };
+            };
+        };
+    };
+}>;
+type AiChatQueryKeys = ReturnType<typeof createAiChatQueryKeys>;
 
-export { createAiChatQueryKeys as c, aiChatBackendPlugin as d };
-export type { AiChatBackendHooks as A, ChatApiContext as C, AiChatMode as a, AiChatBackendConfig as b, AiChatApiRouter as e, ConversationWithMessages as f };
+export { aiChatResources as a, createAiChatQueryKeys as c, aiChatBackendPlugin as h };
+export type { AiChatQueryKeys as A, ConversationWithMessages as C, RenameConversationInput as R, CreateConversationInput as b, ChatApiContext as d, AiChatBackendHooks as e, AiChatMode as f, AiChatBackendConfig as g, AiChatApiRouter as i };

package/dist/shared/{stack.CQnwAN7x.d.mts → stack.BqTR6qi2.d.ts}

@@ -1,6 +1,7 @@
 import { Route, createRouter } from '@btst/yar';
 import { DBAdapter, DbPlugin, DatabaseDefinition } from '@btst/db';
 import { Endpoint, Router } from 'better-call';
+import { S as StackServerAuthProvider } from './stack.C4_gEENS.js';
 
 /**
  * Context passed to backend plugins during route creation
@@ -13,6 +14,8 @@ interface StackContext {
     basePath: string;
     /** The database adapter */
     adapter: DBAdapter;
+    /** The server-side auth provider, when configured on `stack()` */
+    auth?: StackServerAuthProvider;
 }
 /**
  * Context passed to client plugins during route creation
@@ -100,6 +103,13 @@ interface BackendLibConfig<TPlugins extends Record<string, BackendPlugin<any, an
     dbSchema?: DatabaseDefinition;
     plugins: TPlugins;
     adapter: (db: DatabaseDefinition) => DBAdapter;
+    /**
+     * Optional server-side auth provider. When set, `stack()` resolves the
+     * request identity lazily and at most once per request; plugin lifecycle
+     * hooks and route handlers can read it via `getRequestIdentity(headers)`
+     * from `@btst/stack/api`. When omitted, behavior is unchanged.
+     */
+    auth?: StackServerAuthProvider;
 }
 /**
  * Configuration for creating the client library

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

@@ -0,0 +1,406 @@
+import * as _btst_stack_plugins_api from '@btst/stack/plugins/api';
+import { a as SerializedContentItemWithType, S as SerializedContentType, C as ContentType, b as ContentItem, c as SerializedContentItem, d as ContentItemWithType, e as CMSBackendConfig, I as InverseRelation } from './stack.aXdBOJAR.cjs';
+import * as better_call from 'better-call';
+import { z } from 'zod';
+import { DBAdapter } from '@btst/db';
+import { QueryClient } from '@tanstack/react-query';
+
+/**
+ * Serialize a ContentType for SSR/SSG use (convert dates to strings).
+ * Applies lazy migration for legacy schemas (version 1 → 2).
+ */
+declare function serializeContentType(ct: ContentType): SerializedContentType;
+/**
+ * Serialize a ContentItem for SSR/SSG use (convert dates to strings).
+ */
+declare function serializeContentItem(item: ContentItem): SerializedContentItem;
+/**
+ * Serialize a ContentItem with parsed data and joined ContentType.
+ * Throws a SyntaxError if `item.data` is not valid JSON, so corrupted rows
+ * produce a visible, debuggable error rather than silently returning null.
+ */
+declare function serializeContentItemWithType(item: ContentItemWithType): SerializedContentItemWithType;
+/**
+ * Retrieve all content types.
+ * Pure DB function — no hooks, no HTTP context. Safe for SSG and server-side use.
+ *
+ * @remarks **Security:** Authorization hooks are NOT called. The caller is
+ * responsible for any access-control checks before invoking this function.
+ *
+ * @param adapter - The database adapter
+ */
+declare function getAllContentTypes(adapter: DBAdapter): Promise<SerializedContentType[]>;
+/**
+ * Retrieve all content items for a given content type, with optional pagination
+ * and free-text search.
+ * Pure DB function — no hooks, no HTTP context. Safe for SSG and server-side use.
+ *
+ * @remarks **Security:** Authorization hooks (e.g. `onBeforeListItems`) are NOT
+ * called. The caller is responsible for any access-control checks before
+ * invoking this function.
+ *
+ * @param adapter - The database adapter
+ * @param contentTypeSlug - The slug of the content type to query
+ * @param params - Optional filter/pagination parameters. `search` matches
+ * case-insensitively against item slugs and string values in the item data.
+ */
+declare function getAllContentItems(adapter: DBAdapter, contentTypeSlug: string, params?: {
+    slug?: string;
+    limit?: number;
+    offset?: number;
+    search?: string;
+}): Promise<{
+    items: SerializedContentItemWithType[];
+    total: number;
+    limit?: number;
+    offset?: number;
+}>;
+/**
+ * Retrieve a single content item by its ID.
+ * Returns null if the item is not found.
+ * Pure DB function — no hooks, no HTTP context. Safe for SSG and server-side use.
+ *
+ * @remarks **Security:** Authorization hooks are NOT called. The caller is
+ * responsible for any access-control checks before invoking this function.
+ *
+ * @param adapter - The database adapter
+ * @param id - The content item ID (UUID)
+ */
+declare function getContentItemById(adapter: DBAdapter, id: string): Promise<SerializedContentItemWithType | null>;
+/**
+ * Retrieve a single content item by its slug within a content type.
+ * Returns null if the content type or item is not found.
+ * Pure DB function — no hooks, no HTTP context. Safe for SSG and server-side use.
+ *
+ * @remarks **Security:** Authorization hooks are NOT called. The caller is
+ * responsible for any access-control checks before invoking this function.
+ *
+ * @param adapter - The database adapter
+ * @param contentTypeSlug - The slug of the content type
+ * @param slug - The slug of the content item
+ */
+declare function getContentItemBySlug(adapter: DBAdapter, contentTypeSlug: string, slug: string): Promise<SerializedContentItemWithType | null>;
+
+/**
+ * Input for creating a new CMS content item.
+ */
+interface CreateCMSContentItemInput {
+    /** URL-safe slug for the item */
+    slug: string;
+    /** Arbitrary data payload — should match the content type schema */
+    data: Record<string, unknown>;
+}
+/**
+ * Options for {@link createCMSContentItem}.
+ */
+interface CreateCMSContentItemOptions {
+    /**
+     * When `true`, persist relation fields (`belongsTo`, `hasMany`,
+     * `manyToMany`) into the `contentRelation` junction table in addition to
+     * the item's JSON payload.
+     *
+     * This is what the HTTP `POST /content/:typeSlug` route does, and is
+     * required for the admin "Related Items" panel / inverse-relation queries
+     * to find the item.
+     *
+     * Seeds and other programmatic callers that want the admin UI to work
+     * should enable this flag. Callers are still expected to pass
+     * pre-created target IDs (`{ id }` or `[{ id }, ...]`) — inline `_new`
+     * creation is only supported via the HTTP route.
+     *
+     * Defaults to `false` for backwards compatibility (a no-op for content
+     * types without relations).
+     */
+    syncRelations?: boolean;
+}
+/**
+ * Create a new content item for a content type (looked up by slug).
+ *
+ * Bypasses Zod schema validation and inline `_new` relation creation — the
+ * caller is responsible for providing valid data and pre-created relation
+ * IDs. For schema validation or inline creation of related items, use the
+ * HTTP endpoint instead.
+ *
+ * Throws if the content type is not found or the slug is already taken within
+ * that content type.
+ *
+ * @remarks **Security:** No authorization hooks (`onBeforeCreate`, `onAfterCreate`)
+ * are called. The caller is responsible for any access-control checks before
+ * invoking this function.
+ *
+ * @param adapter - The database adapter
+ * @param contentTypeSlug - Slug of the target content type
+ * @param input - Item slug and data payload
+ * @param options - See {@link CreateCMSContentItemOptions}. Pass
+ *   `{ syncRelations: true }` to also populate the `contentRelation`
+ *   junction table for relation fields in the payload.
+ */
+declare function createCMSContentItem(adapter: DBAdapter, contentTypeSlug: string, input: CreateCMSContentItemInput, options?: CreateCMSContentItemOptions): Promise<SerializedContentItem>;
+
+/**
+ * Route keys for the CMS plugin — matches the keys returned by
+ * `stackClient.router.getRoute(path).routeKey`.
+ */
+type CMSRouteKey = "dashboard" | "contentList" | "newContent" | "editContent";
+interface CMSPrefetchForRoute {
+    (key: "dashboard" | "newContent", qc: QueryClient): Promise<void>;
+    (key: "contentList", qc: QueryClient, params: {
+        typeSlug: string;
+    }): Promise<void>;
+    (key: "editContent", qc: QueryClient, params: {
+        typeSlug: string;
+        id: string;
+    }): Promise<void>;
+}
+/**
+ * CMS backend plugin
+ * Provides API endpoints for managing content types and content items
+ *
+ * @param config - Configuration with content types and optional hooks
+ */
+declare const cmsBackendPlugin: (config: CMSBackendConfig) => _btst_stack_plugins_api.BackendPlugin<{
+    listContentTypes: better_call.StrictEndpoint<"/content-types", {} & {
+        method: "GET";
+    }, {
+        itemCount: number;
+        createdAt: string;
+        updatedAt: string;
+        name: string;
+        id: string;
+        slug: string;
+        description?: string | undefined;
+        jsonSchema: string;
+        fieldConfig?: string | undefined;
+        autoFormVersion?: number | undefined;
+    }[]>;
+    getContentTypeBySlug: better_call.StrictEndpoint<"/content-types/:slug", {
+        params: z.ZodObject<{
+            slug: z.ZodString;
+        }, z.core.$strip>;
+    } & {
+        method: "GET";
+    }, SerializedContentType>;
+    listContentItems: better_call.StrictEndpoint<"/content/:typeSlug", {
+        params: z.ZodObject<{
+            typeSlug: z.ZodString;
+        }, z.core.$strip>;
+    } & {
+        method: "GET";
+    } & {
+        query: better_call.StandardSchemaV1<{
+            slug?: string | undefined;
+            search?: string | undefined;
+            limit?: unknown;
+            offset?: unknown;
+        }, {
+            slug?: string | undefined;
+            search?: string | undefined;
+            limit?: unknown;
+            offset?: unknown;
+        }>;
+    }, {
+        items: SerializedContentItemWithType[];
+        total: number;
+        limit?: number;
+        offset?: number;
+    }>;
+    getContentItem: better_call.StrictEndpoint<"/content/:typeSlug/:id", {
+        params: z.ZodObject<{
+            typeSlug: z.ZodString;
+            id: z.ZodString;
+        }, z.core.$strip>;
+    } & {
+        method: "GET";
+    }, SerializedContentItemWithType<Record<string, unknown>>>;
+    createContentItem: better_call.StrictEndpoint<"/content/:typeSlug", {
+        params: z.ZodObject<{
+            typeSlug: z.ZodString;
+        }, z.core.$strip>;
+    } & {
+        method: "POST";
+        body: better_call.StandardSchemaV1<{
+            slug: string;
+            data: {
+                [x: string]: unknown;
+            };
+        }, {
+            slug: string;
+            data: {
+                [x: string]: unknown;
+            };
+        }>;
+    }, {
+        parsedData: Record<string, unknown>;
+        createdAt: string;
+        updatedAt: string;
+        id: string;
+        slug: string;
+        contentTypeId: string;
+        data: string;
+        authorId?: string | undefined;
+    }>;
+    updateContentItem: better_call.StrictEndpoint<"/content/:typeSlug/:id", {
+        params: z.ZodObject<{
+            typeSlug: z.ZodString;
+            id: z.ZodString;
+        }, z.core.$strip>;
+    } & {
+        method: "PUT";
+        body: better_call.StandardSchemaV1<{
+            slug?: string | undefined;
+            data?: {
+                [x: string]: unknown;
+            } | undefined;
+        }, {
+            slug?: string | undefined;
+            data?: {
+                [x: string]: unknown;
+            } | undefined;
+        }>;
+    }, SerializedContentItemWithType<Record<string, unknown>>>;
+    deleteContentItem: better_call.StrictEndpoint<"/content/:typeSlug/:id", {
+        params: z.ZodObject<{
+            typeSlug: z.ZodString;
+            id: z.ZodString;
+        }, z.core.$strip>;
+    } & {
+        method: "DELETE";
+        body: better_call.StandardSchemaV1<unknown, unknown>;
+    }, {
+        success: boolean;
+    }>;
+    getContentItemPopulated: better_call.StrictEndpoint<"/content/:typeSlug/:id/populated", {
+        params: z.ZodObject<{
+            typeSlug: z.ZodString;
+            id: z.ZodString;
+        }, z.core.$strip>;
+    } & {
+        method: "GET";
+    }, {
+        _relations: Record<string, SerializedContentItemWithType<Record<string, unknown>>[]>;
+        parsedData: Record<string, unknown>;
+        contentType?: SerializedContentType;
+        createdAt: string;
+        updatedAt: string;
+        id: string;
+        slug: string;
+        contentTypeId: string;
+        data: string;
+        authorId?: string | undefined;
+    }>;
+    listContentByRelation: better_call.StrictEndpoint<"/content/:typeSlug/by-relation", {
+        params: z.ZodObject<{
+            typeSlug: z.ZodString;
+        }, z.core.$strip>;
+    } & {
+        method: "GET";
+    } & {
+        query: better_call.StandardSchemaV1<{
+            field: string;
+            targetId: string;
+            limit?: unknown;
+            offset?: unknown;
+        }, {
+            field: string;
+            targetId: string;
+            limit?: unknown;
+            offset?: unknown;
+        }>;
+    }, {
+        items: SerializedContentItemWithType<Record<string, unknown>>[];
+        total: number;
+        limit: number;
+        offset: number;
+    }>;
+    getInverseRelations: better_call.StrictEndpoint<"/content-types/:slug/inverse-relations", {
+        params: z.ZodObject<{
+            slug: z.ZodString;
+        }, z.core.$strip>;
+    } & {
+        method: "GET";
+    } & {
+        query: better_call.StandardSchemaV1<{
+            itemId?: string | undefined;
+        }, {
+            itemId?: string | undefined;
+        }>;
+    }, {
+        inverseRelations: InverseRelation[];
+    }>;
+    listInverseRelationItems: better_call.StrictEndpoint<"/content-types/:slug/inverse-relations/:sourceType", {
+        params: z.ZodObject<{
+            slug: z.ZodString;
+            sourceType: z.ZodString;
+        }, z.core.$strip>;
+    } & {
+        method: "GET";
+    } & {
+        query: better_call.StandardSchemaV1<{
+            itemId: string;
+            fieldName: string;
+            limit?: unknown;
+            offset?: unknown;
+        }, {
+            itemId: string;
+            fieldName: string;
+            limit?: unknown;
+            offset?: unknown;
+        }>;
+    }, {
+        items: SerializedContentItemWithType<Record<string, unknown>>[];
+        total: number;
+        limit: number;
+        offset: number;
+    }>;
+}, {
+    getAllContentTypes: () => Promise<SerializedContentType[]>;
+    getAllContentItems: (contentTypeSlug: string, params?: Parameters<typeof getAllContentItems>[2]) => Promise<{
+        items: SerializedContentItemWithType[];
+        total: number;
+        limit?: number;
+        offset?: number;
+    }>;
+    getContentItemBySlug: (contentTypeSlug: string, slug: string) => Promise<SerializedContentItemWithType<Record<string, unknown>> | null>;
+    getContentItemById: (id: string) => Promise<SerializedContentItemWithType<Record<string, unknown>> | null>;
+    prefetchForRoute: CMSPrefetchForRoute;
+    createContentItem: (typeSlug: string, input: Parameters<typeof createCMSContentItem>[2], options?: Parameters<typeof createCMSContentItem>[3]) => Promise<SerializedContentItem>;
+}>;
+type CMSApiRouter = ReturnType<ReturnType<typeof cmsBackendPlugin>["routes"]>;
+
+/**
+ * Internal query key constants for the CMS plugin.
+ * Shared between query-keys.ts (HTTP path) and prefetchForRoute (DB path)
+ * to prevent key drift between SSR loaders and SSG prefetching.
+ */
+interface ContentListDiscriminator {
+    typeSlug: string;
+    limit: number;
+    offset: number;
+    search: string | undefined;
+}
+/** Full query key builders — use these with queryClient.setQueryData() */
+declare const CMS_QUERY_KEYS: {
+    /**
+     * Key for the cmsTypes.list() query.
+     * Full key: ["cmsTypes", "list", "list"]
+     */
+    typesList: () => readonly ["cmsTypes", "list", "list"];
+    /**
+     * Key for the cmsContent.list({ typeSlug, limit, offset }) query.
+     * Full key: ["cmsContent", "list", { typeSlug, limit, offset, search }]
+     */
+    contentList: (params: {
+        typeSlug: string;
+        limit?: number;
+        offset?: number;
+        search?: string;
+    }) => readonly ["cmsContent", "list", ContentListDiscriminator];
+    /**
+     * Key for the cmsContent.detail(typeSlug, id) query.
+     * Full key: ["cmsContent", "detail", typeSlug, id]
+     */
+    contentDetail: (typeSlug: string, id: string) => readonly ["cmsContent", "detail", string, string];
+};
+
+export { cmsBackendPlugin as c, getAllContentItems as d, getContentItemBySlug as e, getContentItemById as f, getAllContentTypes as g, serializeContentItem as h, serializeContentItemWithType as i, createCMSContentItem as j, CMS_QUERY_KEYS as m, serializeContentType as s };
+export type { ContentListDiscriminator as C, CMSApiRouter as a, CMSRouteKey as b, CreateCMSContentItemInput as k, CreateCMSContentItemOptions as l };

package/dist/shared/stack.Bz-YPsuX.d.cts

@@ -0,0 +1,5 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+declare function NewPostPageComponent(): react_jsx_runtime.JSX.Element;
+
+export { NewPostPageComponent as N };

package/dist/shared/stack.Bz-YPsuX.d.mts

@@ -0,0 +1,5 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+declare function NewPostPageComponent(): react_jsx_runtime.JSX.Element;
+
+export { NewPostPageComponent as N };

package/dist/shared/stack.Bz-YPsuX.d.ts

@@ -0,0 +1,5 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+declare function NewPostPageComponent(): react_jsx_runtime.JSX.Element;
+
+export { NewPostPageComponent as N };