@btst/stack 1.0.0 → 1.1.0

package/dist/client/meta-utils.mjs

@@ -0,0 +1,160 @@
+function metaElementsToObject(metaElements) {
+  const metadata = { title: "" };
+  const nameHandlers = {
+    title: (c) => {
+      metadata.title = c;
+    },
+    description: (c) => {
+      metadata.description = c;
+    },
+    keywords: (c) => {
+      const parts = c.split(",").map((k) => k.trim()).filter(Boolean);
+      metadata.keywords = parts.length > 0 ? parts : void 0;
+    },
+    "application-name": (c) => {
+      metadata.applicationName = c;
+    },
+    generator: (c) => {
+      metadata.generator = c;
+    },
+    referrer: (c) => {
+      const allowedReferrers = /* @__PURE__ */ new Set([
+        "no-referrer",
+        "origin",
+        "no-referrer-when-downgrade",
+        "origin-when-cross-origin",
+        "same-origin",
+        "strict-origin",
+        "strict-origin-when-cross-origin",
+        "unsafe-url"
+      ]);
+      if (allowedReferrers.has(c)) {
+        metadata.referrer = c;
+      }
+    },
+    "theme-color": (c) => {
+      metadata.themeColor = c;
+    },
+    viewport: (c) => {
+      metadata.viewport = c;
+    },
+    creator: (c) => {
+      metadata.creator = c;
+    },
+    publisher: (c) => {
+      metadata.publisher = c;
+    },
+    author: (c) => {
+      metadata.authors = [{ name: c }];
+    },
+    abstract: (c) => {
+      metadata.abstract = c;
+    },
+    robots: (c) => {
+      metadata.robots = c;
+    },
+    // Twitter
+    "twitter:title": (c) => {
+      if (!metadata.twitter) metadata.twitter = {};
+      metadata.twitter.title = c;
+    },
+    "twitter:description": (c) => {
+      if (!metadata.twitter) metadata.twitter = {};
+      metadata.twitter.description = c;
+    },
+    "twitter:site": (c) => {
+      if (!metadata.twitter) metadata.twitter = {};
+      metadata.twitter.site = c;
+    },
+    "twitter:creator": (c) => {
+      if (!metadata.twitter) metadata.twitter = {};
+      metadata.twitter.creator = c;
+    },
+    "twitter:image": (c) => {
+      if (!metadata.twitter) metadata.twitter = {};
+      const currentImages = metadata.twitter.images;
+      if (!currentImages) {
+        metadata.twitter.images = [c];
+      } else if (Array.isArray(currentImages)) {
+        metadata.twitter.images = [...currentImages, c];
+      } else {
+        metadata.twitter.images = [currentImages, c];
+      }
+    }
+  };
+  const propertyHandlers = {
+    "og:title": (c) => {
+      if (!metadata.openGraph) metadata.openGraph = {};
+      metadata.openGraph.title = c;
+    },
+    "og:description": (c) => {
+      if (!metadata.openGraph) metadata.openGraph = {};
+      metadata.openGraph.description = c;
+    },
+    "og:url": (c) => {
+      if (!metadata.openGraph) metadata.openGraph = {};
+      metadata.openGraph.url = c;
+      metadata.alternates = {
+        ...metadata.alternates ?? {},
+        canonical: c
+      };
+    },
+    "og:site_name": (c) => {
+      if (!metadata.openGraph) metadata.openGraph = {};
+      metadata.openGraph.siteName = c;
+    },
+    "og:locale": (c) => {
+      if (!metadata.openGraph) metadata.openGraph = {};
+      metadata.openGraph.locale = c;
+    },
+    "og:image": (c) => {
+      if (!metadata.openGraph) metadata.openGraph = {};
+      const currentImages = metadata.openGraph.images;
+      if (!currentImages) {
+        metadata.openGraph.images = [c];
+      } else if (Array.isArray(currentImages)) {
+        metadata.openGraph.images = [...currentImages, c];
+      } else {
+        metadata.openGraph.images = [currentImages, c];
+      }
+    },
+    "og:video": (c) => {
+      if (!metadata.openGraph) metadata.openGraph = {};
+      const currentVideos = metadata.openGraph.videos;
+      if (!currentVideos) {
+        metadata.openGraph.videos = [c];
+      } else if (Array.isArray(currentVideos)) {
+        metadata.openGraph.videos = [...currentVideos, c];
+      } else {
+        metadata.openGraph.videos = [currentVideos, c];
+      }
+    },
+    "og:audio": (c) => {
+      if (!metadata.openGraph) metadata.openGraph = {};
+      const currentAudio = metadata.openGraph.audio;
+      if (!currentAudio) {
+        metadata.openGraph.audio = [c];
+      } else if (Array.isArray(currentAudio)) {
+        metadata.openGraph.audio = [...currentAudio, c];
+      } else {
+        metadata.openGraph.audio = [currentAudio, c];
+      }
+    }
+  };
+  for (const meta of metaElements) {
+    if (!meta) continue;
+    if ("name" in meta && "content" in meta) {
+      const handler = nameHandlers[String(meta.name)];
+      if (handler) handler(String(meta.content));
+      continue;
+    }
+    if ("property" in meta && "content" in meta) {
+      const handler = propertyHandlers[String(meta.property)];
+      if (handler) handler(String(meta.content));
+      continue;
+    }
+  }
+  return metadata;
+}
+
+export { metaElementsToObject };

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,55 +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
-}) {
-  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;
+
+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,14 @@ 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;
 }
 /**
  * Provider component for BetterStack context
@@ -38,49 +44,43 @@ interface BetterStackContextValue<TPluginOverrides extends Record<string, any>>
  * </BetterStackProvider>
  * ```
  */
