@lon-ask/dockit 0.1.1 → 0.1.4

package/apps/server/dist/routes/sources.js

@@ -0,0 +1,100 @@
+import { Router } from 'express';
+const VALID_TYPES = ['zip', 'antora', 'maven', 'asciidoc', 'github-markdown', 'source-code'];
+function validateConfig(type, config) {
+    switch (type) {
+        case 'maven':
+            if (!config.groupId || typeof config.groupId !== 'string')
+                return 'groupId is required';
+            if (!config.artifactId || typeof config.artifactId !== 'string')
+                return 'artifactId is required';
+            if (!config.version || typeof config.version !== 'string')
+                return 'version is required';
+            return null;
+        case 'zip': {
+            const hasUrl = config.url && typeof config.url === 'string';
+            const hasLocalPath = config.localPath && typeof config.localPath === 'string';
+            if (!hasUrl && !hasLocalPath)
+                return 'url or localPath is required';
+            return null;
+        }
+        case 'antora': {
+            const hasRepoUrl = config.repoUrl && typeof config.repoUrl === 'string';
+            const hasZipPath = config.zipPath && typeof config.zipPath === 'string';
+            const hasLocalPath = config.localPath && typeof config.localPath === 'string';
+            if (!hasRepoUrl && !hasZipPath && !hasLocalPath)
+                return 'repoUrl, localPath, or zipPath is required';
+            return null;
+        }
+        case 'asciidoc': {
+            const hasRepoUrl = config.repoUrl && typeof config.repoUrl === 'string';
+            const hasZipPath = config.zipPath && typeof config.zipPath === 'string';
+            const hasLocalPath = config.localPath && typeof config.localPath === 'string';
+            if (!hasRepoUrl && !hasZipPath && !hasLocalPath)
+                return 'repoUrl, localPath, or zipPath is required';
+            return null;
+        }
+        case 'github-markdown': {
+            const hasRepoUrl = config.repoUrl && typeof config.repoUrl === 'string';
+            const hasLocalPath = config.localPath && typeof config.localPath === 'string';
+            if (!hasRepoUrl && !hasLocalPath)
+                return 'repoUrl or localPath is required';
+            return null;
+        }
+        case 'source-code': {
+            const hasRepoUrl = config.repoUrl && typeof config.repoUrl === 'string';
+            const hasLocalPath = config.localPath && typeof config.localPath === 'string';
+            const hasZipPath = config.zipPath && typeof config.zipPath === 'string';
+            if (!hasRepoUrl && !hasLocalPath && !hasZipPath)
+                return 'repoUrl, localPath, or zipPath is required';
+            return null;
+        }
+        default:
+            return null;
+    }
+}
+export function createSourceRoutes(configUseCase) {
+    const router = Router({ mergeParams: true });
+    router.post('/', async (req, res) => {
+        const entryId = req.params.entryId;
+        const entry = await configUseCase.getEntry(entryId);
+        if (!entry) {
+            res.status(404).json({ error: 'Entry not found' });
+            return;
+        }
+        const { type, label, config } = req.body;
+        if (!type || !VALID_TYPES.includes(type)) {
+            res.status(400).json({ error: `type must be one of: ${VALID_TYPES.join(', ')}` });
+            return;
+        }
+        if (!label) {
+            res.status(400).json({ error: 'label is required' });
+            return;
+        }
+        const configError = validateConfig(type, config);
+        if (configError) {
+            res.status(400).json({ error: configError });
+            return;
+        }
+        const source = await configUseCase.createSource(entryId, { type, label, config: config });
+        res.status(201).json(source);
+    });
+    return router;
+}
+export function createSourceFlatRoutes(configUseCase) {
+    const router = Router();
+    router.put('/:id', async (req, res) => {
+        const id = req.params.id;
+        const input = req.body;
+        await configUseCase.updateSource(id, input);
+        const { SqliteSourceRepository } = await import('../infrastructure/persistence/sqlite/SqliteSourceRepository.js');
+        const source = await new SqliteSourceRepository().findById(id);
+        res.json(source);
+    });
+    router.delete('/:id', async (req, res) => {
+        const id = req.params.id;
+        await configUseCase.deleteSource(id);
+        res.json({ success: true });
+    });
+    return router;
+}
+//# sourceMappingURL=sources.js.map

package/apps/server/dist/routes/sources.js.map

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

package/apps/server/dist/routes/viewer.js

