directify-cli 1.3.0 → 1.4.0

package/README.md

@@ -116,10 +116,28 @@ directify tags delete 10
 ### Custom Fields
 
 ```bash
+# List / get
 directify fields list                 # List all custom fields
 directify fields ls --json            # Output as JSON
+directify fields get 12
+
+# Create (label + type required)
+directify fields create \
+  --label "Price Range" \
+  --type select \
+  --options "$,$$,$$$" \
+  --filterable \
+  --on-card
+
+directify fields create --label "Founded Year" --type number
+
+# Update / delete
+directify fields update 12 --label "Pricing Tier" --required true
+directify fields delete 12
 ```
 
+Field types: `text`, `number`, `date`, `file_upload`, `url`, `email`, `rich_editor`, `markdown`, `textarea`, `checkbox`, `rating`, `select`, `list`, `multi_select`, `button`, `javascript`, `html`. The `--name` (machine key) is auto-derived from `--label` if omitted. Set a field's value on a listing via `listings create/update --field "name=value"`.
+
 ### Listings
 
 ```bash
@@ -141,13 +159,15 @@ directify listings create \
   --email "info@bellatrattoria.com" \
   --categories 1,5,12 \
   --tags 3,7 \
+  --organizers 5,8 \
   --featured \
   --field "price_range=2" \
   --field "cuisine_type=Italian, Pasta"
 
-# Update
+# Update (--organizers replaces the listing's current organizer links)
 directify listings update 456 \
   --name "Bella Trattoria NYC" \
+  --organizers 5 \
   --featured true \
   --field "hours_of_operation=Mon | 11:00 - 22:00"
 
@@ -174,6 +194,7 @@ Create a JSON file with an array of listings:
       "description": "Great food",
       "categories": [1, 2],
       "tags": [3],
+      "organizers": [5],
       "price_range": "2",
       "cuisine_type": "Italian"
     },
@@ -194,6 +215,27 @@ Then run:
 directify listings bulk-create --file ./listings.json
 ```
 
+> **Linking organizers:** `--organizers` (and the `organizers` array in the bulk JSON) takes a comma-separated list of organizer IDs to associate the listing with. Only organizers in the same directory are linked; out-of-directory IDs are ignored. On `update`, the list replaces the listing's current organizers. Use `directify organizers list` to find the IDs.
+
+### Organizers
+
+Organizers (agencies, studios, event hosts, etc.) can be linked to multiple listings.
+
+```bash
+# List / get
+directify organizers list
+directify organizers get 5
+
+# Create
+directify organizers create --name "Acme Events" --website "https://acme-events.com"
+
+# Update / delete
+directify organizers update 5 --name "Acme Events Co."
+directify organizers delete 5
+```
+
+To link an organizer to a listing, pass its ID via `--organizers` on `listings create`/`update` (see above).
+
 ### Articles
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "directify-cli",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Official CLI tool for Directify - manage your directories, listings, categories, tags, and articles from the command line.",
   "main": "src/index.js",
   "bin": {

package/src/commands/fields.js

@@ -1,9 +1,11 @@
 import { Command } from 'commander';
 import { api, resolveDirectory } from '../utils/api.js';
-import { printTable, printJson, printError } from '../utils/output.js';
+import { printTable, printJson, printSuccess, printError } from '../utils/output.js';
 import ora from 'ora';
 
-const fields = new Command('fields').description('List custom fields');
+const fields = new Command('fields').description('Manage custom fields');
+
+const FIELD_TYPES = 'text, number, date, file_upload, url, email, rich_editor, markdown, textarea, checkbox, rating, select, list, multi_select, button, javascript, html';
 
 fields
   .command('list')
@@ -38,4 +40,140 @@ fields
     }
   });
 
