@dboio/cli 0.4.1

package/src/commands/login.js

@@ -0,0 +1,97 @@
+import { Command } from 'commander';
+import { loadConfig, saveUserInfo, saveUserProfile, ensureGitignore } from '../lib/config.js';
+import { DboClient } from '../lib/client.js';
+import { log } from '../lib/logger.js';
+
+export const loginCommand = new Command('login')
+  .description('Authenticate with a DBO.io instance')
+  .option('-u, --username <value>', 'Username')
+  .option('-e, --email <value>', 'Email')
+  .option('--phone <value>', 'Phone number')
+  .option('-p, --password <value>', 'Password')
+  .option('--passkey <value>', 'Passkey')
+  .option('--domain <host>', 'Override domain')
+  .action(async (options) => {
+    try {
+      const config = await loadConfig();
+      const client = new DboClient({ domain: options.domain });
+
+      let username = options.username || options.email || options.phone;
+      let password = options.password || options.passkey;
+
+      // Fall back to stored username (password is never stored — prompt every time)
+      if (!username) username = config.username;
+
+      // Interactive prompt if still missing
+      if (!username || !password) {
+        const inquirer = (await import('inquirer')).default;
+        const answers = await inquirer.prompt([
+          { type: 'input', name: 'username', message: 'Username (email):', default: config.username, when: !username },
+          { type: 'password', name: 'password', message: 'Password:', mask: '*', when: !password },
+        ]);
+        username = username || answers.username;
+        password = password || answers.password;
+      }
+
+      // Build auth params
+      const params = new URLSearchParams();
+      if (options.email) params.append('_email', username);
+      else if (options.phone) params.append('_phonenumber', username);
+      else params.append('_username', username);
+
+      if (options.passkey) params.append('_passkey', password);
+      else params.append('_password', password);
+
+      const result = await client.postUrlEncoded('/api/authenticate', params.toString());
+
+      if (result.successful) {
+        log.success(`Authenticated as ${username} on ${await client.getDomain()}`);
+
+        // Ensure sensitive files are gitignored
+        await ensureGitignore(['.dbo/credentials.json', '.dbo/cookies.txt']);
+
+        // Fetch current user info to store ID and UID for future submissions
+        try {
+          const userResult = await client.get('/api/output/31799e38f0854956a47f10', { '_format': 'json_raw' });
+          const userData = userResult.payload || userResult.data;
+          const rows = Array.isArray(userData) ? userData : (userData?.Rows || userData?.rows || []);
+          if (rows.length > 0) {
+            const row = rows[0];
+            const userUid = row.UID || row.uid;
+            const userId = row.ID || row.id || row.UserID || row.userId;
+            const info = {};
+            if (userUid) info.userUid = userUid;
+            if (userId) info.userId = String(userId);
+            if (info.userUid || info.userId) {
+              await saveUserInfo(info);
+              if (info.userId) log.dim(`  User ID:  ${info.userId}`);
+              if (info.userUid) log.dim(`  User UID: ${info.userUid}`);
+            }
+
+            // Save user profile (name, email) for package.json population
+            const firstName = row.FirstName || row.firstname || row.first_name;
+            const lastName = row.LastName || row.lastname || row.last_name;
+            const email = row.Email || row.email;
+            const profile = {};
+            if (firstName) profile.FirstName = firstName;
+            if (lastName) profile.LastName = lastName;
+            if (email) profile.Email = email;
+            if (Object.keys(profile).length > 0) {
+              await saveUserProfile(profile);
+              if (firstName || lastName) log.dim(`  Name:     ${[firstName, lastName].filter(Boolean).join(' ')}`);
+              if (email) log.dim(`  Email:    ${email}`);
+            }
+          }
+        } catch {
+          log.dim('  Could not retrieve user info (non-critical)');
+        }
+      } else {
+        log.error('Authentication failed');
+        for (const msg of result.messages) log.label('Message', msg);
+        process.exit(1);
+      }
+    } catch (err) {
+      log.error(err.message);
+      process.exit(1);
+    }
+  });

package/src/commands/logout.js

@@ -0,0 +1,22 @@
+import { Command } from 'commander';
+import { unlink } from 'fs/promises';
+import { DboClient } from '../lib/client.js';
+import { getActiveCookiesPath } from '../lib/config.js';
+import { log } from '../lib/logger.js';
+
+export const logoutCommand = new Command('logout')
+  .description('Log out and clear session')
+  .action(async () => {
+    try {
+      const client = new DboClient();
+      await client.postUrlEncoded('/api/authenticate', '_logout=true');
+
+      const cookiesPath = await getActiveCookiesPath();
+      try { await unlink(cookiesPath); } catch { /* no cookies file */ }
+
+      log.success('Logged out and session cleared.');
+    } catch (err) {
+      log.error(err.message);
+      process.exit(1);
+    }
+  });

