@wafflebase/cli 0.4.9 → 0.5.0

package/dist/commands/docs.js

@@ -1,320 +0,0 @@
-import { extname } from 'node:path';
-import { getGlobalOpts, getClient, getConfig } from './root.js';
-import { output, outputError } from '../output/formatter.js';
-import { printDryRun } from '../client/dry-run.js';
-import { parseContentFormat, runDocsContent } from '../docs/content.js';
-import { exportPdf } from '../docs/pdf-export.js';
-import { exportDocx } from '../docs/docx-export.js';
-import { createImageFetcher } from '../docs/image-fetcher.js';
-import { parsePageRange } from '../docs/page-range.js';
-import { writeBinary } from '../output/binary.js';
-import { runDocsImport } from '../docs/import.js';
-function parseType(value) {
-    if (value === undefined)
-        return undefined;
-    if (value !== 'doc' && value !== 'sheet') {
-        throw new Error(`Invalid --type "${value}". Use "doc" or "sheet".`);
-    }
-    return value;
-}
-const VALID_EXPORT_FORMATS = ['pdf', 'docx'];
-function detectExportFormat(file, formatFlag) {
-    if (formatFlag) {
-        if (!VALID_EXPORT_FORMATS.includes(formatFlag)) {
-            throw new Error(`Invalid --format "${formatFlag}". Use one of: ${VALID_EXPORT_FORMATS.join(', ')}.`);
-        }
-        return formatFlag;
-    }
-    const ext = extname(file).toLowerCase();
-    if (ext === '.pdf')
-        return 'pdf';
-    if (ext === '.docx')
-        return 'docx';
-    throw new Error(`Cannot infer format from "${file}". Pass --format pdf|docx, or use a .pdf/.docx extension.`);
-}
-export function registerDocsCommand(program) {
-    const doc = program
-        .command('docs')
-        .alias('doc')
-        .alias('document')
-        .alias('documents')
-        .description('Manage documents');
-    doc
-        .command('list')
-        .description('List documents in workspace')
-        .option('--type <type>', 'Filter by document type (doc|sheet)')
-        .action(async function () {
-        const opts = getGlobalOpts(this);
-        const { type: typeStr } = this.opts();
-        try {
-            const filterType = parseType(typeStr);
-            const res = await getClient(opts).listDocuments();
-            if (!res.ok)
-                throw new Error(`HTTP ${res.status}`);
-            let data = res.data;
-            if (filterType && Array.isArray(data)) {
-                data = data.filter((d) => (d.type ?? 'sheet') === filterType);
-            }
-            output(data, opts.format, opts.quiet);
-        }
-        catch (e) {
-            outputError(e, opts.quiet);
-        }
-    });
-    doc
-        .command('create <title>')
-        .description('Create a new document')
-        .option('--type <type>', 'Document type (doc|sheet)', 'sheet')
-        .action(async function (title) {
-        const opts = getGlobalOpts(this);
-        const { type: typeStr } = this.opts();
-        try {
-            const type = parseType(typeStr) ?? 'sheet';
-            if (opts.dryRun) {
-                printDryRun(getConfig(opts), 'POST', '/documents', { title, type });
-                return;
-            }
-            const res = await getClient(opts).createDocument(title, type);
-            if (!res.ok)
-                throw new Error(`HTTP ${res.status}`);
-            output(res.data, opts.format, opts.quiet);
-        }
-        catch (e) {
-            outputError(e, opts.quiet);
-        }
-    });
-    doc
-        .command('get <doc-id>')
-        .description('Show document metadata')
-        .action(async function (docId) {
-        const opts = getGlobalOpts(this);
-        try {
-            const res = await getClient(opts).getDocument(docId);
-            if (!res.ok)
-                throw new Error(`HTTP ${res.status}`);
-            output(res.data, opts.format, opts.quiet);
-        }
-        catch (e) {
-            outputError(e, opts.quiet);
-        }
-    });
-    doc
-        .command('rename <doc-id> <title>')
-        .description('Rename a document')
-        .action(async function (docId, title) {
-        const opts = getGlobalOpts(this);
-        if (opts.dryRun) {
-            printDryRun(getConfig(opts), 'PATCH', `/documents/${docId}`, { title });
-            return;
-        }
-        try {
-            const res = await getClient(opts).updateDocument(docId, title);
-            if (!res.ok)
-                throw new Error(`HTTP ${res.status}`);
-            output(res.data, opts.format, opts.quiet);
-        }
-        catch (e) {
-            outputError(e, opts.quiet);
-        }
-    });
-    doc
-        .command('delete <doc-id>')
-        .description('Delete a document')
-        .action(async function (docId) {
-        const opts = getGlobalOpts(this);
-        if (opts.dryRun) {
-            printDryRun(getConfig(opts), 'DELETE', `/documents/${docId}`);
-            return;
-        }
-        try {
-            const res = await getClient(opts).deleteDocument(docId);
-            if (!res.ok)
-                throw new Error(`HTTP ${res.status}`);
-            output(res.data, opts.format, opts.quiet);
-        }
-        catch (e) {
-            outputError(e, opts.quiet);
-        }
-    });
-    doc
-        .command('content <doc-id>')
-        .description('Read document content as JSON, Markdown, or plain text')
-        // NOTE: `--format` is intentionally not redeclared here. The global
-        // `--format` option (declared in `createProgram`) catches the user's
-        // value because commander resolves duplicate-named flags through the
-        // earliest parent that owns them. Reading via `opts.format` (the
-        // merged form) keeps a single source of truth and lets
-        // `parseContentFormat` validate that the value is one of json|md|text.
-        .option('--pages <range>', 'Page range to include (e.g. 1-3,5)')
-        .option('--include-header-footer', 'Include header/footer (md/text)', false)
-        .option('--inline-images', 'Inline data: image URLs (md only)', false)
-        .option('--out <file>', 'Output file (- for stdout)')
-        .option('--force', 'Overwrite existing output file', false)
-        .action(async function (docId) {
-        const opts = getGlobalOpts(this);
-        const local = this.opts();
-        try {
-            const format = parseContentFormat(opts.format);
-            if (opts.dryRun) {
-                printDryRun(getConfig(opts), 'GET', `/documents/${docId}/content`);
-                return;
-            }
-            const res = await getClient(opts).getDocContent(docId);
-            if (!res.ok) {
-                const body = res.data;
-                if (body?.error) {
-                    // Surface backend-shaped errors (e.g., TYPE_MISMATCH) verbatim
-                    // so agents reading stderr can act on the `code` field.
-                    console.error(JSON.stringify(body, null, 2));
-                    process.exitCode = 1;
-                    return;
-                }
-                throw new Error(`HTTP ${res.status}`);
-            }
-            runDocsContent({
-                doc: res.data,
-                format,
-                pages: local.pages,
-                includeHeaderFooter: local.includeHeaderFooter,
-                inlineImages: local.inlineImages,
-                out: local.out,
-                force: local.force,
-                quiet: opts.quiet,
-            });
-        }
-        catch (e) {
-            outputError(e, opts.quiet);
-        }
-    });
-    doc
-        .command('export <doc-id> <file>')
-        .description('Export a document to PDF or DOCX')
-        // NOTE: `--format` reuses the global option for the same reason
-        // documented on `docs content` above; we route through `opts.format`
-        // and use commander's `getOptionValueSourceWithGlobals` to tell a
-        // user-supplied value from the implicit default. That keeps an
-        // explicit `--format json` from silently falling through to the
-        // extension — it now surfaces as the documented "invalid format"
-        // error.
-        .option('--pages <range>', 'Page range to export (PDF only)')
-        .option('--include-header-footer', 'Include header/footer regions', true)
-        .option('--force', 'Overwrite existing output file', false)
-        .action(async function (docId, file) {
-        const opts = getGlobalOpts(this);
-        const local = this.opts();
-        try {
-            // `'cli'` source means the user typed the flag (or its alias)
-            // on the command line; anything else (`'default'`, `'env'`,
-            // `'config'`) is treated as "no override intended" so the
-            // file extension wins.
-            const formatSource = this.getOptionValueSourceWithGlobals('format');
-            const formatOverride = formatSource === 'cli' ? opts.format : undefined;
-            const format = detectExportFormat(file, formatOverride);
-            if (opts.dryRun) {
-                printDryRun(getConfig(opts), 'GET', `/documents/${docId}/content`);
-                return;
-            }
-            const res = await getClient(opts).getDocContent(docId);
-            if (!res.ok) {
-                const body = res.data;
-                if (body?.error) {
-                    console.error(JSON.stringify(body, null, 2));
-                    process.exitCode = 1;
-                    return;
-                }
-                throw new Error(`HTTP ${res.status}`);
-            }
-            const fetchedDoc = res.data;
-            // Image inlines reference URLs that PdfExporter and DocxExporter
-            // can't resolve on their own. The fetcher walks each unique
-            // `src`, GETs it (via `globalThis.fetch`), and hands back a
-            // Blob. Relative URLs (`/images/<id>`) resolve against the
-            // configured server base so the same doc round-trips between
-            // the editor (browser-relative) and the CLI.
-            const imageFetcher = createImageFetcher({
-                serverBase: getConfig(opts).server,
-            });
-            let bytes;
-            if (format === 'pdf') {
-                // Pagination uses the FontkitMeasurer's coarse Latin estimate
-                // when no Korean fonts are needed; we still pre-page to know
-                // the document's page count for `parsePageRange`. PdfExporter
-                // does the authoritative paint-time pagination internally.
-                let pageRange = undefined;
-                if (local.pages) {
-                    // Resolve pages against the rendered PDF's page count
-                    // (rather than running our own paginator twice). We render
-                    // the full PDF first, then strip non-selected pages —
-                    // see `extractPages` in pdf-export.ts.
-                    const fullPdf = await exportPdf(fetchedDoc, {
-                        includeHeaderFooter: local.includeHeaderFooter,
-                        imageFetcher,
-                    });
-                    const total = await pdfPageCount(fullPdf);
-                    pageRange = parsePageRange(local.pages, total);
-                    if (!opts.quiet) {
-                        for (const w of pageRange.warnings)
-                            console.error(w);
-                    }
-                    bytes = await exportPdf(fetchedDoc, {
-                        includeHeaderFooter: local.includeHeaderFooter,
-                        pages: pageRange,
-                        imageFetcher,
-                    });
-                }
-                else {
-                    bytes = await exportPdf(fetchedDoc, {
-                        includeHeaderFooter: local.includeHeaderFooter,
-                        imageFetcher,
-                    });
-                }
-            }
-            else {
-                if (local.pages && !opts.quiet) {
-                    console.error('DOCX has no page concept — exporting full document, --pages ignored.');
-                }
-                bytes = await exportDocx(fetchedDoc, {
-                    includeHeaderFooter: local.includeHeaderFooter,
-                    imageFetcher,
-                });
-            }
-            writeBinary(bytes, file, { force: local.force, quiet: opts.quiet });
-        }
-        catch (e) {
-            outputError(e, opts.quiet);
-        }
-    });
-    registerDocsImportCommand(doc);
-}
-async function pdfPageCount(bytes) {
-    const { PDFDocument } = await import('pdf-lib');
-    const pdf = await PDFDocument.load(bytes);
-    return pdf.getPageCount();
-}
-export function registerDocsImportCommand(doc) {
-    doc
-        .command('import <file>')
-        .description('Import a .docx file as a new (or replacement) document')
-        .option('--title <title>', 'Document title (default: file basename)')
-        .option('--replace <doc-id>', 'Replace content of an existing document')
-        .option('--yes', 'Skip --replace confirmation prompt', false)
-        .action(async function (file) {
-        const opts = getGlobalOpts(this);
-        const local = this.opts();
-        try {
-            const result = await runDocsImport({
-                file,
-                title: local.title,
-                replace: local.replace,
-                yes: local.yes,
-                quiet: opts.quiet,
-                dryRun: opts.dryRun,
-            }, getClient(opts));
-            if (result.exitCode !== 0)
-                process.exitCode = result.exitCode;
-        }
-        catch (e) {
-            outputError(e, opts.quiet);
-        }
-    });
-}

