@vltpkg/cmd-shim 0.0.0-9

package/LICENSE

@@ -0,0 +1,89 @@
+This is a fork and combination of "cmd-shim" and "read-cmd-shim".
+
+
+"cmd-shim" is used under the terms of the following license:
+------------------------------------------------------------
+The ISC License
+
+Copyright (c) npm, Inc. and Contributors
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
+SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR
+IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+------------------------------------------------------------
+
+"read-cmd-shim" is used under the terms of the following license:
+------------------------------------------------------------
+Copyright (c) 2015, Rebecca Turner <me@re-becca.org>
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
+SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR
+IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
+------------------------------------------------------------
+
+
+All additions and changes in this fork are released under the following
+license:
+------------------------------------------------------------
+Copyright (c) vlt technology, Inc.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+
+Subject to the terms and conditions of this license, each copyright holder and
+contributor hereby grants to those receiving rights under this license a
+perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+(except for failure to satisfy the conditions of this license) patent license
+to make, have made, use, offer to sell, sell, import, and otherwise transfer
+this software, where such license applies only to those patent claims, already
+acquired or hereafter acquired, licensable by such copyright holder or
+contributor that are necessarily infringed by:
+
+(a) their Contribution(s) (the licensed copyrights of copyright holders and
+non-copyrightable additions of contributors, in source or binary form) alone;
+or
+(b) combination of their Contribution(s) with the work of authorship to which
+such Contribution(s) was added by such copyright holder or contributor, if, at
+the time the Contribution is added, such addition causes such combination to be
+necessarily infringed. The patent license shall not apply to any other
+combinations which include the Contribution.
+
+Except as expressly stated above, no rights or licenses from any copyright
+holder or contributor is granted under this license, whether expressly, by
+implication, estoppel or otherwise.
+
+DISCLAIMER
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+------------------------------------------------------------

package/README.md

