@btst/stack 1.6.0 → 1.8.0

package/dist/plugins/route-docs/client/index.d.cts

@@ -0,0 +1,126 @@
+import * as _btst_stack_plugins_client from '@btst/stack/plugins/client';
+import * as react from 'react';
+import * as _btst_yar from '@btst/yar';
+import { QueryClient } from '@tanstack/react-query';
+import { S as SitemapEntry, b as ClientStackContext } from '../../../shared/stack.u9iYV6vt.cjs';
+import '@btst/db';
+import 'better-call';
+
+/**
+ * Represents a documented route parameter
+ */
+interface RouteParameter {
+    name: string;
+    type: string;
+    required: boolean;
+    description?: string;
+    schema?: Record<string, any>;
+}
+/**
+ * Sitemap entry with plugin source
+ */
+interface PluginSitemapEntry extends SitemapEntry {
+    pluginKey: string;
+}
+/**
+ * Represents a documented route
+ */
+interface DocumentedRoute {
+    /** Route key from the plugin */
+    key: string;
+    /** The route path pattern (e.g., "/users/:id") */
+    path: string;
+    /** Path parameters extracted from the path */
+    pathParams: RouteParameter[];
+    /** Query parameters from the route's query schema */
+    queryParams: RouteParameter[];
+    /** Route metadata */
+    meta?: {
+        title?: string;
+        description?: string;
+        tags?: string[];
+        [key: string]: any;
+    };
+}
+/**
+ * Represents a plugin's documented routes
+ */
+interface DocumentedPlugin {
+    /** Plugin key */
+    key: string;
+    /** Plugin name */
+    name: string;
+    /** Routes from this plugin */
+    routes: DocumentedRoute[];
+    /** Sitemap entries from this plugin */
+    sitemapEntries: PluginSitemapEntry[];
+}
+/**
+ * The complete route documentation schema
+ */
+interface RouteDocsSchema {
+    /** All documented plugins */
+    plugins: DocumentedPlugin[];
+    /** Generation timestamp */
+    generatedAt: string;
+    /** All sitemap entries aggregated */
+    allSitemapEntries: PluginSitemapEntry[];
+}
+
+/**
+ * Query key for route docs schema
+ */
+declare const ROUTE_DOCS_QUERY_KEY: readonly ["route-docs", "schema"];
+/**
+ * Get the stored client stack context
+ * Used by the docs page component to generate schema on client-side navigation
+ */
+declare function getStoredContext(): ClientStackContext | null;
+/**
+ * Generate the route docs schema from the stored context
+ * This can be called from both server and client
+ */
+declare function generateSchema(): Promise<RouteDocsSchema>;
+/**
+ * Configuration for Route Docs client plugin
+ */
+interface RouteDocsClientConfig {
+    /** React Query client for SSR prefetching */
+    queryClient: QueryClient;
+    /** Title for the documentation page */
+    title?: string;
+    /** Description for the documentation page */
+    description?: string;
+    /** Site base path for constructing URLs (e.g., "/pages") */
+    siteBasePath: string;
+}
+/**
+ * Route Docs client plugin
+ * Provides a route that displays documentation for all client routes
+ */
+declare const routeDocsClientPlugin: (config: RouteDocsClientConfig) => _btst_stack_plugins_client.ClientPlugin<Record<string, never>, {
+    docs: {
+        (inputCtx_0?: _btst_yar.InputContext<"/route-docs", _btst_yar.RouteOptions> | undefined): {
+            PageComponent?: react.ComponentType<unknown> | undefined;
+            LoadingComponent?: react.ComponentType<unknown> | undefined;
+            ErrorComponent?: react.ComponentType<unknown> | undefined;
+            loader?: (() => Promise<void>) | undefined;
+            meta?: (() => ({
+                title: string;
+                name?: undefined;
+                content?: undefined;
+            } | {
+                name: string;
+                content: string;
+                title?: undefined;
+            })[]) | undefined;
+            extra?: (() => any) | undefined;
+        };
+        options: _btst_yar.RouteOptions | undefined;
+        path: "/route-docs";
+        meta: _btst_yar.RouteMeta | undefined;
+    };
+}>;
+
+export { ROUTE_DOCS_QUERY_KEY, generateSchema, getStoredContext, routeDocsClientPlugin };
+export type { RouteDocsClientConfig };

