@btst/stack 1.0.1 → 1.1.1

package/dist/client/sitemap-utils.cjs

@@ -0,0 +1,14 @@
+'use strict';
+
+function sitemapEntryToXmlString(entries) {
+  const xml = `<?xml version="1.0" encoding="UTF-8"?><urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">` + entries.map((entry) => {
+    const url = `<loc>${entry.url}</loc>`;
+    const lastModified = entry.lastModified ? `<lastmod>${entry.lastModified instanceof Date ? entry.lastModified.toISOString() : entry.lastModified}</lastmod>` : "";
+    const changeFrequency = entry.changeFrequency ? `<changefreq>${entry.changeFrequency}</changefreq>` : "";
+    const priority = entry.priority !== void 0 ? `<priority>${entry.priority}</priority>` : "";
+    return `<url>${url}${lastModified}${changeFrequency}${priority}</url>`;
+  }).join("") + `</urlset>`;
+  return xml;
+}
+
+exports.sitemapEntryToXmlString = sitemapEntryToXmlString;

package/dist/client/sitemap-utils.mjs

@@ -0,0 +1,12 @@
+function sitemapEntryToXmlString(entries) {
+  const xml = `<?xml version="1.0" encoding="UTF-8"?><urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">` + entries.map((entry) => {
+    const url = `<loc>${entry.url}</loc>`;
+    const lastModified = entry.lastModified ? `<lastmod>${entry.lastModified instanceof Date ? entry.lastModified.toISOString() : entry.lastModified}</lastmod>` : "";
+    const changeFrequency = entry.changeFrequency ? `<changefreq>${entry.changeFrequency}</changefreq>` : "";
+    const priority = entry.priority !== void 0 ? `<priority>${entry.priority}</priority>` : "";
+    return `<url>${url}${lastModified}${changeFrequency}${priority}</url>`;
+  }).join("") + `</urlset>`;
+  return xml;
+}
+
+export { sitemapEntryToXmlString };

package/dist/context/index.cjs

@@ -1,67 +1,10 @@
-"use client";
 'use strict';
 
-const jsxRuntime = require('react/jsx-runtime');
-const react = require('react');
+const provider = require('./provider.cjs');
 
-const BetterStackContext = react.createContext(
-  null
-);
-function BetterStackProvider({
-  children,
-  overrides,
-  basePath
-}) {
-  const value = {
-    overrides,
-    basePath
-  };
-  return /* @__PURE__ */ jsxRuntime.jsx(BetterStackContext.Provider, { value, children });
-}
-function useBetterStack() {
-  const context = react.useContext(
-    BetterStackContext
-  );
-  if (!context) {
-    throw new Error(
-      "useBetterStack must be used within BetterStackProvider. Wrap your app with <BetterStackProvider> in your layout file."
-    );
-  }
-  return context;
-}
-function usePluginOverrides(pluginName) {
-  const context = useBetterStack();
-  const overrides = context.overrides[pluginName];
-  if (!overrides) {
-    throw new Error(
-      `Plugin "${pluginName}" not found in BetterStackProvider. Available plugins: ${Object.keys(context.overrides).join(", ")}`
-    );
-  }
-  return overrides;
-}
-function usePluginOverride(pluginName, overrideKey) {
-  const overrides = usePluginOverrides(pluginName);
-  const override = overrides[overrideKey];
-  if (override === void 0) {
-    const availableKeys = overrides && typeof overrides === "object" ? Object.keys(overrides).join(", ") : "none";
-    throw new Error(
-      `Override "${overrideKey}" not found for plugin "${pluginName}". Available overrides: ${availableKeys}`
-    );
-  }
-  return override;
-}
-function useBasePath() {
-  const context = useBetterStack();
-  if (!context) {
-    throw new Error(
-      "useBasePath must be used within BetterStackProvider. Wrap your app with <BetterStackProvider> in your layout file."
-    );
-  }
-  return context.basePath;
-}
 
-exports.BetterStackProvider = BetterStackProvider;
-exports.useBasePath = useBasePath;
-exports.useBetterStack = useBetterStack;
-exports.usePluginOverride = usePluginOverride;
-exports.usePluginOverrides = usePluginOverrides;
+
+exports.BetterStackProvider = provider.BetterStackProvider;
+exports.useBasePath = provider.useBasePath;
+exports.useBetterStack = provider.useBetterStack;
+exports.usePluginOverrides = provider.usePluginOverrides;

