@verbatims/cli 1.0.3 → 1.0.4

package/README.md

@@ -42,6 +42,15 @@ verbatims quotes browse
 # Search
 verbatims search "love" --type quotes
 
+# Manage collections
+verbatims collections list --limit 20
+verbatims collections get 12 --page 1 --limit 20
+verbatims collections create --name "Favorite quotes" --public
+verbatims collections update 12 --name "Reading notes" --private
+verbatims collections add 12 123
+verbatims collections remove 12 123
+verbatims collections delete 12 --yes
+
 # Apply a reproducible theme manifest (safe to preview first)
 verbatims themes apply ./theme.json --dry-run
 verbatims themes apply ./theme.json

package/package.json

@@ -1,8 +1,11 @@
 {
   "name": "@verbatims/cli",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "CLI for the Verbatims quotes API",
   "type": "module",
+  "engines": {
+    "node": "^22 || ^24"
+  },
   "bin": {
     "verbatims": "./bin/verbatims.js"
   },
@@ -16,7 +19,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@verbatims/sdk": "^2.0.2",
+    "@verbatims/sdk": "^2.0.3",
     "@clack/prompts": "^0.10.1",
     "chalk": "^5.4.1",
     "commander": "^13.1.0",

package/src/commands/collections.ts

@@ -1,5 +1,5 @@
 import type { Command } from 'commander'
-import { text, isCancel, cancel } from '@clack/prompts'
+import { text, isCancel, cancel, confirm } from '@clack/prompts'
 import chalk from 'chalk'
 import { getClient } from '../utils/client.js'
 import { output, type Format } from '../utils/format.js'
@@ -12,6 +12,39 @@ function getFormat(program: Command): Format {
 export function registerCollectionsCommand(program: Command) {
   const collections = program.command('collections').description('Manage collections')
 
+  collections
+    .command('list')
+    .description('List collections')
+    .option('--page <n>', 'Page number', '1')
+    .option('--limit <n>', 'Number of results', '20')
+    .action(async (options: Record<string, string>) => {
+      const client = await getClient()
+      const format = getFormat(program)
+      const { data, pagination } = await withSpinner('Fetching collections', () =>
+        client.collections.list({ page: Number(options.page), limit: Number(options.limit) }),
+        format,
+      )
+      output(data, format)
+      if (pagination && format !== 'json') {
+        console.log(chalk.dim(`\nPage ${pagination.page}/${pagination.totalPages} — ${pagination.total} total`))
+      }
+    })
+
+  collections
+    .command('get <id>')
+    .description('Get a collection and its quotes')
+    .option('--page <n>', 'Quote page number', '1')
+    .option('--limit <n>', 'Quotes per page', '20')
+    .action(async (id: string, options: Record<string, string>) => {
+      const client = await getClient()
+      const format = getFormat(program)
+      const { data } = await withSpinner('Fetching collection', () =>
+        client.collections.get(Number(id), { page: Number(options.page), limit: Number(options.limit) }),
+        format,
+      )
+      output(data, format)
+    })
+
   collections
     .command('create')
     .description('Create a collection')
@@ -33,6 +66,51 @@ export function registerCollectionsCommand(program: Command) {
       output(data, format)
     })
 
+  collections
+    .command('update <id>')
+    .description('Update a collection')
+    .option('--name <name>', 'Collection name')
+    .option('--description <text>', 'Description (use an empty value to clear)')
+    .option('--public', 'Make collection public')
+    .option('--private', 'Make collection private')
+    .action(async (id: string, options: Record<string, string | boolean>) => {
+      if (options.public && options.private) {
+        throw new Error('Choose either --public or --private')
+      }
+      const data: { name?: string; description?: string | null; is_public?: boolean } = {}
+      if (options.name) data.name = options.name as string
+      if (options.description !== undefined) data.description = options.description ? options.description as string : null
+      if (options.public) data.is_public = true
+      if (options.private) data.is_public = false
+      if (Object.keys(data).length === 0) {
+        throw new Error('Provide at least one field to update')
+      }
+
+      const client = await getClient()
+      const format = getFormat(program)
+      const { data: updated } = await withSpinner('Updating collection', () =>
+        client.collections.update(Number(id), data),
+        format,
+      )
+      console.log(chalk.green(' Collection updated'))
+      output(updated, format)
+    })
+
+  collections
+    .command('delete <id>')
+    .description('Delete a collection')
+    .option('--yes', 'Skip confirmation')
+    .action(async (id: string, options: { yes?: boolean }) => {
+      if (!options.yes) {
+        const confirmed = await confirm({ message: `Delete collection #${id}?` })
+        if (isCancel(confirmed) || !confirmed) cancel('Cancelled')
+      }
+      const client = await getClient()
+      const format = getFormat(program)
+      await withSpinner('Deleting collection', () => client.collections.delete(Number(id)), format)
+      console.log(chalk.green(` Collection #${id} deleted`))
+    })
+
   collections
     .command('add <collection-id> <quote-id>')
     .description('Add a quote to a collection')