-declare function BetterStackProvider<TPluginOverrides extends Record<string, any> = Record<string, any>>({ children, overrides, }: {
-    children: ReactNode;
+declare function BetterStackProvider<TPluginOverrides extends Record<string, any> = Record<string, any>>({ children, overrides, basePath, }: {
+    children?: ReactNode;
     overrides: TPluginOverrides;
+    basePath: string;
 }): 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>;
+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, 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,14 @@ 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;
 }
 /**
  * Provider component for BetterStack context
@@ -38,49 +44,43 @@ interface BetterStackContextValue<TPluginOverrides extends Record<string, any>>
  * </BetterStackProvider>
  * ```
  */
-declare function BetterStackProvider<TPluginOverrides extends Record<string, any> = Record<string, any>>({ children, overrides, }: {
-    children: ReactNode;
+declare function BetterStackProvider<TPluginOverrides extends Record<string, any> = Record<string, any>>({ children, overrides, basePath, }: {
+    children?: ReactNode;
     overrides: TPluginOverrides;
+    basePath: string;
 }): 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>;
+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, 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,14 @@ 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;
 }
 /**
  * Provider component for BetterStack context
@@ -38,49 +44,43 @@ interface BetterStackContextValue<TPluginOverrides extends Record<string, any>>
  * </BetterStackProvider>
  * ```
  */
-declare function BetterStackProvider<TPluginOverrides extends Record<string, any> = Record<string, any>>({ children, overrides, }: {
-    children: ReactNode;
+declare function BetterStackProvider<TPluginOverrides extends Record<string, any> = Record<string, any>>({ children, overrides, basePath, }: {
+    children?: ReactNode;
     overrides: TPluginOverrides;
+    basePath: string;
 }): 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>;
+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, useBetterStack, usePluginOverride, usePluginOverrides };
+export { BetterStackProvider, useBasePath, useBetterStack, usePluginOverrides };

package/dist/context/index.mjs

@@ -1,50 +1 @@
-"use client";
-import { jsx } from 'react/jsx-runtime';
-import { createContext, useContext } from 'react';
-
-const BetterStackContext = createContext(
-  null
-);
-function BetterStackProvider({
-  children,
-  overrides
-}) {
-  const value = {
-    overrides
-  };
-  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;
-}
-
-export { BetterStackProvider, 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,8 +1,6 @@
 'use strict';
 
 const api_index = require('./api/index.cjs');
-require('better-call');
-require('@btst/db');