@useairfoil/producer-github 0.0.1 → 0.0.3

package/src/schemas/check-runs.ts

@@ -0,0 +1,72 @@
+import { Iceberg } from "@useairfoil/connector-kit";
+import { Schema, Struct } from "effect";
+
+import { Long, Timestamp, readVersion } from "./shared";
+
+export const CheckRunSchema = Schema.Struct({
+  id: Long.pipe(Schema.annotateKey({ description: "Unique check run ID." })),
+  version: readVersion("check run"),
+  node_id: Schema.String.pipe(
+    Schema.annotateKey({ description: "GraphQL node ID of the check run." }),
+  ),
+  repository_id: Long.pipe(
+    Schema.annotateKey({ description: "ID of the repository the check run belongs to." }),
+  ),
+  head_sha: Schema.String.pipe(
+    Schema.annotateKey({ description: "SHA of the commit the check ran on." }),
+  ),
+  name: Schema.String.pipe(Schema.annotateKey({ description: "Check name." })),
+  status: Schema.String.pipe(
+    Schema.annotateKey({ description: "Status, such as queued, in_progress, or completed." }),
+  ),
+  conclusion: Schema.NullOr(Schema.String).pipe(
+    Schema.annotateKey({ description: "Result of a completed check, such as success or failure." }),
+  ),
+  started_at: Schema.NullOr(Timestamp).pipe(
+    Schema.annotateKey({ description: "Time the check started." }),
+  ),
+  completed_at: Schema.NullOr(Timestamp).pipe(
+    Schema.annotateKey({ description: "Time the check completed." }),
+  ),
+  app: Schema.NullOr(
+    Schema.Struct({
+      id: Long.pipe(Schema.annotateKey({ description: "GitHub App ID." })),
+      name: Schema.String.pipe(Schema.annotateKey({ description: "GitHub App name." })),
+    }),
+  ).pipe(
+    Schema.annotateKey({
+      description: "GitHub App that created the check, such as GitHub Actions.",
+    }),
+  ),
+  check_suite: Schema.NullOr(
+    Schema.Struct({ id: Long.pipe(Schema.annotateKey({ description: "Check suite ID." })) }),
+  ).pipe(Schema.annotateKey({ description: "Check suite the check run belongs to." })),
+  output: Schema.Struct({
+    title: Schema.NullOr(Schema.String).pipe(Schema.annotateKey({ description: "Output title." })),
+    summary: Schema.NullOr(Schema.String).pipe(
+      Schema.annotateKey({ description: "Output summary in Markdown." }),
+    ),
+  }).pipe(Schema.annotateKey({ description: "Output the check reported." })),
+  external_id: Schema.NullOr(Schema.String).pipe(
+    Schema.annotateKey({ description: "ID the app gave the check." }),
+  ),
+  details_url: Schema.NullOr(Schema.String).pipe(
+    Schema.annotateKey({ description: "Details page from the app." }),
+  ),
+  html_url: Schema.NullOr(Schema.String).pipe(
+    Schema.annotateKey({ description: "Check run page on GitHub." }),
+  ),
+})
+  .annotate({
+    description:
+      "Check runs, such as GitHub Actions jobs. Polled for default-branch commits; webhooks cover all branches.",
+  })
+  .pipe(Iceberg.identifier("id"));
+
+export type CheckRun = Schema.Schema.Type<typeof CheckRunSchema>;
+
+export const CheckRunObjectSchema = CheckRunSchema.mapFields((fields) =>
+  Struct.omit(fields, ["version", "repository_id"]),
+);
+
+export type CheckRunObject = Schema.Schema.Type<typeof CheckRunObjectSchema>;

package/src/schemas/commit-statuses.ts

