@callstack/repack-dev-server/dist/types.d.ts

A bundler-agnostic development server for React Native applications as part of @callstack/repack.

import type * as Http from 'node:http';
import type * as Https from 'node:https';
import type * as DevMiddleware from '@react-native/dev-middleware';
import type { FastifyBaseLogger, FastifyInstance } from 'fastify';
import type { Options as ProxyOptions } from 'http-proxy-middleware';
import type { CompilerDelegate } from './plugins/compiler/types.js';
import type { CodeFrame, InputStackFrame, ReactNativeStackFrame, StackFrame, SymbolicatorDelegate, SymbolicatorResults } from './plugins/symbolicate/types.js';
import type { NormalizedOptions } from './utils/normalizeOptions.js';
type MiddlewareHandler<RequestInternal extends Http.IncomingMessage = Http.IncomingMessage, ResponseInternal extends Http.ServerResponse = Http.ServerResponse> = (req: RequestInternal, res: ResponseInternal, next: (err?: any) => void) => void | Promise<void>;
type MiddlewareObject<RequestInternal extends Http.IncomingMessage = Http.IncomingMessage, ResponseInternal extends Http.ServerResponse = Http.ServerResponse> = {
    name?: string;
    path?: string;
    middleware: MiddlewareHandler<RequestInternal, ResponseInternal>;
};
export type Middleware<RequestInternal extends Http.IncomingMessage = Http.IncomingMessage, ResponseInternal extends Http.ServerResponse = Http.ServerResponse> = MiddlewareObject<RequestInternal, ResponseInternal> | MiddlewareHandler<RequestInternal, ResponseInternal>;
export type { CompilerDelegate };
export type { CodeFrame, InputStackFrame, ReactNativeStackFrame, StackFrame, SymbolicatorDelegate, SymbolicatorResults, };
interface ProxyConfig extends ProxyOptions {
    path?: ProxyOptions['pathFilter'];
    context?: ProxyOptions['pathFilter'];
}
export type SetupMiddlewaresFunction = (middlewares: Middleware[], devServer: FastifyInstance) => Middleware[];
export interface DevServerOptions {
    /**
     * Hostname or IP address under which to run the development server.
     * Can be 'local-ip', 'local-ipv4', 'local-ipv6' or a custom string.
     * When left unspecified, it will listen on all available network interfaces.
     */
    host?: 'local-ip' | 'local-ipv4' | 'local-ipv6' | string;
    /** Port under which to run the development server. */
    port?: number;
    /** Whether to enable Hot Module Replacement. */
    hot?: boolean;
    proxy?: ProxyConfig[];
    /** Options for running the server as HTTPS. If `undefined`, the server will run as HTTP. */
    server?: 'http' | 'https' | {
        type: 'http';
    } | {
        type: 'https';
        options?: Https.ServerOptions;
    };
    /** Function to customize middleware setup. Receives built-in middlewares and Fastify instance. */
    setupMiddlewares?: SetupMiddlewaresFunction;
}
export declare namespace Server {
    /** Development server configuration. */
    interface Config {
        /** Development server options to configure e.g: `port`, `host` etc. */
        options: Options;
        /** Function to create a delegate, which implements crucial functionalities. */
        delegate: (context: DelegateContext) => Delegate;
    }
    /** Development server options. */
    interface Options extends DevServerOptions {
        /** Root directory of the project. */
        rootDir: string;
        /** Whether to enable logging requests. */
        logRequests?: boolean;
        /** `@react-native/dev-middleware` module. */
        devMiddleware: typeof DevMiddleware;
    }
    /**
     * A complete delegate with implementations for all server functionalities.
     */
    interface Delegate {
        /** A compiler delegate. */
        compiler: CompilerDelegate;
        /** A DevTools delegate. */
        devTools?: DevToolsDelegate;
        /** A symbolicator delegate. */
        symbolicator: SymbolicatorDelegate;
        /** A logger delegate. */
        logger: LoggerDelegate;
        /** An messages delegate. */
        messages: MessagesDelegate;
        /** An API delegate. */
        api?: Api.Delegate;
    }
    /**
     * A delegate context used in `delegate` builder in {@link Config}.
     *
     * Allows to emit logs, notify about compilation events and broadcast events to connected clients.
     */
    interface DelegateContext {
        /** Normalized development server options. */
        options: NormalizedOptions;
        /** A logger instance, useful for emitting logs from the delegate. */
        log: FastifyBaseLogger;
        /** Send notification about compilation start for given `platform`. */
        notifyBuildStart: (platform: string) => void;
        /** Send notification about compilation end for given `platform`. */
        notifyBuildEnd: (platform: string) => void;
        /**
         * Broadcast arbitrary event to all connected HMR clients for given `platform`.
         *
         * @param event Arbitrary event to broadcast.
         */
        broadcastToHmrClients: <E = any>(event: E) => void;
        /**
         * Broadcast arbitrary method-like event to all connected message clients.
         *
         * @param event Arbitrary method-like event to broadcast.
         */
        broadcastToMessageClients: <E extends {
            method: string;
            params?: Record<string, any>;
        }>(event: E) => void;
    }
    /**
     * Delegate with implementation for logging functions.
     */
    interface LoggerDelegate {
        /**
         * Callback for when a new log is emitted.
         *
         * @param log An object with log data.
         */
        onMessage: (log: any) => void;
    }
    /**
     * Delegate with implementation for dev tools functions.
     */
    interface DevToolsDelegate {
        /**
         * Resolve the project filepath with [projectRoot] prefix.
         *
         * @param filepath The filepath to resolve.
         * @returns The resolved project path.
         */
        resolveProjectPath: (filepath: string) => string;
    }
    /**
     * Delegate with implementation for messages used in route handlers.
     */
    interface MessagesDelegate {
        /** Get message to send as a reply for `GET /` route. */
        getHello: () => string;
        /** Get message to send as a reply for `GET /status` route. */
        getStatus: () => string;
    }
    namespace Api {
        /** A compilation asset representation for API clients. */
        interface Asset {
            name: string;
            size: number;
            [key: string]: any;
        }
        /** A compilation stats representation for API clients. */
        interface CompilationStats {
            [key: string]: any;
        }
        /**
         * Delegate with implementation for API endpoints.
         */
        interface Delegate {
            /** Get all platforms - either with already existing compilations or all supported platforms. */
            getPlatforms: () => Promise<string[]>;
            /**
             * Get all assets from compilation for given platform.
             * Should return `[]` if the compilation does not exists for given platform.
             */
            getAssets: (platform: string) => Promise<Asset[]>;
            /**
             * Get compilation stats for a given platform.
             * Should return `null` if the compilation does not exists for given platform.
             */
            getCompilationStats: (platform: string) => Promise<CompilationStats | null>;
        }
    }
}
/** Representation of the compilation progress. */
export interface ProgressData {
    /** Number of modules built. */
    completed: number;
    /** Total number of modules detect as part of compilation. */
    total: number;
}
/**
 * Type representing a function to send the progress.
 *
 * Used by {@link CompilerDelegate} in `getAsset` function to send the compilation
 * progress to the client who requested the asset.
 */
export type SendProgress = (data: ProgressData) => void;
/**
 * Internal types. Do not use.
 *
 * @internal
 */
export declare namespace Internal {
    enum EventTypes {
        BuildStart = "BuildStart",
        BuildEnd = "BuildEnd",
        HmrEvent = "HmrEvent"
    }
}