creepercli 1.0.0 → 1.1.0

package/src/commands/fs.js

@@ -1,152 +1,138 @@
-/*
- * Copyright 2026 DemonZDevelopment
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-'use strict';
-
-const { formatLs, formatTree, humanSize, formatInfo } = require('../formatters');
-const { editFile } = require('../editor');
-
-async function pwd(ctx) {
-  const res = await ctx.client.request('fs.pwd');
-  ctx.cwd = res.cwd;
-  console.log(res.cwd);
-}
-
-async function ls(ctx, args) {
-  const flags = args.filter((a) => a.startsWith('-') && a !== '-');
-  const longFormat = flags.some((f) => f.includes('l'));
-  const all = flags.some((f) => f.includes('a'));
-  const path = args.find((a) => !a.startsWith('-')) || '.';
-  const res = await ctx.client.request('fs.ls', { path, long: longFormat, all });
-  ctx.cwd = res.cwd;
-  console.log(formatLs(res.entries, { longFormat }));
-}
-
-async function cd(ctx, args) {
-  let path = args[0] || '/';
-  if (path === '~' || path.startsWith('~/')) {
-    path = '/' + path.slice(1).replace(/^\/+/, '');
-  }
-  const res = await ctx.client.request('fs.cd', { path });
-  ctx.cwd = res.cwd;
-  console.log(`Changed directory to ${res.cwd}`);
-}
-
-async function tree(ctx, args) {
-  let depth = 3;
-  const pathArgs = [];
-  for (let i = 0; i < args.length; i++) {
-    if (args[i] === '-d' || args[i] === '--depth') {
-      depth = parseInt(args[++i], 10) || 3;
-    } else {
-      pathArgs.push(args[i]);
-    }
-  }
-  const res = await ctx.client.request('fs.tree', { path: pathArgs[0] || '.', depth });
-  console.log(formatTree(res.children || []));
-  if (res.truncated) console.log('(tree truncated)');
-}
-
-async function cat(ctx, args) {
-  if (!args[0]) throw new Error('Usage: cat <path>');
-  const res = await ctx.client.request('fs.cat', { path: args[0] });
-  process.stdout.write(res.content);
-  if (!res.content.endsWith('\n')) process.stdout.write('\n');
-  if (res.truncated) console.error(`(truncated: file is ${humanSize(res.size)})`);
-}
-
-async function head(ctx, args) {
-  const { lines, path } = parseTailArgs(args, 10);
-  const res = await ctx.client.request('fs.head', { path, lines });
-  console.log(res.lines.join('\n'));
-  if (res.truncated) console.error('(truncated)');
-}
-
-async function tail(ctx, args) {
-  if (args.includes('-f') || args.includes('--follow')) {
-    throw new Error('Live follow is available via the "log" command: creepercli log [--grep <regex>]');
-  }
-  const { lines, path } = parseTailArgs(args, 10);
-  const res = await ctx.client.request('fs.tail', { path, lines });
-  console.log(res.lines.join('\n'));
-  if (res.truncated) console.error('(truncated)');
-}
-
-function parseTailArgs(args, def) {
-  let n = def;
-  let path = null;
-  for (let i = 0; i < args.length; i++) {
-    if (args[i] === '-n') n = parseInt(args[++i], 10) || def;
-    else path = args[i];
-  }
-  if (!path) throw new Error('Usage: <command> [-n N] <path>');
-  return { lines: n, path };
-}
-
-async function wc(ctx, args) {
-  if (!args[0]) throw new Error('Usage: wc <path>');
-  const res = await ctx.client.request('fs.wc', { path: args[0] });
-  console.log(`${res.lines} ${res.words} ${res.chars} ${humanSize(res.bytes)} ${args[0]}`);
-}
-
-async function touch(ctx, args) {
-  if (!args[0]) throw new Error('Usage: touch <path>');
-  const res = await ctx.client.request('fs.touch', { path: args[0] });
-  console.log(`touched ${res.path}`);
-}
-
-async function mkdir(ctx, args) {
-  const parents = args.includes('-p') || args.includes('--parents');
-  const path = args.find((a) => !a.startsWith('-'));
-  if (!path) throw new Error('Usage: mkdir [-p] <path>');
-  const res = await ctx.client.request('fs.mkdir', { path, parents });
-  console.log(`created ${res.path}`);
-}
-
-async function rm(ctx, args) {
-  const recursive = args.includes('-r') || args.includes('-R') || args.includes('--recursive');
-  const path = args.find((a) => !a.startsWith('-'));
-  if (!path) throw new Error('Usage: rm [-r] <path>');
-  const res = await ctx.client.request('fs.rm', { path, recursive });
-  console.log(`removed ${res.path}`);
-}
-
-async function cp(ctx, args) {
-  const recursive = args.includes('-r') || args.includes('-R') || args.includes('--recursive');
-  const rest = args.filter((a) => !a.startsWith('-'));
-  if (rest.length < 2) throw new Error('Usage: cp [-r] <src> <dst>');
-  const res = await ctx.client.request('fs.cp', { src: rest[0], dst: rest[1], recursive });
-  console.log(`copied ${res.src} -> ${res.dst}`);
-}
-
-async function mv(ctx, args) {
-  if (args.length < 2) throw new Error('Usage: mv <src> <dst>');
-  const res = await ctx.client.request('fs.mv', { src: args[0], dst: args[1] });
-  console.log(`moved ${res.src} -> ${res.dst}`);
-}
-
-async function info(ctx, args) {
-  if (!args[0]) throw new Error('Usage: info <path>');
-  const res = await ctx.client.request('fs.info', { path: args[0] });
-  console.log(formatInfo(res));
-}
-
-async function edit(ctx, args) {
-  if (!args[0]) throw new Error('Usage: edit <path>');
-  return editFile(ctx, args[0]);
-}
-
-module.exports = { pwd, ls, cd, tree, cat, head, tail, wc, touch, mkdir, rm, cp, mv, info, edit };
+ 
+
+'use strict';
+
+const { formatLs, formatTree, humanSize, formatInfo } = require('../formatters');
+const { editFile } = require('../editor');
+
+async function pwd(ctx) {
+  const res = await ctx.client.request('fs.pwd');
+  ctx.cwd = res.cwd;
+  console.log(res.cwd);
+}
+
+async function ls(ctx, args) {
+  const flags = args.filter((a) => a.startsWith('-') && a !== '-');
+  const longFormat = flags.some((f) => f.includes('l'));
+  const all = flags.some((f) => f.includes('a'));
+  const path = args.find((a) => !a.startsWith('-')) || '.';
+  const res = await ctx.client.request('fs.ls', { path, long: longFormat, all });
+  ctx.cwd = res.cwd;
+  console.log(formatLs(res.entries, { longFormat }));
+}
+
+async function cd(ctx, args) {
+  let path = args[0] || '/';
+  if (path === '~' || path.startsWith('~/')) {
+    path = '/' + path.slice(1).replace(/^\/+/, '');
+  }
+  const res = await ctx.client.request('fs.cd', { path });
+  ctx.cwd = res.cwd;
+  console.log(`Changed directory to ${res.cwd}`);
+}
+
+async function tree(ctx, args) {
+  let depth = 3;
+  const pathArgs = [];
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '-d' || args[i] === '--depth') {
+      depth = parseInt(args[++i], 10) || 3;
+    } else {
+      pathArgs.push(args[i]);
+    }
+  }
+  const res = await ctx.client.request('fs.tree', { path: pathArgs[0] || '.', depth });
+  console.log(formatTree(res.children || []));
+  if (res.truncated) console.log('(tree truncated)');
+}
+
+async function cat(ctx, args) {
+  if (!args[0]) throw new Error('Usage: cat <path>');
+  const res = await ctx.client.request('fs.cat', { path: args[0] });
+  process.stdout.write(res.content);
+  if (!res.content.endsWith('\n')) process.stdout.write('\n');
+  if (res.truncated) console.error(`(truncated: file is ${humanSize(res.size)})`);
+}
+
+async function head(ctx, args) {
+  const { lines, path } = parseTailArgs(args, 10);
+  const res = await ctx.client.request('fs.head', { path, lines });
+  console.log(res.lines.join('\n'));
+  if (res.truncated) console.error('(truncated)');
+}
+
+async function tail(ctx, args) {
+  if (args.includes('-f') || args.includes('--follow')) {
+    throw new Error('Live follow is available via the "log" command: creepercli log [--grep <regex>]');
+  }
+  const { lines, path } = parseTailArgs(args, 10);
+  const res = await ctx.client.request('fs.tail', { path, lines });
+  console.log(res.lines.join('\n'));
+  if (res.truncated) console.error('(truncated)');
+}
+
+function parseTailArgs(args, def) {
+  let n = def;
+  let path = null;
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === '-n') n = parseInt(args[++i], 10) || def;
+    else path = args[i];
+  }
+  if (!path) throw new Error('Usage: <command> [-n N] <path>');
+  return { lines: n, path };
+}
+
+async function wc(ctx, args) {
+  if (!args[0]) throw new Error('Usage: wc <path>');
+  const res = await ctx.client.request('fs.wc', { path: args[0] });
+  console.log(`${res.lines} ${res.words} ${res.chars} ${humanSize(res.bytes)} ${args[0]}`);
+}
+
+async function touch(ctx, args) {
+  if (!args[0]) throw new Error('Usage: touch <path>');
+  const res = await ctx.client.request('fs.touch', { path: args[0] });
+  console.log(`touched ${res.path}`);
+}
+
+async function mkdir(ctx, args) {
+  const parents = args.includes('-p') || args.includes('--parents');
+  const path = args.find((a) => !a.startsWith('-'));
+  if (!path) throw new Error('Usage: mkdir [-p] <path>');
+  const res = await ctx.client.request('fs.mkdir', { path, parents });
+  console.log(`created ${res.path}`);
+}
+
+async function rm(ctx, args) {
+  const recursive = args.includes('-r') || args.includes('-R') || args.includes('--recursive');
+  const path = args.find((a) => !a.startsWith('-'));
+  if (!path) throw new Error('Usage: rm [-r] <path>');
+  const res = await ctx.client.request('fs.rm', { path, recursive });
+  console.log(`removed ${res.path}`);
+}
+
+async function cp(ctx, args) {
+  const recursive = args.includes('-r') || args.includes('-R') || args.includes('--recursive');
+  const rest = args.filter((a) => !a.startsWith('-'));
+  if (rest.length < 2) throw new Error('Usage: cp [-r] <src> <dst>');
+  const res = await ctx.client.request('fs.cp', { src: rest[0], dst: rest[1], recursive });
+  console.log(`copied ${res.src} -> ${res.dst}`);
+}
+
+async function mv(ctx, args) {
+  if (args.length < 2) throw new Error('Usage: mv <src> <dst>');
+  const res = await ctx.client.request('fs.mv', { src: args[0], dst: args[1] });
+  console.log(`moved ${res.src} -> ${res.dst}`);
+}
+
+async function info(ctx, args) {
+  if (!args[0]) throw new Error('Usage: info <path>');
+  const res = await ctx.client.request('fs.info', { path: args[0] });
+  console.log(formatInfo(res));
+}
+
+async function edit(ctx, args) {
+  if (!args[0]) throw new Error('Usage: edit <path>');
+  return editFile(ctx, args[0]);
+}
+
+module.exports = { pwd, ls, cd, tree, cat, head, tail, wc, touch, mkdir, rm, cp, mv, info, edit };

package/src/commands/index.js

@@ -1,139 +1,129 @@
-/*
- * Copyright 2026 DemonZDevelopment
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *     http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-
-'use strict';
-
-const fsCmds = require('./fs');
-const searchCmds = require('./search');
-const execCmds = require('./exec');
-const monitorCmds = require('./monitor');
-const authCmds = require('./auth');
-const { cpush, cpull, csync } = require('../transfer');
-const { friendly } = require('../protocol');
-
-const COMMANDS = [
-  { name: 'pwd', run: fsCmds.pwd, desc: 'Print working directory' },
-  { name: 'ls', run: fsCmds.ls, desc: 'List directory (flags: -l, -a)' },
-  { name: 'cd', run: fsCmds.cd, desc: 'Change directory' },
-  { name: 'tree', run: fsCmds.tree, desc: 'Show directory tree (flag: --depth N)' },
-  { name: 'cat', run: fsCmds.cat, desc: 'Print file contents' },
-  { name: 'head', run: fsCmds.head, desc: 'Print first lines of a file (-n N)' },
-  { name: 'tail', run: fsCmds.tail, desc: 'Print last lines of a file (-n N)' },
-  { name: 'wc', run: fsCmds.wc, desc: 'Count lines/words/chars of a file' },
-  { name: 'touch', run: fsCmds.touch, desc: 'Create or update a file' },
-  { name: 'mkdir', run: fsCmds.mkdir, desc: 'Create directory (flag: -p)' },
-  { name: 'rm', run: fsCmds.rm, desc: 'Remove file/directory (flag: -r)' },
-  { name: 'cp', run: fsCmds.cp, desc: 'Copy file/directory (flag: -r)' },
-  { name: 'mv', run: fsCmds.mv, desc: 'Move/rename a file' },
-  { name: 'info', run: fsCmds.info, desc: 'Show file info (perms, size, mtime)' },
-  { name: 'edit', run: fsCmds.edit, desc: 'Edit a remote file in your local $EDITOR' },
-  { name: 'grep', run: searchCmds.grep, desc: 'Search file contents (flags: -i, --max-depth N)' },
-  { name: 'find', run: searchCmds.find, desc: 'Find files by glob (flag: --glob "**/*.jar")' },
-  { name: 'exec', run: execCmds.exec, desc: 'Run a Minecraft console command (allowlisted)' },
-  { name: 'say', run: execCmds.say, desc: 'Shortcut for "exec say ..."' },
-  { name: 'restart', run: execCmds.restart, desc: 'Shortcut for "exec restart"' },
-  { name: 'stats', run: monitorCmds.stats, desc: 'Server CPU/RAM/disk stats' },
-  { name: 'tps', run: monitorCmds.tps, desc: 'Server TPS (1m/5m/15m)' },
-  { name: 'log', run: monitorCmds.log, desc: 'Follow the server console (flag: --grep <regex>)' },
-  { name: 'top', run: monitorCmds.top, desc: 'Live dashboard (q to quit)' },
-  { name: 'cpush', run: cpush, desc: 'Upload a local file to the server' },
-  { name: 'cpull', run: cpull, desc: 'Download a server file locally' },
-  { name: 'csync', run: csync, desc: 'Synchronize local/remote directories (flag: --yes)' },
-  { name: 'login', run: authCmds.login, desc: 'Authenticate and store a session token' },
-  { name: 'logout', run: authCmds.logout, desc: 'Invalidate session and clear local credentials' },
-  { name: 'passwd', run: authCmds.passwd, desc: 'Change your password' },
-  { name: 'totp', run: authCmds.totp, desc: 'Manage 2FA: totp setup | totp disable' },
-  { name: 'whoami', run: authCmds.whoami, desc: 'Show current session info' },
-  { name: 'ping', run: authCmds.ping, desc: 'Check server connectivity' },
-  { name: 'help', run: help, desc: 'Show this help' },
-  { name: 'exit', run: exitCmd, desc: 'Leave the REPL' },
-  { name: 'quit', run: exitCmd, desc: 'Leave the REPL' },
-  { name: 'q', run: exitCmd, desc: 'Leave the REPL' },
-];
-
-function find(name) {
-  return COMMANDS.find((c) => c.name === name);
-}
-
+ 
+
+'use strict';
+
+const fsCmds = require('./fs');
+const searchCmds = require('./search');
+const execCmds = require('./exec');
+const monitorCmds = require('./monitor');
+const authCmds = require('./auth');
+const { cpush, cpull, csync } = require('../transfer');
+const { friendly } = require('../protocol');
+
+const COMMANDS = [
+  { name: 'pwd', run: fsCmds.pwd, desc: 'Print working directory' },
+  { name: 'ls', run: fsCmds.ls, desc: 'List directory (flags: -l, -a)' },
+  { name: 'cd', run: fsCmds.cd, desc: 'Change directory' },
+  { name: 'tree', run: fsCmds.tree, desc: 'Show directory tree (flag: --depth N)' },
+  { name: 'cat', run: fsCmds.cat, desc: 'Print file contents' },
+  { name: 'head', run: fsCmds.head, desc: 'Print first lines of a file (-n N)' },
+  { name: 'tail', run: fsCmds.tail, desc: 'Print last lines of a file (-n N)' },
+  { name: 'wc', run: fsCmds.wc, desc: 'Count lines/words/chars of a file' },
+  { name: 'touch', run: fsCmds.touch, desc: 'Create or update a file' },
+  { name: 'mkdir', run: fsCmds.mkdir, desc: 'Create directory (flag: -p)' },
+  { name: 'rm', run: fsCmds.rm, desc: 'Remove file/directory (flag: -r)' },
+  { name: 'cp', run: fsCmds.cp, desc: 'Copy file/directory (flag: -r)' },
+  { name: 'mv', run: fsCmds.mv, desc: 'Move/rename a file' },
+  { name: 'info', run: fsCmds.info, desc: 'Show file info (perms, size, mtime)' },
+  { name: 'edit', run: fsCmds.edit, desc: 'Edit a remote file in your local $EDITOR' },
+  { name: 'grep', run: searchCmds.grep, desc: 'Search file contents (flags: -i, --max-depth N)' },
+  { name: 'find', run: searchCmds.find, desc: 'Find files by glob (flag: --glob "**/*.jar")' },
+  { name: 'exec', run: execCmds.exec, desc: 'Run a Minecraft console command (allowlisted)' },
+  { name: 'say', run: execCmds.say, desc: 'Shortcut for "exec say ..."' },
+  { name: 'restart', run: execCmds.restart, desc: 'Shortcut for "exec restart"' },
+  { name: 'stats', run: monitorCmds.stats, desc: 'Server CPU/RAM/disk stats' },
+  { name: 'tps', run: monitorCmds.tps, desc: 'Server TPS (1m/5m/15m)' },
+  { name: 'log', run: monitorCmds.log, desc: 'Follow the server console (flag: --grep <regex>)' },
+  { name: 'top', run: monitorCmds.top, desc: 'Live dashboard (q to quit)' },
+  { name: 'cpush', run: cpush, desc: 'Upload a local file to the server' },
+  { name: 'cpull', run: cpull, desc: 'Download a server file locally' },
+  { name: 'csync', run: csync, desc: 'Synchronize local/remote directories (flag: --yes)' },
+  { name: 'login', run: authCmds.login, desc: 'Authenticate and store a session token' },
+  { name: 'logout', run: authCmds.logout, desc: 'Invalidate session and clear local credentials' },
+  { name: 'passwd', run: authCmds.passwd, desc: 'Change your password' },
+  { name: 'totp', run: authCmds.totp, desc: 'Manage 2FA: totp setup | totp disable' },
+  { name: 'whoami', run: authCmds.whoami, desc: 'Show current session info' },
+  { name: 'ping', run: authCmds.ping, desc: 'Check server connectivity' },
+  { name: 'help', run: help, desc: 'Show this help' },
+  { name: 'exit', run: exitCmd, desc: 'Leave the REPL' },
+  { name: 'quit', run: exitCmd, desc: 'Leave the REPL' },
+  { name: 'q', run: exitCmd, desc: 'Leave the REPL' },
+];
+
+function find(name) {
+  return COMMANDS.find((c) => c.name === name);
+}
+
 function splitArgs(input) {
-  const args = [];
-  let cur = '';
-  let quote = null;
-  let escaped = false;
-  for (const ch of input) {
-    if (escaped) {
-      cur += ch;
-      escaped = false;
+  const args = [];
+  let cur = '';
+  let quote = null;
+  let escaped = false;
+  for (let i = 0; i < input.length; i++) {
+    const ch = input[i];
+    if (escaped) {
+      cur += ch;
+      escaped = false;
     } else if (ch === '\\') {
-      escaped = true;
-    } else if (quote) {
-      if (ch === quote) quote = null;
+      const next = input[i + 1];
+      const escapable = next != null && (next === '\\' || next === '"' || next === "'" || /\s/.test(next));
+      if (escapable) escaped = true;
       else cur += ch;
-    } else if (ch === '"' || ch === "'") {
-      quote = ch;
-    } else if (/\s/.test(ch)) {
-      if (cur) {
-        args.push(cur);
-        cur = '';
-      }
-    } else {
-      cur += ch;
-    }
-  }
-  if (escaped) cur += '\\';
-  if (cur) args.push(cur);
-  return args;
-}
-
-async function runCommand(ctx, input) {
-  let trimmed = input.trim();
-  if (!trimmed || trimmed.startsWith('#')) return 0;
-  
-  // Automatically strip redundant "creepercli" or "creepercli.exe" prefix if typed inside the REPL
-  if (trimmed.startsWith('creepercli.exe ')) {
-    trimmed = trimmed.slice(15).trim();
-  } else if (trimmed.startsWith('creepercli ')) {
-    trimmed = trimmed.slice(11).trim();
-  }
-
-  const args = splitArgs(trimmed);
-  const cmd = find(args[0]);
-  if (!cmd) {
-    console.error(`Unknown command: ${args[0]} (try "help")`);
-    return 1;
-  }
-  try {
-    const rc = await cmd.run(ctx, args.slice(1));
-    return rc == null ? 0 : rc;
-  } catch (err) {
-    console.error(`Error: ${friendly(err)}`);
-    return 1;
-  }
-}
-
-function help() {
-  const width = Math.max(...COMMANDS.map((c) => c.name.length)) + 2;
-  for (const c of COMMANDS) {
-    console.log(c.name.padEnd(width) + c.desc);
-  }
-}
-
-function exitCmd(ctx) {
-  ctx.exit = true;
-  return 0;
-}
-
-module.exports = { COMMANDS, find, splitArgs, runCommand, help };
+    } else if (quote) {
+      if (ch === quote) quote = null;
+      else cur += ch;
+    } else if (ch === '"' || ch === "'") {
+      quote = ch;
+    } else if (/\s/.test(ch)) {
+      if (cur) {
+        args.push(cur);
+        cur = '';
+      }
+    } else {
+      cur += ch;
+    }
+  }
+  if (escaped) cur += '\\';
+  if (cur) args.push(cur);
+  return args;
+}
+
+async function runCommand(ctx, input) {
+  let trimmed = input.trim();
+  if (!trimmed || trimmed.startsWith('#')) return 0;
+  
+  
+  if (trimmed.startsWith('creepercli.exe ')) {
+    trimmed = trimmed.slice(15).trim();
+  } else if (trimmed.startsWith('creepercli ')) {
+    trimmed = trimmed.slice(11).trim();
+  }
+
+  const args = splitArgs(trimmed);
+  const cmd = find(args[0]);
+  if (!cmd) {
+    console.error(`Unknown command: ${args[0]} (try "help")`);
+    return 1;
+  }
+  try {
+    const rc = await cmd.run(ctx, args.slice(1));
+    return rc == null ? 0 : rc;
+  } catch (err) {
+    console.error(`Error: ${friendly(err)}`);
+    return 1;
+  }
+}
+
+function help() {
+  const width = Math.max(...COMMANDS.map((c) => c.name.length)) + 2;
+  for (const c of COMMANDS) {
+    console.log(c.name.padEnd(width) + c.desc);
+  }
+}
+
+function exitCmd(ctx) {
+  ctx.exit = true;
+  return 0;
+}
+
+module.exports = { COMMANDS, find, splitArgs, runCommand, help };