@verbatims/cli 1.0.2 → 1.0.3

package/README.md

@@ -42,6 +42,10 @@ verbatims quotes browse
 # Search
 verbatims search "love" --type quotes
 
+# Apply a reproducible theme manifest (safe to preview first)
+verbatims themes apply ./theme.json --dry-run
+verbatims themes apply ./theme.json
+
 # List social platforms with queue stats
 verbatims social platforms
 
@@ -58,6 +62,8 @@ verbatims social queue run-now --platform bluesky
 verbatims --help
 ```
 
+Theme manifests use `schema_version: 1`, a stable `slug`, a `name`, and an explicit `filters` array. Optional translations (including homepage copy), language, priority, description, and config are validated before a write. Applying the same manifest reconciles filters by type/value, retaining IDs for unchanged filters; translations reconcile by language, and omitted homepage copy is preserved. Activation and default status are left unchanged. Keep manifests in version control to review theme changes before applying them. See [`examples/themes/quiet-courage.json`](examples/themes/quiet-courage.json).
+
 ### Social commands
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@verbatims/cli",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "description": "CLI for the Verbatims quotes API",
   "type": "module",
   "bin": {

package/src/commands/quotes.ts

@@ -95,12 +95,13 @@ export function registerQuotesCommand(program: Command) {
         }),
         format,
       )
-      if (options.sourceType && data) {
+      const sourceType = options.sourceType
+      if (sourceType && data) {
         const primary = data.attributions?.find(attribution => attribution.is_primary)
         if (!primary) throw new Error('The created quote has no primary attribution')
         await withSpinner('Creating source', () => client.quotes.createSource(data.id, {
           attribution_id: primary.id,
-          source_type: options.sourceType,
+          source_type: sourceType,
           source_url: options.sourceUrl,
           is_primary: true,
         }), format)

package/src/commands/themes.ts

@@ -1,4 +1,6 @@
 import type { Command } from 'commander'
+import { readFile } from 'node:fs/promises'
+import { resolve } from 'node:path'
 import { text, isCancel, cancel, confirm } from '@clack/prompts'
 import chalk from 'chalk'
 import { getClient } from '../utils/client.js'
@@ -47,6 +49,44 @@ export function registerThemesCommand(program: Command) {
       output(data, format)
     })
 
+  themes
+    .command('apply <file>')
+    .description('Create or reconcile a theme from a versioned JSON manifest')
+    .option('--dry-run', 'Validate and show the planned operation without changing data')
+    .action(async (file: string, options: { dryRun?: boolean }) => {
+      const sdk = await import('@verbatims/sdk')
+      if (!('parseThemeManifest' in sdk) || typeof sdk.parseThemeManifest !== 'function') {
+        throw new Error('Theme manifests require a newer @verbatims/sdk. Update the SDK and try again.')
+      }
+      const parseThemeManifest = sdk.parseThemeManifest
+      const manifest = parseThemeManifest(JSON.parse(await readFile(resolve(file), 'utf8')))
+      const client = await getClient()
+      if (typeof client.themes.apply !== 'function') {
+        throw new Error('Theme manifests require a newer @verbatims/sdk. Update the SDK and try again.')
+      }
+      const format = getFormat(program)
+
+      if (options.dryRun) {
+        const { data } = await withSpinner('Checking existing themes', () =>
+          client.themes.list({ search: manifest.slug, limit: 100 }), format)
+        const existing = data?.find(theme => theme.slug === manifest.slug)
+        output({
+          operation: existing ? 'update' : 'create',
+          slug: manifest.slug,
+          name: manifest.name,
+          filters: manifest.filters?.length ?? 0,
+          translations: manifest.translations?.length ?? 'unchanged',
+          activation: 'unchanged',
+          defaultStatus: 'unchanged',
+        }, format)
+        return
+      }
+
+      const result = await withSpinner('Applying theme manifest', () => client.themes.apply(manifest), format)
+      console.log(chalk.green(` Theme ${result.operation}`))
+      output(result.data, format)
+    })
+
   themes
     .command('create')
     .description('Create a theme')