@@ -0,0 +1,22 @@
+import { Router } from 'express';
+import path from 'node:path';
+import fs from 'node:fs';
+import { DATA_ROOT } from '../services/paths.js';
+const router = Router();
+router.use('/bundle/:entryId', (req, res) => {
+    const entryId = req.params.entryId;
+    const filePath = req.path.replace(/^\//, '') || 'index.html';
+    const fullPath = path.resolve(DATA_ROOT, entryId, 'bundle', filePath);
+    const dataRoot = path.resolve(DATA_ROOT);
+    if (!fullPath.startsWith(dataRoot)) {
+        res.status(403).json({ error: 'Invalid document path' });
+        return;
+    }
+    if (!fs.existsSync(fullPath)) {
+        res.status(404).json({ error: 'Documentation not built yet' });
+        return;
+    }
+    res.sendFile(fullPath);
+});
+export default router;
+//# sourceMappingURL=viewer.js.map

package/apps/server/dist/routes/viewer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer.js","sourceRoot":"","sources":["../../src/routes/viewer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAqB,MAAM,SAAS,CAAC;AAEpD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEjD,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC;AAExB,MAAM,CAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC,GAAY,EAAE,GAAa,EAAE,EAAE;IAC7D,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,OAAiB,CAAC;IAC7C,MAAM,QAAQ,GAAG,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,YAAY,CAAC;IAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACtE,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEzC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC,CAAC;QACzD,OAAO;IACT,CAAC;IAED,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,6BAA6B,EAAE,CAAC,CAAC;QAC/D,OAAO;IACT,CAAC;IAED,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AACzB,CAAC,CAAC,CAAC;AAEH,eAAe,MAAM,CAAC"}

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

@@ -0,0 +1,222 @@
+import path from 'node:path';
+import fs from 'node:fs';
+import { execSync, spawn } from 'node:child_process';
+import { Readable } from 'node:stream';
+import { pipeline } from 'node:stream/promises';
+import unzipper from 'unzipper';
+async function cloneRepo(repoUrl, targetDir, log) {
+    log(`Cloning repository ${repoUrl}`);
+    if (fs.existsSync(targetDir))
+        fs.rmSync(targetDir, { recursive: true, force: true });
+    return new Promise((resolve, reject) => {
+        const proc = spawn('git', ['clone', '--depth', '1', 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);
+    });
+}
+async function extractZip(zipPath, targetDir, log) {
+    log(`Extracting local ZIP from ${zipPath}`);
+    fs.mkdirSync(targetDir, { recursive: true });
+    const data = fs.readFileSync(zipPath);
+    const stream = Readable.from(data);
+    await pipeline(stream, unzipper.Extract({ path: targetDir }));
+    const entries = fs.readdirSync(targetDir);
+    if (entries.length === 1 && fs.statSync(path.join(targetDir, entries[0])).isDirectory()) {
+        log('Detected single root directory in ZIP, flattening...');
+        const innerDir = path.join(targetDir, entries[0]);
+        const innerEntries = fs.readdirSync(innerDir);
+        for (const entry of innerEntries) {
+            const src = path.join(innerDir, entry);
+            const dest = path.join(targetDir, entry);
+            fs.renameSync(src, dest);
+        }
+        fs.rmdirSync(innerDir);
+    }
+    log(`Extracted ZIP to ${targetDir}`);
+}
+function findAntoraYmlFiles(dir) {
+    const results = [];
+    const stack = [dir];
+    while (stack.length > 0) {
+        const current = stack.pop();
+        const entries = fs.readdirSync(current, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.name.startsWith('.'))
+                continue;
+            if (entry.name === 'node_modules')
+                continue;
+            const fullPath = path.join(current, entry.name);
+            if (entry.isDirectory()) {
+                stack.push(fullPath);
+            }
+            else if (entry.name === 'antora.yml') {
+                results.push(fullPath);
+            }
+        }
+    }
+    return results;
+}
+function findExistingPlaybook(contentDir) {
+    const candidates = ['antora-playbook.yml', 'site.yml', 'antora-playbook.yaml', 'site.yaml'];
+    for (const name of candidates) {
+        const p = path.join(contentDir, name);
+        if (fs.existsSync(p))
+            return p;
+    }
+    return null;
+}
+function generatePlaybook(entryId, contentDir, outputDir, startPaths, log) {
+    let sourcesYaml;
+    if (startPaths.length === 0) {
+        log('  No antora.yml files found — Antora will scan entire repository');
+        sourcesYaml = `    - url: ${contentDir}\n      branches: HEAD`;
+    }
+    else {
+        log(`  Found ${startPaths.length} antora.yml file(s)`);
+        if (startPaths.length === 1) {
+            const rel = path.relative(contentDir, path.dirname(startPaths[0]));
+            log(`  Using start_path: ${rel || '.'}`);
+            sourcesYaml = `    - url: ${contentDir}\n      branches: HEAD\n      start_path: ${rel || '.'}`;
+        }
+        else {
+            const paths = startPaths
+                .map((f) => path.relative(contentDir, path.dirname(f)))
+                .filter((p) => p.length > 0);
+            const pathsStr = paths.length > 0
+                ? `\n${paths.map((p) => `        - ${p}`).join('\n')}`
+                : '';
+            sourcesYaml = `    - url: ${contentDir}\n      branches: HEAD\n      start_paths:${pathsStr}`;
+        }
+    }
+    return `
+site:
+  title: Dockit — ${entryId}
+  url: /api/bundle/${entryId}
+content:
+  sources:
+${sourcesYaml}
+ui:
+  bundle:
+    url: https://gitlab.com/antora/antora-ui-default/-/jobs/artifacts/HEAD/raw/build/ui-bundle.zip?job=bundle-stable
+    snapshot: true
+output:
+  dir: ${outputDir}
+`.trim();
+}
+function generatePlaybookFromExisting(playbookPath, outputDir) {
+    const raw = fs.readFileSync(playbookPath, 'utf-8');
+    if (raw.includes('output:') && raw.includes('dir:')) {
+        return raw;
+    }
+    return raw + `\noutput:\n  dir: ${outputDir}\n`;
+}
+async function runAntora(playbookPath, log) {
+    log(`Running Antora with playbook ${playbookPath}`);
+    return new Promise((resolve, reject) => {
+        const proc = spawn('npx', ['antora', playbookPath], {
+            stdio: ['ignore', 'pipe', 'pipe'],
+            cwd: path.dirname(playbookPath),
+            env: { ...process.env, CI: 'true' },
+        });
+        let stderr = '';
+        proc.stdout?.on('data', (data) => {
+            const lines = data.toString().trim().split('\n');
+            for (const line of lines) {
+                if (line)
+                    log(`  antora: ${line}`);
+            }
+        });
+        proc.stderr?.on('data', (data) => {
+            stderr += data.toString();
+        });
+        proc.on('close', (code) => {
+            if (code === 0) {
+                log('Antora build completed successfully');
+                resolve();
+            }
+            else {
+                const tail = stderr.slice(-800);
+                log(`Antora build failed (stderr: ${tail})`);
+                reject(new Error(`Antora build failed with code ${code}`));
+            }
+        });
+        proc.on('error', reject);
+    });
+}
+export async function buildAntoraSource(config, entryId, workDir, log) {
+    let contentDir;
+    let cleanupDir;
+    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}`);
+        contentDir = config.localPath;
+    }
+    else if (config.repoUrl) {
+        contentDir = path.join(workDir, 'content');
+        await cloneRepo(config.repoUrl, contentDir, log);
+        cleanupDir = contentDir;
+    }
+    else if (config.zipPath) {
+        contentDir = path.join(workDir, 'content');
+        await extractZip(config.zipPath, contentDir, log);
+        cleanupDir = contentDir;
+    }
+    else {
+        throw new Error('Antora source requires repoUrl, localPath, or zipPath');
+    }
+    const playbookPath = path.join(workDir, 'antora-playbook.yml');
+    const outputDir = path.join(workDir, 'output');
+    const existingPlaybook = findExistingPlaybook(contentDir);
+    if (existingPlaybook) {
+        log(`Found existing playbook at ${path.relative(contentDir, existingPlaybook)}`);
+        const playbookContent = generatePlaybookFromExisting(existingPlaybook, outputDir);
+        fs.writeFileSync(playbookPath, playbookContent, 'utf-8');
+    }
+    else {
+        const antoraFiles = findAntoraYmlFiles(contentDir);
+        if (antoraFiles.length === 0) {
+            throw new Error(`No antora.yml files found in repository. ` +
+                `This repo does not appear to be an Antora-based documentation source. ` +
+                `Use a ZIP or Maven source type instead, or provide the URL to the specific ` +
+                `Antora documentation repository (e.g. a repo containing antora.yml files).`);
+        }
+        const playbookContent = generatePlaybook(entryId, contentDir, outputDir, antoraFiles, log);
+        fs.writeFileSync(playbookPath, playbookContent, 'utf-8');
+    }
+    await runAntora(playbookPath, log);
+    return outputDir;
+}
+export function ensureAntoraInstalled() {
+    try {
+        execSync('npx antora --version', { stdio: 'pipe' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=antora.js.map

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

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

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

@@ -0,0 +1,206 @@
+import path from 'node:path';
+import fs from 'node:fs';
+import os from 'node:os';
+import { spawn } from 'node:child_process';
+import { Readable } from 'node:stream';
+import { pipeline } from 'node:stream/promises';
+import unzipper from 'unzipper';
+import asciidoctorModule from '@asciidoctor/core';
+const asciidoctor = asciidoctorModule;
+const SKIP_DIRS = new Set([
+    'node_modules', 'target', 'build', 'dist', '.git',
+    'integrations', 'extensions', 'independent-projects',
+    'test', 'tests', 'tcks',
+]);
+async function cloneRepo(repoUrl, targetDir, log) {
+    log(`Cloning repository ${repoUrl}`);
+    if (fs.existsSync(targetDir))
+        fs.rmSync(targetDir, { recursive: true, force: true });
+    return new Promise((resolve, reject) => {
+        const proc = spawn('git', ['clone', '--depth', '1', 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);
+    });
+}
+async function extractZip(zipPath, targetDir, log) {
+    log(`Extracting local ZIP from ${zipPath}`);
+    fs.mkdirSync(targetDir, { recursive: true });
+    const data = fs.readFileSync(zipPath);
+    const stream = Readable.from(data);
+    await pipeline(stream, unzipper.Extract({ path: targetDir }));
+    const entries = fs.readdirSync(targetDir);
+    if (entries.length === 1 && fs.statSync(path.join(targetDir, entries[0])).isDirectory()) {
+        log('Detected single root directory, flattening...');
+        const innerDir = path.join(targetDir, entries[0]);
+        const innerEntries = fs.readdirSync(innerDir);
+        for (const entry of innerEntries) {
+            fs.renameSync(path.join(innerDir, entry), path.join(targetDir, entry));
+        }
+        fs.rmdirSync(innerDir);
+    }
+    log(`Extracted ZIP to ${targetDir}`);
+}
+function findAdocFiles(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('.adoc')) {
+                results.push(fullPath);
+            }
+        }
+    }
+    return results;
+}
+async function runAsciidoctor(adocFiles, sourceRoot, targetDir, log) {
+    log(`Converting ${adocFiles.length} .adoc files to HTML`);
+    const adoc = asciidoctor();
+    let filesProcessed = 0;
+    let filesSkipped = 0;
+    for (const adocFile of adocFiles) {
+        try {
+            const relPath = path.relative(sourceRoot, adocFile);
+            const outDir = path.join(targetDir, path.dirname(relPath));
+            fs.mkdirSync(outDir, { recursive: true });
+            adoc.convertFile(adocFile, {
+                to_dir: outDir,
+                base_dir: path.dirname(adocFile),
+                mkdirs: true,
+                safe: 'unsafe',
+            });
+            filesProcessed++;
+        }
+        catch (err) {
+            const rel = path.relative(sourceRoot, adocFile);
+            log(`  WARNING: Failed to convert ${rel}: ${err.message || err}`);
+            filesSkipped++;
+        }
+    }
+    const htmlCount = countHtmlFiles(targetDir);
+    log(`AsciiDoc conversion complete: ${filesProcessed} converted, ${filesSkipped} skipped, ${htmlCount} HTML files generated`);
+    if (htmlCount === 0 && filesProcessed === 0) {
+        throw new Error('Asciidoctor 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 buildAsciidocSource(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-asciidoc-${Date.now()}`);
+        await cloneRepo(config.repoUrl, repoDir, log);
+        shouldCleanup = true;
+    }
+    else if (config.zipPath) {
+        repoDir = path.join(os.tmpdir(), `dockit-asciidoc-${Date.now()}`);
+        fs.mkdirSync(repoDir, { recursive: true });
+        await extractZip(config.zipPath, repoDir, log);
+        shouldCleanup = true;
+    }
+    else {
+        throw new Error('AsciiDoc source requires repoUrl, localPath, or zipPath');
+    }
+    try {
+        const sourcePath = config.sourcePath || '';
+        const sourceRoot = sourcePath ? path.join(repoDir, sourcePath) : repoDir;
+        log(`Scanning for .adoc files in ${sourcePath || 'repository root'}`);
+        const adocFiles = findAdocFiles(repoDir, sourcePath);
+        if (adocFiles.length === 0) {
+            if (sourcePath) {
+                throw new Error(`No .adoc files found at path "${sourcePath}" in the repository`);
+            }
+            throw new Error(`No .adoc files found in the repository. ` +
+                `If the docs live in a subdirectory, set the "sourcePath" field ` +
+                `(e.g. "docs/src/main/asciidoc" for Quarkus).`);
+        }
+        log(`Found ${adocFiles.length} .adoc file(s)`);
+        fs.mkdirSync(targetDir, { recursive: true });
+        await runAsciidoctor(adocFiles, sourceRoot, targetDir, log);
+    }
+    finally {
+        if (shouldCleanup && fs.existsSync(repoDir)) {
+            log('Cleaning up cloned repository...');
+            rmDir(repoDir);
+        }
+    }
+}
+//# sourceMappingURL=asciidoc.js.map

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

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