@lon-ask/dockit 0.1.0 → 0.1.2

package/apps/server/dist/services/configLoader.js

@@ -0,0 +1,150 @@
+import fs from 'node:fs';
+import { load as loadYaml } from 'js-yaml';
+export function loadConfig(configPath) {
+    if (!fs.existsSync(configPath)) {
+        throw new Error(`Config file not found: ${configPath}. Create a dockit.yaml file with your entries and sources.`);
+    }
+    const content = fs.readFileSync(configPath, 'utf-8');
+    const config = loadYaml(content);
+    if (!config.entries || !Array.isArray(config.entries) || config.entries.length === 0) {
+        throw new Error('Config file must contain at least one entry under "entries:"');
+    }
+    for (const entry of config.entries) {
+        if (!entry.id || !entry.name || !entry.version) {
+            throw new Error(`Entry missing required fields (id/name/version): ${JSON.stringify(entry)}`);
+        }
+        if (!entry.sources || entry.sources.length === 0) {
+            throw new Error(`Entry "${entry.id}" has no sources`);
+        }
+        for (const source of entry.sources) {
+            if (!source.type || !source.label) {
+                throw new Error(`Source in entry "${entry.id}" missing type or label`);
+            }
+            validateSourceConfig(source);
+        }
+    }
+    return config;
+}
+function validateSourceConfig(source) {
+    switch (source.type) {
+        case 'zip':
+            if (!source.url && !source.localPath) {
+                throw new Error(`ZIP source "${source.label}" requires "url" or "localPath"`);
+            }
+            break;
+        case 'maven':
+            if (!source.groupId || !source.artifactId || !source.version) {
+                throw new Error(`Maven source "${source.label}" requires groupId, artifactId, and version`);
+            }
+            break;
+        case 'antora':
+            if (!source.repoUrl && !source.zipPath && !source.localPath) {
+                throw new Error(`Antora source "${source.label}" requires repoUrl, localPath, or zipPath`);
+            }
+            break;
+        case 'asciidoc':
+            if (!source.repoUrl && !source.zipPath && !source.localPath) {
+                throw new Error(`AsciiDoc source "${source.label}" requires repoUrl, localPath, or zipPath`);
+            }
+            break;
+        case 'github-markdown':
+            if (!source.repoUrl && !source.localPath) {
+                throw new Error(`GitHub Markdown source "${source.label}" requires repoUrl or localPath`);
+            }
+            break;
+        case 'source-code':
+            if (!source.repoUrl && !source.localPath && !source.zipPath) {
+                throw new Error(`Source code source "${source.label}" requires repoUrl, localPath, or zipPath`);
+            }
+            break;
+        default:
+            throw new Error(`Unknown source type: "${source.type}" in source "${source.label}"`);
+    }
+}
+export async function syncConfigToDb(config, entryRepo, sourceRepo) {
+    const entryIds = [];
+    for (const entryConfig of config.entries) {
+        // Preserve existing status if entry already exists
+        const existing = await entryRepo.findById(entryConfig.id);
+        const now = new Date().toISOString();
+        const created_at = existing?.created_at ?? now;
+        await entryRepo.save({
+            id: entryConfig.id,
+            name: entryConfig.name,
+            version: entryConfig.version,
+            description: entryConfig.description || '',
+            status: existing?.status ?? 'pending',
+            created_at,
+            updated_at: now,
+        });
+        entryIds.push(entryConfig.id);
+        for (const sourceConfig of entryConfig.sources) {
+            const config = buildSourceConfig(sourceConfig);
+            const sourceId = `${entryConfig.id}-src-${sourceConfig.label.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '')}`;
+            // Preserve existing source status if it already exists
+            const existingSource = await sourceRepo.findById(sourceId);
+            await sourceRepo.save({
+                id: sourceId,
+                entry_id: entryConfig.id,
+                type: sourceConfig.type,
+                label: sourceConfig.label,
+                config,
+                status: existingSource?.status ?? 'pending',
+                created_at: existingSource?.created_at ?? now,
+            });
+        }
+    }
+    return entryIds;
+}
+function buildSourceConfig(source) {
+    switch (source.type) {
+        case 'zip':
+            return { url: source.url, localPath: source.localPath };
+        case 'maven':
+            return {
+                groupId: source.groupId,
+                artifactId: source.artifactId,
+                version: source.version,
+                classifier: source.classifier || 'javadoc',
+                useMavenCommand: source.useMavenCommand,
+                localJar: source.localJar,
+            };
+        case 'antora':
+            return {
+                repoUrl: source.repoUrl,
+                zipPath: source.zipPath,
+                localPath: source.localPath,
+                playbookOverrides: source.playbookOverrides,
+                graphifyEnabled: source.graphifyEnabled,
+                graphifySourcePath: source.graphifySourcePath,
+            };
+        case 'asciidoc':
+            return {
+                repoUrl: source.repoUrl,
+                zipPath: source.zipPath,
+                localPath: source.localPath,
+                sourcePath: source.sourcePath,
+                graphifyEnabled: source.graphifyEnabled,
+                graphifySourcePath: source.graphifySourcePath,
+            };
+        case 'github-markdown':
+            return {
+                repoUrl: source.repoUrl,
+                localPath: source.localPath,
+                sourcePath: source.sourcePath,
+                branch: source.branch,
+                graphifyEnabled: source.graphifyEnabled,
+                graphifySourcePath: source.graphifySourcePath,
+            };
+        case 'source-code':
+            return {
+                repoUrl: source.repoUrl,
+                localPath: source.localPath,
+                zipPath: source.zipPath,
+                sourcePath: source.sourcePath,
+                branch: source.branch,
+                graphifySourcePath: source.graphifySourcePath,
+            };
+    }
+}
+//# sourceMappingURL=configLoader.js.map

