CommunitySolidServer/src/init/CliRunner.ts

import * as path from 'path';
import type { ReadStream, WriteStream } from 'tty';
import type { LoaderProperties } from 'componentsjs';
import { Loader } from 'componentsjs';
import yargs from 'yargs';
import { ensureTrailingSlash } from '../util/PathUtil';
import type { Initializer } from './Initializer';

/**
 * Generic run function for starting the server from a given config
 * @param args - Command line arguments.
 * @param stderr - Standard error stream.
 * @param properties - Components loader properties.
 */
export const runCli = function({
  argv = process.argv,
  stderr = process.stderr,
  properties = {
    mainModulePath: path.join(__dirname, '../../'),
  },
}: {
  argv?: string[];
  stdin?: ReadStream;
  stdout?: WriteStream;
  stderr?: WriteStream;
  properties?: LoaderProperties;
} = {}): void {
  const { argv: params } = yargs(argv.slice(2))
    .usage('node ./bin/server.js [args]')
    .options({
      baseUrl: { type: 'string', alias: 'b' },
      config: { type: 'string', alias: 'c' },
      loggingLevel: { type: 'string', alias: 'l', default: 'info' },
      port: { type: 'number', alias: 'p', default: 3000 },
      rootFilePath: { type: 'string', alias: 'f' },
      sparqlEndpoint: { type: 'string', alias: 's' },
      podTemplateFolder: { type: 'string', alias: 't' },
    })
    .help();

  (async(): Promise<void> => {
    // Load provided or default config file
    const configPath = params.config ?
      path.join(process.cwd(), params.config) :
      path.join(__dirname, '/../../config/config-default.json');

    // Setup from config file
    const loader = new Loader(properties);
    await loader.registerAvailableModuleResources();
    const initializer: Initializer = await loader
      .instantiateFromUrl('urn:solid-server:default:Initializer', configPath, undefined, {
        variables: {
          'urn:solid-server:default:variable:baseUrl':
            params.baseUrl ? ensureTrailingSlash(params.baseUrl) : `http://localhost:${params.port}/`,
          'urn:solid-server:default:variable:loggingLevel': params.loggingLevel,
          'urn:solid-server:default:variable:port': params.port,
          'urn:solid-server:default:variable:rootFilePath': params.rootFilePath ?? process.cwd(),
          'urn:solid-server:default:variable:sparqlEndpoint': params.sparqlEndpoint,
          'urn:solid-server:default:variable:podTemplateFolder':
            params.podTemplateFolder ?? path.join(__dirname, '../../templates'),
        },
      }) as Initializer;
    await initializer.handleSafe();
  })().catch((error): void => {
    // This is the only time we can *not* use the logger to print error messages, as dependency injection has failed.
    stderr.write(`${error}\n`);
  });
};