@decaf-ts/utils 1.3.2 → 1.5.2

package/lib/esm/cli/commands/npm-link.js

@@ -0,0 +1,188 @@
+import fs from "node:fs";
+import path from "node:path";
+import { execSync } from "node:child_process";
+import { Command } from "./../command.js";
+import { readGitModulesDeep } from "./modules.js";
+import { printCommandHelp } from "./help.js";
+const options = {
+    maxTraversal: {
+        type: "string",
+        default: "2",
+    },
+    excludes: {
+        type: "string",
+        multiple: true,
+        default: ["@decaf-ts/utils", "@decaf-ts/logging"],
+    },
+    include: {
+        type: "string",
+        multiple: true,
+        default: [],
+    },
+    operation: {
+        type: "string",
+        default: "link",
+    },
+};
+function getScope(packageName) {
+    return packageName.split("/")[0] || "";
+}
+function getPackageName(packageName) {
+    return packageName.split("/")[1] || packageName;
+}
+function getDependencyList(pkg) {
+    return [
+        ...Object.keys(pkg.dependencies || {}),
+        ...Object.keys(pkg.devDependencies || {}),
+        ...Object.keys(pkg.peerDependencies || {}),
+    ];
+}
+function normalizeList(value) {
+    if (Array.isArray(value)) {
+        return value.map((item) => `${item}`.trim()).filter(Boolean);
+    }
+    if (typeof value === "string" && value.length > 0) {
+        return value
+            .split(",")
+            .map((item) => item.trim())
+            .filter(Boolean);
+    }
+    return [];
+}
+function matchesPattern(value, pattern) {
+    return (value === pattern ||
+        path.basename(value) === pattern ||
+        value.endsWith(`/${pattern}`));
+}
+export class NpmLinkCommand extends Command {
+    constructor() {
+        super("NpmLinkCommand", options);
+    }
+    help() {
+        printCommandHelp(this.log, "npm-link", "Link or unlink decaf-ts package outputs across linked modules.", "npm-link [options]", [
+            {
+                flag: "--max-traversal <depth>",
+                description: "How many nested .gitmodules levels to traverse",
+                defaultValue: "2",
+            },
+            {
+                flag: "--excludes <items...>",
+                description: "Dependency names or patterns to ignore",
+                defaultValue: "@decaf-ts/utils,@decaf-ts/logging",
+            },
+            {
+                flag: "--include <items...>",
+                description: "Module names or paths to target explicitly",
+            },
+            {
+                flag: "--operation <name>",
+                description: "Operation to run in each module",
+                defaultValue: "link",
+            },
+            {
+                flag: "-h, --help",
+                description: "Show this help text and exit",
+            },
+        ], [
+            "link creates symlinks for decaf-ts dependencies",
+            "unlink removes those links and reinstalls dependencies",
+            "any other operation is passed through to npm in each selected module",
+        ], [
+            "npm-link --operation link",
+            "npm-link --operation unlink",
+            "npm-link --operation install --include packages/app",
+        ]);
+    }
+    async run(answers) {
+        const maxTraversal = Number.parseInt(`${answers.maxTraversal || "2"}`, 10);
+        const include = normalizeList(answers.include);
+        const excludes = normalizeList(answers.excludes);
+        const defaultExcludes = ["@decaf-ts/utils", "@decaf-ts/logging"];
+        const operation = `${answers.operation || "link"}`.trim() || "link";
+        const outerPkg = JSON.parse(fs.readFileSync(path.join(process.cwd(), "package.json"), "utf8"));
+        const scope = getScope(outerPkg.name);
+        const modules = readGitModulesDeep(process.cwd(), Number.isFinite(maxTraversal) ? maxTraversal : 2);
+        const selectedModules = modules.filter((moduleName) => include.length > 0
+            ? include.some((pattern) => matchesPattern(moduleName, pattern))
+            : true);
+        const shouldIgnoreDependency = (dependency) => (excludes.length > 0 ? excludes : defaultExcludes).some((pattern) => matchesPattern(dependency, pattern));
+        for (const moduleName of selectedModules) {
+            const moduleRoot = path.join(process.cwd(), moduleName);
+            let pkg;
+            try {
+                pkg = JSON.parse(fs.readFileSync(path.join(moduleRoot, "package.json"), "utf8"));
+            }
+            catch {
+                continue;
+            }
+            const dependencies = getDependencyList(pkg).filter((dep) => dep.startsWith(scope));
+            if (operation === "link") {
+                for (const dependency of dependencies) {
+                    if (shouldIgnoreDependency(dependency))
+                        continue;
+                    const innerCodePath = dependency.endsWith("styles") ? "dist" : "lib";
+                    const packageName = getPackageName(dependency);
+                    try {
+                        const packageRoot = path.join(moduleRoot, "node_modules", scope, packageName);
+                        const dependencyTarget = path.join(moduleRoot, "node_modules", dependency);
+                        const sourcePath = path.join(process.cwd(), packageName, innerCodePath);
+                        const linkPath = path.join(packageRoot, innerCodePath);
+                        if (!fs.existsSync(sourcePath)) {
+                            console.log(`Skipping ${dependency} as it does not exist in the master repository`);
+                            continue;
+                        }
+                        console.log(`linking ${dependency} as a dependency of ${moduleName}`);
+                        fs.rmSync(dependencyTarget, { force: true, recursive: true });
+                        fs.mkdirSync(packageRoot, { recursive: true });
+                        fs.rmSync(linkPath, { force: true, recursive: true });
+                        fs.symlinkSync(path.relative(packageRoot, sourcePath), linkPath, "dir");
+                    }
+                    catch (error) {
+                        console.log(`Failed to link ${dependency} as a dependency of ${moduleName}: ${error}`);
+                        process.exit(1);
+                    }
+                }
+                continue;
+            }
+            if (operation === "unlink") {
+                for (const dependency of dependencies) {
+                    if (shouldIgnoreDependency(dependency))
+                        continue;
+                    console.log(`unlinking ${dependency} as a dependency of ${moduleName}`);
+                    try {
+                        fs.rmSync(path.join(moduleRoot, "node_modules", dependency), {
+                            force: true,
+                            recursive: true,
+                        });
+                    }
+                    catch {
+                        process.exit(1);
+                    }
+                }
+                try {
+                    execSync("npm run do-install", {
+                        cwd: moduleRoot,
+                        env: process.env,
+                        stdio: "inherit",
+                    });
+                }
+                catch {
+                    process.exit(1);
+                }
+                continue;
+            }
+            console.log(`${operation}ing ${moduleName}`);
+            try {
+                execSync(`npm ${operation}`, {
+                    cwd: moduleRoot,
+                    env: process.env,
+                    stdio: "inherit",
+                });
+            }
+            catch {
+                process.exit(1);
+            }
+        }
+    }
+}
+//# sourceMappingURL=npm-link.js.map

