@mdulghier/devtree 0.1.5

package/dist/config-command.d.ts

@@ -0,0 +1,5 @@
+import type { Devtree_config } from "./config.ts";
+export declare function get_config_value(config: Devtree_config, config_path: string): unknown;
+export declare function format_config_value(value: unknown): string;
+export declare function update_config_text(source_text: string, config_path: string, raw_value: string): string;
+export declare function set_config_value(config_file_path: string, config_path: string, raw_value: string): void;

package/dist/config-command.js

@@ -0,0 +1,181 @@
+import { readFileSync, writeFileSync } from "node:fs";
+import ts from "typescript";
+function get_property_name_text(name) {
+    if (ts.isIdentifier(name) || ts.isStringLiteral(name) || ts.isNumericLiteral(name)) {
+        return name.text;
+    }
+    return undefined;
+}
+function get_object_literal_from_source_file(source_file) {
+    for (const statement of source_file.statements) {
+        if (!ts.isExportAssignment(statement)) {
+            continue;
+        }
+        const export_expression = statement.expression;
+        if (ts.isObjectLiteralExpression(export_expression)) {
+            return export_expression;
+        }
+        if (ts.isCallExpression(export_expression) &&
+            export_expression.arguments.length > 0 &&
+            ts.isObjectLiteralExpression(export_expression.arguments[0])) {
+            return export_expression.arguments[0];
+        }
+    }
+    throw new Error("Could not find an exported devtree config object in devtree.config.ts.");
+}
+function get_property_assignment(object_literal, segment) {
+    return object_literal.properties.find((property) => ts.isPropertyAssignment(property) &&
+        property.name !== undefined &&
+        get_property_name_text(property.name) === segment);
+}
+function create_property_name(segment) {
+    return /^[$A-Z_a-z][$\w]*$/u.test(segment)
+        ? ts.factory.createIdentifier(segment)
+        : ts.factory.createStringLiteral(segment);
+}
+function json_value_to_expression(value) {
+    if (value === null) {
+        return ts.factory.createNull();
+    }
+    if (typeof value === "boolean") {
+        return value ? ts.factory.createTrue() : ts.factory.createFalse();
+    }
+    if (typeof value === "number") {
+        return ts.factory.createNumericLiteral(value);
+    }
+    if (typeof value === "string") {
+        return ts.factory.createStringLiteral(value);
+    }
+    if (Array.isArray(value)) {
+        return ts.factory.createArrayLiteralExpression(value.map(json_value_to_expression), true);
+    }
+    if (typeof value !== "object") {
+        throw new Error("Config values must be JSON-compatible objects, arrays, or primitives.");
+    }
+    return ts.factory.createObjectLiteralExpression(Object.entries(value).map(([key, entry_value]) => ts.factory.createPropertyAssignment(create_property_name(key), json_value_to_expression(entry_value))), true);
+}
+function parse_value_expression(raw_value) {
+    const trimmed_value = raw_value.trim();
+    if (trimmed_value === "true") {
+        return ts.factory.createTrue();
+    }
+    if (trimmed_value === "false") {
+        return ts.factory.createFalse();
+    }
+    if (trimmed_value === "null") {
+        return ts.factory.createNull();
+    }
+    if (trimmed_value === "undefined") {
+        return ts.factory.createIdentifier("undefined");
+    }
+    if (/^-?\d+(?:\.\d+)?$/u.test(trimmed_value)) {
+        return ts.factory.createNumericLiteral(trimmed_value);
+    }
+    if ((trimmed_value.startsWith("{") && trimmed_value.endsWith("}")) ||
+        (trimmed_value.startsWith("[") && trimmed_value.endsWith("]")) ||
+        (trimmed_value.startsWith('"') && trimmed_value.endsWith('"'))) {
+        try {
+            return json_value_to_expression(JSON.parse(trimmed_value));
+        }
+        catch {
+            return ts.factory.createStringLiteral(raw_value);
+        }
+    }
+    return ts.factory.createStringLiteral(raw_value);
+}
+function print_node(node, source_file) {
+    const printer = ts.createPrinter({ newLine: ts.NewLineKind.LineFeed });
+    return printer.printNode(ts.EmitHint.Unspecified, node, source_file);
+}
+function create_nested_object_literal(segments, value) {
+    const [segment, ...rest] = segments;
+    if (!segment) {
+        throw new Error("Config path cannot be empty.");
+    }
+    return ts.factory.createObjectLiteralExpression([
+        ts.factory.createPropertyAssignment(create_property_name(segment), rest.length === 0 ? value : create_nested_object_literal(rest, value)),
+    ], true);
+}
+function plan_config_update(object_literal, segments, value) {
+    const [segment, ...rest] = segments;
+    if (!segment) {
+        throw new Error("Config path cannot be empty.");
+    }
+    const existing_property = get_property_assignment(object_literal, segment);
+    if (rest.length === 0) {
+        if (existing_property) {
+            return {
+                target: existing_property.initializer,
+                replacement: value,
+            };
+        }
+        return {
+            target: object_literal,
+            replacement: ts.factory.updateObjectLiteralExpression(object_literal, [
+                ...object_literal.properties,
+                ts.factory.createPropertyAssignment(create_property_name(segment), value),
+            ]),
+        };
+    }
+    if (!existing_property) {
+        return {
+            target: object_literal,
+            replacement: ts.factory.updateObjectLiteralExpression(object_literal, [
+                ...object_literal.properties,
+                ts.factory.createPropertyAssignment(create_property_name(segment), create_nested_object_literal(rest, value)),
+            ]),
+        };
+    }
+    if (!ts.isObjectLiteralExpression(existing_property.initializer)) {
+        throw new Error(`Cannot set ${segments.join(".")} because ${segment} is not an object.`);
+    }
+    return plan_config_update(existing_property.initializer, rest, value);
+}
+function get_config_path_segments(config_path) {
+    const segments = config_path
+        .split(".")
+        .map((segment) => segment.trim())
+        .filter(Boolean);
+    if (segments.length === 0) {
+        throw new Error("Config path cannot be empty.");
+    }
+    return segments;
+}
+export function get_config_value(config, config_path) {
+    let current_value = config;
+    for (const segment of get_config_path_segments(config_path)) {
+        if (current_value === null || typeof current_value !== "object" || !(segment in current_value)) {
+            return undefined;
+        }
+        current_value = current_value[segment];
+    }
+    return current_value;
+}
+export function format_config_value(value) {
+    if (value === undefined) {
+        return "undefined";
+    }
+    if (typeof value === "string") {
+        return JSON.stringify(value);
+    }
+    if (typeof value === "function") {
+        return "[function]";
+    }
+    return JSON.stringify(value, null, 2);
+}
+export function update_config_text(source_text, config_path, raw_value) {
+    const source_file = ts.createSourceFile("devtree.config.ts", source_text, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
+    const root_object_literal = get_object_literal_from_source_file(source_file);
+    const replacement_plan = plan_config_update(root_object_literal, get_config_path_segments(config_path), parse_value_expression(raw_value));
+    return [
+        source_text.slice(0, replacement_plan.target.getStart(source_file)),
+        print_node(replacement_plan.replacement, source_file),
+        source_text.slice(replacement_plan.target.getEnd()),
+    ].join("");
+}
+export function set_config_value(config_file_path, config_path, raw_value) {
+    const source_text = readFileSync(config_file_path, "utf8");
+    const next_text = update_config_text(source_text, config_path, raw_value);
+    writeFileSync(config_file_path, next_text);
+}
+//# sourceMappingURL=config-command.js.map

package/dist/config-command.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,77 @@
+import type { Devtree_instance } from "./instance.ts";
+export type Managed_env_entry = {
+    kind: "value";
+    key: string;
+    value: string;
+} | {
+    kind: "comment";
+    text: string;
+};
+export type Resolved_env_map = Record<string, string | undefined>;
+export type Command_spec_context = {
+    config: Devtree_config;
+    instance: Devtree_instance;
+    repo_root: string;
+    managed_env_values: Record<string, string>;
+    effective_env_values: Record<string, string>;
+};
+export type Command_spec = {
+    name?: string;
+    command: [string, ...string[]];
+    cwd?: string;
+    env?: Resolved_env_map | ((context: Command_spec_context) => Resolved_env_map);
+};
+export type Compose_dependency_context = Command_spec_context;
+export type Compose_dependency = {
+    kind: "compose";
+    name: string;
+    file_path?: string;
+    project_name?: string | ((context: Compose_dependency_context) => string);
+    services?: string[];
+    env?: Resolved_env_map | ((context: Compose_dependency_context) => Resolved_env_map);
+};
+export type Command_dependency = {
+    kind: "command";
+    name: string;
+    start: Command_spec;
+    stop?: Command_spec;
+    logs?: Command_spec;
+};
+export type Devtree_dependency = Compose_dependency | Command_dependency;
+export type Devtree_config = {
+    app_name: string;
+    namespace?: string;
+    tailscale?: {
+        enabled?: boolean;
+    };
+    portless?: {
+        enabled?: boolean;
+        https?: boolean | "inherit";
+        bootstrap?: "best-effort" | "manual";
+    };
+    env: {
+        provider: "dotenv" | "varlock";
+        file_path?: string;
+        schema_path?: string;
+        managed_block_id?: string;
+        preamble?: string[];
+        entries: (context: {
+            config: Devtree_config;
+            instance: Devtree_instance;
+            existing_env_values: Record<string, string>;
+        }) => Managed_env_entry[];
+    };
+    dependencies?: Devtree_dependency[];
+    hooks?: Partial<Record<"setup" | "migrate" | "pre_dev" | "post_setup", Command_spec[]>>;
+    garbage_collection?: {
+        registry_namespace?: string;
+        docker_label_prefix?: string;
+    };
+};
+export type Loaded_devtree_config = {
+    config: Devtree_config;
+    config_path: string;
+    repo_root: string;
+};
+export declare function define_devtree_config(config: Devtree_config): Devtree_config;
+export declare function load_devtree_config(start_dir?: string): Promise<Loaded_devtree_config>;

package/dist/config.js

@@ -0,0 +1,43 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+import { existsSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+export function define_devtree_config(config) {
+    return config;
+}
+function find_repo_root(start_dir) {
+    let current_dir = resolve(start_dir);
+    while (true) {
+        const config_path = resolve(current_dir, "devtree.config.ts");
+        if (existsSync(config_path)) {
+            return current_dir;
+        }
+        const parent_dir = dirname(current_dir);
+        if (parent_dir === current_dir) {
+            throw new Error("Could not find devtree.config.ts from the current working directory.");
+        }
+        current_dir = parent_dir;
+    }
+}
+export async function load_devtree_config(start_dir = process.cwd()) {
+    const repo_root = find_repo_root(start_dir);
+    const config_path = resolve(repo_root, "devtree.config.ts");
+    const config_url = pathToFileURL(config_path).href;
+    const imported_config = (await import(__rewriteRelativeImportExtension(config_url)));
+    if (!imported_config.default) {
+        throw new Error(`Expected a default export from ${config_path}.`);
+    }
+    return {
+        config: imported_config.default,
+        config_path,
+        repo_root,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;;;;;;;AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AA0FzC,MAAM,UAAU,qBAAqB,CAAC,MAAsB;IAC1D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,cAAc,CAAC,SAAiB;IACvC,IAAI,WAAW,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAErC,OAAO,IAAI,EAAE,CAAC;QACZ,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,EAAE,mBAAmB,CAAC,CAAC;QAE9D,IAAI,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YAC5B,OAAO,WAAW,CAAC;QACrB,CAAC;QAED,MAAM,UAAU,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;QAExC,IAAI,UAAU,KAAK,WAAW,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAC;QAC1F,CAAC;QAED,WAAW,GAAG,UAAU,CAAC;IAC3B,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE;IAEzB,MAAM,SAAS,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IAC5C,MAAM,WAAW,GAAG,OAAO,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;IAC5D,MAAM,UAAU,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC;IACnD,MAAM,eAAe,GAAG,CAAC,MAAM,MAAM,kCAAC,UAAU,EAAC,CAAiC,CAAC;IAEnF,IAAI,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,kCAAkC,WAAW,GAAG,CAAC,CAAC;IACpE,CAAC;IAED,OAAO;QACL,MAAM,EAAE,eAAe,CAAC,OAAO;QAC/B,WAAW;QACX,SAAS;KACV,CAAC;AACJ,CAAC"}

package/dist/env-file.d.ts

@@ -0,0 +1,12 @@
+import type { Loaded_devtree_config, Managed_env_entry } from "./config.ts";
+import type { Devtree_instance } from "./instance.ts";
+export type Ensure_env_file_result = {
+    created: boolean;
+    updated: boolean;
+    env_file_path: string;
+    managed_entries: Managed_env_entry[];
+    managed_env_values: Record<string, string>;
+    effective_env_values: Record<string, string>;
+};
+export declare function ensure_env_file(loaded_config: Loaded_devtree_config, instance: Devtree_instance): Ensure_env_file_result;
+export declare function get_env_file_status_message(result: Ensure_env_file_result): string;

package/dist/env-file.js

@@ -0,0 +1,114 @@
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { parse } from "dotenv";
+function get_block_markers(managed_block_id) {
+    const block_id = managed_block_id?.trim() || "devtree managed env";
+    return {
+        start: `# >>> ${block_id} >>>`,
+        end: `# <<< ${block_id} <<<`,
+    };
+}
+function strip_leading_preamble_blocks(file_text, preamble_lines) {
+    const preamble_block = preamble_lines.join("\n").trim();
+    let next_text = file_text.trim();
+    if (!preamble_block) {
+        return next_text;
+    }
+    while (next_text === preamble_block || next_text.startsWith(`${preamble_block}\n`)) {
+        next_text = next_text.slice(preamble_block.length).trimStart();
+    }
+    return next_text;
+}
+function strip_trailing_preamble_blocks(file_text, preamble_lines) {
+    const preamble_block = preamble_lines.join("\n").trim();
+    let next_text = file_text.trim();
+    if (!preamble_block) {
+        return next_text;
+    }
+    while (next_text === preamble_block || next_text.endsWith(`\n${preamble_block}`)) {
+        next_text = next_text.slice(0, next_text.length - preamble_block.length).trimEnd();
+    }
+    return next_text;
+}
+function remove_managed_block(file_text, start_marker, end_marker, preamble_lines) {
+    const start_index = file_text.indexOf(start_marker);
+    const end_index = file_text.indexOf(end_marker);
+    if (start_index === -1 && end_index === -1) {
+        return file_text.trim();
+    }
+    if (start_index === -1) {
+        return strip_leading_preamble_blocks(file_text.slice(end_index + end_marker.length), preamble_lines);
+    }
+    if (end_index === -1 || end_index < start_index) {
+        return strip_trailing_preamble_blocks(file_text.slice(0, start_index), preamble_lines);
+    }
+    const before_block = strip_trailing_preamble_blocks(file_text.slice(0, start_index), preamble_lines);
+    const after_block = strip_leading_preamble_blocks(file_text.slice(end_index + end_marker.length), preamble_lines);
+    return [before_block, after_block].filter(Boolean).join("\n\n");
+}
+function read_existing_env_file(env_file_path, start_marker, end_marker, preamble_lines) {
+    if (!existsSync(env_file_path)) {
+        return {
+            file_text: "",
+            custom_text: "",
+            env_values: {},
+        };
+    }
+    const file_text = readFileSync(env_file_path, "utf8");
+    return {
+        file_text,
+        custom_text: remove_managed_block(file_text, start_marker, end_marker, preamble_lines),
+        env_values: parse(file_text),
+    };
+}
+function render_entry(entry) {
+    if (entry.kind === "comment") {
+        return entry.text;
+    }
+    return `${entry.key}=${entry.value}`;
+}
+function get_managed_env_values(entries) {
+    const managed_env_values = {};
+    for (const entry of entries) {
+        if (entry.kind === "value") {
+            managed_env_values[entry.key] = entry.value;
+        }
+    }
+    return managed_env_values;
+}
+export function ensure_env_file(loaded_config, instance) {
+    const markers = get_block_markers(loaded_config.config.env.managed_block_id);
+    const existing_env = read_existing_env_file(instance.env_file_path, markers.start, markers.end, loaded_config.config.env.preamble ?? []);
+    const managed_entries = loaded_config.config.env.entries({
+        config: loaded_config.config,
+        instance,
+        existing_env_values: existing_env.env_values,
+    });
+    const managed_block = [
+        ...(loaded_config.config.env.preamble ?? []),
+        markers.start,
+        ...managed_entries.map(render_entry),
+        markers.end,
+    ].join("\n");
+    const next_file_text = [managed_block, existing_env.custom_text].filter(Boolean).join("\n\n") + "\n";
+    if (next_file_text !== existing_env.file_text) {
+        writeFileSync(instance.env_file_path, next_file_text);
+    }
+    return {
+        created: !existing_env.file_text,
+        updated: next_file_text !== existing_env.file_text,
+        env_file_path: instance.env_file_path,
+        managed_entries,
+        managed_env_values: get_managed_env_values(managed_entries),
+        effective_env_values: parse(next_file_text),
+    };
+}
+export function get_env_file_status_message(result) {
+    if (result.created) {
+        return `Created ${result.env_file_path}`;
+    }
+    if (result.updated) {
+        return `Updated ${result.env_file_path}`;
+    }
+    return `${result.env_file_path} is already up to date`;
+}
+//# sourceMappingURL=env-file.js.map

package/dist/env-file.js.map

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

package/dist/gc.d.ts

@@ -0,0 +1,23 @@
+import type { Loaded_devtree_config } from "./config.ts";
+import type { Devtree_instance } from "./instance.ts";
+type Project_resources = {
+    project_name: string;
+    worktree_path: string | null;
+    registry_namespace: string | null;
+    containers: string[];
+    networks: string[];
+    volumes: string[];
+    sources: Set<string>;
+};
+export type Gc_options = {
+    dry_run: boolean;
+    verbose: boolean;
+};
+export type Classified_projects = {
+    active_projects: Project_resources[];
+    orphan_projects: Project_resources[];
+    unknown_projects: Project_resources[];
+};
+export declare function classify_projects(projects: Project_resources[], active_worktrees: Set<string>): Classified_projects;
+export declare function run_gc(loaded_config: Loaded_devtree_config, instance: Devtree_instance, options: Gc_options): void;
+export {};