directify-cli 1.0.0

package/src/commands/categories.js

@@ -0,0 +1,146 @@
+import { Command } from 'commander';
+import { api, resolveDirectory } from '../utils/api.js';
+import { printTable, printJson, printSuccess, printError } from '../utils/output.js';
+import ora from 'ora';
+
+const categories = new Command('categories')
+  .alias('cats')
+  .description('Manage categories');
+
+categories
+  .command('list')
+  .alias('ls')
+  .description('List all categories')
+  .option('-d, --directory <id>', 'Directory ID')
+  .option('--json', 'Output as JSON')
+  .action(async (opts) => {
+    const spinner = ora('Fetching categories...').start();
+    try {
+      const dir = resolveDirectory(opts);
+      const data = await api.get(`/directories/${dir}/categories`);
+      spinner.stop();
+      if (opts.json) {
+        printJson(data.data || data);
+      } else {
+        printTable(data.data || data, [
+          { key: 'id', label: 'ID' },
+          { key: 'title', label: 'Title', maxWidth: 30 },
+          { key: 'slug', label: 'Slug', maxWidth: 30 },
+          { key: 'is_active', label: 'Active' },
+          { key: 'order', label: 'Order' },
+        ]);
+      }
+    } catch (err) {
+      spinner.stop();
+      printError(err.message);
+      process.exit(1);
+    }
+  });
+
+categories
+  .command('get <id>')
+  .description('Get a specific category')
+  .option('-d, --directory <id>', 'Directory ID')
+  .option('--json', 'Output as JSON')
+  .action(async (id, opts) => {
+    try {
+      const dir = resolveDirectory(opts);
+      const data = await api.get(`/directories/${dir}/categories/${id}`);
+      printJson(data.data || data);
+    } catch (err) {
+      printError(err.message);
+      process.exit(1);
+    }
+  });
+
+categories
+  .command('create')
+  .description('Create a new category')
+  .requiredOption('--title <title>', 'Category title')
+  .option('--slug <slug>', 'URL slug')
+  .option('--description <text>', 'Description')
+  .option('--content <text>', 'Content (markdown)')
+  .option('--icon <icon>', 'Icon (emoji or URL)')
+  .option('--parent-id <id>', 'Parent category ID')
+  .option('--order <n>', 'Sort order', parseInt)
+  .option('--inactive', 'Create as inactive')
+  .option('-d, --directory <id>', 'Directory ID')
+  .action(async (opts) => {
+    const spinner = ora('Creating category...').start();
+    try {
+      const dir = resolveDirectory(opts);
+      const body = {
+        title: opts.title,
+        ...(opts.slug && { slug: opts.slug }),
+        ...(opts.description && { description: opts.description }),
+        ...(opts.content && { content: opts.content }),
+        ...(opts.icon && { icon: opts.icon }),
+        ...(opts.parentId && { parent_id: parseInt(opts.parentId) }),
+        ...(opts.order !== undefined && { order: opts.order }),
+        is_active: !opts.inactive,
+      };
+      const data = await api.post(`/directories/${dir}/categories`, body);
+      spinner.stop();
+      printSuccess(`Category created: ${data.data?.title || data.title} (ID: ${data.data?.id || data.id})`);
+    } catch (err) {
+      spinner.stop();
+      printError(err.message);
+      process.exit(1);
+    }
+  });
+
+categories
+  .command('update <id>')
+  .description('Update a category')
+  .option('--title <title>', 'Category title')
+  .option('--slug <slug>', 'URL slug')
+  .option('--description <text>', 'Description')
+  .option('--content <text>', 'Content')
+  .option('--icon <icon>', 'Icon')
+  .option('--parent-id <id>', 'Parent category ID')
+  .option('--order <n>', 'Sort order', parseInt)
+  .option('--active <bool>', 'Active status (true/false)')
+  .option('-d, --directory <id>', 'Directory ID')
+  .action(async (id, opts) => {
+    const spinner = ora('Updating category...').start();
+    try {
+      const dir = resolveDirectory(opts);
+      const body = {};
+      if (opts.title) body.title = opts.title;
+      if (opts.slug) body.slug = opts.slug;
+      if (opts.description) body.description = opts.description;
+      if (opts.content) body.content = opts.content;
+      if (opts.icon) body.icon = opts.icon;
+      if (opts.parentId) body.parent_id = parseInt(opts.parentId);
+      if (opts.order !== undefined) body.order = opts.order;
+      if (opts.active !== undefined) body.is_active = opts.active === 'true';
+
+      const data = await api.put(`/directories/${dir}/categories/${id}`, body);
+      spinner.stop();
+      printSuccess(`Category updated: ${data.data?.title || data.title}`);
+    } catch (err) {
+      spinner.stop();
+      printError(err.message);
+      process.exit(1);
+    }
+  });
+
+categories
+  .command('delete <id>')
+  .description('Delete a category')
+  .option('-d, --directory <id>', 'Directory ID')
+  .action(async (id, opts) => {
+    const spinner = ora('Deleting category...').start();
+    try {
+      const dir = resolveDirectory(opts);
+      await api.delete(`/directories/${dir}/categories/${id}`);
+      spinner.stop();
+      printSuccess(`Category ${id} deleted.`);
+    } catch (err) {
+      spinner.stop();
+      printError(err.message);
+      process.exit(1);
+    }
+  });
+
+export default categories;

