cindel 1.0.6 → 1.1.0

package/README.md

@@ -23,6 +23,7 @@
 - HTTP CORS proxy with configurable header injection
 - WebSocket proxy with header forwarding and message interception
 - Static file server and automatic `index.html` loader injection
+- Custom route handlers and directory mirroring via Bun's native routing
 - TLS/HTTPS + WSS support
 - `/files` endpoint exposing the live watched file list as JSON
 
@@ -140,8 +141,10 @@ You can even load it through a user script on any domain:
 | `static`         | `string \| false`                             | `'.'`                | Directory to serve static files from. Pass `false` to disable static serving                    |
 | `indexPath`      | `string`                                      | `'index.html'`       | Path to `index.html`                                                                            |
 | `injectLoader`   | `string`                                      |                      | Script path injected into `index.html` before `</head>`                                         |
+| `injectPaths`    | `Array<string\|{path: string, html: string}>` | `['/']`              | Paths where the loader script is injected                                                       |
 | `corsProxy`      | `boolean \| string\| CORSProxyConfig`         |                      | Enable the HTTP CORS proxy                                                                      |
 | `wsProxy`        | `WSProxyConfig`                               |                      | Proxy WebSocket connections to an upstream server                                               |
+| `routes`         | `Object`                                      |                      | Custom routes passed directly to `Bun.serve`                                                    |
 | `filesEndpoint`  | `boolean \| string`                           | `'/files'`           | Expose the watched file list as JSON. `true` mounts at `/files`                                 |
 | `configEndpoint` | `boolean \| string`                           | `'/config'`          | Expose the server config as JSON. `false` to disable                                            |
 | `getFiles`       | `() => string[]`                              |                      | Override the file list sent to connecting clients                                               |
@@ -262,6 +265,43 @@ new HMRServer({
 
 ---
 
+### Routing
+
+The `routes` option is passed directly to `Bun.serve`. Useful for mocking APIs, serving specific files, or mirroring directories without a separate server process. See [Bun's routing docs](https://bun.sh/docs/api/http#routing) for the full API.
+
+```js
+routes: {
+  // Serve a specific file
+  '/favicon.ico': new Response(Bun.file('./public/favicon.ico')),
+
+  // Mock API responses
+  '/api/session': Response.json({ user: 'dev', role: 'admin' }),
+  '/api/flags':   Response.json({ darkMode: true, betaFeatures: false }),
+
+  // Named params
+  '/api/users/:id': req => Response.json({ id: req.params.id }),
+
+  // Per-method handlers
+  '/api/posts': {
+    GET: () => new Response("List posts"),
+    POST: async req => {
+      const body = await req.json();
+      return Response.json({ created: true, ...body });
+    },
+  },
+
+  // Mirror directory /assets/* served from /dist/assets/*
+  '/assets/*': req => new Response(Bun.file(`./dist/assets/${req.params['*']}`)),
+
+  // SPA fallback
+  '/*': new Response(Bun.file('./index.html')),
+}
+```
+
+> **Note:** Avoid paths that overlap with `wsPath`, `filesEndpoint`, `configEndpoint`, or any proxy paths, the server will warn on startup if a collision is detected.
+
+---
+
 ### TLS
 
 Pass `tls` to switch the server to HTTPS and WSS. The client's `secure` option or a `wss://` URL flips the client to match.
@@ -442,14 +482,14 @@ client
     console.log(`Loaded ${files.length} files`);
     console.log("Server cold patterns:", config.cold);
   })
-  .on("reload", ({ file }) => {
+  .on("reload", (file) => {
     console.log(`Hot-reloaded: ${file}`);
-    applyChanges(file);
+    swapPrototype(file);
   })
-  .on("add", ({ file }) => {
+  .on("add", (file) => {
     console.log(`New file available: ${file}`);
   })
-  .on("remove", ({ file }) => {
+  .on("remove", (file) => {
     console.log(`File removed: ${file}`);
     cleanupForFile(file);
   })
@@ -467,9 +507,9 @@ client
 | `connect`    |                     | WebSocket connection established       |
 | `disconnect` |                     | WebSocket disconnected                 |
 | `init`       | `{ files, config }` | Server sent the initial file list      |
-| `reload`     | `{ file }`          | A file was changed and hot-reloaded    |
-| `add`        | `{ file }`          | A new file was detected                |
-| `remove`     | `{ file }`          | A file was removed                     |
+| `reload`     | `file: string`      | A file was changed and hot-reloaded    |
+| `add`        | `file: string`      | A new file was detected                |
+| `remove`     | `file: string`      | A file was removed                     |
 | `cold`       | `file: string`      | A cold file changed                    |
 | `error`      | `Error`             | A connection or message error occurred |
 

package/dist/client/file-loader.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-loader.d.ts","sourceRoot":"","sources":["../../src/client/file-loader.js"],"names":[],"mappings":"AAAA,mFAAmF;AACnF;IACE;;;;OAiCC;IAhCC,aAAsB;IACtB;;;;;OAKG;IACH,cAFU,MAAM,GAAG,IAAI,CAES;IAChC,qBAAqB;IACrB,cADW,MAAM,CACe;IAChC;;;;;;OAMG;IACH,KAFU,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAExB;IACd;;;;;OAKG;IACH,WAFU,GAAG,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,UAAU,CAAA;KAAE,CAAC,CAEvC;IAC1B;;;;;OAKG;IACH,UAFU,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAEJ;IAG3B,kCAOC;IAKD,qCAwBC;IAED,oDAmBC;IAED,wCAcC;IAED,oCAwBC;IAKD,oCAeC;IAED,uCAUC;IAED,qCAqBC;IAGD,2BAIC;IAED,6CAaC;IAED,uDAEC;CACF"}
+{"version":3,"file":"file-loader.d.ts","sourceRoot":"","sources":["../../src/client/file-loader.js"],"names":[],"mappings":"AAAA,mFAAmF;AACnF;IACE;;;;OAiCC;IAhCC,aAAsB;IACtB;;;;;OAKG;IACH,cAFU,MAAM,GAAG,IAAI,CAES;IAChC,qBAAqB;IACrB,cADW,MAAM,CACe;IAChC;;;;;;OAMG;IACH,KAFU,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAExB;IACd;;;;;OAKG;IACH,WAFU,GAAG,CAAC,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,UAAU,CAAA;KAAE,CAAC,CAEvC;IAC1B;;;;;OAKG;IACH,UAFU,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAEJ;IAG3B,kCAOC;IAKD,qCAwBC;IAED,oDAmBC;IAED,wCAcC;IAED,oCA4BC;IAKD,oCAeC;IAED,uCAUC;IAED,qCAqBC;IAGD,2BAIC;IAED,6CAaC;IAED,uDAEC;CACF"}

package/dist/client.iife.js

@@ -1644,7 +1644,11 @@ var HMR = (() => {
       script.src = url;
       script.setAttribute("data-file", path);
       return new Promise((resolve, reject) => {
-        script.onload = () => resolve(true);
+        script.onload = () => {
+          const previous = document.querySelector(`script[data-file="${path}"]:not([src="${url}"])`);
+          if (previous) previous.remove();
+          resolve(true);
+        };
         script.onerror = () => reject(new Error(`Failed to load script: ${path}`));
         document.head.appendChild(script);
       });