[ACA-3821] Add lite-serve with VSCode launcher (#1584)

* Add lite-serve with VSCode launcher

* Make lite-serve smarter to work with Basic authtype as well

* Change and unify app-config-replace script

scripts/clireader/base-param.ts

@@ -0,0 +1,38 @@
+/*
+ * Copyright 2005-2019 Alfresco Software, Ltd. All rights reserved.
+ *
+ * License rights for this program may be obtained from Alfresco Software, Ltd.
+ * pursuant to a written agreement and any use of this program without such an
+ * agreement is prohibited.
+ */
+
+import { ParamType } from './params';
+
+export type CommanderProcessor = (arg1: any, arg2: any) => void;
+export type CommanderOptionParams = [string, string, CommanderProcessor?, any?];
+
+export interface BaseParamOptions {
+  name: string;
+  alias: string;
+  title: string;
+  required: boolean;
+  processor?: CommanderProcessor;
+  default?: any;
+}
+
+export abstract class BaseParam {
+  protected type: ParamType;
+  constructor(protected options: BaseParamOptions) {}
+
+  abstract get commanderOption(): CommanderOptionParams;
+
+  abstract get inquirerOption(): any;
+
+  get isRequired() {
+    return this.options.required;
+  }
+
+  get name() {
+    return this.options.name;
+  }
+}

scripts/clireader/boolean-param.ts

@@ -0,0 +1,40 @@
+/*
+ * Copyright 2005-2019 Alfresco Software, Ltd. All rights reserved.
+ *
+ * License rights for this program may be obtained from Alfresco Software, Ltd.
+ * pursuant to a written agreement and any use of this program without such an
+ * agreement is prohibited.
+ */
+
+import { ParamType } from './params';
+import { BaseParamOptions, CommanderOptionParams, BaseParam } from './base-param';
+
+export class BooleanParam extends BaseParam {
+  protected type = ParamType.confirm;
+
+  get commanderOption(): CommanderOptionParams {
+    const optionParams: CommanderOptionParams = [`-${this.options.alias}, --${this.options.name}`, this.options.title];
+
+    if (this.options.processor !== undefined) {
+      optionParams.push(this.options.processor);
+    } else {
+      optionParams.push((value, previousValue) => {
+        return value !== undefined ? !!value : previousValue;
+      });
+    }
+
+    if (this.options.default !== undefined) {
+      optionParams.push(this.options.default);
+    }
+
+    return optionParams;
+  }
+
+  get inquirerOption() {
+    return {
+      type: this.type,
+      name: this.options.name,
+      message: this.options.title
+    };
+  }
+}

scripts/clireader/checkbox-param.ts

@@ -0,0 +1,58 @@
+/*
+ * Copyright 2005-2019 Alfresco Software, Ltd. All rights reserved.
+ *
+ * License rights for this program may be obtained from Alfresco Software, Ltd.
+ * pursuant to a written agreement and any use of this program without such an
+ * agreement is prohibited.
+ */
+
+import { ParamType } from './params';
+import { BaseParamOptions, CommanderOptionParams, BaseParam } from './base-param';
+
+export interface ComplexCheckboxChoice {
+  name: string;
+  value?: any;
+  checked?: boolean;
+  short?: string;
+}
+
+export interface ChekboxParamOptions extends BaseParamOptions {
+  choices: string[] | ComplexCheckboxChoice[];
+  default?: any[];
+}
+
+export class CheckboxParam extends BaseParam {
+  protected type = ParamType.checkbox;
+
+  constructor(protected options: ChekboxParamOptions) {
+    super(options);
+  }
+
+  get commanderOption(): CommanderOptionParams {
+    const optionParams: CommanderOptionParams = [`-${this.options.alias}, --${this.options.name} <${this.options.name}>`, this.options.title];
+
+    if (this.options.processor !== undefined) {
+      optionParams.push(this.options.processor);
+    } else {
+      optionParams.push((value, previousValue) => {
+        return value !== undefined ? value.split(',') : previousValue;
+      });
+    }
+
+    if (this.options.default !== undefined) {
+      optionParams.push(this.options.default);
+    }
+
+    return optionParams;
+  }
+
+  get inquirerOption() {
+    return {
+      type: this.type,
+      name: this.options.name,
+      message: this.options.title,
+      choices: this.options.choices,
+      default: this.options.default
+    };
+  }
+}

scripts/clireader/cli-reader.ts

@@ -0,0 +1,55 @@
+/*
+ * Copyright 2005-2019 Alfresco Software, Ltd. All rights reserved.
+ *
+ * License rights for this program may be obtained from Alfresco Software, Ltd.
+ * pursuant to a written agreement and any use of this program without such an
+ * agreement is prohibited.
+ */
+
+import commander, { program } from 'commander';
+import * as inquirer from 'inquirer';
+import { BooleanParam } from './boolean-param';
+import { InputParam } from './input-param';
+import { ListParam } from './list-param';
+import { CheckboxParam } from './checkbox-param';
+import * as logger from '../../tools/helpers/logger';
+
+export type CliParam = ListParam | InputParam | BooleanParam | CheckboxParam;
+
+export class CliReader {
+  private program: commander.Command;
+
+  constructor(name: string, usage: string, description: string, version: string) {
+    this.program = program;
+
+    this.program
+      .name(name)
+      .usage(usage)
+      .description(description)
+      .version(version)
+      .option('-d, --debug <level>', 'Set the output information level (silly, debug, verbose, info, warn, error)', 'info');
+  }
+
+  *getReader(params: CliParam[], cliArgs: string[]): Generator {
+    params.forEach((param) => {
+      program.option.apply(this.program, param.commanderOption);
+    });
+    this.program.parse(cliArgs);
+    logger.level = this.program.debug;
+
+    const commanderParams = params
+      .filter((param) => this.program[param.name] !== undefined)
+      .reduce((paramsAcc, param) => ({ ...paramsAcc, [param.name]: this.program[param.name] }), {});
+
+    yield commanderParams;
+
+    let unsetRequiredParams;
+    if (Object.keys(commanderParams).length) {
+      unsetRequiredParams = params.filter((param) => param.isRequired && this.program[param.name] === undefined).map((param) => param.inquirerOption);
+    } else {
+      unsetRequiredParams = params.map((param) => param.inquirerOption);
+    }
+
+    return yield inquirer.prompt(unsetRequiredParams).then((inquiredParams) => ({ ...commanderParams, ...inquiredParams }));
+  }
+}

scripts/clireader/input-param.ts

@@ -0,0 +1,36 @@
+/*
+ * Copyright 2005-2019 Alfresco Software, Ltd. All rights reserved.
+ *
+ * License rights for this program may be obtained from Alfresco Software, Ltd.
+ * pursuant to a written agreement and any use of this program without such an
+ * agreement is prohibited.
+ */
+
+import { ParamType } from './params';
+import { BaseParam, BaseParamOptions, CommanderOptionParams } from './base-param';
+
+export class InputParam extends BaseParam {
+  protected type = ParamType.input;
+
+  get commanderOption(): CommanderOptionParams {
+    const optionParams: CommanderOptionParams = [`-${this.options.alias}, --${this.options.name} <${this.options.name}>`, this.options.title];
+
+    if (this.options.processor !== undefined) {
+      optionParams.push(this.options.processor);
+    }
+
+    if (this.options.default !== undefined) {
+      optionParams.push(this.options.default);
+    }
+
+    return optionParams;
+  }
+
+  get inquirerOption() {
+    return {
+      type: this.type,
+      name: this.options.name,
+      message: this.options.title
+    };
+  }
+}

scripts/clireader/list-param.ts

@@ -0,0 +1,54 @@
+/*
+ * Copyright 2005-2019 Alfresco Software, Ltd. All rights reserved.
+ *
+ * License rights for this program may be obtained from Alfresco Software, Ltd.
+ * pursuant to a written agreement and any use of this program without such an
+ * agreement is prohibited.
+ */
+
+import { ParamType } from './params';
+import { BaseParamOptions, CommanderOptionParams, BaseParam } from './base-param';
+
+export interface ComplexListChoice {
+  name: string;
+  value?: any;
+  disabled?: boolean;
+  short?: string;
+}
+
+export interface ListParamOptions extends BaseParamOptions {
+  choices: string[] | ComplexListChoice[];
+  pageSize?: number;
+}
+
+export class ListParam extends BaseParam {
+  protected type = ParamType.list;
+
+  constructor(protected options: ListParamOptions) {
+    super(options);
+  }
+
+  get commanderOption(): CommanderOptionParams {
+    const optionParams: CommanderOptionParams = [`-${this.options.alias}, --${this.options.name} <${this.options.name}>`, this.options.title];
+
+    if (this.options.processor !== undefined) {
+      optionParams.push(this.options.processor);
+    }
+
+    if (this.options.default !== undefined) {
+      optionParams.push(this.options.default);
+    }
+
+    return optionParams;
+  }
+
+  get inquirerOption() {
+    return {
+      type: this.type,
+      name: this.options.name,
+      message: this.options.title,
+      choices: this.options.choices,
+      pageSize: this.options.pageSize
+    };
+  }
+}

scripts/clireader/params.ts

@@ -0,0 +1,14 @@
+/*
+ * Copyright 2005-2019 Alfresco Software, Ltd. All rights reserved.
+ *
+ * License rights for this program may be obtained from Alfresco Software, Ltd.
+ * pursuant to a written agreement and any use of this program without such an
+ * agreement is prohibited.
+ */
+
+export enum ParamType {
+  input = 'input',
+  list = 'list',
+  checkbox = 'checkbox',
+  confirm = 'confirm'
+}