package/dist/context/index.d.cts

@@ -1,4 +1,3 @@
-"use client";
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
 
@@ -7,7 +6,13 @@ import { ReactNode } from 'react';
  * Generic over the shape of all plugin overrides
  */
 interface BetterStackContextValue<TPluginOverrides extends Record<string, any>> {
+    /**
+     * The overrides for the plugin.
+     */
     overrides: TPluginOverrides;
+    /**
+     * The base path where the client router is mounted.
+     */
     basePath: string;
 }
 /**
@@ -49,41 +54,33 @@ declare function BetterStackProvider<TPluginOverrides extends Record<string, any
  * Useful if you need access to multiple plugins or the full context
  */
 declare function useBetterStack<TPluginOverrides extends Record<string, any> = Record<string, any>>(): BetterStackContextValue<TPluginOverrides>;
+type OverridesResult<TOverrides, TDefaults> = undefined extends TDefaults ? TOverrides : TOverrides & Required<Pick<TDefaults & {}, keyof TDefaults>>;
 /**
  * Hook to access overrides for a specific plugin
  * This is type-safe and will only expose the overrides defined by that plugin
  *
+ * When default values are provided, properties with defaults are guaranteed to be non-null.
+ *
  * @example
  * ```tsx
- * // In a todos plugin component
+ * // Without defaults - trusts plugin is configured
  * function TodosList() {
- *   const { Link, navigate } = usePluginOverrides<TodosPluginOverrides>("todos");
- *
- *   return (
- *     <Link href="/todos/add">
- *       <button onClick={() => navigate("/todos")}>
- *         Add Todo
- *       </button>
- *     </Link>
- *   );
+ *   const { navigate } = usePluginOverrides<TodosPluginOverrides>("todos");
+ *   // navigate is (path: string) => void (required fields are non-nullable)
+ *   navigate("/todos/add");
  * }
- * ```
- */
-declare function usePluginOverrides<TOverrides = any>(pluginName: string): TOverrides;
-/**
- * Hook to access a specific override from a plugin
- * Provides fine-grained access with full type safety
  *
- * @example
- * ```tsx
+ * // With defaults - optional fields with defaults become required
  * function TodosList() {
- *   const Link = usePluginOverride<typeof NextLink>("todos", "Link");
- *
- *   return <Link href="/todos/add">Add Todo</Link>;
+ *   const { localization } = usePluginOverrides<TodosPluginOverrides, Partial<TodosPluginOverrides>>("todos", {
+ *     localization: DEFAULT_LOCALIZATION
+ *   });
+ *   // localization is Localization (guaranteed to exist because we provided a default)
+ *   console.log(localization.SOME_KEY);
  * }
  * ```
  */
-declare function usePluginOverride<TOverride = any>(pluginName: string, overrideKey: string): TOverride;
+declare function usePluginOverrides<TOverrides = any, TDefaults extends Partial<TOverrides> | undefined = undefined>(pluginName: string, defaultValues?: TDefaults): OverridesResult<TOverrides, TDefaults>;
 declare function useBasePath(): string;
 
-export { BetterStackProvider, useBasePath, useBetterStack, usePluginOverride, usePluginOverrides };
+export { BetterStackProvider, useBasePath, useBetterStack, usePluginOverrides };

package/dist/context/index.d.mts

@@ -1,4 +1,3 @@
-"use client";
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
 
@@ -7,7 +6,13 @@ import { ReactNode } from 'react';
  * Generic over the shape of all plugin overrides
  */
 interface BetterStackContextValue<TPluginOverrides extends Record<string, any>> {
+    /**
+     * The overrides for the plugin.
+     */
     overrides: TPluginOverrides;
+    /**
+     * The base path where the client router is mounted.
+     */
     basePath: string;
 }
 /**
@@ -49,41 +54,33 @@ declare function BetterStackProvider<TPluginOverrides extends Record<string, any
  * Useful if you need access to multiple plugins or the full context
  */
 declare function useBetterStack<TPluginOverrides extends Record<string, any> = Record<string, any>>(): BetterStackContextValue<TPluginOverrides>;
