@automate.ax/integration-contracts 0.55.0

package/src/github/index.ts

@@ -0,0 +1,217 @@
+import { z } from "zod"
+import {
+  GITHUB_ISSUE_CLOSED_EVENT_SCHEMA,
+  GITHUB_ISSUE_EVENT_SCHEMA,
+  GITHUB_ISSUE_OPENED_EVENT_SCHEMA,
+  GITHUB_ISSUE_REOPENED_EVENT_SCHEMA,
+  GITHUB_PULL_REQUEST_CLOSED_EVENT_SCHEMA,
+  GITHUB_PULL_REQUEST_EVENT_SCHEMA,
+  GITHUB_PULL_REQUEST_MERGED_EVENT_SCHEMA,
+  GITHUB_PULL_REQUEST_OPENED_EVENT_SCHEMA,
+  GITHUB_PULL_REQUEST_READY_FOR_REVIEW_EVENT_SCHEMA,
+  GITHUB_PULL_REQUEST_REVIEW_APPROVED_EVENT_SCHEMA,
+  GITHUB_PULL_REQUEST_REVIEW_CHANGES_REQUESTED_EVENT_SCHEMA,
+  GITHUB_PULL_REQUEST_REVIEW_DISMISSED_EVENT_SCHEMA,
+  GITHUB_PULL_REQUEST_REVIEW_EVENT_SCHEMA,
+  GITHUB_PULL_REQUEST_REVIEW_SUBMITTED_EVENT_SCHEMA,
+  GITHUB_PULL_REQUEST_SYNCHRONIZED_EVENT_SCHEMA,
+  GITHUB_PUSH_EVENT_SCHEMA,
+  GITHUB_RELEASE_EVENT_SCHEMA,
+  GITHUB_RELEASE_PUBLISHED_EVENT_SCHEMA,
+  GITHUB_WORKFLOW_RUN_CANCELLED_EVENT_SCHEMA,
+  GITHUB_WORKFLOW_RUN_COMPLETED_EVENT_SCHEMA,
+  GITHUB_WORKFLOW_RUN_EVENT_SCHEMA,
+  GITHUB_WORKFLOW_RUN_FAILED_EVENT_SCHEMA,
+  GITHUB_WORKFLOW_RUN_REQUESTED_EVENT_SCHEMA,
+  GITHUB_WORKFLOW_RUN_STARTED_EVENT_SCHEMA,
+  GITHUB_WORKFLOW_RUN_SUCCEEDED_EVENT_SCHEMA,
+} from "./schemas"
+
+export * from "./schemas"
+
+export const GITHUB_TRIGGER_CONFIG_SCHEMA = z.object({})
+
+type GitHubTriggerContract<TEventSchema> = {
+  readonly configSchema: typeof GITHUB_TRIGGER_CONFIG_SCHEMA
+  readonly eventSchema: TEventSchema
+}
+
+/** Named registry shape keeps declaration emit within its serialization limit. */
+type GitHubTriggerContracts = {
+  readonly "github.issue.closed": GitHubTriggerContract<
+    typeof GITHUB_ISSUE_CLOSED_EVENT_SCHEMA
+  >
+  readonly "github.issue.event": GitHubTriggerContract<
+    typeof GITHUB_ISSUE_EVENT_SCHEMA
+  >
+  readonly "github.issue.opened": GitHubTriggerContract<
+    typeof GITHUB_ISSUE_OPENED_EVENT_SCHEMA
+  >
+  readonly "github.issue.reopened": GitHubTriggerContract<
+    typeof GITHUB_ISSUE_REOPENED_EVENT_SCHEMA
+  >
+  readonly "github.pull-request.closed": GitHubTriggerContract<
+    typeof GITHUB_PULL_REQUEST_CLOSED_EVENT_SCHEMA
+  >
+  readonly "github.pull-request.event": GitHubTriggerContract<
+    typeof GITHUB_PULL_REQUEST_EVENT_SCHEMA
+  >
+  readonly "github.pull-request.merged": GitHubTriggerContract<
+    typeof GITHUB_PULL_REQUEST_MERGED_EVENT_SCHEMA
+  >
+  readonly "github.pull-request.opened": GitHubTriggerContract<
+    typeof GITHUB_PULL_REQUEST_OPENED_EVENT_SCHEMA
+  >
+  readonly "github.pull-request.ready-for-review": GitHubTriggerContract<
+    typeof GITHUB_PULL_REQUEST_READY_FOR_REVIEW_EVENT_SCHEMA
+  >
+  readonly "github.pull-request-review.approved": GitHubTriggerContract<
+    typeof GITHUB_PULL_REQUEST_REVIEW_APPROVED_EVENT_SCHEMA
+  >
+  readonly "github.pull-request-review.changes-requested": GitHubTriggerContract<
+    typeof GITHUB_PULL_REQUEST_REVIEW_CHANGES_REQUESTED_EVENT_SCHEMA
+  >
+  readonly "github.pull-request-review.dismissed": GitHubTriggerContract<
+    typeof GITHUB_PULL_REQUEST_REVIEW_DISMISSED_EVENT_SCHEMA
+  >
+  readonly "github.pull-request-review.event": GitHubTriggerContract<
+    typeof GITHUB_PULL_REQUEST_REVIEW_EVENT_SCHEMA
+  >
+  readonly "github.pull-request-review.submitted": GitHubTriggerContract<
+    typeof GITHUB_PULL_REQUEST_REVIEW_SUBMITTED_EVENT_SCHEMA
+  >
+  readonly "github.pull-request.synchronized": GitHubTriggerContract<
+    typeof GITHUB_PULL_REQUEST_SYNCHRONIZED_EVENT_SCHEMA
+  >
+  readonly "github.push": GitHubTriggerContract<typeof GITHUB_PUSH_EVENT_SCHEMA>
+  readonly "github.release.event": GitHubTriggerContract<
+    typeof GITHUB_RELEASE_EVENT_SCHEMA
+  >
+  readonly "github.release.published": GitHubTriggerContract<
+    typeof GITHUB_RELEASE_PUBLISHED_EVENT_SCHEMA
+  >
+  readonly "github.workflow-run.cancelled": GitHubTriggerContract<
+    typeof GITHUB_WORKFLOW_RUN_CANCELLED_EVENT_SCHEMA
+  >
+  readonly "github.workflow-run.completed": GitHubTriggerContract<
+    typeof GITHUB_WORKFLOW_RUN_COMPLETED_EVENT_SCHEMA
+  >
+  readonly "github.workflow-run.event": GitHubTriggerContract<
+    typeof GITHUB_WORKFLOW_RUN_EVENT_SCHEMA
+  >
+  readonly "github.workflow-run.failed": GitHubTriggerContract<
+    typeof GITHUB_WORKFLOW_RUN_FAILED_EVENT_SCHEMA
+  >
+  readonly "github.workflow-run.requested": GitHubTriggerContract<
+    typeof GITHUB_WORKFLOW_RUN_REQUESTED_EVENT_SCHEMA
+  >
+  readonly "github.workflow-run.started": GitHubTriggerContract<
+    typeof GITHUB_WORKFLOW_RUN_STARTED_EVENT_SCHEMA
+  >
+  readonly "github.workflow-run.succeeded": GitHubTriggerContract<
+    typeof GITHUB_WORKFLOW_RUN_SUCCEEDED_EVENT_SCHEMA
+  >
+}
+
+export const githubTriggerContracts: GitHubTriggerContracts = {
+  "github.issue.closed": {
+    configSchema: GITHUB_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: GITHUB_ISSUE_CLOSED_EVENT_SCHEMA,
+  },
+  "github.issue.event": {
+    configSchema: GITHUB_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: GITHUB_ISSUE_EVENT_SCHEMA,
+  },
+  "github.issue.opened": {
+    configSchema: GITHUB_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: GITHUB_ISSUE_OPENED_EVENT_SCHEMA,
+  },
+  "github.issue.reopened": {
+    configSchema: GITHUB_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: GITHUB_ISSUE_REOPENED_EVENT_SCHEMA,
+  },
+  "github.pull-request.closed": {
+    configSchema: GITHUB_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: GITHUB_PULL_REQUEST_CLOSED_EVENT_SCHEMA,
+  },
+  "github.pull-request.event": {
+    configSchema: GITHUB_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: GITHUB_PULL_REQUEST_EVENT_SCHEMA,
+  },
+  "github.pull-request.merged": {
+    configSchema: GITHUB_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: GITHUB_PULL_REQUEST_MERGED_EVENT_SCHEMA,
+  },
+  "github.pull-request.opened": {
+    configSchema: GITHUB_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: GITHUB_PULL_REQUEST_OPENED_EVENT_SCHEMA,
+  },
+  "github.pull-request.ready-for-review": {
+    configSchema: GITHUB_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: GITHUB_PULL_REQUEST_READY_FOR_REVIEW_EVENT_SCHEMA,
+  },
+  "github.pull-request-review.approved": {
+    configSchema: GITHUB_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: GITHUB_PULL_REQUEST_REVIEW_APPROVED_EVENT_SCHEMA,
+  },
+  "github.pull-request-review.changes-requested": {
+    configSchema: GITHUB_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: GITHUB_PULL_REQUEST_REVIEW_CHANGES_REQUESTED_EVENT_SCHEMA,
+  },
+  "github.pull-request-review.dismissed": {
+    configSchema: GITHUB_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: GITHUB_PULL_REQUEST_REVIEW_DISMISSED_EVENT_SCHEMA,
+  },
+  "github.pull-request-review.event": {
+    configSchema: GITHUB_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: GITHUB_PULL_REQUEST_REVIEW_EVENT_SCHEMA,
+  },
+  "github.pull-request-review.submitted": {
+    configSchema: GITHUB_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: GITHUB_PULL_REQUEST_REVIEW_SUBMITTED_EVENT_SCHEMA,
+  },
+  "github.pull-request.synchronized": {
+    configSchema: GITHUB_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: GITHUB_PULL_REQUEST_SYNCHRONIZED_EVENT_SCHEMA,
+  },
+  "github.push": {
+    configSchema: GITHUB_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: GITHUB_PUSH_EVENT_SCHEMA,
+  },
+  "github.release.event": {
+    configSchema: GITHUB_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: GITHUB_RELEASE_EVENT_SCHEMA,
+  },
+  "github.release.published": {
+    configSchema: GITHUB_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: GITHUB_RELEASE_PUBLISHED_EVENT_SCHEMA,
+  },
+  "github.workflow-run.cancelled": {
+    configSchema: GITHUB_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: GITHUB_WORKFLOW_RUN_CANCELLED_EVENT_SCHEMA,
+  },
+  "github.workflow-run.completed": {
+    configSchema: GITHUB_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: GITHUB_WORKFLOW_RUN_COMPLETED_EVENT_SCHEMA,
+  },
+  "github.workflow-run.event": {
+    configSchema: GITHUB_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: GITHUB_WORKFLOW_RUN_EVENT_SCHEMA,
+  },
+  "github.workflow-run.failed": {
+    configSchema: GITHUB_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: GITHUB_WORKFLOW_RUN_FAILED_EVENT_SCHEMA,
+  },
+  "github.workflow-run.requested": {
+    configSchema: GITHUB_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: GITHUB_WORKFLOW_RUN_REQUESTED_EVENT_SCHEMA,
+  },
+  "github.workflow-run.started": {
+    configSchema: GITHUB_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: GITHUB_WORKFLOW_RUN_STARTED_EVENT_SCHEMA,
+  },
+  "github.workflow-run.succeeded": {
+    configSchema: GITHUB_TRIGGER_CONFIG_SCHEMA,
+    eventSchema: GITHUB_WORKFLOW_RUN_SUCCEEDED_EVENT_SCHEMA,
+  },
+}

