http-server-rs 0.0.7 → 0.0.20

package/README.md

@@ -8,39 +8,69 @@ https://github.com/user-attachments/assets/7b6bbee0-3428-4c9f-80a6-2804ddac6e01
 
 ## Installation
 
+### Cargo
+
+```bash
+# Installs globally
+cargo install http-server-rs
+```
+
 ### NPM
 
 ```bash
-# Rerun to update
-npm install -g http-server-rs
+# Installs to ./node_modules
+npm install http-server-rs
+npx http-server-rs --help
+```
+
+If you want to override the binary used (for custom platforms)
+```bash
+npm install http-server-rs
+
+export HTTP_SERVER_RS_BIN_OVERRIDE=/path/to/http-server-rs
+npx http-server-rs --help # Uses the override
 ```
 
-### Binary Install Script
+### Manual Install
+
+Download the latest binary from [GitHub Releases](https://github.com/alshdavid-public/http-server-rs/releases/latest) and add it to your `PATH`
 
 ```bash
-# Rerun to update
-eval $(curl -sSf https://raw.githubusercontent.com/alshdavid/http-server-rs/refs/heads/main/install.sh | sh)
+# Linux AMD64 (Change for your platform)
+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
+
+# 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
 ```
 
-## Usage
+## Example Usage
 
 ```bash
 # Use default configuration
-http-server
+http-server-rs
+
+# Enable CORS, reroute requests to index.html and automatically compress served files
+http-server-rs --cors --spa -Z ./public
 
-# Arguments
-# Enable CORS, reroute requests to index.html and automatically compress to brotli 
-http-server --cors --spa -Z ./public
+# Responds with headers required for SharedArrayBuffer
+http-server-rs --shared-array-buffer ./public
+
+# Automatically transpiles TypeScript to JavaScript on request
+http-server-rs --transpile ./public
+
+# Proxy /api to an external backend (quotes are required)
+http-server-rs --proxy "path=/api&target=http://localhost:3000" ./public
 
 # Custom Headers
-http-server -H X-Custom-Header:some-value
+http-server-rs -H X-Custom-Header:some-value
 ```
 
 ```
-Usage: http-server [OPTIONS] [SERVE_DIR]
+Usage: http-server-rs [OPTIONS] [SERVE_DIR]
 
 Arguments:
-  [SERVE_DIR]  Target directory to serve [default: ./dist]
+  [SERVE_DIR]  Target directory to serve [default: ./]
 
 Options:
   -a, --address <ADDRESS>
@@ -63,6 +93,8 @@ Options:
           Enable headers for SharedArrayBuffer
   -Q, --quiet
           Don't print any logs to terminal
+  -t, --transpile
+          Transpile served files
   -w, --watch
           Watch folder for changes and trigger a browser reload
       --watch-dir <WATCH_DIR>
@@ -71,10 +103,24 @@ Options:
           Don't automatically inject watch listener into html
       --stream-buffer-size <STREAM_BUFFER_SIZE>
           Configure the buffer size when streaming files [default: 4000]
+      --proxy <PROXY>
+          Reverse proxy routes (URL-encoded, e.g. "path=/api&target=http://localhost:3000")
   -h, --help
           Print help
 ```
 
+## Live Transpile TypeScript
+
+Will live transpile TypeScript to JavaScript on request. This allows serving TypeScript sources 
+directly to the browser without a build step.
+
+```bash
+http-server-rs --transpile --port 8080 ./testing/transpile/react
+
+# Returns transpiled JavaScript that runs directly in the browser
+curl http://localhost:8080/app.tsx 
+```
+
 ## 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.

package/http-server-rs.js

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+
+import * as child_process from "node:child_process";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as process from "node:process";
+import * as url from "node:url";
+
+const __dirname = path.dirname(url.fileURLToPath(import.meta.url));
+
+const SUPPORTED = [
+  "linux-x64",
+  "linux-arm64",
+  "darwin-arm64",
+  "win32-x64",
+  "win32-arm64",
+];
+
+const TARGET = `${process.platform}-${process.arch}`;
+const EXTENSION = process.platform === "win32" ? ".exe" : "";
+
+const override = process.env.HTTP_SERVER_RS_BIN_OVERRIDE;
+
+let binary;
+
+if (override) {
+  if (!fs.existsSync(override)) {
+    console.error(
+      `http-server-rs: HTTP_SERVER_RS_BIN_OVERRIDE is set, but no file exists at:\n` +
+        `  ${override}\n\n` +
+        `Unset it to use the bundled binary for ${TARGET}.`,
+    );
+    process.exit(1);
+  }
+  binary = override;
+} else {
+  binary = path.join(__dirname, `http-server-rs-${TARGET}${EXTENSION}`);
+
+  if (!fs.existsSync(binary)) {
+    console.error(
+      `http-server-rs: no bundled binary for ${TARGET}.\n\n` +
+        `Expected it at:\n` +
+        `  ${binary}\n\n` +
+        `Supported platforms: ${SUPPORTED.join(", ")}\n` +
+        `Set HTTP_SERVER_RS_BIN_OVERRIDE to run a binary from an explicit path.\n` +
+        `https://github.com/alshdavid/http-server-rs`,
+    );
+    process.exit(1);
+  }
+}
+
+const result = child_process.spawnSync(binary, process.argv.slice(2), {
+  stdio: "inherit",
+  windowsHide: true,
+});
+
+if (result.error) {
+  console.error(`http-server-rs: failed to execute ${binary}`);
+  console.error(result.error.message);
+  process.exit(1);
+}
+
+if (result.signal) {
+  process.kill(process.pid, result.signal);
+}
+
+process.exit(result.status ?? 1);

package/package.json

@@ -1,10 +1,13 @@
 {
   "name": "http-server-rs",
-  "version": "0.0.7",
+  "version": "0.0.20",
+  "license": "MIT",
+  "type": "module",
   "bin": {
-    "http-server-rs": "./http-server.exe"
+    "http-server-rs": "http-server-rs.js"
   },
-  "scripts": {
-    "postinstall": "node ./postinstall.mjs"
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/alshdavid/http-server-rs.git"
   }
 }

package/http-server.exe

@@ -1,11 +0,0 @@
-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/postinstall.mjs

@@ -1,91 +0,0 @@
-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));
-
-  if (fs.existsSync(__bin)) {
-    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

@@ -1 +0,0 @@
-v2025.10.10.0631.a4fb