package/src/commands/media.js

@@ -0,0 +1,46 @@
+import { Command } from 'commander';
+import { writeFile } from 'fs/promises';
+import { DboClient } from '../lib/client.js';
+import { formatResponse, formatError } from '../lib/formatter.js';
+import { log } from '../lib/logger.js';
+
+export const mediaCommand = new Command('media')
+  .description('Get media from DBO.io')
+  .argument('[uid]', 'Media UID')
+  .option('--id <id>', 'Media by numeric ID')
+  .option('--path <path>', 'Media by path')
+  .option('-o, --output <path>', 'Save to local file')
+  .option('--download', 'Force download (attachment disposition)')
+  .option('-v, --verbose', 'Show HTTP request details')
+  .option('--domain <host>', 'Override domain')
+  .action(async (uid, options) => {
+    try {
+      const client = new DboClient({ domain: options.domain, verbose: options.verbose });
+      let path;
+      if (options.id) path = `/api/media/id/${options.id}`;
+      else if (options.path) path = `/dir/${options.path}`;
+      else if (uid) path = `/api/media/${uid}`;
+      else { console.error('Error: provide a media UID, --id, or --path'); process.exit(1); }
+
+      const params = {};
+      if (options.download) params['_download'] = 'true';
+
+      const baseUrl = await client.getBaseUrl();
+      const fullUrl = `${baseUrl}${path}${Object.keys(params).length ? '?' + new URLSearchParams(params) : ''}`;
+
+      // For media, we need raw binary response
+      const response = await client.request(path + (Object.keys(params).length ? '?' + new URLSearchParams(params) : ''));
+
+      if (options.output) {
+        const buffer = Buffer.from(await response.arrayBuffer());
+        await writeFile(options.output, buffer);
+        log.success(`Saved to ${options.output} (${buffer.length} bytes)`);
+      } else {
+        const text = await response.text();
+        log.plain(text);
+      }
+    } catch (err) {
+      formatError(err);
+      process.exit(1);
+    }
+  });

package/src/commands/message.js

@@ -0,0 +1,28 @@
+import { Command } from 'commander';
+import { DboClient } from '../lib/client.js';
+import { formatResponse, formatError } from '../lib/formatter.js';
+
+export const messageCommand = new Command('message')
+  .description('Send a message via DBO.io (email, SMS, chatbot)')
+  .argument('<uid>', 'Content UID for the message template')
+  .option('-C, --confirm <value>', 'Commit: true (default) or false', 'true')
+  .option('--thread <id>', 'Thread ID for chatbot conversations')
+  .option('--json', 'Output raw JSON')
+  .option('--jq <expr>', 'Filter JSON response with jq-like expression')
+  .option('-v, --verbose', 'Show HTTP request details')
+  .option('--domain <host>', 'Override domain')
+  .action(async (uid, options) => {
+    try {
+      const client = new DboClient({ domain: options.domain, verbose: options.verbose });
+      const params = new URLSearchParams();
+      params.append('_confirm', options.confirm);
+      if (options.thread) params.append('ThreadID', options.thread);
+
+      const result = await client.postUrlEncoded(`/api/message/content/${uid}`, params.toString());
+      formatResponse(result, { json: options.json, jq: options.jq });
+      if (!result.successful) process.exit(1);
+    } catch (err) {
+      formatError(err);
+      process.exit(1);
+    }
+  });

package/src/commands/output.js

