lystbot 0.1.0

package/README.md

@@ -0,0 +1,3 @@
+# @lystbot/cli
+
+LystBot command-line interface. See the full documentation at [docs/cli/](../docs/cli/).

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "lystbot",
+  "version": "0.1.0",
+  "description": "LystBot CLI - Manage your lists from the terminal",
+  "main": "src/index.js",
+  "bin": {
+    "lystbot": "src/index.js"
+  },
+  "scripts": {
+    "start": "node src/index.js",
+    "test": "echo \"Tests coming soon\" && exit 0"
+  },
+  "keywords": [
+    "lystbot",
+    "lists",
+    "todo",
+    "ai",
+    "cli",
+    "productivity"
+  ],
+  "author": "AI Ventures Holding / TourAround UG",
+  "license": "MIT",
+  "dependencies": {
+    "commander": "^12.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/TourAround/LystBot.git"
+  },
+  "homepage": "https://github.com/TourAround/LystBot/tree/main/docs/cli"
+}

package/src/api.js

@@ -0,0 +1,159 @@
+const config = require('./config');
+
+async function request(method, path, body = null) {
+  const baseUrl = config.getBaseUrl();
+  const url = `${baseUrl}${path}`;
+
+  const headers = { 'Content-Type': 'application/json' };
+
+  // Some endpoints don't need auth (device registration)
+  const cfg = config.read();
+  if (cfg && cfg.apiKey) {
+    headers['Authorization'] = `Bearer ${cfg.apiKey}`;
+  }
+
+  const opts = { method, headers };
+  if (body) opts.body = JSON.stringify(body);
+
+  let res;
+  try {
+    res = await fetch(url, opts);
+  } catch (err) {
+    console.error(`❌ Network error: ${err.message}`);
+    process.exit(1);
+  }
+
+  if (res.status === 204) return null;
+
+  let data;
+  try {
+    data = await res.json();
+  } catch {
+    if (!res.ok) {
+      console.error(`❌ HTTP ${res.status}: ${res.statusText}`);
+      process.exit(1);
+    }
+    return null;
+  }
+
+  if (!res.ok) {
+    const msg = data?.error?.message || data?.message || JSON.stringify(data);
+    console.error(`❌ ${msg}`);
+    process.exit(1);
+  }
+
+  return data;
+}
+
+// Unauthenticated request with custom headers
+async function rawRequest(method, path, body = null, extraHeaders = {}) {
+  const baseUrl = config.getBaseUrl();
+  const url = `${baseUrl}${path}`;
+  const headers = { 'Content-Type': 'application/json', ...extraHeaders };
+
+  const opts = { method, headers };
+  if (body) opts.body = JSON.stringify(body);
+
+  let res;
+  try {
+    res = await fetch(url, opts);
+  } catch (err) {
+    console.error(`❌ Network error: ${err.message}`);
+    process.exit(1);
+  }
+
+  if (res.status === 204) return null;
+
+  let data;
+  try {
+    data = await res.json();
+  } catch {
+    if (!res.ok) {
+      console.error(`❌ HTTP ${res.status}: ${res.statusText}`);
+      process.exit(1);
+    }
+    return null;
+  }
+
+  if (!res.ok) {
+    const msg = data?.error?.message || data?.message || JSON.stringify(data);
+    console.error(`❌ ${msg}`);
+    process.exit(1);
+  }
+
+  return data;
+}
+
+// Fuzzy match: find a list by name or ID from an array of lists
+function findList(lists, query) {
+  // Try exact ID match
+  const byId = lists.find(l => String(l.id) === String(query));
+  if (byId) return byId;
+
+  // Try exact name match (case-insensitive)
+  const lower = query.toLowerCase();
+  const exact = lists.find(l => (l.title || l.name || '').toLowerCase() === lower);
+  if (exact) return exact;
+
+  // Try startsWith
+  const starts = lists.find(l => (l.title || l.name || '').toLowerCase().startsWith(lower));
+  if (starts) return starts;
+
+  // Try includes
+  const includes = lists.find(l => (l.title || l.name || '').toLowerCase().includes(lower));
+  if (includes) return includes;
+
+  return null;
+}
+
+// Fuzzy match an item by text
+function findItem(items, query) {
+  const lower = query.toLowerCase();
+  const exact = items.find(i => i.text.toLowerCase() === lower);
+  if (exact) return exact;
+
+  const starts = items.find(i => i.text.toLowerCase().startsWith(lower));
+  if (starts) return starts;
+
+  const includes = items.find(i => i.text.toLowerCase().includes(lower));
+  if (includes) return includes;
+
+  return null;
+}
+
+// Resolve a list query to {list, detail} - fetches all lists then the specific one
+async function resolveList(query, { withItems = false } = {}) {
+  const res = await request('GET', '/lists');
+  const lists = res.lists || res;
+  const match = findList(lists, query);
+  if (!match) {
+    const names = lists.map(l => `${l.emoji || '📋'} ${l.title || l.name}`).join(', ');
+    console.error(`❌ List '${query}' not found. Your lists: ${names || '(none)'}`);
+    process.exit(1);
+  }
+  if (withItems) {
+    const detail = await request('GET', `/lists/${match.id}`);
+    return { list: match, detail };
+  }
+  return { list: match };
+}
+
+// Pick an emoji based on list name
+function autoEmoji(name) {
+  const lower = name.toLowerCase();
+  const map = {
+    grocer: '🛒', shopping: '🛍️', food: '🍕', meal: '🍽️',
+    todo: '✅', task: '📝', work: '💼', home: '🏠',
+    travel: '✈️', trip: '🧳', pack: '🧳', vacation: '🏖️',
+    book: '📚', read: '📖', movie: '🎬', watch: '📺',
+    music: '🎵', gift: '🎁', wish: '⭐', fitness: '💪',
+    recipe: '👨‍🍳', cook: '🍳', clean: '🧹', garden: '🌱',
+    pet: '🐾', baby: '👶', school: '🎓', project: '🚀',
+  };
+  for (const [key, emoji] of Object.entries(map)) {
+    if (lower.includes(key)) return emoji;
+  }
+  return '📋';
+}
+
+module.exports = { request, rawRequest, findList, findItem, resolveList, autoEmoji };

