serve-reload 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 serve-reload contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,127 @@
+# serve-reload
+
+Zero-dependency static file server with live reload for development.
+
+Most static dev servers with live reload are either abandoned — accumulating security vulnerabilities flagged by `npm audit` — or bloated with features and dependencies far beyond what a simple dev server needs. serve-reload takes a different approach: it just serves and reloads, with zero dependencies, eliminating the problem of transitive security issues at the root.
+
+## Features
+
+- **Zero dependencies** — only Node.js built-ins
+- **Live reload** — via Server-Sent Events (no WebSocket library needed)
+- **CSS hot inject** — CSS changes apply instantly without a full page reload
+- **SPA mode** — fallback routing for single-page apps
+- **Proxy** — forward API requests to another server
+- **CORS enabled** — by default
+- **Glob ignore patterns** — `*.map`, `src/temp`, `**/test`, etc.
+- **Fast startup** — nothing to install beyond Node.js
+- **CLI + API** — use from the terminal or programmatically
+
+## Install
+
+```bash
+npm install -g serve-reload
+```
+
+Or use directly with npx:
+
+```bash
+npx serve-reload ./public
+```
+
+## CLI Usage
+
+```bash
+serve-reload [root] [options]
+```
+
+| Option | Description | Default |
+|---|---|---|
+| `-p, --port <n>` | Port number (auto-fallback if busy) | `3000` |
+| `--host <addr>` | Bind address | `0.0.0.0` |
+| `-o, --open` | Open browser on start | off |
+| `--no-reload` | Disable live reload | enabled |
+| `--no-cors` | Disable CORS headers | enabled |
+| `--spa <file>` | SPA fallback file | — |
+| `--quiet` | Suppress request logs | off |
+| `--ignore <patterns>` | Comma-separated ignore patterns | — |
+| `--proxy <route:url>` | Proxy route to URL (repeatable) | — |
+
+### Examples
+
+```bash
+# Serve current directory on port 3000
+serve-reload
+
+# Serve ./dist on port 8080, open browser
+serve-reload ./dist -p 8080 --open
+
+# SPA mode (all unknown routes → index.html)
+serve-reload ./build --spa index.html
+
+# Ignore source maps and temp files
+serve-reload --ignore "*.map,*.min.*,temp"
+
+# Proxy API requests
+serve-reload --proxy /api:https://api.example.com
+
+# Multiple proxies
+serve-reload --proxy /api:https://api.example.com --proxy /auth:http://localhost:4000
+
+# Disable live reload (just a static server)
+serve-reload ./public --no-reload
+```
+
+## Ignore Patterns
+
+The `--ignore` option controls which file changes **do not trigger a reload**. Ignored files are still served normally over HTTP — they just won't cause the browser to refresh.
+
+Supported patterns:
+
+| Pattern | Example | Matches |
+|---|---|---|
+| `node_modules` | Plain name | Any path segment named `node_modules` |
+| `*.map` | Extension glob | `dist/bundle.js.map` |
+| `*.min.*` | Multi-extension | `bundle.min.js` |
+| `src/temp` | Path prefix | `src/temp` and `src/temp/file.js` |
+| `**/test` | Recursive glob | `test`, `src/test`, `deep/nested/test` |
+| `?.js` | Single character | `a.js` but not `ab.js` |
+
+Default ignored: `node_modules`, `.git`, `.DS_Store`
+
+## Programmatic API
+
+```ts
+import { ServeReload } from "serve-reload";
+
+const server = new ServeReload({
+  root: "./public",
+  port: 8080,
+  open: true,
+  spa: "index.html",
+  ignore: ["*.map", "temp"],
+  proxy: {
+    "/api": "https://api.example.com",
+  },
+});
+
+server.start();
+
+// Later...
+await server.stop();
+```
+
+## How It Works
+
+1. **Static serving** — Node's built-in `http` module serves files with correct MIME types
+2. **HTML injection** — A tiny `<script>` is injected into HTML responses that opens an SSE connection
+3. **File watching** — `fs.watch` (recursive) monitors the served directory for changes
+4. **Reload signal** — When a non-CSS file changes, all connected browsers reload. When a CSS file changes, stylesheets are hot-swapped without a full reload
+5. **Reconnect** — If the server restarts, the browser automatically reconnects and reloads
+
+## Requirements
+
+Node.js ≥ 18
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+/**
+ * serve-reload CLI
+ *
+ * Usage:
+ *   serve-reload [root] [options]
+ *
+ * Options:
+ *   -p, --port <n>      Port number (default: 3000)
+ *   --host <addr>       Bind address (default: 0.0.0.0)
+ *   -o, --open          Open browser on start
+ *   --no-reload         Disable live reload
+ *   --no-cors           Disable CORS headers
+ *   --spa <file>        SPA fallback file (e.g. index.html)
+ *   --quiet             Suppress request logging
+ *   --ignore <dirs>     Comma-separated dirs to ignore
+ *   --proxy <r:url>     Proxy route to URL (repeatable)
+ *   --help              Show this help
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;;;GAiBG"}

package/dist/cli.js

@@ -0,0 +1,111 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * serve-reload CLI
+ *
+ * Usage:
+ *   serve-reload [root] [options]
+ *
+ * Options:
+ *   -p, --port <n>      Port number (default: 3000)
+ *   --host <addr>       Bind address (default: 0.0.0.0)
+ *   -o, --open          Open browser on start
+ *   --no-reload         Disable live reload
+ *   --no-cors           Disable CORS headers
+ *   --spa <file>        SPA fallback file (e.g. index.html)
+ *   --quiet             Suppress request logging
+ *   --ignore <dirs>     Comma-separated dirs to ignore
+ *   --proxy <r:url>     Proxy route to URL (repeatable)
+ *   --help              Show this help
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const server_js_1 = require("./server.js");
+const args = process.argv.slice(2);
+if (args.includes("--help")) {
+    console.log(`
+  serve-reload — Zero-dependency static file server with live reload
+
+  Usage:
+    serve-reload [root] [options]
+
+  Options:
+    -p, --port <n>      Port number (default: 3000)
+    --host <addr>       Bind address (default: 0.0.0.0)
+    -o, --open          Open browser on start
+    --no-reload         Disable live reload
+    --no-cors           Disable CORS headers
+    --spa <file>        SPA fallback file (e.g. index.html)
+    --quiet             Suppress request logging
+    --ignore <dirs>     Comma-separated directory names to ignore
+    --proxy <r:url>     Proxy route to URL (repeatable, e.g. /api:https://api.example.com)
+    --help              Show this help
+
+  Examples:
+    serve-reload
+    serve-reload ./dist -p 8080 --open
+    serve-reload ./public --spa index.html
+    serve-reload --proxy /api:https://api.example.com --proxy /auth:http://localhost:4000
+`);
+    process.exit(0);
+}
+function getArg(flags) {
+    for (const flag of flags) {
+        const idx = args.indexOf(flag);
+        if (idx !== -1 && idx + 1 < args.length) {
+            return args[idx + 1];
+        }
+    }
+    return undefined;
+}
+function hasFlag(flags) {
+    return flags.some((f) => args.includes(f));
+}
+// The first non-flag argument is the root directory
+let root = ".";
+for (const arg of args) {
+    if (!arg.startsWith("-")) {
+        root = arg;
+        break;
+    }
+}
+const server = new server_js_1.ServeReload({
+    root,
+    port: parseInt(getArg(["-p", "--port"]) ?? "3000", 10),
+    host: getArg(["--host"]) ?? "0.0.0.0",
+    open: hasFlag(["-o", "--open"]),
+    reload: !hasFlag(["--no-reload"]),
+    cors: !hasFlag(["--no-cors"]),
+    quiet: hasFlag(["--quiet"]),
+    spa: getArg(["--spa"]) ?? null,
+    ignore: getArg(["--ignore"])?.split(",").map((s) => s.trim()) ?? [],
+    proxy: parseProxy(),
+});
+function parseProxy() {
+    const result = {};
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === "--proxy" && i + 1 < args.length) {
+            const val = args[i + 1];
+            const sep = val.indexOf(":", val.startsWith("/") ? 1 : 0);
+            if (sep === -1) {
+                console.error(`  Invalid proxy format: ${val} (expected /route:url)`);
+                process.exit(1);
+            }
+            const route = val.slice(0, sep);
+            const target = val.slice(sep + 1);
+            result[route] = target;
+        }
+    }
+    return result;
+}
+server.start();
+// Graceful shutdown
+process.on("SIGINT", async () => {
+    console.log("\n  Shutting down...");
+    await server.stop();
+    process.exit(0);
+});
+process.on("SIGTERM", async () => {
+    await server.stop();
+    process.exit(0);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/glob.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Minimal glob-to-regex converter. Zero dependencies.
+ *
+ * Supported patterns:
+ *   "node_modules"     → matches any path segment named node_modules
+ *   "*.map"            → matches any file ending in .map
+ *   "src/temp"         → matches exact relative prefix
+ *   "**​/test"          → matches "test" at any depth
+ *   "*.min.*"          → matches e.g. bundle.min.js
+ *   ".git"             → matches .git directory/file
+ */
+export declare function createMatcher(patterns: string[]): (filePath: string) => boolean;
+//# sourceMappingURL=glob.d.ts.map

