react-fathom 0.1.0

package/src/next/compositions/withPagesRouter.test.tsx

@@ -0,0 +1,113 @@
+import React from 'react'
+
+import { beforeEach, describe, expect, it, vi } from 'vitest'
+
+import { render, screen } from '@testing-library/react'
+
+import { withPagesRouter } from './withPagesRouter'
+
+// Mock NextFathomProviderPages
+vi.mock('../NextFathomProviderPages', () => ({
+  default: ({
+    children,
+    siteId,
+  }: {
+    children: React.ReactNode
+    siteId?: string
+  }) => (
+    <div data-testid="pages-provider" data-site-id={siteId}>
+      {children}
+    </div>
+  ),
+}))
+
+describe('withPagesRouter', () => {
+  beforeEach(() => {
+    vi.clearAllMocks()
+  })
+
+  it('should wrap component with NextFathomProviderPages', () => {
+    const TestComponent = ({ name }: { name: string }) => (
+      <div>Hello {name}</div>
+    )
+
+    const WrappedComponent = withPagesRouter(TestComponent, {
+      siteId: 'TEST_SITE_ID',
+    })
+
+    render(<WrappedComponent name="World" />)
+
+    expect(screen.getByTestId('pages-provider')).toBeInTheDocument()
+    expect(screen.getByTestId('pages-provider')).toHaveAttribute(
+      'data-site-id',
+      'TEST_SITE_ID',
+    )
+    expect(screen.getByText('Hello World')).toBeInTheDocument()
+  })
+
+  it('should pass props to wrapped component', () => {
+    const TestComponent = ({ count }: { count: number }) => (
+      <div>Count: {count}</div>
+    )
+
+    const WrappedComponent = withPagesRouter(TestComponent)
+
+    render(<WrappedComponent count={42} />)
+
+    expect(screen.getByText('Count: 42')).toBeInTheDocument()
+  })
+
+  it('should pass provider props to NextFathomProviderPages', () => {
+    const TestComponent = () => <div>Test</div>
+
+    const WrappedComponent = withPagesRouter(TestComponent, {
+      siteId: 'TEST_SITE_ID',
+      disableAutoTrack: true,
+      clientOptions: { honorDNT: true },
+    })
+
+    render(<WrappedComponent />)
+
+    expect(screen.getByTestId('pages-provider')).toBeInTheDocument()
+  })
+
+  it('should work without provider props', () => {
+    const TestComponent = () => <div>Test</div>
+
+    const WrappedComponent = withPagesRouter(TestComponent)
+
+    render(<WrappedComponent />)
+
+    expect(screen.getByTestId('pages-provider')).toBeInTheDocument()
+    expect(screen.getByText('Test')).toBeInTheDocument()
+  })
+
+  it('should set displayName correctly', () => {
+    const TestComponent = () => <div>Test</div>
+    TestComponent.displayName = 'TestComponent'
+
+    const WrappedComponent = withPagesRouter(TestComponent)
+
+    expect(WrappedComponent.displayName).toBe('withPagesRouter(TestComponent)')
+  })
+
+  it('should set displayName with component name when displayName is not set', () => {
+    function TestComponent() {
+      return <div>Test</div>
+    }
+
+    const WrappedComponent = withPagesRouter(TestComponent)
+
+    expect(WrappedComponent.displayName).toBe('withPagesRouter(TestComponent)')
+  })
+
+  it('should set displayName with Component fallback', () => {
+    const TestComponent = () => <div>Test</div>
+    // Remove displayName and name
+    Object.defineProperty(TestComponent, 'name', { value: '' })
+
+    const WrappedComponent = withPagesRouter(TestComponent)
+
+    expect(WrappedComponent.displayName).toBe('withPagesRouter(Component)')
+  })
+})

package/src/next/compositions/withPagesRouter.tsx