package/lib/esm/cli/commands/npm-link.js.map

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

package/lib/esm/cli/commands/npm-token.js

@@ -0,0 +1,79 @@
+import fs from "node:fs";
+import path from "node:path";
+import { Command } from "./../command.js";
+import { readGitModulesDeep } from "./modules.js";
+import { printCommandHelp } from "./help.js";
+const options = {
+    maxTraversal: {
+        type: "string",
+        default: "2",
+    },
+    tokenFiles: {
+        type: "string",
+        multiple: true,
+        default: [".token", ".npmtoken"],
+    },
+};
+function normalizeList(value) {
+    if (Array.isArray(value)) {
+        return value.map((item) => `${item}`.trim()).filter(Boolean);
+    }
+    if (typeof value === "string" && value.length > 0) {
+        return value
+            .split(",")
+            .map((item) => item.trim())
+            .filter(Boolean);
+    }
+    return [];
+}
+export class NpmTokenCommand extends Command {
+    constructor() {
+        super("NpmTokenCommand", options);
+    }
+    help() {
+        printCommandHelp(this.log, "npm-token", "Link token files into every module discovered in .gitmodules.", "npm-token [options]", [
+            {
+                flag: "--max-traversal <depth>",
+                description: "How many nested .gitmodules levels to traverse",
+                defaultValue: "2",
+            },
+            {
+                flag: "--token-files <files...>",
+                description: "Token files to link into each selected module",
+                defaultValue: ".token,.npmtoken",
+            },
+            {
+                flag: "-h, --help",
+                description: "Show this help text and exit",
+            },
+        ], [
+            "The command creates symlinks from each selected module back to the token files in the repository root.",
+        ], [
+            "npm-token",
+            "npm-token --token-files .token .npmtoken secrets/npm.token",
+        ]);
+    }
+    async run(answers) {
+        const maxTraversal = Number.parseInt(`${answers.maxTraversal || "2"}`, 10);
+        const tokenFiles = normalizeList(answers.tokenFiles);
+        const effectiveTokenFiles = tokenFiles.length > 0 ? tokenFiles : [".token", ".npmtoken"];
+        const modules = readGitModulesDeep(process.cwd(), Number.isFinite(maxTraversal) ? maxTraversal : 2);
+        for (const moduleName of modules) {
+            const moduleRoot = path.join(process.cwd(), moduleName);
+            try {
+                for (const tokenFile of effectiveTokenFiles) {
+                    console.log(`linking ${tokenFile} to ${moduleName}`);
+                    fs.rmSync(path.join(moduleRoot, tokenFile), {
+                        force: true,
+                        recursive: true,
+                    });
+                    fs.symlinkSync(path.join("..", tokenFile), path.join(moduleRoot, tokenFile));
+                }
+            }
+            catch {
+                process.exit(1);
+            }
+        }
+    }
+}
+//# sourceMappingURL=npm-token.js.map

