@rsdk/cli.core 4.3.1-next.1

package/CHANGELOG.md

@@ -0,0 +1,8 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+## [4.3.1-next.1](https://github.com/R-Vision/rsdk/compare/v4.3.1-next.0...v4.3.1-next.1) (2024-03-25)
+
+**Note:** Version bump only for package @rsdk/cli.core

package/README.MD

@@ -0,0 +1,15 @@
+# Cli
+
+Лаунчер для rsdk команд
+
+## Concepts
+
+При вызове `rsdk <command>` лаунчер попытается найти пакет соответствующий этой команде (алгоритм поиска описан ниже) и/или предложит его установить, после чего делегирует обработку команды этому пакету.
+
+## Алгоритм поиска пакета
+
+Из названия команды берется первая подстрока до двоеточия - `:`, этот фрагмент команды используется в названии команды `@rsdk/cli.cmd.<trimmed>`
+
+## Интерфейс взаимодействия
+
+Основной интерфейс взаимодействия с пакетом команды обеспечивается через `RsdkCliCommand` из пакета `@rsdk/cli.common`

package/TODO.MD

@@ -0,0 +1,5 @@
+# To do
+
+[ ] list all installed commands
+[ ] list all available commands (maybe over npm view + default commands from rsdk packages)
+[ ] installing cmd.* packages different version, not only the same as `@rsdk/cli` package

package/dist/cli.d.ts

@@ -0,0 +1,22 @@
+import type { ResolveResult } from '@parcel/package-manager/lib/types';
+import type { RsdkCliCommand } from '@rsdk/cli.common';
+export declare class Cli {
+    readonly opts?: {
+        plugins?: (string | {
+            command: RsdkCliCommand;
+            cmd: string;
+        })[];
+        discoverPlugins?: boolean;
+    } | undefined;
+    constructor(opts?: {
+        plugins?: (string | {
+            command: RsdkCliCommand;
+            cmd: string;
+        })[];
+        discoverPlugins?: boolean;
+    } | undefined);
+    installCmdPackage(cmdPackage: string): Promise<void>;
+    resolveCmdPackage(cmdPackage: string): Promise<ResolveResult>;
+    getRsdkCommand(cmd: string): Promise<RsdkCliCommand | undefined>;
+    handle(argv: string[]): Promise<void>;
+}

package/dist/cli.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Cli = void 0;
+const fs_1 = require("@parcel/fs");
+const package_manager_1 = require("@parcel/package-manager");
+const commander_1 = require("commander");
+const enquirer_1 = require("enquirer");
+const node_path_1 = require("node:path");
+const exception_1 = require("./exception");
+const package_loader_1 = require("./package.loader");
+class Cli {
+    opts;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    async installCmdPackage(cmdPackage) {
+        const packageManager = new package_manager_1.NodePackageManager(new fs_1.NodeFS(), (0, node_path_1.resolve)());
+        await package_loader_1.PackageLoader.installPackage(packageManager, cmdPackage);
+    }
+    async resolveCmdPackage(cmdPackage) {
+        const packageManager = new package_manager_1.NodePackageManager(new fs_1.NodeFS(), (0, node_path_1.resolve)());
+        return await packageManager.resolve(cmdPackage, (0, node_path_1.resolve)(), null);
+    }
+    async getRsdkCommand(cmd) {
+        const cmdPackage = '@rsdk/cli.cmd.' + cmd;
+        try {
+            const resolvedPackage = await this.resolveCmdPackage(cmdPackage);
+            return package_loader_1.PackageLoader.getEntry(resolvedPackage.resolved);
+        }
+        catch (error) {
+            if (!(error instanceof Error)) {
+                throw error;
+            }
+            if (this.opts?.discoverPlugins === false) {
+                throw error;
+            }
+            const response = await (0, enquirer_1.prompt)({
+                type: 'confirm',
+                name: 'isInstall',
+                message: 'Install ' + cmdPackage + ' package?',
+                initial: true,
+            });
+            if (!response.isInstall) {
+                console.log('Install was aborted');
+                return;
+            }
+            try {
+                await this.installCmdPackage(cmdPackage);
+            }
+            catch (error) {
+                if (!(error instanceof Error)) {
+                    throw error;
+                }
+                exception_1.FailedToInstall.assertError(error, cmdPackage);
+                throw error;
+            }
+            const resolvedPackage = await this.resolveCmdPackage(cmdPackage);
+            return package_loader_1.PackageLoader.getEntry(resolvedPackage.resolved);
+        }
+    }
+    async handle(argv) {
+        const rsdkCommand = argv.slice(2)[0];
+        if (!rsdkCommand || rsdkCommand.startsWith('-')) {
+            commander_1.program.parse();
+            return;
+        }
+        const cmd = rsdkCommand.split(':')[0];
+        const rsdkCliCommand = await this.getRsdkCommand(cmd);
+        if (!rsdkCliCommand) {
+            throw new Error('rsdk cli command not found');
+        }
+        const cmds = rsdkCliCommand.getCommands();
+        for (const cmd of cmds) {
+            commander_1.program.addCommand(cmd);
+        }
+        commander_1.program.parse();
+    }
+}
+exports.Cli = Cli;
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/exception.d.ts

