@ecmaos/coreutils 0.2.0 → 0.3.0

package/src/commands/mktemp.ts

@@ -0,0 +1,235 @@
+import path from 'path'
+import type { Kernel, Process, Shell, Terminal } from '@ecmaos/types'
+import { TerminalCommand } from '../shared/terminal-command.js'
+import { writelnStdout, writelnStderr } from '../shared/helpers.js'
+
+/**
+ * Generate random alphanumeric characters for template replacement
+ */
+function generateRandomChars(count: number): string {
+  const chars = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz'
+  let result = ''
+  const cryptoApi = globalThis.crypto
+  if (!cryptoApi) {
+    throw new Error('Crypto API not available')
+  }
+  const randomValues = cryptoApi.getRandomValues(new Uint8Array(count))
+  for (let i = 0; i < count; i++) {
+    const randomValue = randomValues[i]
+    if (randomValue !== undefined) {
+      result += chars[randomValue % chars.length]
+    }
+  }
+  return result
+}
+
+/**
+ * Replace X's in template with random characters
+ */
+function replaceTemplate(template: string): string {
+  const xCount = (template.match(/X/g) || []).length
+  if (xCount === 0) {
+    // If no X's, append random suffix
+    return template + '.' + generateRandomChars(6)
+  }
+  
+  let result = template
+  const randomChars = generateRandomChars(xCount)
+  let charIndex = 0
+  
+  for (let i = 0; i < template.length; i++) {
+    if (template[i] === 'X') {
+      result = result.substring(0, i) + randomChars[charIndex] + result.substring(i + 1)
+      charIndex++
+    }
+  }
+  
+  return result
+}
+
+function printUsage(process: Process | undefined, terminal: Terminal): void {
+  const usage = `Usage: mktemp [OPTION]... [TEMPLATE]
+Create a temporary file or directory, safely, and print its name.
+
+  -d, --directory     create a directory, not a file
+  -q, --quiet        suppress error messages
+  -u, --dry-run      do not create anything; merely print a name (unsafe)
+  -p DIR, --tmpdir=DIR  interpret TEMPLATE relative to DIR; if DIR is not
+                        specified, use \$TMPDIR if set, else /tmp.  With
+                        this option, TEMPLATE must not be an absolute name;
+                        unlike with -t, TEMPLATE may contain slashes, but
+                        mktemp creates only the final component
+  -t                 interpret TEMPLATE relative to the directory specified by
+                        -p, or \$TMPDIR if -p is not given; if neither is
+                        specified, use /tmp [deprecated]
+  --help             display this help and exit
+
+The TEMPLATE must contain at least 3 consecutive 'X's in last component.
+If TEMPLATE is not specified, use tmp.XXXXXX, and --tmpdir implies -t.
+
+Examples:
+  mktemp                    create a temp file in /tmp
+  mktemp -d                 create a temp directory in /tmp
+  mktemp /tmp/file.XXXXXX   create a temp file with template
+  mktemp -d /tmp/dir.XXXXXX create a temp directory with template`
+  writelnStderr(process, terminal, usage)
+}
+
+export function createCommand(kernel: Kernel, shell: Shell, terminal: Terminal): TerminalCommand {
+  return new TerminalCommand({
+    command: 'mktemp',
+    description: 'Create a temporary file or directory',
+    kernel,
+    shell,
+    terminal,
+    run: async (pid: number, argv: string[]) => {
+      const process = kernel.processes.get(pid) as Process | undefined
+
+      if (!process) return 1
+
+      if (argv.length > 0 && (argv[0] === '--help' || argv[0] === '-h')) {
+        printUsage(process, terminal)
+        return 0
+      }
+
+      let createDirectory = false
+      let quiet = false
+      let dryRun = false
+      let tmpdir: string | undefined
+      let useTmpdir = false
+      let template: string | undefined
+
+      // Parse arguments
+      for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i]
+        if (!arg) continue
+
+        if (arg === '--help' || arg === '-h') {
+          printUsage(process, terminal)
+          return 0
+        } else if (arg === '-d' || arg === '--directory') {
+          createDirectory = true
+        } else if (arg === '-q' || arg === '--quiet') {
+          quiet = true
+        } else if (arg === '-u' || arg === '--dry-run') {
+          dryRun = true
+        } else if (arg === '-t') {
+          useTmpdir = true
+        } else if (arg === '-p' || arg === '--tmpdir') {
+          useTmpdir = true
+          const dirArg = argv[i + 1]
+          if (dirArg && !dirArg.startsWith('-')) {
+            tmpdir = dirArg
+            i++ // Skip the next argument as it's the directory value
+          }
+        } else if (arg.startsWith('--tmpdir=')) {
+          useTmpdir = true
+          const dirValue = arg.split('=')[1]
+          if (dirValue) {
+            tmpdir = dirValue
+          }
+        } else if (!arg.startsWith('-')) {
+          // Positional argument - should be the template
+          if (!template) {
+            template = arg
+          } else {
+            if (!quiet) {
+              await writelnStderr(process, terminal, `mktemp: too many arguments`)
+            }
+            return 1
+          }
+        } else {
+          if (!quiet) {
+            await writelnStderr(process, terminal, `mktemp: invalid option -- '${arg.replace(/^-+/, '')}'`)
+            await writelnStderr(process, terminal, `Try 'mktemp --help' for more information.`)
+          }
+          return 1
+        }
+      }
+
+      // Determine the temp directory
+      let baseDir = '/tmp'
+      if (useTmpdir) {
+        if (tmpdir) {
+          baseDir = tmpdir
+        } else {
+          // Check TMPDIR environment variable
+          const envTmpdir = shell.env.get('TMPDIR')
+          if (envTmpdir) {
+            baseDir = envTmpdir
+          }
+        }
+      }
+
+      // Resolve base directory
+      const resolvedBaseDir = path.isAbsolute(baseDir) ? baseDir : path.resolve(shell.cwd, baseDir)
+
+      // Determine template
+      if (!template) {
+        template = 'tmp.XXXXXX'
+      }
+
+      // If template is absolute and useTmpdir is set, that's an error
+      if (useTmpdir && path.isAbsolute(template)) {
+        if (!quiet) {
+          await writelnStderr(process, terminal, `mktemp: with -p/--tmpdir, TEMPLATE must not be an absolute name`)
+        }
+        return 1
+      }
+
+      // Build the full path
+      let fullPath: string
+      if (path.isAbsolute(template)) {
+        fullPath = template
+      } else {
+        fullPath = path.join(resolvedBaseDir, template)
+      }
+
+      // Check that template has at least 3 X's in the last component
+      const basename = path.basename(fullPath)
+      const xCount = (basename.match(/X/g) || []).length
+      if (xCount < 3) {
+        if (!quiet) {
+          await writelnStderr(process, terminal, `mktemp: too few X's in template ${template}`)
+        }
+        return 1
+      }
+
+      // Replace template with random characters
+      const finalPath = replaceTemplate(fullPath)
+
+      // If dry-run, just print the name
+      if (dryRun) {
+        await writelnStdout(process, terminal, finalPath)
+        return 0
+      }
+
+      // Create the file or directory
+      try {
+        if (createDirectory) {
+          await shell.context.fs.promises.mkdir(finalPath, { recursive: true })
+        } else {
+          // Create parent directory if needed
+          const parentDir = path.dirname(finalPath)
+          try {
+            await shell.context.fs.promises.mkdir(parentDir, { recursive: true })
+          } catch {
+            // Parent might already exist, ignore
+          }
+          // Create empty file
+          await shell.context.fs.promises.writeFile(finalPath, '')
+        }
+        
+        // Print the created path
+        await writelnStdout(process, terminal, finalPath)
+        return 0
+      } catch (error) {
+        if (!quiet) {
+          const errorMessage = error instanceof Error ? error.message : String(error)
+          await writelnStderr(process, terminal, `mktemp: ${errorMessage}`)
+        }
+        return 1
+      }
+    }
+  })
+}