package/dist/plugins/route-docs/client/index.d.mts

@@ -0,0 +1,126 @@
+import * as _btst_stack_plugins_client from '@btst/stack/plugins/client';
+import * as react from 'react';
+import * as _btst_yar from '@btst/yar';
+import { QueryClient } from '@tanstack/react-query';
+import { S as SitemapEntry, b as ClientStackContext } from '../../../shared/stack.u9iYV6vt.mjs';
+import '@btst/db';
+import 'better-call';
+
+/**
+ * Represents a documented route parameter
+ */
+interface RouteParameter {
+    name: string;
+    type: string;
+    required: boolean;
+    description?: string;
+    schema?: Record<string, any>;
+}
+/**
+ * Sitemap entry with plugin source
+ */
+interface PluginSitemapEntry extends SitemapEntry {
+    pluginKey: string;
+}
+/**
+ * Represents a documented route
+ */
+interface DocumentedRoute {
+    /** Route key from the plugin */
+    key: string;
+    /** The route path pattern (e.g., "/users/:id") */
+    path: string;
+    /** Path parameters extracted from the path */
+    pathParams: RouteParameter[];
+    /** Query parameters from the route's query schema */
+    queryParams: RouteParameter[];
+    /** Route metadata */
+    meta?: {
+        title?: string;
+        description?: string;
+        tags?: string[];
+        [key: string]: any;
+    };
+}
+/**
+ * Represents a plugin's documented routes
+ */
+interface DocumentedPlugin {
+    /** Plugin key */
+    key: string;
+    /** Plugin name */
+    name: string;
+    /** Routes from this plugin */
+    routes: DocumentedRoute[];
+    /** Sitemap entries from this plugin */
+    sitemapEntries: PluginSitemapEntry[];
+}
+/**
+ * The complete route documentation schema
+ */
+interface RouteDocsSchema {
+    /** All documented plugins */
+    plugins: DocumentedPlugin[];
+    /** Generation timestamp */
+    generatedAt: string;
+    /** All sitemap entries aggregated */
+    allSitemapEntries: PluginSitemapEntry[];
+}
+
+/**
+ * Query key for route docs schema
+ */
+declare const ROUTE_DOCS_QUERY_KEY: readonly ["route-docs", "schema"];
+/**
+ * Get the stored client stack context
+ * Used by the docs page component to generate schema on client-side navigation
+ */
+declare function getStoredContext(): ClientStackContext | null;
+/**
+ * Generate the route docs schema from the stored context
+ * This can be called from both server and client
+ */
+declare function generateSchema(): Promise<RouteDocsSchema>;
+/**
+ * Configuration for Route Docs client plugin
+ */
+interface RouteDocsClientConfig {
+    /** React Query client for SSR prefetching */
+    queryClient: QueryClient;
+    /** Title for the documentation page */
+    title?: string;
+    /** Description for the documentation page */
+    description?: string;
+    /** Site base path for constructing URLs (e.g., "/pages") */
+    siteBasePath: string;
+}
+/**
+ * Route Docs client plugin
+ * Provides a route that displays documentation for all client routes
+ */
+declare const routeDocsClientPlugin: (config: RouteDocsClientConfig) => _btst_stack_plugins_client.ClientPlugin<Record<string, never>, {
+    docs: {
+        (inputCtx_0?: _btst_yar.InputContext<"/route-docs", _btst_yar.RouteOptions> | undefined): {
+            PageComponent?: react.ComponentType<unknown> | undefined;
+            LoadingComponent?: react.ComponentType<unknown> | undefined;
+            ErrorComponent?: react.ComponentType<unknown> | undefined;
+            loader?: (() => Promise<void>) | undefined;
+            meta?: (() => ({
+                title: string;
+                name?: undefined;
+                content?: undefined;
+            } | {
+                name: string;
+                content: string;
+                title?: undefined;
+            })[]) | undefined;
+            extra?: (() => any) | undefined;
+        };
+        options: _btst_yar.RouteOptions | undefined;
+        path: "/route-docs";
+        meta: _btst_yar.RouteMeta | undefined;
+    };
+}>;
+
+export { ROUTE_DOCS_QUERY_KEY, generateSchema, getStoredContext, routeDocsClientPlugin };
+export type { RouteDocsClientConfig };

package/dist/plugins/route-docs/client/index.d.ts

