tether-sync 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,21 @@
-# Temporary Holding Version
+# tether-sync
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Keep files and folders identical to a central source of truth, wherever they live on your machine.
+
+```sh
+npm install -g tether-sync
+tether login                              # opens the browser to sign in
+tether pull <share-id>                    # get a managed copy of a file or folder
+tether status
+```
+
+Owners publish files with `tether manage <path> --repo <repo>` and share the printed share ID. A managed copy:
+- follows the file when you move or rename it
+- reverts local edits until you run `tether edit <path>`
+- pushes your changes with `tether done <path>` (if you are an editor)
+
+Run `tether --help` for every command. The web console is at https://tether-b10cf.web.app.
+
+Requires Node.js 22.13 or newer. Windows (NTFS/ReFS) is fully supported; Linux support is experimental.
+
+Source: https://github.com/SaiEthihasChanda/Tether

package/bin/chunk-MGMU33LE.js

@@ -0,0 +1,109 @@
+// packages/client/src/paths.js
+import os from "node:os";
+import path from "node:path";
+import crypto from "node:crypto";
+var isWindows = process.platform === "win32";
+function tetherHome() {
+  if (process.env.TETHER_HOME) return path.resolve(process.env.TETHER_HOME);
+  if (isWindows) return path.join(process.env.LOCALAPPDATA || path.join(os.homedir(), "AppData", "Local"), "Tether");
+  return path.join(process.env.XDG_STATE_HOME || path.join(os.homedir(), ".local", "state"), "tether");
+}
+function ipcEndpoint(home = tetherHome()) {
+  const tag = crypto.createHash("sha1").update(home.toLowerCase()).digest("hex").slice(0, 12);
+  if (isWindows) return `\\\\.\\pipe\\tether-${os.userInfo().username}-${tag}`;
+  return path.join(home, "tetherd.sock");
+}
+var files = (home = tetherHome()) => ({
+  db: path.join(home, "tether.db"),
+  blobs: path.join(home, "blobs"),
+  config: path.join(home, "config.json"),
+  credentials: path.join(home, isWindows ? "credentials.bin" : "credentials.json"),
+  log: path.join(home, "tetherd.log"),
+  pid: path.join(home, "tetherd.pid")
+});
+
+// packages/client/src/ipc.js
+import net from "node:net";
+import fs from "node:fs";
+var IpcError = class extends Error {
+  constructor(message, code) {
+    super(message);
+    this.code = code;
+  }
+};
+async function listen(endpoint, handler) {
+  if (!isWindows && fs.existsSync(endpoint)) {
+    const alive = await call(endpoint, "ping", {}, 1e3).then(() => true, () => false);
+    if (alive) throw new IpcError("another tetherd is already running", "EADDRINUSE");
+    fs.rmSync(endpoint, { force: true });
+  }
+  const server = net.createServer((socket) => {
+    let buf = "";
+    socket.setEncoding("utf8");
+    socket.on("data", async (chunk) => {
+      buf += chunk;
+      const nl = buf.indexOf("\n");
+      if (nl < 0) return;
+      let req;
+      try {
+        req = JSON.parse(buf.slice(0, nl));
+      } catch {
+        socket.end(JSON.stringify({ error: { message: "bad request" } }) + "\n");
+        return;
+      }
+      buf = "";
+      let res;
+      try {
+        res = { result: await handler(req.method, req.params ?? {}) ?? null };
+      } catch (e) {
+        res = { error: { message: e.message, code: e.code ?? e.name, status: e.status } };
+      }
+      socket.end(JSON.stringify(res) + "\n");
+    });
+    socket.on("error", () => {
+    });
+  });
+  await new Promise((resolve, reject) => {
+    server.once("error", (e) => reject(e.code === "EADDRINUSE" ? new IpcError("another tetherd is already running", "EADDRINUSE") : e));
+    server.listen(endpoint, resolve);
+  });
+  if (!isWindows) fs.chmodSync(endpoint, 384);
+  return server;
+}
+function call(endpoint, method, params = {}, timeoutMs = 10 * 60 * 1e3) {
+  return new Promise((resolve, reject) => {
+    const socket = net.connect(endpoint);
+    let buf = "";
+    const timer = setTimeout(() => {
+      socket.destroy();
+      reject(new IpcError("the daemon did not answer in time", "ETIMEDOUT"));
+    }, timeoutMs);
+    socket.setEncoding("utf8");
+    socket.on("connect", () => socket.write(JSON.stringify({ method, params }) + "\n"));
+    socket.on("data", (c) => buf += c);
+    socket.on("error", (e) => {
+      clearTimeout(timer);
+      reject(new IpcError("the Tether daemon is not running", e.code === "ENOENT" || e.code === "ECONNREFUSED" ? "ENODAEMON" : e.code));
+    });
+    socket.on("end", () => {
+      clearTimeout(timer);
+      try {
+        const res = JSON.parse(buf);
+        if (res.error) reject(new IpcError(res.error.message, res.error.code));
+        else resolve(res.result);
+      } catch {
+        reject(new IpcError("invalid response from the daemon"));
+      }
+    });
+  });
+}
+
+export {
+  isWindows,
+  tetherHome,
+  ipcEndpoint,
+  files,
+  IpcError,
+  listen,
+  call
+};