package/src/github/schemas.ts

@@ -0,0 +1,435 @@
+import type { Encodable } from "@automate.ax/codec"
+import type { webhooks } from "@octokit/openapi-webhooks-types"
+import type { Octokit } from "@octokit/rest"
+import { z } from "zod"
+
+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_ISSUE_EVENT_BASE_SCHEMA = GITHUB_EVENT_BASE_SCHEMA.extend({
+  action: z.string(),
+  issue: z.looseObject({ id: z.number(), number: z.number().int() }),
+})
+const GITHUB_PULL_REQUEST_EVENT_BASE_SCHEMA = GITHUB_EVENT_BASE_SCHEMA.extend({
+  action: z.string(),
+  pull_request: z.looseObject({
+    id: z.number(),
+    merged: z.boolean(),
+    number: z.number().int(),
+  }),
+})
+const GITHUB_PULL_REQUEST_REVIEW_EVENT_BASE_SCHEMA =
+  GITHUB_PULL_REQUEST_EVENT_BASE_SCHEMA.extend({
+    review: z.looseObject({ id: z.number() }),
+  })
+const GITHUB_PUSH_EVENT_BASE_SCHEMA = GITHUB_EVENT_BASE_SCHEMA.extend({
+  after: z.string(),
+  before: z.string(),
+  ref: z.string(),
+})
+const GITHUB_RELEASE_EVENT_BASE_SCHEMA = GITHUB_EVENT_BASE_SCHEMA.extend({
+  action: z.string(),
+  release: z.looseObject({ id: z.number(), tag_name: z.string() }),
+})
+const GITHUB_WORKFLOW_RUN_EVENT_BASE_SCHEMA = GITHUB_EVENT_BASE_SCHEMA.extend({
+  action: z.string(),
+  workflow_run: z.looseObject({
+    conclusion: z.string().nullable(),
+    id: z.number(),
+  }),
+})
+const GITHUB_ISSUE_BASE_SCHEMA = z.looseObject({
+  id: z.number(),
+  number: z.number().int(),
+  title: z.string(),
+})
+const GITHUB_PULL_REQUEST_BASE_SCHEMA = GITHUB_ISSUE_BASE_SCHEMA.extend({
+  head: z.looseObject({ ref: z.string(), sha: z.string() }),
+})
+const GITHUB_ISSUE_COMMENT_BASE_SCHEMA = z.looseObject({
+  body: z.string().nullable(),
+  id: z.number(),
+})
+const GITHUB_PULL_REQUEST_REVIEW_BASE_SCHEMA = z.looseObject({
+  id: z.number(),
+  state: z.string(),
+})
+
+type GitHubWebhookPayload<TKey extends keyof webhooks> =
+  webhooks[TKey]["post"] extends {
+    requestBody: {
+      content: { "application/json": infer TPayload }
+    }
+  }
+    ? TPayload & Record<string, Encodable>
+    : never
+
+/** Official GitHub issue webhook payload union. */
+export type GitHubIssueEvent = GitHubWebhookPayload<
+  Extract<keyof webhooks, `issues-${string}`>
+>
+
+/** Official GitHub pull request webhook payload union. */
+export type GitHubPullRequestEvent = GitHubWebhookPayload<
+  Extract<keyof webhooks, `pull-request-${string}`>
+>
+
+/** Official GitHub pull request review webhook payload union. */
+export type GitHubPullRequestReviewEvent = GitHubWebhookPayload<
+  Extract<keyof webhooks, `pull-request-review-${string}`>
+>
+
+/** Official GitHub push webhook payload. */
+export type GitHubPushEvent = GitHubWebhookPayload<"push">
+
+/** Official GitHub release webhook payload union. */
+export type GitHubReleaseEvent = GitHubWebhookPayload<
+  Extract<keyof webhooks, `release-${string}`>
+>
+
+/** Official GitHub workflow run webhook payload union. */
+export type GitHubWorkflowRunEvent = GitHubWebhookPayload<
+  Extract<keyof webhooks, `workflow-run-${string}`>
+>
+
+/** GitHub issue-opened webhook payload. */
+export type GitHubIssueOpenedEvent = GitHubWebhookPayload<"issues-opened">
+
+/** GitHub issue-reopened webhook payload. */
+export type GitHubIssueReopenedEvent = GitHubWebhookPayload<"issues-reopened">
+
+/** GitHub issue-closed webhook payload. */
+export type GitHubIssueClosedEvent = GitHubWebhookPayload<"issues-closed">
+
+/** GitHub pull-request-opened webhook payload. */
+export type GitHubPullRequestOpenedEvent =
+  GitHubWebhookPayload<"pull-request-opened">
+
+/** GitHub pull-request-ready-for-review webhook payload. */
+export type GitHubPullRequestReadyForReviewEvent =
+  GitHubWebhookPayload<"pull-request-ready-for-review">
+
+/** GitHub pull-request-synchronize webhook payload. */
+export type GitHubPullRequestSynchronizedEvent =
+  GitHubWebhookPayload<"pull-request-synchronize">
+
+/** GitHub unmerged pull-request-closed webhook payload. */
+export type GitHubPullRequestClosedEvent =
+  GitHubWebhookPayload<"pull-request-closed"> & {
+    pull_request: GitHubWebhookPayload<"pull-request-closed">["pull_request"] & {
+      merged: false
+    }
+  }
+
+/** GitHub merged pull-request-closed webhook payload. */
+export type GitHubPullRequestMergedEvent =
+  GitHubWebhookPayload<"pull-request-closed"> & {
+    pull_request: GitHubWebhookPayload<"pull-request-closed">["pull_request"] & {
+      merged: true
+    }
+  }
+
+/** GitHub pull-request-review-submitted webhook payload. */
+export type GitHubPullRequestReviewSubmittedEvent =
+  GitHubWebhookPayload<"pull-request-review-submitted">
+
+/** Submitted GitHub pull request review with an approved state. */
+export type GitHubPullRequestReviewApprovedEvent =
+  GitHubPullRequestReviewSubmittedEvent & {
+    review: GitHubPullRequestReviewSubmittedEvent["review"] & {
+      state: "approved"
+    }
+  }
+
+/** Submitted GitHub pull request review requesting changes. */
+export type GitHubPullRequestReviewChangesRequestedEvent =
+  GitHubPullRequestReviewSubmittedEvent & {
+    review: GitHubPullRequestReviewSubmittedEvent["review"] & {
+      state: "changes_requested"
+    }
+  }
+
+/** GitHub pull-request-review-dismissed webhook payload. */
+export type GitHubPullRequestReviewDismissedEvent =
+  GitHubWebhookPayload<"pull-request-review-dismissed">
+
+/** GitHub workflow-run-requested webhook payload. */
+export type GitHubWorkflowRunRequestedEvent =
+  GitHubWebhookPayload<"workflow-run-requested">
+
+/** GitHub workflow-run-in-progress webhook payload. */
+export type GitHubWorkflowRunStartedEvent =
+  GitHubWebhookPayload<"workflow-run-in-progress">
+
+/** GitHub workflow-run-completed webhook payload. */
+export type GitHubWorkflowRunCompletedEvent =
+  GitHubWebhookPayload<"workflow-run-completed">
+
+/** Completed GitHub workflow run with a successful conclusion. */
+export type GitHubWorkflowRunSucceededEvent =
+  GitHubWorkflowRunCompletedEvent & {
+    workflow_run: GitHubWorkflowRunCompletedEvent["workflow_run"] & {
+      conclusion: "success"
+    }
+  }
+
+/** Completed GitHub workflow run with a failure conclusion. */
+export type GitHubWorkflowRunFailedEvent = GitHubWorkflowRunCompletedEvent & {
+  workflow_run: GitHubWorkflowRunCompletedEvent["workflow_run"] & {
+    conclusion: "failure"
+  }
+}
+
+/** Completed GitHub workflow run with a cancelled conclusion. */
+export type GitHubWorkflowRunCancelledEvent =
+  GitHubWorkflowRunCompletedEvent & {
+    workflow_run: GitHubWorkflowRunCompletedEvent["workflow_run"] & {
+      conclusion: "cancelled"
+    }
+  }
+
+/** GitHub release-published webhook payload. */
+export type GitHubReleasePublishedEvent =
+  GitHubWebhookPayload<"release-published">
+
+/** Octokit issue response kept aligned with the installed SDK version. */
+type GitHubIssue = Awaited<
+  ReturnType<Octokit["rest"]["issues"]["get"]>
+>["data"] &
+  Encodable
+
+/** Octokit pull request response kept aligned with the installed SDK version. */
+type GitHubPullRequest = Awaited<
+  ReturnType<Octokit["rest"]["pulls"]["get"]>
+>["data"] &
+  Encodable
+
+/** Octokit pull request list item kept aligned with the installed SDK version. */
+type GitHubPullRequestSummary = Awaited<
+  ReturnType<Octokit["rest"]["pulls"]["list"]>
+>["data"][number] &
+  Encodable
+
+/** Octokit issue comment response kept aligned with the installed SDK version. */
+type GitHubIssueComment = Awaited<
+  ReturnType<Octokit["rest"]["issues"]["createComment"]>
+>["data"] &
+  Encodable
+
+/**
+ * Octokit pull request review response kept aligned with the installed SDK
+ * version.
+ */
+type GitHubPullRequestReview = Awaited<
+  ReturnType<Octokit["rest"]["pulls"]["createReview"]>
+>["data"] &
+  Encodable
+
+export const GITHUB_ISSUE_EVENT_SCHEMA: z.ZodType<GitHubIssueEvent> =
+  z.custom<GitHubIssueEvent>(
+    (value) => GITHUB_ISSUE_EVENT_BASE_SCHEMA.safeParse(value).success,
+  )
+export const GITHUB_PULL_REQUEST_EVENT_SCHEMA: z.ZodType<GitHubPullRequestEvent> =
+  z.custom<GitHubPullRequestEvent>(
+    (value) => GITHUB_PULL_REQUEST_EVENT_BASE_SCHEMA.safeParse(value).success,
+  )
+export const GITHUB_PULL_REQUEST_REVIEW_EVENT_SCHEMA: z.ZodType<GitHubPullRequestReviewEvent> =
+  z.custom<GitHubPullRequestReviewEvent>(
+    (value) =>
+      GITHUB_PULL_REQUEST_REVIEW_EVENT_BASE_SCHEMA.safeParse(value).success,
+  )
+export const GITHUB_PUSH_EVENT_SCHEMA: z.ZodType<GitHubPushEvent> =
+  z.custom<GitHubPushEvent>(
+    (value) => GITHUB_PUSH_EVENT_BASE_SCHEMA.safeParse(value).success,
+  )
+export const GITHUB_RELEASE_EVENT_SCHEMA: z.ZodType<GitHubReleaseEvent> =
+  z.custom<GitHubReleaseEvent>(
+    (value) => GITHUB_RELEASE_EVENT_BASE_SCHEMA.safeParse(value).success,
+  )
+export const GITHUB_WORKFLOW_RUN_EVENT_SCHEMA: z.ZodType<GitHubWorkflowRunEvent> =
+  z.custom<GitHubWorkflowRunEvent>(
+    (value) => GITHUB_WORKFLOW_RUN_EVENT_BASE_SCHEMA.safeParse(value).success,
+  )
+
+export const GITHUB_ISSUE_OPENED_EVENT_SCHEMA = githubSemanticEventSchema<
+  GitHubIssueEvent,
+  GitHubIssueOpenedEvent
+>(GITHUB_ISSUE_EVENT_SCHEMA, (event) => event.action === "opened")
+export const GITHUB_ISSUE_REOPENED_EVENT_SCHEMA = githubSemanticEventSchema<
+  GitHubIssueEvent,
+  GitHubIssueReopenedEvent
+>(GITHUB_ISSUE_EVENT_SCHEMA, (event) => event.action === "reopened")
+export const GITHUB_ISSUE_CLOSED_EVENT_SCHEMA = githubSemanticEventSchema<
+  GitHubIssueEvent,
+  GitHubIssueClosedEvent
+>(GITHUB_ISSUE_EVENT_SCHEMA, (event) => event.action === "closed")
+export const GITHUB_PULL_REQUEST_OPENED_EVENT_SCHEMA =
+  githubSemanticEventSchema<
+    GitHubPullRequestEvent,
+    GitHubPullRequestOpenedEvent
+  >(GITHUB_PULL_REQUEST_EVENT_SCHEMA, (event) => event.action === "opened")
+export const GITHUB_PULL_REQUEST_READY_FOR_REVIEW_EVENT_SCHEMA =
+  githubSemanticEventSchema<
+    GitHubPullRequestEvent,
+    GitHubPullRequestReadyForReviewEvent
+  >(
+    GITHUB_PULL_REQUEST_EVENT_SCHEMA,
+    (event) => event.action === "ready_for_review",
+  )
+export const GITHUB_PULL_REQUEST_SYNCHRONIZED_EVENT_SCHEMA =
+  githubSemanticEventSchema<
+    GitHubPullRequestEvent,
+    GitHubPullRequestSynchronizedEvent
+  >(GITHUB_PULL_REQUEST_EVENT_SCHEMA, (event) => event.action === "synchronize")
+export const GITHUB_PULL_REQUEST_CLOSED_EVENT_SCHEMA =
+  githubSemanticEventSchema<
+    GitHubPullRequestEvent,
+    GitHubPullRequestClosedEvent
+  >(
+    GITHUB_PULL_REQUEST_EVENT_SCHEMA,
+    (event) => event.action === "closed" && !event.pull_request.merged,
+  )
+export const GITHUB_PULL_REQUEST_MERGED_EVENT_SCHEMA =
+  githubSemanticEventSchema<
+    GitHubPullRequestEvent,
+    GitHubPullRequestMergedEvent
+  >(
+    GITHUB_PULL_REQUEST_EVENT_SCHEMA,
+    (event) => event.action === "closed" && event.pull_request.merged,
+  )
+export const GITHUB_PULL_REQUEST_REVIEW_SUBMITTED_EVENT_SCHEMA =
+  githubSemanticEventSchema<
+    GitHubPullRequestReviewEvent,
+    GitHubPullRequestReviewSubmittedEvent
+  >(
+    GITHUB_PULL_REQUEST_REVIEW_EVENT_SCHEMA,
+    (event) => event.action === "submitted",
+  )
+export const GITHUB_PULL_REQUEST_REVIEW_APPROVED_EVENT_SCHEMA =
+  githubSemanticEventSchema<
+    GitHubPullRequestReviewEvent,
+    GitHubPullRequestReviewApprovedEvent
+  >(
+    GITHUB_PULL_REQUEST_REVIEW_EVENT_SCHEMA,
+    (event) =>
+      event.action === "submitted" && event.review.state === "approved",
+  )
+export const GITHUB_PULL_REQUEST_REVIEW_CHANGES_REQUESTED_EVENT_SCHEMA =
+  githubSemanticEventSchema<
+    GitHubPullRequestReviewEvent,
+    GitHubPullRequestReviewChangesRequestedEvent
+  >(
+    GITHUB_PULL_REQUEST_REVIEW_EVENT_SCHEMA,
+    (event) =>
+      event.action === "submitted" &&
+      event.review.state === "changes_requested",
+  )
+export const GITHUB_PULL_REQUEST_REVIEW_DISMISSED_EVENT_SCHEMA =
+  githubSemanticEventSchema<
+    GitHubPullRequestReviewEvent,
+    GitHubPullRequestReviewDismissedEvent
+  >(
+    GITHUB_PULL_REQUEST_REVIEW_EVENT_SCHEMA,
+    (event) => event.action === "dismissed",
+  )
+export const GITHUB_WORKFLOW_RUN_REQUESTED_EVENT_SCHEMA =
+  githubSemanticEventSchema<
+    GitHubWorkflowRunEvent,
+    GitHubWorkflowRunRequestedEvent
+  >(GITHUB_WORKFLOW_RUN_EVENT_SCHEMA, (event) => event.action === "requested")
+export const GITHUB_WORKFLOW_RUN_STARTED_EVENT_SCHEMA =
+  githubSemanticEventSchema<
+    GitHubWorkflowRunEvent,
+    GitHubWorkflowRunStartedEvent
+  >(GITHUB_WORKFLOW_RUN_EVENT_SCHEMA, (event) => event.action === "in_progress")
+export const GITHUB_WORKFLOW_RUN_COMPLETED_EVENT_SCHEMA =
+  githubSemanticEventSchema<
+    GitHubWorkflowRunEvent,
+    GitHubWorkflowRunCompletedEvent
+  >(GITHUB_WORKFLOW_RUN_EVENT_SCHEMA, (event) => event.action === "completed")
+export const GITHUB_WORKFLOW_RUN_SUCCEEDED_EVENT_SCHEMA =
+  githubSemanticEventSchema<
+    GitHubWorkflowRunEvent,
+    GitHubWorkflowRunSucceededEvent
+  >(
+    GITHUB_WORKFLOW_RUN_EVENT_SCHEMA,
+    (event) =>
+      event.action === "completed" &&
+      event.workflow_run.conclusion === "success",
+  )
+export const GITHUB_WORKFLOW_RUN_FAILED_EVENT_SCHEMA =
+  githubSemanticEventSchema<
+    GitHubWorkflowRunEvent,
+    GitHubWorkflowRunFailedEvent
+  >(
+    GITHUB_WORKFLOW_RUN_EVENT_SCHEMA,
+    (event) =>
+      event.action === "completed" &&
+      event.workflow_run.conclusion === "failure",
+  )
+export const GITHUB_WORKFLOW_RUN_CANCELLED_EVENT_SCHEMA =
+  githubSemanticEventSchema<
+    GitHubWorkflowRunEvent,
+    GitHubWorkflowRunCancelledEvent
+  >(
+    GITHUB_WORKFLOW_RUN_EVENT_SCHEMA,
+    (event) =>
+      event.action === "completed" &&
+      event.workflow_run.conclusion === "cancelled",
+  )
+export const GITHUB_RELEASE_PUBLISHED_EVENT_SCHEMA = githubSemanticEventSchema<
+  GitHubReleaseEvent,
+  GitHubReleasePublishedEvent
+>(GITHUB_RELEASE_EVENT_SCHEMA, (event) => event.action === "published")
+
+export const GITHUB_ISSUE_SCHEMA = z.custom<GitHubIssue>(
+  (value) => GITHUB_ISSUE_BASE_SCHEMA.safeParse(value).success,
+)
+export const GITHUB_PULL_REQUEST_SCHEMA = z.custom<GitHubPullRequest>(
+  (value) => GITHUB_PULL_REQUEST_BASE_SCHEMA.safeParse(value).success,
+)
+export const GITHUB_PULL_REQUEST_SUMMARY_SCHEMA =
+  z.custom<GitHubPullRequestSummary>(
+    (value) => GITHUB_PULL_REQUEST_BASE_SCHEMA.safeParse(value).success,
+  )
+export const GITHUB_ISSUE_COMMENT_SCHEMA = z.custom<GitHubIssueComment>(
+  (value) => GITHUB_ISSUE_COMMENT_BASE_SCHEMA.safeParse(value).success,
+)
+export const GITHUB_PULL_REQUEST_REVIEW_SCHEMA =
+  z.custom<GitHubPullRequestReview>(
+    (value) => GITHUB_PULL_REQUEST_REVIEW_BASE_SCHEMA.safeParse(value).success,
+  )
+export const GITHUB_PULL_REQUEST_MERGE_SCHEMA = z.object({
+  /** Provider status text describing the merge result. */
+  message: z.string(),
+
+  /** Whether GitHub merged the pull request. */
+  merged: z.boolean(),
+
+  /** Merge commit SHA, when GitHub created one. */
+  sha: z.string().nullable(),
+})
+
+/**
+ * Narrows a validated broad GitHub webhook family to one semantic event.
+ *
+ * @param schema - Broad webhook-family schema.
+ * @param matches - Semantic action or status classifier.
+ */
+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)
+  })
+}