@mdulghier/devtree 0.1.5

package/dist/gc.js

@@ -0,0 +1,243 @@
+import { existsSync } from "node:fs";
+import { list_registered_compose_projects, unregister_compose_project } from "./registry.js";
+import { run_command_capture, run_command_inherit } from "./process.js";
+function get_label_keys(label_prefix) {
+    return {
+        managed: `${label_prefix}.managed`,
+        namespace: `${label_prefix}.namespace`,
+        worktree_path: `${label_prefix}.worktree-path`,
+        compose_project: `${label_prefix}.compose-project`,
+    };
+}
+function get_labels(record) {
+    return record.Config?.Labels ?? record.Labels ?? {};
+}
+function run_json_command(command, args) {
+    const result = run_command_capture(command, args);
+    if (!result.stdout) {
+        return [];
+    }
+    return JSON.parse(result.stdout);
+}
+function ensure_project_entry(projects, project_name, registry_namespace, worktree_path) {
+    const existing_project = projects.get(project_name);
+    if (existing_project) {
+        if (!existing_project.registry_namespace && registry_namespace) {
+            existing_project.registry_namespace = registry_namespace;
+        }
+        if (!existing_project.worktree_path && worktree_path) {
+            existing_project.worktree_path = worktree_path;
+        }
+        return existing_project;
+    }
+    const project = {
+        project_name,
+        registry_namespace,
+        worktree_path,
+        containers: [],
+        networks: [],
+        volumes: [],
+        sources: new Set(),
+    };
+    projects.set(project_name, project);
+    return project;
+}
+function read_git_worktree_paths() {
+    const worktree_result = run_command_capture("git", ["worktree", "list", "--porcelain"]);
+    const worktree_paths = new Set();
+    for (const line of worktree_result.stdout.split("\n")) {
+        if (line.startsWith("worktree ")) {
+            worktree_paths.add(line.slice("worktree ".length).trim());
+        }
+    }
+    return worktree_paths;
+}
+function read_container_projects(instance) {
+    const container_ids = run_command_capture("docker", ["ps", "-aq"])
+        .stdout.split("\n")
+        .filter(Boolean);
+    if (container_ids.length === 0) {
+        return new Map();
+    }
+    const label_keys = get_label_keys(instance.label_prefix);
+    const containers = run_json_command("docker", ["inspect", ...container_ids]);
+    const projects = new Map();
+    for (const container of containers) {
+        const labels = get_labels(container);
+        const project_name = labels["com.docker.compose.project"] ?? labels[label_keys.compose_project];
+        const registry_namespace = labels[label_keys.namespace] ?? null;
+        const worktree_path = labels[label_keys.worktree_path] ?? labels["com.docker.compose.project.working_dir"] ?? null;
+        if (!project_name) {
+            continue;
+        }
+        if ((registry_namespace && registry_namespace !== instance.registry_namespace) ||
+            (!registry_namespace && !project_name.startsWith(instance.registry_namespace))) {
+            continue;
+        }
+        const project = ensure_project_entry(projects, project_name, registry_namespace, worktree_path);
+        if (container.Name) {
+            project.containers.push(container.Name.replace(/^\//, ""));
+        }
+        project.sources.add("container");
+    }
+    return projects;
+}
+function seed_projects_from_registry(projects, instance) {
+    for (const entry of list_registered_compose_projects(instance.registry_namespace)) {
+        ensure_project_entry(projects, entry.compose_project, entry.registry_namespace, entry.worktree_path);
+    }
+}
+function add_named_objects(projects, instance, kind, names, inspect_args) {
+    if (names.length === 0) {
+        return;
+    }
+    const label_keys = get_label_keys(instance.label_prefix);
+    const objects = run_json_command("docker", [...inspect_args, ...names]);
+    for (const object of objects) {
+        const labels = get_labels(object);
+        const project_name = labels["com.docker.compose.project"] ?? labels[label_keys.compose_project];
+        const registry_namespace = labels[label_keys.namespace] ?? null;
+        const worktree_path = labels[label_keys.worktree_path] ?? null;
+        if (!project_name) {
+            continue;
+        }
+        if ((registry_namespace && registry_namespace !== instance.registry_namespace) ||
+            (!registry_namespace && !project_name.startsWith(instance.registry_namespace))) {
+            continue;
+        }
+        const project = ensure_project_entry(projects, project_name, registry_namespace, worktree_path);
+        if (kind === "network" && object.Name) {
+            project.networks.push(object.Name);
+        }
+        if (kind === "volume" && object.Name) {
+            project.volumes.push(object.Name);
+        }
+        project.sources.add(kind);
+    }
+}
+function enrich_projects_with_volumes(projects, instance) {
+    const volume_names = run_command_capture("docker", ["volume", "ls", "-q"])
+        .stdout.split("\n")
+        .filter(Boolean);
+    add_named_objects(projects, instance, "volume", volume_names, ["volume", "inspect"]);
+}
+function enrich_projects_with_networks(projects, instance) {
+    const network_names = run_command_capture("docker", ["network", "ls", "-q"])
+        .stdout.split("\n")
+        .filter(Boolean);
+    add_named_objects(projects, instance, "network", network_names, ["network", "inspect"]);
+}
+function backfill_legacy_resource_names(projects) {
+    const container_names = new Set(run_command_capture("docker", ["ps", "-a", "--format", "{{.Names}}"])
+        .stdout.split("\n")
+        .filter(Boolean));
+    const network_names = new Set(run_command_capture("docker", ["network", "ls", "--format", "{{.Name}}"])
+        .stdout.split("\n")
+        .filter(Boolean));
+    const volume_names = new Set(run_command_capture("docker", ["volume", "ls", "--format", "{{.Name}}"])
+        .stdout.split("\n")
+        .filter(Boolean));
+    for (const project of projects.values()) {
+        const default_container = `${project.project_name}-db-1`;
+        const default_network = `${project.project_name}_default`;
+        const default_volume = `${project.project_name}_pgdata`;
+        if (project.containers.length === 0 && container_names.has(default_container)) {
+            project.containers.push(default_container);
+        }
+        if (project.networks.length === 0 && network_names.has(default_network)) {
+            project.networks.push(default_network);
+        }
+        if (project.volumes.length === 0 && volume_names.has(default_volume)) {
+            project.volumes.push(default_volume);
+        }
+    }
+}
+function is_active_worktree(project, active_worktrees) {
+    if (!project.worktree_path) {
+        return false;
+    }
+    return active_worktrees.has(project.worktree_path) && existsSync(project.worktree_path);
+}
+function format_list(values) {
+    return values.length === 0 ? "none" : values.join(", ");
+}
+function print_project(project, state) {
+    const header = state === "active"
+        ? `Active: ${project.project_name}`
+        : state === "orphan"
+            ? `Orphan: ${project.project_name}`
+            : `Skipped: ${project.project_name}`;
+    console.log(header);
+    console.log(`  worktree: ${project.worktree_path ?? "unknown"}`);
+    console.log(`  containers: ${format_list(project.containers)}`);
+    console.log(`  networks: ${format_list(project.networks)}`);
+    console.log(`  volumes: ${format_list(project.volumes)}`);
+}
+function remove_named_objects(command_group, names) {
+    if (names.length === 0) {
+        return;
+    }
+    run_command_inherit("docker", [command_group, "rm", ...names]);
+}
+function remove_containers(names) {
+    if (names.length === 0) {
+        return;
+    }
+    run_command_inherit("docker", ["rm", "-f", ...names]);
+}
+export function classify_projects(projects, active_worktrees) {
+    return {
+        active_projects: projects.filter((project) => is_active_worktree(project, active_worktrees)),
+        orphan_projects: projects.filter((project) => project.worktree_path && !is_active_worktree(project, active_worktrees)),
+        unknown_projects: projects.filter((project) => !project.worktree_path),
+    };
+}
+export function run_gc(loaded_config, instance, options) {
+    const active_worktrees = read_git_worktree_paths();
+    const projects = read_container_projects(instance);
+    seed_projects_from_registry(projects, instance);
+    enrich_projects_with_networks(projects, instance);
+    enrich_projects_with_volumes(projects, instance);
+    backfill_legacy_resource_names(projects);
+    const all_projects = [...projects.values()].sort((left, right) => left.project_name.localeCompare(right.project_name));
+    const classified_projects = classify_projects(all_projects, active_worktrees);
+    console.log("Devtree dependency garbage collection");
+    console.log(`Config: ${loaded_config.config_path}`);
+    console.log(`Active git worktrees: ${active_worktrees.size}`);
+    console.log(`Managed Docker projects: ${all_projects.length}`);
+    if (options.verbose && classified_projects.active_projects.length > 0) {
+        console.log("");
+        for (const project of classified_projects.active_projects) {
+            print_project(project, "active");
+        }
+    }
+    if (classified_projects.unknown_projects.length > 0) {
+        console.log("");
+        console.log(`Skipping ${classified_projects.unknown_projects.length} project(s) without worktree metadata`);
+        for (const project of classified_projects.unknown_projects) {
+            print_project(project, "unknown");
+        }
+    }
+    if (classified_projects.orphan_projects.length === 0) {
+        console.log("");
+        console.log("No orphaned dependency projects found.");
+        return;
+    }
+    console.log("");
+    console.log(`${options.dry_run ? "Would remove" : "Removing"} ${classified_projects.orphan_projects.length} orphaned project(s)`);
+    for (const project of classified_projects.orphan_projects) {
+        print_project(project, "orphan");
+        if (options.dry_run) {
+            continue;
+        }
+        remove_containers(project.containers);
+        remove_named_objects("network", project.networks);
+        remove_named_objects("volume", project.volumes);
+        unregister_compose_project(instance.registry_namespace, project.project_name);
+    }
+    console.log("");
+    console.log(options.dry_run
+        ? "Dry run only. Re-run without `--dry-run` to remove the orphaned resources."
+        : "Dependency garbage collection complete.");
+}
+//# sourceMappingURL=gc.js.map

package/dist/gc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gc.js","sourceRoot":"","sources":["../src/gc.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { define_devtree_config, load_devtree_config } from "./config.ts";
+export type { Command_spec, Command_spec_context, Compose_dependency, Compose_dependency_context, Devtree_config, Devtree_dependency, Managed_env_entry, } from "./config.ts";
+export { create_devtree_instance } from "./instance.ts";
+export type { Devtree_instance } from "./instance.ts";

package/dist/index.js

@@ -0,0 +1,3 @@
+export { define_devtree_config, load_devtree_config } from "./config.js";
+export { create_devtree_instance } from "./instance.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAUzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC"}

package/dist/instance.d.ts

@@ -0,0 +1,18 @@
+import type { Loaded_devtree_config } from "./config.ts";
+export type Devtree_instance = {
+    app_name: string;
+    namespace: string;
+    repo_root: string;
+    worktree_path: string;
+    worktree_slug: string | null;
+    instance_id: string;
+    scoped_name: string;
+    env_file_path: string;
+    public_url: string;
+    label_prefix: string;
+    registry_namespace: string;
+    portless_enabled: boolean;
+    get_scoped_name: (suffix?: string) => string;
+    allocate_port: (name: string, base_port: number, span?: number) => number;
+};
+export declare function create_devtree_instance(loaded_config: Loaded_devtree_config): Devtree_instance;

package/dist/instance.js

@@ -0,0 +1,98 @@
+import { spawnSync } from "node:child_process";
+import { createHash } from "node:crypto";
+import { existsSync, lstatSync, readFileSync } from "node:fs";
+import { basename, dirname, resolve } from "node:path";
+function slugify(value) {
+    return value
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+}
+function get_parent_worktree_slug(repo_root, repo_slug) {
+    const parent_slug = slugify(basename(dirname(repo_root)));
+    if (!parent_slug || parent_slug === repo_slug) {
+        return null;
+    }
+    return parent_slug;
+}
+function read_worktree_slug(repo_root, repo_slug) {
+    const git_path = resolve(repo_root, ".git");
+    if (!existsSync(git_path)) {
+        return null;
+    }
+    if (!lstatSync(git_path).isFile()) {
+        return null;
+    }
+    const git_file_text = readFileSync(git_path, "utf8");
+    const worktree_match = git_file_text.match(/[\\/]+worktrees[\\/]+([^\\/ \n\r]+)/);
+    if (!worktree_match?.[1]) {
+        return null;
+    }
+    const git_worktree_slug = slugify(worktree_match[1]);
+    if (!git_worktree_slug || git_worktree_slug === repo_slug) {
+        return get_parent_worktree_slug(repo_root, repo_slug);
+    }
+    return git_worktree_slug;
+}
+function get_hash_suffix(value) {
+    return createHash("sha1").update(value).digest("hex").slice(0, 8);
+}
+function read_branch_slug(repo_root) {
+    const branch_result = spawnSync("git", ["branch", "--show-current"], {
+        cwd: repo_root,
+        encoding: "utf8",
+        env: process.env,
+    });
+    if (branch_result.status !== 0) {
+        return null;
+    }
+    const branch_name = branch_result.stdout.trim();
+    if (!branch_name) {
+        return null;
+    }
+    return slugify(branch_name.split("/").at(-1) ?? branch_name);
+}
+function get_public_url(app_name, route_prefix) {
+    const protocol = process.env.PORTLESS_HTTPS === "1" ? "https" : "http";
+    const tld = process.env.PORTLESS_TLD?.trim() || "localhost";
+    const proxy_port = process.env.PORTLESS_PORT?.trim() || "1355";
+    const host = route_prefix ? `${route_prefix}.${app_name}` : app_name;
+    return `${protocol}://${host}.${tld}:${proxy_port}`;
+}
+function get_namespace(config) {
+    return slugify(config.namespace?.trim() || config.app_name);
+}
+export function create_devtree_instance(loaded_config) {
+    const app_name = slugify(loaded_config.config.app_name);
+    const namespace = get_namespace(loaded_config.config);
+    const worktree_path = loaded_config.repo_root;
+    const worktree_slug = read_worktree_slug(loaded_config.repo_root, namespace);
+    const branch_slug = worktree_slug ? read_branch_slug(loaded_config.repo_root) : null;
+    const instance_id = get_hash_suffix(worktree_path);
+    const scoped_name = `${namespace}-${instance_id}`;
+    const env_file_path = resolve(loaded_config.repo_root, loaded_config.config.env.file_path || ".env.local");
+    const label_prefix = loaded_config.config.garbage_collection?.docker_label_prefix?.trim() || "devtree";
+    const registry_namespace = loaded_config.config.garbage_collection?.registry_namespace?.trim() || namespace;
+    return {
+        app_name,
+        namespace,
+        repo_root: loaded_config.repo_root,
+        worktree_path,
+        worktree_slug,
+        instance_id,
+        scoped_name,
+        env_file_path,
+        public_url: get_public_url(app_name, branch_slug ?? worktree_slug),
+        label_prefix,
+        registry_namespace,
+        portless_enabled: loaded_config.config.portless?.enabled !== false && process.env.PORTLESS !== "0",
+        get_scoped_name(suffix) {
+            return suffix ? `${scoped_name}-${slugify(suffix)}` : scoped_name;
+        },
+        allocate_port(name, base_port, span = 1000) {
+            const hash_value = get_hash_suffix(`${worktree_path}:${slugify(name)}`);
+            return base_port + (parseInt(hash_value, 16) % span);
+        },
+    };
+}
+//# sourceMappingURL=instance.js.map

package/dist/instance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance.js","sourceRoot":"","sources":["../src/instance.ts"],"names":[],"mappings":"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"}

package/dist/process.d.ts

@@ -0,0 +1,13 @@
+export type Command_result = {
+    status: number;
+    stdout: string;
+    stderr: string;
+};
+export type Run_command_options = {
+    cwd?: string;
+    env?: Record<string, string | undefined>;
+    allow_failure?: boolean;
+};
+export declare function command_exists(command: string): boolean;
+export declare function run_command_capture(command: string, args: string[], options?: Run_command_options): Command_result;
+export declare function run_command_inherit(command: string, args: string[], options?: Run_command_options): number;

package/dist/process.js

@@ -0,0 +1,43 @@
+import { spawnSync } from "node:child_process";
+export function command_exists(command) {
+    const result = spawnSync("which", [command], {
+        cwd: process.cwd(),
+        encoding: "utf8",
+        env: process.env,
+    });
+    return result.status === 0;
+}
+export function run_command_capture(command, args, options) {
+    const result = spawnSync(command, args, {
+        cwd: options?.cwd ?? process.cwd(),
+        encoding: "utf8",
+        env: { ...process.env, ...options?.env },
+    });
+    if (result.error) {
+        throw result.error;
+    }
+    const command_result = {
+        status: result.status ?? 1,
+        stdout: result.stdout?.trim() ?? "",
+        stderr: result.stderr?.trim() ?? "",
+    };
+    if (!options?.allow_failure && command_result.status !== 0) {
+        throw new Error(command_result.stderr || `${command} ${args.join(" ")} failed`);
+    }
+    return command_result;
+}
+export function run_command_inherit(command, args, options) {
+    const result = spawnSync(command, args, {
+        cwd: options?.cwd ?? process.cwd(),
+        env: { ...process.env, ...options?.env },
+        stdio: "inherit",
+    });
+    if (result.error) {
+        throw result.error;
+    }
+    if (!options?.allow_failure && result.status !== 0) {
+        process.exit(result.status ?? 1);
+    }
+    return result.status ?? 0;
+}
+//# sourceMappingURL=process.js.map

package/dist/process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.js","sourceRoot":"","sources":["../src/process.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAc/C,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,EAAE;QAC3C,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;QAClB,QAAQ,EAAE,MAAM;QAChB,GAAG,EAAE,OAAO,CAAC,GAAG;KACjB,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,OAAe,EACf,IAAc,EACd,OAA6B;IAE7B,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE;QACtC,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE;QAClC,QAAQ,EAAE,MAAM;QAChB,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,OAAO,EAAE,GAAG,EAAE;KACzC,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,MAAM,MAAM,CAAC,KAAK,CAAC;IACrB,CAAC;IAED,MAAM,cAAc,GAAG;QACrB,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,CAAC;QAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE;QACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE;KACpC,CAAC;IAEF,IAAI,CAAC,OAAO,EAAE,aAAa,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,cAAc,CAAC,MAAM,IAAI,GAAG,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAClF,CAAC;IAED,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,mBAAmB,CACjC,OAAe,EACf,IAAc,EACd,OAA6B;IAE7B,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE;QACtC,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE;QAClC,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,GAAG,OAAO,EAAE,GAAG,EAAE;QACxC,KAAK,EAAE,SAAS;KACjB,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,MAAM,MAAM,CAAC,KAAK,CAAC;IACrB,CAAC;IAED,IAAI,CAAC,OAAO,EAAE,aAAa,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnD,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;IACnC,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;AAC5B,CAAC"}

package/dist/registry.d.ts

@@ -0,0 +1,9 @@
+export type Registered_compose_project = {
+    registry_namespace: string;
+    compose_project: string;
+    worktree_path: string;
+    dependency_name: string;
+};
+export declare function register_compose_project(entry: Registered_compose_project): void;
+export declare function unregister_compose_project(registry_namespace: string, compose_project: string): void;
+export declare function list_registered_compose_projects(registry_namespace: string): Registered_compose_project[];

package/dist/registry.js

@@ -0,0 +1,34 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, resolve } from "node:path";
+const registry_path = resolve(homedir(), ".devtree", "projects.json");
+function read_registry() {
+    if (!existsSync(registry_path)) {
+        return [];
+    }
+    const file_text = readFileSync(registry_path, "utf8").trim();
+    if (!file_text) {
+        return [];
+    }
+    return JSON.parse(file_text);
+}
+function write_registry(entries) {
+    mkdirSync(dirname(registry_path), { recursive: true });
+    writeFileSync(registry_path, JSON.stringify(entries, null, 2) + "\n");
+}
+export function register_compose_project(entry) {
+    const next_entries = read_registry().filter((existing_entry) => !(existing_entry.registry_namespace === entry.registry_namespace &&
+        existing_entry.compose_project === entry.compose_project));
+    next_entries.push(entry);
+    next_entries.sort((left, right) => left.compose_project.localeCompare(right.compose_project));
+    write_registry(next_entries);
+}
+export function unregister_compose_project(registry_namespace, compose_project) {
+    const next_entries = read_registry().filter((existing_entry) => !(existing_entry.registry_namespace === registry_namespace &&
+        existing_entry.compose_project === compose_project));
+    write_registry(next_entries);
+}
+export function list_registered_compose_projects(registry_namespace) {
+    return read_registry().filter((entry) => entry.registry_namespace === registry_namespace);
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAS7C,MAAM,aAAa,GAAG,OAAO,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,eAAe,CAAC,CAAC;AAEtE,SAAS,aAAa;IACpB,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAC/B,OAAO,EAAkC,CAAC;IAC5C,CAAC;IAED,MAAM,SAAS,GAAG,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IAE7D,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,EAAkC,CAAC;IAC5C,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAiC,CAAC;AAC/D,CAAC;AAED,SAAS,cAAc,CAAC,OAAqC;IAC3D,SAAS,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,aAAa,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAAiC;IACxE,MAAM,YAAY,GAAG,aAAa,EAAE,CAAC,MAAM,CACzC,CAAC,cAAc,EAAE,EAAE,CACjB,CAAC,CACC,cAAc,CAAC,kBAAkB,KAAK,KAAK,CAAC,kBAAkB;QAC9D,cAAc,CAAC,eAAe,KAAK,KAAK,CAAC,eAAe,CACzD,CACJ,CAAC;IAEF,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,YAAY,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,aAAa,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC;IAC9F,cAAc,CAAC,YAAY,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,kBAA0B,EAAE,eAAuB;IAC5F,MAAM,YAAY,GAAG,aAAa,EAAE,CAAC,MAAM,CACzC,CAAC,cAAc,EAAE,EAAE,CACjB,CAAC,CACC,cAAc,CAAC,kBAAkB,KAAK,kBAAkB;QACxD,cAAc,CAAC,eAAe,KAAK,eAAe,CACnD,CACJ,CAAC;IAEF,cAAc,CAAC,YAAY,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,gCAAgC,CAAC,kBAA0B;IACzE,OAAO,aAAa,EAAE,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,kBAAkB,KAAK,kBAAkB,CAAC,CAAC;AAC5F,CAAC"}

package/dist/tailscale.d.ts

@@ -0,0 +1,10 @@
+import type { Devtree_config } from "./config.ts";
+export type Resolved_tailscale = {
+    enabled: boolean;
+    cli_available: boolean;
+    host: string | null;
+    error: string | null;
+};
+export declare function tailscale_enabled(config: Devtree_config): boolean;
+export declare function parse_tailscale_host(status_json: string): string | null;
+export declare function resolve_tailscale(config: Devtree_config): Resolved_tailscale;

package/dist/tailscale.js

@@ -0,0 +1,65 @@
+import { command_exists, run_command_capture } from "./process.js";
+export function tailscale_enabled(config) {
+    return config.tailscale?.enabled === true;
+}
+export function parse_tailscale_host(status_json) {
+    const parsed_status = JSON.parse(status_json);
+    const host = parsed_status.Self?.DNSName?.trim().replace(/\.$/, "");
+    return host || null;
+}
+export function resolve_tailscale(config) {
+    if (!tailscale_enabled(config)) {
+        return {
+            enabled: false,
+            cli_available: false,
+            host: null,
+            error: null,
+        };
+    }
+    if (!command_exists("tailscale")) {
+        return {
+            enabled: true,
+            cli_available: false,
+            host: null,
+            error: "tailscale is enabled, but the `tailscale` command is not available on PATH",
+        };
+    }
+    const status_result = run_command_capture("tailscale", ["status", "--json"], {
+        allow_failure: true,
+    });
+    if (status_result.status !== 0) {
+        return {
+            enabled: true,
+            cli_available: true,
+            host: null,
+            error: status_result.stderr ||
+                "tailscale is enabled, but `tailscale status --json` did not return a usable host",
+        };
+    }
+    try {
+        const host = parse_tailscale_host(status_result.stdout);
+        if (!host) {
+            return {
+                enabled: true,
+                cli_available: true,
+                host: null,
+                error: "tailscale is enabled, but `tailscale status --json` did not report a MagicDNS host",
+            };
+        }
+        return {
+            enabled: true,
+            cli_available: true,
+            host,
+            error: null,
+        };
+    }
+    catch {
+        return {
+            enabled: true,
+            cli_available: true,
+            host: null,
+            error: "tailscale is enabled, but `tailscale status --json` returned invalid JSON",
+        };
+    }
+}
+//# sourceMappingURL=tailscale.js.map

package/dist/tailscale.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tailscale.js","sourceRoot":"","sources":["../src/tailscale.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAenE,MAAM,UAAU,iBAAiB,CAAC,MAAsB;IACtD,OAAO,MAAM,CAAC,SAAS,EAAE,OAAO,KAAK,IAAI,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,WAAmB;IACtD,MAAM,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAqB,CAAC;IAClE,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAEpE,OAAO,IAAI,IAAI,IAAI,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAAsB;IACtD,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/B,OAAO;YACL,OAAO,EAAE,KAAK;YACd,aAAa,EAAE,KAAK;YACpB,IAAI,EAAE,IAAI;YACV,KAAK,EAAE,IAAI;SACZ,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,EAAE,CAAC;QACjC,OAAO;YACL,OAAO,EAAE,IAAI;YACb,aAAa,EAAE,KAAK;YACpB,IAAI,EAAE,IAAI;YACV,KAAK,EAAE,4EAA4E;SACpF,CAAC;IACJ,CAAC;IAED,MAAM,aAAa,GAAG,mBAAmB,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE;QAC3E,aAAa,EAAE,IAAI;KACpB,CAAC,CAAC;IAEH,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO;YACL,OAAO,EAAE,IAAI;YACb,aAAa,EAAE,IAAI;YACnB,IAAI,EAAE,IAAI;YACV,KAAK,EACH,aAAa,CAAC,MAAM;gBACpB,kFAAkF;SACrF,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,oBAAoB,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QAExD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,aAAa,EAAE,IAAI;gBACnB,IAAI,EAAE,IAAI;gBACV,KAAK,EACH,oFAAoF;aACvF,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,aAAa,EAAE,IAAI;YACnB,IAAI;YACJ,KAAK,EAAE,IAAI;SACZ,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;YACL,OAAO,EAAE,IAAI;YACb,aAAa,EAAE,IAAI;YACnB,IAAI,EAAE,IAAI;YACV,KAAK,EAAE,2EAA2E;SACnF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/vite.d.ts

@@ -0,0 +1,3 @@
+import type { Plugin } from "vite-plus";
+import type { Devtree_config } from "./config.ts";
+export declare function devtree_vite_plugins(config: Devtree_config): Promise<Plugin<any>[]>;