@@ -0,0 +1,44 @@
+import React from 'react'
+import type { ComponentType } from 'react'
+
+import NextFathomProviderPages from '../NextFathomProviderPages'
+import type { NextFathomProviderProps } from '../types'
+
+/**
+ * Higher-order component that wraps your Next.js Pages Router app with FathomProvider
+ *
+ * @example
+ * ```tsx
+ * // pages/_app.tsx
+ * import { withPagesRouter } from 'react-fathom/next'
+ *
+ * function MyApp({ Component, pageProps }) {
+ *   return <Component {...pageProps} />
+ * }
+ *
+ * export default withPagesRouter(MyApp, {
+ *   siteId: 'YOUR_SITE_ID',
+ *   clientOptions: {
+ *     spa: 'auto',
+ *   },
+ * })
+ * ```
+ */
+const withPagesRouter = <P extends object>(
+  Component: ComponentType<P>,
+  providerProps?: NextFathomProviderProps,
+): ComponentType<P> => {
+  const WithPagesRouter: React.FC<P> = (props) => {
+    return (
+      <NextFathomProviderPages {...providerProps}>
+        <Component {...props} />
+      </NextFathomProviderPages>
+    )
+  }
+
+  WithPagesRouter.displayName = `withPagesRouter(${Component.displayName || Component.name || 'Component'})`
+
+  return WithPagesRouter
+}
+
+export { withPagesRouter }

package/src/next/index.ts

@@ -0,0 +1,7 @@
+export * from './NextFathomProviderPages'
+export * from './NextFathomProviderApp'
+export * from './NextFathomProvider'
+
+// Convenience compositions for easy setup
+export * from './compositions/withPagesRouter'
+export * from './compositions/withAppRouter'

package/src/next/types.ts

@@ -0,0 +1,19 @@
+import type { PropsWithChildren } from 'react'
+
+import type { PageViewOptions } from 'fathom-client'
+
+import type { FathomProviderProps } from '../types'
+
+export interface NextFathomProviderProps
+  extends PropsWithChildren, Omit<FathomProviderProps, 'disableDefaultTrack'> {
+  /**
+   * Disable automatic pageview tracking on route changes
+   * @default false
+   */
+  disableAutoTrack?: boolean
+  /**
+   * Default options to pass to trackPageview on route changes
+   * @deprecated Use `defaultPageviewOptions` instead
+   */
+  trackDefaultOptions?: PageViewOptions
+}

package/src/types.ts

@@ -0,0 +1,37 @@
+import type { PropsWithChildren } from 'react'
+
+import type { EventOptions, LoadOptions, PageViewOptions } from 'fathom-client'
+
+export interface FathomClient {
+  blockTrackingForMe: () => void
+  enableTrackingForMe: () => void
+  trackPageview: (opts?: PageViewOptions) => void
+  trackGoal: (code: string, cents: number) => void
+  trackEvent: (eventName: string, opts?: EventOptions) => void
+  setSite: (id: string) => void
+  load: (siteId: string, options?: LoadOptions) => void
+  isTrackingEnabled: () => boolean
+}
+
+export interface FathomContextInterface {
+  blockTrackingForMe?: () => void
+  enableTrackingForMe?: () => void
+  isTrackingEnabled?: () => boolean
+  load?: (siteId: string, options?: LoadOptions) => void
+  setSite?: (siteId: string) => void
+  trackPageview?: (options?: PageViewOptions) => void
+  trackEvent?: (eventName: string, options?: EventOptions) => void
+  trackGoal?: (code: string, cents: number) => void
+  client?: FathomClient
+  defaultPageviewOptions?: PageViewOptions
+  defaultEventOptions?: EventOptions
+}
+
+export interface FathomProviderProps extends PropsWithChildren {
+  client?: FathomClient
+  clientOptions?: LoadOptions
+  siteId?: string
+  disableDefaultTrack?: boolean
+  defaultPageviewOptions?: PageViewOptions
+  defaultEventOptions?: EventOptions
+}

package/types/FathomContext.d.ts

@@ -0,0 +1,3 @@
+import type { FathomContextInterface } from './types';
+export declare const FathomContext: import("react").Context<Partial<FathomContextInterface>>;
+//# sourceMappingURL=FathomContext.d.ts.map

package/types/FathomContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FathomContext.d.ts","sourceRoot":"","sources":["../src/FathomContext.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAA;AAErD,eAAO,MAAM,aAAa,0DAAqD,CAAA"}

package/types/FathomProvider.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+import type { FathomProviderProps } from './types';
+declare const FathomProvider: React.FC<FathomProviderProps>;
+export { FathomProvider };
+//# sourceMappingURL=FathomProvider.d.ts.map

package/types/FathomProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FathomProvider.d.ts","sourceRoot":"","sources":["../src/FathomProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAsD,MAAM,OAAO,CAAA;AAM1E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAElD,QAAA,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,mBAAmB,CA6GjD,CAAA;AAID,OAAO,EAAE,cAAc,EAAE,CAAA"}

package/types/components/TrackClick.d.ts

