@useairfoil/producer-github 0.0.2 → 0.0.3

package/src/schemas/commit-statuses.ts

@@ -1,20 +1,40 @@
 import { Iceberg } from "@useairfoil/connector-kit";
 import { Schema, Struct } from "effect";
 
-import { Long, Text, Timestamp, field, user, version } from "./shared";
+import { Long, Text, Timestamp, user, version } from "./shared";
 
 export const CommitStatusSchema = Schema.Struct({
-  id: Long.pipe(field(1, "Unique status ID. Each new status of a context gets a new ID.")),
-  version: version(2, "status"),
-  node_id: Schema.String.pipe(field(3, "GraphQL node ID of the status.")),
-  repository_id: Long.pipe(field(4, "ID of the repository the status belongs to.")),
-  sha: Schema.String.pipe(field(5, "SHA of the commit the status is on.")),
-  state: Schema.String.pipe(field(6, "State: error, failure, pending, or success.")),
-  context: Schema.String.pipe(field(7, "Label that tells the status apart, such as ci/build.")),
-  description: Text.pipe(field(8, "Short description. Empty when not set.")),
-  target_url: Schema.NullOr(Schema.String).pipe(field(9, "Link the status points to.")),
-  creator: Schema.NullOr(user(100)).pipe(field(10, "Account that created the status.")),
-  created_at: Timestamp.pipe(field(11, "Time the status was created.")),
+  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.",

package/src/schemas/commits.ts

@@ -1,43 +1,59 @@
 import { Iceberg } from "@useairfoil/connector-kit";
 import { Schema, SchemaTransformation } from "effect";
 
-import { Long, Timestamp, field, list, user } from "./shared";
+import { Long, Timestamp, user } from "./shared";
 
-export const gitActor = (baseId: number) =>
-  Schema.Struct({
-    name: Schema.String.pipe(field(baseId, "Name in the commit.")),
-    date: Timestamp.pipe(field(baseId + 1, "Time in the commit.")),
-  });
+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 = (baseId: number) =>
-  Schema.NullOr(Schema.Union([user(baseId), Schema.Struct({})])).pipe(
-    Schema.decodeTo(
-      Schema.NullOr(Schema.toType(user(baseId))),
-      SchemaTransformation.transform({
-        decode: (value) => (value !== null && "id" in value ? value : null),
-        encode: (value) => value,
-      }),
-    ),
-  );
+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(field(1, "Repository ID and SHA, such as `1406396726:9eb3a7d`.")),
-  version: Schema.Date.pipe(field(2, "Commit time. A commit never changes.")),
-  repository_id: Long.pipe(field(3, "ID of the repository the commit is in.")),
-  sha: Schema.String.pipe(field(4, "Commit SHA.")),
-  node_id: Schema.String.pipe(field(5, "GraphQL node ID of the commit.")),
-  message: Schema.String.pipe(field(6, "Commit message.")),
-  author: gitActor(100).pipe(field(7, "Author name and time from the commit.")),
-  committer: gitActor(102).pipe(field(8, "Committer name and time from the commit.")),
-  author_user: account(104).pipe(field(9, "GitHub account of the author.")),
-  committer_user: account(107).pipe(field(10, "GitHub account of the committer.")),
-  parents: list(110, Schema.String).pipe(field(11, "SHAs of the parent commits.")),
-  verified: Schema.Boolean.pipe(field(12, "Whether GitHub verified the commit signature.")),
-  html_url: Schema.String.pipe(field(13, "Commit page on GitHub.")),
+  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.",
@@ -50,13 +66,13 @@ export const CommitObjectSchema = Schema.Struct({
   sha: Schema.String,
   node_id: Schema.String,
   commit: Schema.Struct({
-    author: gitActor(100),
-    committer: gitActor(102),
+    author: gitActor,
+    committer: gitActor,
     message: Schema.String,
     verification: Schema.optionalKey(Schema.Struct({ verified: Schema.Boolean })),
   }),
-  author: account(104),
-  committer: account(107),
+  author: account,
+  committer: account,
   parents: Schema.Array(Schema.Struct({ sha: Schema.String })),
   html_url: Schema.String,
 });

package/src/schemas/issue-comments.ts

@@ -1,24 +1,34 @@
 import { Iceberg } from "@useairfoil/connector-kit";
 import { Schema, Struct } from "effect";
 
-import { Long, Text, Timestamp, deleted, field, user, version } from "./shared";
+import { Long, Text, Timestamp, deleted, user, version } from "./shared";
 
 export const IssueCommentSchema = Schema.Struct({
-  id: Long.pipe(field(1, "Unique comment ID.")),
-  version: version(2, "comment"),
-  node_id: Schema.String.pipe(field(3, "GraphQL node ID of the comment.")),
-  repository_id: Long.pipe(field(4, "ID of the repository the comment belongs to.")),
+  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(
-    field(5, "Number of the issue or pull request the comment is on, in its repository."),
+    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." }),
   ),
-  user: Schema.NullOr(user(100)).pipe(field(6, "Account that wrote the comment.")),
   author_association: Schema.String.pipe(
-    field(7, "Author's relation to the repository, such as OWNER or CONTRIBUTOR."),
+    Schema.annotateKey({
+      description: "Author's relation to the repository, such as OWNER or CONTRIBUTOR.",
+    }),
   ),
-  body: Text.pipe(field(8, "Comment in Markdown. Empty when not set.")),
-  created_at: Timestamp.pipe(field(9, "Time the comment was written.")),
-  html_url: Schema.String.pipe(field(10, "Comment on GitHub.")),
-  _deleted: deleted(11, "comment"),
+  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:

package/src/schemas/issues.ts

@@ -6,9 +6,7 @@ import {
   Text,
   Timestamp,
   deleted,
-  field,
   label,
-  list,
   milestone,
   optionalList,
   user,
@@ -16,32 +14,48 @@ import {
 } from "./shared";
 
 export const IssueSchema = Schema.Struct({
-  id: Long.pipe(field(1, "Unique issue ID.")),
-  version: version(2, "issue"),
-  node_id: Schema.String.pipe(field(3, "GraphQL node ID of the issue.")),
-  repository_id: Long.pipe(field(4, "ID of the repository the issue belongs to.")),
-  number: Long.pipe(field(5, "Issue number in the repository.")),
-  title: Schema.String.pipe(field(6, "Issue title.")),
-  body: Text.pipe(field(7, "Issue description in Markdown. Empty when not set.")),
-  state: Schema.String.pipe(field(8, "State: open or closed.")),
+  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(
-    field(9, "Why the issue was closed or reopened, such as completed or not_planned."),
+    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." }),
   ),
-  locked: Schema.Boolean.pipe(field(10, "Whether the conversation is locked.")),
-  user: Schema.NullOr(user(100)).pipe(field(11, "Account that opened the issue.")),
   author_association: Schema.String.pipe(
-    field(12, "Author's relation to the repository, such as OWNER or CONTRIBUTOR."),
+    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." }),
   ),
-  labels: list(103, label(104)).pipe(field(13, "Labels on the issue.")),
-  assignees: list(106, user(107)).pipe(field(14, "Accounts assigned to the issue.")),
-  milestone: Schema.NullOr(milestone(110)).pipe(field(15, "Milestone of the issue.")),
-  comments: Long.pipe(field(16, "Number of comments.")),
-  created_at: Timestamp.pipe(field(17, "Time the issue was opened.")),
+  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(
-    field(18, "Time the issue was closed. Null while it is open."),
+    Schema.annotateKey({ description: "Time the issue was closed. Null while it is open." }),
   ),
-  html_url: Schema.String.pipe(field(19, "Issue page on GitHub.")),
-  _deleted: deleted(20, "issue"),
+  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.",
@@ -53,8 +67,8 @@ 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(104)),
-  assignees: optionalList(user(107)),
+  labels: optionalList(label),
+  assignees: optionalList(user),
   // Set on pull requests, which the issues list also returns.
   pull_request: Schema.optionalKey(Schema.Unknown),
 }));

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

@@ -2,22 +2,36 @@ import { Iceberg } from "@useairfoil/connector-kit";
 import { Schema } from "effect";
 
 import { account, gitActor } from "./commits";
-import { Long, field } from "./shared";
+import { Long } from "./shared";
 
 export const PullRequestCommitSchema = Schema.Struct({
   key: Schema.String.pipe(
-    field(1, "Repository ID, pull request number, and SHA, such as `1406396726:3:9eb3a7d`."),
+    Schema.annotateKey({
+      description: "Repository ID, pull request number, and SHA, such as `1406396726:3:9eb3a7d`.",
+    }),
   ),
-  version: Schema.Date.pipe(field(2, "Time GitHub last updated the pull request.")),
-  repository_id: Long.pipe(field(3, "ID of the repository the pull request belongs to.")),
-  pull_request_number: Long.pipe(field(4, "Pull request number in the repository.")),
-  sha: Schema.String.pipe(field(5, "Commit SHA.")),
-  message: Schema.String.pipe(field(6, "Commit message.")),
-  author: gitActor(100).pipe(field(7, "Author name and time from the commit.")),
-  committer: gitActor(102).pipe(field(8, "Committer name and time from the commit.")),
-  author_user: account(104).pipe(field(9, "GitHub account of the author.")),
-  committer_user: account(107).pipe(field(10, "GitHub account of the committer.")),
-  html_url: Schema.String.pipe(field(11, "Commit page on GitHub.")),
+  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:

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

@@ -1,50 +1,68 @@
 import { Iceberg } from "@useairfoil/connector-kit";
 import { Schema, Struct } from "effect";
 
-import { Long, Timestamp, deleted, field, user, version } from "./shared";
+import { Long, Timestamp, deleted, user, version } from "./shared";
 
 export const PullRequestReviewCommentSchema = Schema.Struct({
-  id: Long.pipe(field(1, "Unique review comment ID.")),
-  version: version(2, "review comment"),
-  node_id: Schema.String.pipe(field(3, "GraphQL node ID of the review comment.")),
-  repository_id: Long.pipe(field(4, "ID of the repository the comment belongs to.")),
+  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(
-    field(5, "Number of the pull request the comment is on, in its repository."),
+    Schema.annotateKey({
+      description: "Number of the pull request the comment is on, in its repository.",
+    }),
   ),
   pull_request_review_id: Schema.NullOr(Long).pipe(
-    field(6, "ID of the review the comment belongs to."),
+    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." }),
   ),
-  in_reply_to_id: Schema.optionalKey(Long).pipe(field(7, "ID of the comment this one replies to.")),
-  user: Schema.NullOr(user(100)).pipe(field(8, "Account that wrote the comment.")),
   author_association: Schema.String.pipe(
-    field(9, "Author's relation to the repository, such as OWNER or CONTRIBUTOR."),
+    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." }),
   ),
-  body: Schema.String.pipe(field(10, "Comment in Markdown.")),
-  path: Schema.String.pipe(field(11, "Path of the file the comment is on.")),
-  commit_id: Schema.String.pipe(field(12, "SHA of the commit the comment is on now.")),
   original_commit_id: Schema.String.pipe(
-    field(13, "SHA of the commit the comment was written on."),
+    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." }),
   ),
-  diff_hunk: Schema.String.pipe(field(14, "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(
-    field(15, "Last line of the commented range in the current diff."),
+    Schema.annotateKey({ description: "Last line of the commented range in the current diff." }),
   ),
   original_line: Schema.optionalKey(Schema.NullOr(Long)).pipe(
-    field(16, "Last line of the commented range in the original diff."),
+    Schema.annotateKey({ description: "Last line of the commented range in the original diff." }),
   ),
   start_line: Schema.optionalKey(Schema.NullOr(Long)).pipe(
-    field(17, "First line of a multi-line comment."),
+    Schema.annotateKey({ description: "First line of a multi-line comment." }),
   ),
   side: Schema.optionalKey(Schema.NullOr(Schema.String)).pipe(
-    field(18, "Side of the diff: LEFT or RIGHT."),
+    Schema.annotateKey({ description: "Side of the diff: LEFT or RIGHT." }),
   ),
   subject_type: Schema.optionalKey(Schema.String).pipe(
-    field(19, "What the comment is on: line or file."),
+    Schema.annotateKey({ description: "What the comment is on: line or file." }),
   ),
-  created_at: Timestamp.pipe(field(20, "Time the comment was written.")),
-  html_url: Schema.String.pipe(field(21, "Comment on GitHub.")),
-  _deleted: deleted(22, "review comment"),
+  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.",

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

@@ -1,27 +1,43 @@
 import { Iceberg } from "@useairfoil/connector-kit";
 import { Schema, Struct } from "effect";
 
-import { Long, Timestamp, field, readVersion, user } from "./shared";
+import { Long, Timestamp, readVersion, user } from "./shared";
 
 export const PullRequestReviewSchema = Schema.Struct({
-  id: Long.pipe(field(1, "Unique review ID.")),
-  version: readVersion(2, "review"),
-  node_id: Schema.String.pipe(field(3, "GraphQL node ID of the review.")),
-  repository_id: Long.pipe(field(4, "ID of the repository the review belongs to.")),
+  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(
-    field(5, "Number of the pull request the review is on, in its repository."),
+    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." }),
   ),
-  user: Schema.NullOr(user(100)).pipe(field(6, "Account that wrote the review.")),
   author_association: Schema.String.pipe(
-    field(7, "Author's relation to the repository, such as OWNER or CONTRIBUTOR."),
+    Schema.annotateKey({
+      description: "Author's relation to the repository, such as OWNER or CONTRIBUTOR.",
+    }),
   ),
   state: Schema.String.pipe(
-    field(8, "State, such as APPROVED, CHANGES_REQUESTED, COMMENTED, or DISMISSED."),
+    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." }),
   ),
-  body: Schema.String.pipe(field(9, "Review summary in Markdown.")),
-  commit_id: Schema.NullOr(Schema.String).pipe(field(10, "SHA of the commit the review is on.")),
-  submitted_at: Schema.optionalKey(Timestamp).pipe(field(11, "Time the review was submitted.")),
-  html_url: Schema.String.pipe(field(12, "Review on GitHub.")),
+  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.",

package/src/schemas/pull-requests.ts

@@ -1,55 +1,75 @@
 import { Iceberg } from "@useairfoil/connector-kit";
 import { Schema, Struct } from "effect";
 
-import {
-  Long,
-  Text,
-  Timestamp,
-  field,
-  label,
-  list,
-  milestone,
-  optionalList,
-  user,
-  version,
-} from "./shared";
+import { Long, Text, Timestamp, label, milestone, optionalList, user, version } from "./shared";
 
-const branch = (baseId: number) =>
-  Schema.Struct({
-    ref: Schema.String.pipe(field(baseId, "Branch name.")),
-    sha: Schema.String.pipe(field(baseId + 1, "Commit SHA.")),
-    label: Schema.String.pipe(field(baseId + 2, "Owner and branch, such as octocat:main.")),
-  });
+const branch = Schema.Struct({
+  ref: Schema.String.pipe(Schema.annotateKey({ description: "Branch name." })),
+  sha: Schema.String.pipe(Schema.annotateKey({ description: "Commit SHA." })),
+  label: Schema.String.pipe(
+    Schema.annotateKey({ description: "Owner and branch, such as octocat:main." }),
+  ),
+});
 
 export const PullRequestSchema = Schema.Struct({
-  id: Long.pipe(field(1, "Unique pull request ID. Not the ID of its issue.")),
-  version: version(2, "pull request"),
-  node_id: Schema.String.pipe(field(3, "GraphQL node ID of the pull request.")),
-  repository_id: Long.pipe(field(4, "ID of the repository the pull request belongs to.")),
-  number: Long.pipe(field(5, "Pull request number in the repository.")),
-  title: Schema.String.pipe(field(6, "Pull request title.")),
-  body: Text.pipe(field(7, "Pull request description in Markdown. Empty when not set.")),
-  state: Schema.String.pipe(field(8, "State: open or closed. Merged pull requests are closed.")),
-  draft: Schema.optionalKey(Schema.Boolean).pipe(field(9, "Whether the pull request is a draft.")),
-  locked: Schema.Boolean.pipe(field(10, "Whether the conversation is locked.")),
-  user: Schema.NullOr(user(100)).pipe(field(11, "Account that opened the pull request.")),
+  id: Long.pipe(
+    Schema.annotateKey({ description: "Unique pull request ID. Not the ID of its issue." }),
+  ),
+  version: version("pull request"),
+  node_id: Schema.String.pipe(
+    Schema.annotateKey({ description: "GraphQL node ID of the pull request." }),
+  ),
+  repository_id: Long.pipe(
+    Schema.annotateKey({ description: "ID of the repository the pull request belongs to." }),
+  ),
+  number: Long.pipe(Schema.annotateKey({ description: "Pull request number in the repository." })),
+  title: Schema.String.pipe(Schema.annotateKey({ description: "Pull request title." })),
+  body: Text.pipe(
+    Schema.annotateKey({
+      description: "Pull request description in Markdown. Empty when not set.",
+    }),
+  ),
+  state: Schema.String.pipe(
+    Schema.annotateKey({ description: "State: open or closed. Merged pull requests are closed." }),
+  ),
+  draft: Schema.optionalKey(Schema.Boolean).pipe(
+    Schema.annotateKey({ description: "Whether the pull request is a draft." }),
+  ),
+  locked: Schema.Boolean.pipe(
+    Schema.annotateKey({ description: "Whether the conversation is locked." }),
+  ),
+  user: Schema.NullOr(user).pipe(
+    Schema.annotateKey({ description: "Account that opened the pull request." }),
+  ),
   author_association: Schema.String.pipe(
-    field(12, "Author's relation to the repository, such as OWNER or CONTRIBUTOR."),
+    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 pull request." }),
+  ),
+  assignees: Schema.Array(user).pipe(
+    Schema.annotateKey({ description: "Accounts assigned to the pull request." }),
   ),
-  labels: list(103, label(104)).pipe(field(13, "Labels on the pull request.")),
-  assignees: list(106, user(107)).pipe(field(14, "Accounts assigned to the pull request.")),
-  requested_reviewers: list(110, user(111)).pipe(
-    field(15, "Accounts asked to review that have not reviewed yet."),
+  requested_reviewers: Schema.Array(user).pipe(
+    Schema.annotateKey({ description: "Accounts asked to review that have not reviewed yet." }),
+  ),
+  milestone: Schema.NullOr(milestone).pipe(
+    Schema.annotateKey({ description: "Milestone of the pull request." }),
+  ),
+  head: branch.pipe(Schema.annotateKey({ description: "Branch the changes come from." })),
+  base: branch.pipe(Schema.annotateKey({ description: "Branch the changes merge into." })),
+  created_at: Timestamp.pipe(
+    Schema.annotateKey({ description: "Time the pull request was opened." }),
   ),
-  milestone: Schema.NullOr(milestone(114)).pipe(field(16, "Milestone of the pull request.")),
-  head: branch(117).pipe(field(17, "Branch the changes come from.")),
-  base: branch(120).pipe(field(18, "Branch the changes merge into.")),
-  created_at: Timestamp.pipe(field(19, "Time the pull request was opened.")),
   closed_at: Schema.NullOr(Timestamp).pipe(
-    field(20, "Time the pull request was closed. Null while it is open."),
+    Schema.annotateKey({ description: "Time the pull request was closed. Null while it is open." }),
+  ),
+  merged_at: Schema.NullOr(Timestamp).pipe(
+    Schema.annotateKey({ description: "Time the pull request was merged." }),
   ),
-  merged_at: Schema.NullOr(Timestamp).pipe(field(21, "Time the pull request was merged.")),
-  html_url: Schema.String.pipe(field(22, "Pull request page on GitHub.")),
+  html_url: Schema.String.pipe(Schema.annotateKey({ description: "Pull request page on GitHub." })),
 })
   .annotate({
     description: "Pull requests in the installation's repositories.",
@@ -67,9 +87,9 @@ export const PullRequestObjectSchema = PullRequestSchema.mapFields((fields) => (
     "requested_reviewers",
   ]),
   updated_at: Timestamp,
-  labels: optionalList(label(104)),
-  assignees: optionalList(user(107)),
-  requested_reviewers: optionalList(user(111)),
+  labels: optionalList(label),
+  assignees: optionalList(user),
+  requested_reviewers: optionalList(user),
 }));
 
 export type PullRequestObject = Schema.Schema.Type<typeof PullRequestObjectSchema>;