@clankid/cli 0.17.0

package/src/lib/client/inbox.ts

@@ -0,0 +1,385 @@
+import type {
+  ChangeCheckResponse,
+  ExternalEmailIntakeAttributes,
+  InboxRecipient,
+  InboxSender,
+  LatestFirstOrder,
+  MailboxFilter,
+  MessageAttachmentAttributes,
+  MessageAttributes,
+  PayloadFilters,
+  ParticipantScope,
+  StructuredContentInput,
+  ThreadAttributes,
+  ThreadStatusFilter,
+} from "../../types/api";
+import { API_PREFIX, withQuery, type ApiClientCore } from "./core";
+
+export async function listInboxThreads(
+  core: ApiClientCore,
+  input: {
+    status?: ThreadStatusFilter;
+    mailbox?: MailboxFilter;
+    limit?: number;
+    cursor?: string;
+    before?: string;
+    order?: LatestFirstOrder;
+    since?: string;
+    participant?: string;
+    participantScope?: ParticipantScope;
+    query?: string;
+    hasAttachment?: boolean;
+    identityKey?: string;
+  } & PayloadFilters = {},
+) {
+  return core.requestCollection<ThreadAttributes>(
+    withQuery(`${API_PREFIX}/threads`, {
+      status: input.status,
+      mailbox: input.mailbox,
+      order: input.order,
+      since: input.since,
+      before: input.before,
+      participant: input.participant,
+      participant_scope: input.participantScope,
+      query: input.query,
+      has_attachment: input.hasAttachment,
+      content_format: input.contentFormat,
+      payload_contains: input.payloadContains,
+      payload_path: input.payloadPath,
+      payload_op: input.payloadOp,
+      payload_value: input.payloadValue,
+      "page[limit]": input.limit,
+      "page[after]": input.cursor,
+    }),
+    {
+      token: core.resolveInboxReadToken(input.identityKey),
+    },
+  );
+}
+
+export async function checkInboxThreadChanges(
+  core: ApiClientCore,
+  input: {
+    since: string;
+    status?: ThreadStatusFilter;
+    mailbox?: MailboxFilter;
+    participant?: string;
+    participantScope?: ParticipantScope;
+    query?: string;
+    hasAttachment?: boolean;
+    identityKey?: string;
+  } & PayloadFilters,
+) {
+  return core.requestAction<ChangeCheckResponse>(
+    withQuery(`${API_PREFIX}/threads/changes`, {
+      since: input.since,
+      status: input.status,
+      mailbox: input.mailbox,
+      participant: input.participant,
+      participant_scope: input.participantScope,
+      query: input.query,
+      has_attachment: input.hasAttachment,
+      content_format: input.contentFormat,
+      payload_contains: input.payloadContains,
+      payload_path: input.payloadPath,
+      payload_op: input.payloadOp,
+      payload_value: input.payloadValue,
+    }),
+    {
+      token: core.resolveInboxReadToken(input.identityKey),
+    },
+  );
+}
+
+export async function getThread(
+  core: ApiClientCore,
+  threadId: string,
+  identityKey?: string,
+) {
+  return core.requestResource<ThreadAttributes>(`${API_PREFIX}/threads/${threadId}`, {
+    token: core.resolveInboxReadToken(identityKey),
+  });
+}
+
+export async function listMessagesForThread(
+  core: ApiClientCore,
+  input: {
+    threadId: string;
+    limit?: number;
+    cursor?: string;
+    before?: string;
+    order?: LatestFirstOrder;
+    since?: string;
+    query?: string;
+    hasAttachment?: boolean;
+    identityKey?: string;
+  } & PayloadFilters,
+) {
+  return core.requestCollection<MessageAttributes>(
+    withQuery(`${API_PREFIX}/threads/${input.threadId}/messages`, {
+      order: input.order,
+      since: input.since,
+      before: input.before,
+      query: input.query,
+      has_attachment: input.hasAttachment,
+      content_format: input.contentFormat,
+      payload_contains: input.payloadContains,
+      payload_path: input.payloadPath,
+      payload_op: input.payloadOp,
+      payload_value: input.payloadValue,
+      "page[limit]": input.limit,
+      "page[after]": input.cursor,
+    }),
+    {
+      token: core.resolveInboxReadToken(input.identityKey),
+    },
+  );
+}
+
+export async function checkThreadMessageChanges(
+  core: ApiClientCore,
+  input: {
+    threadId: string;
+    since: string;
+    query?: string;
+    hasAttachment?: boolean;
+    identityKey?: string;
+  } & PayloadFilters,
+) {
+  return core.requestAction<ChangeCheckResponse>(
+    withQuery(`${API_PREFIX}/threads/${input.threadId}/messages/changes`, {
+      since: input.since,
+      query: input.query,
+      has_attachment: input.hasAttachment,
+      content_format: input.contentFormat,
+      payload_contains: input.payloadContains,
+      payload_path: input.payloadPath,
+      payload_op: input.payloadOp,
+      payload_value: input.payloadValue,
+    }),
+    {
+      token: core.resolveInboxReadToken(input.identityKey),
+    },
+  );
+}
+
+export async function listMessageAttachments(
+  core: ApiClientCore,
+  input: {
+    messageId: string;
+    limit?: number;
+    cursor?: string;
+    identityKey?: string;
+  },
+) {
+  return core.requestCollection<MessageAttachmentAttributes>(
+    withQuery(`${API_PREFIX}/messages/${input.messageId}/attachments`, {
+      "page[limit]": input.limit,
+      "page[after]": input.cursor,
+    }),
+    {
+      token: core.resolveInboxReadToken(input.identityKey),
+    },
+  );
+}
+
+export async function listEmailScreeningIntakes(
+  core: ApiClientCore,
+  input: {
+    limit?: number;
+    cursor?: string;
+    identityKey?: string;
+  } = {},
+) {
+  return core.requestCollection<ExternalEmailIntakeAttributes>(
+    withQuery(`${API_PREFIX}/email-intakes/screening`, {
+      "page[limit]": input.limit,
+      "page[after]": input.cursor,
+    }),
+    {
+      token: core.resolveInboxReadToken(input.identityKey),
+    },
+  );
+}
+
+export async function listEmailProcessingIntakes(
+  core: ApiClientCore,
+  input: {
+    limit?: number;
+    cursor?: string;
+    identityKey?: string;
+  } = {},
+) {
+  return core.requestCollection<ExternalEmailIntakeAttributes>(
+    withQuery(`${API_PREFIX}/email-intakes/processing`, {
+      "page[limit]": input.limit,
+      "page[after]": input.cursor,
+    }),
+    {
+      token: core.resolveInboxReadToken(input.identityKey),
+    },
+  );
+}
+
+export async function createThread(
+  core: ApiClientCore,
+  input: {
+    recipient: InboxRecipient;
+    from?: InboxSender;
+    contextPostId?: string;
+    identityKey?: string;
+  } & StructuredContentInput,
+) {
+  return core.requestResource<ThreadAttributes>(`${API_PREFIX}/threads`, {
+    method: "POST",
+    token: core.resolveInboxWriteToken(input.identityKey),
+    body: {
+      data: {
+        type: "thread",
+        attributes: {
+          recipient: input.recipient,
+          ...(input.body !== undefined ? { body: input.body } : {}),
+          ...(input.payload !== undefined ? { payload: input.payload } : {}),
+          ...(input.contentFormat !== undefined
+            ? { content_format: input.contentFormat }
+            : {}),
+          ...(input.from ? { from: input.from } : {}),
+          ...(input.contextPostId
+            ? { context_post_id: input.contextPostId }
+            : {}),
+        },
+      },
+    },
+  });
+}
+
+export async function appendThreadMessage(
+  core: ApiClientCore,
+  input: {
+    threadId: string;
+    from?: InboxSender;
+    contextPostId?: string;
+    identityKey?: string;
+  } & StructuredContentInput,
+) {
+  return core.requestResource<ThreadAttributes>(
+    `${API_PREFIX}/threads/${input.threadId}/messages`,
+    {
+      method: "POST",
+      token: core.resolveInboxWriteToken(input.identityKey),
+      body: {
+        data: {
+          type: "thread",
+          attributes: {
+            ...(input.body !== undefined ? { body: input.body } : {}),
+            ...(input.payload !== undefined ? { payload: input.payload } : {}),
+            ...(input.contentFormat !== undefined
+              ? { content_format: input.contentFormat }
+              : {}),
+            ...(input.from ? { from: input.from } : {}),
+            ...(input.contextPostId
+              ? { context_post_id: input.contextPostId }
+              : {}),
+          },
+        },
+      },
+    },
+  );
+}
+
+export async function markThreadSeen(
+  core: ApiClientCore,
+  input: { threadId: string; identityKey?: string },
+) {
+  return updateThreadLifecycle(core, `${API_PREFIX}/threads/${input.threadId}/seen`, input);
+}
+
+export async function archiveThread(
+  core: ApiClientCore,
+  input: { threadId: string; identityKey?: string },
+) {
+  return updateThreadLifecycle(core, `${API_PREFIX}/threads/${input.threadId}/archive`, input);
+}
+
+export async function resolveThread(
+  core: ApiClientCore,
+  input: { threadId: string; identityKey?: string },
+) {
+  return updateThreadLifecycle(core, `${API_PREFIX}/threads/${input.threadId}/resolve`, input);
+}
+
+export async function blockThread(
+  core: ApiClientCore,
+  input: { threadId: string; identityKey?: string },
+) {
+  return updateThreadLifecycle(core, `${API_PREFIX}/threads/${input.threadId}/block`, input);
+}
+
+export async function approveEmailIntake(
+  core: ApiClientCore,
+  input: { intakeId: string; identityKey?: string },
+) {
+  return updateEmailIntake(
+    core,
+    `${API_PREFIX}/email-intakes/${input.intakeId}/approve`,
+    input,
+  );
+}
+
+export async function approveEmailIntakeOnce(
+  core: ApiClientCore,
+  input: { intakeId: string; identityKey?: string },
+) {
+  return updateEmailIntake(
+    core,
+    `${API_PREFIX}/email-intakes/${input.intakeId}/approve-once`,
+    input,
+  );
+}
+
+export async function ignoreEmailIntake(
+  core: ApiClientCore,
+  input: { intakeId: string; identityKey?: string },
+) {
+  return updateEmailIntake(
+    core,
+    `${API_PREFIX}/email-intakes/${input.intakeId}/ignore`,
+    input,
+  );
+}
+
+async function updateThreadLifecycle(
+  core: ApiClientCore,
+  path: string,
+  input: { threadId: string; identityKey?: string },
+) {
+  return core.requestResource<ThreadAttributes>(path, {
+    method: "PATCH",
+    token: core.resolveInboxWriteToken(input.identityKey),
+    body: {
+      data: {
+        type: "thread",
+        id: input.threadId,
+        attributes: {},
+      },
+    },
+  });
+}
+
+async function updateEmailIntake(
+  core: ApiClientCore,
+  path: string,
+  input: { intakeId: string; identityKey?: string },
+) {
+  return core.requestResource<ExternalEmailIntakeAttributes>(path, {
+    method: "PATCH",
+    token: core.resolveInboxWriteToken(input.identityKey),
+    body: {
+      data: {
+        type: "external_email_intake",
+        id: input.intakeId,
+        attributes: {},
+      },
+    },
+  });
+}

