/opt/canhelp/node_modules/next/dist/shared/lib
Edit: /opt/canhelp/node_modules/next/dist/shared/lib/utils.d.ts (9201B)
import type { HtmlProps } from './html-context.shared-runtime';
import type { ComponentType, JSX } from 'react';
import type { DomainLocale } from '../../server/config';
import type { Env } from '@next/env';
import type { IncomingMessage, ServerResponse } from 'http';
import type { NextRouter } from './router/router';
import type { ParsedUrlQuery } from 'querystring';
import type { PreviewData } from '../../types';
import type { COMPILER_NAMES } from './constants';
import type fs from 'fs';
export type NextComponentType
= ComponentType & {
/**
* Used for initial page load data population. Data returned from `getInitialProps` is serialized when server rendered.
* Make sure to return plain `Object` without using `Date`, `Map`, `Set`.
* @param context Context of `page`
*/
getInitialProps?(context: Context): InitialProps | Promise;
};
export type DocumentType = NextComponentType;
export type AppType = NextComponentType>;
export type AppTreeType = ComponentType;
/**
* Web vitals provided to _app.reportWebVitals by Core Web Vitals plugin developed by Google Chrome team.
* https://nextjs.org/blog/next-9-4#integrated-web-vitals-reporting
*/
export declare const WEB_VITALS: readonly ["CLS", "FCP", "FID", "INP", "LCP", "TTFB"];
export type NextWebVitalsMetric = {
id: string;
startTime: number;
value: number;
attribution?: {
[key: string]: unknown;
};
} & ({
label: 'web-vital';
name: (typeof WEB_VITALS)[number];
} | {
label: 'custom';
name: 'Next.js-hydration' | 'Next.js-route-change-to-render' | 'Next.js-render';
});
export type Enhancer = (Component: C) => C;
export type ComponentsEnhancer = {
enhanceApp?: Enhancer;
enhanceComponent?: Enhancer;
} | Enhancer;
export type RenderPageResult = {
html: string;
head?: Array;
};
export type RenderPage = (options?: ComponentsEnhancer) => DocumentInitialProps | Promise;
export type BaseContext = {
res?: ServerResponse;
[k: string]: any;
};
export type NEXT_DATA = {
props: Record;
page: string;
query: ParsedUrlQuery;
buildId: string;
assetPrefix?: string;
runtimeConfig?: {
[key: string]: any;
};
nextExport?: boolean;
autoExport?: boolean;
isFallback?: boolean;
isExperimentalCompile?: boolean;
dynamicIds?: (string | number)[];
err?: Error & {
statusCode?: number;
source?: typeof COMPILER_NAMES.server | typeof COMPILER_NAMES.edgeServer;
};
gsp?: boolean;
gssp?: boolean;
customServer?: boolean;
gip?: boolean;
appGip?: boolean;
locale?: string;
locales?: readonly string[];
defaultLocale?: string;
domainLocales?: readonly DomainLocale[];
scriptLoader?: any[];
isPreview?: boolean;
notFoundSrcPage?: string;
};
/**
* `Next` context
*/
export interface NextPageContext {
/**
* Error object if encountered during rendering
*/
err?: (Error & {
statusCode?: number;
}) | null;
/**
* `HTTP` request object.
*/
req?: IncomingMessage;
/**
* `HTTP` response object.
*/
res?: ServerResponse;
/**
* Path section of `URL`.
*/
pathname: string;
/**
* Query string section of `URL` parsed as an object.
*/
query: ParsedUrlQuery;
/**
* `String` of the actual path including query.
*/
asPath?: string;
/**
* The currently active locale
*/
locale?: string;
/**
* All configured locales
*/
locales?: readonly string[];
/**
* The configured default locale
*/
defaultLocale?: string;
/**
* `Component` the tree of the App to use if needing to render separately
*/
AppTree: AppTreeType;
}
export type AppContextType = {
Component: NextComponentType;
AppTree: AppTreeType;
ctx: NextPageContext;
router: Router;
};
export type AppInitialProps = {
pageProps: PageProps;
};
export type AppPropsType = AppInitialProps & {
Component: NextComponentType;
router: Router;
__N_SSG?: boolean;
__N_SSP?: boolean;
};
export type DocumentContext = NextPageContext & {
renderPage: RenderPage;
defaultGetInitialProps(ctx: DocumentContext, options?: {
nonce?: string;
}): Promise;
};
export type DocumentInitialProps = RenderPageResult & {
styles?: React.ReactElement[] | Iterable | JSX.Element;
};
export type DocumentProps = DocumentInitialProps & HtmlProps;
/**
* Next `API` route request
*/
export interface NextApiRequest extends IncomingMessage {
/**
* Object of `query` values from url
*/
query: Partial<{
[key: string]: string | string[];
}>;
/**
* Object of `cookies` from header
*/
cookies: Partial<{
[key: string]: string;
}>;
body: any;
env: Env;
draftMode?: boolean;
preview?: boolean;
/**
* Preview data set on the request, if any
* */
previewData?: PreviewData;
}
/**
* Send body of response
*/
type Send = (body: T) => void;
/**
* Next `API` route response
*/
export type NextApiResponse = ServerResponse & {
/**
* Send data `any` data in response
*/
send: Send;
/**
* Send data `json` data in response
*/
json: Send;
status: (statusCode: number) => NextApiResponse;
redirect(url: string): NextApiResponse;
redirect(status: number, url: string): NextApiResponse;
/**
* Set draft mode
*/
setDraftMode: (options: {
enable: boolean;
}) => NextApiResponse;
/**
* Set preview data for Next.js' prerender mode
*/
setPreviewData: (data: object | string, options?: {
/**
* Specifies the number (in seconds) for the preview session to last for.
* The given number will be converted to an integer by rounding down.
* By default, no maximum age is set and the preview session finishes
* when the client shuts down (browser is closed).
*/
maxAge?: number;
/**
* Specifies the path for the preview session to work under. By default,
* the path is considered the "default path", i.e., any pages under "/".
*/
path?: string;
}) => NextApiResponse;
/**
* Clear preview data for Next.js' prerender mode
*/
clearPreviewData: (options?: {
path?: string;
}) => NextApiResponse;
/**
* Revalidate a specific page and regenerate it using On-Demand Incremental
* Static Regeneration.
* The path should be an actual path, not a rewritten path. E.g. for
* "/blog/[slug]" this should be "/blog/post-1".
* @link https://nextjs.org/docs/app/building-your-application/data-fetching/incremental-static-regeneration#on-demand-revalidation-with-revalidatepath
*/
revalidate: (urlPath: string, opts?: {
unstable_onlyGenerated?: boolean;
}) => Promise;
};
/**
* Next `API` route handler
*/
export type NextApiHandler = (req: NextApiRequest, res: NextApiResponse) => unknown | Promise;
/**
* Utils
*/
export declare function execOnce ReturnType>(fn: T): T;
export declare const isAbsoluteUrl: (url: string) => boolean;
export declare function getLocationOrigin(): string;
export declare function getURL(): string;
export declare function getDisplayName(Component: ComponentType
): string;
export declare function isResSent(res: ServerResponse): boolean;
export declare function normalizeRepeatedSlashes(url: string): string;
export declare function loadGetInitialProps(App: NextComponentType, ctx: C): Promise;
export declare const SP: boolean;
export declare const ST: boolean;
export declare class DecodeError extends Error {
}
export declare class NormalizeError extends Error {
}
export declare class PageNotFoundError extends Error {
code: string;
constructor(page: string);
}
export declare class MissingStaticPage extends Error {
constructor(page: string, message: string);
}
export declare class MiddlewareNotFoundError extends Error {
code: string;
constructor();
}
export interface CacheFs {
existsSync: typeof fs.existsSync;
readFile: typeof fs.promises.readFile;
readFileSync: typeof fs.readFileSync;
writeFile(f: string, d: any): Promise;
mkdir(dir: string): Promise;
stat(f: string): Promise<{
mtime: Date;
}>;
}
export declare function stringifyError(error: Error): string;
export {};