@btst/stack 1.0.0 → 1.1.0

package/dist/plugins/blog/schemas.cjs

@@ -0,0 +1,39 @@
+'use strict';
+
+const zod = require('zod');
+
+const dateFields = {
+  publishedAt: zod.z.coerce.date().optional(),
+  createdAt: zod.z.coerce.date().optional(),
+  updatedAt: zod.z.coerce.date().optional()
+};
+const coreFields = {
+  title: zod.z.string().min(1, "Title is required"),
+  content: zod.z.string().min(1, "Content is required"),
+  excerpt: zod.z.string().min(1, "Excerpt is required"),
+  image: zod.z.string().optional(),
+  published: zod.z.boolean().optional().default(false),
+  slug: zod.z.string().min(1, "Slug is required"),
+  tags: zod.z.array(
+    zod.z.union([
+      zod.z.object({ name: zod.z.string() }),
+      zod.z.object({ id: zod.z.string(), name: zod.z.string(), slug: zod.z.string() })
+    ])
+  ).optional().default([])
+};
+const PostDomainSchema = zod.z.object({
+  id: zod.z.string().optional(),
+  ...coreFields,
+  ...dateFields
+});
+const createPostSchema = PostDomainSchema.extend({
+  slug: PostDomainSchema.shape.slug.optional()
+}).omit({ id: true });
+const updatePostSchema = PostDomainSchema.extend({
+  id: zod.z.string()
+  // required on update
+});
+
+exports.PostDomainSchema = PostDomainSchema;
+exports.createPostSchema = createPostSchema;
+exports.updatePostSchema = updatePostSchema;

package/dist/plugins/blog/schemas.mjs

@@ -0,0 +1,35 @@
+import { z } from 'zod';
+
+const dateFields = {
+  publishedAt: z.coerce.date().optional(),
+  createdAt: z.coerce.date().optional(),
+  updatedAt: z.coerce.date().optional()
+};
+const coreFields = {
+  title: z.string().min(1, "Title is required"),
+  content: z.string().min(1, "Content is required"),
+  excerpt: z.string().min(1, "Excerpt is required"),
+  image: z.string().optional(),
+  published: z.boolean().optional().default(false),
+  slug: z.string().min(1, "Slug is required"),
+  tags: z.array(
+    z.union([
+      z.object({ name: z.string() }),
+      z.object({ id: z.string(), name: z.string(), slug: z.string() })
+    ])
+  ).optional().default([])
+};
+const PostDomainSchema = z.object({
+  id: z.string().optional(),
+  ...coreFields,
+  ...dateFields
+});
+const createPostSchema = PostDomainSchema.extend({
+  slug: PostDomainSchema.shape.slug.optional()
+}).omit({ id: true });
+const updatePostSchema = PostDomainSchema.extend({
+  id: z.string()
+  // required on update
+});
+
+export { PostDomainSchema, createPostSchema, updatePostSchema };

package/dist/plugins/blog/style.css

@@ -0,0 +1,22 @@
+@import "./client.css";
+
+/*
+ * Blog 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/blog/css";
+ */
+
+/* Scan this package's source files for Tailwind classes */
+@source "../../../src/**/*.{ts,tsx}";
+
+/* Scan UI package components (if in monorepo) */
+@source "../../../../@workspace/ui/src/**/*.{ts,tsx}";
+
+/* Scan UI package components (if installed as npm package) */
+@source "../../../node_modules/@workspace/ui/src/**/*.{ts,tsx}";
+
+/*
+* alternatively consumer can use @source "../node_modules/@btst/stack/src/**\/*.{ts,tsx}";
+*/

package/dist/plugins/blog/utils.cjs

