@lopatnov/conduit 0.2.0

package/Readme.md

@@ -0,0 +1,99 @@
+# @lopatnov/conduit
+
+[![npm](https://img.shields.io/npm/v/@lopatnov/conduit.svg)](https://www.npmjs.com/package/@lopatnov/conduit)
+[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](https://github.com/lopatnov/conduit/blob/main/LICENSE)
+
+**High-performance reverse proxy and static file server** — powered by [Cloudflare Pingora](https://github.com/cloudflare/pingora). Runs as a native Rust binary, distributed via npm for convenience.
+
+- **Single binary** — no Node.js runtime needed after install
+- **One JSON file** describes your entire server
+- Static file server, reverse proxy, TLS termination, HTTP/2, IP filtering, redirects
+- Hot-reload in dev and Auto-TLS (Let's Encrypt) in production — [coming soon](https://github.com/lopatnov/conduit#implementation-status)
+- Drop-in upgrade path from `express-reverse-proxy`
+
+## Installation
+
+```bash
+# Use without installing
+npx @lopatnov/conduit
+
+# Or install globally
+npm install -g @lopatnov/conduit
+```
+
+The `postinstall` script automatically downloads the correct pre-built binary for your
+platform from [GitHub Releases](https://github.com/lopatnov/conduit/releases).
+
+To skip the download (e.g., you built from source and placed the binary yourself):
+
+```bash
+CONDUIT_SKIP_DOWNLOAD=1 npm install @lopatnov/conduit
+```
+
+## Quick Start
+
+```bash
+# Interactive setup wizard
+conduit init
+
+# Start the server
+conduit
+
+# Validate config without starting
+conduit validate
+```
+
+Minimal `conduit.json`:
+
+```json
+{
+  "port": 3000,
+  "static": "./dist",
+  "proxy": { "/api": "http://localhost:4000" }
+}
+```
+
+## CLI
+
+```bash
+conduit                         start server (reads conduit.json)
+conduit -c <file>               use a specific config file
+conduit init                    interactive wizard
+conduit validate                validate config (exit 0 = OK)
+conduit probe                   HEAD to every upstream
+conduit fmt [--write]           pretty-print config
+conduit reload                  hot-reload config (no restart)
+conduit status                  server status
+conduit upstreams               upstream health and latency
+conduit shutdown                graceful shutdown
+conduit --version
+```
+
+## Supported Platforms
+
+| Platform | Architecture          | Supported |
+| -------- | --------------------- | --------- |
+| Linux    | x86-64                | ✅        |
+| Linux    | ARM64                 | ✅        |
+| macOS    | x86-64 (Intel)        | ✅        |
+| macOS    | ARM64 (Apple Silicon) | ✅        |
+| Windows  | x86-64                | ✅        |
+
+## Alternatives
+
+If the binary download fails or your platform is not supported, install from source:
+
+```bash
+cargo install lopatnov-conduit
+```
+
+Or download a pre-built binary directly from
+[GitHub Releases](https://github.com/lopatnov/conduit/releases).
+
+## Documentation
+
+Full documentation: <https://github.com/lopatnov/conduit>
+
+## License
+
+[Apache 2.0](https://github.com/lopatnov/conduit/blob/main/LICENSE)

package/bin/conduit.js

@@ -0,0 +1,80 @@
+#!/usr/bin/env node
+/**
+ * Conduit — platform wrapper.
+ *
+ * Resolves the native binary for the current OS/arch and spawns it,
+ * passing all CLI arguments and stdio through transparently.
+ */
+
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+// --------------------------------------------------------------------------
+// Platform → binary name mapping (matches GitHub Release asset names)
+// --------------------------------------------------------------------------
+function getPlatformBinary() {
+  const { platform, arch } = process;
+
+  const map = {
+    "linux-x64":   "conduit-x86_64-unknown-linux-gnu",
+    "linux-arm64": "conduit-aarch64-unknown-linux-gnu",
+    "darwin-x64":  "conduit-x86_64-apple-darwin",
+    "darwin-arm64":"conduit-aarch64-apple-darwin",
+    "win32-x64":   "conduit-x86_64-pc-windows-msvc.exe",
+  };
+
+  const key = `${platform}-${arch}`;
+  const name = map[key];
+
+  if (!name) {
+    console.error(
+      `[conduit] Unsupported platform: ${key}\n` +
+      `Supported: ${Object.keys(map).join(", ")}\n` +
+      `Install from source: cargo install conduit-proxy`
+    );
+    process.exit(1);
+  }
+
+  return name;
+}
+
+// --------------------------------------------------------------------------
+// Locate binary
+// --------------------------------------------------------------------------
+const nativeDir = join(__dirname, "native");
+const binaryName = getPlatformBinary();
+const binaryPath = join(nativeDir, binaryName);
+
+if (!existsSync(binaryPath)) {
+  console.error(
+    `[conduit] Native binary not found: ${binaryPath}\n` +
+    `Try reinstalling: npm install @lopatnov/conduit\n` +
+    `Or install from source: cargo install conduit-proxy`
+  );
+  process.exit(1);
+}
+
+// --------------------------------------------------------------------------
+// Spawn
+// --------------------------------------------------------------------------
+const child = spawn(binaryPath, process.argv.slice(2), {
+  stdio: "inherit",
+  env: process.env,
+});
+
+child.on("error", (err) => {
+  console.error(`[conduit] Failed to start binary: ${err.message}`);
+  process.exit(1);
+});
+
+child.on("exit", (code, signal) => {
+  if (signal) {
+    process.kill(process.pid, signal);
+  } else {
+    process.exit(code ?? 0);
+  }
+});

package/bin/download.js

@@ -0,0 +1,170 @@
+#!/usr/bin/env node
+/**
+ * Conduit — postinstall downloader.
+ *
+ * Downloads the native binary for the current platform from GitHub Releases.
+ * Runs automatically after `npm install`.
+ *
+ * Skipped when:
+ *   - CONDUIT_SKIP_DOWNLOAD=1     (opt-out for custom installs)
+ *   - npm lifecycle is "ci"       (avoid re-downloading in production installs
+ *                                  where the binary is vendored or built locally)
+ */
+
+import { createWriteStream, existsSync, mkdirSync, chmodSync, unlinkSync } from "node:fs";
+import { get } from "node:https";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+import { readFileSync } from "node:fs";
+
+// --------------------------------------------------------------------------
+// Skip conditions
+// --------------------------------------------------------------------------
+if (process.env.CONDUIT_SKIP_DOWNLOAD === "1") {
+  process.exit(0);
+}
+
+// --------------------------------------------------------------------------
+// Config
+// --------------------------------------------------------------------------
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const pkgPath = join(__dirname, "..", "package.json");
+const pkg = JSON.parse(readFileSync(pkgPath, "utf8"));
+const VERSION = pkg.version;
+const REPO = "lopatnov/conduit";
+const NATIVE_DIR = join(__dirname, "native");
+
+// --------------------------------------------------------------------------
+// Platform → asset name
+// --------------------------------------------------------------------------
+function getAssetName() {
+  const { platform, arch } = process;
+
+  const map = {
+    "linux-x64":    "conduit-x86_64-unknown-linux-gnu",
+    "linux-arm64":  "conduit-aarch64-unknown-linux-gnu",
+    "darwin-x64":   "conduit-x86_64-apple-darwin",
+    "darwin-arm64": "conduit-aarch64-apple-darwin",
+    "win32-x64":    "conduit-x86_64-pc-windows-msvc.exe",
+  };
+
+  const key = `${platform}-${arch}`;
+  const name = map[key];
+
+  if (!name) {
+    console.warn(
+      `[conduit] Skipping binary download — unsupported platform: ${key}\n` +
+      `Install from source: cargo install conduit-proxy`
+    );
+    process.exit(0);
+  }
+
+  return name;
+}
+
+// --------------------------------------------------------------------------
+// Download helper (follows redirects, no external dependencies)
+// --------------------------------------------------------------------------
+const MAX_REDIRECTS = 10;
+
+function download(url, dest) {
+  return new Promise((resolve, reject) => {
+    const file = createWriteStream(dest);
+    let redirectCount = 0;
+
+    function request(url) {
+      get(url, { headers: { "User-Agent": `conduit-npm/${VERSION}` } }, (res) => {
+        if (res.statusCode === 301 || res.statusCode === 302 || res.statusCode === 307 || res.statusCode === 308) {
+          if (++redirectCount > MAX_REDIRECTS) {
+            file.close();
+            try { unlinkSync(dest); } catch { /* ignore */ }
+            reject(new Error(`Too many redirects (>${MAX_REDIRECTS}) for ${url}`));
+            return;
+          }
+          if (!res.headers.location) {
+            file.close();
+            try { unlinkSync(dest); } catch { /* ignore */ }
+            reject(new Error(`Redirect with no Location header from ${url}`));
+            return;
+          }
+          // Follow redirect (resolve relative URLs against current URL).
+          request(new URL(res.headers.location, url).href);
+          return;
+        }
+
+        if (res.statusCode !== 200) {
+          file.close();
+          try { unlinkSync(dest); } catch { /* ignore */ }
+          reject(new Error(`HTTP ${res.statusCode} for ${url}`));
+          return;
+        }
+
+        const total = parseInt(res.headers["content-length"] || "0", 10);
+        let received = 0;
+        let lastPct = -1;
+
+        res.on("data", (chunk) => {
+          received += chunk.length;
+          if (total > 0) {
+            const pct = Math.floor((received / total) * 100);
+            if (pct !== lastPct && pct % 10 === 0) {
+              process.stdout.write(`\r[conduit] Downloading... ${pct}%`);
+              lastPct = pct;
+            }
+          }
+        });
+
+        res.pipe(file);
+        file.on("finish", () => {
+          file.close(() => {
+            process.stdout.write("\r[conduit] Downloading... done    \n");
+            resolve();
+          });
+        });
+      }).on("error", (err) => {
+        file.close();
+        try { unlinkSync(dest); } catch { /* ignore */ }
+        reject(err);
+      });
+    }
+
+    request(url);
+  });
+}
+
+// --------------------------------------------------------------------------
+// Main
+// --------------------------------------------------------------------------
+async function main() {
+  const assetName = getAssetName();
+  const url = `https://github.com/${REPO}/releases/download/v${VERSION}/${assetName}`;
+  const dest = join(NATIVE_DIR, assetName);
+
+  // Skip if already downloaded (idempotent)
+  if (existsSync(dest)) {
+    return;
+  }
+
+  mkdirSync(NATIVE_DIR, { recursive: true });
+
+  console.log(`[conduit] Downloading v${VERSION} for ${process.platform}/${process.arch}`);
+  console.log(`[conduit] Source: ${url}`);
+
+  try {
+    await download(url, dest);
+  } catch (err) {
+    console.error(`\n[conduit] Download failed: ${err.message}`);
+    console.error(`[conduit] You can install from source: cargo install conduit-proxy`);
+    // Exit 0 so npm install doesn't fail for the whole project
+    process.exit(0);
+  }
+
+  // Make executable on Unix
+  if (process.platform !== "win32") {
+    chmodSync(dest, 0o755);
+  }
+
+  console.log(`[conduit] Binary installed to ${dest}`);
+}
+
+main();

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@lopatnov/conduit",
+  "version": "0.2.0",
+  "description": "High-performance reverse proxy and static file server powered by Cloudflare Pingora",
+  "keywords": [
+    "reverse-proxy",
+    "proxy",
+    "static-server",
+    "http",
+    "https",
+    "http2",
+    "load-balancer",
+    "rust",
+    "pingora"
+  ],
+  "homepage": "https://github.com/lopatnov/conduit#readme",
+  "bugs": {
+    "url": "https://github.com/lopatnov/conduit/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lopatnov/conduit.git"
+  },
+  "license": "Apache-2.0",
+  "author": "lopatnov",
+  "type": "module",
+  "bin": {
+    "conduit": "./bin/conduit.js"
+  },
+  "files": [
+    "bin/",
+    "Readme.md"
+  ],
+  "scripts": {
+    "postinstall": "node bin/download.js"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}