@doxbrix/doxloop 0.1.0

package/dist/deploy.js

@@ -0,0 +1,136 @@
+import { readFile } from 'node:fs/promises';
+import { apiUrl, authenticatedRequest, authenticatedRequestOptional, } from './auth.js';
+import { DoxloopError } from './errors.js';
+import { listFiles, resolveContainedDirectory } from './fs.js';
+import { deployGeneratedSite } from './artifact-deploy.js';
+import { loadPages, loadProject, loadSiteConfig, relativePath, } from './project.js';
+import { createStepList, formatDuration } from './progress.js';
+import { validateProject } from './validation.js';
+const MEDIA_EXTENSIONS = new Set([
+    '.avif',
+    '.bmp',
+    '.eot',
+    '.gif',
+    '.ico',
+    '.jpeg',
+    '.jpg',
+    '.mov',
+    '.mp3',
+    '.mp4',
+    '.ogg',
+    '.otf',
+    '.pdf',
+    '.png',
+    '.svg',
+    '.ttf',
+    '.wav',
+    '.webm',
+    '.webp',
+    '.woff',
+    '.woff2',
+]);
+export async function deploy(options) {
+    const project = await loadProject(options.root);
+    const name = options.name?.trim() || project.title;
+    const slug = options.slug?.trim() || slugify(project.title);
+    process.stdout.write(`Documentation project:\n  ${options.root}\nProduct sources excluded from deployment: ${project.sources.length}\n\n`);
+    if (project.generator !== 'doxbrix') {
+        return deployGeneratedSite({ ...options, name, slug });
+    }
+    const steps = createStepList();
+    process.stdout.write(`Deploying "${name}" → ${apiUrl(options.apiUrl)}\n\n`);
+    try {
+        const validating = steps.start('Validating documentation');
+        const result = await validateProject(options.root);
+        if (result.errors > 0) {
+            throw new DoxloopError(`Deployment stopped because documentation has ${result.errors} validation error${result.errors === 1 ? '' : 's'}. Run \`doxloop test\`.`);
+        }
+        validating.done('Validated documentation');
+        const building = steps.start('Building bundle');
+        const bundle = await buildDeploymentBundle(options.root, project.contentDir);
+        const bytes = Buffer.byteLength(JSON.stringify(bundle));
+        building.done('Built bundle', `${count(bundle.pages.length, 'page')}${bundle.media.length > 0 ? `, ${count(bundle.media.length, 'media file')}` : ''}, ${formatBytes(bytes)}`);
+        if (options.dryRun) {
+            process.stdout.write(`\nDeployment is valid.\nProject: ${name}\nSlug: ${slug}\nPages: ${bundle.pages.length}\nMedia files: ${bundle.media.length}\nPayload: ${formatBytes(bytes)}\nNo data was uploaded.\n`);
+            return;
+        }
+        const locating = steps.start('Locating project');
+        const existing = await authenticatedRequestOptional(`/api/v1/projects/${encodeURIComponent(slug)}`, { method: 'GET' }, options.apiUrl);
+        let target = existing?.project;
+        if (target) {
+            locating.done(`Found project "${target.name}" (${target.slug})`);
+        }
+        else {
+            const created = await authenticatedRequest('/api/v1/projects', {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                // The bundle below is the source of truth. Do not let Doxbrix seed its
+                // web starter template (Guides / API Reference / FAQ) first.
+                body: JSON.stringify({ name, slug, seedTemplate: false }),
+            }, options.apiUrl);
+            target = created.project;
+            locating.done(`Created project "${target.name}" (${target.slug})`);
+        }
+        const publishing = steps.start('Publishing to Doxbrix');
+        const pushed = await authenticatedRequest(`/api/v1/projects/${encodeURIComponent(target.slug)}/bundle`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ ...bundle, publish: true }),
+        }, options.apiUrl);
+        const report = pushed.result;
+        publishing.done('Published', `${count(bundle.pages.length, 'page')} (${report.pagesCreated} created, ${report.pagesUpdated} updated), ${count(report.spaces, 'space')}${bundle.media.length > 0 ? `, ${count(bundle.media.length, 'media file')}` : ''} · ${formatDuration(publishing.durationMs)}`);
+        for (const warning of report.warnings ?? []) {
+            process.stdout.write(`warning: ${warning}\n`);
+        }
+        process.stdout.write(`\n${apiUrl(options.apiUrl)}/editor?project=${encodeURIComponent(target.slug)}\n`);
+    }
+    catch (error) {
+        steps.failActive();
+        throw error;
+    }
+}
+export async function buildDeploymentBundle(root, contentDir) {
+    const project = await loadProject(root);
+    if (contentDir !== project.contentDir) {
+        throw new DoxloopError('Deployment content directory must match .doxloop/project.json.');
+    }
+    const contentRoot = await resolveContainedDirectory(root, project.contentDir, 'Deployment content directory');
+    const pages = [];
+    for (const path of await loadPages(root, project)) {
+        pages.push({
+            path: relativePath(contentRoot, path),
+            markdown: await readFile(path, 'utf8'),
+        });
+    }
+    const media = [];
+    for (const path of await listFiles(contentRoot, MEDIA_EXTENSIONS)) {
+        media.push({
+            path: relativePath(contentRoot, path),
+            base64: (await readFile(path)).toString('base64'),
+        });
+    }
+    const manifest = await loadSiteConfig(root, project);
+    return { manifest, basePath: contentDir, pages, media };
+}
+function slugify(value) {
+    const slug = value
+        .toLowerCase()
+        .normalize('NFKD')
+        .replace(/[\u0300-\u036f]/g, '')
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '');
+    if (!slug)
+        throw new DoxloopError('Cannot derive a project slug. Pass --slug.');
+    return slug;
+}
+function count(value, noun) {
+    return `${value} ${noun}${value === 1 ? '' : 's'}`;
+}
+function formatBytes(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${(bytes / 1024).toFixed(1)} KiB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MiB`;
+}
+//# sourceMappingURL=deploy.js.map

package/dist/deploy.js.map

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

package/dist/doctor.d.ts

@@ -0,0 +1,18 @@
+import type { AgentName } from './types.js';
+export interface DoctorCheck {
+    status: 'pass' | 'warning' | 'fail';
+    label: string;
+    detail?: string;
+}
+export interface DoctorReport {
+    ready: boolean;
+    checks: DoctorCheck[];
+}
+export declare function runDoctor(options: {
+    cwd: string;
+    source?: string;
+    output?: string;
+    agent?: AgentName;
+}): Promise<DoctorReport>;
+export declare function formatDoctorReport(report: DoctorReport): string;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../src/doctor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAgB3C,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAA;IACnC,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,EAAE,WAAW,EAAE,CAAA;CACtB;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE;IACvC,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,SAAS,CAAA;CAClB,GAAG,OAAO,CAAC,YAAY,CAAC,CA8CxB;AAqBD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAY/D"}

package/dist/doctor.js

@@ -0,0 +1,222 @@
+import { createServer } from 'node:net';
+import { agentAuthenticationStatus, chooseAgent, skillStatus, } from './agents.js';
+import { DoxloopError } from './errors.js';
+import { diagnoseGenerator } from './generator-manager.js';
+import { findProjectRoot, loadProject, resolveSeparateProjectLayout, validateProjectSourceBoundaries, } from './project.js';
+import { validateProject } from './validation.js';
+export async function runDoctor(options) {
+    const checks = [nodeCheck()];
+    const preflight = options.source !== undefined || options.output !== undefined;
+    if (preflight) {
+        if (!options.source || !options.output) {
+            checks.push({
+                status: 'fail',
+                label: 'New project paths',
+                detail: 'Pass both `--source <product-directory>` and `--output <documentation-directory>`.',
+            });
+        }
+        else {
+            try {
+                const layout = await resolveSeparateProjectLayout({
+                    cwd: options.cwd,
+                    source: options.source,
+                    output: options.output,
+                });
+                checks.push({
+                    status: 'pass',
+                    label: 'Product source found',
+                    detail: layout.sourceRoot,
+                });
+                checks.push({
+                    status: 'pass',
+                    label: 'Documentation output is separate and available',
+                    detail: layout.projectRoot,
+                });
+            }
+            catch (error) {
+                checks.push({
+                    status: 'fail',
+                    label: 'Product and documentation directories',
+                    detail: errorMessage(error),
+                });
+            }
+        }
+    }
+    else {
+        await inspectExistingProject(options.cwd, checks);
+    }
+    await inspectAgent(options.agent, checks, preflight ? undefined : options.cwd);
+    checks.push(await previewPortCheck());
+    return {
+        ready: checks.every((check) => check.status !== 'fail'),
+        checks,
+    };
+}
+async function previewPortCheck() {
+    return new Promise((resolveCheck) => {
+        const server = createServer();
+        server.unref();
+        server.once('error', () => {
+            resolveCheck({
+                status: 'warning',
+                label: 'Preview port 4321 is occupied',
+                detail: 'Use `doxloop preview --port 4400 --open` or stop the process using port 4321.',
+            });
+        });
+        server.listen(4321, '127.0.0.1', () => {
+            server.close(() => {
+                resolveCheck({ status: 'pass', label: 'Preview port 4321 is available' });
+            });
+        });
+    });
+}
+export function formatDoctorReport(report) {
+    const lines = ['Checking Doxloop…', ''];
+    for (const check of report.checks) {
+        const symbol = check.status === 'pass' ? '✓' : check.status === 'warning' ? '!' : '✗';
+        lines.push(`${symbol} ${check.label}`);
+        if (check.detail) {
+            for (const line of check.detail.split('\n'))
+                lines.push(`  ${line}`);
+        }
+    }
+    lines.push('', report.ready ? 'Doxloop is ready.' : 'Doxloop needs attention before you continue.');
+    return lines.join('\n');
+}
+async function inspectExistingProject(cwd, checks) {
+    let root;
+    try {
+        root = await findProjectRoot(cwd);
+        checks.push({
+            status: 'pass',
+            label: 'Documentation project found',
+            detail: root,
+        });
+    }
+    catch (error) {
+        checks.push({
+            status: 'fail',
+            label: 'Documentation project',
+            detail: `${errorMessage(error)}\nFor a new project, run: doxloop doctor --source ./my-product --output ./my-docs`,
+        });
+        return;
+    }
+    try {
+        const project = await loadProject(root);
+        await validateProjectSourceBoundaries(root, project.sources);
+        checks.push({
+            status: 'pass',
+            label: `${project.sources.length} product source${project.sources.length === 1 ? '' : 's'} found and separate`,
+        });
+    }
+    catch (error) {
+        checks.push({
+            status: 'fail',
+            label: 'Product source boundary',
+            detail: errorMessage(error),
+        });
+    }
+    try {
+        const generator = await diagnoseGenerator(root);
+        const name = generator.split('\n')[0]?.replace(/^Generator:\s*/, '') ?? 'Generator';
+        checks.push({ status: 'pass', label: `${name} generator is ready` });
+    }
+    catch (error) {
+        checks.push({
+            status: 'fail',
+            label: 'Documentation generator',
+            detail: errorMessage(error),
+        });
+    }
+    const validation = await validateProject(root);
+    checks.push({
+        status: validation.errors > 0
+            ? 'fail'
+            : validation.warnings > 0
+                ? 'warning'
+                : 'pass',
+        label: `${validation.pages.length} documentation page${validation.pages.length === 1 ? '' : 's'} checked`,
+        detail: `${validation.errors} errors, ${validation.warnings} warnings`,
+    });
+}
+async function inspectAgent(preferredAgent, checks, projectCwd) {
+    try {
+        const agent = await chooseAgent(preferredAgent);
+        const label = agent.name === 'claude' ? 'Claude Code' : capitalize(agent.name);
+        checks.push({ status: 'pass', label: `${label} is installed` });
+        const authentication = await agentAuthenticationStatus(agent);
+        checks.push({
+            status: authentication.status === 'authenticated'
+                ? 'pass'
+                : authentication.status === 'unknown'
+                    ? 'warning'
+                    : 'fail',
+            label: authentication.status === 'authenticated'
+                ? `${label} is signed in`
+                : `${label} authentication`,
+            ...(authentication.status === 'authenticated'
+                ? {}
+                : { detail: authentication.detail }),
+        });
+        if (projectCwd) {
+            let root;
+            try {
+                root = await findProjectRoot(projectCwd);
+            }
+            catch {
+                return;
+            }
+            await inspectSkills(root, agent.name, checks);
+        }
+    }
+    catch (error) {
+        checks.push({
+            status: 'fail',
+            label: 'Coding agent',
+            detail: errorMessage(error),
+        });
+    }
+}
+async function inspectSkills(root, agent, checks) {
+    const skills = await skillStatus(root, agent);
+    const missing = skills.filter((skill) => skill.status === 'missing');
+    const modified = skills.filter((skill) => skill.status === 'modified');
+    const label = agent === 'claude' ? 'Claude Code' : capitalize(agent);
+    if (missing.length > 0) {
+        checks.push({
+            status: 'fail',
+            label: `${label} project skills`,
+            detail: `Missing ${missing.length} skill${missing.length === 1 ? '' : 's'}. Run \`doxloop agent setup --agent ${agent}\`.`,
+        });
+    }
+    else if (modified.length > 0) {
+        checks.push({
+            status: 'fail',
+            label: `${label} project skills`,
+            detail: `Modified ${modified.length} skill${modified.length === 1 ? '' : 's'}. Review them, then run \`doxloop agent update --agent ${agent}\` if they should be replaced.`,
+        });
+    }
+    else {
+        checks.push({ status: 'pass', label: `${label} project skills are ready` });
+    }
+}
+function nodeCheck() {
+    const [major = 0, minor = 0] = process.versions.node
+        .split('.')
+        .map((value) => Number(value));
+    const supported = major > 20 || (major === 20 && minor >= 12);
+    return {
+        status: supported ? 'pass' : 'fail',
+        label: `Node.js ${process.versions.node} ${supported ? 'is supported' : 'is not supported'}`,
+        ...(supported ? {} : { detail: 'Install Node.js 20.12 or later.' }),
+    };
+}
+function capitalize(value) {
+    return `${value.slice(0, 1).toUpperCase()}${value.slice(1)}`;
+}
+function errorMessage(error) {
+    if (error instanceof DoxloopError || error instanceof Error)
+        return error.message;
+    return String(error);
+}
+//# sourceMappingURL=doctor.js.map