+type OverridesResult<TOverrides, TDefaults> = undefined extends TDefaults ? TOverrides : TOverrides & Required<Pick<TDefaults & {}, keyof TDefaults>>;
 /**
  * Hook to access overrides for a specific plugin
  * This is type-safe and will only expose the overrides defined by that plugin
  *
+ * When default values are provided, properties with defaults are guaranteed to be non-null.
+ *
  * @example
  * ```tsx
- * // In a todos plugin component
+ * // Without defaults - trusts plugin is configured
  * function TodosList() {
- *   const { Link, navigate } = usePluginOverrides<TodosPluginOverrides>("todos");
- *
- *   return (
- *     <Link href="/todos/add">
- *       <button onClick={() => navigate("/todos")}>
- *         Add Todo
- *       </button>
- *     </Link>
- *   );
+ *   const { navigate } = usePluginOverrides<TodosPluginOverrides>("todos");
+ *   // navigate is (path: string) => void (required fields are non-nullable)
+ *   navigate("/todos/add");
  * }
- * ```
- */
-declare function usePluginOverrides<TOverrides = any>(pluginName: string): TOverrides;
-/**
- * Hook to access a specific override from a plugin
- * Provides fine-grained access with full type safety
  *
- * @example
- * ```tsx
+ * // With defaults - optional fields with defaults become required
  * function TodosList() {
- *   const Link = usePluginOverride<typeof NextLink>("todos", "Link");
- *
- *   return <Link href="/todos/add">Add Todo</Link>;
+ *   const { localization } = usePluginOverrides<TodosPluginOverrides, Partial<TodosPluginOverrides>>("todos", {
+ *     localization: DEFAULT_LOCALIZATION
+ *   });
+ *   // localization is Localization (guaranteed to exist because we provided a default)
+ *   console.log(localization.SOME_KEY);
  * }
  * ```
  */
-declare function usePluginOverride<TOverride = any>(pluginName: string, overrideKey: string): TOverride;
+declare function usePluginOverrides<TOverrides = any, TDefaults extends Partial<TOverrides> | undefined = undefined>(pluginName: string, defaultValues?: TDefaults): OverridesResult<TOverrides, TDefaults>;
 declare function useBasePath(): string;
 
-export { BetterStackProvider, useBasePath, useBetterStack, usePluginOverride, usePluginOverrides };
+export { BetterStackProvider, useBasePath, useBetterStack, usePluginOverrides };

package/dist/context/index.d.ts

@@ -1,4 +1,3 @@
-"use client";
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode } from 'react';
 
@@ -7,7 +6,13 @@ import { ReactNode } from 'react';
  * Generic over the shape of all plugin overrides
  */
 interface BetterStackContextValue<TPluginOverrides extends Record<string, any>> {
+    /**
+     * The overrides for the plugin.
+     */
     overrides: TPluginOverrides;
+    /**
+     * The base path where the client router is mounted.
+     */
     basePath: string;
 }
 /**
@@ -49,41 +54,33 @@ declare function BetterStackProvider<TPluginOverrides extends Record<string, any
  * Useful if you need access to multiple plugins or the full context
  */
 declare function useBetterStack<TPluginOverrides extends Record<string, any> = Record<string, any>>(): BetterStackContextValue<TPluginOverrides>;
+type OverridesResult<TOverrides, TDefaults> = undefined extends TDefaults ? TOverrides : TOverrides & Required<Pick<TDefaults & {}, keyof TDefaults>>;
 /**
  * Hook to access overrides for a specific plugin
  * This is type-safe and will only expose the overrides defined by that plugin
  *
+ * When default values are provided, properties with defaults are guaranteed to be non-null.
+ *
  * @example
  * ```tsx
- * // In a todos plugin component
+ * // Without defaults - trusts plugin is configured
  * function TodosList() {
- *   const { Link, navigate } = usePluginOverrides<TodosPluginOverrides>("todos");
- *
- *   return (
- *     <Link href="/todos/add">
- *       <button onClick={() => navigate("/todos")}>
- *         Add Todo
- *       </button>
- *     </Link>
- *   );
+ *   const { navigate } = usePluginOverrides<TodosPluginOverrides>("todos");
+ *   // navigate is (path: string) => void (required fields are non-nullable)
+ *   navigate("/todos/add");
  * }
- * ```
- */
-declare function usePluginOverrides<TOverrides = any>(pluginName: string): TOverrides;
-/**
- * Hook to access a specific override from a plugin
- * Provides fine-grained access with full type safety
  *
- * @example
- * ```tsx
+ * // With defaults - optional fields with defaults become required
  * function TodosList() {
- *   const Link = usePluginOverride<typeof NextLink>("todos", "Link");
- *
- *   return <Link href="/todos/add">Add Todo</Link>;
+ *   const { localization } = usePluginOverrides<TodosPluginOverrides, Partial<TodosPluginOverrides>>("todos", {
+ *     localization: DEFAULT_LOCALIZATION
+ *   });
+ *   // localization is Localization (guaranteed to exist because we provided a default)
+ *   console.log(localization.SOME_KEY);
  * }
  * ```
  */
