@wavyx/pdcli 0.1.0

package/src/lib/output/index.js

@@ -0,0 +1,22 @@
+import { formatTable } from './table.js'
+import { formatJson } from './json.js'
+
+/**
+ * @param {object | object[]} data
+ * @param {Record<string, import('./table.js').Column>} columns
+ * @param {'table' | 'json'} format
+ * @param {import('@oclif/core').Command} cmd
+ */
+export function formatOutput(data, columns, format, cmd) {
+  const items = Array.isArray(data) ? data : [data]
+
+  switch (format) {
+    case 'json':
+      cmd.log(formatJson(data))
+      break
+    case 'table':
+    default:
+      cmd.log(formatTable(items, columns))
+      break
+  }
+}

package/src/lib/output/json.js

@@ -0,0 +1,7 @@
+/**
+ * @param {unknown} data
+ * @returns {string}
+ */
+export function formatJson(data) {
+  return JSON.stringify(data, null, 2)
+}

package/src/lib/output/record.js

@@ -0,0 +1,27 @@
+/**
+ * Flatten a single record into [{ field, value }] rows for a transposed
+ * key/value table view. custom_fields entries are hoisted to the top level
+ * (callers resolve hash keys to names first via fields.makeResolver).
+ * @param {object} record
+ * @returns {{ field: string, value: string }[]}
+ */
+export function flattenRecord(record) {
+  const rows = []
+  for (const [field, value] of Object.entries(record)) {
+    if (field === 'custom_fields' && value && typeof value === 'object') {
+      for (const [name, customValue] of Object.entries(value)) {
+        rows.push({ field: name, value: renderValue(customValue) })
+      }
+      continue
+    }
+    rows.push({ field, value: renderValue(value) })
+  }
+  return rows
+}
+
+function renderValue(value) {
+  if (value == null) return ''
+  if (Array.isArray(value)) return value.map(renderValue).join(', ')
+  if (typeof value === 'object') return JSON.stringify(value)
+  return String(value)
+}

package/src/lib/output/table.js

@@ -0,0 +1,40 @@
+import Table from 'cli-table3'
+import chalk from 'chalk'
+
+/**
+ * @typedef {object} Column
+ * @property {string} header
+ * @property {(row: object) => string} [get]
+ * @property {string} [key]
+ * @property {number} [minWidth]
+ */
+
+/**
+ * @param {object[]} data
+ * @param {Record<string, Column>} columns
+ * @returns {string}
+ */
+export function formatTable(data, columns) {
+  if (!data || data.length === 0) {
+    return chalk.dim('No results found.')
+  }
+
+  const entries = Object.entries(columns)
+
+  const table = new Table({
+    head: entries.map(([, col]) => chalk.bold(col.header)),
+    style: { head: [], border: [] },
+  })
+
+  for (const row of data) {
+    table.push(
+      entries.map(([fieldKey, col]) => {
+        if (col.get) return String(col.get(row) ?? '')
+        const value = row[col.key ?? fieldKey]
+        return value != null ? String(value) : ''
+      }),
+    )
+  }
+
+  return table.toString()
+}

package/src/lib/pagination.js

@@ -0,0 +1,14 @@
+/**
+ * @template T
+ * @param {AsyncGenerator<T>} generator
+ * @param {number} [limit]
+ * @returns {Promise<T[]>}
+ */
+export async function collectPages(generator, limit) {
+  const results = []
+  for await (const item of generator) {
+    results.push(item)
+    if (limit && results.length >= limit) break
+  }
+  return results
+}