@@ -0,0 +1,51 @@
+import { Iceberg } from "@useairfoil/connector-kit";
+import { Schema, Struct } from "effect";
+
+import { Long, Text, Timestamp, user, version } from "./shared";
+
+export const CommitStatusSchema = Schema.Struct({
+  id: Long.pipe(
+    Schema.annotateKey({
+      description: "Unique status ID. Each new status of a context gets a new ID.",
+    }),
+  ),
+  version: version("status"),
+  node_id: Schema.String.pipe(
+    Schema.annotateKey({ description: "GraphQL node ID of the status." }),
+  ),
+  repository_id: Long.pipe(
+    Schema.annotateKey({ description: "ID of the repository the status belongs to." }),
+  ),
+  sha: Schema.String.pipe(
+    Schema.annotateKey({ description: "SHA of the commit the status is on." }),
+  ),
+  state: Schema.String.pipe(
+    Schema.annotateKey({ description: "State: error, failure, pending, or success." }),
+  ),
+  context: Schema.String.pipe(
+    Schema.annotateKey({ description: "Label that tells the status apart, such as ci/build." }),
+  ),
+  description: Text.pipe(
+    Schema.annotateKey({ description: "Short description. Empty when not set." }),
+  ),
+  target_url: Schema.NullOr(Schema.String).pipe(
+    Schema.annotateKey({ description: "Link the status points to." }),
+  ),
+  creator: Schema.NullOr(user).pipe(
+    Schema.annotateKey({ description: "Account that created the status." }),
+  ),
+  created_at: Timestamp.pipe(Schema.annotateKey({ description: "Time the status was created." })),
+})
+  .annotate({
+    description: "Commit statuses. Polled for default-branch commits; webhooks cover all branches.",
+  })
+  .pipe(Iceberg.identifier("id"));
+
+export type CommitStatus = Schema.Schema.Type<typeof CommitStatusSchema>;
+
+export const CommitStatusObjectSchema = CommitStatusSchema.mapFields((fields) => ({
+  ...Struct.omit(fields, ["version", "repository_id", "sha"]),
+  updated_at: Timestamp,
+}));
+
+export type CommitStatusObject = Schema.Schema.Type<typeof CommitStatusObjectSchema>;

package/src/schemas/commits.ts

@@ -0,0 +1,80 @@
+import { Iceberg } from "@useairfoil/connector-kit";
+import { Schema, SchemaTransformation } from "effect";
+
+import { Long, Timestamp, user } from "./shared";
+
+export const gitActor = Schema.Struct({
+  name: Schema.String.pipe(Schema.annotateKey({ description: "Name in the commit." })),
+  date: Timestamp.pipe(Schema.annotateKey({ description: "Time in the commit." })),
+});
+
+/**
+ * The GitHub account of a commit's author or committer. GitHub sends `null` or
+ * `{}` when the email matches no account, and both become `null`.
+ */
+export const account = Schema.NullOr(Schema.Union([user, Schema.Struct({})])).pipe(
+  Schema.decodeTo(
+    Schema.NullOr(Schema.toType(user)),
+    SchemaTransformation.transform({
+      decode: (value) => (value !== null && "id" in value ? value : null),
+      encode: (value) => value,
+    }),
+  ),
+);
+
+export const CommitSchema = Schema.Struct({
+  key: Schema.String.pipe(
+    Schema.annotateKey({ description: "Repository ID and SHA, such as `1406396726:9eb3a7d`." }),
+  ),
+  version: Schema.Date.pipe(
+    Schema.annotateKey({ description: "Commit time. A commit never changes." }),
+  ),
+  repository_id: Long.pipe(
+    Schema.annotateKey({ description: "ID of the repository the commit is in." }),
+  ),
+  sha: Schema.String.pipe(Schema.annotateKey({ description: "Commit SHA." })),
+  node_id: Schema.String.pipe(
+    Schema.annotateKey({ description: "GraphQL node ID of the commit." }),
+  ),
+  message: Schema.String.pipe(Schema.annotateKey({ description: "Commit message." })),
+  author: gitActor.pipe(
+    Schema.annotateKey({ description: "Author name and time from the commit." }),
+  ),
+  committer: gitActor.pipe(
+    Schema.annotateKey({ description: "Committer name and time from the commit." }),
+  ),
+  author_user: account.pipe(Schema.annotateKey({ description: "GitHub account of the author." })),
+  committer_user: account.pipe(
+    Schema.annotateKey({ description: "GitHub account of the committer." }),
+  ),
+  parents: Schema.Array(Schema.String).pipe(
+    Schema.annotateKey({ description: "SHAs of the parent commits." }),
+  ),
+  verified: Schema.Boolean.pipe(
+    Schema.annotateKey({ description: "Whether GitHub verified the commit signature." }),
+  ),
+  html_url: Schema.String.pipe(Schema.annotateKey({ description: "Commit page on GitHub." })),
+})
+  .annotate({
+    description: "Commits on the default branch of the installation's repositories.",
+  })
+  .pipe(Iceberg.identifier("key"));
+
+export type Commit = Schema.Schema.Type<typeof CommitSchema>;
+
+export const CommitObjectSchema = Schema.Struct({
+  sha: Schema.String,
+  node_id: Schema.String,
+  commit: Schema.Struct({
+    author: gitActor,
+    committer: gitActor,
+    message: Schema.String,
+    verification: Schema.optionalKey(Schema.Struct({ verified: Schema.Boolean })),
+  }),
+  author: account,
+  committer: account,
+  parents: Schema.Array(Schema.Struct({ sha: Schema.String })),
+  html_url: Schema.String,
+});
+
+export type CommitObject = Schema.Schema.Type<typeof CommitObjectSchema>;