@@ -0,0 +1,126 @@
+import * as _btst_stack_plugins_client from '@btst/stack/plugins/client';
+import * as react from 'react';
+import * as _btst_yar from '@btst/yar';
+import { QueryClient } from '@tanstack/react-query';
+import { S as SitemapEntry, b as ClientStackContext } from '../../../shared/stack.u9iYV6vt.js';
+import '@btst/db';
+import 'better-call';
+
+/**
+ * Represents a documented route parameter
+ */
+interface RouteParameter {
+    name: string;
+    type: string;
+    required: boolean;
+    description?: string;
+    schema?: Record<string, any>;
+}
+/**
+ * Sitemap entry with plugin source
+ */
+interface PluginSitemapEntry extends SitemapEntry {
+    pluginKey: string;
+}
+/**
+ * Represents a documented route
+ */
+interface DocumentedRoute {
+    /** Route key from the plugin */
+    key: string;
+    /** The route path pattern (e.g., "/users/:id") */
+    path: string;
+    /** Path parameters extracted from the path */
+    pathParams: RouteParameter[];
+    /** Query parameters from the route's query schema */
+    queryParams: RouteParameter[];
+    /** Route metadata */
+    meta?: {
+        title?: string;
+        description?: string;
+        tags?: string[];
+        [key: string]: any;
+    };
+}
+/**
+ * Represents a plugin's documented routes
+ */
+interface DocumentedPlugin {
+    /** Plugin key */
+    key: string;
+    /** Plugin name */
+    name: string;
+    /** Routes from this plugin */
+    routes: DocumentedRoute[];
+    /** Sitemap entries from this plugin */
+    sitemapEntries: PluginSitemapEntry[];
+}
+/**
+ * The complete route documentation schema
+ */
+interface RouteDocsSchema {
+    /** All documented plugins */
+    plugins: DocumentedPlugin[];
+    /** Generation timestamp */
+    generatedAt: string;
+    /** All sitemap entries aggregated */
+    allSitemapEntries: PluginSitemapEntry[];
+}
+
+/**
+ * Query key for route docs schema
+ */
+declare const ROUTE_DOCS_QUERY_KEY: readonly ["route-docs", "schema"];
+/**
+ * Get the stored client stack context
+ * Used by the docs page component to generate schema on client-side navigation
+ */
+declare function getStoredContext(): ClientStackContext | null;
+/**
+ * Generate the route docs schema from the stored context
+ * This can be called from both server and client
+ */
+declare function generateSchema(): Promise<RouteDocsSchema>;
+/**
+ * Configuration for Route Docs client plugin
+ */
+interface RouteDocsClientConfig {
+    /** React Query client for SSR prefetching */
+    queryClient: QueryClient;
+    /** Title for the documentation page */
+    title?: string;
+    /** Description for the documentation page */
+    description?: string;
+    /** Site base path for constructing URLs (e.g., "/pages") */
+    siteBasePath: string;
+}
+/**
+ * Route Docs client plugin
+ * Provides a route that displays documentation for all client routes
+ */
+declare const routeDocsClientPlugin: (config: RouteDocsClientConfig) => _btst_stack_plugins_client.ClientPlugin<Record<string, never>, {
+    docs: {
+        (inputCtx_0?: _btst_yar.InputContext<"/route-docs", _btst_yar.RouteOptions> | undefined): {
+            PageComponent?: react.ComponentType<unknown> | undefined;
+            LoadingComponent?: react.ComponentType<unknown> | undefined;
+            ErrorComponent?: react.ComponentType<unknown> | undefined;
+            loader?: (() => Promise<void>) | undefined;
+            meta?: (() => ({
+                title: string;
+                name?: undefined;
+                content?: undefined;
+            } | {
+                name: string;
+                content: string;
+                title?: undefined;
+            })[]) | undefined;
+            extra?: (() => any) | undefined;
+        };
+        options: _btst_yar.RouteOptions | undefined;
+        path: "/route-docs";
+        meta: _btst_yar.RouteMeta | undefined;
+    };
+}>;
+
+export { ROUTE_DOCS_QUERY_KEY, generateSchema, getStoredContext, routeDocsClientPlugin };
+export type { RouteDocsClientConfig };

package/dist/plugins/route-docs/client/index.mjs

