@btst/stack 1.0.0

package/README.md

@@ -0,0 +1,3 @@
+# BETTER STACK
+
+WIP

package/dist/api/index.cjs

@@ -0,0 +1,30 @@
+'use strict';
+
+const betterCall = require('better-call');
+const db = require('@btst/db');
+
+function betterStack(config) {
+  const { plugins, adapter, dbSchema } = config;
+  const allRoutes = {};
+  let betterDbSchema = dbSchema ?? db.defineDb({});
+  for (const [pluginKey, plugin] of Object.entries(plugins)) {
+    betterDbSchema = betterDbSchema.use(plugin.dbPlugin);
+  }
+  for (const [pluginKey, plugin] of Object.entries(plugins)) {
+    const pluginRoutes = plugin.routes(adapter(betterDbSchema));
+    for (const [routeKey, endpoint] of Object.entries(pluginRoutes)) {
+      const compositeKey = `${pluginKey}_${routeKey}`;
+      allRoutes[compositeKey] = endpoint;
+    }
+  }
+  const router = betterCall.createRouter(allRoutes, {
+    basePath: "/api"
+  });
+  return {
+    handler: router.handler,
+    router,
+    dbSchema: betterDbSchema
+  };
+}
+
+exports.betterStack = betterStack;

package/dist/api/index.d.cts

@@ -0,0 +1,29 @@
+import { e as PrefixedPluginRoutes, f as BackendLibConfig, g as BackendLib } from '../shared/stack.Dva9muUy.cjs';
+export { B as BackendPlugin } from '../shared/stack.Dva9muUy.cjs';
+import '@btst/yar';
+import '@btst/db';
+import 'better-call';
+
+/**
+ * Creates the backend library with plugin support
+ *
+ * @example
+ * ```ts
+ * const api = betterStack({
+ *   plugins: {
+ *     messages: messagesPlugin.backend
+ *   },
+ *   adapter: memoryAdapter
+ * });
+ *
+ * // Use in API route:
+ * export const GET = api.handler;
+ * export const POST = api.handler;
+ * ```
+ *
+ * @template TPlugins - The exact plugins map (inferred from config)
+ * @template TRoutes - All routes with prefixed keys like "pluginName_routeName" (computed automatically)
+ */
+declare function betterStack<TPlugins extends Record<string, any>, TRoutes extends PrefixedPluginRoutes<TPlugins> = PrefixedPluginRoutes<TPlugins>>(config: BackendLibConfig<TPlugins>): BackendLib<TRoutes>;
+
+export { BackendLib, BackendLibConfig, betterStack };

package/dist/api/index.d.mts

@@ -0,0 +1,29 @@
+import { e as PrefixedPluginRoutes, f as BackendLibConfig, g as BackendLib } from '../shared/stack.Dva9muUy.mjs';
+export { B as BackendPlugin } from '../shared/stack.Dva9muUy.mjs';
+import '@btst/yar';
+import '@btst/db';
+import 'better-call';
+
+/**
+ * Creates the backend library with plugin support
+ *
+ * @example
+ * ```ts
+ * const api = betterStack({
+ *   plugins: {
+ *     messages: messagesPlugin.backend
+ *   },
+ *   adapter: memoryAdapter
+ * });
+ *
+ * // Use in API route:
+ * export const GET = api.handler;
+ * export const POST = api.handler;
+ * ```
+ *
+ * @template TPlugins - The exact plugins map (inferred from config)
+ * @template TRoutes - All routes with prefixed keys like "pluginName_routeName" (computed automatically)
+ */
+declare function betterStack<TPlugins extends Record<string, any>, TRoutes extends PrefixedPluginRoutes<TPlugins> = PrefixedPluginRoutes<TPlugins>>(config: BackendLibConfig<TPlugins>): BackendLib<TRoutes>;
+
+export { BackendLib, BackendLibConfig, betterStack };

package/dist/api/index.d.ts