+fields
+  .command('get <id>')
+  .description('Get a specific custom field')
+  .option('-d, --directory <id>', 'Directory ID')
+  .action(async (id, opts) => {
+    try {
+      const dir = resolveDirectory(opts);
+      const data = await api.get(`/directories/${dir}/custom-fields/${id}`);
+      printJson(data.data || data);
+    } catch (err) {
+      printError(err.message);
+      process.exit(1);
+    }
+  });
+
+fields
+  .command('create')
+  .description('Create a new custom field definition')
+  .requiredOption('--label <label>', 'Human-readable field label')
+  .requiredOption('--type <type>', `Field type (${FIELD_TYPES})`)
+  .option('--name <name>', 'Machine name/key (auto-derived from label if omitted)')
+  .option('--fieldable-type <type>', 'What the field attaches to: listing, organizer, article (default: listing)')
+  .option('--placeholder <text>', 'Input placeholder text')
+  .option('--description <text>', 'Help text shown under the field')
+  .option('--default <value>', 'Default value')
+  .option('--prefix <value>', 'Prefix shown before the value (e.g. $)')
+  .option('--suffix <value>', 'Suffix shown after the value (e.g. /mo)')
+  .option('--options <values>', 'Options for select/multi_select/list types (comma-separated)')
+  .option('--required', 'Mark the field as required')
+  .option('--filterable', 'Allow filtering listings by this field')
+  .option('--on-card', 'Show the value on listing cards')
+  .option('--public', 'Show the field on the public submission form')
+  .option('--hidden', 'Hide the field from the listing page')
+  .option('--order <n>', 'Sort order', parseInt)
+  .option('-d, --directory <id>', 'Directory ID')
+  .action(async (opts) => {
+    const spinner = ora('Creating custom field...').start();
+    try {
+      const dir = resolveDirectory(opts);
+      const body = { label: opts.label, type: opts.type };
+      if (opts.name) body.name = opts.name;
+      if (opts.fieldableType) body.fieldable_type = opts.fieldableType;
+      if (opts.placeholder) body.placeholder = opts.placeholder;
+      if (opts.description) body.description = opts.description;
+      if (opts.default) body.default_value = opts.default;
+      if (opts.prefix) body.value_prefix = opts.prefix;
+      if (opts.suffix) body.value_suffix = opts.suffix;
+      if (opts.options) body.options = opts.options.split(',').map((o) => o.trim());
+      if (opts.required) body.is_required = true;
+      if (opts.filterable) body.filterable = true;
+      if (opts.onCard) body.show_on_card = true;
+      if (opts.public) body.show_on_public_submission = true;
+      if (opts.hidden) body.is_visible = false;
+      if (opts.order !== undefined) body.order = opts.order;
+
+      const data = await api.post(`/directories/${dir}/custom-fields`, body);
+      spinner.stop();
+      const result = data.data || data;
+      printSuccess(`Custom field created: ${result.label} (${result.name}, ID: ${result.id})`);
+    } catch (err) {
+      spinner.stop();
+      printError(err.message);
+      process.exit(1);
+    }
+  });
+
+fields
+  .command('update <id>')
+  .description('Update a custom field definition')
+  .option('--label <label>', 'Human-readable field label')
+  .option('--type <type>', `Field type (${FIELD_TYPES})`)
+  .option('--name <name>', 'Machine name/key')
+  .option('--fieldable-type <type>', 'What the field attaches to: listing, organizer, article')
+  .option('--placeholder <text>', 'Input placeholder text')
+  .option('--description <text>', 'Help text shown under the field')
+  .option('--default <value>', 'Default value')
+  .option('--prefix <value>', 'Prefix shown before the value')
+  .option('--suffix <value>', 'Suffix shown after the value')
+  .option('--options <values>', 'Options for select/multi_select/list types (comma-separated)')
+  .option('--required <bool>', 'Required status (true/false)')
+  .option('--filterable <bool>', 'Filterable status (true/false)')
+  .option('--on-card <bool>', 'Show on cards (true/false)')
+  .option('--public <bool>', 'Show on public submission form (true/false)')
+  .option('--visible <bool>', 'Visible on the listing page (true/false)')
+  .option('--order <n>', 'Sort order', parseInt)
+  .option('-d, --directory <id>', 'Directory ID')
+  .action(async (id, opts) => {
+    const spinner = ora('Updating custom field...').start();
+    try {
+      const dir = resolveDirectory(opts);
+      const body = {};
+      if (opts.label) body.label = opts.label;
+      if (opts.type) body.type = opts.type;
+      if (opts.name) body.name = opts.name;
+      if (opts.fieldableType) body.fieldable_type = opts.fieldableType;
+      if (opts.placeholder) body.placeholder = opts.placeholder;
+      if (opts.description) body.description = opts.description;
+      if (opts.default) body.default_value = opts.default;
+      if (opts.prefix) body.value_prefix = opts.prefix;
+      if (opts.suffix) body.value_suffix = opts.suffix;
+      if (opts.options) body.options = opts.options.split(',').map((o) => o.trim());
+      if (opts.required !== undefined) body.is_required = opts.required === 'true';
+      if (opts.filterable !== undefined) body.filterable = opts.filterable === 'true';
+      if (opts.onCard !== undefined) body.show_on_card = opts.onCard === 'true';
+      if (opts.public !== undefined) body.show_on_public_submission = opts.public === 'true';
+      if (opts.visible !== undefined) body.is_visible = opts.visible === 'true';
+      if (opts.order !== undefined) body.order = opts.order;
+
+      const data = await api.put(`/directories/${dir}/custom-fields/${id}`, body);
+      spinner.stop();
+      printSuccess(`Custom field updated: ${data.data?.label || data.label}`);
+    } catch (err) {
+      spinner.stop();
+      printError(err.message);
+      process.exit(1);
+    }
+  });
+
+fields
+  .command('delete <id>')
+  .description('Delete a custom field definition (also removes its values from all listings)')
+  .option('-d, --directory <id>', 'Directory ID')
+  .action(async (id, opts) => {
+    const spinner = ora('Deleting custom field...').start();
+    try {
+      const dir = resolveDirectory(opts);
+      await api.delete(`/directories/${dir}/custom-fields/${id}`);
+      spinner.stop();
+      printSuccess(`Custom field ${id} deleted.`);
+    } catch (err) {
+      spinner.stop();
+      printError(err.message);
+      process.exit(1);
+    }
+  });
+
 export default fields;