@@ -0,0 +1,129 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { DboClient } from '../lib/client.js';
+import { formatResponse, formatError } from '../lib/formatter.js';
+import { saveToDisk } from '../lib/save-to-disk.js';
+import { log } from '../lib/logger.js';
+
+function collect(value, previous) {
+  return previous.concat([value]);
+}
+
+export const outputCommand = new Command('output')
+  .description('Query data from DBO.io outputs or entities')
+  .argument('[uid]', 'Output UID')
+  .option('-e, --entity <uid>', 'Query by entity UID')
+  .option('--row <id>', 'Specific row ID')
+  .option('--filter <expr>', 'Filter expression (repeatable)', collect, [])
+  .option('--format <type>', 'Output format: json, html, csv, xml, txt, pdf')
+  .option('--sort <expr>', 'Sort expression (repeatable)', collect, [])
+  .option('--search <expr>', 'Full-text search')
+  .option('--page <n>', 'Page number')
+  .option('--rows-per-page <n>', 'Rows per page')
+  .option('--maxrows <n>', 'Maximum rows')
+  .option('--rows <range>', 'Row range (e.g., 1-10)')
+  .option('--template <value>', 'Custom template')
+  .option('--debug', 'Include debug info')
+  .option('--debug-sql', 'Include SQL debug info')
+  .option('--meta', 'Use meta output endpoint')
+  .option('--meta-column <uid>', 'Column metadata')
+  .option('--save', 'Interactive save-to-disk mode')
+  .option('--save-filename <col>', 'Column for filenames (non-interactive)')
+  .option('--save-path <col>', 'Column for file path (non-interactive)')
+  .option('--save-content <col>', 'Column for file content (non-interactive)')
+  .option('--save-extension <col>', 'Column or literal extension (non-interactive)')
+  .option('--columns <list>', 'Comma-separated columns to display (e.g., UserID,FirstName,Email)')
+  .option('--json', 'Output raw JSON')
+  .option('--jq <expr>', 'Filter JSON response with jq-like expression (implies --json)')
+  .option('-v, --verbose', 'Show HTTP request details')
+  .option('--domain <host>', 'Override domain')
+  .action(async (uid, options) => {
+    try {
+      const client = new DboClient({ domain: options.domain, verbose: options.verbose });
+
+      // Build request path
+      let path;
+      if (options.metaColumn) {
+        path = `/api/output/meta/column/${options.metaColumn}`;
+      } else if (options.meta && options.entity) {
+        path = `/api/output/meta/entity/${options.entity}`;
+      } else if (options.entity) {
+        path = options.row
+          ? `/api/output/entity/${options.entity}/${options.row}`
+          : `/api/output/entity/${options.entity}`;
+      } else if (uid) {
+        path = `/api/output/${uid}`;
+      } else {
+        console.error('Error: provide an output UID or use --entity <uid>');
+        process.exit(1);
+      }
+
+      // Build query params — default to json_raw for normalized data
+      const params = { '_format': options.format || 'json_raw' };
+      if (options.search) params['_search'] = options.search;
+      if (options.page) params['_page'] = options.page;
+      if (options.rowsPerPage) params['_RowsPerPage'] = options.rowsPerPage;
+      if (options.maxrows) params['_maxrows'] = options.maxrows;
+      if (options.rows) params['_rows'] = options.rows;
+      if (options.template) params['_template'] = options.template;
+      if (options.debug) params['_debug'] = 'true';
+      if (options.debugSql) params['_debug_sql'] = 'true';
+
+      for (const f of options.filter) {
+        const atIdx = f.indexOf('=');
+        if (atIdx !== -1) {
+          const key = f.substring(0, atIdx);
+          const value = f.substring(atIdx + 1);
+          // Support key:modifier=value or key=value
+          if (key.includes(':')) {
+            const [col, mod] = key.split(':');
+            params[`_filter@${col}:${mod}`] = value;
+          } else {
+            params[`_filter@${key}`] = value;
+          }
+        }
+      }
+
+      for (const s of options.sort) {
+        const [col, dir] = s.includes(':') ? s.split(':') : [s, 'asc'];
+        params[`_sort@${col}`] = dir;
+      }
+
+      // For save mode or jq mode, force json_raw if user didn't set a custom format
+      if ((options.save || options.saveFilename || options.jq) && !options.format) {
+        params['_format'] = 'json_raw';
+      }
+
+      const result = await client.get(path, params);
+
+      // Save to disk mode
+      if (options.save || options.saveFilename) {
+        log.success(`Pulled from ${chalk.underline(result.url || '')}`);
+        const data = result.payload || result.data;
+        const rows = Array.isArray(data) ? data : (data?.Rows || data?.rows || [data]);
+        if (rows.length === 0) {
+          log.warn('No records found.');
+          return;
+        }
+        log.info(`${rows.length} record(s) to save`);
+        const columns = Object.keys(rows[0]);
+        await saveToDisk(rows, columns, {
+          entity: options.entity || null,
+          saveFilename: options.saveFilename,
+          savePath: options.savePath,
+          saveContent: options.saveContent,
+          saveExtension: options.saveExtension,
+          nonInteractive: !!options.saveFilename,
+        });
+        return;
+      }
+
+      // Default to colorized JSON when using json_raw (no explicit --format, --json, or --jq)
+      const jq = options.jq || (!options.format && !options.json ? '.' : undefined);
+      formatResponse(result, { json: options.json, jq, columns: options.columns });
+      if (!result.successful && !result.ok) process.exit(1);
+    } catch (err) {
+      formatError(err);
+      process.exit(1);
+    }
+  });