package/dist/commands/login.d.ts

@@ -1,2 +0,0 @@
-import { Command } from 'commander';
-export declare function registerLoginCommand(program: Command): void;

package/dist/commands/login.js

@@ -1,220 +0,0 @@
-import { createServer } from 'node:http';
-import { createInterface } from 'node:readline';
-import { loadSession, saveSession, decodeJwtExpiry, } from '../config/session.js';
-import { DEFAULT_SERVER } from '../config/config.js';
-export function registerLoginCommand(program) {
-    program
-        .command('login')
-        .description('Log in via GitHub OAuth in the browser')
-        .action(async function () {
-        const parentOpts = this.optsWithGlobals();
-        const server = (parentOpts.server ?? DEFAULT_SERVER).replace(/\/$/, '');
-        // 1. Check existing session
-        const existing = loadSession();
-        if (existing) {
-            const answer = await ask(`Logged in as ${existing.user.username}. Continue? [Y/n] `);
-            if (answer.toLowerCase() === 'n') {
-                console.log('Cancelled.');
-                return;
-            }
-        }
-        // 2. Start local HTTP server
-        const { port, waitForCallback, close } = await startCallbackServer();
-        // 3. Build OAuth URL and open browser
-        const oauthUrl = `${server}/auth/github?mode=cli&port=${port}`;
-        console.error(`Opening browser: ${oauthUrl}`);
-        console.error('If the browser does not open, visit the URL above.');
-        try {
-            const open = (await import('open')).default;
-            await open(oauthUrl);
-        }
-        catch {
-            // Browser open failed — URL was already printed
-        }
-        // 4. Wait for callback
-        let code;
-        try {
-            code = await waitForCallback();
-        }
-        finally {
-            close();
-        }
-        // 5. Exchange code for tokens
-        const exchangeRes = await fetch(`${server}/auth/cli/exchange`, {
-            method: 'POST',
-            headers: { 'Content-Type': 'application/json' },
-            body: JSON.stringify({ code }),
-        });
-        if (!exchangeRes.ok) {
-            console.error('Token exchange failed. Try again with `wafflebase login`.');
-            process.exit(1);
-        }
-        const tokens = (await exchangeRes.json());
-        // 6. Get user info
-        const meRes = await fetch(`${server}/auth/me`, {
-            headers: { Authorization: `Bearer ${tokens.accessToken}` },
-        });
-        if (!meRes.ok) {
-            console.error('Failed to fetch user info.');
-            process.exit(1);
-        }
-        const user = (await meRes.json());
-        // 7. Get workspace list
-        const wsRes = await fetch(`${server}/workspaces`, {
-            headers: { Authorization: `Bearer ${tokens.accessToken}` },
-        });
-        if (!wsRes.ok) {
-            console.error(`Failed to fetch workspaces (HTTP ${wsRes.status}). Try again with \`wafflebase login\`.`);
-            process.exit(1);
-        }
-        const workspaces = (await wsRes.json());
-        // 8. Select workspace
-        let activeWorkspace = '';
-        if (workspaces.length === 0) {
-            console.log('No workspaces found.');
-        }
-        else if (workspaces.length === 1) {
-            activeWorkspace = workspaces[0].id;
-            console.log(`Workspace: ${workspaces[0].name}`);
-        }
-        else {
-            console.log('Select a workspace:');
-            workspaces.forEach((ws, i) => {
-                console.log(`  ${i + 1}. ${ws.name} (${ws.id.slice(0, 8)})`);
-            });
-            const choice = await ask('Enter number: ');
-            const idx = parseInt(choice, 10) - 1;
-            if (idx >= 0 && idx < workspaces.length) {
-                activeWorkspace = workspaces[idx].id;
-            }
-            else {
-                activeWorkspace = workspaces[0].id;
-                console.log(`Invalid choice, using ${workspaces[0].name}.`);
-            }
-        }
-        // 9. Save session
-        const session = {
-            server,
-            user,
-            accessToken: tokens.accessToken,
-            refreshToken: tokens.refreshToken,
-            expiresAt: decodeJwtExpiry(tokens.accessToken),
-            activeWorkspace,
-            workspaces,
-        };
-        saveSession(session);
-        console.log(`Logged in as ${user.username}.`);
-    });
-}
-function ask(prompt) {
-    const rl = createInterface({ input: process.stdin, output: process.stderr });
-    return new Promise((resolve) => {
-        rl.question(prompt, (answer) => {
-            rl.close();
-            resolve(answer.trim());
-        });
-    });
-}
-function startCallbackServer() {
-    return new Promise((resolve, reject) => {
-        let settled = false;
-        let callbackResolve;
-        let callbackReject;
-        const callbackPromise = new Promise((res, rej) => {
-            callbackResolve = res;
-            callbackReject = rej;
-        });
-        const srv = createServer((req, res) => {
-            const url = new URL(req.url ?? '/', `http://127.0.0.1`);
-            if (url.pathname !== '/callback') {
-                res.writeHead(404);
-                res.end('Not found');
-                return;
-            }
-            const code = url.searchParams.get('code');
-            if (!code) {
-                res.writeHead(400);
-                res.end('Missing code');
-                return;
-            }
-            res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
-            res.end(`<!DOCTYPE html>
-<html lang="en">
-<head>
-<meta charset="utf-8">
-<meta name="viewport" content="width=device-width, initial-scale=1">
-<title>Wafflebase CLI</title>
-<style>
-  body {
-    font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
-    display: flex;
-    justify-content: center;
-    align-items: center;
-    min-height: 100vh;
-    margin: 0;
-    background: #fafafa;
-    color: #1a1a1a;
-  }
-  .card {
-    text-align: center;
-    padding: 3rem 2.5rem;
-    background: #fff;
-    border-radius: 12px;
-    box-shadow: 0 1px 3px rgba(0,0,0,0.08), 0 4px 12px rgba(0,0,0,0.04);
-  }
-  .icon { font-size: 2.5rem; margin-bottom: 0.5rem; }
-  h2 { margin: 0 0 0.5rem; font-size: 1.25rem; font-weight: 600; }
-  p { margin: 0; color: #666; font-size: 0.95rem; }
-</style>
-</head>
-<body>
-  <div class="card">
-    <div class="icon">&#10003;</div>
-    <h2>Login successful!</h2>
-    <p>You can close this tab and return to the terminal.</p>
-  </div>
-</body>
-</html>`);
-            if (!settled) {
-                settled = true;
-                callbackResolve(code);
-            }
-        });
-        const timeout = setTimeout(() => {
-            if (!settled) {
-                settled = true;
-                callbackReject(new Error('Login timed out. Try again with `wafflebase login`.'));
-            }
-            srv.close();
-        }, 30_000);
-        // Try to listen on a random port (up to 3 attempts)
-        let attempts = 0;
-        const tryListen = () => {
-            attempts++;
-            srv.listen(0, '127.0.0.1', () => {
-                const addr = srv.address();
-                if (!addr || typeof addr === 'string') {
-                    reject(new Error('Failed to start callback server'));
-                    return;
-                }
-                resolve({
-                    port: addr.port,
-                    waitForCallback: () => callbackPromise,
-                    close: () => {
-                        clearTimeout(timeout);
-                        srv.close();
-                    },
-                });
-            });
-        };
-        srv.on('error', (err) => {
-            if (err.code === 'EADDRINUSE' && attempts < 3) {
-                tryListen();
-            }
-            else {
-                reject(err);
-            }
-        });
-        tryListen();
-    });
-}