package/dist/doctor.js.map

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

package/dist/doxbrix-markdown.d.ts

@@ -0,0 +1,20 @@
+/**
+ * MDX -> HTML renderer for `dxb dev`. Emits the same `dp-`/`df-` class structure
+ * the published reader site uses (see apps/web BlockRenderer + DocumentationSite),
+ * so that — paired with the bundled reader stylesheet (preview.css) — the local
+ * preview renders the way the cloud site does. Plain Markdown and the Doxbrix
+ * component blocks (callouts, Steps, Tabs, Accordion, Card/CardGroup, Columns,
+ * CodeGroup, Terminal, Frame, Video, Embed, File, ApiEndpoint, Badge, Icon,
+ * Update, Mermaid, Math, ...) are all supported.
+ */
+export interface TocEntry {
+    id: string;
+    level: 2 | 3 | 4;
+    title: string;
+}
+export interface RenderResult {
+    html: string;
+    toc: TocEntry[];
+}
+export declare function renderMarkdown(md: string): RenderResult;
+//# sourceMappingURL=doxbrix-markdown.d.ts.map

package/dist/doxbrix-markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doxbrix-markdown.d.ts","sourceRoot":"","sources":["../src/doxbrix-markdown.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAkBH,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAChB,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,QAAQ,EAAE,CAAA;CAChB;AAeD,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,CAUvD"}