wpops 0.1.0 → 0.2.0

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} 未删除`);
+}