@wpmoo/toolkit 0.9.0

package/dist/args.js

@@ -0,0 +1,259 @@
+import { basename, resolve } from 'node:path';
+import { supportedOdooVersions } from './odoo-versions.js';
+import { defaultAgentSkillsTemplateUrl, defaultComposeTemplateUrl } from './external-templates.js';
+import { defaultCommunityAddons, defaultProAddons } from './templates.js';
+import { dailyActionCommands } from './daily-actions.js';
+import { validateAddonName, validateRepoPath } from './path-validation.js';
+import { inferGitHubOwner, inferRepoPath, normalizeRepositoryUrl } from './repo-url.js';
+const commandNames = new Set([
+    'status',
+    'create',
+    'add-repo',
+    'remove-repo',
+    'add-module',
+    'remove-module',
+    'source',
+    'reset',
+    'doctor',
+    ...dailyActionCommands,
+]);
+const internalFlags = new Set(['--no-update-check']);
+export function isUpdateCheckFlag(arg) {
+    return internalFlags.has(arg);
+}
+export function stripInternalFlags(argv) {
+    return argv.filter((arg) => !isUpdateCheckFlag(arg));
+}
+export function commandFromArgs(argv) {
+    if (argv.length === 0) {
+        return { command: 'menu', argv: [] };
+    }
+    const [first, ...rest] = argv;
+    if (commandNames.has(first)) {
+        return { command: first, argv: rest };
+    }
+    if (first.startsWith('--') || first === '-h' || first === '-v') {
+        return { command: 'create', argv };
+    }
+    throw new Error(`Unknown command: ${first}`);
+}
+export function parseArgs(argv) {
+    const values = {};
+    for (let index = 0; index < argv.length; index += 1) {
+        const arg = argv[index];
+        if (!arg.startsWith('--')) {
+            throw new Error(`Unexpected argument: ${arg}`);
+        }
+        const [rawKey, inlineValue] = arg.slice(2).split('=', 2);
+        const key = rawKey.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase());
+        if (inlineValue !== undefined) {
+            values[key] = inlineValue;
+            continue;
+        }
+        const next = argv[index + 1];
+        if (!next || next.startsWith('--')) {
+            values[key] = true;
+            continue;
+        }
+        values[key] = next;
+        index += 1;
+    }
+    return { values };
+}
+function stringValue(values, key) {
+    const value = values[key];
+    return typeof value === 'string' ? value : undefined;
+}
+function listValue(value, fallback) {
+    if (!value)
+        return fallback;
+    return value
+        .split(',')
+        .map((item) => item.trim())
+        .filter(Boolean);
+}
+function validateAddons(addons) {
+    return addons.map(validateAddonName);
+}
+function valueAfter(argv, index, key) {
+    const arg = argv[index];
+    const inlineValue = arg.includes('=') ? arg.slice(arg.indexOf('=') + 1) : undefined;
+    if (inlineValue !== undefined) {
+        return { value: inlineValue, nextIndex: index };
+    }
+    const next = argv[index + 1];
+    if (!next || next.startsWith('--')) {
+        throw new Error(`Missing value for --${key}`);
+    }
+    return { value: next, nextIndex: index + 1 };
+}
+function parseSourceRepos(argv) {
+    const repos = [];
+    for (let index = 0; index < argv.length; index += 1) {
+        const arg = argv[index];
+        if (!arg.startsWith('--'))
+            continue;
+        const rawKey = arg.slice(2).split('=', 1)[0];
+        const key = rawKey.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase());
+        if (key === 'sourceRepoUrl') {
+            const parsed = valueAfter(argv, index, rawKey);
+            repos.push({ url: normalizeRepositoryUrl(parsed.value) });
+            index = parsed.nextIndex;
+            continue;
+        }
+        if (key === 'sourcePath') {
+            const current = repos.at(-1);
+            if (!current)
+                throw new Error('--source-path must follow --source-repo-url');
+            const parsed = valueAfter(argv, index, rawKey);
+            current.path = parsed.value;
+            index = parsed.nextIndex;
+            continue;
+        }
+        if (key === 'sourceAddons') {
+            const current = repos.at(-1);
+            if (!current)
+                throw new Error('--source-addons must follow --source-repo-url');
+            const parsed = valueAfter(argv, index, rawKey);
+            current.addons = listValue(parsed.value, []);
+            index = parsed.nextIndex;
+        }
+    }
+    return repos.map((repo) => {
+        const path = validateRepoPath(repo.path?.trim() || inferRepoPath(repo.url));
+        return {
+            url: repo.url,
+            path,
+            addons: validateAddons(repo.addons?.length ? repo.addons : [path]),
+        };
+    });
+}
+function booleanValue(values, key, fallback) {
+    const value = values[key];
+    if (value === undefined)
+        return fallback;
+    if (typeof value === 'boolean')
+        return value;
+    const normalized = value.toLowerCase().trim();
+    if (['true', '1', 'yes', 'y'].includes(normalized))
+        return true;
+    if (['false', '0', 'no', 'n'].includes(normalized))
+        return false;
+    throw new Error(`Invalid boolean value for --${key}: ${value}`);
+}
+function visibilityValue(values) {
+    const value = stringValue(values, 'repoVisibility') ?? 'private';
+    if (value === 'private' || value === 'public') {
+        return value;
+    }
+    throw new Error(`Invalid value for --repo-visibility: ${value}`);
+}
+function engineValue(values) {
+    const value = stringValue(values, 'engine') ?? 'compose';
+    if (value === 'compose') {
+        return value;
+    }
+    throw new Error(`Invalid value for --engine: ${value}`);
+}
+function assertNoRemovedDevelopmentPackFlags(argv) {
+    for (const arg of argv) {
+        const rawKey = arg.startsWith('--') ? arg.slice(2).split('=', 1)[0] : '';
+        if (rawKey === 'pack' || rawKey === 'no-packs') {
+            throw new Error('Optional development packs were removed. See the WPMoo Development Guidelines in README.md.');
+        }
+    }
+}
+export function defaultTargetForProduct(product, cwd = process.cwd()) {
+    const devRepo = `${product}_dev`;
+    return basename(cwd) === devRepo ? cwd : resolve(cwd, devRepo);
+}
+export function optionsFromArgs(argv) {
+    assertNoRemovedDevelopmentPackFlags(argv);
+    const { values } = parseArgs(argv);
+    const product = stringValue(values, 'product');
+    if (!product) {
+        return undefined;
+    }
+    const parsedSourceRepos = parseSourceRepos(argv);
+    const hasLegacySourceConfig = [
+        'org',
+        'communityRepo',
+        'communityRepoUrl',
+        'communityAddons',
+        'proRepo',
+        'proRepoUrl',
+        'proAddons',
+    ].some((key) => values[key] !== undefined);
+    if (parsedSourceRepos.length === 0 && !hasLegacySourceConfig) {
+        throw new Error('Missing --source-repo-url. Provide at least one source repository URL.');
+    }
+    const org = stringValue(values, 'org') ?? inferGitHubOwner(parsedSourceRepos[0]?.url ?? '') ?? 'example-org';
+    const odooVersion = stringValue(values, 'odooVersion') ?? supportedOdooVersions[0];
+    const engine = engineValue(values);
+    const installAgentSkillsTemplate = booleanValue(values, 'agentSkillsTemplate', values.agentSkillsTemplateUrl !== undefined);
+    const devRepoUrl = normalizeRepositoryUrl(stringValue(values, 'devRepoUrl') ?? `https://github.com/${org}/${product}_dev.git`);
+    const devRepo = stringValue(values, 'devRepo') ?? inferRepoPath(devRepoUrl);
+    const communityRepo = validateRepoPath(stringValue(values, 'communityRepo') ?? product);
+    const proRepo = validateRepoPath(stringValue(values, 'proRepo') ?? `${product}_pro`);
+    const targetValue = stringValue(values, 'target');
+    const target = targetValue ? resolve(targetValue) : defaultTargetForProduct(product);
+    const communityRepoUrl = normalizeRepositoryUrl(stringValue(values, 'communityRepoUrl') ?? `https://github.com/${org}/${communityRepo}.git`);
+    const proRepoUrl = normalizeRepositoryUrl(stringValue(values, 'proRepoUrl') ?? `https://github.com/${org}/${proRepo}.git`);
+    const communityAddons = validateAddons(listValue(stringValue(values, 'communityAddons'), defaultCommunityAddons(product)));
+    const proAddons = validateAddons(listValue(stringValue(values, 'proAddons'), defaultProAddons(product)));
+    const hasExplicitProRepo = values.proRepo !== undefined || values.proRepoUrl !== undefined || values.proAddons !== undefined;
+    const sourceRepos = parsedSourceRepos.length > 0
+        ? parsedSourceRepos
+        : [
+            {
+                url: communityRepoUrl,
+                path: communityRepo,
+                addons: communityAddons,
+            },
+            ...(hasExplicitProRepo
+                ? [
+                    {
+                        url: proRepoUrl,
+                        path: proRepo,
+                        addons: proAddons,
+                    },
+                ]
+                : []),
+        ].filter((repo) => repo.url && repo.path && repo.addons.length);
+    return {
+        product,
+        org,
+        odooVersion,
+        engine,
+        composeTemplateUrl: stringValue(values, 'composeTemplateUrl') ?? defaultComposeTemplateUrl,
+        composeTemplateRef: stringValue(values, 'composeTemplateRef'),
+        agentSkillsTemplateUrl: installAgentSkillsTemplate
+            ? stringValue(values, 'agentSkillsTemplateUrl') ?? defaultAgentSkillsTemplateUrl
+            : undefined,
+        agentSkillsTemplateRef: stringValue(values, 'agentSkillsTemplateRef'),
+        postgresVersion: stringValue(values, 'postgresVersion'),
+        httpPort: stringValue(values, 'httpPort'),
+        geventPort: stringValue(values, 'geventPort'),
+        devRepo,
+        devRepoUrl,
+        communityRepo,
+        proRepo,
+        communityRepoUrl,
+        proRepoUrl,
+        communityAddons,
+        proAddons,
+        sourceRepos,
+        target,
+        dryRun: booleanValue(values, 'dryRun', false),
+        initEmptyRepos: booleanValue(values, 'initEmptyRepos', false),
+        stage: booleanValue(values, 'stage', true),
+        createMissingRepos: booleanValue(values, 'createMissingRepos', false),
+        repoVisibility: visibilityValue(values),
+    };
+}
+export function isHelpRequested(argv) {
+    return argv.includes('--help') || argv.includes('-h');
+}
+export function isVersionRequested(argv) {
+    return argv.includes('--version') || argv.includes('-v');
+}