@@ -0,0 +1,4 @@
+export declare class FailedToInstall extends Error {
+    constructor(packageName: string, cause?: any);
+    static assertError(error: Error, packageName: string): void;
+}

package/dist/exception.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FailedToInstall = void 0;
+class FailedToInstall extends Error {
+    constructor(packageName, cause) {
+        super('Failed to install ' + packageName, {
+            cause: {
+                packageName,
+                cause,
+            },
+        });
+        this.name = this.constructor.name;
+    }
+    static assertError(error, packageName) {
+        const isFailedToInstall = error.message.startsWith('Failed to install');
+        if (isFailedToInstall) {
+            throw new FailedToInstall(packageName, error);
+        }
+    }
+}
+exports.FailedToInstall = FailedToInstall;
+//# sourceMappingURL=exception.js.map

package/dist/exception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exception.js","sourceRoot":"","sources":["../src/exception.ts"],"names":[],"mappings":";;;AAAA,MAAa,eAAgB,SAAQ,KAAK;IACxC,YAAY,WAAmB,EAAE,KAAW;QAC1C,KAAK,CAAC,oBAAoB,GAAG,WAAW,EAAE;YACxC,KAAK,EAAE;gBACL,WAAW;gBACX,KAAK;aACN;SACF,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;IACpC,CAAC;IAED,MAAM,CAAC,WAAW,CAAC,KAAY,EAAE,WAAmB;QAClD,MAAM,iBAAiB,GAAI,KAAK,CAAC,OAAkB,CAAC,UAAU,CAC5D,mBAAmB,CACpB,CAAC;QACF,IAAI,iBAAiB,EAAE,CAAC;YACtB,MAAM,IAAI,eAAe,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;QAChD,CAAC;IACH,CAAC;CACF;AAnBD,0CAmBC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+import type { RsdkCliCommand } from '@rsdk/cli.common';
+import './reconfigure-logger';
+export declare const execute: (opts?: {
+    plugins?: (string | {
+        command: RsdkCliCommand;
+        cmd: string;
+    })[];
+    discoverPlugins?: boolean;
+}) => Promise<void>;

package/dist/index.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.execute = void 0;
+require("./reconfigure-logger");
+const cli_1 = require("./cli");
+// TODO: сделать более понятным, переиспользуемым, консистентным и контролируем
+process.env.RSDK_CLI_MODE = 'true';
+process.title = 'rsdk';
+const execute = async (opts) => {
+    await new cli_1.Cli(opts).handle(process.argv);
+};
+exports.execute = execute;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAEA,gCAA8B;AAE9B,+BAA4B;AAE5B,+EAA+E;AAC/E,OAAO,CAAC,GAAG,CAAC,aAAa,GAAG,MAAM,CAAC;AAEnC,OAAO,CAAC,KAAK,GAAG,MAAM,CAAC;AAChB,MAAM,OAAO,GAAG,KAAK,EAAE,IAG7B,EAAiB,EAAE;IAClB,MAAM,IAAI,SAAG,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAC3C,CAAC,CAAC;AALW,QAAA,OAAO,WAKlB"}

