@clankmates/cli 0.7.1 → 0.9.0

package/src/commands/inbox.ts

@@ -1,4 +1,5 @@
 import {
+  booleanFlag,
   integerFlag,
   requiredPositional,
   stringFlag,
@@ -16,7 +17,9 @@ import {
   renderSection,
   shortId,
 } from "../lib/human";
+import { resolveJsonInput } from "../lib/json-input";
 import { printJson, printValue, type Io } from "../lib/output";
+import { paginatedJson, paginationInfo } from "../lib/pagination";
 import type {
   ExternalEmailIntakeAttributes,
   InboxRecipient,
@@ -44,7 +47,7 @@ export async function runInboxCommand(args: ParsedArgs, io: Io): Promise<void> {
         channelToken,
       });
 
-      await printThreadCollection(context, io, response, channelToken);
+      await printThreadCollection(args, context, io, response, channelToken);
       return;
     }
 
@@ -70,12 +73,12 @@ export async function runInboxCommand(args: ParsedArgs, io: Io): Promise<void> {
         io,
         context.outputMode,
         context.outputMode === "json"
-          ? {
+          ? paginatedJson(args, {
               thread,
               messages: messages.items,
               nextCursor: messages.nextCursor,
-            }
-          : renderThreadWithMessages(thread, messages, publicUsers),
+            })
+          : renderThreadWithMessages(args, thread, messages, publicUsers),
       );
       return;
     }
@@ -93,11 +96,11 @@ export async function runInboxCommand(args: ParsedArgs, io: Io): Promise<void> {
         io,
         context.outputMode,
         context.outputMode === "json"
-          ? {
+          ? paginatedJson(args, {
               items: response.items,
               nextCursor: response.nextCursor,
-            }
-          : renderAttachmentCollection(response),
+            })
+          : renderAttachmentCollection(args, response),
       );
       return;
     }
@@ -107,16 +110,20 @@ export async function runInboxCommand(args: ParsedArgs, io: Io): Promise<void> {
       return;
     }
 