@@ -0,0 +1,97 @@
+'use strict';
+
+const clsx = require('clsx');
+const tailwindMerge = require('tailwind-merge');
+const slug = require('slug');
+
+function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e.default : e; }
+
+const slug__default = /*#__PURE__*/_interopDefaultCompat(slug);
+
+function slugify(text, locale = "en") {
+  return slug__default(text, { lower: true, locale });
+}
+function cn(...inputs) {
+  return tailwindMerge.twMerge(clsx.clsx(inputs));
+}
+function throttle(callback, waitMs) {
+  let timerId = null;
+  let lastInvokeTime = 0;
+  let trailingArgs = null;
+  const invoke = (args) => {
+    lastInvokeTime = Date.now();
+    callback(...args);
+  };
+  const throttled = (...args) => {
+    const now = Date.now();
+    const remaining = waitMs - (now - lastInvokeTime);
+    if (lastInvokeTime === 0) {
+      invoke(args);
+      return;
+    }
+    if (remaining <= 0 || remaining > waitMs) {
+      if (timerId) {
+        clearTimeout(timerId);
+        timerId = null;
+      }
+      invoke(args);
+    } else {
+      trailingArgs = args;
+      if (!timerId) {
+        timerId = setTimeout(() => {
+          timerId = null;
+          if (trailingArgs) {
+            invoke(trailingArgs);
+            trailingArgs = null;
+          }
+        }, remaining);
+      }
+    }
+  };
+  throttled.cancel = () => {
+    if (timerId) {
+      clearTimeout(timerId);
+      timerId = null;
+    }
+    trailingArgs = null;
+    lastInvokeTime = 0;
+  };
+  throttled.flush = () => {
+    if (timerId && trailingArgs) {
+      clearTimeout(timerId);
+      timerId = null;
+      invoke(trailingArgs);
+      trailingArgs = null;
+    }
+  };
+  return throttled;
+}
+function stripHtml(html) {
+  let text = html.replace(/<[^>]*>/g, "");
+  text = text.replace(/&amp;/g, "&").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/&#x27;/g, "'").replace(/&#x2F;/g, "/").replace(/&nbsp;/g, " ").replace(/&hellip;/g, "...");
+  return text.replace(/\s+/g, " ").trim();
+}
+function stripMarkdown(markdown) {
+  let text = markdown;
+  text = text.replace(/^#{1,6}\s+/gm, "");
+  text = text.replace(/\*\*([^*]+)\*\*/g, "$1");
+  text = text.replace(/\*([^*]+)\*/g, "$1");
+  text = text.replace(/__([^_]+)__/g, "$1");
+  text = text.replace(/_([^_]+)_/g, "$1");
+  text = text.replace(/~~([^~]+)~~/g, "$1");
+  text = text.replace(/`([^`]+)`/g, "$1");
+  text = text.replace(/```[\s\S]*?```/g, "");
+  text = text.replace(/\[([^\]]+)\]\([^)]+\)/g, "$1");
+  text = text.replace(/!\[([^\]]*)\]\([^)]+\)/g, "$1");
+  text = text.replace(/^>\s+/gm, "");
+  text = text.replace(/^[-*]{3,}$/gm, "");
+  text = text.replace(/^[\s]*[-*+]\s+/gm, "");
+  text = text.replace(/^[\s]*\d+\.\s+/gm, "");
+  return text.replace(/\n\s*\n/g, "\n").replace(/\s+/g, " ").trim();
+}
+
+exports.cn = cn;
+exports.slugify = slugify;
+exports.stripHtml = stripHtml;
+exports.stripMarkdown = stripMarkdown;
+exports.throttle = throttle;

package/dist/plugins/blog/utils.mjs

@@ -0,0 +1,87 @@
+import { clsx } from 'clsx';
+import { twMerge } from 'tailwind-merge';
+import slug from 'slug';
+
+function slugify(text, locale = "en") {
+  return slug(text, { lower: true, locale });
+}
+function cn(...inputs) {
+  return twMerge(clsx(inputs));
+}
+function throttle(callback, waitMs) {
+  let timerId = null;
+  let lastInvokeTime = 0;
+  let trailingArgs = null;
+  const invoke = (args) => {
+    lastInvokeTime = Date.now();
+    callback(...args);
+  };
+  const throttled = (...args) => {
+    const now = Date.now();
+    const remaining = waitMs - (now - lastInvokeTime);
+    if (lastInvokeTime === 0) {
+      invoke(args);
+      return;
+    }
+    if (remaining <= 0 || remaining > waitMs) {
+      if (timerId) {
+        clearTimeout(timerId);
+        timerId = null;
+      }
+      invoke(args);
+    } else {
+      trailingArgs = args;
+      if (!timerId) {
+        timerId = setTimeout(() => {
+          timerId = null;
+          if (trailingArgs) {
+            invoke(trailingArgs);
+            trailingArgs = null;
+          }
+        }, remaining);
+      }
+    }
+  };
+  throttled.cancel = () => {
+    if (timerId) {
+      clearTimeout(timerId);
+      timerId = null;
+    }
+    trailingArgs = null;
+    lastInvokeTime = 0;
+  };
+  throttled.flush = () => {
+    if (timerId && trailingArgs) {
+      clearTimeout(timerId);
+      timerId = null;
+      invoke(trailingArgs);
+      trailingArgs = null;
+    }
+  };
+  return throttled;
+}
+function stripHtml(html) {
+  let text = html.replace(/<[^>]*>/g, "");
+  text = text.replace(/&amp;/g, "&").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"').replace(/&#x27;/g, "'").replace(/&#x2F;/g, "/").replace(/&nbsp;/g, " ").replace(/&hellip;/g, "...");
+  return text.replace(/\s+/g, " ").trim();
+}
+function stripMarkdown(markdown) {
+  let text = markdown;
+  text = text.replace(/^#{1,6}\s+/gm, "");
+  text = text.replace(/\*\*([^*]+)\*\*/g, "$1");
+  text = text.replace(/\*([^*]+)\*/g, "$1");
+  text = text.replace(/__([^_]+)__/g, "$1");
+  text = text.replace(/_([^_]+)_/g, "$1");
+  text = text.replace(/~~([^~]+)~~/g, "$1");
+  text = text.replace(/`([^`]+)`/g, "$1");
+  text = text.replace(/```[\s\S]*?```/g, "");
+  text = text.replace(/\[([^\]]+)\]\([^)]+\)/g, "$1");
+  text = text.replace(/!\[([^\]]*)\]\([^)]+\)/g, "$1");
+  text = text.replace(/^>\s+/gm, "");
+  text = text.replace(/^[-*]{3,}$/gm, "");
+  text = text.replace(/^[\s]*[-*+]\s+/gm, "");
+  text = text.replace(/^[\s]*\d+\.\s+/gm, "");
+  return text.replace(/\n\s*\n/g, "\n").replace(/\s+/g, " ").trim();
+}
+
+export { cn, slugify, stripHtml, stripMarkdown, throttle };