package/dist/glob.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.d.ts","sourceRoot":"","sources":["../src/glob.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAU/E"}

package/dist/glob.js

@@ -0,0 +1,90 @@
+"use strict";
+/**
+ * Minimal glob-to-regex converter. Zero dependencies.
+ *
+ * Supported patterns:
+ *   "node_modules"     → matches any path segment named node_modules
+ *   "*.map"            → matches any file ending in .map
+ *   "src/temp"         → matches exact relative prefix
+ *   "**​/test"          → matches "test" at any depth
+ *   "*.min.*"          → matches e.g. bundle.min.js
+ *   ".git"             → matches .git directory/file
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMatcher = createMatcher;
+function createMatcher(patterns) {
+    if (patterns.length === 0)
+        return () => false;
+    const matchers = patterns.map((p) => compileSingle(p));
+    return (filePath) => {
+        // Normalize to forward slashes for matching
+        const normalized = filePath.replace(/\\/g, "/");
+        return matchers.some((m) => m(normalized));
+    };
+}
+function compileSingle(pattern) {
+    const p = pattern.replace(/\\/g, "/");
+    // Plain name without glob chars or slashes → match any segment
+    if (!p.includes("*") && !p.includes("/") && !p.includes("?")) {
+        return (filePath) => {
+            const segments = filePath.split("/");
+            return segments.includes(p);
+        };
+    }
+    // Patterns with slashes but no globs → match as prefix (dir) or exact
+    if (!p.includes("*") && !p.includes("?") && p.includes("/")) {
+        return (filePath) => filePath === p || filePath.startsWith(p + "/");
+    }
+    // Convert glob to regex
+    const regexStr = globToRegex(p);
+    const regex = new RegExp(regexStr);
+    return (filePath) => regex.test(filePath);
+}
+function globToRegex(glob) {
+    let result = "";
+    let i = 0;
+    // If pattern doesn't start with ** or a path separator, allow matching
+    // against any segment boundary (e.g. "*.map" matches "dir/foo.map")
+    const matchAnywhere = !glob.startsWith("/") && !glob.startsWith("**/");
+    if (matchAnywhere) {
+        result += "(?:^|/)";
+    }
+    else {
+        result += "^";
+    }
+    while (i < glob.length) {
+        const ch = glob[i];
+        if (ch === "*" && glob[i + 1] === "*") {
+            // ** matches any depth (including zero segments)
+            if (glob[i + 2] === "/") {
+                result += "(?:.+/)?";
+                i += 3;
+            }
+            else {
+                result += ".*";
+                i += 2;
+            }
+        }
+        else if (ch === "*") {
+            // * matches anything except /
+            result += "[^/]*";
+            i++;
+        }
+        else if (ch === "?") {
+            // ? matches single char except /
+            result += "[^/]";
+            i++;
+        }
+        else {
+            // Escape regex special chars
+            result += escapeRegex(ch);
+            i++;
+        }
+    }
+    result += "$";
+    return result;
+}
+function escapeRegex(ch) {
+    return ch.replace(/[.+^${}()|[\]\\]/g, "\\$&");
+}
+//# sourceMappingURL=glob.js.map