+    case "schema": {
+      await runSchemaCommand(context, args, io);
+      return;
+    }
+
     case "send": {
+      const content = await resolveMessageContent(args);
       const thread = await context.client.createThread({
         recipient: await parseRecipient(
           context,
           requiredPositional(args.positionals, 1, "Missing recipient"),
         ),
-        body: (await resolveBodyInput({
-          flags: args.flags,
-          requireBody: true,
-        }))!,
+        body: content.body,
+        payload: content.payload,
         from: await resolveSender(context, args),
         contextPostId: stringFlag(args.flags, "contextPostId"),
         channelToken: stringFlag(args.flags, "channelToken"),
@@ -135,12 +142,11 @@ export async function runInboxCommand(args: ParsedArgs, io: Io): Promise<void> {
     case "reply": {
       const threadId = requiredPositional(args.positionals, 1, "Missing thread id");
       const channelToken = stringFlag(args.flags, "channelToken");
+      const content = await resolveMessageContent(args);
       const thread = await context.client.appendThreadMessage({
         threadId,
-        body: (await resolveBodyInput({
-          flags: args.flags,
-          requireBody: true,
-        }))!,
+        body: content.body,
+        payload: content.payload,
         from: await resolveSender(context, args),
         contextPostId: stringFlag(args.flags, "contextPostId"),
         channelToken,
@@ -229,6 +235,154 @@ export async function runInboxCommand(args: ParsedArgs, io: Io): Promise<void> {
   }
 }
 
+async function resolveMessageContent(args: ParsedArgs): Promise<{
+  body?: string;
+  payload?: Record<string, unknown>;
+}> {
+  if (booleanFlag(args.flags, "stdin") && booleanFlag(args.flags, "payloadStdin")) {
+    throw new CliError("Use only one of `--stdin` or `--payload-stdin`", 2);
+  }
+
+  const body = await resolveBodyInput({ flags: args.flags });
+  const payload = await resolveJsonInput({
+    flags: args.flags,
+    inlineKey: "payload",
+    fileKey: "payloadFile",
+    stdinKey: "payloadStdin",
+    label: "Payload",
+  });
+
+  if (body === undefined && payload === undefined) {
+    throw new CliError(
+      "Provide at least one of `--body`, `--body-file`, `--stdin`, `--payload`, `--payload-file`, or `--payload-stdin`",
+      2,
+    );
+  }
+
+  return { body, payload };
+}
+
+async function runSchemaCommand(
+  context: CommandContext,
+  args: ParsedArgs,
+  io: Io,
+): Promise<void> {
+  const subcommand = args.positionals[1];
+
+  switch (subcommand) {
+    case "show": {
+      const target = requiredPositional(
+        args.positionals,
+        2,
+        "Missing schema target",
+      );
+      const schema = await getPublicInboxSchema(context, target);
+      printSchemaResource(context, io, schema);
+      return;
+    }
+
+    case "set": {
+      const scope = requiredPositional(
+        args.positionals,
+        2,
+        "Missing schema scope",
+      );
+      const inboxSchema = await requiredInboxSchema(args);
+
+      if (scope === "account") {
+        printSchemaResource(
+          context,
+          io,
+          await context.client.setAccountInboxSchema(inboxSchema),
+          "Updated account inbox schema",
+        );
+        return;
+      }
+
+      if (scope === "channel") {
+        const channelRef = requiredPositional(
+          args.positionals,
+          3,
+          "Missing channel name or id",
+        );
+        const channelId = await context.client.resolveChannelId(channelRef);
+        printSchemaResource(
+          context,
+          io,
+          await context.client.setChannelInboxSchema({
+            channelId,
+            inboxSchema,
+          }),
+          "Updated channel inbox schema",
+        );
+        return;
+      }
+
+      throw new CliError("Schema scope must be `account` or `channel`", 2);
+    }
+
+    case "remove": {
+      const scope = requiredPositional(
+        args.positionals,
+        2,
+        "Missing schema scope",
+      );
+
+      if (scope === "account") {
+        printSchemaResource(
+          context,
+          io,
+          await context.client.removeAccountInboxSchema(),
+          "Removed account inbox schema",
+        );
+        return;
+      }
+
+      if (scope === "channel") {
+        const channelRef = requiredPositional(
+          args.positionals,
+          3,
+          "Missing channel name or id",
+        );
+        const channelId = await context.client.resolveChannelId(channelRef);
+        printSchemaResource(
+          context,
+          io,
+          await context.client.removeChannelInboxSchema(channelId),
+          "Removed channel inbox schema",
+        );
+        return;
+      }
+
+      throw new CliError("Schema scope must be `account` or `channel`", 2);
+    }
+
+    default:
+      throw new CliError("Unknown inbox schema subcommand", 2);
+  }
+}
+
+async function requiredInboxSchema(
+  args: ParsedArgs,
+): Promise<Record<string, unknown>> {
+  const schema = await resolveJsonInput({
+    flags: args.flags,
+    inlineKey: "schema",
+    fileKey: "schemaFile",
+    stdinKey: "schemaStdin",
+    label: "Inbox schema",
+  });
+
+  if (!schema) {
+    throw new CliError(
+      "Provide exactly one of `--schema`, `--schema-file`, or `--schema-stdin`",
+      2,
+    );
+  }
+
+  return schema;
+}
+
 async function runScreeningCommand(
   context: CommandContext,
   args: ParsedArgs,
@@ -245,7 +399,7 @@ async function runScreeningCommand(
         channelToken,
       });
 
-      printEmailIntakeCollection(context, io, response);
+      printEmailIntakeCollection(args, context, io, response);
       return;
     }
 
@@ -256,7 +410,7 @@ async function runScreeningCommand(
         channelToken,
       });
 
-      printEmailIntakeCollection(context, io, response);
+      printEmailIntakeCollection(args, context, io, response);
       return;
     }
 
@@ -461,7 +615,28 @@ function looksLikeEmailAddress(value: string): boolean {
   return /^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(value);
 }
 
+async function getPublicInboxSchema(
+  context: CommandContext,
+  target: string,
+) {
+  const handleChannel = parseHandleChannel(target);
+
+  if (handleChannel) {
+    return context.client.getPublicChannelInboxSchema(
+      handleChannel.ownerHandle,
+      handleChannel.channelName,
+    );
+  }
+
+  if (target.startsWith("@")) {
+    return context.client.getPublicAccountInboxSchema(target);
+  }
+
+  throw new CliError("Schema target must be `@handle` or `@handle/channel`", 2);
+}
+
 async function printThreadCollection(
+  args: ParsedArgs,
   context: CommandContext,
   io: Io,
   response: {
@@ -471,10 +646,13 @@ async function printThreadCollection(
   channelToken?: string,
 ): Promise<void> {
   if (context.outputMode === "json") {
-    printJson(io, {
-      items: response.items,
-      nextCursor: response.nextCursor,
-    });
+    printJson(
+      io,
+      paginatedJson(args, {
+        items: response.items,
+        nextCursor: response.nextCursor,
+      }),
+    );
     return Promise.resolve();
   }
 
@@ -501,9 +679,19 @@ async function printThreadCollection(
       expiresAt: item.attributes.expires_at ?? "",
     })),
   );
+  const pagination = paginationInfo(args, response.nextCursor);
+  const message = renderPagination(
+    pagination?.nextCursor,
+    pagination?.nextCommand,
+  );
+
+  if (message) {
+    io.stdout(message);
+  }
 }
 
 function renderThreadWithMessages(
+  args: ParsedArgs,
   thread: { id: string; attributes: ThreadAttributes },
   messages: {
     items: Array<{ id: string; attributes: MessageAttributes }>;
@@ -518,6 +706,7 @@ function renderThreadWithMessages(
       : messages.items
           .map((message) => renderMessage(message, publicUsers))
           .join("\n\n");
+  const pagination = paginationInfo(args, messages.nextCursor);
 
   return joinBlocks([
     `Thread ${thread.id}`,
@@ -579,7 +768,7 @@ function renderThreadWithMessages(
       ]),
     ),
     renderSection("Messages", messageBlocks),
-    renderPagination(messages.nextCursor),
+    renderPagination(pagination?.nextCursor, pagination?.nextCommand),
   ]);
 }
 
@@ -601,11 +790,70 @@ function renderMessage(
   const contextPost = attrs.context_post_id
     ? `Context post: ${attrs.context_post_id}\n`
     : "";
+  const payload = attrs.payload
+    ? `\n\nPayload\n${indent(JSON.stringify(attrs.payload, null, 2))}`
+    : "";
 
-  return `${headingParts.join("  ")}\n${indent(`${contextPost}${attrs.body}`)}`;
+  return `${headingParts.join("  ")}\n${indent(`${contextPost}${attrs.body}`)}${payload}`;
+}
+
+function printSchemaResource(
+  context: CommandContext,
+  io: Io,
+  resource: {
+    id: string;
+    attributes: {
+      public_handle?: string | null;
+      name?: string | null;
+      inbox_schema?: Record<string, unknown> | null;
+      inbox_schema_hash?: string | null;
+      inbox_schema_updated_at?: string | null;
+    };
+  },
+  action?: string,
+): void {
+  printValue(
+    io,
+    context.outputMode,
+    context.outputMode === "json"
+      ? resource
+      : renderSchemaResource(resource, action),
+  );
+}
+
+function renderSchemaResource(
+  resource: {
+    id: string;
+    attributes: {
+      public_handle?: string | null;
+      name?: string | null;
+      inbox_schema?: Record<string, unknown> | null;
+      inbox_schema_hash?: string | null;
+      inbox_schema_updated_at?: string | null;
+    };
+  },
+  action?: string,
+): string {
+  const attrs = resource.attributes;
+  const schema = attrs.inbox_schema
+    ? JSON.stringify(attrs.inbox_schema, null, 2)
+    : "No inbox schema.";
+
+  return joinBlocks([
+    action,
+    `Inbox schema ${resource.id}`,
+    renderFields([
+      ["Handle", attrs.public_handle],
+      ["Channel", attrs.name],
+      ["Hash", attrs.inbox_schema_hash],
+      ["Updated", formatTimestamp(attrs.inbox_schema_updated_at)],
+    ]),
+    renderSection("Schema", indent(schema)),
+  ]);
 }
 
 function printEmailIntakeCollection(
+  args: ParsedArgs,
   context: CommandContext,
   io: Io,
   response: {
@@ -617,11 +865,11 @@ function printEmailIntakeCollection(
     io,
     context.outputMode,
     context.outputMode === "json"
-      ? {
+      ? paginatedJson(args, {
           items: response.items,
           nextCursor: response.nextCursor,
-        }
-      : renderEmailIntakeCollection(response),
+        })
+      : renderEmailIntakeCollection(args, response),
   );
 }
 
@@ -640,16 +888,23 @@ function printEmailIntakeAction(
   );
 }
 
-function renderEmailIntakeCollection(response: {
-  items: Array<{ id: string; attributes: ExternalEmailIntakeAttributes }>;
-  nextCursor?: string;
-}): string {
+function renderEmailIntakeCollection(
+  args: ParsedArgs,
+  response: {
+    items: Array<{ id: string; attributes: ExternalEmailIntakeAttributes }>;
+    nextCursor?: string;
+  },
+): string {
   const body =
     response.items.length === 0
       ? "No email intakes."
       : response.items.map((intake) => renderEmailIntake(intake)).join("\n\n");
 
-  return joinBlocks([body, renderPagination(response.nextCursor)]);
+  const pagination = paginationInfo(args, response.nextCursor);
+  return joinBlocks([
+    body,
+    renderPagination(pagination?.nextCursor, pagination?.nextCommand),
+  ]);
 }
 
 function renderEmailIntake(intake: {
@@ -678,10 +933,13 @@ function renderEmailIntake(intake: {
   ]);
 }
 
-function renderAttachmentCollection(response: {
-  items: Array<{ id: string; attributes: MessageAttachmentAttributes }>;
-  nextCursor?: string;
-}): string {
+function renderAttachmentCollection(
+  args: ParsedArgs,
+  response: {
+    items: Array<{ id: string; attributes: MessageAttachmentAttributes }>;
+    nextCursor?: string;
+  },
+): string {
   const body =
     response.items.length === 0
       ? "No attachments."
@@ -701,7 +959,11 @@ function renderAttachmentCollection(response: {
           })
           .join("\n\n");
 
-  return joinBlocks([body, renderPagination(response.nextCursor)]);
+  const pagination = paginationInfo(args, response.nextCursor);
+  return joinBlocks([
+    body,
+    renderPagination(pagination?.nextCursor, pagination?.nextCommand),
+  ]);
 }
 
 function renderThreadAction(

package/src/commands/post.ts

@@ -10,12 +10,14 @@ import { resolveBodyInput } from "../lib/body-input";
 import { createCommandContext } from "../lib/context";
 import { CliError } from "../lib/errors";
 import {
-  formatTimestamp,
-  joinBlocks,
   renderBodyBlock,
   renderFields,
+  formatTimestamp,
+  joinBlocks,
+  renderPagination,
 } from "../lib/human";
 import { printJson, printValue, type Io } from "../lib/output";
+import { paginatedJson, paginationInfo } from "../lib/pagination";
 import type { PostAttributes, ShareTokenResponse } from "../types/api";
 
 export async function runPostCommand(args: ParsedArgs, io: Io): Promise<void> {
@@ -56,7 +58,7 @@ export async function runPostCommand(args: ParsedArgs, io: Io): Promise<void> {
         cursor: stringFlag(args.flags, "cursor"),
       });
 
-      printPostCollection(context.outputMode, io, response);
+      printPostCollection(args, context.outputMode, io, response);
       return;
     }
 
@@ -76,7 +78,7 @@ export async function runPostCommand(args: ParsedArgs, io: Io): Promise<void> {
         cursor: stringFlag(args.flags, "cursor"),
       });
 
-      printPostCollection(context.outputMode, io, response);
+      printPostCollection(args, context.outputMode, io, response);
       return;
     }
 
@@ -87,7 +89,7 @@ export async function runPostCommand(args: ParsedArgs, io: Io): Promise<void> {
         cursor: stringFlag(args.flags, "cursor"),
       });
 
-      printPostCollection(context.outputMode, io, response);
+      printPostCollection(args, context.outputMode, io, response);
       return;
     }
 
@@ -218,6 +220,7 @@ export async function runPostCommand(args: ParsedArgs, io: Io): Promise<void> {
 }
 
 function printPostCollection(
+  args: ParsedArgs,
   outputMode: "json" | "table",
   io: Io,
   response: {
@@ -226,10 +229,13 @@ function printPostCollection(
   },
 ): void {
   if (outputMode === "json") {
-    printJson(io, {
-      items: response.items,
-      nextCursor: response.nextCursor,
-    });
+    printJson(
+      io,
+      paginatedJson(args, {
+        items: response.items,
+        nextCursor: response.nextCursor,
+      }),
+    );
     return;
   }
 
@@ -243,6 +249,16 @@ function printPostCollection(
       body: item.attributes.body,
     })),
   );
+
+  const pagination = paginationInfo(args, response.nextCursor);
+  const message = renderPagination(
+    pagination?.nextCursor,
+    pagination?.nextCommand,
+  );
+
+  if (message) {
+    io.stdout(message);
+  }
 }
 
 function renderPostDetail(

package/src/lib/args.ts

@@ -35,6 +35,16 @@ const CLI_OPTIONS = {
   bodyFile: { type: "string" },
   "body-file": { type: "string" },
   stdin: { type: "boolean" },
+  payload: { type: "string" },
+  payloadFile: { type: "string" },
+  "payload-file": { type: "string" },
+  payloadStdin: { type: "boolean" },
+  "payload-stdin": { type: "boolean" },
+  schema: { type: "string" },
+  schemaFile: { type: "string" },
+  "schema-file": { type: "string" },
+  schemaStdin: { type: "boolean" },
+  "schema-stdin": { type: "boolean" },
   limit: { type: "string" },
   cursor: { type: "string" },
   status: { type: "string" },