@@ -0,0 +1,36 @@
+# @vltpkg/cmd-shim
+
+This is a module for writing `.cmd` and `.ps1` shims for executables
+on Windows, since shebangs are not supported on Windows, and thus
+symlinks are not sufficient for running executables.
+
+**[Usage](#usage)** · **[Note](#note)**
+
+## Overview
+
+This module doesn't do anything on non-Windows platforms.
+
+On Windows platforms, it parses the `#!` (shebang) line of a script,
+and figures out how to write the appropriate `.cmd` shim for it.
+
+The behavior is just like creating a symlink, and it'll clobber
+anything in its way.
+
+It can also be used to determine which package a shim points to
+(assuming it was created by vlt).
+
+## Usage
+
+```js
+import { cmdShim, findSource } from '@vltpkg/cmd-shim'
+
+const binFile = 'node_modules/some-pkg/bin/foo.js'
+const target = 'node_modules/.bin/foo'
+
+await cmdShim(binFile, target)
+// now the file is there
+assert(statSync(target).isFile())
+
+// prints: 'node_modules/some-pkg'
+console.error(await findSource(target))
+```

package/dist/esm/index.d.ts

@@ -0,0 +1,5 @@
+import type { RollbackRemove } from '@vltpkg/rollback-remove';
+export { findCmdShim, findCmdShimIfExists, readCmdShim, readCmdShimIfExists, } from './read.ts';
+export declare const cmdShimIfExists: (from: string, to: string, remover: RollbackRemove) => Promise<void>;
+export declare const cmdShim: (from: string, to: string, remover: RollbackRemove) => Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAA;AAG7D,OAAO,EACL,WAAW,EACX,mBAAmB,EACnB,WAAW,EACX,mBAAmB,GACpB,MAAM,WAAW,CAAA;AAKlB,eAAO,MAAM,eAAe,SACpB,MAAM,MACR,MAAM,WACD,cAAc,kBAQxB,CAAA;AAED,eAAO,MAAM,OAAO,SACZ,MAAM,MACR,MAAM,WACD,cAAc,kBAYxB,CAAA"}

package/dist/esm/index.js

@@ -0,0 +1,192 @@
+// On windows, create a .cmd file.
+// Read the #! in the file to see what it uses.  The vast majority
+// of the time, this will be either:
+// "#!/usr/bin/env <prog> <args...>"
+// or:
+// "#!<prog> <args...>"
+//
+// Write a binroot/pkg.bin + ".cmd" file that has this line in it:
+// @<prog> <args...> %dp0%<target> %*
+import { chmod, mkdir, readFile, stat, writeFile, } from 'node:fs/promises';
+import { error } from '@vltpkg/error-cause';
+import { dirname, relative } from 'node:path';
+import { convertToSetCommands } from "./to-batch-syntax.js";
+export { findCmdShim, findCmdShimIfExists, readCmdShim, readCmdShimIfExists, } from "./read.js";
+const shebangExpr = /^#!\s*(?:\/usr\/bin\/env\s+(?:-S\s+)?((?:[^ \t=]+=[^ \t=]+\s+)*))?([^ \t]+)(.*)$/;
+export const cmdShimIfExists = async (from, to, remover) => {
+    try {
+        await stat(from);
+    }
+    catch {
+        return;
+    }
+    await writeShim(from, to, remover);
+};
+export const cmdShim = async (from, to, remover) => {
+    try {
+        await stat(from);
+        await writeShim(from, to, remover);
+    }
+    catch (er) {
+        throw error('Could not shim to executable file', {
+            path: from,
+            target: to,
+            cause: er,
+        });
+    }
+};
+const writeShim = async (from, to, remover) => {
+    await Promise.all([
+        remover.rm(to),
+        remover.rm(to + '.cmd'),
+        remover.rm(to + '.ps1'),
+        remover.rm(to + '.pwsh'),
+    ]);
+    // make a cmd file and a sh script
+    // First, check if the bin is a #! of some sort.
+    // If not, then assume it's something that'll be compiled, or some other
+    // sort of script, and just call it directly.
+    await mkdir(dirname(to), { recursive: true });
+    const data = await readFile(from, 'utf8').catch(() => '');
+    if (!data) {
+        return await writeShim_(from, to);
+    }
+    const firstLine = data.trim().split(/\r*\n/)[0];
+    const shebang = firstLine?.match(shebangExpr) ?? undefined;
+    return writeShim_(from, to, shebang?.[2], shebang?.[3], shebang?.[1]);
+};
+const writeShim_ = async (from, to, prog, args, variables) => {
+    let shTarget = relative(dirname(to), from);
+    let target = shTarget.split('/').join('\\');
+    let longProg;
+    let shProg = prog?.split('\\').join('/');
+    let shLongProg;
+    let pwshProg = shProg && `"${shProg}$exe"`;
+    let pwshLongProg;
+    shTarget = shTarget.split('\\').join('/');
+    args = args || '';
+    variables = variables || '';
+    if (!prog) {
+        prog = `"%dp0%\\${target}"`;
+        shProg = `"$basedir/${shTarget}"`;
+        pwshProg = shProg;
+        args = '';
+        target = '';
+        shTarget = '';
+    }
+    else {
+        longProg = `"%dp0%\\${prog}.exe"`;
+        shLongProg = `"$basedir/${prog}"`;
+        pwshLongProg = `"$basedir/${prog}$exe"`;
+        target = `"%dp0%\\${target}"`;
+        shTarget = `"$basedir/${shTarget}"`;
+    }
+    // Subroutine trick to fix https://github.com/npm/cmd-shim/issues/10
+    // and https://github.com/npm/cli/issues/969
+    const head = '@ECHO off\r\n' +
+        'GOTO start\r\n' +
+        ':find_dp0\r\n' +
+        'SET dp0=%~dp0\r\n' +
+        'EXIT /b\r\n' +
+        ':start\r\n' +
+        'SETLOCAL\r\n' +
+        'CALL :find_dp0\r\n';
+    let cmd;
+    if (longProg) {
+        /* c8 ignore next */
+        shLongProg = (shLongProg ?? '').trim();
+        args = args.trim();
+        const variablesBatch = convertToSetCommands(variables);
+        cmd =
+            `${head}${variablesBatch}\r\n` +
+                `IF EXIST ${longProg} (\r\n` +
+                `  SET "_prog=${longProg.replace(/(^")|("$)/g, '')}"\r\n` +
+                ') ELSE (\r\n' +
+                `  SET "_prog=${prog.replace(/(^")|("$)/g, '')}"\r\n` +
+                '  SET PATHEXT=%PATHEXT:;.JS;=;%\r\n' +
+                ')\r\n' +
+                '\r\n' +
+                // prevent "Terminate Batch Job? (Y/n)" message
+                // https://github.com/npm/cli/issues/969#issuecomment-737496588
+                'endLocal & goto #_undefined_# 2>NUL || title %COMSPEC% & ' +
+                `"%_prog%" ${args} ${target} %*\r\n`;
+    }
+    else {
+        cmd = `${head}${prog} ${args} ${target} %*\r\n`;
+    }
+    let sh = '#!/bin/sh\n' +
+        `basedir=$(dirname "$(echo "$0" | sed -e 's,\\\\,/,g')")\n` +
+        '\n' +
+        'case `uname` in\n' +
+        '    *CYGWIN*|*MINGW*|*MSYS*)\n' +
+        '        if command -v cygpath > /dev/null 2>&1; then\n' +
+        '            basedir=`cygpath -w "$basedir"`\n' +
+        '        fi\n' +
+        '    ;;\n' +
+        'esac\n' +
+        '\n';
+    if (shLongProg) {
+        sh +=
+            `if [ -x ${shLongProg} ]; then\n` +
+                `  exec ${variables}${shLongProg} ${args} ${shTarget} "$@"\n` +
+                'else \n' +
+                `  exec ${variables}${shProg} ${args} ${shTarget} "$@"\n` +
+                'fi\n';
+    }
+    else {
+        sh += `exec ${shProg} ${args} ${shTarget} "$@"\n`;
+    }
+    let pwsh = '#!/usr/bin/env pwsh\n' +
+        '$basedir=Split-Path $MyInvocation.MyCommand.Definition -Parent\n' +
+        '\n' +
+        '$exe=""\n' +
+        'if ($PSVersionTable.PSVersion -lt "6.0" -or $IsWindows) {\n' +
+        '  # Fix case when both the Windows and Linux builds of Node\n' +
+        '  # are installed in the same directory\n' +
+        '  $exe=".exe"\n' +
+        '}\n';
+    if (shLongProg) {
+        pwsh +=
+            '$ret=0\n' +
+                `if (Test-Path ${pwshLongProg}) {\n` +
+                '  # Support pipeline input\n' +
+                '  if ($MyInvocation.ExpectingInput) {\n' +
+                `    $input | & ${pwshLongProg} ${args} ${shTarget} $args\n` +
+                '  } else {\n' +
+                `    & ${pwshLongProg} ${args} ${shTarget} $args\n` +
+                '  }\n' +
+                '  $ret=$LASTEXITCODE\n' +
+                '} else {\n' +
+                '  # Support pipeline input\n' +
+                '  if ($MyInvocation.ExpectingInput) {\n' +
+                `    $input | & ${pwshProg} ${args} ${shTarget} $args\n` +
+                '  } else {\n' +
+                `    & ${pwshProg} ${args} ${shTarget} $args\n` +
+                '  }\n' +
+                '  $ret=$LASTEXITCODE\n' +
+                '}\n' +
+                'exit $ret\n';
+    }
+    else {
+        pwsh +=
+            '# Support pipeline input\n' +
+                'if ($MyInvocation.ExpectingInput) {\n' +
+                `  $input | & ${pwshProg} ${args} ${shTarget} $args\n` +
+                '} else {\n' +
+                `  & ${pwshProg} ${args} ${shTarget} $args\n` +
+                '}\n' +
+                'exit $LASTEXITCODE\n';
+    }
+    await Promise.all([
+        writeFile(to + '.cmd', cmd, 'utf8'),
+        writeFile(to + '.ps1', pwsh, 'utf8'),
+        writeFile(to, sh, 'utf8'),
+    ]);
+    await chmodShim(to);
+};
+const chmodShim = async (to) => await Promise.all([
+    chmod(to, 0o755),
+    chmod(to + '.cmd', 0o755),
+    chmod(to + '.ps1', 0o755),
+]);
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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","sourcesContent":["// On windows, create a .cmd file.\n// Read the #! in the file to see what it uses.  The vast majority\n// of the time, this will be either:\n// \"#!/usr/bin/env <prog> <args...>\"\n// or:\n// \"#!<prog> <args...>\"\n//\n// Write a binroot/pkg.bin + \".cmd\" file that has this line in it:\n// @<prog> <args...> %dp0%<target> %*\n\nimport {\n  chmod,\n  mkdir,\n  readFile,\n  stat,\n  writeFile,\n} from 'node:fs/promises'\n\nimport { error } from '@vltpkg/error-cause'\nimport type { RollbackRemove } from '@vltpkg/rollback-remove'\nimport { dirname, relative } from 'node:path'\nimport { convertToSetCommands } from './to-batch-syntax.ts'\nexport {\n  findCmdShim,\n  findCmdShimIfExists,\n  readCmdShim,\n  readCmdShimIfExists,\n} from './read.ts'\n\nconst shebangExpr =\n  /^#!\\s*(?:\\/usr\\/bin\\/env\\s+(?:-S\\s+)?((?:[^ \\t=]+=[^ \\t=]+\\s+)*))?([^ \\t]+)(.*)$/\n\nexport const cmdShimIfExists = async (\n  from: string,\n  to: string,\n  remover: RollbackRemove,\n) => {\n  try {\n    await stat(from)\n  } catch {\n    return\n  }\n  await writeShim(from, to, remover)\n}\n\nexport const cmdShim = async (\n  from: string,\n  to: string,\n  remover: RollbackRemove,\n) => {\n  try {\n    await stat(from)\n    await writeShim(from, to, remover)\n  } catch (er) {\n    throw error('Could not shim to executable file', {\n      path: from,\n      target: to,\n      cause: er,\n    })\n  }\n}\n\nconst writeShim = async (\n  from: string,\n  to: string,\n  remover: RollbackRemove,\n) => {\n  await Promise.all([\n    remover.rm(to),\n    remover.rm(to + '.cmd'),\n    remover.rm(to + '.ps1'),\n    remover.rm(to + '.pwsh'),\n  ])\n  // make a cmd file and a sh script\n  // First, check if the bin is a #! of some sort.\n  // If not, then assume it's something that'll be compiled, or some other\n  // sort of script, and just call it directly.\n  await mkdir(dirname(to), { recursive: true })\n  const data = await readFile(from, 'utf8').catch(() => '')\n  if (!data) {\n    return await writeShim_(from, to)\n  }\n  const firstLine = data.trim().split(/\\r*\\n/)[0]\n  const shebang = firstLine?.match(shebangExpr) ?? undefined\n  return writeShim_(\n    from,\n    to,\n    shebang?.[2],\n    shebang?.[3],\n    shebang?.[1],\n  )\n}\n\nconst writeShim_ = async (\n  from: string,\n  to: string,\n  prog?: string,\n  args?: string,\n  variables?: string,\n) => {\n  let shTarget = relative(dirname(to), from)\n  let target = shTarget.split('/').join('\\\\')\n  let longProg\n  let shProg = prog?.split('\\\\').join('/')\n  let shLongProg\n  let pwshProg = shProg && `\"${shProg}$exe\"`\n  let pwshLongProg\n  shTarget = shTarget.split('\\\\').join('/')\n  args = args || ''\n  variables = variables || ''\n  if (!prog) {\n    prog = `\"%dp0%\\\\${target}\"`\n    shProg = `\"$basedir/${shTarget}\"`\n    pwshProg = shProg\n    args = ''\n    target = ''\n    shTarget = ''\n  } else {\n    longProg = `\"%dp0%\\\\${prog}.exe\"`\n    shLongProg = `\"$basedir/${prog}\"`\n    pwshLongProg = `\"$basedir/${prog}$exe\"`\n    target = `\"%dp0%\\\\${target}\"`\n    shTarget = `\"$basedir/${shTarget}\"`\n  }\n\n  // Subroutine trick to fix https://github.com/npm/cmd-shim/issues/10\n  // and https://github.com/npm/cli/issues/969\n  const head =\n    '@ECHO off\\r\\n' +\n    'GOTO start\\r\\n' +\n    ':find_dp0\\r\\n' +\n    'SET dp0=%~dp0\\r\\n' +\n    'EXIT /b\\r\\n' +\n    ':start\\r\\n' +\n    'SETLOCAL\\r\\n' +\n    'CALL :find_dp0\\r\\n'\n\n  let cmd\n  if (longProg) {\n    /* c8 ignore next */\n    shLongProg = (shLongProg ?? '').trim()\n    args = args.trim()\n    const variablesBatch = convertToSetCommands(variables)\n    cmd =\n      `${head}${variablesBatch}\\r\\n` +\n      `IF EXIST ${longProg} (\\r\\n` +\n      `  SET \"_prog=${longProg.replace(/(^\")|(\"$)/g, '')}\"\\r\\n` +\n      ') ELSE (\\r\\n' +\n      `  SET \"_prog=${prog.replace(/(^\")|(\"$)/g, '')}\"\\r\\n` +\n      '  SET PATHEXT=%PATHEXT:;.JS;=;%\\r\\n' +\n      ')\\r\\n' +\n      '\\r\\n' +\n      // prevent \"Terminate Batch Job? (Y/n)\" message\n      // https://github.com/npm/cli/issues/969#issuecomment-737496588\n      'endLocal & goto #_undefined_# 2>NUL || title %COMSPEC% & ' +\n      `\"%_prog%\" ${args} ${target} %*\\r\\n`\n  } else {\n    cmd = `${head}${prog} ${args} ${target} %*\\r\\n`\n  }\n\n  let sh =\n    '#!/bin/sh\\n' +\n    `basedir=$(dirname \"$(echo \"$0\" | sed -e 's,\\\\\\\\,/,g')\")\\n` +\n    '\\n' +\n    'case `uname` in\\n' +\n    '    *CYGWIN*|*MINGW*|*MSYS*)\\n' +\n    '        if command -v cygpath > /dev/null 2>&1; then\\n' +\n    '            basedir=`cygpath -w \"$basedir\"`\\n' +\n    '        fi\\n' +\n    '    ;;\\n' +\n    'esac\\n' +\n    '\\n'\n\n  if (shLongProg) {\n    sh +=\n      `if [ -x ${shLongProg} ]; then\\n` +\n      `  exec ${variables}${shLongProg} ${args} ${shTarget} \"$@\"\\n` +\n      'else \\n' +\n      `  exec ${variables}${shProg} ${args} ${shTarget} \"$@\"\\n` +\n      'fi\\n'\n  } else {\n    sh += `exec ${shProg} ${args} ${shTarget} \"$@\"\\n`\n  }\n\n  let pwsh =\n    '#!/usr/bin/env pwsh\\n' +\n    '$basedir=Split-Path $MyInvocation.MyCommand.Definition -Parent\\n' +\n    '\\n' +\n    '$exe=\"\"\\n' +\n    'if ($PSVersionTable.PSVersion -lt \"6.0\" -or $IsWindows) {\\n' +\n    '  # Fix case when both the Windows and Linux builds of Node\\n' +\n    '  # are installed in the same directory\\n' +\n    '  $exe=\".exe\"\\n' +\n    '}\\n'\n\n  if (shLongProg) {\n    pwsh +=\n      '$ret=0\\n' +\n      `if (Test-Path ${pwshLongProg}) {\\n` +\n      '  # Support pipeline input\\n' +\n      '  if ($MyInvocation.ExpectingInput) {\\n' +\n      `    $input | & ${pwshLongProg} ${args} ${shTarget} $args\\n` +\n      '  } else {\\n' +\n      `    & ${pwshLongProg} ${args} ${shTarget} $args\\n` +\n      '  }\\n' +\n      '  $ret=$LASTEXITCODE\\n' +\n      '} else {\\n' +\n      '  # Support pipeline input\\n' +\n      '  if ($MyInvocation.ExpectingInput) {\\n' +\n      `    $input | & ${pwshProg} ${args} ${shTarget} $args\\n` +\n      '  } else {\\n' +\n      `    & ${pwshProg} ${args} ${shTarget} $args\\n` +\n      '  }\\n' +\n      '  $ret=$LASTEXITCODE\\n' +\n      '}\\n' +\n      'exit $ret\\n'\n  } else {\n    pwsh +=\n      '# Support pipeline input\\n' +\n      'if ($MyInvocation.ExpectingInput) {\\n' +\n      `  $input | & ${pwshProg} ${args} ${shTarget} $args\\n` +\n      '} else {\\n' +\n      `  & ${pwshProg} ${args} ${shTarget} $args\\n` +\n      '}\\n' +\n      'exit $LASTEXITCODE\\n'\n  }\n\n  await Promise.all([\n    writeFile(to + '.cmd', cmd, 'utf8'),\n    writeFile(to + '.ps1', pwsh, 'utf8'),\n    writeFile(to, sh, 'utf8'),\n  ])\n  await chmodShim(to)\n}\n\nconst chmodShim = async (to: string) =>\n  await Promise.all([\n    chmod(to, 0o755),\n    chmod(to + '.cmd', 0o755),\n    chmod(to + '.ps1', 0o755),\n  ])\n"]}

package/dist/esm/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/dist/esm/paths.d.ts

@@ -0,0 +1,2 @@
+export declare const paths: (path: string) => string[];
+//# sourceMappingURL=paths.d.ts.map

package/dist/esm/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/paths.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,KAAK,SAEP,MAAM,aAMW,CAAA"}

package/dist/esm/paths.js

@@ -0,0 +1,12 @@
+// On non-windows platforms, we only look for symlinks, not shims
+/* c8 ignore start */
+export const paths = process.platform === 'win32' ?
+    (path) => [
+        path + '.cmd',
+        path + '.ps1',
+        path,
+        path + '.pwsh',
+    ]
+    : (path) => [path];
+/* c8 ignore stop */
+//# sourceMappingURL=paths.js.map

package/dist/esm/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/paths.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,qBAAqB;AACrB,MAAM,CAAC,MAAM,KAAK,GAChB,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC;IAC5B,CAAC,IAAY,EAAE,EAAE,CAAC;QAChB,IAAI,GAAG,MAAM;QACb,IAAI,GAAG,MAAM;QACb,IAAI;QACJ,IAAI,GAAG,OAAO;KACf;IACH,CAAC,CAAC,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAA;AAC5B,oBAAoB","sourcesContent":["// On non-windows platforms, we only look for symlinks, not shims\n/* c8 ignore start */\nexport const paths =\n  process.platform === 'win32' ?\n    (path: string) => [\n      path + '.cmd',\n      path + '.ps1',\n      path,\n      path + '.pwsh',\n    ]\n  : (path: string) => [path]\n/* c8 ignore stop */\n"]}

package/dist/esm/read.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Find a matching cmd, cygwin, powershell, or symlink executable,
+ * and return the matching file and the target it references in a
+ * `[string,string]` tuple if found, or undefined if not.
+ */
+export declare const findCmdShimIfExists: (path: string) => Promise<undefined | [string, string]>;
+/**
+ * Find a matching cmd, cygwin, powershell, or symlink executable,
+ * and return the matching file and the target it references in a
+ * `[string,string]` tuple if found, or throw if not found.
+ */
+export declare const findCmdShim: (path: string) => Promise<[string, string]>;
+/**
+ * Read the specified executable shim if it exists, returning the
+ * target it references. Return undefined if it does not exist
+ * or cannot be dereferenced.
+ */
+export declare const readCmdShimIfExists: (path: string) => Promise<string | undefined>;
+/**
+ * Read the specified executable shim, returning the target
+ * it references. Raise an error if it does not exist or cannot be read.
+ */
+export declare const readCmdShim: (path: string) => Promise<string>;
+//# sourceMappingURL=read.d.ts.map

package/dist/esm/read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.d.ts","sourceRoot":"","sources":["../../src/read.ts"],"names":[],"mappings":"AAoCA;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,SACxB,MAAM,KACX,OAAO,CAAC,SAAS,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAMtC,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,WAAW,SAAgB,MAAM,8BAQ7C,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,SAAgB,MAAM,gCAUrD,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,SAAgB,MAAM,oBAmB7C,CAAA"}

package/dist/esm/read.js

@@ -0,0 +1,92 @@
+import { error } from '@vltpkg/error-cause';
+import { lstat, readFile, readlink } from 'node:fs/promises';
+import { dirname, resolve } from 'node:path';
+import { paths } from "./paths.js";
+const extractPath = (path, cmdshimContents) => {
+    if (/\.cmd$/i.test(path)) {
+        return extractPathFromCmd(cmdshimContents);
+    }
+    else if (/\.(ps1|pwsh)$/i.test(path)) {
+        return extractPathFromPowershell(cmdshimContents);
+    }
+    else {
+        return extractPathFromCygwin(cmdshimContents);
+    }
+};
+const extractPathFromPowershell = (cmdshimContents) => {
+    const matches = /"[$]basedir\/([^"]+?)"\s+[$]args/.exec(cmdshimContents);
+    return matches?.[1]?.replace(/\\/g, '/');
+};
+const extractPathFromCmd = (cmdshimContents) => {
+    const matches = /"%(?:~dp0|dp0%)\\([^"]+?)"\s+%[*]/.exec(cmdshimContents);
+    return matches?.[1]?.replace(/\\/g, '/');
+};
+const extractPathFromCygwin = (cmdshimContents) => {
+    const matches = /"[$]basedir\/([^"]+?)"\s+"[$]@"/.exec(cmdshimContents);
+    return matches?.[1]?.replace(/\\/g, '/');
+};
+/**
+ * Find a matching cmd, cygwin, powershell, or symlink executable,
+ * and return the matching file and the target it references in a
+ * `[string,string]` tuple if found, or undefined if not.
+ */
+export const findCmdShimIfExists = async (path) => {
+    path = path.replace(/\.(cmd|pwsh|ps1)$/i, '');
+    for (const p of paths(path)) {
+        const result = await readCmdShimIfExists(p);
+        if (result)
+            return [p, result];
+    }
+};
+/**
+ * Find a matching cmd, cygwin, powershell, or symlink executable,
+ * and return the matching file and the target it references in a
+ * `[string,string]` tuple if found, or throw if not found.
+ */
+export const findCmdShim = async (path) => {
+    const result = await findCmdShimIfExists(path);
+    if (result)
+        return result;
+    throw error('Could not find matching cmd shim', { path }, findCmdShim);
+};
+/**
+ * Read the specified executable shim if it exists, returning the
+ * target it references. Return undefined if it does not exist
+ * or cannot be dereferenced.
+ */
+export const readCmdShimIfExists = async (path) => {
+    try {
+        const st = await lstat(path);
+        if (st.isSymbolicLink()) {
+            return resolve(dirname(path), await readlink(path));
+        }
+        const contents = await readFile(path);
+        const destination = extractPath(path, contents.toString());
+        if (destination)
+            return resolve(dirname(path), destination);
+    }
+    catch { }
+};
+/**
+ * Read the specified executable shim, returning the target
+ * it references. Raise an error if it does not exist or cannot be read.
+ */
+export const readCmdShim = async (path) => {
+    try {
+        const st = await lstat(path);
+        if (st.isSymbolicLink()) {
+            return resolve(dirname(path), await readlink(path));
+        }
+        // create a new error to capture the stack trace from this point,
+        // instead of getting some opaque stack into node's internals
+        const contents = await readFile(path);
+        const destination = extractPath(path, contents.toString());
+        if (destination)
+            return resolve(dirname(path), destination);
+    }
+    catch (er) {
+        throw error('Could not read shim', { path, cause: er }, readCmdShim);
+    }
+    throw error('Not a valid cmd shim', { path }, readCmdShim);
+};
+//# sourceMappingURL=read.js.map