@@ -0,0 +1 @@
+export { ROUTE_DOCS_QUERY_KEY, generateSchema, getStoredContext, routeDocsClientPlugin } from '../../../packages/better-stack/src/plugins/route-docs/client/plugin.mjs';

package/dist/plugins/route-docs/client.css

@@ -0,0 +1,3 @@
+/* Route Docs Plugin Client CSS */
+/* No custom styles needed - uses shadcn/ui components and Tailwind */
+

package/dist/plugins/route-docs/style.css

@@ -0,0 +1,19 @@
+@import "./client.css";
+
+/*
+ * Route Docs Plugin CSS - Includes Tailwind class scanning
+ * 
+ * When consumed from npm, Tailwind v4 will automatically scan this package's
+ * source files for Tailwind classes. Consumers only need:
+ *   @import "@btst/stack/plugins/route-docs/css";
+ */
+
+/* Scan this package's source files for Tailwind classes */
+@source "../../../src/**/*.{ts,tsx}";
+
+/* Scan UI package components (when installed as npm package the UI package will be in this dir) */
+@source "../../packages/ui/src";
+
+/*
+* alternatively consumer can use @source "../node_modules/@btst/stack/src/**\/*.{ts,tsx}";
+*/

package/dist/shared/{stack.ByOugz9d.d.cts → stack.u9iYV6vt.d.cts}

@@ -2,6 +2,28 @@ import { Route, createRouter } from '@btst/yar';
 import { Adapter, DbPlugin, DatabaseDefinition } from '@btst/db';
 import { Endpoint, Router } from 'better-call';
 
+/**
+ * Context passed to backend plugins during route creation
+ * Provides access to all registered plugins for introspection (used by openAPI plugin)
+ */
+interface BetterStackContext {
+    /** All registered backend plugins */
+    plugins: Record<string, BackendPlugin<any>>;
+    /** The API base path (e.g., "/api/data") */
+    basePath: string;
+    /** The database adapter */
+    adapter: Adapter;
+}
+/**
+ * Context passed to client plugins during route creation
+ * Provides access to all registered plugins for introspection (used by routeDocs plugin)
+ */
+interface ClientStackContext<TPlugins extends Record<string, ClientPlugin<any, any>> = Record<string, ClientPlugin<any, any>>> {
+    /** All registered client plugins */
+    plugins: TPlugins;
+    /** The base path for the client (e.g., "/app") */
+    basePath?: string;
+}
 /**
  * Backend plugin definition
  * Defines API routes and data access for a feature
@@ -20,8 +42,9 @@ interface BackendPlugin<TRoutes extends Record<string, Endpoint> = Record<string
      *
      * @param adapter - Better DB adapter instance with methods:
      *   create, update, updateMany, delete, deleteMany, findOne, findMany, count
+     * @param context - Optional context with access to all plugins (for introspection)
      */
-    routes: (adapter: Adapter) => TRoutes;
+    routes: (adapter: Adapter, context?: BetterStackContext) => TRoutes;
     dbPlugin: DbPlugin;
 }
 /**
@@ -37,8 +60,10 @@ interface ClientPlugin<TOverrides = Record<string, never>, TRoutes extends Recor
     /**
      * Define routes (pages) for this plugin
      * Returns yar routes that will be composed into the router
+     *
+     * @param context - Optional context with access to all plugins (for introspection)
      */
