wpops 0.1.1 → 0.2.0

package/lib/abilities.js

@@ -0,0 +1,51 @@
+// Abilities API 命令(/wp-json/wp-abilities/v1/abilities)。
+// 需要站点安装并启用 Abilities API 插件。
+import { printJson, dry, parseJson } from './util.js';
+
+const ABILITIES = '/wp-json/wp-abilities/v1/abilities';
+
+/** 端点可能返回数组、{ abilities: [...] } 或按名字索引的对象,统一成数组。 */
+function asList(data) {
+  if (Array.isArray(data)) return data;
+  if (Array.isArray(data?.abilities)) return data.abilities;
+  if (data && typeof data === 'object') return Object.values(data);
+  return [];
+}
+
+/** 列表:GET /abilities。字段可能缺失,逐项容错。 */
+export async function listAbilities(client, flags) {
+  const { data } = await client.request('GET', ABILITIES);
+  if (flags.json) return printJson(data);
+  const items = asList(data);
+  console.log(`Abilities ${items.length} 个:`);
+  for (const item of items) {
+    const name = item?.name ?? item?.id ?? '?';
+    const label = item?.label ?? '';
+    const description = item?.description ?? '';
+    console.log(`  ${name}  ${label}  ${description}`);
+  }
+}
+
+/** 详情:GET /abilities/{name}。 */
+export async function getAbility(client, name, flags) {
+  const { data } = await client.request('GET', `${ABILITIES}/${encodeURIComponent(name)}`);
+  if (flags.json) return printJson(data);
+  console.log(`${data?.name ?? name}  ${data?.label ?? ''}`);
+  if (data?.description) console.log(`  描述:${data.description}`);
+  if (data?.input_schema) console.log(`  输入:${JSON.stringify(data.input_schema)}`);
+  if (data?.output_schema) console.log(`  输出:${JSON.stringify(data.output_schema)}`);
+}
+
+/**
+ * 运行:POST /abilities/{name}/run。
+ * body 来自 --input 或 --data(JSON 字符串),都没有则 {}。
+ */
+export async function runAbility(client, name, flags) {
+  const raw = flags.input !== undefined ? flags.input : flags.data;
+  const body = raw !== undefined ? parseJson(raw) : {};
+  if (flags['dry-run']) return dry(`运行 Ability ${name} ${JSON.stringify(body)}`);
+  const { data } = await client.request('POST', `${ABILITIES}/${encodeURIComponent(name)}/run`, { body });
+  if (flags.json) return printJson(data);
+  console.log(`✓ 已运行 ${name}`);
+  console.log(JSON.stringify(data, null, 2));
+}

package/lib/app-passwords.js

@@ -0,0 +1,39 @@
+// 用户应用密码(/wp-json/wp/v2/users/<user|me>/application-passwords)。
+// 创建是唯一会返回明文 password 的接口,该字段只在此处打印一次。
+import { printJson, dry } from './util.js';
+import { UsageError } from './errors.js';
+
+function appPasswordsPath(user) {
+  return `/wp-json/wp/v2/users/${user || 'me'}/application-passwords`;
+}
+
+export async function listAppPasswords(client, user, flags) {
+  const base = appPasswordsPath(user);
+  const { data } = await client.request('GET', base);
+  if (flags.json) return printJson(data);
+  console.log(`应用密码 ${data.length} 个:`);
+  for (const p of data) {
+    console.log(`  ${p.uuid}  ${p.name}  ${p.last_used ?? '—'}  ${p.created ?? '—'}`);
+  }
+}
+
+export async function createAppPassword(client, user, flags) {
+  if (flags.name === undefined) throw new UsageError('创建应用密码需要 --name');
+  const body = { name: String(flags.name) };
+  if (flags['app-id'] !== undefined) body.app_id = String(flags['app-id']);
+  const base = appPasswordsPath(user);
+  if (flags['dry-run']) return dry(`创建应用密码 ${body.name}`);
+  const { data } = await client.request('POST', base, { body });
+  if (flags.json) return printJson(data);
+  console.log(`${data.uuid}  ${data.name}`);
+  console.log(`password: ${data.password}`);
+}
+
+export async function deleteAppPassword(client, user, uuid, flags) {
+  const base = appPasswordsPath(user);
+  if (flags['dry-run']) return dry(`删除应用密码 ${uuid}`);
+  if (!flags.force) throw new UsageError('删除应用密码需要 --force(不可撤销)');
+  const { data } = await client.request('DELETE', `${base}/${uuid}`);
+  if (flags.json) return printJson(data);
+  console.log(data.deleted ? `✓ 已删除应用密码 ${uuid}` : `? 应用密码 ${uuid} 未删除`);
+}