package/dist/esm/read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read.js","sourceRoot":"","sources":["../../src/read.ts"],"names":[],"mappings":"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","sourcesContent":["import { error } from '@vltpkg/error-cause'\nimport { lstat, readFile, readlink } from 'node:fs/promises'\nimport { dirname, resolve } from 'node:path'\nimport { paths } from './paths.ts'\n\nconst extractPath = (path: string, cmdshimContents: string) => {\n  if (/\\.cmd$/i.test(path)) {\n    return extractPathFromCmd(cmdshimContents)\n  } else if (/\\.(ps1|pwsh)$/i.test(path)) {\n    return extractPathFromPowershell(cmdshimContents)\n  } else {\n    return extractPathFromCygwin(cmdshimContents)\n  }\n}\n\nconst extractPathFromPowershell = (cmdshimContents: string) => {\n  const matches = /\"[$]basedir\\/([^\"]+?)\"\\s+[$]args/.exec(\n    cmdshimContents,\n  )\n  return matches?.[1]?.replace(/\\\\/g, '/')\n}\n\nconst extractPathFromCmd = (cmdshimContents: string) => {\n  const matches = /\"%(?:~dp0|dp0%)\\\\([^\"]+?)\"\\s+%[*]/.exec(\n    cmdshimContents,\n  )\n  return matches?.[1]?.replace(/\\\\/g, '/')\n}\n\nconst extractPathFromCygwin = (cmdshimContents: string) => {\n  const matches = /\"[$]basedir\\/([^\"]+?)\"\\s+\"[$]@\"/.exec(\n    cmdshimContents,\n  )\n  return matches?.[1]?.replace(/\\\\/g, '/')\n}\n\n/**\n * Find a matching cmd, cygwin, powershell, or symlink executable,\n * and return the matching file and the target it references in a\n * `[string,string]` tuple if found, or undefined if not.\n */\nexport const findCmdShimIfExists = async (\n  path: string,\n): Promise<undefined | [string, string]> => {\n  path = path.replace(/\\.(cmd|pwsh|ps1)$/i, '')\n  for (const p of paths(path)) {\n    const result = await readCmdShimIfExists(p)\n    if (result) return [p, result]\n  }\n}\n\n/**\n * Find a matching cmd, cygwin, powershell, or symlink executable,\n * and return the matching file and the target it references in a\n * `[string,string]` tuple if found, or throw if not found.\n */\nexport const findCmdShim = async (path: string) => {\n  const result = await findCmdShimIfExists(path)\n  if (result) return result\n  throw error(\n    'Could not find matching cmd shim',\n    { path },\n    findCmdShim,\n  )\n}\n\n/**\n * Read the specified executable shim if it exists, returning the\n * target it references. Return undefined if it does not exist\n * or cannot be dereferenced.\n */\nexport const readCmdShimIfExists = async (path: string) => {\n  try {\n    const st = await lstat(path)\n    if (st.isSymbolicLink()) {\n      return resolve(dirname(path), await readlink(path))\n    }\n    const contents = await readFile(path)\n    const destination = extractPath(path, contents.toString())\n    if (destination) return resolve(dirname(path), destination)\n  } catch {}\n}\n\n/**\n * Read the specified executable shim, returning the target\n * it references. Raise an error if it does not exist or cannot be read.\n */\nexport const readCmdShim = async (path: string) => {\n  try {\n    const st = await lstat(path)\n    if (st.isSymbolicLink()) {\n      return resolve(dirname(path), await readlink(path))\n    }\n    // create a new error to capture the stack trace from this point,\n    // instead of getting some opaque stack into node's internals\n    const contents = await readFile(path)\n    const destination = extractPath(path, contents.toString())\n    if (destination) return resolve(dirname(path), destination)\n  } catch (er) {\n    throw error(\n      'Could not read shim',\n      { path, cause: er },\n      readCmdShim,\n    )\n  }\n  throw error('Not a valid cmd shim', { path }, readCmdShim)\n}\n"]}