package/lib/esm/cli/commands/npm-token.js.map

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

package/lib/esm/cli/commands/release-chain.js

@@ -3,6 +3,7 @@ import { DefaultCommandOptions } from "./../constants.js";
 import { dispatchReleaseChainWorkflow, runReleaseChain, } from "./../../release-chain/index.js";
 import { getPackage } from "./../../utils/index.js";
 import { execSync } from "node:child_process";
+import { printCommandHelp } from "./help.js";
 const releaseChainArgs = {
     meta: {
         type: "string",
@@ -55,6 +56,46 @@ export class ReleaseChainCommand extends Command {
     constructor() {
         super("ReleaseChain", Object.assign({}, DefaultCommandOptions, releaseChainArgs));
     }
+    help() {
+        printCommandHelp(this.log, "release-chain", "Run the release-chain workflow locally across repositories.", "release-chain [options]", [
+            { flag: "--meta <url>", description: "Meta repository URL" },
+            {
+                flag: "--branch <name>",
+                description: "Branch to update downstream repositories",
+                defaultValue: "main or detected branch",
+            },
+            {
+                flag: "--current <owner/repo>",
+                description: "Current repository slug to resume after in the chain",
+            },
+            {
+                flag: "--package <name>",
+                description: "Override detected package name",
+            },
+            {
+                flag: "--token <token>",
+                description: "GitHub token for cloning and pushing",
+            },
+            {
+                flag: "--submodule-file <file>",
+                description: "Override submodule file name",
+            },
+            {
+                flag: "--submodule-path <path>",
+                description: "Use a local submodule file instead of downloading",
+            },
+            {
+                flag: "--target-base <branch>",
+                description: "Base branch for downstream pull requests",
+            },
+            {
+                flag: "-h, --help",
+                description: "Show this help text and exit",
+            },
+        ], [
+            "Missing meta or branch values are detected from git and environment variables when possible.",
+        ]);
+    }
     async run(options) {
         const answerMap = options;
         const packageName = answerMap.package ||
@@ -83,6 +124,47 @@ export class ReleaseChainDispatchCommand extends Command {
     constructor() {
         super("ReleaseChainDispatch", Object.assign({}, DefaultCommandOptions, releaseChainArgs));
     }
+    help() {
+        printCommandHelp(this.log, "release-chain-dispatch", "Dispatch the release-chain GitHub Actions workflow.", "release-chain-dispatch [options]", [
+            { flag: "--meta <url>", description: "Meta repository URL" },
+            {
+                flag: "--branch <name>",
+                description: "Branch to evaluate in downstream repositories",
+                defaultValue: "main or detected branch",
+            },
+            {
+                flag: "--current <owner/repo>",
+                description: "Repository slug that triggered the release chain",
+            },
+            {
+                flag: "--workflow <file>",
+                description: "Workflow file name",
+                defaultValue: "release-chain.yaml",
+            },
+            {
+                flag: "--repo <owner/repo>",
+                description: "Target repository slug where the workflow lives",
+            },
+            {
+                flag: "--token <token>",
+                description: "GitHub token for dispatching workflows",
+            },
+            {
+                flag: "--ref <ref>",
+                description: "Git ref to dispatch the workflow on",
+            },
+            {
+                flag: "--target-base <branch>",
+                description: "Base branch for downstream pull requests",
+            },
+            {
+                flag: "-h, --help",
+                description: "Show this help text and exit",
+            },
+        ], [
+            "Missing meta or branch values are detected from git and environment variables when possible.",
+        ]);
+    }
     async run(options) {
         const answerMap = options;
         const metaRepo = answerMap.meta || detectRemoteUrl();

package/lib/esm/cli/commands/release-chain.js.map

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

package/lib/esm/cli/commands/run-all.js

@@ -0,0 +1,70 @@
+import fs from "node:fs";
+import path from "node:path";
+import { execSync } from "node:child_process";
+import { Command } from "./../command.js";
+import { readGitModules } from "./modules.js";
+import { printCommandHelp } from "./help.js";
+const options = {
+    basePath: {
+        type: "string",
+        default: process.cwd(),
+    },
+    command: {
+        type: "string",
+        default: undefined,
+    },
+};
+export class RunAllCommand extends Command {
+    constructor() {
+        super("RunAllCommand", options);
+    }
+    help() {
+        printCommandHelp(this.log, "run-all", "Run a shell command in every module listed in .gitmodules.", "run-all [options] --command <cmd>", [
+            {
+                flag: "--base-path <path>",
+                description: "Directory to read .gitmodules from",
+                defaultValue: "current working directory",
+            },
+            {
+                flag: "--command <cmd>",
+                description: "Shell command to execute in each module",
+            },
+            {
+                flag: "-h, --help",
+                description: "Show this help text and exit",
+            },
+        ], [
+            "The command fails fast if any module invocation fails.",
+        ], [
+            "run-all --command npm test",
+            "run-all --base-path ../repo --command npm run lint",
+        ]);
+    }
+    async run(answers) {
+        const basePath = typeof answers.basePath === "string" && answers.basePath.trim().length > 0
+            ? answers.basePath.trim()
+            : process.cwd();
+        const command = typeof answers.command === "string" ? answers.command.trim() : "";
+        if (command.length === 0) {
+            throw new Error("run-all requires a command to execute");
+        }
+        const modules = readGitModules(basePath);
+        for (const moduleName of modules) {
+            const moduleRoot = path.join(basePath, moduleName);
+            if (!fs.existsSync(moduleRoot))
+                continue;
+            console.log(`running ${command} ${moduleName}`);
+            try {
+                execSync(command, {
+                    cwd: moduleRoot,
+                    env: process.env,
+                    stdio: "inherit",
+                });
+            }
+            catch {
+                process.exit(1);
+            }
+        }
+    }
+}
+//# sourceMappingURL=run-all.js.map

package/lib/esm/cli/commands/run-all.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-all.js","sourceRoot":"","sources":["../../../../src/cli/commands/run-all.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE9C,OAAO,EAAE,OAAO,EAAE,wBAAmB;AAErC,OAAO,EAAE,cAAc,EAAE,qBAAkB;AAC3C,OAAO,EAAE,gBAAgB,EAAE,kBAAe;AAE1C,MAAM,OAAO,GAAG;IACd,QAAQ,EAAE;QACR,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,OAAO,CAAC,GAAG,EAAE;KACvB;IACD,OAAO,EAAE;QACP,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,SAAS;KACnB;CACF,CAAC;AAEF,MAAM,OAAO,aAAc,SAAQ,OAA6B;IAC9D;QACE,KAAK,CAAC,eAAe,EAAE,OAAO,CAAC,CAAC;IAClC,CAAC;IAEkB,IAAI;QACrB,gBAAgB,CACd,IAAI,CAAC,GAAG,EACR,SAAS,EACT,4DAA4D,EAC5D,mCAAmC,EACnC;YACE;gBACE,IAAI,EAAE,oBAAoB;gBAC1B,WAAW,EAAE,oCAAoC;gBACjD,YAAY,EAAE,2BAA2B;aAC1C;YACD;gBACE,IAAI,EAAE,iBAAiB;gBACvB,WAAW,EAAE,yCAAyC;aACvD;YACD;gBACE,IAAI,EAAE,YAAY;gBAClB,WAAW,EAAE,8BAA8B;aAC5C;SACF,EACD;YACE,wDAAwD;SACzD,EACD;YACE,4BAA4B;YAC5B,oDAAoD;SACrD,CACF,CAAC;IACJ,CAAC;IAES,KAAK,CAAC,GAAG,CACjB,OAIG;QAEH,MAAM,QAAQ,GACZ,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;YACxE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE;YACzB,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC;QACpB,MAAM,OAAO,GACX,OAAO,OAAO,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAEpE,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,CAAC;QAED,MAAM,OAAO,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;QACzC,KAAK,MAAM,UAAU,IAAI,OAAO,EAAE,CAAC;YACjC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;YACnD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC;gBAAE,SAAS;YAEzC,OAAO,CAAC,GAAG,CAAC,WAAW,OAAO,IAAI,UAAU,EAAE,CAAC,CAAC;YAChD,IAAI,CAAC;gBACH,QAAQ,CAAC,OAAO,EAAE;oBAChB,GAAG,EAAE,UAAU;oBACf,GAAG,EAAE,OAAO,CAAC,GAAG;oBAChB,KAAK,EAAE,SAAS;iBACjB,CAAC,CAAC;YACL,CAAC;YAAC,MAAM,CAAC;gBACP,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;IACH,CAAC;CACF"}