package/dist/plugins/client/index.cjs

@@ -0,0 +1,15 @@
+'use strict';
+
+const utils = require('../utils.cjs');
+const yar = require('@btst/yar');
+const client = require('better-call/client');
+
+function defineClientPlugin(plugin) {
+  return plugin;
+}
+
+exports.createApiClient = utils.createApiClient;
+exports.createRoute = yar.createRoute;
+exports.createRouter = yar.createRouter;
+exports.createClient = client.createClient;
+exports.defineClientPlugin = defineClientPlugin;

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

@@ -0,0 +1,57 @@
+import { C as ClientPlugin } from '../../shared/stack.ByOugz9d.cjs';
+export { P as PluginOverrides } from '../../shared/stack.ByOugz9d.cjs';
+import { createClient } from 'better-call/client';
+export { createClient } from 'better-call/client';
+import { Router, Endpoint } from 'better-call';
+export { Route, createRoute, createRouter } from '@btst/yar';
+import '@btst/db';
+
+interface CreateApiClientOptions {
+    baseURL?: string;
+    basePath?: string;
+}
+/**
+ * Creates a Better Call API client with proper URL handling for both server and client side
+ * @param options - Configuration options
+ * @param options.baseURL - The base URL (e.g., 'http://localhost:3000'). If not provided, uses relative URLs (same domain)
+ * @param options.basePath - The API base path (defaults to '/')
+ * @template TRouter - The router type (Router or Record<string, Endpoint>)
+ */
+declare function createApiClient<TRouter extends Router | Record<string, Endpoint> = Record<string, Endpoint>>(options?: CreateApiClientOptions): ReturnType<typeof createClient<TRouter>>;
+
+/**
+ * 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 client plugin with full type inference
+ *
+ * Automatically infers route keys, hook names, and their types without needing casts.
+ *
+ * @example
+ * ```ts
+ * const messagesPlugin = defineClientPlugin({
+ *   name: "messages",
+ *   routes: () => ({
+ *     messagesList: createRoute("/messages", () => ({ ... }))
+ *   }),
+ *   hooks: () => ({
+ *     useMessages: () => { ... }
+ *   })
+ * });
+ * // No casts needed - route keys, hook names, and types are all preserved!
+ * ```
+ *
+ * @template TPlugin - The exact plugin definition (auto-inferred)
+ */
+declare function defineClientPlugin<TPlugin extends ClientPlugin<any, any>>(plugin: TPlugin): TPlugin;
+
+export { ClientPlugin, createApiClient, defineClientPlugin };

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

