latchkey 0.1.0

package/dist/src/browserConfig.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Browser discovery and configuration management for Latchkey.
+ *
+ * This module handles:
+ * - Discovering system-installed Chrome/Chromium browsers
+ * - Finding Playwright's bundled Chromium
+ * - Downloading Chromium via Playwright when needed
+ * - Persisting the discovered browser path
+ */
+import { z } from 'zod';
+/**
+ * Schema for the browser configuration file.
+ */
+declare const BrowserConfigSchema: z.ZodObject<{
+    executablePath: z.ZodString;
+    source: z.ZodEnum<["system", "playwright", "downloaded"]>;
+    discoveredAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    executablePath: string;
+    source: "system" | "playwright" | "downloaded";
+    discoveredAt: string;
+}, {
+    executablePath: string;
+    source: "system" | "playwright" | "downloaded";
+    discoveredAt: string;
+}>;
+export type BrowserConfig = z.infer<typeof BrowserConfigSchema>;
+export declare class BrowserNotFoundError extends Error {
+    constructor(message: string);
+}
+export declare class BrowserConfigError extends Error {
+    constructor(message: string);
+}
+/**
+ * Get the default path for the browser configuration file.
+ */
+export declare function getDefaultBrowserConfigPath(): string;
+/**
+ * Find a system-installed Chrome/Chromium browser.
+ * Returns the path to the executable if found, null otherwise.
+ */
+export declare function findSystemBrowser(): string | null;
+/**
+ * Find Chrome/Chromium installed by Playwright.
+ * Returns the path to the executable if found, null otherwise.
+ */
+export declare function findPlaywrightBrowser(): Promise<string | null>;
+/**
+ * Download Chromium using Playwright's browser installation mechanism.
+ * Returns the path to the downloaded executable.
+ */
+export declare function downloadPlaywrightBrowser(): Promise<string>;
+/**
+ * Options for browser discovery.
+ */
+export interface DiscoverBrowserOptions {
+    /** Skip discovery of system-installed browsers. Default: false */
+    skipSystemBrowser?: boolean;
+}
+/**
+ * Discover a Chrome/Chromium browser using the following priority:
+ * 1. System-installed browser (unless skipSystemBrowser is true)
+ * 2. Playwright's bundled browser
+ * 3. Download via Playwright
+ *
+ * Returns the browser configuration with the discovered path.
+ */
+export declare function discoverBrowser(options?: DiscoverBrowserOptions): Promise<BrowserConfig>;
+/**
+ * Save browser configuration to disk.
+ */
+export declare function saveBrowserConfig(configPath: string, config: BrowserConfig): void;
+/**
+ * Load browser configuration from disk.
+ * Returns null if the file doesn't exist or is invalid.
+ */
+export declare function loadBrowserConfig(configPath: string): BrowserConfig | null;
+/**
+ * Ensure a browser is available and return its configuration.
+ * If a valid configuration exists, it is returned.
+ * Otherwise, a new browser is discovered and the configuration is saved.
+ */
+export declare function ensureBrowser(configPath?: string, options?: DiscoverBrowserOptions): Promise<BrowserConfig>;
+/**
+ * Get the browser executable path from the stored configuration.
+ * Returns null if no valid configuration exists.
+ */
+export declare function getBrowserExecutablePath(configPath?: string): string | null;
+export {};
+//# sourceMappingURL=browserConfig.d.ts.map

package/dist/src/browserConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browserConfig.d.ts","sourceRoot":"","sources":["../../src/browserConfig.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,QAAA,MAAM,mBAAmB;;;;;;;;;;;;EAIvB,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,kBAAmB,SAAQ,KAAK;gBAC/B,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,MAAM,CAEpD;AAoED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,GAAG,IAAI,CA2BjD;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAYpE;AAED;;;GAGG;AACH,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,MAAM,CAAC,CAejE;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,kEAAkE;IAClE,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,OAAO,CAAC,aAAa,CAAC,CAiClG;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI,CAQjF;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAmB1E;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,UAAU,GAAE,MAAsC,EAClD,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,aAAa,CAAC,CAWxB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,GAAE,MAAsC,GACjD,MAAM,GAAG,IAAI,CAGf"}

package/dist/src/browserConfig.js