@@ -0,0 +1,29 @@
+import { e as PrefixedPluginRoutes, f as BackendLibConfig, g as BackendLib } from '../shared/stack.Dva9muUy.js';
+export { B as BackendPlugin } from '../shared/stack.Dva9muUy.js';
+import '@btst/yar';
+import '@btst/db';
+import 'better-call';
+
+/**
+ * Creates the backend library with plugin support
+ *
+ * @example
+ * ```ts
+ * const api = betterStack({
+ *   plugins: {
+ *     messages: messagesPlugin.backend
+ *   },
+ *   adapter: memoryAdapter
+ * });
+ *
+ * // Use in API route:
+ * export const GET = api.handler;
+ * export const POST = api.handler;
+ * ```
+ *
+ * @template TPlugins - The exact plugins map (inferred from config)
+ * @template TRoutes - All routes with prefixed keys like "pluginName_routeName" (computed automatically)
+ */
+declare function betterStack<TPlugins extends Record<string, any>, TRoutes extends PrefixedPluginRoutes<TPlugins> = PrefixedPluginRoutes<TPlugins>>(config: BackendLibConfig<TPlugins>): BackendLib<TRoutes>;
+
+export { BackendLib, BackendLibConfig, betterStack };

package/dist/api/index.mjs

@@ -0,0 +1,28 @@
+import { createRouter } from 'better-call';
+import { defineDb } from '@btst/db';
+
+function betterStack(config) {
+  const { plugins, adapter, dbSchema } = config;
+  const allRoutes = {};
+  let betterDbSchema = dbSchema ?? defineDb({});
+  for (const [pluginKey, plugin] of Object.entries(plugins)) {
+    betterDbSchema = betterDbSchema.use(plugin.dbPlugin);
+  }
+  for (const [pluginKey, plugin] of Object.entries(plugins)) {
+    const pluginRoutes = plugin.routes(adapter(betterDbSchema));
+    for (const [routeKey, endpoint] of Object.entries(pluginRoutes)) {
+      const compositeKey = `${pluginKey}_${routeKey}`;
+      allRoutes[compositeKey] = endpoint;
+    }
+  }
+  const router = createRouter(allRoutes, {
+    basePath: "/api"
+  });
+  return {
+    handler: router.handler,
+    router,
+    dbSchema: betterDbSchema
+  };
+}
+
+export { betterStack };

package/dist/client/index.cjs

@@ -0,0 +1,34 @@
+'use strict';
+
+const yar = require('@btst/yar');
+const context_index = require('../context/index.cjs');
+const utils = require('../shared/stack.Br2KMECJ.cjs');
+require('react/jsx-runtime');
+require('react');
+require('better-call/client');
+
+function createStackClient(config) {
+  const { plugins } = config;
+  const allRoutes = {};
+  const allHooks = {};
+  for (const [pluginKey, plugin] of Object.entries(plugins)) {
+    const pluginRoutes = plugin.routes();
+    Object.assign(allRoutes, pluginRoutes);
+    if (plugin.hooks) {
+      allHooks[pluginKey] = plugin.hooks();
+    }
+  }
+  const router = yar.createRouter(allRoutes);
+  return {
+    router,
+    hooks: allHooks
+  };
+}
+
+exports.BetterStackProvider = context_index.BetterStackProvider;
+exports.useBetterStack = context_index.useBetterStack;
+exports.usePluginOverride = context_index.usePluginOverride;
+exports.usePluginOverrides = context_index.usePluginOverrides;
+exports.createApiClient = utils.createApiClient;
+exports.getServerBaseURL = utils.getServerBaseURL;
+exports.createStackClient = createStackClient;

package/dist/client/index.d.cts

@@ -0,0 +1,36 @@
+import { C as ClientPlugin, P as PluginRoutes, a as PluginHooks, b as ClientLibConfig, c as ClientLib } from '../shared/stack.Dva9muUy.cjs';
+export { BetterStackProvider, useBetterStack, usePluginOverride, usePluginOverrides } from '../context/index.cjs';
+export { c as createApiClient, g as getServerBaseURL } from '../shared/stack.DvFqFlOV.cjs';
+import '@btst/yar';
+import '@btst/db';
+import 'better-call';
+import 'react/jsx-runtime';
+import 'react';
+import 'better-call/client';
+
+/**
+ * Creates the client library with plugin support
+ *
+ * @example
+ * ```ts
+ * // For Next.js with SSR:
+ * const lib = createStackClient({
+ *   plugins: {
+ *     messages: messagesPlugin.client
+ *   }
+ * });
+ *
+ * // Access router for page routing
+ * const route = lib.router.getRoute('/messages');
+ *
+ * // For SPA (just use hooks directly):
+ * const { useMessages } = lib.hooks.messages;
+ * ```
+ *
+ * @template TPlugins - The exact plugins map (inferred from config)
+ * @template TRoutes - All routes from all plugins, merged (computed automatically)
+ * @template THooks - All hooks from all plugins, organized by plugin name (computed automatically)
+ */
+declare function createStackClient<TPlugins extends Record<string, ClientPlugin<any, any>>, TRoutes extends PluginRoutes<TPlugins> = PluginRoutes<TPlugins>, THooks extends PluginHooks<TPlugins> = PluginHooks<TPlugins>>(config: ClientLibConfig<TPlugins>): ClientLib<TRoutes, THooks>;
+
+export { ClientLib, ClientLibConfig, ClientPlugin, createStackClient };