@@ -0,0 +1,57 @@
+import { C as ClientPlugin } from '../../shared/stack.ByOugz9d.mjs';
+export { P as PluginOverrides } from '../../shared/stack.ByOugz9d.mjs';
+import { createClient } from 'better-call/client';
+export { createClient } from 'better-call/client';
+import { Router, Endpoint } from 'better-call';
+export { Route, createRoute, createRouter } from '@btst/yar';
+import '@btst/db';
+
+interface CreateApiClientOptions {
+    baseURL?: string;
+    basePath?: string;
+}
+/**
+ * Creates a Better Call API client with proper URL handling for both server and client side
+ * @param options - Configuration options
+ * @param options.baseURL - The base URL (e.g., 'http://localhost:3000'). If not provided, uses relative URLs (same domain)
+ * @param options.basePath - The API base path (defaults to '/')
+ * @template TRouter - The router type (Router or Record<string, Endpoint>)
+ */
+declare function createApiClient<TRouter extends Router | Record<string, Endpoint> = Record<string, Endpoint>>(options?: CreateApiClientOptions): ReturnType<typeof createClient<TRouter>>;
+
+/**
+ * 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 client plugin with full type inference
+ *
+ * Automatically infers route keys, hook names, and their types without needing casts.
+ *
+ * @example
+ * ```ts
+ * const messagesPlugin = defineClientPlugin({
+ *   name: "messages",
+ *   routes: () => ({
+ *     messagesList: createRoute("/messages", () => ({ ... }))
+ *   }),
+ *   hooks: () => ({
+ *     useMessages: () => { ... }
+ *   })
+ * });
+ * // No casts needed - route keys, hook names, and types are all preserved!
+ * ```
+ *
+ * @template TPlugin - The exact plugin definition (auto-inferred)
+ */
+declare function defineClientPlugin<TPlugin extends ClientPlugin<any, any>>(plugin: TPlugin): TPlugin;
+
+export { ClientPlugin, createApiClient, defineClientPlugin };

package/dist/plugins/client/index.d.ts

@@ -0,0 +1,57 @@
+import { C as ClientPlugin } from '../../shared/stack.ByOugz9d.js';
+export { P as PluginOverrides } from '../../shared/stack.ByOugz9d.js';
+import { createClient } from 'better-call/client';
+export { createClient } from 'better-call/client';
+import { Router, Endpoint } from 'better-call';
+export { Route, createRoute, createRouter } from '@btst/yar';
+import '@btst/db';
+
+interface CreateApiClientOptions {
+    baseURL?: string;
+    basePath?: string;
+}
+/**
+ * Creates a Better Call API client with proper URL handling for both server and client side
+ * @param options - Configuration options
+ * @param options.baseURL - The base URL (e.g., 'http://localhost:3000'). If not provided, uses relative URLs (same domain)
+ * @param options.basePath - The API base path (defaults to '/')
+ * @template TRouter - The router type (Router or Record<string, Endpoint>)
+ */
+declare function createApiClient<TRouter extends Router | Record<string, Endpoint> = Record<string, Endpoint>>(options?: CreateApiClientOptions): ReturnType<typeof createClient<TRouter>>;
+
+/**
+ * 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 client plugin with full type inference
+ *
+ * Automatically infers route keys, hook names, and their types without needing casts.
+ *
+ * @example
+ * ```ts
+ * const messagesPlugin = defineClientPlugin({
+ *   name: "messages",
+ *   routes: () => ({
+ *     messagesList: createRoute("/messages", () => ({ ... }))
+ *   }),
+ *   hooks: () => ({
+ *     useMessages: () => { ... }
+ *   })
+ * });
+ * // No casts needed - route keys, hook names, and types are all preserved!
+ * ```
+ *
+ * @template TPlugin - The exact plugin definition (auto-inferred)
+ */
+declare function defineClientPlugin<TPlugin extends ClientPlugin<any, any>>(plugin: TPlugin): TPlugin;
+
+export { ClientPlugin, createApiClient, defineClientPlugin };

package/dist/plugins/client/index.mjs

@@ -0,0 +1,9 @@
+export { createApiClient } from '../utils.mjs';
+export { createRoute, createRouter } from '@btst/yar';
+export { createClient } from 'better-call/client';
+
+function defineClientPlugin(plugin) {
+  return plugin;
+}
+
+export { defineClientPlugin };

package/dist/{shared/stack.Br2KMECJ.cjs → plugins/utils.cjs}

@@ -3,7 +3,7 @@
 const client = require('better-call/client');
 
 function createApiClient(options) {
-  const { baseURL = "", basePath = "/api" } = options ?? {};
+  const { baseURL = "", basePath = "/" } = options ?? {};
   const normalizedBaseURL = baseURL ? baseURL.replace(/\/$/, "") : "";
   const normalizedBasePath = basePath.startsWith("/") ? basePath : `/${basePath}`;
   const finalBasePath = normalizedBasePath.replace(/\/$/, "");
@@ -12,12 +12,5 @@ function createApiClient(options) {
     baseURL: apiPath
   });
 }