package/src/commands/config.js

@@ -0,0 +1,27 @@
+import { Command } from 'commander';
+import { getDefaultDirectory, setDefaultDirectory } from '../utils/api.js';
+import { printSuccess, printInfo } from '../utils/output.js';
+
+const config = new Command('config').description('Manage CLI configuration');
+
+config
+  .command('set-directory <id>')
+  .description('Set the default directory ID (used when --directory is not specified)')
+  .action((id) => {
+    setDefaultDirectory(id);
+    printSuccess(`Default directory set to ${id}`);
+  });
+
+config
+  .command('get-directory')
+  .description('Show the current default directory ID')
+  .action(() => {
+    const dir = getDefaultDirectory();
+    if (dir) {
+      printInfo(`Default directory: ${dir}`);
+    } else {
+      printInfo('No default directory set. Use: directify config set-directory <id>');
+    }
+  });
+
+export default config;

package/src/commands/directories.js

@@ -0,0 +1,35 @@
+import { Command } from 'commander';
+import { api } from '../utils/api.js';
+import { printTable, printJson, printError } from '../utils/output.js';
+import ora from 'ora';
+
+const directories = new Command('directories')
+  .alias('dirs')
+  .description('List your directories');
+
+directories
+  .command('list')
+  .alias('ls')
+  .description('List all directories you own')
+  .option('--json', 'Output as JSON')
+  .action(async (opts) => {
+    const spinner = ora('Fetching directories...').start();
+    try {
+      const data = await api.get('/directories');
+      spinner.stop();
+      if (opts.json) {
+        printJson(data.data || data);
+      } else {
+        printTable(data.data || data, [
+          { key: 'id', label: 'ID' },
+          { key: 'name', label: 'Name', maxWidth: 40 },
+        ]);
+      }
+    } catch (err) {
+      spinner.stop();
+      printError(err.message);
+      process.exit(1);
+    }
+  });
+
+export default directories;

package/src/commands/fields.js

@@ -0,0 +1,41 @@
+import { Command } from 'commander';
+import { api, resolveDirectory } from '../utils/api.js';
+import { printTable, printJson, printError } from '../utils/output.js';
+import ora from 'ora';
+
+const fields = new Command('fields').description('List custom fields');
+
+fields
+  .command('list')
+  .alias('ls')
+  .description('List all custom fields for a directory')
+  .option('-d, --directory <id>', 'Directory ID')
+  .option('--json', 'Output as JSON')
+  .action(async (opts) => {
+    const spinner = ora('Fetching custom fields...').start();
+    try {
+      const dir = resolveDirectory(opts);
+      const data = await api.get(`/directories/${dir}/custom-fields`);
+      spinner.stop();
+      const items = data.data || data;
+      if (opts.json) {
+        printJson(items);
+      } else {
+        printTable(items, [
+          { key: 'id', label: 'ID' },
+          { key: 'name', label: 'Name', maxWidth: 25 },
+          { key: 'label', label: 'Label', maxWidth: 25 },
+          { key: 'type', label: 'Type' },
+          { key: 'is_required', label: 'Required' },
+          { key: 'filterable', label: 'Filterable' },
+          { key: 'show_on_card', label: 'On Card' },
+        ]);
+      }
+    } catch (err) {
+      spinner.stop();
+      printError(err.message);
+      process.exit(1);
+    }
+  });
+
+export default fields;

