tm-serve 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 mrsekut
+
+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,22 @@
+# tm-serve
+
+Serve local `.user.js` files for Tampermonkey installation.
+
+## Usage
+
+```bash
+bunx tm-serve ./my-script.user.js
+```
+
+This will:
+
+1. Create a template `.user.js` file if it doesn't exist
+2. Start an HTTP server serving your userscript
+3. Open your browser to the script URL
+4. Tampermonkey automatically shows the install dialog
+5. Watch for file changes and reload on save
+
+## Options
+
+- First argument: path to `.user.js` file (default: `script.user.js`)
+- `PORT` env var: server port (default: `4889`)

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "tm-serve",
+  "version": "0.1.0",
+  "description": "Serve local .user.js files for Tampermonkey installation",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mrsekut/tm-serve.git"
+  },
+  "type": "module",
+  "bin": {
+    "tm-serve": "src/cli.ts"
+  },
+  "files": [
+    "src",
+    "!src/**/*.test.ts"
+  ],
+  "devDependencies": {
+    "@types/bun": "latest"
+  },
+  "peerDependencies": {
+    "typescript": "^5"
+  },
+  "dependencies": {
+    "open": "^11.0.0"
+  }
+}

package/src/cli.ts

@@ -0,0 +1,56 @@
+#!/usr/bin/env bun
+
+import { resolve } from 'path';
+import open from 'open';
+import { generateTemplate } from './template';
+import { startServer } from './server';
+import { watchScript } from './watcher';
+
+const DEFAULT_SCRIPT_NAME = 'script.user.js';
+const DEFAULT_PORT = 4889;
+
+main();
+
+function parseArgs(argv: string[]): { scriptPath: string; port: number } {
+  const args = argv.slice(2);
+  const scriptPath = resolve(args[0] ?? DEFAULT_SCRIPT_NAME);
+  const port = Number(process.env['PORT']) || DEFAULT_PORT;
+  return { scriptPath, port };
+}
+
+async function main() {
+  const { scriptPath, port } = parseArgs(process.argv);
+
+  await ensureScript(scriptPath);
+
+  let scriptContent = await Bun.file(scriptPath).text();
+
+  const server = startServer(scriptPath, port, async () => scriptContent);
+
+  watchScript(scriptPath, async () => {
+    scriptContent = await Bun.file(scriptPath).text();
+  });
+
+  const scriptFileName = scriptPath.split('/').pop() ?? 'script.user.js';
+  const scriptUrl = `http://127.0.0.1:${port}/${scriptFileName}`;
+
+  try {
+    await open(scriptUrl);
+  } catch {
+    console.log(`Open ${scriptUrl} in your browser to install the script.`);
+  }
+
+  process.on('SIGINT', () => {
+    console.log('\nShutting down...');
+    server.stop();
+    process.exit(0);
+  });
+}
+
+async function ensureScript(scriptPath: string): Promise<void> {
+  const file = Bun.file(scriptPath);
+  if (!(await file.exists())) {
+    await Bun.write(scriptPath, generateTemplate());
+    console.log(`Created template: ${scriptPath}`);
+  }
+}

package/src/server.ts

@@ -0,0 +1,34 @@
+import { buildIndexHtml } from './template';
+
+export type ScriptProvider = () => Promise<string>;
+
+export function startServer(
+  scriptPath: string,
+  port: number,
+  getScript: ScriptProvider,
+): ReturnType<typeof Bun.serve> {
+  const scriptFileName = scriptPath.split('/').pop() ?? 'script.user.js';
+  const scriptUrl = `http://127.0.0.1:${port}/${scriptFileName}`;
+
+  const server = Bun.serve({
+    port,
+    hostname: '127.0.0.1',
+    routes: {
+      '/': new Response(buildIndexHtml(scriptUrl, scriptPath), {
+        headers: { 'Content-Type': 'text/html; charset=utf-8' },
+      }),
+      [`/${scriptFileName}`]: async () => {
+        const content = await getScript();
+        return new Response(content, {
+          headers: {
+            'Content-Type': 'text/javascript; charset=utf-8',
+            'Cache-Control': 'no-cache, no-store, must-revalidate',
+          },
+        });
+      },
+    },
+  });
+
+  console.log(`Serving ${scriptPath} at ${scriptUrl}`);
+  return server;
+}

package/src/template.ts

@@ -0,0 +1,25 @@
+const METADATA_TEMPLATE = `// ==UserScript==
+// @name        my-script
+// @namespace   http://tampermonkey.net/
+// @version     0.0.1
+// @description A new userscript
+// @match       *://*/*
+// @grant       none
+// ==/UserScript==
+`;
+
+export function generateTemplate(): string {
+  return METADATA_TEMPLATE;
+}
+
+export function buildIndexHtml(scriptUrl: string, scriptPath: string): string {
+  return `<!DOCTYPE html>
+<html>
+<head><meta charset="utf-8"><title>tm-serve</title></head>
+<body>
+  <h1>tm-serve</h1>
+  <p>Monitoring: <code>${scriptPath}</code></p>
+  <p>Install: <a href="${scriptUrl}">${scriptUrl}</a></p>
+</body>
+</html>`;
+}

package/src/watcher.ts

@@ -0,0 +1,20 @@
+import { watch, type FSWatcher } from 'fs';
+
+export function watchScript(
+  scriptPath: string,
+  onReload: () => void,
+): FSWatcher {
+  const watcher = watch(scriptPath, event => {
+    if (event === 'change') {
+      const time = new Date().toLocaleTimeString();
+      console.log(`[${time}] Reloaded ${scriptPath}`);
+      onReload();
+    }
+  });
+
+  watcher.on('error', err => {
+    console.error(`Watch error: ${err.message}`);
+  });
+
+  return watcher;
+}