package/src/schemas/events.ts

@@ -0,0 +1,139 @@
+import { Schema, Struct } from "effect";
+
+import { IssueCommentObjectSchema } from "./issue-comments";
+import { IssueObjectSchema } from "./issues";
+import { PullRequestReviewCommentObjectSchema } from "./pull-request-review-comments";
+import { PullRequestObjectSchema } from "./pull-requests";
+import { ReleaseObjectSchema } from "./releases";
+import { RepositoryObjectSchema } from "./repositories";
+import { Long, ObjectRefSchema, Timestamp } from "./shared";
+import { WorkflowRunObjectSchema } from "./workflow-runs";
+
+/**
+ * The webhook route passes the payload on as it is. GitHub puts the event name
+ * in a header, so each resource decodes its own event.
+ */
+export const WebhookPayloadSchema = Schema.Record(Schema.String, Schema.Unknown);
+
+export type WebhookPayload = Schema.Schema.Type<typeof WebhookPayloadSchema>;
+
+export const InstallationEventSchema = Schema.Struct({
+  installation: Schema.optional(Schema.Struct({ id: Schema.Number })),
+});
+
+/** For handlers that read the API again. */
+const RepositoryNameSchema = Schema.Struct({ id: Long, full_name: Schema.String });
+
+/** A transferred issue no longer exists in its old repository. */
+export const IssueRemovedEventSchema = Schema.Struct({
+  action: Schema.Literals(["deleted", "transferred"]),
+  issue: ObjectRefSchema,
+});
+
+export const IssuesEventSchema = Schema.Union([
+  IssueRemovedEventSchema,
+  Schema.Struct({
+    action: Schema.String,
+    repository: RepositoryNameSchema,
+    issue: IssueObjectSchema,
+  }),
+]);
+
+export const IssueCommentDeletedEventSchema = Schema.Struct({
+  action: Schema.Literal("deleted"),
+  comment: ObjectRefSchema,
+});
+
+export const IssueCommentEventSchema = Schema.Union([
+  IssueCommentDeletedEventSchema,
+  Schema.Struct({
+    action: Schema.String,
+    repository: ObjectRefSchema,
+    comment: IssueCommentObjectSchema,
+  }),
+]);
+
+export const PullRequestReviewCommentDeletedEventSchema = Schema.Struct({
+  action: Schema.Literal("deleted"),
+  comment: ObjectRefSchema,
+});
+
+export const PullRequestReviewCommentEventSchema = Schema.Union([
+  PullRequestReviewCommentDeletedEventSchema,
+  Schema.Struct({
+    action: Schema.String,
+    repository: ObjectRefSchema,
+    comment: PullRequestReviewCommentObjectSchema,
+  }),
+]);
+
+export const PullRequestEventSchema = Schema.Struct({
+  repository: RepositoryNameSchema,
+  pull_request: PullRequestObjectSchema,
+});
+
+export const RepositoryDeletedEventSchema = Schema.Struct({
+  action: Schema.Literal("deleted"),
+  repository: ObjectRefSchema,
+});
+
+export const RepositoryEventSchema = Schema.Union([
+  RepositoryDeletedEventSchema,
+  Schema.Struct({ action: Schema.String, repository: RepositoryObjectSchema }),
+]);
+
+export const ReleaseDeletedEventSchema = Schema.Struct({
+  action: Schema.Literal("deleted"),
+  release: ObjectRefSchema,
+});
+
+export const ReleaseEventSchema = Schema.Union([
+  ReleaseDeletedEventSchema,
+  Schema.Struct({
+    action: Schema.String,
+    repository: ObjectRefSchema,
+    release: ReleaseObjectSchema,
+  }),
+]);
+
+export const WorkflowRunEventSchema = Schema.Struct({
+  repository: ObjectRefSchema,
+  workflow_run: WorkflowRunObjectSchema,
+});
+
+export const PushEventSchema = Schema.Struct({
+  ref: Schema.String,
+  before: Schema.String,
+  after: Schema.String,
+  repository: RepositoryNameSchema.mapFields(Struct.assign({ default_branch: Schema.String })),
+});
+
+export const PullRequestReviewEventSchema = Schema.Struct({
+  repository: RepositoryNameSchema,
+  pull_request: Schema.Struct({ number: Long }),
+  review: ObjectRefSchema,
+});
+
+export const PullRequestCommitsEventSchema = Schema.Struct({
+  action: Schema.String,
+  changes: Schema.optionalKey(Schema.Struct({ base: Schema.optionalKey(Schema.Unknown) })),
+  repository: RepositoryNameSchema,
+  pull_request: Schema.Struct({ number: Long, updated_at: Timestamp }),
+});
+
+export const CheckRunEventSchema = Schema.Struct({
+  repository: RepositoryNameSchema,
+  check_run: ObjectRefSchema,
+});
+
+export const WorkflowJobEventSchema = Schema.Struct({
+  repository: RepositoryNameSchema,
+  workflow_job: ObjectRefSchema,
+});
+
+/** The status payload is flat. */
+export const StatusEventSchema = Schema.Struct({
+  id: Long,
+  sha: Schema.String,
+  repository: RepositoryNameSchema,
+});