package/src/commands/listings.js

@@ -0,0 +1,243 @@
+import { Command } from 'commander';
+import { api, resolveDirectory } from '../utils/api.js';
+import { printTable, printJson, printSuccess, printError } from '../utils/output.js';
+import { readFileSync } from 'fs';
+import ora from 'ora';
+
+const listings = new Command('listings').description('Manage listings (projects)');
+
+listings
+  .command('list')
+  .alias('ls')
+  .description('List all listings (paginated)')
+  .option('-d, --directory <id>', 'Directory ID')
+  .option('--page <n>', 'Page number', '1')
+  .option('--json', 'Output as JSON')
+  .action(async (opts) => {
+    const spinner = ora('Fetching listings...').start();
+    try {
+      const dir = resolveDirectory(opts);
+      const data = await api.get(`/directories/${dir}/projects?page=${opts.page}`);
+      spinner.stop();
+      if (opts.json) {
+        printJson(data);
+      } else {
+        const items = data.data || data;
+        printTable(items, [
+          { key: 'id', label: 'ID' },
+          { key: 'name', label: 'Name', maxWidth: 35 },
+          { key: 'slug', label: 'Slug', maxWidth: 25 },
+          { key: 'is_active', label: 'Active' },
+          { key: 'is_featured', label: 'Featured' },
+        ]);
+        if (data.meta) {
+          console.log(`\nPage ${data.meta.current_page} of ${data.meta.last_page} (${data.meta.total} total)`);
+        }
+      }
+    } catch (err) {
+      spinner.stop();
+      printError(err.message);
+      process.exit(1);
+    }
+  });
+
+listings
+  .command('get <id>')
+  .description('Get a specific listing')
+  .option('-d, --directory <id>', 'Directory ID')
+  .action(async (id, opts) => {
+    try {
+      const dir = resolveDirectory(opts);
+      const data = await api.get(`/directories/${dir}/projects/${id}`);
+      printJson(data.data || data);
+    } catch (err) {
+      printError(err.message);
+      process.exit(1);
+    }
+  });
+
+listings
+  .command('create')
+  .description('Create a new listing')
+  .requiredOption('--name <name>', 'Listing name')
+  .option('--url <url>', 'Website URL')
+  .option('--slug <slug>', 'URL slug')
+  .option('--description <text>', 'Short description')
+  .option('--content <text>', 'Full content (markdown)')
+  .option('--image-url <url>', 'Cover image URL')
+  .option('--logo-url <url>', 'Logo URL')
+  .option('--phone <number>', 'Phone number')
+  .option('--email <email>', 'Email address')
+  .option('--address <address>', 'Physical address')
+  .option('--lat <n>', 'Latitude', parseFloat)
+  .option('--lng <n>', 'Longitude', parseFloat)
+  .option('--categories <ids>', 'Category IDs (comma-separated)')
+  .option('--tags <ids>', 'Tag IDs (comma-separated)')
+  .option('--featured', 'Mark as featured')
+  .option('--inactive', 'Create as inactive')
+  .option('--field <key=value...>', 'Custom field values (repeatable)', collect, [])
+  .option('-d, --directory <id>', 'Directory ID')
+  .action(async (opts) => {
+    const spinner = ora('Creating listing...').start();
+    try {
+      const dir = resolveDirectory(opts);
+      const body = { name: opts.name };
+      if (opts.url) body.url = opts.url;
+      if (opts.slug) body.slug = opts.slug;
+      if (opts.description) body.description = opts.description;
+      if (opts.content) body.content = opts.content;
+      if (opts.imageUrl) body.image_url = opts.imageUrl;
+      if (opts.logoUrl) body.logo_url = opts.logoUrl;
+      if (opts.phone) body.phone_number = opts.phone;
+      if (opts.email) body.email = opts.email;
+      if (opts.address) body.address = opts.address;
+      if (opts.lat) body.latitude = opts.lat;
+      if (opts.lng) body.longitude = opts.lng;
+      if (opts.categories) body.categories = opts.categories.split(',').map(Number);
+      if (opts.tags) body.tags = opts.tags.split(',').map(Number);
+      if (opts.featured) body.is_featured = true;
+      if (opts.inactive) body.is_active = false;
+
+      // Custom fields
+      for (const field of opts.field) {
+        const [key, ...rest] = field.split('=');
+        body[key] = rest.join('=');
+      }
+
+      const data = await api.post(`/directories/${dir}/projects`, body);
+      spinner.stop();
+      const result = data.data || data;
+      printSuccess(`Listing created: ${result.name} (ID: ${result.id})`);
+    } catch (err) {
+      spinner.stop();
+      printError(err.message);
+      process.exit(1);
+    }
+  });
+
+listings
+  .command('update <id>')
+  .description('Update a listing')
+  .option('--name <name>', 'Listing name')
+  .option('--url <url>', 'Website URL')
+  .option('--slug <slug>', 'URL slug')
+  .option('--description <text>', 'Short description')
+  .option('--content <text>', 'Full content (markdown)')
+  .option('--image-url <url>', 'Cover image URL')
+  .option('--logo-url <url>', 'Logo URL')
+  .option('--phone <number>', 'Phone number')
+  .option('--email <email>', 'Email address')
+  .option('--address <address>', 'Physical address')
+  .option('--lat <n>', 'Latitude', parseFloat)
+  .option('--lng <n>', 'Longitude', parseFloat)
+  .option('--categories <ids>', 'Category IDs (comma-separated)')
+  .option('--tags <ids>', 'Tag IDs (comma-separated)')
+  .option('--featured <bool>', 'Featured status (true/false)')
+  .option('--active <bool>', 'Active status (true/false)')
+  .option('--field <key=value...>', 'Custom field values (repeatable)', collect, [])
+  .option('-d, --directory <id>', 'Directory ID')
+  .action(async (id, opts) => {
+    const spinner = ora('Updating listing...').start();
+    try {
+      const dir = resolveDirectory(opts);
+      const body = {};
+      if (opts.name) body.name = opts.name;
+      if (opts.url) body.url = opts.url;
+      if (opts.slug) body.slug = opts.slug;
+      if (opts.description) body.description = opts.description;
+      if (opts.content) body.content = opts.content;
+      if (opts.imageUrl) body.image_url = opts.imageUrl;
+      if (opts.logoUrl) body.logo_url = opts.logoUrl;
+      if (opts.phone) body.phone_number = opts.phone;
+      if (opts.email) body.email = opts.email;
+      if (opts.address) body.address = opts.address;
+      if (opts.lat) body.latitude = opts.lat;
+      if (opts.lng) body.longitude = opts.lng;
+      if (opts.categories) body.categories = opts.categories.split(',').map(Number);
+      if (opts.tags) body.tags = opts.tags.split(',').map(Number);
+      if (opts.featured !== undefined) body.is_featured = opts.featured === 'true';
+      if (opts.active !== undefined) body.is_active = opts.active === 'true';
+
+      for (const field of opts.field) {
+        const [key, ...rest] = field.split('=');
+        body[key] = rest.join('=');
+      }
+
+      const data = await api.put(`/directories/${dir}/projects/${id}`, body);
+      spinner.stop();
+      printSuccess(`Listing updated: ${data.data?.name || data.name}`);
+    } catch (err) {
+      spinner.stop();
+      printError(err.message);
+      process.exit(1);
+    }
+  });
+
+listings
+  .command('delete <id>')
+  .description('Delete a listing')
+  .option('-d, --directory <id>', 'Directory ID')
+  .action(async (id, opts) => {
+    const spinner = ora('Deleting listing...').start();
+    try {
+      const dir = resolveDirectory(opts);
+      await api.delete(`/directories/${dir}/projects/${id}`);
+      spinner.stop();
+      printSuccess(`Listing ${id} deleted.`);
+    } catch (err) {
+      spinner.stop();
+      printError(err.message);
+      process.exit(1);
+    }
+  });
+
+listings
+  .command('exists')
+  .description('Check if a listing with a given URL exists')
+  .requiredOption('--url <url>', 'URL to check')
+  .option('-d, --directory <id>', 'Directory ID')
+  .action(async (opts) => {
+    try {
+      const dir = resolveDirectory(opts);
+      const data = await api.post(`/directories/${dir}/projects/exists`, { url: opts.url });
+      printSuccess(data.message);
+    } catch (err) {
+      printError(err.message);
+      process.exit(1);
+    }
+  });
+
+listings
+  .command('bulk-create')
+  .description('Bulk create listings from a JSON file')
+  .requiredOption('--file <path>', 'Path to JSON file with listings array')
+  .option('-d, --directory <id>', 'Directory ID')
+  .action(async (opts) => {
+    const spinner = ora('Creating listings...').start();
+    try {
+      const dir = resolveDirectory(opts);
+      const content = readFileSync(opts.file, 'utf-8');
+      const listings = JSON.parse(content);
+      const body = { listings: Array.isArray(listings) ? listings : listings.listings };
+
+      const data = await api.post(`/directories/${dir}/projects/bulk`, body);
+      spinner.stop();
+      printSuccess(`Created: ${data.total_created}, Errors: ${data.total_errors}`);
+      if (data.errors && data.errors.length > 0) {
+        console.log('\nErrors:');
+        for (const err of data.errors) {
+          printError(`  [${err.index}] ${err.name}: ${err.error}`);
+        }
+      }
+    } catch (err) {
+      spinner.stop();
+      printError(err.message);
+      process.exit(1);
+    }
+  });
+
+function collect(value, previous) {
+  return previous.concat([value]);
+}
+
+export default listings;