-declare function usePluginOverride<TOverride = any>(pluginName: string, overrideKey: string): TOverride;
+declare function usePluginOverrides<TOverrides = any, TDefaults extends Partial<TOverrides> | undefined = undefined>(pluginName: string, defaultValues?: TDefaults): OverridesResult<TOverrides, TDefaults>;
 declare function useBasePath(): string;
 
-export { BetterStackProvider, useBasePath, useBetterStack, usePluginOverride, usePluginOverrides };
+export { BetterStackProvider, useBasePath, useBetterStack, usePluginOverrides };

package/dist/context/index.mjs

@@ -1,61 +1 @@
-"use client";
-import { jsx } from 'react/jsx-runtime';
-import { createContext, useContext } from 'react';
-
-const BetterStackContext = createContext(
-  null
-);
-function BetterStackProvider({
-  children,
-  overrides,
-  basePath
-}) {
-  const value = {
-    overrides,
-    basePath
-  };
-  return /* @__PURE__ */ jsx(BetterStackContext.Provider, { value, children });
-}
-function useBetterStack() {
-  const context = useContext(
-    BetterStackContext
-  );
-  if (!context) {
-    throw new Error(
-      "useBetterStack must be used within BetterStackProvider. Wrap your app with <BetterStackProvider> in your layout file."
-    );
-  }
-  return context;
-}
-function usePluginOverrides(pluginName) {
-  const context = useBetterStack();
-  const overrides = context.overrides[pluginName];
-  if (!overrides) {
-    throw new Error(
-      `Plugin "${pluginName}" not found in BetterStackProvider. Available plugins: ${Object.keys(context.overrides).join(", ")}`
-    );
-  }
-  return overrides;
-}
-function usePluginOverride(pluginName, overrideKey) {
-  const overrides = usePluginOverrides(pluginName);
-  const override = overrides[overrideKey];
-  if (override === void 0) {
-    const availableKeys = overrides && typeof overrides === "object" ? Object.keys(overrides).join(", ") : "none";
-    throw new Error(
-      `Override "${overrideKey}" not found for plugin "${pluginName}". Available overrides: ${availableKeys}`
-    );
-  }
-  return override;
-}
-function useBasePath() {
-  const context = useBetterStack();
-  if (!context) {
-    throw new Error(
-      "useBasePath must be used within BetterStackProvider. Wrap your app with <BetterStackProvider> in your layout file."
-    );
-  }
-  return context.basePath;
-}
-
-export { BetterStackProvider, useBasePath, useBetterStack, usePluginOverride, usePluginOverrides };
+export { BetterStackProvider, useBasePath, useBetterStack, usePluginOverrides } from './provider.mjs';

package/dist/context/provider.cjs

@@ -0,0 +1,51 @@
+"use client";
+'use strict';
+
+const jsxRuntime = require('react/jsx-runtime');
+const React = require('react');
+
+const BetterStackContext = React.createContext(
+  null
+);
+function BetterStackProvider({
+  children,
+  overrides,
+  basePath
+}) {
+  const value = {
+    overrides,
+    basePath
+  };
+  return /* @__PURE__ */ jsxRuntime.jsx(BetterStackContext.Provider, { value, children });
+}
+function useBetterStack() {
+  const context = React.useContext(
+    BetterStackContext
+  );
+  if (!context) {
+    throw new Error(
+      "useBetterStack must be used within BetterStackProvider. Wrap your app with <BetterStackProvider> in your layout file."
+    );
+  }
+  return context;
+}
+function usePluginOverrides(pluginName, defaultValues) {
+  const context = useBetterStack();
+  const pluginOverrides = context.overrides[pluginName];
+  const overrides = defaultValues ? { ...defaultValues, ...pluginOverrides } : pluginOverrides;
+  return overrides;
+}
+function useBasePath() {
+  const context = useBetterStack();
+  if (!context) {
+    throw new Error(
+      "useBasePath must be used within BetterStackProvider. Wrap your app with <BetterStackProvider> in your layout file."
+    );
+  }
+  return context.basePath;
+}
+
+exports.BetterStackProvider = BetterStackProvider;
+exports.useBasePath = useBasePath;
+exports.useBetterStack = useBetterStack;
+exports.usePluginOverrides = usePluginOverrides;

