ctx-sync 1.0.0

package/dist/core/docker-handler.js

@@ -0,0 +1,515 @@
+/**
+ * Docker handler module.
+ *
+ * Detects Docker Compose files, parses their service definitions,
+ * queries Docker for running container state, and saves/loads
+ * encrypted Docker state.
+ *
+ * **Graceful degradation:** If Docker is not installed or compose files
+ * are missing, the module returns empty/null results rather than throwing.
+ *
+ * @module core/docker-handler
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { execSync } from 'node:child_process';
+import { readState, writeState } from './state-manager.js';
+/**
+ * Known Docker Compose file names (in priority order).
+ */
+export const COMPOSE_FILE_NAMES = [
+    'docker-compose.yml',
+    'docker-compose.yaml',
+    'compose.yml',
+    'compose.yaml',
+];
+/**
+ * Detect a Docker Compose file in the given project directory.
+ *
+ * Searches for known compose file names in priority order. Does not
+ * throw if none is found — returns `found: false`.
+ *
+ * @param projectDir - Absolute path to the project directory.
+ * @returns Detection result with file path if found.
+ */
+export function detectDockerCompose(projectDir) {
+    for (const fileName of COMPOSE_FILE_NAMES) {
+        const filePath = path.join(projectDir, fileName);
+        if (fs.existsSync(filePath)) {
+            return {
+                found: true,
+                filePath,
+                fileName,
+            };
+        }
+    }
+    return {
+        found: false,
+        filePath: null,
+        fileName: null,
+    };
+}
+/**
+ * Parse a Docker Compose file and extract service definitions.
+ *
+ * Uses a simple YAML parser (line-based) to extract services, ports,
+ * images, volumes, and networks without requiring a full YAML library.
+ * This handles common compose file patterns.
+ *
+ * @param filePath - Absolute path to the compose file.
+ * @returns Parsed services and networks.
+ * @throws If the file cannot be read.
+ */
+export function parseComposeFile(filePath) {
+    if (!fs.existsSync(filePath)) {
+        throw new Error(`Compose file not found: ${filePath}`);
+    }
+    const content = fs.readFileSync(filePath, 'utf-8');
+    return parseComposeContent(content);
+}
+/**
+ * Parse Docker Compose YAML content.
+ *
+ * Simple line-based parser that handles common compose file patterns.
+ * Extracts service name, image, container_name, ports, volumes,
+ * healthcheck, and top-level networks.
+ *
+ * @param content - The raw YAML content.
+ * @returns Parsed services and networks.
+ */
+export function parseComposeContent(content) {
+    const lines = content.split('\n');
+    const services = [];
+    const networks = [];
+    let inServices = false;
+    let inNetworks = false;
+    let currentService = null;
+    let currentServiceName = null;
+    let inPorts = false;
+    let inVolumes = false;
+    let inHealthcheck = false;
+    let servicesIndent = -1;
+    let serviceIndent = -1;
+    for (const rawLine of lines) {
+        // Skip comments and empty lines
+        const commentIdx = rawLine.indexOf('#');
+        const line = commentIdx >= 0 ? rawLine.slice(0, commentIdx) : rawLine;
+        if (line.trim() === '')
+            continue;
+        const indent = line.length - line.trimStart().length;
+        const trimmed = line.trim();
+        // Top-level section detection
+        if (indent === 0) {
+            // Flush current service before switching sections
+            if (currentService && currentServiceName) {
+                services.push(finalizeService(currentServiceName, currentService));
+                currentService = null;
+                currentServiceName = null;
+            }
+            inPorts = false;
+            inVolumes = false;
+            inHealthcheck = false;
+            if (trimmed === 'services:' || trimmed.startsWith('services:')) {
+                inServices = true;
+                inNetworks = false;
+                servicesIndent = 0;
+                continue;
+            }
+            else if (trimmed === 'networks:' || trimmed.startsWith('networks:')) {
+                inServices = false;
+                inNetworks = true;
+                continue;
+            }
+            else {
+                inServices = false;
+                inNetworks = false;
+                continue;
+            }
+        }
+        // Parse networks section
+        if (inNetworks && indent > 0) {
+            // Network names are keys at the first indent level
+            if (trimmed.endsWith(':') && !trimmed.includes(' ')) {
+                networks.push(trimmed.slice(0, -1));
+            }
+            continue;
+        }
+        // Parse services section
+        if (inServices) {
+            // Detect a new service (one level deeper than 'services:')
+            if (indent > servicesIndent &&
+                (serviceIndent === -1 || indent <= serviceIndent) &&
+                trimmed.endsWith(':') &&
+                !trimmed.includes(' ')) {
+                // Flush previous service
+                if (currentService && currentServiceName) {
+                    services.push(finalizeService(currentServiceName, currentService));
+                }
+                currentServiceName = trimmed.slice(0, -1);
+                currentService = {
+                    volumes: [],
+                };
+                serviceIndent = indent;
+                inPorts = false;
+                inVolumes = false;
+                inHealthcheck = false;
+                continue;
+            }
+            if (!currentService)
+                continue;
+            // Within a service definition
+            if (indent > serviceIndent) {
+                // Check if we're ending a list context
+                if (!trimmed.startsWith('-') && !trimmed.startsWith('#')) {
+                    if (inPorts && !trimmed.startsWith('-')) {
+                        inPorts = false;
+                    }
+                    if (inVolumes && !trimmed.startsWith('-')) {
+                        inVolumes = false;
+                    }
+                }
+                // Parse ports list items
+                if (inPorts && trimmed.startsWith('-')) {
+                    const portMapping = trimmed.slice(1).trim().replace(/['"]/g, '');
+                    const hostPort = parseHostPort(portMapping);
+                    if (hostPort > 0 && !currentService.port) {
+                        currentService.port = hostPort;
+                    }
+                    continue;
+                }
+                // Parse volumes list items
+                if (inVolumes && trimmed.startsWith('-')) {
+                    const volume = trimmed.slice(1).trim().replace(/['"]/g, '');
+                    if (volume) {
+                        currentService.volumes = currentService.volumes ?? [];
+                        currentService.volumes.push(volume);
+                    }
+                    continue;
+                }
+                // Parse healthcheck test
+                if (inHealthcheck) {
+                    if (trimmed.startsWith('test:')) {
+                        const testValue = trimmed.slice(5).trim();
+                        if (testValue) {
+                            // Could be inline array: ["CMD", "pg_isready"] or a string
+                            currentService.healthCheck = parseHealthcheckValue(testValue);
+                        }
+                    }
+                    else if (trimmed.startsWith('-') && !currentService.healthCheck) {
+                        // Array form (multi-line): take the command part (skip CMD or CMD-SHELL)
+                        const item = trimmed.slice(1).trim().replace(/['"]/g, '');
+                        if (item !== 'CMD' && item !== 'CMD-SHELL') {
+                            currentService.healthCheck = item;
+                        }
+                    }
+                    // Stay in healthcheck context until we get to a key at the service indent level
+                    const nextKeyMatch = trimmed.match(/^[a-z_]+:/i);
+                    if (nextKeyMatch &&
+                        !trimmed.startsWith('test:') &&
+                        !trimmed.startsWith('interval:') &&
+                        !trimmed.startsWith('timeout:') &&
+                        !trimmed.startsWith('retries:') &&
+                        !trimmed.startsWith('start_period:')) {
+                        inHealthcheck = false;
+                    }
+                    else {
+                        continue;
+                    }
+                }
+                // Parse key-value pairs
+                if (trimmed.startsWith('image:')) {
+                    currentService.image = cleanYamlValue(trimmed.slice(6));
+                }
+                else if (trimmed.startsWith('container_name:')) {
+                    currentService.container = cleanYamlValue(trimmed.slice(15));
+                }
+                else if (trimmed.startsWith('ports:')) {
+                    inPorts = true;
+                    // Handle inline ports: ["5432:5432"]
+                    const inlineValue = trimmed.slice(6).trim();
+                    if (inlineValue) {
+                        const ports = parseInlineList(inlineValue);
+                        for (const portMapping of ports) {
+                            const hostPort = parseHostPort(portMapping);
+                            if (hostPort > 0 && !currentService.port) {
+                                currentService.port = hostPort;
+                            }
+                        }
+                        inPorts = false;
+                    }
+                }
+                else if (trimmed.startsWith('volumes:')) {
+                    inVolumes = true;
+                    // Handle inline volumes
+                    const inlineValue = trimmed.slice(8).trim();
+                    if (inlineValue) {
+                        const vols = parseInlineList(inlineValue);
+                        currentService.volumes = currentService.volumes ?? [];
+                        currentService.volumes.push(...vols);
+                        inVolumes = false;
+                    }
+                }
+                else if (trimmed.startsWith('healthcheck:')) {
+                    inHealthcheck = true;
+                }
+            }
+        }
+    }
+    // Flush the last service
+    if (currentService && currentServiceName) {
+        services.push(finalizeService(currentServiceName, currentService));
+    }
+    return { services, networks };
+}
+/**
+ * Clean a YAML value: strip quotes and whitespace.
+ */
+function cleanYamlValue(raw) {
+    return raw.trim().replace(/^['"]|['"]$/g, '');
+}
+/**
+ * Parse a healthcheck test value.
+ *
+ * Handles:
+ * - Inline array: `["CMD", "pg_isready"]` → `pg_isready`
+ * - Inline array: `["CMD-SHELL", "curl -f http://localhost:3000/health || exit 1"]` → `curl ...`
+ * - Plain string: `curl -f http://localhost/health || exit 1` → as-is
+ */
+function parseHealthcheckValue(raw) {
+    const trimmed = raw.trim();
+    // Inline array form: ["CMD", "pg_isready"] or ["CMD-SHELL", "..."]
+    if (trimmed.startsWith('[') && trimmed.endsWith(']')) {
+        const items = trimmed
+            .slice(1, -1)
+            .split(',')
+            .map((s) => s.trim().replace(/^['"]|['"]$/g, ''));
+        // Filter out CMD / CMD-SHELL and return the rest joined
+        const commandParts = items.filter((item) => item !== 'CMD' && item !== 'CMD-SHELL');
+        return commandParts.join(' ').trim() || trimmed;
+    }
+    return cleanYamlValue(trimmed);
+}
+/**
+ * Parse an inline YAML list like ["a", "b"] or [a, b].
+ */
+function parseInlineList(raw) {
+    const trimmed = raw.trim();
+    if (trimmed.startsWith('[') && trimmed.endsWith(']')) {
+        return trimmed
+            .slice(1, -1)
+            .split(',')
+            .map((s) => s.trim().replace(/^['"]|['"]$/g, ''))
+            .filter(Boolean);
+    }
+    return [];
+}
+/**
+ * Parse a host port from a port mapping string.
+ *
+ * Handles formats like:
+ * - "5432:5432"
+ * - "5432:5432/tcp"
+ * - "0.0.0.0:5432:5432"
+ * - "8080:80"
+ *
+ * Returns the **host** port (left side).
+ */
+export function parseHostPort(mapping) {
+    const clean = mapping.replace(/\/\w+$/, '').trim(); // Remove /tcp, /udp suffix
+    const parts = clean.split(':');
+    if (parts.length === 0)
+        return 0;
+    // "5432:5432" or "8080:80" → host port is parts[0]
+    // "0.0.0.0:5432:5432" → host port is parts[1]
+    if (parts.length === 3) {
+        return parseInt(parts[1] ?? '0', 10) || 0;
+    }
+    if (parts.length === 2) {
+        return parseInt(parts[0] ?? '0', 10) || 0;
+    }
+    if (parts.length === 1) {
+        return parseInt(parts[0] ?? '0', 10) || 0;
+    }
+    return 0;
+}
+/**
+ * Finalize a partially parsed service into a full ParsedService.
+ */
+function finalizeService(name, partial) {
+    return {
+        name,
+        image: partial.image ?? '',
+        container: partial.container ?? `${name}`,
+        port: partial.port ?? 0,
+        volumes: partial.volumes ?? [],
+        healthCheck: partial.healthCheck,
+    };
+}
+/**
+ * Check if Docker is available on this machine.
+ *
+ * @returns `true` if `docker` CLI is installed and responds to `docker info`.
+ */
+export function isDockerAvailable() {
+    try {
+        execSync('docker info', { stdio: 'pipe', timeout: 5000 });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get running containers for a project directory.
+ *
+ * Uses `docker compose ps` to query running containers related to
+ * the compose file in the given directory.
+ *
+ * @param projectDir - Absolute path to the project directory.
+ * @returns List of running containers, or empty array if Docker is not available.
+ */
+export function getRunningContainers(projectDir) {
+    if (!isDockerAvailable()) {
+        return [];
+    }
+    const compose = detectDockerCompose(projectDir);
+    if (!compose.found) {
+        return [];
+    }
+    try {
+        const output = execSync('docker compose ps --format json', {
+            cwd: projectDir,
+            stdio: ['pipe', 'pipe', 'pipe'],
+            timeout: 10000,
+        }).toString();
+        if (!output.trim()) {
+            return [];
+        }
+        // docker compose ps --format json outputs one JSON object per line
+        const containers = [];
+        for (const line of output.trim().split('\n')) {
+            const trimmedLine = line.trim();
+            if (!trimmedLine)
+                continue;
+            try {
+                const entry = JSON.parse(trimmedLine);
+                containers.push({
+                    id: entry['ID'] ?? '',
+                    name: entry['Name'] ?? '',
+                    image: entry['Image'] ?? '',
+                    status: entry['Status'] ?? '',
+                    ports: entry['Ports'] ?? entry['Publishers'] ?? '',
+                });
+            }
+            catch {
+                // Skip malformed lines
+            }
+        }
+        return containers;
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Build a DockerState entry for a project from its compose file.
+ *
+ * Detects the compose file, parses it, and creates a DockerState entry
+ * suitable for encryption and storage.
+ *
+ * @param projectName - The project name (key in the DockerState map).
+ * @param projectDir - Absolute path to the project directory.
+ * @param autoStartDefault - Default value for autoStart on each service.
+ * @returns The project's Docker state entry, or `null` if no compose file found.
+ */
+export function buildDockerStateEntry(projectName, projectDir, autoStartDefault = true) {
+    const compose = detectDockerCompose(projectDir);
+    if (!compose.found || !compose.filePath) {
+        return null;
+    }
+    const parsed = parseComposeFile(compose.filePath);
+    const services = parsed.services.map((svc) => ({
+        name: svc.name,
+        container: svc.container,
+        image: svc.image,
+        port: svc.port,
+        volumes: svc.volumes.length > 0 ? svc.volumes : undefined,
+        autoStart: autoStartDefault,
+        healthCheck: svc.healthCheck,
+    }));
+    return {
+        composeFile: compose.filePath,
+        services,
+        networks: parsed.networks.length > 0 ? parsed.networks : undefined,
+        lastStarted: undefined,
+    };
+}
+/**
+ * Save Docker state for a project to encrypted storage.
+ *
+ * Reads existing Docker state, merges the new project entry, and
+ * writes the updated state to `docker-state.age`.
+ *
+ * @param syncDir - The sync directory path.
+ * @param projectName - The project name (key in DockerState).
+ * @param entry - The Docker state entry for the project.
+ * @param publicKey - The Age public key for encryption.
+ * @param privateKey - The Age private key for reading existing state.
+ */
+export async function saveDockerState(syncDir, projectName, entry, publicKey, privateKey) {
+    // Read existing state
+    const existing = await readState(syncDir, privateKey, 'docker-state');
+    const dockerState = existing ?? {};
+    // Merge the new entry
+    dockerState[projectName] = entry;
+    // Write encrypted state
+    await writeState(syncDir, dockerState, publicKey, 'docker-state');
+}
+/**
+ * Load Docker state for a specific project from encrypted storage.
+ *
+ * @param syncDir - The sync directory path.
+ * @param projectName - The project name.
+ * @param privateKey - The Age private key for decryption.
+ * @returns The project's Docker state, or `null` if not found.
+ */
+export async function loadDockerState(syncDir, projectName, privateKey) {
+    const dockerState = await readState(syncDir, privateKey, 'docker-state');
+    if (!dockerState)
+        return null;
+    return dockerState[projectName] ?? null;
+}
+/**
+ * Load all Docker state from encrypted storage.
+ *
+ * @param syncDir - The sync directory path.
+ * @param privateKey - The Age private key for decryption.
+ * @returns Full Docker state, or `null` if no docker-state.age exists.
+ */
+export async function loadAllDockerState(syncDir, privateKey) {
+    return readState(syncDir, privateKey, 'docker-state');
+}
+/**
+ * Remove Docker state for a project from encrypted storage.
+ *
+ * @param syncDir - The sync directory path.
+ * @param projectName - The project name to remove.
+ * @param publicKey - The Age public key for re-encryption.
+ * @param privateKey - The Age private key for decryption.
+ * @returns `true` if the project was found and removed.
+ */
+export async function removeDockerState(syncDir, projectName, publicKey, privateKey) {
+    const dockerState = await readState(syncDir, privateKey, 'docker-state');
+    if (!dockerState || !(projectName in dockerState)) {
+        return false;
+    }
+    const updated = {};
+    for (const [key, value] of Object.entries(dockerState)) {
+        if (key !== projectName) {
+            updated[key] = value;
+        }
+    }
+    await writeState(syncDir, updated, publicKey, 'docker-state');
+    return true;
+}
+//# sourceMappingURL=docker-handler.js.map

package/dist/core/docker-handler.js.map

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

package/dist/core/encryption.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Age encryption wrapper module.
+ *
+ * Provides key generation, encryption, and decryption operations
+ * using the Age encryption library. All operations are in-memory only —
+ * no temporary files are created during crypto operations.
+ *
+ * @module core/encryption
+ */
+/**
+ * Generate a new Age key pair.
+ *
+ * @returns Object containing the public key (age1...) and private key (AGE-SECRET-KEY-...).
+ */
+export declare function generateKey(): Promise<{
+    publicKey: string;
+    privateKey: string;
+}>;
+/**
+ * Encrypt a plaintext string with an Age public key.
+ *
+ * @param plaintext - The string to encrypt.
+ * @param publicKey - The Age public key (age1...) to encrypt for.
+ * @returns ASCII-armored Age ciphertext.
+ * @throws If the public key is invalid.
+ */
+export declare function encrypt(plaintext: string, publicKey: string): Promise<string>;
+/**
+ * Decrypt an ASCII-armored Age ciphertext with a private key.
+ *
+ * @param ciphertext - The ASCII-armored Age ciphertext.
+ * @param privateKey - The Age private key (AGE-SECRET-KEY-...).
+ * @returns The decrypted plaintext string.
+ * @throws If the private key cannot decrypt the ciphertext.
+ */
+export declare function decrypt(ciphertext: string, privateKey: string): Promise<string>;
+/**
+ * Encrypt a typed data object as JSON into an Age ciphertext blob.
+ * The data is serialised to JSON in memory, then encrypted.
+ * No plaintext JSON is ever written to disk.
+ *
+ * @param data - The data to encrypt.
+ * @param publicKey - The Age public key to encrypt for.
+ * @returns ASCII-armored Age ciphertext containing the serialised JSON.
+ */
+export declare function encryptState<T>(data: T, publicKey: string): Promise<string>;
+/**
+ * Decrypt an Age ciphertext blob and parse the JSON back into a typed object.
+ *
+ * @param ciphertext - The ASCII-armored Age ciphertext.
+ * @param privateKey - The Age private key.
+ * @returns The decrypted and parsed data.
+ * @throws If decryption fails or the JSON is invalid.
+ */
+export declare function decryptState<T>(ciphertext: string, privateKey: string): Promise<T>;
+/**
+ * Encrypt a plaintext string for multiple Age recipients.
+ *
+ * All recipients can independently decrypt the resulting ciphertext
+ * using their own private key. This enables team/multi-machine support.
+ *
+ * @param plaintext - The string to encrypt.
+ * @param publicKeys - Array of Age public keys (age1...) to encrypt for.
+ * @returns ASCII-armored Age ciphertext.
+ * @throws If any public key is invalid or the array is empty.
+ */
+export declare function encryptForRecipients(plaintext: string, publicKeys: string[]): Promise<string>;
+/**
+ * Encrypt a typed data object as JSON for multiple Age recipients.
+ *
+ * Serialises the data to JSON in memory, then encrypts for all recipients.
+ * No plaintext JSON is ever written to disk.
+ *
+ * @param data - The data to encrypt.
+ * @param publicKeys - Array of Age public keys to encrypt for.
+ * @returns ASCII-armored Age ciphertext containing the serialised JSON.
+ */
+export declare function encryptStateForRecipients<T>(data: T, publicKeys: string[]): Promise<string>;
+//# sourceMappingURL=encryption.d.ts.map

package/dist/core/encryption.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encryption.d.ts","sourceRoot":"","sources":["../../src/core/encryption.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH;;;;GAIG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAItF;AAED;;;;;;;GAOG;AACH,wBAAsB,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAKnF;AAED;;;;;;;GAOG;AACH,wBAAsB,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAKrF;AAED;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGjF;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAGxF;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC,MAAM,CAAC,CAWjB;AAED;;;;;;;;;GASG;AACH,wBAAsB,yBAAyB,CAAC,CAAC,EAC/C,IAAI,EAAE,CAAC,EACP,UAAU,EAAE,MAAM,EAAE,GACnB,OAAO,CAAC,MAAM,CAAC,CAGjB"}