@btst/stack 2.0.1 → 2.2.0

package/dist/plugins/ui-builder/client/components/index.d.mts

@@ -1,5 +1,5 @@
 import { ComponentType, ReactNode } from 'react';
-import { a as ComponentRegistry, P as PropValue } from '../../../../shared/stack.ChVuHi5e.mjs';
+import { a as ComponentRegistry, P as PropValue } from '../../../../shared/stack.D1DMlJp-.mjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import 'zod';
 import '../../../../shared/stack.8nldKomx.mjs';

package/dist/plugins/ui-builder/client/components/index.d.ts

@@ -1,5 +1,5 @@
 import { ComponentType, ReactNode } from 'react';
-import { a as ComponentRegistry, P as PropValue } from '../../../../shared/stack.EhM4pmtN.js';
+import { a as ComponentRegistry, P as PropValue } from '../../../../shared/stack.GygI_T3X.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import 'zod';
 import '../../../../shared/stack.8nldKomx.js';

package/dist/plugins/ui-builder/client/hooks/index.d.cts

@@ -1,6 +1,6 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
-import { S as SerializedUIBuilderPage } from '../../../../shared/stack.BYysGdHl.cjs';
-import { C as ComponentLayer, V as Variable } from '../../../../shared/stack.BdJFrdyt.cjs';
+import { S as SerializedUIBuilderPage } from '../../../../shared/stack.C-WUPMT6.cjs';
+import { C as ComponentLayer, V as Variable } from '../../../../shared/stack.B-YHz18S.cjs';
 import 'zod';
 import 'react';
 import '../../../../shared/stack.8nldKomx.cjs';

package/dist/plugins/ui-builder/client/hooks/index.d.mts

@@ -1,6 +1,6 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
-import { S as SerializedUIBuilderPage } from '../../../../shared/stack.DYCFcnkL.mjs';
-import { C as ComponentLayer, V as Variable } from '../../../../shared/stack.ChVuHi5e.mjs';
+import { S as SerializedUIBuilderPage } from '../../../../shared/stack.6fUOjLs9.mjs';
+import { C as ComponentLayer, V as Variable } from '../../../../shared/stack.D1DMlJp-.mjs';
 import 'zod';
 import 'react';
 import '../../../../shared/stack.8nldKomx.mjs';

package/dist/plugins/ui-builder/client/hooks/index.d.ts

@@ -1,6 +1,6 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
-import { S as SerializedUIBuilderPage } from '../../../../shared/stack.kFbDspnF.js';
-import { C as ComponentLayer, V as Variable } from '../../../../shared/stack.EhM4pmtN.js';
+import { S as SerializedUIBuilderPage } from '../../../../shared/stack.C-Ptrz8s.js';
+import { C as ComponentLayer, V as Variable } from '../../../../shared/stack.GygI_T3X.js';
 import 'zod';
 import 'react';
 import '../../../../shared/stack.8nldKomx.js';

package/dist/plugins/ui-builder/client/index.d.cts

@@ -3,10 +3,10 @@ import * as react from 'react';
 import react__default, { ComponentType } from 'react';
 import * as _btst_yar from '@btst/yar';
 import { QueryClient } from '@tanstack/react-query';
-import { c as UIBuilderClientHooks } from '../../../shared/stack.BYysGdHl.cjs';
-import { a as ComponentRegistry, F as FieldConfigFunction, C as ComponentLayer } from '../../../shared/stack.BdJFrdyt.cjs';
+import { c as UIBuilderClientHooks } from '../../../shared/stack.C-WUPMT6.cjs';
+import { a as ComponentRegistry, F as FieldConfigFunction, C as ComponentLayer } from '../../../shared/stack.B-YHz18S.cjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { F as FieldConfigItem, A as AutoFormInputComponentProps } from '../../../shared/stack.8nldKomx.cjs';
+import { A as AutoFormInputComponentProps, F as FieldConfigItem } from '../../../shared/stack.8nldKomx.cjs';
 export { PageBuilderPage, PageListPage, PageRenderer, PageRendererProps, SuspensePageRenderer } from './components/index.cjs';
 export { CreateUIBuilderPageInput, UpdateUIBuilderPageInput, UseUIBuilderPagesOptions, UseUIBuilderPagesResult, useCreateUIBuilderPage, useDeleteUIBuilderPage, useSuspenseUIBuilderPage, useSuspenseUIBuilderPageBySlug, useSuspenseUIBuilderPages, useUIBuilderPage, useUIBuilderPageBySlug, useUIBuilderPages, useUpdateUIBuilderPage } from './hooks/index.cjs';
 import 'zod';
@@ -200,7 +200,12 @@ declare const defaultComponentRegistry: ComponentRegistry;
 declare function createComponentRegistry(components: ComponentRegistry): ComponentRegistry;
 
 declare const classNameFieldOverrides: FieldConfigFunction;
