@common-stack/common-tools 8.5.1-alpha.1 → 8.5.1-alpha.3

package/bin/common-tools.js

@@ -11,16 +11,18 @@ import { createGenerateResolutionsCommand } from '../lib/cli/generateResolutions
 import { createUpdateDependenciesCommand } from '../lib/cli/updateDependencies.js';
 import { createSortPackageJsonCommand } from '../lib/cli/sortPackageJson.js';
 import { createUpdateDependencyVersionCommand } from '../lib/cli/updateDependencyVersion.js';
+import { createPrepWebConfigCommand } from '../lib/cli/prepWebConfig.js';
 
 const program = new Command();
 
-program.name('common-tools').description('Common CLI tools for monorepo management').version('8.2.4-alpha.5');
+program.name('cdecodecli').description('Common CLI tools for monorepo management').version('8.2.4-alpha.5');
 
 // Add all subcommands
 program.addCommand(createGenerateResolutionsCommand());
 program.addCommand(createUpdateDependenciesCommand());
 program.addCommand(createSortPackageJsonCommand());
 program.addCommand(createUpdateDependencyVersionCommand());
+program.addCommand(createPrepWebConfigCommand());
 
 // Parse and execute
 program.parse();

package/lib/cli/prepWebConfig.d.ts

@@ -0,0 +1,23 @@
+/**
+ * CLI command: prepWebConfig
+ *
+ * Generates the merged configuration (cde-webconfig.json) for a frontend server
+ * by resolving default-config.json + project config.json + environment variables.
+ *
+ * Usage:
+ *   cdecodecli prepWebConfig [options]
+ *
+ * Options:
+ *   --config   Path to project config.json (default: ./config.json)
+ *   --out      Output directory for the generated config (default: ./app)
+ *   --env-file Path to a .env file to load (falls back to ENV_FILE env var)
+ */
+import { Command } from 'commander';
+export declare function createPrepWebConfigCommand(): Command;
+export interface PrepWebConfigOptions {
+    configPath: string;
+    outputDir: string;
+    envFile?: string;
+}
+export declare function runPrepWebConfig(options: PrepWebConfigOptions): Promise<void>;
+//# sourceMappingURL=prepWebConfig.d.ts.map

package/lib/cli/prepWebConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepWebConfig.d.ts","sourceRoot":"","sources":["../../src/cli/prepWebConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgJpC,wBAAgB,0BAA0B,IAAI,OAAO,CAiBpD;AAED,MAAM,WAAW,oBAAoB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+CnF"}

package/lib/cli/prepWebConfig.js

