ellmo-ai-react 0.0.17 → 0.0.22

package/dist/EllmoApiStatic.d.ts

@@ -5,6 +5,14 @@ type AppContext = {
     ctx: any;
     router: any;
 };
+type GetStaticPropsContext = {
+    params?: Record<string, string | string[]>;
+    preview?: boolean;
+    previewData?: any;
+    locale?: string;
+    locales?: string[];
+    defaultLocale?: string;
+};
 /**
  * Helper for _app.tsx to fetch global Ellmo data and merge with page props
  * Automatically calls the page's getInitialProps and merges everything
@@ -56,4 +64,85 @@ export declare function withEllmoApp({ clientId, url, type, debugging }: {
         pageEllmoData: string | null;
     };
 }>;
+/**
+ * Higher-order function to wrap getStaticProps with Ellmo data fetching
+ * Automatically calls the page's existing getStaticProps and merges Ellmo data
+ *
+ * @param clientId - Your Ellmo client ID
+ * @param url - Function that returns the URL path from GetStaticPropsContext
+ * @param type - Content type: 'semantic' or 'structured' (default: 'semantic')
+ * @param debugging - Include ellmoError in props for debugging (default: false)
+ *
+ * Returns ellmoData and ellmoError in props at both root level and inside pageProps for flexibility.
+ *
+ * @example
+ * ```tsx
+ * import { withEllmoStatic } from 'ellmo-ai-react';
+ *
+ * export const getStaticProps = withEllmoStatic({
+ *   clientId: process.env.ELLMO_CLIENT_ID!,
+ *   url: (context) => context.params?.slug ? `/blog/${context.params.slug}` : '/',
+ *   type: 'semantic',
+ *   debugging: process.env.NODE_ENV === 'development'
+ * });
+ *
+ * // In page component - access directly
+ * export default function BlogPost({ ellmoData, ellmoError }) {
+ *   return (
+ *     <div>
+ *       <EllmoApiSSR data={ellmoData} error={ellmoError} />
+ *       <h1>Blog Post</h1>
+ *     </div>
+ *   );
+ * }
+ *
+ * // In _app.tsx - access via pageProps
+ * function MyApp({ Component, pageProps }) {
+ *   return (
+ *     <div>
+ *       <EllmoApiSSR data={pageProps.pageEllmoData} error={pageProps.pageEllmoError} />
+ *       <Component {...pageProps} />
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function withEllmoStatic<P extends Record<string, any> = Record<string, any>>({ clientId, url, type, debugging }: {
+    clientId: string;
+    url: (context: GetStaticPropsContext) => string;
+    type?: EllmoApiType;
+    debugging?: boolean;
+}): (context: GetStaticPropsContext) => Promise<{
+    props: P & {
+        ellmoData: string | null;
+        ellmoError?: string | null;
+        pageProps?: {
+            pageEllmoData: string | null;
+            pageEllmoError?: string | null;
+        };
+    };
+}>;
+/**
+ * Build standardized Ellmo props synchronously from provided data and error.
+ * Returns ellmoData/ellmoError at root and pageEllmoData/pageEllmoError inside pageProps.
+ */
+/**
+ * Fetch Ellmo data and return standardized props (no Next.js dependency).
+ * Accepts a plain URL string and returns the same shape as buildEllmoProps.
+ */
+export declare function getEllmoStaticProps({ clientId, url, type, debugging }: {
+    clientId: string;
+    url: string;
+    type?: EllmoApiType;
+    debugging?: boolean;
+}): Promise<{
+    props: {
+        ellmoData: string | null;
+        ellmoError?: string | null;
+        pageProps: {
+            pageEllmoData: string | null;
+            pageEllmoError?: string | null;
+        };
+    };
+}>;
 //# sourceMappingURL=EllmoApiStatic.d.ts.map

