tether-sync 0.1.0 → 0.2.0

package/README.md

@@ -1,21 +1,27 @@
-# tether-sync
-
-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
+# tether-sync
+
+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)
+
+Editors can also run `tether edit <path> --realtime` to push every save live, one live editor per file. `tether update` installs the latest version.
+
+Inside a git repository, Tether asks whether git's changes should be reverted (keep), or accepted and published after pull, checkout and merge (follow, for editors). Change it with `tether git <path> --mode`.
+
+Desktop notifications cover reverted changes, conflicts, lost live sessions and revoked access. Set them with `tether config set notifications all|errors|off`.
+
+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-NDKBAHAG.js

@@ -0,0 +1,248 @@
+// 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"));
+      }
+    });
+  });
+}
+
+// packages/client/src/version.js
+var VERSION = "0.2.0";
+
+// packages/client/src/update.js
+import fs2 from "node:fs";
+import path2 from "node:path";
+import { spawnSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+var PACKAGE = "tether-sync";
+var registry = () => (process.env.TETHER_UPDATE_REGISTRY || "https://registry.npmjs.org").replace(/\/$/, "");
+async function latestVersion() {
+  try {
+    const res = await fetch(`${registry()}/${PACKAGE}/latest`, { signal: AbortSignal.timeout(1e4) });
+    if (!res.ok) return null;
+    return (await res.json()).version ?? null;
+  } catch {
+    return null;
+  }
+}
+function isNewer(a, b) {
+  if (!a || !b) return false;
+  const parse = (v) => {
+    const [core, pre] = v.split("-");
+    return { nums: core.split(".").map((n) => Number(n) || 0), pre: pre ?? null };
+  };
+  const x = parse(a);
+  const y = parse(b);
+  for (let i = 0; i < 3; i++) if ((x.nums[i] ?? 0) !== (y.nums[i] ?? 0)) return (x.nums[i] ?? 0) > (y.nums[i] ?? 0);
+  if (x.pre === y.pre) return false;
+  if (x.pre === null) return true;
+  if (y.pre === null) return false;
+  return x.pre > y.pre;
+}
+function installDir(from = fileURLToPath(import.meta.url)) {
+  const dir = path2.resolve(path2.dirname(from), "..");
+  try {
+    return JSON.parse(fs2.readFileSync(path2.join(dir, "package.json"), "utf8")).name === PACKAGE ? dir : null;
+  } catch {
+    return null;
+  }
+}
+function prefixOf(pkgDir, windows = isWindows) {
+  const parent = path2.dirname(path2.dirname(pkgDir));
+  return !windows && path2.basename(parent) === "lib" ? path2.dirname(parent) : parent;
+}
+function npmInstall(spec, prefix) {
+  const args = ["install", "-g", "--prefix", prefix, spec];
+  const bin = path2.dirname(process.execPath);
+  const npmCli = [path2.join(bin, "node_modules", "npm", "bin", "npm-cli.js"), path2.join(bin, "..", "lib", "node_modules", "npm", "bin", "npm-cli.js")].find((p) => fs2.existsSync(p));
+  const r = npmCli ? spawnSync(process.execPath, [npmCli, ...args], { stdio: "inherit" }) : spawnSync(isWindows ? "npm.cmd" : "npm", args.map((a) => isWindows ? `"${a}"` : a), { stdio: "inherit", shell: isWindows });
+  return r.status ?? 1;
+}
+
+// packages/client/src/git.js
+import fs3 from "node:fs";
+import path3 from "node:path";
+import { execFileSync } from "node:child_process";
+var GIT_MODES = ["keep", "follow"];
+function git(cwd, args) {
+  return execFileSync("git", ["-C", cwd, ...args], { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"], windowsHide: true }).trim();
+}
+function findRepo(p) {
+  let dir = path3.resolve(p);
+  while (!fs3.existsSync(dir) || !fs3.statSync(dir).isDirectory()) {
+    const up = path3.dirname(dir);
+    if (up === dir) return null;
+    dir = up;
+  }
+  try {
+    const [root, gitDir, hooks] = git(dir, ["rev-parse", "--show-toplevel", "--absolute-git-dir", "--git-path", "hooks"]).split(/\r?\n/);
+    return { root: path3.resolve(root), gitDir: path3.resolve(gitDir), hooksDir: path3.resolve(dir, hooks) };
+  } catch {
+    return null;
+  }
+}
+function gitBusy(gitDir) {
+  if (!gitDir) return null;
+  const has = (f) => fs3.existsSync(path3.join(gitDir, f));
+  if (has("index.lock")) return "git is running";
+  if (has("MERGE_HEAD")) return "merge in progress";
+  if (has("rebase-merge") || has("rebase-apply")) return "rebase in progress";
+  if (has("CHERRY_PICK_HEAD")) return "cherry-pick in progress";
+  if (has("REVERT_HEAD")) return "revert in progress";
+  return null;
+}
+var HOOKS = ["post-merge", "post-checkout", "post-rewrite"];
+var quote = (s) => `'${s.replace(/\\/g, "/").replace(/'/g, `'\\''`)}'`;
+var begin = (home) => `# >>> tether (${home.replace(/\\/g, "/")}) >>>`;
+var end = (home) => `# <<< tether (${home.replace(/\\/g, "/")}) <<<`;
+function installHooks(hooksDir, { home, node, cli }) {
+  fs3.mkdirSync(hooksDir, { recursive: true });
+  for (const hook of HOOKS) {
+    const file = path3.join(hooksDir, hook);
+    let text = fs3.existsSync(file) ? fs3.readFileSync(file, "utf8") : "#!/bin/sh\n";
+    text = stripBlock(text, home);
+    const block = [
+      begin(home),
+      "# Lets Tether pick up files git changed (follow mode). Remove with `tether git <path> --mode keep`.",
+      `TETHER_HOME=${quote(home)} ${quote(node)} ${quote(cli)} git-sync --hook ${hook} --repo "$(pwd)" >/dev/null 2>&1 || true`,
+      end(home)
+    ].join("\n");
+    fs3.writeFileSync(file, `${text.replace(/\s*$/, "")}
+
+${block}
+`);
+    try {
+      fs3.chmodSync(file, 493);
+    } catch {
+    }
+  }
+}
+function removeHooks(hooksDir, home) {
+  for (const hook of HOOKS) {
+    const file = path3.join(hooksDir, hook);
+    if (!fs3.existsSync(file)) continue;
+    const text = stripBlock(fs3.readFileSync(file, "utf8"), home);
+    if (/^(#!.*\n)?\s*$/.test(text)) fs3.rmSync(file);
+    else fs3.writeFileSync(file, text.replace(/\s*$/, "\n"));
+  }
+}
+function stripBlock(text, home) {
+  const b = text.indexOf(begin(home));
+  if (b < 0) return text;
+  const e = text.indexOf(end(home), b);
+  return (text.slice(0, b) + (e < 0 ? "" : text.slice(e + end(home).length))).replace(/\n{3,}/g, "\n\n");
+}
+
+export {
+  isWindows,
+  tetherHome,
+  ipcEndpoint,
+  files,
+  IpcError,
+  listen,
+  call,
+  VERSION,
+  PACKAGE,
+  latestVersion,
+  isNewer,
+  installDir,
+  prefixOf,
+  npmInstall,
+  GIT_MODES,
+  findRepo,
+  gitBusy,
+  installHooks,
+  removeHooks
+};