package/dist/client/index.d.mts

@@ -0,0 +1,36 @@
+import { C as ClientPlugin, P as PluginRoutes, a as PluginHooks, b as ClientLibConfig, c as ClientLib } from '../shared/stack.Dva9muUy.mjs';
+export { BetterStackProvider, useBetterStack, usePluginOverride, usePluginOverrides } from '../context/index.mjs';
+export { c as createApiClient, g as getServerBaseURL } from '../shared/stack.DvFqFlOV.mjs';
+import '@btst/yar';
+import '@btst/db';
+import 'better-call';
+import 'react/jsx-runtime';
+import 'react';
+import 'better-call/client';
+
+/**
+ * Creates the client library with plugin support
+ *
+ * @example
+ * ```ts
+ * // For Next.js with SSR:
+ * const lib = createStackClient({
+ *   plugins: {
+ *     messages: messagesPlugin.client
+ *   }
+ * });
+ *
+ * // Access router for page routing
+ * const route = lib.router.getRoute('/messages');
+ *
+ * // For SPA (just use hooks directly):
+ * const { useMessages } = lib.hooks.messages;
+ * ```
+ *
+ * @template TPlugins - The exact plugins map (inferred from config)
+ * @template TRoutes - All routes from all plugins, merged (computed automatically)
+ * @template THooks - All hooks from all plugins, organized by plugin name (computed automatically)
+ */
+declare function createStackClient<TPlugins extends Record<string, ClientPlugin<any, any>>, TRoutes extends PluginRoutes<TPlugins> = PluginRoutes<TPlugins>, THooks extends PluginHooks<TPlugins> = PluginHooks<TPlugins>>(config: ClientLibConfig<TPlugins>): ClientLib<TRoutes, THooks>;
+
+export { ClientLib, ClientLibConfig, ClientPlugin, createStackClient };

package/dist/client/index.d.ts

@@ -0,0 +1,36 @@
+import { C as ClientPlugin, P as PluginRoutes, a as PluginHooks, b as ClientLibConfig, c as ClientLib } from '../shared/stack.Dva9muUy.js';
+export { BetterStackProvider, useBetterStack, usePluginOverride, usePluginOverrides } from '../context/index.js';
+export { c as createApiClient, g as getServerBaseURL } from '../shared/stack.DvFqFlOV.js';
+import '@btst/yar';
+import '@btst/db';
+import 'better-call';
+import 'react/jsx-runtime';
+import 'react';
+import 'better-call/client';
+
+/**
+ * Creates the client library with plugin support
+ *
+ * @example
+ * ```ts
+ * // For Next.js with SSR:
+ * const lib = createStackClient({
+ *   plugins: {
+ *     messages: messagesPlugin.client
+ *   }
+ * });
+ *
+ * // Access router for page routing
+ * const route = lib.router.getRoute('/messages');
+ *
+ * // For SPA (just use hooks directly):
+ * const { useMessages } = lib.hooks.messages;
+ * ```
+ *
+ * @template TPlugins - The exact plugins map (inferred from config)
+ * @template TRoutes - All routes from all plugins, merged (computed automatically)
+ * @template THooks - All hooks from all plugins, organized by plugin name (computed automatically)
+ */
+declare function createStackClient<TPlugins extends Record<string, ClientPlugin<any, any>>, TRoutes extends PluginRoutes<TPlugins> = PluginRoutes<TPlugins>, THooks extends PluginHooks<TPlugins> = PluginHooks<TPlugins>>(config: ClientLibConfig<TPlugins>): ClientLib<TRoutes, THooks>;
+
+export { ClientLib, ClientLibConfig, ClientPlugin, createStackClient };

package/dist/client/index.mjs

