feega 0.1.3 → 0.1.4

package/bin/feega.mjs

@@ -1,12 +1,12 @@
 #!/usr/bin/env node
 import { spawn, spawnSync } from 'node:child_process';
-import { createWriteStream, mkdirSync, realpathSync, rmSync } from 'node:fs';
+import { createWriteStream, mkdirSync, readFileSync, realpathSync, rmSync } from 'node:fs';
 import { homedir, tmpdir } from 'node:os';
 import { join } from 'node:path';
 import { Readable } from 'node:stream';
 import { pipeline } from 'node:stream/promises';
 
-import { appDir, bundleSource, cachedVersions, isCached, latestAppVersion, markCached, parseArgs, pickVersion } from '../launcher.mjs';
+import { USAGE, appDir, bundleSource, boundUrl, cachedVersions, freePort, isCached, latestAppVersion, markCached, parseArgs, pickVersion } from '../launcher.mjs';
 
 const MIN_NODE_MAJOR = 22;
 const WEBSTORAGE_NODE_MAJOR = 25;
@@ -88,14 +88,26 @@ async function main() {
     throw new Error(`Node ${MIN_NODE_MAJOR}+ is required (found ${process.versions.node})`);
   }
 
-  const { file, port, browser } = parseArgs(process.argv.slice(2), process.cwd());
+  const args = parseArgs(process.argv.slice(2), process.cwd());
+  if (args.command === 'help') {
+    console.log(USAGE);
+    return;
+  }
+
+  if (args.command === 'version') {
+    console.log(JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version);
+    return;
+  }
+
+  const { file, browser } = args;
+  const port = await freePort(args.port);
   const { version, action } = await chooseVersion(homedir());
   const dir = appDir(homedir(), version);
   if (action === 'download') {
     await install(dir, version);
   }
 
-  const url = `http://localhost:${port}`;
+  const url = boundUrl(port);
   console.log(`feega: saving to ${file}`);
   console.log(`feega: open ${url}`);
 

package/launcher.mjs

@@ -1,8 +1,11 @@
 import { existsSync, mkdirSync, readdirSync, writeFileSync } from 'node:fs';
+import { createServer } from 'node:net';
 import { join, resolve } from 'node:path';
 
 const DEFAULT_FILE = 'canvas.feega';
-const DEFAULT_PORT = 5173;
+const DEFAULT_PORT = 0;
+export const LOOPBACK = '127.0.0.1';
+export const USAGE = `usage: feega [file.feega] [--port <n>] [--no-open] [--help] [--version]`;
 const CACHED_MARKER = '.complete';
 const APP_TAG = 'app-v';
 const RELEASES = 'https://github.com/andreabuttarelli/feega/releases/download';
@@ -25,6 +28,14 @@ export function parseArgs(argv, cwd) {
 
   while (rest.length) {
     const arg = rest.shift();
+    if (arg === '--help' || arg === '-h') {
+      return { command: 'help' };
+    }
+
+    if (arg === '--version') {
+      return { command: 'version' };
+    }
+
     if (arg === '--no-open') {
       browser = 'skip';
       continue;
@@ -40,10 +51,14 @@ export function parseArgs(argv, cwd) {
       continue;
     }
 
+    if (arg.startsWith('-')) {
+      throw new Error(`unknown option: ${arg}\n${USAGE}`);
+    }
+
     files.push(arg);
   }
 
-  return { file: resolve(cwd, files[0] ?? DEFAULT_FILE), port, browser };
+  return { command: 'run', file: resolve(cwd, files[0] ?? DEFAULT_FILE), port, browser };
 }
 
 export const appDir = (home, version) => join(home, '.feega', 'app', version);
@@ -94,3 +109,15 @@ export function pickVersion(latest, cached) {
 
   return { version: cached[0], action: 'cache' };
 }
+
+export const boundUrl = (port) => `http://${LOOPBACK}:${port}`;
+
+export const freePort = (port) =>
+  new Promise((done, fail) => {
+    const probe = createServer();
+    probe.once('error', fail);
+    probe.listen(port, LOOPBACK, () => {
+      const { port: bound } = probe.address();
+      probe.close(() => done(bound));
+    });
+  });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "feega",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Run feega's infinite canvas locally, saved to a .feega file. No account, no database.",
   "license": "Apache-2.0",
   "type": "module",