npm-workspaces-publish-tool 0.0.1

package/build/src/bin/cli2.js

@@ -0,0 +1,444 @@
+#!/usr/bin/env node
+import { program } from 'commander';
+import { readFileSync, writeFileSync } from 'fs';
+import { createRequire } from 'module';
+import { dirname, relative, resolve } from 'path';
+import { cwd as getCwd } from 'process';
+import semver from 'semver';
+import { createDependencyMap, getChangesBetweenRefs, getPackageInfos, getWorkspaces, git, } from 'workspace-tools';
+import { execSync } from 'child_process';
+const require = createRequire(import.meta.url);
+const pkg = require('../../package.json');
+const cwd = getCwd();
+const dependancyTypes = [
+    'dependencies',
+    'devDependencies',
+    'peerDependencies',
+    'optionalDependencies'
+];
+function getLastTag() {
+    const result = git(['tag', '--list', 'v*', '--sort=-v:refname'], { cwd });
+    if (!result.success)
+        return null;
+    const tags = result.stdout.split('\n').filter(Boolean);
+    return tags[0] || null;
+}
+function calculateWorkspaceInDegree(packageInfos, dependencies) {
+    const inDegree = new Map();
+    for (const pkgName of Object.keys(packageInfos)) {
+        inDegree.set(pkgName, 0);
+    }
+    for (const [_, deps] of dependencies) {
+        for (const dep of deps) {
+            inDegree.set(dep, (inDegree.get(dep) ?? 0) + 1);
+        }
+    }
+    return inDegree;
+}
+function getReleaseOrderFromInDegree(inDegree, dependencies) {
+    const queue = Array.from(inDegree.entries())
+        .filter(([_, count]) => count === 0)
+        .map(([pkg]) => pkg);
+    const order = [];
+    while (queue.length > 0) {
+        const current = queue.shift();
+        order.push(current);
+        if (dependencies.has(current)) {
+            for (const dependent of dependencies.get(current)) {
+                const newCount = inDegree.get(dependent) - 1;
+                inDegree.set(dependent, newCount);
+                if (newCount === 0) {
+                    queue.push(dependent);
+                }
+            }
+        }
+    }
+    return order;
+}
+function getDirtyMap(workspaces, lastTag) {
+    const dirtyMap = new Map();
+    const changedFiles = lastTag
+        ? getChangesBetweenRefs(lastTag, 'HEAD', [], '', cwd)
+        : [];
+    for (const ws of workspaces) {
+        const isNew = !lastTag;
+        const isDirty = changedFiles.some((f) => f.startsWith(ws.path + '/') || f === ws.path);
+        if (isNew) {
+            dirtyMap.set(ws.name, 'new');
+        }
+        else if (isDirty) {
+            dirtyMap.set(ws.name, 'dirty');
+        }
+        else {
+            dirtyMap.set(ws.name, 'unchanged');
+        }
+    }
+    return dirtyMap;
+}
+function getDirtyPackagesVersionChanges(workspaces, dirtyMap, lastTag, cwd) {
+    const result = new Map();
+    if (!lastTag) {
+        for (const ws of workspaces) {
+            const status = dirtyMap.get(ws.name);
+            if (status !== 'dirty' && status !== 'new')
+                continue;
+            const pkgPath = resolve(cwd, ws.path, 'package.json');
+            let currentPkg;
+            try {
+                currentPkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+            }
+            catch (err) {
+                throw new Error(`Failed to parse current package.json for package "${ws.name}" at path "${pkgPath}": ${err}`);
+            }
+            const newVersion = currentPkg.version;
+            result.set(ws.name, {
+                oldVersion: null,
+                newVersion,
+                versionChanged: true,
+                versionIncremented: true,
+            });
+        }
+        return result;
+    }
+    for (const ws of workspaces) {
+        const status = dirtyMap.get(ws.name);
+        if (status !== 'dirty' && status !== 'new')
+            continue;
+        const pkgPath = resolve(cwd, ws.path, 'package.json');
+        let currentPkg;
+        try {
+            currentPkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+        }
+        catch (err) {
+            throw new Error(`Failed to parse current package.json for package "${ws.name}" at path "${pkgPath}": ${err}`);
+        }
+        const newVersion = currentPkg.version;
+        if (status === 'new') {
+            result.set(ws.name, {
+                oldVersion: null,
+                newVersion,
+                versionChanged: true,
+                versionIncremented: true,
+            });
+            continue;
+        }
+        const previousPkgRaw = git(['show', `${lastTag}:${ws.path}/package.json`], { cwd });
+        if (!previousPkgRaw.success) {
+            result.set(ws.name, {
+                oldVersion: null,
+                newVersion,
+                versionChanged: true,
+                versionIncremented: true,
+            });
+            continue;
+        }
+        let previousPkg;
+        try {
+            previousPkg = JSON.parse(previousPkgRaw.stdout);
+        }
+        catch (err) {
+            throw new Error(`Failed to parse package.json from git at tag "${lastTag}" for package "${ws.name}": ${err}`);
+        }
+        const oldVersion = previousPkg.version;
+        const versionChanged = newVersion !== oldVersion;
+        const versionIncremented = semver.gt(newVersion, oldVersion);
+        result.set(ws.name, {
+            oldVersion,
+            newVersion,
+            versionChanged,
+            versionIncremented,
+        });
+    }
+    return result;
+}
+function verifyCleanGitStatus(workspaces, dirtyMap, cwd) {
+    const changedFilesRaw = git(['diff', '--name-only', 'HEAD'], { cwd })
+        .stdout.trim()
+        .split('\n')
+        .filter(Boolean);
+    const stagedFilesRaw = git(['diff', '--cached', '--name-only'], { cwd })
+        .stdout.trim()
+        .split('\n')
+        .filter(Boolean);
+    const unstagedFilesRaw = git(['diff', '--name-only'], { cwd })
+        .stdout.trim()
+        .split('\n')
+        .filter(Boolean);
+    const status = git(['status', '--porcelain'], { cwd })
+        .stdout.trim()
+        .split('\n')
+        .filter(Boolean);
+    const untrackedFilesRaw = status
+        .filter((line) => line.startsWith('??'))
+        .map((line) => line.slice(3));
+    const workspaceIssues = new Map();
+    for (const ws of workspaces) {
+        workspaceIssues.set(ws.name, {
+            unstagedFiles: [],
+            stagedFiles: [],
+            untrackedFiles: [],
+        });
+    }
+    function findWorkspaceForFile(filePath) {
+        const absoluteFilePath = resolve(cwd, filePath).replace(/\\/g, '/');
+        for (const ws of workspaces) {
+            const wsPathNormalized = resolve(cwd, ws.path)
+                .replace(/\\/g, '/')
+                .replace(/\/$/, '');
+            if (absoluteFilePath === wsPathNormalized ||
+                absoluteFilePath.startsWith(wsPathNormalized + '/')) {
+                return ws;
+            }
+        }
+        return undefined;
+    }
+    const changedFiles = new Set(changedFilesRaw);
+    const stagedFiles = new Set(stagedFilesRaw);
+    const unstagedFiles = new Set(unstagedFilesRaw);
+    const untrackedFiles = new Set(untrackedFilesRaw);
+    for (const filePath of changedFiles) {
+        const ws = findWorkspaceForFile(filePath);
+        if (!ws)
+            continue;
+        const status = dirtyMap.get(ws.name);
+        if (status !== 'new' && status !== 'dirty')
+            continue;
+        const issues = workspaceIssues.get(ws.name);
+        if (unstagedFiles.has(filePath)) {
+            issues.unstagedFiles.push(filePath);
+        }
+        else if (stagedFiles.has(filePath)) {
+            issues.stagedFiles.push(filePath);
+        }
+    }
+    // lets think carefully about untracked files..... if we had a new workspace that something depended on then
+    // surely its untracked files must be commited however adding an untracked folder which was not a workspace would be fine
+    // we should allow untracked files within a workspace but the entire workspace if something depends on it should not be untracked....
+    // if its part of the workspaces it should not be enitrely untracked.... but a sub folder within it would be fine..... think hard on it.
+    for (const filePath of untrackedFilesRaw) {
+        const ws = findWorkspaceForFile(filePath);
+        if (!ws)
+            continue;
+        if (dirtyMap.get(ws.name) !== 'new' &&
+            dirtyMap.get(ws.name) !== 'dirty')
+            continue;
+        workspaceIssues.get(ws.name).untrackedFiles.push(filePath);
+    }
+    let hasIssues = false;
+    for (const [wsName, issues] of workspaceIssues.entries()) {
+        const { unstagedFiles, stagedFiles, untrackedFiles } = issues;
+        if (unstagedFiles.length === 0 &&
+            stagedFiles.length === 0 &&
+            untrackedFiles.length === 0 // but we should allow untracked files its more of a warning than an error isnt it....
+        ) {
+            continue;
+        }
+        hasIssues = true;
+        console.error(`❌ Workspace '${wsName}' has issues preventing publish:`);
+        if (unstagedFiles.length > 0) {
+            console.error('  ⚠️ Unstaged files:');
+            for (const f of unstagedFiles) {
+                console.error(`    - ${f}`);
+            }
+        }
+        if (stagedFiles.length > 0) {
+            console.error('  ⚠️ Staged but uncommitted files:');
+            for (const f of stagedFiles) {
+                console.error(`    - ${f}`);
+            }
+        }
+        if (untrackedFiles.length > 0) {
+            console.error('  ⚠️ Untracked files:');
+            for (const f of untrackedFiles) {
+                console.error(`    - ${f}`);
+            }
+        }
+    }
+    const rootPackageJsonPath = 'package.json';
+    if (changedFiles.has(rootPackageJsonPath)) {
+        if (unstagedFiles.has(rootPackageJsonPath)) {
+            console.error(`❌ Root package.json has unstaged changes. Please stage or discard them.`);
+            hasIssues = true;
+        }
+        if (stagedFiles.has(rootPackageJsonPath)) {
+            console.error(`❌ Root package.json is staged but not committed. Please commit it.`);
+            hasIssues = true;
+        }
+    }
+    if (hasIssues) {
+        console.error('Please commit or stash the above changes before publishing.');
+        return false;
+    }
+    return true;
+}
+function validatePublish() {
+    const lastMonoRepoTag = getLastTag();
+    const workspaces = getWorkspaces(cwd);
+    const packageInfos = getPackageInfos(cwd);
+    const { dependencies } = createDependencyMap(packageInfos);
+    const inDegree = calculateWorkspaceInDegree(packageInfos, dependencies);
+    const releaseOrder = getReleaseOrderFromInDegree(inDegree, dependencies);
+    const dirtyMap = getDirtyMap(workspaces, lastMonoRepoTag);
+    const dirtyVersionChanges = getDirtyPackagesVersionChanges(workspaces, dirtyMap, lastMonoRepoTag, cwd);
+    let hasError = false;
+    for (const [pkgName, { oldVersion, newVersion, versionChanged, versionIncremented },] of dirtyVersionChanges.entries()) {
+        if (!semver.valid(newVersion)) {
+            console.error(`❌ Package "${pkgName}" has invalid version: "${newVersion}"`);
+            hasError = true;
+            continue;
+        }
+        if (!versionChanged) {
+            console.error(`❌ Package "${pkgName}" was modified but version unchanged (${newVersion})`);
+            hasError = true;
+            const ws = workspaces.find((w) => w.name === pkgName);
+            const changedFiles = lastMonoRepoTag
+                ? getChangesBetweenRefs(lastMonoRepoTag, 'HEAD', [], ws.path, cwd)
+                : [];
+            if (changedFiles.length > 0) {
+                console.error(`   Changed files in "${pkgName}":`);
+                for (const file of changedFiles) {
+                    console.error(`     - ${relative(ws.path, file)}`);
+                }
+            }
+            continue;
+        }
+        if (oldVersion && !versionIncremented) {
+            console.error(`❌ Package "${pkgName}" version not incremented: ${oldVersion} -> ${newVersion}`);
+            hasError = true;
+        }
+    }
+    if (hasError) {
+        console.error('\nFix the above issues before publishing.\n');
+        process.exit(1);
+    }
+    if (!verifyCleanGitStatus(workspaces, dirtyMap, cwd)) {
+        process.exit(1);
+    }
+    console.log('\nPublish summary:\n');
+    const packagesToRelease = [];
+    for (const pkgName of releaseOrder) {
+        const status = dirtyMap.get(pkgName);
+        const versionInfo = dirtyVersionChanges.get(pkgName);
+        if (status === 'new') {
+            packagesToRelease.push(pkgName);
+            const ws = workspaces.find((w) => w.name === pkgName);
+            const currentVersion = JSON.parse(readFileSync(resolve(cwd, ws.path, 'package.json'), 'utf8')).version;
+            console.log(`🆕 ${pkgName} @ ${currentVersion} (new)`);
+        }
+        else if (status === 'dirty' && versionInfo?.versionIncremented) {
+            packagesToRelease.push(pkgName);
+            console.log(`⬆️ ${pkgName}: ${versionInfo.oldVersion} → ${versionInfo.newVersion}`);
+        }
+        else {
+            const ws = workspaces.find((w) => w.name === pkgName);
+            const currentVersion = JSON.parse(readFileSync(resolve(cwd, ws.path, 'package.json'), 'utf8')).version;
+            console.log(`✔️ ${pkgName} @ ${currentVersion} (unchanged)`);
+        }
+    }
+    return { releaseOrder, packageInfos, packagesToRelease };
+}
+function replaceWorkspaceDepsWithVersions(packageInfos, packagesToUpdate) {
+    const originals = new Map();
+    for (const pkgName of packagesToUpdate) {
+        const pkgInfo = packageInfos[pkgName];
+        const packageJsonPath = pkgInfo.packageJsonPath;
+        const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
+        originals.set(pkgName, JSON.stringify(packageJson));
+        let changed = false;
+        for (const depType of dependancyTypes) {
+            const deps = packageJson[depType];
+            if (!deps)
+                continue;
+            for (const [depName, currentSpec] of Object.entries(deps)) {
+                if (currentSpec === '*' && packageInfos[depName]) {
+                    const newVersion = packageInfos[depName].packageJson.version;
+                    deps[depName] = newVersion;
+                    changed = true;
+                    console.log(`Updated ${pkgName}'s ${depType} for ${depName} to ${newVersion}`);
+                }
+            }
+        }
+        if (changed) {
+            writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2));
+        }
+    }
+    return originals;
+}
+function restoreWorkspaceDepsToStar(packageInfos, packagesToRestore, originals) {
+    for (const pkgName of packagesToRestore) {
+        const original = originals.get(pkgName);
+        if (original) {
+            const pkgInfo = packageInfos[pkgName];
+            writeFileSync(pkgInfo.packageJsonPath, original);
+            console.log(`Restored dependencies for ${pkgName}`);
+        }
+    }
+}
+function runNpmPublishInReleaseOrder(releaseOrder, packageInfos, packagesToRelease) {
+    for (const packageName of releaseOrder) {
+        if (!packagesToRelease.includes(packageName))
+            continue;
+        const pkgInfo = packageInfos[packageName];
+        const pkgDir = dirname(pkgInfo.packageJsonPath);
+        console.log(`\nPublishing ${packageName} from ${pkgDir}...`);
+        try {
+            execSync('npm publish', {
+                cwd: pkgDir,
+                stdio: 'inherit',
+                env: { ...process.env, FORCE_COLOR: '1' }
+            });
+            console.log(`✅ Successfully published ${packageName}`);
+        }
+        catch (error) {
+            console.error(`❌ Failed to publish ${packageName}:`, error);
+            throw error;
+        }
+    }
+}
+program.name(pkg.name).description(pkg.description).version(pkg.version);
+program
+    .command('publish')
+    .description('Publish packages')
+    .option('--dry-run', 'Run without making changes')
+    .action((options) => {
+    const { packageInfos, releaseOrder, packagesToRelease } = validatePublish();
+    const dryRun = options.dryRun;
+    if (packagesToRelease.length === 0) {
+        console.log('No packages to publish');
+        return;
+    }
+    let originalPackageJsons = null;
+    try {
+        if (!dryRun) {
+            console.log('\nUpdating workspace dependencies to exact versions...');
+            originalPackageJsons = replaceWorkspaceDepsWithVersions(packageInfos, packagesToRelease);
+        }
+        else {
+            console.log('\n[dry-run] Would update workspace dependencies to exact versions');
+        }
+        if (!dryRun) {
+            console.log('\nPublishing packages...');
+            runNpmPublishInReleaseOrder(releaseOrder, packageInfos, packagesToRelease);
+            console.log('\n🎉 All packages published successfully!');
+        }
+        else {
+            console.log('\n[dry-run] Would publish packages in order:');
+            packagesToRelease.forEach(pkg => console.log(`- ${pkg}`));
+        }
+    }
+    catch (error) {
+        console.error('\nPublishing failed:', error);
+        process.exit(1);
+    }
+    finally {
+        if (!dryRun && originalPackageJsons) {
+            console.log('\nRestoring workspace dependencies...');
+            restoreWorkspaceDepsToStar(packageInfos, packagesToRelease, originalPackageJsons);
+            console.log('Restoration complete.');
+        }
+        else if (dryRun) {
+            console.log('\n[dry-run] Would restore workspace dependencies');
+        }
+    }
+});
+program.parse(process.argv);