package/dist/commands/logout.d.ts

@@ -1,2 +0,0 @@
-import { Command } from 'commander';
-export declare function registerLogoutCommand(program: Command): void;

package/dist/commands/logout.js

@@ -1,10 +0,0 @@
-import { clearSession } from '../config/session.js';
-export function registerLogoutCommand(program) {
-    program
-        .command('logout')
-        .description('Log out and clear session')
-        .action(() => {
-        clearSession();
-        console.log('Logged out.');
-    });
-}

package/dist/commands/root.d.ts

@@ -1,18 +0,0 @@
-import { Command } from 'commander';
-import { type CliConfig } from '../config/config.js';
-import { HttpClient } from '../client/http-client.js';
-import type { OutputFormat } from '../output/formatter.js';
-export interface GlobalOpts {
-    server?: string;
-    apiKey?: string;
-    workspace?: string;
-    profile?: string;
-    format: OutputFormat;
-    quiet: boolean;
-    verbose: boolean;
-    dryRun: boolean;
-}
-export declare function getGlobalOpts(cmd: Command): GlobalOpts;
-export declare function getConfig(opts: GlobalOpts): CliConfig;
-export declare function getClient(opts: GlobalOpts): HttpClient;
-export declare function createProgram(): Command;

package/dist/commands/root.js