@@ -0,0 +1,26 @@
+import { createRouter } from '@btst/yar';
+export { BetterStackProvider, useBetterStack, usePluginOverride, usePluginOverrides } from '../context/index.mjs';
+export { c as createApiClient, g as getServerBaseURL } from '../shared/stack.CwGEQ10b.mjs';
+import 'react/jsx-runtime';
+import 'react';
+import 'better-call/client';
+
+function createStackClient(config) {
+  const { plugins } = config;
+  const allRoutes = {};
+  const allHooks = {};
+  for (const [pluginKey, plugin] of Object.entries(plugins)) {
+    const pluginRoutes = plugin.routes();
+    Object.assign(allRoutes, pluginRoutes);
+    if (plugin.hooks) {
+      allHooks[pluginKey] = plugin.hooks();
+    }
+  }
+  const router = createRouter(allRoutes);
+  return {
+    router,
+    hooks: allHooks
+  };
+}
+
+export { createStackClient };

package/dist/context/index.cjs

@@ -0,0 +1,55 @@
+"use client";
+'use strict';
+
+const jsxRuntime = require('react/jsx-runtime');
+const react = require('react');
+
+const BetterStackContext = react.createContext(
+  null
+);
+function BetterStackProvider({
+  children,
+  overrides
+}) {
+  const value = {
+    overrides
+  };
+  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;
+}
+
+exports.BetterStackProvider = BetterStackProvider;
+exports.useBetterStack = useBetterStack;
+exports.usePluginOverride = usePluginOverride;
+exports.usePluginOverrides = usePluginOverrides;

package/dist/context/index.d.cts

@@ -0,0 +1,86 @@
+"use client";
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+
+/**
+ * Context value that provides plugin-specific overrides
+ * Generic over the shape of all plugin overrides
+ */
+interface BetterStackContextValue<TPluginOverrides extends Record<string, any>> {
+    overrides: TPluginOverrides;
+}
+/**
+ * Provider component for BetterStack context
+ * Provides type-safe access to plugin-specific overrides
+ *
+ * Only requires override values, not plugin objects - keeps bundle size minimal!
+ *
+ * @example
+ * ```tsx
+ * // Define the type shape (no import of plugin values needed!)
+ * type MyPluginOverrides = {
+ *   todos: TodosPluginOverrides;
+ *   messages: MessagesPluginOverrides;
+ * };
+ *
+ * <BetterStackProvider<MyPluginOverrides>
+ *   overrides={{
+ *     todos: {
+ *       Link: (props) => <NextLink {...props} />,
+ *       navigate: (path) => router.push(path),
+ *     },
+ *     messages: {
+ *       MarkdownRenderer: (props) => <ReactMarkdown {...props} />,
+ *     }
+ *   }}
+ * >
+ *   {children}
+ * </BetterStackProvider>
+ * ```
+ */
+declare function BetterStackProvider<TPluginOverrides extends Record<string, any> = Record<string, any>>({ children, overrides, }: {
+    children: ReactNode;
+    overrides: TPluginOverrides;
+}): react_jsx_runtime.JSX.Element;
+/**
+ * Hook to access the entire context
+ * 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>;
+/**
+ * Hook to access overrides for a specific plugin
+ * This is type-safe and will only expose the overrides defined by that plugin
+ *
+ * @example
+ * ```tsx
+ * // In a todos plugin component
+ * function TodosList() {
+ *   const { Link, navigate } = usePluginOverrides<TodosPluginOverrides>("todos");
+ *
+ *   return (
+ *     <Link href="/todos/add">
+ *       <button onClick={() => navigate("/todos")}>
+ *         Add Todo
+ *       </button>
+ *     </Link>
+ *   );
+ * }
+ * ```
+ */
+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
+ * function TodosList() {
+ *   const Link = usePluginOverride<typeof NextLink>("todos", "Link");
+ *
+ *   return <Link href="/todos/add">Add Todo</Link>;
+ * }
+ * ```
+ */
+declare function usePluginOverride<TOverride = any>(pluginName: string, overrideKey: string): TOverride;
+
+export { BetterStackProvider, useBetterStack, usePluginOverride, usePluginOverrides };

package/dist/context/index.d.mts

@@ -0,0 +1,86 @@
+"use client";
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+
+/**
+ * Context value that provides plugin-specific overrides
+ * Generic over the shape of all plugin overrides
+ */
+interface BetterStackContextValue<TPluginOverrides extends Record<string, any>> {
+    overrides: TPluginOverrides;
+}
+/**
+ * Provider component for BetterStack context
+ * Provides type-safe access to plugin-specific overrides
+ *
+ * Only requires override values, not plugin objects - keeps bundle size minimal!
+ *
+ * @example
+ * ```tsx
+ * // Define the type shape (no import of plugin values needed!)
+ * type MyPluginOverrides = {
+ *   todos: TodosPluginOverrides;
+ *   messages: MessagesPluginOverrides;
+ * };
+ *
+ * <BetterStackProvider<MyPluginOverrides>
+ *   overrides={{
+ *     todos: {
+ *       Link: (props) => <NextLink {...props} />,
+ *       navigate: (path) => router.push(path),
+ *     },
+ *     messages: {
+ *       MarkdownRenderer: (props) => <ReactMarkdown {...props} />,
+ *     }
+ *   }}
+ * >
+ *   {children}
+ * </BetterStackProvider>
+ * ```
+ */
+declare function BetterStackProvider<TPluginOverrides extends Record<string, any> = Record<string, any>>({ children, overrides, }: {
+    children: ReactNode;
+    overrides: TPluginOverrides;
+}): react_jsx_runtime.JSX.Element;
+/**
+ * Hook to access the entire context
+ * 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>;
+/**
+ * Hook to access overrides for a specific plugin
+ * This is type-safe and will only expose the overrides defined by that plugin
+ *
+ * @example
+ * ```tsx
+ * // In a todos plugin component
+ * function TodosList() {
+ *   const { Link, navigate } = usePluginOverrides<TodosPluginOverrides>("todos");
+ *
+ *   return (
+ *     <Link href="/todos/add">
+ *       <button onClick={() => navigate("/todos")}>
+ *         Add Todo
+ *       </button>
+ *     </Link>
+ *   );
+ * }
+ * ```
+ */
+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
+ * function TodosList() {
+ *   const Link = usePluginOverride<typeof NextLink>("todos", "Link");
+ *
+ *   return <Link href="/todos/add">Add Todo</Link>;
+ * }
+ * ```
+ */
+declare function usePluginOverride<TOverride = any>(pluginName: string, overrideKey: string): TOverride;
+
+export { BetterStackProvider, useBetterStack, usePluginOverride, usePluginOverrides };