package/src/commands/pull.js

@@ -0,0 +1,109 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { DboClient } from '../lib/client.js';
+import { formatError } from '../lib/formatter.js';
+import { saveToDisk } from '../lib/save-to-disk.js';
+import { log } from '../lib/logger.js';
+
+function collect(value, previous) {
+  return previous.concat([value]);
+}
+
+export const pullCommand = new Command('pull')
+  .description('Pull records from DBO.io to local files (default entity: content)')
+  .argument('[uid]', 'Record UID (optional)')
+  .option('-e, --entity <uid>', 'Entity to pull from (default: content)', 'content')
+  .option('--filter <expr>', 'Filter expression (repeatable)', collect, [])
+  .option('--maxrows <n>', 'Maximum rows to pull')
+  .option('--sort <expr>', 'Sort expression (repeatable)', collect, [])
+  .option('-v, --verbose', 'Show HTTP request details')
+  .option('--domain <host>', 'Override domain')
+  .action(async (uid, options) => {
+    try {
+      const client = new DboClient({ domain: options.domain, verbose: options.verbose });
+      const entity = options.entity;
+      const params = { '_format': 'json_raw' };
+      if (options.maxrows) params['_maxrows'] = options.maxrows;
+
+      for (const f of options.filter) {
+        const atIdx = f.indexOf('=');
+        if (atIdx !== -1) {
+          const key = f.substring(0, atIdx);
+          const value = f.substring(atIdx + 1);
+          if (key.includes(':')) {
+            const [col, mod] = key.split(':');
+            params[`_filter@${col}:${mod}`] = value;
+          } else {
+            params[`_filter@${key}`] = value;
+          }
+        }
+      }
+
+      for (const s of options.sort) {
+        const [col, dir] = s.includes(':') ? s.split(':') : [s, 'asc'];
+        params[`_sort@${col}`] = dir;
+      }
+
+      let path;
+      if (uid) {
+        path = `/api/output/entity/${entity}/${uid}`;
+      } else {
+        path = `/api/output/entity/${entity}`;
+      }
+
+      const result = await client.get(path, params);
+
+      log.success(`Pulled from ${chalk.underline(result.url || '')}`);
+
+      const data = result.payload || result.data;
+
+      // Validate we got actual JSON data, not raw HTML
+      if (data && data.raw && typeof data.raw === 'string') {
+        log.error(`Received non-JSON response. Check that entity "${entity}" exists.`);
+        log.dim(`  Hint: use --entity (double dash) not -entity`);
+        process.exit(1);
+      }
+
+      const rows = Array.isArray(data) ? data : (data?.Rows || data?.rows || [data]);
+
+      if (rows.length === 0) {
+        log.warn('No records found.');
+        return;
+      }
+
+      log.info(`${rows.length} record(s) to save`);
+
+      const columns = Object.keys(rows[0]);
+
+      if (columns.length <= 1) {
+        log.error(`Response has no usable columns. Check the entity name and UID.`);
+        process.exit(1);
+      }
+
+      // Content entity has well-known defaults — skip prompts
+      const isContent = entity === 'content';
+
+      if (isContent) {
+        await saveToDisk(rows, columns, {
+          entity,
+          saveFilename: columns.includes('Name') ? 'Name' : 'UID',
+          savePath: columns.includes('Path') ? 'Path' : null,
+          saveContent: columns.includes('Content') ? 'Content' : null,
+          saveExtension: columns.includes('Extension') ? 'Extension' : null,
+          nonInteractive: false, // still prompt for overwrites
+          contentFileMap: columns.includes('Content') ? {
+            Content: { suffix: '', extensionSource: columns.includes('Extension') ? 'Extension' : null, extension: 'txt' },
+          } : null,
+        });
+      } else {
+        // Other entities: interactive prompts for column selection
+        await saveToDisk(rows, columns, {
+          entity,
+          nonInteractive: false,
+        });
+      }
+    } catch (err) {
+      formatError(err);
+      process.exit(1);
+    }
+  });