-    routes: () => TRoutes;
+    routes: (context?: ClientStackContext) => TRoutes;
     /**
      * Optional sitemap generator for this plugin. Should return absolute URLs.
      * Implementations can call their own API endpoints to include dynamic routes.
@@ -129,4 +154,4 @@ type SitemapEntry = {
 };
 type Sitemap = Array<SitemapEntry>;
 
-export type { BackendPlugin as B, ClientPlugin as C, PluginOverrides as P, Sitemap as S, PluginRoutes as a, ClientLibConfig as b, ClientLib as c, PrefixedPluginRoutes as d, BackendLibConfig as e, BackendLib as f };
+export type { BackendPlugin as B, ClientPlugin as C, PluginOverrides as P, SitemapEntry as S, BetterStackContext 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 };

package/dist/shared/{stack.ByOugz9d.d.mts → stack.u9iYV6vt.d.mts}

@@ -2,6 +2,28 @@ import { Route, createRouter } from '@btst/yar';
 import { Adapter, DbPlugin, DatabaseDefinition } from '@btst/db';
 import { Endpoint, Router } from 'better-call';
 
+/**
+ * Context passed to backend plugins during route creation
+ * Provides access to all registered plugins for introspection (used by openAPI plugin)
+ */
+interface BetterStackContext {
+    /** All registered backend plugins */
+    plugins: Record<string, BackendPlugin<any>>;
+    /** The API base path (e.g., "/api/data") */
+    basePath: string;
+    /** The database adapter */
+    adapter: Adapter;
+}
+/**
+ * Context passed to client plugins during route creation
+ * Provides access to all registered plugins for introspection (used by routeDocs plugin)
+ */
+interface ClientStackContext<TPlugins extends Record<string, ClientPlugin<any, any>> = Record<string, ClientPlugin<any, any>>> {
+    /** All registered client plugins */
+    plugins: TPlugins;
+    /** The base path for the client (e.g., "/app") */
+    basePath?: string;
+}
 /**
  * Backend plugin definition
  * Defines API routes and data access for a feature
@@ -20,8 +42,9 @@ interface BackendPlugin<TRoutes extends Record<string, Endpoint> = Record<string
      *
      * @param adapter - Better DB adapter instance with methods:
      *   create, update, updateMany, delete, deleteMany, findOne, findMany, count
+     * @param context - Optional context with access to all plugins (for introspection)
      */
-    routes: (adapter: Adapter) => TRoutes;
+    routes: (adapter: Adapter, context?: BetterStackContext) => TRoutes;
     dbPlugin: DbPlugin;
 }
 /**
@@ -37,8 +60,10 @@ interface ClientPlugin<TOverrides = Record<string, never>, TRoutes extends Recor
     /**
      * Define routes (pages) for this plugin
      * Returns yar routes that will be composed into the router
+     *
+     * @param context - Optional context with access to all plugins (for introspection)
      */
-    routes: () => TRoutes;
+    routes: (context?: ClientStackContext) => TRoutes;
     /**
      * Optional sitemap generator for this plugin. Should return absolute URLs.
      * Implementations can call their own API endpoints to include dynamic routes.
@@ -129,4 +154,4 @@ type SitemapEntry = {
 };
 type Sitemap = Array<SitemapEntry>;
 
-export type { BackendPlugin as B, ClientPlugin as C, PluginOverrides as P, Sitemap as S, PluginRoutes as a, ClientLibConfig as b, ClientLib as c, PrefixedPluginRoutes as d, BackendLibConfig as e, BackendLib as f };
+export type { BackendPlugin as B, ClientPlugin as C, PluginOverrides as P, SitemapEntry as S, BetterStackContext 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 };

package/dist/shared/{stack.ByOugz9d.d.ts → stack.u9iYV6vt.d.ts}

@@ -2,6 +2,28 @@ import { Route, createRouter } from '@btst/yar';
 import { Adapter, DbPlugin, DatabaseDefinition } from '@btst/db';
 import { Endpoint, Router } from 'better-call';
 
+/**
+ * Context passed to backend plugins during route creation
+ * Provides access to all registered plugins for introspection (used by openAPI plugin)
+ */
+interface BetterStackContext {
+    /** All registered backend plugins */
+    plugins: Record<string, BackendPlugin<any>>;
+    /** The API base path (e.g., "/api/data") */
+    basePath: string;
+    /** The database adapter */
+    adapter: Adapter;
+}
+/**
+ * Context passed to client plugins during route creation
+ * Provides access to all registered plugins for introspection (used by routeDocs plugin)
+ */
+interface ClientStackContext<TPlugins extends Record<string, ClientPlugin<any, any>> = Record<string, ClientPlugin<any, any>>> {
+    /** All registered client plugins */
+    plugins: TPlugins;
+    /** The base path for the client (e.g., "/app") */
+    basePath?: string;
+}
 /**
  * Backend plugin definition
  * Defines API routes and data access for a feature
@@ -20,8 +42,9 @@ interface BackendPlugin<TRoutes extends Record<string, Endpoint> = Record<string
      *
      * @param adapter - Better DB adapter instance with methods:
      *   create, update, updateMany, delete, deleteMany, findOne, findMany, count
+     * @param context - Optional context with access to all plugins (for introspection)
      */