-function getServerBaseURL() {
-  if (typeof window === "undefined") {
-    return process.env.NEXT_PUBLIC_BASE_URL || "http://localhost:3000";
-  }
-  return void 0;
-}
 
 exports.createApiClient = createApiClient;
-exports.getServerBaseURL = getServerBaseURL;

package/dist/{shared/stack.CwGEQ10b.mjs → plugins/utils.mjs}

@@ -1,7 +1,7 @@
 import { createClient } from 'better-call/client';
 
 function createApiClient(options) {
-  const { baseURL = "", basePath = "/api" } = options ?? {};
+  const { baseURL = "", basePath = "/" } = options ?? {};
   const normalizedBaseURL = baseURL ? baseURL.replace(/\/$/, "") : "";
   const normalizedBasePath = basePath.startsWith("/") ? basePath : `/${basePath}`;
   const finalBasePath = normalizedBasePath.replace(/\/$/, "");
@@ -10,11 +10,5 @@ function createApiClient(options) {
     baseURL: apiPath
   });
 }
-function getServerBaseURL() {
-  if (typeof window === "undefined") {
-    return process.env.NEXT_PUBLIC_BASE_URL || "http://localhost:3000";
-  }
-  return void 0;
-}
 
-export { createApiClient as c, getServerBaseURL as g };
+export { createApiClient };

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

@@ -24,11 +24,6 @@ interface BackendPlugin<TRoutes extends Record<string, Endpoint> = Record<string
     routes: (adapter: Adapter) => TRoutes;
     dbPlugin: DbPlugin;
 }
-/**
- * Hook function type
- * Generic function type for React hooks returned by plugins
- */
-type HookFunction = (...args: unknown[]) => unknown;
 /**
  * Frontend plugin definition
  * Defines pages, components, loaders, and React Query hooks for a feature
@@ -45,20 +40,16 @@ interface ClientPlugin<TOverrides = Record<string, never>, TRoutes extends Recor
      */
     routes: () => TRoutes;
     /**
-     * Optional: Create React Query hooks for this plugin
-     * These can be used directly in components without the loader
+     * Optional sitemap generator for this plugin. Should return absolute URLs.
+     * Implementations can call their own API endpoints to include dynamic routes.
      */
-    hooks?: () => Record<string, HookFunction>;
-    /**
-     * Optional: Default implementations for overridable components/functions
-     * These will be used if no override is provided in BetterStackContext
-     */
-    defaultOverrides?: Partial<TOverrides>;
+    sitemap?: () => Promise<Sitemap> | Sitemap;
 }
 /**
  * Configuration for creating the backend library
  */
 interface BackendLibConfig<TPlugins extends Record<string, BackendPlugin<any>> = Record<string, BackendPlugin<any>>> {
+    basePath: string;
     dbSchema?: DatabaseDefinition;
     plugins: TPlugins;
     adapter: (db: DatabaseDefinition) => Adapter;
@@ -89,13 +80,6 @@ type PluginOverrides<TPlugins extends Record<string, ClientPlugin<any, any>>> =
  * Extract all routes from all client plugins, merging them into a single record
  */
 type PluginRoutes<TPlugins extends Record<string, ClientPlugin<any, any>>> = MergeAllPluginRoutes<TPlugins>;
-/**
- * Extract all hooks from all client plugins, organized by plugin name
- * For plugins without hooks, the type will be an empty object
- */
-type PluginHooks<TPlugins extends Record<string, ClientPlugin<any, any>>> = {
-    [K in keyof TPlugins]: TPlugins[K]["hooks"] extends () => infer H ? H : {};
-};
 /**
  * Prefix all backend plugin route keys with the plugin name
  * Example: { messages: { list: Endpoint } } => { messages_list: Endpoint }
@@ -130,9 +114,19 @@ type UnionToIntersection<U> = (U extends unknown ? (k: U) => void : never) exten
 /**
  * Result of creating the client library
  */
-interface ClientLib<TRoutes extends Record<string, Route> = Record<string, Route>, THooks extends Record<string, any> = Record<string, any>> {
+interface ClientLib<TRoutes extends Record<string, Route> = Record<string, Route>> {
     router: ReturnType<typeof createRouter<TRoutes, {}>>;
-    hooks: THooks;
+    generateSitemap: () => Promise<Sitemap>;
 }
+/**
+ * Minimal sitemap entry shape aligned with Next.js MetadataRoute.Sitemap
+ */
+type SitemapEntry = {
+    url: string;
+    lastModified?: string | Date;
+    changeFrequency?: "always" | "hourly" | "daily" | "weekly" | "monthly" | "yearly" | "never";
+    priority?: number;
+};
+type Sitemap = Array<SitemapEntry>;
 
-export type { BackendPlugin as B, ClientPlugin as C, InferPluginOverrides as I, PluginRoutes as P, PluginHooks as a, ClientLibConfig as b, ClientLib as c, PluginOverrides as d, PrefixedPluginRoutes as e, BackendLibConfig as f, BackendLib as g };
+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 };

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

@@ -24,11 +24,6 @@ interface BackendPlugin<TRoutes extends Record<string, Endpoint> = Record<string
     routes: (adapter: Adapter) => TRoutes;
     dbPlugin: DbPlugin;
 }