package/dist/context/index.d.ts

@@ -0,0 +1,86 @@
+"use client";
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { ReactNode } from 'react';
+
+/**
+ * Context value that provides plugin-specific overrides
+ * Generic over the shape of all plugin overrides
+ */
+interface BetterStackContextValue<TPluginOverrides extends Record<string, any>> {
+    overrides: TPluginOverrides;
+}
+/**
+ * Provider component for BetterStack context
+ * Provides type-safe access to plugin-specific overrides
+ *
+ * Only requires override values, not plugin objects - keeps bundle size minimal!
+ *
+ * @example
+ * ```tsx
+ * // Define the type shape (no import of plugin values needed!)
+ * type MyPluginOverrides = {
+ *   todos: TodosPluginOverrides;
+ *   messages: MessagesPluginOverrides;
+ * };
+ *
+ * <BetterStackProvider<MyPluginOverrides>
+ *   overrides={{
+ *     todos: {
+ *       Link: (props) => <NextLink {...props} />,
+ *       navigate: (path) => router.push(path),
+ *     },
+ *     messages: {
+ *       MarkdownRenderer: (props) => <ReactMarkdown {...props} />,
+ *     }
+ *   }}
+ * >
+ *   {children}
+ * </BetterStackProvider>
+ * ```
+ */
+declare function BetterStackProvider<TPluginOverrides extends Record<string, any> = Record<string, any>>({ children, overrides, }: {
+    children: ReactNode;
+    overrides: TPluginOverrides;
+}): react_jsx_runtime.JSX.Element;
+/**
+ * Hook to access the entire context
+ * 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>;
+/**
+ * Hook to access overrides for a specific plugin
+ * This is type-safe and will only expose the overrides defined by that plugin
+ *
+ * @example
+ * ```tsx
+ * // In a todos plugin component
+ * function TodosList() {
+ *   const { Link, navigate } = usePluginOverrides<TodosPluginOverrides>("todos");
+ *
+ *   return (
+ *     <Link href="/todos/add">
+ *       <button onClick={() => navigate("/todos")}>
+ *         Add Todo
+ *       </button>
+ *     </Link>
+ *   );
+ * }
+ * ```
+ */
+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
+ * function TodosList() {
+ *   const Link = usePluginOverride<typeof NextLink>("todos", "Link");
+ *
+ *   return <Link href="/todos/add">Add Todo</Link>;
+ * }
+ * ```
+ */
+declare function usePluginOverride<TOverride = any>(pluginName: string, overrideKey: string): TOverride;
+
+export { BetterStackProvider, useBetterStack, usePluginOverride, usePluginOverrides };