package/src/commands/nc.ts

@@ -1,7 +1,7 @@
 import type { Kernel, Process, Shell, Terminal } from '@ecmaos/types'
 import { TerminalEvents } from '@ecmaos/types'
 import { TerminalCommand } from '../shared/terminal-command.js'
-import { writelnStderr, writelnStdout } from '../shared/helpers.js'
+import { writelnStderr } from '../shared/helpers.js'
 
 function printUsage(process: Process | undefined, terminal: Terminal): void {
   const usage = `Usage: nc [OPTIONS] <host> [port]
@@ -19,7 +19,7 @@ Examples:
   nc -p 443 echo.websocket.org
   nc -u wss://echo.websocket.org
   nc -u https://example.com:443`
-  writelnStdout(process, terminal, usage)
+  writelnStderr(process, terminal, usage)
 }
 
 interface ConnectionOptions {

package/src/commands/passkey.ts

@@ -13,7 +13,7 @@ Subcommands:
   remove-all                  Remove all passkeys
 
   --help  display this help and exit`
-  writelnStdout(process, terminal, usage)
+  writelnStderr(process, terminal, usage)
 }
 
 export function createCommand(kernel: Kernel, shell: Shell, terminal: Terminal): TerminalCommand {
@@ -186,7 +186,7 @@ export function createCommand(kernel: Kernel, shell: Shell, terminal: Terminal):
           case 'remove': {
             if (!id) {
               await writelnStderr(process, terminal, chalk.red('Error: --id is required for remove command'))
-              await writelnStdout(process, terminal, 'Usage: passkey remove --id <id>')
+              await writelnStderr(process, terminal, 'Usage: passkey remove --id <id>')
               return 1
             }
 
@@ -223,7 +223,7 @@ export function createCommand(kernel: Kernel, shell: Shell, terminal: Terminal):
 
           default:
             await writelnStderr(process, terminal, chalk.red(`Error: Unknown subcommand: ${subcommand}`))
-            await writelnStdout(process, terminal, 'Run "passkey help" for usage information')
+            await writelnStderr(process, terminal, 'Run "passkey help" for usage information')
             return 1
         }
       } catch (error) {

package/src/commands/pwd.ts

@@ -1,13 +1,13 @@
 import type { Kernel, Process, Shell, Terminal } from '@ecmaos/types'
 import { TerminalCommand } from '../shared/terminal-command.js'
-import { writelnStdout } from '../shared/helpers.js'
+import { writelnStdout, writelnStderr } from '../shared/helpers.js'
 
 function printUsage(process: Process | undefined, terminal: Terminal): void {
   const usage = `Usage: pwd
 Print the name of the current working directory.
 
   --help  display this help and exit`
-  writelnStdout(process, terminal, usage)
+  writelnStderr(process, terminal, usage)
 }
 
 export function createCommand(kernel: Kernel, shell: Shell, terminal: Terminal): TerminalCommand {

package/src/commands/rm.ts

@@ -7,7 +7,9 @@ function printUsage(process: Process | undefined, terminal: Terminal): void {
   const usage = `Usage: rm [OPTION]... FILE...
 Remove (unlink) the FILE(s).
 
-  --help  display this help and exit`
+  -f, --force     ignore nonexistent files and arguments, never prompt
+  -r, -R, --recursive   remove directories and their contents recursively
+  --help          display this help and exit`
   writelnStderr(process, terminal, usage)
 }
 