package/dist/EllmoApiStatic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EllmoApiStatic.d.ts","sourceRoot":"","sources":["../src/EllmoApiStatic.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7D,YAAY,EAAE,YAAY,EAAE,CAAC;AAG7B,KAAK,UAAU,GAAG;IAChB,SAAS,EAAE,GAAG,CAAC;IACf,GAAG,EAAE,GAAG,CAAC;IACT,MAAM,EAAE,GAAG,CAAC;CACb,CAAC;AAGF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,YAAY,CAAC,EAC3B,QAAQ,EACR,GAAG,EACH,IAAiB,EACjB,SAAiB,EAClB,EAAE;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,MAAM,CAAC;IACxC,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,IACe,YAAY,UAAU;;;;;GAuBrC"}
+{"version":3,"file":"EllmoApiStatic.d.ts","sourceRoot":"","sources":["../src/EllmoApiStatic.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,UAAU,CAAC;AAE7D,YAAY,EAAE,YAAY,EAAE,CAAC;AAG7B,KAAK,UAAU,GAAG;IAChB,SAAS,EAAE,GAAG,CAAC;IACf,GAAG,EAAE,GAAG,CAAC;IACT,MAAM,EAAE,GAAG,CAAC;CACb,CAAC;AAGF,KAAK,qBAAqB,GAAG;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,GAAG,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAGF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,YAAY,CAAC,EAC3B,QAAQ,EACR,GAAG,EACH,IAAiB,EACjB,SAAiB,EAClB,EAAE;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,MAAM,CAAC;IACxC,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,IACe,YAAY,UAAU;;;;;GAuBrC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,EACnF,QAAQ,EACR,GAAG,EACH,IAAiB,EACjB,SAAiB,EAClB,EAAE;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,CAAC,OAAO,EAAE,qBAAqB,KAAK,MAAM,CAAC;IAChD,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,IACe,SAAS,qBAAqB;WAMnB,CAAC,GAAG;QAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,SAAS,CAAC,EAAE;YAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;YAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;SAAE,CAAA;KAAE;GAEpK;AAED;;;GAGG;AAGH;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,EACxC,QAAQ,EACR,GAAG,EACH,IAAiB,EACjB,SAAiB,EAClB,EAAE;IACD,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,GAAG,OAAO,CAAC;IAAE,KAAK,EAAE;QAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,SAAS,EAAE;YAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;YAAC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;SAAE,CAAA;KAAE,CAAA;CAAE,CAAC,CAe5J"}

package/dist/index.d.ts

@@ -161,6 +161,14 @@ type AppContext = {
     ctx: any;
     router: any;
 };
+type GetStaticPropsContext = {
+    params?: Record<string, string | string[]>;
+    preview?: boolean;
+    previewData?: any;
+    locale?: string;
+    locales?: string[];
+    defaultLocale?: string;
+};
 /**
  * Helper for _app.tsx to fetch global Ellmo data and merge with page props
  * Automatically calls the page's getInitialProps and merges everything
@@ -212,6 +220,87 @@ declare function withEllmoApp({ clientId, url, type, debugging }: {
         pageEllmoData: string | null;
     };
 }>;
+/**
+ * Higher-order function to wrap getStaticProps with Ellmo data fetching
+ * Automatically calls the page's existing getStaticProps and merges Ellmo data
+ *
+ * @param clientId - Your Ellmo client ID
+ * @param url - Function that returns the URL path from GetStaticPropsContext
+ * @param type - Content type: 'semantic' or 'structured' (default: 'semantic')
+ * @param debugging - Include ellmoError in props for debugging (default: false)
+ *
+ * Returns ellmoData and ellmoError in props at both root level and inside pageProps for flexibility.
+ *
+ * @example
+ * ```tsx
+ * import { withEllmoStatic } from 'ellmo-ai-react';
+ *
+ * export const getStaticProps = withEllmoStatic({
+ *   clientId: process.env.ELLMO_CLIENT_ID!,
+ *   url: (context) => context.params?.slug ? `/blog/${context.params.slug}` : '/',
+ *   type: 'semantic',
+ *   debugging: process.env.NODE_ENV === 'development'
+ * });
+ *
+ * // In page component - access directly
+ * export default function BlogPost({ ellmoData, ellmoError }) {
+ *   return (
+ *     <div>
+ *       <EllmoApiSSR data={ellmoData} error={ellmoError} />
+ *       <h1>Blog Post</h1>
+ *     </div>
+ *   );
+ * }
+ *
+ * // In _app.tsx - access via pageProps
+ * function MyApp({ Component, pageProps }) {
+ *   return (
+ *     <div>
+ *       <EllmoApiSSR data={pageProps.pageEllmoData} error={pageProps.pageEllmoError} />
+ *       <Component {...pageProps} />
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+declare function withEllmoStatic<P extends Record<string, any> = Record<string, any>>({ clientId, url, type, debugging }: {
+    clientId: string;
+    url: (context: GetStaticPropsContext) => string;
+    type?: EllmoApiType;
+    debugging?: boolean;
+}): (context: GetStaticPropsContext) => Promise<{
+    props: P & {
+        ellmoData: string | null;
+        ellmoError?: string | null;
+        pageProps?: {
+            pageEllmoData: string | null;
+            pageEllmoError?: string | null;
+        };
+    };
+}>;
+/**
+ * Build standardized Ellmo props synchronously from provided data and error.
+ * Returns ellmoData/ellmoError at root and pageEllmoData/pageEllmoError inside pageProps.
+ */
+/**
+ * Fetch Ellmo data and return standardized props (no Next.js dependency).
+ * Accepts a plain URL string and returns the same shape as buildEllmoProps.
+ */
+declare function getEllmoStaticProps({ clientId, url, type, debugging }: {
+    clientId: string;
+    url: string;
+    type?: EllmoApiType;
+    debugging?: boolean;
+}): Promise<{
+    props: {
+        ellmoData: string | null;
+        ellmoError?: string | null;
+        pageProps: {
+            pageEllmoData: string | null;
+            pageEllmoError?: string | null;
+        };
+    };
+}>;
 
 /**
  * Custom header name for Ellmo AI to pass pathname information
@@ -294,4 +383,4 @@ declare function getPathnameFromHeaders(headers: {
     get(name: string): string | null;
 }): string | null;
 
-export { ELLMO_PATHNAME_HEADER, EllmoApi, EllmoApiProps, EllmoApiSSR, EllmoApiSSRProps, EllmoApiType, EllmoRequest, EllmoResponse, ellmoMiddleware, fetchEllmoData, getPathnameFromHeaders, ellmoMiddleware as middleware, withEllmoApp };
+export { ELLMO_PATHNAME_HEADER, EllmoApi, EllmoApiProps, EllmoApiSSR, EllmoApiSSRProps, EllmoApiType, EllmoRequest, EllmoResponse, ellmoMiddleware, fetchEllmoData, getEllmoStaticProps, getPathnameFromHeaders, ellmoMiddleware as middleware, withEllmoApp, withEllmoStatic };

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,YAAY,CAAC;AACjD,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhD,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,eAAe,CAAC;AACvD,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGtD,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAG7C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAGhD,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,YAAY,CAAC;AACjD,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhD,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,eAAe,CAAC;AACvD,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGtD,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAG7C,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAGtF,OAAO,EACL,eAAe,EACf,sBAAsB,EACtB,qBAAqB,EACtB,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -262,6 +262,82 @@ function withEllmoApp({ clientId, url, type = 'semantic', debugging = false }) {
         };
     };
 }
+/**
+ * Higher-order function to wrap getStaticProps with Ellmo data fetching
+ * Automatically calls the page's existing getStaticProps and merges Ellmo data
+ *
+ * @param clientId - Your Ellmo client ID
+ * @param url - Function that returns the URL path from GetStaticPropsContext
+ * @param type - Content type: 'semantic' or 'structured' (default: 'semantic')
+ * @param debugging - Include ellmoError in props for debugging (default: false)
+ *
+ * Returns ellmoData and ellmoError in props at both root level and inside pageProps for flexibility.
+ *
+ * @example
+ * ```tsx
+ * import { withEllmoStatic } from 'ellmo-ai-react';
+ *
+ * export const getStaticProps = withEllmoStatic({
+ *   clientId: process.env.ELLMO_CLIENT_ID!,
+ *   url: (context) => context.params?.slug ? `/blog/${context.params.slug}` : '/',
+ *   type: 'semantic',
+ *   debugging: process.env.NODE_ENV === 'development'
+ * });
+ *
+ * // In page component - access directly
+ * export default function BlogPost({ ellmoData, ellmoError }) {
+ *   return (
+ *     <div>
+ *       <EllmoApiSSR data={ellmoData} error={ellmoError} />
+ *       <h1>Blog Post</h1>
+ *     </div>
+ *   );
+ * }
+ *
+ * // In _app.tsx - access via pageProps
+ * function MyApp({ Component, pageProps }) {
+ *   return (
+ *     <div>
+ *       <EllmoApiSSR data={pageProps.pageEllmoData} error={pageProps.pageEllmoError} />
+ *       <Component {...pageProps} />
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+function withEllmoStatic({ clientId, url, type = 'semantic', debugging = false }) {
+    return async (context) => {
+        return getEllmoStaticProps({
+            clientId,
+            url: url(context),
+            type,
+            debugging
+        });
+    };
+}
+/**
+ * Build standardized Ellmo props synchronously from provided data and error.
+ * Returns ellmoData/ellmoError at root and pageEllmoData/pageEllmoError inside pageProps.
+ */
+// (removed buildEllmoProps to reduce surface area)
+/**
+ * Fetch Ellmo data and return standardized props (no Next.js dependency).
+ * Accepts a plain URL string and returns the same shape as buildEllmoProps.
+ */
+async function getEllmoStaticProps({ clientId, url, type = 'semantic', debugging = false }) {
+    const { data, error } = await fetchEllmoData({ clientId, url, type });
+    const props = {
+        ellmoData: data,
+        pageProps: {
+            pageEllmoData: data
+        }
+    };
+    if (debugging) {
+        props.ellmoError = error;
+        props.pageProps.pageEllmoError = error;
+    }
+    return { props };
+}
 
 /**
  * Custom header name for Ellmo AI to pass pathname information
@@ -342,7 +418,9 @@ exports.EllmoApi = EllmoApi;
 exports.EllmoApiSSR = EllmoApiSSR;
 exports.ellmoMiddleware = ellmoMiddleware;
 exports.fetchEllmoData = fetchEllmoData;
+exports.getEllmoStaticProps = getEllmoStaticProps;
 exports.getPathnameFromHeaders = getPathnameFromHeaders;
 exports.middleware = ellmoMiddleware;
 exports.withEllmoApp = withEllmoApp;
+exports.withEllmoStatic = withEllmoStatic;
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../src/EllmoApi.tsx","../src/EllmoApiSSR.tsx","../src/shared.ts","../src/EllmoApiStatic.tsx","../src/middleware.ts"],"sourcesContent":["import React from 'react';\nimport type { EllmoApiType } from './shared';\n\nexport type { EllmoApiType };\n\nexport interface EllmoApiProps {\n  /**\n   * The URL path to fetch data for (required).\n   * \n   * With middleware (recommended):\n   * ```tsx\n   * import { headers } from 'next/headers';\n   * import { getPathnameFromHeaders } from 'ellmo-ai-react/middleware';\n   * \n   * const pathname = getPathnameFromHeaders(headers());\n   * <EllmoApi clientId=\"...\" url={pathname || '/'} />\n   * ```\n   * \n   * Without middleware:\n   * ```tsx\n   * <EllmoApi clientId=\"...\" url=\"/about\" />\n   * ```\n   */\n  url: string;\n  /**\n   * The API key/client identifier (required)\n   */\n  clientId: string;\n  /**\n   * Type of data to fetch\n   */\n  type?: EllmoApiType;\n  /**\n   * Custom className for styling\n   */\n  className?: string;\n  /**\n   * Whether to show errors\n   */\n  showErrors?: boolean;\n  /**\n   * Children to render when data is available\n   */\n  children?: (data: any, error: Error | null) => React.ReactNode;\n}\n\n/**\n * Server-only Ellmo API component (React Server Component)\n * This component fetches data during server rendering.\n * It requires Next.js 13+ App Router or other RSC-compatible frameworks.\n * \n * @example\n * ```tsx\n * // In a server component (app/page.tsx)\n * export default async function Page() {\n *   return <EllmoApi clientId=\"your-id\" url=\"/about\" />;\n * }\n * ```\n */\nconst EllmoApi = async ({\n  url,\n  clientId,\n  type,\n  className = '',\n  showErrors = false,\n  children\n}: EllmoApiProps): Promise<React.ReactElement | null> => {\n  let data: any = null;\n  let error: Error | null = null;\n\n  let translatedType = type === 'structured' ? 'structured' : 'semantic';\n\n  try {\n    // Validate required props\n    if (!clientId) {\n      throw new Error('clientId is required. Please provide your Ellmo API client identifier.');\n    }\n\n    if (!url) {\n      throw new Error('url prop is required. Please provide the page pathname.');\n    }\n\n    // Encode the URL path for the API call\n    const encodedUrl = encodeURIComponent(url);\n\n    // Build the API URL\n    const apiUrl = `https://www.tryellmo.ai/public-api/wordpress?c=${clientId}&t=${translatedType}&u=${encodedUrl}`;\n\n    // Fetch data during server render\n    const response = await fetch(apiUrl, {\n      cache: 'no-store', // Always fetch fresh data\n    });\n\n    if (!response.ok) {\n      throw new Error(`API request failed with status ${response.status}`);\n    }\n\n    if (type === 'structured') {\n      data = await response.text();\n    } else if (type === 'semantic') {\n      data = await response.text();\n    } else {\n      throw new Error(`Invalid type: ${type}`);\n    }\n  } catch (err) {\n    error = err instanceof Error ? err : new Error('Unknown error occurred');\n  }\n\n  // If children prop is provided, use render prop pattern\n  if (children) {\n    return <>{children(data, error)}</>;\n  }\n\n  // Show errors if enabled\n  if (error && showErrors) {\n    return (\n      <div className={`ellmo-api-error ${className}`}>\n        <div>Error: {error.message}</div>\n      </div>\n    );\n  }\n\n  // Show data if showErrors is enabled (for debugging)\n  if (data && showErrors) {\n    return (\n      <div className={`ellmo-api-data ${className}`}>\n        <pre>{JSON.stringify(data, null, 2)}</pre>\n      </div>\n    );\n  }\n\n  // Invisible component by default - just fetches data during server render\n  if (type === 'structured' && data) {\n    return <div dangerouslySetInnerHTML={{ __html: data }} />;\n  } else if (type === 'semantic' && data) {\n    return <div dangerouslySetInnerHTML={{ __html: data }} />;\n  }\n  return null;\n};\n\nexport default EllmoApi;\n","import React from 'react';\nimport type { EllmoApiType } from './shared';\n\nexport type { EllmoApiType };\n\nexport interface EllmoApiSSRProps {\n  /**\n   * The pre-fetched data from the Ellmo API\n   */\n  data?: string | null;\n  /**\n   * Error from fetching data\n   */\n  error?: string | null;\n  /**\n   * Type of data to render\n   */\n  type?: EllmoApiType;\n  /**\n   * Custom className for styling\n   */\n  className?: string;\n  /**\n   * Whether to show errors\n   */\n  showErrors?: boolean;\n  /**\n   * Children render prop with data and error\n   */\n  children?: (data: string | null, error: string | null) => React.ReactNode;\n}\n\n/**\n * Ellmo API component for traditional SSR environments (Next.js Pages Router)\n * This component receives pre-fetched data and renders it.\n * Data fetching should be done in getServerSideProps or getStaticProps.\n * \n * @example\n * ```tsx\n * // In your page file (pages/about.tsx)\n * import { EllmoApiSSR, fetchEllmoData } from 'ellmo-ai-react';\n * \n * export async function getServerSideProps(context) {\n *   const { data, error } = await fetchEllmoData({\n *     clientId: 'your-client-id',\n *     url: context.resolvedUrl,\n *     type: 'semantic'\n *   });\n *   \n *   return {\n *     props: { ellmoData: data, ellmoError: error }\n *   };\n * }\n * \n * export default function AboutPage({ ellmoData, ellmoError }) {\n *   return (\n *     <div>\n *       <h1>About Page</h1>\n *       <EllmoApiSSR data={ellmoData} error={ellmoError} />\n *     </div>\n *   );\n * }\n * ```\n */\nconst EllmoApiSSR: React.FC<EllmoApiSSRProps> = ({\n  data = null,\n  error = null,\n  className = '',\n  showErrors = false,\n  children\n}) => {\n  // If children prop is provided, use render prop pattern\n  if (children) {\n    return <>{children(data, error)}</>;\n  }\n\n  // Show errors if enabled\n  if (error && showErrors) {\n    return (\n      <div className={`ellmo-api-error ${className}`}>\n        <div>Error: {error}</div>\n      </div>\n    );\n  }\n\n  // Show data if showErrors is enabled (for debugging)\n  if (data && showErrors) {\n    return (\n      <div className={`ellmo-api-data ${className}`}>\n        <pre>{data}</pre>\n      </div>\n    );\n  }\n\n  // Render HTML content if available\n  if (data && !error) {\n    return <div className={className} dangerouslySetInnerHTML={{ __html: data }} />;\n  }\n\n  // Return null if no data\n  return null;\n};\n\nexport default EllmoApiSSR;\n \n","export type EllmoApiType = 'semantic' | 'structured';\n\n/**\n * Fetch data from Ellmo API\n * Use this in getServerSideProps, getStaticProps, or getInitialProps\n * \n * @example\n * ```tsx\n * // In getServerSideProps (Next.js Pages Router)\n * export async function getServerSideProps(context) {\n *   const { data, error } = await fetchEllmoData({\n *     clientId: process.env.ELLMO_CLIENT_ID!,\n *     url: context.resolvedUrl,\n *     type: 'semantic'\n *   });\n *   \n *   return {\n *     props: { ellmoData: data, ellmoError: error }\n *   };\n * }\n * \n * // In getInitialProps (older Next.js API)\n * MyPage.getInitialProps = async (ctx) => {\n *   const { data, error } = await fetchEllmoData({\n *     clientId: process.env.NEXT_PUBLIC_ELLMO_CLIENT_ID!,\n *     url: ctx.asPath || '/',\n *     type: 'semantic'\n *   });\n *   \n *   return { ellmoData: data, ellmoError: error };\n * };\n * ```\n */\nexport async function fetchEllmoData({\n  clientId,\n  url,\n  type = 'semantic'\n}: {\n  clientId: string;\n  url: string;\n  type?: EllmoApiType;\n}): Promise<{ data: string | null; error: string | null }> {\n  try {\n    // Validate required props\n    if (!clientId) {\n      throw new Error('clientId is required. Please provide your Ellmo API client identifier.');\n    }\n\n    if (!url) {\n      throw new Error('url is required. Please provide the page pathname.');\n    }\n\n    if (url.includes('.')) {\n      // Sometimes urls contain a dot if they're images or other assets which are served by SSG (static generation)\n      return { data: null, error: null };\n    }\n\n    // Encode the URL path for the API call\n    const encodedUrl = encodeURIComponent(url);\n    const translatedType = type === 'structured' ? 'structured' : 'semantic';\n\n    // Build the API URL\n    const apiUrl = `https://www.tryellmo.ai/public-api/wordpress?c=${clientId}&t=${translatedType}&u=${encodedUrl}`;\n\n    // Fetch data\n    const response = await fetch(apiUrl, {\n      cache: 'no-store',\n    });\n\n    if (!response.ok) {\n      throw new Error(`API request failed with status ${response.status}`);\n    }\n\n    const data = await response.text();\n    return { data, error: null };\n  } catch (err) {\n    const errorMessage = err instanceof Error ? err.message : 'Unknown error occurred';\n    return { data: null, error: errorMessage };\n  }\n}\n\n","import { fetchEllmoData, type EllmoApiType } from './shared';\n\nexport type { EllmoApiType };\n\n// Type for Next.js App context\ntype AppContext = {\n  Component: any;\n  ctx: any;\n  router: any;\n};\n\n\n/**\n * Helper for _app.tsx to fetch global Ellmo data and merge with page props\n * Automatically calls the page's getInitialProps and merges everything\n * \n * @param clientId - Your Ellmo client ID\n * @param url - Function that returns the URL path from app context\n * @param type - Content type: 'semantic' or 'structured' (default: 'semantic')\n * @param debugging - Include pageEllmoError in props for debugging (default: false)\n * \n * Returns pageEllmoData in pageProps. If debugging is enabled, also includes pageEllmoError.\n * \n * @example\n * ```tsx\n * import { withEllmoApp } from 'ellmo-ai-react';\n * \n * function MyApp({ Component, pageProps }) {\n *   return (\n *     <>\n *       <header>\n *         <EllmoApiSSR \n *           data={pageProps.pageEllmoData} \n *           error={pageProps.pageEllmoError} \n *           showErrors={true} // Show errors in development\n *         />\n *       </header>\n *       <Component {...pageProps} />\n *     </>\n *   );\n * }\n * \n * MyApp.getInitialProps = withEllmoApp({\n *   clientId: process.env.NEXT_PUBLIC_ELLMO_CLIENT_ID!,\n *   url: (appContext) => '/global-header',\n *   type: 'structured',\n *   debugging: process.env.NODE_ENV === 'development' // Enable error prop in development\n * });\n * \n * export default MyApp;\n * ```\n */\nexport function withEllmoApp({\n  clientId,\n  url,\n  type = 'semantic',\n  debugging = false\n}: {\n  clientId: string;\n  url: (appContext: AppContext) => string;\n  type?: EllmoApiType;\n  debugging?: boolean;\n}) {\n  return async (appContext: AppContext) => {\n    // Fetch global Ellmo data\n    const { data, error } = await fetchEllmoData({\n      clientId,\n      url: url(appContext), // Use the function to get the URL\n      type\n    });\n\n    // Call the page's getInitialProps if it exists\n    let pageProps = {};\n    if (appContext.Component.getInitialProps) {\n      pageProps = await appContext.Component.getInitialProps(appContext.ctx);\n    }\n\n    // Return merged props with ellmo data inside pageProps\n    return {\n      pageProps: {\n        ...pageProps,\n        pageEllmoData: data,\n        ...(debugging ? { pageEllmoError: error } : {}), // Only add error if debugging is enabled\n      }\n    };\n  };\n}\n","/**\n * Custom header name for Ellmo AI to pass pathname information\n * Using 'x-ellmo-pathname' to avoid conflicts with other libraries\n */\nexport const ELLMO_PATHNAME_HEADER = 'x-ellmo-pathname';\n\n/**\n * Type definitions for Next.js middleware (to avoid requiring Next.js as a dependency)\n */\nexport interface EllmoRequest {\n  nextUrl: {\n    pathname: string;\n  };\n}\n\nexport interface EllmoResponse {\n  headers: {\n    set(name: string, value: string): void;\n  };\n}\n\n/**\n * Ellmo AI middleware helper for Next.js\n * \n * This is a vanilla helper that adds pathname to request headers.\n * It doesn't depend on Next.js - you provide the request/response objects.\n * \n * Usage in Next.js:\n * \n * ```ts\n * // middleware.ts\n * import { ellmoMiddleware } from 'ellmo-ai-react/middleware';\n * import { NextResponse } from 'next/server';\n * import type { NextRequest } from 'next/server';\n * \n * export function middleware(request: NextRequest) {\n *   const response = NextResponse.next();\n *   return ellmoMiddleware(request, response);\n * }\n * \n * export const config = {\n *   matcher: [\n *     '/((?!_next/static|_next/image|favicon.ico).*)',\n *   ],\n * };\n * ```\n * \n * Composing with existing middleware:\n * \n * ```ts\n * export function middleware(request: NextRequest) {\n *   let response = NextResponse.next();\n *   \n *   // Your logic here\n *   if (someCondition) {\n *     response = NextResponse.redirect(new URL('/login', request.url));\n *   }\n *   \n *   // Apply Ellmo middleware\n *   return ellmoMiddleware(request, response);\n * }\n * ```\n */\nexport function ellmoMiddleware<\n  Req extends EllmoRequest,\n  Res extends EllmoResponse\n>(\n  request: Req,\n  response: Res\n): Res {\n  // Extract pathname from the request URL\n  const pathname = request.nextUrl.pathname;\n  \n  // Add the pathname to a custom header\n  response.headers.set(ELLMO_PATHNAME_HEADER, pathname);\n  \n  return response;\n}\n\n/**\n * Helper to extract pathname from headers object\n * \n * Usage in Next.js Server Components:\n * ```tsx\n * import { headers } from 'next/headers';\n * import { getPathnameFromHeaders } from 'ellmo-ai-react/middleware';\n * \n * export default function Page() {\n *   const headersList = headers();\n *   const pathname = getPathnameFromHeaders(headersList);\n *   \n *   return <EllmoApi clientId=\"your-id\" url={pathname} />;\n * }\n * ```\n */\nexport function getPathnameFromHeaders(headers: { get(name: string): string | null }): string | null {\n  return headers.get(ELLMO_PATHNAME_HEADER);\n}\n\nexport default ellmoMiddleware;\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../src/EllmoApi.tsx","../src/EllmoApiSSR.tsx","../src/shared.ts","../src/EllmoApiStatic.tsx","../src/middleware.ts"],"sourcesContent":["import React from 'react';\nimport type { EllmoApiType } from './shared';\n\nexport type { EllmoApiType };\n\nexport interface EllmoApiProps {\n  /**\n   * The URL path to fetch data for (required).\n   * \n   * With middleware (recommended):\n   * ```tsx\n   * import { headers } from 'next/headers';\n   * import { getPathnameFromHeaders } from 'ellmo-ai-react/middleware';\n   * \n   * const pathname = getPathnameFromHeaders(headers());\n   * <EllmoApi clientId=\"...\" url={pathname || '/'} />\n   * ```\n   * \n   * Without middleware:\n   * ```tsx\n   * <EllmoApi clientId=\"...\" url=\"/about\" />\n   * ```\n   */\n  url: string;\n  /**\n   * The API key/client identifier (required)\n   */\n  clientId: string;\n  /**\n   * Type of data to fetch\n   */\n  type?: EllmoApiType;\n  /**\n   * Custom className for styling\n   */\n  className?: string;\n  /**\n   * Whether to show errors\n   */\n  showErrors?: boolean;\n  /**\n   * Children to render when data is available\n   */\n  children?: (data: any, error: Error | null) => React.ReactNode;\n}\n\n/**\n * Server-only Ellmo API component (React Server Component)\n * This component fetches data during server rendering.\n * It requires Next.js 13+ App Router or other RSC-compatible frameworks.\n * \n * @example\n * ```tsx\n * // In a server component (app/page.tsx)\n * export default async function Page() {\n *   return <EllmoApi clientId=\"your-id\" url=\"/about\" />;\n * }\n * ```\n */\nconst EllmoApi = async ({\n  url,\n  clientId,\n  type,\n  className = '',\n  showErrors = false,\n  children\n}: EllmoApiProps): Promise<React.ReactElement | null> => {\n  let data: any = null;\n  let error: Error | null = null;\n\n  let translatedType = type === 'structured' ? 'structured' : 'semantic';\n\n  try {\n    // Validate required props\n    if (!clientId) {\n      throw new Error('clientId is required. Please provide your Ellmo API client identifier.');\n    }\n\n    if (!url) {\n      throw new Error('url prop is required. Please provide the page pathname.');\n    }\n\n    // Encode the URL path for the API call\n    const encodedUrl = encodeURIComponent(url);\n\n    // Build the API URL\n    const apiUrl = `https://www.tryellmo.ai/public-api/wordpress?c=${clientId}&t=${translatedType}&u=${encodedUrl}`;\n\n    // Fetch data during server render\n    const response = await fetch(apiUrl, {\n      cache: 'no-store', // Always fetch fresh data\n    });\n\n    if (!response.ok) {\n      throw new Error(`API request failed with status ${response.status}`);\n    }\n\n    if (type === 'structured') {\n      data = await response.text();\n    } else if (type === 'semantic') {\n      data = await response.text();\n    } else {\n      throw new Error(`Invalid type: ${type}`);\n    }\n  } catch (err) {\n    error = err instanceof Error ? err : new Error('Unknown error occurred');\n  }\n\n  // If children prop is provided, use render prop pattern\n  if (children) {\n    return <>{children(data, error)}</>;\n  }\n\n  // Show errors if enabled\n  if (error && showErrors) {\n    return (\n      <div className={`ellmo-api-error ${className}`}>\n        <div>Error: {error.message}</div>\n      </div>\n    );\n  }\n\n  // Show data if showErrors is enabled (for debugging)\n  if (data && showErrors) {\n    return (\n      <div className={`ellmo-api-data ${className}`}>\n        <pre>{JSON.stringify(data, null, 2)}</pre>\n      </div>\n    );\n  }\n\n  // Invisible component by default - just fetches data during server render\n  if (type === 'structured' && data) {\n    return <div dangerouslySetInnerHTML={{ __html: data }} />;\n  } else if (type === 'semantic' && data) {\n    return <div dangerouslySetInnerHTML={{ __html: data }} />;\n  }\n  return null;\n};\n\nexport default EllmoApi;\n","import React from 'react';\nimport type { EllmoApiType } from './shared';\n\nexport type { EllmoApiType };\n\nexport interface EllmoApiSSRProps {\n  /**\n   * The pre-fetched data from the Ellmo API\n   */\n  data?: string | null;\n  /**\n   * Error from fetching data\n   */\n  error?: string | null;\n  /**\n   * Type of data to render\n   */\n  type?: EllmoApiType;\n  /**\n   * Custom className for styling\n   */\n  className?: string;\n  /**\n   * Whether to show errors\n   */\n  showErrors?: boolean;\n  /**\n   * Children render prop with data and error\n   */\n  children?: (data: string | null, error: string | null) => React.ReactNode;\n}\n\n/**\n * Ellmo API component for traditional SSR environments (Next.js Pages Router)\n * This component receives pre-fetched data and renders it.\n * Data fetching should be done in getServerSideProps or getStaticProps.\n * \n * @example\n * ```tsx\n * // In your page file (pages/about.tsx)\n * import { EllmoApiSSR, fetchEllmoData } from 'ellmo-ai-react';\n * \n * export async function getServerSideProps(context) {\n *   const { data, error } = await fetchEllmoData({\n *     clientId: 'your-client-id',\n *     url: context.resolvedUrl,\n *     type: 'semantic'\n *   });\n *   \n *   return {\n *     props: { ellmoData: data, ellmoError: error }\n *   };\n * }\n * \n * export default function AboutPage({ ellmoData, ellmoError }) {\n *   return (\n *     <div>\n *       <h1>About Page</h1>\n *       <EllmoApiSSR data={ellmoData} error={ellmoError} />\n *     </div>\n *   );\n * }\n * ```\n */\nconst EllmoApiSSR: React.FC<EllmoApiSSRProps> = ({\n  data = null,\n  error = null,\n  className = '',\n  showErrors = false,\n  children\n}) => {\n  // If children prop is provided, use render prop pattern\n  if (children) {\n    return <>{children(data, error)}</>;\n  }\n\n  // Show errors if enabled\n  if (error && showErrors) {\n    return (\n      <div className={`ellmo-api-error ${className}`}>\n        <div>Error: {error}</div>\n      </div>\n    );\n  }\n\n  // Show data if showErrors is enabled (for debugging)\n  if (data && showErrors) {\n    return (\n      <div className={`ellmo-api-data ${className}`}>\n        <pre>{data}</pre>\n      </div>\n    );\n  }\n\n  // Render HTML content if available\n  if (data && !error) {\n    return <div className={className} dangerouslySetInnerHTML={{ __html: data }} />;\n  }\n\n  // Return null if no data\n  return null;\n};\n\nexport default EllmoApiSSR;\n \n","export type EllmoApiType = 'semantic' | 'structured';\n\n/**\n * Fetch data from Ellmo API\n * Use this in getServerSideProps, getStaticProps, or getInitialProps\n * \n * @example\n * ```tsx\n * // In getServerSideProps (Next.js Pages Router)\n * export async function getServerSideProps(context) {\n *   const { data, error } = await fetchEllmoData({\n *     clientId: process.env.ELLMO_CLIENT_ID!,\n *     url: context.resolvedUrl,\n *     type: 'semantic'\n *   });\n *   \n *   return {\n *     props: { ellmoData: data, ellmoError: error }\n *   };\n * }\n * \n * // In getInitialProps (older Next.js API)\n * MyPage.getInitialProps = async (ctx) => {\n *   const { data, error } = await fetchEllmoData({\n *     clientId: process.env.NEXT_PUBLIC_ELLMO_CLIENT_ID!,\n *     url: ctx.asPath || '/',\n *     type: 'semantic'\n *   });\n *   \n *   return { ellmoData: data, ellmoError: error };\n * };\n * ```\n */\nexport async function fetchEllmoData({\n  clientId,\n  url,\n  type = 'semantic'\n}: {\n  clientId: string;\n  url: string;\n  type?: EllmoApiType;\n}): Promise<{ data: string | null; error: string | null }> {\n  try {\n    // Validate required props\n    if (!clientId) {\n      throw new Error('clientId is required. Please provide your Ellmo API client identifier.');\n    }\n\n    if (!url) {\n      throw new Error('url is required. Please provide the page pathname.');\n    }\n\n    if (url.includes('.')) {\n      // Sometimes urls contain a dot if they're images or other assets which are served by SSG (static generation)\n      return { data: null, error: null };\n    }\n\n    // Encode the URL path for the API call\n    const encodedUrl = encodeURIComponent(url);\n    const translatedType = type === 'structured' ? 'structured' : 'semantic';\n\n    // Build the API URL\n    const apiUrl = `https://www.tryellmo.ai/public-api/wordpress?c=${clientId}&t=${translatedType}&u=${encodedUrl}`;\n\n    // Fetch data\n    const response = await fetch(apiUrl, {\n      cache: 'no-store',\n    });\n\n    if (!response.ok) {\n      throw new Error(`API request failed with status ${response.status}`);\n    }\n\n    const data = await response.text();\n    return { data, error: null };\n  } catch (err) {\n    const errorMessage = err instanceof Error ? err.message : 'Unknown error occurred';\n    return { data: null, error: errorMessage };\n  }\n}\n\n","import { fetchEllmoData, type EllmoApiType } from './shared';\n\nexport type { EllmoApiType };\n\n// Type for Next.js App context\ntype AppContext = {\n  Component: any;\n  ctx: any;\n  router: any;\n};\n\n// Type for Next.js GetStaticProps context (minimal definition to avoid next.js dependency)\ntype GetStaticPropsContext = {\n  params?: Record<string, string | string[]>;\n  preview?: boolean;\n  previewData?: any;\n  locale?: string;\n  locales?: string[];\n  defaultLocale?: string;\n};\n\n\n/**\n * Helper for _app.tsx to fetch global Ellmo data and merge with page props\n * Automatically calls the page's getInitialProps and merges everything\n * \n * @param clientId - Your Ellmo client ID\n * @param url - Function that returns the URL path from app context\n * @param type - Content type: 'semantic' or 'structured' (default: 'semantic')\n * @param debugging - Include pageEllmoError in props for debugging (default: false)\n * \n * Returns pageEllmoData in pageProps. If debugging is enabled, also includes pageEllmoError.\n * \n * @example\n * ```tsx\n * import { withEllmoApp } from 'ellmo-ai-react';\n * \n * function MyApp({ Component, pageProps }) {\n *   return (\n *     <>\n *       <header>\n *         <EllmoApiSSR \n *           data={pageProps.pageEllmoData} \n *           error={pageProps.pageEllmoError} \n *           showErrors={true} // Show errors in development\n *         />\n *       </header>\n *       <Component {...pageProps} />\n *     </>\n *   );\n * }\n * \n * MyApp.getInitialProps = withEllmoApp({\n *   clientId: process.env.NEXT_PUBLIC_ELLMO_CLIENT_ID!,\n *   url: (appContext) => '/global-header',\n *   type: 'structured',\n *   debugging: process.env.NODE_ENV === 'development' // Enable error prop in development\n * });\n * \n * export default MyApp;\n * ```\n */\nexport function withEllmoApp({\n  clientId,\n  url,\n  type = 'semantic',\n  debugging = false\n}: {\n  clientId: string;\n  url: (appContext: AppContext) => string;\n  type?: EllmoApiType;\n  debugging?: boolean;\n}) {\n  return async (appContext: AppContext) => {\n    // Fetch global Ellmo data\n    const { data, error } = await fetchEllmoData({\n      clientId,\n      url: url(appContext), // Use the function to get the URL\n      type\n    });\n\n    // Call the page's getInitialProps if it exists\n    let pageProps = {};\n    if (appContext.Component.getInitialProps) {\n      pageProps = await appContext.Component.getInitialProps(appContext.ctx);\n    }\n\n    // Return merged props with ellmo data inside pageProps\n    return {\n      pageProps: {\n        ...pageProps,\n        pageEllmoData: data,\n        ...(debugging ? { pageEllmoError: error } : {}), // Only add error if debugging is enabled\n      }\n    };\n  };\n}\n\n/**\n * Higher-order function to wrap getStaticProps with Ellmo data fetching\n * Automatically calls the page's existing getStaticProps and merges Ellmo data\n *\n * @param clientId - Your Ellmo client ID\n * @param url - Function that returns the URL path from GetStaticPropsContext\n * @param type - Content type: 'semantic' or 'structured' (default: 'semantic')\n * @param debugging - Include ellmoError in props for debugging (default: false)\n *\n * Returns ellmoData and ellmoError in props at both root level and inside pageProps for flexibility.\n *\n * @example\n * ```tsx\n * import { withEllmoStatic } from 'ellmo-ai-react';\n *\n * export const getStaticProps = withEllmoStatic({\n *   clientId: process.env.ELLMO_CLIENT_ID!,\n *   url: (context) => context.params?.slug ? `/blog/${context.params.slug}` : '/',\n *   type: 'semantic',\n *   debugging: process.env.NODE_ENV === 'development'\n * });\n *\n * // In page component - access directly\n * export default function BlogPost({ ellmoData, ellmoError }) {\n *   return (\n *     <div>\n *       <EllmoApiSSR data={ellmoData} error={ellmoError} />\n *       <h1>Blog Post</h1>\n *     </div>\n *   );\n * }\n *\n * // In _app.tsx - access via pageProps\n * function MyApp({ Component, pageProps }) {\n *   return (\n *     <div>\n *       <EllmoApiSSR data={pageProps.pageEllmoData} error={pageProps.pageEllmoError} />\n *       <Component {...pageProps} />\n *     </div>\n *   );\n * }\n * ```\n */\nexport function withEllmoStatic<P extends Record<string, any> = Record<string, any>>({\n  clientId,\n  url,\n  type = 'semantic',\n  debugging = false\n}: {\n  clientId: string;\n  url: (context: GetStaticPropsContext) => string;\n  type?: EllmoApiType;\n  debugging?: boolean;\n}) {\n  return async (context: GetStaticPropsContext) => {\n    return getEllmoStaticProps({\n      clientId,\n      url: url(context),\n      type,\n      debugging\n    }) as Promise<{ props: P & { ellmoData: string | null; ellmoError?: string | null; pageProps?: { pageEllmoData: string | null; pageEllmoError?: string | null } } }>;\n  };\n}\n\n/**\n * Build standardized Ellmo props synchronously from provided data and error.\n * Returns ellmoData/ellmoError at root and pageEllmoData/pageEllmoError inside pageProps.\n */\n// (removed buildEllmoProps to reduce surface area)\n\n/**\n * Fetch Ellmo data and return standardized props (no Next.js dependency).\n * Accepts a plain URL string and returns the same shape as buildEllmoProps.\n */\nexport async function getEllmoStaticProps({\n  clientId,\n  url,\n  type = 'semantic',\n  debugging = false\n}: {\n  clientId: string;\n  url: string;\n  type?: EllmoApiType;\n  debugging?: boolean;\n}): Promise<{ props: { ellmoData: string | null; ellmoError?: string | null; pageProps: { pageEllmoData: string | null; pageEllmoError?: string | null } } }> {\n  const { data, error } = await fetchEllmoData({ clientId, url, type });\n  const props: { ellmoData: string | null; ellmoError?: string | null; pageProps: { pageEllmoData: string | null; pageEllmoError?: string | null } } = {\n    ellmoData: data,\n    pageProps: {\n      pageEllmoData: data\n    }\n  };\n\n  if (debugging) {\n    props.ellmoError = error;\n    props.pageProps.pageEllmoError = error;\n  }\n\n  return { props };\n}\n\n","/**\n * Custom header name for Ellmo AI to pass pathname information\n * Using 'x-ellmo-pathname' to avoid conflicts with other libraries\n */\nexport const ELLMO_PATHNAME_HEADER = 'x-ellmo-pathname';\n\n/**\n * Type definitions for Next.js middleware (to avoid requiring Next.js as a dependency)\n */\nexport interface EllmoRequest {\n  nextUrl: {\n    pathname: string;\n  };\n}\n\nexport interface EllmoResponse {\n  headers: {\n    set(name: string, value: string): void;\n  };\n}\n\n/**\n * Ellmo AI middleware helper for Next.js\n * \n * This is a vanilla helper that adds pathname to request headers.\n * It doesn't depend on Next.js - you provide the request/response objects.\n * \n * Usage in Next.js:\n * \n * ```ts\n * // middleware.ts\n * import { ellmoMiddleware } from 'ellmo-ai-react/middleware';\n * import { NextResponse } from 'next/server';\n * import type { NextRequest } from 'next/server';\n * \n * export function middleware(request: NextRequest) {\n *   const response = NextResponse.next();\n *   return ellmoMiddleware(request, response);\n * }\n * \n * export const config = {\n *   matcher: [\n *     '/((?!_next/static|_next/image|favicon.ico).*)',\n *   ],\n * };\n * ```\n * \n * Composing with existing middleware:\n * \n * ```ts\n * export function middleware(request: NextRequest) {\n *   let response = NextResponse.next();\n *   \n *   // Your logic here\n *   if (someCondition) {\n *     response = NextResponse.redirect(new URL('/login', request.url));\n *   }\n *   \n *   // Apply Ellmo middleware\n *   return ellmoMiddleware(request, response);\n * }\n * ```\n */\nexport function ellmoMiddleware<\n  Req extends EllmoRequest,\n  Res extends EllmoResponse\n>(\n  request: Req,\n  response: Res\n): Res {\n  // Extract pathname from the request URL\n  const pathname = request.nextUrl.pathname;\n  \n  // Add the pathname to a custom header\n  response.headers.set(ELLMO_PATHNAME_HEADER, pathname);\n  \n  return response;\n}\n\n/**\n * Helper to extract pathname from headers object\n * \n * Usage in Next.js Server Components:\n * ```tsx\n * import { headers } from 'next/headers';\n * import { getPathnameFromHeaders } from 'ellmo-ai-react/middleware';\n * \n * export default function Page() {\n *   const headersList = headers();\n *   const pathname = getPathnameFromHeaders(headersList);\n *   \n *   return <EllmoApi clientId=\"your-id\" url={pathname} />;\n * }\n * ```\n */\nexport function getPathnameFromHeaders(headers: { get(name: string): string | null }): string | null {\n  return headers.get(ELLMO_PATHNAME_HEADER);\n}\n\nexport default ellmoMiddleware;\n"],"names":[],"mappings":"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"}

package/dist/index.mjs

@@ -260,6 +260,82 @@ function withEllmoApp({ clientId, url, type = 'semantic', debugging = false }) {
         };
     };
 }