@@ -0,0 +1,39 @@
+import React from 'react';
+import type { ElementType, MouseEvent, ReactNode } from 'react';
+import type { EventOptions } from 'fathom-client';
+export interface TrackClickProps extends EventOptions {
+    /**
+     * Event name to track
+     */
+    eventName: string;
+    /**
+     * Child element(s) to wrap
+     */
+    children: ReactNode;
+    /**
+     * Whether to prevent default behavior
+     * @default false
+     */
+    preventDefault?: boolean;
+    /**
+     * Custom onClick handler (will be called before tracking)
+     */
+    onClick?: (e: MouseEvent) => void;
+    /**
+     * HTML element to render as wrapper
+     * @default 'div'
+     */
+    as?: ElementType;
+}
+/**
+ * Component wrapper that automatically tracks clicks on its children
+ *
+ * @example
+ * ```tsx
+ * <TrackClick eventName="cta-clicked" id="hero-cta">
+ *   <button>Get Started</button>
+ * </TrackClick>
+ * ```
+ */
+export declare const TrackClick: React.FC<TrackClickProps>;
+//# sourceMappingURL=TrackClick.d.ts.map

package/types/components/TrackClick.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TrackClick.d.ts","sourceRoot":"","sources":["../../src/components/TrackClick.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAA;AACzB,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAE/D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAIjD,MAAM,WAAW,eAAgB,SAAQ,YAAY;IACnD;;OAEG;IACH,SAAS,EAAE,MAAM,CAAA;IACjB;;OAEG;IACH,QAAQ,EAAE,SAAS,CAAA;IACnB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,CAAA;IACjC;;;OAGG;IACH,EAAE,CAAC,EAAE,WAAW,CAAA;CACjB;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU,EAAE,KAAK,CAAC,EAAE,CAAC,eAAe,CAmBhD,CAAA"}

package/types/components/TrackPageview.d.ts

@@ -0,0 +1,21 @@
+import React from 'react';
+import type { ReactNode } from 'react';
+import type { PageViewOptions } from 'fathom-client';
+export interface TrackPageviewProps extends PageViewOptions {
+    /**
+     * Child element(s) to render
+     */
+    children?: ReactNode;
+}
+/**
+ * Component that tracks a pageview when it mounts
+ *
+ * @example
+ * ```tsx
+ * <TrackPageview url="/custom-page">
+ *   <div>Page content</div>
+ * </TrackPageview>
+ * ```
+ */
+export declare const TrackPageview: React.FC<TrackPageviewProps>;
+//# sourceMappingURL=TrackPageview.d.ts.map

package/types/components/TrackPageview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TrackPageview.d.ts","sourceRoot":"","sources":["../../src/components/TrackPageview.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoB,MAAM,OAAO,CAAA;AACxC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAIpD,MAAM,WAAW,kBAAmB,SAAQ,eAAe;IACzD;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAA;CACrB;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CAWtD,CAAA"}

package/types/components/TrackVisible.d.ts

@@ -0,0 +1,39 @@
+import React from 'react';
+import type { ElementType, ReactNode } from 'react';
+import type { EventOptions } from 'fathom-client';
+export interface TrackVisibleProps extends EventOptions {
+    /**
+     * Event name to track
+     */
+    eventName: string;
+    /**
+     * Child element(s) to render
+     */
+    children?: ReactNode;
+    /**
+     * Intersection observer options
+     */
+    observerOptions?: IntersectionObserverInit;
+    /**
+     * Whether to track only once or every time it becomes visible
+     * @default true
+     */
+    trackOnce?: boolean;
+    /**
+     * HTML element to render as wrapper
+     * @default 'div'
+     */
+    as?: ElementType;
+}
+/**
+ * Component that tracks an event when it becomes visible in the viewport
+ *
+ * @example
+ * ```tsx
+ * <TrackVisible eventName="section-viewed" section="hero">
+ *   <HeroSection />
+ * </TrackVisible>
+ * ```
+ */
+export declare const TrackVisible: React.ForwardRefExoticComponent<TrackVisibleProps & React.RefAttributes<HTMLDivElement>>;
+//# sourceMappingURL=TrackVisible.d.ts.map

