@verbatims/cli 1.0.3 → 1.0.5

package/README.md

@@ -30,6 +30,11 @@ verbatims quotes attributions list 123
 verbatims quotes attributions create 123 --author-id 1 --reference-id 2 --status manually_verified --primary
 verbatims quotes sources list 123
 verbatims quotes sources create 123 --attribution-id 7 --source-type book --source-url https://example.com/edition --status externally_verified
+verbatims quotes sources update 123 7 --translator-name "Jane Doe"
+
+# Structured author dates (era can be bce or ce)
+verbatims authors create --name "Hypatia" --birth-year 350 --birth-era ce --birth-approximate
+verbatims authors update 12 --death-year 415 --death-era ce --death-approximate
 
 # Create a quote with a source
 verbatims quotes create --name "Alea jacta est" --author-id 1 --source-type book --source-url https://example.com/edition
@@ -42,6 +47,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.5",
   "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.4",
     "@clack/prompts": "^0.10.1",
     "chalk": "^5.4.1",
     "commander": "^13.1.0",

package/src/commands/authors.ts

@@ -11,6 +11,36 @@ function getFormat(program: Command): Format {
   return (program.opts().format ?? 'table') as Format
 }
 
+function getLifeDateFields(options: Record<string, unknown>): Record<string, unknown> {
+  const fields: Record<string, unknown> = {}
+  const dateParts = ['date', 'year', 'era', 'month', 'day', 'approximate'] as const
+
+  for (const period of ['birth', 'death'] as const) {
+    for (const part of dateParts) {
+      const optionName = part === 'approximate' ? `${period}Approximate` : `${period}${part.slice(0, 1).toUpperCase()}${part.slice(1)}`
+      const fieldName = part === 'approximate' ? `${period}_is_approximate` : `${period}_${part}`
+      const value = options[optionName]
+      if (value !== undefined) fields[fieldName] = part === 'year' || part === 'month' || part === 'day' ? Number(value) : value
+    }
+  }
+
+  return fields
+}
+
+function addLifeDateOptions(command: Command): void {
+  for (const period of ['birth', 'death'] as const) {
+    const label = period === 'birth' ? 'Birth' : 'Death'
+    command
+      .option(`--${period}-date <date>`, `${label} date`)
+      .option(`--${period}-year <year>`, `${label} year (supports BCE with --${period}-era bce)`)
+      .option(`--${period}-era <era>`, `${label} era: bce or ce`)
+      .option(`--${period}-month <month>`, `${label} month`)
+      .option(`--${period}-day <day>`, `${label} day`)
+      .option(`--${period}-approximate`, `Mark ${label.toLowerCase()} date as approximate`)
+      .option(`--no-${period}-approximate`, `Mark ${label.toLowerCase()} date as exact`)
+  }
+}
+
 export function registerAuthorsCommand(program: Command) {
   const authors = program.command('authors').description('Manage authors')
 
@@ -42,8 +72,8 @@ export function registerAuthorsCommand(program: Command) {
       output(data, format)
     })
 
-  authors
-    .command('create')
+  const createAuthor = authors.command('create')
+  createAuthor
     .description('Create an author')
     .option('--name <name>', 'Author name')
     .option('--job <job>', 'Job title')