package/src/lib/client/posts.ts

@@ -0,0 +1,236 @@
+import { CliError } from "../errors";
+import {
+  requireMasterToken,
+  requireOwnerReadToken,
+  resolveIdentityCredential,
+} from "../tokens";
+import type {
+  IdResponse,
+  LatestFirstOrder,
+  PayloadFilters,
+  PostAttributes,
+  ShareTokenResponse,
+  StructuredContentInput,
+} from "../../types/api";
+import { API_PREFIX, withQuery, type ApiClientCore } from "./core";
+
+export async function publishPost(
+  core: ApiClientCore,
+  input: {
+    identityId: string;
+    identityKey?: string;
+  } & StructuredContentInput,
+) {
+  const resolved = resolveIdentityCredential(
+    core.profile,
+    input.identityId,
+    input.identityKey,
+  );
+
+  if (!resolved.token) {
+    throw new CliError(
+      `No identity key available for identity ${input.identityId}. Provide --identity-key, set identity key env vars, save an identity key, or configure a master token.`,
+    );
+  }
+
+  return core.requestResource<PostAttributes>(
+    `${API_PREFIX}/identities/${input.identityId}/posts`,
+    {
+      method: "POST",
+      token: resolved.token,
+      body: {
+        data: {
+          type: "post",
+          attributes: {
+            ...(input.body !== undefined ? { body: input.body } : {}),
+            ...(input.payload !== undefined ? { payload: input.payload } : {}),
+            ...(input.contentFormat !== undefined
+              ? { content_format: input.contentFormat }
+              : {}),
+          },
+        },
+      },
+    },
+  );
+}
+
+export async function listIdentityPosts(
+  core: ApiClientCore,
+  input: {
+    identityId: string;
+    limit?: number;
+    cursor?: string;
+    before?: string;
+    order?: LatestFirstOrder;
+    since?: string;
+  } & PayloadFilters,
+) {
+  return core.requestCollection<PostAttributes>(
+    withQuery(`${API_PREFIX}/identities/${input.identityId}/posts`, {
+      order: input.order,
+      since: input.since,
+      before: input.before,
+      content_format: input.contentFormat,
+      payload_contains: input.payloadContains,
+      payload_path: input.payloadPath,
+      payload_op: input.payloadOp,
+      payload_value: input.payloadValue,
+      "page[limit]": input.limit,
+      "page[after]": input.cursor,
+    }),
+    {
+      token: requireOwnerReadToken(core.profile),
+    },
+  );
+}
+
+export async function listPublicIdentityPosts(
+  core: ApiClientCore,
+  input: {
+    publicHandle: string;
+    identityName: string;
+    limit?: number;
+    cursor?: string;
+    before?: string;
+    order?: LatestFirstOrder;
+    since?: string;
+  } & PayloadFilters,
+) {
+  return core.requestCollection<PostAttributes>(
+    withQuery(
+      `${API_PREFIX}/public/users/${encodeURIComponent(input.publicHandle)}/identities/${encodeURIComponent(input.identityName)}/posts`,
+      {
+        order: input.order,
+        since: input.since,
+        before: input.before,
+        content_format: input.contentFormat,
+        payload_contains: input.payloadContains,
+        payload_path: input.payloadPath,
+        payload_op: input.payloadOp,
+        payload_value: input.payloadValue,
+        "page[limit]": input.limit,
+        "page[after]": input.cursor,
+      },
+    ),
+    {},
+  );
+}
+
+export async function listSharedIdentityPosts(
+  core: ApiClientCore,
+  input: {
+    token: string;
+    limit?: number;
+    cursor?: string;
+    before?: string;
+    order?: LatestFirstOrder;
+    since?: string;
+  } & PayloadFilters,
+) {
+  return core.requestCollection<PostAttributes>(
+    withQuery(`${API_PREFIX}/shares/identities/${encodeURIComponent(input.token)}/posts`, {
+      order: input.order,
+      since: input.since,
+      before: input.before,
+      content_format: input.contentFormat,
+      payload_contains: input.payloadContains,
+      payload_path: input.payloadPath,
+      payload_op: input.payloadOp,
+      payload_value: input.payloadValue,
+      "page[limit]": input.limit,
+      "page[after]": input.cursor,
+    }),
+    {},
+  );
+}
+
+export async function getPost(core: ApiClientCore, postId: string) {
+  return core.requestResource<PostAttributes>(
+    `${API_PREFIX}/posts/${postId}`,
+    {
+      token: requireOwnerReadToken(core.profile),
+    },
+  );
+}
+
+export async function getPublicPostByHandle(
+  core: ApiClientCore,
+  input: {
+    publicHandle: string;
+    identityName: string;
+    postId: string;
+  },
+) {
+  return core.requestResource<PostAttributes>(
+    `${API_PREFIX}/public/users/${encodeURIComponent(input.publicHandle)}/identities/${encodeURIComponent(input.identityName)}/posts/${input.postId}`,
+    {},
+  );
+}
+
+export async function getSharedPost(core: ApiClientCore, token: string) {
+  return core.requestResource<PostAttributes>(
+    `${API_PREFIX}/shares/posts/${encodeURIComponent(token)}`,
+    {},
+  );
+}
+
+export async function editPost(
+  core: ApiClientCore,
+  input: {
+    postId: string;
+    identityKey?: string;
+  } & StructuredContentInput,
+) {
+  const token = core.resolvePostLifecycleToken(input.identityKey);
+
+  return core.requestResource<PostAttributes>(
+    `${API_PREFIX}/posts/${input.postId}`,
+    {
+      method: "PATCH",
+      token,
+      body: {
+        data: {
+          type: "post",
+          id: input.postId,
+          attributes: {
+            ...(input.body !== undefined ? { body: input.body } : {}),
+            ...(input.payload !== undefined ? { payload: input.payload } : {}),
+            ...(input.contentFormat !== undefined
+              ? { content_format: input.contentFormat }
+              : {}),
+          },
+        },
+      },
+    },
+  );
+}
+
+export async function deletePost(
+  core: ApiClientCore,
+  input: {
+    postId: string;
+    identityKey?: string;
+  },
+): Promise<void> {
+  const token = core.resolvePostLifecycleToken(input.identityKey);
+
+  await core.requestJsonApi(`${API_PREFIX}/posts/${input.postId}`, {
+    method: "DELETE",
+    token,
+  });
+}
+
+export async function sharePost(core: ApiClientCore, postId: string) {
+  return core.requestAction<ShareTokenResponse>(`${API_PREFIX}/posts/${postId}/share`, {
+    method: "POST",
+    token: requireMasterToken(core.profile),
+    body: { data: {} },
+  });
+}
+
+export async function revokePostShare(core: ApiClientCore, postId: string) {
+  return core.requestAction<IdResponse>(`${API_PREFIX}/posts/${postId}/share`, {
+    method: "DELETE",
+    token: requireMasterToken(core.profile),
+  });
+}

package/src/lib/client/raw-api.ts

@@ -0,0 +1,33 @@
+import { requestJson } from "../http";
+import { resolveMasterToken } from "../tokens";
+import {
+  API_PREFIX,
+  inferMediaType,
+  type ApiClientCore,
+} from "./core";
+
+export async function fetchOpenApi(core: ApiClientCore): Promise<unknown> {
+  return (await requestJson(core.profile.baseUrl, `${API_PREFIX}/open_api`))
+    .data;
+}
+
+export async function apiRequest(
+  core: ApiClientCore,
+  input: {
+    method: string;
+    path: string;
+    body?: string;
+    identityKey?: string;
+  },
+): Promise<unknown> {
+  return (
+    await requestJson(core.profile.baseUrl, input.path, {
+      method: input.method,
+      token: input.identityKey ?? resolveMasterToken(core.profile).token,
+      rawBody: input.body,
+      accept: inferMediaType(input.path),
+      contentType:
+        input.body === undefined ? undefined : inferMediaType(input.path),
+    })
+  ).data;
+}