@somewhatabstract/x 0.0.1 → 0.1.0

package/src/x-impl.ts

@@ -1,5 +1,96 @@
+import {discoverPackages} from "./discover-packages";
+import {HandledError} from "./errors";
+import {executeScript} from "./execute-script";
+import {findMatchingBins} from "./find-matching-bins";
+import {findWorkspaceRoot} from "./find-workspace-root";
 
-export function xImpl(): void {
-    const x: string = "Hello, world!";
-    console.log(x);
-};
+export interface XOptions {
+    dryRun?: boolean;
+}
+
+export interface XResult {
+    exitCode: number;
+}
+
+/**
+ * Main implementation of the x command.
+ * Finds and executes a bin script from any package in the workspace.
+ *
+ * @param scriptName - Name of the bin script to execute
+ * @param args - Arguments to pass to the script
+ * @param options - Additional options
+ * @returns Result object with exit code
+ */
+export async function xImpl(
+    scriptName: string,
+    args: string[] = [],
+    options: XOptions = {},
+): Promise<XResult> {
+    try {
+        if (!scriptName || !scriptName.trim()) {
+            throw new HandledError("Script name cannot be empty");
+        }
+        if (scriptName.includes("/") || scriptName.includes("\\")) {
+            throw new HandledError(
+                "Script name cannot contain path separators",
+            );
+        }
+
+        // Find workspace root
+        const workspaceRoot = await findWorkspaceRoot();
+
+        // Discover all packages
+        const packages = await discoverPackages(workspaceRoot);
+
+        if (packages.length === 0) {
+            throw new HandledError(
+                "No packages found in workspace. Is this a valid monorepo?",
+            );
+        }
+
+        // Find matching bins
+        const matchingBins = await findMatchingBins(packages, scriptName);
+
+        if (matchingBins.length === 0) {
+            throw new HandledError(
+                `No bin script named "${scriptName}" found in any workspace package.`,
+            );
+        }
+
+        if (matchingBins.length > 1) {
+            console.error(
+                `Multiple packages provide bin "${scriptName}". Please be more specific.`,
+            );
+            console.error("\nMatching packages:");
+            matchingBins.forEach((bin) => {
+                console.error(`  - ${bin.packageName} (${bin.packagePath})`);
+            });
+            throw new HandledError(
+                `Ambiguous bin name "${scriptName}". Found ${matchingBins.length} matches.`,
+            );
+        }
+
+        const bin = matchingBins[0];
+
+        // Dry run mode - just show what would be executed
+        if (options.dryRun) {
+            console.log(
+                `Would execute: ${bin.binName} from ${bin.packageName}`,
+            );
+            console.log(`  Binary: ${bin.binPath}`);
+            console.log(`  Arguments: ${args.join(" ")}`);
+            return {exitCode: 0};
+        }
+
+        // Execute the script
+        const exitCode = await executeScript(bin, args, workspaceRoot);
+
+        return {exitCode};
+    } catch (error) {
+        if (error instanceof HandledError) {
+            console.error(`Error: ${error.message}`);
+            return {exitCode: 1};
+        }
+        throw error;
+    }
+}

package/tsconfig-types.json

@@ -1,7 +1,5 @@
 /* Visit https://aka.ms/tsconfig to read more about this file */
 {
     "extends": "./tsconfig.json",
-    "exclude": [
-        "**/*.test.ts",
-    ],
-}
+    "exclude": ["**/*.test.ts"]
+}

package/tsconfig.json

@@ -1,19 +1,13 @@
 {
     "compilerOptions": {
         "target": "esnext",
-        "lib": [
-            "es2023"
-        ],
+        "lib": ["es2023"],
         "moduleDetection": "force",
         "module": "preserve",
         "moduleResolution": "bundler",
         "resolveJsonModule": true,
-        "types": [
-            "node"
-        ],
-        "typeRoots": [
-            "./node_modules/@types"
-        ],
+        "types": ["node"],
+        "typeRoots": ["./node_modules/@types"],
         "strict": true,
         "noUnusedLocals": true,
         "declaration": true,
@@ -23,7 +17,5 @@
         "verbatimModuleSyntax": true,
         "skipLibCheck": true
     },
-    "include": [
-        "src"
-    ]
-}
+    "include": ["src"]
+}

package/tsdown.config.ts

@@ -7,7 +7,7 @@ export default defineConfig({
     sourcemap: false,
     dts: {
         oxc: true,
-        tsconfig: "tsconfig-types.json"
+        tsconfig: "tsconfig-types.json",
     },
     plugins: [
         process.env.CODECOV_TOKEN

package/vitest.config.ts

@@ -3,6 +3,7 @@ import {defineConfig} from "vitest/config";
 export default defineConfig({
     test: {
         coverage: {
+            include: ["src/**/*.ts"],
             reporter: ["text", "json"],
         },
     },