@@ -0,0 +1,212 @@
+import { Command } from 'commander';
+import fs from 'fs';
+import path from 'path';
+import { setupConfig, updateFromConfig } from '@common-stack/rollup-vite-utils';
+
+/**
+ * CLI command: prepWebConfig
+ *
+ * Generates the merged configuration (cde-webconfig.json) for a frontend server
+ * by resolving default-config.json + project config.json + environment variables.
+ *
+ * Usage:
+ *   cdecodecli prepWebConfig [options]
+ *
+ * Options:
+ *   --config   Path to project config.json (default: ./config.json)
+ *   --out      Output directory for the generated config (default: ./app)
+ *   --env-file Path to a .env file to load (falls back to ENV_FILE env var)
+ */
+// ---------------------------------------------------------------------------
+// Value helpers
+// ---------------------------------------------------------------------------
+function coerceType(value) {
+    if (value === undefined)
+        return undefined;
+    if (value === 'true')
+        return true;
+    if (value === 'false')
+        return false;
+    if (value === 'null')
+        return null;
+    if (value === 'undefined')
+        return undefined;
+    if (/^-?\d+(\.\d+)?$/.test(value)) {
+        return parseFloat(value);
+    }
+    return value;
+}
+/**
+ * Resolves a single $ expression segment (e.g. $.env.CLIENT_URL.url.port)
+ */
+function resolveSegment(config, expr) {
+    if (typeof expr !== 'string' || !expr.startsWith('$.')) {
+        const literal = expr.replace(/^['"]|['"]$/g, '');
+        return { value: coerceType(literal), resolved: true };
+    }
+    const parts = expr.split('.').slice(1); // Remove leading '$.'
+    if (parts[0] === 'env') {
+        const envVar = parts[1];
+        const envValue = process.env[envVar];
+        if (!envValue && envValue !== '') {
+            return { value: undefined, resolved: false };
+        }
+        if (parts[2] === 'url') {
+            try {
+                const url = new URL(envValue);
+                if (parts[3] === 'pathname')
+                    return { value: url.pathname, resolved: true };
+                if (parts[3] === 'port') {
+                    if (!url.port)
+                        return { value: undefined, resolved: false };
+                    return { value: parseInt(url.port, 10), resolved: true };
+                }
+                if (parts[3] === 'hostname')
+                    return { value: url.hostname, resolved: true };
+                return { value: envValue, resolved: true };
+            }
+            catch {
+                console.warn(`Invalid URL in ${envVar}: ${envValue}`);
+                return { value: undefined, resolved: false };
+            }
+        }
+        return { value: coerceType(envValue), resolved: true };
+    }
+    // Regular config path resolution
+    const result = parts.reduce((o, p) => {
+        if (o === undefined || o === null || typeof o !== 'object')
+            return undefined;
+        return o[p];
+    }, config);
+    return { value: result, resolved: result !== undefined };
+}
+/**
+ * Resolves path expressions with chained '|' fallbacks.
+ * E.g. $.env.CLIENT_URL.url.port|$.env.LOCAL_CLIENT_URL.url.port|'3000'
+ */
+function resolvePath(config, pathExpr) {
+    if (typeof pathExpr !== 'string')
+        return pathExpr;
+    const segments = pathExpr.split('|');
+    for (let i = 0; i < segments.length; i++) {
+        const segment = segments[i].trim();
+        const { value, resolved } = resolveSegment(config, segment);
+        if (resolved && value !== undefined)
+            return value;
+        if (i === segments.length - 1) {
+            if (!segment.startsWith('$.')) {
+                return coerceType(segment.replace(/^['"]|['"]$/g, ''));
+            }
+            console.warn(`Warning: Could not resolve any fallback in expression: ${pathExpr}`);
+            return undefined;
+        }
+    }
+    return pathExpr;
+}
+/**
+ * Resolves all buildConfig values that use $.env expressions
+ */
+function resolveBuildConfig(config) {
+    const buildConfig = config.buildConfig;
+    if (!buildConfig)
+        return config;
+    const resolvedBuildConfig = {};
+    for (const [key, value] of Object.entries(buildConfig)) {
+        resolvedBuildConfig[key] = resolvePath(config, value);
+    }
+    return { ...config, buildConfig: resolvedBuildConfig };
+}
+// ---------------------------------------------------------------------------
+// Env loader
+// ---------------------------------------------------------------------------
+function loadEnv(envFilePath) {
+    let dotenv;
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-require-imports
+        dotenv = require('dotenv');
+    }
+    catch {
+        // dotenv not available – env must be set externally
+    }
+    if (!dotenv)
+        return;
+    if (envFilePath) {
+        const resolved = path.resolve(envFilePath);
+        if (fs.existsSync(resolved)) {
+            dotenv.config({ path: resolved });
+            console.log(`Loaded environment from ${resolved}`);
+        }
+        else {
+            console.warn(`Warning: Specified env file not found at ${resolved}`);
+        }
+        return;
+    }
+    // Fallback: try the conventional dev.env path
+    const defaultEnvPath = path.resolve('../../config/development/dev.env');
+    if (fs.existsSync(defaultEnvPath)) {
+        dotenv.config({ path: defaultEnvPath });
+        console.log(`Loaded environment from ${defaultEnvPath}`);
+    }
+}
+// ---------------------------------------------------------------------------
+// Command factory
+// ---------------------------------------------------------------------------
+function createPrepWebConfigCommand() {
+    const command = new Command('prepWebConfig')
+        .description('Generate merged frontend configuration (cde-webconfig.json) by resolving config.json + environment variables')
+        .option('-c, --config <path>', 'Path to project config.json', './config.json')
+        .option('-o, --out <dir>', 'Output directory for the generated config', './app')
+        .option('-e, --env-file <path>', 'Path to .env file to load (defaults to ENV_FILE env var)')
+        .action(async (options) => {
+        await runPrepWebConfig({
+            configPath: options.config,
+            outputDir: options.out,
+            envFile: options.envFile || process.env.ENV_FILE,
+        });
+    });
+    return command;
+}
+async function runPrepWebConfig(options) {
+    const projectConfigPath = path.resolve(options.configPath);
+    const outputDir = path.resolve(options.outputDir);
+    // 1. Load environment
+    loadEnv(options.envFile);
+    // 2. Verify config exists
+    if (!fs.existsSync(projectConfigPath)) {
+        console.error(`Error: Config file not found at ${projectConfigPath}`);
+        process.exit(1);
+    }
+    // 3. Merge and resolve config
+    const mergedConfig = setupConfig(projectConfigPath);
+    const resolvedConfig = resolveBuildConfig(mergedConfig);
+    // 4. Ensure output directory exists
+    if (!fs.existsSync(outputDir)) {
+        fs.mkdirSync(outputDir, { recursive: true });
+        console.log(`Created directory: ${outputDir}`);
+    }
+    // 5. Write the merged configuration
+    const finalConfigPath = path.resolve(outputDir, 'cde-webconfig.json');
+    fs.writeFileSync(finalConfigPath, JSON.stringify(resolvedConfig, null, 2));
+    console.log(`Merged configuration written to ${finalConfigPath}`);
+    // 6. Add output directory to .gitignore if not already present
+    const outDirName = path.basename(outputDir);
+    const gitignorePath = path.resolve('.gitignore');
+    let gitignoreContent = '';
+    if (fs.existsSync(gitignorePath)) {
+        gitignoreContent = fs.readFileSync(gitignorePath, 'utf8');
+    }
+    else {
+        fs.writeFileSync(gitignorePath, '');
+        console.log('Created .gitignore file');
+    }
+    if (!gitignoreContent.includes(outDirName)) {
+        fs.appendFileSync(gitignorePath, `\n${outDirName}\n`);
+        console.log(`Added "${outDirName}" to .gitignore`);
+    }
+    // 7. Update package.json from config (modules, devModules, etc.)
+    await updateFromConfig(finalConfigPath);
+    console.log('Web config preparation complete.');
+}
+
+export { createPrepWebConfigCommand, runPrepWebConfig };
+//# sourceMappingURL=prepWebConfig.js.map

package/lib/cli/prepWebConfig.js.map

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

package/lib/index.d.ts

@@ -372,5 +372,28 @@ declare function runUpdateDependencyVersion(rootDir: string, options: UpdateDepe
  */
 declare function runUpdateDependencyVersionCLI(args?: string[]): Promise<void>;
 
-export { ADD_END_NEWLINE, DEFAULT_COMMON_STACK_PACKAGES, DEFAULT_CONFIG, JSON_SPACING, buildPackageMap, createGenerateResolutionsCommand, createSortPackageJsonCommand, createUpdateDependenciesCommand, createUpdateDependencyVersionCommand, execCommand, fileExists, fileExistsSync, findConfigFile, findPackageDirectories, findPackageJsonFiles, getTargetPathsForPackage, getWorkspacePackages, loadConfig, loadConfigWithDefaults, mergeDependencies, readCDecodeConfigFile, readPackageJson, readPackageJsonSync, resolveConfigPaths, runGenerateResolutions, runGenerateResolutionsCLI, runNcuUpdate, runSortPackageJson, runSortPackageJsonCLI, runUpdateDependenciesCLI, runUpdateDependenciesCLIAction, runUpdateDependenciesWorkflow, runUpdateDependencyVersion, runUpdateDependencyVersionCLI, runYarnInstall, sortAllPackageJsonFiles, sortObjectKeys, sortPackageJsonFile, updateDependencies, updateDependencyVersions, writePackageJson, writePackageJsonSync };
-export type { CDecodeConfig, CodegenConfig, DependencyUpdateConfig, DeployVersionUpdateConfig, GenerateResolutionsOptions, PackageJson, ProjectPathsConfig, ServiceSchemasConfig, SortPackageJsonConfig, SortPackageJsonOptions, UpdateDependenciesConfig, UpdateDependenciesOptions, UpdateDependencyVersionConfig, UpdateDependencyVersionOptions };
+/**
+ * CLI command: prepWebConfig
+ *
+ * Generates the merged configuration (cde-webconfig.json) for a frontend server
+ * by resolving default-config.json + project config.json + environment variables.
+ *
+ * Usage:
+ *   cdecodecli prepWebConfig [options]
+ *
+ * Options:
+ *   --config   Path to project config.json (default: ./config.json)
+ *   --out      Output directory for the generated config (default: ./app)
+ *   --env-file Path to a .env file to load (falls back to ENV_FILE env var)
+ */
+
+declare function createPrepWebConfigCommand(): Command;
+interface PrepWebConfigOptions {
+    configPath: string;
+    outputDir: string;
+    envFile?: string;
+}
+declare function runPrepWebConfig(options: PrepWebConfigOptions): Promise<void>;
+
+export { ADD_END_NEWLINE, DEFAULT_COMMON_STACK_PACKAGES, DEFAULT_CONFIG, JSON_SPACING, buildPackageMap, createGenerateResolutionsCommand, createPrepWebConfigCommand, createSortPackageJsonCommand, createUpdateDependenciesCommand, createUpdateDependencyVersionCommand, execCommand, fileExists, fileExistsSync, findConfigFile, findPackageDirectories, findPackageJsonFiles, getTargetPathsForPackage, getWorkspacePackages, loadConfig, loadConfigWithDefaults, mergeDependencies, readCDecodeConfigFile, readPackageJson, readPackageJsonSync, resolveConfigPaths, runGenerateResolutions, runGenerateResolutionsCLI, runNcuUpdate, runPrepWebConfig, runSortPackageJson, runSortPackageJsonCLI, runUpdateDependenciesCLI, runUpdateDependenciesCLIAction, runUpdateDependenciesWorkflow, runUpdateDependencyVersion, runUpdateDependencyVersionCLI, runYarnInstall, sortAllPackageJsonFiles, sortObjectKeys, sortPackageJsonFile, updateDependencies, updateDependencyVersions, writePackageJson, writePackageJsonSync };
+export type { CDecodeConfig, CodegenConfig, DependencyUpdateConfig, DeployVersionUpdateConfig, GenerateResolutionsOptions, PackageJson, PrepWebConfigOptions, ProjectPathsConfig, ServiceSchemasConfig, SortPackageJsonConfig, SortPackageJsonOptions, UpdateDependenciesConfig, UpdateDependenciesOptions, UpdateDependencyVersionConfig, UpdateDependencyVersionOptions };

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EACH,yBAAyB,EACzB,oCAAoC,EACpC,yBAAyB,EACzB,uBAAuB,EACvB,iBAAiB,IAAI,2BAA2B,EAChD,2BAA2B,EAC3B,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,aAAa,IAAI,mBAAmB,GAC5C,MAAM,iCAAiC,CAAC;AAGzC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,EACH,yBAAyB,EACzB,oCAAoC,EACpC,yBAAyB,EACzB,uBAAuB,EACvB,iBAAiB,IAAI,2BAA2B,EAChD,2BAA2B,EAC3B,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,aAAa,IAAI,mBAAmB,GAC5C,MAAM,iCAAiC,CAAC;AAGzC,cAAc,mBAAmB,CAAC;AAGlC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,0BAA0B,CAAC;AACzC,cAAc,kCAAkC,CAAC;AACjD,cAAc,wBAAwB,CAAC"}

package/lib/index.js

@@ -8,4 +8,5 @@ export { createGenerateResolutionsCommand, runGenerateResolutions, runGenerateRe
 export { createUpdateDependenciesCommand, runUpdateDependenciesCLI, runUpdateDependenciesCLIAction } from './cli/updateDependencies.js';
 export { createSortPackageJsonCommand, runSortPackageJson, runSortPackageJsonCLI, sortAllPackageJsonFiles, sortPackageJsonFile } from './cli/sortPackageJson.js';
 export { createUpdateDependencyVersionCommand, runUpdateDependencyVersion, runUpdateDependencyVersionCLI, updateDependencyVersions } from './cli/updateDependencyVersion.js';
+export { createPrepWebConfigCommand, runPrepWebConfig } from './cli/prepWebConfig.js';
 //# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@common-stack/common-tools",
-    "version": "8.5.1-alpha.1",
+    "version": "8.5.1-alpha.3",
     "description": "Common CLI tools for monorepo management - resolution generation, dependency updates, and package.json utilities",
     "homepage": "https://github.com/cdmbase/fullstack-pro#readme",
     "bugs": {
@@ -17,6 +17,7 @@
     "module": "lib/index.js",
     "typings": "lib/index.d.ts",
     "bin": {
+        "cdecodecli": "bin/common-tools.js",
         "common-tools": "bin/common-tools.js",
         "generate-resolutions": "bin/generate-resolutions.js",
         "sort-package-json": "bin/sort-package-json.js",
@@ -38,8 +39,9 @@
         "watch": "npm run build:lib:watch"
     },
     "dependencies": {
-        "@common-stack/rollup-vite-utils": "8.5.1-alpha.1",
+        "@common-stack/rollup-vite-utils": "8.5.1-alpha.3",
         "commander": "^12.1.0",
+        "dotenv": "^16.4.0",
         "glob": "^11.0.0",
         "sort-package-json": "^2.10.0"
     },
@@ -62,7 +64,7 @@
     "publishConfig": {
         "access": "public"
     },
-    "gitHead": "2e05dc0e2a7a61f08500919ebaa3b543387827f0",
+    "gitHead": "3966f9ac59348ef1b9e78d40e0c3125f0a3d8a51",
     "typescript": {
         "definition": "lib/index.d.ts"
     }