symlx 0.1.11 → 0.1.13

package/README.md

@@ -14,7 +14,7 @@ In a CLI project with:
 run:
 
 ```bash
-symlx link
+symlx serve
 ```
 
 Then use your CLI normally:
@@ -23,7 +23,7 @@ Then use your CLI normally:
 awesome-cli --help
 ```
 
-Use `symlx serve` when you want temporary session-scoped links with auto-cleanup on exit.
+Use `symlx link` when you want one-shot linking without keeping a live file-watcher session open.
 
 ---
 
@@ -203,6 +203,7 @@ Current launcher inference:
 
 - `.js`, `.mjs`, `.cjs` -> Node launcher
 - `.ts`, `.tsx`, `.mts`, `.cts` -> `tsx` launcher
+- if a TypeScript target declares `#!/usr/bin/env node`, symlx fails early and tells you to use `tsx` shebang or remove shebang for launcher inference
 
 TypeScript runtime resolution order is:
 
@@ -287,6 +288,11 @@ symlx serve --collision fail
 
 Install `tsx` in the project or make `tsx` available on `PATH`.
 
+## "typescript target uses node shebang and is not directly runnable"
+
+- replace shebang with `#!/usr/bin/env tsx`
+- or remove shebang and let symlx infer launcher by file type
+
 ## "package.json not found"
 
 Run in your project root, or pass bins inline/config.

package/dist/lib/bin-targets.js

@@ -5,8 +5,10 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.prepareBinTargets = prepareBinTargets;
 const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
 const launchers_1 = require("./launchers");
 const shebang_1 = require("./shebang");
+const TYPESCRIPT_TARGET_EXTENSIONS = new Set(['.ts', '.tsx', '.mts', '.cts']);
 function isExecutable(filePath) {
     if (process.platform === 'win32') {
         return true;
@@ -53,6 +55,17 @@ function addUnsupportedWithoutShebangIssue(issues, name, target, reason) {
         hint: 'explicitly specify a shebang at the top of the target file to declare its runner',
     });
 }
+function isTypeScriptTarget(targetPath) {
+    return TYPESCRIPT_TARGET_EXTENSIONS.has(node_path_1.default.extname(targetPath).toLowerCase());
+}
+function addInvalidTypeScriptNodeShebangIssue(issues, name, target) {
+    issues.push({
+        name,
+        target,
+        reason: 'typescript target uses node shebang and is not directly runnable',
+        hint: 'use #!/usr/bin/env tsx or remove shebang to use launcher inference',
+    });
+}
 function prepareBinTargets(cwd, bin, options = {}) {
     const currentPath = options.currentPath ?? process.env.PATH;
     const preparedTargets = [];
@@ -86,7 +99,13 @@ function prepareBinTargets(cwd, bin, options = {}) {
             });
             continue;
         }
-        if ((0, shebang_1.hasShebang)(target)) {
+        const shebang = (0, shebang_1.readShebang)(target);
+        if (shebang) {
+            const shebangRuntime = (0, shebang_1.extractShebangRuntime)(shebang);
+            if (isTypeScriptTarget(target) && shebangRuntime === 'node') {
+                addInvalidTypeScriptNodeShebangIssue(issues, name, target);
+                continue;
+            }
             const executableIssue = ensureExecutable(target, stats.mode);
             if (executableIssue) {
                 issues.push({

package/dist/lib/shebang.js

@@ -4,8 +4,11 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.readShebang = readShebang;
+exports.extractShebangRuntime = extractShebangRuntime;
+exports.readShebangRuntime = readShebangRuntime;
 exports.hasShebang = hasShebang;
 const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
 function readShebang(filePath) {
     const raw = node_fs_1.default.readFileSync(filePath, 'utf8');
     const firstLine = raw.split(/\r?\n/, 1)[0]?.replace(/^\uFEFF/, '');
@@ -14,6 +17,38 @@ function readShebang(filePath) {
     }
     return firstLine;
 }
+function tokenizeShebangCommand(shebang) {
+    return shebang
+        .slice(2)
+        .trim()
+        .split(/\s+/)
+        .map((token) => token.replace(/^['"]|['"]$/g, ''))
+        .filter(Boolean);
+}
+function extractShebangRuntime(shebang) {
+    const tokens = tokenizeShebangCommand(shebang);
+    if (tokens.length === 0) {
+        return undefined;
+    }
+    const command = tokens[0];
+    const commandBase = node_path_1.default.basename(command).toLowerCase();
+    if (commandBase === 'env') {
+        // env-style shebangs can include flags before the actual runtime command.
+        const runtimeToken = tokens.slice(1).find((token) => !token.startsWith('-'));
+        if (!runtimeToken) {
+            return undefined;
+        }
+        return node_path_1.default.basename(runtimeToken).toLowerCase();
+    }
+    return commandBase;
+}
+function readShebangRuntime(filePath) {
+    const shebang = readShebang(filePath);
+    if (!shebang) {
+        return undefined;
+    }
+    return extractShebangRuntime(shebang);
+}
 function hasShebang(filePath) {
     return Boolean(readShebang(filePath));
 }

package/package.json

@@ -1,8 +1,20 @@
 {
   "name": "symlx",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "description": "Temporary local CLI bin linker",
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/emekaorji/symlx.git"
+  },
+  "homepage": "https://github.com/emekaorji/symlx#readme",
+  "bugs": {
+    "url": "https://github.com/emekaorji/symlx/issues"
+  },
+  "preferGlobal": true,
+  "publishConfig": {
+    "access": "public"
+  },
   "bin": {
     "symlx": "dist/cli.js",
     "cx": "dist/cli.js"
@@ -14,7 +26,13 @@
   "keywords": [
     "cli",
     "bin",
-    "dev"
+    "command-linker",
+    "local-cli",
+    "developer-tooling",
+    "symlink",
+    "typescript",
+    "nodejs",
+    "npm-link"
   ],
   "engines": {
     "node": ">=18.0.0"