@automate.ax/integration-contracts 0.86.2 → 0.87.0

package/src/github/additional-events.ts

@@ -0,0 +1,704 @@
+import type { Encodable } from "@automate.ax/codec"
+import type { webhooks } from "@octokit/openapi-webhooks-types"
+import * as z from "zod"
+
+type GitHubWebhookPayload<TKey extends keyof webhooks> =
+  webhooks[TKey]["post"] extends {
+    requestBody: {
+      content: { "application/json": infer TPayload }
+    }
+  }
+    ? TPayload & Record<string, Encodable>
+    : never
+
+/** Official GitHub check-run webhook payload union. */
+export type GitHubCheckRunEvent = GitHubWebhookPayload<
+  Extract<keyof webhooks, `check-run-${string}`>
+>
+export type GitHubCheckRunCreatedEvent =
+  GitHubWebhookPayload<"check-run-created">
+export type GitHubCheckRunRerequestedEvent =
+  GitHubWebhookPayload<"check-run-rerequested">
+export type GitHubCheckRunRequestedActionEvent =
+  GitHubWebhookPayload<"check-run-requested-action">
+export type GitHubCheckRunCompletedEvent =
+  GitHubWebhookPayload<"check-run-completed">
+export type GitHubCheckRunSucceededEvent = GitHubCheckRunCompletedEvent & {
+  check_run: GitHubCheckRunCompletedEvent["check_run"] & {
+    conclusion: "success"
+  }
+}
+export type GitHubCheckRunFailedEvent = GitHubCheckRunCompletedEvent & {
+  check_run: GitHubCheckRunCompletedEvent["check_run"] & {
+    conclusion: "failure"
+  }
+}
+export type GitHubCheckRunCancelledEvent = GitHubCheckRunCompletedEvent & {
+  check_run: GitHubCheckRunCompletedEvent["check_run"] & {
+    conclusion: "cancelled"
+  }
+}
+export type GitHubCheckRunTimedOutEvent = GitHubCheckRunCompletedEvent & {
+  check_run: GitHubCheckRunCompletedEvent["check_run"] & {
+    conclusion: "timed_out"
+  }
+}
+export type GitHubCheckRunStartupFailedEvent = GitHubCheckRunCompletedEvent & {
+  check_run: GitHubCheckRunCompletedEvent["check_run"] & {
+    conclusion: "startup_failure"
+  }
+}
+export type GitHubCheckRunActionRequiredEvent = GitHubCheckRunCompletedEvent & {
+  check_run: GitHubCheckRunCompletedEvent["check_run"] & {
+    conclusion: "action_required"
+  }
+}
+
+/** Official GitHub check-suite webhook payload union. */
+export type GitHubCheckSuiteEvent = GitHubWebhookPayload<
+  Extract<keyof webhooks, `check-suite-${string}`>
+>
+export type GitHubCheckSuiteCompletedEvent =
+  GitHubWebhookPayload<"check-suite-completed">
+export type GitHubCheckSuiteRequestedEvent =
+  GitHubWebhookPayload<"check-suite-requested">
+export type GitHubCheckSuiteRerequestedEvent =
+  GitHubWebhookPayload<"check-suite-rerequested">
+export type GitHubCheckSuiteSucceededEvent = GitHubCheckSuiteCompletedEvent & {
+  check_suite: GitHubCheckSuiteCompletedEvent["check_suite"] & {
+    conclusion: "success"
+  }
+}
+export type GitHubCheckSuiteFailedEvent = GitHubCheckSuiteCompletedEvent & {
+  check_suite: GitHubCheckSuiteCompletedEvent["check_suite"] & {
+    conclusion: "failure"
+  }
+}
+export type GitHubCheckSuiteCancelledEvent = GitHubCheckSuiteCompletedEvent & {
+  check_suite: GitHubCheckSuiteCompletedEvent["check_suite"] & {
+    conclusion: "cancelled"
+  }
+}
+export type GitHubCheckSuiteTimedOutEvent = GitHubCheckSuiteCompletedEvent & {
+  check_suite: GitHubCheckSuiteCompletedEvent["check_suite"] & {
+    conclusion: "timed_out"
+  }
+}
+export type GitHubCheckSuiteStartupFailedEvent =
+  GitHubCheckSuiteCompletedEvent & {
+    check_suite: GitHubCheckSuiteCompletedEvent["check_suite"] & {
+      conclusion: "startup_failure"
+    }
+  }
+export type GitHubCheckSuiteActionRequiredEvent =
+  GitHubCheckSuiteCompletedEvent & {
+    check_suite: GitHubCheckSuiteCompletedEvent["check_suite"] & {
+      conclusion: "action_required"
+    }
+  }
+
+/** GitHub branch-or-tag creation webhook payload. */
+export type GitHubRefCreatedEvent = GitHubWebhookPayload<"create">
+export type GitHubBranchCreatedEvent = GitHubRefCreatedEvent & {
+  ref_type: "branch"
+}
+export type GitHubTagCreatedEvent = GitHubRefCreatedEvent & { ref_type: "tag" }
+
+/** GitHub branch-or-tag deletion webhook payload. */
+export type GitHubRefDeletedEvent = GitHubWebhookPayload<"delete">
+export type GitHubBranchDeletedEvent = GitHubRefDeletedEvent & {
+  ref_type: "branch"
+}
+export type GitHubTagDeletedEvent = GitHubRefDeletedEvent & { ref_type: "tag" }
+
+/** Official GitHub issue-comment webhook payload union. */
+export type GitHubIssueCommentEvent = GitHubWebhookPayload<
+  Extract<keyof webhooks, `issue-comment-${string}`>
+>
+export type GitHubIssueCommentCreatedEvent =
+  GitHubWebhookPayload<"issue-comment-created">
+export type GitHubIssueCommentEditedEvent =
+  GitHubWebhookPayload<"issue-comment-edited">
+export type GitHubIssueCommentDeletedEvent =
+  GitHubWebhookPayload<"issue-comment-deleted">
+
+/** Official GitHub pull-request review-comment webhook payload union. */
+export type GitHubPullRequestReviewCommentEvent = GitHubWebhookPayload<
+  Extract<keyof webhooks, `pull-request-review-comment-${string}`>
+>
+export type GitHubPullRequestReviewCommentCreatedEvent =
+  GitHubWebhookPayload<"pull-request-review-comment-created">
+export type GitHubPullRequestReviewCommentEditedEvent =
+  GitHubWebhookPayload<"pull-request-review-comment-edited">
+export type GitHubPullRequestReviewCommentDeletedEvent =
+  GitHubWebhookPayload<"pull-request-review-comment-deleted">
+
+/** Official GitHub workflow-job webhook payload union. */
+export type GitHubWorkflowJobEvent = GitHubWebhookPayload<
+  Extract<keyof webhooks, `workflow-job-${string}`>
+>
+export type GitHubWorkflowJobQueuedEvent =
+  GitHubWebhookPayload<"workflow-job-queued">
+export type GitHubWorkflowJobStartedEvent =
+  GitHubWebhookPayload<"workflow-job-in-progress">
+export type GitHubWorkflowJobWaitingEvent =
+  GitHubWebhookPayload<"workflow-job-waiting">
+export type GitHubWorkflowJobCompletedEvent =
+  GitHubWebhookPayload<"workflow-job-completed">
+export type GitHubWorkflowJobSucceededEvent =
+  GitHubWorkflowJobCompletedEvent & {
+    workflow_job: GitHubWorkflowJobCompletedEvent["workflow_job"] & {
+      conclusion: "success"
+    }
+  }
+export type GitHubWorkflowJobFailedEvent = GitHubWorkflowJobCompletedEvent & {
+  workflow_job: GitHubWorkflowJobCompletedEvent["workflow_job"] & {
+    conclusion: "failure"
+  }
+}
+export type GitHubWorkflowJobCancelledEvent =
+  GitHubWorkflowJobCompletedEvent & {
+    workflow_job: GitHubWorkflowJobCompletedEvent["workflow_job"] & {
+      conclusion: "cancelled"
+    }
+  }
+export type GitHubWorkflowJobTimedOutEvent = GitHubWorkflowJobCompletedEvent & {
+  workflow_job: GitHubWorkflowJobCompletedEvent["workflow_job"] & {
+    conclusion: "timed_out"
+  }
+}
+
+/** GitHub repository-dispatch webhook payload. */
+export type GitHubRepositoryDispatchEvent =
+  GitHubWebhookPayload<"repository-dispatch-sample.collected">
+
+/** GitHub workflow-dispatch webhook payload. */
+export type GitHubWorkflowDispatchEvent =
+  GitHubWebhookPayload<"workflow-dispatch">
+
+/** GitHub deployment-created webhook payload. */
+export type GitHubDeploymentEvent = GitHubWebhookPayload<"deployment-created">
+
+/** GitHub deployment-status webhook payload. */
+export type GitHubDeploymentStatusEvent =
+  GitHubWebhookPayload<"deployment-status-created">
+export type GitHubDeploymentQueuedEvent = GitHubDeploymentStatusEvent & {
+  deployment_status: GitHubDeploymentStatusEvent["deployment_status"] & {
+    state: "queued"
+  }
+}
+export type GitHubDeploymentStartedEvent = GitHubDeploymentStatusEvent & {
+  deployment_status: GitHubDeploymentStatusEvent["deployment_status"] & {
+    state: "in_progress"
+  }
+}
+export type GitHubDeploymentPendingEvent = GitHubDeploymentStatusEvent & {
+  deployment_status: GitHubDeploymentStatusEvent["deployment_status"] & {
+    state: "pending"
+  }
+}
+export type GitHubDeploymentInactiveEvent = GitHubDeploymentStatusEvent & {
+  deployment_status: GitHubDeploymentStatusEvent["deployment_status"] & {
+    state: "inactive"
+  }
+}
+export type GitHubDeploymentSucceededEvent = GitHubDeploymentStatusEvent & {
+  deployment_status: GitHubDeploymentStatusEvent["deployment_status"] & {
+    state: "success"
+  }
+}
+export type GitHubDeploymentFailedEvent = GitHubDeploymentStatusEvent & {
+  deployment_status: GitHubDeploymentStatusEvent["deployment_status"] & {
+    state: "failure"
+  }
+}
+export type GitHubDeploymentErroredEvent = GitHubDeploymentStatusEvent & {
+  deployment_status: GitHubDeploymentStatusEvent["deployment_status"] & {
+    state: "error"
+  }
+}
+
+/** GitHub commit-status webhook payload. */
+export type GitHubStatusEvent = GitHubWebhookPayload<"status">
+export type GitHubStatusPendingEvent = GitHubStatusEvent & { state: "pending" }
+export type GitHubStatusSucceededEvent = GitHubStatusEvent & {
+  state: "success"
+}
+export type GitHubStatusFailedEvent = GitHubStatusEvent & { state: "failure" }
+export type GitHubStatusErroredEvent = GitHubStatusEvent & { state: "error" }
+
+const GITHUB_EVENT_BASE_SCHEMA = z.looseObject({
+  installation: z.looseObject({ id: z.number().int().positive() }),
+  repository: z.looseObject({
+    full_name: z.string(),
+    id: z.number().int().positive(),
+  }),
+  sender: z.looseObject({ id: z.number().int().positive(), login: z.string() }),
+})
+const GITHUB_CHECK_RUN_EVENT_BASE_SCHEMA = GITHUB_EVENT_BASE_SCHEMA.extend({
+  action: z.string(),
+  check_run: z.looseObject({
+    conclusion: z.string().nullable(),
+    id: z.number().int().positive(),
+    status: z.string(),
+  }),
+})
+const GITHUB_CHECK_SUITE_EVENT_BASE_SCHEMA = GITHUB_EVENT_BASE_SCHEMA.extend({
+  action: z.string(),
+  check_suite: z.looseObject({
+    conclusion: z.string().nullable(),
+    id: z.number().int().positive(),
+    status: z.string(),
+  }),
+})
+const GITHUB_REF_EVENT_BASE_SCHEMA = GITHUB_EVENT_BASE_SCHEMA.extend({
+  ref: z.string(),
+  ref_type: z.enum(["branch", "tag"]),
+})
+const GITHUB_ISSUE_COMMENT_EVENT_BASE_SCHEMA = GITHUB_EVENT_BASE_SCHEMA.extend({
+  action: z.string(),
+  comment: z.looseObject({ id: z.number().int().positive() }),
+  issue: z.looseObject({ id: z.number(), number: z.number().int() }),
+})
+const GITHUB_PULL_REQUEST_REVIEW_COMMENT_EVENT_BASE_SCHEMA =
+  GITHUB_EVENT_BASE_SCHEMA.extend({
+    action: z.string(),
+    comment: z.looseObject({ id: z.number().int().positive() }),
+    pull_request: z.looseObject({
+      id: z.number(),
+      number: z.number().int(),
+    }),
+  })
+const GITHUB_WORKFLOW_JOB_EVENT_BASE_SCHEMA = GITHUB_EVENT_BASE_SCHEMA.extend({
+  action: z.string(),
+  workflow_job: z.looseObject({
+    conclusion: z.string().nullable(),
+    id: z.number().int().positive(),
+    status: z.string(),
+  }),
+})
+const GITHUB_REPOSITORY_DISPATCH_EVENT_BASE_SCHEMA =
+  GITHUB_EVENT_BASE_SCHEMA.extend({
+    action: z.string(),
+    branch: z.string(),
+    client_payload: z.record(z.string(), z.json()).nullable(),
+  })
+const GITHUB_WORKFLOW_DISPATCH_EVENT_BASE_SCHEMA =
+  GITHUB_EVENT_BASE_SCHEMA.extend({
+    inputs: z.record(z.string(), z.json()).nullable(),
+    ref: z.string(),
+    workflow: z.string(),
+  })
+const GITHUB_DEPLOYMENT_EVENT_BASE_SCHEMA = GITHUB_EVENT_BASE_SCHEMA.extend({
+  action: z.literal("created"),
+  deployment: z.looseObject({ id: z.number().int().positive() }),
+})
+const GITHUB_DEPLOYMENT_STATUS_EVENT_BASE_SCHEMA =
+  GITHUB_EVENT_BASE_SCHEMA.extend({
+    action: z.literal("created"),
+    deployment: z.looseObject({ id: z.number().int().positive() }),
+    deployment_status: z.looseObject({
+      id: z.number().int().positive(),
+      state: z.string(),
+    }),
+  })
+const GITHUB_STATUS_EVENT_BASE_SCHEMA = GITHUB_EVENT_BASE_SCHEMA.extend({
+  context: z.string(),
+  sha: z.string(),
+  state: z.string(),
+})
+
+export const GITHUB_CHECK_RUN_EVENT_SCHEMA =
+  githubEventSchema<GitHubCheckRunEvent>(GITHUB_CHECK_RUN_EVENT_BASE_SCHEMA)
+export const GITHUB_CHECK_RUN_CREATED_EVENT_SCHEMA = githubSemanticEventSchema<
+  GitHubCheckRunEvent,
+  GitHubCheckRunCreatedEvent
+>(GITHUB_CHECK_RUN_EVENT_SCHEMA, (event) => event.action === "created")
+export const GITHUB_CHECK_RUN_COMPLETED_EVENT_SCHEMA =
+  githubSemanticEventSchema<GitHubCheckRunEvent, GitHubCheckRunCompletedEvent>(
+    GITHUB_CHECK_RUN_EVENT_SCHEMA,
+    (event) => event.action === "completed",
+  )
+export const GITHUB_CHECK_RUN_REREQUESTED_EVENT_SCHEMA =
+  githubSemanticEventSchema<
+    GitHubCheckRunEvent,
+    GitHubCheckRunRerequestedEvent
+  >(GITHUB_CHECK_RUN_EVENT_SCHEMA, (event) => event.action === "rerequested")
+export const GITHUB_CHECK_RUN_REQUESTED_ACTION_EVENT_SCHEMA =
+  githubSemanticEventSchema<
+    GitHubCheckRunEvent,
+    GitHubCheckRunRequestedActionEvent
+  >(
+    GITHUB_CHECK_RUN_EVENT_SCHEMA,
+    (event) => event.action === "requested_action",
+  )
+export const GITHUB_CHECK_RUN_SUCCEEDED_EVENT_SCHEMA =
+  githubSemanticEventSchema<GitHubCheckRunEvent, GitHubCheckRunSucceededEvent>(
+    GITHUB_CHECK_RUN_EVENT_SCHEMA,
+    (event) =>
+      event.action === "completed" && event.check_run.conclusion === "success",
+  )
+export const GITHUB_CHECK_RUN_FAILED_EVENT_SCHEMA = githubSemanticEventSchema<
+  GitHubCheckRunEvent,
+  GitHubCheckRunFailedEvent
+>(
+  GITHUB_CHECK_RUN_EVENT_SCHEMA,
+  (event) =>
+    event.action === "completed" && event.check_run.conclusion === "failure",
+)
+export const GITHUB_CHECK_RUN_CANCELLED_EVENT_SCHEMA =
+  githubSemanticEventSchema<GitHubCheckRunEvent, GitHubCheckRunCancelledEvent>(
+    GITHUB_CHECK_RUN_EVENT_SCHEMA,
+    (event) =>
+      event.action === "completed" &&
+      event.check_run.conclusion === "cancelled",
+  )
+export const GITHUB_CHECK_RUN_TIMED_OUT_EVENT_SCHEMA =
+  githubSemanticEventSchema<GitHubCheckRunEvent, GitHubCheckRunTimedOutEvent>(
+    GITHUB_CHECK_RUN_EVENT_SCHEMA,
+    (event) =>
+      event.action === "completed" &&
+      event.check_run.conclusion === "timed_out",
+  )
+export const GITHUB_CHECK_RUN_STARTUP_FAILED_EVENT_SCHEMA =
+  githubSemanticEventSchema<
+    GitHubCheckRunEvent,
+    GitHubCheckRunStartupFailedEvent
+  >(
+    GITHUB_CHECK_RUN_EVENT_SCHEMA,
+    (event) =>
+      event.action === "completed" &&
+      event.check_run.conclusion === "startup_failure",
+  )
+export const GITHUB_CHECK_RUN_ACTION_REQUIRED_EVENT_SCHEMA =
+  githubSemanticEventSchema<
+    GitHubCheckRunEvent,
+    GitHubCheckRunActionRequiredEvent
+  >(
+    GITHUB_CHECK_RUN_EVENT_SCHEMA,
+    (event) =>
+      event.action === "completed" &&
+      event.check_run.conclusion === "action_required",
+  )
+
+export const GITHUB_CHECK_SUITE_EVENT_SCHEMA =
+  githubEventSchema<GitHubCheckSuiteEvent>(GITHUB_CHECK_SUITE_EVENT_BASE_SCHEMA)
+export const GITHUB_CHECK_SUITE_COMPLETED_EVENT_SCHEMA =
+  githubSemanticEventSchema<
+    GitHubCheckSuiteEvent,
+    GitHubCheckSuiteCompletedEvent
+  >(GITHUB_CHECK_SUITE_EVENT_SCHEMA, (event) => event.action === "completed")
+export const GITHUB_CHECK_SUITE_REQUESTED_EVENT_SCHEMA =
+  githubSemanticEventSchema<
+    GitHubCheckSuiteEvent,
+    GitHubCheckSuiteRequestedEvent
+  >(GITHUB_CHECK_SUITE_EVENT_SCHEMA, (event) => event.action === "requested")
+export const GITHUB_CHECK_SUITE_REREQUESTED_EVENT_SCHEMA =
+  githubSemanticEventSchema<
+    GitHubCheckSuiteEvent,
+    GitHubCheckSuiteRerequestedEvent
+  >(GITHUB_CHECK_SUITE_EVENT_SCHEMA, (event) => event.action === "rerequested")
+export const GITHUB_CHECK_SUITE_SUCCEEDED_EVENT_SCHEMA =
+  githubSemanticEventSchema<
+    GitHubCheckSuiteEvent,
+    GitHubCheckSuiteSucceededEvent
+  >(
+    GITHUB_CHECK_SUITE_EVENT_SCHEMA,
+    (event) =>
+      event.action === "completed" &&
+      event.check_suite.conclusion === "success",
+  )
+export const GITHUB_CHECK_SUITE_FAILED_EVENT_SCHEMA = githubSemanticEventSchema<
+  GitHubCheckSuiteEvent,
+  GitHubCheckSuiteFailedEvent
+>(
+  GITHUB_CHECK_SUITE_EVENT_SCHEMA,
+  (event) =>
+    event.action === "completed" && event.check_suite.conclusion === "failure",
+)
+export const GITHUB_CHECK_SUITE_CANCELLED_EVENT_SCHEMA =
+  githubSemanticEventSchema<
+    GitHubCheckSuiteEvent,
+    GitHubCheckSuiteCancelledEvent
+  >(
+    GITHUB_CHECK_SUITE_EVENT_SCHEMA,
+    (event) =>
+      event.action === "completed" &&
+      event.check_suite.conclusion === "cancelled",
+  )
+export const GITHUB_CHECK_SUITE_TIMED_OUT_EVENT_SCHEMA =
+  githubSemanticEventSchema<
+    GitHubCheckSuiteEvent,
+    GitHubCheckSuiteTimedOutEvent
+  >(
+    GITHUB_CHECK_SUITE_EVENT_SCHEMA,
+    (event) =>
+      event.action === "completed" &&
+      event.check_suite.conclusion === "timed_out",
+  )
+export const GITHUB_CHECK_SUITE_STARTUP_FAILED_EVENT_SCHEMA =
+  githubSemanticEventSchema<
+    GitHubCheckSuiteEvent,
+    GitHubCheckSuiteStartupFailedEvent
+  >(
+    GITHUB_CHECK_SUITE_EVENT_SCHEMA,
+    (event) =>
+      event.action === "completed" &&
+      event.check_suite.conclusion === "startup_failure",
+  )
+export const GITHUB_CHECK_SUITE_ACTION_REQUIRED_EVENT_SCHEMA =
+  githubSemanticEventSchema<
+    GitHubCheckSuiteEvent,
+    GitHubCheckSuiteActionRequiredEvent
+  >(
+    GITHUB_CHECK_SUITE_EVENT_SCHEMA,
+    (event) =>
+      event.action === "completed" &&
+      event.check_suite.conclusion === "action_required",
+  )
+
+export const GITHUB_REF_CREATED_EVENT_SCHEMA =
+  githubEventSchema<GitHubRefCreatedEvent>(GITHUB_REF_EVENT_BASE_SCHEMA)
+export const GITHUB_BRANCH_CREATED_EVENT_SCHEMA = githubSemanticEventSchema<
+  GitHubRefCreatedEvent,
+  GitHubBranchCreatedEvent
+>(GITHUB_REF_CREATED_EVENT_SCHEMA, (event) => event.ref_type === "branch")
+export const GITHUB_TAG_CREATED_EVENT_SCHEMA = githubSemanticEventSchema<
+  GitHubRefCreatedEvent,
+  GitHubTagCreatedEvent
+>(GITHUB_REF_CREATED_EVENT_SCHEMA, (event) => event.ref_type === "tag")
+export const GITHUB_REF_DELETED_EVENT_SCHEMA =
+  githubEventSchema<GitHubRefDeletedEvent>(GITHUB_REF_EVENT_BASE_SCHEMA)
+export const GITHUB_BRANCH_DELETED_EVENT_SCHEMA = githubSemanticEventSchema<
+  GitHubRefDeletedEvent,
+  GitHubBranchDeletedEvent
+>(GITHUB_REF_DELETED_EVENT_SCHEMA, (event) => event.ref_type === "branch")
+export const GITHUB_TAG_DELETED_EVENT_SCHEMA = githubSemanticEventSchema<
+  GitHubRefDeletedEvent,
+  GitHubTagDeletedEvent
+>(GITHUB_REF_DELETED_EVENT_SCHEMA, (event) => event.ref_type === "tag")
+
+export const GITHUB_ISSUE_COMMENT_EVENT_SCHEMA =
+  githubEventSchema<GitHubIssueCommentEvent>(
+    GITHUB_ISSUE_COMMENT_EVENT_BASE_SCHEMA,
+  )
+export const GITHUB_ISSUE_COMMENT_CREATED_EVENT_SCHEMA =
+  githubSemanticEventSchema<
+    GitHubIssueCommentEvent,
+    GitHubIssueCommentCreatedEvent
+  >(GITHUB_ISSUE_COMMENT_EVENT_SCHEMA, (event) => event.action === "created")
+export const GITHUB_ISSUE_COMMENT_EDITED_EVENT_SCHEMA =
+  githubSemanticEventSchema<
+    GitHubIssueCommentEvent,
+    GitHubIssueCommentEditedEvent
+  >(GITHUB_ISSUE_COMMENT_EVENT_SCHEMA, (event) => event.action === "edited")
+export const GITHUB_ISSUE_COMMENT_DELETED_EVENT_SCHEMA =
+  githubSemanticEventSchema<
+    GitHubIssueCommentEvent,
+    GitHubIssueCommentDeletedEvent
+  >(GITHUB_ISSUE_COMMENT_EVENT_SCHEMA, (event) => event.action === "deleted")
+
+export const GITHUB_PULL_REQUEST_REVIEW_COMMENT_EVENT_SCHEMA =
+  githubEventSchema<GitHubPullRequestReviewCommentEvent>(
+    GITHUB_PULL_REQUEST_REVIEW_COMMENT_EVENT_BASE_SCHEMA,
+  )
+export const GITHUB_PULL_REQUEST_REVIEW_COMMENT_CREATED_EVENT_SCHEMA =
+  githubSemanticEventSchema<
+    GitHubPullRequestReviewCommentEvent,
+    GitHubPullRequestReviewCommentCreatedEvent
+  >(
+    GITHUB_PULL_REQUEST_REVIEW_COMMENT_EVENT_SCHEMA,
+    (event) => event.action === "created",
+  )
+export const GITHUB_PULL_REQUEST_REVIEW_COMMENT_EDITED_EVENT_SCHEMA =
+  githubSemanticEventSchema<
+    GitHubPullRequestReviewCommentEvent,
+    GitHubPullRequestReviewCommentEditedEvent
+  >(
+    GITHUB_PULL_REQUEST_REVIEW_COMMENT_EVENT_SCHEMA,
+    (event) => event.action === "edited",
+  )
+export const GITHUB_PULL_REQUEST_REVIEW_COMMENT_DELETED_EVENT_SCHEMA =
+  githubSemanticEventSchema<
+    GitHubPullRequestReviewCommentEvent,
+    GitHubPullRequestReviewCommentDeletedEvent
+  >(
+    GITHUB_PULL_REQUEST_REVIEW_COMMENT_EVENT_SCHEMA,
+    (event) => event.action === "deleted",
+  )
+
+export const GITHUB_WORKFLOW_JOB_EVENT_SCHEMA =
+  githubEventSchema<GitHubWorkflowJobEvent>(
+    GITHUB_WORKFLOW_JOB_EVENT_BASE_SCHEMA,
+  )
+export const GITHUB_WORKFLOW_JOB_QUEUED_EVENT_SCHEMA =
+  githubSemanticEventSchema<
+    GitHubWorkflowJobEvent,
+    GitHubWorkflowJobQueuedEvent
+  >(GITHUB_WORKFLOW_JOB_EVENT_SCHEMA, (event) => event.action === "queued")
+export const GITHUB_WORKFLOW_JOB_STARTED_EVENT_SCHEMA =
+  githubSemanticEventSchema<
+    GitHubWorkflowJobEvent,
+    GitHubWorkflowJobStartedEvent
+  >(GITHUB_WORKFLOW_JOB_EVENT_SCHEMA, (event) => event.action === "in_progress")
+export const GITHUB_WORKFLOW_JOB_WAITING_EVENT_SCHEMA =
+  githubSemanticEventSchema<
+    GitHubWorkflowJobEvent,
+    GitHubWorkflowJobWaitingEvent
+  >(GITHUB_WORKFLOW_JOB_EVENT_SCHEMA, (event) => event.action === "waiting")
+export const GITHUB_WORKFLOW_JOB_COMPLETED_EVENT_SCHEMA =
+  githubSemanticEventSchema<
+    GitHubWorkflowJobEvent,
+    GitHubWorkflowJobCompletedEvent
+  >(GITHUB_WORKFLOW_JOB_EVENT_SCHEMA, (event) => event.action === "completed")
+export const GITHUB_WORKFLOW_JOB_SUCCEEDED_EVENT_SCHEMA =
+  githubSemanticEventSchema<
+    GitHubWorkflowJobEvent,
+    GitHubWorkflowJobSucceededEvent
+  >(
+    GITHUB_WORKFLOW_JOB_EVENT_SCHEMA,
+    (event) =>
+      event.action === "completed" &&
+      event.workflow_job.conclusion === "success",
+  )
+export const GITHUB_WORKFLOW_JOB_FAILED_EVENT_SCHEMA =
+  githubSemanticEventSchema<
+    GitHubWorkflowJobEvent,
+    GitHubWorkflowJobFailedEvent
+  >(
+    GITHUB_WORKFLOW_JOB_EVENT_SCHEMA,
+    (event) =>
+      event.action === "completed" &&
+      event.workflow_job.conclusion === "failure",
+  )
+export const GITHUB_WORKFLOW_JOB_CANCELLED_EVENT_SCHEMA =
+  githubSemanticEventSchema<
+    GitHubWorkflowJobEvent,
+    GitHubWorkflowJobCancelledEvent
+  >(
+    GITHUB_WORKFLOW_JOB_EVENT_SCHEMA,
+    (event) =>
+      event.action === "completed" &&
+      event.workflow_job.conclusion === "cancelled",
+  )
+export const GITHUB_WORKFLOW_JOB_TIMED_OUT_EVENT_SCHEMA =
+  githubSemanticEventSchema<
+    GitHubWorkflowJobEvent,
+    GitHubWorkflowJobTimedOutEvent
+  >(
+    GITHUB_WORKFLOW_JOB_EVENT_SCHEMA,
+    (event) =>
+      event.action === "completed" &&
+      event.workflow_job.conclusion === "timed_out",
+  )
+
+export const GITHUB_REPOSITORY_DISPATCH_EVENT_SCHEMA =
+  githubEventSchema<GitHubRepositoryDispatchEvent>(
+    GITHUB_REPOSITORY_DISPATCH_EVENT_BASE_SCHEMA,
+  )
+export const GITHUB_WORKFLOW_DISPATCH_EVENT_SCHEMA =
+  githubEventSchema<GitHubWorkflowDispatchEvent>(
+    GITHUB_WORKFLOW_DISPATCH_EVENT_BASE_SCHEMA,
+  )
+export const GITHUB_DEPLOYMENT_EVENT_SCHEMA =
+  githubEventSchema<GitHubDeploymentEvent>(GITHUB_DEPLOYMENT_EVENT_BASE_SCHEMA)
+export const GITHUB_DEPLOYMENT_STATUS_EVENT_SCHEMA =
+  githubEventSchema<GitHubDeploymentStatusEvent>(
+    GITHUB_DEPLOYMENT_STATUS_EVENT_BASE_SCHEMA,
+  )
+export const GITHUB_DEPLOYMENT_QUEUED_EVENT_SCHEMA = githubSemanticEventSchema<
+  GitHubDeploymentStatusEvent,
+  GitHubDeploymentQueuedEvent
+>(
+  GITHUB_DEPLOYMENT_STATUS_EVENT_SCHEMA,
+  (event) => event.deployment_status.state === "queued",
+)
+export const GITHUB_DEPLOYMENT_STARTED_EVENT_SCHEMA = githubSemanticEventSchema<
+  GitHubDeploymentStatusEvent,
+  GitHubDeploymentStartedEvent
+>(
+  GITHUB_DEPLOYMENT_STATUS_EVENT_SCHEMA,
+  (event) => event.deployment_status.state === "in_progress",
+)
+export const GITHUB_DEPLOYMENT_PENDING_EVENT_SCHEMA = githubSemanticEventSchema<
+  GitHubDeploymentStatusEvent,
+  GitHubDeploymentPendingEvent
+>(
+  GITHUB_DEPLOYMENT_STATUS_EVENT_SCHEMA,
+  (event) => event.deployment_status.state === "pending",
+)
+export const GITHUB_DEPLOYMENT_INACTIVE_EVENT_SCHEMA =
+  githubSemanticEventSchema<
+    GitHubDeploymentStatusEvent,
+    GitHubDeploymentInactiveEvent
+  >(
+    GITHUB_DEPLOYMENT_STATUS_EVENT_SCHEMA,
+    (event) => event.deployment_status.state === "inactive",
+  )
+export const GITHUB_DEPLOYMENT_SUCCEEDED_EVENT_SCHEMA =
+  githubSemanticEventSchema<
+    GitHubDeploymentStatusEvent,
+    GitHubDeploymentSucceededEvent
+  >(
+    GITHUB_DEPLOYMENT_STATUS_EVENT_SCHEMA,
+    (event) => event.deployment_status.state === "success",
+  )
+export const GITHUB_DEPLOYMENT_FAILED_EVENT_SCHEMA = githubSemanticEventSchema<
+  GitHubDeploymentStatusEvent,
+  GitHubDeploymentFailedEvent
+>(
+  GITHUB_DEPLOYMENT_STATUS_EVENT_SCHEMA,
+  (event) => event.deployment_status.state === "failure",
+)
+export const GITHUB_DEPLOYMENT_ERRORED_EVENT_SCHEMA = githubSemanticEventSchema<
+  GitHubDeploymentStatusEvent,
+  GitHubDeploymentErroredEvent
+>(
+  GITHUB_DEPLOYMENT_STATUS_EVENT_SCHEMA,
+  (event) => event.deployment_status.state === "error",
+)
+
+export const GITHUB_STATUS_EVENT_SCHEMA = githubEventSchema<GitHubStatusEvent>(
+  GITHUB_STATUS_EVENT_BASE_SCHEMA,
+)
+export const GITHUB_STATUS_PENDING_EVENT_SCHEMA = githubSemanticEventSchema<
+  GitHubStatusEvent,
+  GitHubStatusPendingEvent
+>(GITHUB_STATUS_EVENT_SCHEMA, (event) => event.state === "pending")
+export const GITHUB_STATUS_SUCCEEDED_EVENT_SCHEMA = githubSemanticEventSchema<
+  GitHubStatusEvent,
+  GitHubStatusSucceededEvent
+>(GITHUB_STATUS_EVENT_SCHEMA, (event) => event.state === "success")
+export const GITHUB_STATUS_FAILED_EVENT_SCHEMA = githubSemanticEventSchema<
+  GitHubStatusEvent,
+  GitHubStatusFailedEvent
+>(GITHUB_STATUS_EVENT_SCHEMA, (event) => event.state === "failure")
+export const GITHUB_STATUS_ERRORED_EVENT_SCHEMA = githubSemanticEventSchema<
+  GitHubStatusEvent,
+  GitHubStatusErroredEvent
+>(GITHUB_STATUS_EVENT_SCHEMA, (event) => event.state === "error")
+
+/**
+ * Validates a typed GitHub webhook family.
+ *
+ * @param schema - Runtime schema for the webhook family.
+ */
+function githubEventSchema<TEvent>(schema: z.ZodType): z.ZodType<TEvent> {
+  return z.custom<TEvent>((value) => schema.safeParse(value).success)
+}
+
+/**
+ * Narrows a broad GitHub webhook family to one semantic event.
+ *
+ * @param schema - Runtime schema for the broad webhook family.
+ * @param matches - Whether the payload belongs to the semantic event.
+ */
+function githubSemanticEventSchema<TEvent, TSemanticEvent extends TEvent>(
+  schema: z.ZodType<TEvent>,
+  matches: (event: TEvent) => boolean,
+): z.ZodType<TSemanticEvent> {
+  return z.custom<TSemanticEvent>((value) => {
+    const event = schema.safeParse(value)
+    return event.success && matches(event.data)
+  })
+}