directify-cli 1.0.0 → 1.1.1

package/README.md

@@ -226,6 +226,55 @@ directify articles delete 789
 directify articles exists --slug "best-italian-restaurants"
 ```
 
+### Custom Pages
+
+```bash
+# List
+directify pages list
+directify pages ls --json
+
+# Get
+directify pages get 12
+
+# Create a page in the navbar
+directify pages create \
+  --title "About Us" \
+  --markdown "# About Us\n\nWe are a directory of the best restaurants..." \
+  --placement navbar \
+  --seo-title "About Us" \
+  --seo-description "Learn about our restaurant directory"
+
+# Create a programmatic SEO page (unlisted by default)
+directify pages create \
+  --title "NYC vs Chicago Pizza" \
+  --markdown "# NYC vs Chicago Pizza\n\nA detailed comparison..." \
+  --seo-title "Best Pizza: NYC vs Chicago Compared" \
+  --seo-description "Compare pizza styles between New York and Chicago"
+
+# Create a footer link
+directify pages create \
+  --title "Terms of Service" \
+  --markdown "# Terms of Service\n\n..." \
+  --placement footer \
+  --order 1
+
+# Create an external link in the navbar
+directify pages create \
+  --title "Submit a Listing" \
+  --external-url "https://forms.google.com/your-form" \
+  --placement navbar \
+  --new-tab
+
+# Update
+directify pages update 12 --title "Updated Title" --placement footer
+
+# Toggle published/unpublished
+directify pages toggle 12
+
+# Delete
+directify pages delete 12
+```
+
 ## Global Options
 
 All resource commands support these options:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "directify-cli",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "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/pages.js

@@ -0,0 +1,187 @@
+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 pages = new Command('pages').description('Manage custom pages');
+
+pages
+  .command('list')
+  .alias('ls')
+  .description('List all custom pages')
+  .option('-d, --directory <id>', 'Directory ID')
+  .option('--json', 'Output as JSON')
+  .action(async (opts) => {
+    const spinner = ora('Fetching pages...').start();
+    try {
+      const dir = resolveDirectory(opts);
+      const data = await api.get(`/directories/${dir}/pages`);
+      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: 'placement', label: 'Placement' },
+          { key: 'is_published', label: 'Published' },
+          { key: 'order', label: 'Order' },
+        ]);
+        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);
+    }
+  });
+
+pages
+  .command('get <id>')
+  .description('Get a specific page')
+  .option('-d, --directory <id>', 'Directory ID')
+  .action(async (id, opts) => {
+    try {
+      const dir = resolveDirectory(opts);
+      const data = await api.get(`/directories/${dir}/pages/${id}`);
+      printJson(data.data || data);
+    } catch (err) {
+      printError(err.message);
+      process.exit(1);
+    }
+  });
+
+pages
+  .command('create')
+  .description('Create a new custom page')
+  .requiredOption('--title <title>', 'Page title')
+  .option('--slug <slug>', 'URL slug (auto-generated from title if not set)')
+  .option('--markdown <text>', 'Page content in markdown')
+  .option('--placement <type>', 'Where the link appears: navbar, footer, sidebar, unlisted (default: unlisted)')
+  .option('--order <n>', 'Sort order for navigation', '0')
+  .option('--seo-title <text>', 'SEO title')
+  .option('--seo-description <text>', 'SEO description')
+  .option('--external-url <url>', 'External URL (makes this a link, not a page)')
+  .option('--new-tab', 'Open external links in new tab')
+  .option('--unpublished', 'Create as unpublished')
+  .option('-d, --directory <id>', 'Directory ID')
+  .action(async (opts) => {
+    const spinner = ora('Creating page...').start();
+    try {
+      const dir = resolveDirectory(opts);
+      const body = { title: opts.title };
+      if (opts.slug) body.slug = opts.slug;
+      if (opts.markdown) body.markdown = opts.markdown;
+      if (opts.placement) body.placement = opts.placement;
+      if (opts.order) body.order = parseInt(opts.order, 10);
+      if (opts.externalUrl) {
+        body.is_external = true;
+        body.external_url = opts.externalUrl;
+      }
+      if (opts.newTab) body.new_tab = true;
+      if (opts.seoTitle || opts.seoDescription) {
+        body.seo = {};
+        if (opts.seoTitle) body.seo.title = opts.seoTitle;
+        if (opts.seoDescription) body.seo.description = opts.seoDescription;
+      }
+      body.is_published = !opts.unpublished;
+
+      const data = await api.post(`/directories/${dir}/pages`, body);
+      spinner.stop();
+      const result = data.data || data;
+      printSuccess(`Page created: ${result.title} (ID: ${result.id})`);
+    } catch (err) {
+      spinner.stop();
+      printError(err.message);
+      process.exit(1);
+    }
+  });
+
+pages
+  .command('update <id>')
+  .description('Update a custom page')
+  .option('--title <title>', 'Page title')
+  .option('--slug <slug>', 'URL slug')
+  .option('--markdown <text>', 'Page content in markdown')
+  .option('--placement <type>', 'Where the link appears: navbar, footer, sidebar, unlisted')
+  .option('--order <n>', 'Sort order for navigation')
+  .option('--seo-title <text>', 'SEO title')
+  .option('--seo-description <text>', 'SEO description')
+  .option('--external-url <url>', 'External URL')
+  .option('--new-tab <bool>', 'Open in new tab (true/false)')
+  .option('--published <bool>', 'Published status (true/false)')
+  .option('-d, --directory <id>', 'Directory ID')
+  .action(async (id, opts) => {
+    const spinner = ora('Updating page...').start();
+    try {
+      const dir = resolveDirectory(opts);
+      const body = {};
+      if (opts.title) body.title = opts.title;
+      if (opts.slug) body.slug = opts.slug;
+      if (opts.markdown) body.markdown = opts.markdown;
+      if (opts.placement) body.placement = opts.placement;
+      if (opts.order !== undefined) body.order = parseInt(opts.order, 10);
+      if (opts.externalUrl) {
+        body.is_external = true;
+        body.external_url = opts.externalUrl;
+      }
+      if (opts.newTab !== undefined) body.new_tab = opts.newTab === 'true';
+      if (opts.published !== undefined) body.is_published = opts.published === '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}/pages/${id}`, body);
+      spinner.stop();
+      printSuccess(`Page updated: ${data.data?.title || data.title}`);
+    } catch (err) {
+      spinner.stop();
+      printError(err.message);
+      process.exit(1);
+    }
+  });
+
+pages
+  .command('delete <id>')
+  .description('Delete a custom page')
+  .option('-d, --directory <id>', 'Directory ID')
+  .action(async (id, opts) => {
+    const spinner = ora('Deleting page...').start();
+    try {
+      const dir = resolveDirectory(opts);
+      await api.delete(`/directories/${dir}/pages/${id}`);
+      spinner.stop();
+      printSuccess(`Page ${id} deleted.`);
+    } catch (err) {
+      spinner.stop();
+      printError(err.message);
+      process.exit(1);
+    }
+  });
+
+pages
+  .command('toggle <id>')
+  .description('Toggle page published/unpublished status')
+  .option('-d, --directory <id>', 'Directory ID')
+  .action(async (id, opts) => {
+    const spinner = ora('Toggling page...').start();
+    try {
+      const dir = resolveDirectory(opts);
+      const data = await api.patch(`/directories/${dir}/pages/${id}/toggle`);
+      spinner.stop();
+      const result = data.data || data;
+      printSuccess(`Page "${result.title}" is now ${result.is_published ? 'published' : 'unpublished'}.`);
+    } catch (err) {
+      spinner.stop();
+      printError(err.message);
+      process.exit(1);
+    }
+  });
+
+export default pages;

package/src/index.js

@@ -9,6 +9,7 @@ import tags from './commands/tags.js';
 import fields from './commands/fields.js';
 import listings from './commands/listings.js';
 import articles from './commands/articles.js';
+import pages from './commands/pages.js';
 
 const program = new Command();
 
@@ -25,5 +26,6 @@ program.addCommand(tags);
 program.addCommand(fields);
 program.addCommand(listings);
 program.addCommand(articles);
+program.addCommand(pages);
 
 program.parse();