@@ -51,15 +81,15 @@ export function registerAuthorsCommand(program: Command) {
     .option('--image-url <url>', 'Image URL')
     .option('--image-path <path>', 'Local image file path')
     .option('--fictional', 'Mark as fictional')
-    .action(async (options: Record<string, string>) => {
+    .action(async (options: Record<string, unknown>) => {
       const client = await getClient()
       const format = getFormat(program)
 
-      const name = options.name ?? await text({ message: 'Author name', validate: (v) => !v ? 'Required' : undefined })
+      const name = (options.name as string | undefined) ?? await text({ message: 'Author name', validate: (v) => !v ? 'Required' : undefined })
       if (isCancel(name)) cancel('Cancelled')
 
-      let image_url: string | null = options.imageUrl || null
-      const imagePath = options.imagePath
+      let image_url: string | null = typeof options.imageUrl === 'string' ? options.imageUrl : null
+      const imagePath = typeof options.imagePath === 'string' ? options.imagePath : undefined
       if (imagePath) {
         image_url = await withSpinner('Uploading image', () => uploadImageFromPath(client, imagePath), format)
       }
@@ -67,10 +97,11 @@ export function registerAuthorsCommand(program: Command) {
       const { data } = await withSpinner('Creating author', () =>
         client.authors.create({
           name: name as string,
-          job: options.job ?? null,
-          description: options.description ?? null,
+          job: (options.job as string | undefined) ?? null,
+          description: (options.description as string | undefined) ?? null,
           image_url,
-          fictional: options.fictional !== undefined ? true : undefined,
+          fictional: options.fictional === true ? true : undefined,
+          ...getLifeDateFields(options),
         }),
         format,
       )
@@ -78,8 +109,8 @@ export function registerAuthorsCommand(program: Command) {
       output(data, format)
     })
 
-  authors
-    .command('update <id>')
+  const updateAuthor = authors.command('update <id>')
+  updateAuthor
     .description('Update an author')
     .option('--name <name>', 'Author name')
     .option('--job <job>', 'Job title')
@@ -88,27 +119,30 @@ export function registerAuthorsCommand(program: Command) {
     .option('--image-path <path>', 'Local image file path')
     .option('--fictional', 'Mark as fictional')
     .option('--no-fictional', 'Mark as not fictional')
-    .action(async (id: string, options: Record<string, string>) => {
+    .action(async (id: string, options: Record<string, unknown>) => {
       const client = await getClient()
       const format = getFormat(program)
 
       const data_: Record<string, unknown> = {}
-      if (options.name) data_.name = options.name
+      if (typeof options.name === 'string') data_.name = options.name
       if (options.job !== undefined) data_.job = options.job || null
       if (options.description !== undefined) data_.description = options.description || null
       if (options.imageUrl !== undefined) data_.image_url = options.imageUrl || null
-      const updateImagePath = options.imagePath
+      const updateImagePath = typeof options.imagePath === 'string' ? options.imagePath : undefined
       if (updateImagePath !== undefined) {
         data_.image_url = await withSpinner('Uploading image', () => uploadImageFromPath(client, updateImagePath), format)
       }
-      if (options.fictional !== undefined) data_.is_fictional = true
-      if (options.noFictional !== undefined) data_.is_fictional = false
+      if (options.fictional !== undefined) data_.is_fictional = options.fictional === true
+      Object.assign(data_, getLifeDateFields(options))
 
       const { data } = await withSpinner('Updating author', () => client.authors.update(Number(id), data_ as any), format)
       console.log(chalk.green(' Author updated'))
       output(data, format)
     })
 
+  addLifeDateOptions(createAuthor)
+  addLifeDateOptions(updateAuthor)
+
   authors
     .command('delete <id>')
     .description('Delete an author')

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')

package/src/commands/quotes.ts

@@ -70,6 +70,7 @@ export function registerQuotesCommand(program: Command) {
     .option('--reference-id <id>', 'Primary attribution reference ID')
     .option('--source-type <type>', 'Source type for the primary attribution')
     .option('--source-url <url>', 'Source URL for the primary attribution')
+    .option('--translator-name <name>', 'Translator name for the primary source')
     .action(async (options: Record<string, string>) => {
       const client = await getClient()
       const format = getFormat(program)
@@ -103,6 +104,7 @@ export function registerQuotesCommand(program: Command) {
           attribution_id: primary.id,
           source_type: sourceType,
           source_url: options.sourceUrl,
+          translator_name: options.translatorName,
           is_primary: true,
         }), format)
       }
@@ -292,6 +294,7 @@ export function registerQuotesCommand(program: Command) {
     .option('--source-type <type>', 'Source type')
     .option('--source-url <url>', 'Source URL')
     .option('--label <label>', 'Source label')
+    .option('--translator-name <name>', 'Translator name')
     .option('--status <status>', 'Verification status')
     .option('--notes <text>', 'Internal notes')
     .option('--primary', 'Set as primary source')
@@ -314,6 +317,7 @@ export function registerQuotesCommand(program: Command) {
           source_type: options.sourceType,
           source_url: options.sourceUrl,
           label: options.label,
+          translator_name: options.translatorName,
           verification_status: options.status,
           notes: options.notes,
           is_primary: options.primary,
@@ -329,6 +333,7 @@ export function registerQuotesCommand(program: Command) {
         if (options.sourceType !== undefined) data_.source_type = options.sourceType
         if (options.sourceUrl !== undefined) data_.source_url = options.sourceUrl
         if (options.label !== undefined) data_.label = options.label
+        if (options.translatorName !== undefined) data_.translator_name = options.translatorName
         if (options.status !== undefined) data_.verification_status = options.status
         if (options.notes !== undefined) data_.notes = options.notes
         if (options.primary !== undefined) data_.is_primary = options.primary