package/dist/esm/to-batch-syntax.d.ts

@@ -0,0 +1,4 @@
+export declare const convertToSetCommand: (key: string, value: string) => string;
+export declare const convertToSetCommands: (variableString: string) => string;
+export declare const replaceDollarWithPercentPair: (value: string) => string;
+//# sourceMappingURL=to-batch-syntax.d.ts.map

package/dist/esm/to-batch-syntax.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-batch-syntax.d.ts","sourceRoot":"","sources":["../../src/to-batch-syntax.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,QAAS,MAAM,SAAS,MAAM,WACd,CAAA;AAiBhD,eAAO,MAAM,oBAAoB,mBAAoB,MAAM,WAG9C,CAAA;AAEb,eAAO,MAAM,4BAA4B,UAAW,MAAM,WAezD,CAAA"}

package/dist/esm/to-batch-syntax.js

@@ -0,0 +1,28 @@
+export const convertToSetCommand = (key, value) => convertToSetCommand_(key.trim(), value.trim());
+const convertToSetCommand_ = (key, value) => key && value ?
+    `@SET ${key}=${replaceDollarWithPercentPair(value)}\r\n`
+    : '';
+const extractVariableValuePairs = (declarations) => declarations.reduce((pairs, declaration) => {
+    const [key = '', val = ''] = declaration.split('=');
+    pairs[key] = val;
+    return pairs;
+}, {});
+export const convertToSetCommands = (variableString) => Object.entries(extractVariableValuePairs(variableString.split(' ')))
+    .map(([key, val]) => convertToSetCommand(key, val))
+    .join('');
+export const replaceDollarWithPercentPair = (value) => {
+    const dollarExpressions = /\$\{?([^$@#?\- \t{}:]+)\}?/g;
+    let result = '';
+    let startIndex = 0;
+    do {
+        const match = dollarExpressions.exec(value);
+        if (match) {
+            const betweenMatches = value.substring(startIndex, match.index) || '';
+            result += betweenMatches + '%' + String(match[1]) + '%';
+            startIndex = dollarExpressions.lastIndex;
+        }
+    } while (dollarExpressions.lastIndex > 0);
+    result += value.slice(startIndex);
+    return result;
+};
+//# sourceMappingURL=to-batch-syntax.js.map

package/dist/esm/to-batch-syntax.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-batch-syntax.js","sourceRoot":"","sources":["../../src/to-batch-syntax.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,GAAW,EAAE,KAAa,EAAE,EAAE,CAChE,oBAAoB,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAA;AAEhD,MAAM,oBAAoB,GAAG,CAAC,GAAW,EAAE,KAAa,EAAE,EAAE,CAC1D,GAAG,IAAI,KAAK,CAAC,CAAC;IACZ,QAAQ,GAAG,IAAI,4BAA4B,CAAC,KAAK,CAAC,MAAM;IAC1D,CAAC,CAAC,EAAE,CAAA;AAEN,MAAM,yBAAyB,GAAG,CAAC,YAAsB,EAAE,EAAE,CAC3D,YAAY,CAAC,MAAM,CACjB,CAAC,KAA6B,EAAE,WAAW,EAAE,EAAE;IAC7C,MAAM,CAAC,GAAG,GAAG,EAAE,EAAE,GAAG,GAAG,EAAE,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IACnD,KAAK,CAAC,GAAG,CAAC,GAAG,GAAG,CAAA;IAChB,OAAO,KAAK,CAAA;AACd,CAAC,EACD,EAAE,CACH,CAAA;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,cAAsB,EAAE,EAAE,CAC7D,MAAM,CAAC,OAAO,CAAC,yBAAyB,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;KACjE,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,mBAAmB,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;KAClD,IAAI,CAAC,EAAE,CAAC,CAAA;AAEb,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,KAAa,EAAE,EAAE;IAC5D,MAAM,iBAAiB,GAAG,6BAA6B,CAAA;IACvD,IAAI,MAAM,GAAG,EAAE,CAAA;IACf,IAAI,UAAU,GAAG,CAAC,CAAA;IAClB,GAAG,CAAC;QACF,MAAM,KAAK,GAAG,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QAC3C,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,cAAc,GAClB,KAAK,CAAC,SAAS,CAAC,UAAU,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAA;YAChD,MAAM,IAAI,cAAc,GAAG,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAA;YACvD,UAAU,GAAG,iBAAiB,CAAC,SAAS,CAAA;QAC1C,CAAC;IACH,CAAC,QAAQ,iBAAiB,CAAC,SAAS,GAAG,CAAC,EAAC;IACzC,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAA;IACjC,OAAO,MAAM,CAAA;AACf,CAAC,CAAA","sourcesContent":["export const convertToSetCommand = (key: string, value: string) =>\n  convertToSetCommand_(key.trim(), value.trim())\n\nconst convertToSetCommand_ = (key: string, value: string) =>\n  key && value ?\n    `@SET ${key}=${replaceDollarWithPercentPair(value)}\\r\\n`\n  : ''\n\nconst extractVariableValuePairs = (declarations: string[]) =>\n  declarations.reduce(\n    (pairs: Record<string, string>, declaration) => {\n      const [key = '', val = ''] = declaration.split('=')\n      pairs[key] = val\n      return pairs\n    },\n    {},\n  )\n\nexport const convertToSetCommands = (variableString: string) =>\n  Object.entries(extractVariableValuePairs(variableString.split(' ')))\n    .map(([key, val]) => convertToSetCommand(key, val))\n    .join('')\n\nexport const replaceDollarWithPercentPair = (value: string) => {\n  const dollarExpressions = /\\$\\{?([^$@#?\\- \\t{}:]+)\\}?/g\n  let result = ''\n  let startIndex = 0\n  do {\n    const match = dollarExpressions.exec(value)\n    if (match) {\n      const betweenMatches =\n        value.substring(startIndex, match.index) || ''\n      result += betweenMatches + '%' + String(match[1]) + '%'\n      startIndex = dollarExpressions.lastIndex\n    }\n  } while (dollarExpressions.lastIndex > 0)\n  result += value.slice(startIndex)\n  return result\n}\n"]}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "@vltpkg/cmd-shim",
+  "description": "Executable script shims for Windows",
+  "version": "0.0.0-9",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vltpkg/vltpkg.git",
+    "directory": "src/cmd-shim"
+  },
+  "tshy": {
+    "selfLink": false,
+    "liveDev": true,
+    "dialects": [
+      "esm"
+    ],
+    "exports": {
+      "./package.json": "./package.json",
+      ".": "./src/index.ts"
+    }
+  },
+  "dependencies": {
+    "@vltpkg/error-cause": "0.0.0-9",
+    "@vltpkg/rollback-remove": "0.0.0-9"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.20.0",
+    "@types/eslint__js": "^8.42.3",
+    "@types/node": "^22.13.1",
+    "eslint": "^9.20.0",
+    "prettier": "^3.4.2",
+    "tap": "^21.1.0",
+    "tshy": "^3.0.2",
+    "typedoc": "0.27.6",
+    "typescript": "5.7.3",
+    "typescript-eslint": "^8.23.0"
+  },
+  "license": "BSD-2-Clause-Patent",
+  "engines": {
+    "node": ">=22"
+  },
+  "tap": {
+    "extends": "../../tap-config.yaml"
+  },
+  "prettier": "../../.prettierrc.js",
+  "module": "./dist/esm/index.js",
+  "type": "module",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "import": {
+        "types": "./dist/esm/index.d.ts",
+        "default": "./dist/esm/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "format": "prettier --write . --log-level warn --ignore-path ../../.prettierignore --cache",
+    "format:check": "prettier --check . --ignore-path ../../.prettierignore --cache",
+    "lint": "eslint . --fix",
+    "lint:check": "eslint .",
+    "snap": "tap",
+    "test": "tap",
+    "posttest": "tsc --noEmit",
+    "typecheck": "tsc --noEmit"
+  }
+}