-    routes: (adapter: Adapter) => TRoutes;
+    routes: (adapter: Adapter, context?: BetterStackContext) => TRoutes;
     dbPlugin: DbPlugin;
 }
 /**
@@ -37,8 +60,10 @@ interface ClientPlugin<TOverrides = Record<string, never>, TRoutes extends Recor
     /**
      * Define routes (pages) for this plugin
      * Returns yar routes that will be composed into the router
+     *
+     * @param context - Optional context with access to all plugins (for introspection)
      */
-    routes: () => TRoutes;
+    routes: (context?: ClientStackContext) => TRoutes;
     /**
      * Optional sitemap generator for this plugin. Should return absolute URLs.
      * Implementations can call their own API endpoints to include dynamic routes.
@@ -129,4 +154,4 @@ type SitemapEntry = {
 };
 type Sitemap = Array<SitemapEntry>;
 
-export type { BackendPlugin as B, ClientPlugin as C, PluginOverrides as P, Sitemap as S, PluginRoutes as a, ClientLibConfig as b, ClientLib as c, PrefixedPluginRoutes as d, BackendLibConfig as e, BackendLib as f };
+export type { BackendPlugin as B, ClientPlugin as C, PluginOverrides as P, SitemapEntry as S, BetterStackContext 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 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@btst/stack",
-  "version": "1.6.0",
+  "version": "1.8.0",
   "description": "A composable, plugin-based library for building full-stack applications.",
   "repository": {
     "type": "git",
@@ -247,6 +247,27 @@
       }
     },
     "./plugins/form-builder/css": "./dist/plugins/form-builder/style.css",
+    "./plugins/open-api/api": {
+      "import": {
+        "types": "./dist/plugins/open-api/api/index.d.ts",
+        "default": "./dist/plugins/open-api/api/index.mjs"
+      },
+      "require": {
+        "types": "./dist/plugins/open-api/api/index.d.cts",
+        "default": "./dist/plugins/open-api/api/index.cjs"
+      }
+    },
+    "./plugins/route-docs/client": {
+      "import": {
+        "types": "./dist/plugins/route-docs/client/index.d.ts",
+        "default": "./dist/plugins/route-docs/client/index.mjs"
+      },
+      "require": {
+        "types": "./dist/plugins/route-docs/client/index.d.cts",
+        "default": "./dist/plugins/route-docs/client/index.cjs"
+      }
+    },
+    "./plugins/route-docs/css": "./dist/plugins/route-docs/style.css",
     "./dist/*": "./dist/*",
     "./ui/css": "./dist/ui/components.css",
     "./package.json": "./package.json"
@@ -312,6 +333,12 @@
       ],
       "plugins/form-builder/client/hooks": [
         "./dist/plugins/form-builder/client/hooks/index.d.ts"
+      ],
+      "plugins/open-api/api": [
+        "./dist/plugins/open-api/api/index.d.ts"
+      ],
+      "plugins/route-docs/client": [
+        "./dist/plugins/route-docs/client/index.d.ts"
       ]
     }
   },

package/src/api/index.ts

@@ -3,6 +3,7 @@ import type {
 	BackendLibConfig,
 	BackendLib,
 	PrefixedPluginRoutes,
+	BetterStackContext,
 } from "../types";
 import { defineDb } from "@btst/db";
 
@@ -45,9 +46,19 @@ export function betterStack<
 		betterDbSchema = betterDbSchema.use(plugin.dbPlugin);
 	}
 
+	// Create the adapter instance once
+	const adapterInstance = adapter(betterDbSchema);
+
+	// Create context for plugins that need access to all plugins (e.g., openAPI)
+	const context: BetterStackContext = {
+		plugins,
+		basePath,
+		adapter: adapterInstance,
+	};
+
 	for (const [pluginKey, plugin] of Object.entries(plugins)) {
-		// Pass the adapter directly to plugin routes
-		const pluginRoutes = plugin.routes(adapter(betterDbSchema));
+		// Pass both adapter and context to plugin routes
+		const pluginRoutes = plugin.routes(adapterInstance, context);
 
 		// Prefix route keys with plugin name to avoid collisions
 		for (const [routeKey, endpoint] of Object.entries(pluginRoutes)) {
@@ -72,4 +83,5 @@ export type {
 	BackendPlugin,
 	BackendLibConfig,
 	BackendLib,
+	BetterStackContext,
 } from "../types";