package/dist/context/provider.mjs

@@ -0,0 +1,46 @@
+"use client";
+import { jsx } from 'react/jsx-runtime';
+import { createContext, useContext } from 'react';
+
+const BetterStackContext = createContext(
+  null
+);
+function BetterStackProvider({
+  children,
+  overrides,
+  basePath
+}) {
+  const value = {
+    overrides,
+    basePath
+  };
+  return /* @__PURE__ */ jsx(BetterStackContext.Provider, { value, children });
+}
+function useBetterStack() {
+  const context = useContext(
+    BetterStackContext
+  );
+  if (!context) {
+    throw new Error(
+      "useBetterStack must be used within BetterStackProvider. Wrap your app with <BetterStackProvider> in your layout file."
+    );
+  }
+  return context;
+}
+function usePluginOverrides(pluginName, defaultValues) {
+  const context = useBetterStack();
+  const pluginOverrides = context.overrides[pluginName];
+  const overrides = defaultValues ? { ...defaultValues, ...pluginOverrides } : pluginOverrides;
+  return overrides;
+}
+function useBasePath() {
+  const context = useBetterStack();
+  if (!context) {
+    throw new Error(
+      "useBasePath must be used within BetterStackProvider. Wrap your app with <BetterStackProvider> in your layout file."
+    );
+  }
+  return context.basePath;
+}
+
+export { BetterStackProvider, useBasePath, useBetterStack, usePluginOverrides };

package/dist/index.cjs

@@ -1,10 +1,9 @@
 'use strict';
 
 const api_index = require('./api/index.cjs');
-const betterCall = require('better-call');
-require('@btst/db');
+const node = require('better-call/node');
 
 
 
 exports.betterStack = api_index.betterStack;
-exports.createEndpoint = betterCall.createEndpoint;
+exports.toNodeHandler = node.toNodeHandler;

package/dist/index.d.cts

@@ -1,5 +1,6 @@
 export { betterStack } from './api/index.cjs';
-export { f as BackendLib, e as BackendLibConfig, B as BackendPlugin } from './shared/stack.DORw_1ps.cjs';
-export { createEndpoint } from 'better-call';
+export { toNodeHandler } from 'better-call/node';
+export { f as BackendLib, e as BackendLibConfig, B as BackendPlugin } from './shared/stack.ByOugz9d.cjs';
 import '@btst/yar';
 import '@btst/db';
+import 'better-call';

package/dist/index.d.mts

@@ -1,5 +1,6 @@
 export { betterStack } from './api/index.mjs';
-export { f as BackendLib, e as BackendLibConfig, B as BackendPlugin } from './shared/stack.DORw_1ps.mjs';
-export { createEndpoint } from 'better-call';
+export { toNodeHandler } from 'better-call/node';
+export { f as BackendLib, e as BackendLibConfig, B as BackendPlugin } from './shared/stack.ByOugz9d.mjs';
 import '@btst/yar';
 import '@btst/db';
+import 'better-call';

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export { betterStack } from './api/index.js';
-export { f as BackendLib, e as BackendLibConfig, B as BackendPlugin } from './shared/stack.DORw_1ps.js';
-export { createEndpoint } from 'better-call';
+export { toNodeHandler } from 'better-call/node';
+export { f as BackendLib, e as BackendLibConfig, B as BackendPlugin } from './shared/stack.ByOugz9d.js';
 import '@btst/yar';
 import '@btst/db';
+import 'better-call';

package/dist/index.mjs

@@ -1,3 +1,2 @@
 export { betterStack } from './api/index.mjs';
-export { createEndpoint } from 'better-call';
-import '@btst/db';
+export { toNodeHandler } from 'better-call/node';