package/dist/glob.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"glob.js","sourceRoot":"","sources":["../src/glob.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * serve-reload — Zero-dependency static file server with live reload.
+ *
+ * Usage (programmatic):
+ *
+ *   import { ServeReload } from "serve-reload";
+ *   const server = new ServeReload({ root: "./public", port: 8080 });
+ *   server.start();
+ */
+export { ServeReload } from "./server.js";
+export type { ServeReloadOptions } from "./server.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,15 @@
+"use strict";
+/**
+ * serve-reload — Zero-dependency static file server with live reload.
+ *
+ * Usage (programmatic):
+ *
+ *   import { ServeReload } from "serve-reload";
+ *   const server = new ServeReload({ root: "./public", port: 8080 });
+ *   server.start();
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServeReload = void 0;
+var server_js_1 = require("./server.js");
+Object.defineProperty(exports, "ServeReload", { enumerable: true, get: function () { return server_js_1.ServeReload; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAEH,yCAA0C;AAAjC,wGAAA,WAAW,OAAA"}

package/dist/injector.d.ts

@@ -0,0 +1,11 @@
+/**
+ * The tiny client-side script injected into HTML pages.
+ * Uses Server-Sent Events (SSE) to listen for reload signals.
+ * Automatically reconnects if the connection drops (server restart).
+ */
+/**
+ * Inject the live-reload script into an HTML string.
+ * Inserts right before </body> if present, otherwise appends to the end.
+ */
+export declare function inject(html: string, sseEndpoint: string): string;
+//# sourceMappingURL=injector.d.ts.map

package/dist/injector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"injector.d.ts","sourceRoot":"","sources":["../src/injector.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;;GAGG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAShE"}

package/dist/injector.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * The tiny client-side script injected into HTML pages.
+ * Uses Server-Sent Events (SSE) to listen for reload signals.
+ * Automatically reconnects if the connection drops (server restart).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.inject = inject;
+function clientScript(sseEndpoint) {
+    return `<script>/*serve-reload*/(function(){var c=!1;function n(){var e=new EventSource("${sseEndpoint}");e.onmessage=function(ev){var d=ev.data;if(d==="1")return location.reload();var t=Date.now();document.querySelectorAll('link[rel="stylesheet"]').forEach(function(l){var h=l.getAttribute("href");if(h&&h.split("?")[0].endsWith(d)){l.setAttribute("href",h.split("?")[0]+"?t="+t)}})};e.onopen=function(){if(c)location.reload();c=!0};e.onerror=function(){e.close();setTimeout(n,1e3)}}n()})()</script>`;
+}
+/**
+ * Inject the live-reload script into an HTML string.
+ * Inserts right before </body> if present, otherwise appends to the end.
+ */
+function inject(html, sseEndpoint) {
+    const script = clientScript(sseEndpoint);
+    if (html.includes("</body>")) {
+        return html.replace("</body>", script + "\n</body>");
+    }
+    if (html.includes("</head>")) {
+        return html.replace("</head>", script + "\n</head>");
+    }
+    return html + script;
+}
+//# sourceMappingURL=injector.js.map

package/dist/injector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"injector.js","sourceRoot":"","sources":["../src/injector.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;AAUH,wBASC;AAjBD,SAAS,YAAY,CAAC,WAAmB;IACvC,OAAO,oFAAoF,WAAW,+YAA+Y,CAAC;AACxf,CAAC;AAED;;;GAGG;AACH,SAAgB,MAAM,CAAC,IAAY,EAAE,WAAmB;IACtD,MAAM,MAAM,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;IACzC,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,CAAC,CAAC;IACvD,CAAC;IACD,OAAO,IAAI,GAAG,MAAM,CAAC;AACvB,CAAC"}

package/dist/mime.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Minimal MIME type lookup by file extension.
+ * Covers the most common static file types served during development.
+ */
+export declare function lookup(filePath: string): string;
+//# sourceMappingURL=mime.d.ts.map

package/dist/mime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mime.d.ts","sourceRoot":"","sources":["../src/mime.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAgDH,wBAAgB,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAG/C"}

package/dist/mime.js

@@ -0,0 +1,55 @@
+"use strict";
+/**
+ * Minimal MIME type lookup by file extension.
+ * Covers the most common static file types served during development.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.lookup = lookup;
+const node_path_1 = __importDefault(require("node:path"));
+const MIME_TYPES = {
+    // Text / markup
+    ".html": "text/html; charset=utf-8",
+    ".htm": "text/html; charset=utf-8",
+    ".css": "text/css; charset=utf-8",
+    ".js": "application/javascript; charset=utf-8",
+    ".mjs": "application/javascript; charset=utf-8",
+    ".json": "application/json; charset=utf-8",
+    ".xml": "application/xml; charset=utf-8",
+    ".txt": "text/plain; charset=utf-8",
+    ".md": "text/markdown; charset=utf-8",
+    ".csv": "text/csv; charset=utf-8",
+    // Images
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".gif": "image/gif",
+    ".svg": "image/svg+xml",
+    ".ico": "image/x-icon",
+    ".webp": "image/webp",
+    ".avif": "image/avif",
+    // Fonts
+    ".woff": "font/woff",
+    ".woff2": "font/woff2",
+    ".ttf": "font/ttf",
+    ".otf": "font/otf",
+    ".eot": "application/vnd.ms-fontobject",
+    // Media
+    ".mp4": "video/mp4",
+    ".webm": "video/webm",
+    ".ogg": "audio/ogg",
+    ".mp3": "audio/mpeg",
+    ".wav": "audio/wav",
+    // Other
+    ".pdf": "application/pdf",
+    ".zip": "application/zip",
+    ".wasm": "application/wasm",
+    ".map": "application/json",
+};
+function lookup(filePath) {
+    const ext = node_path_1.default.extname(filePath).toLowerCase();
+    return MIME_TYPES[ext] || "application/octet-stream";
+}
+//# sourceMappingURL=mime.js.map

package/dist/mime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mime.js","sourceRoot":"","sources":["../src/mime.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;AAgDH,wBAGC;AAjDD,0DAA6B;AAE7B,MAAM,UAAU,GAA2B;IACzC,gBAAgB;IAChB,OAAO,EAAE,0BAA0B;IACnC,MAAM,EAAE,0BAA0B;IAClC,MAAM,EAAE,yBAAyB;IACjC,KAAK,EAAE,uCAAuC;IAC9C,MAAM,EAAE,uCAAuC;IAC/C,OAAO,EAAE,iCAAiC;IAC1C,MAAM,EAAE,gCAAgC;IACxC,MAAM,EAAE,2BAA2B;IACnC,KAAK,EAAE,8BAA8B;IACrC,MAAM,EAAE,yBAAyB;IAEjC,SAAS;IACT,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,eAAe;IACvB,MAAM,EAAE,cAAc;IACtB,OAAO,EAAE,YAAY;IACrB,OAAO,EAAE,YAAY;IAErB,QAAQ;IACR,OAAO,EAAE,WAAW;IACpB,QAAQ,EAAE,YAAY;IACtB,MAAM,EAAE,UAAU;IAClB,MAAM,EAAE,UAAU;IAClB,MAAM,EAAE,+BAA+B;IAEvC,QAAQ;IACR,MAAM,EAAE,WAAW;IACnB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,WAAW;IAEnB,QAAQ;IACR,MAAM,EAAE,iBAAiB;IACzB,MAAM,EAAE,iBAAiB;IACzB,OAAO,EAAE,kBAAkB;IAC3B,MAAM,EAAE,kBAAkB;CAC3B,CAAC;AAEF,SAAgB,MAAM,CAAC,QAAgB;IACrC,MAAM,GAAG,GAAG,mBAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IACjD,OAAO,UAAU,CAAC,GAAG,CAAC,IAAI,0BAA0B,CAAC;AACvD,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Core static file server with SSE-based live reload.
+ */
+import http from "node:http";
+export interface ServeReloadOptions {
+    /** Directory to serve (default ".") */
+    root?: string;
+    /** Port number (default 3000) */
+    port?: number;
+    /** Host to bind (default "0.0.0.0") */
+    host?: string;
+    /** Open browser on start (default false) */
+    open?: boolean;
+    /** Enable live reload (default true) */
+    reload?: boolean;
+    /** Enable permissive CORS (default true) */
+    cors?: boolean;
+    /** Suppress request logging (default false) */
+    quiet?: boolean;
+    /** Extra directory names to ignore when watching */
+    ignore?: string[];
+    /** Serve this file for 404s — SPA mode (e.g. "index.html") */
+    spa?: string | null;
+    /** Proxy rules: { route: targetURL } (e.g. { "/api": "https://api.example.com" }) */
+    proxy?: Record<string, string>;
+}
+export declare class ServeReload {
+    root: string;
+    port: number;
+    host: string;
+    open: boolean;
+    reload: boolean;
+    cors: boolean;
+    quiet: boolean;
+    spa: string | null;
+    ignore: string[];
+    proxy: Map<string, string>;
+    private requestedPort;
+    private clients;
+    private connections;
+    _server: http.Server | null;
+    private watcher;
+    constructor(opts?: ServeReloadOptions);
+    start(): this;
+    stop(): Promise<void>;
+    handleRequest(req: http.IncomingMessage, res: http.ServerResponse): void;
+    private serveFile;
+    private handle404;
+    private handleSSE;
+    private broadcast;
+    private matchProxy;
+    private handleProxy;
+    private log;
+    private openBrowser;
+}
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAa7B,MAAM,WAAW,kBAAkB;IACjC,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iCAAiC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,wCAAwC;IACxC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,4CAA4C;IAC5C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,+CAA+C;IAC/C,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,8DAA8D;IAC9D,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,qFAAqF;IACrF,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAChC;AAED,qBAAa,WAAW;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE3B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,WAAW,CAAyB;IAE5C,OAAO,EAAE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAQ;IACnC,OAAO,CAAC,OAAO,CAAwB;gBAE3B,IAAI,GAAE,kBAAuB;IAczC,KAAK,IAAI,IAAI;IAmDP,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAqB3B,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,GAAG,EAAE,IAAI,CAAC,cAAc,GAAG,IAAI;IA6CxE,OAAO,CAAC,SAAS;IAuDjB,OAAO,CAAC,SAAS;IAsBjB,OAAO,CAAC,SAAS;IAcjB,OAAO,CAAC,SAAS;IAUjB,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,WAAW;IAoCnB,OAAO,CAAC,GAAG;IAOX,OAAO,CAAC,WAAW;CASpB"}

package/dist/server.js

@@ -0,0 +1,286 @@
+"use strict";
+/**
+ * Core static file server with SSE-based live reload.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServeReload = void 0;
+const node_http_1 = __importDefault(require("node:http"));
+const node_https_1 = __importDefault(require("node:https"));
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_url_1 = require("node:url");
+const node_child_process_1 = require("node:child_process");
+const mime_js_1 = require("./mime.js");
+const injector_js_1 = require("./injector.js");
+const watcher_js_1 = require("./watcher.js");
+const SSE_ENDPOINT = "/__serve_reload_sse__";
+class ServeReload {
+    root;
+    port;
+    host;
+    open;
+    reload;
+    cors;
+    quiet;
+    spa;
+    ignore;
+    proxy;
+    requestedPort;
+    clients = new Set();
+    connections = new Set();
+    /* @internal – exposed for testing */
+    _server = null;
+    watcher = null;
+    constructor(opts = {}) {
+        this.root = node_path_1.default.resolve(opts.root ?? ".");
+        this.port = opts.port ?? 3000;
+        this.host = opts.host ?? "0.0.0.0";
+        this.open = opts.open ?? false;
+        this.reload = opts.reload ?? true;
+        this.cors = opts.cors ?? true;
+        this.quiet = opts.quiet ?? false;
+        this.spa = opts.spa ?? null;
+        this.ignore = ["node_modules", ".git", ".DS_Store", ...(opts.ignore ?? [])];
+        this.proxy = new Map(Object.entries(opts.proxy ?? {}));
+        this.requestedPort = this.port;
+    }
+    start() {
+        this._server = node_http_1.default.createServer((req, res) => this.handleRequest(req, res));
+        // Track open connections so we can destroy them on stop
+        this._server.on("connection", (socket) => {
+            this.connections.add(socket);
+            socket.on("close", () => this.connections.delete(socket));
+        });
+        this._server.on("error", (err) => {
+            if (err.code === "EADDRINUSE" && this.port === this.requestedPort) {
+                console.log(`  Port ${this.port} is busy, using a random port...`);
+                this.port = 0;
+                this._server.listen(0, this.host);
+            }
+            else {
+                throw err;
+            }
+        });
+        this._server.listen(this.port, this.host, () => {
+            const addr = this._server.address();
+            this.port = addr.port;
+            const url = `http://localhost:${this.port}`;
+            console.log(`\n  serve-reload\n`);
+            console.log(`  Serving   ${this.root}`);
+            console.log(`  Local     ${url}`);
+            if (this.reload)
+                console.log(`  Reload    enabled`);
+            if (this.spa)
+                console.log(`  SPA       fallback → ${this.spa}`);
+            for (const [route, target] of this.proxy) {
+                console.log(`  Proxy     ${route} → ${target}`);
+            }
+            console.log();
+            if (this.open)
+                this.openBrowser(url);
+        });
+        if (this.reload) {
+            this.watcher = new watcher_js_1.Watcher(this.root, {
+                ignore: this.ignore,
+                onChange: (filePath) => {
+                    const isCSS = filePath.endsWith(".css");
+                    if (!this.quiet)
+                        console.log(`  ${isCSS ? "css" : "changed"}   ${filePath}`);
+                    this.broadcast(filePath);
+                },
+            });
+            this.watcher.start();
+        }
+        return this;
+    }
+    async stop() {
+        if (this.watcher)
+            this.watcher.stop();
+        for (const res of this.clients) {
+            res.end();
+        }
+        this.clients.clear();
+        // Destroy all open sockets so server.close() doesn't hang
+        for (const socket of this.connections) {
+            socket.destroy();
+        }
+        this.connections.clear();
+        if (this._server) {
+            await new Promise((resolve) => this._server.close(() => resolve()));
+        }
+    }
+    /* ---- request handling ---- */
+    handleRequest(req, res) {
+        // SSE endpoint
+        if (req.url === SSE_ENDPOINT) {
+            return this.handleSSE(req, res);
+        }
+        // Proxy
+        const proxyTarget = this.matchProxy(req.url);
+        if (proxyTarget) {
+            return this.handleProxy(req, res, proxyTarget.target, proxyTarget.rewrittenPath);
+        }
+        // CORS headers
+        if (this.cors) {
+            res.setHeader("Access-Control-Allow-Origin", "*");
+            res.setHeader("Access-Control-Allow-Methods", "GET, HEAD, OPTIONS");
+            res.setHeader("Access-Control-Allow-Headers", "*");
+            if (req.method === "OPTIONS") {
+                res.writeHead(204);
+                return void res.end();
+            }
+        }
+        // Only GET / HEAD
+        if (req.method !== "GET" && req.method !== "HEAD") {
+            res.writeHead(405, { "Content-Type": "text/plain" });
+            return void res.end("Method Not Allowed");
+        }
+        // Decode & sanitize URL
+        let urlPath;
+        try {
+            urlPath = decodeURIComponent(req.url.split("?")[0]);
+        }
+        catch {
+            res.writeHead(400);
+            return void res.end("Bad Request");
+        }
+        // Prevent path traversal
+        const safePath = node_path_1.default.normalize(urlPath).replace(/^(\.\.[/\\])+/, "");
+        const filePath = node_path_1.default.join(this.root, safePath);
+        this.serveFile(req, res, filePath, urlPath);
+    }
+    serveFile(req, res, filePath, urlPath) {
+        node_fs_1.default.stat(filePath, (err, stats) => {
+            if (err || !stats || (!stats.isFile() && !stats.isDirectory())) {
+                return this.handle404(req, res, urlPath);
+            }
+            // Directory → try index.html
+            if (stats.isDirectory()) {
+                if (!urlPath.endsWith("/")) {
+                    res.writeHead(301, { Location: urlPath + "/" });
+                    return void res.end();
+                }
+                return this.serveFile(req, res, node_path_1.default.join(filePath, "index.html"), urlPath);
+            }
+            const mimeType = (0, mime_js_1.lookup)(filePath);
+            const isHTML = mimeType.startsWith("text/html");
+            if (isHTML && this.reload) {
+                // Read entirely to inject script
+                node_fs_1.default.readFile(filePath, "utf-8", (readErr, content) => {
+                    if (readErr) {
+                        res.writeHead(500);
+                        return void res.end("Internal Server Error");
+                    }
+                    const injected = (0, injector_js_1.inject)(content, SSE_ENDPOINT);
+                    const buf = Buffer.from(injected, "utf-8");
+                    res.writeHead(200, {
+                        "Content-Type": mimeType,
+                        "Content-Length": buf.length,
+                        "Cache-Control": "no-cache, no-store, must-revalidate",
+                    });
+                    if (req.method === "HEAD")
+                        return void res.end();
+                    res.end(buf);
+                    this.log(200, urlPath);
+                });
+            }
+            else {
+                // Stream the file
+                res.writeHead(200, {
+                    "Content-Type": mimeType,
+                    "Content-Length": stats.size,
+                    "Cache-Control": "no-cache",
+                });
+                if (req.method === "HEAD")
+                    return void res.end();
+                node_fs_1.default.createReadStream(filePath).pipe(res);
+                this.log(200, urlPath);
+            }
+        });
+    }
+    handle404(req, res, urlPath) {
+        // SPA fallback
+        if (this.spa) {
+            const spaPath = node_path_1.default.join(this.root, this.spa);
+            if (node_fs_1.default.existsSync(spaPath)) {
+                return this.serveFile(req, res, spaPath, urlPath);
+            }
+        }
+        res.writeHead(404, { "Content-Type": "text/html; charset=utf-8" });
+        res.end(`<!DOCTYPE html><html><head><title>404</title></head><body><h1>404 — Not Found</h1><p>${urlPath}</p></body></html>`);
+        this.log(404, urlPath);
+    }
+    /* ---- SSE ---- */
+    handleSSE(_req, res) {
+        res.writeHead(200, {
+            "Content-Type": "text/event-stream",
+            "Cache-Control": "no-cache",
+            Connection: "keep-alive",
+        });
+        res.write(":\n\n"); // comment to keep alive
+        this.clients.add(res);
+        _req.on("close", () => {
+            this.clients.delete(res);
+        });
+    }
+    broadcast(filePath) {
+        const isCSS = filePath.endsWith(".css");
+        const msg = isCSS ? `data: ${filePath}\n\n` : `data: 1\n\n`;
+        for (const client of this.clients) {
+            client.write(msg);
+        }
+    }
+    /* ---- proxy ---- */
+    matchProxy(url) {
+        const urlPath = url.split("?")[0];
+        for (const [route, target] of this.proxy) {
+            if (urlPath === route || urlPath.startsWith(route + "/") || urlPath.startsWith(route + "?")) {
+                // Keep the full original URL (path + query) for forwarding
+                return { target, rewrittenPath: url };
+            }
+        }
+        return null;
+    }
+    handleProxy(req, res, target, forwardPath) {
+        const targetUrl = new node_url_1.URL(forwardPath, target);
+        const lib = targetUrl.protocol === "https:" ? node_https_1.default : node_http_1.default;
+        const proxyReq = lib.request(targetUrl, {
+            method: req.method,
+            headers: {
+                ...req.headers,
+                host: targetUrl.host,
+            },
+        }, (proxyRes) => {
+            res.writeHead(proxyRes.statusCode ?? 502, proxyRes.headers);
+            proxyRes.pipe(res);
+            this.log(proxyRes.statusCode ?? 502, `⇄ ${forwardPath}`);
+        });
+        proxyReq.on("error", (err) => {
+            res.writeHead(502, { "Content-Type": "text/plain" });
+            res.end(`Proxy error: ${err.message}`);
+            this.log(502, `⇄ ${forwardPath}`);
+        });
+        req.pipe(proxyReq);
+    }
+    /* ---- helpers ---- */
+    log(status, urlPath) {
+        if (this.quiet)
+            return;
+        const color = status < 400 ? "\x1b[32m" : "\x1b[33m";
+        const reset = "\x1b[0m";
+        console.log(`  ${color}${status}${reset}  ${urlPath}`);
+    }
+    openBrowser(url) {
+        const cmd = process.platform === "darwin"
+            ? "open"
+            : process.platform === "win32"
+                ? "start"
+                : "xdg-open";
+        (0, node_child_process_1.exec)(`${cmd} ${url}`);
+    }
+}
+exports.ServeReload = ServeReload;
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/watcher.d.ts