-/**
- * Hook function type
- * Generic function type for React hooks returned by plugins
- */
-type HookFunction = (...args: unknown[]) => unknown;
 /**
  * Frontend plugin definition
  * Defines pages, components, loaders, and React Query hooks for a feature
@@ -45,20 +40,16 @@ interface ClientPlugin<TOverrides = Record<string, never>, TRoutes extends Recor
      */
     routes: () => TRoutes;
     /**
-     * Optional: Create React Query hooks for this plugin
-     * These can be used directly in components without the loader
+     * Optional sitemap generator for this plugin. Should return absolute URLs.
+     * Implementations can call their own API endpoints to include dynamic routes.
      */
-    hooks?: () => Record<string, HookFunction>;
-    /**
-     * Optional: Default implementations for overridable components/functions
-     * These will be used if no override is provided in BetterStackContext
-     */
-    defaultOverrides?: Partial<TOverrides>;
+    sitemap?: () => Promise<Sitemap> | Sitemap;
 }
 /**
  * Configuration for creating the backend library
  */
 interface BackendLibConfig<TPlugins extends Record<string, BackendPlugin<any>> = Record<string, BackendPlugin<any>>> {
+    basePath: string;
     dbSchema?: DatabaseDefinition;
     plugins: TPlugins;
     adapter: (db: DatabaseDefinition) => Adapter;
@@ -89,13 +80,6 @@ type PluginOverrides<TPlugins extends Record<string, ClientPlugin<any, any>>> =
  * Extract all routes from all client plugins, merging them into a single record
  */
 type PluginRoutes<TPlugins extends Record<string, ClientPlugin<any, any>>> = MergeAllPluginRoutes<TPlugins>;
-/**
- * Extract all hooks from all client plugins, organized by plugin name
- * For plugins without hooks, the type will be an empty object
- */
-type PluginHooks<TPlugins extends Record<string, ClientPlugin<any, any>>> = {
-    [K in keyof TPlugins]: TPlugins[K]["hooks"] extends () => infer H ? H : {};
-};
 /**
  * Prefix all backend plugin route keys with the plugin name
  * Example: { messages: { list: Endpoint } } => { messages_list: Endpoint }
@@ -130,9 +114,19 @@ type UnionToIntersection<U> = (U extends unknown ? (k: U) => void : never) exten
 /**
  * Result of creating the client library
  */
-interface ClientLib<TRoutes extends Record<string, Route> = Record<string, Route>, THooks extends Record<string, any> = Record<string, any>> {
+interface ClientLib<TRoutes extends Record<string, Route> = Record<string, Route>> {
     router: ReturnType<typeof createRouter<TRoutes, {}>>;
-    hooks: THooks;
+    generateSitemap: () => Promise<Sitemap>;
 }
+/**
+ * Minimal sitemap entry shape aligned with Next.js MetadataRoute.Sitemap
+ */
+type SitemapEntry = {
+    url: string;
+    lastModified?: string | Date;
+    changeFrequency?: "always" | "hourly" | "daily" | "weekly" | "monthly" | "yearly" | "never";
+    priority?: number;
+};
+type Sitemap = Array<SitemapEntry>;
 
-export type { BackendPlugin as B, ClientPlugin as C, InferPluginOverrides as I, PluginRoutes as P, PluginHooks as a, ClientLibConfig as b, ClientLib as c, PluginOverrides as d, PrefixedPluginRoutes as e, BackendLibConfig as f, BackendLib as g };
+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 };