@tplog/zendcli 0.2.2 → 0.2.3

package/README.md

@@ -39,11 +39,18 @@ Environment variables take precedence over the config file.
 ## Usage
 
 ```bash
+zend --help
+zend tickets --help
+zend email --help
+zend follower --help
+zend comments --help
 zend tickets --limit 10
 zend tickets --status open --limit 20
 zend email user@example.com
 zend email user@example.com --status unresolved
 zend email user@example.com --status open,pending
+zend follower
+zend follower tp@dify.ai --limit 3
 zend comments 12345
 zend comments 12345 --type public
 zend comments 12345 --json

package/dist/cli.js

@@ -3512,17 +3512,14 @@ function getConfig() {
 }
 
 // src/api.ts
-async function apiGet(path, params) {
-  const { subdomain, email, api_token } = getConfig();
-  const url = new URL(`https://${subdomain}.zendesk.com${path}`);
-  if (params) {
-    for (const [key, value] of Object.entries(params)) {
-      url.searchParams.set(key, String(value));
-    }
-  }
+function getAuthHeader() {
+  const { email, api_token } = getConfig();
   const credentials = btoa(`${email}/token:${api_token}`);
-  const resp = await fetch(url.toString(), {
-    headers: { Authorization: `Basic ${credentials}` }
+  return `Basic ${credentials}`;
+}
+async function fetchJson(url) {
+  const resp = await fetch(url, {
+    headers: { Authorization: getAuthHeader() }
   });
   if (!resp.ok) {
     const body = await resp.text();
@@ -3531,6 +3528,19 @@ async function apiGet(path, params) {
   }
   return resp.json();
 }
+async function apiGet(path, params) {
+  const { subdomain } = getConfig();
+  const url = new URL(`https://${subdomain}.zendesk.com${path}`);
+  if (params) {
+    for (const [key, value] of Object.entries(params)) {
+      url.searchParams.set(key, String(value));
+    }
+  }
+  return fetchJson(url.toString());
+}
+async function apiGetUrl(url) {
+  return fetchJson(url);
+}
 
 // src/cli.ts
 var program2 = new Command();
@@ -3599,6 +3609,67 @@ function parseStatusFilter(input) {
   if (statuses.includes("unresolved")) return ["new", "open", "pending", "hold"];
   return statuses;
 }
+function buildSearchQuery(base, rawStatus, statusFilter, canUseSearchStatus) {
+  let query = base;
+  if (rawStatus === "unresolved") {
+    query += " status<solved";
+  } else if (canUseSearchStatus && statusFilter.length === 1) {
+    query += ` status:${statusFilter[0]}`;
+  }
+  return query;
+}
+function printTickets(tickets, meta) {
+  for (const t of tickets) {
+    const status = (t.status || "").padEnd(8);
+    const subject = t.subject || "(no subject)";
+    console.log(`[${t.id}] ${status} ${subject}`);
+    console.log(meta(t));
+    console.log();
+  }
+}
+async function findUserByEmail(email) {
+  const data = await apiGet("/api/v2/users/search.json", {
+    query: email
+  });
+  const user = (data.users || []).find((item) => item.email?.toLowerCase() === email.toLowerCase()) || data.users?.[0];
+  if (!user) {
+    console.error(`No Zendesk user found for email: ${email}`);
+    process.exit(1);
+  }
+  return user;
+}
+async function findFollowerTickets(email, rawStatus, limit, sort) {
+  const user = await findUserByEmail(email);
+  const statusFilter = parseStatusFilter(rawStatus);
+  const canUseSearchStatus = rawStatus === "unresolved" || statusFilter.length === 1;
+  let url = new URL(`https://${getConfig().subdomain}.zendesk.com/api/v2/search.json`).toString();
+  const params = new URLSearchParams({
+    query: buildSearchQuery("type:ticket", rawStatus, statusFilter, canUseSearchStatus),
+    sort_by: "updated_at",
+    sort_order: sort,
+    per_page: "100"
+  });
+  url += `?${params.toString()}`;
+  const matches = [];
+  while (url && matches.length < limit) {
+    const data = await apiGetUrl(url);
+    let tickets = data.results || [];
+    if (statusFilter.length > 0 && rawStatus !== "unresolved" && !canUseSearchStatus) {
+      tickets = tickets.filter((ticket) => statusFilter.includes((ticket.status || "").toLowerCase()));
+    }
+    for (const ticket of tickets) {
+      const followers = ticket.follower_ids || [];
+      if (followers.includes(user.id) && ticket.assignee_id !== user.id) {
+        matches.push(ticket);
+      }
+      if (matches.length >= limit) {
+        break;
+      }
+    }
+    url = data.next_page || null;
+  }
+  return matches;
+}
 program2.command("configure").description("Set up Zendesk credentials interactively").action(async () => {
   const existing = loadConfig();
   console.error("Zendesk CLI Configuration");
@@ -3622,24 +3693,15 @@ program2.command("tickets").description("List tickets from Zendesk, sorted by up
   if (opts.status) {
     tickets = tickets.filter((t) => t.status === opts.status);
   }
-  for (const t of tickets.slice(0, limit)) {
-    const status = (t.status || "").padEnd(8);
-    const subject = t.subject || "(no subject)";
-    console.log(`[${t.id}] ${status} ${subject}`);
-    console.log(`    priority=${t.priority ?? "-"}  type=${t.type ?? "-"}  created=${t.created_at}`);
-    console.log();
-  }
+  printTickets(tickets.slice(0, limit), (ticket) => {
+    return `    priority=${ticket.priority ?? "-"}  type=${ticket.type ?? "-"}  created=${ticket.created_at}`;
+  });
 });
 program2.command("email <email>").description("Find tickets for a requester email").option("--status <status>", "Filter status: unresolved|all|new|open|pending|hold|solved|closed or comma-separated list", "unresolved").option("--limit <n>", "Max tickets to return", "20").option("--sort <order>", "Sort order (asc|desc)", "desc").option("--json", "Output raw JSON").action(async (email, opts) => {
   const limit = parseInt(opts.limit, 10);
   const statusFilter = parseStatusFilter(opts.status);
   const canUseSearchStatus = opts.status === "unresolved" || statusFilter.length === 1;
-  let query = `type:ticket requester:${email}`;
-  if (opts.status === "unresolved") {
-    query += " status<solved";
-  } else if (canUseSearchStatus && statusFilter.length === 1) {
-    query += ` status:${statusFilter[0]}`;
-  }
+  const query = buildSearchQuery(`type:ticket requester:${email}`, opts.status, statusFilter, canUseSearchStatus);
   const data = await apiGet("/api/v2/search.json", {
     query,
     sort_by: "updated_at",
@@ -3655,13 +3717,21 @@ program2.command("email <email>").description("Find tickets for a requester emai
     console.log(JSON.stringify(tickets, null, 2));
     return;
   }
-  for (const t of tickets) {
-    const status = (t.status || "").padEnd(8);
-    const subject = t.subject || "(no subject)";
-    console.log(`[${t.id}] ${status} ${subject}`);
-    console.log(`    priority=${t.priority ?? "-"}  type=${t.type ?? "-"}  requester=${email}  updated=${t.updated_at}`);
-    console.log();
+  printTickets(tickets, (ticket) => {
+    return `    priority=${ticket.priority ?? "-"}  type=${ticket.type ?? "-"}  requester=${email}  updated=${ticket.updated_at}`;
+  });
+});
+program2.command("follower [email]").description("Find tickets where the user is a follower but not the assignee").option("--status <status>", "Filter status: unresolved|all|new|open|pending|hold|solved|closed or comma-separated list", "unresolved").option("--limit <n>", "Max tickets to return", "20").option("--sort <order>", "Sort order (asc|desc)", "desc").option("--json", "Output raw JSON").action(async (email, opts) => {
+  const targetEmail = email || getConfig().email;
+  const limit = parseInt(opts.limit, 10);
+  const tickets = await findFollowerTickets(targetEmail, opts.status, limit, opts.sort);
+  if (opts.json) {
+    console.log(JSON.stringify(tickets, null, 2));
+    return;
   }
+  printTickets(tickets, (ticket) => {
+    return `    priority=${ticket.priority ?? "-"}  type=${ticket.type ?? "-"}  follower=${targetEmail}  assignee=${ticket.assignee_id ?? "-"}  updated=${ticket.updated_at}`;
+  });
 });
 program2.command("comments <ticketId>").description("List comments/thread for a ticket (public=customer-facing, internal=agents only)").option("--type <type>", "Filter: all|public|internal", "all").option("--sort <order>", "Sort order (asc|desc)", "asc").option("--json", "Output raw JSON").action(async (ticketId, opts) => {
   const data = await apiGet(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tplog/zendcli",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "Minimal Zendesk CLI for tickets and comments",
   "repository": {
     "type": "git",