package/src/schemas/issue-comments.ts

@@ -0,0 +1,48 @@
+import { Iceberg } from "@useairfoil/connector-kit";
+import { Schema, Struct } from "effect";
+
+import { Long, Text, Timestamp, deleted, user, version } from "./shared";
+
+export const IssueCommentSchema = Schema.Struct({
+  id: Long.pipe(Schema.annotateKey({ description: "Unique comment ID." })),
+  version: version("comment"),
+  node_id: Schema.String.pipe(
+    Schema.annotateKey({ description: "GraphQL node ID of the comment." }),
+  ),
+  repository_id: Long.pipe(
+    Schema.annotateKey({ description: "ID of the repository the comment belongs to." }),
+  ),
+  issue_number: Long.pipe(
+    Schema.annotateKey({
+      description: "Number of the issue or pull request the comment is on, in its repository.",
+    }),
+  ),
+  user: Schema.NullOr(user).pipe(
+    Schema.annotateKey({ description: "Account that wrote the comment." }),
+  ),
+  author_association: Schema.String.pipe(
+    Schema.annotateKey({
+      description: "Author's relation to the repository, such as OWNER or CONTRIBUTOR.",
+    }),
+  ),
+  body: Text.pipe(Schema.annotateKey({ description: "Comment in Markdown. Empty when not set." })),
+  created_at: Timestamp.pipe(Schema.annotateKey({ description: "Time the comment was written." })),
+  html_url: Schema.String.pipe(Schema.annotateKey({ description: "Comment on GitHub." })),
+  _deleted: deleted("comment"),
+})
+  .annotate({
+    description:
+      "Comments on issues and pull requests. Pull request review comments are not included.",
+  })
+  .pipe(Iceberg.identifier("id"));
+
+export type IssueComment = Schema.Schema.Type<typeof IssueCommentSchema>;
+
+export const IssueCommentObjectSchema = IssueCommentSchema.mapFields((fields) => ({
+  ...Struct.omit(fields, ["version", "repository_id", "issue_number", "_deleted"]),
+  updated_at: Timestamp,
+  // The list has no issue number, only this URL, which ends in it.
+  issue_url: Schema.String.check(Schema.isPattern(/\/issues\/\d+$/)),
+}));
+
+export type IssueCommentObject = Schema.Schema.Type<typeof IssueCommentObjectSchema>;

