http-server-rs 0.0.1

package/README.md

@@ -0,0 +1,116 @@
+# http-server: a simple static HTTP server 🚀🦀
+
+Rewrite of the popular npm package [http-server](https://github.com/http-party/http-server/tree/master) in Rust with some extras included.
+
+`http-server` is a simple, zero-configuration command-line static HTTP server. It is powerful enough for production usage, but it's simple and hackable enough to be used for testing, local development and learning.
+
+https://github.com/user-attachments/assets/7b6bbee0-3428-4c9f-80a6-2804ddac6e01
+
+## Usage
+
+```bash
+# Use default configuration
+http-server
+
+# Arguments
+# Enable CORS, reroute requests to index.html and automatically compress to brotli 
+http-server --cors --spa -Z ./public
+
+# Custom Headers
+http-server -H X-Custom-Header:some-value
+```
+
+```
+Usage: http-server [OPTIONS] [SERVE_DIR]
+
+Arguments:
+  [SERVE_DIR]  Target directory to serve [default: ./dist]
+
+Options:
+  -a, --address <ADDRESS>
+          [default: 0.0.0.0]
+  -p, --port <PORT>
+          [default: 8080]
+      --spa
+          Redirect requests to /index.html for Single Page Applications
+  -c, --cache-time <CACHE_TIME>
+          Cache control time [default: 0]
+  -Z, --compress
+          Compress responses (JIT)
+  -H, --header <HEADERS>
+          Custom headers (Format "key:value")
+      --auth <BASIC_AUTH>
+          Put server behind basic auth (Format "username:password")
+      --cors
+          Enable CORS header
+  -S, --shared-array-buffer
+          Enable headers for SharedArrayBuffer
+  -Q, --quiet
+          Don't print any logs to terminal
+  -w, --watch
+          Watch folder for changes and trigger a browser reload
+      --watch-dir <WATCH_DIR>
+          Watch for changes [default: SERVE_DIR]
+      --no-watch-inject
+          Don't automatically inject watch listener into html
+      --stream-buffer-size <STREAM_BUFFER_SIZE>
+          Configure the buffer size when streaming files [default: 4000]
+  -h, --help
+          Print help
+```
+
+## Watch Mode
+
+`http-server` under `--watch` mode can watch the served directory for changes and emit an event to the client notifying of a change. By default the server will intercept html files and inject a JavaScript script which subscribes to change events and triggers a page reload.
+
+```bash
+http-server --watch ./dist
+```
+
+To customize the reload functionality, disable the auto-inject script, manually subscribe to change events and trigger the desired functionality.
+
+```bash
+http-server --watch --no-watch-inject ./dist
+```
+
+```html
+<html>
+  <head>
+    <script>
+      new EventSource("/.http-server-rs/reload")
+        .onmessage = () => window.location.reload();
+    </script>
+  </head>
+  <body>
+    <script src="./app.js"></script>
+  </body>
+</html>
+```
+
+## Installation
+
+### MacOS & Linux
+
+Download the binary from the [latest GitHub release](https://github.com/alshdavid/http-server-rs/releases/latest) and add it to your `PATH`
+
+```shell
+# Linux AMD64
+curl -L --url https://github.com/alshdavid/http-server-rs/releases/latest/download/http-server-linux-amd64.tar.gz | tar -xvzf - -C $HOME/.local/bin
+
+# Linux ARM64
+curl -L --url https://github.com/alshdavid/http-server-rs/releases/latest/download/http-server-linux-arm64.tar.gz | tar -xvzf - -C $HOME/.local/bin
+
+# MacOS ARM64 (Apple Silicon)
+curl -L --url https://github.com/alshdavid/http-server-rs/releases/latest/download/http-server-macos-arm64.tar.gz | tar -xvzf - -C $HOME/.local/bin 
+
+# MacOS AMD64 (Intel)
+curl -L --url https://github.com/alshdavid/http-server-rs/releases/latest/download/http-server-macos-amd64.tar.gz | tar -xvzf - -C $HOME/.local/bin
+
+# Add to PATH if not already there:
+echo "\nexport \PATH=\$PATH:\$HOME/.local/bin\n" >> $HOME/.zshrc
+echo "\nexport \PATH=\$PATH:\$HOME/.local/bin\n" >> $HOME/.bashrc
+```
+
+### Windows
+
+Download the binary from the [latest GitHub release](https://github.com/alshdavid/http-server-rs/releases/latest) and add it to your `PATH`

package/http-server.exe

@@ -0,0 +1,11 @@
+This is a placeholder file required because npm will only create 
+a symlink to a `package.json#bin` entry if the file exists.
+
+This file is replaced in a postinstall step with the actual binary 
+downloaded from GitHub releases.
+
+This file has an .exe extension for Windows compatibility because 
+Windows requires a file extension to know a file is executable. 
+
+Linux and MacOS will be able to run the file as a normal binary 
+regardless of the extension being present.

package/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "http-server-rs",
+  "version": "0.0.1",
+  "bin": {
+    "http-server-rs": "./http-server.exe"
+  },
+  "scripts": {
+    "postinstall": "node ./postinstall.mjs"
+  }
+}

package/postinstall.mjs

@@ -0,0 +1,88 @@
+import * as process from "node:process";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as url from "node:url";
+import * as stream from "node:stream";
+import * as tar from "./tar.cjs";
+
+const __dirname = path.dirname(url.fileURLToPath(import.meta.url));
+const __bin = path.join(__dirname, "http-server.exe");
+const __bin_unix = path.join(__dirname, "http-server");
+
+const HTTP_SERVER_RS_BIN_PATH = process.env.HTTP_SERVER_RS_BIN_PATH;
+const HTTP_SERVER_RS_SKIP_DOWNLOAD = process.env.HTTP_SERVER_RS_SKIP_DOWNLOAD;
+const HTTP_SERVER_RS_FORCE_TAG = process.env.HTTP_SERVER_RS_FORCE_TAG;
+
+const os = {
+  darwin: "macos",
+  linux: "linux",
+  win32: "windows",
+}[process.platform];
+
+const arch = {
+  arm64: "arm64",
+  x64: "amd64",
+}[process.arch];
+
+void (async function main() {
+  if (HTTP_SERVER_RS_SKIP_DOWNLOAD === "true") {
+    // Do nothing
+  } else if (
+    HTTP_SERVER_RS_BIN_PATH &&
+    fs.existsSync(HTTP_SERVER_RS_BIN_PATH)
+  ) {
+    await fs.promises.rm(__bin, { recursive: true, force: true });
+    await fs.promises.symlink(__bin, HTTP_SERVER_RS_BIN_PATH);
+  } else {
+    await downloadBin();
+  }
+})();
+
+async function downloadBin() {
+  if (!arch || !os) {
+    throw new Error(
+      "Unable to determine what Atlaspack Version Manager binary to download"
+    );
+  }
+
+  let tag = HTTP_SERVER_RS_FORCE_TAG || "latest";
+  if (fs.existsSync(path.join(__dirname, "tag"))) {
+    tag = (
+      await fs.promises.readFile(path.join(__dirname, "tag"), "utf8")
+    ).trim();
+  }
+
+  let url = `https://github.com/alshdavid/http-server-rs/releases/latest/download/http-server-${os}-${arch}.tar.gz`;
+  if (tag !== "latest") {
+    url = `https://github.com/alshdavid/http-server-rs/releases/download/${tag}/http-server-${os}-${arch}.tar.gz`;
+  }
+
+  const response = await globalThis.fetch(url);
+  if (!response.ok) {
+    throw new Error("Unable to fetch http-server-rs binary");
+  }
+
+  const body = await response.bytes();
+  const file = new stream.Duplex();
+
+  file.push(body);
+  file.push(null);
+
+  if (fs.existsSync(__bin)) {
+    fs.rmSync(__bin, { recursive: true, force: true });
+  }
+
+  let writable = tar.x({
+    C: __dirname,
+    chmod: true,
+  });
+
+  file.pipe(writable);
+  await new Promise((res) => writable.on("close", res));
+
+  await fs.promises.rm(__bin, { recursive: true, force: true });
+  if (fs.existsSync(__bin_unix)) {
+    await fs.promises.rename(__bin_unix, __bin);
+  }
+  await fs.promises.chmod(__bin, "755");
+}

package/tag

@@ -0,0 +1 @@
+v2025.06.22.0413.6e88