package/types/components/TrackVisible.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TrackVisible.d.ts","sourceRoot":"","sources":["../../src/components/TrackVisible.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAqD,MAAM,OAAO,CAAA;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAIjD,MAAM,WAAW,iBAAkB,SAAQ,YAAY;IACrD;;OAEG;IACH,SAAS,EAAE,MAAM,CAAA;IACjB;;OAEG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB;;OAEG;IACH,eAAe,CAAC,EAAE,wBAAwB,CAAA;IAC1C;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;;OAGG;IACH,EAAE,CAAC,EAAE,WAAW,CAAA;CACjB;AAED;;;;;;;;;GASG;AACH,eAAO,MAAM,YAAY,0FA8DxB,CAAA"}

package/types/components/index.d.ts

@@ -0,0 +1,4 @@
+export * from './TrackClick';
+export * from './TrackPageview';
+export * from './TrackVisible';
+//# sourceMappingURL=index.d.ts.map

package/types/components/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,gBAAgB,CAAA"}

package/types/hooks/index.d.ts

@@ -0,0 +1,5 @@
+export * from './useFathom';
+export * from './useTrackOnMount';
+export * from './useTrackOnClick';
+export * from './useTrackOnVisible';
+//# sourceMappingURL=index.d.ts.map

package/types/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAC3B,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,qBAAqB,CAAA"}

package/types/hooks/useFathom.d.ts

@@ -0,0 +1,6 @@
+import type { FathomContextInterface } from '../types';
+export declare const useFathom: {
+    (): FathomContextInterface;
+    displayName: string;
+};
+//# sourceMappingURL=useFathom.d.ts.map

package/types/hooks/useFathom.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFathom.d.ts","sourceRoot":"","sources":["../../src/hooks/useFathom.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAA;AAEtD,eAAO,MAAM,SAAS;QAAO,sBAAsB;;CAGlD,CAAA"}

package/types/hooks/useTrackOnClick.d.ts

@@ -0,0 +1,39 @@
+import type { MouseEvent } from 'react';
+import type { EventOptions } from 'fathom-client';
+export interface UseTrackOnClickOptions extends EventOptions {
+    /**
+     * Event name to track
+     */
+    eventName: string;
+    /**
+     * Whether to prevent default behavior
+     * @default false
+     */
+    preventDefault?: boolean;
+    /**
+     * Optional callback function to run after tracking
+     * Receives the click event as a parameter
+     */
+    callback?: (e?: MouseEvent) => void;
+}
+/**
+ * Hook that returns a click handler function that tracks an event
+ *
+ * @example
+ * ```tsx
+ * function Button() {
+ *   const handleClick = useTrackOnClick({
+ *     eventName: 'button-click',
+ *     id: 'signup-button',
+ *     callback: (e) => {
+ *       console.log('Button clicked!')
+ *       // Your custom logic here
+ *     },
+ *   })
+ *
+ *   return <button onClick={handleClick}>Sign Up</button>
+ * }
+ * ```
+ */
+export declare const useTrackOnClick: (options: UseTrackOnClickOptions) => ((e?: MouseEvent) => void);
+//# sourceMappingURL=useTrackOnClick.d.ts.map

package/types/hooks/useTrackOnClick.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTrackOnClick.d.ts","sourceRoot":"","sources":["../../src/hooks/useTrackOnClick.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,OAAO,CAAA;AAEvC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAIjD,MAAM,WAAW,sBAAuB,SAAQ,YAAY;IAC1D;;OAEG;IACH,SAAS,EAAE,MAAM,CAAA;IACjB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,CAAA;CACpC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,eAAe,GAC1B,SAAS,sBAAsB,KAC9B,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,CAmB3B,CAAA"}

package/types/hooks/useTrackOnMount.d.ts

@@ -0,0 +1,14 @@
+import type { PageViewOptions } from 'fathom-client';
+/**
+ * Hook to track a pageview when a component mounts
+ *
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   useTrackOnMount({ url: '/custom-page' })
+ *   return <div>Content</div>
+ * }
+ * ```
+ */
+export declare const useTrackOnMount: (options?: PageViewOptions) => void;
+//# sourceMappingURL=useTrackOnMount.d.ts.map

package/types/hooks/useTrackOnMount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTrackOnMount.d.ts","sourceRoot":"","sources":["../../src/hooks/useTrackOnMount.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAIpD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,GAAI,UAAU,eAAe,SAMxD,CAAA"}

package/types/hooks/useTrackOnVisible.d.ts