package/src/schemas/issues.ts

@@ -0,0 +1,76 @@
+import { Iceberg } from "@useairfoil/connector-kit";
+import { Schema, Struct } from "effect";
+
+import {
+  Long,
+  Text,
+  Timestamp,
+  deleted,
+  label,
+  milestone,
+  optionalList,
+  user,
+  version,
+} from "./shared";
+
+export const IssueSchema = Schema.Struct({
+  id: Long.pipe(Schema.annotateKey({ description: "Unique issue ID." })),
+  version: version("issue"),
+  node_id: Schema.String.pipe(Schema.annotateKey({ description: "GraphQL node ID of the issue." })),
+  repository_id: Long.pipe(
+    Schema.annotateKey({ description: "ID of the repository the issue belongs to." }),
+  ),
+  number: Long.pipe(Schema.annotateKey({ description: "Issue number in the repository." })),
+  title: Schema.String.pipe(Schema.annotateKey({ description: "Issue title." })),
+  body: Text.pipe(
+    Schema.annotateKey({ description: "Issue description in Markdown. Empty when not set." }),
+  ),
+  state: Schema.String.pipe(Schema.annotateKey({ description: "State: open or closed." })),
+  state_reason: Schema.NullOr(Schema.String).pipe(
+    Schema.annotateKey({
+      description: "Why the issue was closed or reopened, such as completed or not_planned.",
+    }),
+  ),
+  locked: Schema.Boolean.pipe(
+    Schema.annotateKey({ description: "Whether the conversation is locked." }),
+  ),
+  user: Schema.NullOr(user).pipe(
+    Schema.annotateKey({ description: "Account that opened the issue." }),
+  ),
+  author_association: Schema.String.pipe(
+    Schema.annotateKey({
+      description: "Author's relation to the repository, such as OWNER or CONTRIBUTOR.",
+    }),
+  ),
+  labels: Schema.Array(label).pipe(Schema.annotateKey({ description: "Labels on the issue." })),
+  assignees: Schema.Array(user).pipe(
+    Schema.annotateKey({ description: "Accounts assigned to the issue." }),
+  ),
+  milestone: Schema.NullOr(milestone).pipe(
+    Schema.annotateKey({ description: "Milestone of the issue." }),
+  ),
+  comments: Long.pipe(Schema.annotateKey({ description: "Number of comments." })),
+  created_at: Timestamp.pipe(Schema.annotateKey({ description: "Time the issue was opened." })),
+  closed_at: Schema.NullOr(Timestamp).pipe(
+    Schema.annotateKey({ description: "Time the issue was closed. Null while it is open." }),
+  ),
+  html_url: Schema.String.pipe(Schema.annotateKey({ description: "Issue page on GitHub." })),
+  _deleted: deleted("issue"),
+})
+  .annotate({
+    description: "Issues in the installation's repositories. Pull requests are not included.",
+  })
+  .pipe(Iceberg.identifier("id"));
+
+export type Issue = Schema.Schema.Type<typeof IssueSchema>;
+
+export const IssueObjectSchema = IssueSchema.mapFields((fields) => ({
+  ...Struct.omit(fields, ["version", "repository_id", "labels", "assignees", "_deleted"]),
+  updated_at: Timestamp,
+  labels: optionalList(label),
+  assignees: optionalList(user),
+  // Set on pull requests, which the issues list also returns.
+  pull_request: Schema.optionalKey(Schema.Unknown),
+}));
+
+export type IssueObject = Schema.Schema.Type<typeof IssueObjectSchema>;

package/src/schemas/pull-request-commits.ts