package/src/commands/listings.js

@@ -73,6 +73,7 @@ listings
   .option('--lng <n>', 'Longitude', parseFloat)
   .option('--categories <ids>', 'Category IDs (comma-separated)')
   .option('--tags <ids>', 'Tag IDs (comma-separated)')
+  .option('--organizers <ids>', 'Organizer IDs to link (comma-separated)')
   .option('--featured', 'Mark as featured')
   .option('--inactive', 'Create as inactive')
   .option('--field <key=value...>', 'Custom field values (repeatable)', collect, [])
@@ -95,6 +96,7 @@ listings
       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.organizers) body.organizers = opts.organizers.split(',').map(Number);
       if (opts.featured) body.is_featured = true;
       if (opts.inactive) body.is_active = false;
 
@@ -132,6 +134,7 @@ listings
   .option('--lng <n>', 'Longitude', parseFloat)
   .option('--categories <ids>', 'Category IDs (comma-separated)')
   .option('--tags <ids>', 'Tag IDs (comma-separated)')
+  .option('--organizers <ids>', 'Organizer IDs to link, replaces current set (comma-separated; out-of-directory IDs are ignored)')
   .option('--featured <bool>', 'Featured status (true/false)')
   .option('--active <bool>', 'Active status (true/false)')
   .option('--field <key=value...>', 'Custom field values (repeatable)', collect, [])
@@ -155,6 +158,7 @@ listings
       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.organizers) body.organizers = opts.organizers.split(',').map(Number);
       if (opts.featured !== undefined) body.is_featured = opts.featured === 'true';
       if (opts.active !== undefined) body.is_active = opts.active === 'true';
 

package/src/commands/organizers.js

@@ -56,9 +56,11 @@ organizers
   .description('Create a new organizer')
   .requiredOption('--name <name>', 'Organizer name')
   .option('--slug <slug>', 'URL slug (auto-generated from name if not provided)')
-  .option('--description <text>', 'Description')
+  .option('--description <text>', 'Short description')
+  .option('--content <text>', 'Long-form content (markdown supported)')
   .option('--email <email>', 'Contact email')
   .option('--phone <phone>', 'Contact phone')
+  .option('--address <address>', 'Physical address')
   .option('--website <url>', 'Website URL')
   .option('--user-id <id>', 'Assign to a user (submitter) by ID')
   .option('--inactive', 'Create as inactive')
@@ -72,8 +74,10 @@ organizers
         name: opts.name,
         ...(opts.slug && { slug: opts.slug }),
         ...(opts.description && { description: opts.description }),
+        ...(opts.content && { content: opts.content }),
         ...(opts.email && { email: opts.email }),
         ...(opts.phone && { phone: opts.phone }),
+        ...(opts.address && { address: opts.address }),
         ...(opts.website && { website_url: opts.website }),
         ...(opts.userId && { user_id: Number(opts.userId) }),
         is_active: !opts.inactive,
@@ -94,9 +98,11 @@ organizers
   .description('Update an organizer')
   .option('--name <name>', 'Organizer name')
   .option('--slug <slug>', 'URL slug')
-  .option('--description <text>', 'Description')
+  .option('--description <text>', 'Short description')
+  .option('--content <text>', 'Long-form content (markdown supported)')
   .option('--email <email>', 'Contact email')
   .option('--phone <phone>', 'Contact phone')
+  .option('--address <address>', 'Physical address')
   .option('--website <url>', 'Website URL')
   .option('--user-id <id>', 'Assign to a user (submitter) by ID')
   .option('--active <bool>', 'Active status (true/false)')
@@ -110,8 +116,10 @@ organizers
       if (opts.name) body.name = opts.name;
       if (opts.slug) body.slug = opts.slug;
       if (opts.description) body.description = opts.description;
+      if (opts.content) body.content = opts.content;
       if (opts.email) body.email = opts.email;
       if (opts.phone) body.phone = opts.phone;
+      if (opts.address) body.address = opts.address;
       if (opts.website) body.website_url = opts.website;
       if (opts.userId) body.user_id = Number(opts.userId);
       if (opts.active !== undefined) body.is_active = opts.active === 'true';