Class ApiConfig

js/botasaurus-server-js/src/api-config.ts:750–995

* Configuration class for API. * Controls API-only mode, port settings, and autostart behavior.

 * Controls API-only mode, port settings, and autostart behavior.
 */
class ApiConfig {
    static apiPort: number = 8000;
    static autoStart: boolean = true;
    static routeSetupFn?: (server: FastifyInstance) => void;
    static apiBasePath: string = ""; // Default empty
    static routeAliases: Map<Function, string[]> = new Map();

    // Kubernetes configuration
    static nodeRole: NodeRole = 'standalone';

    /**
     * Enables API
     * @example
     * ApiConfig.enableApi();
     */
    static enableApi(): void {
        // @ts-ignore
        global.ApiConfig = ApiConfig;
        // @ts-ignore
        global.startServer = startServer;
        // @ts-ignore
        global.stopServer = stopServer;
    }



    /**
     * Enables Kubernetes Master-Worker mode.
     * 
     * This method configures the application for distributed task processing:
     * - If --master flag is passed: Acts as the master node (task distribution)
     * - If --worker flag is passed: Acts as a worker node (task execution)
     * - If neither flag is passed: Acts as normal desktop application (default behavior)
     * 
     * @param {string} masterEndpoint - The master node endpoint (e.g., "http://master-srv:3000")
     * @param {number | Record<string, number>} taskTimeout - Task timeout in seconds. Ideally set it to 2× your max expected task duration.
     *        Can be a single number (applies to all scrapers) or an object mapping scraper names/types to timeouts.
     *        Default: 8 hours (28800 seconds)
     * 
     * @example
     * // Simple usage with default timeout
     * ApiConfig.enableKubernetes("http://master-srv:3000");
     * 
     * @example
     * // Custom timeout for all scrapers
     * ApiConfig.enableKubernetes("http://master-srv:3000", 3600); // 1 hour
     * 
     * @example
     * // Different timeouts per scraper
     * ApiConfig.enableKubernetes("http://master-srv:3000", {
     *   "longRunningScraper": 14400,  // 4 hours
     *   "quickScraper": 1800          // 30 minutes
     * });
     */
    static async enableKubernetes({
        masterEndpoint,
        taskTimeout = DEFAULT_TASK_TIMEOUT
    }: {