@@ -0,0 +1,43 @@
+import type { RefObject } from 'react';
+import type { EventOptions } from 'fathom-client';
+export interface UseTrackOnVisibleOptions extends EventOptions {
+    /**
+     * Event name to track
+     */
+    eventName: string;
+    /**
+     * Intersection observer options
+     */
+    observerOptions?: IntersectionObserverInit;
+    /**
+     * Whether to track only once or every time it becomes visible
+     * @default true
+     */
+    trackOnce?: boolean;
+    /**
+     * Optional callback function to run after tracking
+     * Receives the intersection observer entry as a parameter
+     */
+    callback?: (entry: IntersectionObserverEntry) => void;
+}
+/**
+ * Hook to track an event when an element becomes visible (using Intersection Observer)
+ *
+ * @example
+ * ```tsx
+ * function Section() {
+ *   const ref = useTrackOnVisible({
+ *     eventName: 'section-viewed',
+ *     section: 'hero',
+ *     callback: (entry) => {
+ *       console.log('Section is visible!', entry.isIntersecting)
+ *       // Your custom logic here
+ *     },
+ *   })
+ *
+ *   return <section ref={ref}>Content</section>
+ * }
+ * ```
+ */
+export declare const useTrackOnVisible: (options: UseTrackOnVisibleOptions) => RefObject<HTMLElement | null>;
+//# sourceMappingURL=useTrackOnVisible.d.ts.map

package/types/hooks/useTrackOnVisible.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTrackOnVisible.d.ts","sourceRoot":"","sources":["../../src/hooks/useTrackOnVisible.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AAEtC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAIjD,MAAM,WAAW,wBAAyB,SAAQ,YAAY;IAC5D;;OAEG;IACH,SAAS,EAAE,MAAM,CAAA;IACjB;;OAEG;IACH,eAAe,CAAC,EAAE,wBAAwB,CAAA;IAC1C;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,yBAAyB,KAAK,IAAI,CAAA;CACtD;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,iBAAiB,GAC5B,SAAS,wBAAwB,KAChC,SAAS,CAAC,WAAW,GAAG,IAAI,CAiD9B,CAAA"}

package/types/index.d.ts

@@ -0,0 +1,5 @@
+export * from './FathomContext';
+export * from './FathomProvider';
+export * from './hooks';
+export * from './components';
+//# sourceMappingURL=index.d.ts.map

package/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA;AAChC,cAAc,SAAS,CAAA;AACvB,cAAc,cAAc,CAAA"}

package/types/next/AppRouterProvider.d.ts

@@ -0,0 +1,7 @@
+import React from 'react'
+
+import type { NextFathomProviderProps } from './types'
+
+declare const AppRouterProvider: React.FC<NextFathomProviderProps>
+export { AppRouterProvider }
+//# sourceMappingURL=AppRouterProvider.d.ts.map

package/types/next/AppRouterProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppRouterProvider.d.ts","sourceRoot":"","sources":["../../src/next/AppRouterProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAyC,MAAM,OAAO,CAAA;AAK7D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAA;AAEtD,QAAA,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,uBAAuB,CAqExD,CAAA;AAID,OAAO,EAAE,iBAAiB,EAAE,CAAA"}

package/types/next/NextFathomProvider.d.ts

@@ -0,0 +1,34 @@
+import React from 'react';
+import type { NextFathomProviderProps } from './types';
+export interface NextFathomProviderComponentProps extends NextFathomProviderProps {
+    /**
+     * Router type to use
+     * @default 'app'
+     */
+    router?: 'pages' | 'app';
+    /**
+     * Fallback component to show while loading the router provider
+     * @default null
+     */
+    fallback?: React.ReactNode;
+}
+/**
+ * Unified provider component that conditionally renders the appropriate
+ * Next.js router provider based on the `router` prop.
+ * Providers are dynamically loaded to avoid bundling both router types.
+ *
+ * @example
+ * ```tsx
+ * // App Router (default)
+ * <NextFathomProvider siteId="YOUR_SITE_ID" router="app">
+ *   <App>{children}</App>
+ * </NextFathomProvider>
+ *
+ * // Pages Router
+ * <NextFathomProvider siteId="YOUR_SITE_ID" router="pages">
+ *   <App>{children}</App>
+ * </NextFathomProvider>
+ * ```
+ */
+export declare const NextFathomProvider: React.FC<NextFathomProviderComponentProps>;
+//# sourceMappingURL=NextFathomProvider.d.ts.map

package/types/next/NextFathomProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NextFathomProvider.d.ts","sourceRoot":"","sources":["../../src/next/NextFathomProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkC,MAAM,OAAO,CAAA;AAEtD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAA;AAEtD,MAAM,WAAW,gCAAiC,SAAQ,uBAAuB;IAC/E;;;OAGG;IACH,MAAM,CAAC,EAAE,OAAO,GAAG,KAAK,CAAA;IACxB;;;OAGG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;CAC3B;AAUD;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC,gCAAgC,CAgBzE,CAAA"}

