@alfalab/arui-scripts-artifacts 0.0.0-beta-20260824133302

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (142) hide show
  1. package/.eslintignore +2 -0
  2. package/.eslintrc.js +8 -0
  3. package/.prettierignore +2 -0
  4. package/.turbo/turbo-build.log +0 -0
  5. package/.turbo/turbo-test.log +15 -0
  6. package/CHANGELOG.md +42 -0
  7. package/README.md +298 -0
  8. package/build/archive/build-archive.d.ts +14 -0
  9. package/build/archive/build-archive.js +69 -0
  10. package/build/archive/constants.d.ts +6 -0
  11. package/build/archive/constants.js +6 -0
  12. package/build/archive/index.d.ts +2 -0
  13. package/build/archive/index.js +2 -0
  14. package/build/cjs/archive/build-archive.d.ts +14 -0
  15. package/build/cjs/archive/build-archive.js +75 -0
  16. package/build/cjs/archive/constants.d.ts +6 -0
  17. package/build/cjs/archive/constants.js +9 -0
  18. package/build/cjs/archive/index.d.ts +2 -0
  19. package/build/cjs/archive/index.js +9 -0
  20. package/build/cjs/bin/index.d.ts +2 -0
  21. package/build/cjs/bin/index.js +58 -0
  22. package/build/cjs/cli/config-file.d.ts +46 -0
  23. package/build/cjs/cli/config-file.js +117 -0
  24. package/build/cjs/cli/create-cli.d.ts +25 -0
  25. package/build/cjs/cli/create-cli.js +75 -0
  26. package/build/cjs/cli/index.d.ts +3 -0
  27. package/build/cjs/cli/index.js +17 -0
  28. package/build/cjs/cli/load-config-file.d.ts +15 -0
  29. package/build/cjs/cli/load-config-file.js +62 -0
  30. package/build/cjs/config/index.d.ts +10 -0
  31. package/build/cjs/config/index.js +132 -0
  32. package/build/cjs/config/types.d.ts +226 -0
  33. package/build/cjs/config/types.js +2 -0
  34. package/build/cjs/docker/build-command.d.ts +13 -0
  35. package/build/cjs/docker/build-command.js +65 -0
  36. package/build/cjs/docker/build-docker-image.d.ts +21 -0
  37. package/build/cjs/docker/build-docker-image.js +65 -0
  38. package/build/cjs/docker/build-params.d.ts +20 -0
  39. package/build/cjs/docker/build-params.js +52 -0
  40. package/build/cjs/docker/constants.d.ts +19 -0
  41. package/build/cjs/docker/constants.js +22 -0
  42. package/build/cjs/docker/index.d.ts +7 -0
  43. package/build/cjs/docker/index.js +26 -0
  44. package/build/cjs/docker/prepare-files.d.ts +19 -0
  45. package/build/cjs/docker/prepare-files.js +81 -0
  46. package/build/cjs/docker/templates/dockerfile-compiled.template.d.ts +6 -0
  47. package/build/cjs/docker/templates/dockerfile-compiled.template.js +52 -0
  48. package/build/cjs/docker/templates/dockerfile.template.d.ts +5 -0
  49. package/build/cjs/docker/templates/dockerfile.template.js +46 -0
  50. package/build/cjs/index.d.ts +15 -0
  51. package/build/cjs/index.js +45 -0
  52. package/build/cjs/nginx/constants.d.ts +11 -0
  53. package/build/cjs/nginx/constants.js +19 -0
  54. package/build/cjs/nginx/index.d.ts +3 -0
  55. package/build/cjs/nginx/index.js +13 -0
  56. package/build/cjs/nginx/templates/base-nginx.conf.template.d.ts +7 -0
  57. package/build/cjs/nginx/templates/base-nginx.conf.template.js +57 -0
  58. package/build/cjs/nginx/templates/nginx.conf.template.d.ts +5 -0
  59. package/build/cjs/nginx/templates/nginx.conf.template.js +52 -0
  60. package/build/cjs/pipeline/build-artifact.d.ts +8 -0
  61. package/build/cjs/pipeline/build-artifact.js +16 -0
  62. package/build/cjs/pipeline/host-pipeline.d.ts +9 -0
  63. package/build/cjs/pipeline/host-pipeline.js +33 -0
  64. package/build/cjs/pipeline/index.d.ts +3 -0
  65. package/build/cjs/pipeline/index.js +9 -0
  66. package/build/cjs/pipeline/render.d.ts +16 -0
  67. package/build/cjs/pipeline/render.js +38 -0
  68. package/build/cjs/start-script/constants.d.ts +4 -0
  69. package/build/cjs/start-script/constants.js +7 -0
  70. package/build/cjs/start-script/index.d.ts +2 -0
  71. package/build/cjs/start-script/index.js +8 -0
  72. package/build/cjs/start-script/start.template.d.ts +6 -0
  73. package/build/cjs/start-script/start.template.js +74 -0
  74. package/build/cjs/utils/exec.d.ts +12 -0
  75. package/build/cjs/utils/exec.js +36 -0
  76. package/build/cjs/utils/shell.d.ts +6 -0
  77. package/build/cjs/utils/shell.js +16 -0
  78. package/build/cjs/utils/yarn.d.ts +25 -0
  79. package/build/cjs/utils/yarn.js +70 -0
  80. package/build/cli/config-file.d.ts +46 -0
  81. package/build/cli/config-file.js +110 -0
  82. package/build/cli/create-cli.d.ts +25 -0
  83. package/build/cli/create-cli.js +71 -0
  84. package/build/cli/index.d.ts +3 -0
  85. package/build/cli/index.js +3 -0
  86. package/build/cli/load-config-file.d.ts +15 -0
  87. package/build/cli/load-config-file.js +53 -0
  88. package/build/config/index.d.ts +10 -0
  89. package/build/config/index.js +126 -0
  90. package/build/config/types.d.ts +226 -0
  91. package/build/config/types.js +1 -0
  92. package/build/docker/build-command.d.ts +13 -0
  93. package/build/docker/build-command.js +57 -0
  94. package/build/docker/build-docker-image.d.ts +21 -0
  95. package/build/docker/build-docker-image.js +59 -0
  96. package/build/docker/build-params.d.ts +20 -0
  97. package/build/docker/build-params.js +44 -0
  98. package/build/docker/constants.d.ts +19 -0
  99. package/build/docker/constants.js +19 -0
  100. package/build/docker/index.d.ts +7 -0
  101. package/build/docker/index.js +7 -0
  102. package/build/docker/prepare-files.d.ts +19 -0
  103. package/build/docker/prepare-files.js +75 -0
  104. package/build/docker/templates/dockerfile-compiled.template.d.ts +6 -0
  105. package/build/docker/templates/dockerfile-compiled.template.js +49 -0
  106. package/build/docker/templates/dockerfile.template.d.ts +5 -0
  107. package/build/docker/templates/dockerfile.template.js +43 -0
  108. package/build/index.d.ts +15 -0
  109. package/build/index.js +20 -0
  110. package/build/nginx/constants.d.ts +11 -0
  111. package/build/nginx/constants.js +16 -0
  112. package/build/nginx/index.d.ts +3 -0
  113. package/build/nginx/index.js +3 -0
  114. package/build/nginx/templates/base-nginx.conf.template.d.ts +7 -0
  115. package/build/nginx/templates/base-nginx.conf.template.js +54 -0
  116. package/build/nginx/templates/nginx.conf.template.d.ts +5 -0
  117. package/build/nginx/templates/nginx.conf.template.js +49 -0
  118. package/build/pipeline/build-artifact.d.ts +8 -0
  119. package/build/pipeline/build-artifact.js +13 -0
  120. package/build/pipeline/host-pipeline.d.ts +9 -0
  121. package/build/pipeline/host-pipeline.js +27 -0
  122. package/build/pipeline/index.d.ts +3 -0
  123. package/build/pipeline/index.js +3 -0
  124. package/build/pipeline/render.d.ts +16 -0
  125. package/build/pipeline/render.js +35 -0
  126. package/build/start-script/constants.d.ts +4 -0
  127. package/build/start-script/constants.js +4 -0
  128. package/build/start-script/index.d.ts +2 -0
  129. package/build/start-script/index.js +2 -0
  130. package/build/start-script/start.template.d.ts +6 -0
  131. package/build/start-script/start.template.js +71 -0
  132. package/build/utils/exec.d.ts +12 -0
  133. package/build/utils/exec.js +28 -0
  134. package/build/utils/shell.d.ts +6 -0
  135. package/build/utils/shell.js +13 -0
  136. package/build/utils/yarn.d.ts +25 -0
  137. package/build/utils/yarn.js +61 -0
  138. package/jest.config.js +12 -0
  139. package/package.json +57 -0
  140. package/tsconfig.cjs.json +13 -0
  141. package/tsconfig.eslint.json +7 -0
  142. package/tsconfig.json +22 -0