@@ -0,0 +1,32 @@
+/**
+ * File watcher built on top of fs.watch (recursive mode).
+ *
+ * fs.watch with { recursive: true } is supported on macOS and Windows.
+ * On Linux (kernel ≥ 5.9, Node ≥ 19.1) it is also supported.
+ * For older Linux, we fall back to walking the directory tree and
+ * watching each subdirectory individually.
+ */
+export interface WatcherOptions {
+    /** Patterns to ignore (directory names, globs, paths). e.g. ["node_modules", "*.map", "src/temp"] */
+    ignore?: string[];
+    /** Milliseconds to debounce rapid changes (default 150) */
+    debounce?: number;
+    /** Callback invoked with the relative file path that changed */
+    onChange?: (filePath: string) => void;
+}
+export declare class Watcher {
+    readonly root: string;
+    private readonly ignoreSet;
+    private readonly isIgnored;
+    private readonly debounce;
+    private readonly onChange;
+    private watchers;
+    private timers;
+    constructor(root: string, opts?: WatcherOptions);
+    start(): void;
+    stop(): void;
+    private tryRecursive;
+    private walkAndWatch;
+    private handle;
+}
+//# sourceMappingURL=watcher.d.ts.map

package/dist/watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.d.ts","sourceRoot":"","sources":["../src/watcher.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH,MAAM,WAAW,cAAc;IAC7B,qGAAqG;IACrG,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC;AAED,qBAAa,OAAO;IAClB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAc;IACxC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAgC;IAC1D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IACtD,OAAO,CAAC,QAAQ,CAAsB;IACtC,OAAO,CAAC,MAAM,CAAoD;gBAEtD,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,cAAmB;IAWnD,KAAK,IAAI,IAAI;IAQb,IAAI,IAAI,IAAI;IAaZ,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,YAAY;IAepB,OAAO,CAAC,MAAM;CAef"}

