derpcat 0.0.1

package/LICENSE

@@ -0,0 +1,29 @@
+BSD 3-Clause License
+
+Copyright (c) 2026 Shayne
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/README.md

@@ -0,0 +1,40 @@
+# derpcat
+
+`derpcat` is a standalone Go CLI for moving one bidirectional byte stream between two hosts using the public Tailscale DERP network for bootstrap and relay fallback, with direct UDP promotion when possible.
+
+## npm
+
+The npm packaging and release workflow now exist.
+The first `0.0.1` publish is still manual until npm trusted publishing is configured.
+The install commands below are post-publish examples.
+
+### Production install example
+
+```bash
+npx derpcat --version
+```
+
+### Dev channel install example
+
+```bash
+npx derpcat@dev --version
+```
+
+## Build
+
+```bash
+mise run build
+```
+
+## Test
+
+```bash
+mise run test
+mise run smoke-local
+```
+
+## Publishing
+
+- Manual bootstrap runbook: [docs/releases/npm-bootstrap.md](docs/releases/npm-bootstrap.md)
+- `main` publishes the npm `dev` dist-tag once trusted publishing is configured
+- version tags like `v0.1.0` publish production releases through GitHub Actions once trusted publishing is configured

package/bin/derpcat.js

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const triples = new Map([
+  ["linux:x64", "x86_64-unknown-linux-musl"],
+  ["linux:arm64", "aarch64-unknown-linux-musl"],
+  ["darwin:x64", "x86_64-apple-darwin"],
+  ["darwin:arm64", "aarch64-apple-darwin"],
+]);
+
+const triple = triples.get(`${process.platform}:${process.arch}`);
+if (!triple) {
+  console.error(`Unsupported platform: ${process.platform} (${process.arch})`);
+  process.exit(1);
+}
+
+const binaryName = process.platform === "win32" ? "derpcat.exe" : "derpcat";
+const binaryPath = path.join(__dirname, "..", "vendor", triple, "derpcat", binaryName);
+if (!existsSync(binaryPath)) {
+  console.error(`Missing vendored binary: ${binaryPath}`);
+  process.exit(1);
+}
+
+const child = spawn(binaryPath, process.argv.slice(2), {
+  stdio: "inherit",
+  env: { ...process.env, DERPCAT_MANAGED_BY_NPM: "1" },
+});
+
+child.on("error", (err) => {
+  const reason = err instanceof Error ? err.message : String(err);
+  console.error(`Failed to launch vendored binary: ${reason}`);
+  process.exit(1);
+});
+
+["SIGINT", "SIGTERM", "SIGHUP"].forEach((sig) => {
+  process.on(sig, () => {
+    if (!child.killed) {
+      child.kill(sig);
+    }
+  });
+});
+
+const result = await new Promise((resolve) => {
+  child.on("exit", (code, signal) => {
+    if (signal) {
+      resolve({ signal });
+      return;
+    }
+    resolve({ code: code ?? 1 });
+  });
+});
+
+if (result.signal) {
+  const signalNumber = os.constants.signals[result.signal];
+  process.exit(typeof signalNumber === "number" ? 128 + signalNumber : 1);
+} else {
+  process.exit(result.code);
+}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "derpcat",
+  "version": "0.0.1",
+  "license": "BSD-3-Clause",
+  "bin": {
+    "derpcat": "bin/derpcat.js"
+  },
+  "type": "module",
+  "os": [
+    "linux",
+    "darwin"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
+  "engines": {
+    "node": ">=16"
+  },
+  "files": [
+    "bin",
+    "vendor",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/shayne/derpcat.git"
+  }
+}