@@ -1,37 +0,0 @@
-import { createRequire } from 'node:module';
-import { Command } from 'commander';
-import { resolveConfig } from '../config/config.js';
-import { HttpClient } from '../client/http-client.js';
-const require = createRequire(import.meta.url);
-const { version } = require('../../package.json');
-export function getGlobalOpts(cmd) {
-    const root = cmd.optsWithGlobals();
-    return root;
-}
-export function getConfig(opts) {
-    return resolveConfig({
-        server: opts.server,
-        apiKey: opts.apiKey,
-        workspace: opts.workspace,
-        profile: opts.profile,
-    });
-}
-export function getClient(opts) {
-    return new HttpClient(getConfig(opts));
-}
-export function createProgram() {
-    const program = new Command();
-    program
-        .name('wafflebase')
-        .description('CLI for Wafflebase spreadsheet API')
-        .version(version)
-        .option('--server <url>', 'Server URL')
-        .option('--api-key <key>', 'API key')
-        .option('--workspace <id>', 'Workspace ID')
-        .option('--profile <name>', 'Config profile', 'default')
-        .option('--format <fmt>', 'Output format (json, table, csv)', 'json')
-        .option('--quiet', 'Suppress output', false)
-        .option('--verbose', 'Verbose output', false)
-        .option('--dry-run', 'Show request without executing', false);
-    return program;
-}