@@ -0,0 +1,42 @@
+import { Iceberg } from "@useairfoil/connector-kit";
+import { Schema } from "effect";
+
+import { account, gitActor } from "./commits";
+import { Long } from "./shared";
+
+export const PullRequestCommitSchema = Schema.Struct({
+  key: Schema.String.pipe(
+    Schema.annotateKey({
+      description: "Repository ID, pull request number, and SHA, such as `1406396726:3:9eb3a7d`.",
+    }),
+  ),
+  version: Schema.Date.pipe(
+    Schema.annotateKey({ description: "Time GitHub last updated the pull request." }),
+  ),
+  repository_id: Long.pipe(
+    Schema.annotateKey({ description: "ID of the repository the pull request belongs to." }),
+  ),
+  pull_request_number: Long.pipe(
+    Schema.annotateKey({ description: "Pull request number in the repository." }),
+  ),
+  sha: Schema.String.pipe(Schema.annotateKey({ description: "Commit SHA." })),
+  message: Schema.String.pipe(Schema.annotateKey({ description: "Commit message." })),
+  author: gitActor.pipe(
+    Schema.annotateKey({ description: "Author name and time from the commit." }),
+  ),
+  committer: gitActor.pipe(
+    Schema.annotateKey({ description: "Committer name and time from the commit." }),
+  ),
+  author_user: account.pipe(Schema.annotateKey({ description: "GitHub account of the author." })),
+  committer_user: account.pipe(
+    Schema.annotateKey({ description: "GitHub account of the committer." }),
+  ),
+  html_url: Schema.String.pipe(Schema.annotateKey({ description: "Commit page on GitHub." })),
+})
+  .annotate({
+    description:
+      "Commits in pull requests, up to 250 per pull request. Commits removed by a force push stay.",
+  })
+  .pipe(Iceberg.identifier("key"));
+
+export type PullRequestCommit = Schema.Schema.Type<typeof PullRequestCommitSchema>;

package/src/schemas/pull-request-review-comments.ts

@@ -0,0 +1,85 @@
+import { Iceberg } from "@useairfoil/connector-kit";
+import { Schema, Struct } from "effect";
+
+import { Long, Timestamp, deleted, user, version } from "./shared";
+
+export const PullRequestReviewCommentSchema = Schema.Struct({
+  id: Long.pipe(Schema.annotateKey({ description: "Unique review comment ID." })),
+  version: version("review comment"),
+  node_id: Schema.String.pipe(
+    Schema.annotateKey({ description: "GraphQL node ID of the review comment." }),
+  ),
+  repository_id: Long.pipe(
+    Schema.annotateKey({ description: "ID of the repository the comment belongs to." }),
+  ),
+  pull_request_number: Long.pipe(
+    Schema.annotateKey({
+      description: "Number of the pull request the comment is on, in its repository.",
+    }),
+  ),
+  pull_request_review_id: Schema.NullOr(Long).pipe(
+    Schema.annotateKey({ description: "ID of the review the comment belongs to." }),
+  ),
+  in_reply_to_id: Schema.optionalKey(Long).pipe(
+    Schema.annotateKey({ description: "ID of the comment this one replies to." }),
+  ),
+  user: Schema.NullOr(user).pipe(
+    Schema.annotateKey({ description: "Account that wrote the comment." }),
+  ),
+  author_association: Schema.String.pipe(
+    Schema.annotateKey({
+      description: "Author's relation to the repository, such as OWNER or CONTRIBUTOR.",
+    }),
+  ),
+  body: Schema.String.pipe(Schema.annotateKey({ description: "Comment in Markdown." })),
+  path: Schema.String.pipe(
+    Schema.annotateKey({ description: "Path of the file the comment is on." }),
+  ),
+  commit_id: Schema.String.pipe(
+    Schema.annotateKey({ description: "SHA of the commit the comment is on now." }),
+  ),
+  original_commit_id: Schema.String.pipe(
+    Schema.annotateKey({ description: "SHA of the commit the comment was written on." }),
+  ),
+  diff_hunk: Schema.String.pipe(
+    Schema.annotateKey({ description: "Part of the diff the comment is on." }),
+  ),
+  // GitHub sends null for a comment on a line that is no longer in the diff.
+  line: Schema.optionalKey(Schema.NullOr(Long)).pipe(
+    Schema.annotateKey({ description: "Last line of the commented range in the current diff." }),
+  ),
+  original_line: Schema.optionalKey(Schema.NullOr(Long)).pipe(
+    Schema.annotateKey({ description: "Last line of the commented range in the original diff." }),
+  ),
+  start_line: Schema.optionalKey(Schema.NullOr(Long)).pipe(
+    Schema.annotateKey({ description: "First line of a multi-line comment." }),
+  ),
+  side: Schema.optionalKey(Schema.NullOr(Schema.String)).pipe(
+    Schema.annotateKey({ description: "Side of the diff: LEFT or RIGHT." }),
+  ),
+  subject_type: Schema.optionalKey(Schema.String).pipe(
+    Schema.annotateKey({ description: "What the comment is on: line or file." }),
+  ),
+  created_at: Timestamp.pipe(Schema.annotateKey({ description: "Time the comment was written." })),
+  html_url: Schema.String.pipe(Schema.annotateKey({ description: "Comment on GitHub." })),
+  _deleted: deleted("review comment"),
+})
+  .annotate({
+    description: "Review comments on pull request diffs.",
+  })
+  .pipe(Iceberg.identifier("id"));
+
+export type PullRequestReviewComment = Schema.Schema.Type<typeof PullRequestReviewCommentSchema>;
+
+export const PullRequestReviewCommentObjectSchema = PullRequestReviewCommentSchema.mapFields(
+  (fields) => ({
+    ...Struct.omit(fields, ["version", "repository_id", "pull_request_number", "_deleted"]),
+    updated_at: Timestamp,
+    // The list has no pull request number, only this URL, which ends in it.
+    pull_request_url: Schema.String.check(Schema.isPattern(/\/pulls\/\d+$/)),
+  }),
+);
+
+export type PullRequestReviewCommentObject = Schema.Schema.Type<
+  typeof PullRequestReviewCommentObjectSchema
+>;