package/types/next/NextFathomProviderApp.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+import type { NextFathomProviderProps } from './types';
+declare const NextFathomProviderApp: React.FC<NextFathomProviderProps>;
+export default NextFathomProviderApp;
+export { NextFathomProviderApp };
+//# sourceMappingURL=NextFathomProviderApp.d.ts.map

package/types/next/NextFathomProviderApp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NextFathomProviderApp.d.ts","sourceRoot":"","sources":["../../src/next/NextFathomProviderApp.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkD,MAAM,OAAO,CAAA;AAOtE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAA;AAGtD,QAAA,MAAM,qBAAqB,EAAE,KAAK,CAAC,EAAE,CAAC,uBAAuB,CA0F5D,CAAA;AAID,eAAe,qBAAqB,CAAA;AACpC,OAAO,EAAE,qBAAqB,EAAE,CAAA"}

package/types/next/NextFathomProviderPages.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+import type { NextFathomProviderProps } from './types';
+declare const NextFathomProviderPages: React.FC<NextFathomProviderProps>;
+export default NextFathomProviderPages;
+export { NextFathomProviderPages };
+//# sourceMappingURL=NextFathomProviderPages.d.ts.map

package/types/next/NextFathomProviderPages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NextFathomProviderPages.d.ts","sourceRoot":"","sources":["../../src/next/NextFathomProviderPages.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkD,MAAM,OAAO,CAAA;AAOtE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAA;AAGtD,QAAA,MAAM,uBAAuB,EAAE,KAAK,CAAC,EAAE,CAAC,uBAAuB,CAgG9D,CAAA;AAID,eAAe,uBAAuB,CAAA;AACtC,OAAO,EAAE,uBAAuB,EAAE,CAAA"}

package/types/next/PagesRouterProvider.d.ts

@@ -0,0 +1,7 @@
+import React from 'react'
+
+import type { NextFathomProviderProps } from './types'
+
+declare const PagesRouterProvider: React.FC<NextFathomProviderProps>
+export { PagesRouterProvider }
+//# sourceMappingURL=PagesRouterProvider.d.ts.map

package/types/next/PagesRouterProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PagesRouterProvider.d.ts","sourceRoot":"","sources":["../../src/next/PagesRouterProvider.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAyC,MAAM,OAAO,CAAA;AAK7D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAA;AAEtD,QAAA,MAAM,mBAAmB,EAAE,KAAK,CAAC,EAAE,CAAC,uBAAuB,CAoF1D,CAAA;AAID,OAAO,EAAE,mBAAmB,EAAE,CAAA"}

package/types/next/compositions/withAppRouter.d.ts

@@ -0,0 +1,29 @@
+import type { ComponentType } from 'react';
+import type { NextFathomProviderProps } from '../types';
+/**
+ * Higher-order component that wraps your Next.js App Router app with FathomProvider
+ *
+ * @example
+ * ```tsx
+ * // app/layout.tsx
+ * import { withAppRouter } from 'react-fathom/next'
+ *
+ * function RootLayout({ children }) {
+ *   return (
+ *     <html>
+ *       <body>{children}</body>
+ *     </html>
+ *   )
+ * }
+ *
+ * export default withAppRouter(RootLayout, {
+ *   siteId: 'YOUR_SITE_ID',
+ *   clientOptions: {
+ *     spa: 'auto',
+ *   },
+ * })
+ * ```
+ */
+declare const withAppRouter: <P extends object>(Component: ComponentType<P>, providerProps?: NextFathomProviderProps) => ComponentType<P>;
+export { withAppRouter };
+//# sourceMappingURL=withAppRouter.d.ts.map

package/types/next/compositions/withAppRouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"withAppRouter.d.ts","sourceRoot":"","sources":["../../../src/next/compositions/withAppRouter.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAG1C,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAA;AAEvD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,QAAA,MAAM,aAAa,GAAI,CAAC,SAAS,MAAM,EACrC,WAAW,aAAa,CAAC,CAAC,CAAC,EAC3B,gBAAgB,uBAAuB,KACtC,aAAa,CAAC,CAAC,CAYjB,CAAA;AAED,OAAO,EAAE,aAAa,EAAE,CAAA"}