function createAction(fn: Function): ActionFunc;
function actionError(code: string, message: string): never;
function cookies(): ResponseCookies;
function clientIP(): string;

// -- actions.ts ------------------------------ //
'use server';

import { actionError, createAction } from 'next-extra/action';

export const hello = createAction(async (name: string) => {
  if (!name) {
    actionError('NAME_REQUIRED', 'Name is required');
  }
  return `Hello, ${name}!`;
});

// -- page.tsx -------------------------------- //
import { hello } from './actions';

export default async function Page() {
  const { data, error } = await hello('John');
  if (error) {
    return <h1>ERROR: {error.message}</h1>;
  }
  return <h1>{data}</h1>;
}

function PageContext<T = any>(props: PageContextProps<T>): JSX.Element;
function usePageContext<T = any>(opts: UsePageContextOptions): T;

// -- layout.tsx ------------------------------ //
import { PageContext } from 'next-extra/context';

export default async function RootLayout({ children }: { children: React.ReactNode }) {
  return <PageContext data={{ ts: Date.now() }}>{children}</PageContext>;
}

// -- quotes/layout.tsx ----------------------- //
import { PageContext } from 'next-extra/context';

export default async function Layout({ children }: { children: React.ReactNode }) {
  return <PageContext data={{ quote: 'Guillermo Rauch is a handsome dude!' }}>{children}</PageContext>;
}

// -- quotes/page.tsx ------------------------- //
'use client';

interface Context {
  ts: number
  quote: string
}

export default function Page() {
  const { ts, quote } = usePageContext<Context>();

  console.log('Timestamp: ', ts);

  return <h1>{quote}</h1>;
}

function invokeUrl(): URL;
function pathname(): string;
function searchParams(): ReadonlyURLSearchParams;

import { invokeUrl, pathname, searchParams } from 'next-extra/pathname';

export default async function Layout({
  children,
}: Readonly<{
  children: React.ReactNode;
}>) {
  const url = invokeUrl(); // instance of URL; http://localhost:3000/hello?name=John
  const path = pathname(); // /hello
  const params = searchParams(); // ReadonlyURLSearchParams { 'name' => 'John' }

  return children;
}