expensify-common 2.0.194 → 2.0.196

package/dist/CLI.d.ts

@@ -149,6 +149,11 @@ declare class CLI<TConfig extends CLIConfig> {
     readonly positionalArgs: ParsedPositionalArgs<TConfig['positionalArgs']>;
     constructor(config: TConfig);
     private printHelp;
+    /**
+     * Attempts to detect the command used to invoke the currently-running script, for display in the usage line of the help message.
+     * Checked in order of most to least reliable signal; falls back to plain `node` if nothing else matches.
+     */
+    private static detectRuntimeCommand;
     private static parseStringArg;
     /**
      * Prompts the user for confirmation and returns true if they confirm (y/yes), false otherwise.

package/dist/CLI.js

@@ -205,7 +205,7 @@ class CLI {
             .map((key) => `[--${key} <value>]`)
             .join(' ');
         const flagUsage = [...Object.keys(flags), '--yes', '--no', '--help'].map((key) => `[${key.startsWith('--') ? key : `--${key}`}]`).join(' ');
-        console.log(`\nUsage: npx ts-node ${scriptName} ${flagUsage} ${namedArgUsage} ${positionalUsage}\n`);
+        console.log(`\nUsage: ${CLI.detectRuntimeCommand()} ${scriptName} ${flagUsage} ${namedArgUsage} ${positionalUsage}\n`);
         console.log('Flags:');
         for (const [name, spec] of Object.entries(flags)) {
             console.log(`  --${name.padEnd(20)} ${spec.description}`);
@@ -233,6 +233,25 @@ class CLI {
             console.log('');
         }
     }
+    /**
+     * Attempts to detect the command used to invoke the currently-running script, for display in the usage line of the help message.
+     * Checked in order of most to least reliable signal; falls back to plain `node` if nothing else matches.
+     */
+    static detectRuntimeCommand() {
+        // Bun's own public, documented signal. Cast needed since @types/node's ProcessVersions type has no `bun` key.
+        if (process.versions.bun) {
+            return 'bun';
+        }
+        // Internal symbol ts-node sets on `process` when its register hook is active (the same mechanism other tools, e.g. fastify-autoload, rely on to detect ts-node).
+        if (Reflect.get(process, Symbol.for('ts-node.register.instance'))) {
+            return 'npx ts-node';
+        }
+        // tsx registers its loader hooks via --require/--import flags pointing into its own package, visible in execArgv regardless of how it was installed.
+        if (process.execArgv.some((arg) => arg.includes('tsx/dist/'))) {
+            return 'npx tsx';
+        }
+        return 'node';
+    }
     static parseStringArg(rawString, paramName, spec) {
         if ('parse' in spec && !!spec.parse) {
             try {

package/dist/esm/CLI.d.ts

@@ -149,6 +149,11 @@ declare class CLI<TConfig extends CLIConfig> {
     readonly positionalArgs: ParsedPositionalArgs<TConfig['positionalArgs']>;
     constructor(config: TConfig);
     private printHelp;
+    /**
+     * Attempts to detect the command used to invoke the currently-running script, for display in the usage line of the help message.
+     * Checked in order of most to least reliable signal; falls back to plain `node` if nothing else matches.
+     */
+    private static detectRuntimeCommand;
     private static parseStringArg;
     /**
      * Prompts the user for confirmation and returns true if they confirm (y/yes), false otherwise.

package/dist/esm/CLI.js

@@ -167,7 +167,7 @@ class CLI {
             .map((key) => `[--${key} <value>]`)
             .join(' ');
         const flagUsage = [...Object.keys(flags), '--yes', '--no', '--help'].map((key) => `[${key.startsWith('--') ? key : `--${key}`}]`).join(' ');
-        console.log(`\nUsage: npx ts-node ${scriptName} ${flagUsage} ${namedArgUsage} ${positionalUsage}\n`);
+        console.log(`\nUsage: ${CLI.detectRuntimeCommand()} ${scriptName} ${flagUsage} ${namedArgUsage} ${positionalUsage}\n`);
         console.log('Flags:');
         for (const [name, spec] of Object.entries(flags)) {
             console.log(`  --${name.padEnd(20)} ${spec.description}`);
@@ -195,6 +195,25 @@ class CLI {
             console.log('');
         }
     }
+    /**
+     * Attempts to detect the command used to invoke the currently-running script, for display in the usage line of the help message.
+     * Checked in order of most to least reliable signal; falls back to plain `node` if nothing else matches.
+     */
+    static detectRuntimeCommand() {
+        // Bun's own public, documented signal. Cast needed since @types/node's ProcessVersions type has no `bun` key.
+        if (process.versions.bun) {
+            return 'bun';
+        }
+        // Internal symbol ts-node sets on `process` when its register hook is active (the same mechanism other tools, e.g. fastify-autoload, rely on to detect ts-node).
+        if (Reflect.get(process, Symbol.for('ts-node.register.instance'))) {
+            return 'npx ts-node';
+        }
+        // tsx registers its loader hooks via --require/--import flags pointing into its own package, visible in execArgv regardless of how it was installed.
+        if (process.execArgv.some((arg) => arg.includes('tsx/dist/'))) {
+            return 'npx tsx';
+        }
+        return 'node';
+    }
     static parseStringArg(rawString, paramName, spec) {
         if ('parse' in spec && !!spec.parse) {
             try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expensify-common",
-  "version": "2.0.194",
+  "version": "2.0.196",
   "author": "Expensify, Inc.",
   "description": "Expensify libraries and components shared across different repos",
   "homepage": "https://expensify.com",