@btst/stack 1.1.0 → 1.1.2

package/README.md

@@ -2,12 +2,12 @@
 
 <div align="center">
 
-**Add complete full-stack features to your React app in minutes, not weeks**
+**Composable full-stack plugin system for React frameworks**
 
 [![npm version](https://img.shields.io/npm/v/@btst/stack.svg)](https://www.npmjs.com/package/@btst/stack)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-[📖 Documentation](https://www.btst.ai) • [🐛 Issues](https://github.com/olliethedev/better-stack/issues)
+[📖 Documentation](https://www.better-stack.ai/docs) • [🐛 Issues](https://github.com/better-stack-ai/better-stack/issues)
 
 </div>
 
@@ -215,23 +215,23 @@ Now add scheduling, feedback, or newsletters the same way. Each feature is indep
 
 Better Stack transforms how you think about building apps:
 
-• **Internal teams** - Build shared features once, use across multiple apps. Your marketing team's blog plugin works in the main app, the docs site, and the landing page
-• **Open source** - Share complete features, not just code snippets. Someone can add your newsletter feature to their Next.js app in minutes
-• **Agencies** - Create a library of reusable features. Drop scheduling into client A's app, feedback into client B's app, both using React Router
-• **SaaS platforms** - Offer feature plugins your customers can compose. They pick blog + scheduling + AI assistant, mix and match to build their ideal app
-• **Rapid prototyping** - Add 5 features in an afternoon instead of 5 weeks. Validate ideas faster
+- **Open source** - Share complete features, not just code snippets. Someone can add a newsletter plugin to their Next.js app in minutes
+- **Fast development** - Add 5 features in an afternoon instead of 5 weeks. Validate ideas faster
+- **Agencies** - Create a library of reusable features. Drop scheduling into client A's app, feedback into client B's app.
+- **SaaS platforms** - Offer feature plugins your customers can compose. They pick blog + scheduling + AI assistant, mix and match to build their ideal app
 
-Each feature is a complete, self-contained full-stack capability. No configuration files. No code generation. No framework lock-in. Just add it and it works.
+
+Each plugin is a complete, self-contained horizontal full-stack feature. No framework lock-in. Just add it and it works.
 
 ## Learn More
 
-For complete documentation, examples, and plugin development guides, visit **[https://www.btst.ai](https://www.btst.ai)**
+For complete documentation, examples, and plugin development guides, visit **[https://www.better-stack.ai](https://www.better-stack.ai)**
 
 ## Examples
 
-- [Next.js App Router](./examples/nextjs) - Full SSR with App Router
-- [React Router](./examples/react-router) - Client-side routing with React Router
-- [TanStack Router](./examples/tanstack) - Type-safe routing with TanStack Router
+- [Next.js App Router](./examples/nextjs) - Next.js App Router example
+- [React Router](./examples/react-router) - React Router example
+- [TanStack Router](./examples/tanstack) - TanStack Router example
 
 ## License
 

package/dist/api/index.cjs

@@ -2,6 +2,7 @@
 
 const betterCall = require('better-call');
 const db = require('@btst/db');
+const node = require('better-call/node');
 
 function betterStack(config) {
   const { plugins, adapter, dbSchema, basePath } = config;
@@ -27,4 +28,5 @@ function betterStack(config) {
   };
 }
 
+exports.toNodeHandler = node.toNodeHandler;
 exports.betterStack = betterStack;

package/dist/api/index.d.cts

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

package/dist/api/index.d.mts

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

package/dist/api/index.d.ts

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

package/dist/api/index.mjs

@@ -1,5 +1,6 @@
 import { createRouter } from 'better-call';
 import { defineDb } from '@btst/db';
+export { toNodeHandler } from 'better-call/node';
 
 function betterStack(config) {
   const { plugins, adapter, dbSchema, basePath } = config;

package/dist/client/components/index.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
-const compose = require('./compose.cjs');
-const errorBoundary = require('./error-boundary.cjs');
+const compose = require('../../packages/better-stack/src/client/components/compose.cjs');
+const errorBoundary = require('../../packages/better-stack/src/client/components/error-boundary.cjs');
 
 
 

package/dist/client/components/index.mjs

@@ -1,2 +1,2 @@
-export { ComposedRoute, RouteRenderer } from './compose.mjs';
-export { ErrorBoundary } from './error-boundary.mjs';
+export { ComposedRoute, RouteRenderer } from '../../packages/better-stack/src/client/components/compose.mjs';
+export { ErrorBoundary } from '../../packages/better-stack/src/client/components/error-boundary.mjs';

package/dist/client/index.cjs

@@ -1,8 +1,9 @@
 'use strict';
 
 const yar = require('@btst/yar');
-const sitemapUtils = require('./sitemap-utils.cjs');
-const metaUtils = require('./meta-utils.cjs');
+const sitemapUtils = require('../packages/better-stack/src/client/sitemap-utils.cjs');
+const metaUtils = require('../packages/better-stack/src/client/meta-utils.cjs');
+const pathUtils = require('../packages/better-stack/src/client/path-utils.cjs');
 
 function createStackClient(config) {
   const { plugins } = config;
@@ -36,4 +37,5 @@ function createStackClient(config) {
 
 exports.sitemapEntryToXmlString = sitemapUtils.sitemapEntryToXmlString;
 exports.metaElementsToObject = metaUtils.metaElementsToObject;
+exports.normalizePath = pathUtils.normalizePath;
 exports.createStackClient = createStackClient;

package/dist/client/index.d.cts

@@ -72,6 +72,29 @@ interface Metadata {
  */
 declare function metaElementsToObject(metaElements: Array<React.JSX.IntrinsicElements["meta"] | undefined>): Metadata;
 
+/**
+ * Normalizes path segments from framework route params into a consistent path string.
+ *
+ * Handles different framework param formats:
+ * - Next.js: `pathParams.all` (string[])
+ * - React Router: `params["*"]` (string)
+ * - TanStack Router: `params._splat` (string)
+ *
+ * @param path - Path segments as string, string array, or undefined
+ * @returns Normalized path string starting with "/" (or "/" for empty/undefined)
+ *
+ * @example
+ * ```ts
+ * // Next.js
+ * normalizePath(pathParams?.all) // ["blog", "post"] => "/blog/post"
+ *
+ * // React Router / TanStack Router
+ * normalizePath(params["*"]) // "blog/post" => "/blog/post"
+ * normalizePath(undefined) // => "/"
+ * ```
+ */
+declare function normalizePath(path?: string | Array<string> | undefined): string;
+
 /**
  * Creates the client library with plugin support
  *
@@ -121,4 +144,4 @@ declare function metaElementsToObject(metaElements: Array<React.JSX.IntrinsicEle
  */
 declare function createStackClient<TPlugins extends Record<string, ClientPlugin<any, any>>, TRoutes extends PluginRoutes<TPlugins> = PluginRoutes<TPlugins>>(config: ClientLibConfig<TPlugins>): ClientLib<TRoutes>;
 
-export { ClientLib, ClientLibConfig, ClientPlugin, createStackClient, metaElementsToObject, sitemapEntryToXmlString };
+export { ClientLib, ClientLibConfig, ClientPlugin, createStackClient, metaElementsToObject, normalizePath, sitemapEntryToXmlString };

package/dist/client/index.d.mts

@@ -72,6 +72,29 @@ interface Metadata {
  */
 declare function metaElementsToObject(metaElements: Array<React.JSX.IntrinsicElements["meta"] | undefined>): Metadata;
 
+/**
+ * Normalizes path segments from framework route params into a consistent path string.
+ *
+ * Handles different framework param formats:
+ * - Next.js: `pathParams.all` (string[])
+ * - React Router: `params["*"]` (string)
+ * - TanStack Router: `params._splat` (string)
+ *
+ * @param path - Path segments as string, string array, or undefined
+ * @returns Normalized path string starting with "/" (or "/" for empty/undefined)
+ *
+ * @example
+ * ```ts
+ * // Next.js
+ * normalizePath(pathParams?.all) // ["blog", "post"] => "/blog/post"
+ *
+ * // React Router / TanStack Router
+ * normalizePath(params["*"]) // "blog/post" => "/blog/post"
+ * normalizePath(undefined) // => "/"
+ * ```
+ */
+declare function normalizePath(path?: string | Array<string> | undefined): string;
+
 /**
  * Creates the client library with plugin support
  *
@@ -121,4 +144,4 @@ declare function metaElementsToObject(metaElements: Array<React.JSX.IntrinsicEle
  */
 declare function createStackClient<TPlugins extends Record<string, ClientPlugin<any, any>>, TRoutes extends PluginRoutes<TPlugins> = PluginRoutes<TPlugins>>(config: ClientLibConfig<TPlugins>): ClientLib<TRoutes>;
 
-export { ClientLib, ClientLibConfig, ClientPlugin, createStackClient, metaElementsToObject, sitemapEntryToXmlString };
+export { ClientLib, ClientLibConfig, ClientPlugin, createStackClient, metaElementsToObject, normalizePath, sitemapEntryToXmlString };

package/dist/client/index.d.ts

@@ -72,6 +72,29 @@ interface Metadata {
  */
 declare function metaElementsToObject(metaElements: Array<React.JSX.IntrinsicElements["meta"] | undefined>): Metadata;
 
+/**
+ * Normalizes path segments from framework route params into a consistent path string.
+ *
+ * Handles different framework param formats:
+ * - Next.js: `pathParams.all` (string[])
+ * - React Router: `params["*"]` (string)
+ * - TanStack Router: `params._splat` (string)
+ *
+ * @param path - Path segments as string, string array, or undefined
+ * @returns Normalized path string starting with "/" (or "/" for empty/undefined)
+ *
+ * @example
+ * ```ts
+ * // Next.js
+ * normalizePath(pathParams?.all) // ["blog", "post"] => "/blog/post"
+ *
+ * // React Router / TanStack Router
+ * normalizePath(params["*"]) // "blog/post" => "/blog/post"
+ * normalizePath(undefined) // => "/"
+ * ```
+ */
+declare function normalizePath(path?: string | Array<string> | undefined): string;
+
 /**
  * Creates the client library with plugin support
  *
@@ -121,4 +144,4 @@ declare function metaElementsToObject(metaElements: Array<React.JSX.IntrinsicEle
  */
 declare function createStackClient<TPlugins extends Record<string, ClientPlugin<any, any>>, TRoutes extends PluginRoutes<TPlugins> = PluginRoutes<TPlugins>>(config: ClientLibConfig<TPlugins>): ClientLib<TRoutes>;
 
-export { ClientLib, ClientLibConfig, ClientPlugin, createStackClient, metaElementsToObject, sitemapEntryToXmlString };
+export { ClientLib, ClientLibConfig, ClientPlugin, createStackClient, metaElementsToObject, normalizePath, sitemapEntryToXmlString };

package/dist/client/index.mjs

@@ -1,6 +1,7 @@
 import { createRouter } from '@btst/yar';
-export { sitemapEntryToXmlString } from './sitemap-utils.mjs';
-export { metaElementsToObject } from './meta-utils.mjs';
+export { sitemapEntryToXmlString } from '../packages/better-stack/src/client/sitemap-utils.mjs';
+export { metaElementsToObject } from '../packages/better-stack/src/client/meta-utils.mjs';
+export { normalizePath } from '../packages/better-stack/src/client/path-utils.mjs';
 
 function createStackClient(config) {
   const { plugins } = config;

package/dist/context/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-const provider = require('./provider.cjs');
+const provider = require('../packages/better-stack/src/context/provider.cjs');
 
 
 

package/dist/context/index.mjs

@@ -1 +1 @@
-export { BetterStackProvider, useBasePath, useBetterStack, usePluginOverrides } from './provider.mjs';
+export { BetterStackProvider, useBasePath, useBetterStack, usePluginOverrides } from '../packages/better-stack/src/context/provider.mjs';

package/dist/index.cjs

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

package/dist/index.d.cts

@@ -1,4 +1,5 @@
 export { betterStack } from './api/index.cjs';
+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';

package/dist/index.d.mts

@@ -1,4 +1,5 @@
 export { betterStack } from './api/index.mjs';
+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';

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export { betterStack } from './api/index.js';
+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';

package/dist/index.mjs

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