@doxbrix/doxloop 0.1.0

package/dist/artifact-deploy.js

@@ -0,0 +1,240 @@
+import { spawn } from 'node:child_process';
+import { createHash } from 'node:crypto';
+import { lstat, readdir, readFile } from 'node:fs/promises';
+import { basename, extname, relative, resolve, sep } from 'node:path';
+import { zipSync } from 'fflate';
+import { apiUrl, authenticatedRequest, authenticatedRequestOptional } from './auth.js';
+import { DoxloopError } from './errors.js';
+import { loadGeneratorAdapter } from './generators.js';
+import { loadProject } from './project.js';
+import { createStepList, formatDuration } from './progress.js';
+import { validateProject } from './validation.js';
+const MAX_ZIP_BYTES = 100 * 1024 * 1024;
+const MAX_FILES = 20_000;
+const MAX_UNCOMPRESSED_BYTES = 300 * 1024 * 1024;
+const MAX_FILE_BYTES = 50 * 1024 * 1024;
+const POLL_TIMEOUT_MS = 20 * 60_000;
+export async function deployGeneratedSite(options) {
+    const project = await loadProject(options.root);
+    const adapter = await loadGeneratorAdapter(options.root, project);
+    const steps = createStepList();
+    process.stdout.write(`Deploying "${options.name}" → ${apiUrl(options.apiUrl)}\n\n`);
+    try {
+        const validating = steps.start('Validating documentation');
+        const validation = await validateProject(options.root);
+        if (validation.errors > 0) {
+            throw new DoxloopError(`Deployment stopped because documentation has ${validation.errors} validation error${validation.errors === 1 ? '' : 's'}. Run \`doxloop test\`.`);
+        }
+        validating.done('Validated documentation');
+        let target;
+        let siteUrl = process.env.DOXLOOP_SITE_URL || 'https://example.com';
+        if (!options.dryRun) {
+            const locating = steps.start('Locating project');
+            const existing = await authenticatedRequestOptional(`/api/v1/projects/${encodeURIComponent(options.slug)}`, { method: 'GET' }, options.apiUrl);
+            if (existing?.project) {
+                target = existing.project;
+                assertArtifactProject(target, project.generator);
+                locating.done(`Found project "${target.name}" (${target.slug})`);
+            }
+            else {
+                const created = await authenticatedRequest('/api/v1/projects', {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify({
+                        name: options.name,
+                        slug: options.slug,
+                        seedTemplate: false,
+                        connectedArtifact: { generator: project.generator },
+                    }),
+                }, options.apiUrl);
+                target = created.project;
+                assertArtifactProject(target, project.generator);
+                locating.done(`Created hosted project "${target.name}" (${target.slug})`);
+            }
+            if (!target.hostedUrl)
+                throw new DoxloopError('Doxbrix did not return a hosted site URL for this project.');
+            siteUrl = target.hostedUrl;
+        }
+        const building = steps.start(`Building ${adapter.displayName} site locally`);
+        await runLocalBuild(adapter.id, adapter.build.command, options.root, siteUrl);
+        const outputRoot = containedOutput(options.root, adapter.build.outputDir);
+        const packaged = await packageStaticOutput(outputRoot);
+        building.done(`Built ${adapter.displayName} artifact`, `${packaged.files} files, ${formatBytes(packaged.archive.byteLength)}${packaged.omittedSourceMaps ? `, omitted ${packaged.omittedSourceMaps} source maps` : ''}`);
+        if (options.dryRun) {
+            process.stdout.write(`\nDeployment is valid.\nGenerator: ${project.generator}\nOutput: ${adapter.build.outputDir}\nFiles: ${packaged.files}\nArtifact: ${formatBytes(packaged.archive.byteLength)}\nSHA-256: ${packaged.sha256}\nNo data was uploaded.\n`);
+            return;
+        }
+        if (!target)
+            throw new DoxloopError('Doxbrix project resolution failed.');
+        const reserving = steps.start('Reserving secure upload');
+        const reserved = await authenticatedRequest(`/api/v1/projects/${encodeURIComponent(target.id)}/deployments`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ bytes: packaged.archive.byteLength, sha256: packaged.sha256 }),
+        }, options.apiUrl);
+        if (reserved.deployment.alreadyRunning || !reserved.deployment.upload) {
+            throw new DoxloopError(`A deployment is already running for this project (${reserved.deployment.buildId}).`);
+        }
+        reserving.done('Reserved checksum-bound upload');
+        const uploading = steps.start('Uploading static artifact');
+        await uploadArtifact(reserved.deployment.upload, packaged.archive);
+        uploading.done('Uploaded static artifact', formatBytes(packaged.archive.byteLength));
+        const deploying = steps.start('Indexing and deploying on Doxbrix');
+        await authenticatedRequest(`/api/v1/projects/${encodeURIComponent(target.id)}/deployments/${encodeURIComponent(reserved.deployment.buildId)}/complete`, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: '{}' }, options.apiUrl);
+        const result = await waitForDeployment(target.id, reserved.deployment.buildId, options.apiUrl);
+        if (result.status !== 'ready')
+            throw new DoxloopError(result.error || `Deployment ended with status ${result.status}.`);
+        deploying.done('Deployed', `${result.fileCount ?? packaged.files} files, ${result.pagesIndexed ?? 0} pages indexed · ${formatDuration(deploying.durationMs)}`);
+        process.stdout.write(`\n${result.hostedUrl || target.hostedUrl}\n`);
+    }
+    catch (error) {
+        steps.failActive();
+        throw error;
+    }
+}
+function assertArtifactProject(project, generator) {
+    if (project.kind !== 'connected' || project.source !== 'bundle') {
+        throw new DoxloopError(`Project "${project.slug}" already exists but is not a Connected Docs artifact project. Choose another --slug.`);
+    }
+    if (project.generator !== generator) {
+        throw new DoxloopError(`Project "${project.slug}" expects generator "${project.generator ?? 'unknown'}", but this Doxloop project uses "${generator}". Choose another --slug.`);
+    }
+}
+function containedOutput(root, outputDir) {
+    const base = resolve(root);
+    const output = resolve(base, outputDir);
+    if (output === base || !output.startsWith(`${base}${sep}`)) {
+        throw new DoxloopError(`Generator output directory must be inside the project: ${outputDir}`);
+    }
+    return output;
+}
+async function runLocalBuild(generator, command, root, siteUrl) {
+    const environment = { ...process.env, DOXLOOP_SITE_URL: siteUrl, SITE_URL: siteUrl };
+    delete environment.DOXLOOP_TOKEN;
+    delete environment.DOXBRIX_TOKEN;
+    const effectiveCommand = generator === 'hugo'
+        ? `${command} --baseURL ${JSON.stringify(`${siteUrl.replace(/\/$/, '')}/`)}`
+        : generator === 'jekyll'
+            ? `${command} --url ${JSON.stringify(siteUrl.replace(/\/$/, ''))}`
+            : command;
+    const code = await new Promise((resolveExit, reject) => {
+        const child = spawn(effectiveCommand, {
+            cwd: root,
+            env: environment,
+            shell: true,
+            stdio: 'inherit',
+        });
+        child.once('error', reject);
+        child.once('exit', (value) => resolveExit(value ?? 1));
+    });
+    if (code !== 0) {
+        throw new DoxloopError(`Local generator build failed (exit ${code}). Doxloop does not install dependencies during deploy; install them and run \`${command}\` locally to diagnose.`);
+    }
+}
+async function packageStaticOutput(root) {
+    let rootStat;
+    try {
+        rootStat = await lstat(root);
+    }
+    catch {
+        throw new DoxloopError(`Generator build output was not found: ${root}`);
+    }
+    if (!rootStat.isDirectory() || rootStat.isSymbolicLink())
+        throw new DoxloopError('Generator build output must be a real directory, not a symbolic link.');
+    const entries = {};
+    let files = 0;
+    let bytes = 0;
+    let omittedSourceMaps = 0;
+    let hasIndex = false;
+    const visit = async (directory) => {
+        for (const item of await readdir(directory, { withFileTypes: true })) {
+            const absolute = resolve(directory, item.name);
+            const path = relative(root, absolute).split(sep).join('/');
+            const stat = await lstat(absolute);
+            if (stat.isSymbolicLink())
+                throw new DoxloopError(`Build output contains a symbolic link, which cannot be deployed safely: ${path}`);
+            if (stat.isDirectory()) {
+                await visit(absolute);
+                continue;
+            }
+            if (!stat.isFile())
+                throw new DoxloopError(`Build output contains an unsupported file type: ${path}`);
+            if (extname(path).toLowerCase() === '.map') {
+                omittedSourceMaps++;
+                continue;
+            }
+            assertSafeArtifactName(path);
+            if (stat.size > MAX_FILE_BYTES)
+                throw new DoxloopError(`Build output file exceeds ${formatBytes(MAX_FILE_BYTES)}: ${path}`);
+            files++;
+            bytes += stat.size;
+            if (files > MAX_FILES)
+                throw new DoxloopError(`Build output contains more than ${MAX_FILES} files.`);
+            if (bytes > MAX_UNCOMPRESSED_BYTES)
+                throw new DoxloopError(`Build output exceeds ${formatBytes(MAX_UNCOMPRESSED_BYTES)} before compression.`);
+            const data = await readFile(absolute);
+            const text = data.toString('utf8');
+            if (/-----BEGIN (?:RSA |EC |OPENSSH )?PRIVATE KEY-----/.test(text)) {
+                throw new DoxloopError(`Build output appears to contain a private key: ${path}`);
+            }
+            const activeTokens = [process.env.DOXLOOP_TOKEN, process.env.DOXBRIX_TOKEN].filter((value) => Boolean(value && value.length >= 12));
+            if (activeTokens.some((token) => text.includes(token)) || /\bdxb_[A-Za-z0-9_-]{20,}\b/.test(text)) {
+                throw new DoxloopError(`Build output appears to contain a Doxbrix access token: ${path}`);
+            }
+            entries[path] = new Uint8Array(data);
+            if (path === 'index.html')
+                hasIndex = true;
+        }
+    };
+    await visit(root);
+    if (!hasIndex)
+        throw new DoxloopError('Generator output does not contain a root index.html file.');
+    if (files === 0)
+        throw new DoxloopError('Generator produced no deployable files.');
+    const archive = zipSync(entries, { level: 6 });
+    if (archive.byteLength > MAX_ZIP_BYTES)
+        throw new DoxloopError(`Compressed artifact exceeds ${formatBytes(MAX_ZIP_BYTES)}.`);
+    return { archive, files, omittedSourceMaps, sha256: createHash('sha256').update(archive).digest('hex') };
+}
+function assertSafeArtifactName(path) {
+    const name = basename(path).toLowerCase();
+    if (name === '.env' || name.startsWith('.env.') || name === 'id_rsa' || name === 'id_ed25519' ||
+        name === 'credentials' || name.endsWith('.pem') || name.endsWith('.key') || name.endsWith('.p12') || name.endsWith('.pfx')) {
+        throw new DoxloopError(`Build output contains a likely secret file: ${path}`);
+    }
+}
+async function uploadArtifact(upload, bytes) {
+    let response;
+    try {
+        response = await fetch(upload.url, {
+            method: upload.method,
+            headers: upload.headers,
+            body: bytes,
+            redirect: 'error',
+        });
+    }
+    catch (error) {
+        throw new DoxloopError(`Artifact upload failed: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    if (!response.ok)
+        throw new DoxloopError(`Artifact upload failed: ${response.status} ${response.statusText}`);
+}
+async function waitForDeployment(projectId, buildId, override) {
+    const deadline = Date.now() + POLL_TIMEOUT_MS;
+    for (;;) {
+        const response = await authenticatedRequest(`/api/v1/projects/${encodeURIComponent(projectId)}/deployments/${encodeURIComponent(buildId)}`, { method: 'GET' }, override);
+        if (response.deployment.status === 'ready' || response.deployment.status === 'failed' || response.deployment.status === 'canceled')
+            return response.deployment;
+        if (Date.now() >= deadline)
+            throw new DoxloopError(`Deployment is still running after ${POLL_TIMEOUT_MS / 60_000} minutes. Check it in Doxbrix: ${apiUrl(override)}`);
+        await new Promise((resolveWait) => setTimeout(resolveWait, 2_000));
+    }
+}
+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=artifact-deploy.js.map

package/dist/artifact-deploy.js.map

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

package/dist/auth.d.ts

@@ -0,0 +1,17 @@
+interface UserConfig {
+    apiUrl: string;
+    token?: string;
+}
+export declare function apiUrl(override?: string): string;
+export declare function loadUserConfig(): Promise<UserConfig>;
+export declare function saveToken(token: string, baseUrl: string): Promise<void>;
+export declare function logout(): Promise<void>;
+export declare function login(options: {
+    apiUrl?: string;
+    token?: string;
+}): Promise<void>;
+export declare function whoami(override?: string): Promise<void>;
+export declare function authenticatedRequest<T>(path: string, init: RequestInit, override?: string): Promise<T>;
+export declare function authenticatedRequestOptional<T>(path: string, init: RequestInit, override?: string): Promise<T | undefined>;
+export {};
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAWA,UAAU,UAAU;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAqBD,wBAAgB,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAwBhD;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC,UAAU,CAAC,CAS1D;AAED,wBAAsB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ7E;AAED,wBAAsB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAE5C;AAED,wBAAsB,KAAK,CAAC,OAAO,EAAE;IACnC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAA;CACf,GAAG,OAAO,CAAC,IAAI,CAAC,CAoDhB;AA+DD,wBAAsB,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAS7D;AAED,wBAAsB,oBAAoB,CAAC,CAAC,EAC1C,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,WAAW,EACjB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,CAAC,CAAC,CAGZ;AAED,wBAAsB,4BAA4B,CAAC,CAAC,EAClD,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,WAAW,EACjB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAExB"}

package/dist/auth.js

@@ -0,0 +1,245 @@
+import { chmod, mkdir, readFile, rm, writeFile } from 'node:fs/promises';
+import { homedir, hostname } from 'node:os';
+import { dirname, join } from 'node:path';
+import { spawn } from 'node:child_process';
+import { DoxloopError } from './errors.js';
+import { pathExists } from './fs.js';
+const DEFAULT_API_URL = 'https://app.doxbrix.com';
+const TOKEN_PREFIX = 'dxb_';
+const DEVICE_SCOPES = ['docs:read', 'docs:write', 'project:read', 'project:admin'];
+export function apiUrl(override) {
+    const raw = override ?? process.env.DOXLOOP_API_URL ?? DEFAULT_API_URL;
+    let parsed;
+    try {
+        parsed = new URL(raw);
+    }
+    catch {
+        throw new DoxloopError(`Invalid Doxbrix API URL: ${raw}`, 2);
+    }
+    if (parsed.username || parsed.password || parsed.search || parsed.hash) {
+        throw new DoxloopError('The Doxbrix API URL cannot contain credentials, a query, or a fragment.', 2);
+    }
+    if (parsed.protocol !== 'https:' &&
+        !(parsed.protocol === 'http:' && isLoopbackHost(parsed.hostname))) {
+        throw new DoxloopError('The Doxbrix API URL must use HTTPS. HTTP is allowed only for localhost development.', 2);
+    }
+    return parsed.toString().replace(/\/+$/, '');
+}
+export async function loadUserConfig() {
+    const path = configPath();
+    if (!(await pathExists(path)))
+        return { apiUrl: apiUrl() };
+    try {
+        const parsed = JSON.parse(await readFile(path, 'utf8'));
+        return { apiUrl: apiUrl(parsed.apiUrl), ...(parsed.token ? { token: parsed.token } : {}) };
+    }
+    catch {
+        throw new DoxloopError(`Cannot read Doxloop credentials at ${path}.`);
+    }
+}
+export async function saveToken(token, baseUrl) {
+    const path = configPath();
+    await mkdir(dirname(path), { recursive: true, mode: 0o700 });
+    await writeFile(path, `${JSON.stringify({ apiUrl: baseUrl, token }, null, 2)}\n`, {
+        encoding: 'utf8',
+        mode: 0o600,
+    });
+    if (process.platform !== 'win32')
+        await chmod(path, 0o600);
+}
+export async function logout() {
+    await rm(configPath(), { force: true });
+}
+export async function login(options) {
+    const baseUrl = apiUrl(options.apiUrl);
+    const directToken = options.token ?? process.env.DOXLOOP_TOKEN ?? process.env.DOXBRIX_TOKEN;
+    if (directToken) {
+        await verifyAndSaveToken(baseUrl, directToken);
+        return;
+    }
+    let start;
+    try {
+        start = await requestJson(`${baseUrl}/api/v1/auth/device/start`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ name: `doxloop @ ${hostname()}`, scopes: DEVICE_SCOPES }),
+        });
+    }
+    catch {
+        // The server may not offer the device flow; fall back to token paste.
+        start = undefined;
+    }
+    if (!start) {
+        process.stdout.write(`Browser sign-in is unavailable.\nCreate a token at ${baseUrl}/settings/tokens and paste it below.\n`);
+        if (!process.stdin.isTTY) {
+            throw new DoxloopError('Pass --token dxb_… (stdin is not a TTY).');
+        }
+        await verifyAndSaveToken(baseUrl, await readSecret('Token: '));
+        return;
+    }
+    process.stdout.write(`Open ${start.verificationUri}\nEnter code: ${start.userCode}\n`);
+    openBrowser(`${start.verificationUri}?code=${encodeURIComponent(start.userCode)}`);
+    const deadline = Date.now() + start.expiresIn * 1000;
+    while (Date.now() < deadline) {
+        await delay(Math.max(2, start.interval) * 1000);
+        let poll;
+        try {
+            poll = await requestJson(`${baseUrl}/api/v1/auth/device/poll`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({ deviceCode: start.deviceCode }),
+            });
+        }
+        catch {
+            continue;
+        }
+        if (poll.status === 'expired')
+            break;
+        if (poll.status === 'approved') {
+            await verifyAndSaveToken(baseUrl, poll.token);
+            return;
+        }
+    }
+    throw new DoxloopError('Doxbrix authorization expired. Run `doxloop login` again.');
+}
+async function verifyAndSaveToken(baseUrl, token) {
+    if (!token.startsWith(TOKEN_PREFIX)) {
+        throw new DoxloopError(`That does not look like a Doxbrix token (expected a "${TOKEN_PREFIX}" prefix). Create one in the Doxbrix web app under Settings > Tokens.`);
+    }
+    const user = await verifyToken(baseUrl, token);
+    await saveToken(token, baseUrl);
+    process.stdout.write(`Signed in to Doxbrix as ${user.email}.\n`);
+}
+function readSecret(promptText) {
+    process.stdout.write(promptText);
+    return new Promise((resolveSecret, reject) => {
+        const stdin = process.stdin;
+        stdin.setRawMode(true);
+        stdin.resume();
+        stdin.setEncoding('utf8');
+        let value = '';
+        const cleanup = () => {
+            stdin.setRawMode(false);
+            stdin.pause();
+            stdin.off('data', onData);
+        };
+        const onData = (chunk) => {
+            for (const character of chunk) {
+                if (character === '\u0003') {
+                    cleanup();
+                    process.stdout.write('\n');
+                    reject(new DoxloopError('Sign-in cancelled.'));
+                    return;
+                }
+                if (character === '\r' || character === '\n') {
+                    cleanup();
+                    process.stdout.write('\n');
+                    resolveSecret(value.trim());
+                    return;
+                }
+                if (character === '\u007f' || character === '\b') {
+                    value = value.slice(0, -1);
+                    continue;
+                }
+                value += character;
+            }
+        };
+        stdin.on('data', onData);
+    });
+}
+async function verifyToken(baseUrl, token) {
+    try {
+        return await requestJson(`${baseUrl}/api/v1/me`, {
+            headers: { Authorization: `Bearer ${token}` },
+        });
+    }
+    catch {
+        throw new DoxloopError('That token was rejected by the API. Check the token and --api-url, then try again.');
+    }
+}
+export async function whoami(override) {
+    const config = await loadUserConfig();
+    const token = config.token ?? process.env.DOXLOOP_TOKEN ?? process.env.DOXBRIX_TOKEN;
+    if (!token)
+        throw new DoxloopError('Not signed in. Run `doxloop login`.');
+    const account = await requestJson(`${apiUrl(override ?? config.apiUrl)}/api/v1/me`, { headers: { Authorization: `Bearer ${token}` } });
+    process.stdout.write(`${account.email}${account.name ? ` (${account.name})` : ''}\n`);
+}
+export async function authenticatedRequest(path, init, override) {
+    const result = await authenticatedRequestInternal(path, init, override, false);
+    return result;
+}
+export async function authenticatedRequestOptional(path, init, override) {
+    return authenticatedRequestInternal(path, init, override, true);
+}
+async function authenticatedRequestInternal(path, init, override, allowNotFound) {
+    const config = await loadUserConfig();
+    const token = config.token ?? process.env.DOXLOOP_TOKEN ?? process.env.DOXBRIX_TOKEN;
+    if (!token)
+        throw new DoxloopError('Not signed in. Run `doxloop login` first.');
+    const headers = new Headers(init.headers);
+    headers.set('Authorization', `Bearer ${token}`);
+    const url = `${apiUrl(override ?? config.apiUrl)}${path}`;
+    let response;
+    try {
+        response = await fetch(url, { ...init, headers, redirect: 'error' });
+    }
+    catch (error) {
+        throw new DoxloopError(`Cannot connect to ${new URL(url).origin}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    if (allowNotFound && response.status === 404)
+        return undefined;
+    if (!response.ok)
+        throw await responseError(response);
+    return (await response.json());
+}
+async function requestJson(url, init) {
+    let response;
+    try {
+        response = await fetch(url, { ...init, redirect: 'error' });
+    }
+    catch (error) {
+        throw new DoxloopError(`Cannot connect to ${new URL(url).origin}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    if (!response.ok)
+        throw await responseError(response);
+    return (await response.json());
+}
+function isLoopbackHost(hostname) {
+    const normalized = hostname.replace(/^\[|\]$/g, '').toLowerCase();
+    return (normalized === 'localhost' ||
+        normalized === '::1' ||
+        /^127(?:\.\d{1,3}){3}$/.test(normalized));
+}
+async function responseError(response) {
+    let message = `${response.status} ${response.statusText}`;
+    try {
+        const body = (await response.json());
+        if (typeof body.error === 'string')
+            message = body.error;
+        else if (body.error?.message)
+            message = body.error.message;
+        else if (body.message)
+            message = body.message;
+    }
+    catch {
+        // Keep the HTTP status when the response is not JSON.
+    }
+    return new DoxloopError(`Doxbrix API error: ${message}`);
+}
+function configPath() {
+    if (process.platform === 'win32') {
+        return join(process.env.APPDATA ?? join(homedir(), 'AppData', 'Roaming'), 'doxloop', 'config.json');
+    }
+    return join(process.env.XDG_CONFIG_HOME ?? join(homedir(), '.config'), 'doxloop', 'config.json');
+}
+function openBrowser(url) {
+    const command = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'cmd' : 'xdg-open';
+    const args = process.platform === 'win32' ? ['/c', 'start', '', url] : [url];
+    const child = spawn(command, args, { detached: true, stdio: 'ignore' });
+    child.unref();
+}
+function delay(milliseconds) {
+    return new Promise((resolveDelay) => setTimeout(resolveDelay, milliseconds));
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

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

package/dist/author.d.ts

@@ -0,0 +1,30 @@
+import type { AgentName, ApplicationConfig, DocumentationBrief, GeneratorName } from './types.js';
+export type AuthorMode = 'create' | 'update' | 'review';
+export type ScreenshotIntent = 'auto' | 'enabled' | 'disabled';
+export declare function resolveScreenshotIntent(enabled: boolean, disabled: boolean): ScreenshotIntent;
+declare const REASONING_LEVELS: readonly ["minimal", "low", "medium", "high", "xhigh"];
+export type ReasoningLevel = (typeof REASONING_LEVELS)[number];
+export declare function parseReasoning(value: string | undefined): ReasoningLevel | undefined;
+export declare function runAuthor(options: {
+    root: string;
+    mode: AuthorMode;
+    agent?: AgentName;
+    print?: boolean;
+    request?: string;
+    model?: string;
+    reasoning?: ReasoningLevel;
+    screenshots?: ScreenshotIntent;
+}): Promise<number>;
+export declare function agentArguments(name: AgentName, prompt: string, options?: {
+    model?: string;
+    reasoning?: ReasoningLevel;
+    mode?: AuthorMode;
+}): string[];
+export declare function authorPrompt(mode: AuthorMode, sources: Array<{
+    name: string;
+    path: string;
+}>, request?: string, generator?: GeneratorName, documentation?: DocumentationBrief, designReferences?: Array<{
+    url: string;
+}>, changeSummary?: string, screenshots?: ScreenshotIntent, application?: ApplicationConfig): string;
+export {};
+//# sourceMappingURL=author.d.ts.map

package/dist/author.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"author.d.ts","sourceRoot":"","sources":["../src/author.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,SAAS,EACT,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACd,MAAM,YAAY,CAAA;AAEnB,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAA;AACvD,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,CAAA;AAE9D,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,OAAO,GAChB,gBAAgB,CAOlB;AAED,QAAA,MAAM,gBAAgB,wDAAyD,CAAA;AAC/E,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE9D,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,GAAG,SAAS,CAMpF;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE;IACvC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,UAAU,CAAA;IAChB,KAAK,CAAC,EAAE,SAAS,CAAA;IACjB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,cAAc,CAAA;IAC1B,WAAW,CAAC,EAAE,gBAAgB,CAAA;CAC/B,GAAG,OAAO,CAAC,MAAM,CAAC,CAiGlB;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,SAAS,EACf,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IACP,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,cAAc,CAAA;IAC1B,IAAI,CAAC,EAAE,UAAU,CAAA;CACb,GACL,MAAM,EAAE,CA8BV;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,EAC9C,OAAO,CAAC,EAAE,MAAM,EAChB,SAAS,GAAE,aAAyB,EACpC,aAAa,CAAC,EAAE,kBAAkB,EAClC,gBAAgB,GAAE,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,CAAM,EAC7C,aAAa,CAAC,EAAE,MAAM,EACtB,WAAW,GAAE,gBAAyB,EACtC,WAAW,CAAC,EAAE,iBAAiB,GAC9B,MAAM,CA2DR"}