package/dist/plugins/api/index.cjs

@@ -0,0 +1,13 @@
+'use strict';
+
+const betterCall = require('better-call');
+const db = require('@btst/db');
+
+function defineBackendPlugin(plugin) {
+  return plugin;
+}
+
+exports.createEndpoint = betterCall.createEndpoint;
+exports.createRouter = betterCall.createRouter;
+exports.createDbPlugin = db.createDbPlugin;
+exports.defineBackendPlugin = defineBackendPlugin;

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

@@ -0,0 +1,40 @@
+import { B as BackendPlugin } from '../../shared/stack.ByOugz9d.cjs';
+export { C as ClientPlugin } from '../../shared/stack.ByOugz9d.cjs';
+import { Endpoint } from 'better-call';
+export { Endpoint, Router, createEndpoint, createRouter } from 'better-call';
+export { Adapter, DatabaseDefinition, DbPlugin, createDbPlugin } from '@btst/db';
+import '@btst/yar';
+
+/**
+ * Plugin utilities and types for building standalone plugins
+ *
+ * This module exports everything needed to create custom plugins
+ * for Better Stack outside of this package.
+ *
+ * Note: Backend and Client plugins are separate to prevent SSR issues
+ * and enable better code splitting. Import them separately:
+ * - Backend: import type { BackendPlugin } from "@btst/stack/plugins/api"
+ * - Client: import type { ClientPlugin } from "@btst/stack/plugins/client"
+ */
+
+/**
+ * Helper to define a backend plugin with full type inference
+ *
+ * @example
+ * ```ts
+ * const messagesPlugin = defineBackendPlugin({
+ *   name: "messages",
+ *   dbPlugin: createDbPlugin("messages", messagesSchema),
+ *   routes: (adapter) => ({
+ *     list: endpoint("/messages", { method: "GET" }, async () => { ... }),
+ *     create: endpoint("/messages", { method: "POST" }, async () => { ... })
+ *   })
+ * });
+ * // Route keys "list" and "create" are preserved in types
+ * ```
+ *
+ * @template TRoutes - The exact shape of routes (auto-inferred from routes function)
+ */
+declare function defineBackendPlugin<TRoutes extends Record<string, Endpoint> = Record<string, Endpoint>>(plugin: BackendPlugin<TRoutes>): BackendPlugin<TRoutes>;
+
+export { BackendPlugin, defineBackendPlugin };

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

@@ -0,0 +1,40 @@
+import { B as BackendPlugin } from '../../shared/stack.ByOugz9d.mjs';
+export { C as ClientPlugin } from '../../shared/stack.ByOugz9d.mjs';
+import { Endpoint } from 'better-call';
+export { Endpoint, Router, createEndpoint, createRouter } from 'better-call';
+export { Adapter, DatabaseDefinition, DbPlugin, createDbPlugin } from '@btst/db';
+import '@btst/yar';
+
+/**
+ * Plugin utilities and types for building standalone plugins
+ *
+ * This module exports everything needed to create custom plugins
+ * for Better Stack outside of this package.
+ *
+ * Note: Backend and Client plugins are separate to prevent SSR issues
+ * and enable better code splitting. Import them separately:
+ * - Backend: import type { BackendPlugin } from "@btst/stack/plugins/api"
+ * - Client: import type { ClientPlugin } from "@btst/stack/plugins/client"
+ */
+
+/**
+ * Helper to define a backend plugin with full type inference
+ *
+ * @example
+ * ```ts
+ * const messagesPlugin = defineBackendPlugin({
+ *   name: "messages",
+ *   dbPlugin: createDbPlugin("messages", messagesSchema),
+ *   routes: (adapter) => ({
+ *     list: endpoint("/messages", { method: "GET" }, async () => { ... }),
+ *     create: endpoint("/messages", { method: "POST" }, async () => { ... })
+ *   })
+ * });
+ * // Route keys "list" and "create" are preserved in types
+ * ```
+ *
+ * @template TRoutes - The exact shape of routes (auto-inferred from routes function)
+ */
+declare function defineBackendPlugin<TRoutes extends Record<string, Endpoint> = Record<string, Endpoint>>(plugin: BackendPlugin<TRoutes>): BackendPlugin<TRoutes>;
+
+export { BackendPlugin, defineBackendPlugin };