@@ -32,10 +34,32 @@ export function createCommand(kernel: Kernel, shell: Shell, terminal: Terminal):
         return 0
       }
 
+      let recursive = false
+      let force = false
       const pathArray: string[] = []
+      
       for (const arg of argv) {
         if (arg.startsWith('-') && arg !== '--') {
-          if (arg !== '-f' && arg !== '-r' && arg !== '-rf' && arg !== '-fr') {
+          // Handle combined flags like -rf, -fr, -rR, etc.
+          if (arg === '--recursive' || arg === '-R') {
+            recursive = true
+          } else if (arg === '--force') {
+            force = true
+          } else if (arg.length > 1) {
+            // Parse individual flags in combined options like -rf
+            for (let i = 1; i < arg.length; i++) {
+              const flag = arg[i]
+              if (flag === 'r' || flag === 'R') {
+                recursive = true
+              } else if (flag === 'f') {
+                force = true
+              } else {
+                await writelnStderr(process, terminal, `rm: invalid option -- '${flag}'`)
+                await writelnStderr(process, terminal, "Try 'rm --help' for more information.")
+                return 1
+              }
+            }
+          } else {
             await writelnStderr(process, terminal, `rm: invalid option -- '${arg.slice(1)}'`)
             await writelnStderr(process, terminal, "Try 'rm --help' for more information.")
             return 1
@@ -104,24 +128,42 @@ export function createCommand(kernel: Kernel, shell: Shell, terminal: Terminal):
 
       for (const target of expandedPaths) {
         if (!target || typeof target !== 'string') {
-          await writelnStderr(process, terminal, `rm: ${String(target)}: No such file or directory`)
-          hasError = true
+          if (!force) {
+            await writelnStderr(process, terminal, `rm: ${String(target)}: No such file or directory`)
+            hasError = true
+          }
           continue
         }
 
         const fullPath = path.resolve(shell.cwd, target)
 
         try {
-          const stat = await shell.context.fs.promises.stat(fullPath)
-          if (stat.isDirectory()) {
-            await shell.context.fs.promises.rmdir(fullPath)
-          } else {
-            await shell.context.fs.promises.unlink(fullPath)
+          // Check if it's a directory to validate recursive flag requirement
+          try {
+            const stat = await shell.context.fs.promises.stat(fullPath)
+            if (stat.isDirectory() && !recursive) {
+              await writelnStderr(process, terminal, `rm: ${target}: is a directory`)
+              hasError = true
+              continue
+            }
+          } catch (statError) {
+            // If stat fails, the file might not exist
+            // If force is enabled, we'll try to remove it anyway (rm will handle it)
+            // If force is not enabled, we'll let rm handle the error
           }
+
+          // Use fs.promises.rm with appropriate options
+          await shell.context.fs.promises.rm(fullPath, {
+            recursive: recursive,
+            force: force
+          })
         } catch (error) {
-          const errorMessage = error instanceof Error ? error.message : String(error)
-          await writelnStderr(process, terminal, `rm: ${target}: ${errorMessage}`)
-          hasError = true
+          // If force is enabled, ignore errors
+          if (!force) {
+            const errorMessage = error instanceof Error ? error.message : String(error)
+            await writelnStderr(process, terminal, `rm: ${target}: ${errorMessage}`)
+            hasError = true
+          }
         }
       }
 

package/src/commands/rmdir.ts

@@ -1,14 +1,14 @@
 import path from 'path'
 import type { Kernel, Process, Shell, Terminal } from '@ecmaos/types'
 import { TerminalCommand } from '../shared/terminal-command.js'
-import { writelnStdout, writelnStderr } from '../shared/helpers.js'
+import { writelnStderr } from '../shared/helpers.js'
 
 function printUsage(process: Process | undefined, terminal: Terminal): void {
   const usage = `Usage: rmdir [OPTION]... DIRECTORY...
 Remove the DIRECTORY(ies), if they are empty.
 
   --help  display this help and exit`
-  writelnStdout(process, terminal, usage)
+  writelnStderr(process, terminal, usage)
 }
 
 export function createCommand(kernel: Kernel, shell: Shell, terminal: Terminal): TerminalCommand {

package/src/commands/sockets.ts

@@ -26,7 +26,7 @@ Examples:
   sockets create https://example.com:443 -t webtransport
   sockets close abc-123-def-456
   sockets show abc-123-def-456`
-  writelnStdout(process, terminal, usage)
+  writelnStderr(process, terminal, usage)
 }
 
 function findConnectionById(kernel: Kernel, id: string): SocketConnection | undefined {

package/src/commands/stat.ts

@@ -3,14 +3,14 @@ import chalk from 'chalk'
 import * as zipjs from '@zip.js/zip.js'
 import type { Kernel, Process, Shell, Terminal } from '@ecmaos/types'
 import { TerminalCommand } from '../shared/terminal-command.js'
-import { writelnStdout } from '../shared/helpers.js'
+import { writelnStdout, writelnStderr } from '../shared/helpers.js'
 
 function printUsage(process: Process | undefined, terminal: Terminal): void {
   const usage = `Usage: stat [OPTION]... FILE...
 Display file or file system status.
 
   --help  display this help and exit`
-  writelnStdout(process, terminal, usage)
+  writelnStderr(process, terminal, usage)
 }
 
 export function createCommand(kernel: Kernel, shell: Shell, terminal: Terminal): TerminalCommand {
@@ -28,22 +28,50 @@ export function createCommand(kernel: Kernel, shell: Shell, terminal: Terminal):
         return 0
       }
 
-      const argPath = argv.length > 0 && argv[0] && !argv[0].startsWith('-') ? argv[0] : shell.cwd
-      const fullPath = argPath ? path.resolve(shell.cwd, argPath) : shell.cwd
-      const stats = await shell.context.fs.promises.stat(fullPath)
-      await writelnStdout(process, terminal, JSON.stringify(stats, null, 2))
-
-      const extension = path.extname(fullPath)
-      if (extension === '.zip') {
-        const blob = new Blob([new Uint8Array(await shell.context.fs.promises.readFile(fullPath))])
-        const zipReader = new zipjs.ZipReader(new zipjs.BlobReader(blob))
-        const entries = await zipReader.getEntries()
-        await writelnStdout(process, terminal, chalk.bold('\nZIP Entries:'))
-        for (const entry of entries) {
-          await writelnStdout(process, terminal, `${chalk.blue(entry.filename)} (${entry.uncompressedSize} bytes)`)
+      // Filter out options/flags and get target paths
+      const targets = argv.length > 0 
+        ? argv.filter(arg => !arg.startsWith('-'))
+        : [shell.cwd]
+
+      if (targets.length === 0) {
+        targets.push(shell.cwd)
+      }
+
+      let hasError = false
+
+      for (const target of targets) {
+        const fullPath = path.resolve(shell.cwd, target)
+        
+        try {
+          const stats = await shell.context.fs.promises.stat(fullPath)
+          
+          if (targets.length > 1) {
+            await writelnStdout(process, terminal, `${target}:`)
+          }
+          await writelnStdout(process, terminal, JSON.stringify(stats, null, 2))
+
+          const extension = path.extname(fullPath)
+          if (extension === '.zip') {
+            const blob = new Blob([new Uint8Array(await shell.context.fs.promises.readFile(fullPath))])
+            const zipReader = new zipjs.ZipReader(new zipjs.BlobReader(blob))
+            const entries = await zipReader.getEntries()
+            await writelnStdout(process, terminal, chalk.bold('\nZIP Entries:'))
+            for (const entry of entries) {
+              await writelnStdout(process, terminal, `${chalk.blue(entry.filename)} (${entry.uncompressedSize} bytes)`)
+            }
+          }
+          
+          if (targets.length > 1) {
+            await writelnStdout(process, terminal, '')
+          }
+        } catch (error) {
+          const errorMessage = error instanceof Error ? error.message : String(error)
+          await writelnStderr(process, terminal, `stat: ${target}: ${errorMessage}`)
+          hasError = true
         }
       }
-      return 0
+
+      return hasError ? 1 : 0
     }
   })
 }

package/src/commands/tail.ts

@@ -2,7 +2,7 @@ import path from 'path'
 import type { Kernel, Process, Shell, Terminal } from '@ecmaos/types'
 import { TerminalEvents } from '@ecmaos/types'
 import { TerminalCommand } from '../shared/terminal-command.js'
-import { writelnStdout } from '../shared/helpers.js'
+import { writelnStderr } from '../shared/helpers.js'
 
 function printUsage(process: Process | undefined, terminal: Terminal): void {
   const usage = `Usage: tail [OPTION]... [FILE]...
@@ -10,7 +10,7 @@ Print the last 10 lines of each FILE to standard output.
 
   -n, -nNUMBER        print the last NUMBER lines instead of 10
   --help             display this help and exit`
-  writelnStdout(process, terminal, usage)
+  writelnStderr(process, terminal, usage)
 }
 
 export function createCommand(kernel: Kernel, shell: Shell, terminal: Terminal): TerminalCommand {