directify-cli 1.0.0

package/.gitattributes

@@ -0,0 +1,2 @@
+# Auto detect text files and perform LF normalization
+* text=auto

package/README.md

@@ -0,0 +1,297 @@
+# Directify CLI
+
+Official command-line tool for [Directify](https://directify.app) - manage your directory websites, listings, categories, tags, and articles from the terminal.
+
+## Installation
+
+```bash
+npm install -g directify-cli
+```
+
+Or run directly with npx:
+
+```bash
+npx directify-cli --help
+```
+
+## Quick Start
+
+### 1. Get your API token
+
+Go to your Directify dashboard: **Settings > API** and generate a new token.
+
+### 2. Authenticate
+
+```bash
+directify auth login YOUR_API_TOKEN
+```
+
+### 3. Set your default directory
+
+```bash
+# List your directories to find the ID
+directify directories list
+
+# Set the default so you don't need --directory on every command
+directify config set-directory 123
+```
+
+### 4. Start managing
+
+```bash
+# List listings
+directify listings list
+
+# Create a listing
+directify listings create --name "Bella Trattoria" --description "Authentic Italian cuisine" --address "123 Main St"
+
+# Create a category
+directify categories create --title "Italian" --icon "🍝"
+```
+
+## Commands
+
+### Authentication
+
+```bash
+directify auth login <token>    # Authenticate with your API token
+directify auth logout           # Remove stored token
+directify auth status           # Check authentication status
+```
+
+### Configuration
+
+```bash
+directify config set-directory <id>   # Set default directory
+directify config get-directory        # Show default directory
+```
+
+### Directories
+
+```bash
+directify directories list            # List all your directories
+directify dirs ls                     # Short alias
+directify dirs ls --json              # Output as JSON
+```
+
+### Categories
+
+```bash
+# List
+directify categories list
+directify cats ls --json
+
+# Create
+directify categories create --title "Italian" --icon "🍝" --description "Italian restaurants"
+directify categories create --title "Japanese" --parent-id 5 --order 2
+
+# Update
+directify categories update 42 --title "Italian Cuisine" --order 1
+
+# Delete
+directify categories delete 42
+
+# Get details
+directify categories get 42
+```
+
+### Tags
+
+```bash
+# List
+directify tags list
+directify tags ls --json
+
+# Create
+directify tags create --title "Featured" --color "#f59e0b" --text-color "#ffffff"
+directify tags create --title "New" --heroicon "heroicon-o-sparkles"
+
+# Update
+directify tags update 10 --title "Hot" --color "#ef4444"
+
+# Delete
+directify tags delete 10
+```
+
+### Custom Fields
+
+```bash
+directify fields list                 # List all custom fields
+directify fields ls --json            # Output as JSON
+```
+
+### Listings
+
+```bash
+# List (paginated)
+directify listings list
+directify listings list --page 2
+directify listings ls --json
+
+# Get a specific listing
+directify listings get 456
+
+# Create
+directify listings create \
+  --name "Bella Trattoria" \
+  --url "https://bellatrattoria.com" \
+  --description "Authentic Italian cuisine" \
+  --address "123 Main Street, New York" \
+  --phone "+1-212-555-1234" \
+  --email "info@bellatrattoria.com" \
+  --categories 1,5,12 \
+  --tags 3,7 \
+  --featured \
+  --field "price_range=2" \
+  --field "cuisine_type=Italian, Pasta"
+
+# Update
+directify listings update 456 \
+  --name "Bella Trattoria NYC" \
+  --featured true \
+  --field "hours_of_operation=Mon | 11:00 - 22:00"
+
+# Delete
+directify listings delete 456
+
+# Check if URL exists
+directify listings exists --url "https://example.com"
+
+# Bulk create from JSON file
+directify listings bulk-create --file ./listings.json
+```
+
+#### Bulk Create JSON Format
+
+Create a JSON file with an array of listings:
+
+```json
+{
+  "listings": [
+    {
+      "name": "Restaurant One",
+      "url": "https://restaurant-one.com",
+      "description": "Great food",
+      "categories": [1, 2],
+      "tags": [3],
+      "price_range": "2",
+      "cuisine_type": "Italian"
+    },
+    {
+      "name": "Restaurant Two",
+      "url": "https://restaurant-two.com",
+      "description": "Amazing sushi",
+      "categories": [3],
+      "cuisine_type": "Japanese"
+    }
+  ]
+}
+```
+
+Then run:
+
+```bash
+directify listings bulk-create --file ./listings.json
+```
+
+### Articles
+
+```bash
+# List
+directify articles list
+directify articles list --page 2 --json
+
+# Get
+directify articles get 789
+
+# Create
+directify articles create \
+  --title "Best Italian Restaurants in NYC" \
+  --markdown "# Top Picks\n\nHere are our favorites..." \
+  --categories "Reviews,Italian" \
+  --thumbnail-url "https://example.com/image.jpg" \
+  --seo-title "Best Italian Restaurants" \
+  --seo-description "Discover the top Italian restaurants in New York City"
+
+# Update
+directify articles update 789 --title "Updated Title" --active true
+
+# Toggle active/inactive
+directify articles toggle 789
+
+# Delete
+directify articles delete 789
+
+# Check if slug exists
+directify articles exists --slug "best-italian-restaurants"
+```
+
+## Global Options
+
+All resource commands support these options:
+
+| Option | Description |
+|--------|-------------|
+| `-d, --directory <id>` | Directory ID (overrides default) |
+| `--json` | Output as JSON (on list commands) |
+| `--help` | Show help for a command |
+
+## Custom Fields
+
+When creating or updating listings, you can set custom field values using the `--field` flag:
+
+```bash
+directify listings create \
+  --name "My Restaurant" \
+  --field "price_range=3" \
+  --field "cuisine_type=Italian, Pizza" \
+  --field "hours_of_operation=Mon | 11:00 - 22:00
+Tue | 11:00 - 22:00
+Wed | Closed" \
+  --field "menu_highlights=Carbonara | Classic Roman pasta | \$22
+Margherita | Fresh mozzarella | \$18"
+```
+
+Use `directify fields list` to see available custom fields and their names.
+
+## Using with LLMs / AI Agents
+
+The CLI is designed to work well with AI-powered workflows. Use `--json` output for machine-readable responses:
+
+```bash
+# Get all listings as JSON for processing
+directify listings list --json | jq '.data[].name'
+
+# Pipe data between commands
+directify listings get 456 --json | jq '.categories'
+```
+
+## Rate Limits
+
+The API allows **120 requests per minute** per directory. If you hit the rate limit, the CLI will show an error message. Implement delays between requests for bulk operations.
+
+## Configuration Storage
+
+The CLI stores your auth token and default directory in your system's config directory:
+
+- **macOS**: `~/Library/Preferences/directify-cli-nodejs/`
+- **Linux**: `~/.config/directify-cli-nodejs/`
+- **Windows**: `%APPDATA%/directify-cli-nodejs/`
+
+## Troubleshooting
+
+### "Not authenticated" error
+Run `directify auth login <token>` with your API token from Settings > API.
+
+### "No directory specified" error
+Either pass `--directory <id>` or set a default: `directify config set-directory <id>`
+
+### "Rate limit exceeded" error
+Wait a moment and retry. The limit is 120 requests per minute per directory.
+
+### "Validation error"
+Check the error details for which fields failed validation. Use `directify fields list` to see available custom field names.
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "directify-cli",
+  "version": "1.0.0",
+  "description": "Official CLI tool for Directify - manage your directories, listings, categories, tags, and articles from the command line.",
+  "main": "src/index.js",
+  "bin": {
+    "directify": "./src/index.js"
+  },
+  "type": "module",
+  "scripts": {
+    "start": "node src/index.js",
+    "lint": "eslint src/"
+  },
+  "keywords": [
+    "directify",
+    "directory",
+    "cli",
+    "listings",
+    "api"
+  ],
+  "author": "Directify",
+  "license": "MIT",
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "conf": "^13.0.1",
+    "ora": "^8.1.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/src/commands/articles.js

@@ -0,0 +1,193 @@
+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 articles = new Command('articles').description('Manage blog articles');
+
+articles
+  .command('list')
+  .alias('ls')
+  .description('List all articles')
+  .option('-d, --directory <id>', 'Directory ID')
+  .option('--page <n>', 'Page number', '1')
+  .option('--json', 'Output as JSON')
+  .action(async (opts) => {
+    const spinner = ora('Fetching articles...').start();
+    try {
+      const dir = resolveDirectory(opts);
+      const data = await api.get(`/directories/${dir}/articles?page=${opts.page}`);
+      spinner.stop();
+      if (opts.json) {
+        printJson(data);
+      } else {
+        const items = data.data || data;
+        printTable(items, [
+          { key: 'id', label: 'ID' },
+          { key: 'title', label: 'Title', maxWidth: 40 },
+          { key: 'slug', label: 'Slug', maxWidth: 25 },
+          { key: 'active', label: 'Active' },
+          { key: 'published_at', label: 'Published' },
+        ]);
+        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);
+    }
+  });
+
+articles
+  .command('get <id>')
+  .description('Get a specific article')
+  .option('-d, --directory <id>', 'Directory ID')
+  .action(async (id, opts) => {
+    try {
+      const dir = resolveDirectory(opts);
+      const data = await api.get(`/directories/${dir}/articles/${id}`);
+      printJson(data.data || data);
+    } catch (err) {
+      printError(err.message);
+      process.exit(1);
+    }
+  });
+
+articles
+  .command('create')
+  .description('Create a new article')
+  .requiredOption('--title <title>', 'Article title')
+  .option('--slug <slug>', 'URL slug (auto-generated from title if not set)')
+  .option('--content <text>', 'HTML content')
+  .option('--markdown <text>', 'Markdown content')
+  .option('--thumbnail-url <url>', 'Thumbnail image URL')
+  .option('--categories <names>', 'Category names (comma-separated)')
+  .option('--seo-title <text>', 'SEO title')
+  .option('--seo-description <text>', 'SEO description')
+  .option('--inactive', 'Create as inactive')
+  .option('-d, --directory <id>', 'Directory ID')
+  .action(async (opts) => {
+    const spinner = ora('Creating article...').start();
+    try {
+      const dir = resolveDirectory(opts);
+      const body = { title: opts.title };
+      if (opts.slug) body.slug = opts.slug;
+      if (opts.content) body.content = opts.content;
+      if (opts.markdown) body.markdown = opts.markdown;
+      if (opts.thumbnailUrl) body.thumbnail_url = opts.thumbnailUrl;
+      if (opts.categories) body.categories = opts.categories.split(',').map((s) => s.trim());
+      if (opts.seoTitle || opts.seoDescription) {
+        body.seo = {};
+        if (opts.seoTitle) body.seo.title = opts.seoTitle;
+        if (opts.seoDescription) body.seo.description = opts.seoDescription;
+      }
+      body.active = !opts.inactive;
+
+      const data = await api.post(`/directories/${dir}/articles`, body);
+      spinner.stop();
+      const result = data.data || data;
+      printSuccess(`Article created: ${result.title} (ID: ${result.id})`);
+    } catch (err) {
+      spinner.stop();
+      printError(err.message);
+      process.exit(1);
+    }
+  });
+
+articles
+  .command('update <id>')
+  .description('Update an article')
+  .option('--title <title>', 'Article title')
+  .option('--slug <slug>', 'URL slug')
+  .option('--content <text>', 'HTML content')
+  .option('--markdown <text>', 'Markdown content')
+  .option('--thumbnail-url <url>', 'Thumbnail image URL')
+  .option('--categories <names>', 'Category names (comma-separated)')
+  .option('--seo-title <text>', 'SEO title')
+  .option('--seo-description <text>', 'SEO description')
+  .option('--active <bool>', 'Active status (true/false)')
+  .option('-d, --directory <id>', 'Directory ID')
+  .action(async (id, opts) => {
+    const spinner = ora('Updating article...').start();
+    try {
+      const dir = resolveDirectory(opts);
+      const body = {};
+      if (opts.title) body.title = opts.title;
+      if (opts.slug) body.slug = opts.slug;
+      if (opts.content) body.content = opts.content;
+      if (opts.markdown) body.markdown = opts.markdown;
+      if (opts.thumbnailUrl) body.thumbnail_url = opts.thumbnailUrl;
+      if (opts.categories) body.categories = opts.categories.split(',').map((s) => s.trim());
+      if (opts.active !== undefined) body.active = opts.active === 'true';
+      if (opts.seoTitle || opts.seoDescription) {
+        body.seo = {};
+        if (opts.seoTitle) body.seo.title = opts.seoTitle;
+        if (opts.seoDescription) body.seo.description = opts.seoDescription;
+      }
+
+      const data = await api.put(`/directories/${dir}/articles/${id}`, body);
+      spinner.stop();
+      printSuccess(`Article updated: ${data.data?.title || data.title}`);
+    } catch (err) {
+      spinner.stop();
+      printError(err.message);
+      process.exit(1);
+    }
+  });
+
+articles
+  .command('delete <id>')
+  .description('Delete an article')
+  .option('-d, --directory <id>', 'Directory ID')
+  .action(async (id, opts) => {
+    const spinner = ora('Deleting article...').start();
+    try {
+      const dir = resolveDirectory(opts);
+      await api.delete(`/directories/${dir}/articles/${id}`);
+      spinner.stop();
+      printSuccess(`Article ${id} deleted.`);
+    } catch (err) {
+      spinner.stop();
+      printError(err.message);
+      process.exit(1);
+    }
+  });
+
+articles
+  .command('toggle <id>')
+  .description('Toggle article active/inactive status')
+  .option('-d, --directory <id>', 'Directory ID')
+  .action(async (id, opts) => {
+    const spinner = ora('Toggling article...').start();
+    try {
+      const dir = resolveDirectory(opts);
+      const data = await api.patch(`/directories/${dir}/articles/${id}/toggle`);
+      spinner.stop();
+      const result = data.data || data;
+      printSuccess(`Article "${result.title}" is now ${result.active ? 'active' : 'inactive'}.`);
+    } catch (err) {
+      spinner.stop();
+      printError(err.message);
+      process.exit(1);
+    }
+  });
+
+articles
+  .command('exists')
+  .description('Check if an article with a given slug exists')
+  .requiredOption('--slug <slug>', 'Slug to check')
+  .option('-d, --directory <id>', 'Directory ID')
+  .action(async (opts) => {
+    try {
+      const dir = resolveDirectory(opts);
+      const data = await api.post(`/directories/${dir}/articles/exists`, { slug: opts.slug });
+      printSuccess(data.message);
+    } catch (err) {
+      printError(err.message);
+      process.exit(1);
+    }
+  });
+
+export default articles;

package/src/commands/auth.js

@@ -0,0 +1,54 @@
+import { Command } from 'commander';
+import { setToken, clearToken, getToken, api } from '../utils/api.js';
+import { printSuccess, printError, printInfo } from '../utils/output.js';
+import ora from 'ora';
+
+const auth = new Command('auth').description('Manage authentication');
+
+auth
+  .command('login <token>')
+  .description('Authenticate with your Directify API token')
+  .action(async (token) => {
+    const spinner = ora('Verifying token...').start();
+    try {
+      setToken(token);
+      const data = await api.get('/user');
+      spinner.stop();
+      printSuccess(`Authenticated as ${data.name} (${data.email})`);
+    } catch (err) {
+      clearToken();
+      spinner.stop();
+      printError(`Authentication failed: ${err.message}`);
+      process.exit(1);
+    }
+  });
+
+auth
+  .command('logout')
+  .description('Remove stored authentication token')
+  .action(() => {
+    clearToken();
+    printSuccess('Logged out successfully.');
+  });
+
+auth
+  .command('status')
+  .description('Check current authentication status')
+  .action(async () => {
+    const token = getToken();
+    if (!token) {
+      printInfo('Not authenticated. Run: directify auth login <token>');
+      return;
+    }
+    const spinner = ora('Checking...').start();
+    try {
+      const data = await api.get('/user');
+      spinner.stop();
+      printSuccess(`Authenticated as ${data.name} (${data.email})`);
+    } catch (err) {
+      spinner.stop();
+      printError(`Token invalid: ${err.message}`);
+    }
+  });
+
+export default auth;