@takodotid/circuit 0.34.3 → 0.35.0

package/dist/chunks/index-v8zgr7wm.js

@@ -1,128 +0,0 @@
-// src/core/addr.ts
-var familyOf2 = (address) => address.includes(":") ? "ipv6" : "ipv4";
-var bitsOf = (family) => family === "ipv4" ? 32 : 128;
-function parse(address) {
-  if (!address.includes(":")) {
-    const octets = address.split(".");
-    const valid = octets.length === 4 && octets.every((octet) => /^\d{1,3}$/.test(octet) && Number(octet) <= 255);
-    if (!valid)
-      return null;
-    return octets.reduce((value, octet) => value << 8n | BigInt(octet), 0n);
-  }
-  const [before, after, extra] = address.split("::");
-  if (extra !== undefined)
-    return null;
-  const groupsOf = (text) => text ? text.split(":") : [];
-  const leading = groupsOf(before);
-  const trailing = groupsOf(after);
-  const zeros = after === undefined ? 0 : 8 - leading.length - trailing.length;
-  const groups = [...leading, ...Array(zeros).fill("0"), ...trailing];
-  const valid = groups.length === 8 && groups.every((group) => /^[0-9a-fA-F]{1,4}$/.test(group));
-  if (!valid)
-    return null;
-  return groups.reduce((value, group) => value << 16n | BigInt(parseInt(group, 16)), 0n);
-}
-function split(cidr) {
-  const [address, lengthText] = cidr.split("/");
-  const family = familyOf2(address);
-  const length = Number(lengthText);
-  const valid = parse(address) !== null && lengthText !== undefined && Number.isInteger(length) && length >= 0 && length <= bitsOf(family);
-  if (!valid)
-    throw new Error(`'${cidr}' is not an address with a length`);
-  return { addr: address, len: length, family };
-}
-var isAddress2 = (text) => parse(text) !== null;
-function isCidr2(text) {
-  try {
-    split(text);
-    return true;
-  } catch {
-    return false;
-  }
-}
-var mask = (length, family) => {
-  const all = (1n << BigInt(bitsOf(family))) - 1n;
-  const hostBits = (1n << BigInt(bitsOf(family) - length)) - 1n;
-  return all ^ hostBits;
-};
-function format(value, family) {
-  if (family === "ipv4") {
-    return [24n, 16n, 8n, 0n].map((shift) => String(value >> shift & 255n)).join(".");
-  }
-  const groups = Array.from({ length: 8 }, (_, index) => (value >> BigInt(112 - index * 16) & 0xffffn).toString(16));
-  let longestStart = -1;
-  let longestLength = 0;
-  for (let start = 0;start < 8; ) {
-    let end = start;
-    while (end < 8 && groups[end] === "0")
-      end++;
-    const runLength = end - start;
-    if (runLength > longestLength && runLength > 1) {
-      longestStart = start;
-      longestLength = runLength;
-    }
-    start = end === start ? start + 1 : end;
-  }
-  if (longestStart < 0)
-    return groups.join(":");
-  const head = groups.slice(0, longestStart).join(":");
-  const tail = groups.slice(longestStart + longestLength).join(":");
-  return `${head}::${tail}`;
-}
-function network(cidr) {
-  const { addr, len, family } = split(cidr);
-  return `${format(parse(addr) & mask(len, family), family)}/${len}`;
-}
-function contains2(outer, inner) {
-  const outerParts = split(outer);
-  const [innerAddress, innerLengthText] = inner.split("/");
-  if (familyOf2(innerAddress) !== outerParts.family)
-    return false;
-  const innerLength = innerLengthText === undefined ? bitsOf(outerParts.family) : Number(innerLengthText);
-  if (innerLength < outerParts.len)
-    return false;
-  const outerMask = mask(outerParts.len, outerParts.family);
-  return (parse(innerAddress) & outerMask) === (parse(outerParts.addr) & outerMask);
-}
-var formatAddress = (value, family) => format(value, family);
-function rangeOf(cidr) {
-  const { addr, len, family } = split(cidr);
-  const hostBits = mask(len, family) ^ (1n << BigInt(bitsOf(family))) - 1n;
-  const first = parse(addr) & mask(len, family);
-  return { first, last: first | hostBits, family };
-}
-function prefixesBetween(first, last, family) {
-  const bits = bitsOf(family);
-  const prefixes = [];
-  for (let start = first;start <= last; ) {
-    let size = 0;
-    while (size < bits && start % (1n << BigInt(size + 1)) === 0n && start + (1n << BigInt(size + 1)) - 1n <= last)
-      size++;
-    prefixes.push(`${format(start, family)}/${bits - size}`);
-    start += 1n << BigInt(size);
-  }
-  return prefixes;
-}
-var netmask = (length) => format(mask(length, "ipv4"), "ipv4");
-var wildcard = (length) => format(mask(length, "ipv4") ^ 0xffffffffn, "ipv4");
-var host2 = (cidr) => cidr.split("/")[0];
-var NOT_GLOBAL_V4 = [
-  "0.0.0.0/8",
-  "10.0.0.0/8",
-  "100.64.0.0/10",
-  "127.0.0.0/8",
-  "169.254.0.0/16",
-  "172.16.0.0/12",
-  "192.0.2.0/24",
-  "192.168.0.0/16",
-  "198.18.0.0/15",
-  "198.51.100.0/24",
-  "203.0.113.0/24"
-];
-function isGlobal2(address) {
-  if (familyOf2(address) === "ipv6")
-    return contains2("2000::/3", address) && !contains2("2001:db8::/32", address);
-  return !NOT_GLOBAL_V4.some((prefix) => contains2(prefix, address));
-}
-
-export { familyOf2, parse, split, isAddress2, isCidr2, network, contains2, formatAddress, rangeOf, prefixesBetween, netmask, wildcard, host2, isGlobal2 };