package/dist/watcher.js

@@ -0,0 +1,90 @@
+"use strict";
+/**
+ * File watcher built on top of fs.watch (recursive mode).
+ *
+ * fs.watch with { recursive: true } is supported on macOS and Windows.
+ * On Linux (kernel ≥ 5.9, Node ≥ 19.1) it is also supported.
+ * For older Linux, we fall back to walking the directory tree and
+ * watching each subdirectory individually.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Watcher = void 0;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const glob_js_1 = require("./glob.js");
+class Watcher {
+    root;
+    ignoreSet;
+    isIgnored;
+    debounce;
+    onChange;
+    watchers = [];
+    timers = new Map();
+    constructor(root, opts = {}) {
+        this.root = node_path_1.default.resolve(root);
+        const patterns = opts.ignore ?? ["node_modules", ".git", ".DS_Store"];
+        // Simple names go into a Set for fast directory-walk filtering
+        this.ignoreSet = new Set(patterns.filter((p) => !p.includes("*") && !p.includes("/") && !p.includes("?")));
+        // Full glob matcher for all patterns
+        this.isIgnored = (0, glob_js_1.createMatcher)(patterns);
+        this.debounce = opts.debounce ?? 150;
+        this.onChange = opts.onChange ?? (() => { });
+    }
+    start() {
+        try {
+            this.tryRecursive();
+        }
+        catch {
+            this.walkAndWatch(this.root);
+        }
+    }
+    stop() {
+        for (const w of this.watchers) {
+            w.close();
+        }
+        this.watchers = [];
+        for (const t of this.timers.values()) {
+            clearTimeout(t);
+        }
+        this.timers.clear();
+    }
+    /* ---- internals ---- */
+    tryRecursive() {
+        const w = node_fs_1.default.watch(this.root, { recursive: true }, (_, filename) => {
+            if (filename)
+                this.handle(filename);
+        });
+        this.watchers.push(w);
+    }
+    walkAndWatch(dir) {
+        if (this.ignoreSet.has(node_path_1.default.basename(dir)))
+            return;
+        const w = node_fs_1.default.watch(dir, (_, filename) => {
+            if (filename)
+                this.handle(node_path_1.default.relative(this.root, node_path_1.default.join(dir, filename)));
+        });
+        this.watchers.push(w);
+        for (const entry of node_fs_1.default.readdirSync(dir, { withFileTypes: true })) {
+            if (entry.isDirectory() && !this.ignoreSet.has(entry.name)) {
+                this.walkAndWatch(node_path_1.default.join(dir, entry.name));
+            }
+        }
+    }
+    handle(relative) {
+        if (this.isIgnored(relative))
+            return;
+        // debounce per file
+        const existing = this.timers.get(relative);
+        if (existing)
+            clearTimeout(existing);
+        this.timers.set(relative, setTimeout(() => {
+            this.timers.delete(relative);
+            this.onChange(relative);
+        }, this.debounce));
+    }
+}
+exports.Watcher = Watcher;
+//# sourceMappingURL=watcher.js.map

package/dist/watcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"watcher.js","sourceRoot":"","sources":["../src/watcher.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "serve-reload",
+  "version": "1.0.0",
+  "description": "Zero-dependency static file server with live reload for development",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "serve-reload": "dist/cli.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch & node --watch-path=dist dist/cli.js",
+    "start": "node dist/cli.js",
+    "test": "node test/test.js && node test/glob.test.js",
+    "prepublishOnly": "tsc && npm test"
+  },
+  "keywords": [
+    "static",
+    "server",
+    "live-reload",
+    "dev-server",
+    "zero-dependency"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "typescript": "^5.8.0"
+  },
+  "files": [
+    "dist/",
+    "README.md"
+  ]
+}