harn-stdlib 0.8.82

/**
 * Canonical normalized connector event schemas, authored as Harn types.
 *
 * This module is the SOURCE OF TRUTH for the normalized-event shapes that
 * `.harn` connectors emit and the Rust runtime deserializes. The Rust structs
 * in `crates/harn-vm/src/triggers/event/schemas_generated.rs` are GENERATED
 * from these declarations by `harn connector-schema-codegen`, so a connector's
 * JSON output matches the Rust struct by construction.
 *
 * Regenerate the Rust structs with:  make gen-connector-schemas
 * Verify they are not stale with:     make check-connector-schemas
 *
 * Type mapping applied by the generator:
 *   string      -> String
 *   int         -> i64
 *   bool        -> bool
 *   any         -> serde_json::Value      (untyped JSON subtree)
 *   T?          -> Option<T>              (+ serde default + skip_serializing_if)
 *   list<T>     -> Vec<T>                 (+ serde default)
 *   dict<K, V>  -> BTreeMap<K, V>         (+ serde default)
 *   { ... }     -> a `#[serde(flatten)]` field named `common` when the field is
 *                  spelled `common: <Record>`; otherwise a nested struct.
 *
 * GIT FORGE. Provider packages for GitHub, GitLab, Gitea, Forgejo, and other
 * forges can emit these records onto the shared forge event-log topic while
 * still preserving their native payload in `raw_payload`.
 */
type GitForgeRepositoryRef = {provider: string, full_name?: string, id?: string, web_url?: string}

type GitForgePullRequestRef = {
  number: int,
  id?: string,
  title?: string,
  author?: string,
  web_url?: string,
  head_ref?: string,
  head_sha?: string,
  base_ref?: string,
  base_sha?: string,
  state?: string,
  draft?: bool,
  merged?: bool,
}

type GitForgeWritebackTarget = {
  provider: string,
  repository_full_name?: string,
  repository_id?: string,
  pull_request_number: int,
  web_url?: string,
}

type GitForgePullRequestEvent = {
  topic: string,
  event: string,
  kind: string,
  provider: string,
  lifecycle: string,
  repository: GitForgeRepositoryRef,
  pull_request: GitForgePullRequestRef,
  writeback: GitForgeWritebackTarget,
  delivery_id?: string,
  signature_status?: any,
  provider_metadata: dict<string, any>,
  raw_payload: any,
}

// GITHUB. The provider-schema generator is exercised end-to-end for GitHub,
// alongside the forge-agnostic records above. Keep the GitHub records a
// faithful mirror of the `GitHubEventPayload` family in
// `crates/harn-vm/src/triggers/event/payloads.rs`.
/**
 * Stable common block shared by every GitHub normalized event. The generator
 * recognizes a field named `common` whose type is a record and emits it as a
 * `#[serde(flatten)]` field, matching the hand-written `GitHubEventCommon`.
 */
type GitHubEventCommon = {
  event: string,
  action?: string,
  delivery_id?: string,
  installation_id?: int,
  topic?: string,
  repository?: any,
  repo?: any,
  raw: any,
}

type GitHubIssuesEventPayload = {common: GitHubEventCommon, issue: any}

type GitHubPullRequestEventPayload = {common: GitHubEventCommon, pull_request: any}

type GitHubIssueCommentEventPayload = {common: GitHubEventCommon, issue: any, comment: any}

type GitHubPullRequestReviewEventPayload = {
  common: GitHubEventCommon,
  pull_request: any,
  review: any,
}

type GitHubPushEventPayload = {common: GitHubEventCommon, commits: list<any>, distinct_size?: int}

type GitHubWorkflowRunEventPayload = {common: GitHubEventCommon, workflow_run: any}

type GitHubDeploymentStatusEventPayload = {
  common: GitHubEventCommon,
  deployment_status: any,
  deployment: any,
}

type GitHubCheckRunEventPayload = {common: GitHubEventCommon, check_run: any}

type GitHubCheckSuiteEventPayload = {
  common: GitHubEventCommon,
  check_suite: any,
  check_suite_id?: int,
  pull_request_number?: int,
  head_sha?: string,
  head_ref?: string,
  base_ref?: string,
  status?: string,
  conclusion?: string,
}

type GitHubStatusEventPayload = {
  common: GitHubEventCommon,
  commit_status?: any,
  status_id?: int,
  head_sha?: string,
  head_ref?: string,
  base_ref?: string,
  state?: string,
  context?: string,
  target_url?: string,
}

type GitHubMergeGroupEventPayload = {
  common: GitHubEventCommon,
  merge_group: any,
  merge_group_id?: any,
  head_sha?: string,
  head_ref?: string,
  base_sha?: string,
  base_ref?: string,
  pull_requests: list<any>,
  pull_request_numbers: list<int>,
}

type GitHubInstallationEventPayload = {
  common: GitHubEventCommon,
  installation?: any,
  account?: any,
  installation_state?: string,
  suspended?: bool,
  revoked?: bool,
  repositories: list<any>,
}

type GitHubInstallationRepositoriesEventPayload = {
  common: GitHubEventCommon,
  installation?: any,
  account?: any,
  installation_state?: string,
  suspended?: bool,
  revoked?: bool,
  repository_selection?: string,
  repositories_added: list<any>,
  repositories_removed: list<any>,
}

/**
 * The dispatched GitHub event union, mirroring the hand-written
 * `GitHubEventPayload` enum (an untagged-on-the-wire, `event`-dispatched enum).
 *
 * The generator emits one Rust enum variant per union member; the trailing
 * `GitHubEventCommon` member is the catch-all `Other` variant the manual
 * `Deserialize` falls back to when the `event` discriminator is unrecognized.
 * Referencing every payload record here also keeps this schema module free of
 * `unused-type` lint noise.
 */
type GitHubEventPayload = GitHubIssuesEventPayload | GitHubPullRequestEventPayload | GitHubIssueCommentEventPayload | GitHubPullRequestReviewEventPayload | GitHubPushEventPayload | GitHubWorkflowRunEventPayload | GitHubDeploymentStatusEventPayload | GitHubCheckRunEventPayload | GitHubCheckSuiteEventPayload | GitHubStatusEventPayload | GitHubMergeGroupEventPayload | GitHubInstallationEventPayload | GitHubInstallationRepositoriesEventPayload | GitHubEventCommon