storage-explorer 0.1.0 → 1.0.0

package/README.md

@@ -2,6 +2,20 @@
 
 Read-only AWS S3 / S3-compatible explorer built with Bun + React.
 
+## Run with npm / npx
+
+```bash
+npx storage-explorer
+```
+
+Requires Bun on your machine because the runtime server uses Bun.
+
+Optional flags:
+
+```bash
+npx storage-explorer --port 3000 --host 127.0.0.1
+```
+
 ## Install
 
 ```bash

package/bunfig.toml

@@ -0,0 +1,2 @@
+[serve.static]
+env = "BUN_PUBLIC_*"

package/cli.js

@@ -0,0 +1,98 @@
+#!/usr/bin/env node
+
+import { spawn } from "node:child_process";
+import { access, readFile } from "node:fs/promises";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const packageRoot = path.resolve(__dirname, "..");
+const entrypoint = path.resolve(packageRoot, "src", "index.ts");
+
+const args = process.argv.slice(2);
+
+let hostArg;
+let portArg;
+
+if (args.includes("-h") || args.includes("--help")) {
+  console.log("storage-explorer\n");
+  console.log("Runs the Storage Explorer server using Bun.");
+  console.log("\nUsage:");
+  console.log("  npx storage-explorer [--port 3000] [--host 127.0.0.1]");
+  console.log("\nOptions:");
+  console.log("  -h, --help       Show help");
+  console.log("  -v, --version    Show package version");
+  console.log("  --port <number>  Port to listen on (default: 3000)");
+  console.log("  --host <addr>    Host to bind (default: 127.0.0.1)");
+  process.exit(0);
+}
+
+if (args.includes("-v") || args.includes("--version")) {
+  const packageJsonPath = path.resolve(packageRoot, "package.json");
+  const packageJson = JSON.parse(await readFile(packageJsonPath, "utf8"));
+  console.log(packageJson.version ?? "unknown");
+  process.exit(0);
+}
+
+for (let i = 0; i < args.length; i += 1) {
+  const arg = args[i];
+
+  if (arg === "--port") {
+    const value = Number(args[i + 1]);
+    if (!Number.isFinite(value) || value <= 0 || value > 65535) {
+      console.error("Invalid --port value.");
+      process.exit(1);
+    }
+    portArg = String(value);
+    i += 1;
+    continue;
+  }
+
+  if (arg === "--host") {
+    const value = args[i + 1];
+    if (!value) {
+      console.error("Missing --host value.");
+      process.exit(1);
+    }
+    hostArg = value;
+    i += 1;
+  }
+}
+
+try {
+  await access(entrypoint);
+} catch {
+  console.error("Missing src/index.ts in package.");
+  process.exit(1);
+}
+
+const child = spawn("bun", [entrypoint], {
+  stdio: "inherit",
+  env: {
+    ...process.env,
+    NODE_ENV: process.env.NODE_ENV ?? "production",
+    ...(portArg ? { PORT: portArg } : {}),
+    ...(hostArg ? { HOST: hostArg } : {}),
+  },
+});
+
+child.on("error", error => {
+  if (error && typeof error === "object" && "code" in error && error.code === "ENOENT") {
+    console.error("Bun is required to run storage-explorer.");
+    console.error("Install Bun: https://bun.sh/docs/installation");
+    process.exit(1);
+  }
+
+  console.error(error instanceof Error ? error.message : String(error));
+  process.exit(1);
+});
+
+child.on("exit", (code, signal) => {
+  if (signal) {
+    process.kill(process.pid, signal);
+    return;
+  }
+
+  process.exit(code ?? 0);
+});