@edwinencomienda/live-reloader 1.0.0

package/README.md

@@ -0,0 +1,150 @@
+# Live Reloader
+
+A lightweight live-reload development server built with Bun. Serves static files and automatically reloads connected browsers when files change.
+
+## Installation
+
+Install globally using npm:
+
+```bash
+npm install -g live-reloader
+```
+
+Or using bun:
+
+```bash
+bun install -g live-reloader
+```
+
+**Note:** This package requires Bun to be installed on your system. [Install Bun](https://bun.sh/docs/installation) first if you haven't already.
+
+## Usage
+
+```bash
+# Serve current directory
+live-reloader
+
+# Serve a specific directory
+live-reloader ./public
+
+# Change the port
+live-reloader --port 5173
+
+# Custom host and port
+live-reloader ./public --host 0.0.0.0 --port 8080
+
+# Check version
+live-reloader --version
+```
+
+## Development
+
+### Prerequisites
+
+- [Bun](https://bun.sh/docs/installation) installed on your system
+
+### Getting Started
+
+Install dependencies:
+
+```bash
+bun install
+```
+
+Run in development mode (with hot reload):
+
+```bash
+bun run dev
+```
+
+Run from source:
+
+```bash
+bun run start
+
+# With options
+bun run start ./public --port 5173
+```
+
+### Building
+
+**Build for npm publishing:**
+
+```bash
+bun run build
+```
+
+This creates `dist/index.js` and is automatically run before publishing.
+
+**Build standalone binary:**
+
+```bash
+bun run build:binary
+```
+
+This creates a standalone executable at `dist/live-reloader` that includes the Bun runtime.
+
+## Publishing to npm
+
+### First Time Setup
+
+1. Create an npm account at [npmjs.com](https://www.npmjs.com/) if you don't have one
+2. Login to npm from your terminal:
+
+```bash
+npm login
+```
+
+### Publishing Updates
+
+1. **Update the version** in `package.json`:
+
+```bash
+# Patch release (0.1.4 -> 0.1.5)
+npm version patch
+
+# Minor release (0.1.4 -> 0.2.0)
+npm version minor
+
+# Major release (0.1.4 -> 1.0.0)
+npm version major
+```
+
+This automatically creates a git commit and tag.
+
+2. **Publish to npm**:
+
+```bash
+npm publish
+```
+
+The `prepublishOnly` script automatically builds the dist folder before publishing.
+
+3. **Push changes to GitHub**:
+
+```bash
+git push && git push --tags
+```
+
+### Testing Before Publishing
+
+Test the package locally before publishing:
+
+```bash
+# Build the package
+bun run build
+
+# Create a test link
+npm link
+
+# Test the CLI
+live-reloader --version
+
+# Unlink when done
+npm unlink -g live-reloader
+```
+
+---
+
+Built with [Bun](https://bun.sh) 🚀
+

package/dist/index.js

@@ -0,0 +1,232 @@
+#!/usr/bin/env bun
+// @bun
+
+// index.ts
+var {serve } = globalThis.Bun;
+import { watch } from "fs";
+import { networkInterfaces } from "os";
+import { resolve, sep } from "path";
+var VERSION = "0.1.4";
+var clients = new Set;
+var encoder = new TextEncoder;
+function parseArgs() {
+  const argv = Bun.argv.slice(2);
+  if (argv.includes("--version") || argv.includes("-v")) {
+    console.log(`live-reloader v${VERSION}`);
+    process.exit(0);
+  }
+  let port = 3000;
+  let hostname = "0.0.0.0";
+  let rootDir;
+  for (let i = 0;i < argv.length; i++) {
+    const a = argv[i];
+    if (a === "--port" || a === "-p") {
+      const v = argv[i + 1];
+      if (v) {
+        const n = Number(v);
+        if (Number.isFinite(n) && n > 0)
+          port = n;
+      }
+      i += 1;
+      continue;
+    }
+    if (a.startsWith("--port=")) {
+      const n = Number(a.slice("--port=".length));
+      if (Number.isFinite(n) && n > 0)
+        port = n;
+      continue;
+    }
+    if (a === "--host" || a === "-h") {
+      const v = argv[i + 1];
+      if (v && !v.startsWith("-")) {
+        hostname = v;
+      }
+      i += 1;
+      continue;
+    }
+    if (a.startsWith("--host=")) {
+      hostname = a.slice("--host=".length);
+      continue;
+    }
+    if (!a.startsWith("-") && !rootDir) {
+      rootDir = a;
+    }
+  }
+  return { port, hostname, rootDir: resolve(rootDir ?? process.cwd()) };
+}
+var { port, hostname, rootDir } = parseArgs();
+function now() {
+  return new Date().toISOString();
+}
+function log(line) {
+  console.log(`[${now()}] ${line}`);
+}
+function formatPath(url) {
+  return `${url.pathname}${url.search}`;
+}
+function getLocalIP() {
+  const interfaces = networkInterfaces();
+  for (const name of Object.keys(interfaces)) {
+    const iface = interfaces[name];
+    if (!iface)
+      continue;
+    for (const addr of iface) {
+      if (addr.family === "IPv4" && !addr.internal) {
+        return addr.address;
+      }
+    }
+  }
+  return;
+}
+var server;
+try {
+  server = serve({
+    port,
+    hostname,
+    async fetch(req) {
+      const url = new URL(req.url);
+      const reqPath = formatPath(url);
+      if (url.pathname === "/__reload") {
+        let controllerRef = null;
+        const stream = new ReadableStream({
+          start(controller) {
+            controllerRef = controller;
+            clients.add(controller);
+            controller.enqueue(encoder.encode(`retry: 1000
+
+`));
+            log(`SSE connected (clients=${clients.size})`);
+          },
+          cancel() {
+            if (controllerRef)
+              clients.delete(controllerRef);
+            log(`SSE disconnected (clients=${clients.size})`);
+          }
+        });
+        const res2 = new Response(stream, {
+          headers: {
+            "Content-Type": "text/event-stream; charset=utf-8",
+            "Cache-Control": "no-cache, no-transform",
+            Connection: "keep-alive"
+          }
+        });
+        log(`${req.method} ${reqPath} -> ${res2.status}`);
+        return res2;
+      }
+      let pathname;
+      try {
+        pathname = decodeURIComponent(url.pathname);
+      } catch {
+        const res2 = new Response("Bad Request", { status: 400 });
+        log(`${req.method} ${reqPath} -> ${res2.status}`);
+        return res2;
+      }
+      if (pathname === "/index.html") {
+        const res2 = Response.redirect(url.origin + "/" + url.search, 301);
+        log(`${req.method} ${reqPath} -> ${res2.status} (redirect to /)`);
+        return res2;
+      }
+      if (pathname === "/")
+        pathname = "/index.html";
+      const rootPrefix = rootDir.endsWith(sep) ? rootDir : rootDir + sep;
+      function isInsideRoot(p) {
+        return p === rootDir || p.startsWith(rootPrefix);
+      }
+      let resolvedPath = resolve(rootDir, `.${pathname}`);
+      if (!isInsideRoot(resolvedPath)) {
+        const res2 = new Response("Forbidden", { status: 403 });
+        log(`${req.method} ${reqPath} -> ${res2.status}`);
+        return res2;
+      }
+      let file = Bun.file(resolvedPath);
+      if (!await file.exists()) {
+        const hasExtension = pathname.includes(".") && !pathname.endsWith("/");
+        if (!hasExtension) {
+          const htmlPath = resolve(rootDir, `.${pathname}.html`);
+          if (isInsideRoot(htmlPath)) {
+            const htmlFile = Bun.file(htmlPath);
+            if (await htmlFile.exists()) {
+              resolvedPath = htmlPath;
+              file = htmlFile;
+            }
+          }
+        }
+      }
+      if (!await file.exists()) {
+        const res2 = new Response("Not Found", { status: 404 });
+        log(`${req.method} ${reqPath} -> ${res2.status}`);
+        return res2;
+      }
+      if (file.type.startsWith("text/html")) {
+        const t = await file.text();
+        const injected = `<script>
+const es=new EventSource('/__reload');
+es.onmessage=()=>location.reload();
+</script>`;
+        const body = t.includes("</body>") ? t.replace("</body>", `${injected}</body>`) : `${t}
+${injected}
+`;
+        const res2 = new Response(body, {
+          headers: {
+            "Content-Type": file.type || "text/html; charset=utf-8"
+          }
+        });
+        log(`${req.method} ${reqPath} -> ${res2.status} (${resolvedPath})`);
+        return res2;
+      }
+      const res = new Response(file);
+      log(`${req.method} ${reqPath} -> ${res.status} (${resolvedPath})`);
+      return res;
+    }
+  });
+} catch (err) {
+  const msg = err instanceof Error ? err.message : String(err);
+  if (msg.includes("EADDRINUSE") || msg.toLowerCase().includes("in use")) {
+    log(`Port ${port} is already in use.`);
+    console.log(`  Try using a different port: live-reloader --port ${port + 1}`);
+  } else {
+    log(`Failed to start server: ${msg}`);
+  }
+  process.exit(1);
+}
+console.log("");
+console.log(`\x1B[36m\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\x1B[0m`);
+console.log(`\x1B[32m  live-reloader v${VERSION}\x1B[0m`);
+console.log(`\x1B[36m\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\x1B[0m`);
+console.log(`\x1B[33m\uD83D\uDCC1 Root:\x1B[0m ${rootDir}`);
+console.log(`\x1B[33m\uD83D\uDD17 Local:\x1B[0m   \x1B[1mhttp://localhost:${server.port}\x1B[0m`);
+var localIP = getLocalIP();
+if (localIP) {
+  console.log(`\x1B[33m\uD83D\uDD17 Network:\x1B[0m \x1B[1mhttp://${localIP}:${server.port}\x1B[0m`);
+}
+console.log(`\x1B[33m\uD83D\uDC40 Watching for changes...\x1B[0m`);
+console.log(`\x1B[36m\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\u2550\x1B[0m`);
+console.log("");
+var reloadTimer;
+var watcher = watch(rootDir, { recursive: true }, (eventType, filename) => {
+  const label = filename ? String(filename) : "(unknown file)";
+  log(`fs.watch ${eventType}: ${label}`);
+  if (reloadTimer)
+    clearTimeout(reloadTimer);
+  reloadTimer = setTimeout(() => {
+    const msg = encoder.encode(`data: reload
+
+`);
+    let ok = 0;
+    for (const c of clients) {
+      try {
+        c.enqueue(msg);
+        ok += 1;
+      } catch {
+        clients.delete(c);
+      }
+    }
+    if (ok > 0)
+      log(`reload broadcast -> ${ok} client(s)`);
+  }, 75);
+});
+watcher.on("error", (e) => {
+  const msg = e instanceof Error ? e.message : String(e);
+  log(`fs.watch error: ${msg}`);
+});
+log(`Watching "${rootDir}" for changes (recursive)`);

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@edwinencomienda/live-reloader",
+  "version": "1.0.0",
+  "description": "A fast, simple live-reload development server with file watching",
+  "author": "Edwin Encomienda",
+  "license": "MIT",
+  "keywords": [
+    "live-reload",
+    "dev-server",
+    "file-watcher",
+    "development",
+    "hot-reload",
+    "bun",
+    "cli"
+  ],
+  "bin": {
+    "live-reloader": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "module": "index.ts",
+  "type": "module",
+  "scripts": {
+    "dev": "bun run --hot index.ts",
+    "start": "bun run index.ts",
+    "build": "bun build index.ts --outfile dist/index.js --target bun",
+    "build:binary": "bun build index.ts --compile --minify --outfile dist/live-reloader",
+    "prepublishOnly": "bun run build"
+  },
+  "devDependencies": {
+    "@types/bun": "latest"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/yourusername/live-reloader"
+  },
+  "bugs": {
+    "url": "https://github.com/yourusername/live-reloader/issues"
+  },
+  "homepage": "https://github.com/yourusername/live-reloader#readme"
+}