package/dist/commands/schema.d.ts

@@ -1,2 +0,0 @@
-import { Command } from 'commander';
-export declare function registerSchemaCommand(program: Command): void;

package/dist/commands/schema.js

@@ -1,28 +0,0 @@
-import { getGlobalOpts } from './root.js';
-import { output } from '../output/formatter.js';
-import { getCommandSchema, getAllCommandSchemas } from '../schema/registry.js';
-export function registerSchemaCommand(program) {
-    program
-        .command('schema [command]')
-        .description('Describe command parameters and response shape')
-        .action(function (commandName) {
-        const opts = getGlobalOpts(this);
-        if (commandName) {
-            const schema = getCommandSchema(commandName);
-            if (!schema) {
-                console.error(JSON.stringify({ error: { code: 'NOT_FOUND', message: `Unknown command: ${commandName}` } }, null, 2));
-                process.exitCode = 1;
-                return;
-            }
-            output(schema, opts.format, opts.quiet);
-        }
-        else {
-            const commands = getAllCommandSchemas().map((c) => ({
-                name: c.name,
-                description: c.description,
-                safety: c.safety,
-            }));
-            output({ commands }, opts.format, opts.quiet);
-        }
-    });
-}

package/dist/commands/sheets-export.d.ts

@@ -1,2 +0,0 @@
-import { Command } from 'commander';
-export declare function registerSheetsExportCommand(parent: Command): void;