package/src/config.js

@@ -0,0 +1,56 @@
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const CONFIG_DIR = path.join(os.homedir(), '.lystbot');
+const CONFIG_PATH = path.join(CONFIG_DIR, 'config.json');
+
+function read() {
+  try {
+    const data = fs.readFileSync(CONFIG_PATH, 'utf8');
+    return JSON.parse(data);
+  } catch {
+    return null;
+  }
+}
+
+function write(config) {
+  fs.mkdirSync(CONFIG_DIR, { recursive: true });
+  fs.writeFileSync(CONFIG_PATH, JSON.stringify(config, null, 2) + '\n');
+}
+
+function remove() {
+  try {
+    fs.unlinkSync(CONFIG_PATH);
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function getApiKey() {
+  const cfg = read();
+  if (!cfg || !cfg.apiKey) {
+    console.error('❌ Not logged in. Run: lystbot login');
+    process.exit(1);
+  }
+  return cfg.apiKey;
+}
+
+const PROD_URL = 'https://lystbot.com/api/v1';
+
+let _customUrl = null;
+
+function setCustomUrl(url) {
+  _customUrl = url;
+}
+
+function getBaseUrl() {
+  if (_customUrl) return _customUrl;
+  if (process.env.LYSTBOT_API_URL) return process.env.LYSTBOT_API_URL;
+  const cfg = read();
+  if (cfg && cfg.apiUrl) return cfg.apiUrl;
+  return PROD_URL;
+}
+
+module.exports = { read, write, remove, getApiKey, getBaseUrl, setCustomUrl, PROD_URL, CONFIG_PATH };

package/src/index.js

@@ -0,0 +1,369 @@
+#!/usr/bin/env node
+
+const { Command } = require('commander');
+const { randomUUID } = require('crypto');
+const readline = require('readline');
+const config = require('./config');
+const api = require('./api');
+
+const program = new Command();
+
+program
+  .name('lystbot')
+  .description('📋 LystBot CLI - Manage your lists from the terminal')
+  .version('0.1.0')
+  .option('--api <url>', 'Use custom API URL')
+  .hook('preAction', () => {
+    const opts = program.opts();
+    if (opts.api) {
+      config.setCustomUrl(opts.api);
+      console.log(`🔗 API: ${opts.api}\n`);
+    }
+  });
+
+// ── login ──────────────────────────────────────────────
+program
+  .command('login')
+  .description('Authenticate with LystBot')
+  .option('--token <api-key>', 'Set API key directly')
+  .action(async (options) => {
+    if (options.token) {
+      config.write({ apiKey: options.token, apiUrl: config.getBaseUrl() });
+      console.log('✅ Logged in! API key stored.');
+      return;
+    }
+
+    // Interactive registration
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    const ask = (q) => new Promise(resolve => rl.question(q, resolve));
+
+    console.log('🔐 LystBot Device Registration\n');
+    const name = await ask('Device name (e.g. "My Laptop"): ');
+    rl.close();
+
+    if (!name.trim()) {
+      console.error('❌ Name cannot be empty.');
+      process.exit(1);
+    }
+
+    console.log('\n⏳ Registering device...');
+    const uuid = randomUUID();
+    const device = await api.rawRequest('POST', '/devices/register', {
+      uuid,
+      name: name.trim(),
+      platform: 'cli',
+    });
+
+    console.log(`📱 Device registered: ${device.uuid}`);
+
+    // API key may come directly in register response or via separate endpoint
+    let apiKey = device.api_key || device.apiKey;
+    if (!apiKey) {
+      console.log('⏳ Fetching API key...');
+      const keyData = await api.rawRequest('GET', `/devices/${device.uuid}/api-key`, null, {
+        'X-Device-UUID': device.uuid,
+      });
+      apiKey = keyData.api_key || keyData.apiKey;
+    }
+
+    config.write({
+      apiKey,
+      deviceUuid: device.uuid,
+      deviceName: name.trim(),
+      apiUrl: config.getBaseUrl(),
+    });
+
+    console.log('✅ Logged in! You\'re all set 🎉');
+  });
+
+// ── logout ─────────────────────────────────────────────
+program
+  .command('logout')
+  .description('Remove stored credentials')
+  .action(() => {
+    if (config.remove()) {
+      console.log('👋 Logged out. Config removed.');
+    } else {
+      console.log('ℹ️  Already logged out (no config found).');
+    }
+  });
+
+// ── whoami ─────────────────────────────────────────────
+program
+  .command('whoami')
+  .description('Show current auth info')
+  .action(() => {
+    const cfg = config.read();
+    if (!cfg) {
+      console.log('❌ Not logged in. Run: lystbot login');
+      process.exit(1);
+    }
+    const masked = cfg.apiKey
+      ? cfg.apiKey.slice(0, 12) + '...' + cfg.apiKey.slice(-4)
+      : '(none)';
+    console.log('👤 LystBot CLI');
+    console.log(`   API URL:  ${cfg.apiUrl || config.getBaseUrl()}`);
+    if (cfg.deviceName) console.log(`   Device:   ${cfg.deviceName}`);
+    if (cfg.deviceUuid) console.log(`   UUID:     ${cfg.deviceUuid}`);
+    console.log(`   API Key:  ${masked}`);
+  });
+
+// ── lists ──────────────────────────────────────────────
+program
+  .command('lists')
+  .description('Show all your lists')
+  .option('--json', 'Output as JSON')
+  .action(async (options) => {
+    config.getApiKey(); // ensure logged in
+    const res = await api.request('GET', '/lists');
+    const lists = res.lists || res;
+
+    if (options.json) {
+      console.log(JSON.stringify(lists, null, 2));
+      return;
+    }
+
+    if (!lists.length) {
+      console.log('📋 No lists yet. Create one: lystbot create "My List"');
+      return;
+    }
+
+    console.log('📋 Your Lists\n');
+    for (const l of lists) {
+      const emoji = l.emoji || '📋';
+      const shared = l.is_shared ? ' 👥' : '';
+      const total = l.item_count || 0;
+      const unchecked = l.unchecked_count || 0;
+      const checked = total - unchecked;
+      const count = `${checked}/${total}`;
+      console.log(`  ${emoji} ${l.title || l.name}  (${count} done)${shared}`);
+    }
+    console.log(`\n  ${lists.length} list${lists.length === 1 ? '' : 's'} total`);
+  });
+
+// ── show ───────────────────────────────────────────────
+program
+  .command('show <list>')
+  .description('Show items in a list')
+  .option('--json', 'Output as JSON')
+  .action(async (listQuery, options) => {
+    config.getApiKey();
+    const { detail } = await api.resolveList(listQuery, { withItems: true });
+
+    if (options.json) {
+      console.log(JSON.stringify(detail, null, 2));
+      return;
+    }
+
+    const emoji = detail.emoji || '📋';
+    const listTitle = detail.title || detail.name;
+    const memberCount = Array.isArray(detail.members) ? detail.members.length : (detail.members || 0);
+    const shared = detail.is_shared ? ` 👥 (${memberCount} member${memberCount === 1 ? '' : 's'})` : '';
+    console.log(`\n${emoji} ${listTitle}${shared}\n`);
+
+    if (!detail.items || !detail.items.length) {
+      console.log('  (empty list)');
+      return;
+    }
+
+    for (const item of detail.items) {
+      if (item.checked) {
+        console.log(`  ✅ ~~${item.text}~~`);
+      } else {
+        console.log(`  ⬜ ${item.text}`);
+      }
+    }
+
+    const checked = detail.items.filter(i => i.checked).length;
+    console.log(`\n  ${checked}/${detail.items.length} done`);
+  });
+
+// ── add ────────────────────────────────────────────────
+program
+  .command('add <list> <items...>')
+  .description('Add items to a list (supports comma-separated)')
+  .action(async (listQuery, rawItems) => {
+    config.getApiKey();
+
+    // Smart parsing: split on commas, trim, flatten
+    const items = rawItems
+      .flatMap(i => i.split(','))
+      .map(i => i.trim())
+      .filter(Boolean);
+
+    if (!items.length) {
+      console.error('❌ No items to add.');
+      process.exit(1);
+    }
+
+    // Try to find the list
+    const listsRes = await api.request('GET', '/lists');
+    const lists = listsRes.lists || listsRes;
+    let match = api.findList(lists, listQuery);
+
+    // If not found, offer to create it
+    if (!match) {
+      const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+      const answer = await new Promise(resolve =>
+        rl.question(`📋 List '${listQuery}' doesn't exist. Create it? (Y/n) `, resolve)
+      );
+      rl.close();
+
+      if (answer.toLowerCase() === 'n') {
+        console.log('Cancelled.');
+        process.exit(0);
+      }
+
+      const emoji = api.autoEmoji(listQuery);
+      const newId = randomUUID();
+      await api.request('POST', '/lists', { id: newId, title: listQuery, type: 'generic', emoji });
+      match = { id: newId, title: listQuery, emoji };
+      console.log(`✨ Created list: ${emoji} ${listQuery}`);
+    }
+
+    // Add items one by one (each needs a client-generated UUID)
+    let added = 0;
+    for (let idx = 0; idx < items.length; idx++) {
+      await api.request('POST', `/lists/${match.id}/items`, {
+        id: randomUUID(),
+        text: items[idx],
+        quantity: 1,
+        unit: null,
+        position: idx,
+      });
+      added++;
+    }
+
+    const emoji = match.emoji || '📋';
+    console.log(`➕ Added ${added} item${added === 1 ? '' : 's'} to ${emoji} ${match.title || match.name}`);
+    for (const text of items) {
+      console.log(`   • ${text}`);
+    }
+  });
+
+// ── check ──────────────────────────────────────────────
+program
+  .command('check <list> <item>')
+  .description('Mark an item as done')
+  .action(async (listQuery, itemQuery) => {
+    config.getApiKey();
+    const { list, detail } = await api.resolveList(listQuery, { withItems: true });
+
+    const item = api.findItem(detail.items || [], itemQuery);
+    if (!item) {
+      const names = (detail.items || []).map(i => i.text).join(', ');
+      console.error(`❌ Item '${itemQuery}' not found in ${list.title || list.name}. Items: ${names || '(empty)'}`);
+      process.exit(1);
+    }
+
+    await api.request('PUT', `/lists/${list.id}/items/${item.id}`, { checked: true });
+    console.log(`✅ Checked: ${item.text}`);
+  });
+
+// ── uncheck ────────────────────────────────────────────
+program
+  .command('uncheck <list> <item>')
+  .description('Unmark an item')
+  .action(async (listQuery, itemQuery) => {
+    config.getApiKey();
+    const { list, detail } = await api.resolveList(listQuery, { withItems: true });
+
+    const item = api.findItem(detail.items || [], itemQuery);
+    if (!item) {
+      const names = (detail.items || []).map(i => i.text).join(', ');
+      console.error(`❌ Item '${itemQuery}' not found in ${list.title || list.name}. Items: ${names || '(empty)'}`);
+      process.exit(1);
+    }
+
+    await api.request('PUT', `/lists/${list.id}/items/${item.id}`, { checked: false });
+    console.log(`⬜ Unchecked: ${item.text}`);
+  });
+
+// ── remove ─────────────────────────────────────────────
+program
+  .command('remove <list> <item>')
+  .description('Remove an item from a list')
+  .action(async (listQuery, itemQuery) => {
+    config.getApiKey();
+    const { list, detail } = await api.resolveList(listQuery, { withItems: true });
+
+    const item = api.findItem(detail.items || [], itemQuery);
+    if (!item) {
+      const names = (detail.items || []).map(i => i.text).join(', ');
+      console.error(`❌ Item '${itemQuery}' not found in ${list.title || list.name}. Items: ${names || '(empty)'}`);
+      process.exit(1);
+    }
+
+    await api.request('DELETE', `/lists/${list.id}/items/${item.id}`);
+    console.log(`🗑️  Removed: ${item.text}`);
+  });
+
+// ── create ─────────────────────────────────────────────
+program
+  .command('create <name>')
+  .description('Create a new list')
+  .option('--emoji <emoji>', 'List emoji')
+  .option('--type <type>', 'List type (shopping|todo|packing|generic)', 'generic')
+  .action(async (name, options) => {
+    config.getApiKey();
+    const emoji = options.emoji || api.autoEmoji(name);
+    const list = await api.request('POST', '/lists', {
+      id: randomUUID(),
+      title: name,
+      type: options.type,
+      emoji,
+    });
+    console.log(`✨ Created: ${emoji} ${name}`);
+  });
+
+// ── delete ─────────────────────────────────────────────
+program
+  .command('delete <list>')
+  .description('Delete a list')
+  .option('--force', 'Skip confirmation')
+  .action(async (listQuery, options) => {
+    config.getApiKey();
+    const { list } = await api.resolveList(listQuery);
+
+    if (!options.force) {
+      const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+      const answer = await new Promise(resolve =>
+        rl.question(`🗑️  Delete '${list.emoji || ''} ${list.title || list.name}'? This cannot be undone. (y/N) `, resolve)
+      );
+      rl.close();
+
+      if (answer.toLowerCase() !== 'y') {
+        console.log('Cancelled.');
+        process.exit(0);
+      }
+    }
+
+    await api.request('DELETE', `/lists/${list.id}`);
+    console.log(`🗑️  Deleted: ${list.emoji || '📋'} ${list.title || list.name}`);
+  });
+
+// ── share ──────────────────────────────────────────────
+program
+  .command('share <list>')
+  .description('Generate a share code for a list')
+  .action(async (listQuery) => {
+    config.getApiKey();
+    const { list } = await api.resolveList(listQuery);
+
+    const result = await api.request('POST', `/lists/${list.id}/share`);
+    console.log(`\n🔗 Share code for ${list.emoji || '📋'} ${list.title || list.name}:\n`);
+    console.log(`   ${result.shareCode}\n`);
+    console.log(`   Others can join with: lystbot join ${result.shareCode}`);
+  });
+
+// ── join ───────────────────────────────────────────────
+program
+  .command('join <code>')
+  .description('Join a shared list using a share code')
+  .action(async (code) => {
+    config.getApiKey();
+    const list = await api.request('POST', '/lists/join', { shareCode: code });
+    console.log(`🤝 Joined: ${list.emoji || '📋'} ${list.title || list.name} (${list.item_count || 0} items)`);
+  });
+
+program.parse();