@luxmargos/ensure-hosts 0.1.0

package/dist/config.js

@@ -0,0 +1,274 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { delimiter, resolve } from 'node:path';
+import { config as loadDotenv } from 'dotenv';
+import { parse as parseYaml } from 'yaml';
+const DEFAULT_ENV_FILE = '.env';
+export function parseCliOptions(argv) {
+    const options = {
+        configPaths: [],
+        envFile: DEFAULT_ENV_FILE,
+        envFileExplicit: false,
+        dryRun: false,
+        printRecords: false,
+        remove: false,
+        removeForce: false,
+        noElevate: false,
+        elevated: false,
+    };
+    for (let index = 0; index < argv.length; index += 1) {
+        const arg = argv[index];
+        if (arg === '--help' || arg === '-h') {
+            printHelpAndExit(0);
+        }
+        if (arg === '--version' || arg === '-v') {
+            printVersionAndExit();
+        }
+        if (arg === '--config') {
+            options.configPaths.push(requireValue(argv, ++index, '--config'));
+            continue;
+        }
+        if (arg.startsWith('--config=')) {
+            options.configPaths.push(arg.slice('--config='.length));
+            continue;
+        }
+        if (arg === '--env-file') {
+            options.envFile = requireValue(argv, ++index, '--env-file');
+            options.envFileExplicit = true;
+            continue;
+        }
+        if (arg.startsWith('--env-file=')) {
+            options.envFile = arg.slice('--env-file='.length);
+            options.envFileExplicit = true;
+            continue;
+        }
+        if (arg === '--hosts-file') {
+            options.hostsFile = requireValue(argv, ++index, '--hosts-file');
+            continue;
+        }
+        if (arg.startsWith('--hosts-file=')) {
+            options.hostsFile = arg.slice('--hosts-file='.length);
+            continue;
+        }
+        if (arg === '--output-file') {
+            options.outputFile = requireValue(argv, ++index, '--output-file');
+            continue;
+        }
+        if (arg.startsWith('--output-file=')) {
+            options.outputFile = arg.slice('--output-file='.length);
+            continue;
+        }
+        if (arg === '--dry-run') {
+            options.dryRun = true;
+            continue;
+        }
+        if (arg === '--print-records') {
+            options.printRecords = true;
+            continue;
+        }
+        if (arg === '--remove') {
+            options.remove = true;
+            continue;
+        }
+        if (arg === '--remove-force') {
+            options.removeForce = true;
+            continue;
+        }
+        if (arg === '--no-elevate') {
+            options.noElevate = true;
+            continue;
+        }
+        if (arg === '--elevated') {
+            options.elevated = true;
+            continue;
+        }
+        throw new Error(`Unknown option: ${arg}\n\n${usage()}`);
+    }
+    assertCompatibleModes(options);
+    return options;
+}
+function assertCompatibleModes(options) {
+    if (options.remove && options.removeForce) {
+        throw new Error(`--remove and --remove-force cannot be used together.\n\n${usage()}`);
+    }
+    if ((options.remove || options.removeForce) && options.printRecords) {
+        throw new Error(`--print-records cannot be combined with --remove or --remove-force.\n\n${usage()}`);
+    }
+}
+export function loadDefaultEnv(envFile) {
+    const resolved = resolve(envFile);
+    if (!existsSync(resolved)) {
+        return;
+    }
+    loadDotenv({ path: resolved, override: false });
+}
+export function resolveConfigPaths(options, env = process.env) {
+    if (options.configPaths.length > 0) {
+        return options.configPaths.map(path => resolve(path));
+    }
+    const fromEnv = env.ENSURE_HOSTS_CONFIG?.trim();
+    if (!fromEnv) {
+        throw new Error(`No config file provided. Use --config <path> or set ENSURE_HOSTS_CONFIG.\n\n${usage()}`);
+    }
+    return splitPathList(fromEnv).map(path => resolve(path));
+}
+export function resolveHostsFileOverride(options, env = process.env) {
+    return options.hostsFile ?? env.ENSURE_HOSTS_HOSTS_FILE;
+}
+export function resolveNoElevate(options, env = process.env) {
+    return options.noElevate || parseBooleanEnv(env.ENSURE_HOSTS_NO_ELEVATE);
+}
+/**
+ * Rebuild the CLI args for an elevated child process from already-resolved
+ * (absolute) paths. The elevated re-spawn runs in a different working
+ * directory than the parent (osascript's `do shell script` starts in `/`),
+ * so any relative path the user passed would fail to resolve in the child.
+ * Passing absolute paths fixes that without changing the public CLI surface.
+ *
+ * Elevation-only flags (`--no-elevate`, `--elevated`) and `--output-file`
+ * (Windows elevated-output plumbing) are intentionally omitted: the child is
+ * re-elevated/redirected by the elevation layer itself, not by these flags.
+ */
+export function buildElevationArgs(options, configPaths) {
+    const args = [];
+    for (const configPath of configPaths) {
+        args.push('--config', resolve(configPath));
+    }
+    // Only forward --env-file when the user explicitly set it. Node 20.6+ treats
+    // --env-file as its own flag (even after the script path) and exits with an
+    // error if the file is missing, so emitting it unconditionally would crash
+    // the elevated child whenever the default .env is absent.
+    if (options.envFileExplicit) {
+        args.push('--env-file', resolve(options.envFile));
+    }
+    if (options.hostsFile) {
+        args.push('--hosts-file', resolve(options.hostsFile));
+    }
+    if (options.dryRun) {
+        args.push('--dry-run');
+    }
+    if (options.printRecords) {
+        args.push('--print-records');
+    }
+    if (options.remove) {
+        args.push('--remove');
+    }
+    if (options.removeForce) {
+        args.push('--remove-force');
+    }
+    return args;
+}
+export function loadProfiles(configPaths) {
+    return configPaths.map(loadProfile);
+}
+export function loadProfile(configPath) {
+    if (!/\.ya?ml$/i.test(configPath)) {
+        throw new Error(`Config file must be .yaml or .yml: ${configPath}`);
+    }
+    const content = readFileSync(configPath, 'utf8');
+    const parsed = parseYaml(content);
+    return normalizeProfile(parsed, configPath);
+}
+function normalizeProfile(value, configPath) {
+    if (!isRecord(value)) {
+        throw new Error(`Config must be a YAML object: ${configPath}`);
+    }
+    const profile = requireString(value.profile, 'profile', configPath);
+    const hostsValue = value.hosts;
+    if (!Array.isArray(hostsValue)) {
+        throw new Error(`Config field "hosts" must be an array: ${configPath}`);
+    }
+    return {
+        profile,
+        hosts: hostsValue.map((host, index) => normalizeHostNode(host, `${configPath}:hosts[${index}]`)),
+    };
+}
+function normalizeHostNode(value, location) {
+    if (typeof value === 'string') {
+        return { domain: value };
+    }
+    if (!isRecord(value)) {
+        throw new Error(`Host entry must be an object or string: ${location}`);
+    }
+    const domain = requireString(value.domain, 'domain', location);
+    const node = { domain };
+    if (value.address !== undefined) {
+        node.address = requireString(value.address, 'address', location);
+    }
+    if (value.rewrite !== undefined) {
+        node.rewrite = requireBoolean(value.rewrite, 'rewrite', location);
+    }
+    if (value.skipSelf !== undefined) {
+        node.skipSelf = requireBoolean(value.skipSelf, 'skipSelf', location);
+    }
+    if (value.children !== undefined) {
+        if (!Array.isArray(value.children)) {
+            throw new Error(`Field "children" must be an array: ${location}`);
+        }
+        node.children = value.children.map((child, index) => normalizeHostNode(child, `${location}.children[${index}]`));
+    }
+    return node;
+}
+function splitPathList(value) {
+    return value
+        .split(/[,\n]/g)
+        .flatMap(part => part.split(delimiter))
+        .map(part => part.trim())
+        .filter(Boolean);
+}
+function requireValue(argv, index, option) {
+    const value = argv[index];
+    if (!value || value.startsWith('--')) {
+        throw new Error(`${option} requires a value.`);
+    }
+    return value;
+}
+function requireString(value, field, location) {
+    if (typeof value !== 'string' || value.trim() === '') {
+        throw new Error(`Field "${field}" must be a non-empty string: ${location}`);
+    }
+    return value.trim();
+}
+function requireBoolean(value, field, location) {
+    if (typeof value !== 'boolean') {
+        throw new Error(`Field "${field}" must be a boolean: ${location}`);
+    }
+    return value;
+}
+function parseBooleanEnv(value) {
+    if (!value) {
+        return false;
+    }
+    return ['1', 'true', 'yes', 'on'].includes(value.trim().toLowerCase());
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function printHelpAndExit(code) {
+    console.log(usage());
+    process.exit(code);
+}
+function printVersionAndExit() {
+    console.log('0.1.0');
+    process.exit(0);
+}
+export function usage() {
+    return [
+        'Usage: ensure-hosts --config <path> [--config <path> ...] [options]',
+        '',
+        'Options:',
+        '  --config <path>      YAML/YML config file path (repeatable)',
+        '  --env-file <path>    dotenv file path (default: .env)',
+        '  --hosts-file <path>  override hosts file path',
+        '  --dry-run            print rewritten hosts content without writing',
+        '  --print-records      print expanded records and exit',
+        '  --remove             remove rewrite:true domains (respects rewrite:false)',
+        '  --remove-force       remove all listed domains, including rewrite:false',
+        '  --no-elevate         disable macOS/Windows privilege prompt',
+        '  --help               show help',
+        '  --version            show version',
+        '',
+        '--remove and --remove-force are mutually exclusive and cannot be combined',
+        'with --print-records.',
+    ].join('\n');
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/domain-map.d.ts

@@ -0,0 +1,4 @@
+import type { ExpandedProfile, ProfileConfig } from './types.js';
+export declare function expandProfiles(profiles: ProfileConfig[]): ExpandedProfile[];
+export declare function expandProfile(profile: ProfileConfig): ExpandedProfile;
+export declare function composeDomain(domain: string, parentDomain?: string): string;

package/dist/domain-map.js

@@ -0,0 +1,73 @@
+import { isIP } from 'node:net';
+export function expandProfiles(profiles) {
+    return profiles.map(expandProfile);
+}
+export function expandProfile(profile) {
+    const output = {
+        profile: profile.profile,
+        records: [],
+        cleanupDomains: new Set(),
+    };
+    for (const host of profile.hosts) {
+        expandNode(host, {
+            profile: profile.profile,
+            parentRewrite: true,
+        }, output);
+    }
+    return {
+        profile: output.profile,
+        records: output.records,
+        cleanupDomains: [...output.cleanupDomains],
+    };
+}
+function expandNode(node, context, output) {
+    const domain = composeDomain(node.domain, context.parentDomain);
+    const address = normalizeOptionalString(node.address) ?? context.parentAddress;
+    const rewrite = node.rewrite ?? context.parentRewrite ?? true;
+    const skipSelf = node.skipSelf ?? false;
+    if (rewrite) {
+        output.cleanupDomains.add(domain);
+    }
+    if (!skipSelf && address) {
+        assertIpAddress(address, domain);
+        output.records.push({
+            profile: context.profile,
+            domain,
+            address,
+            rewrite,
+        });
+    }
+    for (const child of node.children ?? []) {
+        const childNode = typeof child === 'string' ? { domain: child } : child;
+        expandNode(childNode, {
+            profile: context.profile,
+            parentDomain: domain,
+            parentAddress: address,
+            parentRewrite: rewrite,
+        }, output);
+    }
+}
+export function composeDomain(domain, parentDomain) {
+    const normalized = domain.trim().replace(/^\.+|\.+$/g, '').toLowerCase();
+    if (!normalized) {
+        throw new Error('Domain must not be empty.');
+    }
+    if (!parentDomain) {
+        return normalized;
+    }
+    const normalizedParent = parentDomain.trim().replace(/^\.+|\.+$/g, '').toLowerCase();
+    if (normalized === normalizedParent || normalized.endsWith(`.${normalizedParent}`)) {
+        return normalized;
+    }
+    return `${normalized}.${normalizedParent}`;
+}
+function normalizeOptionalString(value) {
+    const normalized = value?.trim();
+    return normalized ? normalized : undefined;
+}
+function assertIpAddress(address, domain) {
+    if (isIP(address) === 0) {
+        throw new Error(`Invalid IP address for ${domain}: ${address}`);
+    }
+}
+//# sourceMappingURL=domain-map.js.map

package/dist/domain-map.js.map

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

package/dist/hosts.d.ts

@@ -0,0 +1,30 @@
+import type { ExpandedProfile, HostRecord } from './types.js';
+export interface RewriteResult {
+    content: string;
+    appended: HostRecord[];
+    removedDomains: string[];
+}
+export interface RemoveResult {
+    content: string;
+    removedDomains: string[];
+}
+export declare function rewriteHostsContent(content: string, profiles: ExpandedProfile[]): RewriteResult;
+/**
+ * Remove the domains managed by the given profiles from the hosts content,
+ * without appending anything. This is the inverse of the default ensure
+ * action: run the cleanup phase only.
+ *
+ * `force: false` (the `--remove` flag) strips only `cleanupDomains` — the
+ * domains declared `rewrite: true`. Domains declared `rewrite: false` are
+ * left untouched, matching their "do not alter existing entries" contract.
+ *
+ * `force: true` (the `--remove-force` flag) additionally strips every domain
+ * the profiles would write (`record.domain`), including `rewrite: false`
+ * entries.
+ */
+export declare function removeHostsContent(content: string, profiles: ExpandedProfile[], options: {
+    force: boolean;
+}): RemoveResult;
+export declare function selectRecordsToAppend(lines: string[], profiles: ExpandedProfile[]): HostRecord[];
+export declare function collectDomainsFromContent(content: string): Set<string>;
+export declare function collectDomainsFromLines(lines: string[]): Set<string>;

package/dist/hosts.js

@@ -0,0 +1,220 @@
+export function rewriteHostsContent(content, profiles) {
+    const eol = detectEol(content);
+    const hadFinalEol = content.endsWith('\n') || content.endsWith('\r\n');
+    const sourceLines = splitLines(content);
+    const cleanupDomains = new Set(profiles.flatMap(profile => profile.cleanupDomains));
+    const profileNames = new Set(profiles.map(profile => profile.profile));
+    const { lines: cleanedLines, removedDomains } = cleanupHostsLines(sourceLines, cleanupDomains, profileNames);
+    const compactedLines = compactBlankRuns(cleanedLines);
+    const appended = selectRecordsToAppend(compactedLines, profiles);
+    const nextLines = [...trimTrailingBlankLines(compactedLines)];
+    if (appended.length > 0) {
+        if (nextLines.length > 0) {
+            nextLines.push('');
+        }
+        for (const record of appended) {
+            nextLines.push(`# ${record.profile}`);
+            nextLines.push(`${record.address} ${record.domain}`);
+        }
+    }
+    const contentBody = nextLines.join(eol);
+    const nextContent = contentBody.length > 0 ? `${contentBody}${eol}` : hadFinalEol ? eol : '';
+    return {
+        content: nextContent,
+        appended,
+        removedDomains: [...removedDomains],
+    };
+}
+/**
+ * Remove the domains managed by the given profiles from the hosts content,
+ * without appending anything. This is the inverse of the default ensure
+ * action: run the cleanup phase only.
+ *
+ * `force: false` (the `--remove` flag) strips only `cleanupDomains` — the
+ * domains declared `rewrite: true`. Domains declared `rewrite: false` are
+ * left untouched, matching their "do not alter existing entries" contract.
+ *
+ * `force: true` (the `--remove-force` flag) additionally strips every domain
+ * the profiles would write (`record.domain`), including `rewrite: false`
+ * entries.
+ */
+export function removeHostsContent(content, profiles, options) {
+    const eol = detectEol(content);
+    const hadFinalEol = content.endsWith('\n') || content.endsWith('\r\n');
+    const sourceLines = splitLines(content);
+    const removeDomains = new Set(profiles.flatMap(profile => profile.cleanupDomains));
+    if (options.force) {
+        for (const profile of profiles) {
+            for (const record of profile.records) {
+                removeDomains.add(record.domain);
+            }
+        }
+    }
+    const profileNames = new Set(profiles.map(profile => profile.profile));
+    const { lines: cleanedLines, removedDomains } = cleanupHostsLines(sourceLines, removeDomains, profileNames);
+    const compactedLines = compactBlankRuns(cleanedLines);
+    const nextLines = [...trimTrailingBlankLines(compactedLines)];
+    const contentBody = nextLines.join(eol);
+    const nextContent = contentBody.length > 0 ? `${contentBody}${eol}` : hadFinalEol ? eol : '';
+    return {
+        content: nextContent,
+        removedDomains: [...removedDomains],
+    };
+}
+/**
+ * Run the shared line-cleanup pass used by both ensure (rewrite) and remove.
+ * Strips tokens in `cleanupDomains` from each line via `cleanHostsLine`,
+ * drops orphaned `# <profile>` managed comments that precede a removed line,
+ * and returns the surviving lines plus the set of domains actually removed.
+ * Does not compact blank runs or append anything — callers do that.
+ */
+function cleanupHostsLines(sourceLines, cleanupDomains, profileNames) {
+    const cleanedLines = [];
+    const removedDomains = new Set();
+    let pendingManagedComments = [];
+    for (const line of sourceLines) {
+        if (isManagedProfileComment(line, profileNames)) {
+            pendingManagedComments.push(line);
+            continue;
+        }
+        const cleaned = cleanHostsLine(line, cleanupDomains);
+        for (const domain of cleaned.removedDomains) {
+            removedDomains.add(domain);
+        }
+        if (cleaned.changed) {
+            pendingManagedComments = [];
+        }
+        else if (pendingManagedComments.length > 0) {
+            cleanedLines.push(...pendingManagedComments);
+            pendingManagedComments = [];
+        }
+        if (cleaned.line !== null) {
+            cleanedLines.push(cleaned.line);
+        }
+    }
+    if (pendingManagedComments.length > 0) {
+        cleanedLines.push(...pendingManagedComments);
+    }
+    return { lines: cleanedLines, removedDomains };
+}
+export function selectRecordsToAppend(lines, profiles) {
+    const existingDomains = collectDomainsFromLines(lines);
+    const records = profiles.flatMap(profile => profile.records);
+    const appended = [];
+    for (const record of records) {
+        if (!record.rewrite && existingDomains.has(record.domain)) {
+            continue;
+        }
+        appended.push(record);
+        existingDomains.add(record.domain);
+    }
+    return appended;
+}
+export function collectDomainsFromContent(content) {
+    return collectDomainsFromLines(splitLines(content));
+}
+export function collectDomainsFromLines(lines) {
+    const domains = new Set();
+    for (const line of lines) {
+        const body = stripInlineComment(line).trim();
+        if (!body) {
+            continue;
+        }
+        const [, ...hosts] = body.split(/\s+/);
+        for (const host of hosts) {
+            domains.add(host.toLowerCase());
+        }
+    }
+    return domains;
+}
+function cleanHostsLine(line, cleanupDomains) {
+    if (cleanupDomains.size === 0) {
+        return { line, changed: false, removedDomains: [] };
+    }
+    const { body, comment } = splitInlineComment(line);
+    const leading = body.match(/^\s*/)?.[0] ?? '';
+    const tokens = body.trim().split(/\s+/).filter(Boolean);
+    if (tokens.length === 0) {
+        return { line, changed: false, removedDomains: [] };
+    }
+    const [address, ...hosts] = tokens;
+    if (hosts.length === 0) {
+        return { line, changed: false, removedDomains: [] };
+    }
+    const removedDomains = [];
+    const remainingHosts = hosts.filter(host => {
+        const shouldRemove = cleanupDomains.has(host.toLowerCase());
+        if (shouldRemove) {
+            removedDomains.push(host.toLowerCase());
+        }
+        return !shouldRemove;
+    });
+    if (removedDomains.length === 0) {
+        return { line, changed: false, removedDomains: [] };
+    }
+    if (remainingHosts.length === 0) {
+        const keptComment = comment.trim();
+        return {
+            line: keptComment ? keptComment : null,
+            changed: true,
+            removedDomains,
+        };
+    }
+    const nextBody = `${leading}${[address, ...remainingHosts].join('\t')}`;
+    return {
+        line: comment ? `${nextBody} ${comment}` : nextBody,
+        changed: true,
+        removedDomains,
+    };
+}
+function isManagedProfileComment(line, profileNames) {
+    const trimmed = line.trim();
+    if (!trimmed.startsWith('#')) {
+        return false;
+    }
+    const label = trimmed.slice(1).trim();
+    return profileNames.has(label);
+}
+function splitInlineComment(line) {
+    const index = line.indexOf('#');
+    if (index === -1) {
+        return { body: line, comment: '' };
+    }
+    return {
+        body: line.slice(0, index),
+        comment: line.slice(index),
+    };
+}
+function stripInlineComment(line) {
+    return splitInlineComment(line).body;
+}
+function splitLines(content) {
+    if (content.length === 0) {
+        return [];
+    }
+    return content.replace(/\r?\n$/, '').split(/\r?\n/);
+}
+function trimTrailingBlankLines(lines) {
+    const output = [...lines];
+    while (output.length > 0 && output[output.length - 1]?.trim() === '') {
+        output.pop();
+    }
+    return output;
+}
+function compactBlankRuns(lines) {
+    const output = [];
+    let previousBlank = false;
+    for (const line of lines) {
+        const blank = line.trim() === '';
+        if (blank && previousBlank) {
+            continue;
+        }
+        output.push(line);
+        previousBlank = blank;
+    }
+    return output;
+}
+function detectEol(content) {
+    return content.includes('\r\n') ? '\r\n' : '\n';
+}
+//# sourceMappingURL=hosts.js.map

package/dist/hosts.js.map

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

package/dist/platform.d.ts

@@ -0,0 +1,30 @@
+export declare function resolveDefaultHostsPath(currentPlatform?: NodeJS.Platform, env?: NodeJS.ProcessEnv): string;
+export type ElevationResult = false | 'written' | 'spawned';
+export interface ElevationOptions {
+    scriptPath: string;
+    args: string[];
+    cwd: string;
+    noElevate: boolean;
+    elevated: boolean;
+    dryRun: boolean;
+    printRecords: boolean;
+    filePath: string;
+    content: string;
+}
+export declare function tryElevate(options: ElevationOptions): ElevationResult;
+/**
+ * Returns true when an elevation attempt succeeded and the caller should
+ * exit cleanly (no Permission denied error). Any truthy ElevationResult
+ * (`'written'` from sudo tee / already-root, or `'spawned'` from the
+ * osascript/Windows GUI re-spawn) counts as success. `false` means no
+ * elevation happened and the caller should throw the sudo hint.
+ */
+export declare function elevationHandled(elevated: ElevationResult): boolean;
+/**
+ * Prints a notification when the process is running as root (uid 0),
+ * so the user knows the hosts file will be written directly without
+ * any elevation prompt. Called before the direct writeFileSync in cli.ts.
+ */
+export declare function notifyRootWrite(filePath: string): void;
+export declare function elevatedCommandHint(command?: string): string;
+export declare function withoutElevationArgs(args: string[]): string[];