package/dist/package.loader.d.ts

@@ -0,0 +1,6 @@
+import type { PackageManager } from '@parcel/package-manager';
+import type { RsdkCliCommand } from '@rsdk/cli.common';
+export declare class PackageLoader {
+    static getEntry(cmdPackageName: string): RsdkCliCommand;
+    static installPackage(packageManager: PackageManager, cmdPackage: string): Promise<void>;
+}

package/dist/package.loader.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PackageLoader = void 0;
+const node_path_1 = require("node:path");
+class PackageLoader {
+    static getEntry(cmdPackageName) {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        return require(cmdPackageName).Cmd;
+    }
+    static async installPackage(packageManager, cmdPackage) {
+        const cliPackageJsonPath = require.resolve('../package.json', {
+            paths: [__dirname],
+        });
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const cliPackageJson = require(cliPackageJsonPath);
+        // @ts-expect-error not declared method
+        await packageManager.install([
+            {
+                name: cmdPackage,
+                semVer: cliPackageJson.version,
+            },
+        ], (0, node_path_1.resolve)(''), {
+            saveDev: true,
+        });
+    }
+}
+exports.PackageLoader = PackageLoader;
+//# sourceMappingURL=package.loader.js.map

package/dist/package.loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package.loader.js","sourceRoot":"","sources":["../src/package.loader.ts"],"names":[],"mappings":";;;AAEA,yCAAoC;AAEpC,MAAa,aAAa;IACxB,MAAM,CAAC,QAAQ,CAAC,cAAsB;QACpC,8DAA8D;QAC9D,OAAO,OAAO,CAAC,cAAc,CAAC,CAAC,GAAG,CAAC;IACrC,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,cAAc,CACzB,cAA8B,EAC9B,UAAkB;QAElB,MAAM,kBAAkB,GAAW,OAAO,CAAC,OAAO,CAAC,iBAAiB,EAAE;YACpE,KAAK,EAAE,CAAC,SAAS,CAAC;SACnB,CAAC,CAAC;QAEH,8DAA8D;QAC9D,MAAM,cAAc,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;QAEnD,uCAAuC;QACvC,MAAM,cAAc,CAAC,OAAO,CAC1B;YACE;gBACE,IAAI,EAAE,UAAU;gBAChB,MAAM,EAAE,cAAc,CAAC,OAAO;aAC/B;SACF,EACD,IAAA,mBAAO,EAAC,EAAE,CAAC,EACX;YACE,OAAO,EAAE,IAAI;SACd,CACF,CAAC;IACJ,CAAC;CACF;AA/BD,sCA+BC"}

package/dist/reconfigure-logger.d.ts

@@ -0,0 +1,5 @@
+/**
+ * TODO: написать корректную работу с логгером, с учетом того что она может (уже используется вне DI) и может аффектить tracing
+ */
+import { LogLevel } from '@rsdk/logging';
+export declare const logLevelFromEnv: LogLevel | undefined;

package/dist/reconfigure-logger.js

