lcbp3.np-dms.work/frontend/node_modules/next/dist/server/render-result.d.ts

import type { OutgoingHttpHeaders, ServerResponse } from 'http';
import type { CacheControl } from './lib/cache-control';
import type { FetchMetrics } from './base-http';
import type { RenderResumeDataCache } from './resume-data-cache/resume-data-cache';
import type { HTML_CONTENT_TYPE_HEADER, JSON_CONTENT_TYPE_HEADER, TEXT_PLAIN_CONTENT_TYPE_HEADER } from '../lib/constants';
import type { RSC_CONTENT_TYPE_HEADER } from '../client/components/app-router-headers';
type ContentTypeOption = typeof RSC_CONTENT_TYPE_HEADER | typeof HTML_CONTENT_TYPE_HEADER | typeof JSON_CONTENT_TYPE_HEADER | typeof TEXT_PLAIN_CONTENT_TYPE_HEADER;
export type AppPageRenderResultMetadata = {
    flightData?: Buffer;
    cacheControl?: CacheControl;
    staticBailoutInfo?: {
        stack?: string;
        description?: string;
    };
    /**
     * The postponed state if the render had postponed and needs to be resumed.
     */
    postponed?: string;
    /**
     * The headers to set on the response that were added by the render.
     */
    headers?: OutgoingHttpHeaders;
    statusCode?: number;
    fetchTags?: string;
    fetchMetrics?: FetchMetrics;
    segmentData?: Map<string, Buffer>;
    /**
     * In development, the resume data cache is warmed up before the render. This
     * is attached to the metadata so that it can be used during the render. When
     * prerendering, the filled resume data cache is also attached to the metadata
     * so that it can be used when prerendering matching fallback shells.
     */
    renderResumeDataCache?: RenderResumeDataCache;
};
export type PagesRenderResultMetadata = {
    pageData?: any;
    cacheControl?: CacheControl;
    assetQueryString?: string;
    isNotFound?: boolean;
    isRedirect?: boolean;
};
export type StaticRenderResultMetadata = {};
export type RenderResultMetadata = AppPageRenderResultMetadata & PagesRenderResultMetadata & StaticRenderResultMetadata;
export type RenderResultResponse = ReadableStream<Uint8Array>[] | ReadableStream<Uint8Array> | string | Buffer | null;
export type RenderResultOptions<Metadata extends RenderResultMetadata = RenderResultMetadata> = {
    contentType: ContentTypeOption | null;
    waitUntil?: Promise<unknown>;
    metadata: Metadata;
};
export default class RenderResult<Metadata extends RenderResultMetadata = RenderResultMetadata> {
    /**
     * The detected content type for the response. This is used to set the
     * `Content-Type` header.
     */
    readonly contentType: ContentTypeOption | null;
    /**
     * The metadata for the response. This is used to set the revalidation times
     * and other metadata.
     */
    readonly metadata: Readonly<Metadata>;
    /**
     * The response itself. This can be a string, a stream, or null. If it's a
     * string, then it's a static response. If it's a stream, then it's a
     * dynamic response. If it's null, then the response was not found or was
     * already sent.
     */
    private response;
    /**
     * A render result that represents an empty response. This is used to
     * represent a response that was not found or was already sent.
     */
    static readonly EMPTY: RenderResult<StaticRenderResultMetadata>;
    /**
     * Creates a new RenderResult instance from a static response.
     *
     * @param value the static response value
     * @param contentType the content type of the response
     * @returns a new RenderResult instance
     */
    static fromStatic(value: string | Buffer, contentType: ContentTypeOption): RenderResult<StaticRenderResultMetadata>;
    private readonly waitUntil?;
    constructor(response: RenderResultResponse, { contentType, waitUntil, metadata }: RenderResultOptions<Metadata>);
    assignMetadata(metadata: Metadata): void;
    /**
     * Returns true if the response is null. It can be null if the response was
     * not found or was already sent.
     */
    get isNull(): boolean;
    /**
     * Returns false if the response is a string. It can be a string if the page
     * was prerendered. If it's not, then it was generated dynamically.
     */
    get isDynamic(): boolean;
    /**
     * Returns the response if it is a string. If the page was dynamic, this will
     * return a promise if the `stream` option is true, or it will throw an error.
     *
     * @param stream Whether or not to return a promise if the response is dynamic
     * @returns The response as a string
     */
    toUnchunkedString(stream?: false): string;
    toUnchunkedString(stream: true): Promise<string>;
    /**
     * Returns a readable stream of the response.
     */
    private get readable();
    /**
     * Coerces the response to an array of streams. This will convert the response
     * to an array of streams if it is not already one.
     *
     * @returns An array of streams
     */
    private coerce;
    /**
     * Unshifts a new stream to the response. This will convert the response to an
     * array of streams if it is not already one and will add the new stream to
     * the start of the array. When this response is piped, all of the streams
     * will be piped one after the other.
     *
     * @param readable The new stream to unshift
     */
    unshift(readable: ReadableStream<Uint8Array>): void;
    /**
     * Chains a new stream to the response. This will convert the response to an
     * array of streams if it is not already one and will add the new stream to
     * the end. When this response is piped, all of the streams will be piped
     * one after the other.
     *
     * @param readable The new stream to chain
     */
    push(readable: ReadableStream<Uint8Array>): void;
    /**
     * Pipes the response to a writable stream. This will close/cancel the
     * writable stream if an error is encountered. If this doesn't throw, then
     * the writable stream will be closed or aborted.
     *
     * @param writable Writable stream to pipe the response to
     */
    pipeTo(writable: WritableStream<Uint8Array>): Promise<void>;
    /**
     * Pipes the response to a node response. This will close/cancel the node
     * response if an error is encountered.
     *
     * @param res
     */
    pipeToNodeResponse(res: ServerResponse): Promise<void>;
}
export {};