package/apps/server/dist/services/configLoader.js.map

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

package/apps/server/dist/services/githubMarkdown.js

@@ -0,0 +1,221 @@
+import path from 'node:path';
+import fs from 'node:fs';
+import os from 'node:os';
+import { spawn } from 'node:child_process';
+import { marked } from 'marked';
+const SKIP_DIRS = new Set([
+    'node_modules', 'target', 'build', 'dist', '.git',
+    'test', 'tests', 'tcks', '__tests__', 'fixtures',
+]);
+async function cloneRepo(repoUrl, targetDir, branch, log) {
+    const branchArg = branch ? ['--branch', branch] : [];
+    log(`Cloning repository ${repoUrl}${branch ? ` (branch: ${branch})` : ''}`);
+    if (fs.existsSync(targetDir))
+        fs.rmSync(targetDir, { recursive: true, force: true });
+    return new Promise((resolve, reject) => {
+        const proc = spawn('git', ['clone', '--depth', '1', ...branchArg, repoUrl, targetDir], {
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        let stderr = '';
+        proc.stderr?.on('data', (data) => {
+            stderr += data.toString();
+            const lines = data.toString().trim().split('\n');
+            for (const line of lines) {
+                if (line)
+                    log(`  git: ${line}`);
+            }
+        });
+        proc.on('close', (code) => {
+            if (code === 0) {
+                log('Repository cloned successfully');
+                resolve();
+            }
+            else {
+                reject(new Error(`git clone failed with code ${code}: ${stderr}`));
+            }
+        });
+        proc.on('error', reject);
+    });
+}
+function findMarkdownFiles(dir, sourcePath) {
+    const root = sourcePath ? path.join(dir, sourcePath) : dir;
+    if (!fs.existsSync(root)) {
+        return [];
+    }
+    const results = [];
+    const stack = [root];
+    while (stack.length > 0) {
+        const current = stack.pop();
+        let entries;
+        try {
+            entries = fs.readdirSync(current, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const entry of entries) {
+            if (entry.name.startsWith('.') || SKIP_DIRS.has(entry.name))
+                continue;
+            const fullPath = path.join(current, entry.name);
+            if (entry.isDirectory()) {
+                stack.push(fullPath);
+            }
+            else if (entry.name.endsWith('.md')) {
+                results.push(fullPath);
+            }
+        }
+    }
+    return results;
+}
+function stripFrontmatter(content) {
+    if (content.startsWith('---')) {
+        const end = content.indexOf('---', 3);
+        if (end !== -1) {
+            return content.slice(end + 3).trimStart();
+        }
+    }
+    return content;
+}
+function buildHtmlTemplate(title, bodyHtml, relPath) {
+    return `<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="UTF-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>${escapeHtml(title)}</title>
+<style>
+body{font-family:system-ui,-apple-system,sans-serif;line-height:1.6;max-width:900px;margin:40px auto;padding:0 20px;color:#333}
+pre{background:#f5f5f5;padding:12px;border-radius:6px;overflow-x:auto}
+code{font-family:monospace;background:#f5f5f5;padding:2px 6px;border-radius:3px;font-size:.9em}
+pre code{padding:0;background:none}
+table{border-collapse:collapse;width:100%}
+th,td{border:1px solid #ddd;padding:8px;text-align:left}
+th{background:#f5f5f5}
+img{max-width:100%}
+blockquote{border-left:4px solid #ddd;margin:0;padding-left:16px;color:#666}
+h1,h2,h3,h4,h5,h6{margin-top:1.5em;margin-bottom:.5em}
+a{color:#0366d6}
+</style>
+</head>
+<body>
+<main>
+${bodyHtml}
+</main>
+</body>
+</html>`;
+}
+function escapeHtml(text) {
+    return text
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;');
+}
+async function convertMarkdownFiles(mdFiles, sourceRoot, targetDir, log) {
+    log(`Converting ${mdFiles.length} .md files to HTML`);
+    let filesProcessed = 0;
+    let filesSkipped = 0;
+    for (const mdFile of mdFiles) {
+        try {
+            const relPath = path.relative(sourceRoot, mdFile);
+            const outPath = path.join(targetDir, relPath.replace(/\.md$/i, '.html'));
+            fs.mkdirSync(path.dirname(outPath), { recursive: true });
+            const raw = fs.readFileSync(mdFile, 'utf-8');
+            const withoutFrontmatter = stripFrontmatter(raw);
+            const bodyHtml = await marked(withoutFrontmatter);
+            const title = path.basename(mdFile, '.md');
+            const fullHtml = buildHtmlTemplate(title, bodyHtml, relPath);
+            fs.writeFileSync(outPath, fullHtml, 'utf-8');
+            filesProcessed++;
+        }
+        catch (err) {
+            const rel = path.relative(sourceRoot, mdFile);
+            log(`  WARNING: Failed to convert ${rel}: ${err.message || err}`);
+            filesSkipped++;
+        }
+    }
+    const htmlCount = countHtmlFiles(targetDir);
+    log(`Markdown conversion complete: ${filesProcessed} converted, ${filesSkipped} skipped, ${htmlCount} HTML files generated`);
+    if (htmlCount === 0 && filesProcessed === 0) {
+        throw new Error('Markdown conversion failed to produce any HTML. Check that the source files are valid.');
+    }
+}
+function countHtmlFiles(dir) {
+    if (!fs.existsSync(dir))
+        return 0;
+    let count = 0;
+    const stack = [dir];
+    while (stack.length > 0) {
+        const current = stack.pop();
+        let entries;
+        try {
+            entries = fs.readdirSync(current, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const e of entries) {
+            const p = path.join(current, e.name);
+            if (e.isDirectory() && !e.name.startsWith('.'))
+                stack.push(p);
+            else if (e.name.endsWith('.html'))
+                count++;
+        }
+    }
+    return count;
+}
+function rmDir(dir) {
+    try {
+        fs.rmSync(dir, { recursive: true, force: true });
+    }
+    catch {
+        // best-effort cleanup
+    }
+}
+export async function buildGithubMarkdownSource(config, targetDir, log) {
+    let repoDir;
+    let shouldCleanup;
+    if (config.localPath) {
+        if (!fs.existsSync(config.localPath)) {
+            throw new Error(`Local path not found: ${config.localPath}`);
+        }
+        if (!fs.statSync(config.localPath).isDirectory()) {
+            throw new Error(`localPath must be a directory: ${config.localPath}`);
+        }
+        log(`Using local directory: ${config.localPath}`);
+        repoDir = config.localPath;
+        shouldCleanup = false;
+    }
+    else if (config.repoUrl) {
+        repoDir = path.join(os.tmpdir(), `dockit-github-md-${Date.now()}`);
+        await cloneRepo(config.repoUrl, repoDir, config.branch, log);
+        shouldCleanup = true;
+    }
+    else {
+        throw new Error('GitHub Markdown source requires repoUrl or localPath');
+    }
+    try {
+        const sourcePath = config.sourcePath || '';
+        const sourceRoot = sourcePath ? path.join(repoDir, sourcePath) : repoDir;
+        log(`Scanning for .md files in ${sourcePath || 'repository root'}`);
+        const mdFiles = findMarkdownFiles(repoDir, sourcePath);
+        if (mdFiles.length === 0) {
+            if (sourcePath) {
+                throw new Error(`No .md files found at path "${sourcePath}" in the repository`);
+            }
+            throw new Error(`No .md files found in the repository. ` +
+                `If the docs live in a subdirectory, set the "sourcePath" field ` +
+                `(e.g. "src/content" for React docs).`);
+        }
+        log(`Found ${mdFiles.length} .md file(s)`);
+        fs.mkdirSync(targetDir, { recursive: true });
+        await convertMarkdownFiles(mdFiles, sourceRoot, targetDir, log);
+    }
+    finally {
+        if (shouldCleanup && fs.existsSync(repoDir)) {
+            log('Cleaning up cloned repository...');
+            rmDir(repoDir);
+        }
+    }
+}
+//# sourceMappingURL=githubMarkdown.js.map

package/apps/server/dist/services/githubMarkdown.js.map

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

package/apps/server/dist/services/maven.js

@@ -0,0 +1,148 @@
+import path from 'node:path';
+import fs from 'node:fs';
+import { Readable } from 'node:stream';
+import { pipeline } from 'node:stream/promises';
+import { spawn } from 'node:child_process';
+import unzipper from 'unzipper';
+function buildMavenUrl(config) {
+    const groupPath = config.groupId.replace(/\./g, '/');
+    const classifier = config.classifier || 'javadoc';
+    return `https://repo1.maven.org/maven2/${groupPath}/${config.artifactId}/${config.version}/${config.artifactId}-${config.version}-${classifier}.jar`;
+}
+export async function downloadWithMavenCommand(config, targetDir, log) {
+    const classifier = config.classifier || 'javadoc';
+    const artifact = `${config.groupId}:${config.artifactId}:${config.version}:jar:${classifier}`;
+    log(`Resolved Maven artifact: ${config.groupId}:${config.artifactId}:${config.version}`);
+    log(`Downloading via mvn dependency:copy (using ~/.m2/settings.xml)`);
+    fs.mkdirSync(targetDir, { recursive: true });
+    const escapedArtifact = artifact.replace(/"/g, '\\"');
+    return new Promise((resolve, reject) => {
+        const proc = spawn('mvn', [
+            'org.apache.maven.plugins:maven-dependency-plugin:3.10.0:copy',
+            `-Dartifact=${escapedArtifact}`,
+            `-DoutputDirectory=${targetDir}`,
+            '-Dtransitive=false',
+        ], {
+            stdio: ['ignore', 'pipe', 'pipe'],
+        });
+        let stderr = '';
+        proc.stdout?.on('data', (data) => {
+            const lines = data.toString().trim().split('\n');
+            for (const line of lines) {
+                if (line)
+                    log(`  mvn: ${line}`);
+            }
+        });
+        proc.stderr?.on('data', (data) => {
+            stderr += data.toString();
+            const lines = data.toString().trim().split('\n');
+            for (const line of lines) {
+                if (line)
+                    log(`  mvn: ${line}`);
+            }
+        });
+        proc.on('close', (code) => {
+            if (code === 0) {
+                log(`Maven download complete`);
+                const downloaded = findJarFiles(targetDir);
+                if (downloaded.length > 0) {
+                    log(`Downloaded: ${downloaded.map((p) => path.basename(p)).join(', ')}`);
+                    resolve();
+                    return;
+                }
+                reject(new Error('Maven download succeeded but no JAR files found in target directory'));
+            }
+            else {
+                const tail = stderr.slice(-500);
+                if (stderr.includes('BUILD FAILURE') || tail.includes('Could not resolve dependencies')) {
+                    reject(new Error(`Maven download failed — artifact may not exist or your settings.xml proxy is misconfigured.\n` +
+                        `Artifact: ${artifact}\n` +
+                        `Last output: ${tail}`));
+                }
+                else {
+                    reject(new Error(`Maven download failed with code ${code}. Install Maven or use direct download/locallJar mode. Last output: ${tail}`));
+                }
+            }
+        });
+        proc.on('error', (err) => {
+            if (err.code === 'ENOENT') {
+                reject(new Error('mvn command not found. Install Maven (apt install maven) or use direct download/locallJar mode.'));
+            }
+            else {
+                reject(err);
+            }
+        });
+    });
+}
+export async function extractLocalJar(localJarPath, targetDir, log) {
+    if (!fs.existsSync(localJarPath)) {
+        throw new Error(`Local JAR not found: ${localJarPath}`);
+    }
+    const stat = fs.statSync(localJarPath);
+    if (!stat.isFile()) {
+        throw new Error(`localJar must be a .jar file, got directory: ${localJarPath}`);
+    }
+    if (!localJarPath.endsWith('.jar')) {
+        throw new Error(`localJar must be a .jar file: ${localJarPath}`);
+    }
+    log(`Extracting local JAR from ${localJarPath}`);
+    fs.mkdirSync(targetDir, { recursive: true });
+    const data = fs.readFileSync(localJarPath);
+    const stream = Readable.from(data);
+    await pipeline(stream, unzipper.Extract({ path: targetDir }));
+    log(`Extracted JAR to ${targetDir}`);
+    const files = countFilesRecursive(targetDir);
+    log(`Found ${files} files in extracted artifact`);
+}
+export async function downloadAndExtractMavenJar(config, targetDir, log) {
+    if (config.localJar) {
+        await extractLocalJar(config.localJar, targetDir, log);
+        return;
+    }
+    if (config.useMavenCommand) {
+        await downloadWithMavenCommand(config, targetDir, log);
+        return;
+    }
+    const url = buildMavenUrl(config);
+    log(`Resolved Maven artifact: ${config.groupId}:${config.artifactId}:${config.version}`);
+    log(`Downloading JAR from ${url}`);
+    const response = await fetch(url);
+    if (!response.ok) {
+        throw new Error(`Failed to download Maven JAR: ${response.status} ${response.statusText} — ${url}`);
+    }
+    fs.mkdirSync(targetDir, { recursive: true });
+    if (!response.body) {
+        throw new Error('No response body');
+    }
+    const nodeStream = Readable.fromWeb(response.body);
+    await pipeline(nodeStream, unzipper.Extract({ path: targetDir }));
+    log(`Extracted Maven JAR to ${targetDir}`);
+    const files = countFilesRecursive(targetDir);
+    log(`Found ${files} files in extracted artifact`);
+}
+function findJarFiles(dir) {
+    const results = [];
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isFile() && entry.name.endsWith('.jar')) {
+            results.push(fullPath);
+        }
+    }
+    return results;
+}
+function countFilesRecursive(dir) {
+    let count = 0;
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            count += countFilesRecursive(fullPath);
+        }
+        else {
+            count++;
+        }
+    }
+    return count;
+}
+//# sourceMappingURL=maven.js.map

package/apps/server/dist/services/maven.js.map

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

package/apps/server/dist/services/normalizer.js

@@ -0,0 +1,42 @@
+import path from 'node:path';
+import fs from 'node:fs';
+export function normalizeDocs(sources, outputDir, log) {
+    fs.mkdirSync(outputDir, { recursive: true });
+    const htmlFiles = [];
+    for (const source of sources) {
+        log(`Normalizing source "${source.label}" from ${source.dir}`);
+        const sourceDir = path.join(outputDir, sanitizeDirname(source.label));
+        copyDirContents(source.dir, sourceDir, outputDir, htmlFiles, log);
+    }
+    log(`Normalized ${htmlFiles.length} HTML files into ${outputDir}`);
+    return htmlFiles.map((f) => f.relativePath);
+}
+function sanitizeDirname(name) {
+    return name.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
+}
+function copyDirContents(srcDir, destDir, bundleRoot, htmlFiles, log) {
+    if (!fs.existsSync(srcDir)) {
+        log(`  Warning: source directory does not exist: ${srcDir}`);
+        return;
+    }
+    const entries = fs.readdirSync(srcDir, { withFileTypes: true });
+    for (const entry of entries) {
+        const srcPath = path.join(srcDir, entry.name);
+        const destPath = path.join(destDir, entry.name);
+        if (entry.isDirectory()) {
+            fs.mkdirSync(destPath, { recursive: true });
+            copyDirContents(srcPath, destPath, bundleRoot, htmlFiles, log);
+        }
+        else if (entry.isFile() && entry.name.endsWith('.html')) {
+            fs.mkdirSync(path.dirname(destPath), { recursive: true });
+            fs.copyFileSync(srcPath, destPath);
+            const relativePath = path.relative(bundleRoot, destPath);
+            htmlFiles.push({ relativePath, fullPath: destPath });
+        }
+        else if (entry.isFile()) {
+            fs.mkdirSync(path.dirname(destPath), { recursive: true });
+            fs.copyFileSync(srcPath, destPath);
+        }
+    }
+}
+//# sourceMappingURL=normalizer.js.map

package/apps/server/dist/services/normalizer.js.map

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

package/apps/server/dist/services/paths.js

@@ -0,0 +1,5 @@
+import path from 'node:path';
+import os from 'node:os';
+const home = os.homedir() || process.cwd();
+export const DATA_ROOT = process.env.DOCKIT_DATA_DIR || path.join(home, '.dockit');
+//# sourceMappingURL=paths.js.map

package/apps/server/dist/services/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/services/paths.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,EAAE,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;AAC3C,MAAM,CAAC,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC"}