+/**
+ * Higher-order function to wrap getStaticProps with Ellmo data fetching
+ * Automatically calls the page's existing getStaticProps and merges Ellmo data
+ *
+ * @param clientId - Your Ellmo client ID
+ * @param url - Function that returns the URL path from GetStaticPropsContext
+ * @param type - Content type: 'semantic' or 'structured' (default: 'semantic')
+ * @param debugging - Include ellmoError in props for debugging (default: false)
+ *
+ * Returns ellmoData and ellmoError in props at both root level and inside pageProps for flexibility.
+ *
+ * @example
+ * ```tsx
+ * import { withEllmoStatic } from 'ellmo-ai-react';
+ *
+ * export const getStaticProps = withEllmoStatic({
+ *   clientId: process.env.ELLMO_CLIENT_ID!,
+ *   url: (context) => context.params?.slug ? `/blog/${context.params.slug}` : '/',
+ *   type: 'semantic',
+ *   debugging: process.env.NODE_ENV === 'development'
+ * });
+ *
+ * // In page component - access directly
+ * export default function BlogPost({ ellmoData, ellmoError }) {
+ *   return (
+ *     <div>
+ *       <EllmoApiSSR data={ellmoData} error={ellmoError} />
+ *       <h1>Blog Post</h1>
+ *     </div>
+ *   );
+ * }
+ *
+ * // In _app.tsx - access via pageProps
+ * function MyApp({ Component, pageProps }) {
+ *   return (
+ *     <div>
+ *       <EllmoApiSSR data={pageProps.pageEllmoData} error={pageProps.pageEllmoError} />
+ *       <Component {...pageProps} />
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+function withEllmoStatic({ clientId, url, type = 'semantic', debugging = false }) {
+    return async (context) => {
+        return getEllmoStaticProps({
+            clientId,
+            url: url(context),
+            type,
+            debugging
+        });
+    };
+}
+/**
+ * Build standardized Ellmo props synchronously from provided data and error.
+ * Returns ellmoData/ellmoError at root and pageEllmoData/pageEllmoError inside pageProps.
+ */
+// (removed buildEllmoProps to reduce surface area)
+/**
+ * Fetch Ellmo data and return standardized props (no Next.js dependency).
+ * Accepts a plain URL string and returns the same shape as buildEllmoProps.
+ */
+async function getEllmoStaticProps({ clientId, url, type = 'semantic', debugging = false }) {
+    const { data, error } = await fetchEllmoData({ clientId, url, type });
+    const props = {
+        ellmoData: data,
+        pageProps: {
+            pageEllmoData: data
+        }
+    };
+    if (debugging) {
+        props.ellmoError = error;
+        props.pageProps.pageEllmoError = error;
+    }
+    return { props };
+}
 
 /**
  * Custom header name for Ellmo AI to pass pathname information
@@ -335,5 +411,5 @@ function getPathnameFromHeaders(headers) {
     return headers.get(ELLMO_PATHNAME_HEADER);
 }
 
-export { ELLMO_PATHNAME_HEADER, EllmoApi, EllmoApiSSR, ellmoMiddleware, fetchEllmoData, getPathnameFromHeaders, ellmoMiddleware as middleware, withEllmoApp };
+export { ELLMO_PATHNAME_HEADER, EllmoApi, EllmoApiSSR, ellmoMiddleware, fetchEllmoData, getEllmoStaticProps, getPathnameFromHeaders, ellmoMiddleware as middleware, withEllmoApp, withEllmoStatic };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sources":["../src/EllmoApi.tsx","../src/EllmoApiSSR.tsx","../src/shared.ts","../src/EllmoApiStatic.tsx","../src/middleware.ts"],"sourcesContent":["import React from 'react';\nimport type { EllmoApiType } from './shared';\n\nexport type { EllmoApiType };\n\nexport interface EllmoApiProps {\n  /**\n   * The URL path to fetch data for (required).\n   * \n   * With middleware (recommended):\n   * ```tsx\n   * import { headers } from 'next/headers';\n   * import { getPathnameFromHeaders } from 'ellmo-ai-react/middleware';\n   * \n   * const pathname = getPathnameFromHeaders(headers());\n   * <EllmoApi clientId=\"...\" url={pathname || '/'} />\n   * ```\n   * \n   * Without middleware:\n   * ```tsx\n   * <EllmoApi clientId=\"...\" url=\"/about\" />\n   * ```\n   */\n  url: string;\n  /**\n   * The API key/client identifier (required)\n   */\n  clientId: string;\n  /**\n   * Type of data to fetch\n   */\n  type?: EllmoApiType;\n  /**\n   * Custom className for styling\n   */\n  className?: string;\n  /**\n   * Whether to show errors\n   */\n  showErrors?: boolean;\n  /**\n   * Children to render when data is available\n   */\n  children?: (data: any, error: Error | null) => React.ReactNode;\n}\n\n/**\n * Server-only Ellmo API component (React Server Component)\n * This component fetches data during server rendering.\n * It requires Next.js 13+ App Router or other RSC-compatible frameworks.\n * \n * @example\n * ```tsx\n * // In a server component (app/page.tsx)\n * export default async function Page() {\n *   return <EllmoApi clientId=\"your-id\" url=\"/about\" />;\n * }\n * ```\n */\nconst EllmoApi = async ({\n  url,\n  clientId,\n  type,\n  className = '',\n  showErrors = false,\n  children\n}: EllmoApiProps): Promise<React.ReactElement | null> => {\n  let data: any = null;\n  let error: Error | null = null;\n\n  let translatedType = type === 'structured' ? 'structured' : 'semantic';\n\n  try {\n    // Validate required props\n    if (!clientId) {\n      throw new Error('clientId is required. Please provide your Ellmo API client identifier.');\n    }\n\n    if (!url) {\n      throw new Error('url prop is required. Please provide the page pathname.');\n    }\n\n    // Encode the URL path for the API call\n    const encodedUrl = encodeURIComponent(url);\n\n    // Build the API URL\n    const apiUrl = `https://www.tryellmo.ai/public-api/wordpress?c=${clientId}&t=${translatedType}&u=${encodedUrl}`;\n\n    // Fetch data during server render\n    const response = await fetch(apiUrl, {\n      cache: 'no-store', // Always fetch fresh data\n    });\n\n    if (!response.ok) {\n      throw new Error(`API request failed with status ${response.status}`);\n    }\n\n    if (type === 'structured') {\n      data = await response.text();\n    } else if (type === 'semantic') {\n      data = await response.text();\n    } else {\n      throw new Error(`Invalid type: ${type}`);\n    }\n  } catch (err) {\n    error = err instanceof Error ? err : new Error('Unknown error occurred');\n  }\n\n  // If children prop is provided, use render prop pattern\n  if (children) {\n    return <>{children(data, error)}</>;\n  }\n\n  // Show errors if enabled\n  if (error && showErrors) {\n    return (\n      <div className={`ellmo-api-error ${className}`}>\n        <div>Error: {error.message}</div>\n      </div>\n    );\n  }\n\n  // Show data if showErrors is enabled (for debugging)\n  if (data && showErrors) {\n    return (\n      <div className={`ellmo-api-data ${className}`}>\n        <pre>{JSON.stringify(data, null, 2)}</pre>\n      </div>\n    );\n  }\n\n  // Invisible component by default - just fetches data during server render\n  if (type === 'structured' && data) {\n    return <div dangerouslySetInnerHTML={{ __html: data }} />;\n  } else if (type === 'semantic' && data) {\n    return <div dangerouslySetInnerHTML={{ __html: data }} />;\n  }\n  return null;\n};\n\nexport default EllmoApi;\n","import React from 'react';\nimport type { EllmoApiType } from './shared';\n\nexport type { EllmoApiType };\n\nexport interface EllmoApiSSRProps {\n  /**\n   * The pre-fetched data from the Ellmo API\n   */\n  data?: string | null;\n  /**\n   * Error from fetching data\n   */\n  error?: string | null;\n  /**\n   * Type of data to render\n   */\n  type?: EllmoApiType;\n  /**\n   * Custom className for styling\n   */\n  className?: string;\n  /**\n   * Whether to show errors\n   */\n  showErrors?: boolean;\n  /**\n   * Children render prop with data and error\n   */\n  children?: (data: string | null, error: string | null) => React.ReactNode;\n}\n\n/**\n * Ellmo API component for traditional SSR environments (Next.js Pages Router)\n * This component receives pre-fetched data and renders it.\n * Data fetching should be done in getServerSideProps or getStaticProps.\n * \n * @example\n * ```tsx\n * // In your page file (pages/about.tsx)\n * import { EllmoApiSSR, fetchEllmoData } from 'ellmo-ai-react';\n * \n * export async function getServerSideProps(context) {\n *   const { data, error } = await fetchEllmoData({\n *     clientId: 'your-client-id',\n *     url: context.resolvedUrl,\n *     type: 'semantic'\n *   });\n *   \n *   return {\n *     props: { ellmoData: data, ellmoError: error }\n *   };\n * }\n * \n * export default function AboutPage({ ellmoData, ellmoError }) {\n *   return (\n *     <div>\n *       <h1>About Page</h1>\n *       <EllmoApiSSR data={ellmoData} error={ellmoError} />\n *     </div>\n *   );\n * }\n * ```\n */\nconst EllmoApiSSR: React.FC<EllmoApiSSRProps> = ({\n  data = null,\n  error = null,\n  className = '',\n  showErrors = false,\n  children\n}) => {\n  // If children prop is provided, use render prop pattern\n  if (children) {\n    return <>{children(data, error)}</>;\n  }\n\n  // Show errors if enabled\n  if (error && showErrors) {\n    return (\n      <div className={`ellmo-api-error ${className}`}>\n        <div>Error: {error}</div>\n      </div>\n    );\n  }\n\n  // Show data if showErrors is enabled (for debugging)\n  if (data && showErrors) {\n    return (\n      <div className={`ellmo-api-data ${className}`}>\n        <pre>{data}</pre>\n      </div>\n    );\n  }\n\n  // Render HTML content if available\n  if (data && !error) {\n    return <div className={className} dangerouslySetInnerHTML={{ __html: data }} />;\n  }\n\n  // Return null if no data\n  return null;\n};\n\nexport default EllmoApiSSR;\n \n","export type EllmoApiType = 'semantic' | 'structured';\n\n/**\n * Fetch data from Ellmo API\n * Use this in getServerSideProps, getStaticProps, or getInitialProps\n * \n * @example\n * ```tsx\n * // In getServerSideProps (Next.js Pages Router)\n * export async function getServerSideProps(context) {\n *   const { data, error } = await fetchEllmoData({\n *     clientId: process.env.ELLMO_CLIENT_ID!,\n *     url: context.resolvedUrl,\n *     type: 'semantic'\n *   });\n *   \n *   return {\n *     props: { ellmoData: data, ellmoError: error }\n *   };\n * }\n * \n * // In getInitialProps (older Next.js API)\n * MyPage.getInitialProps = async (ctx) => {\n *   const { data, error } = await fetchEllmoData({\n *     clientId: process.env.NEXT_PUBLIC_ELLMO_CLIENT_ID!,\n *     url: ctx.asPath || '/',\n *     type: 'semantic'\n *   });\n *   \n *   return { ellmoData: data, ellmoError: error };\n * };\n * ```\n */\nexport async function fetchEllmoData({\n  clientId,\n  url,\n  type = 'semantic'\n}: {\n  clientId: string;\n  url: string;\n  type?: EllmoApiType;\n}): Promise<{ data: string | null; error: string | null }> {\n  try {\n    // Validate required props\n    if (!clientId) {\n      throw new Error('clientId is required. Please provide your Ellmo API client identifier.');\n    }\n\n    if (!url) {\n      throw new Error('url is required. Please provide the page pathname.');\n    }\n\n    if (url.includes('.')) {\n      // Sometimes urls contain a dot if they're images or other assets which are served by SSG (static generation)\n      return { data: null, error: null };\n    }\n\n    // Encode the URL path for the API call\n    const encodedUrl = encodeURIComponent(url);\n    const translatedType = type === 'structured' ? 'structured' : 'semantic';\n\n    // Build the API URL\n    const apiUrl = `https://www.tryellmo.ai/public-api/wordpress?c=${clientId}&t=${translatedType}&u=${encodedUrl}`;\n\n    // Fetch data\n    const response = await fetch(apiUrl, {\n      cache: 'no-store',\n    });\n\n    if (!response.ok) {\n      throw new Error(`API request failed with status ${response.status}`);\n    }\n\n    const data = await response.text();\n    return { data, error: null };\n  } catch (err) {\n    const errorMessage = err instanceof Error ? err.message : 'Unknown error occurred';\n    return { data: null, error: errorMessage };\n  }\n}\n\n","import { fetchEllmoData, type EllmoApiType } from './shared';\n\nexport type { EllmoApiType };\n\n// Type for Next.js App context\ntype AppContext = {\n  Component: any;\n  ctx: any;\n  router: any;\n};\n\n\n/**\n * Helper for _app.tsx to fetch global Ellmo data and merge with page props\n * Automatically calls the page's getInitialProps and merges everything\n * \n * @param clientId - Your Ellmo client ID\n * @param url - Function that returns the URL path from app context\n * @param type - Content type: 'semantic' or 'structured' (default: 'semantic')\n * @param debugging - Include pageEllmoError in props for debugging (default: false)\n * \n * Returns pageEllmoData in pageProps. If debugging is enabled, also includes pageEllmoError.\n * \n * @example\n * ```tsx\n * import { withEllmoApp } from 'ellmo-ai-react';\n * \n * function MyApp({ Component, pageProps }) {\n *   return (\n *     <>\n *       <header>\n *         <EllmoApiSSR \n *           data={pageProps.pageEllmoData} \n *           error={pageProps.pageEllmoError} \n *           showErrors={true} // Show errors in development\n *         />\n *       </header>\n *       <Component {...pageProps} />\n *     </>\n *   );\n * }\n * \n * MyApp.getInitialProps = withEllmoApp({\n *   clientId: process.env.NEXT_PUBLIC_ELLMO_CLIENT_ID!,\n *   url: (appContext) => '/global-header',\n *   type: 'structured',\n *   debugging: process.env.NODE_ENV === 'development' // Enable error prop in development\n * });\n * \n * export default MyApp;\n * ```\n */\nexport function withEllmoApp({\n  clientId,\n  url,\n  type = 'semantic',\n  debugging = false\n}: {\n  clientId: string;\n  url: (appContext: AppContext) => string;\n  type?: EllmoApiType;\n  debugging?: boolean;\n}) {\n  return async (appContext: AppContext) => {\n    // Fetch global Ellmo data\n    const { data, error } = await fetchEllmoData({\n      clientId,\n      url: url(appContext), // Use the function to get the URL\n      type\n    });\n\n    // Call the page's getInitialProps if it exists\n    let pageProps = {};\n    if (appContext.Component.getInitialProps) {\n      pageProps = await appContext.Component.getInitialProps(appContext.ctx);\n    }\n\n    // Return merged props with ellmo data inside pageProps\n    return {\n      pageProps: {\n        ...pageProps,\n        pageEllmoData: data,\n        ...(debugging ? { pageEllmoError: error } : {}), // Only add error if debugging is enabled\n      }\n    };\n  };\n}\n","/**\n * Custom header name for Ellmo AI to pass pathname information\n * Using 'x-ellmo-pathname' to avoid conflicts with other libraries\n */\nexport const ELLMO_PATHNAME_HEADER = 'x-ellmo-pathname';\n\n/**\n * Type definitions for Next.js middleware (to avoid requiring Next.js as a dependency)\n */\nexport interface EllmoRequest {\n  nextUrl: {\n    pathname: string;\n  };\n}\n\nexport interface EllmoResponse {\n  headers: {\n    set(name: string, value: string): void;\n  };\n}\n\n/**\n * Ellmo AI middleware helper for Next.js\n * \n * This is a vanilla helper that adds pathname to request headers.\n * It doesn't depend on Next.js - you provide the request/response objects.\n * \n * Usage in Next.js:\n * \n * ```ts\n * // middleware.ts\n * import { ellmoMiddleware } from 'ellmo-ai-react/middleware';\n * import { NextResponse } from 'next/server';\n * import type { NextRequest } from 'next/server';\n * \n * export function middleware(request: NextRequest) {\n *   const response = NextResponse.next();\n *   return ellmoMiddleware(request, response);\n * }\n * \n * export const config = {\n *   matcher: [\n *     '/((?!_next/static|_next/image|favicon.ico).*)',\n *   ],\n * };\n * ```\n * \n * Composing with existing middleware:\n * \n * ```ts\n * export function middleware(request: NextRequest) {\n *   let response = NextResponse.next();\n *   \n *   // Your logic here\n *   if (someCondition) {\n *     response = NextResponse.redirect(new URL('/login', request.url));\n *   }\n *   \n *   // Apply Ellmo middleware\n *   return ellmoMiddleware(request, response);\n * }\n * ```\n */\nexport function ellmoMiddleware<\n  Req extends EllmoRequest,\n  Res extends EllmoResponse\n>(\n  request: Req,\n  response: Res\n): Res {\n  // Extract pathname from the request URL\n  const pathname = request.nextUrl.pathname;\n  \n  // Add the pathname to a custom header\n  response.headers.set(ELLMO_PATHNAME_HEADER, pathname);\n  \n  return response;\n}\n\n/**\n * Helper to extract pathname from headers object\n * \n * Usage in Next.js Server Components:\n * ```tsx\n * import { headers } from 'next/headers';\n * import { getPathnameFromHeaders } from 'ellmo-ai-react/middleware';\n * \n * export default function Page() {\n *   const headersList = headers();\n *   const pathname = getPathnameFromHeaders(headersList);\n *   \n *   return <EllmoApi clientId=\"your-id\" url={pathname} />;\n * }\n * ```\n */\nexport function getPathnameFromHeaders(headers: { get(name: string): string | null }): string | null {\n  return headers.get(ELLMO_PATHNAME_HEADER);\n}\n\nexport default ellmoMiddleware;\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.mjs","sources":["../src/EllmoApi.tsx","../src/EllmoApiSSR.tsx","../src/shared.ts","../src/EllmoApiStatic.tsx","../src/middleware.ts"],"sourcesContent":["import React from 'react';\nimport type { EllmoApiType } from './shared';\n\nexport type { EllmoApiType };\n\nexport interface EllmoApiProps {\n  /**\n   * The URL path to fetch data for (required).\n   * \n   * With middleware (recommended):\n   * ```tsx\n   * import { headers } from 'next/headers';\n   * import { getPathnameFromHeaders } from 'ellmo-ai-react/middleware';\n   * \n   * const pathname = getPathnameFromHeaders(headers());\n   * <EllmoApi clientId=\"...\" url={pathname || '/'} />\n   * ```\n   * \n   * Without middleware:\n   * ```tsx\n   * <EllmoApi clientId=\"...\" url=\"/about\" />\n   * ```\n   */\n  url: string;\n  /**\n   * The API key/client identifier (required)\n   */\n  clientId: string;\n  /**\n   * Type of data to fetch\n   */\n  type?: EllmoApiType;\n  /**\n   * Custom className for styling\n   */\n  className?: string;\n  /**\n   * Whether to show errors\n   */\n  showErrors?: boolean;\n  /**\n   * Children to render when data is available\n   */\n  children?: (data: any, error: Error | null) => React.ReactNode;\n}\n\n/**\n * Server-only Ellmo API component (React Server Component)\n * This component fetches data during server rendering.\n * It requires Next.js 13+ App Router or other RSC-compatible frameworks.\n * \n * @example\n * ```tsx\n * // In a server component (app/page.tsx)\n * export default async function Page() {\n *   return <EllmoApi clientId=\"your-id\" url=\"/about\" />;\n * }\n * ```\n */\nconst EllmoApi = async ({\n  url,\n  clientId,\n  type,\n  className = '',\n  showErrors = false,\n  children\n}: EllmoApiProps): Promise<React.ReactElement | null> => {\n  let data: any = null;\n  let error: Error | null = null;\n\n  let translatedType = type === 'structured' ? 'structured' : 'semantic';\n\n  try {\n    // Validate required props\n    if (!clientId) {\n      throw new Error('clientId is required. Please provide your Ellmo API client identifier.');\n    }\n\n    if (!url) {\n      throw new Error('url prop is required. Please provide the page pathname.');\n    }\n\n    // Encode the URL path for the API call\n    const encodedUrl = encodeURIComponent(url);\n\n    // Build the API URL\n    const apiUrl = `https://www.tryellmo.ai/public-api/wordpress?c=${clientId}&t=${translatedType}&u=${encodedUrl}`;\n\n    // Fetch data during server render\n    const response = await fetch(apiUrl, {\n      cache: 'no-store', // Always fetch fresh data\n    });\n\n    if (!response.ok) {\n      throw new Error(`API request failed with status ${response.status}`);\n    }\n\n    if (type === 'structured') {\n      data = await response.text();\n    } else if (type === 'semantic') {\n      data = await response.text();\n    } else {\n      throw new Error(`Invalid type: ${type}`);\n    }\n  } catch (err) {\n    error = err instanceof Error ? err : new Error('Unknown error occurred');\n  }\n\n  // If children prop is provided, use render prop pattern\n  if (children) {\n    return <>{children(data, error)}</>;\n  }\n\n  // Show errors if enabled\n  if (error && showErrors) {\n    return (\n      <div className={`ellmo-api-error ${className}`}>\n        <div>Error: {error.message}</div>\n      </div>\n    );\n  }\n\n  // Show data if showErrors is enabled (for debugging)\n  if (data && showErrors) {\n    return (\n      <div className={`ellmo-api-data ${className}`}>\n        <pre>{JSON.stringify(data, null, 2)}</pre>\n      </div>\n    );\n  }\n\n  // Invisible component by default - just fetches data during server render\n  if (type === 'structured' && data) {\n    return <div dangerouslySetInnerHTML={{ __html: data }} />;\n  } else if (type === 'semantic' && data) {\n    return <div dangerouslySetInnerHTML={{ __html: data }} />;\n  }\n  return null;\n};\n\nexport default EllmoApi;\n","import React from 'react';\nimport type { EllmoApiType } from './shared';\n\nexport type { EllmoApiType };\n\nexport interface EllmoApiSSRProps {\n  /**\n   * The pre-fetched data from the Ellmo API\n   */\n  data?: string | null;\n  /**\n   * Error from fetching data\n   */\n  error?: string | null;\n  /**\n   * Type of data to render\n   */\n  type?: EllmoApiType;\n  /**\n   * Custom className for styling\n   */\n  className?: string;\n  /**\n   * Whether to show errors\n   */\n  showErrors?: boolean;\n  /**\n   * Children render prop with data and error\n   */\n  children?: (data: string | null, error: string | null) => React.ReactNode;\n}\n\n/**\n * Ellmo API component for traditional SSR environments (Next.js Pages Router)\n * This component receives pre-fetched data and renders it.\n * Data fetching should be done in getServerSideProps or getStaticProps.\n * \n * @example\n * ```tsx\n * // In your page file (pages/about.tsx)\n * import { EllmoApiSSR, fetchEllmoData } from 'ellmo-ai-react';\n * \n * export async function getServerSideProps(context) {\n *   const { data, error } = await fetchEllmoData({\n *     clientId: 'your-client-id',\n *     url: context.resolvedUrl,\n *     type: 'semantic'\n *   });\n *   \n *   return {\n *     props: { ellmoData: data, ellmoError: error }\n *   };\n * }\n * \n * export default function AboutPage({ ellmoData, ellmoError }) {\n *   return (\n *     <div>\n *       <h1>About Page</h1>\n *       <EllmoApiSSR data={ellmoData} error={ellmoError} />\n *     </div>\n *   );\n * }\n * ```\n */\nconst EllmoApiSSR: React.FC<EllmoApiSSRProps> = ({\n  data = null,\n  error = null,\n  className = '',\n  showErrors = false,\n  children\n}) => {\n  // If children prop is provided, use render prop pattern\n  if (children) {\n    return <>{children(data, error)}</>;\n  }\n\n  // Show errors if enabled\n  if (error && showErrors) {\n    return (\n      <div className={`ellmo-api-error ${className}`}>\n        <div>Error: {error}</div>\n      </div>\n    );\n  }\n\n  // Show data if showErrors is enabled (for debugging)\n  if (data && showErrors) {\n    return (\n      <div className={`ellmo-api-data ${className}`}>\n        <pre>{data}</pre>\n      </div>\n    );\n  }\n\n  // Render HTML content if available\n  if (data && !error) {\n    return <div className={className} dangerouslySetInnerHTML={{ __html: data }} />;\n  }\n\n  // Return null if no data\n  return null;\n};\n\nexport default EllmoApiSSR;\n \n","export type EllmoApiType = 'semantic' | 'structured';\n\n/**\n * Fetch data from Ellmo API\n * Use this in getServerSideProps, getStaticProps, or getInitialProps\n * \n * @example\n * ```tsx\n * // In getServerSideProps (Next.js Pages Router)\n * export async function getServerSideProps(context) {\n *   const { data, error } = await fetchEllmoData({\n *     clientId: process.env.ELLMO_CLIENT_ID!,\n *     url: context.resolvedUrl,\n *     type: 'semantic'\n *   });\n *   \n *   return {\n *     props: { ellmoData: data, ellmoError: error }\n *   };\n * }\n * \n * // In getInitialProps (older Next.js API)\n * MyPage.getInitialProps = async (ctx) => {\n *   const { data, error } = await fetchEllmoData({\n *     clientId: process.env.NEXT_PUBLIC_ELLMO_CLIENT_ID!,\n *     url: ctx.asPath || '/',\n *     type: 'semantic'\n *   });\n *   \n *   return { ellmoData: data, ellmoError: error };\n * };\n * ```\n */\nexport async function fetchEllmoData({\n  clientId,\n  url,\n  type = 'semantic'\n}: {\n  clientId: string;\n  url: string;\n  type?: EllmoApiType;\n}): Promise<{ data: string | null; error: string | null }> {\n  try {\n    // Validate required props\n    if (!clientId) {\n      throw new Error('clientId is required. Please provide your Ellmo API client identifier.');\n    }\n\n    if (!url) {\n      throw new Error('url is required. Please provide the page pathname.');\n    }\n\n    if (url.includes('.')) {\n      // Sometimes urls contain a dot if they're images or other assets which are served by SSG (static generation)\n      return { data: null, error: null };\n    }\n\n    // Encode the URL path for the API call\n    const encodedUrl = encodeURIComponent(url);\n    const translatedType = type === 'structured' ? 'structured' : 'semantic';\n\n    // Build the API URL\n    const apiUrl = `https://www.tryellmo.ai/public-api/wordpress?c=${clientId}&t=${translatedType}&u=${encodedUrl}`;\n\n    // Fetch data\n    const response = await fetch(apiUrl, {\n      cache: 'no-store',\n    });\n\n    if (!response.ok) {\n      throw new Error(`API request failed with status ${response.status}`);\n    }\n\n    const data = await response.text();\n    return { data, error: null };\n  } catch (err) {\n    const errorMessage = err instanceof Error ? err.message : 'Unknown error occurred';\n    return { data: null, error: errorMessage };\n  }\n}\n\n","import { fetchEllmoData, type EllmoApiType } from './shared';\n\nexport type { EllmoApiType };\n\n// Type for Next.js App context\ntype AppContext = {\n  Component: any;\n  ctx: any;\n  router: any;\n};\n\n// Type for Next.js GetStaticProps context (minimal definition to avoid next.js dependency)\ntype GetStaticPropsContext = {\n  params?: Record<string, string | string[]>;\n  preview?: boolean;\n  previewData?: any;\n  locale?: string;\n  locales?: string[];\n  defaultLocale?: string;\n};\n\n\n/**\n * Helper for _app.tsx to fetch global Ellmo data and merge with page props\n * Automatically calls the page's getInitialProps and merges everything\n * \n * @param clientId - Your Ellmo client ID\n * @param url - Function that returns the URL path from app context\n * @param type - Content type: 'semantic' or 'structured' (default: 'semantic')\n * @param debugging - Include pageEllmoError in props for debugging (default: false)\n * \n * Returns pageEllmoData in pageProps. If debugging is enabled, also includes pageEllmoError.\n * \n * @example\n * ```tsx\n * import { withEllmoApp } from 'ellmo-ai-react';\n * \n * function MyApp({ Component, pageProps }) {\n *   return (\n *     <>\n *       <header>\n *         <EllmoApiSSR \n *           data={pageProps.pageEllmoData} \n *           error={pageProps.pageEllmoError} \n *           showErrors={true} // Show errors in development\n *         />\n *       </header>\n *       <Component {...pageProps} />\n *     </>\n *   );\n * }\n * \n * MyApp.getInitialProps = withEllmoApp({\n *   clientId: process.env.NEXT_PUBLIC_ELLMO_CLIENT_ID!,\n *   url: (appContext) => '/global-header',\n *   type: 'structured',\n *   debugging: process.env.NODE_ENV === 'development' // Enable error prop in development\n * });\n * \n * export default MyApp;\n * ```\n */\nexport function withEllmoApp({\n  clientId,\n  url,\n  type = 'semantic',\n  debugging = false\n}: {\n  clientId: string;\n  url: (appContext: AppContext) => string;\n  type?: EllmoApiType;\n  debugging?: boolean;\n}) {\n  return async (appContext: AppContext) => {\n    // Fetch global Ellmo data\n    const { data, error } = await fetchEllmoData({\n      clientId,\n      url: url(appContext), // Use the function to get the URL\n      type\n    });\n\n    // Call the page's getInitialProps if it exists\n    let pageProps = {};\n    if (appContext.Component.getInitialProps) {\n      pageProps = await appContext.Component.getInitialProps(appContext.ctx);\n    }\n\n    // Return merged props with ellmo data inside pageProps\n    return {\n      pageProps: {\n        ...pageProps,\n        pageEllmoData: data,\n        ...(debugging ? { pageEllmoError: error } : {}), // Only add error if debugging is enabled\n      }\n    };\n  };\n}\n\n/**\n * Higher-order function to wrap getStaticProps with Ellmo data fetching\n * Automatically calls the page's existing getStaticProps and merges Ellmo data\n *\n * @param clientId - Your Ellmo client ID\n * @param url - Function that returns the URL path from GetStaticPropsContext\n * @param type - Content type: 'semantic' or 'structured' (default: 'semantic')\n * @param debugging - Include ellmoError in props for debugging (default: false)\n *\n * Returns ellmoData and ellmoError in props at both root level and inside pageProps for flexibility.\n *\n * @example\n * ```tsx\n * import { withEllmoStatic } from 'ellmo-ai-react';\n *\n * export const getStaticProps = withEllmoStatic({\n *   clientId: process.env.ELLMO_CLIENT_ID!,\n *   url: (context) => context.params?.slug ? `/blog/${context.params.slug}` : '/',\n *   type: 'semantic',\n *   debugging: process.env.NODE_ENV === 'development'\n * });\n *\n * // In page component - access directly\n * export default function BlogPost({ ellmoData, ellmoError }) {\n *   return (\n *     <div>\n *       <EllmoApiSSR data={ellmoData} error={ellmoError} />\n *       <h1>Blog Post</h1>\n *     </div>\n *   );\n * }\n *\n * // In _app.tsx - access via pageProps\n * function MyApp({ Component, pageProps }) {\n *   return (\n *     <div>\n *       <EllmoApiSSR data={pageProps.pageEllmoData} error={pageProps.pageEllmoError} />\n *       <Component {...pageProps} />\n *     </div>\n *   );\n * }\n * ```\n */\nexport function withEllmoStatic<P extends Record<string, any> = Record<string, any>>({\n  clientId,\n  url,\n  type = 'semantic',\n  debugging = false\n}: {\n  clientId: string;\n  url: (context: GetStaticPropsContext) => string;\n  type?: EllmoApiType;\n  debugging?: boolean;\n}) {\n  return async (context: GetStaticPropsContext) => {\n    return getEllmoStaticProps({\n      clientId,\n      url: url(context),\n      type,\n      debugging\n    }) as Promise<{ props: P & { ellmoData: string | null; ellmoError?: string | null; pageProps?: { pageEllmoData: string | null; pageEllmoError?: string | null } } }>;\n  };\n}\n\n/**\n * Build standardized Ellmo props synchronously from provided data and error.\n * Returns ellmoData/ellmoError at root and pageEllmoData/pageEllmoError inside pageProps.\n */\n// (removed buildEllmoProps to reduce surface area)\n\n/**\n * Fetch Ellmo data and return standardized props (no Next.js dependency).\n * Accepts a plain URL string and returns the same shape as buildEllmoProps.\n */\nexport async function getEllmoStaticProps({\n  clientId,\n  url,\n  type = 'semantic',\n  debugging = false\n}: {\n  clientId: string;\n  url: string;\n  type?: EllmoApiType;\n  debugging?: boolean;\n}): Promise<{ props: { ellmoData: string | null; ellmoError?: string | null; pageProps: { pageEllmoData: string | null; pageEllmoError?: string | null } } }> {\n  const { data, error } = await fetchEllmoData({ clientId, url, type });\n  const props: { ellmoData: string | null; ellmoError?: string | null; pageProps: { pageEllmoData: string | null; pageEllmoError?: string | null } } = {\n    ellmoData: data,\n    pageProps: {\n      pageEllmoData: data\n    }\n  };\n\n  if (debugging) {\n    props.ellmoError = error;\n    props.pageProps.pageEllmoError = error;\n  }\n\n  return { props };\n}\n\n","/**\n * Custom header name for Ellmo AI to pass pathname information\n * Using 'x-ellmo-pathname' to avoid conflicts with other libraries\n */\nexport const ELLMO_PATHNAME_HEADER = 'x-ellmo-pathname';\n\n/**\n * Type definitions for Next.js middleware (to avoid requiring Next.js as a dependency)\n */\nexport interface EllmoRequest {\n  nextUrl: {\n    pathname: string;\n  };\n}\n\nexport interface EllmoResponse {\n  headers: {\n    set(name: string, value: string): void;\n  };\n}\n\n/**\n * Ellmo AI middleware helper for Next.js\n * \n * This is a vanilla helper that adds pathname to request headers.\n * It doesn't depend on Next.js - you provide the request/response objects.\n * \n * Usage in Next.js:\n * \n * ```ts\n * // middleware.ts\n * import { ellmoMiddleware } from 'ellmo-ai-react/middleware';\n * import { NextResponse } from 'next/server';\n * import type { NextRequest } from 'next/server';\n * \n * export function middleware(request: NextRequest) {\n *   const response = NextResponse.next();\n *   return ellmoMiddleware(request, response);\n * }\n * \n * export const config = {\n *   matcher: [\n *     '/((?!_next/static|_next/image|favicon.ico).*)',\n *   ],\n * };\n * ```\n * \n * Composing with existing middleware:\n * \n * ```ts\n * export function middleware(request: NextRequest) {\n *   let response = NextResponse.next();\n *   \n *   // Your logic here\n *   if (someCondition) {\n *     response = NextResponse.redirect(new URL('/login', request.url));\n *   }\n *   \n *   // Apply Ellmo middleware\n *   return ellmoMiddleware(request, response);\n * }\n * ```\n */\nexport function ellmoMiddleware<\n  Req extends EllmoRequest,\n  Res extends EllmoResponse\n>(\n  request: Req,\n  response: Res\n): Res {\n  // Extract pathname from the request URL\n  const pathname = request.nextUrl.pathname;\n  \n  // Add the pathname to a custom header\n  response.headers.set(ELLMO_PATHNAME_HEADER, pathname);\n  \n  return response;\n}\n\n/**\n * Helper to extract pathname from headers object\n * \n * Usage in Next.js Server Components:\n * ```tsx\n * import { headers } from 'next/headers';\n * import { getPathnameFromHeaders } from 'ellmo-ai-react/middleware';\n * \n * export default function Page() {\n *   const headersList = headers();\n *   const pathname = getPathnameFromHeaders(headersList);\n *   \n *   return <EllmoApi clientId=\"your-id\" url={pathname} />;\n * }\n * ```\n */\nexport function getPathnameFromHeaders(headers: { get(name: string): string | null }): string | null {\n  return headers.get(ELLMO_PATHNAME_HEADER);\n}\n\nexport default ellmoMiddleware;\n"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ellmo-ai-react",
-  "version": "0.0.17",
+  "version": "0.0.22",
   "website": "https://www.tryellmo.ai?utm_source=npm&utm_medium=package&utm_campaign=ellmo-ai-react",
   "description": "React component for integration with Ellmo AI Platform",
   "main": "dist/index.js",