@@ -0,0 +1,259 @@
+/**
+ * Browser discovery and configuration management for Latchkey.
+ *
+ * This module handles:
+ * - Discovering system-installed Chrome/Chromium browsers
+ * - Finding Playwright's bundled Chromium
+ * - Downloading Chromium via Playwright when needed
+ * - Persisting the discovered browser path
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir, platform } from 'node:os';
+import { dirname, join } from 'node:path';
+import { z } from 'zod';
+import { LATCHKEY_SKIP_SYSTEM_BROWSER_ENV_VAR } from './config.js';
+/**
+ * Schema for the browser configuration file.
+ */
+const BrowserConfigSchema = z.object({
+    executablePath: z.string(),
+    source: z.enum(['system', 'playwright', 'downloaded']),
+    discoveredAt: z.string().datetime(),
+});
+export class BrowserNotFoundError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'BrowserNotFoundError';
+    }
+}
+export class BrowserConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'BrowserConfigError';
+    }
+}
+/**
+ * Get the default path for the browser configuration file.
+ */
+export function getDefaultBrowserConfigPath() {
+    return join(homedir(), '.latchkey', 'browser.json');
+}
+/**
+ * System Chrome/Chromium installation paths by platform.
+ * These are the standard locations where browsers are installed.
+ */
+const SYSTEM_CHROME_PATHS = {
+    darwin: [
+        '/Applications/Google Chrome.app/Contents/MacOS/Google Chrome',
+        '/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary',
+        '/Applications/Chromium.app/Contents/MacOS/Chromium',
+        '/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge',
+    ],
+    linux: [
+        '/opt/google/chrome/chrome',
+        '/opt/google/chrome-beta/chrome',
+        '/opt/google/chrome-unstable/chrome',
+        '/usr/bin/google-chrome',
+        '/usr/bin/google-chrome-stable',
+        '/usr/bin/chromium',
+        '/usr/bin/chromium-browser',
+        '/opt/microsoft/msedge/msedge',
+    ],
+    win32: [
+        // These are relative paths that will be joined with common Windows prefixes
+        '\\Google\\Chrome\\Application\\chrome.exe',
+        '\\Google\\Chrome Beta\\Application\\chrome.exe',
+        '\\Google\\Chrome SxS\\Application\\chrome.exe',
+        '\\Chromium\\Application\\chrome.exe',
+        '\\Microsoft\\Edge\\Application\\msedge.exe',
+    ],
+};
+/**
+ * Get Windows path prefixes from environment variables.
+ */
+function getWindowsPrefixes() {
+    const prefixes = [];
+    const env = process.env;
+    if (env.LOCALAPPDATA) {
+        prefixes.push(env.LOCALAPPDATA);
+    }
+    if (env.PROGRAMFILES) {
+        prefixes.push(env.PROGRAMFILES);
+    }
+    if (env['PROGRAMFILES(X86)']) {
+        prefixes.push(env['PROGRAMFILES(X86)']);
+    }
+    if (env.HOMEDRIVE) {
+        prefixes.push(join(env.HOMEDRIVE, 'Program Files'));
+        prefixes.push(join(env.HOMEDRIVE, 'Program Files (x86)'));
+    }
+    return prefixes;
+}
+/**
+ * Check if a file exists and is accessible.
+ */
+function canAccessFile(filePath) {
+    try {
+        return existsSync(filePath);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Find a system-installed Chrome/Chromium browser.
+ * Returns the path to the executable if found, null otherwise.
+ */
+export function findSystemBrowser() {
+    const currentPlatform = platform();
+    const paths = SYSTEM_CHROME_PATHS[currentPlatform];
+    if (!paths) {
+        return null;
+    }
+    if (currentPlatform === 'win32') {
+        const prefixes = getWindowsPrefixes();
+        for (const prefix of prefixes) {
+            for (const suffix of paths) {
+                const fullPath = join(prefix, suffix);
+                if (canAccessFile(fullPath)) {
+                    return fullPath;
+                }
+            }
+        }
+    }
+    else {
+        for (const path of paths) {
+            if (canAccessFile(path)) {
+                return path;
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Find Chrome/Chromium installed by Playwright.
+ * Returns the path to the executable if found, null otherwise.
+ */
+export async function findPlaywrightBrowser() {
+    try {
+        const { chromium } = await import('playwright');
+        const executablePath = chromium.executablePath();
+        if (executablePath && canAccessFile(executablePath)) {
+            return executablePath;
+        }
+    }
+    catch {
+        // Playwright not available or browser not installed
+    }
+    return null;
+}
+/**
+ * Download Chromium using Playwright's browser installation mechanism.
+ * Returns the path to the downloaded executable.
+ */
+export async function downloadPlaywrightBrowser() {
+    const { installBrowsersForNpmInstall } = await import('playwright-core/lib/server/registry/index');
+    await installBrowsersForNpmInstall(['chromium']);
+    // After installation, get the path
+    const browserPath = await findPlaywrightBrowser();
+    if (!browserPath) {
+        throw new BrowserNotFoundError('Failed to locate Chromium after download. The installation may have failed.');
+    }
+    return browserPath;
+}
+/**
+ * Discover a Chrome/Chromium browser using the following priority:
+ * 1. System-installed browser (unless skipSystemBrowser is true)
+ * 2. Playwright's bundled browser
+ * 3. Download via Playwright
+ *
+ * Returns the browser configuration with the discovered path.
+ */
+export async function discoverBrowser(options = {}) {
+    const skipSystem = options.skipSystemBrowser ?? process.env[LATCHKEY_SKIP_SYSTEM_BROWSER_ENV_VAR] === '1';
+    // 1. Try system browser first (unless skipped)
+    if (!skipSystem) {
+        const systemPath = findSystemBrowser();
+        if (systemPath) {
+            return {
+                executablePath: systemPath,
+                source: 'system',
+                discoveredAt: new Date().toISOString(),
+            };
+        }
+    }
+    // 2. Try Playwright's bundled browser
+    const playwrightPath = await findPlaywrightBrowser();
+    if (playwrightPath) {
+        return {
+            executablePath: playwrightPath,
+            source: 'playwright',
+            discoveredAt: new Date().toISOString(),
+        };
+    }
+    // 3. Download via Playwright
+    const downloadedPath = await downloadPlaywrightBrowser();
+    return {
+        executablePath: downloadedPath,
+        source: 'downloaded',
+        discoveredAt: new Date().toISOString(),
+    };
+}
+/**
+ * Save browser configuration to disk.
+ */
+export function saveBrowserConfig(configPath, config) {
+    const directory = dirname(configPath);
+    if (!existsSync(directory)) {
+        mkdirSync(directory, { recursive: true, mode: 0o700 });
+    }
+    const content = JSON.stringify(config, null, 2);
+    writeFileSync(configPath, content, { encoding: 'utf-8', mode: 0o600 });
+}
+/**
+ * Load browser configuration from disk.
+ * Returns null if the file doesn't exist or is invalid.
+ */
+export function loadBrowserConfig(configPath) {
+    if (!existsSync(configPath)) {
+        return null;
+    }
+    try {
+        const content = readFileSync(configPath, 'utf-8');
+        const data = JSON.parse(content);
+        const config = BrowserConfigSchema.parse(data);
+        // Verify the browser still exists
+        if (!canAccessFile(config.executablePath)) {
+            return null;
+        }
+        return config;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Ensure a browser is available and return its configuration.
+ * If a valid configuration exists, it is returned.
+ * Otherwise, a new browser is discovered and the configuration is saved.
+ */
+export async function ensureBrowser(configPath = getDefaultBrowserConfigPath(), options = {}) {
+    // Try to load existing configuration
+    const existingConfig = loadBrowserConfig(configPath);
+    if (existingConfig) {
+        return existingConfig;
+    }
+    // Discover and save new configuration
+    const config = await discoverBrowser(options);
+    saveBrowserConfig(configPath, config);
+    return config;
+}
+/**
+ * Get the browser executable path from the stored configuration.
+ * Returns null if no valid configuration exists.
+ */
+export function getBrowserExecutablePath(configPath = getDefaultBrowserConfigPath()) {
+    const config = loadBrowserConfig(configPath);
+    return config?.executablePath ?? null;
+}
+//# sourceMappingURL=browserConfig.js.map

package/dist/src/browserConfig.js.map

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

package/dist/src/browserState.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Browser state management utilities.
+ */
+/**
+ * Get the browser state path from the LATCHKEY_BROWSER_STATE environment variable.
+ */
+export declare function getBrowserStatePath(): string | null;
+//# sourceMappingURL=browserState.d.ts.map

package/dist/src/browserState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browserState.d.ts","sourceRoot":"","sources":["../../src/browserState.ts"],"names":[],"mappings":"AAAA;;GAEG;AAOH;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,IAAI,CAUnD"}

package/dist/src/browserState.js

@@ -0,0 +1,21 @@
+/**
+ * Browser state management utilities.
+ */
+import { homedir } from 'node:os';
+import { resolve } from 'node:path';
+const LATCHKEY_BROWSER_STATE_ENV_VAR = 'LATCHKEY_BROWSER_STATE';
+/**
+ * Get the browser state path from the LATCHKEY_BROWSER_STATE environment variable.
+ */
+export function getBrowserStatePath() {
+    const envValue = process.env[LATCHKEY_BROWSER_STATE_ENV_VAR];
+    if (envValue) {
+        // Expand ~ to home directory
+        if (envValue.startsWith('~')) {
+            return resolve(homedir(), envValue.slice(2));
+        }
+        return resolve(envValue);
+    }
+    return null;
+}
+//# sourceMappingURL=browserState.js.map

package/dist/src/browserState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browserState.js","sourceRoot":"","sources":["../../src/browserState.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,8BAA8B,GAAG,wBAAwB,CAAC;AAEhE;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,CAAC;IAC7D,IAAI,QAAQ,EAAE,CAAC;QACb,6BAA6B;QAC7B,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7B,OAAO,OAAO,CAAC,OAAO,EAAE,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/src/cli.d.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+/**
+ * Command-line interface entry point for latchkey.
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/src/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":";AAEA;;GAEG"}

package/dist/src/cli.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+/**
+ * Command-line interface entry point for latchkey.
+ */
+import { program } from 'commander';
+import { registerCommands, createDefaultDependencies } from './cliCommands.js';
+import { InsecureFilePermissionsError } from './config.js';
+const deps = createDefaultDependencies();
+try {
+    deps.config.checkSensitiveFilePermissions();
+}
+catch (error) {
+    if (error instanceof InsecureFilePermissionsError) {
+        console.error(`Error: ${error.message}`);
+        process.exit(1);
+    }
+    throw error;
+}
+program
+    .name('latchkey')
+    .description('A command-line tool that injects API credentials to curl requests to known public APIs.')
+    .version('0.1.0');
+registerCommands(program, deps);
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/src/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":";AAEA;;GAEG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAE3D,MAAM,IAAI,GAAG,yBAAyB,EAAE,CAAC;AAEzC,IAAI,CAAC;IACH,IAAI,CAAC,MAAM,CAAC,6BAA6B,EAAE,CAAC;AAC9C,CAAC;AAAC,OAAO,KAAK,EAAE,CAAC;IACf,IAAI,KAAK,YAAY,4BAA4B,EAAE,CAAC;QAClD,OAAO,CAAC,KAAK,CAAC,UAAU,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACzC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,KAAK,CAAC;AACd,CAAC;AAED,OAAO;KACJ,IAAI,CAAC,UAAU,CAAC;KAChB,WAAW,CACV,yFAAyF,CAC1F;KACA,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,gBAAgB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AAEhC,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/src/cliCommands.d.ts

@@ -0,0 +1,29 @@
+/**
+ * CLI command implementations with dependency injection for testability.
+ */
+import type { Command } from 'commander';
+import { Config } from './config.js';
+import type { CurlResult } from './curl.js';
+import { Registry } from './registry.js';
+/**
+ * Dependencies that can be injected for testing.
+ */
+export interface CliDependencies {
+    readonly registry: Registry;
+    readonly config: Config;
+    readonly runCurl: (args: readonly string[]) => CurlResult;
+    readonly confirm: (message: string) => Promise<boolean>;
+    readonly exit: (code: number) => never;
+    readonly log: (message: string) => void;
+    readonly errorLog: (message: string) => void;
+}
+/**
+ * Default implementation of CLI dependencies.
+ */
+export declare function createDefaultDependencies(): CliDependencies;
+export declare function extractUrlFromCurlArguments(args: string[]): string | null;
+/**
+ * Register all CLI commands on the given program.
+ */
+export declare function registerCommands(program: Command, deps: CliDependencies): void;
+//# sourceMappingURL=cliCommands.d.ts.map

package/dist/src/cliCommands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cliCommands.d.ts","sourceRoot":"","sources":["../../src/cliCommands.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,OAAO,EAAE,MAAM,EAAU,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,OAAO,EAAE,QAAQ,EAAY,MAAM,eAAe,CAAC;AAOnD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,KAAK,UAAU,CAAC;IAC1D,QAAQ,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACxD,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC;IACvC,QAAQ,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,eAAe,CAc3D;AAMD,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAyBzE;AAsFD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,eAAe,GAAG,IAAI,CAuJ9E"}