package/src/commands/tags.js

@@ -0,0 +1,138 @@
+import { Command } from 'commander';
+import { api, resolveDirectory } from '../utils/api.js';
+import { printTable, printJson, printSuccess, printError } from '../utils/output.js';
+import ora from 'ora';
+
+const tags = new Command('tags').description('Manage tags');
+
+tags
+  .command('list')
+  .alias('ls')
+  .description('List all tags')
+  .option('-d, --directory <id>', 'Directory ID')
+  .option('--json', 'Output as JSON')
+  .action(async (opts) => {
+    const spinner = ora('Fetching tags...').start();
+    try {
+      const dir = resolveDirectory(opts);
+      const data = await api.get(`/directories/${dir}/tags`);
+      spinner.stop();
+      if (opts.json) {
+        printJson(data.data || data);
+      } else {
+        printTable(data.data || data, [
+          { key: 'id', label: 'ID' },
+          { key: 'title', label: 'Title', maxWidth: 30 },
+          { key: 'slug', label: 'Slug', maxWidth: 30 },
+          { key: 'is_active', label: 'Active' },
+        ]);
+      }
+    } catch (err) {
+      spinner.stop();
+      printError(err.message);
+      process.exit(1);
+    }
+  });
+
+tags
+  .command('get <id>')
+  .description('Get a specific tag')
+  .option('-d, --directory <id>', 'Directory ID')
+  .action(async (id, opts) => {
+    try {
+      const dir = resolveDirectory(opts);
+      const data = await api.get(`/directories/${dir}/tags/${id}`);
+      printJson(data.data || data);
+    } catch (err) {
+      printError(err.message);
+      process.exit(1);
+    }
+  });
+
+tags
+  .command('create')
+  .description('Create a new tag')
+  .requiredOption('--title <title>', 'Tag title')
+  .option('--slug <slug>', 'URL slug')
+  .option('--color <hex>', 'Background color (hex)')
+  .option('--text-color <hex>', 'Text color (hex)')
+  .option('--icon <icon>', 'Icon')
+  .option('--heroicon <name>', 'Heroicon name')
+  .option('--inactive', 'Create as inactive')
+  .option('-d, --directory <id>', 'Directory ID')
+  .action(async (opts) => {
+    const spinner = ora('Creating tag...').start();
+    try {
+      const dir = resolveDirectory(opts);
+      const body = {
+        title: opts.title,
+        ...(opts.slug && { slug: opts.slug }),
+        ...(opts.color && { color: opts.color }),
+        ...(opts.textColor && { text_color: opts.textColor }),
+        ...(opts.icon && { icon: opts.icon }),
+        ...(opts.heroicon && { heroicon: opts.heroicon }),
+        is_active: !opts.inactive,
+      };
+      const data = await api.post(`/directories/${dir}/tags`, body);
+      spinner.stop();
+      printSuccess(`Tag created: ${data.data?.title || data.title} (ID: ${data.data?.id || data.id})`);
+    } catch (err) {
+      spinner.stop();
+      printError(err.message);
+      process.exit(1);
+    }
+  });
+
+tags
+  .command('update <id>')
+  .description('Update a tag')
+  .option('--title <title>', 'Tag title')
+  .option('--slug <slug>', 'URL slug')
+  .option('--color <hex>', 'Background color')
+  .option('--text-color <hex>', 'Text color')
+  .option('--icon <icon>', 'Icon')
+  .option('--heroicon <name>', 'Heroicon name')
+  .option('--active <bool>', 'Active status (true/false)')
+  .option('-d, --directory <id>', 'Directory ID')
+  .action(async (id, opts) => {
+    const spinner = ora('Updating tag...').start();
+    try {
+      const dir = resolveDirectory(opts);
+      const body = {};
+      if (opts.title) body.title = opts.title;
+      if (opts.slug) body.slug = opts.slug;
+      if (opts.color) body.color = opts.color;
+      if (opts.textColor) body.text_color = opts.textColor;
+      if (opts.icon) body.icon = opts.icon;
+      if (opts.heroicon) body.heroicon = opts.heroicon;
+      if (opts.active !== undefined) body.is_active = opts.active === 'true';
+
+      const data = await api.put(`/directories/${dir}/tags/${id}`, body);
+      spinner.stop();
+      printSuccess(`Tag updated: ${data.data?.title || data.title}`);
+    } catch (err) {
+      spinner.stop();
+      printError(err.message);
+      process.exit(1);
+    }
+  });
+
+tags
+  .command('delete <id>')
+  .description('Delete a tag')
+  .option('-d, --directory <id>', 'Directory ID')
+  .action(async (id, opts) => {
+    const spinner = ora('Deleting tag...').start();
+    try {
+      const dir = resolveDirectory(opts);
+      await api.delete(`/directories/${dir}/tags/${id}`);
+      spinner.stop();
+      printSuccess(`Tag ${id} deleted.`);
+    } catch (err) {
+      spinner.stop();
+      printError(err.message);
+      process.exit(1);
+    }
+  });
+
+export default tags;

package/src/index.js

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import auth from './commands/auth.js';
+import config from './commands/config.js';
+import directories from './commands/directories.js';
+import categories from './commands/categories.js';
+import tags from './commands/tags.js';
+import fields from './commands/fields.js';
+import listings from './commands/listings.js';
+import articles from './commands/articles.js';
+
+const program = new Command();
+
+program
+  .name('directify')
+  .description('Official CLI for Directify - manage your directory websites from the command line.')
+  .version('1.0.0');
+
+program.addCommand(auth);
+program.addCommand(config);
+program.addCommand(directories);
+program.addCommand(categories);
+program.addCommand(tags);
+program.addCommand(fields);
+program.addCommand(listings);
+program.addCommand(articles);
+
+program.parse();