@trpc/next/dist/withTRPC-BzqvaIkK.d.mts

The tRPC Next.js library

import { QueryClient } from "@tanstack/react-query";
import { TransformerOptions } from "@trpc/client/unstable-internals";
import { CreateTRPCReactOptions, CreateTRPCReactQueryClientConfig } from "@trpc/react-query/shared";
import { AnyRouter, ResponseMeta, inferClientTypes } from "@trpc/server/unstable-core-do-not-import";
import { CreateTRPCClientOptions, TRPCClient, TRPCClientError, TRPCUntypedClient } from "@trpc/client";
import { NextComponentType, NextPageContext } from "next/dist/shared/lib/utils.js";
//#region src/withTRPC.d.ts
/**
 * What the `config` callback returns: tRPC client options, `QueryClient` options and `abortOnUnmount`.
 *
 * @deprecated part of `createTRPCNext`, which is built on `@trpc/react-query`.
 * @see https://trpc.io/docs/client/nextjs/pages-router/setup#moving-from-createtrpcnext
 */
type WithTRPCConfig<TRouter extends AnyRouter> = CreateTRPCClientOptions<TRouter> & CreateTRPCReactQueryClientConfig & {
  /**
   * Abort pending queries when their component unmounts.
   * @default false
   */
  abortOnUnmount?: boolean;
};
type WithTRPCOptions<TRouter extends AnyRouter> = CreateTRPCReactOptions<TRouter> & {
  /**
   * Returns the client config. Gets the Next.js `ctx` during the SSR
   * prepass; other calls may get no `ctx`.
   * @see https://trpc.io/docs/client/nextjs/pages-router/setup#moving-from-createtrpcnext
   */
  config: (info: {
    ctx?: NextPageContext;
  }) => WithTRPCConfig<TRouter>;
} & TransformerOptions<inferClientTypes<TRouter>>;
/**
 * The type of {@link ssrPrepass}.
 *
 * @deprecated part of `ssr: true`, which is built on `@trpc/react-query`.
 * @see https://trpc.io/docs/client/nextjs/pages-router/ssr
 */
type TRPCPrepassHelper = (opts: {
  parent: WithTRPCSSROptions<AnyRouter>;
  WithTRPC: NextComponentType<any, any, any>;
  AppOrPage: NextComponentType<any, any, any>;
}) => void;
/**
 * Options for `createTRPCNext` and `withTRPC` with SSR on.
 *
 * @deprecated part of `createTRPCNext`, which is built on `@trpc/react-query`.
 * @see https://trpc.io/docs/client/nextjs/pages-router/setup#moving-from-createtrpcnext
 */
type WithTRPCSSROptions<TRouter extends AnyRouter> = WithTRPCOptions<TRouter> & {
  /**
   * If you enable this, you also need to add a `ssrPrepass`-prop
   * @deprecated built on `@trpc/react-query`. Prefetch each page's queries
   * in `getServerSideProps` with `@trpc/tanstack-react-query` instead.
   * @see https://trpc.io/docs/client/nextjs/pages-router/ssr
   */
  ssr: true | ((opts: {
    ctx: NextPageContext;
  }) => boolean | Promise<boolean>);
  /**
   * Sets the status code and headers of the SSR response.
   * @deprecated part of `ssr: true`. Set the status and headers in
   * `getServerSideProps` instead.
   * @see https://trpc.io/docs/client/nextjs/pages-router/ssr#set-the-status-and-cache-headers
   */
  responseMeta?: (opts: {
    ctx: NextPageContext;
    clientErrors: TRPCClientError<TRouter>[];
  }) => ResponseMeta;
  /**
   * use `import { ssrPrepass } from '@trpc/next/ssrPrepass'`
   * @deprecated part of `ssr: true`, which is built on `@trpc/react-query`.
   * @see https://trpc.io/docs/client/nextjs/pages-router/ssr
   */
  ssrPrepass: TRPCPrepassHelper;
};
/**
 * Options for `createTRPCNext` and `withTRPC` with SSR off.
 *
 * @deprecated part of `createTRPCNext`, which is built on `@trpc/react-query`.
 * @see https://trpc.io/docs/client/nextjs/pages-router/setup#moving-from-createtrpcnext
 */
type WithTRPCNoSSROptions<TRouter extends AnyRouter> = WithTRPCOptions<TRouter> & {
  /**
   * @see https://trpc.io/docs/client/nextjs/pages-router/setup#moving-from-createtrpcnext
   */
  ssr?: false;
};
/**
 * The props `ssrPrepass` passes to the wrapped app during the prepass.
 *
 * @deprecated part of `ssr: true`, which is built on `@trpc/react-query`.
 * @see https://trpc.io/docs/client/nextjs/pages-router/ssr
 */
type TRPCPrepassProps<TRouter extends AnyRouter, TSSRContext extends NextPageContext = NextPageContext> = {
  /**
   * The client config from the `config` callback.
   */
  config: WithTRPCConfig<TRouter>;
  /**
   * The `QueryClient` that collects the prefetched queries.
   */
  queryClient: QueryClient;
  /**
   * The tRPC client used during the prepass.
   */
  trpcClient: TRPCUntypedClient<TRouter> | TRPCClient<TRouter>;
  ssrState: 'prepass';
  /**
   * The Next.js page context.
   */
  ssrContext: TSSRContext;
};
/**
 * Wraps a Next.js app or page with the tRPC and TanStack Query providers.
 * `createTRPCNext` returns it, and you wrap your app with it:
 * `export default trpc.withTRPC(MyApp)`.
 *
 * @deprecated built on `@trpc/react-query`, which only gets bug fixes. Mount
 * `TRPCProvider` from `@trpc/tanstack-react-query` in `_app` instead.
 * @see https://trpc.io/docs/client/nextjs/pages-router/setup#moving-from-createtrpcnext
 */
declare function withTRPC<TRouter extends AnyRouter, TSSRContext extends NextPageContext = NextPageContext>(opts: WithTRPCNoSSROptions<TRouter> | WithTRPCSSROptions<TRouter>): (AppOrPage: NextComponentType<any, any, any>) => NextComponentType;
//#endregion
export { WithTRPCSSROptions as a, WithTRPCNoSSROptions as i, TRPCPrepassProps as n, withTRPC as o, WithTRPCConfig as r, TRPCPrepassHelper as t };
//# sourceMappingURL=withTRPC-BzqvaIkK.d.mts.map