@@ -0,0 +1,12 @@
+"use strict";
+/**
+ * TODO: написать корректную работу с логгером, с учетом того что она может (уже используется вне DI) и может аффектить tracing
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logLevelFromEnv = void 0;
+const logging_1 = require("@rsdk/logging");
+exports.logLevelFromEnv = logging_1.LogLevel[(process.env.LOG_LEVEL ?? 'info')];
+logging_1.LoggerFactory.reconfigure({
+    level: exports.logLevelFromEnv ?? logging_1.LogLevel.info,
+});
+//# sourceMappingURL=reconfigure-logger.js.map

package/dist/reconfigure-logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconfigure-logger.js","sourceRoot":"","sources":["../src/reconfigure-logger.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,2CAAwD;AAE3C,QAAA,eAAe,GAAG,kBAAQ,CACrC,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM,CAAa,CACtB,CAAC;AAE1B,uBAAa,CAAC,WAAW,CAAC;IACxB,KAAK,EAAE,uBAAe,IAAI,kBAAQ,CAAC,IAAI;CACxC,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@rsdk/cli.core",
+  "version": "4.3.1-next.1",
+  "description": "entry package to cli functions",
+  "main": "dist/index.js",
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "rsdk",
+    "cli"
+  ],
+  "license": "Apache License 2.0",
+  "dependencies": {
+    "@parcel/core": "^2.11.0",
+    "@parcel/fs": "^2.11.0",
+    "@parcel/package-manager": "^2.11.0",
+    "@sinclair/typebox": "^0.32.13",
+    "commander": "^12.0.0",
+    "dotenv": "^16.3.1",
+    "enquirer": "^2.4.1",
+    "kafkajs": "^2.2.4",
+    "listr2": "^6.6.1",
+    "yaml": "^2.3.1"
+  },
+  "peerDependencies": {
+    "@rsdk/cli.cmd.kafka": "^4.3.1-next.1",
+    "@rsdk/cli.common": "^4.3.1-next.1",
+    "@rsdk/logging": "^4.3.1-next.1"
+  },
+  "gitHead": "79ad5e9c5f25719390d866add5ef49c5f513485c"
+}

package/src/cli.ts

@@ -0,0 +1,94 @@
+import { NodeFS } from '@parcel/fs';
+import { NodePackageManager } from '@parcel/package-manager';
+import type { ResolveResult } from '@parcel/package-manager/lib/types';
+import type { RsdkCliCommand } from '@rsdk/cli.common';
+import { program } from 'commander';
+import { prompt } from 'enquirer';
+import { resolve } from 'node:path';
+
+import { FailedToInstall } from './exception';
+import { PackageLoader } from './package.loader';
+
+export class Cli {
+  constructor(
+    readonly opts?: {
+      plugins?: (string | { command: RsdkCliCommand; cmd: string })[];
+      discoverPlugins?: boolean;
+    },
+  ) {}
+
+  async installCmdPackage(cmdPackage: string): Promise<void> {
+    const packageManager = new NodePackageManager(new NodeFS(), resolve());
+
+    await PackageLoader.installPackage(packageManager, cmdPackage);
+  }
+
+  async resolveCmdPackage(cmdPackage: string): Promise<ResolveResult> {
+    const packageManager = new NodePackageManager(new NodeFS(), resolve());
+
+    return await packageManager.resolve(cmdPackage, resolve(), null);
+  }
+
+  async getRsdkCommand(cmd: string): Promise<RsdkCliCommand | undefined> {
+    const cmdPackage = '@rsdk/cli.cmd.' + cmd;
+
+    try {
+      const resolvedPackage = await this.resolveCmdPackage(cmdPackage);
+
+      return PackageLoader.getEntry(resolvedPackage.resolved);
+    } catch (error) {
+      if (!(error instanceof Error)) {
+        throw error;
+      }
+      if (this.opts?.discoverPlugins === false) {
+        throw error;
+      }
+      const response = await prompt<{ isInstall: boolean }>({
+        type: 'confirm',
+        name: 'isInstall',
+        message: 'Install ' + cmdPackage + ' package?',
+        initial: true,
+      });
+
+      if (!response.isInstall) {
+        console.log('Install was aborted');
+        return;
+      }
+      try {
+        await this.installCmdPackage(cmdPackage);
+      } catch (error: any) {
+        if (!(error instanceof Error)) {
+          throw error;
+        }
+        FailedToInstall.assertError(error, cmdPackage);
+        throw error;
+      }
+
+      const resolvedPackage = await this.resolveCmdPackage(cmdPackage);
+
+      return PackageLoader.getEntry(resolvedPackage.resolved);
+    }
+  }
+
+  async handle(argv: string[]): Promise<void> {
+    const rsdkCommand = argv.slice(2)[0];
+
+    if (!rsdkCommand || rsdkCommand.startsWith('-')) {
+      program.parse();
+      return;
+    }
+    const cmd = rsdkCommand.split(':')[0];
+
+    const rsdkCliCommand = await this.getRsdkCommand(cmd);
+    if (!rsdkCliCommand) {
+      throw new Error('rsdk cli command not found');
+    }
+    const cmds = rsdkCliCommand.getCommands();
+
+    for (const cmd of cmds) {
+      program.addCommand(cmd);
+    }
+
+    program.parse();
+  }
+}

package/src/exception.ts

@@ -0,0 +1,20 @@
+export class FailedToInstall extends Error {
+  constructor(packageName: string, cause?: any) {
+    super('Failed to install ' + packageName, {
+      cause: {
+        packageName,
+        cause,
+      },
+    });
+    this.name = this.constructor.name;
+  }
+
+  static assertError(error: Error, packageName: string): void {
+    const isFailedToInstall = (error.message as string).startsWith(
+      'Failed to install',
+    );
+    if (isFailedToInstall) {
+      throw new FailedToInstall(packageName, error);
+    }
+  }
+}

package/src/index.ts

@@ -0,0 +1,16 @@
+import type { RsdkCliCommand } from '@rsdk/cli.common';
+
+import './reconfigure-logger';
+
+import { Cli } from './cli';
+
+// TODO: сделать более понятным, переиспользуемым, консистентным и контролируем
+process.env.RSDK_CLI_MODE = 'true';
+
+process.title = 'rsdk';
+export const execute = async (opts?: {
+  plugins?: (string | { command: RsdkCliCommand; cmd: string })[];
+  discoverPlugins?: boolean;
+}): Promise<void> => {
+  await new Cli(opts).handle(process.argv);
+};

package/src/package.loader.ts

@@ -0,0 +1,36 @@
+import type { PackageManager } from '@parcel/package-manager';
+import type { RsdkCliCommand } from '@rsdk/cli.common';
+import { resolve } from 'node:path';
+
+export class PackageLoader {
+  static getEntry(cmdPackageName: string): RsdkCliCommand {
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    return require(cmdPackageName).Cmd;
+  }
+
+  static async installPackage(
+    packageManager: PackageManager,
+    cmdPackage: string,
+  ): Promise<void> {
+    const cliPackageJsonPath: string = require.resolve('../package.json', {
+      paths: [__dirname],
+    });
+
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    const cliPackageJson = require(cliPackageJsonPath);
+
+    // @ts-expect-error not declared method
+    await packageManager.install(
+      [
+        {
+          name: cmdPackage,
+          semVer: cliPackageJson.version,
+        },
+      ],
+      resolve(''),
+      {
+        saveDev: true,
+      },
+    );
+  }
+}

package/src/reconfigure-logger.ts

@@ -0,0 +1,13 @@
+/**
+ * TODO: написать корректную работу с логгером, с учетом того что она может (уже используется вне DI) и может аффектить tracing
+ */
+
+import { LoggerFactory, LogLevel } from '@rsdk/logging';
+
+export const logLevelFromEnv = LogLevel[
+  (process.env.LOG_LEVEL ?? 'info') as LogLevel
+] as LogLevel | undefined;
+
+LoggerFactory.reconfigure({
+  level: logLevelFromEnv ?? LogLevel.info,
+});

package/tsconfig.build.json

@@ -0,0 +1,12 @@
+{
+  "extends": "./tsconfig.json",
+  "exclude": [
+    "node_modules",
+    "dist",
+    "test",
+    "**/*.spec.ts",
+    "**/*.test.ts",
+    "**/*.test.e2e.ts",
+    "**/*.test.manual-e2e.ts",
+  ]
+}

package/tsconfig.json

@@ -0,0 +1,7 @@
+{
+  "extends": "@rsdk/tsconfig/base.json",
+  "compilerOptions": {
+    "declaration": true,
+    "outDir": "dist"
+  }
+}