@islamihab/kds 0.2.1 → 0.2.2

package/index.js

@@ -14594,7 +14594,7 @@ import { join } from "path";
 // package.json
 var package_default = {
   name: "cli",
-  version: "0.2.1",
+  version: "0.2.2",
   private: true,
   type: "module",
   bin: {
@@ -17823,59 +17823,117 @@ var auth = group({
   commands: [login, logout, status]
 });
 
-// src/lib/attachments.ts
-import { basename } from "path";
-var attachFiles = async (client3, issueId, paths) => {
-  if (paths.length === 0)
-    return [];
-  const files = paths.map((path) => ({ path, file: Bun.file(path) }));
-  for (const { path, file: file2 } of files) {
-    if (!await file2.exists())
-      throw new Error(`No file at ${path}.`);
-    if (file2.size <= 0)
-      throw new Error(`${path} is empty; an attachment cannot be.`);
-    if (file2.size > MAX_ISSUE_ATTACHMENT_BYTES) {
-      throw new Error(`${path} is too large (${file2.size} bytes; max ${MAX_ISSUE_ATTACHMENT_BYTES}).`);
-    }
+// src/lib/activity.ts
+var SOURCE_LABELS = { github: "GitHub" };
+var issueActivityLine = (detail) => {
+  const label = detail.kind.replaceAll("_", " ");
+  switch (detail.kind) {
+    case "created":
+    case "description_changed":
+      return label;
+    case "title_changed":
+    case "status_changed":
+    case "priority_changed":
+    case "disposition_changed":
+    case "estimate_changed":
+    case "due_date_changed":
+    case "branch_changed":
+    case "pr_changed":
+    case "project_changed":
+    case "milestone_changed":
+    case "parent_changed":
+      return `${label}: ${detail.from ?? "none"} \u2192 ${detail.to ?? "none"}`;
+    case "label_added":
+    case "label_removed":
+    case "attachment_added":
+    case "attachment_removed":
+      return `${label}: ${detail.name}`;
+    case "child_added":
+    case "child_removed":
+      return `${label}: ${detail.identifier}`;
+    case "relation_added":
+    case "relation_removed":
+      return `${label}: ${detail.relation.replaceAll("_", " ")} ${detail.identifier}`;
   }
-  const created = new Set;
-  try {
-    for (const { path, file: file2 } of files) {
-      const uploadUrl = await client3.mutation(api2.issueAttachments.generateUploadUrl, { issueId });
-      const response = await fetch(uploadUrl, {
-        method: "POST",
-        headers: { "Content-Type": file2.type },
-        body: file2
-      });
-      if (!response.ok)
-        throw new Error(`Uploading ${path} failed (${response.status}).`);
-      const storageId = exports_external.custom((value) => typeof value === "string");
-      const body = exports_external.object({ storageId }).safeParse(await response.json());
-      if (!body.success)
-        throw new Error("The upload returned no file reference.");
-      created.add(await client3.action(api2.issueAttachments.create, {
-        issueId,
-        storageId: body.data.storageId,
-        name: basename(path)
-      }));
-    }
-  } catch (error51) {
-    for (const id of created) {
-      await client3.mutation(api2.issueAttachments.remove, { id }).catch(() => {
-        console.error("An attachment from this failed batch could not be removed; check the dashboard.");
-      });
-    }
-    throw error51;
+};
+var projectActivityLine = (detail) => {
+  const label = detail.kind.replaceAll("_", " ");
+  switch (detail.kind) {
+    case "created":
+    case "summary_changed":
+    case "description_changed":
+    case "milestones_reordered":
+      return label;
+    case "name_changed":
+    case "status_changed":
+    case "health_changed":
+    case "target_date_changed":
+    case "repo_changed":
+    case "milestone_renamed":
+      return `${label}: ${detail.from ?? "none"} \u2192 ${detail.to ?? "none"}`;
+    case "milestone_added":
+    case "milestone_removed":
+    case "milestone_description_changed":
+      return `${label}: ${detail.name}`;
+    case "milestone_target_date_changed":
+      return `${label}: ${detail.name} ${detail.from ?? "none"} \u2192 ${detail.to ?? "none"}`;
+    case "issue_added":
+    case "issue_removed":
+      return `${label}: ${detail.identifier}`;
   }
-  const attachments = await client3.query(api2.issueAttachments.list, { issueId });
-  return attachments.filter((attachment) => created.has(attachment._id));
 };
-var printAttachments = (attachments) => {
-  for (const attachment of attachments) {
-    console.log(`Attached ${attachment.name}${attachment.url ? ` \u2014 ${attachment.url}` : ""}`);
+
+// src/lib/output.ts
+var printTable = (rows) => {
+  if (rows.length === 0)
+    return;
+  const columnCount = Math.max(...rows.map((row) => row.length));
+  const widths = Array.from({ length: columnCount }, (_, column) => Math.max(...rows.map((row) => (row[column] ?? "").length)));
+  for (const row of rows) {
+    console.log(row.map((cell, column) => cell.padEnd(widths[column] ?? 0)).join("  ").trimEnd());
   }
 };
 
+// src/commands/inbox/list.ts
+var inboxOptions = {
+  all: exports_external.boolean().default(false).describe("Include events already marked seen"),
+  json: exports_external.boolean().default(false).describe("Print as JSON")
+};
+var runInbox = async (options) => {
+  const client3 = await backendClient();
+  const inbox = await client3.query(api2.inbox.list, {});
+  const targetLastSeen = new Map(inbox.targetLastSeen.map((state) => [state.targetId, state.lastSeenAt]));
+  const events = options.all ? inbox.events : inbox.events.filter((event) => {
+    const targetId = event.type === "issue" ? event.issue.id : event.project.id;
+    return event.at > Math.max(inbox.lastSeenAt, targetLastSeen.get(targetId) ?? 0);
+  });
+  if (options.json)
+    return console.log(JSON.stringify({ ...inbox, events }, null, 2));
+  if (events.length === 0) {
+    if (options.all)
+      console.log("Nothing in the inbox.");
+    else
+      console.log(inbox.truncated ? "Nothing unseen in the newest events shown." : "Inbox zero.");
+    if (!options.all && inbox.events.length > 0)
+      console.log("Pass --all to reprint seen events.");
+    return;
+  }
+  printTable([
+    ["WHEN", "ACTOR", "WHERE", "EVENT"],
+    ...events.map((event) => [
+      new Date(event.at).toISOString().slice(0, 16).replace("T", " "),
+      SOURCE_LABELS[event.via],
+      event.type === "issue" ? event.issue.identifier : event.project.name,
+      event.type === "issue" ? issueActivityLine(event.detail) : projectActivityLine(event.detail)
+    ])
+  ]);
+  if (inbox.truncated)
+    console.log(`
+(older events truncated)`);
+  if (!options.all)
+    console.log("\nRun `kds inbox seen` once these are handled.");
+};
+
 // src/lib/input.ts
 var assertSize = (size) => {
   if (size > MAX_PAGE_HTML_BYTES)
@@ -18011,6 +18069,83 @@ var resolveMilestone = async (client3, projectId, name) => {
   return milestone;
 };
 
+// src/commands/inbox/seen.ts
+var seen = command({
+  name: "seen",
+  description: "Mark one issue, or the whole inbox, as seen",
+  positionals: {
+    id: exports_external.string().optional().describe("Issue identifier, number, or URL")
+  },
+  run: async ({ positionals: { id } }) => {
+    const client3 = await backendClient();
+    const issue2 = id === undefined ? undefined : await resolveIssue(client3, id);
+    await client3.mutation(api2.inbox.markSeen, { targetId: issue2?._id });
+    console.log(issue2 ? `${issue2.identifier} marked seen.` : "Inbox marked seen.");
+  }
+});
+
+// src/commands/inbox/index.ts
+var inbox = group({
+  name: "inbox",
+  description: "Automated activity across issues and projects, unseen first",
+  options: inboxOptions,
+  run: async ({ options }) => await runInbox(options),
+  commands: [seen]
+});
+
+// src/lib/attachments.ts
+import { basename } from "path";
+var attachFiles = async (client3, issueId, paths) => {
+  if (paths.length === 0)
+    return [];
+  const files = paths.map((path) => ({ path, file: Bun.file(path) }));
+  for (const { path, file: file2 } of files) {
+    if (!await file2.exists())
+      throw new Error(`No file at ${path}.`);
+    if (file2.size <= 0)
+      throw new Error(`${path} is empty; an attachment cannot be.`);
+    if (file2.size > MAX_ISSUE_ATTACHMENT_BYTES) {
+      throw new Error(`${path} is too large (${file2.size} bytes; max ${MAX_ISSUE_ATTACHMENT_BYTES}).`);
+    }
+  }
+  const created = new Set;
+  try {
+    for (const { path, file: file2 } of files) {
+      const uploadUrl = await client3.mutation(api2.issueAttachments.generateUploadUrl, { issueId });
+      const response = await fetch(uploadUrl, {
+        method: "POST",
+        headers: { "Content-Type": file2.type },
+        body: file2
+      });
+      if (!response.ok)
+        throw new Error(`Uploading ${path} failed (${response.status}).`);
+      const storageId = exports_external.custom((value) => typeof value === "string");
+      const body = exports_external.object({ storageId }).safeParse(await response.json());
+      if (!body.success)
+        throw new Error("The upload returned no file reference.");
+      created.add(await client3.action(api2.issueAttachments.create, {
+        issueId,
+        storageId: body.data.storageId,
+        name: basename(path)
+      }));
+    }
+  } catch (error51) {
+    for (const id of created) {
+      await client3.mutation(api2.issueAttachments.remove, { id }).catch(() => {
+        console.error("An attachment from this failed batch could not be removed; check the dashboard.");
+      });
+    }
+    throw error51;
+  }
+  const attachments = await client3.query(api2.issueAttachments.list, { issueId });
+  return attachments.filter((attachment) => created.has(attachment._id));
+};
+var printAttachments = (attachments) => {
+  for (const attachment of attachments) {
+    console.log(`Attached ${attachment.name}${attachment.url ? ` \u2014 ${attachment.url}` : ""}`);
+  }
+};
+
 // src/commands/issues/comment.ts
 var comment = command({
   name: "comment",
@@ -18073,38 +18208,6 @@ var create = command({
 });
 
 // src/commands/issues/get.ts
-var SOURCE_LABELS = { github: "GitHub" };
-var activityLine = (detail) => {
-  const label = detail.kind.replaceAll("_", " ");
-  switch (detail.kind) {
-    case "created":
-    case "description_changed":
-      return label;
-    case "title_changed":
-    case "status_changed":
-    case "priority_changed":
-    case "disposition_changed":
-    case "estimate_changed":
-    case "due_date_changed":
-    case "branch_changed":
-    case "pr_changed":
-    case "project_changed":
-    case "milestone_changed":
-    case "parent_changed":
-      return `${label}: ${detail.from ?? "none"} \u2192 ${detail.to ?? "none"}`;
-    case "label_added":
-    case "label_removed":
-    case "attachment_added":
-    case "attachment_removed":
-      return `${label}: ${detail.name}`;
-    case "child_added":
-    case "child_removed":
-      return `${label}: ${detail.identifier}`;
-    case "relation_added":
-    case "relation_removed":
-      return `${label}: ${detail.relation.replaceAll("_", " ")} ${detail.identifier}`;
-  }
-};
 var get = command({
   name: "get",
   description: "Show an issue: properties, description, and its feed",
@@ -18173,7 +18276,7 @@ Feed:`);
       const at = new Date(event.at).toISOString().slice(0, 16).replace("T", " ");
       if (event.type === "activity") {
         const via = event.via === undefined ? "" : ` (via ${SOURCE_LABELS[event.via]})`;
-        console.log(`${at}  ${activityLine(event.detail)}${via}`);
+        console.log(`${at}  ${issueActivityLine(event.detail)}${via}`);
       } else {
         console.log(`${at}  comment${event.editedAt ? " (edited)" : ""}:`);
         for (const line of event.bodyMarkdown.split(`
@@ -18184,17 +18287,6 @@ Feed:`);
   }
 });
 
-// src/lib/output.ts
-var printTable = (rows) => {
-  if (rows.length === 0)
-    return;
-  const columnCount = Math.max(...rows.map((row) => row.length));
-  const widths = Array.from({ length: columnCount }, (_, column) => Math.max(...rows.map((row) => (row[column] ?? "").length)));
-  for (const row of rows) {
-    console.log(row.map((cell, column) => cell.padEnd(widths[column] ?? 0)).join("  ").trimEnd());
-  }
-};
-
 // src/commands/issues/list.ts
 var list = command({
   name: "list",
@@ -18888,7 +18980,7 @@ var upgrade = command({
 var rootCommand = group({
   name: "kds",
   description: "KDS CLI",
-  commands: [auth, issues, pages, project, projects, upgrade],
+  commands: [auth, inbox, issues, pages, project, projects, upgrade],
   options: {
     version: exports_external.boolean().default(false).describe("Show the version").meta({ short: "v" })
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@islamihab/kds",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Command-line client for Kai Dev Studio",
   "license": "MIT",
   "publishConfig": {