package/src/schemas/pull-request-reviews.ts

@@ -0,0 +1,53 @@
+import { Iceberg } from "@useairfoil/connector-kit";
+import { Schema, Struct } from "effect";
+
+import { Long, Timestamp, readVersion, user } from "./shared";
+
+export const PullRequestReviewSchema = Schema.Struct({
+  id: Long.pipe(Schema.annotateKey({ description: "Unique review ID." })),
+  version: readVersion("review"),
+  node_id: Schema.String.pipe(
+    Schema.annotateKey({ description: "GraphQL node ID of the review." }),
+  ),
+  repository_id: Long.pipe(
+    Schema.annotateKey({ description: "ID of the repository the review belongs to." }),
+  ),
+  pull_request_number: Long.pipe(
+    Schema.annotateKey({
+      description: "Number of the pull request the review is on, in its repository.",
+    }),
+  ),
+  user: Schema.NullOr(user).pipe(
+    Schema.annotateKey({ description: "Account that wrote the review." }),
+  ),
+  author_association: Schema.String.pipe(
+    Schema.annotateKey({
+      description: "Author's relation to the repository, such as OWNER or CONTRIBUTOR.",
+    }),
+  ),
+  state: Schema.String.pipe(
+    Schema.annotateKey({
+      description: "State, such as APPROVED, CHANGES_REQUESTED, COMMENTED, or DISMISSED.",
+    }),
+  ),
+  body: Schema.String.pipe(Schema.annotateKey({ description: "Review summary in Markdown." })),
+  commit_id: Schema.NullOr(Schema.String).pipe(
+    Schema.annotateKey({ description: "SHA of the commit the review is on." }),
+  ),
+  submitted_at: Schema.optionalKey(Timestamp).pipe(
+    Schema.annotateKey({ description: "Time the review was submitted." }),
+  ),
+  html_url: Schema.String.pipe(Schema.annotateKey({ description: "Review on GitHub." })),
+})
+  .annotate({
+    description: "Reviews on pull requests. Pending reviews are only visible to their author.",
+  })
+  .pipe(Iceberg.identifier("id"));
+
+export type PullRequestReview = Schema.Schema.Type<typeof PullRequestReviewSchema>;
+
+export const PullRequestReviewObjectSchema = PullRequestReviewSchema.mapFields((fields) =>
+  Struct.omit(fields, ["version", "repository_id", "pull_request_number"]),
+);
+
+export type PullRequestReviewObject = Schema.Schema.Type<typeof PullRequestReviewObjectSchema>;