-declare const childrenFieldOverrides: FieldConfigFunction;
+declare const childrenFieldOverrides: (layer: ComponentLayer, allowVariableBinding?: boolean) => {
+    renderParent: (({ children }: {
+        children: react__default.ReactNode;
+    }) => react_jsx_runtime.JSX.Element) | undefined;
+    fieldType: ({ label, isRequired, fieldConfigItem, field, fieldProps, }: AutoFormInputComponentProps) => react_jsx_runtime.JSX.Element;
+};
 declare const iconNameFieldOverrides: FieldConfigFunction;
 declare const childrenAsTextareaFieldOverrides: (layer: ComponentLayer, allowVariableBinding?: boolean) => {
     renderParent: (({ children }: {
@@ -214,9 +219,14 @@ declare const childrenAsTipTapFieldOverrides: (layer: ComponentLayer, allowVaria
     }) => react_jsx_runtime.JSX.Element) | undefined;
     fieldType: ({ label, isRequired, fieldConfigItem, field, fieldProps, }: AutoFormInputComponentProps) => react_jsx_runtime.JSX.Element;
 };
-declare const commonFieldOverrides: (allowBinding?: boolean) => Record<string, FieldConfigFunction> | {
+declare const commonFieldOverrides: (allowBinding?: boolean) => Record<string, (layer: ComponentLayer) => ReturnType<FieldConfigFunction>> | {
     className: (layer: ComponentLayer) => FieldConfigItem;
-    children: (layer: ComponentLayer) => FieldConfigItem;
+    children: (layer: ComponentLayer) => {
+        renderParent: (({ children }: {
+            children: react__default.ReactNode;
+        }) => react_jsx_runtime.JSX.Element) | undefined;
+        fieldType: ({ label, isRequired, fieldConfigItem, field, fieldProps, }: AutoFormInputComponentProps) => react_jsx_runtime.JSX.Element;
+    };
 };
 
 /**

package/dist/plugins/ui-builder/client/index.d.mts

@@ -3,10 +3,10 @@ import * as react from 'react';
 import react__default, { ComponentType } from 'react';
 import * as _btst_yar from '@btst/yar';
 import { QueryClient } from '@tanstack/react-query';
-import { c as UIBuilderClientHooks } from '../../../shared/stack.DYCFcnkL.mjs';
-import { a as ComponentRegistry, F as FieldConfigFunction, C as ComponentLayer } from '../../../shared/stack.ChVuHi5e.mjs';
+import { c as UIBuilderClientHooks } from '../../../shared/stack.6fUOjLs9.mjs';
+import { a as ComponentRegistry, F as FieldConfigFunction, C as ComponentLayer } from '../../../shared/stack.D1DMlJp-.mjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { F as FieldConfigItem, A as AutoFormInputComponentProps } from '../../../shared/stack.8nldKomx.mjs';
+import { A as AutoFormInputComponentProps, F as FieldConfigItem } from '../../../shared/stack.8nldKomx.mjs';
 export { PageBuilderPage, PageListPage, PageRenderer, PageRendererProps, SuspensePageRenderer } from './components/index.mjs';
 export { CreateUIBuilderPageInput, UpdateUIBuilderPageInput, UseUIBuilderPagesOptions, UseUIBuilderPagesResult, useCreateUIBuilderPage, useDeleteUIBuilderPage, useSuspenseUIBuilderPage, useSuspenseUIBuilderPageBySlug, useSuspenseUIBuilderPages, useUIBuilderPage, useUIBuilderPageBySlug, useUIBuilderPages, useUpdateUIBuilderPage } from './hooks/index.mjs';
 import 'zod';
@@ -200,7 +200,12 @@ declare const defaultComponentRegistry: ComponentRegistry;
 declare function createComponentRegistry(components: ComponentRegistry): ComponentRegistry;
 
 declare const classNameFieldOverrides: FieldConfigFunction;
-declare const childrenFieldOverrides: FieldConfigFunction;
+declare const childrenFieldOverrides: (layer: ComponentLayer, allowVariableBinding?: boolean) => {
+    renderParent: (({ children }: {
+        children: react__default.ReactNode;
+    }) => react_jsx_runtime.JSX.Element) | undefined;
+    fieldType: ({ label, isRequired, fieldConfigItem, field, fieldProps, }: AutoFormInputComponentProps) => react_jsx_runtime.JSX.Element;
+};
 declare const iconNameFieldOverrides: FieldConfigFunction;
 declare const childrenAsTextareaFieldOverrides: (layer: ComponentLayer, allowVariableBinding?: boolean) => {
     renderParent: (({ children }: {
@@ -214,9 +219,14 @@ declare const childrenAsTipTapFieldOverrides: (layer: ComponentLayer, allowVaria
     }) => react_jsx_runtime.JSX.Element) | undefined;
     fieldType: ({ label, isRequired, fieldConfigItem, field, fieldProps, }: AutoFormInputComponentProps) => react_jsx_runtime.JSX.Element;
 };
-declare const commonFieldOverrides: (allowBinding?: boolean) => Record<string, FieldConfigFunction> | {
+declare const commonFieldOverrides: (allowBinding?: boolean) => Record<string, (layer: ComponentLayer) => ReturnType<FieldConfigFunction>> | {
     className: (layer: ComponentLayer) => FieldConfigItem;
-    children: (layer: ComponentLayer) => FieldConfigItem;
+    children: (layer: ComponentLayer) => {
+        renderParent: (({ children }: {
+            children: react__default.ReactNode;
+        }) => react_jsx_runtime.JSX.Element) | undefined;
+        fieldType: ({ label, isRequired, fieldConfigItem, field, fieldProps, }: AutoFormInputComponentProps) => react_jsx_runtime.JSX.Element;
+    };
 };
 
 /**

package/dist/plugins/ui-builder/client/index.d.ts

@@ -3,10 +3,10 @@ import * as react from 'react';
 import react__default, { ComponentType } from 'react';
 import * as _btst_yar from '@btst/yar';
 import { QueryClient } from '@tanstack/react-query';
-import { c as UIBuilderClientHooks } from '../../../shared/stack.kFbDspnF.js';
-import { a as ComponentRegistry, F as FieldConfigFunction, C as ComponentLayer } from '../../../shared/stack.EhM4pmtN.js';
+import { c as UIBuilderClientHooks } from '../../../shared/stack.C-Ptrz8s.js';
+import { a as ComponentRegistry, F as FieldConfigFunction, C as ComponentLayer } from '../../../shared/stack.GygI_T3X.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { F as FieldConfigItem, A as AutoFormInputComponentProps } from '../../../shared/stack.8nldKomx.js';
+import { A as AutoFormInputComponentProps, F as FieldConfigItem } from '../../../shared/stack.8nldKomx.js';
 export { PageBuilderPage, PageListPage, PageRenderer, PageRendererProps, SuspensePageRenderer } from './components/index.js';
 export { CreateUIBuilderPageInput, UpdateUIBuilderPageInput, UseUIBuilderPagesOptions, UseUIBuilderPagesResult, useCreateUIBuilderPage, useDeleteUIBuilderPage, useSuspenseUIBuilderPage, useSuspenseUIBuilderPageBySlug, useSuspenseUIBuilderPages, useUIBuilderPage, useUIBuilderPageBySlug, useUIBuilderPages, useUpdateUIBuilderPage } from './hooks/index.js';
 import 'zod';
@@ -200,7 +200,12 @@ declare const defaultComponentRegistry: ComponentRegistry;
 declare function createComponentRegistry(components: ComponentRegistry): ComponentRegistry;
 
 declare const classNameFieldOverrides: FieldConfigFunction;
-declare const childrenFieldOverrides: FieldConfigFunction;
+declare const childrenFieldOverrides: (layer: ComponentLayer, allowVariableBinding?: boolean) => {
+    renderParent: (({ children }: {
+        children: react__default.ReactNode;
+    }) => react_jsx_runtime.JSX.Element) | undefined;
+    fieldType: ({ label, isRequired, fieldConfigItem, field, fieldProps, }: AutoFormInputComponentProps) => react_jsx_runtime.JSX.Element;
+};
 declare const iconNameFieldOverrides: FieldConfigFunction;
 declare const childrenAsTextareaFieldOverrides: (layer: ComponentLayer, allowVariableBinding?: boolean) => {
     renderParent: (({ children }: {
@@ -214,9 +219,14 @@ declare const childrenAsTipTapFieldOverrides: (layer: ComponentLayer, allowVaria
     }) => react_jsx_runtime.JSX.Element) | undefined;
     fieldType: ({ label, isRequired, fieldConfigItem, field, fieldProps, }: AutoFormInputComponentProps) => react_jsx_runtime.JSX.Element;
 };
-declare const commonFieldOverrides: (allowBinding?: boolean) => Record<string, FieldConfigFunction> | {
+declare const commonFieldOverrides: (allowBinding?: boolean) => Record<string, (layer: ComponentLayer) => ReturnType<FieldConfigFunction>> | {
     className: (layer: ComponentLayer) => FieldConfigItem;
-    children: (layer: ComponentLayer) => FieldConfigItem;
+    children: (layer: ComponentLayer) => {
+        renderParent: (({ children }: {
+            children: react__default.ReactNode;
+        }) => react_jsx_runtime.JSX.Element) | undefined;
+        fieldType: ({ label, isRequired, fieldConfigItem, field, fieldProps, }: AutoFormInputComponentProps) => react_jsx_runtime.JSX.Element;
+    };
 };
 
 /**

package/dist/plugins/ui-builder/index.d.cts

@@ -1,7 +1,7 @@
 import { z } from 'zod';
-import { C as ContentTypeConfig } from '../../shared/stack.BsXokfNh.cjs';
-export { L as LoaderContext, b as PaginatedUIBuilderPages, P as ParsedUIBuilderPage, S as SerializedUIBuilderPage, c as UIBuilderClientHooks, a as UIBuilderPage, U as UIBuilderPageData } from '../../shared/stack.BYysGdHl.cjs';
-export { C as ComponentLayer, a as ComponentRegistry, R as RegistryEntry, V as Variable } from '../../shared/stack.BdJFrdyt.cjs';
+import { C as ContentTypeConfig } from '../../shared/stack.CXjzTMsb.cjs';
+export { L as LoaderContext, b as PaginatedUIBuilderPages, P as ParsedUIBuilderPage, S as SerializedUIBuilderPage, c as UIBuilderClientHooks, a as UIBuilderPage, U as UIBuilderPageData } from '../../shared/stack.C-WUPMT6.cjs';
+export { C as ComponentLayer, a as ComponentRegistry, R as RegistryEntry, V as Variable } from '../../shared/stack.B-YHz18S.cjs';
 import 'react';
 import '../../shared/stack.8nldKomx.cjs';
 import 'react-hook-form';

package/dist/plugins/ui-builder/index.d.mts

@@ -1,7 +1,7 @@
 import { z } from 'zod';
-import { C as ContentTypeConfig } from '../../shared/stack.BsXokfNh.mjs';
-export { L as LoaderContext, b as PaginatedUIBuilderPages, P as ParsedUIBuilderPage, S as SerializedUIBuilderPage, c as UIBuilderClientHooks, a as UIBuilderPage, U as UIBuilderPageData } from '../../shared/stack.DYCFcnkL.mjs';
-export { C as ComponentLayer, a as ComponentRegistry, R as RegistryEntry, V as Variable } from '../../shared/stack.ChVuHi5e.mjs';
+import { C as ContentTypeConfig } from '../../shared/stack.CXjzTMsb.mjs';
+export { L as LoaderContext, b as PaginatedUIBuilderPages, P as ParsedUIBuilderPage, S as SerializedUIBuilderPage, c as UIBuilderClientHooks, a as UIBuilderPage, U as UIBuilderPageData } from '../../shared/stack.6fUOjLs9.mjs';
+export { C as ComponentLayer, a as ComponentRegistry, R as RegistryEntry, V as Variable } from '../../shared/stack.D1DMlJp-.mjs';
 import 'react';
 import '../../shared/stack.8nldKomx.mjs';
 import 'react-hook-form';

package/dist/plugins/ui-builder/index.d.ts

@@ -1,7 +1,7 @@
 import { z } from 'zod';
-import { C as ContentTypeConfig } from '../../shared/stack.BsXokfNh.js';
-export { L as LoaderContext, b as PaginatedUIBuilderPages, P as ParsedUIBuilderPage, S as SerializedUIBuilderPage, c as UIBuilderClientHooks, a as UIBuilderPage, U as UIBuilderPageData } from '../../shared/stack.kFbDspnF.js';
-export { C as ComponentLayer, a as ComponentRegistry, R as RegistryEntry, V as Variable } from '../../shared/stack.EhM4pmtN.js';
+import { C as ContentTypeConfig } from '../../shared/stack.CXjzTMsb.js';
+export { L as LoaderContext, b as PaginatedUIBuilderPages, P as ParsedUIBuilderPage, S as SerializedUIBuilderPage, c as UIBuilderClientHooks, a as UIBuilderPage, U as UIBuilderPageData } from '../../shared/stack.C-Ptrz8s.js';
+export { C as ComponentLayer, a as ComponentRegistry, R as RegistryEntry, V as Variable } from '../../shared/stack.GygI_T3X.js';
 import 'react';
 import '../../shared/stack.8nldKomx.js';
 import 'react-hook-form';

package/dist/shared/{stack.DYCFcnkL.d.mts → stack.6fUOjLs9.d.mts}

@@ -1,4 +1,4 @@
-import { C as ComponentLayer, V as Variable } from './stack.ChVuHi5e.mjs';
+import { C as ComponentLayer, V as Variable } from './stack.D1DMlJp-.mjs';
 
 /**
  * UI Builder Page data structure

package/dist/shared/{stack.BoA0xkJv.d.mts → stack.7n9Y_u7N.d.cts}

@@ -8,7 +8,7 @@ import { Endpoint, Router } from 'better-call';
  */
 interface StackContext {
     /** All registered backend plugins */
-    plugins: Record<string, BackendPlugin<any>>;
+    plugins: Record<string, BackendPlugin<any, any>>;
     /** The API base path (e.g., "/api/data") */
     basePath: string;
     /** The database adapter */
@@ -33,8 +33,11 @@ interface ClientStackContext<TPlugins extends Record<string, ClientPlugin<any, a
  * You can optionally provide a base schema via the dbSchema config option.
  *
  * @template TRoutes - The exact shape of routes this plugin provides (preserves keys and endpoint types)
+ * @template TApi - The shape of the server-side API surface exposed via `stack().api`.
+ *   Defaults to `never` so that plugins without an `api` factory are excluded from the
+ *   `stack().api` namespace entirely, preventing accidental access of `undefined` at runtime.
  */
-interface BackendPlugin<TRoutes extends Record<string, Endpoint> = Record<string, Endpoint>> {
+interface BackendPlugin<TRoutes extends Record<string, Endpoint> = Record<string, Endpoint>, TApi extends Record<string, (...args: any[]) => any> = never> {
     name: string;
     /**
      * Create API endpoints for this plugin
@@ -46,6 +49,14 @@ interface BackendPlugin<TRoutes extends Record<string, Endpoint> = Record<string
      */
     routes: (adapter: Adapter, context?: StackContext) => TRoutes;
     dbPlugin: DbPlugin;
+    /**
+     * Optional factory that returns server-side getter functions bound to the adapter.
+     * The returned object is merged into `stack().api.<pluginName>.*` for direct
+     * server-side or SSG data access without going through HTTP.
+     *
+     * @param adapter - The adapter instance shared with `routes`
+     */
+    api?: (adapter: Adapter) => TApi;
 }
 /**
  * Frontend plugin definition
@@ -70,10 +81,21 @@ interface ClientPlugin<TOverrides = Record<string, never>, TRoutes extends Recor
      */
     sitemap?: () => Promise<Sitemap> | Sitemap;
 }
+/**
+ * Utility type that maps each plugin key to the return type of its `api` factory.
+ * Plugin keys whose `TApi` resolves to `never` (i.e. plugins with no `api` factory)
+ * are excluded from the resulting type via key remapping, preventing TypeScript from
+ * suggesting callable functions on what is actually `undefined` at runtime.
+ */
+type PluginApis<TPlugins extends Record<string, BackendPlugin<any, any>>> = {
+    [K in keyof TPlugins as _ApiOf<TPlugins[K]> extends never ? never : K]: _ApiOf<TPlugins[K]>;
+};
+/** @internal Extract the TApi parameter from a BackendPlugin type. */
+type _ApiOf<T> = T extends BackendPlugin<any, infer TApi> ? TApi : never;
 /**
  * Configuration for creating the backend library
  */
-interface BackendLibConfig<TPlugins extends Record<string, BackendPlugin<any>> = Record<string, BackendPlugin<any>>> {
+interface BackendLibConfig<TPlugins extends Record<string, BackendPlugin<any, any>> = Record<string, BackendPlugin<any, any>>> {
     basePath: string;
     dbSchema?: DatabaseDefinition;
     plugins: TPlugins;
@@ -109,18 +131,22 @@ type PluginRoutes<TPlugins extends Record<string, ClientPlugin<any, any>>> = Mer
  * Prefix all backend plugin route keys with the plugin name
  * Example: { messages: { list: Endpoint } } => { messages_list: Endpoint }
  */
-type PrefixedPluginRoutes<TPlugins extends Record<string, BackendPlugin<any>>> = UnionToIntersection<{
-    [PluginKey in keyof TPlugins]: TPlugins[PluginKey] extends BackendPlugin<infer TRoutes> ? {
+type PrefixedPluginRoutes<TPlugins extends Record<string, BackendPlugin<any, any>>> = UnionToIntersection<{
+    [PluginKey in keyof TPlugins]: TPlugins[PluginKey] extends BackendPlugin<infer TRoutes, any> ? {
         [RouteKey in keyof TRoutes as `${PluginKey & string}_${RouteKey & string}`]: TRoutes[RouteKey];
     } : never;
 }[keyof TPlugins]> extends infer U ? U extends Record<string, Endpoint> ? U : Record<string, Endpoint> : Record<string, Endpoint>;
 /**
  * Result of creating the backend library
  */
-interface BackendLib<TRoutes extends Record<string, Endpoint> = Record<string, Endpoint>> {
+interface BackendLib<TRoutes extends Record<string, Endpoint> = Record<string, Endpoint>, TApis extends Record<string, Record<string, (...args: any[]) => any>> = Record<string, Record<string, (...args: any[]) => any>>> {
     handler: (request: Request) => Promise<Response>;
     router: Router;
     dbSchema: DatabaseDefinition;
+    /** The database adapter shared across all plugins */
+    adapter: Adapter;
+    /** Fully-typed server-side getter functions, namespaced per plugin */
+    api: TApis;
 }
 /**
  * Helper type to extract routes from a client plugin
@@ -154,4 +180,4 @@ type SitemapEntry = {
 };
 type Sitemap = Array<SitemapEntry>;
 
-export type { BackendPlugin as B, ClientPlugin as C, PluginOverrides as P, StackContext as S, SitemapEntry as a, ClientStackContext as b, Sitemap as c, PluginRoutes as d, ClientLibConfig as e, ClientLib as f, PrefixedPluginRoutes as g, BackendLibConfig as h, BackendLib as i };
+export type { BackendPlugin as B, ClientPlugin as C, PluginOverrides as P, StackContext as S, SitemapEntry as a, ClientStackContext as b, Sitemap as c, PluginRoutes as d, ClientLibConfig as e, ClientLib as f, PrefixedPluginRoutes as g, BackendLibConfig as h, BackendLib as i, PluginApis as j };

package/dist/shared/{stack.BoA0xkJv.d.cts → stack.7n9Y_u7N.d.mts}

@@ -8,7 +8,7 @@ import { Endpoint, Router } from 'better-call';
  */
 interface StackContext {
     /** All registered backend plugins */
-    plugins: Record<string, BackendPlugin<any>>;
+    plugins: Record<string, BackendPlugin<any, any>>;
     /** The API base path (e.g., "/api/data") */
     basePath: string;
     /** The database adapter */
@@ -33,8 +33,11 @@ interface ClientStackContext<TPlugins extends Record<string, ClientPlugin<any, a
  * You can optionally provide a base schema via the dbSchema config option.
  *
  * @template TRoutes - The exact shape of routes this plugin provides (preserves keys and endpoint types)
+ * @template TApi - The shape of the server-side API surface exposed via `stack().api`.
+ *   Defaults to `never` so that plugins without an `api` factory are excluded from the
+ *   `stack().api` namespace entirely, preventing accidental access of `undefined` at runtime.
  */
-interface BackendPlugin<TRoutes extends Record<string, Endpoint> = Record<string, Endpoint>> {
+interface BackendPlugin<TRoutes extends Record<string, Endpoint> = Record<string, Endpoint>, TApi extends Record<string, (...args: any[]) => any> = never> {
     name: string;
     /**
      * Create API endpoints for this plugin
@@ -46,6 +49,14 @@ interface BackendPlugin<TRoutes extends Record<string, Endpoint> = Record<string
      */
     routes: (adapter: Adapter, context?: StackContext) => TRoutes;
     dbPlugin: DbPlugin;
+    /**
+     * Optional factory that returns server-side getter functions bound to the adapter.
+     * The returned object is merged into `stack().api.<pluginName>.*` for direct
+     * server-side or SSG data access without going through HTTP.
+     *
+     * @param adapter - The adapter instance shared with `routes`
+     */
+    api?: (adapter: Adapter) => TApi;
 }
 /**
  * Frontend plugin definition
@@ -70,10 +81,21 @@ interface ClientPlugin<TOverrides = Record<string, never>, TRoutes extends Recor
      */
     sitemap?: () => Promise<Sitemap> | Sitemap;
 }
+/**
+ * Utility type that maps each plugin key to the return type of its `api` factory.
+ * Plugin keys whose `TApi` resolves to `never` (i.e. plugins with no `api` factory)
+ * are excluded from the resulting type via key remapping, preventing TypeScript from
+ * suggesting callable functions on what is actually `undefined` at runtime.
+ */
+type PluginApis<TPlugins extends Record<string, BackendPlugin<any, any>>> = {
+    [K in keyof TPlugins as _ApiOf<TPlugins[K]> extends never ? never : K]: _ApiOf<TPlugins[K]>;
+};
+/** @internal Extract the TApi parameter from a BackendPlugin type. */
+type _ApiOf<T> = T extends BackendPlugin<any, infer TApi> ? TApi : never;
 /**
  * Configuration for creating the backend library
  */
-interface BackendLibConfig<TPlugins extends Record<string, BackendPlugin<any>> = Record<string, BackendPlugin<any>>> {
+interface BackendLibConfig<TPlugins extends Record<string, BackendPlugin<any, any>> = Record<string, BackendPlugin<any, any>>> {
     basePath: string;
     dbSchema?: DatabaseDefinition;
     plugins: TPlugins;
@@ -109,18 +131,22 @@ type PluginRoutes<TPlugins extends Record<string, ClientPlugin<any, any>>> = Mer
  * Prefix all backend plugin route keys with the plugin name
  * Example: { messages: { list: Endpoint } } => { messages_list: Endpoint }
  */
-type PrefixedPluginRoutes<TPlugins extends Record<string, BackendPlugin<any>>> = UnionToIntersection<{
-    [PluginKey in keyof TPlugins]: TPlugins[PluginKey] extends BackendPlugin<infer TRoutes> ? {
+type PrefixedPluginRoutes<TPlugins extends Record<string, BackendPlugin<any, any>>> = UnionToIntersection<{
+    [PluginKey in keyof TPlugins]: TPlugins[PluginKey] extends BackendPlugin<infer TRoutes, any> ? {
         [RouteKey in keyof TRoutes as `${PluginKey & string}_${RouteKey & string}`]: TRoutes[RouteKey];
     } : never;
 }[keyof TPlugins]> extends infer U ? U extends Record<string, Endpoint> ? U : Record<string, Endpoint> : Record<string, Endpoint>;
 /**
  * Result of creating the backend library
  */
-interface BackendLib<TRoutes extends Record<string, Endpoint> = Record<string, Endpoint>> {
+interface BackendLib<TRoutes extends Record<string, Endpoint> = Record<string, Endpoint>, TApis extends Record<string, Record<string, (...args: any[]) => any>> = Record<string, Record<string, (...args: any[]) => any>>> {
     handler: (request: Request) => Promise<Response>;
     router: Router;
     dbSchema: DatabaseDefinition;
+    /** The database adapter shared across all plugins */
+    adapter: Adapter;
+    /** Fully-typed server-side getter functions, namespaced per plugin */
+    api: TApis;
 }
 /**
  * Helper type to extract routes from a client plugin
@@ -154,4 +180,4 @@ type SitemapEntry = {
 };
 type Sitemap = Array<SitemapEntry>;
 
-export type { BackendPlugin as B, ClientPlugin as C, PluginOverrides as P, StackContext as S, SitemapEntry as a, ClientStackContext as b, Sitemap as c, PluginRoutes as d, ClientLibConfig as e, ClientLib as f, PrefixedPluginRoutes as g, BackendLibConfig as h, BackendLib as i };
+export type { BackendPlugin as B, ClientPlugin as C, PluginOverrides as P, StackContext as S, SitemapEntry as a, ClientStackContext as b, Sitemap as c, PluginRoutes as d, ClientLibConfig as e, ClientLib as f, PrefixedPluginRoutes as g, BackendLibConfig as h, BackendLib as i, PluginApis as j };

package/dist/shared/{stack.BoA0xkJv.d.ts → stack.7n9Y_u7N.d.ts}

@@ -8,7 +8,7 @@ import { Endpoint, Router } from 'better-call';
  */
 interface StackContext {
     /** All registered backend plugins */
-    plugins: Record<string, BackendPlugin<any>>;
+    plugins: Record<string, BackendPlugin<any, any>>;
     /** The API base path (e.g., "/api/data") */
     basePath: string;
     /** The database adapter */
@@ -33,8 +33,11 @@ interface ClientStackContext<TPlugins extends Record<string, ClientPlugin<any, a
  * You can optionally provide a base schema via the dbSchema config option.
  *
  * @template TRoutes - The exact shape of routes this plugin provides (preserves keys and endpoint types)
+ * @template TApi - The shape of the server-side API surface exposed via `stack().api`.
+ *   Defaults to `never` so that plugins without an `api` factory are excluded from the
+ *   `stack().api` namespace entirely, preventing accidental access of `undefined` at runtime.
  */
-interface BackendPlugin<TRoutes extends Record<string, Endpoint> = Record<string, Endpoint>> {
+interface BackendPlugin<TRoutes extends Record<string, Endpoint> = Record<string, Endpoint>, TApi extends Record<string, (...args: any[]) => any> = never> {
     name: string;
     /**
      * Create API endpoints for this plugin
@@ -46,6 +49,14 @@ interface BackendPlugin<TRoutes extends Record<string, Endpoint> = Record<string
      */
     routes: (adapter: Adapter, context?: StackContext) => TRoutes;
     dbPlugin: DbPlugin;
+    /**
+     * Optional factory that returns server-side getter functions bound to the adapter.
+     * The returned object is merged into `stack().api.<pluginName>.*` for direct
+     * server-side or SSG data access without going through HTTP.
+     *
+     * @param adapter - The adapter instance shared with `routes`
+     */
+    api?: (adapter: Adapter) => TApi;
 }
 /**
  * Frontend plugin definition
@@ -70,10 +81,21 @@ interface ClientPlugin<TOverrides = Record<string, never>, TRoutes extends Recor
      */
     sitemap?: () => Promise<Sitemap> | Sitemap;
 }
+/**
+ * Utility type that maps each plugin key to the return type of its `api` factory.
+ * Plugin keys whose `TApi` resolves to `never` (i.e. plugins with no `api` factory)
+ * are excluded from the resulting type via key remapping, preventing TypeScript from
+ * suggesting callable functions on what is actually `undefined` at runtime.
+ */
+type PluginApis<TPlugins extends Record<string, BackendPlugin<any, any>>> = {
+    [K in keyof TPlugins as _ApiOf<TPlugins[K]> extends never ? never : K]: _ApiOf<TPlugins[K]>;
+};
+/** @internal Extract the TApi parameter from a BackendPlugin type. */
+type _ApiOf<T> = T extends BackendPlugin<any, infer TApi> ? TApi : never;
 /**
  * Configuration for creating the backend library
  */
-interface BackendLibConfig<TPlugins extends Record<string, BackendPlugin<any>> = Record<string, BackendPlugin<any>>> {
+interface BackendLibConfig<TPlugins extends Record<string, BackendPlugin<any, any>> = Record<string, BackendPlugin<any, any>>> {
     basePath: string;
     dbSchema?: DatabaseDefinition;
     plugins: TPlugins;
@@ -109,18 +131,22 @@ type PluginRoutes<TPlugins extends Record<string, ClientPlugin<any, any>>> = Mer
  * Prefix all backend plugin route keys with the plugin name
  * Example: { messages: { list: Endpoint } } => { messages_list: Endpoint }
  */
-type PrefixedPluginRoutes<TPlugins extends Record<string, BackendPlugin<any>>> = UnionToIntersection<{
-    [PluginKey in keyof TPlugins]: TPlugins[PluginKey] extends BackendPlugin<infer TRoutes> ? {
+type PrefixedPluginRoutes<TPlugins extends Record<string, BackendPlugin<any, any>>> = UnionToIntersection<{
+    [PluginKey in keyof TPlugins]: TPlugins[PluginKey] extends BackendPlugin<infer TRoutes, any> ? {
         [RouteKey in keyof TRoutes as `${PluginKey & string}_${RouteKey & string}`]: TRoutes[RouteKey];
     } : never;
 }[keyof TPlugins]> extends infer U ? U extends Record<string, Endpoint> ? U : Record<string, Endpoint> : Record<string, Endpoint>;
 /**
  * Result of creating the backend library
  */
-interface BackendLib<TRoutes extends Record<string, Endpoint> = Record<string, Endpoint>> {
+interface BackendLib<TRoutes extends Record<string, Endpoint> = Record<string, Endpoint>, TApis extends Record<string, Record<string, (...args: any[]) => any>> = Record<string, Record<string, (...args: any[]) => any>>> {
     handler: (request: Request) => Promise<Response>;
     router: Router;
     dbSchema: DatabaseDefinition;
+    /** The database adapter shared across all plugins */
+    adapter: Adapter;
+    /** Fully-typed server-side getter functions, namespaced per plugin */
+    api: TApis;
 }
 /**
  * Helper type to extract routes from a client plugin
@@ -154,4 +180,4 @@ type SitemapEntry = {
 };
 type Sitemap = Array<SitemapEntry>;
 
-export type { BackendPlugin as B, ClientPlugin as C, PluginOverrides as P, StackContext as S, SitemapEntry as a, ClientStackContext as b, Sitemap as c, PluginRoutes as d, ClientLibConfig as e, ClientLib as f, PrefixedPluginRoutes as g, BackendLibConfig as h, BackendLib as i };
+export type { BackendPlugin as B, ClientPlugin as C, PluginOverrides as P, StackContext as S, SitemapEntry as a, ClientStackContext as b, Sitemap as c, PluginRoutes as d, ClientLibConfig as e, ClientLib as f, PrefixedPluginRoutes as g, BackendLibConfig as h, BackendLib as i, PluginApis as j };

package/dist/shared/{stack.BdJFrdyt.d.cts → stack.B-YHz18S.d.cts}

@@ -11,8 +11,8 @@ interface ComponentLayer<TProps extends Record<string, PropValue> = Record<strin
     props: ComponentProps<TProps>;
     children: ComponentLayer[] | string | VariableReference;
 }
-type VariableValueType = 'string' | 'number' | 'boolean';
-type VariableValue<T extends VariableValueType> = T extends 'string' ? string : T extends 'number' ? number : T extends 'boolean' ? boolean : never;
+type VariableValueType = 'string' | 'number' | 'boolean' | 'function';
+type VariableValue<T extends VariableValueType> = T extends 'string' ? string : T extends 'number' ? number : T extends 'boolean' ? boolean : T extends 'function' ? string : never;
 interface Variable<T extends VariableValueType = VariableValueType> {
     id: string;
     name: string;