package/dist/chunks/new-ny89s7y7.js

@@ -1,166 +0,0 @@
-// src/cli/new.ts
-import { spawnSync } from "node:child_process";
-import { cpSync, existsSync, readdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
-import { basename, dirname, join, relative, resolve } from "node:path";
-import { createInterface } from "node:readline/promises";
-import { fileURLToPath } from "node:url";
-function packageRoot() {
-  let directory = dirname(fileURLToPath(import.meta.url));
-  while (!existsSync(join(directory, "templates"))) {
-    const parent = dirname(directory);
-    if (parent === directory)
-      throw new Error("Circuit's templates are missing from its package");
-    directory = parent;
-  }
-  return directory;
-}
-var ROOT = packageRoot();
-var TEMPLATES = join(ROOT, "templates");
-var circuit = JSON.parse(readFileSync(join(ROOT, "package.json"), "utf8"));
-var MANAGERS = {
-  npm: { install: "npm install", run: "npx circuit", types: "node" },
-  pnpm: { install: "pnpm install", run: "pnpm circuit", types: "node" },
-  bun: { install: "bun install", run: "bun circuit", types: "bun" }
-};
-function detectManager() {
-  const agent = process.env.npm_config_user_agent ?? "";
-  if (agent.startsWith("pnpm/"))
-    return "pnpm";
-  if (agent.startsWith("bun/") || process.versions.bun)
-    return "bun";
-  return "npm";
-}
-var PATTERNS = {
-  "single-site": { title: "A single site", fits: "a home, an office or an internal network: a router and a switch, no BGP", asn: false },
-  "edge-router": { title: "An edge router", fits: "your own AS number, with an IP transit and an internet exchange", asn: true },
-  colocation: {
-    title: "Colocation with tenants",
-    fits: "a provider whose customers each get their own VLANs, addresses and ports",
-    asn: true
-  }
-};
-var EXAMPLE_ASN = "64500";
-var USAGE = `usage: circuit new [directory] [options]
-
-  --pattern <name>   single-site, edge-router or colocation
-  --asn <number>     your AS number, for edge-router and colocation
-  --1password        write .env with 1Password references instead of empty values
-  --use <manager>    npm, pnpm or bun; the one that ran this by default
-  --no-install       do not install the dependencies`;
-function fail(message) {
-  console.error(message);
-  process.exit(1);
-}
-function option(args, name) {
-  const at = args.indexOf(`--${name}`);
-  if (at >= 0)
-    return args[at + 1];
-  return args.find((arg) => arg.startsWith(`--${name}=`))?.slice(name.length + 3);
-}
-function filesIn(directory) {
-  return readdirSync(directory, { recursive: true, withFileTypes: true }).filter((entry) => entry.isFile()).map((entry) => relative(directory, join(entry.parentPath, entry.name)));
-}
-async function create(args) {
-  if (args.includes("--help") || args.includes("-h")) {
-    console.log(USAGE);
-    return;
-  }
-  const valued = new Set(["--pattern", "--asn", "--use"]);
-  const positional = args.filter((arg, index) => !arg.startsWith("--") && !valued.has(args[index - 1] ?? ""));
-  const interactive = process.stdin.isTTY === true;
-  const terminal = interactive ? createInterface({ input: process.stdin, output: process.stdout }) : undefined;
-  const ask = async (question, fallback) => {
-    if (!terminal)
-      return fallback;
-    const answer = (await terminal.question(`${question} (${fallback}): `)).trim();
-    return answer || fallback;
-  };
-  const directory = positional[0] ?? await ask("Directory for the project", "my-network");
-  const target = resolve(process.cwd(), directory);
-  if (existsSync(target) && readdirSync(target).length)
-    fail(`${target} is not empty`);
-  let pattern = option(args, "pattern");
-  if (!pattern) {
-    const names = Object.keys(PATTERNS);
-    if (terminal) {
-      console.log(`
-Which is closest to your network?`);
-      names.forEach((name, index) => console.log(`  ${index + 1}. ${PATTERNS[name].title}: ${PATTERNS[name].fits}`));
-    }
-    pattern = names[Number(await ask("Number", "1")) - 1];
-  }
-  if (!pattern || !(pattern in PATTERNS))
-    fail(`no pattern ${pattern}; there are ${Object.keys(PATTERNS).join(", ")}`);
-  let asn = option(args, "asn");
-  if (!asn && PATTERNS[pattern].asn) {
-    asn = await ask("Your AS number, or press enter to keep the documentation example", EXAMPLE_ASN);
-  }
-  if (asn && !/^\d+$/.test(asn))
-    fail(`${asn} is not an AS number`);
-  const manager = option(args, "use") ?? detectManager();
-  if (!(manager in MANAGERS))
-    fail(`no package manager ${manager}; there are ${Object.keys(MANAGERS).join(", ")}`);
-  const { install, run, types } = MANAGERS[manager];
-  const onePassword = args.includes("--1password") || (await ask("Keep the secrets in 1Password? y or n", "n")).toLowerCase().startsWith("y");
-  terminal?.close();
-  cpSync(join(TEMPLATES, pattern), target, { recursive: true });
-  cpSync(join(TEMPLATES, "project"), target, { recursive: true });
-  renameSync(join(target, "gitignore"), join(target, ".gitignore"));
-  for (const file of ["AGENTS.md", "README.md", "tsconfig.json"]) {
-    const path = join(target, file);
-    const text = readFileSync(path, "utf8").replaceAll("npx circuit", run).replaceAll("npm install", install).replaceAll('"types": ["node"]', `"types": ["${types}"]`);
-    writeFileSync(path, text);
-  }
-  const sources = filesIn(target).filter((file) => file.endsWith(".ts"));
-  const secrets = new Set;
-  for (const file of sources) {
-    const path = join(target, file);
-    let text = readFileSync(path, "utf8");
-    if (asn && asn !== EXAMPLE_ASN)
-      text = text.replaceAll(new RegExp(`\\b${EXAMPLE_ASN}\\b`, "g"), asn);
-    for (const [, name] of text.matchAll(/secret\("([A-Z0-9_]+)"\)/g))
-      secrets.add(name);
-    writeFileSync(path, text);
-  }
-  const env = [
-    "# Secrets for Circuit. Never commit this file.",
-    "# A value is the secret itself, or a 1Password reference, op://vault/item/field, read with the 1Password CLI.",
-    ...[...secrets].sort().map((name) => onePassword ? `${name}=op://Network/${name}/password` : `${name}=`),
-    ""
-  ];
-  writeFileSync(join(target, ".env"), env.join(`
-`));
-  const name = basename(target).toLowerCase().replace(/[^a-z0-9-]+/g, "-");
-  const packageJson = {
-    name,
-    private: true,
-    type: "module",
-    dependencies: { "@takodotid/circuit": circuit.version },
-    devDependencies: { [`@types/${types}`]: circuit.devDependencies[`@types/${types}`] }
-  };
-  writeFileSync(join(target, "package.json"), JSON.stringify(packageJson, null, 4) + `
-`);
-  if (!args.includes("--no-install")) {
-    const result = spawnSync(install, { cwd: target, stdio: "inherit", shell: true });
-    if (result.status !== 0)
-      console.log(`${install} failed; run it again in the project.`);
-  }
-  const steps = [
-    `cd ${directory}`,
-    onePassword ? `Point each line of .env at the item that holds it in 1Password, then run: ${run} secrets` : `Fill in each password in .env, then run: ${run} secrets`,
-    "Change the names, addresses and ports in the device files to your own.",
-    ...PATTERNS[pattern].asn && (!asn || asn === EXAMPLE_ASN) ? ["Put your own AS number in routing.ts."] : [],
-    `${run} validate`,
-    `${run} snapshot, then ${run} diff, to see what would change on each device`
-  ];
-  console.log(`
-Created ${directory} from the pattern "${PATTERNS[pattern].title}".
-
-Next:`);
-  steps.forEach((step, index) => console.log(`  ${index + 1}. ${step}`));
-  console.log(`
-What each file does: https://circuit.tako.id/patterns/${pattern}`);
-}
-export {
-  create
-};

package/dist/chunks/server-tjbb3rqc.js

@@ -1,251 +0,0 @@
-import {
-  packageRoot
-} from "./index-47debt16.js";
-
-// src/studio/server.ts
-import { execFile as execFile2, spawn } from "node:child_process";
-import { existsSync, readFileSync, watch } from "node:fs";
-import { createServer } from "node:http";
-import { extname, join as join2 } from "node:path";
-
-// src/studio/git.ts
-import { execFile } from "node:child_process";
-import { mkdirSync, writeFileSync } from "node:fs";
-import { basename, join } from "node:path";
-var environment = () => Object.fromEntries(Object.entries(process.env).filter(([name]) => !name.startsWith("GIT_")));
-function git(cwd, args) {
-  return new Promise((done, fail) => {
-    execFile("git", args, { cwd, env: environment(), maxBuffer: 64 * 1024 * 1024 }, (error, stdout, stderr) => {
-      if (error)
-        fail(new Error((stderr || error.message).trim()));
-      else
-        done(stdout);
-    });
-  });
-}
-var FORMAT = "--format=%H%x1f%h%x1f%an%x1f%aI%x1f%s";
-function commitsOf(text) {
-  return text.split(`
-`).filter(Boolean).map((line) => {
-    const [commit = "", short = "", author = "", date = "", subject = ""] = line.split("\x1F");
-    return { commit, short, author, date, subject };
-  });
-}
-async function gitTop(directory) {
-  try {
-    return (await git(directory, ["rev-parse", "--show-toplevel"])).trim();
-  } catch {
-    return;
-  }
-}
-async function history(directory, files, limit = 50) {
-  if (!files.length)
-    return [];
-  return commitsOf(await git(directory, ["log", `-n${limit}`, FORMAT, "--", ...files]));
-}
-async function references(directory) {
-  const names = (await git(directory, [
-    "for-each-ref",
-    "--count=100",
-    "--sort=-committerdate",
-    "--format=%(refname:short)",
-    "refs/heads",
-    "refs/remotes",
-    "refs/tags"
-  ])).split(`
-`).filter((name) => name && !name.endsWith("/HEAD"));
-  return { names, commits: commitsOf(await git(directory, ["log", "-n30", FORMAT])) };
-}
-async function commitOf(directory, name) {
-  if (!/^[A-Za-z0-9][\w./@^~-]*$/.test(name))
-    return;
-  try {
-    const [commit] = commitsOf(await git(directory, ["log", "-n1", FORMAT, `${name}^{commit}`, "--"]));
-    return commit;
-  } catch {
-    return;
-  }
-}
-async function networkAt(configDirectory, configPath, commit, gather) {
-  const top = await gitTop(configDirectory);
-  if (!top)
-    throw new Error("the config is not in a git repository");
-  const cache = join(configDirectory, ".circuit", "cache");
-  mkdirSync(cache, { recursive: true });
-  writeFileSync(join(cache, ".gitignore"), `# Written by Circuit Studio: checkouts of other commits, removed once read.
-*
-`);
-  await git(top, ["worktree", "prune"]);
-  const checkout = join(cache, commit.slice(0, 12));
-  await git(top, ["worktree", "add", "--detach", "--force", checkout, commit]);
-  try {
-    const prefix = (await git(configDirectory, ["rev-parse", "--show-prefix"])).trim();
-    return await gather(join(checkout, prefix, basename(configPath)));
-  } finally {
-    await git(top, ["worktree", "remove", "--force", checkout]).catch(() => {});
-  }
-}
-
-// src/studio/server.ts
-var isLoopback = (host) => host === "localhost" || host === "::1" || /^127\.\d+\.\d+\.\d+$/.test(host);
-function hostAllowed(header, port, allowHosts) {
-  if (!header)
-    return false;
-  if (header === `127.0.0.1:${port}` || header === `localhost:${port}` || header === `[::1]:${port}`)
-    return true;
-  const name = header.replace(/:\d+$/, "").toLowerCase();
-  return allowHosts.some((allowed) => {
-    const wanted = allowed.toLowerCase();
-    return wanted === header.toLowerCase() || wanted === name;
-  });
-}
-var IGNORED = /(^|[\\/])(node_modules|\.git|\.circuit[\\/]cache)([\\/]|$)/;
-var CONTENT_TYPES = {
-  ".html": "text/html; charset=utf-8",
-  ".css": "text/css; charset=utf-8",
-  ".js": "text/javascript; charset=utf-8",
-  ".svg": "image/svg+xml",
-  ".woff2": "font/woff2"
-};
-function gather(configPath) {
-  const cli = process.argv[1];
-  const args = [...process.execArgv, cli, "studio", "--json", `--config=${configPath}`];
-  return new Promise((done) => {
-    execFile2(process.execPath, args, { maxBuffer: 256 * 1024 * 1024 }, (error, stdout, stderr) => {
-      if (!error)
-        return done(stdout);
-      const message = (stderr || error.message).trim();
-      done(JSON.stringify({ error: message }));
-    });
-  });
-}
-function openBrowser(url) {
-  const [command, args] = process.platform === "win32" ? ["cmd", ["/c", "start", "", url]] : process.platform === "darwin" ? ["open", [url]] : ["xdg-open", [url]];
-  const child = spawn(command, args, { stdio: "ignore", detached: true });
-  child.on("error", () => {});
-  child.unref();
-}
-async function studio(options) {
-  const { configPath, root, port } = options;
-  const installed = packageRoot();
-  if (!installed)
-    throw new Error("cannot find where Circuit is installed, so Studio has no page to serve");
-  const pages = join2(installed, "src", "studio", "public");
-  let data = await gather(configPath);
-  const past = new Map;
-  const answer = async (response, work) => {
-    let body;
-    try {
-      const result = await work();
-      body = typeof result === "string" ? result : JSON.stringify(result);
-    } catch (error) {
-      body = JSON.stringify({ error: error.message });
-    }
-    response.writeHead(200, { "content-type": "application/json", "cache-control": "no-store" }).end(body);
-  };
-  const listeners = new Set;
-  const tell = (message) => {
-    for (const listener of listeners)
-      listener.write(`data: ${message}
-
-`);
-  };
-  const server = createServer((request, response) => {
-    response.setHeader("x-robots-tag", "noindex, nofollow, noarchive");
-    if (!hostAllowed(request.headers.host, port, options.allowHosts)) {
-      response.writeHead(403).end();
-      return;
-    }
-    const url = new URL(request.url ?? "/", "http://studio");
-    const path = url.pathname;
-    if (path === "/history") {
-      answer(response, async () => {
-        const name = url.searchParams.get("device") ?? "";
-        const files = JSON.parse(data).files?.[name];
-        if (!files)
-          throw new Error(`no device ${name}`);
-        return history(root, [files.source, files.snapshot].filter((file) => Boolean(file)));
-      });
-      return;
-    }
-    if (path === "/refs") {
-      answer(response, () => references(root));
-      return;
-    }
-    if (path === "/compare") {
-      answer(response, async () => {
-        const asked = url.searchParams.get("ref") ?? "";
-        const commit = await commitOf(root, asked);
-        if (!commit)
-          throw new Error(`${asked} names no commit here`);
-        if (!past.has(commit.commit))
-          past.set(commit.commit, networkAt(root, configPath, commit.commit, gather));
-        const network = await past.get(commit.commit);
-        if (network.startsWith('{"error"'))
-          past.delete(commit.commit);
-        return `{"commit":${JSON.stringify(commit)},"network":${network}}`;
-      });
-      return;
-    }
-    if (path === "/robots.txt") {
-      response.writeHead(200, { "content-type": "text/plain; charset=utf-8" }).end(`User-agent: *
-Disallow: /
-`);
-      return;
-    }
-    if (path === "/data") {
-      response.writeHead(200, { "content-type": "application/json", "cache-control": "no-store" }).end(data);
-      return;
-    }
-    if (path === "/events") {
-      response.writeHead(200, {
-        "content-type": "text/event-stream",
-        "cache-control": "no-store",
-        connection: "keep-alive",
-        "x-accel-buffering": "no"
-      });
-      response.write(`: connected
-
-`);
-      listeners.add(response);
-      request.on("close", () => listeners.delete(response));
-      return;
-    }
-    const name = path === "/" ? "index.html" : path.slice(1);
-    const type = CONTENT_TYPES[extname(name)];
-    const file = join2(pages, name);
-    if (!/^[a-z-]+\.[a-z0-9]+$/.test(name) || !type || !existsSync(file)) {
-      response.writeHead(404).end();
-      return;
-    }
-    response.writeHead(200, { "content-type": type, "cache-control": "no-store" }).end(readFileSync(file));
-  });
-  let timer;
-  watch(root, { recursive: true }, (_event, filename) => {
-    if (filename && IGNORED.test(filename))
-      return;
-    clearTimeout(timer);
-    timer = setTimeout(async () => {
-      data = await gather(configPath);
-      tell("changed");
-      console.log(`${new Date().toLocaleTimeString()}  ${filename ?? "a file"} changed, read again`);
-    }, 300);
-  });
-  watch(pages, () => tell("page"));
-  server.on("error", (error) => {
-    const message = error.code === "EADDRINUSE" ? `port ${port} is in use; choose another with --port=N` : error.message;
-    console.error(message);
-    process.exit(1);
-  });
-  server.listen(port, options.host, () => {
-    const local = isLoopback(options.host);
-    const url = local ? `http://127.0.0.1:${port}` : `http://${options.allowHosts[0] ?? options.host}`;
-    console.log(`Circuit Studio at ${url}, listening on ${options.host}:${port}, watching ${root}. Stop it with Ctrl+C.`);
-    if (options.open && local)
-      openBrowser(url);
-  });
-}
-export {
-  isLoopback,
-  studio
-};