@@ -0,0 +1,58 @@
1
+ #! /usr/bin/env node
2
+ "use strict";
3
+ var __importDefault = (this && this.__importDefault) || function (mod) {
4
+ return (mod && mod.__esModule) ? mod : { "default": mod };
5
+ };
6
+ Object.defineProperty(exports, "__esModule", { value: true });
7
+ const path_1 = __importDefault(require("path"));
8
+ const fs_extra_1 = __importDefault(require("fs-extra"));
9
+ const config_file_1 = require("../cli/config-file");
10
+ const create_cli_1 = require("../cli/create-cli");
11
+ const load_config_file_1 = require("../cli/load-config-file");
12
+ const constants_1 = require("../docker/constants");
13
+ const constants_2 = require("../nginx/constants");
14
+ const build_artifact_1 = require("../pipeline/build-artifact");
15
+ const constants_3 = require("../start-script/constants");
16
+ // eslint-disable-next-line global-require, @typescript-eslint/no-var-requires
17
+ const { version } = require('../../../package.json');
18
+ /**
19
+ * Локальные файлы проекта, замещающие сгенерированные шаблоны, если они лежат в корне проекта.
20
+ * Явно заданные в конфиге `localFiles` имеют приоритет над автодетектом.
21
+ */
22
+ function detectLocalFiles(cwd) {
23
+ const resolveIfExists = (fileName) => {
24
+ const filePath = path_1.default.join(cwd, fileName);
25
+ return fs_extra_1.default.existsSync(filePath) ? filePath : null;
26
+ };
27
+ return {
28
+ dockerfile: resolveIfExists(constants_1.DOCKERFILE_FILENAME),
29
+ startScript: resolveIfExists(constants_3.START_SCRIPT_FILENAME),
30
+ nginxConf: resolveIfExists(constants_2.NGINX_CONFIG_FILENAME),
31
+ nginxBaseConf: resolveIfExists(constants_2.BASE_NGINX_CONFIG_FILENAME),
32
+ };
33
+ }
34
+ (async () => {
35
+ const argv = process.argv.slice(2);
36
+ const cwd = process.cwd();
37
+ const configFile = await (0, load_config_file_1.resolveConfigFile)(cwd, (0, create_cli_1.extractConfigPath)(argv));
38
+ const program = (0, create_cli_1.createCli)({
39
+ configFile,
40
+ version,
41
+ run: async ({ command, args }) => {
42
+ const options = (0, config_file_1.resolveCommandOptions)(command, configFile);
43
+ if (!options) {
44
+ throw new Error(`Unknown command: ${command}`);
45
+ }
46
+ await (0, build_artifact_1.buildArtifact)({
47
+ ...options,
48
+ localFiles: { ...detectLocalFiles(cwd), ...options.localFiles },
49
+ // аргументы командной строки (name=... version=... registry=...) — высший приоритет
50
+ argv: args,
51
+ });
52
+ },
53
+ });
54
+ await program.parseAsync(argv, { from: 'user' });
55
+ })().catch((err) => {
56
+ console.error(err instanceof Error ? err.message : err);
57
+ process.exit(1);
58
+ });
@@ -0,0 +1,46 @@
1
+ import { type ArtifactsOptions } from '../config/types';
2
+ import { type BuildArtifactOptions } from '../pipeline/build-artifact';
3
+ /**
4
+ * Содержимое `arui-scripts-artifacts.ts` — единственный источник правды для всех команд проекта.
5
+ *
6
+ * Верхний уровень описывает общие для проекта настройки, `commands` — конкретные сборки. Команда
7
+ * наследует верхний уровень, поэтому «еще один образ с другим портом» — это несколько строк в
8
+ * конфиге, а не отдельный скрипт.
9
+ */
10
+ export type ArtifactsConfigFile = ArtifactsOptions & {
11
+ /**
12
+ * Именованные команды. Имя становится аргументом CLI: `arui-scripts-artifacts <имя>`.
13
+ * Встроенные `docker-build`, `docker-build:compiled` и `archive-build` можно донасыщать или
14
+ * переопределять.
15
+ */
16
+ commands?: Record<string, ArtifactsOptions>;
17
+ };
18
+ /** Конфиг может экспортировать объект или (в т.ч. асинхронную) функцию, возвращающую объект. */
19
+ export type ArtifactsConfigFileExport = ArtifactsConfigFile | (() => ArtifactsConfigFile | Promise<ArtifactsConfigFile>);
20
+ /**
21
+ * Хелпер для типизации `arui-scripts-artifacts.ts`. Ничего не делает в рантайме — существует только
22
+ * ради автодополнения и проверки типов в конфиге.
23
+ */
24
+ export declare function defineConfig(config: ArtifactsConfigFileExport): ArtifactsConfigFileExport;
25
+ /**
26
+ * Встроенные команды. Задают только то, что отличает одну команду от другой; все остальное берется
27
+ * из конфига проекта.
28
+ */
29
+ export declare const BUILT_IN_COMMANDS: Record<string, ArtifactsOptions>;
30
+ /**
31
+ * Сливает несколько конфигов в один: каждый следующий переопределяет предыдущие по тем же правилам,
32
+ * что и команда переопределяет верхний уровень — секции по полям, `commands` по имени команды.
33
+ *
34
+ * Нужно тем, кто отдает CLI собственный конфиг (`-c`) и хочет доложить поверх пользовательский —
35
+ * так делает arui-scripts, чтобы `arui-scripts-artifacts.ts` в корне проекта продолжал работать.
36
+ */
37
+ export declare function mergeConfigFiles(...configFiles: ArtifactsConfigFile[]): ArtifactsConfigFile;
38
+ /** Список команд, доступных с данным конфигом: встроенные плюс объявленные в проекте. */
39
+ export declare function getAvailableCommands(configFile?: ArtifactsConfigFile): string[];
40
+ /**
41
+ * Собирает опции конкретной команды. Приоритет (по возрастанию):
42
+ * дефолты встроенной команды → верхний уровень конфига → секция `commands[command]`.
43
+ *
44
+ * Возвращает `null`, если такой команды нет ни среди встроенных, ни в конфиге.
45
+ */
46
+ export declare function resolveCommandOptions(command: string, configFile?: ArtifactsConfigFile): BuildArtifactOptions | null;
@@ -0,0 +1,117 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.BUILT_IN_COMMANDS = void 0;
4
+ exports.defineConfig = defineConfig;
5
+ exports.mergeConfigFiles = mergeConfigFiles;
6
+ exports.getAvailableCommands = getAvailableCommands;
7
+ exports.resolveCommandOptions = resolveCommandOptions;
8
+ /**
9
+ * Хелпер для типизации `arui-scripts-artifacts.ts`. Ничего не делает в рантайме — существует только
10
+ * ради автодополнения и проверки типов в конфиге.
11
+ */
12
+ function defineConfig(config) {
13
+ return config;
14
+ }
15
+ /**
16
+ * Встроенные команды. Задают только то, что отличает одну команду от другой; все остальное берется
17
+ * из конфига проекта.
18
+ */
19
+ exports.BUILT_IN_COMMANDS = {
20
+ 'docker-build': {
21
+ artifact: 'docker',
22
+ docker: { variant: 'runtime', addNodeModulesToDockerIgnore: false },
23
+ localFiles: { allowDockerfile: true, allowStartScript: true },
24
+ },
25
+ 'docker-build:compiled': {
26
+ artifact: 'docker',
27
+ docker: { variant: 'compiled', addNodeModulesToDockerIgnore: true },
28
+ localFiles: { allowDockerfile: false, allowStartScript: false },
29
+ },
30
+ 'archive-build': {
31
+ artifact: 'archive',
32
+ },
33
+ };
34
+ /** Секции конфига — их сливаем по полям, а не заменяем целиком. */
35
+ const MERGED_SECTIONS = [
36
+ 'docker',
37
+ 'nginx',
38
+ 'archive',
39
+ 'build',
40
+ 'packageManager',
41
+ 'localFiles',
42
+ 'templates',
43
+ 'overrides',
44
+ ];
45
+ function isPlainObject(value) {
46
+ return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
47
+ }
48
+ function mergeSection(base, patch) {
49
+ const result = { ...base, ...patch };
50
+ // единственная вложенная в секцию секция — `nginx.baseConf`, и ее тоже ожидаемо сливать по полям.
51
+ // `baseConf: false/null` — осмысленное «не генерировать базовый конфиг», такое значение не сливаем
52
+ Object.keys(patch).forEach((key) => {
53
+ if (isPlainObject(base[key]) && isPlainObject(patch[key])) {
54
+ result[key] = { ...base[key], ...patch[key] };
55
+ }
56
+ });
57
+ return result;
58
+ }
59
+ function mergeOptions(base, patch) {
60
+ const result = { ...base, ...patch };
61
+ MERGED_SECTIONS.forEach((key) => {
62
+ const baseValue = base[key];
63
+ const patchValue = patch[key];
64
+ if (isPlainObject(baseValue) && isPlainObject(patchValue)) {
65
+ Object.assign(result, { [key]: mergeSection(baseValue, patchValue) });
66
+ }
67
+ });
68
+ return result;
69
+ }
70
+ /**
71
+ * Сливает несколько конфигов в один: каждый следующий переопределяет предыдущие по тем же правилам,
72
+ * что и команда переопределяет верхний уровень — секции по полям, `commands` по имени команды.
73
+ *
74
+ * Нужно тем, кто отдает CLI собственный конфиг (`-c`) и хочет доложить поверх пользовательский —
75
+ * так делает arui-scripts, чтобы `arui-scripts-artifacts.ts` в корне проекта продолжал работать.
76
+ */
77
+ function mergeConfigFiles(...configFiles) {
78
+ return configFiles.reduce((base, patch) => {
79
+ const { commands: baseCommands, ...baseShared } = base;
80
+ const { commands: patchCommands, ...patchShared } = patch;
81
+ const merged = mergeOptions(baseShared, patchShared);
82
+ const commandNames = [
83
+ ...new Set([...Object.keys(baseCommands ?? {}), ...Object.keys(patchCommands ?? {})]),
84
+ ];
85
+ if (commandNames.length) {
86
+ merged.commands = Object.fromEntries(commandNames.map((name) => [
87
+ name,
88
+ mergeOptions(baseCommands?.[name] ?? {}, patchCommands?.[name] ?? {}),
89
+ ]));
90
+ }
91
+ return merged;
92
+ }, {});
93
+ }
94
+ /** Список команд, доступных с данным конфигом: встроенные плюс объявленные в проекте. */
95
+ function getAvailableCommands(configFile = {}) {
96
+ return Array.from(new Set([...Object.keys(exports.BUILT_IN_COMMANDS), ...Object.keys(configFile.commands ?? {})]));
97
+ }
98
+ /**
99
+ * Собирает опции конкретной команды. Приоритет (по возрастанию):
100
+ * дефолты встроенной команды → верхний уровень конфига → секция `commands[command]`.
101
+ *
102
+ * Возвращает `null`, если такой команды нет ни среди встроенных, ни в конфиге.
103
+ */
104
+ function resolveCommandOptions(command, configFile = {}) {
105
+ const { commands, ...sharedOptions } = configFile;
106
+ const builtIn = exports.BUILT_IN_COMMANDS[command];
107
+ const declared = commands?.[command];
108
+ if (!builtIn && !declared) {
109
+ return null;
110
+ }
111
+ let options = builtIn ?? {};
112
+ options = mergeOptions(options, sharedOptions);
113
+ if (declared) {
114
+ options = mergeOptions(options, declared);
115
+ }
116
+ return options;
117
+ }
@@ -0,0 +1,25 @@
1
+ import { Command } from 'commander';
2
+ import { type ArtifactsConfigFile } from './config-file';
3
+ /**
4
+ * Достает путь до конфига до того, как построен основной CLI: список команд зависит от конфига,
5
+ * а конфиг — от аргументов. Разбирает тем же commander, просто с выключенными проверками.
6
+ */
7
+ export declare function extractConfigPath(argv: string[]): string | undefined;
8
+ export type RunCommandParams = {
9
+ /** Имя команды из конфига или встроенной. */
10
+ command: string;
11
+ /** Позиционные аргументы команды (`name=... version=... registry=...`). */
12
+ args: string[];
13
+ };
14
+ export type CreateCliParams = {
15
+ /** Загруженный конфиг проекта — из него берется список доступных команд. */
16
+ configFile: ArtifactsConfigFile;
17
+ version: string;
18
+ run: (params: RunCommandParams) => Promise<void> | void;
19
+ };
20
+ /**
21
+ * Собирает CLI: по одной подкоманде на каждую доступную сборку — встроенные плюс объявленные в
22
+ * `commands` конфига проекта. Благодаря этому `--help` показывает и кастомные команды, а опечатка в
23
+ * имени дает подсказку вместо простого списка.
24
+ */
25
+ export declare function createCli({ configFile, version, run }: CreateCliParams): Command;
@@ -0,0 +1,75 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.extractConfigPath = extractConfigPath;
4
+ exports.createCli = createCli;
5
+ const commander_1 = require("commander");
6
+ const config_file_1 = require("./config-file");
7
+ /** Описания встроенных команд для `--help`. */
8
+ const BUILT_IN_DESCRIPTIONS = {
9
+ 'docker-build': 'Сборка приложения на хосте, создание docker образа и пуш в registry',
10
+ 'docker-build:compiled': 'Как docker-build, но зависимости и сборка выполняются внутри образа (для CI/CD)',
11
+ 'archive-build': 'Собирает tar-архив с production-сборкой (buildPath, node_modules, package.json, config)',
12
+ };
13
+ const CONFIG_OPTION_HELP = 'Путь до конфига (по умолчанию arui-scripts-artifacts.ts в корне проекта)';
14
+ /**
15
+ * Добавляет опцию конфига. Кроме канонических `-c`/`--config` принимаем и `--c` — commander не умеет
16
+ * несколько длинных имен у одной опции, поэтому вторая объявлена отдельно и скрыта из справки.
17
+ */
18
+ function addConfigOption(command) {
19
+ return command
20
+ .option('-c, --config <path>', CONFIG_OPTION_HELP)
21
+ .addOption(new commander_1.Command().createOption('--c <path>', CONFIG_OPTION_HELP).hideHelp());
22
+ }
23
+ /** Значение опции конфига, из какого бы из ее написаний оно ни пришло. */
24
+ function getConfigPath(options) {
25
+ return options.config ?? options.c;
26
+ }
27
+ /**
28
+ * Достает путь до конфига до того, как построен основной CLI: список команд зависит от конфига,
29
+ * а конфиг — от аргументов. Разбирает тем же commander, просто с выключенными проверками.
30
+ */
31
+ function extractConfigPath(argv) {
32
+ const program = addConfigOption(new commander_1.Command())
33
+ .allowUnknownOption()
34
+ .allowExcessArguments()
35
+ .helpOption(false);
36
+ program.parse(argv, { from: 'user' });
37
+ return getConfigPath(program.opts());
38
+ }
39
+ /**
40
+ * Собирает CLI: по одной подкоманде на каждую доступную сборку — встроенные плюс объявленные в
41
+ * `commands` конфига проекта. Благодаря этому `--help` показывает и кастомные команды, а опечатка в
42
+ * имени дает подсказку вместо простого списка.
43
+ */
44
+ function createCli({ configFile, version, run }) {
45
+ const program = new commander_1.Command('arui-scripts-artifacts');
46
+ program
47
+ .description('Сборка docker-образов для приложений на arui-scripts')
48
+ .version(version, '-v, --version', 'Показать версию')
49
+ .showHelpAfterError('(используйте --help для списка команд)')
50
+ .showSuggestionAfterError();
51
+ addConfigOption(program);
52
+ (0, config_file_1.getAvailableCommands)(configFile).forEach((name) => {
53
+ const isBuiltIn = Boolean(config_file_1.BUILT_IN_COMMANDS[name]);
54
+ const description = isBuiltIn
55
+ ? BUILT_IN_DESCRIPTIONS[name]
56
+ : 'Команда из arui-scripts-artifacts конфига проекта';
57
+ const command = program
58
+ .command(name)
59
+ .description(description)
60
+ // name=/version=/registry= — позиционные аргументы, а не опции commander
61
+ .allowUnknownOption()
62
+ .allowExcessArguments()
63
+ .action(async () => {
64
+ await run({ command: name, args: command.args });
65
+ });
66
+ addConfigOption(command);
67
+ });
68
+ program.addHelpText('after', [
69
+ '',
70
+ 'Имя образа формируется как {docker.registry}/{name}:{version}.',
71
+ 'name и version по умолчанию берутся из package.json, но их можно переопределить:',
72
+ ' arui-scripts-artifacts docker-build name=container-name version=0.1-beta',
73
+ ].join('\n'));
74
+ return program;
75
+ }
@@ -0,0 +1,3 @@
1
+ export { createCli, extractConfigPath, type CreateCliParams, type RunCommandParams, } from './create-cli';
2
+ export { BUILT_IN_COMMANDS, defineConfig, getAvailableCommands, mergeConfigFiles, resolveCommandOptions, type ArtifactsConfigFile, type ArtifactsConfigFileExport, } from './config-file';
3
+ export { CONFIG_FILE_NAMES, findConfigFile, loadConfigFile, resolveConfigFile, } from './load-config-file';
@@ -0,0 +1,17 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.resolveConfigFile = exports.loadConfigFile = exports.findConfigFile = exports.CONFIG_FILE_NAMES = exports.resolveCommandOptions = exports.mergeConfigFiles = exports.getAvailableCommands = exports.defineConfig = exports.BUILT_IN_COMMANDS = exports.extractConfigPath = exports.createCli = void 0;
4
+ var create_cli_1 = require("./create-cli");
5
+ Object.defineProperty(exports, "createCli", { enumerable: true, get: function () { return create_cli_1.createCli; } });
6
+ Object.defineProperty(exports, "extractConfigPath", { enumerable: true, get: function () { return create_cli_1.extractConfigPath; } });
7
+ var config_file_1 = require("./config-file");
8
+ Object.defineProperty(exports, "BUILT_IN_COMMANDS", { enumerable: true, get: function () { return config_file_1.BUILT_IN_COMMANDS; } });
9
+ Object.defineProperty(exports, "defineConfig", { enumerable: true, get: function () { return config_file_1.defineConfig; } });
10
+ Object.defineProperty(exports, "getAvailableCommands", { enumerable: true, get: function () { return config_file_1.getAvailableCommands; } });
11
+ Object.defineProperty(exports, "mergeConfigFiles", { enumerable: true, get: function () { return config_file_1.mergeConfigFiles; } });
12
+ Object.defineProperty(exports, "resolveCommandOptions", { enumerable: true, get: function () { return config_file_1.resolveCommandOptions; } });
13
+ var load_config_file_1 = require("./load-config-file");
14
+ Object.defineProperty(exports, "CONFIG_FILE_NAMES", { enumerable: true, get: function () { return load_config_file_1.CONFIG_FILE_NAMES; } });
15
+ Object.defineProperty(exports, "findConfigFile", { enumerable: true, get: function () { return load_config_file_1.findConfigFile; } });
16
+ Object.defineProperty(exports, "loadConfigFile", { enumerable: true, get: function () { return load_config_file_1.loadConfigFile; } });
17
+ Object.defineProperty(exports, "resolveConfigFile", { enumerable: true, get: function () { return load_config_file_1.resolveConfigFile; } });
@@ -0,0 +1,15 @@
1
+ import { type ArtifactsConfigFile } from './config-file';
2
+ /** Имена, по которым конфиг ищется автоматически, если не передан `--config`. */
3
+ export declare const CONFIG_FILE_NAMES: string[];
4
+ /**
5
+ * Ищет конфиг в `cwd`. Явно переданный путь имеет приоритет и обязан существовать — молча
6
+ * игнорировать опечатку в `--config` хуже, чем упасть.
7
+ */
8
+ export declare function findConfigFile(cwd: string, explicitPath?: string): string | null;
9
+ /**
10
+ * Загружает конфиг. Через jiti, поэтому одинаково работают TypeScript, ESM и CommonJS без
11
+ * дополнительных загрузчиков в проекте.
12
+ */
13
+ export declare function loadConfigFile(configPath: string): Promise<ArtifactsConfigFile>;
14
+ /** Находит и загружает конфиг проекта. Если конфига нет — пустой объект. */
15
+ export declare function resolveConfigFile(cwd: string, explicitPath?: string): Promise<ArtifactsConfigFile>;
@@ -0,0 +1,62 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ exports.CONFIG_FILE_NAMES = void 0;
7
+ exports.findConfigFile = findConfigFile;
8
+ exports.loadConfigFile = loadConfigFile;
9
+ exports.resolveConfigFile = resolveConfigFile;
10
+ const path_1 = __importDefault(require("path"));
11
+ const fs_extra_1 = __importDefault(require("fs-extra"));
12
+ const jiti_1 = require("jiti");
13
+ /** Имена, по которым конфиг ищется автоматически, если не передан `--config`. */
14
+ exports.CONFIG_FILE_NAMES = [
15
+ 'arui-scripts-artifacts.ts',
16
+ 'arui-scripts-artifacts.mts',
17
+ 'arui-scripts-artifacts.cts',
18
+ 'arui-scripts-artifacts.js',
19
+ 'arui-scripts-artifacts.mjs',
20
+ 'arui-scripts-artifacts.cjs',
21
+ 'arui-scripts-artifacts.config.ts',
22
+ 'arui-scripts-artifacts.config.js',
23
+ ];
24
+ /**
25
+ * Ищет конфиг в `cwd`. Явно переданный путь имеет приоритет и обязан существовать — молча
26
+ * игнорировать опечатку в `--config` хуже, чем упасть.
27
+ */
28
+ function findConfigFile(cwd, explicitPath) {
29
+ if (explicitPath) {
30
+ const configPath = path_1.default.resolve(cwd, explicitPath);
31
+ if (!fs_extra_1.default.existsSync(configPath)) {
32
+ throw new Error(`Config file not found: ${configPath}`);
33
+ }
34
+ return configPath;
35
+ }
36
+ return (exports.CONFIG_FILE_NAMES.map((fileName) => path_1.default.join(cwd, fileName)).find((filePath) => fs_extra_1.default.existsSync(filePath)) ?? null);
37
+ }
38
+ /**
39
+ * Загружает конфиг. Через jiti, поэтому одинаково работают TypeScript, ESM и CommonJS без
40
+ * дополнительных загрузчиков в проекте.
41
+ */
42
+ async function loadConfigFile(configPath) {
43
+ // База резолва — сам конфиг: его импорты должны разрешаться относительно проекта, а не либы.
44
+ // Заодно не зависим от __filename/import.meta, которых нет то в одной, то в другой сборке.
45
+ const jiti = (0, jiti_1.createJiti)(configPath, { interopDefault: true });
46
+ const configModule = await jiti.import(configPath, {
47
+ default: true,
48
+ });
49
+ const config = typeof configModule === 'function' ? await configModule() : configModule;
50
+ if (!config || typeof config !== 'object') {
51
+ throw new Error(`Config file ${configPath} must export an object or a function returning an object`);
52
+ }
53
+ return config;
54
+ }
55
+ /** Находит и загружает конфиг проекта. Если конфига нет — пустой объект. */
56
+ async function resolveConfigFile(cwd, explicitPath) {
57
+ const configPath = findConfigFile(cwd, explicitPath);
58
+ if (!configPath) {
59
+ return {};
60
+ }
61
+ return loadConfigFile(configPath);
62
+ }
@@ -0,0 +1,10 @@
1
+ import { type ArtifactsOptions, type ResolvedArtifactsConfig } from './types';
2
+ /**
3
+ * Донасыщает частичные опции сборки полным набором значений с дефолтами.
4
+ *
5
+ * Все дефолты артефактов живут здесь (и в константах доменных папок) — потребители, включая
6
+ * arui-scripts, только транслируют то, что задал пользователь. Значения по умолчанию совпадают с
7
+ * историческим поведением arui-scripts, поэтому вызов без аргументов даст такой же образ, как
8
+ * команда `arui-scripts docker-build`.
9
+ */
10
+ export declare function resolveArtifactsConfig(options?: ArtifactsOptions): ResolvedArtifactsConfig;
@@ -0,0 +1,132 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ exports.resolveArtifactsConfig = resolveArtifactsConfig;
7
+ const path_1 = __importDefault(require("path"));
8
+ const fs_extra_1 = __importDefault(require("fs-extra"));
9
+ const constants_1 = require("../archive/constants");
10
+ const constants_2 = require("../docker/constants");
11
+ const constants_3 = require("../nginx/constants");
12
+ const yarn_1 = require("../utils/yarn");
13
+ function readPackageJson(cwd) {
14
+ try {
15
+ return fs_extra_1.default.readJsonSync(path_1.default.join(cwd, 'package.json'));
16
+ }
17
+ catch {
18
+ return {};
19
+ }
20
+ }
21
+ /**
22
+ * Дефолт значения флага `undefined ? fallback : value`, но с учетом того, что `false`/`0`/`''`
23
+ * — валидные значения, которые не должны затираться дефолтом.
24
+ */
25
+ function withDefault(value, fallback) {
26
+ return value === undefined ? fallback : value;
27
+ }
28
+ /**
29
+ * Донасыщает частичные опции сборки полным набором значений с дефолтами.
30
+ *
31
+ * Все дефолты артефактов живут здесь (и в константах доменных папок) — потребители, включая
32
+ * arui-scripts, только транслируют то, что задал пользователь. Значения по умолчанию совпадают с
33
+ * историческим поведением arui-scripts, поэтому вызов без аргументов даст такой же образ, как
34
+ * команда `arui-scripts docker-build`.
35
+ */
36
+ function resolveArtifactsConfig(options = {}) {
37
+ const cwd = options.cwd ?? process.cwd();
38
+ const pkg = readPackageJson(cwd);
39
+ const artifact = withDefault(options.artifact, 'docker');
40
+ const clientOnly = withDefault(options.clientOnly, false);
41
+ const debug = withDefault(options.debug, false);
42
+ const buildPath = withDefault(options.buildPath, '.build');
43
+ const assetsPath = withDefault(options.assetsPath, 'assets');
44
+ return {
45
+ artifact,
46
+ name: options.name ?? pkg.name ?? '',
47
+ version: options.version ?? pkg.version ?? '',
48
+ cwd,
49
+ debug,
50
+ clientOnly,
51
+ buildPath,
52
+ serverOutput: withDefault(options.serverOutput, 'server.js'),
53
+ serverPort: withDefault(options.serverPort, 3000),
54
+ assetsPath,
55
+ // arui-scripts считает publicPath как `${assetsPath}/`. Пустой publicPath дал бы второй
56
+ // `location /` в nginx-конфиге и nginx не поднялся бы с `duplicate location "/"`.
57
+ publicPath: withDefault(options.publicPath, `${assetsPath}/`),
58
+ docker: resolveDocker(options, debug),
59
+ nginx: resolveNginx(options),
60
+ archive: resolveArchive(options),
61
+ build: resolveBuild(options, artifact),
62
+ packageManager: resolvePackageManager(options, cwd, clientOnly),
63
+ localFiles: resolveLocalFiles(options),
64
+ };
65
+ }
66
+ function resolveDocker(options, debug) {
67
+ const docker = options.docker ?? {};
68
+ return {
69
+ variant: withDefault(docker.variant, 'runtime'),
70
+ registry: withDefault(docker.registry, ''),
71
+ baseImage: withDefault(docker.baseImage, constants_2.DEFAULT_BASE_DOCKER_IMAGE),
72
+ runFromNonRootUser: withDefault(docker.runFromNonRootUser, true),
73
+ context: withDefault(docker.context, '.'),
74
+ tempDirName: withDefault(docker.tempDirName, constants_2.DEFAULT_TEMP_DIR_NAME),
75
+ push: withDefault(docker.push, !debug),
76
+ platform: withDefault(docker.platform, 'auto'),
77
+ buildArgs: withDefault(docker.buildArgs, {}),
78
+ addNodeModulesToDockerIgnore: withDefault(docker.addNodeModulesToDockerIgnore, false),
79
+ };
80
+ }
81
+ function resolveNginx(options) {
82
+ const nginx = options.nginx ?? {};
83
+ // `false` — то же самое, что `null`: базовый конфиг не генерируется
84
+ const baseConf = nginx.baseConf || null;
85
+ return {
86
+ port: withDefault(nginx.port, constants_3.DEFAULT_NGINX_PORT),
87
+ rootPath: withDefault(nginx.rootPath, constants_3.DEFAULT_NGINX_ROOT_PATH),
88
+ enablePreviousVersionHeaders: withDefault(nginx.enablePreviousVersionHeaders, false),
89
+ baseConf: baseConf && { ...constants_3.DEFAULT_NGINX_BASE_CONF, ...baseConf },
90
+ };
91
+ }
92
+ function resolveArchive(options) {
93
+ const archive = options.archive ?? {};
94
+ return {
95
+ name: withDefault(archive.name, constants_1.DEFAULT_ARCHIVE_NAME),
96
+ tempDirName: withDefault(archive.tempDirName, constants_1.DEFAULT_ARCHIVE_TEMP_DIR_NAME),
97
+ additionalPaths: withDefault(archive.additionalPaths, constants_1.DEFAULT_ARCHIVE_ADDITIONAL_PATHS),
98
+ };
99
+ }
100
+ function resolveBuild(options, artifact) {
101
+ const build = options.build ?? {};
102
+ // архив всегда собирается на хосте — внутри tar-а собирать нечего
103
+ const isHostBuild = artifact === 'archive' || withDefault(options.docker?.variant, 'runtime') === 'runtime';
104
+ const command = withDefault(build.command, isHostBuild ? 'npm run build' : null);
105
+ return {
106
+ cleanBuildPath: withDefault(build.cleanBuildPath, isHostBuild),
107
+ command: command || null,
108
+ removeDevDependencies: withDefault(build.removeDevDependencies, isHostBuild),
109
+ };
110
+ }
111
+ function resolvePackageManager(options, cwd, clientOnly) {
112
+ const packageManager = options.packageManager ?? {};
113
+ const useYarn = withDefault(packageManager.useYarn, (0, yarn_1.detectUseYarn)(cwd));
114
+ const yarnVersion = packageManager.yarnVersion ?? (0, yarn_1.getYarnVersion)({ useYarn });
115
+ return {
116
+ useYarn,
117
+ yarnVersion,
118
+ installProductionCommand: packageManager.installProductionCommand ?? (0, yarn_1.getInstallProductionCommand)(yarnVersion),
119
+ pruneCommand: packageManager.pruneCommand ?? (0, yarn_1.getPruningCommand)({ yarnVersion, clientOnly }),
120
+ };
121
+ }
122
+ function resolveLocalFiles(options) {
123
+ const localFiles = options.localFiles ?? {};
124
+ return {
125
+ dockerfile: localFiles.dockerfile ?? null,
126
+ startScript: localFiles.startScript ?? null,
127
+ nginxConf: localFiles.nginxConf ?? null,
128
+ nginxBaseConf: localFiles.nginxBaseConf ?? null,
129
+ allowDockerfile: withDefault(localFiles.allowDockerfile, true),
130
+ allowStartScript: withDefault(localFiles.allowStartScript, true),
131
+ };
132
+ }