package/lib/args.js

@@ -1,5 +1,8 @@
 // 已知的布尔开关:遇到它们不吞下一个参数,避免 `--json -s a` 把 -s 当值。
-const BOOLEAN_FLAGS = new Set(['json', 'force', 'activate', 'dry-run', 'yes', 'all', 'help', 'version']);
+const BOOLEAN_FLAGS = new Set([
+  'json', 'force', 'activate', 'dry-run', 'yes', 'all', 'help', 'version',
+  'csv', 'table', 'quiet', 'verbose', 'all-pages', 'paginate', 'auto-add',
+]);
 
 /** 解析命令行。支持 --flag value、--flag=value、布尔 --flag、以及 -s/-a/-h/-y。 */
 export function parseArgs(argv) {
@@ -53,37 +56,5 @@ export function parseArgs(argv) {
   return { positionals, flags };
 }
 
-const CONTENT_MUTATIONS = new Set(['create', 'new', 'update', 'edit', 'delete', 'rm']);
-
-/** 判断命令是否会修改站点数据(用于 --all 护栏与 --dry-run 提示)。 */
-export function isMutation(group, action) {
-  const act = action || '';
-  switch (group) {
-    case 'posts':
-    case 'post':
-    case 'pages':
-    case 'page':
-    case 'categories':
-    case 'category':
-    case 'tags':
-    case 'tag':
-      return CONTENT_MUTATIONS.has(act);
-    case 'media':
-      return ['upload', 'update', 'edit', 'delete', 'rm'].includes(act);
-    case 'plugins':
-    case 'plugin':
-      return ['install', 'activate', 'deactivate'].includes(act);
-    case 'themes':
-    case 'theme':
-      return ['activate', 'switch'].includes(act);
-    case 'comments':
-    case 'comment':
-      return ['update', 'edit', 'delete', 'rm'].includes(act);
-    case 'users':
-      return ['create', 'update', 'edit', 'delete', 'rm'].includes(act);
-    case 'raw':
-      return !['GET', 'HEAD', 'OPTIONS'].includes(act.toUpperCase());
-    default:
-      return false;
-  }
-}
+// 写操作判定统一来自 lib/spec.js(单一事实来源),这里只做转发。
+export { isMutation, groupByName } from './spec.js';

package/lib/batch.js

@@ -0,0 +1,54 @@
+// 批量请求命令(/wp-json/batch/v1)。
+// 一次提交多条子请求,减少往返。
+import { printJson, dry, parseJson, readJsonFile } from './util.js';
+import { UsageError } from './errors.js';
+
+const BATCH = '/wp-json/batch/v1';
+
+const NEED =
+  'batch 需要 --requests JSON 数组 或 --requests-file 文件';
+
+function readRequests(flags) {
+  if (flags.requests === undefined && flags['requests-file'] === undefined) return undefined;
+  try {
+    const parsed = flags.requests !== undefined
+      ? parseJson(flags.requests)
+      : readJsonFile(flags['requests-file']);
+    // 同时接受裸数组和 {"requests": [...]} 两种写法。
+    return Array.isArray(parsed?.requests) ? parsed.requests : parsed;
+  } catch (err) {
+    throw new UsageError(`${NEED}(${err.message})`);
+  }
+}
+
+/** POST /batch/v1,body 为 { requests }。 */
+export async function batch(client, flags) {
+  const requests = readRequests(flags);
+  if (!Array.isArray(requests) || requests.length === 0) {
+    throw new UsageError(NEED);
+  }
+  const BATCH_METHODS = ['POST', 'PUT', 'PATCH', 'DELETE'];
+  const bad = requests.find(
+    (r) => r && r.method && !BATCH_METHODS.includes(String(r.method).toUpperCase()),
+  );
+  if (bad) {
+    throw new UsageError(`batch 不支持 ${bad.method}:WordPress 批量端点只接受 ${BATCH_METHODS.join('/')}`);
+  }
+  if (flags['dry-run']) return dry(`批量请求 ${requests.length} 条`);
+  const { data } = await client.request('POST', BATCH, { body: { requests } });
+  if (flags.json) return printJson(data);
+
+  const responses = Array.isArray(data?.responses)
+    ? data.responses
+    : Array.isArray(data)
+      ? data
+      : [];
+  console.log(`批量返回 ${responses.length} 条:`);
+  responses.forEach((response, index) => {
+    const request = requests[index] || {};
+    const status = response?.status ?? request.status ?? '?';
+    const method = response?.method ?? request.method ?? '?';
+    const path = response?.path ?? request.path ?? '?';
+    console.log(`  [${status}] ${method} ${path}`);
+  });
+}

package/lib/blocks.js

@@ -0,0 +1,72 @@
+// 可复用区块(wp_block):/wp-json/wp/v2/blocks。
+
+import { readFileSync } from 'node:fs';
+import { stripTags, printJson, dry, listRequest } from './util.js';
+import { UsageError } from './errors.js';
+
+const BLOCKS = '/wp-json/wp/v2/blocks';
+
+export async function listBlocks(client, flags) {
+  const query = {
+    per_page: flags['per-page'] ?? 20,
+    page: flags.page,
+    search: flags.search,
+    status: flags.status,
+    context: 'edit',
+  };
+  const { data, total } = await listRequest(client, BLOCKS, query, flags);
+  if (flags.json) return printJson(data);
+  console.log(`区块 ${total ?? data.length} 个:`);
+  for (const b of data) {
+    console.log(`  #${b.id}  [${b.status}]  ${stripTags(b.title?.raw ?? b.title?.rendered ?? '(无标题)')}`);
+  }
+}
+
+export async function getBlock(client, id, flags) {
+  const { data } = await client.request('GET', `${BLOCKS}/${Number(id)}`, {
+    query: { context: flags.context || 'edit' },
+  });
+  if (flags.json) return printJson(data);
+  console.log(`#${data.id}  [${data.status}]  ${stripTags(data.title?.raw ?? data.title?.rendered ?? '')}`);
+  console.log('─'.repeat(44));
+  console.log(data.content?.raw ?? stripTags(data.content?.rendered || ''));
+}
+
+function blockBody(flags) {
+  const body = {};
+  if (flags.title !== undefined) body.title = String(flags.title);
+  if (flags['from-file'] !== undefined) body.content = readFileSync(String(flags['from-file']), 'utf8');
+  else if (flags.content !== undefined) body.content = String(flags.content);
+  if (flags.status !== undefined) body.status = String(flags.status);
+  return body;
+}
+
+export async function createBlock(client, flags) {
+  const body = blockBody(flags);
+  if (body.title === undefined && body.content === undefined) {
+    throw new UsageError('创建区块至少需要 --title 或 --content');
+  }
+  if (flags['dry-run']) return dry(`创建区块 ${JSON.stringify(body)}`);
+  const { data } = await client.request('POST', BLOCKS, { body });
+  if (flags.json) return printJson(data);
+  console.log(`✓ 已创建区块 #${data.id} [${data.status}]`);
+}
+
+export async function updateBlock(client, id, flags) {
+  const body = blockBody(flags);
+  if (!Object.keys(body).length) {
+    throw new UsageError('没有可更新的字段(--title/--content/--from-file/--status)');
+  }
+  if (flags['dry-run']) return dry(`更新区块 #${id} ${JSON.stringify(body)}`);
+  const { data } = await client.request('POST', `${BLOCKS}/${Number(id)}`, { body });
+  if (flags.json) return printJson(data);
+  console.log(`✓ 已更新区块 #${data.id}`);
+}
+
+export async function deleteBlock(client, id, flags) {
+  if (flags['dry-run']) return dry(`删除区块 #${id}`);
+  if (!flags.force) throw new UsageError('删除区块需要 --force(不可撤销)');
+  const { data } = await client.request('DELETE', `${BLOCKS}/${Number(id)}`, { query: { force: 'true' } });
+  if (flags.json) return printJson(data);
+  console.log(data.deleted ? `✓ 已删除区块 #${id}` : `? 区块 #${id} 未删除`);
+}